Menggunakan Variabel

Penjelasan berikut menerangkan cara guna dasar variabel pada LibreOffice Basic.

Penamaan Konvensi untuk Identifir Variabel

Sebuah nama variabel dapat terdiri dari maksimal 255 karakter. Karakter pertama dari nama variabel harus menggunakan huruf A-Z atau a-z. Bilangan juga dapat digunakan dalam nama variabel, tetapi simbol tanda baca dan karakter khusus tidak diizinkan, dengan pengecualian karakter garis bawah ("_"). Pada LibreOffice Pengidentifikasi variabel dasar tidak peka huruf besar kecil. Nama-nama variabel mungkin berisi spasi tetapi harus diapit oleh tanda kurung kurung siku jika mereka melakukannya.

Contoh untuk variabel pengenal:


    MyNumber=5      'Benar'
    MyNumber5=15    'Benar'
    MyNumber_5=20   'Benar'
    My Number=20    'Tidak valid, variabel dengan spasi harus dilampirkan dengan tanda kurung siku'
    [My Number]=12  'Benar'
    DéjàVu=25       'Tidak berlaku, karakter spesial tidak diperbolehkan'
    5MyNumber=12    'Tidak berlaku, variabel tidak diperbolehkan dimulai dengan sebuah nomor'
    Number,Mine=12  'Tidak valid, tanda hubung tidak diperbolehkan'

Mendeklarasikan Variabel

Pada LibreOffice Basis anda tidak perlu mendeklarasikan variabel secara eksplisit. Deklarasi variabel dapat dilakukan dengan pernyataan Redup . Anda dapat mendeklarasikan lebih dari satu variabel sekaligus dengan memisahkan nama dengan koma. Untuk menentukan jenis variabel, gunakan salah satu deklarasi tipe tanda setelah nama, atau kata kunci yang sesuai.

Contoh untuk deklarasi variabel:


    Dim a$               'Deklarasi variabel "a" sebagai sebuah String'
    Dim a As String      'Deklarasi variabel "a" sebagai sebuah String'
    Dim a$, b As Integer 'Deklarasi satu variabel sebagai sebuah String dan satu sebagai Integer'
    Dim c As Boolean     'Deklarasi c sebagai variabel Boole yang dinyatakan dengan BENAR atau SALAH'

Sekali Anda mendeklarasikan sebuah variabel dalam jenis tertentu, Anda tidak dapat mendeklarasikan variabel tersebut lagi dalam nama yang sama dan jenis berbeda!

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.

Memaksakan Deklarasi Variabel

Untuk memaksakan pernyataan variabel, gunakanlah perintah berikut:


Option Explicit

Pernyataan Option Explicit harus berada di baris pertama modul bersangkutan, sebelumnya SUB yang pertama. Umumnya, hanya susunan (array) yang perlu dinyatakan eksplisit. Sementara pernyataan bagi variabel lainnya bergantung pada karakter deklarasi yang diketikka, atau - apabila diabaikan - sebagai jenis utama Single (tunggal).

Jenis-jenis Variabel

LibreOffice Basic mendukung empat kelas variabel:

Variabel Numerik mengandung nilai-nilai angka. Beberapa variabel digunakan untuk menyimpan sejumlah besar maupun kecil angka, dan lainnya digunakan untuk titik ambang (floating-point) atau angka-angka hasil pembagian.
Variabel String mengandung string-string karakter.
Variabel Boolean mengandung nilai TRUE (benar) atau FALSE (salah).
Variabel Objek digunakan untuk menyimpan sejumlah jenis objek, seperti tabel dan dokumen di dalam sebuah dokumen.

Variabel Integer

Variabel integer berkisar dari -32768 hingga 32767. Jika Anda menetapkan nilai floating-point ke variabel integer, tempat desimal dibulatkan ke integer berikutnya. Variabel integer dengan cepat dihitung dalam prosedur dan cocok untuk variabel penghitung dalam perulangan. Variabel integer hanya membutuhkan dua byte memori. "%" adalah karakter deklarasi jenis.


Dim Variable%
Dim Variable As Integer

Variabel Integer Panjang

Variabel integer panjang berkisar dari -2147483648 hingga 2147483647. Jika Anda menetapkan nilai titik-apung ke variabel integer panjang, desimal dibulatkan ke integer berikutnya. Variabel integer panjang dihitung dengan cepat dalam prosedur dan cocok untuk variabel cacah dalam perulangan untuk nilai besar. Variabel integer panjang membutuhkan empat byte memori. "&" adalah jenis karakter deklarasi.


Dim Variable&
Dim Variable As Long

Variabel Desimal

Variabel desimal bisa berupa angka positif, negatif, atau kosong. Keakuratannya mencapai 29 digit.

Anda dapat memakai tanda tambah (+) atau kurang (-) sebagai awalan untuk angka desimal (dengan atau tanpa spasi).

Apabila angka desimal ditetapkan sebagai variabel integer (bilangan bulat), maka LibreOffice Basic akan membulatkan angka tersebut dengan pembulatan ke atas.

Variabel Tunggal

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

Variabel Ganda

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

Variabel Mata Uang

Variabel mata uang disimpan secara internal sebagai angka 64-bit (8 byte) dan ditampilkan sebagai sebuah nomor desimal tetap dengan 15 bukan desimal dan 4 tempat desimal. Nilai berkisar dari -922337203685477.5808 sampai +922337203685477.5808. Variabel mata uang digunakan untuk menghitung nilai mata uang dengan presisi tinggi. Karakter deklarasi tipe adalah "@".


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

Variabel String

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

Variabel Boolean

Variabel boolean hanya menyimpan salah satu dari dua nilai: TRUE atau FALSE. Angka 0 berarti FALSE, sedangkan lainnya berarti TRUE.


Dim Variable As Boolean

Variabel Tanggal

Variabel tanggal hanya dapat berisi tanggal dan nilai waktu yang disimpan dalam format internal. Nilai yang ditetapkan untuk variabel tanggal dengan Serial Tanggal, Nilai Tanggal, Serial Waktu or Nilai Waktu secara otomatis dikonversi ke format internal. Variabel tanggal dikonversi ke angka normal dengan menggunakan Hari, Bulan, Tahun or the Jam, Menit, Detik fungsi. Format internal memungkinkan perbandingan nilai tanggal / waktu dengan menghitung selisih antara dua angka. Variabel-variabel ini hanya dapat dideklarasikan dengan kata kunci Tanggal.


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#


  zeroDay = #12/30/1899#
  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

Inisial Nilai Variabel

Segera setelah variabel dideklarasikan, maka ia akan secara otomatis diset menjadi nilai "Null" (kosong). Perhatikanlah konvensi berikut:

Variabel Numerik secara otomatis ditetapkan sebagai nilai "0" segera setelah dideklarasikan.

Variabel tanggal diberi nilai 0 secara internal; setara dengan mengonversi nilai menjadi "0" dengan Hari, Bulan, Tahun atau Jam, Menit, Detik fungsi.

Variabel string ditetapkan sebagai string kosong ("") saat mereka dideklarasikan.

Susunan

LibreOffice Basic tahu array satu atau multi-dimensi, didefinisikan oleh tipe variabel yang dinyatakan. Array cocok untuk menyunting daftar dan tabel dalam program. Masing-masing elemen array dapat diakses melalui indeks numerik.

Susunan (atau array) harus dideklarasikan bersama pernyataan Dim. Berikut beberapa cara untuk mendefinisikan rentang indeks dari sebuah susunan (array):


    Dim Text$(20)       '21 elemen diberi nomor dari 0 hingga 20'
    Dim Text$(5,4)      '30 elemen (sebuah matriks elemen 6x5)'
    Dim Text$(5 To 25)  '21 elemen ditandai dengan angka dari 5 hingga 25'
    Dim Text$(-15 To 5) '21 elemen (termasuk 0), ditandai dengan angka -15 hingga 5'

Rentang indeks bisa memiliki angka-angka positif dan negatif.

Konstanta

Konstanta memiliki nilai tetap. Bilangan ini hanya bisa ditentukan satu kali dan tidak dapat diubah lagi di lain waktu:


Const ConstName=Expression

Basic Constants

Dim Statement