Trabalhando com listas

Criar uma nova lista

create_list()

Descrição

Insira a função no campo "Calculadora" nas configurações do bloco:

create_list(name) - cria uma nova lista. O resultado é o ID da lista.

Parâmetros:

! name - nome da lista. O nome é especificado entre aspas simples.

Exemplo

list_id = create_list("registered")

Criar uma lista a partir do bloco sem duplicatas

create_list_if_not_exist()

Descrição

create_list_if_not_exist('list_name') - cria uma nova lista se uma com o nome fornecido ainda não existir e retorna seu identificador, ou retorna o identificador da lista existente.

Parâmetro obrigatório:

list_name - nome para a nova lista a ser criada.

Exemplo

new_list = create_list_if_not_exist('List of participants')

Adicionar um cliente à lista

add_to_list()

Descrição

add_to_list(list_id, client_id) - adiciona um cliente a uma lista. A função não retorna nada.

Parâmetros:

! list_id - ID da lista

client_id - ID do cliente MaviBot. Se não for fornecido, o ID do cliente atual é usado.

Mover um cliente para a lista

move_to_list()

Descrição

move_to_list(list_id, client_id) - move um cliente para a lista (Importante! O cliente é removido de todas as outras listas e movido para a especificada). O resultado é um valor booleano (True ou False).

Parâmetros:

! list_id - ID da lista

client_id - ID do cliente MaviBot. Se não for fornecido, o ID do cliente atual é usado.

Remover um cliente da lista

remove_from_list()

Descrição

remove_from_list(list_id, client_id) - remove um cliente com o client_id especificado da lista.

Parâmetros:

! list_id - ID da lista

client_id - ID do cliente MaviBot. Se não for fornecido, o ID do cliente atual é usado.

Excluir listas

remove_list_from_project(list_id, clear_list)

Descrição
! list_id - parâmetro obrigatório; o ID da lista a ser excluída.

clear_list — parâmetro opcional; aceita dois valores: True ou False (padrão é False).

Se você não fornecer este parâmetro e a lista contiver clientes, receberá a seguinte resposta:
"Can't delete list, list not empty"

Se a lista estiver vazia, ela será excluída sem problemas. No entanto, se você definir clear_list como True, a lista será excluída independentemente de conter clientes ou não.

Excluir tags

remove_label_from_project(list_id, clear_list)

Descrição
! list_id - parâmetro obrigatório; o ID da tag a ser excluída.

clear_list - parâmetro opcional; aceita dois valores: True ou False (padrão é False).

Se este parâmetro não for fornecido e a tag estiver atribuída a clientes, você receberá a seguinte resposta:
"Can't delete list, list not empty"

Se a tag não estiver atribuída a nenhum cliente, ela será excluída sem problemas. No entanto, se clear_list for definido como True, a tag será excluída independentemente de estar atribuída a clientes ou não.

Limpar a lista de clientes

clear_list()

Descrição

clear_list(list_id) - limpa a lista de clientes

Parâmetros:

! list_id - ID da lista. Após o uso, todos os clientes serão removidos da lista especificada.

Obter o número de clientes na lista

list_size()

Descrição

list_size(list_id) – conta o número total de clientes na lista

Parâmetros:

! list_id- ID da lista

Contar o número de entradas únicas de clientes em várias listas

lists_joint_count()

Descrição

lists_joint_count(massive_list) – conta o número total de entradas únicas de clientes em várias listas. A função recebe um array de IDs de lista como entrada e retorna um número.

Parâmetros:

! massive_list - um array contendo os IDs das listas nas quais as entradas únicas de clientes serão contadas. O formato é: ['list_id1', 'list_id2', ..., 'list_idN']

Exemplo de código para copiar

/*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]')

Verificar se um cliente está na lista

inlist()

Descrição

inlist(list_id,client_id) - verifica se um cliente está na lista. O resultado é um valor booleano (True ou False).

Parâmetros:

! list_id - ID da lista

client_id - ID do cliente MaviBot. Se não for fornecido, o ID do cliente atual é usado.

Verificar se um participante do chat está em uma lista específica

some_client_in_list()

Descrição

some_client_in_list(list_id, recepient)

Parâmetros:

! list_id - ID da lista;

! recepient - ID do usuário do messenger que está sendo verificado (platform_id). Para chats, o valor da variável é chat_member_id.

Retorna valores:

True - o cliente está na lista;

False - o cliente não está na lista especificada.

Exemplo

Exemplo de código para copiar

/*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)

Recuperar elementos de uma lista

count_occurrences()

Descrição

count_occurrences(array, element) - retorna o número de elementos especificados contidos na lista.

Parâmetros:

array - parâmetro obrigatório; lista de elementos

element - parâmetro obrigatório; elemento a ser contado

Obter um ID de cliente aleatório da lista

random_list_member(list_id)

Descrição

random_list_member(list_id) - retorna um ID de cliente aleatório na lista especificada.

list_id - parâmetro obrigatório, ID da lista.

O ID da lista, que contém seus clientes, pode ser encontrado na seção "Listas":

Exemplo de trabalho com listas na Calculadora

Vamos ver um exemplo de uso de funções na "Calculadora" para trabalhar com listas.

Importante! Você precisa salvar o ID da nova lista para usá-lo posteriormente. Para fazer isso, atribua o resultado da função a uma variável, ou seja, list_id = ...

Agora você pode realizar facilmente outras operações com a lista — verificar se um cliente está na lista, adicionar, mover ou remover um cliente.

Por exemplo, vamos verificar se um cliente está na lista com ID 12333:

É muito conveniente usar listas ao exibir dados estatísticos:

Muitas vezes é necessário obter o número total de entradas únicas em um conjunto de listas — isso pode ser feito facilmente usando a função lists_joint_count().

а

Obter todos os IDs de lista de um cliente

get_all_client_label_ids(client_id)

Descrição

get_all_client_list_ids(client_id) — retorna um array contendo os IDs de todas as listas às quais o cliente pertence.

Se o cliente não pertencer a nenhuma lista, a função retorna um array vazio: [].

Parâmetros:

• client_id — o ID do cliente Mavibot. Se omitido, o ID do cliente atual é usado.