Dim Statement
Deklaruje premennú alebo pole.
Ak sú premenné oddelené čiarkou (napr. DIM sPar1, sPar2, sPar3 AS STRING), je možné definovať len premenné Variant. Každú premennú definujte na samostatnom riadku.
Dim sPar1 As String
Dim sPar2 As String
Dim sPar3 As String
Dim deklaruje miestne premenné v podprograme. Globálne premenné sa deklarujú príkazom PUBLIC alebo PRIVATE.
Syntax:
[ReDim]Dim NázovPremennej [(začiatok To koniec)] [As TypPremennej][, NázovPremenne2 [(začiatok To koniec)] [As TypPremennej][,...]]
Paremetre:
NázovPremennej: Platný názov premennej alebo poľa.
Začiatok, Koniec: Číselné hodnoty alebo konštanty, ktoré definujú počet prvkov (PočetPrvkov = (koniec-začiatok) +1) a rozsah indexu.
Začiatok a Koniec môžu byť číselné výrazy, ak sa ReDim použije na úrovni procedúry.
TypPremennej: Kľúčové slovo určujúce dátový typ premennej.
Kľúčové slovo: Typ premennej
Bool: Boolovská premenná (True, False)
Currency: Premenná meny (mena so 4 desatinnými miestami)
Date: Dátumová premenná
Double: Premenná v plávajúcej rádovej čiarke (1,79769313486232 × 10E308 - 4,94065645841247 × 10E-324)
Integer: Celočíselná premenná (-32768 - 32767)
Long: Dlhá celočíselná premenná (-2 147 483 648 – 2 147 483 647)
Object: Objektová premenná (Poznámka: túto premennú možno následne definovať pomocou Set)
Single: Premenná v plávajúcej rádovej čiarke (3,402823 x 10E38 - 1,401298 x 10E-45).
String: Reťazec obsahujúci maximálne 64000 ASCII znakov.
[Variant]: Premenná typu Variant (obsahuje všetky typy, určuje sa v definícii). Pokiaľ nie je zadané kľúčové slovo, premennej sa automaticky priradí typ Variant, ak sa neuplatní príkaz DefBool až DefVar.
V jazyku LibreOffice Basic nemusíte premenné deklarovať explicitne. Avšak musíte pred použitím deklarovať pole. Premennú je možné deklarovať pomocou príkazu Dim a použiť čiarky na oddelenie niekoľkých deklarácií. Ak chcete deklarovať typ premennej, použite znak typovej deklarácie alebo zodpovedajúce kľúčové slovo.
LibreOffice Basic podporuje jedno- i viacrozmerné polia, ktoré sa definujú určeným typom premennej. Polia sú vhodné, ak chcete v programe použiť zoznam alebo tabuľku, ktoré chcete upravovať. Výhodou polí je, že k jednotlivým prvkom je možné pristupovať pomocou indexov, ktoré možno vyjadriť číselným výrazom alebo premennou.
Polia sa deklarujú príkazom Dim. Rozsah indexu možno definovať dvoma spôsobmi:
DIM text(20) as String REM 21 prvkov číslovaných od 0 do 20
DIM text(5 to 25) as String REM 21 prvkov číslovaných od 5 do 25
DIM text(-15 to 5) as String REM 21 prvkov (vrátane 0)
REM číslované od -15 do 5
Dvojrozmerné dátové pole
DIM text(20,2) as String REM 63 prvkov; od 0 do 20 úroveň 1, od 0 do 20 úroveň 2 a od 0 do 20 úroveň 3.
Pole je možné deklarovať ako dynamické, pokiaľ v podprograme, kde chcete s poľom pracovať, definujete rozmery pomocou príkazu ReDim. Všeobecne možno rozmery určiť len raz. Potom ich nemožno zmeniť. V podprograme je možné deklarovať pole pomocou ReDim. Rozmery je možné definovať len číselným výrazom. To zaručuje, že sú polia veľké len tak, ako je potrebné.
Príklad:
Sub ExampleDim1
Dim sVar As String
Dim iVar As Integer
sVar = "Office"
End Sub
Sub ExampleDim2
Dvojrozmerné dátové pole
Dim stext(20,2) As String
Const sDim as String = " Dimension:"
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