Następna
Poprzednia
Spis treści
Funkcje wbudowane opisane w tym rozdziale dostępne są w trybie grup.
- Składnia
String current_newsgroup ()
- Opis
Funkcja ta zwraca nazwę bieżącej grupy.
- Zobacz również
server_name
- Składnia
Integer get_group_flags ()
- Opis
Ta funkcja zwraca flagi skojarzone z bieżącą grupą. Zwracana liczba
całkowita jest polem bitowym, którego składowe są określone następującymi
stałymi:
GROUP_UNSUBSCRIBED : ustawione, jeśli grupa nie jest subskrybowana
GROUP_NEW_GROUP_FLAG : ustawione, jeśli grupa jest nowa
- Zobacz również
get_header_flags, set_group_flags, current_newsgroup
- Składnia
Array_Type get_group_order ()
- Opis
Funkcja ta zwraca tablicę napisów zawierających nazwy wszystkich znanych
grup w bieżącym porządku.
- Uwagi
Funkcja ta dostępna jest tylko wówczas, jeśli slrn był skompilowany z
biblioteką S-Lang w wersji przynajmniej 1.4.x.
- Zobacz również
set_group_order
- Składnia
Integer group_down_n (Integer n)
- Opis
Ta funkcja przemieszcza kursor w dół o n grup i zwraca wartość
rzeczywistego przemieszczenia.
- Zobacz również
group_up_n, group_search, current_newsgroup
- Składnia
Integer group_search (String name)
- Opis
Funkcja szuka grupy zwierającej w nazwie podciąg name. Przeszukuje
również opisy grup. Jeśli szukanie zakończyło się sukcesem zwraca
wartość niezerową, i zero w przeciwnym przypadku.
- Uwagi
Po dojściu do końca listy grup, szukanie rozpoczyna się od początku.
- Zobacz również
select_group, current_newsgroup
- Składnia
Integer group_unread ()
- Opis
Funkcja ta zwraca liczbę nieprzeczytanych artykułów w bieżącej grupie.
- Zobacz również
select_group, current_newsgroup, is_group_mode
- Składnia
Integer group_up_n (Integer n)
- Opis
Funkcja przemieszcza kursor do góry o n grup i zwraca wartość
rzeczywistego przemieszczenia.
- Zobacz również
group_down_n, group_search, current_newsgroup
- Składnia
Void hide_current_group ()
- Opis
Funkcja ukrywa bieżącą grupę w oknie grup. Grupy ukryte można wyświetlić
ponownie wywołując funkcję toggle_hidden.
- Składnia
Integer is_group_mode ()
- Opis
Funkcja zwraca wartość niezerową, jeśli tryb bieżący jest trybem grup.
- Zobacz również
- Składnia
Integer select_group ()
- Opis
Funkcji tej można użyć do wybrania bieżącej grupy. Zwraca 0 w przypadku
sukcesu i -1 w razie niepowodzenia. Wykonanie może się nie powieść, jeśli
w grupie brak artykułów.
- Zobacz również
current_newsgroup
- Składnia
Void set_group_display_format (Int_Type n, String_Type fmt)
- Opis
Funkcja ta może zostać użyta do ustawienia n-tego formatu
wyświetlania na fmt. Użytkownik może przełączać się między
formatamia za pomocą kombinacji klawiszy przypisanej do
toggle_group_formats.
Zasadniczo format jest taki sam, jak podano w opisie
set_header_display_format.
Określone są następujące specyfikatory:
F : Flagi grupy: 'U' = niesubskrybowana, 'N' = nowa,
d : Skrócone opisy grup (należy je pobrać za pomocą "slrn -d"),
g : Przejdź do podanej kolumny,
h : Najwyższy numer artykułu w grupie,
l : Najniższy numer artykułu w grupie,
n : Nazwa grupy,
t : Przybliżona liczba artykułów w grupie,
u : Liczba nieprzeczytanych artykułow w grupie.
- Składnia
Void set_group_flags (Integer flags)
- Opis
Funkcji tej można użyć do ustawienia flag skojarzonych z bieżącą grupą.
- Zobacz również
get_group_flags
- Składnia
Void set_group_order (Array_Type names)
- Opis
Jeśli names zawiera jednowymiarową tablicę napisów (nazw grup),
slrn posortuje listę grup w podanej kolejności. Napisy nie pasujące do
znanych grup zostaną zignorowane; istniejące grupy, których nazwy nie są
zawarte w tablicy names pozostaną w dotychczasowej (względnej)
kolejności, ale zostaną umieszczone na końcu.
- Przykład
Zgodnie z powyższą zasadą, można przemieścić grupę na początek listy
używając jednoelementowej tablicy names:
set_group_order ("news.software.readers");
Przeniesienia grupy na koniec listy można dokonać usuwając jej nazwę z
listy zwróconej przez get_group_order i wywołując
set_group_order z tablicą wynikową jako argumentem.
Przykład prostego sortowania grup opartego na tej funkcji można znaleźć w
pliku 'gsort.sl' zawartym w pakiecie slrn.
- Uwagi
Funkcja ta jest dostępna tylko wówczas, jeśli slrn został skompilowany z
biblioteką S-lang w wersji co najmniej 1.4.x.
- Zobacz również
get_group_order
Następna
Poprzednia
Spis treści
|
|
Funkcje slrn
1. Funkcje obsługujące nagłówki i wątkowanie
2. Funkcje dostępne w trybie artykułów
3. Funkcje dostępne w trybie grup
4. Funkcje dialogowe i informacyjne
5. Interakcja z użytkownikiem
6. Obsługa plików
7. Inne funkcje
8. Funkcje obsługi zdarzeń (Hooks)
|
|