ST-DOS Calc -tuotteen käyttöohje


Tervetuloa käyttämään ST-DOS Calc -ohjelmaa! ST-DOS Calc:lla hoituvat sekä
yritysten kirjanpito, kotitalouksien taloudenhallinta että myös muut
kansantaloudellisesti tarpeelliset kalkuloinnit käden käänteessä. Tässä
dokumentissa neuvotaan, miten pääset alkuun ST-DOS Calc -ohjelman kanssa.

  Sisällysluettelo:

1. Laitteistovaatimukset
2. Ohjelman käynnistys
3. Taulukossa navigointi
4. Solun arvon asettaminen
5. Dokumentin tallentaminen
6. Merkkijonon etsiminen dokumentista
7. Tiettyyn soluun hyppääminen
8. Funktiot
9. Makrot


  Dokumentin sisältö:

  1. Laitteistovaatimukset

ST-DOS Calc toimii kaikilla IBM PC XT -yhteensopivilla tietokoneilla.
Käyttöjärjestelmän on oltava joko POSIX- tai DOS-yhteensopiva. Parhaan
käyttökokemuksen saavuttamiseksi suosittelemme ST-DOS-levykäyttöjärjestelmää.

Ohjelman sujuva käyttö edellyttää vähintään seuraavia komponentteja:

- 4,77 MHz 8088 tai yhteensopiva prosessori (suositellaan vähintään 16 MHz 286
  liukulukusuorittimen kanssa)
- 512 kB järjestelmämuistia
- CGA-näytönohjain (MDA-näytönohjain ei ole tällä hetkellä tuettu)
- 80 kB levytilaa

  2. Ohjelman käynnistys

ST-DOS Calc käynnistetään komentoriviltä komennolla "CALC" (ilman 
lainausmerkkejä). Jos haluat luoda uuden (tyhjän) taulukkolaskentadokumentin,
komennolle ei tarvitse antaa argumentteja. Jos haluat avata jo olemassa olevan
tiedoston, on tiedoston nimi annettava argumenttina komennolle.


  3. Taulukossa navigointi

Navigointi taulukossa tapahtuu nuolinäppäimillä sekä navigointinäppäimillä
[HOME], [END], [PAGE UP] ja [PAGE DOWN]. Jos [Scroll Lock] on päällä, 
taulukossa liikkuminen vaihtaa vain taulukon näkymää, mutta ei valittuna
olevaa solua. Muussa tapauksessa myös valittu solu vaihtuu.


  4. Solun arvon asettaminen

Kun solu on valittuna, painamalla [ENTER] ohjelma menee muokkaustilaan. Voit
tällöin kirjoittaa solulle uuden arvon käyttämällä numero- ja kirjainnäppäimiä.
[BACKSPACE] poistaa viimeisimmäksi syötetyn merkin. Muokkaustilasta poistutaan
painamalla [ENTER] tai [ESC].


  5. Dokumentin tallentaminen

Taulukkolaskentadokumentti tallennetaan CSV-tiedostoon painamalla [F2]. Tällöin
ohjelma kysyy käyttäjältä tallennettavan tiedoston nimen. Tallennuksen voi
peruuttaa painamalla [ESC] tai vahvistaa painamalla [ENTER]. Painamalla [F6]
voit tallentaa tiedostoon kaavojen sijaan tulokset esim. kuvaajan piirtämistä
varten.


  6. Merkkijonon etsiminen dokumentista

a) Merkkijonon ensimmäisen esiintymän etsiminen: Paina [F4]. Ohjelma kysyy
hakusanaa. Voit peruuttaa etsinnän painamalla [ESC] tai kirjoittaa hakusanan
ja vahvistaa sen painamalla [ENTER]. Jos hakusana löytyy yhdestä tai
useammasta taulukon solusta, ohjelma hyppää soluun, josta ensimmäinen
esiintymä löytyy.

b) Merkkijonon seuraavien esiintymien etsiminen: Paina [F3]. Ohjelma hyppää
merkkijonon seuraavaan esiintymään, jos sellainen löytyy. Etsintäjärjestys
on vasemmalta oikealle ja ylhäältä alas.


  7. Tiettyyn soluun hyppääminen

Suurikokoisessa taulukossa navigointi pelkillä nuolinäppäimillä voi olla 
hidasta. Siksi ST-DOS Calc:ssa on hyppytoiminto, johon pääset painamalla
[F7]-näppäintä. Ohjelma kysyy solun nimeä. Jos syötät täyden solun
nimen (esim. LE37), ohjelma hyppää kyseiseen soluun. Jos syötät pelkän
rivinumeron, ohjelma hyppää kyseisen rivin ensimmäiseen soluun. Jos syötät
pelkän sarakkeen nimen, ohjelma hyppää kyseisen sarakkeen ylimmälle riville.


  8. Funktiot

ST-DOS Calc tukee tällä hetkellä seuraavia funktioita:

=SUM()
=MIN()
=MAX()
=COUNT()
=IF()
=AND()
=OR()
=XOR()
=NOT()
=PRODUCT()
=QUOTIENT()
=MOD()
=IMDIV()
=MOV()*
=FOR()*
=FORMAT()*
=NOP()*
LIST()*
SLIST()*

Kaikki ylläolevat funktiot paitsi MOV(), FOR(), FORMAT. LIST() ja SLIST() ovat
standardeja taulukkolaskentafunktioita, joiden käyttöä ei neuvota tässä
ohjeessa. Jotta ST-DOS Calc mukautuisi erityisen hyvin vaativiinkin tarpeisiin,
on siihen lisätty muutamia erikoisominaisuuksia, jotka mahdollistavat
Turing-vahvan laskennan.

ST-DOS Calc tukee myös muuttujia. Muuttujien nimet ovat yksikirjaimisia ja ne
muodostuvat dollarimerkistä ($) ja yhdestä isosta kirjaimesta. Muuttujanimi $A
on varattu FOR-funktion paluuarvolle. Jos FOR-funktioita on useita sisäkkäin,
niin $A tarkoittaa sen FOR-funktion paluuarvoa, jonka syvyydeltä sitä on
kutsuttu. Muut muuttujanimet ovat vapaasti käytössä ja niiden näkyvyys on
koko solun laajuinen. Uusi muuttuja esitellään viittaamalla siihen ensimmäisen
kerran ja sen lähtöarvo on nolla (0).


  FORMAT()-funktion käyttäminen

Syntaksi: FORMAT(funktio, solu/soluryhmä)

Toiminta: FORMAT-funktio alustaa taulukosta soluja niin, että niitä voi käyttää
MOV()-funktion kohteena. Alustamattoihin (tyhjiin) soluihin ei voi viitata
MOV()-funktiolla. Solujen arvoksi luodaan FORMAT-funktion ensimmäisenä
argumenttina oleva funktio.

Seuraava esimerkki alustaa taulukosta solut B1:C10 arvolle NOP():

  =FORMAT(NOP(),B1:C10)

Alustuksen jälkeen soluja voi käyttää esimerkiksi FOR-funktion paluuarvojen
tallentamiseen LIST()-rakenteen avulla.

Paluuarvo: FORMAT palauttaa funktion, joka sille on annettu ensimmäisenä
argumenttina.


  NOP()-funktion käyttäminen

Syntaksi: NOP()

Toiminta: NOP-funktio ei tee mitään, eikä se muuta solun tuloksen arvoa.

Paluuarvo: NOP ei palauta mitään.


  MOV()-funktion käyttäminen

Syntaksi: MOV(solu/muuttuja; solu/muuttuja/funktio)

Toiminta: MOV-funktio kopioi arvon toisena argumenttina olevasta objektista
ensimmäisenä argumenttina olevaan objektiin. Ensimmäinen argumentti voi olla
solu tai muuttuja. Toinen argumentti voi olla solu, muuttuja tai funktio.

Paluuarvo: MOV palauttaa kopioidun arvon.


  LIST()- ja SLIST()-rakenteiden käyttäminen

Syntaksi: [S]LIST(soluryhmä)

Toiminta: LIST-rakennetta voi kutsua vain FOR-silmukan sisältä. Kun LIST-
rakennetta kutsutaan ensimmäisen kerran, alustaa se taulukkolaskentaohjelman
muistiin listan argumenttina annetuissa koordinaateissa sijaitsevista soluista.
LIST-rakenne tekee listan taulukossa näkyvässä järjestyksessä vasemmalta
oikealle ja ylhäältä alaspäin. SLIST-kutsu järjestää solut listaan
numeraaliseen suuruusjärjestykseen pienimmästä suurimpaan. LIST-rakenteen tila
nollautuu jokaisen FOR-silmukan alussa, tai kun listan viimeinen solu on luettu.

Seuraava funktiokutsu järjestää sarakkeissa B:C olevat arvot suuruusjärjestykseen
soluihin D:E:

  =FOR(;MOV(LIST(D:E),SLIST(B:C));)

Paluuarvo: LIST-rakenne palauttaa listassa olevat solut yksi kerrallaan.


  FOR()-funktion käyttäminen

Syntaksi: FOR(funktio1,funktio2,funktio2...;ehto;funktio1,funktio2,funktio3...)

Toiminta: FOR-funktio tekee silmukan, jonka sisällä voidaan kutsua muita
funktioita. Toisin kuin muissa funktioissa, joissa puolipistettä ja tavallista
pilkkua voi käyttää samalla tavalla, FOR-funktiossa puolipiste ilmaisee
funktion seuraavaa vaihetta, joten argumentit on eroteltava toisistaan
pilkulla.

Paluuarvo: FOR-funktio palauttaa $A-muuttujaan sijoitetun arvon.

FOR-funktiolla on kolme vaihetta:
1) Alustusvaihe. Alustusvaiheen argumenttilista voi olla tyhjä tai siinä voi
olla funktiokutsuja. Alustusvaiheen aikana siinä kutsutut funktiot suoritetaan
järjestyksessä vasemmalta oikealle.

2) Ehtovaihe. Ehtovaiheen argumenttilistassa on oltava vähintään yksi
argumentti. Argumentit voivat olla tyypiltään soluja, soluryhmiä, lukuvakioita,
muuttujia, funktioita tai loogisia vertailulausekkeita. Argumenttilistassa
olevat argumentit evaluoidaan järjestyksessä vasemmalta oikealle. Jos ainakin
yksi argumentti palauttaa muun arvon kuin nolla (0), funktio siirtyy seuraavaan
vaiheeseen, kun kaikki argumentit on käsitelty. Muussa tapauksessa funktion
suoritus loppuu.

3) Suoritusvaihe. Argumenttien on oltava tyypiltään funktioita. Argumenttilistan
funktiot suoritetaan järjestyksessä vasemmalta oikealle, jonka jälkeen palataan
FOR-funktion vaiheeseen 2 (ehtovaihe).

  Esimerkkejä FOR-funktion käytöstä

Seuraava funktio laskee yhdestä kymmeneen käyttäen laskurina FOR-funktion
paluuarvolle varattua muuttujanimeä $A:

=FOR(MOV($A,1);$A<10;MOV($A,SUM($A,1)))

Seuraava funktiokutsu laskee potenssin käyttäen kantalukuna solua A17 ja
eksponenttina solua B17:

=FOR(MOV($E,SUM(B17,-1)),MOV($A,A17);$E;MOV($A,PRODUCT($A,A17)),MOV($E,SUM($E,-1)))

Seuraava funktiokutsu käy läpi D-sarakkeen soluja ylhäältä alaspäin ja palauttaa
ensimmäisen sellaisen solun arvon, jonka arvo on 100 tai enemmän:

=FOR(;MOV($A,LIST(D:D))<100;)


  9. Makrot

Jotta ST-DOS Calc mukautuisi parhaalla mahdollisella tavalla jokaisen käyttäjän
yksilöllisiin tarpeisiin, on ohjelmaan sisällytetty myös makrotoiminto. Makrot
löytyvät tiedostosta MACROS.CLC. Makrojen syntaksi on seuraava:

[MAKROKOMENTO] [FUNKTIOKUTSU(%1,%2,%3,%%)]

Makrokomennolle syötettävät argumentit ilmaistaan prosenttimerkin jälkeen
tulevilla numeroilla. Jos makrossa on kaksi prosenttimerkkiä peräkkäin, loput
argumentit tulevat siihen kohtaan komentoa. Se mahdollistaa makrot, jotka
vastaanottavat vaihtelevan määrän argumentteja.

Makroja voi käyttää myös vaihtoehtoisten nimien luomiseen jo olemassa oleville
funktioille. Esimerkiksi makro

MUL PRODUCT(%%)

tekee kertolaskua ilmaisevalle PRODUCT()-funktiolle lyhyemmän ja helpommin
muistettavan aliaksen.

Lisää esimerkkejä makroista löytyy MACROS.CLC -tiedostosta.

Dokumentin versio 1.5