Muuttujien käyttö

LibreOffice Basicin muuttujien perusteet kuvaillaan oheisena.

Muuttujien tunnusten nimeämissäännöt

Muuttujan nimi voi koostua enintään 255 merkistä. Muuttujanimen ensimmäisen merkin pitää olla joku kirjaimista A-Z tai a-z. Numeroitakin voi käyttää muuttujien nimissä, mutta skandinaaviset kirjaimet (ääkköset), välimerkit ja erikoismerkit eivät ole sallittuja. Poikkeuksen tekee alaviivamerkki ("_"). LibreOffice Basicin muuttujien tunnuksissa kirjainkokoa ei erotella. Muuttujan nimessä voi esiintyä välilyönti, mutta silloin nimeä on käytettävä hakasulkeissa.

Esimerkkejä muuttujien tunnuksista:


    MyNumber=5      'Correct'
    MyNumber5=15    'Correct'
    MyNumber_5=20   'Correct'
    My Number=20    'Not valid, variable with space must be enclosed in square brackets'
    [My Number]=12  'Correct'
    DéjàVu=25       'Not valid, special characters are not allowed'
    5MyNumber=12    'Not valid, variable may not begin with a number'
    Number,Mine=12  'Not valid, punctuation marks are not allowed'

Muuttujien määrittely

LibreOffice Basicissa ei ole muuttujien esittely- eli määrittelypakkoa. Muuttujan määrittely voidaan tehdä Dim-lauseella. Useamman muuttujan määrittelylauseessa muuttuja erotellaan pilkuilla. Muuttujan tyyppi määritetään joko tyypin määräävällä loppumerkillä tai käyttämällä määrittelevää avainsanaa.

Esimerkkejä muuttujien määrittelyistä:


    Dim a$               'Declares the variable "a" as a String'
    Dim a As String      'Declares the variable "a" as a String'
    Dim a$, b As Integer 'Declares one variable as a String and one as an Integer'
    Dim c As Boolean     'Declares c as a Boolean variable that can be TRUE or FALSE'
Varoitus-kuvake

Kun muuttujalle on määritelty tietty tietotyyppi, samannimistä muuttujaa ei voi enää tyyppimääritellä toisen tyyppiseksi!


Pakollinen muuttujien määrittely

Muuttujien määrittelyn voi tehdä pakolliseksi käyttämällä seuraavaa käskyä:


Option Explicit

Option Explicit -lauseen on oltava moduulin ensimmäisenä rivinä, ennen ensimmäistä SUB-riviä. Yleisesti ottaen, vain taulukot tarvitsevat nimenomaisen määrittelyn. Muut muuttujat tulevat määritellyiksi tyypin määräävällä merkillä tai, sen puuttuessa, oletuksena Single-tyyppisiksi (perusliukuluvuiksi).

Muuttujien tietotyypit

LibreOffice Basic tukee neljää muuttujaluokkaa:

Kokonaislukumuuttujat

Kokonaislukumuuttujien (Integer) arvoalue on -32768 ... 32767. Jos liukulukuarvo sijoitetaan kokonaislukumuuttujaan, desimaalit pyöristetään lähimpään kokonaislukuun. Kokonaislukumuuttujien laskenta on nopeaa ja ne sopivat silmukoiden laskureiksi. Kokonaislukumuuttuja vie vain kaksi tavua muistissa. Tietotyypin määräysmerkkinä on "%".


Dim Variable%
Dim Variable As Integer

Pitkät kokonaislukumuuttujat

Pitkien kokonaislukumuuttujien (Long) arvoalue on -2147483648 ... 2147483647. Jos liukulukuarvo sijoitetaan pitkän kokonaisluvun muuttujaan, desimaalit pyöristetään lähimpään kokonaislukuun. Pitkien kokonaislukumuuttujien laskenta on nopeaa ja ne sopivat silmukoiden laskureiksi, kun arvot ovat suuria. Pitkä kokonaislukumuuttuja vie neljä tavua muistissa. Tyypin määräysmerkkinä on "&".


Dim Variable&
Dim Variable As Long

Desimaalilukumuuttujat

Desimaalilukumuuttujat voivat esittää negatiivisia ja positiivisia lukuja tai arvon nolla. Tarkkuus on jopa 19 numeroa.

Plusmerkkiä (+) ja miinusmerkkiä (-) voi käyttää desimaaliluvun edessä (välilyönnin kanssa tai ilman).

Jos desimaaliluku (liukuluku) sijoitetaan kokonaislukumuuttujaan, LibreOffice Basic pyöristää lukua ylös- tai alaspäin.

Perustarkkuuden liukulukumuuttujat

Perustarkkuuden (Single) liukulukumuuttujat voivat saada positiivisia tai negatiivisia arvoja, joiden itseisarvot ovat väliltä 3,402823 x 10E38 ... 1,401298 x 10E-45. Single-muuttujat ovat liukulukumuuttujia, joissa desimaaliosan tarkkuus vähenee, kun kokonaislukunumeroiden määrä luvussa lisääntyy. Perustarkkuuden liukulukumuuttujat sopivat keskinkertaisen tarkkuuden matemaattiseen laskentaan. Laskenta-aika niillä on suurempi kuin kokonaislukumuuttujilla, mutta pienempi kuin kaksoistarkkuuden liukuluvuilla. Single-muuttuja varaa 4 tavua muistista. Tyypin määräysmerkkinä on "!".


Dim Variable!
Dim Variable As Single

Kaksinkertaisen tarkkuuden liukulukumuuttujat

Kaksoistarkkuuden (Double) liukulukumuuttujat voivat käsitellä positiivisia ja negatiivisia lukuja, joiden itseisarvot ovat väliltä 1,79769313486232 x 10E308 ... 4,94065645841247 x 10E-324. Double-muuttujat ovat liukulukumuuttujia, joissa desimaaliosan tarkkuus vähenee, kun kokonaislukunumeroiden määrä luvussa lisääntyy. Kaksoistarkkuuden liukulukumuuttujat soveltuvat tarkkuuslaskentaan. Laskenta-aika on suurempi kuin perustarkkuuden liukuluvuilla. Double-muuttuja tarvitsee 8 tavua muistissa. Tyypin määräysmerkkinä on "#".


Dim Variable#
Dim Variable As Double

Valuuttamuuttujat

Valuuttamuuttujat (Currency) tallennetaan sisäisesti 64-bittisinä lukuina (8 tavua) ja esitetään kiinteän pilkun desimaalilukuna 15 kokonaisluku- 4 desimaaliosan numerolla. Arvoalue on -922337203685477.5808 ... +922337203685477.5807. Currency-muuttujia käytetään laskettaessa suuren tarkkuuden vaativia valuuttalaskuja. Tietotyypin määräysmerkkinä on "@".


Dim Variable@
Dim Variable As Currency

Merkkijonomuuttujat

Merkkijonomuuttujissa (String) voi olla enintään 65 535 merkkiä pitkiä merkkijonoja. Jokainen merkki on tallennettu sitä vastaavana Unicode-arvona. Merkkijonomuuttujat ovat sopivia tekstinkäsittelyyn ohjelmissa ja tilapäisiksi varastoiksi tulostumattomille merkeille aina 64 kt jonoihin asti. String-muuttujien muistin tarve on riippuvainen merkkijonon pituudesta. Tyypin määritysmerkkinä on "$".


Dim Variable$
Dim Variable As String

Boolen muuttujat

Boolen muuttujilla on vain kaksi (totuus)arvoa: TRUE (tosi) tai FALSE (epätosi). Numero 0 tulkitaan arvoksi FALSE, kaikki muut arvot tulkitaan arvoksi TRUE.


Dim Variable As Boolean

Päivämäärämuuttujat

Päivämäärämuuttujissa (Date) voi olla vain päivämäärä- tai aika-arvoja, jotka on tallennettu sisäiseen erityismuotoon. Arvot, jotka sijoitetaan Date-muuttujiin funktiolla Dateserial, Datevalue, Timeserial ja Timevalue, muuntuvat sisäiseen erityismuotoon. Päivämäärämuuttujat muutetaan tavanomaisiksi luvuiksi käyttämällä funktioita Day, Month ja Year tai Hour, Minute ja Second. Sisäinen muoto tekee mahdolliseksi vertailla päivämäärä- ja aika-arvoja laskemalla kahden luvun erotus. Nämä muuttujat voidaan esitellä eli määritellä vain avainsanalla Date.


Dim Variable As Date

Muuttujien alkuarvot

Heti kun muuttuja on määritelty, sen arvo alustetaan samalla "Null"-arvoksi. Katso seuraavia sääntöjä:

Numeeriset muuttujat alustetaan arvoon "0" määriteltäessä.

Päivämäärämuuttujat saavat sisäisen 0-arvon; se vastaa arvon "0" antamista muuttujalle funktiolla Day, Month ja Year tai Hour, Minute ja Second.

Merkkijonomuuttujat alustetaan tyhjällä merkkijonolla ("") määriteltäessä.

Taulukot

LibreOffice Basic tuntee yksi- ja moniulotteiset taulukot, jotka määritellään tietyn tietotyypin mukaan. Taulukot soveltuvat luetteloiden ja taulukoiden muokkaamiseen ohjelmassa. Taulukon yksittäiset alkiot ovat osoitettavissa käyttäen taulukon nimeä ja alkion indeksinumeroa.

Taulukot pitää määritellä Dim-lauseella. Taulukon indeksointi on toteutettavissa useilla erilaisilla tavoilla:


    Dim Text$(20)       '21 elements numbered from 0 to 20'
    Dim Text$(5,4)      '30 elements (a matrix of 6 x 5 elements)'
    Dim Text$(5 To 25)  '21 elements numbered from 5 to 25'
    Dim Text$(-15 To 5) '21 elements (including 0), numbered from -15 to 5'

Indeksiväli voi kattaa niin positiivisia kuin negatiivisiakin lukuja.

Vakiot

Vakioilla on muuttumaton arvo. Ne määritellään vain kerran ohjelmassa eikä niitä voi määritellä myöhemmin uudestaan:


Const ConstName=Expression