Antarmuka: Peta

aturan.Peta

antarmuka   statis

Jenis peta, digunakan untuk pemetaan nilai kunci sederhana.

Kunci harus berjenis rules.String.

Selain metode yang tercantum di bawah ini, peta memiliki operator berikut:

---

Operator	Penggunaan
x == y	Bandingkan peta x dan y
x[k]	Operator indeks, dapatkan nilai pada nama kunci k
x.k	Mendapatkan nilai pada nama kunci k
k in x	Periksa apakah kunci k ada di peta x

Metode

diff

diff(map_to_compare) menampilkan rules.MapDiff

Menampilkan rules.MapDiff yang mewakili hasil perbandingan Peta saat ini ke Peta perbandingan.

Parameter
peta_untuk_bandingkan	rules.Peta Peta tempat Peta (panggilan) saat ini akan dibandingkan. Nilai tidak boleh nol.

Hasil

Objek non-null rules.MapDiff yang mewakili hasil perbandingan.

get

get(kunci, nilai_default) menampilkan nilai

Menampilkan nilai yang terkait dengan string kunci penelusuran tertentu.

Untuk Maps bertingkat, yang melibatkan kunci dan sub-kunci, menampilkan nilai yang terkait dengan string sub-kunci tertentu. Sub-kunci diidentifikasi menggunakan daftar, item pertama adalah kunci tingkat atas dan item terakhir adalah sub-kunci yang nilainya akan dicari dan dikembalikan. Lihat Peta bertingkat contoh di bawah ini.

Fungsi ini memerlukan nilai default untuk ditampilkan jika tidak ada kecocokan dengan menemukan {i>search key<i}.

Parameter
kunci	(rules.String non-null atau rules.List non-null) Kunci yang ditentukan sebagai string, atau untuk Maps bertingkat, sub-kunci yang ditetapkan menggunakan sintaksis daftar.
default_value	default_value Nilai yang akan ditampilkan jika Peta tidak berisi kunci penelusuran yang diberikan. Dapat berupa jenis bahasa Aturan apa pun.

Hasil

value Nilai yang sesuai dengan key yang diberikan, atau nilai nilai default yang ditentukan oleh default_value jika tidak cocok dengan kunci yang diberikan ditemukan. Karena konten Peta ditentukan oleh pengguna, maka jenis data value yang ditampilkan dapat berupa jenis bahasa Aturan apa pun.

Contoh

// "c" is not a key in the supplied Map, returns default value 7.
{"a": 3,"b": 2}.get("c", 7) == 7

// Default result can be any type, e.g. a list such as [1, 1].
{"a": [2, 7], "b": [9, 12]}.get("c", [1, 1]) == [1, 1]

// Return a list on a successful match.
{"a": [2, 7],"b": [9, 12]}.get("b", [1, 1]) == [9, 12]

// For nested Maps, use list ["a", "b"] to specify lookup on sub-key "b".
{"a": {"b": 1},"c": 2}.get(["a", "b"], 7) == 1

kunci

keys() menampilkan rules.List

Dapatkan daftar kunci di peta.

Hasil

non-null rules.List daftar kunci.

ukuran

size() menampilkan rules.Integer

Dapatkan jumlah entri dalam peta.

Hasil

non-null rules.Integer jumlah entri.

nilai

values() menampilkan rules.List

Dapatkan daftar nilai di peta.

Hasil

non-null rules.List daftar nilai.