Bekerja dengan senarai

Buat senarai baru

create_list()

Penerangan

Masukkan fungsi dalam medan "Kalkulator" dalam tetapan blok:

create_list(nama) - mencipta senarai baru. Hasilnya adalah ID senarai.

Parameter:

!** nama - nama senarai. Nama dinyatakan dalam tanda petik tunggal.

Contoh

list_id = create_list("berdaftar")

Mencipta senarai dari blok tanpa pendua

create_list_if_not_exist()

Penerangan

create_list_if_not_exist('nama_senarai') - mencipta senarai baru jika senarai dengan nama yang diberikan belum wujud dan mengembalikan pengecamnya, atau mengembalikan pengecam senarai yang sedia ada.

Parameter wajib:

nama_senarai - nama untuk senarai baru yang akan dicipta.

Contoh

new_list = create_list_if_not_exist('Senarai peserta')

Menambah pelanggan ke senarai

add_to_list()

Penerangan

add_to_list(id_senarai, id_pelanggan) - menambah pelanggan ke senarai. Fungsi mengembalikan none.

Parameter:

!** id_senarai - ID senarai

id_pelanggan - ID pelanggan MaviBot. Jika tidak diberikan, ID pelanggan semasa digunakan.

Memindahkan pelanggan ke senarai

move_to_list()

Penerangan

move_to_list(id_senarai, id_pelanggan) - memindahkan pelanggan ke senarai (Penting! Pelanggan dikeluarkan dari semua senarai lain dan dipindahkan ke senarai yang ditentukan). Hasilnya adalah nilai boolean (True atau False).

Parameter:

!** id_senarai - ID senarai

id_pelanggan - ID pelanggan MaviBot. Jika tidak diberikan, ID pelanggan semasa digunakan.

Mengeluarkan pelanggan dari senarai

remove_from_list()

Penerangan

remove_from_list(id_senarai, id_pelanggan) - mengeluarkan pelanggan dengan id_pelanggan yang ditentukan dari senarai.

Parameter:

!** id_senarai - ID senarai

id_pelanggan - ID pelanggan MaviBot. Jika tidak diberikan, ID pelanggan semasa digunakan.

Memadam senarai

remove_list_from_project(id_senarai, clear_list)

Penerangan
!** id_senarai - parameter wajib; ID senarai yang akan dipadam.

clear_list — parameter pilihan; menerima dua nilai: True atau False (lalai adalah False).

Jika anda tidak memberikan parameter ini dan senarai mengandungi pelanggan, anda akan menerima respons berikut:
"Can't delete list, list not empty"

Jika senarai kosong, ia akan dipadam tanpa masalah. Walau bagaimanapun, jika anda menetapkan clear_list kepada True, senarai akan dipadam tanpa mengira sama ada ia mengandungi pelanggan atau tidak.

Memadam tag

remove_label_from_project(id_senarai, clear_list)

Penerangan
!** id_senarai - parameter wajib; ID tag yang akan dipadam.

clear_list - parameter pilihan; menerima dua nilai: True atau False (lalai adalah False).

Jika parameter ini tidak diberikan dan tag diberikan kepada pelanggan, anda akan menerima respons berikut:
"Can't delete list, list not empty"

Jika tag tidak diberikan kepada mana-mana pelanggan, ia akan dipadam tanpa masalah. Walau bagaimanapun, jika clear_list ditetapkan kepada True, tag akan dipadam tanpa mengira sama ada ia diberikan kepada pelanggan atau tidak.

Kosongkan senarai pelanggan

clear_list()

Penerangan

clear_list(id_senarai) - mengosongkan senarai pelanggan

Parameter:

!** id_senarai - ID senarai. Selepas digunakan, semua pelanggan akan dikeluarkan dari senarai yang ditentukan.

Dapatkan bilangan pelanggan dalam senarai

list_size()

Penerangan

list_size(id_senarai) – mengira jumlah bilangan pelanggan dalam senarai

Parameter:

!** id_senarai- ID senarai

Kira bilangan kemasukan pelanggan unik merentas pelbagai senarai

lists_joint_count()

Penerangan

lists_joint_count(senarai_besar) – mengira jumlah bilangan kemasukan pelanggan unik merentas pelbagai senarai. Fungsi mengambil tatasusunan ID senarai sebagai input dan mengembalikan nombor.

Parameter:

!** senarai_besar - tatasusunan yang mengandungi ID senarai di mana kemasukan pelanggan unik akan dikira. Formatnya adalah: ['id_senarai1', 'id_senarai2', ..., 'id_senaraiN']

Contoh kod untuk disalin

/*Mencipta senarai*/
list_id = create_list('Senarai baru')

/*Semak jika pelanggan berada dalam senarai*/
k=inlist(list_id, client_id)

/*Dapatkan saiz senarai — jumlah bilangan pelanggan dalam senarai*/
razm=list_size(1)

/*Dapatkan jumlah bilangan kemasukan pelanggan unik merentas pelbagai senarai*/
k=lists_joint_count('[144636,144634]')

Semak jika pelanggan berada dalam senarai

inlist()

Penerangan

inlist(id_senarai, id_pelanggan) - menyemak jika pelanggan berada dalam senarai. Hasilnya adalah nilai boolean (True atau False).

Parameter:

!** id_senarai - ID senarai

id_pelanggan - ID pelanggan MaviBot. Jika tidak diberikan, ID pelanggan semasa digunakan.

Semak jika peserta sembang berada dalam senarai tertentu

some_client_in_list()

Penerangan

some_client_in_list(id_senarai, penerima)

Parameter:

!** id_senarai - ID senarai;

!** penerima - ID pengguna messenger yang disemak (platform_id). Untuk sembang, nilai pembolehubah adalah chat_member_id.

Ia mengembalikan nilai:

True - pelanggan berada dalam senarai;

False - pelanggan tidak berada dalam senarai yang ditentukan.

Contoh

Contoh kod untuk disalin

/*Contoh menyemak jika peserta sembang berada dalam senarai, di mana parameter pertama adalah ID senarai, dan yang kedua adalah ID sembang pengguna*/

r = some_client_in_list(123456, chat_member_id)

Mengambil elemen dari senarai

count_occurrences()

Penerangan

count_occurrences(tatasusunan, elemen) - mengembalikan bilangan elemen yang ditentukan yang terkandung dalam senarai.

Parameter:

tatasusunan - parameter wajib; senarai elemen

elemen - parameter wajib; elemen untuk dikira

Mendapatkan ID pelanggan rawak dari senarai

random_list_member(id_senarai)

Penerangan

random_list_member(id_senarai) - mengembalikan satu ID pelanggan rawak dalam senarai yang ditentukan.

id_senarai - parameter wajib, ID senarai.

ID senarai, yang mengandungi pelanggan anda, boleh didapati di bahagian "Senarai":

Contoh bekerja dengan senarai dalam Kalkulator

Mari lihat contoh penggunaan fungsi dalam "Kalkulator" untuk bekerja dengan senarai.

Penting! Anda perlu menyimpan ID senarai baru untuk menggunakannya kemudian. Untuk melakukan ini, tetapkan hasil fungsi kepada pembolehubah, iaitu list_id = ...

Sekarang anda boleh melakukan operasi lain dengan senarai dengan mudah — semak jika pelanggan berada dalam senarai, tambah, pindah, atau keluarkan pelanggan.

Sebagai contoh, mari semak jika pelanggan berada dalam senarai dengan ID 12333:

Sangat mudah untuk menggunakan senarai semasa memaparkan data statistik:

Selalunya perlu untuk mendapatkan jumlah bilangan kemasukan unik merentas satu set senarai — ini boleh dilakukan dengan mudah menggunakan fungsi lists_joint_count().

Dapatkan semua ID senarai pelanggan

get_all_client_label_ids(id_pelanggan)

Penerangan

get_all_client_list_ids(id_pelanggan) — mengembalikan tatasusunan yang mengandungi ID semua senarai yang dimiliki oleh pelanggan.

Jika pelanggan tidak tergolong dalam mana-mana senarai, fungsi mengembalikan tatasusunan kosong: [].

Parameter:

id_pelanggan — ID pelanggan Mavibot. Jika ditinggalkan, ID pelanggan semasa digunakan.