Provided by: manpages-hu_20010119-6_all bug

NÉV

       dc - tetszőleges pontosságú számológép

ÁTTEKINTÉS

       dc

LEÍRÁS

       A  dc egy korlátlan pontosságú számítások elvégzésére alkalmas fordított-lengyel (postfix)
       asztali számológép,  amely  lehetőséget  ad  makrók  definiálására  és  végrehajtására.  A
       bemenetet  a  szabványos  bemenetről veszi; ha argumentumot adsz meg neki, azt fájlnévként
       értelmezi és azon fájlok tartalmát veszi és hajtja végre, majd ezután olvas  a  szabványos
       bemenetről. A kimenet a szabványos kimenet, a hibák a szabványos hibakimenetre íródnak.

       A  fordított-lengyel számológép a számokat egy veremben tárolja. Új szám bevitele esetén a
       szám a verem tetejére kerül. A műveletek az argumentumukat a verem tetejéről veszik,  majd
       az eredményt visszateszik a verembe.

       A   bevitelhez   a  számot  egyszerűen  beírod,  követheti  opcionálisan  tizedespont.   A
       hatványalak  használata  nem  támogatott.  Negatív  számok  beviteléhez  a  számot   ``_''
       karakterrel  kezdd. Az előjel nem lehet ``-'', mivel ez a kivonás műveleti operátora. Több
       számot egymástól szóközzel vagy új sorral elválasztva lehet bevinni, ezen  karakterek  nem
       parancsok.

KIÍRÓ PARANCSOK

       p      Kiírja a verem tetején levő számot a verem megváltoztatása nélkül.  A szám után egy
              újsor karakter is kiíródik.

       P      Kiveszi a verem tetejéről a számot, kiírja, és nem ír utána újsor karaktert.

       f      Kiírja a verem teljes tartalmát anélkül, hogy bármit  változtatna.   Akkor  jó,  ha
              teljesen eltévedtél, vagy ki akarod találni, hogy egy parancs vajon mit csinált.

SZÁMÍTÁSOK

       +      Leveszi  a  verem  két  felső  elemét,  összeadja  őket,  és az eredményt a verembe
              helyezi. A pontosságot kizárólag az argumentumok értéke határozza meg.

       -      Leveszi a verem két felső elemét, az elsőt (ami eredetileg felül  volt)  kivonja  a
              másodikból, majd az eredményt a verembe helyezi.

       *      Leveszi  a  verem két felső elemét, összeszorozza őket, majd az eredményt a verembe
              helyezi. A tizedesjegyek számát az aktuális pontosságérték (l.  lentebb)  határozza
              meg, és nem függ a szorzandóktól.

       /      Leveszi a verem két felső elemét, az elsőt elosztja a másodikkal, majd az eredményt
              a verembe helyezi. A tizedesjegyek számát a pontosságérték határozza meg.

       %      Leveszi a verem két felső elemét, a / által  végzett  osztás  maradékát  a  verembe
              helyezi.  Az  osztás a pontosságérték által meghatározott pontossággal végződik el,
              és a maradék is ennek megfelelő számú jegyre számolódik ki.

       ~      Leveszi a verem két felső  elemét,  az  elsőt  elosztja  a  másodikkal.  Először  a
              hányadost, aztán a maradékot helyezi a verembe. Az osztásban használt tizedesjegyek
              értéke a pontosságértéktől függ. (A SdSn lnld/ LnLd% hatása hasonló, a hibakezelése
              más egy kicsit.)

       ^      Leveszi a verem két felső elemét, az elsőt (ami eredetilg felül volt) kitevőként, a
              másodikat alapként használva elvégzi a hatványozást.  Ha a kitevőnek van törtrésze,
              azt  figyelmen  kívül hagyja. A pontosságérték határozza meg, hogy az eredmény hány
              tizedesjegyre számítódik ki.

       |      Törtkitevős hatványozást végez. Leveszi a verem felső három elemét.  Az  első  (ami
              eredetileg felül volt) lesz a kitevő nevezője, ez nem lehet nulla, és egésznek kell
              lennie. A második a kitevő számlálója, ez nem lehet negatív. Ha  van  tizedesjegye,
              azt  figyelmen  kívül  hagyja.   A  harmadik  szám  lesz  a  hatványozás  alapja. A
              pontosságérték határozza meg, hogy az eredmény hány  tizedesjegyre  számítódik  ki.
              Kis számok esetén hasonlít hozzá a Sm lble^ Lm% szekvencia, de a  ^-tól eltérően ez
              a parancs nem alkalmazható tetszőlegesen nagy kitevőkre.

       v      Levesz egy elemet a veremről, kiszámítja  a  négyzetgyökét,  majd  az  eredményt  a
              verembe  helyezi.  A pontosságérték határozza meg, hogy hány tizedesjegyre végződik
              el a számítás.

       A legtöbb számítás eredményét befolyásolja a k paranccsal beállítható  pontosságérték.  Ez
       alapértelmezésben  nulla,  ami  azt  jelenti,  hogy  az összeadás és a kivonás kivételével
       minden művelet erdménye egész lesz.

       A % maradék-művelet kis magyarázatra szorul. Ha az argumentumai ``a'' és  ``b'',  akkor  a
       művelet eredménye ``a - (b * (a / b))'', ahol ``a / b'' az aktuális pontosságérték szerint
       számítódik.

VEREMKARBANTARTÁS

       c      Kitörli a verem minden elemét, a verem üres lesz.

       d      A verem tetején levő elemet megduplázza és a verem tetejére helyezi, így a ``4d*p''
              eredménye 16.

       r      Megfordítja (kicseréli) a verem két felső elemét.

REGISZTEREK

       A   dc  256  memóriaregisztert  képes  kezelni,  mindegyikük  neve  egyetlen  karakter.  A
       regiszterben tárolható és később újrafelhasználható egy szám vagy egy karakterlánc.

       sr     A verem tetején levő értéket leveszi és az r regiszterben eltárolja.

       lr     Az r regiszter tartalmát a verembe helyezi. Ez a művelet nem változtatja meg  az  r
              regiszter tartalmát.

       Minden regiszternek megvan a saját verme, az aktuális regiszterérték van a verem tetején.

       Sr     A  (fő)  verem  tetején  levő  értéket leveszi és az r regiszter vermébe helyezi. A
              regiszter előző értéke így elérhetetlen.

       Lr     Az r regiszter verméből leveszi az  elemet  és  a  fő  verembe  helyezi.  Ha  az  r
              regiszter  vermében  volt  régebben  valami  érték,  akkor  az most a lr paranccsal
              elérhetővé válik.

PARAMÉTEREK

       A dc működését három paraméter befolyásolja: a pontosság, a beviteli alap  és  a  kimeneti
       alap.  A  pontosság határozza meg, hogy a műveletek eredményéből hány tizedesjegy maradjon
       meg. A beviteli alap mutatja meg, hogy a begépelt számok  hányas  számrendszerben  vannak;
       minden  begépelt  szám  ebben a számrendszerben értelmeződik. Számok kiírásakor a számok a
       kimeneti alap szerinti számrendszerben íródnak ki.

       A beviteli és a kimeneti alapok különböző paraméterek,  nem  kell  feltétlenül  egyenlőnek
       lenniük;  ez lehet hasznos és zavaró is.  A bemeneti alap legalább 2, legfeljebb 36 lehet.
       A kimeneti alapnak legalább 2-nek kell lennie. A  pontosságnak  nullának  vagy  nagyobbnak
       kell lennie. A pontosság a beviteli és kimeneti alaptól függetlenül mindig tizedesjegyeket
       jelent.

       i      Leveszi a verem tetején levő számot és erre állítja a beviteli alapot.

       o      Leveszi a verem tetején levő számot és erre állítja a kimeneti alapot.

       k      Leveszi a verem tetején levő számot és erre állítja a pontosságot.

       I      Az aktuális beviteli alapot a verem tetejére helyezi.

       O      Az aktuális kimeneti alapot a verem tetejére helyezi.

       K      A pontosság aktuális értékét a verem tetejére helyezi.

KARAKTERLÁNCOK

       A dc képes karakterláncokat is kezelni. A karakterláncokat  csak  tárolni  vagy  makróként
       végrehajtani   (azaz  a  tartalmuk  dc  parancsként  értelmeződik)  lehet.  Karakterláncok
       tárolására minden regiszter  és  a  verem  is  képes.  Néhány  parancs,  mint  például  az
       aritmetikai műveletek számokat várnak argumentumként, és hibát jeleznek, ha karakterláncot
       találnak helyette. Más parancsok számot és karakterláncot is elfogadnak; ilyen például a p
       parancs, ami mindegyiket elfogadja és a típusának megfelelő módon írja ki.

       [karakterek]
              A  karakterek  -et  tartalmazó  karakterláncot  (azokat a karaktereket, amik [ és ]
              karakterek között vannak) tartalmazó karakterláncot képez  és  a  veremre  helyezi.
              Például a [foo]P kiírja a foo szöveget és nem ír utána újsor karaktert.

       a      Leveszi  a verem legfelső elemét. Ha ez szám, akkor az alacsony helyiértékű bájtját
              karakterré konvertálja és a verembe helyezi.  Ha ez karakterlánc, akkor ennek  első
              karakterét helyezi vissza a verembe.

       x      Leveszi  a  verem  legfelső elemét és makróként végrehajtja. Normális esetben ez az
              elem egy karakterlánc; ha szám, akkor visszahelyezi  a  verembe.  Például  a  [1p]x
              végrhajtja a 1p makrót, ami egy 1 -est tesz a verembe és új sorban kiírja az 1 -et.

       A makrókat leggyakrabban regiszterekben tároljuk; a [1p]sa az a regiszterbe tesz egy olyan
       makrót, ami egy 1 -est ír ki. A lax parancs hajtja végre ezt a makrót.

       >r     Leveszi a verem két felső elemét, feltételezi, hogy  ezek  számok,  összehasonlítja
              őket,  és  végrehajtja  az  r  regiszterben  lévő  makrót, ha az eredetileg a verem
              tetején levő szám nagyobb. Az 1 2>a parancs végrehajtja az  a  regiszterben  tárolt
              makrót, míg a 2 1>a parancs nem.

       <r     Hasonló, de akkor hajtja végre a makrót, ha az eredetileg a verem tetején levő szám
              kisebb.

       =r     Hasonló, de akkor hajtja végre a makrót, ha a két levett elem egyenlő.

       ?      Beolvas  egy  sort  a  terminálról  és  végrehajtja.  Ezzel  a   paranccsal   lehet
              felhasználói bevitelt kérni.

       q      Kilép  a makróból és az azt hívó makróból is. Ha a legfelső szinten hajtod végre, a
              q parancs kilép a dc -ből.

       Q      Leveszi a verem legfelső elemét és ennyi szintet lép ki a makrókból.  A  Q  parancs
              soha nem lép ki a dc -ből.

ÁLLAPOTLEKÉRDEZÉS

       Z      Leveszi  a  verem  tetején  levő elemet, megszámolja hány jegyű (ha szám) vagy hány
              karakterből áll (ha karakterlánc), és ezt a számot teszi a verembe.

       X      Leveszi a verem tetején levő elemet, megszámolja, hány tizedesjegye van, majd ezt a
              számot teszi a verembe. Ha a levett elem karakterlánc, akkor 0 -t tesz a verembe.

       z      A  verembe  teszi  a  verem  aktuális mélységét; azt, hogy a z parancs végrehajtása
              előtt hány elem volt a veremben.

EGYÉB

       !      A sor többi részét mint rendszerparancsot futtatja.

       #      A sor többi részét megjegyzésként kezeli.

       :r     A verem két felső elemét leveszi. A második elemet az r  tömbbe  helyezi,  amit  az
              első elemmel indexel.

       ;r     Leveszi a verem felső elemét és az r tömb indexeként használja. A kiválasztott elem
              a verembe kerül.

MEGJEGYZÉSEK

       A : és a ; tömbműveteket általában csak a bc hagyományos implementációi használják. (A GNU
       bc ezt tartalmazza, nem szükséges a futásához a dc. )

HIBÁK

       A  hibákat  e-mail-ben  jelentsd  a bug-gnu-utils@prep.ai.mit.edu címen. A levél tárgyában
       valahol legyen benne a ``dc'' szó.

MAGYAR FORDÍTÁS

       Tevesz Tamás <ice@rulez.org>