.\"
.\" dc.1 - the *roff document processor source for the dc manual
.\"
.\" This file is part of GNU dc.
.\" Copyright (C) 1994, 1997 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, write to
.\" the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH DC 1 "1997-03-25" "GNU Project"
.ds dc \fIdc\fP
.ds Dc \fIDc\fP
.SH NV
dc \- tetszleges pontossg szmolgp
.SH TTEKINTS
dc
.SH LERS
.PP
A \*(dc egy korltlan pontossg szmtsok elvgzsre alkalmas
fordtott-lengyel (postfix) asztali szmolgp, amely lehetsget ad
makrk definilsra s vgrehajtsra. A bemenetet a szabvnyos bemenetrl
veszi; ha argumentumot adsz meg neki, azt fjlnvknt rtelmezi s azon
fjlok tartalmt veszi s hajtja vgre, majd ezutn olvas a szabvnyos
bemenetrl. A kimenet a szabvnyos kimenet, a hibk a szabvnyos hibakimenetre
rdnak.
.PP
A fordtott-lengyel szmolgp a szmokat egy veremben trolja. j szm
bevitele esetn a szm a verem tetejre kerl. A mveletek az
argumentumukat a verem tetejrl veszik, majd az eredmnyt visszateszik
a verembe.
.PP
A bevitelhez a szmot egyszeren berod, kvetheti opcionlisan tizedespont.
A hatvnyalak hasznlata nem tmogatott. Negatv szmok bevitelhez
a szmot ``_'' karakterrel kezdd. Az eljel nem lehet ``-'', mivel ez
a kivons mveleti opertora. Tbb szmot egymstl szkzzel vagy
j sorral elvlasztva lehet bevinni, ezen karakterek nem parancsok.
.PD
.SH KIR PARANCSOK
.TP
.B p
Kirja a verem tetejn lev szmot a verem megvltoztatsa nlkl.
A szm utn egy jsor karakter is kirdik.
.TP
.B P
Kiveszi a verem tetejrl a szmot, kirja, s nem r utna jsor karaktert.
.TP
.B f
Kirja a verem teljes tartalmt anlkl, hogy brmit vltoztatna.
Akkor j, ha teljesen eltvedtl, vagy ki akarod tallni, hogy egy
parancs vajon mit csinlt.
.PD
.SH SZMTSOK
.TP
.B +
Leveszi a verem kt fels elemt, sszeadja ket, s az eredmnyt a
verembe helyezi. A pontossgot kizrlag az argumentumok rtke
hatrozza meg.
.TP
.B -
Leveszi a verem kt fels elemt, az elst (ami eredetileg fell volt)
kivonja a msodikbl, majd az eredmnyt a verembe helyezi.
.TP
.B *
Leveszi a verem kt fels elemt, sszeszorozza ket, majd az
eredmnyt a verembe helyezi. A tizedesjegyek szmt az
aktulis pontossgrtk (l. lentebb) hatrozza meg, s nem fgg
a szorzandktl.
.TP
.B /
Leveszi a verem kt fels elemt, az elst elosztja a msodikkal,
majd az eredmnyt a verembe helyezi. A tizedesjegyek szmt a
pontossgrtk hatrozza meg.
.TP
.B %
Leveszi a verem kt fels elemt, a
.B /
ltal vgzett oszts maradkt a verembe helyezi. Az oszts a pontossgrtk
ltal meghatrozott pontossggal vgzdik el, s a maradk is ennek
megfelel szm jegyre szmoldik ki.
.TP
.B ~
Leveszi a verem kt fels elemt, az elst elosztja a msodikkal. Elszr
a hnyadost, aztn a maradkot helyezi a verembe. Az osztsban
hasznlt tizedesjegyek rtke a pontossgrtktl fgg. (A \fBSdSn lnld/
LnLd%\fP hatsa hasonl, a hibakezelse ms egy kicsit.)
.TP
.B ^
Leveszi a verem kt fels elemt, az elst (ami eredetilg fell volt)
kitevknt, a msodikat alapknt hasznlva elvgzi a hatvnyozst.
Ha a kitevnek van trtrsze, azt figyelmen kvl hagyja. A pontossgrtk
hatrozza meg, hogy az eredmny hny tizedesjegyre szmtdik ki.
.TP
.B |
Trtkitevs hatvnyozst vgez. Leveszi a verem fels hrom elemt.
Az els (ami eredetileg fell volt) lesz a kitev nevezje, ez nem lehet
nulla, s egsznek kell lennie. A msodik a kitev szmllja, ez
nem lehet negatv. Ha van tizedesjegye, azt figyelmen kvl hagyja.
A harmadik szm lesz a hatvnyozs alapja. A pontossgrtk hatrozza
meg, hogy az eredmny hny tizedesjegyre szmtdik ki. Kis szmok
esetn hasonlt hozz a \fBSm lble^ Lm%\fP szekvencia, de a  \fB^\fP-tl
eltren ez a parancs nem alkalmazhat tetszlegesen nagy
kitevkre.
.TP
.B v
Levesz egy elemet a veremrl, kiszmtja a ngyzetgykt, majd az eredmnyt
a verembe helyezi. A pontossgrtk hatrozza meg, hogy hny tizedesjegyre
vgzdik el a szmts.
.PP
A legtbb szmts eredmnyt befolysolja a
.B k
paranccsal bellthat pontossgrtk. Ez alaprtelmezsben nulla, ami
azt jelenti, hogy az sszeads s a kivons kivtelvel minden
mvelet erdmnye egsz lesz.
.PP
A
.B %
maradk-mvelet kis magyarzatra szorul. Ha az argumentumai ``a'' s
``b'', akkor a mvelet eredmnye ``a - (b * (a / b))'', ahol ``a / b''
az aktulis pontossgrtk szerint szmtdik.
.SH VEREMKARBANTARTS
.TP
.B c
Kitrli a verem minden elemt, a verem res lesz.
.TP
.B d
A verem tetejn lev elemet megduplzza s a verem tetejre helyezi,
gy a ``4d*p'' eredmnye 16.
.TP
.B r
Megfordtja (kicserli) a verem kt fels elemt.
.SH REGISZTEREK
.PP
A
\*(dc 256 memriaregisztert kpes kezelni, mindegyikk neve egyetlen
karakter. A regiszterben trolhat s ksbb jrafelhasznlhat
egy szm vagy egy karakterlnc.
.TP
.BI s r
A verem tetejn lev rtket leveszi s az
.IR r
regiszterben eltrolja.
.TP
.BI l r
Az
.I r
regiszter tartalmt a verembe helyezi. Ez a mvelet nem vltoztatja meg az
.IR r
regiszter tartalmt.
.PP
Minden regiszternek megvan a sajt verme, az aktulis regiszterrtk
van a verem tetejn.
.TP
.BI S r
A (f) verem tetejn lev rtket leveszi s az
.IR r
regiszter vermbe helyezi. A regiszter elz rtke gy elrhetetlen.
.TP
.BI L r
Az
.IR r
regiszter vermbl leveszi az elemet s a f verembe helyezi. Ha az
.IR r
regiszter vermben volt rgebben valami rtk, akkor az most a
.BI l r
paranccsal elrhetv vlik.
.SH PARAMTEREK
.PP
A
\*(dc mkdst hrom paramter befolysolja: a pontossg, a beviteli
alap s a kimeneti alap. A pontossg hatrozza meg, hogy a mveletek
eredmnybl hny tizedesjegy maradjon meg. A beviteli alap mutatja
meg, hogy a begpelt szmok hnyas szmrendszerben vannak; minden
begpelt szm ebben a szmrendszerben rtelmezdik. Szmok kirsakor
a szmok a kimeneti alap szerinti szmrendszerben rdnak ki.
.PP
A beviteli s a kimeneti alapok klnbz paramterek, nem kell
felttlenl egyenlnek lennik; ez lehet hasznos s zavar is.
A bemeneti alap legalbb 2, legfeljebb 36 lehet. A kimeneti alapnak
legalbb 2-nek kell lennie. A pontossgnak nullnak vagy nagyobbnak
kell lennie. A pontossg a beviteli s kimeneti alaptl fggetlenl
mindig tizedesjegyeket jelent.
.TP
.B i
Leveszi a verem tetejn lev szmot s erre lltja a beviteli alapot.
.TP
.B o
Leveszi a verem tetejn lev szmot s erre lltja a kimeneti alapot.
.TP
.B k
Leveszi a verem tetejn lev szmot s erre lltja a pontossgot.
.TP
.B I
Az aktulis beviteli alapot a verem tetejre helyezi.
.TP
.B O
Az aktulis kimeneti alapot a verem tetejre helyezi.
.TP
.B K
A pontossg aktulis rtkt a verem tetejre helyezi.
.SH KARAKTERLNCOK
.PP
A \*(dc kpes karakterlncokat is kezelni. A karakterlncokat csak
trolni vagy makrknt vgrehajtani (azaz a tartalmuk \*(dc
parancsknt rtelmezdik) lehet. Karakterlncok trolsra minden
regiszter s a verem is kpes. Nhny parancs, mint pldul az
aritmetikai mveletek szmokat vrnak argumentumknt, s hibt
jeleznek, ha karakterlncot tallnak helyette. Ms parancsok
szmot s karakterlncot is elfogadnak; ilyen pldul a
.B p
parancs, ami mindegyiket elfogadja s a tpusnak megfelel mdon
rja ki.
.TP
.BI [ karakterek ]
A 
.I karakterek
-et tartalmaz karakterlncot (azokat a karaktereket, amik
.B [
s
.B ]
karakterek kztt vannak) tartalmaz karakterlncot kpez s a veremre
helyezi. Pldul a
.B [foo]P
kirja a
.B foo
szveget s nem r utna jsor karaktert.
.TP
.B a
Leveszi a verem legfels elemt. Ha ez szm, akkor az alacsony
helyirtk bjtjt karakterr konvertlja s a verembe helyezi.
Ha ez karakterlnc, akkor ennek els karaktert helyezi vissza a
verembe.
.TP
.B x
Leveszi a verem legfels elemt s makrknt vgrehajtja. Normlis
esetben ez az elem egy karakterlnc; ha szm, akkor visszahelyezi
a verembe. Pldul a
.B [1p]x
vgrhajtja a
.B 1p
makrt, ami egy
.B 1
-est tesz a verembe s j sorban kirja az
.B 1
-et.
.PP
A makrkat leggyakrabban regiszterekben troljuk; a
.B [1p]sa
az
.BR a
regiszterbe tesz egy olyan makrt, ami egy
.B 1
-est r ki. A
.B lax
parancs hajtja vgre ezt a makrt.
.TP
.BI > r
Leveszi a verem kt fels elemt, felttelezi, hogy ezek szmok, 
sszehasonltja ket, s vgrehajtja az
.I r
regiszterben lv makrt, ha az eredetileg a verem tetejn lev szm
nagyobb. Az
.B 1 2>a
parancs vgrehajtja az
.BR a
regiszterben trolt makrt, mg a
.B 2 1>a
parancs nem.
.TP
.BI < r
Hasonl, de akkor hajtja vgre a makrt, ha az eredetileg a verem
tetejn lev szm kisebb.
.TP
.BI = r
Hasonl, de akkor hajtja vgre a makrt, ha a kt levett elem egyenl.
.TP
.B ?
Beolvas egy sort a terminlrl s vgrehajtja. Ezzel a paranccsal
lehet felhasznli bevitelt krni.
.TP
.B q
Kilp a makrbl s az azt hv makrbl is. Ha a legfels
szinten hajtod vgre, a
.B q
parancs kilp a \*(dc -bl.
.TP
.B Q
Leveszi a verem legfels elemt s ennyi szintet lp ki a makrkbl.
A
.B Q
parancs soha nem lp ki a \*(dc -bl.
.SH LLAPOTLEKRDEZS
.TP
.B Z
Leveszi a verem tetejn lev elemet, megszmolja hny jegy (ha szm)
vagy hny karakterbl ll (ha karakterlnc), s ezt a szmot teszi
a verembe.
.TP
.B X
Leveszi a verem tetejn lev elemet, megszmolja, hny tizedesjegye van,
majd ezt a szmot teszi a verembe. Ha a levett elem karakterlnc, akkor
.\" -1.
0
-t tesz a verembe.
.TP
.B z
A verembe teszi a verem aktulis mlysgt; azt, hogy a
.B z
parancs vgrehajtsa eltt hny elem volt a veremben.
.SH EGYB
.TP
.B !
A sor tbbi rszt mint rendszerparancsot futtatja.
.TP
.B #
A sor tbbi rszt megjegyzsknt kezeli.
.TP
.BI : r
A verem kt fels elemt leveszi. A msodik elemet az
.IR r
tmbbe helyezi, amit az els elemmel indexel.
.TP
.BI ; r
Leveszi a verem fels elemt s az
.IR r
tmb indexeknt hasznlja. A kivlasztott elem a verembe kerl.
.SH MEGJEGYZSEK
.PP
A
.B :
s a
.B ;
tmbmveteket ltalban csak a
.IR bc
hagyomnyos implementcii hasznljk. (A GNU
.I bc
ezt tartalmazza, nem szksges a futshoz a \*(dc. )
.SH HIBK
.PP
A hibkat e-mail-ben jelentsd a
.BR bug-gnu-utils@prep.ai.mit.edu 
cmen. A levl trgyban valahol legyen benne a ``dc'' sz.
.SH MAGYAR FORDTS
Tevesz Tams <ice@rulez.org>