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
-T typ), 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/.