Trabalhando com listas
Criar uma nova lista
create_list()
Insira a função no "Calculadora" campo 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.
list_id = create_list("registered")
Criando uma lista a partir do bloco sem duplicatas
create_list_if_not_exist()
create_list_if_not_exist('list_name') - cria uma nova lista se ainda não existir uma com o nome informado e retorna seu identificador, ou retorna o identificador da lista existente.
Parâmetro obrigatório:
list_name - nome da nova lista a ser criada.
new_list = create_list_if_not_exist('Lista de participantes')Adicionando um cliente à lista
add_to_list()
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 do MaviBot. Se não for fornecido, será usado o ID do cliente atual.
Movendo um cliente para a lista
move_to_list()
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 do MaviBot. Se não for fornecido, será usado o ID do cliente atual.
Removendo um cliente da lista
remove_from_list()
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 do MaviBot. Se não for fornecido, será usado o ID do cliente atual.
Excluindo listas
remove_list_from_project(list_id, clear_list)
! 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 (o padrão é False).
Se você não fornecer esse parâmetro e a lista contiver clientes, você receberá a seguinte resposta: "Não é possível excluir a lista, a lista não está vazia"
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 независимо de conter clientes ou não.
Excluindo tags
remove_label_from_project(list_id, clear_list)
! 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 (o padrão é False).
Se esse parâmetro não for fornecido e a tag estiver atribuída a clientes, você receberá a seguinte resposta: "Não é possível excluir a lista, a lista não está vazia"
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()
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()
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()
lists_joint_count(massive_list) – conta o número total de entradas únicas de clientes em várias listas. A função recebe como entrada um array de IDs de listas 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']
Verifique se um cliente está na lista
inlist()
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 do MaviBot. Se não for fornecido, será usado o ID do cliente atual.
Verifique se um participante do chat está em uma lista específica
some_client_in_list()
some_client_in_list(list_id, recepient)
Parâmetros:
! list_id - ID da lista;
! recepient - ID do usuário do mensageiro que está sendo verificado (platform_id). Para chats, o valor da variável é chat_member_id.
Retorna os valores:
True - o cliente está na lista;
False - o cliente não está na lista especificada.
Recuperando elementos de uma lista
count_occurrences()
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 contar
Obtendo um ID de cliente aleatório da lista
random_list_member(list_id)
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 em "Listas" :
Exemplo de trabalho com listas na Calculadora
exemplo
Vamos ver um exemplo de uso de funções na "Calculadora" para trabalhar com listas.
Importante! Você precisa salvar um novo ID de lista para usá-lo depois. Para isso, atribua o resultado da função a uma variável, ou seja, list_id = ...
Agora você pode facilmente realizar 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 o 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 lists_joint_count() função.
a
Atualizado