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()
=POWER()
=MEDIAN()
=LOG()
=ROOT()*
=MOV()*
=FOR()*
=FORMAT()*
=NOP()*
LIST()*
SLIST()*

Kaikki yll„olevat funktiot paitsi ROOT(), MOV(), FOR(), FORMAT(), NOP(), 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).


  ROOT()-funktion k„ytt„minen

Syntaksi: ROOT(solu1,solu2)

Toiminta: ROOT-funktio etsii ensimm„isen argumentin arvolle juuren, jonka
potenssi k„ytt„en eksponenttina toisen argumentin arvoa on ensimm„isen argumentin
arvo.

Seuraava esimerkki etsii kuutiojuuren solun A8 arvolle:

  =ROOT(A8,3)

Paluuarvo: ROOT-funktio palauttaa juuren.


  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.

  10. Ymp„rist”muuttujat

ST-DOS etsii asetustiedostojaan ensisijaisesti CALC-ymp„rist”muuttujan osoittamasta
hakemistosta. Jos k„yt„t esimerkiksi DOS-k„ytt”j„rjestelm„„ ja olet asentanut
ST-DOS Calcin kansioon C:\CALC, saat alustettua ymp„rist”muuttujan k„ynnistyksen
yhteydess„ lis„„m„ll„ AUTOEXEC.BAT-tiedostoosi seuraavan rivin:

SET CALC=C:\CALC

Jos k„yt„t Linuxia tai muuta Unixin kaltaista k„ytt”j„rjestelm„„, ymp„rist”muuttujien
automaattinen alustus onnistuu lis„„m„ll„ kirjautumisen yhteydess„ suoritettaviin
skripteihin seuraava rivi:

export CALC=/polku/asetustiedostoihin

Jos ymp„rist”muuttujaa CALC ei ole asetettu, etsii ST-DOS asetustiedostojaan
k„ynnistyksen aikaisesta ty”skentelyhakemistosta.

On suositeltavaa my”s lis„t„ PATH-ymp„rist”muuttujaan hakemisto, jossa ST-DOS
Calcin suoritettavat bin„„rit sijaitsevat.

Dokumentin versio 1.9