Content-type: text/html Manpage of ralcalc

ralcalc

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

NAME

ralcalc - Une calculatrice simple en ligne de commandes  

SYNOPSIS

ralcalc {-a | --all} | {-h | --help} | {-v | --version} ralcalc [-e | -r] [-f nom_fichier] [-i] [-p precision] [-q] [-s préfixe] équation = {-a | --all} | {-h | --help} | {-v | --version} = [-e | -r] [-f nom_fichier] [-i] [-p precision] [-q] [-s préfixe] équation  

DESCRIPTION

racalc est une calculatrice en ligne de commande dont le but est de réaliser des calculs très rapide où un seul résultat est attendu, sans avoir à démarrer, puis quitter un programme.

ralcalc est aussi installé sous la commande = pour encore plus de rapidité.  

OPTIONS

-a, --all
Afficher tous les opérateurs disponibles, les fonctions et les constantes.
-e
Afficher le résultat sous la forme "1e-3" plutôt qu'avec les préfixes du Système International (SI).
-f
Procéder à une liste de calculs contenue dans un fichier. Veuillez vous référer à la section fichier d'entrée (FILE INPUT) ci-dessous pour plus d'informations.
-h, --help
Afficher les détails d'utilisation, de version et de contact.
-i
Processus de la liste de calcul depuis stdin. Voir la section du FICHIER D'ENTRÉE ci-dessous pour plus d'informations.
-p
Control the number of digits displayed in the output result. This is only available for -e and -r modes or if the output does not use a SI prefix.
-q
Afficher seulement le résultat (donc cacher l'entrée et de possibles erreurs)
-r
Montre le résultat sous le format décimal sans les préfixes du SI, sans exposant.
-s
Afficher le résultat en utilisant un préfixe particulier du SI. Cette option est ignorée si -e /option > ou -r est aussi utilis
-v, --version
Afficher les détails d'utilisation, de version et de contact.
 

FORMAT NUMéRIQUE

Les chiffres doivent être entrées en utilisant soit "." ou "," comme point décimal (ceci dépend de votre locale aussi les deux peuvent ne pas fonctionner ensemble), sans aucun séparateur de milliers.

ralcalc command> prend en charge les caract = 2u/35 2u/35 = 57.1429n

Les nombres du genre 1e-3 sont également supportés, où le "e" indique une puissance de dix. Ne pas mélanger les préfixes SI et "e" dans un même nombre (bien que 1e-3n soit valide, 1ne-3 ne l'est pas - éviter les deux pour moins de confusion).

Les préfixes du SI supportés sont : Y, Z, E, P, T, G, M, k, m, u, n, p, f, a, z, y.  

OPéRATEURS

Les opérateurs mathématiques simples pour l'addition (+), la soustraction (-), la multiplication (*, x), la division (/) et la puissance (^) sont supportés, l'addition et la soustraction ayant la priorité la plus basse et la puissance ayant la plus haute. Placeholder-1 / >

Les parenthèses ((), []) peuvent être utilisées pour contrôler l'ordre dans lequel les opérations sont traitées : placeholder-1 / >

Both the square and round brackets can be used and are both directly equivalent, so [1+2)x3 is also valid. Round brackets are more commonly used in mathematics, but the square brackets (and the "x" for multiplication) are included to try to prevent problems with the shell expanding those characters.

ralcalc command> stocke le r = 2^0.5 2^0.5 = 1.41421 = 1/_ 1/_ = 0.707107  

FONCTIONS

The functions sin, cos, tan, asin, acos, atan, sqrt, log (base 10 logarithm) and ln (natural logarithm) are supported. The trigonometric functions work on radians. The use of brackets is not necessary, but is recommended where precedence may be confusing. The functions have equal precedence to multiplication/division, so care must be taken:


        = sin2x2
        sin2x2 = 1.81859

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

CONSTANTES

Les constantes pi (3.14159) et exp (2.71828) peuvent être utilisées et sont traitées de la même manière que n'importe quel nombre.  

FICHIER D'ENTRéE

A list of calculations can be processed at once by placing them in a file. Each line of the file will be process exactly the same as if ralcalc had been run with those arguments. The file could look like the following (note the lack of the command = or ralcalc):


        2^0.5
        1/_
        238/1064x100

File input is also possible using stdin, i.e. reading interactively directly from the terminal with each line being calculated as normal. To quit, type "q" or "quit" on a new line, use Ctrl-D to indicate the end of file, or use Ctrl-C to cause ralcalc to be terminated.

If either of the file input options are given on the command line, then any calculations given on the command line will be calculated first. If both of the file input options are given, then the calculations from the -f will be carried out first, followed by those from stdin.  

EXEMPLES

Calcul basique :


        = ln 1.0001
        ln 1.0001 = 99.995u

Format de sortie en exposant:


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

Format de sortie d'un nombre premier :


        = -r ln 1.0001
        ln 1.0001 = 0.000100

Format de sortie d'un nombre avec un préfixe spécifique SI :


        = -s m ln 1.0001
        ln 1.0001 = 0.099995
 

VARIABLES D'ENVIRONNEMENT

ACCUEIL
Determine où le fichier .ralcalc_result est sauvegardé
 

VALEURS DE SORTIE

0
Réussi
1
Au moins une erreur est survenue.
 

FICHIERS

${HOME}/.ralcalc_result
Le résultat du calcul le plus récent, qui peut être consulté plus tard en utilisant le caractère "_". Notez que ce n'est pas nécessairement transférables dans différentes architectures machine.
 

DIAGNOSTICS

ralcalc attempts to notify the user of as many errors as possible and indicate where those errors are, if they are user input related.

If an unknown character is included in the equation, an "unknown token" error will be generated. The error marker points to the invalid character.


        = 34/3@2

        Error: 34/3@2
                   ^ unknown token

If an invalid number is included, a "bad number" error will be generated. The error marker points to the end of the invalid number.


        = 3.14.159x2.8^2

        Error: 3.14.159x2.8^2
                      ^ bad number

If the number of open and close brackets do not match, a "mismatched brackets" error will be generated. The error marker position has no significance.


        = 5/[[2+3]*9

        Error: 5/[[2+3]*9
                         ^ mismatched brackets

If an operator appears in an invalid position, an "invalid operator" error will be generated. The error marker indicated the invalid operator.


        = 3^^7

        Error: 3^^7
                 ^ invalid operator

If a bracket appears in an invalid position, an "invalid bracket" error will be generated. This type of error often overlaps with other errors, so there will be a number of messages written to the screen. It is best to fix this error first as it will likely be the root cause of the problem. The error marker indicates the invalid bracket.


        = [2+]3

        Error: [2+]3
                  ^ invalid bracket

        Error: [2+]3
                    ^ invalid operator

Siralcalc ne peut allouer un peu de mémoire, une erreur "Plus de mémoire disponible" sera générée.

Internal error: If the parser notices two numbers next to each other yet does not generate a "bad number" error, the a "duplicate number" error will be generated. This should never happen.

Internal error: If an unknown error code is passed to the error output function, an "unknown error" will be generated and the invalid error code displayed. This should never happen.  

BUGS

Only a single "-f filename" can be passed at once.

If you find a bug, please submit a report at http://bugs.launchpad.net/ralcalc  

AUTEUR

Roger Light <roger@atchoo.org>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FORMAT NUMéRIQUE
OPéRATEURS
FONCTIONS
CONSTANTES
FICHIER D'ENTRéE
EXEMPLES
VARIABLES D'ENVIRONNEMENT
VALEURS DE SORTIE
FICHIERS
DIAGNOSTICS
BUGS
AUTEUR

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