SLRN - Super Page
 

Wewnętrzne funkcje slrn 
> Instalacja i konfiguracja > Podręcznik > FAQ > Pozostała dokumentacja
poziom wyżej

Następna Poprzednia Spis treści

3. Funkcje dostępne w trybie grup

Funkcje wbudowane opisane w tym rozdziale dostępne są w trybie grup.

3.1 current_newsgroup

Składnia

String current_newsgroup ()

Opis

Funkcja ta zwraca nazwę bieżącej grupy.

Zobacz również

server_name

3.2 get_group_flags

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

3.3 get_group_order

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

3.4 group_down_n

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

3.5 group_search

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

3.6 group_unread

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

3.7 group_up_n

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

3.8 hide_current_group

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.

3.9 is_group_mode

Składnia

Integer is_group_mode ()

Opis

Funkcja zwraca wartość niezerową, jeśli tryb bieżący jest trybem grup.

Zobacz również

3.10 select_group

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

3.11 set_group_display_format

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.

3.12 set_group_flags

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

3.13 set_group_order

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)


projekt www: loop Piotr Gogolin
[ strona wygenerowana z CVS: 07.06.2002 20:25 ]