Content-type: text/html Manpage of ralcalc

ralcalc

Section: (1)
Updated: 3 October 2011
Index Return to Main Contents
 

NAME

ralcalc - uma calculadora simples de linha de comando  

SYNOPSIS

ralcalc {-a | --all} | {-h | --help} | {-v | --version} ralcalc [-e | -r] [-f nome de arquivo] [-i] [-q] [-s prefixo] equação = {-a | --all} | {-h | --help} | {-v | --version} = [-e | -r] [-f nome de arquivo] [-i] [-q] [-s prefixo] equação  

DESCRIçãO

ralcalc é uma calculadora de linha de comando projetada para cálculos muito rápidos onde talvez apenas um resultado único é garantido sem ter a necessidade de iniciar e depois encerrar um programa.

ralcalc é instalado também como o comando = para fazê-lo cada vez mais rápido.  

OPçõES

-a, --all
Emite a impressão de todos os operadores, funções e constantes.
-e
Exibe o resultado na forma "1e-3" ao invés de usar prefixos SI.
-f
Processa uma lista de cálculos de um arquivo. Consulte a seção ARQUIVO DE ENTRADA abaixo para maiores informações.
-h, --help
Exibe o uso, versão e detalhes de contato.
-i
Processa uma lista de cálculos de stdin. Consulte a seção ARQUIVO DE ENTRADA abaixo para maiores informações.
-q
Exibir apenas o resultado (então esconda a entrada e quaisquer erros).
-r
Exibir o resultado em formato decimal nem com prefixos SI nem com expoente.
-s
Exibe o resultado usando um prefixo SI particular. Esta opção é ignorada se a opção -e ou -r também é usada.
-v, --version
Exibe o uso, versão e detalhes de contato.
 

FORMATO DO NúMERO

Os números devem ser inseridos usando ou "." ou "," como um ponto decimal (isto depende da localidade então ambos podem não funcionar na sua localidade), sem separadores de milhares.

ralcalc suporta caracteres com prefixo SI tanto para entrada quanto para saída:


        = 2u/35
        2u/35 = 57.1429n

Números da forma 1e-3 também são suportados, onde o "e" indica uma potência de dez. Não misture e coincida prefixos SI e "e" no mesmo número (apesar de 1e-3n ser válido, 1ne-3 não é - evite ambos para menos confusões).

Os prefixos SI suportados são: Y, Z, E, P, T, G, M, k, m, u, n, p, f, a, z, y.  

OPERADORES

As operações matemáticas simples para adição (+), subtração (-), multiplicação (*, x), divisão (/) e potência (^) são suportadas, sendo que a adição e a subtração as que possuem a menor precedência e a potência tendo a mais alta.


        = 1+2x3
        1+2x3 = 7

        = 1/2^0.5
        1/2^0.5 = 0.707107

Parênteses ( (), [] ) podem ser usados para controlar a órdem na qual as instruções são processadas:


        = [1+2]x3
        [1+2]x3 = 9

Tanto os colchetes quanto os parênteses podem ser usados e ambos são diretamente equivalentes, então [1+2)x3 também é válido. Parênteses são geralmente mais usados na matemática, entretanto os colchetes (e o "x" para multiplicação) estão inclusos para tentar prevenir problemas com o shell que expande aqueles caracteres.

ralcalc armazena o resultado do cálculo para que este possa ser usado no próximo cálculo com o caractere "_".


        = 2^0.5
        2^0.5 = 1.41421

        = 1/_
        1/_ = 0.707107
 

FUNçõES

As funções sin, cos, tan, asin, acos, atan, sqrt, log (logarítmo de base 10) e ln (logarítmo natural) são suportadas. As funções trigonométricas trabalham em radianos. O uso de parênteses não é necessário, mas é recomendado quando a precedência possa ser confusa. As funções possuem precedência igual na multiplicação/divisão, então deve-se ter cuidado:


        = sin2x2
        sin2x2 = 1.81859

        = sin[2x2]
        sin[2x2] = -0.756802
 

CONSTANTES

As constantes pi (3.14159) e exp (2.71828) podem ser usadas e são tratadas da mesma forma que qualquer outro número.  

ARQUIVO DE ENTRADA

Uma lista de cálculos pode ser processada de uma vez colocando eles em um arquivo. Cada linha da fila será processada exatamente igual como se o ralcalc tivesse sido executado com estes argumentos. O arquivo pode se parecer como o seguinte (note a falta do comando = ou ralcalc):


        2^0.5
        1/_
        238/1064x100

Entrada de arquivo também é possível usando stdin, por exrmplo: lendo interativamento direto do terminal com cada linha sendo calculada como normal. Para sair, digite "q" ou "quit" em uma nova linha, use Ctrl-D para indicar o final do arquivo, ou use Ctrl-C para causar o término do ralcalc.

Se uma das opções de entrada de arquivo são dadas na linha de comando, então quaisquer cálculos fornecidos na linha de comando serão calculados primeiro. Se ambas as opções de entrada de arquivo são fornecidas, então os cálculos do -f serão feitos primeiro, seguidos daqueles do stdin.  

EXEMPLOS

Cálculo básico:


        = ln 1.0001
        ln 1.0001 = 99.995u

Formato de saída de número exponencial:


        = -e ln 1.0001
        ln 1.0001 = 9.9995e-05

Formato de saída de número Raw:


        = -r ln 1.0001
        ln 1.0001 = 0.000100

Formato de saída de número com um prefixo SI específico:


        = -s m ln 1.0001
        ln 1.0001 = 0.099995
 

VARIáVEIS DE AMBIENTE

INÍCIO
Determina onde o arquivo .ralcalc_result é armazenado.
 

VALORES DE SAíDA

0
Êxito
1
Ocorreu pelo menos um erro.
 

ARQUIVOS

${HOME}/.ralcalc_result
O resultado do cálculo mais recente, que pode ser acessado em um cálculo mais tarde usando o caractere "_". Note que isto não é necesáriamente portátil através de diferentes arquiteturas de máquinas.
 

DIAGNóSTICOS

ralcalc tenta notificar o usuário de muitos erros quanto o possível e indica onde estes erros estão, se eles estão relacionados a entrada do usuário.

Se um caractere desconhecido é incluído na equação, um erro de "símbolo desconhecido" será gerado. O marcador de erros aponta para o caractere inválido.


        = 34/3@2

        Erro: 34/3@2
                   ^ símbolo desconhecido

Se um número inválido é incluído, um erro de "número ruim" será gerado. O marcador de erros aponta para o final do número inválido.


        = 3.14.159x2.8^2

        Erro: 3.14.159x2.8^2
                      ^ número ruim

Se o número que abre e fecha parênteses não se coincidem, um erro de "parênteses inadequados" será gerado. A posição do marcador de erros é insignificante.


        = 5/[[2+3]*9

        Erro: 5/[[2+3]*9
                         ^ parênteses inadequados

Se um operador aparece em uma posição inválida, um erro de "operador inválido" será gerado. O marcador de erro indicou o operador inválido.


        = 3^^7

        Erro: 3^^7
                 ^ operador inválido

Se um parênteses aparece em uma posição inválida, um erro de "parênteses inválido" será gerado. Este tipo de erro geralmente sobrepõe os outro erros, então haverá certo número de mensagens escritas na tela. É melhor primeiramente corrigir este erro do que ser provavelmente a causa raíz do problema. O marcador de erro indica o parênteses inválido.


        = [2+]3

        Erro: [2+]3
                  ^ parênteses inválido

        Erro: [2+]3
                    ^ operador inválido

Se o ralcalc estiver incapaz de alocar um pouco de memória, um erro de "sem memória" será gerado.

Erro interno: Se o analisador reparar dois números próximos uns aos outros ainda não gerará um erro de "número ruim", o erro de "número duplicado" será gerado. Isto nunca deveria acontecer.

Erro interno: Se um código de falha desconhecida passa para a função de saída de erro, uma "falha desconhecida" será gerada e o código de falha desconhecida será exibida. Isto nunca deve acontecer.  

DEFEITOS

Apenas um único "-f nome de arquivo" pode passar de uma vez.

Se você encontrar um erro, por gentileza envie o relatório em http://bugs.launchpad.net/ralcalc  

AUTOR

Roger Light <roger@atchoo.org>


 

Index

NAME
SYNOPSIS
DESCRIçãO
OPçõES
FORMATO DO NúMERO
OPERADORES
FUNçõES
CONSTANTES
ARQUIVO DE ENTRADA
EXEMPLOS
VARIáVEIS DE AMBIENTE
VALORES DE SAíDA
ARQUIVOS
DIAGNóSTICOS
DEFEITOS
AUTOR

This document was created by man2html, using the manual pages.
Time: 11:10:15 GMT, October 03, 2011