KEYCAP(3)

명칭
kgetent, kgetnum, kgetflag, kgetstr - 키캡 데이타베이스에의 액세스 routine군

서식
int kgetent(char *bp, char *name) int kgetnum(char *id) int kgetflag(char *id) char * kgetstr(char *id, char **area)

해설
이러한 함수는, 키보드케이파비리티데이타베이스, 통상은 /usr/share/misc/keycap.pcvt (으)로부터 케이파비리티를 꺼내 사용합니다. 데이타베이스의 포맷은 keycap(5) 에 설명되고 있습니다.

kgetent() 함수는, bp 의 버퍼에 name 의 키보드 매핑의 엔트리를 전개합니다. 인수 bp (은)는 사이즈가 1024 의 캐릭터 버퍼여야 하는 것으로, kgetnum(), kgetflag(), kgetstr() 에의 그 후의 모든 호출을 통해 보관 유지되지 않으면 안됩니다. kgetent() 함수는, 오픈할 수 있었다 keycap 데이타베이스 파일이 하나도 없으면 -1 을 돌려주어, 소정의 MAP명에 엔트리가 없으면 0 을 돌려주어, 모두가 정상 종료하면 1 을 돌려줍니다.

kgetnum() 함수는 케이파비리티 id 에 대한 수치를 얻습니다. MAP로부터 주어지지 않으면 -1 을 돌려줍니다.

kgetflag() 함수는, 특정의 케이파비리티가 MAP의 엔트리에 존재하면 1 을 되돌려, 존재하지 않으면 0 을 되돌립니다.

kgetstr() 함수는 케이파비리티 id 에 대한 캐릭터 라인을 area 에 의해 나타난 버퍼에 카피해, 그 포인터를 돌려줍니다. 그리고 area 포인터를 그 캐릭터 라인의 뒤까지 진행합니다. kgetstr() 함수는, 케이파비리티가 발견되지 않으면 NULL (을)를 돌려줍니다.

관련 파일
/usr/share/misc/keycap.pcvt
    키보드케이파비리티데이타베이스 (없으면 인스톨시에 선택됩니다)

관련 항목
kcon(1), keycap(5)