Menyalin elemen-elemen dalam array dari posisi start berdasarkan panjang tertentu dan mengembalikan elemen-elemen tersebut sebagai array baru.
Sintaksis
array<T> slice(array<T> <a>, <start>, <length>)Parameter
a: Wajib. Menentukan array.
Tdalamarray<T>menunjukkan tipe data elemen-elemen dalam array, yang dapat berupa tipe apa pun.start: Wajib. Parameter ini menentukan posisi awal untuk menyalin elemen dari kiri ke kanan. Nilai positif minimum untuk parameter ini adalah 1. Anda juga dapat menetapkan nilai negatif untuk parameter start. Dalam hal ini, posisi awal dihitung dari akhir array, tetapi elemen-elemen tetap disalin dari kiri ke kanan.
length: Wajib. Menentukan jumlah elemen dalam array hasil. Nilainya harus lebih besar dari atau sama dengan 0. Jika nilainya melebihi panjang array input, fungsi akan mengembalikan array baru yang mencakup elemen-elemen dari posisi start hingga akhir array input.
Nilai pengembalian
Mengembalikan nilai bertipe ARRAY.
Contoh
Contoh 1: Menyalin elemen-elemen dalam
array(10, 20, 20, null, null, 30)dari posisi1dengan panjang3. Pernyataan contoh:-- Nilai pengembalian adalah [10, 20, 20]. select slice(array(10, 20, 20, null, null, 30), 1, 3);Contoh 2: Menyalin elemen-elemen dalam
array(10, 20, 20, null, null, 30)dari posisi-2dengan panjang2. Pernyataan contoh:-- Nilai pengembalian adalah [null, 30]. select slice(array(10, 20, 20, null, null, 30), -2, 2);Contoh 3: Menyalin elemen-elemen dalam
array(10, 20, 20, null, null, 30)dari posisi3dengan panjang10. Pernyataan contoh:-- Nilai pengembalian adalah [20, null, null, 30]. select slice(array(10, 20, 20, null, null, 30), 3, 10);Contoh 4: Menyalin elemen-elemen dalam
array(10, 20, 20, null, null, 30)dari posisi3dengan panjang0. Pernyataan contoh:-- Nilai pengembalian adalah []. select slice(array(10, 20, 20, null, null, 30), 3, 0);
Fungsi terkait
SLICE merupakan fungsi tipe kompleks. Untuk informasi lebih lanjut tentang fungsi-fungsi yang digunakan untuk memproses data tipe kompleks seperti ARRAY, MAP, STRUCT, dan JSON, lihat Fungsi Tipe Kompleks.