varijable

Slijedeće opisuje osnovnu upotrebu procedura i funkcija u LibreOffice Basic-u.

Naming Conventions for Variable Identifiers

A variable name can consist of a maximum of 255 characters. The first character of a variable name must be a letter A-Z or a-z. Numbers can also be used in a variable name, but punctuation symbols and special characters are not permitted, with exception of the underscore character ("_"). In LibreOffice Basic variable identifiers are not case-sensitive. Variable names may contain spaces but must be enclosed in square brackets if they do.

Examples for variable identifiers:

    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'

Deklarisanje Varijabli

U LibreOffice Basicu varijable se ne moraju deklarisati eksplicitno. Varijabla se može deklarisati sa Dim iskazom. Može se deklarisati više varijabli u isto vrijeme odvajanjem imena zarezom. Da bi se definisao tip varijable, koristi ili znak za deklaraciju tipa poslije imena , ili odgovarajuću ključnu riječ.

Primjeri za deklarisanje varijabli:

    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'

Kada se varijabla deklariše kao određeni tip, ne može se ponovo deklarisati pod istim imenom a drugim tipom!

When you declare multiple variables in a single line of code you need to specify the type of each variable. If the type of a variable is not explicitly specified, then Basic will assume that the variable is of the Variant type.

  ' Both variables "a" and "b" are of the Integer type
  Dim a As Integer, b As Integer
  ' Variable "c" is a Variant and "d" is an Integer
  Dim c, d As Integer
  ' A variable can also be explicitly declared as a Variant
  Dim e As Variant, f As Double

The Variant type is a special data type that can store any kind of value. To learn more, refer to the section The Variant type below.

Forsiranje Deklaracije Varijable

Da bi se primorala deklaracija varijabli, koristi slijedeću komandu:

Option Explicit

Opcija Eksplicitna iskaz mora biti prvi red u modulu, prije prvog SUBa. Općenito, samo nizovi moraju biti deklarisani eksplicitno. Sve ostale varijable se deklarišu na osnovu karaktera za deklaraciju tipa, ili - ako je izostavljeno - kao dodijeljeni tip Single.

Tipovi Varijable

LibreOffice Basic podržava četiri klase variableČ

• Numeričke varijable mogu sadržati vrijednosti brojeva. Neke varijable se koriste da bi pohranili velike ili male brojeve, a druge za brojeve s pomičnim zarezom ili razlomke.

• String varijable sadrže stringove znakova (karaktera).

• Boolean variable sadrže ili TAČNO ili NETAČNO vrijednosti.

• Objekat varijable mogu pohraniti različite vrste objekata, kao tabele i dokumente unutar dokumenta.

Varijable Cijelih Brojeva (Integer)

Raspon varijabli Integer (Cijeli Brojevi) je od -32768 do 32767. Ako dodijeliš vrijednost sa pomičnim zarezom varijabli koja je cijeli broj, decimalna mjesta se zaokružuju kao naredni cijeli broj. Varijable cijelih brojeva se brzo računaju u procedurama i pogodne su za varijable brojača u petljama. Varijabla Cijeli Broj zahtijeva samo dva bajta memorije. "%" je karakter za deklaraciju tipa.

Dim Variable%
Dim Variable As Integer

Long Integer Varijable

Raspon Long Integer (Dugi Cijeli Broj) varijabli je od -2147483648 do 2147483647. Ako dodijelite vrijednost sa pomičnim zarezom varijabli Long Integer, decimalna mjesta su zaokružena na naredni cijeli broj. Long integer varijable se brzo računaju u procedurama i prikladne su za varijable brojača u petljama za velike vrijednosti. Long Integer varijabla zauzima četiri bajta memorije. "&" je karakter za deklaraciju tipa.

Dim Variable&
Dim Variable As Long

Decimalne Varijable

Decimalne variable mogu imati pozitivne ili negativne brojeve ili nulu. Ispravnost je do 29 decimala.

Možete koristiti plus (+) ili minus (-) kao prefikse za decimalne brojeve (sa ili bez razmaka).

Ako je decimalni broj dodijeljen varijabli Integer (Cijelog Broja), LibreOffice Basic zaokružuje cifru niže ili više.

Single Varijable

Single variables can take positive or negative values ranging from 3.402823 x 10E38 to 1.401298 x 10E-45. Single variables are floating-point variables, in which the decimal precision decreases as the non-decimal part of the number increases. Single variables are suitable for mathematical calculations of average precision. Calculations require more time than for Integer variables, but are faster than calculations with Double variables. A Single variable requires 4 bytes of memory. The type-declaration character is "!".

Dim Variable!
Dim Variable As Single

Duple Varijable

Double variables can take positive or negative values ranging from 1.79769313486232 x 10E308 to 4.94065645841247 x 10E-324. Double variables are floating-point variables, in which the decimal precision decreases as the non-decimal part of the number increases. Double variables are suitable for precise calculations. Calculations require more time than for Single variables. A Double variable requires 8 bytes of memory. The type-declaration character is "#".

Dim Variable#
Dim Variable As Double

Varijable Currency (Valute)

Currency varijable su interno pohranjene kao 64-bitni brojevi (8 Bajta) i prikazane kao brojevi sa fiksnom decimalom sa 15 ne-decimalnih i 4 decimalna mjesta. Vrijednosti su u rasponu od -922337203685477.5808 do +922337203685477.5807. Currency varijable se koriste za računanje vrijednosti valute sa visokom preciznošću. Karakter za deklaraciju tipa je "@".

Dim Variable@
Dim Variable As Currency

Literals for integers

Numbers can be encoded using octal and hexadecimal forms.

  xi = &o13 '    8 + 3
  ci = &h65 ' 6*16 + 5
  MAX_Integer =  &o77777 '  32767 = &h7FFF
  MIN_Integer = &o100000 ' -32768 = &h8000
  MAX_Long = &h7fffffff '  2147483647 = &o17777777777
  MIN_Long = &h80000000 ' -2147483648 = &o20000000000

String Varijable

String variables can hold character strings with up to 2,147,483,648 characters. Each character is stored as the corresponding Unicode value. String variables are suitable for word processing within programs and for temporary storage of any non-printable character up to a maximum length of 2 Gbytes. The memory required for storing string variables depends on the number of characters in the variable. The type-declaration character is "$".

In BASIC String functions, the first character of the string has index 1.

Dim Variable$
Dim Variable As String

Boolean Varijable

Boolean varijable pohranjuju samo jednu od dvije vrijednosti: TRUE ili FALSE (TAČNO ili NETAČNO). Broj 0 jednak je FALSE, svaka druga vrijednost jednaka je TRUE.

Dim Variable As Boolean

Varijable Date (Datum)

Date varijable mogu sadržati samo datume i vrijednosti za vrijeme pohranjene u internom formatu. Vrijednosti dodijeljene varijablama Date sa Dateserial, Datevalue, Timeserial ili Timevalue su automatski pretvorene u interni format. Varijable Date su pretvorene u normalne brojeve koristeći Day, Mjesec, Godina or the Hour, Minute, Second funkcijom. Interni format omogućava usporedbu vrijednosti datuma i vremena računanjem razlike između dva broja. Ove varijable se mogu deklarisati samo ključnom rječju Datum.

Dim Variable As Date

Literals for Dates

Date literals allow to specify unambiguous date variables that are independent from the current language. Literals are enclosed between hash signs #. Possible formats are:

• #yyyy-mm-dd#

• #mm/dd/yyyy#

  start_date = #12/30/1899# ' = 1
  dob = #2010-09-28#

The Variant type

Variables declared as Variant can handle any data type. This means that the actual data type is defined during runtime as a value is assigned to the variable.

There are three main ways to create a Variant variable, as shown below:

  Dim varA            ' The type is not specified, hence the variable is a Variant
  Dim varB as Variant ' The variable is explicitly declared as a Variant
  varC = "abc"        ' Previously undeclared variables are treated as Variants

The example below uses the TypeName function to show how the type of a Variant variable changes upon assignment.

  Dim myVar As Variant
  MsgBox TypeName(myVar) ' Empty
  myVar = "Hello!"
  MsgBox TypeName(myVar) ' String
  myVar = 10
  MsgBox TypeName(myVar) ' Integer

A Variant variable is initialized with the Empty special data type. You can use the IsEmpty function to test if a variable is an Empty Variant.

You can also use the keyword Any to declare a variable as a Variant. However, Any is deprecated and is available for backward compatibility.

Arguments with type Variant or Any passed in function calls are not checked for their types.

  Dim myVar As Any ' Variable "myVar" is a Variant

Početne Vrijednosti Varijabli

Čim se varijabla deklariše, automatski je postavljena na vrijednost"Null" (Nula). Zapamti slijedeća pravilas:

Numeričke varijablama je automatski dodijeljena vrijednost "0" čim su deklarisane.

Date variables dodijeljena vrijednost 0 interno; ekvivalent za pretvaranje vrijednosti u "0" sa Day, Mjesec, Godina ili Hour, Minute, Secondfunkcijom.

String variables varijablama se dodjeljuje prazan string ("") kada se deklarišu.

Arrays (Matrica)

LibreOffice Basic poznaje jedno- ili više-dimenzionalne matrice, definisane određenim tipom varijable. Arrays su prikladne za editovanje listi i tabela u programima. Pojedinačni elementi matrice se mogu adresirati kroz numerički indeks.

Matrice moraju deklarisane sa Dim iskazom. Postoji nekoliko načina da se definiše raspon indeksa matrice:

    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'

Raspon indeksa uključuje pozitivne kao i negativne brojeve.

Konstante

Konstante imaju fiksiranu vrijednost. Također su definisane samo jednom u programu i ne mogu se ponovo definisati:

Const ConstName=Expression