Construct 2 Indonesia Manual: Bab Plugin Reference - 8. Dictionary

Object: Dictionary menyimpan String dan angka. Setiap nilai memiliki kunci yang terkait, berupa String. Dictionary adalah Object yang berfungsi sebagai penyimpanan data (Storage) – tidak melakukan pengecekan ejaan atau fitur khusus bahasa.

Nama kunci dalam Object: Dictionary selalu bersifat Case Sensitive. Ini berarti kata kunci “SKOR” dianggap berbeda dengan kata kunci “skor”.

Contoh

Misalkan nomor 100 disimpan dengan kata kunci “skor”, dan String “Joe” disimpan dengan kata kunci “nama”. Hasil penyimpanan seperti tabel berikut:

    “nama”: “Joe”

    “skor”: 100

Mengambil kata kunci “nama” dengan Action: Dictionary.Get(“nama”) akan mendapatkan “Joe”, dan mengambil “skor” akan mendapatkan 100. Menetapkan “skor” menjadi 50 akan mengubah nilai pada kata kunci.

Ini seperti menyimpan data pada Instance Variable atau Event Variable, namun karena Anda dapat menggunakan String sebagai kata kunci, Anda dapat menyimpan lebih banyak nilai.

Dictionary Conditions

• Compare value
  Bandingkan nilai yang tersimpan dalam sebuah kunci.
  
  
• Has key
  Untuk memeriksa apakah ada kunci tertentu dalam penyimpanan (Dictionary).
  
  
• Is empty
  TRUE bila tidak ada kunci sama sekali dalam Dictionary.
  
  
• For each key
  Ulangi Event satu kali untuk setiap kunci Dictionary. Expression: CurrentKey dan CurrentValue digunakan untuk mendapatkan kata kunci saat ini dan masing-masing nilainya.
  
  
• Compare current value
  Bandingkan nilai kunci saat ini (Hanya berlaku untuk Event: For each key).

Dictionary Actions

• Add key
  Tambahkan kata kunci baru ke Dictionary, dengan nilai yang diberikan. Jika kata kunci sudah ada, maka nilainya akan diperbarui.
  
  
• Clear
  Hapus semua kunci dari Dictionary, membuat Object menjadi kosong.
  
  
• Delete key
  Hapus kunci tertentu beserta nilainya dari Dictionary. Jika kuncinya tidak ada, ini tidak berpengaruh.
  
  
• Set key
  Perbarui nilai untuk kata kunci yang sudah ada. Jika kuncinya tidak ada, ini tidak berpengaruh (Tidak seperti Action: Add key, Action ini tidak membuat kunci baru).
  
  
• Download (JSON)
  Meminta browser mendownload dari sebuah file yang berisi isi Dictionary dalam format JSON. Ini ditujukan untuk pengembangan dalam mode Offline, misalnya: membuat ‘Level Editor’.
  
  
• Load (JSON)
  Muat semua kunci dan nilai dari data JSON yang sebelumnya diambil dari Object: Dictionary menggunakan Action: Download atau Expression: AsJSON.

Dictionary Expressions

• Get
  Mengambil nilai yang tersimpan untuk sebuah kata kunci, misalnya: Dictionary.Get(“skor”). Jika kuncinya tidak ada, akan menghasilkan nilai 0.
  
  
• KeyCount
  Mendapatkan jumlah kunci dalam Dictionary.
  
  
• CurrentKey
• CurrentValue
  Dalam Event: For each key, Action ini digunakan untuk mengambil kunci dan nilainya (masing-masing) untuk kunci saat ini pada saat perulangan (Iteration).
  
  
• AsJSON
  Mengambil isi Object: Dictionary dalam format JSON. Ini kemudian dapat dimuat kembali dengan Action: Load, dikirim ke server melalui AJAX, disimpan ke disk, dan seterusnya.