Modul
Isi
Indeks 🔎︎

# 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 siku jika mereka melakukannya.

Contoh untuk variabel pengenal:

    MyNumber=5
| Benar
    MyNumber5=15
| Benar
    MyNumber_5=20
| Benar
    My Number=20
| Tidak sah, variabel dengan spasi harus digabung dengan kurung siku
    [My Number]=12
| Benar
    DéjàVu=25
| Tidak sah, karakter spesial tidak diperbolehkan
    5MyNumber=12
| Tidak sah, variabel tidak dimulai dengan angka
    Number,Mine=12
| Tidak sah, tanda baca 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 tipe variabel, gunakan salah satu deklarasi tipe tanda setelah nama, atau kata kunci yang sesuai.

Contoh untuk deklarasi variabel:

    Dim a$
| Mendeklarasikan variabel "a" sebagai sebuah String
    Dim a As String
| Mendeklarasikan variabel "a" sebagai sebuah String
    Dim a$, b As Integer
| Mendeklarasikan sebuah variabel sebagai String dan lainnya sebagai Integer
    Dim c As Boolean
| Mendeklarasikan c sebagai variabel Boolean yang dapat TRUE (benar) atau FALSE (salah)

Ini sangat penting ketika menyatakan variabel yang Anda gunakan karakter deklarasi tipe setiap kali, bahkan jika telah digunakan dalam deklarasi bukan kata kunci. Pernyataan berikut tidak berlaku:

    Dim a$
| Mendeklarasikan "a" sebagai sebuah String
    a="TestString"
| Ketikan deklarasi yang hilang: "a$="

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

### 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 tipe.

    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 tipe 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

Variabel tunggal dapat mengambil nilai positif atau negatif mulai dari 3,402823 x 10E38 hingga 1,401298 x 10E-45. Variabel tunggal adalah variabel titik-apung, di mana ketepatan desimal menurun sebagai bagian bukan desimal dari jumlah meningkat. Variabel tunggal cocok untuk perhitungan matematika presisi rata-rata. Perhitungan membutuhkan lebih banyak waktu daripada untuk variabel Integer, tetapi lebih cepat daripada perhitungan dengan variabel Ganda. Satu variabel membutuhkan 4 byte memori. Karakter tipe deklarasi adalah "!".

    Dim Variable!

    Dim Variable As Single

### Variabel Ganda

Variabel ganda dapat mengambil nilai positif atau negatif mulai dari 1,79769313486232 x 10E308 hingga 4,94065645841247 x 10E-324. Variabel ganda adalah variabel titik-apung, di mana ketepatan desimal menurun sebagai bagian bukan desimal dari jumlah meningkat. Variabel ganda cocok untuk perhitungan yang tepat. Perhitungan membutuhkan lebih banyak waktu daripada untuk variabel Tunggal. Variabel Ganda membutuhkan 8 byte memori. Karakter tipe deklarasi adalah "#".

    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

### Variabel String

Variabel string dapat menahan string karakter hingga 65.535 karakter. Setiap karakter disimpan sebagai nilai Unicode yang sesuai. Variabel string cocok untuk pengolah kata dalam program dan untuk penyimpanan sementara dari karakter yang tidak dapat dicetak hingga panjang maksimum 64 Kbytes. Memori yang diperlukan untuk menyimpan variabel string tergantung pada jumlah karakter dalam variabel. Karakter deklarasi tipe adalah "$".

    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

## 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 jangkauan indeks dari sebuah susunan (array):

    Dim Text$(20)
| 21 elemen dinomori dari 0 sampai 20
    Dim Text$(5,4)
| 30 elemen (metriks dari 6 x 5 elemen)
    Dim Text$(5 To 25)
| 21 elemen dinomori dari 5 sampai 25
    Dim Text$(-15 To 5)
| 21 elemen (termasuk 0), dinomori dari -15 sampai 5

Jangkauan 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