NAZWA¶
tput - inicjalizuj terminal lub pytaj bazę terminfo
SKŁADNIA¶
tput [
-Ttyp]
nazwawłaściwości
[
parm ... ]
tput [
-Ttyp]
init
tput [
-Ttyp]
reset
tput [
-Ttyp]
longname
tput -S <<
OPIS¶
Uwaga! To tłumaczenie może być nieaktualne!
Narzędzie
tput robi użytek z bazy
terminfo,
dając możlwiość dojścia do zależnych
od terminala właściwości z poziomu powłoki (zobacz
sh(1)), a także inicjalizowania lub resetowania terminala, lub
zwracania długiej nazwy żądanego typu terminala.
Jeśli atrybut (
nazwawłaściwości) jest typu
łańcuchowego,
tput wydaje wartość
łańcuchową, a jeśli jest typu całkowitego,
wydaje liczbę całkowitą. Jeśli atrybut jest
wartością logiczną,
tput po prostu ustawia kod
wyjścia (
0 to prawda, jeśli terminal ma daną
właściwość, a
1 to fałsz,
jeśli terminal żądanej właściwości
nie posiada) i nie wydaje żadnego wyjścia tekstowego.
Przed użyciem zwróconej wartości, użytkownik
powinien przetestować kod wyjscia i upewnić się,
że wynosi on
0. (Zobacz sekcje
KODY WYJŚCIA i
DIAGNOSTYKA.) Dla kompletnej listy właściwości i
nazwwłaściwości związanych z
każdą z nich, zobacz
terminfo(5).
- -Ttyp
- określa typ terminala. Normalnie opcja ta jest niepotrzebna,
gdyż wartość domyślna jest pobierana ze
zmiennej środowiskowej TERM. Jeśli podane jest
-T, zmienne powłoki LINES i COLUMNS
będą ignorowane, a system operacyjny nie będzie
zapytywany o rzeczywisty rozmiar ekranu.
- nazwawłaściwości
- określa atrybut z bazy terminfo. Gdy wkompilowana jest
obsługa termcap, można podawać
również termcapowe nazwy atrybutów.
- parm
- Jeśli atrybut jest łańcuchem, który wymaga
parametrów, argumenty param zostaną przeniesione do
tego łańcucha. Wszystkie argumenty numeryczne zostaną
atrybutowi przekazane jako liczby.
- -S
- umożliwiwa używanie więcej niż jednej
właściwości na jedno wywołanie tput.
Właściwości muszą być przekazywane do
tput ze standardowego wejścia, a nie przez linię
poleceń (zobacz przykład). Na linię dozwolona jest
tylko jedna nazwawłaściwości. Opcja -S
zmienia znaczenie kodów wyjścia 0 i 1 (zobacz
sekcję KODY WYJŚCIA).
- init
- Jeśli baza terminfo istnieje i znajduje się w niej
opis dla terminala użytkownika (zobacz wyżej
-Ttyp), to stanie sie co następuje: (1) jeśli
istnieją łańcuchy inicjalizacyjne, to zostaną
one wysłane ( is1, is2, is3, if,
iprog), (2) wszelkie opóźnienia (np. nowej linii),
podane w opisie zostaną ustawione w sterowniku tty, (3)
rozszerzanie tabulacji zostanie włączone lub
wyłączone, zależnie od specyfikacji w opisie i (4)
jeśli tabulacje nie są rozszerzane, ustawione zostaną
standardowe tabulacje (co 8 spacji). Jeśli opis nie zawiera
informacji wymaganej dla któregoś z tych czterech
działań, to zostanie ono cicho pominięte.
- reset
- Zamiast wystawiania łańcuchów inicjalizacji,
wysłane zostaną (o ile są obecne)
łańcuchy resetowania ( rs1, rs2, rs3,
rf). Jeśli łańcuchy resetowania nie są
zdefiniowane, lecz zdefiniowane są łańcuchy
inicjalizacji, to wysłane zostaną łańcuchy
inicjalizacji. W przeciwnym wypadku, reset działa
analogicznie do init.
- longname
- Jeśli obecna jest baza terminfo i istnieje w niej opis dla
terminala użytkownika (zobacz wyżej -Ttyp), to
wyświetlona zostanie długa nazwa terminala. Długa
nazwa jest ostatnią nazwą w pierwszej linii opisu terminala
w bazie terminfo [zobacz term(5)].
PRZYKŁADY¶
- tput init
- Inicjalizuj terminal według typu terminala ze zmiennej
środowiskowej TERM. Komenda ta powinna być
załączona do .profile każdego użytkownika po
wyeksportowaniu zmiennej środowiskowej TERM, jak pokazano w
podręczniku profile(4).
- tput -T5620 reset
- Resetuj terminal AT&T 5620, przeciążając rodzaj
terminala ze zmiennej środowiskowej TERM.
- tput cup 0 0
- Wyślij sekwencję do przesunięcia kursora do wiersza
0, kolumny 0 (lewy górny narożnik ekranu,
znany zwykle jako "domowa" (home) pozycja kursora).
- tput clear
- Wyślij na bieżący terminal sekwencję
czyszczącą ekran.
- tput cols
- Wydrukuj liczbę kolumn w bieżącym terminalu.
- tput -T450 cols
- Wydrukuj liczbę kolumn terminala 450.
- bold=`tput smso` offbold=`tput rmso`
- Ustaw zmienne powłoki bold na początek sekwencji
trybu standout i offbold na koniec sekwencji trybu standout
bieżącego terminala. Może to być użyte
w znaku zachęty: echo "${bold}Proszę wpisać
imię: ${offbold}\c"
- tput hc
- Ustaw kod wyjścia, określający czy terminal jest
terminalem hard copy.
- tput cup 23 4
- Wyślij sekwencję przesuwającą kursor do
wiersza 23 w 4 kolumnie.
- tput longname
- Wydrukuj długą nazwę terminala TERM,
określoną w bazie terminfo.
- tput -S <<!
-
> clear
> cup 10 10
> bold
> !
- Ten przykład pokazuje przetwarzania przez tput kilku
właściwości w jednym wywołaniu.
Przykład ten czyści ekran, przesuwa kursor do pozycji 10, 10
i włącza tryb wytłuszczenia. Lista jest
kończona znakiem wykrzyknika, znajdującym się w
osobnej linii.
PLIKI¶
- /usr/share/terminfo
- skompilowana baza opisu terminala
- /usr/include/curses.h
- plik nagłówkowy curses(3X)
- /usr/include/term.h
- plik nagłówkowy terminfo
- /usr/share/tabset/*
- ustawienia tab dla niektórych terminali w formacie odpowiednim do
wysyłania na terminal (sekwencje specjalne, ustawiające
marginesy i tabulacje); dla dalszych informacji, zobacz sekcję
"Tabs and Initialization" terminfo(4).
ZOBACZ TAKŻE¶
clear(1),
stty(1),
tabs(5).
profile(5),
terminfo(4) w podręczniku
System
Administrator'
s Reference Manual. Rozdział
10 podręcznika
Programmer'
s Guide.
KODY WYJŚCIA¶
Jeśli
nazwawłaściwości jest typu logicznego,
dla prawdy zwracana jest wartość
0, a dla fałszu
1. Wyjątkiem jest użycie opcji
-S.
Jeśli
nazwawłaściwości jest typu
łańcuchowego, zwracane jest
0, gdy
własciwość jest zdefiniowana dla tego terminala
(wartość
nazwywłaściwości jest
zwracana na standardowe wyjście); zwracane jest
1 jeśli
właściwość
nazwawłaściwości nie jest zdefiniowana dla tego
terminala (na stdout nie jest nic wypisywane).
Jeśli
nazwawłaściwości jest typu logicznego,
lub łańcuchowego i użyto opcji
-S, w wypadku gdy
wszystkie linie były pomyślne zwracane jest
0.
Ponieważ nie można określić, która z linii
się nie powiodła, nie jest zwracana wartość
1. Kody wyjścia
2,
3 i
4 mają
swoją tradycyjną interpretację.
Jeśli
nazwawłaściwości jest typu
całkowitego, zwracane jest zawsze
0. Aby określić
czy własciwość jest zdefiniowana, użytkownik musi
testować wartość standardowego wyjścia.
Wartość
-1 oznacza, że
własciwość nie jest zdefiniowana dla tego terminala.
Wszystkie inne kody wyjścia oznaczają błędy; zobacz
sekcję DIAGNOSTYKA.
DIAGNOSTYKA¶
tput drukuje następujące komunikaty o błędach
i ustawia odpowiednie kody błędów:
kod błędu |
komunikat błędu |
0 |
(nazwawłaściwości jest zmienną
numeryczną, która nie jest |
|
podana w bazie terminfo(5) tego typu terminala, np. |
|
tput -T450 lines i tput -T2621 xmc) |
1 |
nie jest drukowany żaden komunikat błędu, zobacz
sekcję |
|
KODY WYJŚCIA. |
2 |
błąd użycia. |
3 |
nieznany typ terminala, lub brak bazy terminfo. |
4 |
nieznana własciwość
nazwawłaściwości terminfo |
PRZENOŚNOŚĆ¶
Opcje
longname i
-S oraz właściwości
podstawiania parametrów, używane w przykładzie
cup
nie są obsługiwane w BSD curses i w AT&T/USL curses przed
SVr4.
Powyższe tłumaczenie pochodzi z nieistniejącego już
Projektu Tłumaczenia Manuali i
może nie być
aktualne. W razie zauważenia różnic między
powyższym opisem a rzeczywistym zachowaniem opisywanego programu lub
funkcji, prosimy o zapoznanie się z oryginalną
(angielską) wersją strony podręcznika za pomocą
polecenia:
- man --locale=C 1 tput
Prosimy o pomoc w aktualizacji stron man - więcej informacji można
znaleźć pod adresem
http://sourceforge.net/projects/manpages-pl/.