All Products
Search
Document Center

MaxCompute:ALL_MATCH

Last Updated:Jul 02, 2025

Memeriksa apakah semua elemen dalam Array a memenuhi kondisi predicate.

Sintaksis

boolean all_match(array<T> <a>, function<T, boolean> <predicate>)

Parameter

  • a: Wajib. Menentukan array. T dalam array<T> menentukan tipe data elemen-elemen dalam array, yang dapat berupa tipe data apa pun.

  • predicate: Wajib. Menentukan fungsi bawaan, fungsi yang ditentukan pengguna, atau ekspresi untuk mengevaluasi apakah semua elemen dalam Array a memenuhi persyaratan. Tipe data parameter input harus sesuai dengan tipe data elemen-elemen dalam Array a.

Nilai kembali

Mengembalikan nilai BOOLEAN berdasarkan aturan berikut:

  • Jika semua elemen dalam Array a memenuhi kondisi predicate, atau jika array kosong, mengembalikan True.

  • Jika satu atau lebih elemen dalam Array a tidak memenuhi kondisi predicate, mengembalikan False.

  • Jika sebuah elemen dalam Array a adalah null dan elemen lainnya memenuhi kondisi predicate, mengembalikan NULL.

Contoh

  • Contoh 1: Memeriksa apakah semua elemen dalam array(4, 5, 6) memenuhi kondisi x -> x > 3. Contoh pernyataan:

    -- Nilai kembali adalah true. 
    select all_match(array(4, 5, 6), x -> x>3);
  • Contoh 2: Array kosong. Contoh pernyataan:

    -- Nilai kembali adalah true. 
    select all_match(array(), x -> x>3);
  • Contoh 3: Memeriksa apakah semua elemen dalam array(1, 2, -10, 100, -30) memenuhi kondisi x -> x > 3. Contoh pernyataan:

    -- Nilai kembali adalah false. 
    select all_match(array(1, 2, -10, 100, -30), x -> x>3);
  • Contoh 4: Memeriksa apakah semua elemen dalam array(10, 100, 30, null) memenuhi kondisi x -> x > 3. Contoh pernyataan:

    -- Nilai kembali adalah null. 
    select all_match(array(10, 100, 30, null), x -> x>3);

Fungsi terkait

  • ALL_MATCH adalah fungsi tipe kompleks. Untuk informasi lebih lanjut tentang fungsi-fungsi yang digunakan untuk memproses data dari tipe data kompleks seperti ARRAY, MAP, STRUCT, dan JSON, lihat Fungsi Tipe Kompleks.

  • Dalam contoh-contoh di atas, kombinasi tanda hubung dan tanda kurung penutup (->) digunakan. Untuk informasi lebih lanjut tentang cara menggunakan kombinasi tanda hubung dan tanda kurung penutup (->) dalam fungsi Lambda, lihat Fungsi Lambda.