Listelerle çalışma
Yeni bir liste oluştur
create_list()
İş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.
list_id = create_list("registered")
Tekrarlarsız bloktan liste oluşturma
create_list_if_not_exist()
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ı.
new_list = create_list_if_not_exist('Katılımcı listesi')Bir istemciyi listeye ekleme
add_to_list()
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()
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()
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)
! 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)
! 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()
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()
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()
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']
Bir istemcinin listede olup olmadığını kontrol etme
inlist()
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()
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.
Bir listeden öğeleri alma
count_occurrences()
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)
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
Last updated