8a72894489
Sync with the original version. Unify some japanese words. Submitted by: kano@na.rim.or.jp
265 lines
6.7 KiB
Groff
265 lines
6.7 KiB
Groff
.\" 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$
|
|
.\"
|
|
.Dd July 25, 1996
|
|
.Dt VIS 3
|
|
.Os
|
|
.Sh ̾¾Î
|
|
.Nm vis
|
|
.Nd ¥¥ã¥é¥¯¥¿¤ò»ë³ÐŪ¤Ë¥³¡¼¥É²½
|
|
.Sh ¥é¥¤¥Ö¥é¥ê
|
|
.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 ¤Ä¤Î·Á¼°¤¬¤¢¤ê¤Þ¤¹¡£¤¹¤Ù¤Æ¤Î·Á¼°¤Ï¡¢
|
|
¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¥¥ã¥é¥¯¥¿
|
|
.Ql \e
|
|
¤ò»È¤Ã¤ÆÆü쥷¡¼¥±¥ó¥¹¤òƳÆþ¤·¤Þ¤¹¡£ËÜÅö¤Î¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¤òɽ¤¹¤Ë¤Ï¡¢
|
|
2 ¤Ä¤Î¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¤ò»È¤¤¤Þ¤¹¡£¼¡¤Î¤è¤¦¤Ê»ë³ÐŪ·Á¼°¤¬¤¢¤ê¤Þ¤¹:
|
|
.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 ¥¹¥¿¥¤¥ë¤Î¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¥·¡¼¥±¥ó¥¹¤ò»È¤Ã¤Æ¡¢É¸½àÈó°õºþ
|
|
¥¥ã¥é¥¯¥¿¤òɽ¤·¤Þ¤¹¡£¼¡¤Ë¼¨¤¹¥·¡¼¥±¥ó¥¹¤ò»È¤Ã¤Æ¡¢»ØÄꤵ¤ì¤Æ¤¤¤ë¥¥ã¥é¥¯¥¿
|
|
¤òɽ¤·¤Þ¤¹¡§
|
|
.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 ¥¨¥ó¥³¡¼¥É¤ò»ÈÍѤ·¤Þ¤¹¡£
|
|
·Á¼°¤Ï
|
|
.Ql %dd
|
|
¤Ç¤¢¤ê¡¢
|
|
.Em d
|
|
¤Ï¡¢16 ¿Ê¿ô¤Î·å¤òɽ¸½¤·¤Þ¤¹¡£
|
|
.It Dv VIS_OCTAL
|
|
3 ·å¤Î 8 ¿ÊË¡¥·¡¼¥±¥ó¥¹¤ò»È¤¤¤Þ¤¹¡£
|
|
.Em d
|
|
¤¬ 8 ¿Ê¿ô»ú¤òɽ¤¹¾ì¹ç¤Ï¡¢·Á¼°¤Ï
|
|
.Ql \eddd
|
|
¤È¤Ê¤ê¤Þ¤¹¡£
|
|
.El
|
|
.Pp
|
|
¤â¤¦°ì¤Ä¤Î¥Õ¥é¥°¡¢
|
|
.Dv VIS_NOSLASH
|
|
¤Ï¡¢¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¤Î½ÅÊ£¤ª¤è¤Ó¥Ç¥Õ¥©¥ë¥È·Á¼° (¤¹¤Ê¤ï¤Á¡¢
|
|
À©¸æ¥¥ã¥é¥¯¥¿¤ò
|
|
.Ql ^C
|
|
¤Ç¡¢¥á¥¿¥¥ã¥é¥¯¥¿¤ò
|
|
.Ql M-C
|
|
¤Çɽ¤¹·Á¼°) ¤ÎÁ°¤Î¥Ð¥Ã¥¯¥¹¥é¥Ã¥·¥å¤òÍÞÀ©¤·¤Þ¤¹¡£¤³¤Î¥Õ¥é¥°¤¬¥»¥Ã¥È
|
|
¤·¤Æ¤¢¤ë¤È¡¢¥³¡¼¥É²½¤Ï¤¢¤¤¤Þ¤¤¤È¤Ê¤êµÕÊÑ´¹ÉÔǽ¤È¤Ê¤ê¤Þ¤¹¡£
|
|
.Sh ´ØÏ¢¹àÌÜ
|
|
.Xr unvis 1 ,
|
|
.Xr unvis 3
|
|
.Rs
|
|
.%A R. Fielding
|
|
.%T Relative Uniform Resource Locators
|
|
.%O RFC1808
|
|
.Re
|
|
.Sh Îò»Ë
|
|
¤³¤ì¤é¤Î´Ø¿ô¤Ï
|
|
.Bx 4.4
|
|
¤Ç¤Ï¤¸¤á¤ÆÅо줷¤Þ¤·¤¿¡£
|