.\" Copyright (c) 1989, 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. .\" .\" From: @(#) vis. 3 8.1 (Berkeley) 6/9/93 .\" %FreeBSD: src/lib/libc/gen/vis. 3, v 1.8. 2.6 2001/12/14 18:33:51 ru Exp % .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/vis. 3, v 1.5 2002/05/18 07:12:57 horikawa Exp $ .\" .Dd July 25, 1996 .Dt VIS 3 .Os .Sh 명칭 .Nm vis .Nd 캐릭터를 시각적으로 코드화 .Sh LIBRARY .Lb libc .Sh 서식 .In vis.h .Ft char * .Fn vis "char *dst" "int c" "int flag" "int nextc" .Ft int .Fn strvis "char *dst" "const char *src" "int flag" .Ft int .Fn strvisx "char *dst" "const char *src" "size_t len" "int flag" .Sh 해설 .Fn vis 함수는, 캐릭터 .Fa c (을)를 나타내는 캐릭터 라인을 .Fa dst 에 카피합니다. .Fa c 하지만 코드화를 필요로 하지 않는 경우는, 아무것도 변경하지 않고 카피합니다. 캐릭터 라인은 null 로 종단 되어 캐릭터 라인의 최후에의 포인터가 돌려주어집니다. 코드화의 길이의 최대치는 4 캐릭터입니다 (마지막 .Dv NUL (은)는 포함하지 않는다). 따라서, 캐릭터세트를 버퍼에 코드화할 때는, 버퍼의 사이즈는 코드화 된다 캐릭터수의 4 배로 마지막에 붙인다 .Dv NUL 의 분의 1 이 필요합니다. 코드화한다 캐릭터의 디폴트 범위를 변경하기 위해(때문에), 또 시각적인 표현을 변경하기 위해서는 플래그 파라미터를 사용합니다. 추가의 캐릭터, .Fa nextc (은)는, 코드화 형식 .Dv VIS_CSTYLE (을)를 선택했을 때에 마셔 사용합니다 (이하에 설명합니다). .Pp .Fn strvis 및 .Fn strvisx 함수는, 캐릭터 라인 .Fa src 의 시각적 표현을 .Fa dst 에 카피합니다. .Fn strvis 함수는, .Fa src (으)로부터 최초의 .Dv NUL 까지의 캐릭터를 코드화합니다. .Fn strvisx 함수는, .Fa src (으)로부터 정확하게 .Fa len 개의 캐릭터를 코드화합니다 (이것은, 복수의 .Dv NUL (을)를 포함할 가능성이 있는 데이터의 블록을 코드화하는 경우에 도움이 됩니다). 어느 쪽의 형식에서도 .Fa dst (을)를 .Dv NUL 그리고 종단 합니다. .Fa dst 의 사이즈는, .Fa src (으)로부터 코드화 되는 캐릭터수의 4 배가 아니면 안됩니다 (플러스 .Dv NUL (을)를 위한 1). 어느 쪽의 형식에서도, 캐릭터수를 .Fa dst 에 돌려줍니다 (마지막 .Dv NUL (은)는 포함하지 않고 ). .Pp 코드화는, 모두 그래픽 캐릭터로 구성된 독특해 역변환 가능한 표현입니다. 즉, .Xr unvis 3 또는 .Xr strunvis 3 함수를 사용하면 원의 형태에 되돌릴 수가 있습니다. .Pp 제어할 수 있는 파라미터는 2 개 있는:코드화하는 캐릭터의 범위, 및 사용하는 표현의 타입입니다. 디폴트에서는, 스페이스, 탭, 개행을 제외한 모든 비그래픽 캐릭터가 코드화 됩니다. ( .Xr isgraph 3 참조) 이것은, 이하의 플래그에 의해 변경됩니다: .Bl -tag -width VIS_WHITEX .It Dv VIS_SP 스페이스도 코드화합니다. .It Dv VIS_TAB 탭도 코드화합니다. .It Dv VIS_NL 개행도 코드화합니다. .It VIS_WHITE .Dv VIS_SP \&| .Dv VIS_TAB \&| .Dv VIS_NL (와)과 동의. .It Dv VIS_SAFE "unsafe" 캐릭터만을 코드화합니다. "unsafe"캐릭터란, 보통 단말에 예기치 않은 기능을 일으키는 것 같은 제어 캐릭터 입니다. 현재로서는, 이 형식에서는 모든 그래픽 캐릭터에 더해, 스페이스, 탭, 개행, 백 스페이스, 벨, 리턴을 코드화하지 않고 일어납니다. .El .Pp 코드화에는 4 개의 형식이 있습니다. 모든 형식은, backslash 캐릭터 .Ql \e (을)를 사용해 특수 순차 순서를 도입합니다. 진짜 backslash를 나타내려면 , 2 개의 backslash를 사용합니다. 다음과 같은 시각 마토가타식이 있습니다: .Bl -tag -width VIS_HTTPSTYLE .It (default) .Ql M (을)를 사용해 메타캐라크타 (8 번째의 비트가 세트 되었다 캐릭터)를 나타내, 캐럿 .Ql ^ (을)를 사용해 제어 캐릭터를 나타냅니다 ( .Xr iscntrl 3 참조). 다음과 같은 형식을 사용합니다： .Bl -tag -width xxxxx .It Dv \e^C 제어 캐릭터 .Ql C (을)를 나타냅니다. .Ql \e000 (으)로부터 .Ql \e037 까지, 및 .Ql \e177 의 캐릭터를 포함합니다 ( .QL \e^? (와)과 같이). .It Dv \eM-C 8 번째의 비트가 세트 된 캐릭터 .Ql C (을)를 나타냅니다. .Ql \e241 (으)로부터 .Ql \e377 까지의 캐릭터를 포함합니다. .It Dv \eM^C 8 번째의 비트가 세트 된 제어 캐릭터 .Ql C (을)를 나타냅니다. .Ql \e200 (으)로부터 .Ql \e237 까지, 및 .QL \e377 의 캐릭터를 포함합니다 ( .Ql \eM^? (와)과 같이). .It Dv \e040 .Tn ASCII 의 스페이스를 나타냅니다. .It Dv \e240 메타스페이스를 나타냅니다. .El .Pp .It Dv VIS_CSTYLE C 스타일의 backslash 순차 순서를 사용해, 표준비인쇄 캐릭터를 나타냅니다. 다음에 나타내는 순차 순서를 사용해, 지정되어 있는 캐릭터 (을)를 나타냅니다： .Bd -unfilled -offset indent .Li \ea Tn - BEL No (007) .Li \eb Tn - BS No (010) .Li \ef Tn - NP No (014) .Li \en Tn - NL No (012) .Li \er Tn - CR No (015) .Li \et Tn - HT No (011) .Li \ev Tn - VT No (013) .Li \e0 Tn - NUL No (000) .Ed .Pp 이 형식을 사용하는 경우는, nextc 파라미터를 봐 .Dv NUL 캐릭터를 .Ql \e000 (은)는 아니고 .Ql \e0 (와)과 코드화하는지 어떤지를 판단합니다. .Fa nextc 하지만 8 진수자인 경우는, 애매함을 피하기 위해서(때문에) .Ql \e000 의 표현을 사용합니다. .It Dv VIS_HTTPSTYLE RFC 1808 에 기술된 URI encode를 사용합니다. 형식은 .Ql %dd (이어)여, .Em d (은)는, 16 진수의 자리수를 표현합니다. .It Dv VIS_OCTAL 3 자리수의 8 진법순차 순서를 사용합니다. .Em d 하지만 8 진수자를 나타내는 경우는, 형식은 .Ql \eddd 됩니다. .El .Pp 하나 더의 플래그, .Dv VIS_NOSLASH (은)는, backslash의 중복 및 디폴트 형식 (즉, 제어 캐릭터를 .Ql ^C 그리고, 메타캐라크타를 .Ql M-C 그리고 나타내는 형식)의 전의 backslash를 억제합니다. 이 플래그가 세트 되어 있으면(자), 코드화는 애매가 되어 역변환 불능이 됩니다. .Sh 관련 항목 .Xr unvis 1 , .Xr unvis 3 .Rs . %A R. Fielding . %T Relative Uniform Resource Locators . %O RFC1808 .Re .Sh 역사 이러한 함수는 .Bx 4.4 그리고 처음 등장했습니다.