# Manual do &kcalc;

## Introdución

This document describes &kcalc; version 2.7.

O &kcalc; ofrece muitas máis funcións matemáticas do que dá a entender á  primeira vista. Estude por favor a sección sobre os atallos de teclado e os modos neste manual para aprender máis sobre as moitas funcións disponíbeis.

Para alén da funcionalidade normal ofrecida pola maioría das calculadoras científicas, o &kcalc; ofrece un monte de funcionalidades que merecen ser resaltadas:

- O &kcalc; ofrece funcións trigonométricas, operacións lóxicas e é capaz de efectuar cálculos estatísticos.

- O &kcalc; permite cortar e apegar os números de e para o pantalla.

- O &kcalc; contén unha pila de resultados que permite recuperar comodadamente os resultados anteriores.

- Pódense configurar as cores e o tipo de letra do &kcalc;.

- Pódese configurar a precisión do &kcalc; e o número de díxitos a seguir á vírgula.

- O &kcalc; ofrece un monte de atallos de teclado útiles que posibilitan e facilitan o uso do &kcalc; sen  usar o rato.

  Hint: pressing (and holding) the &Ctrl;-key, displays on every button,the corresponding key-binding.

Divírtase co &kcalc;!

&Bernd.Johannes.Wuebben;

## Utilización

### Utilización xeral

A utilización xeral é intuitiva e semellante a como funcionan a maioría das calculadoras científicas simples, mais hai que ter en conta as seguintes funcionalidades especiais do &kcalc;:

Pila de resultados

- De cada vez que se preme co &LMB; no botón = ou se premen as teclas &Enter; ou =, o resultado presentado gárdase na de resultados do &kcalc;. Pódese  navegar pola pila de resultados coas teclas &Ctrl;Z e &Ctrl; &Shift;Z.

Función de porcentaxe

- A tecla de porcentaxe funciona de forma lixeiramente diferente da que costuma existir na maioría das calculadoras. Porén, unha vez entendida, a súa funcionalidade mellorada tórnase bastante útil. Vexa a sección sobre a función porcentaxe para máis detalles.

Cortar e apegar

- - Ao premer &Ctrl;C o número pasa para o porta-retallos.

  - Ao premer &Ctrl;V apégase na pantalla o contido do porta-retallos - se o contido do porta-retallos é un número de vírgula flotante válido.

  - Ainda é posíbel copiar/apegar premendo na pantalla do &kcalc;, mas isto podería desaparecer en versións futuras.

Funcións avanzadas

- Ao iniciar &kcalc; pola primeira vez, a calculadora só mostra os botóns para os cálculos aritméticos básicos.

  Under the menu entry Settings it is possible to select a mode for &kcalc;: it is possible to choose Simple or Science or Statistic or Numeral System mode. Please note, that these modes will slightly change as &kcalc; evolves.

Disposición dos botóns

- To give easy access to all the functions in &kcalc;, many keys have a second layout. Click on &Shift; or press the shortcut I to make the second layout of the buttons visible.

### Simple Mode

This mode contains only those buttons and functions, which are essential necessary for basic calculations.

If you just want to sum up all items on an invoice this mode may be your choice.

### Science Mode

Neste modo a columna esquerda dos botóns fica destinada ás funcións trigonométricas:

Botóns | Función
Hyp | Enter Hyperbolic sub mode. Hyp Sin for example is the hyperbolic sine: sinh
Sin | Calcula o seno
&Shift; Sin | Calcula o arco-seno
Cos | Calcula o coseno
&Shift; Cos | Calcula o arco-coseno
Tan | Calcula a tanxente
&Shift; Tan | Calcula a arco-tanxente
Log | Calcula o logaritmo de base 10
&Shift; Log | Calcula 10 elevado a x
Ln | Calcula o logaritmo natural. Este é o logaritmo na base e
&Shift; Ln | Calcula e elevado a x

### Modo estatístico

Neste modo a columna esquerda dos botóns destínase ás funcións estatísticas:

A maioria das funcionalidades deste modo están centradas no botón Dat. Para crear unha lista de datos numéricos, introduza un número na calculadora e prema Dat. Na pantalla pareceun número secuencial incremental que indica a posición que ocupa o número nalista de datos. Unha calculadora tradicional só garda tres valores para as funcións estatísticas: O número de elementos discretos dunha lista, o sumatorio dos elementos de datos introducidos e a suma dos cadrados de todos os elementos da lista. O &kcalc; é diferente porque almacena realmente todos os valores discretos, o que permite calcular a mediana dos datos.

Botóns | Función
N | Mostra o número de dados introducidos
&Shift; N | Mostra o sumatorio de todos os datos introducidos
Mea | Mostra a media dos elementos de dados introducidos
&Shift; Mea | Mostra a suma do cadrado de todos os elementos de datos introducidos
Std | Mostra a desviación estándar (n)
&Shift; Std | Mostra a desviación estándar da poboación (n-1)
Med | Mostra a mediana
Dat | Introduce un elemento de datos
&Shift; Dat | Borra o último elemento de datos introducido
CSt | Borra o almacenamento de todos os elementos de datos introducidos

### Numeral System Mode

This mode contains buttons and functions to calculate in binary, hexadecimal, octal and decimal.

You select the numeral system with the radio buttons on the right. To insert a hexadecimal number for example, just do the following: Select Hex from the radio buttons. Then enter a number and note, that you can use the letters A to F for numbers larger than 9. If you would like to see this number in binary, just select Bin from the radio buttons.

You may want to select Show Bit Edit from the Settings menu to see selected bits.

There are logic operators available in this mode. These operators are:

Botóns | Función
E | Two numbers are logically anded
OU | Two numbers are logically ored
XOR | Two numbers are logically exclusive ored

### Operacións de memoria

O &kcalc; permite as operacións de memoria que fornecen as máquinas de calcular  normais, mais seis lugares onde gardar constantes.

#### Operacións de memoria normais

&kcalc; can remember results of operations for you, and re-use them in later calculations. You can access these functions via several buttons labeled MR, MS, M+ and MC.

MS

- MS garda na memoria o resultado actual da pantalla.

M+

- M+ engade o resultado actual ao que se encontra na memoria. Así, se tiver almacenado un 20 e o resultado actual for 5, a memoria conterá 25 cando prema o botón. Se a memoria estiver baleria actúa como o MS e simplemente garda o  resultado.

MR

- O botón MR recupera o valor gardado na memoria e  colócao na pantalla.

MC

- O botón MC borra a memoria.

Se un valor for gardado en memoria, aparece un M na barra de estado, ao lado do indicador do modo da calculadora

#### Constantes

The six constants buttons C1 to C6 will only be visible after activating the item Constants Buttons in the menu Settings of the menu bar. They are available in Science mode and Statistics mode

To store the number shown in the &kcalc; display in one of the six constants, first press &Shift; followed by the desired button key C1 up to C6.

To use the value stored in any of the constants in a calculation, just press the desired button (C1 to C6), and the corresponding number will appear in the display.

É posíbel alterar a lenda dos botóns de constantes para facilitar que o usuario lembre cal é a constante que contén cada botón. Prema cobotón dereito un dos botóns (C1 a C6). Aparece un menú no que se pode seleccionar a opciónEscoller o nome.

Existen varias constantes (a maioría delas son físicas) que se poden colocar en calquera dos seis botóns C1 - C6, se se selecciona a constante desexada no menú de contexto que aparece ao premer un dos botóns de constantes e seleccionar a opción Escoller da lista. Ainda que tamén se poida acceder ás  constantes predefinidas a través do menú Constantes, pode ser útil gardalas nun botón de constantes se o número for usado con frecuencia.

### Atallos de teclado simples

Para simplificar a introdución de cálculos a partir do teclado, o &kcalc; ten algúns aceleradores de teclado simples para a maioría das funcións. Por exemplo, introducindo `7R` ou `7r` calcúlase o inverso de 7 (1/7).

Durante un cálculo, pódese premer sempre a tecla &Ctrl; para que  cada botón mostre a súa combinación de teclas.

Tecla | Función | Notas
H | Hyp | Hyperbolic as in Hyp Sin, the sinh
S | Sin |
C | Cos |
T | Tan |
N | Ln | Logaritmo en base e
L | Log | Logaritmo en base 10
Ctrl-2 | &Shift; | Second function for this button. ⪚ if you want arcsin type `Ctrl-2 s`
\ | +/- | Mudar o signo
[ | x^2 |
^ | x^y |
! | x! | Factorial
< | Lsh | Desprazamento á esquerda
> | Rsh | Desprazamento á dereita.
& | E | E lóxico (AND)
x ou * | X | Multiplicar
/ | / | Dividir
D | Dat | Introduce un elemento de datos no modo estatístico
| | OU | Logical OR. Note: &Shift; OR is XOR
R | 1/x | Recíproco
&Enter; | = |
Return | = |
RePág | C | Borrar
&Esc; | C | Borrar
AvPág | AC | Borrar todo
Del | AC | Borrar todo
&Shift;+: | Mod | resto da división
&Alt;+1 até &Alt;+6 | C1 | usar o valor gardado en C1 até C6

## Comentarios sobre funcións específicas

### Mod e IntDiv

Mod devolve o resto da división do número presentado polo próximo número que se introduza.

- `22 Mod 8 =` dá como resultado 6

  `22 Mod 8 =` dá como resultado 6

&Shift; IntDiv does integer division of the displayed number by the next input number.

- `22 Shift IntDiv 8 =` will give the result 2

  `22.345 Shift IntDiv 8 =` also gives 2

### %

Usado no canto da tecla =, % interpreta a operación final executada no cálculo actual como se indica a seguir:

- Se o operador final for + ou -, o segundo argumento interprétase como porcentaxe do segundo operando.

- Se o operador final for *, divídese o resultado da multiplicación por 100.

- Se o operador final for /, dá o operando esquerdo como porcentaxe do operando dereito.

- En todos os outros casos a tecla % dá resultados iguais á tecla =.

Exemplos:

- `150 + 50 %` dá 225 (150 máis 50 por cento deste valor)

  `42 * 3 %` dá 1.26 (42 * 3 / 100)

  `45 / 55 %` dá 81,81... (45 é 81,81.. por cento de 55)

### Lsh e Rsh

Lsh despraza á esquerda a parte enteira do valor presentado (multiplícaa por 2) n veces, onde n é o próximo número que se introduza, e dá un resultado enteiro (coa base definida como Bin):

- `10 Lsh 3 =` dá 80 (10 multiplicado por 2, tres veces).

  `10.345 Lsh 3 =` tamén dá 80.

Rsh despraza á dereita o valor (fai unha división enteira por 2), n veces.

- `16 Rsh 2 =` dá 4 (16 dividido por 2, dúas veces).

  `16.999 Rsh 2 =` tamén dá 4.

### Cmp, E, OU e Xor

As funcións Cmp, E e OU efectúan operacións lóxicas con bits, e como tal  parecen máis significativas se a Base estiver definida como Hex, Oct ou Bin en vez de Dec. Nos seguintes exemplos, a Base está definida como Bin.

Cmp efectúa un complemento a 1 (inverte os bits).

- `101 Cmp` dá 111...111010

E efectúa un E lóxico.

- `101 E 110 =` dá 100

OU efectúa o OU lóxico.

- `101 OU 110 =` dá 111

XOR efectúa a operación de XOR lóxico (OU exclusivo).

- `101 XOR 110 =` dá 11

## Preguntas e respostas

Como se pode obter e, o número de Euler?

Type `1 Shift Ln`.

Como se obteñen dous algarismos fixos despois da vírgula?

Prema o botón Configuración Configurar &kcalc;..., para que este mostre o diálogo de configuración. Seleccione a opción Escoller a precisión decimal e axuste o valor para que mostre un 2.

E a precisión?

O factor principal que determina a precisión do &kcalc; é se o libc e olibmath do sistema admiten o tipo de datos do C `long double`. Se este for o caso, o &kcalc; detecta isto cando se compila e úsao  como tipo de datos fundamental para representar os números.

Axuste a Precisión no diálogo Configurar do &kcalc; para que as contas anteriores funcionen correctamente. Recoméndase unha precisión de 14 se o tipo de datos da versión do &kcalc;  for o `long double`; caso contrario, recoméndase 8 ou 10.

Unha maior precisión non significa necesariamente mellores resultados. Brinque coa precisión e comprenderá o que se está a dicir.

&commands;

## Créditos e licenza

&kcalc; Programa Copyright ©:

&Bernd.Johannes.Wuebben; 1996-2000

A Equipa do &kde; 2000-2008

- &Bernd.Johannes.Wuebben; &Bernd.Johannes.Wuebben.mail;

- &Evan.Teran; &Evan.Teran.mail;

- &Espen.Sand; &Espen.Sand.mail;

- &Chris.Howells; &Chris.Howells.mail;

- &Aaron.J.Seigo; &Aaron.J.Seigo.mail;

- &Charles.Samuels; &Charles.Samuels.mail;

- &David.Johnson; &David.Johnson.mail;

O &kcalc; inspirouse no xfrmcalc de Martin Bartlett, cuxa pila é ainda parte do &kcalc;.

Documentation Copyright © 2001,2002,2005, 2006,2010:

- &Bernd.Johannes.Wuebben; &Bernd.Johannes.Wuebben.mail;

- &Pamela.Roberts; &Pamela.Roberts.mail;

- &J.Hall; &J.Hall.mail;

- &Anne-Marie.Mahfouf;&Anne-Marie.Mahfouf.mail;

- Eike Krumbacher eike.krumbacher@x-eike.de

Tradución da documentación: Xosé Calvo - http://trasno.net/

&underFDL; &underGPL;

## Instalación

O &kcalc; é parte do paquete kdeutils do proxecto &kde; e fornécese como parte dunha instalación do &kde;. Para máis detalles sobre o  &kde; vaia a http://www.kde.org.

### Compilación e instalación

&install.intro.documentation; &install.compile.documentation;

### Como activar a precisión "long double" para o &kcalc;

Se a máquina permite o tipo de datos do C `long double` e se ten unha libc funcional, pódese activar a precisión `long double` para o &kcalc;.

Velaquí o que hai que facer:

1. Verifique o `config-kcalc.h` e vexa se o HAVE_LONG_DOUBLE está definido, &ie; debería poder localizar unha  liña que di:

       #define HAVE_LONG_DOUBLE 1

   Se non se dá atopado esa liña, o sistema non permite a precisión "long double" do IEEE.

2. Altere os ficheiros `kcalctype.h`, `configdlg.cpp`, `kcalc.cpp` e `kcalc_core.cpp` e retire as liñas:

       #ifdef HAVE_LONG_DOUBLE
       #undef HAVE_LONG_DOUBLE
       #endif

3. Recompile o &kcalc;.