.\" -*- coding: UTF-8 -*-
.\"
.\" bc.1 - the *roff document processor source for the bc manual
.\"
.\" This file is part of GNU bc.
.\" Copyright (C) 1991-1994, 1997, 2000, 2003, 2006, 2017, 2024, 2025
.\" Free Software Foundation, Inc.
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License , or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; see the file COPYING. If not, see
.\" .
.\"
.\" You may contact the author by:
.\" e-mail: philnelson@acm.org
.\" us-mail: Philip A. Nelson
.\" Computer Science Department, 9062
.\" Western Washington University
.\" Bellingham, WA 98226-9062
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH bc 1 "2025. január 5" "GNU Project"
.SH NÉV
bc \- Lebegőpontos kalkulátor nyelv
.SH ÁTTEKINTÉS
\fBbc\fP [ \fB\-hlwsqv\fP ] [long\-options] [ \fI file ...\fP ]
.SH LEÍRÁS
\fBbc\fP egy olyan nyelv, amely lebegőpontos számolást nyújt, interaktív
végrehajtással. Van némi hasonlóság a C programozási nyelvvel. Egy standard
matematikai könyvtár megadható parancssor paraméterként. Ha szükséges, a
matematikai könyvtárat definiálni kell, mielőtt bármilyen más fájlt
feldolgoznánk. A \fBbc\fP a megadott fájlokban levő kódot a megadás sorrenjében
dolgozza fel. Miután minden fájlt feldolgozott a \fBbc\fP a szabványos
bemenetről vár további utasításokat. Minden kódot a beolvasás pillanatában
végrehajt. (Ha egy fájlban olyan utasítás található, amely megállítja a
feldolgozót, a \fBbc\fP nem fog a szabványos bemenetről olvasni.
.PP
A \fBbc\fP ezen implementációja sok bővítéssel rendelkezik a POSIX standardhoz
képest. Parancssor opcióval megadható, hogy a program ezeknél
figyelmeztessen, vagy dobja vissza őket. Ez a dokumentum az ezen feldolgozó
által elfogadott nyelvet írja le. A kiterjesztések természetesen jelölésre
kerülnek.
.SS KAPCSOLÓK
.IP "\-h, \-\-help"
Print the usage and exit.
.IP "\-i, \-\-interactive"
Force interactive mode.
.IP "\-l, \-\-mathlib"
Definiálja a standard matematikai könyvtárat.
.IP "\-w, \-\-warn"
Figyelmeztet a POSIX \fBbc\fP\-hez képest használt kiterjesztésekre.
.IP "\-s, \-\-standard"
Csak a pontos POSIX \fBbc\fP nyelvet dolgozza fel.
.IP "\-q, \-\-quiet"
Do not print the normal GNU bc welcome.
.IP "\-v, \-\-version"
Print the version number and copyright and quit.
.SS SZÁMOK
The most basic element in \fBbc\fP is the number. Numbers are arbitrary
precision numbers. This precision is both in the integer part and the
fractional part. All numbers are represented internally in decimal and all
computation is done in decimal. (This version truncates results from divide
and multiply operations.) There are two attributes of numbers, the length
and the scale. The length is the total number of decimal digits used by
\fBbc\fP to represent a number and the scale is the total number of decimal
digits after the decimal point. For example:
.nf
.RS
.000001 számnak a hossza és a léptéke is 6.
míg az 1935.000 számnak a hossza 7, a léptéke 3.
.RE
.fi
.SS VÁLTOZÓK
A számokat két fajta változóban lehet tárolni, egyszerű változóban vagy
tömbben. Mind az egyszerű, mind a tömbváltozónak van neve. A neveknek
betűvel kell kezdődniük, ezt követhetik számok, betűk vagy
aláhúzások. Minden betűnek kisbetűnek kell lennie. (A teljes alfanumerikus
nevek már egy kiterjesztés. A POSIX \fBbc\fP\-ben minden név egy kisbetűből
áll.) A változó típusa a kontextusból tisztán kiderül, mivel minden tömb
változót egy szögletes zárójel pár ([]) követ.
.PP
Négy speciális változó van, \fBscale, ibase, obase,\fP és \fBlast\fP. A \fBscale\fP
azt definiálja, hogy néhány művelet a tizdes pont után hány számjegyet
használjon. A \fBscale\fP alapértelmezett értéke 0. Az \fBibase\fP és az \fBobase\fP
definiálja a bemeneti és a kimeneti számrendszer konverziót. Az
alapértelmezett számrendszer mind a bemenetre, mind a kimenetre 10\-es. A
\fBlast\fP (kiterjesztés) változóban az utolsó kiírt érték szerepel. Ez később
kerül részletezésre. Ezeknek vátlozóknak lehet értéket adni, de kifejezésben
is használhatóak.
.SS MEGJEGYZÉS
A megjegyzések a \fBbc\fP\-ben a \fB/*\fP karakterekkel kezdődnek és a \fB*/\fP
karakterek jelzik a végét. A megjegyzések bárhol megjelenhetnek, és a
bemenetben egy szóközt jelentenek. (Ez azt jelenti, hogy a megjegyzések
elhatárolnak más objektumokat. Például, egy megjegyzés nem lehet egy
változónév közepén.) A megjegyzésekben bármennyi újsor lehet (sor vége), a
megjegyzés kezdete és vége között.
.PP
To support the use of scripts for \fBbc\fP, a single line comment has been
added as an extension. A single line comment starts at a \fB#\fP character and
continues to the next end of the line. The end of line character is not
part of the comment and is processed normally.
.SS KIFEJEZÉSEK
A számokat kifejezésekkel és utasításokkal lehet manipulálni. Mivel a
nyelvet interaktívra készítették, az utasítások és a kifejezések rögtön
végrehajtódnak. Nincs "fő" program (main függvény). A kód olyan sorrendben
hajtódik végre, ahogy a \fBbc\fP beolvassa. (A függvények, később kerülnek
leírásra, a beolvasás sorrendjében kerülnek definiálásra.)
.PP
A simple expression is just a constant. \fBbc\fP converts constants into
internal decimal numbers using the current input base, specified by the
variable \fBibase\fP. (There is an exception in functions.) The valid values
for \fBibase\fP are 2 through 36. (Bases greater than 16 are an extension.)
Assigning a value outside this range to \fBibase\fP will result in a value of 2
or 36. Input numbers may contain the characters 0\-9 and A\-Z. (Note: They
must be capitals. Lower case letters are variable names.) Single digit
numbers always have the value of the digit regardless of the value of
\fBibase\fP. (i.e.\& A = 10.) For multi\-digit numbers, \fBbc\fP changes all input
digits greater or equal to ibase to the value of \fBibase\fP\-1. This makes the
number \fBZZZ\fP always be the largest 3 digit number of the input base.
.PP
A teljes kifejezések hasonlóak a többi magas szintű nyelvben levőkhöz.
Mivel csak egyetlen típusú szám van, nincs szabály a típusok keverésének
kezelésére. Minden kifejezésnek van egy pontossága. Ez az eredeti számokból,
az elvégzett műveletekból és még sok egyébből tevődik össze, az értéke a
\fBscale\fP változóban található. Ezen változó legális értékei a 0\-tól a C
nyelvben egész számnak megadható legnagyobb értékig terjednek.
.PP
In the following descriptions of valid expressions, "expr" refers to a
complete expression and "var" refers to a simple or an array variable. A
simple variable is just a
.RS
\fInév\fP
.RE
míg egy tömbre a
.RS
leírásával hivatkozhatunk. Hacsak másként nem specifikáljuk, az eredmény
pontossága a kifejezések pontosságának a maximuma lesz.
.RE
Unless specifically mentioned the scale of the result is the maximum scale
of the expressions involved.
.IP "\- expr"
Az eredmény a kifejezés negáltja.
.IP "++ var"
A változó értéke eggyel nő, és az eredmény a változó új értéke lesz.
.IP "\-\- var"
A változó értéke eggyel csökken, és az eredmény a változó új értéke lesz.
.IP "var ++"
The result of the expression is the value of the variable and then the
variable is incremented by one.
.IP "var \-\-"
A kifejezés eredménye a változó eredeti értéke, majd a változó értéke
csökken eggyel.
.IP "expr + expr"
Az eredmény a két kifejezés összege.
.IP "expr \- expr"
Az eredmény a két kifejezés különbsége.
.IP "expr * expr"
Az eredmény a két kifejezés szorzata.
.IP "expr / expr"
Az eredmény a két kifejezés hányadosa. Az eredmény pontosságát a \fBscale\fP
változó értéke határozza meg.
.IP "expr % expr"
Az eredmény a "maradék", amely a következőképpen kerül kiszámolásra. Az a%b
kiszámolásához először, kiszámolásra kerül az a/b, \fBscale\fP számjegyre. Az
eredmény a következőképpen adódik: a\-(a/b)*b, a pontossága a
\fBscale\fP+scale(b) és scale(a) közül a nagyobb lesz. Ha a \fBscale\fP egyenlő
nullával, vagy mindkét kifejezés egész, a maradék is egész lesz.
.IP "expr ^ expr"
The result of the expression is the value of the first raised to the
second. The second expression must be an integer. (If the second expression
is not an integer, a warning is generated and the expression is truncated to
get an integer value.) The scale of the result is \fBscale\fP if the exponent
is negative. If the exponent is positive the scale of the result is the
minimum of the scale of the first expression times the value of the exponent
and the maximum of \fBscale\fP and the scale of the first expression. (e.g.\&
scale(a^b) = min(scale(a)*b, max( \fBscale,\fP scale(a))).) It should be
noted that expr^0 will always return the value of 1.
.IP "( expr )"
Ez megváltoztatja a kifejezés kiértékelésének standard precedenciáját.
.IP "var = expr"
A változó értéke a kifejezés lesz.
.IP "var = expr"
Ez ekvivalens a "var = var expr" kifejezéssel, azzal a
kivétellel, hogy a "var" rész csak egyszer értékelődik ki. Ez akkor okozhat
különbséget, ha a "var" egy tömb.
.PP
Relational expressions are a special kind of expression that always evaluate
to 0 or 1, 0 if the relation is false and 1 if the relation is true. These
may appear in any valid expression. (POSIX bc requires that relational
expressions are used only in if, while, and for statements and that only one
relational test may be done in them.) The relational operators are
.IP "expr1 < expr2"
Az eredmény 1, ha az expr1 kisebb, mint az expr2.
.IP "expr1 <= expr2"
Az eredmény 1, ha az expr1 kisebb, vagy egyenlő, mint az expr2.
.IP "expr1 > expr2"
Az eredmény 1, ha az expr1 nagyobb, mint az expr2.
.IP "expr1 >= expr2"
Az eredmény 1, ha az expr1 nagyobb, vagy egyenlő, mint az expr2.
.IP "expr1 == expr2"
Az eredmény 1, ha az expr1 egyenlő az expr2\-vel.
.IP "expr1 != expr2"
Az eredmény 1, ha az expr1 nem egyenlő az expr2\-vel.
.PP
Boolean operations are also valid. (POSIX \fBbc\fP does NOT have boolean
operations). The result of all boolean operations are 0 and 1 (for false and
true) as in relational expressions. The boolean operators are:
.IP !expr
Az eredmény 1, ha a kifejezés 0.
.IP "expr && expr"
Az eredmény 1, ha a mindkét kifejezés nem 0.
.IP "expr || expr"
Az eredmény 1, ha a bármelyik kifejezés nem 0.
.PP
A kifejezések precedenciája a következő (alacsonytól a magas felé):
.nf
.RS
|| operátor, balról asszociatív
&& operátor, balról asszociatív
! operátor, nem asszociatív
Relációs operátorok, balról asszociatív
Értékadó operátor, jobbról asszociatív
+ és \- operátorok, balról associative
*, / és % operátorok, balról asszociatív
^ operátor, jobbról asszociatív
unáris \- operátor, nem asszociatív
++ és \-\- operátorok, nem asszociatív
.RE
.fi
.PP
Ez a precedencia úgy van megválasztva, hogy a POSIX \fBbc\fP alá programok is
korrekten fussanak. Emiatt, a relációs és logikai operátorokat az értékadó
operátoroknál néha szokatlan eredmény is kijöhet. Lásd a következő
kifejezést:
.RS
a = 3 < 5
.RE
.PP
A legtöbb C programozó ezt úgy értelmezi, hogy a "3 < 5" (az értéke 1)
kerül az "a" változóba. A \fBbc\fP itt a következőt csinálja, hozzárendeli a
3\-at az "a" változóhoz, majd a 3\-at összehasonlítja az 5\-tel. A legjobb,
hogyha értékadó operátort használsz relációs, és logikai operátorokkal,
akkor használsz zárójeleket.
.PP
Van néhány egyéb speciális kifejezés, amelyet még a \fBbc\fP nyújt. Ezek a
felhasználó által definiálható függvények, és a standard függvények
hívása. Ezek a következő alakban jelennek meg: \fIname\fP\fB(\fP\fIparameters\fP\fB)\fP
A függvényekhez lásd még a felhasználó által definiált függvények
fejezetet. A standard függvények a következőek:
.IP "length ( expression )"
A length függvény értéke a kifejezésben megadott szám értékes jegyeinek
száma.
.IP "read ( )"
A read függvény (kiterjesztés) beolvas egy számot a szabványos bemenetről,
függetlenül attól, hogy a függvény hol található. Figyelmeztetés: ez
problémát okozhat, ha mind a program, mind az adatok a standard bementről
jönnek. A legjobb, ha ezt a függvényt csak előre megírt programoknál
használjuk, amely adatokat kér a felhasználótól, de nem engedi meg, hogy a
felhasználó program kódot is beírjon. A read függvény értéke a szabványos
bemenetről beolvasott szám értéke, az \fBibase\fP változó értékét, mint
számrendszert használva a konverzió alapjául.
.IP "scale ( expression )"
A scale függvény értéke a kifejezés tizedespont mögött szereplő
számjegyeinek száma.
.IP "sqrt ( expression )"
Az sqrt függvény értéke a kifejezés értékének a négyzetgyökével egyenlő. Ha
a kifejezés negatív, egy futási hiba generálódik.
.SS UTASÍTÁSOK
Statements (as in most algebraic languages) provide the sequencing of
expression evaluation. In \fBbc\fP statements are executed "as soon as
possible". Execution happens when a newline in encountered and there is one
or more complete statements. Due to this immediate execution, newlines are
very important in \fBbc\fP. In fact, both a semicolon and a newline are used as
statement separators. An improperly placed newline will cause a syntax
error. Because newlines are statement separators, it is possible to hide a
newline by using the backslash character. The sequence "\e",
where is the newline appears to \fBbc\fP as whitespace instead of
a newline. A statement list is a series of statements separated by
semicolons and newlines. The following is a list of \fBbc\fP statements and
what they do: (Things enclosed in brackets ([]) are optional parts of the
statement.)
.IP expression
This statement does one of two things. If the expression starts with
" ...", it is considered to be an
assignment statement. If the expression is not an assignment statement, the
expression is evaluated and printed to the output. After the number is
printed, a newline is printed. For example, "a=1" is an assignment
statement and "(a=1)" is an expression that has an embedded assignment. All
numbers that are printed are printed in the base specified by the variable
\fBobase\fP. The valid values for \fB obase\fP are 2 through BC_BASE_MAX. (See
the section LIMITS.) For bases 2 through 16, the usual method of writing
numbers is used. For bases greater than 16, \fBbc\fP uses a multi\-character
digit method of printing the numbers where each higher base digit is printed
as a base 10 number. The multi\-character digits are separated by spaces.
Each digit contains the number of characters required to represent the base
ten value of "obase\-1". Since numbers are of arbitrary precision, some
numbers may not be printable on a single output line. These long numbers
will be split across lines using the "\e" as the last character on a line.
The maximum number of characters printed per line is 70. Due to the
interactive nature of \fBbc\fP, printing a number causes the side effect of
assigning the printed value to the special variable \fBlast\fP. This allows the
user to recover the last value printed without having to retype the
expression that printed the number. Assigning to \fBlast\fP is valid and will
overwrite the last printed value with the assigned value. The newly
assigned value will remain until the next number is printed or another value
is assigned to \fBlast\fP. (Some installations may allow the use of a single
period (.) which is not part of a number as a short hand notation for
\fBlast\fP.)
.IP string
A string a kimenetre íródik ki. A stringek idézőjellel kezdődnek, és
bármilyen karaktert tartalmazhatnak a következő idézőjelig. Egyetlen
karakter sem kerül értelmezésre, még az újsor karakter sem. A string kiírása
után nem íródik ki újsor karakter.
.IP "\fBprint\fP list"
A print utasítás (kiterjesztés), a kiírás egy újabb módozatát kínálja. A
"list" egy string és kifejezés lista, vesszővel elválasztva. Minden string
vagy kifejezés a lista sorrendjében íródik ki. Záró újsor nem íródik ki. A
kifejezések kiértékelődnek, és az eredményük a \fBlast\fP változóban tárolásra
kerül. A stringek pedig egyszerűen kiírásra kerülnek, speciális karaktereket
is tartalmazhatnak. A speciális karakterek a backslalsh karakterrel
kezdődnek (\e). A speciális karakterek a következőek: "a" (figyelmeztetés,
vagy bip), "b" (backspace), "f" (lapdobás), "n" (újsor), "r" (kocsi vissza),
"q" (idézőjel), "t" (tabulátor) és "\e" (backslash). Minden más, a backslash
után levő karaktert figyelmen kívül hagy a program.
.IP "{ utasítás_lista }"
Ez egy összetett utasítás. Ennek segítségével lehet több végrehajtandó
utasítást egybekapcsolni.
.IP "\fBif\fP ( kifejezés ) \fBthen\fP utasítás1 [\fBelse\fP utasítás2]"
Az if kiértékeli a kifejezést, és végrehajtja az utasítás1\-et, vagy az
utasítás2\-t, a kifejezés értékétől függően. Ha a kifejezés eredménye nem
nulla, az utasítás1 hajtódik végre. Ha az utasítás2 létezik, és a kifejezés
eredménye nulla, az utasítás2 hajtódik végre. (Az else ág kiterjesztés.)
.IP "\fBwhile\fP ( kifejezés ) utasítás"
A while utasítás mindaddig végrehajtja az utasítást, amíg a kifejezés
eredménye nem nulla. Az utasítás minden végrehajtása előtt kiértékeli a
kifejezést. A ciklus akkor fejeződik be, ha a kifejezés eredménye nulla
lesz, vagy ha végrehajtódik egy break utasítás.
.IP "\fBfor\fP ( [kifejezés1] ; [kifejezés2] ; [kifejezés3] ) utasítás"
A for utasítás egy utasítás ismételt végrehajtását vezérli. A kifejezés1 a
ciklus előtt kiértékelődik. A kifejezés2 az utasítás minden végrehajtása
előtt kiértékelődik. Ha nem nulla, az utasítás végrehajtódik, ha nulla, a
ciklus véget ér. Az utasítás minden végrehajtása után, a kifejezés3
kiértékelődik, mielőtt a kifejezés2 kiszámolódna. Ha a kifejezés1 és a
kifejezés3 hiányzik, a kiértékelődésük helyén semmi nem fog történni. Ha a
kifejezés2 hiányzik, az olyan, mintha a kifejezés2 helyén egy olyan
kifejezés lenne, amelynek az eredménye mindig 1. (Az opcionális kifejezések
egy kiterjesztés.) A következő ekvivalens kódokat ad a for utasításra:
.nf
.RS
kifejezés1;
while (kifejezés2) {
utasítás;
kifejezés3;
}
.RE
.fi
.IP \fBbreak\fP
Ezzel az utasítással ki lehet lépni a legbelső while, vagy for utasításból.
.IP \fBcontinue\fP
Ez az utasítás (kiterjesztés) azt eredményezi, hogy a legbelső for utasítás
egy új ciklust kezd.
.IP \fBhalt\fP
Ez az utasítás (kiterjesztés), ha végrehajtódik, azt eredményezi, hogy a
\fBbc\fP kilép.
.IP \fBreturn\fP
Nulla értékkel tér vissza egy függvényből (lásd még a függvények fejezetet).
.IP "\fBreturn\fP ( kifejezés )"
Return the value of the expression from a function. (See the section on
functions.) As an extension, the parenthesis are not required.
.SS "PSZEUDO UTASÍTÁSOK"
Ezek az utasítások a tradicionális értelemben nem utasítások. Nem hajtódnak
végre. Funkciójukat "fordítási" időben fejtik ki.
.IP \fBlimits\fP
Kiírja a \fBbc\fP adott verziója által használt határokat. Kiterjesztés.
.IP \fBquit\fP
Ha a quit utasítást beolvassa, a \fBbc\fP feldolgozó kilép. Nem számít, hogy az
utasítás hol található (pl. az "if (0 == 1) quit" hatására is kilép a
\fBbc\fP.)
.IP \fBwarranty\fP
Kiírja a figyelmeztető üzenetet. Kiterjesztés.
.SS FÜGGVÉNYEK
A függvényekkel definiálhatunk számításokat, amelyeket csak később kívánunk
végrehajtani. A függvények a \fBbc\fP \-ben mindig egy értéket számolnak, és azt
visszaadják a hívónak. A függvény definíciója "dinamikus" abban az
értelemben, hogy mindaddig definiálatlan, amíg a feldolgozó nem találkozik
vele a bemeneten. Ez a definícó mindaddig használható, amíg egy ugyanezen
névű függvény definicóval nem találkozik. Az új definíció felülírja a
régit. Egy függvény definíciója a következőképpen néz ki:
.nf
.RS
\fBdefine \fP\fIname \fP\fB( \fP\fIparameters \fP\fB) { \fP\fInewline auto_list statement_list \fP\fB}\fP
.RE
.fi
A függvényhívás is egy kifejezés, a következő formában:
"\fIname\fP\fB(\fP\fIparameters\fP\fB)\fP".
.PP
Parameters are numbers or arrays (an extension). In the function
definition, zero or more parameters are defined by listing their names
separated by commas. All parameters are call by value parameters. Arrays
are specified in the parameter definition by the notation "\fIname\fP\fB[]\fP".
In the function call, actual parameters are full expressions for number
parameters. The same notation is used for passing arrays as for defining
array parameters. The named array is passed by value to the function.
Since function definitions are dynamic, parameter numbers and types are
checked when a function is called. Any mismatch in number or types of
parameters will cause a runtime error. A runtime error will also occur for
the call to an undefined function.
.PP
Az \fIauto_list\fP egy opcionális változó lista, amely "helyi" változókat
tartalmazza. A szintaxisa: "\fBauto \fP\fInév\fP, ... ;". (A pontosvessző
opcionális.) Minden \fInév\fP egy auto változó neve. Tömbök is definiálhatóak
így, a szokásos módon. Ezek a változók a vermen kapnak helyet, a függvény
belépése után. A változók ezután inicializálásra kerülnek nulla
kezdőértékkel, és a függvény végrehajtása során használhatóak. Amikor a
függvény kilép, ezeket a változókat eltávolítja a veremből, így az eredeti
értékük helyreállítódik. A paraméterek is auto változók, amelyek a függvény
meghívásakor kapják meg értéküket. Az auto változók különböznek a
tradícionális helyi változóktól a következő dologban: ha A meghívja a B
függvényt, B látja az A auto változóit, hacsak B\-ben nincs ugyanezen néven
is auto változó definiálva. Azon tény miatt, hogy az auto változók és a
paraméterek egy vermen kapnak helyet, a \fBbc\fP kezeli a rekurzív függvényeket
is.
.PP
A függvény törzse \fBbc\fP utasítások listája. Az utasításokat pontosvesszők,
vagy újsorok választják el. A return utasítás hatására a függvény
végrehajtása véget ér, és visszatér egy értékkel. Az első forma, a
"\fBreturn\fP", 0\-át ad vissza a hívónak, míg a második, "\fBreturn ( \fP\fIkifejezés \fP\fB)\fP", kiértékeli a kifejezést, és az eredményt adja vissza. A
függvény végén, ha mást nem írunk ki, mindig van egy "\fBreturn (0)\fP", ez
megkímél attól, hogy explicite ki kelljen írni a return utasítást.
.PP
A függvényeknél megváltozik az \fBibase\fP változó használata is. A függvény
törzsében szereplő minden konstans, a függvény hívásakor használatos
\fBibase\fP alapján konvertálódik. Ha az \fBibase\fP\-t megváltoztatjuk egy
függvényben, annak nem lesz hatása, kivéve a \fBread\fP standard függvényt,
amely mindig az \fBibase\fP aktuális értékét használja a számok
konvertálásához.
.PP
Several extensions have been added to functions. First, the format of the
definition has been slightly relaxed. The standard requires the opening
brace be on the same line as the \fBdefine\fP keyword and all other parts must
be on following lines. This version of \fBbc\fP will allow any number of
newlines before and after the opening brace of the function. For example,
the following definitions are valid.
.nf
.RS
\f(CR
define d (n) { return (2*n); }
define d (n)
{ return (2*n); }\fR
.\fR
.RE
.fi
.PP
Functions may be defined as \fBvoid\fP. A void funtion returns no value and
thus may not be used in any place that needs a value. A void function does
not produce any output when called by itself on an input line. The key word
\fBvoid\fP is placed between the key word \fBdefine\fP and the function name. For
example, consider the following session.
.nf
.RS
\f(CR
define py (y) { print "\-\-\->", y, "<\-\-\-", "\en"; }
define void px (x) { print "\-\-\->", x, "<\-\-\-", "\en"; }
py(1)
\-\-\->1<\-\-\-
0
px(1)
\-\-\->1<\-\-\-\fR
.\fR
.RE
.fi
\f(CRSince \fBpy\fP is not a void function, the call of \fBpy(1)\fP prints the
desired output and then prints a second line that is the value of the
function. Since the value of a function that is not given an explicit
return statement is zero, the zero is printed. For \fBpx(1)\fP, no zero is
printed because the function is a void function.
.PP
Also, call by variable for arrays was added. To declare a call by variable
array, the declaration of the array parameter in the function definition
looks like "\fI*name\fP\fB[]\fP". The call to the function remains the same as
call by value arrays.
.SS "MATEMATIKAI KÖNYVTÁR"
Ha a \fBbc\fP\-t a \fB\-l\fP opcióval indítjuk, a matematikai könyvtár betöltődik,
és a pontosság 20\-as lesz. A matematikai függvények azzal a pontossággal
számolják ki az eredményt, amely a meghívásukkor be volt állítva. A
matematikai könyvtár a következő függvényeket definiálja:
.IP "s (\fIx\fP)"
Az x (radián) színusza.
.IP "c (\fIx\fP)"
Az x (radián) koszínusza.
.IP "a (\fIx\fP)"
The arctangent of x, arctangent returns radians.
.IP "l (\fIx\fP)"
Az x természetes logaritmusa.
.IP "e (\fIx\fP)"
Az e x\-edik hatványa.
.IP "j (\fIn,x\fP)"
Az n\-ed rendű Bessel fuggvenye x\-nek.
.SS PÉLDÁK
A /bin/sh\-ban a következő utasítás visszaadja a "pi" értékét a \fBpi\fP
környezeti változóban.
.RS
\f(CR pi=$(echo "scale=10; 4*a(1)" | bc \-l)\fR
.\fR
.RE
.PP
Az itt következő példában a matematikai könyvtárban található hatvány
függvény definícióját mutatjuk be. A függvény POSIX \fBbc\fP nyelven íródott.
.nf
.RS
\f(CR
scale = 20\fR
\f(CR/* Uses the fact that e^x = (e^(x/2))^2
When x is small enough, we use the series:
e^x = 1 + x + x^2/2! + x^3/3! + ...
*/\fR
\f(CRdefine e(x) {
auto a, d, e, f, i, m, v, z\fR
\f(CR /* Check the sign of x. */
if (x<0) {
m = 1
x = \-x
}\fR
\f(CR /* Precondition x. */
z = scale;
scale = 4 + z + .44*x;
while (x > 1) {
f += 1;
x /= 2;
}\fR
\f(CR /* Initialize the variables. */
v = 1+x
a = x
d = 1\fR
\f(CR for (i=2; 1; i++) {
e = (a *= x) / (d *= i)
if (e == 0) {
if (f>0) while (f\-\-) v = v*v;
scale = z
if (m) return (1/v);
return (v/1);
}
v += e
}
}\fR
.\fR
.RE
.fi
.PP
A következő kód a \fBbc\fP kiterjesztett szolgáltatásait használja, egy
egyszerű csekkfüzet egyenleg kiszámolására. Legjobb, ha ezt a programot
fájlba lementjük, hogy többször is használhassuk anélkül, hogy újra be
kelljen gépelni.
.nf
.RS
\f(CR
scale=2
print "\enCheck book program!\en"
print " Remember, deposits are negative transactions.\en"
print " Exit by a 0 transaction.\en\en"\fR
\f(CRprint "Initial balance? "; bal = read()
bal /= 1
print "\en"
while (1) {
"current balance = "; bal
"transaction? "; trans = read()
if (trans == 0) break;
bal \-= trans
bal /= 1
}
quit\fR
.\fR
.RE
.fi
.PP
A következő függvény a faktoriális rekurzív definíciója.
.nf
.RS
\f(CR
define f (x) {
if (x <= 1) return (1);
return (f(x\-1) * x);
}\fR
.\fR
.RE
.fi
.SS "READLINE AND LIBEDIT OPTIONS"
GNU \fBbc\fP can be compiled (via a configure option) to use the GNU
\fBreadline\fP input editor library or the BSD \fBlibedit\fP library. This allows
the user to do editing of lines before sending them to \fBbc\fP. It also
allows for a history of previous lines typed. When this option is selected,
\fBbc\fP has one more special variable. This special variable, \fBhistory\fP is
the number of lines of history retained. For \fBreadline\fP, a value of \-1
means that an unlimited number of history lines are retained. Setting the
value of \fBhistory\fP to a positive number restricts the number of history
lines to the number given. The value of 0 disables the history feature.
The default value is 100. For more information, read the user manuals for
the GNU \fBreadline\fP, \fBhistory\fP and BSD \fBlibedit\fP libraries. One can not
enable both \fBreadline\fP and \fBlibedit\fP at the same time.
.SS ELTÉRÉSEK
This version of \fBbc\fP was implemented from the POSIX P1003.2/D11 draft and
contains several differences and extensions relative to the draft and
traditional implementations. It is not implemented in the traditional way
using \fBdc\fP(1). This version is a single process which parses and runs a
byte code translation of the program. There is an "undocumented" option
(\-c) that causes the program to output the byte code to the standard output
instead of running it. It was mainly used for debugging the parser and
preparing the math library.
.PP
A különbségek legfőbb forrásai a kiterjesztések, hol egy szolgáltatás lett
kiterjesztve, hogy több lehetősége legyen, hol pedig új szolgáltatás lett
létrehozva. A következó lista megmutatja a különbségeket és a
kiterjesztéseket.
.IP "LANG environment"
Ez a verzió nem követi a POSIX szabványt a LANG környezeti változó
használatában, és minden környezeti változó az "LC_" prefixszel kezdődik.
.IP nevek
A tradícionális és a POSIX \fBbc\fP \-ben a funkciók, változók és tömbök nevei
csak egy karakter hosszúak lehettek. Itt már több karaktert is
használhatunk, de a neveknek betűvel kell kezdődni és csak betűket számokat
és aláhúzásjeleket tartalmazhatnak.
.IP Stringek
A stringek nem tartalmazhatnak NUL (ASCII nulla) karaktert. A POSIX szerint
bármilyen karakter lehet egy stringben.
.IP last
A POSIX \fBbc\fP\-ben nincs \fBlast\fP változó. Néhány implementáció a pontot (.)
használja erre a célra.
.IP összehasonlítások
A POSIX \fBbc\fP csak az if, vagy a while utasításban enged meg
összehasonlításokat, vagy a for utasítás második kifejezésében. Továbbá,
utasításonként csak egy relációs operátor van megengedve.
.IP "if utasítás, else ág"
A POSIX \fBbc\fP\-ben nincs else ág.
.IP "for utasítás"
A POSIX \fBbc\fP\-ben minden kifejezésnek szerepelnie kell.
.IP "&&, ||, !"
A POSIX \fBbc\fP\-ben nincsenek logikai operátorok.
.IP "read függvény"
A POSIX \fBbc\fP\-ben nincs read függvény.
.IP "print utasítás"
A POSIX \fBbc\fP\-ben nincs print utasítás.
.IP "continue utasítás"
A POSIX \fBbc\fP\-ben nincs continue utasítás.
.IP "return utasítás"
POSIX \fBbc\fP requires parentheses around the return expression.
.IP "tömb paraméterek"
POSIX \fBbc\fP does not (currently) support array parameters in full. The
POSIX grammar allows for arrays in function definitions, but does not
provide a method to specify an array as an actual parameter. (This is most
likely an oversight in the grammar.) Traditional implementations of \fBbc\fP
have only call by value array parameters.
.IP "function format"
POSIX \fBbc\fP requires the opening brace on the same line as the \fBdefine\fP key
word and the \fBauto\fP statement on the next line.
.IP "=+, =\-, =*, =/, =%, =^"
A POSIX \fBbc\fP\-ben nincs szükség ezekre a "régi stílusú" értékadó
operátorokra. Ez a verzió megengedi ezeket. Használd a limits utasítást,
hogy megtudd, hogy az installált verzió megengedi\-e ezeket. Ha igen, az "a
=\- 1" kifejezés csökkenti az \fBa\fP értékét 1\-gyel, egyébként pedig az \fBa\fP
értékét beállítja \-1\-re.
.IP "szóközök a számokban"
A \fBbc\fP más implementációi megengedik szóközök használatát a számokban.
Például, az "x=1 3" kifejezés az x változóhoz hozzárendeli a 13\-at. Ebben a
\fBbc\fP\-ben ugyanez az utasítás szintaktikai hibát ad.
.IP "hibák és végrehajtás"
Ez az impelmentáció különbözik a többitől abban, hogy mely kódokat hajtja
végre, mikor egy szintaktikai, vagy más hibába belefut. Ha egy szintaktikai
hibát talál a függvény definíciójában, a hibakezelő megpróbálja megtalálni
az utasítás elejét, és folytatni a függvény feldolgozását. Ha a szintaktikai
hiba a függvény törzsében következik be, a függvény nem lesz definiálva, és
nem lehet meghívni sem. Az interaktív végrehajtási blokkokban levő
szintaktikai hibák érvénytelenítik az egész blokkot. Egy végrehajtási
blokknak minősül az az utasítássor, amely a következő soremelésig tart.
Például:
.nf
.RS
a = 1
b = 2
.RE
.fi
ez két végrehajtási blokk és
.nf
.RS
{ a = 1
b = 2 }
.RE
.fi
ez egy. A futási\-hibák hatására a jelenlegi blokk végrehajtása
befejeződik. A futási\-figyelmezetetés nem állítja meg a blokk végrehajtását.
.IP Megszakítások
Egy interaktív végrehajtás során, a SIGINT szignál (általában a terminálról
érkező Control\-C karakter generálja) hatására a jelenlegi blokk végrehajtása
megszakad. Kijelzésre kerül egy "futási" hiba, hogy melyik függvény lett
megszakítva. Miután minden futási struktúra kiürül, egy üzenet kerül
kiírásra a felhasználó felé, hogy a \fBbc\fP kész további adatok
fogadására. Minden korábban definiált függvény továbbra is definiálva marad,
és minden nem\-auto változóban a megszakításkori érték lesz. Minden auto
változó (a függvények paraméterei is) törlésre kerül a kiürítési eljárás
során. Nem\-interaktív végrehajtáskor a SIGINT szignál az egész \fBbc\fP futását
megszakítja.
.SS HATÁROK
A következő határok vannak beépítve ebbe a \fBbc\fP \-be. Néhányuk egy
installálással megváltoztatható. Az aktuális értékeik megszerzéséhez
használd a limits utasítást.
.IP BC_BASE_MAX
The maximum output base is at least 10^9. The maximum input base is 16.
.IP BC_DIM_MAX
Ez a jelenlegi pontossági határ, 655535. Az ön installációjában más lehet.
.IP BC_SCALE_MAX
The number of digits after the decimal point is limited to INT_MAX digits.
Also, the number of digits before the decimal point is limited to INT_MAX
digits.
.IP BC_STRING_MAX
A karakterek maximális száma egy stringben INT_MAX.
.IP exponens
A hatványozás operátor (^) kitevőjének maximum értékét a LONG_MAX határozza
meg.
.IP "változó nevek"
A jelenlegi limit az egyedi nevekre 32767 mind az egyszerű változókra, mind
a tömbökre és a függvényekre.
.SH "KÖRNYEZETI VÁLTOZÓK"
The following environment variables are processed by \fBbc\fP:
.IP POSIXLY_CORRECT
This is the same as the \fB\-s\fP option.
.IP BC_ENV_ARGS
This is another mechanism to get arguments to \fBbc\fP. The format is the same
as the command line arguments. These arguments are processed first, so any
files listed in the environment arguments are processed before any command
line argument files. This allows the user to set up "standard" options and
files to be processed at every invocation of \fBbc\fP. The files in the
environment variables would typically contain function definitions for
functions the user wants defined every time \fBbc\fP is run.
.IP BC_LINE_LENGTH
This should be an integer specifying the number of characters in an output
line for numbers. This includes the backslash and newline characters for
long numbers. As an extension, the value of zero disables the multi\-line
feature. Any other value of this variable that is less than 3 sets the line
length to 70.
.SH DIAGNOSZTIKA
Ha egy a parancssorban szereplő fájl nem nyitható meg, a \fBbc\fP üzen, hogy a
fájl nem elérhető, és kilép. Ugyanígy, a fordítási és a futási idejű
diagnosztika is önmagyarázó.
.SH HIBÁK
A hibakezelés még nem túl jó.
.PP
Email bug reports to \fBbug\-bc@gnu.org\fP. Be sure to include the word \*(lqbc\*(rq
somewhere in the \*(lqSubject:\*(rq field.
.SH SZERZŐ
.nf
Philip A. Nelson
philnelson@acm.org
.fi
.SH KÖSZÖNETNYILVÁNÍTÁS
A szerző szeretné megköszönni Setve Sommars\-nak (Steve.Sommars@att.com),
hogy oly nagy mértékben segített az implementáció tesztelésében. Sok nagyon
jó tanácsot adott. Segítségével egy sokkal jobb terméket sikerült
létrehozni.
.PP
.SH FORDÍTÁS
A kézikönyv magyar fordítását a
Csehi András
készítette.
.PP
Ez a fordítás ingyenes dokumentáció; lásd a
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License 3
.UE . Vagy újabb verzióját a szerzői jogi feltételekkel kapcsolatban.
Feltételezzük, hogy NEM FELELŐSSÉG.
.PP
Ha hibát talál a kézikönyv oldal fordításában, küldje el a
e-mail cím:
.MT
TODO.
.ME .