.\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#) termcap. 3 8.2 (Berkeley) 12/11/93 .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/termcap. 3, v 1.2 2001/05/14 01:08:40 horikawa Exp $ .Dd December 11, 1993 .Dt TERMCAP 3 .Os BSD 4 .Sh 명칭 .Nm tgetent , .Nm tgetnum , .Nm tgetflag , .Nm tgetstr , .Nm tgoto , .Nm tputs , .Nm tparm , .Nm __set_ospeed .Nd 터미널과는 독립한 조작 함수 .Sh 서식 .Fd #include .Vt char PC; .Vt char *BC; .Vt char *UP; .Vt short ospeed; .Ft int .Fn tgetent "char *bp" "const char *name" .Ft int .Fn tgetnum "const char *id" .Ft int .Fn tgetflag "const char *id" .Ft char * .Fn tgetstr "const char *id" "char **area" .Ft char * .Fn tgoto "const char *cm" "int destcol" "int destline" .Ft int .Fn tputs "const char *cp" "int affcnt" "int (*outc)(int)" .Ft char * .Fn tparm "const char *cp" "..." .Ft void .Fn __set_ospeed "unsigned int speed" .Sh 해설 이러한 함수는, 단말 기능 데이타베이스, 보통은 .Pa /usr/share/misc/termcap (으)로부터 기능을 추출해 사용해, 그 형식은 .Xr termcap 5 에 설명되어 있습니다. 이것들은 저레벨의 routine입니다. 보다 고레벨의 패키지에 대해서는, .Xr curses 3 (을)를 참조해 주세요. .Pp .Fn tgetent 함수는, 단말명의 입력을 .Fa bp 의 버퍼에 추출합니다. 인수 .Fa bp (은)는 사이즈 1024 의 캐릭터 버퍼가 아니면 안되어, 또 거기에 계속되어 함수 .Fn tgetnum , .Fn tgetflag , .Fn tgetstr 등의 호출을 해도 보관 유지됩니다. .Fn tgetent 함수는, 데이타베이스 파일 .Nm termcap 하지만 어느 것도 열지 않는 경우는 \-1 을 돌려주어, 준 단말명이 입력되어 있지 않은 경우는 0 을 돌려주어, 모든 것이 잘 처리되었을 경우는 1 을 돌려줍니다. 이 함수는 환경속에서 .Ev TERMCAP 변수를 찾습니다. 그것이 발견되어, 그 값이 slash로 시작되지 않고, 또 단말 타입 .Fa name 하지만 환경 string .Ev TERM (와)과 같은 경우는, .Nm termcap 파일을 읽지 않고 .Ev TERMCAP string를 사용합니다. slash로 시작되어 있는 경우는, 검색한다 .Nm termcap 파일의 패스명으로서 그 string를 사용합니다. .Ev TERMCAP 하지만 slash로 시작되어 , 한편 .Fa name 하지만 .Ev TERM (와)과 다른 경우는, 환경 변수 .Ev TERMPATH 하지만 존재하지 않으면 .Fn tgetent 함수는 파일 .Pa $HOME/.termcap 및 .Pa /usr/share/misc/termcap (을)를 이 차례로 찾습니다. .Ev TERMPATH 하지만 존재하면, 그것이 검색하는 파일의(공백 또는 코론으로 단락지어진) 패스명 리스트를 지정합니다. 복수의 파일을 찾는 경우로 요구된 엔트리에 .Sy tc 필드가 있는 경우는, 그것이 지명하는 엔트리를 같은 파일 또는 거기에 계속되는 파일안에 찾지 않으면 되지 않습니다. 이것에 의해, .Fn tgetent 함수를 호출하는 프로그램에의 입력의 스피드를 올릴 수가 있는 것과 동시에, 새로운 단말 기술의 디버그나 .Pa /usr/share/misc/termcap 파일을 쓸 수 없는 경우에 자신의 단말의 단말 설명을 만드는 것이 간단하게 됩니다. .Pp .Fn tgetnum 함수는, 기능 .Fa id 의 수치를 거두어 들여, 그것이 단말에 대해서 주어지지 않은 경우는 \-1 을 돌려줍니다. .Fn tgetflag 함수는, 지정된 기능이 단말의 엔트리에 존재하는 경우에는 1 을 돌려주어, 존재하지 않는 경우에는 0 을 돌려줍니다. .Fn tgetstr 함수는, 기능 .Fa id 의 string치를 돌려주어, 그것을 .Fa area 의 버퍼에 넣어 .Fa area 포인터를 진행시킵니다. 이 함수는, 커서의 주소 및 팟딘그 정보를 제외해, .Xr termcap 5 에 기술된 이 필드의 약칭을 디코드합니다. .Fn tgetstr 함수는, 그 기능이 발견되지 않는 경우는 .Dv NULL (을)를 돌려줍니다. .Pp .Fn tgoto 함수는, .Fa destline 행의 .Fa cm (으)로부터 go to 컬럼까지로 디코드된 커서 주소 string를 돌려줍니다. 이 함수는, 돌려주는 string에 .Sy \en , .Sy ^D 또는 .Sy ^@ (을)를 넣는 것을 피하기 위해서(때문에) 필요한 경우에는 외부 변수 .Va UP ( .Sy up 기능으로부터 ) 및 .Va BC ( .Sy bs (은)는 아니고 .Sy bc 하지만 주어지고 있는 경우 )를 사용합니다. ( .Fn tgoto 함수를 호출하는 프로그램은, .Fn tgoto 함수가 탭을 출력할 가능성이 있으므로, 반드시 .Dv XTABS 비트를 오프로 해 두지 않으면 안됩니다. 어쨌든, termcap 를 사용하고 있는 프로그램은, 단말에 따라서는 control-I 를 다른 기능, 예를 들면 파괴 불능 스페이스에 사용하고 있으므로, 일반적으로 .Dv XTABS (을)를 오프로 한다 필요가 있는 것에 주의해 주세요 ) . 이해할 수 없다 .Sy % 순차 순서가 주어지고 있는 경우는, .Fn tgoto 함수는 .Pq Dv OOPS (을)를 돌려줍니다. .Pp .Fn tputs 함수는, .Fa cp string의 선두의 팟딘그 정보를 디코드합니다. .Fa affcnt (은)는, 이 조작에 의해 영향을 받는 행수를 주어 이것에 해당하지 않는다 경우는 행수는 1 이 되어, .Fa outc (은)는 각 캐릭터와 함께 순서에 불려 가는 routine입니다. 외부 변수 .Va PC 에는, 패드 캐릭터가 null .Pq Sy ^@ 그럼 부적당한 경우에는, ( .Sy pc 기능으로부터 ) 사용해야 할 패드 캐릭터가 들어가 있지 않으면 안됩니다. 외부 변수 .Va ospeed 에는, .Xr stty 3 에 의해 encode 된 단말의 출력 속도가 들어가 있지 않으면 안됩니다. .Fn __set_ospeed 함수는, cps 로 나타낸 속도 .Fa speed (을)를 가장 가깝다 .Xr stty 3 코드화 된 속도로 변환해, 그 결과를 .Va ospeed 에 보존합니다. .Pp .Fn tparm 함수는, string .Fa cp (이)가 주어진 파라미터에 의해 인스턴스로 변환합니다. .Fa cp 에 그 파라미터가 적용된 결과를 가리키는 포인터 하지만 돌려주어집니다. 이해할 수 없다 .Sy % 순차 순서가 주어졌을 경우는, .Fn tparm 함수는 .Pq Dv OOPS (을)를 돌려줍니다. .Sh 파일 .Bl -tag -width /usr/share/misc/termcap -compact .It /usr/lib/libtermcap.a .Fl l Ar ltermcap 프로그램 라이브러리 ( .Fl l Ar ltermlib (이)라고도 불립니다 ) .It /usr/share/misc/termcap 표준 단말 기능 데이타베이스 .It $HOME/.termcap 유저의 단말 기능 데이타베이스 .El .Sh 참조 .Xr ex 1 , .Xr curses 3 , .Xr termcap 5 .Sh 역사 .Fn tgetent 함수는, .Bx 4.0 에 나타났습니다.