Жаңа тізім құру

create_list()

Сипаттама

Блок параметрлеріндегі "Калькулятор" өрісіне функцияны енгізіңіз:

create_list(name) - жаңа тізім жасайды. Нәтиже - тізім идентификаторы.

Параметрлер:

!** name** - тізім атауы. Атау жалғыз тырнақшада көрсетіледі.

Мысал

list_id = create_list("registered")

Қайталанбайтын тізімді блоктан құру

create_list_if_not_exist()

Сипаттама

create_list_if_not_exist('list_name') - егер берілген атаумен тізім әлі жоқ болса, жаңа тізім жасайды және оның идентификаторын қайтарады, немесе бар тізімнің идентификаторын қайтарады.

Қажетті параметр:

list_name - жасалатын жаңа тізімнің атауы.

Мысал

new_list = create_list_if_not_exist('Қатысушылар тізімі')

Клиентті тізімге қосу

add_to_list()

Сипаттама

add_to_list(list_id, client_id) - клиентті тізімге қосады. Функция none мәнін қайтарады.

Параметрлер:

!** list_id** - тізім идентификаторы

client_id - MaviBot клиент идентификаторы. Егер көрсетілмесе, ағымдағы клиенттің идентификаторы қолданылады.

Клиентті тізімге жылжыту

move_to_list()

Сипаттама

move_to_list(list_id, client_id) - клиентті тізімге жылжытады (Маңызды! Клиент барлық басқа тізімдерден жойылып, көрсетілген тізімге жылжытылады). Нәтиже - логикалық мән (True немесе False).

Параметрлер:

!** list_id** - тізім идентификаторы

client_id - MaviBot клиент идентификаторы. Егер көрсетілмесе, ағымдағы клиенттің идентификаторы қолданылады.

Клиентті тізімнен жою

remove_from_list()

Сипаттама

remove_from_list(list_id, client_id) - көрсетілген client_id бар клиентті тізімнен жояды.

Параметрлер:

!** list_id** - тізім идентификаторы

client_id - MaviBot клиент идентификаторы. Егер көрсетілмесе, ағымдағы клиенттің идентификаторы қолданылады.

Тізімдерді жою

remove_list_from_project(list_id, clear_list)

Сипаттама
!** list_id** - міндетті параметр; жойылатын тізімнің идентификаторы.

clear_list — қосымша параметр; екі мәнді қабылдайды: True немесе False (әдепкі бойынша False).

Егер сіз бұл параметрді бермесеңіз және тізімде клиенттер болса, келесі жауапты аласыз:
"Тізімді жою мүмкін емес, тізім бос емес"

Егер тізім бос болса, ол еш қиындықсыз жойылады. Алайда, егер сіз clear_list мәнін True етіп орнатсаңыз, тізімде клиенттер болса да, жойылады.

Тегтерді жою

remove_label_from_project(list_id, clear_list)

Сипаттама
!** list_id** - міндетті параметр; жойылатын тегтің идентификаторы.

clear_list - қосымша параметр; екі мәнді қабылдайды: True немесе False (әдепкі бойынша False).

Егер бұл параметр берілмесе және тег клиенттерге тағайындалған болса, келесі жауапты аласыз:
"Тізімді жою мүмкін емес, тізім бос емес"

Егер тег ешбір клиентке тағайындалмаған болса, ол еш қиындықсыз жойылады. Алайда, егер clear_list мәні True етіп орнатылса, тег клиенттерге тағайындалған болса да, жойылады.

Клиенттер тізімін тазалау

clear_list()

Сипаттама

clear_list(list_id) - клиенттер тізімін тазалайды

Параметрлер:

!** list_id -** тізім идентификаторы. Қолданғаннан кейін барлық клиенттер көрсетілген тізімнен жойылады.

Тізімдегі клиенттер санын алу

list_size()

Сипаттама

list_size(list_id) – тізімдегі клиенттердің жалпы санын есептейді

Параметрлер:

!** list_id**- тізім идентификаторы

Бірнеше тізім бойынша бірегей клиент жазбаларының санын есептеу

lists_joint_count()

Сипаттама

lists_joint_count(massive_list) – бірнеше тізім бойынша бірегей клиент жазбаларының жалпы санын есептейді. Функция кіріс ретінде тізім идентификаторларының массивін қабылдайды және санды қайтарады.

Параметрлер:

!** massive_list** - бірегей клиент жазбалары есептелетін тізім идентификаторларын қамтитын массив. Пішімі: ['list_id1', 'list_id2', ..., 'list_idN']

Көшіруге арналған код мысалы

/*Тізім құру*/
list_id = create_list('Жаңа тізім')

/*Клиенттің тізімде бар-жоғын тексеру*/
k=inlist(list_id, client_id)

/*Тізім өлшемін алу — тізімдегі клиенттердің жалпы саны*/
razm=list_size(1)

/*Бірнеше тізім бойынша бірегей клиент жазбаларының жалпы санын алу*/
k=lists_joint_count('[144636,144634]')

Клиенттің тізімде бар-жоғын тексеру

inlist()

Сипаттама

inlist(list_id,client_id) - клиенттің тізімде бар-жоғын тексереді. Нәтиже - логикалық мән (True немесе False).

Параметрлер:

!** list_id** - тізім идентификаторы

client_id - MaviBot клиент идентификаторы. Егер көрсетілмесе, ағымдағы клиенттің идентификаторы қолданылады.

Чат қатысушысының белгілі бір тізімде бар-жоғын тексеру

some_client_in_list()

Сипаттама

some_client_in_list(list_id, recepient)

Параметрлер:

!** list_id** - тізім идентификаторы;

!** recepient** - тексерілетін мессенджер пайдаланушысының идентификаторы (platform_id). Чаттар үшін айнымалының мәні chat_member_id.

Қайтаратын мәндер:

True - клиент тізімде;

False - клиент көрсетілген тізімде жоқ.

Мысал

Көшіруге арналған код мысалы

/*Чат қатысушысының тізімде бар-жоғын тексеру мысалы, мұнда бірінші параметр - тізім идентификаторы, ал екіншісі - пайдаланушының чат идентификаторы*/

r = some_client_in_list(123456, chat_member_id)

Тізімнен элементтерді алу

count_occurrences()

Сипаттама

count_occurrences(array, element) - тізімдегі көрсетілген элементтердің санын қайтарады.

Параметрлер:

array - міндетті параметр; элементтер тізімі

element - міндетті параметр; саналатын элемент

Тізімнен кездейсоқ клиент идентификаторын алу

random_list_member(list_id)

Сипаттама

random_list_member(list_id) - көрсетілген тізімдегі бір кездейсоқ клиент идентификаторын қайтарады.

list_id - міндетті параметр, тізім идентификаторы.

Клиенттеріңізді қамтитын тізім идентификаторын "Тізімдер" бөлімінен табуға болады:

Калькуляторда тізімдермен жұмыс істеу мысалы

Тізімдермен жұмыс істеу үшін "Калькулятор" функцияларын қолдану мысалын қарастырайық.

Маңызды! Кейінірек пайдалану үшін жаңа тізім идентификаторын сақтау қажет. Ол үшін функция нәтижесін айнымалыға тағайындаңыз, яғни list_id = ...

Енді сіз тізіммен басқа амалдарды оңай орындай аласыз — клиенттің тізімде бар-жоғын тексеру, клиентті қосу, жылжыту немесе жою.

Мысалы, клиенттің 12333 идентификаторы бар тізімде бар-жоғын тексерейік:

Статистикалық деректерді көрсету кезінде тізімдерді пайдалану өте ыңғайлы:

Көбінесе тізімдер жиынтығы бойынша бірегей жазбалардың жалпы санын алу қажет — мұны lists_joint_count() функциясы арқылы оңай жасауға болады.

а

Барлық клиент тізімдерінің идентификаторларын алу

get_all_client_label_ids(client_id)

Сипаттама

get_all_client_list_ids(client_id) — клиент тиесілі барлық тізімдердің идентификаторларын қамтитын массивті қайтарады.

Егер клиент ешбір тізімге тиесілі болмаса, функция бос массивті қайтарады: [].

Параметрлер:

  • client_id — Mavibot клиент идентификаторы. Егер көрсетілмесе, ағымдағы клиенттің идентификаторы қолданылады.