Ukaz Dim

Deklarira spremenljivko ali polje.

Če so spremenljivke med seboj ločene z vejicami (npr. DIM sPar1, sPar2, sPar3 AS STRING), je mogoče tako definirati samo spremenljivke vrste Variant. Uporabljajte za vsako spremenljivko svojo vrstico.

Dim sPar1 As String

Dim sPar2 As String

Dim sPar3 As String

Dim deklarira lokalne spremenljivke znotraj podprogramov. Globalne spremenljivke se deklarira z ukazoma PUBLIC ali PRIVATE.

Skladnja:

[ReDim]Dim ImeSpr [(začetek To konec)] [As SprVrsta][, ImeSpr2 [(začetek To konec)] [As SprVrsta][,...]]

Parametri:

ImeSpr: poljubno ime za spremenljivko ali polje.

Začetek, konec: numerične vrednosti ali konstante, ki določajo število elementov (število elementov=(konec-začetek)+1) in obseg indeksa.

Začetek in konec sta lahko numerična izraza, če se na ravni procedure uporabi ukaz ReDim.

SprVrsta: ključna beseda, s katero se definira vrsta spremenljivke.

Ključna beseda: vrsta spremenljivke

Bool: Boolova spremenljivka (Res, Ni Res)

Currency: spremenljivka v denarnih enotah (s 4 decimalnimi mesti)

Date: spremenljivka vrste Date

Double: spremenljivka v plavajoči vejici dvojne dolžine (1,79769313486232 x 10E308 - 4,94065645841247 x 10E-324)

Integer: cela spremenljivka (-32768 - 32767)

Long: dolga cela spremenljivka (-2.147.483.648 - 2.147.483.647)

Object: spremenljivka vrste Object (predmet; Opomba: to spremenljivko je mogoče definirati samo z ukazom Set!)

Single: spremenljivka v plavajoči vejici enojne dolžine (3,402823 x 10E308 - 1,401298 x 10E-45)

String: Spremenljivka vrste String (niz) lahko vsebuje največ do 64,000 znakov ASCII.

[Variant]: spremenljivka vrste Variant (vsebuje vse vrste, navedene v definiciji). Če ključna beseda ni uporabljena, se spremenljivke samodejno obravnava kot vrste Variant, razen če program ne uporablja ukazov od DefBool do DefVar.

V LibreOffice Basic spremenljivk ni potrebno deklarirati eksplicitno. Če pa hočete uporabiti polje, ga morate predhodno deklarirati. Spremenljivko lahko deklarirate z ukazom Dim, pri čemer z vejicami ločite večkratne deklaracije med seboj. Če želite deklarirati vrsto spremenljivke, uporabite znak za vrsto deklaracije in ime za njim, ali pa ustrezno ključno besedo.

LibreOffice Basic podpira polja z eno ali več dimenzijami, ki so definirati za navedeno vrsto spremenljivk. Polja so primerna pomoč pri delu v programih, ki vsebujejo sezname ali pa tabele, s katerimi želite računati. Prednost polj je v tem, da lahko vedno pridete do posameznih elementov polj s pomočjo indeksov, ki jih formulirate v obliki numeričnih izrazov ali s pomočjo spremenljivk.

Polja deklariramo z ukazom Dim. Za definicijo obsega indeksa sta na voljo dve metodi:

DIM besedilo(20) as String REM 21 elementov, od 0 do 20

DIM besedilo(5 to 25) as String REM 21 elementov, od 5 do 25

DIM besedilo(-15 to 5) as String REM 21 elementov (vključno z 0)

REM oštevilčeni so od -15 do 5

Dvodimenzionalno polje

DIM text(20,2) as String REM 63 elementov; od 0 do 20 raven 1, od 0 do 2 raven 2 in od 0 do 20 raven 3

Polje lahko deklarirate dinamično, s tem da v ukazu ReDim ukazom navedete dimenzije za podprogram ali funkcijo, ki to polje uporabljata. Na splošno lahko dimenzije za polje določite samo enkrat in jih po tem ne morete več spreminjati. Znotraj podprograma lahko polje definirate z ReDim. Dimenzije se da definirati samo z numeričnimi izrazi. Tako je zagotovljeno, da so polja samo tako velika, kot je potrebno.

Primer:

Sub ExampleDim1

Dim sVar As String

Dim iVar As Integer

    sVar = "Pisarna"

End Sub

 

Sub ExampleDim2

' Dvodimenzionalno polje

Dim stext(20,2) As String

Const sDim As String = " Dimenzija:"

For i = 0 To 20

    For ii = 0 To 2

        stext(i,ii) = str(i) & sDim & str(ii)

    Next ii

Next i

For i = 0 To 20

    For ii = 0 To 2

        MsgBox stext(i,ii)

    Next ii

Next i

End Sub