Content-type: text/html Manpage of ralcalc

ralcalc

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

NAME

ralcalc - prosty kalkulator uruchamiany z wiersza poleceń  

SYNOPSIS

ralcalc {-a | --all} | {-h | --help} | {-v | --version} ralcalc [-e | -r] [-f nazwa_pliku] [-i] [-q] [-s przedrostek] równanie = {-a | --all} | {-h | --help} | {-v | --version} = [-e | -r] [-f nazwa_pliku] [-i] [-q] [-s przedrostek] równanie  

OPIS

ralcalc to kalkulator działający w wierszu poleceń, umożliwiający bardzo szybkie wykonanie obliczeń (zwłaszcza takich, w których ważny jest tylko wynik końcowy) bez konieczności uruchamiania i wyłączania programu.

ralcalc jest instalowany także jako polecenie =, dzięki czemu korzystanie z niego jest jeszcze szybsze.  

OPCJE

-a, --all
Wypisz wszystkie dostępne operatory, funkcje i stałe.
-e
Wyświetl wynik w postaci "1e-3" zamiast stosować przedrostki SI.
-f
Wykonaj obliczenia podane w pliku. Zobacz rozdział ODCZYT Z PLIKU, aby uzyskać więcej informacji.
-h, --help
Wyświetl sposób użycia, wersję i informacje kontaktowe.
-i
Wykonaj obliczenia podane na wejściu standardowym (stdin). Zobacz rozdział ODCZYT Z PLIKU, aby uzyskać więcej informacji.
-q
Wyświetl tylko wynik (ukrywając dane wejściowe i wszelkie błędy).
-r
Wyświetlaj wynik w postaci dziesiętnej nie stosując przedrostków SI ani postaci wykładniczej.
-s
Wyświetl wynik stosując określony przedrostek SI. Ta opcja jest ignorowana gdy użyto jednocześnie opcji -e lub -r.
-v, --version
Wyświetl sposób użycia, wersję i informacje kontaktowe.
 

FORMAT LICZBY

Przy podawaniu liczb ułamkowych należy stosować kropkę (".") albo przecinek (",") dziesiętny; jest to zależne od ustawień regionalnych ("locale"), zatem jeden z tych znaków może nie działać przy twoich ustawieniach. Nie należy natomiast oddzielać żadnym znakiem tysięcy.

ralcalc obsługuje przedrostki SI zarówno przy wprowadzaniu, jak i wyprowadzaniu informacji:


        = 2u/35
        2u/35 = 57,1429n

Obsługiwane są także liczby w postaci 1e-3, gdzie "e" wskazuje potęgę dziesiątki. Nie należy mieszać w jednej liczbie przedrostków SI oraz "e" (zapis 1e-3n jest poprawny, natomiast 1ne-3 już nie - unikaj obu by nie stwarzać niejasności).

Obsługiwane przedrostki SI: Y, Z, E, P, T, G, M, k, m, u, n, p, f, a, z, y.  

OPERATORY

Obsługiwane są operatory matematyczne dodawania (+), odejmowania (-), mnożenia (*, x), dzielenia (/) i potęgowania (^), przy czym na końcu wykonywane jest dodawanie i odejmowanie, w pierwszej kolejności zaś potęgowanie.


        = 1+2x3
        1+2x3 = 7

        = 1/2^0,5
        1/2^0,5 = 0,707107

Można używać nawiasów ( (), [] ) w celu określenia kolejności wykonywania działań:


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

Można używać zarówno nawiasów okrągłych, jak i kwadratowych, co oznacza, że poprawny jest zapis [1+2)x3. W matematyce najczęściej używa się nawiasów okrągłych, lecz program dopuszcza również nawiasy kwadratowe (a także "x" jako znak mnożenia), żeby uniknąć problemów przy rozpoznawaniu tych znaków przez interpreter wiersza poleceń.

ralcalc przechowuje wynik ostatniego działania, tak aby można było odwołać się do niego używając znaku "_".


        = 2^0,5
        2^0,5 = 1,41421

        = 1/_
        1/_ = 0,707107
 

FUNKCJE

Obsługiwane są funkcje sin, cos, tan, asin, acos, atan, sqrt, log (logarytm o podstawie 10) i ln (logarytm naturalny). Jednostką używaną w funkcjach trygonometrycznych jest radian. Używanie nawiasów nie jest konieczne, lecz jest zalecane tam, gdzie kolejność wykonywania działań może budzić wątpliwości. Funkcje wykonywane są w tym samym kroku co mnożenie/dzielenie, należy więc zwrócić na tę kwestię szczególną uwagę:


        = sin2x2
        sin2x2 = 1,81859

        = sin[2x2]
        sin[2x2] = -0,756802
 

STAłE

Można używać stałych pi (3,14159) oraz exp (2,71828) - są one traktowane tak jak każda inna liczba.  

ODCZYT Z PLIKU

Możliwe jest wykonywanie większej liczby obliczeń za jednym razem - należy podać je w pliku. Każdy wiersz tego pliku będzie wykonywany tak, jakby wywołane zostało polecenie ralcalc z danymi parametrami. Przykładowy plik może wyglądać następująco (zauważ brak polecenia =, czy też ralcalc):


        2^0,5
        1/_
        238/1064x100

Przy odczycie z pliku można korzystać z wejścia standardowego (stdin), tzn. wpisywać wszystko w oknie terminala, a każdy wiersz zostanie obliczony tak jak zwykle. Aby wyjść z programu, należy wpisać w nowym wierszu "q" albo "quit", nacisnąć Ctrl-D w celu oznaczenia końca pliku albo Ctrl-C by przerwać działanie programu ralcalc.

Jeśli w wierszu poleceń zostaną podane jakiekolwiek opcje odczytu z pliku, to wszelkie obliczenia podane w wierszu poleceń zostaną wykonane jako pierwsze. Jeśli podane zostaną obydwie opcje odczytu z pliku, to najpierw zostaną wykonane obliczenia z opcji -f, a następnie te z wejścia standardowego (stdin).  

PRZYKłADY

Proste obliczenie:


        = ln 1,0001
        ln 1,0001 = 99,995u

Wykładniczy format wyprowadzania liczb:


        = -e ln 1,0001
        ln 1,0001 = 9,9995e-05

Niezmodyfikowany format wyprowadzania liczb:


        = -r ln 1,0001
        ln 1,0001 = 0,000100

Format wyprowadzania liczb z określonym przedrostkiem SI:


        = -s m ln 1,0001
        ln 1,0001 = 0,099995
 

ZMIENNE śRODOWISKOWE

HOME
Określa lokalizację pliku .ralcalc_result.
 

WARTOśCI WYJśCIOWE

0
Powodzenie
1
Wystąpił co najmniej jeden błąd.
 

PLIKI

${HOME}/.ralcalc_result
Wynik ostatniego obliczenia, do którego można się później odwoływać za pomocą znaku "_". Należy zauważyć, że przenoszenie go między systemami o różnej architekturze nie zawsze jest możliwe.
 

DIAGNOSTYKA

ralcalc wyświetla komunikaty o wszystkich znalezionych błędach i wskazuje miejsca ich występowania (jeśli są to błędy wynikające z danych wprowadzonych przez użytkownika).

Jeśli w równaniu znajduje się nieznany znak, to zostanie zgłoszony błąd "nieznany symbol". Wskaźnik błędu zostanie ustawiony na niewłaściwym znaku.


        = 34/3@2

        Błąd: 34/3@2
         ^ nieznany symbol

Jeśli podano nieprawidłową liczbę, zostanie zgłoszony błąd "nieprawidłowa liczba". Wskaźnik błędu będzie pokazywał koniec nieprawidłowej liczby.


        = 3.14.159x2.8^2

        Błąd: 3.14.159x2.8^2
         ^ nieprawidłowa liczba

Jeśli nie zgadza się liczba nawiasów otwierających i zamykających, to zgłoszony zostanie błąd "nawias bez pary". Pozycja wskaźnika błędu nie ma tu żadnego znaczenia.


        = 5/[[2+3]*9

        Błąd: 5/[[2+3]*9       ^ nawias bez pary

Jeśli operator występuje w niewłaściwym miejscu, to zostanie zgłoszony błąd "nieprawidłowy operator". Wskaźnik błędu zostanie ustawiony na niewłaściwym znaku.


        = 3^^7

        Error: 3^^7
         ^ nieprawidłowy operator

Jeśli nawias znajduje się w niewłaściwym miejscu, to zostanie zgłoszony błąd "nieprawidłowy nawias". Błąd tego rodzaju często występuje łącznie z innymi błędami, więc na ekranie pojawi się więcej komunikatów. Najlepiej jest poprawić ten błąd jako pierwszy, ponieważ stanowi on zwykle główną przyczynę problemu. Znacznik błędu wskazuje nieprawidłowy nawias.


        = [2+]3

        Błąd: [2+]3
         ^ nieprawidłowy nawias

        Błąd: [2+]3
         ^ nieprawidłowy operator

Jeśli program ralcalc nie jest w stanie zarezerwować pamięci, zostanie zgłoszony błąd "brak wolnej pamięci".

Błąd wewnętrzny: Jeśli analizator składni rozpozna, że dwie liczby znajdują się bezpośrednio jedna po drugiej, lecz nie zgłosi błędu "nieprawidłowa liczba"", to zostanie zgłoszony błąd "dwie liczby bezpośrednio obok siebie". To nigdy nie powinno mieć miejsca.

Błąd wewnętrzny: Jeśli nieznany kod błędu zostanie przekazany do funkcji wyprowadzającej błędy, to zostanie zgłoszony "nieznany błąd" i wyświetlony kod błędu. To nigdy nie powinno mieć miejsca.  

BłęDY

Dopuszczalne jest tylko jednokrotne użycie parametru "-f nazwa_pliku".

Jeśli znajdziesz błąd w programie, zgłoś go na stronie http://bugs.launchpad.net/ralcalc  

AUTOR

Roger Light <roger@atchoo.org>


 

Index

NAME
SYNOPSIS
OPIS
OPCJE
FORMAT LICZBY
OPERATORY
FUNKCJE
STAłE
ODCZYT Z PLIKU
PRZYKłADY
ZMIENNE śRODOWISKOWE
WARTOśCI WYJśCIOWE
PLIKI
DIAGNOSTYKA
BłęDY
AUTOR

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