Darbs ar sarakstiem

Izveidot jaunu sarakstu

create_list()

Apraksts

Ievadiet funkciju bloka iestatījumu laukā "Kalkulators":

create_list(name) - izveido jaunu sarakstu. Rezultāts ir saraksta ID.

Parametri:

! name - saraksta nosaukums. Nosaukums tiek norādīts vienpēdiņās.

Piemērs

list_id = create_list("registered")

Saraksta izveide no bloka bez dublikātiem

create_list_if_not_exist()

Apraksts

create_list_if_not_exist('list_name') - izveido jaunu sarakstu, ja tāds ar doto nosaukumu vēl neeksistē, un atgriež tā identifikatoru, vai arī atgriež esošā saraksta identifikatoru.

Obligāts parametrs:

list_name - nosaukums jaunajam izveidojamajam sarakstam.

Piemērs

new_list = create_list_if_not_exist('List of participants')

Klienta pievienošana sarakstam

add_to_list()

Apraksts

add_to_list(list_id, client_id) - pievieno klientu sarakstam. Funkcija atgriež none.

Parametri:

! list_id - saraksta ID

client_id - MaviBot klienta ID. Ja nav norādīts, tiek izmantots pašreizējā klienta ID.

Klienta pārvietošana uz sarakstu

move_to_list()

Apraksts

move_to_list(list_id, client_id) - pārvieto klientu uz sarakstu (Svarīgi! Klients tiek noņemts no visiem citiem sarakstiem un pārvietots uz norādīto). Rezultāts ir Būla vērtība (True vai False).

Parametri:

! list_id - saraksta ID

client_id - MaviBot klienta ID. Ja nav norādīts, tiek izmantots pašreizējā klienta ID.

Klienta noņemšana no saraksta

remove_from_list()

Apraksts

remove_from_list(list_id, client_id) - noņem klientu ar norādīto client_id no saraksta.

Parametri:

! list_id - saraksta ID

client_id - MaviBot klienta ID. Ja nav norādīts, tiek izmantots pašreizējā klienta ID.

Sarakstu dzēšana

remove_list_from_project(list_id, clear_list)

Apraksts
! list_id - obligāts parametrs; dzēšamā saraksta ID.

clear_list — neobligāts parametrs; pieņem divas vērtības: True vai False (noklusējums ir False).

Ja nenorādīsiet šo parametru un sarakstā ir klienti, jūs saņemsiet šādu atbildi:
"Can't delete list, list not empty"

Ja saraksts ir tukšs, tas tiks dzēsts bez problēmām. Tomēr, ja iestatīsiet clear_list uz True, saraksts tiks dzēsts neatkarīgi no tā, vai tajā ir klienti vai nav.

Birku dzēšana

remove_label_from_project(list_id, clear_list)

Apraksts
! list_id - obligāts parametrs; dzēšamās birgas ID.

clear_list - neobligāts parametrs; pieņem divas vērtības: True vai False (noklusējums ir False).

Ja šis parametrs nav norādīts un birga ir piešķirta klientiem, jūs saņemsiet šādu atbildi:
"Can't delete list, list not empty"

Ja birga nav piešķirta nevienam klientam, tā tiks dzēsta bez problēmām. Tomēr, ja clear_list ir iestatīts uz True, birga tiks dzēsta neatkarīgi no tā, vai tā ir piešķirta klientiem vai nav.

Klientu saraksta notīrīšana

clear_list()

Apraksts

clear_list(list_id) - notīra klientu sarakstu

Parametri:

! list_id - saraksta ID. Pēc lietošanas visi klienti tiks noņemti no norādītā saraksta.

Iegūt klientu skaitu sarakstā

list_size()

Apraksts

list_size(list_id) – saskaita kopējo klientu skaitu sarakstā

Parametri:

! list_id- saraksta ID

Saskaitīt unikālo klientu ierakstu skaitu vairākos sarakstos

lists_joint_count()

Apraksts

lists_joint_count(massive_list) – saskaita kopējo unikālo klientu ierakstu skaitu vairākos sarakstos. Funkcija kā ievadi saņem saraksta ID masīvu un atgriež skaitli.

Parametri:

! massive_list - masīvs, kas satur saraksta ID, kuros tiks skaitīti unikālie klientu ieraksti. Formāts ir: ['list_id1', 'list_id2', ..., 'list_idN']

Koda piemērs kopēšanai

/*Creating a list*/
list_id = create_list('New list')

/*Check if the client is in the list*/
k=inlist(list_id, client_id)

/*Get the size of the list — total number of clients in the list*/
razm=list_size(1)

/*Get the total number of unique client entries across multiple lists*/
k=lists_joint_count('[144636,144634]')

Pārbaudīt, vai klients ir sarakstā

inlist()

Apraksts

inlist(list_id,client_id) - pārbauda, vai klients ir sarakstā. Rezultāts ir Būla vērtība (True vai False).

Parametri:

! list_id - saraksta ID

client_id - MaviBot klienta ID. Ja nav norādīts, tiek izmantots pašreizējā klienta ID.

Pārbaudīt, vai tērzēšanas dalībnieks ir konkrētā sarakstā

some_client_in_list()

Apraksts

some_client_in_list(list_id, recepient)

Parametri:

! list_id - saraksta ID;

! recepient - pārbaudāmā ziņojumapmaiņas lietotāja ID (platform_id). Tērzēšanām tiek izmantota mainīgā chat_member_id vērtība.

Atgriež vērtības:

True - klients ir sarakstā;

False - klients nav norādītajā sarakstā.

Piemērs

Koda piemērs kopēšanai

/*Example of checking if a chat participant is in the list, where the first parameter is the list ID, and the second is the user's chat ID*/

r = some_client_in_list(123456, chat_member_id)

Elementu iegūšana no saraksta

count_occurrences()

Apraksts

count_occurrences(array, element) - atgriež norādīto elementu skaitu, kas atrodas sarakstā.

Parametri:

array - obligāts parametrs; elementu saraksts

element - obligāts parametrs; skaitāmais elements

Nejauša klienta ID iegūšana no saraksta

random_list_member(list_id)

Apraksts

random_list_member(list_id) - atgriež vienu nejaušu klienta ID norādītajā sarakstā.

list_id - obligāts parametrs, saraksta ID.

Saraksta ID, kas satur jūsu klientus, var atrast sadaļā "Saraksti":

Piemērs darbam ar sarakstiem kalkulatorā

piemērs

Apskatīsim piemēru funkciju izmantošanai "Kalkulatorā" darbam ar sarakstiem.

Svarīgi! Jums ir jāsaglabā jaunā saraksta ID, lai to izmantotu vēlāk. Lai to izdarītu, piešķiriet funkcijas rezultātu mainīgajam, t.i., list_id = ...

Tagad jūs varat viegli veikt citas darbības ar sarakstu — pārbaudīt, vai klients ir sarakstā, pievienot, pārvietot vai noņemt klientu.

Piemēram, pārbaudīsim, vai klients ir sarakstā ar ID 12333:

Ir ļoti ērti izmantot sarakstus, attēlojot statistikas datus:

Bieži vien ir nepieciešams iegūt kopējo unikālo ierakstu skaitu vairākos sarakstos — to var viegli izdarīt, izmantojot funkciju lists_joint_count().

Iegūt visus klienta saraksta ID

get_all_client_label_ids(client_id)

Apraksts

get_all_client_list_ids(client_id) — atgriež masīvu, kas satur visu to sarakstu ID, kuros klients atrodas.

Ja klients neatrodas nevienā sarakstā, funkcija atgriež tukšu masīvu: [].

Parametri:

client_id — Mavibot klienta ID. Ja izlaists, tiek izmantots pašreizējā klienta ID.