Listelerle çalışma

Yeni bir liste oluştur

create_list()

Açıklama

İşlevi bloğun "Hesaplayıcı" ayarlarındaki alana girin:

create_list(name) - yeni bir liste oluşturur. Sonuç liste ID’sidir.

Parametreler:

! name - liste adı. Ad tek tırnak içinde belirtilir.

Örnek

Tekrarlarsız bloktan liste oluşturma

create_list_if_not_exist()

Açıklama

create_list_if_not_exist('list_name') - verilen ada sahip bir liste henüz yoksa yeni bir liste oluşturur ve tanımlayıcısını döndürür; ya da mevcut listenin tanımlayıcısını döndürür.

Gerekli parametre:

list_name - oluşturulacak yeni listenin adı.

Örnek

Bir istemciyi listeye ekleme

add_to_list()

Açıklama

add_to_list(list_id, client_id) - bir istemciyi listeye ekler. İşlev hiçbir şey döndürmez.

Parametreler:

! list_id - liste ID’si

client_id - MaviBot istemci ID’si. Sağlanmazsa, mevcut istemcinin ID’si kullanılır.

Bir istemciyi listeye taşıma

move_to_list()

Açıklama

move_to_list(list_id, client_id) - bir istemciyi listeye taşır (Önemli! İstemci diğer tüm listelerden kaldırılır ve belirtilen listeye taşınır). Sonuç bir boole değeridir (True veya False).

Parametreler:

! list_id - liste ID’si

client_id - MaviBot istemci ID’si. Sağlanmazsa, mevcut istemcinin ID’si kullanılır.

Bir istemciyi listeden kaldırma

remove_from_list()

Açıklama

remove_from_list(list_id, client_id) - belirtilen client_id’ye sahip bir istemciyi listeden kaldırır.

Parametreler:

! list_id - liste ID’si

client_id - MaviBot istemci ID’si. Sağlanmazsa, mevcut istemcinin ID’si kullanılır.

Listeleri silme

remove_list_from_project(list_id, clear_list)

Açıklama

! list_id - gerekli parametre; silinecek listenin ID’si.

clear_list — isteğe bağlı parametre; iki değer alır: True veya False (varsayılan False’tur).

Bu parametreyi sağlamazsanız ve listede istemciler varsa, aşağıdaki yanıtı alırsınız: "Liste silinemiyor, liste boş değil"

Liste boşsa, sorunsuz şekilde silinir. Ancak clear_list değerini True olarak ayarlarsanız, liste istemci içerip içermemesine bakılmaksızın silinir.

Etiketleri silme

remove_label_from_project(list_id, clear_list)

Açıklama

! list_id - gerekli parametre; silinecek etiketin ID’si.

clear_list - isteğe bağlı parametre; iki değer alır: True veya False (varsayılan False’tur).

Bu parametre sağlanmazsa ve etiket istemcilere atanmışsa, aşağıdaki yanıtı alırsınız: "Liste silinemiyor, liste boş değil"

Etiket herhangi bir istemciye atanmadıysa, sorunsuz şekilde silinir. Ancak clear_list True olarak ayarlanırsa, etiket istemcilere atanmış olup olmamasına bakılmaksızın silinir.

İstemci listesini temizleme

clear_list()

Açıklama

clear_list(list_id) - istemci listesini temizler

Parametreler:

! list_id - liste ID’si. Kullanımdan sonra belirtilen listedeki tüm istemciler kaldırılır.

Listedeki istemci sayısını alma

list_size()

Açıklama

list_size(list_id) – listedeki toplam istemci sayısını sayar

Parametreler:

! list_id- liste ID’si

Birden fazla listedeki benzersiz istemci girişlerinin sayısını sayma

lists_joint_count()

Açıklama

lists_joint_count(massive_list) – birden fazla listedeki benzersiz istemci girişlerinin toplam sayısını sayar. İşlev giriş olarak bir liste ID dizisi alır ve bir sayı döndürür.

Parametreler:

! massive_list - benzersiz istemci girişlerinin sayılacağı liste ID’lerini içeren bir dizi. Biçim şöyledir: ['list_id1', 'list_id2', ..., 'list_idN']

Kopyalama için kod örneği

Bir istemcinin listede olup olmadığını kontrol etme

inlist()

Açıklama

inlist(list_id,client_id) - bir istemcinin listede olup olmadığını kontrol eder. Sonuç bir boole değeridir (True veya False).

Parametreler:

! list_id - liste ID’si

client_id - MaviBot istemci ID’si. Sağlanmazsa, mevcut istemcinin ID’si kullanılır.

Bir sohbet katılımcısının belirli bir listede olup olmadığını kontrol etme

some_client_in_list()

Açıklama

some_client_in_list(list_id, recepient)

Parametreler:

! list_id - liste ID’si;

! recepient - kontrol edilen mesajlaşma uygulaması kullanıcı ID’si (platform_id). Sohbetler için değişkenin değeri chat_member_id’dir.

Şu değerleri döndürür:

True - istemci listede;

False - istemci belirtilen listede değil.

Örnek

Kopyalama için kod örneği

Bir listeden öğeleri alma

count_occurrences()

Açıklama

count_occurrences(array, element) - listede bulunan belirtilen öğelerin sayısını döndürür.

Parametreler:

dizi - gerekli parametre; öğe listesi

element - gerekli parametre; sayılacak öğe

Listeden rastgele bir istemci ID’si alma

random_list_member(list_id)

Açıklama

random_list_member(list_id) - belirtilen listedeki rastgele bir istemci ID’sini döndürür.

list_id - gerekli parametre, liste ID’si.

İstemcilerinizi içeren liste ID’si, "Lists" bölümünde bulmanız gerekir:

Hesaplayıcıda listelerle çalışma örneği

örnek

İşlevlerin kullanıldığı bir örneğe bakalım "Hesaplayıcı" listelerle çalışmak için.

Önemli! Daha sonra kullanmak üzere yeni bir liste ID’sini kaydetmeniz gerekir. Bunu yapmak için, işlev sonucunu bir değişkene atayın; yani list_id = ...

Artık listeyle başka işlemleri kolayca yapabilirsiniz — bir istemcinin listede olup olmadığını kontrol edin, bir istemci ekleyin, taşıyın veya kaldırın.

Örneğin, 12333 ID’li bir istemcinin listede olup olmadığını kontrol edelim:

İstatistiksel verileri görüntülerken listeleri kullanmak çok uygundur:

Çoğu zaman bir grup listedeki benzersiz girişlerin toplam sayısını almak gerekir — bu işlem kolayca şu kullanılarak yapılabilir lists_joint_count() işlevini kullanın.

a