OSDN Git Service

(split) LDP: Update draft and release (from the previous commit)
[linuxjm/LDP_man-pages.git] / release / man3 / isalpha.3
index 92bd378..2f96ad3 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
-.\" License.
+.\" %%%LICENSE_END
 .\"
 .\" Modified Sat Jul 24 19:10:00 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified Sun Aug 21 17:51:50 1994 by Rik Faith (faith@cs.unc.edu)
 .\" Modified Sat Sep  2 21:52:01 1995 by Jim Van Zandt <jrv@vanzandt.mv.com>
 .\" Modified Mon May 27 22:55:26 1996 by Martin Schulze (joey@linux.de)
 .\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
 .\" Japanese Version Copyright (c) 1997 Ueyama Rui
 .\"         all rights reserved.
 .\" Translated 1997-08-29, Ueyama Rui <rui@campus.or.jp>
 .\" Updated 2005-02-26, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\" Updated 2007-05-01, Akihiro MOTOKI, LDP v2.46
 .\"
-.TH ISALPHA 3 2010-09-20 "GNU" "Linux Programmer's Manual"
-.SH Ì¾Á°
+.TH ISALPHA 3 2014\-03\-18 GNU "Linux Programmer's Manual"
+.SH 名前
 isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower,
-isprint, ispunct, isspace, isupper, isxdigit \- Ê¸»ú¤òʬÎह¤ë
-.SH ½ñ¼°
+isprint, ispunct, isspace, isupper, isxdigit, isalnum_l, isalpha_l,
+isascii_l, isblank_l, iscntrl_l, isdigit_l, isgraph_l, islower_l, isprint_l,
+ispunct_l, isspace_l, isupper_l, isxdigit_l \- 文字を分類する
+.SH 書式
 .nf
-.B #include <ctype.h>
+\fB#include <ctype.h>\fP
 .sp
-.BI "int isalnum(int " "c" );
-.br
-.BI "int isalpha(int " "c" );
-.br
-.BI "int isascii(int " "c" );
-.br
-.BI "int isblank(int " "c" );
-.br
-.BI "int iscntrl(int " "c" );
-.br
-.BI "int isdigit(int " "c" );
-.br
-.BI "int isgraph(int " "c" );
-.br
-.BI "int islower(int " "c" );
-.br
-.BI "int isprint(int " "c" );
-.br
-.BI "int ispunct(int " "c" );
-.br
-.BI "int isspace(int " "c" );
-.br
-.BI "int isupper(int " "c" );
-.br
-.BI "int isxdigit(int " "c" );
+\fBint isalnum(int \fP\fIc\fP\fB);\fP
+\fBint isalpha(int \fP\fIc\fP\fB);\fP
+\fBint iscntrl(int \fP\fIc\fP\fB);\fP
+\fBint isdigit(int \fP\fIc\fP\fB);\fP
+\fBint isgraph(int \fP\fIc\fP\fB);\fP
+\fBint islower(int \fP\fIc\fP\fB);\fP
+\fBint isprint(int \fP\fIc\fP\fB);\fP
+\fBint ispunct(int \fP\fIc\fP\fB);\fP
+\fBint isspace(int \fP\fIc\fP\fB);\fP
+\fBint isupper(int \fP\fIc\fP\fB);\fP
+\fBint isxdigit(int \fP\fIc\fP\fB);\fP
+
+\fBint isascii(int \fP\fIc\fP\fB);\fP
+\fBint isblank(int \fP\fIc\fP\fB);\fP
+
+\fBint isalnum_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint isalpha_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint isblank_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint iscntrl_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint isdigit_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint isgraph_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint islower_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint isprint_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint ispunct_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint isspace_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint isupper_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+\fBint isxdigit_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
+
+\fBint isascii_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
 .fi
 .sp
 .in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
 .ad l
-.BR isascii ():
+\fBisascii\fP():
 .RS 4
 _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE
 .br
 .RE
-.BR isblank ():
+
+\fBisblank\fP():
 .RS 4
-_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
-_POSIX_C_SOURCE\ >=\ 200112L;
+_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L;
 .br
-or
-.I cc\ -std=c99
+または \fIcc\ \-std=c99\fP
+.RE
+
+\fBisalnum_l\fP(), \fBisalpha_l\fP(), \fBisblank_l\fP(), \fBiscntrl_l\fP(),
+\fBisdigit_l\fP(), \fBisgraph_l\fP(), \fBislower_l\fP(), \fBisprint_l\fP(),
+\fBispunct_l\fP(), \fBisspace_l\fP(), \fBisupper_l\fP(), \fBisxdigit_l\fP():
+.PD 0
+.RS 4
+.TP 
+glibc 2.10 以降:
+_XOPEN_SOURCE\ >=\ 700
+.TP 
+glibc 2.10 より前:
+_GNU_SOURCE
+.RE
+.PD
+
+\fBisascii_l\fP(),
+.PD 0
+.RS 4
+.TP 
+glibc 2.10 以降:
+_XOPEN_SOURCE\ >=\ 700 && (_SVID_SOURCE || _BSD_SOURCE)
+.TP 
+glibc 2.10 より前:
+_GNU_SOURCE
 .RE
+.PD
 .ad
-.SH ÀâÌÀ
-¤³¤ì¤é¤Î´Ø¿ô¤Ï¡¢¸½ºß¤Î¥í¥±¡¼¥ë¤Ë½¾¤Ã¤Æ
-.I c
-¤òʬÎह¤ë¡£
-.I c
-¤Ï
-.I unsigned char
-¤«
-.B EOF
-¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-.TP
-.BR isalnum ()
-±Ñ»ú¤Þ¤¿¤Ï¿ô»ú¤Ç¤¢¤ë¤«¤òÄ´¤Ù¤ë¡£
-.BI "(isalpha(" c ") || isdigit(" c "))" \fR
-¤ÈÅù²Á¤Ç¤¢¤ë¡£
-.TP
-.BR isalpha ()
-¥¢¥ë¥Õ¥¡¥Ù¥Ã¥È¤«¤É¤¦¤«Ä´¤Ù¤ë¡£É¸½à¤Î \fB"C"\fP ¥í¥±¡¼¥ë¤Ç¤Ï
-.BI "(isupper(" c ") || islower(" c "))" \fR
-¤ÈÅù²Á¤Ç¤¢¤ë¡£Â¾¤Î¥í¥±¡¼¥ë¤Ç¤Ï¡¢Âçʸ»ú¤Ç¤â¾®Ê¸»ú¤Ç¤â¤Ê¤¤Â¾¤Îʸ»ú¤Ç¤â
-.BR isalpha ()
-¤¬ true ¤òÊÖ¤¹¤³¤È¤¬¤¢¤ë¡£
-.TP
-.BR isascii ()
-\fIc\fP ¤¬¡¢ASCIIʸ»ú¥»¥Ã¥È¤Ë¹çÃפ¹¤ë 7¥Ó¥Ã¥È¤Î
-.I unsigned char
-¤Ç¤¢¤ë¤«¤òÄ´¤Ù¤ë¡£
-.TP
-.BR isblank ()
-¶õÇòʸ»ú (¥¹¥Ú¡¼¥¹¤«¥¿¥Ö) ¤Ç¤¢¤ë¤«¤òÄ´¤Ù¤ë¡£
-.TP
-.BR iscntrl ()
-À©¸æʸ»ú¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¡£
-.TP
-.BR isdigit ()
-¿ô»ú (0¡Á9) ¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¡£
-.TP
-.BR isgraph ()
-ɽ¼¨²Äǽ¤Êʸ»ú¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¡£¥¹¥Ú¡¼¥¹¤Ï´Þ¤Þ¤ì¤Ê¤¤¡£
-.TP
-.BR islower ()
-¾®Ê¸»ú¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¡£
-.TP
-.BR isprint ()
-ɽ¼¨²Äǽ¤Êʸ»ú¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¡£¥¹¥Ú¡¼¥¹¤â´Þ¤Þ¤ì¤ë¡£
-.TP
-.BR ispunct ()
-ɽ¼¨²Äǽ¤Êʸ»ú¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¡£¥¹¥Ú¡¼¥¹¤È±Ñ¿ô»ú¤Ï´Þ¤Þ¤ì¤Ê¤¤¡£
-.TP
-.BR isspace ()
-¶õÇòʸ»ú¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¡£
-.B """C"""
-¥í¥±¡¼¥ë¤«
-.B """POSIX"""
-¥í¥±¡¼¥ë¤Ç¤Ï¡¢¶õÇòʸ»ú¤È¤Ï¡¢¥¹¥Ú¡¼¥¹¡¢¥Õ¥©¡¼¥à¥Õ¥£¡¼¥É
-.RB ( \(aq\ef\(aq )
-¡¢²þ¹Ô(newline)
-.RB ( \(aq\en\(aq )
-¡¢Éüµ¢(carriage return)
-.RB ( \(aq\er\(aq )
-¡¢¿åÊ¿¥¿¥Ö
-.RB ( \(aq\et\(aq )
-¡¢¿âľ¥¿¥Ö
-.RB ( \(aq\ev\(aq )
-¤Ç¤¢¤ë¡£
-.TP
-.BR isupper ()
-¾®Ê¸»ú¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¡£
-.TP
-.BR isxdigit ()
-16¿Ê¿ô¤Ç¤Î¿ô»ú¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¡£
+.SH 説明
+これらの関数は、指定したロケールに従って \fIc\fP を分類する。 \fIc\fP は \fIunsigned char\fP か \fBEOF\fP でなければならない。
+"_l" が後ろに付かない関数は現在のロケールに基づいてチェックを行う。
+
+"_l" で終わる関数は、ロケールオブジェクト \fIlocale\fP で指定されたロケールに基づいてチェックを行う。 \fIlocale\fP
+が特別なロケールオブジェクト \fBLC_GLOBAL_LOCALE\fP (\fBduplocale\fP(3) 参照) の場合や、 \fIlocale\fP
+が有効なオブジェクトロケールハンドルでない場合、 これらの関数の動作は未定義である。
+
+以下のリストでは、 "_l" が後ろに付かない関数の動作を説明する。 "_l" で終わる関数は、現在のロケールではなく、ロケールオブジェクト
+\fIlocale\fP を使う点だけが異なる。
+.TP 
+\fBisalnum\fP()
+英字または数字であるかを調べる。 \fB(isalpha(\fP\fIc\fP\fB) || isdigit(\fP\fIc\fP\fB))\fP と等価である。
+.TP 
+\fBisalpha\fP()
+アルファベットかどうか調べる。標準の \fB"C"\fP ロケールでは \fB(isupper(\fP\fIc\fP\fB) || islower(\fP\fIc\fP\fB))\fP
+と等価である。他のロケールでは、大文字でも小文字でもない他の文字でも \fBisalpha\fP()  が true を返すことがある。
+.TP 
+\fBisascii\fP()
+\fIc\fP が、ASCII文字セットに合致する 7ビットの \fIunsigned char\fP であるかを調べる。
+.TP 
+\fBisblank\fP()
+空白文字 (スペースかタブ) であるかを調べる。
+.TP 
+\fBiscntrl\fP()
+制御文字かどうかを調べる。
+.TP 
+\fBisdigit\fP()
+数字 (0〜9) かどうかを調べる。
+.TP 
+\fBisgraph\fP()
+表示可能な文字かどうかを調べる。スペースは含まれない。
+.TP 
+\fBislower\fP()
+小文字かどうかを調べる。
+.TP 
+\fBisprint\fP()
+表示可能な文字かどうかを調べる。スペースも含まれる。
+.TP 
+\fBispunct\fP()
+表示可能な文字かどうかを調べる。スペースと英数字は含まれない。
+.TP 
+\fBisspace\fP()
+空白文字かどうかを調べる。 \fB"C"\fP ロケールか \fB"POSIX"\fP ロケールでは、空白文字とは、スペース、フォームフィード
+(\fB\(aq\ef\(aq\fP)  、改行(newline)  (\fB\(aq\en\(aq\fP)  、復帰(carriage return)
+(\fB\(aq\er\(aq\fP)  、水平タブ (\fB\(aq\et\(aq\fP)  、垂直タブ (\fB\(aq\ev\(aq\fP)  である。
+.TP 
+\fBisupper\fP()
+大文字かどうかを調べる。
+.TP 
+\fBisxdigit\fP()
+16進数での数字かどうかを調べる。
 .br
-.B "0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F"
-¤Îʸ»ú¤Ç¤¢¤ë¤«¤É¤¦¤«¤òÄ´¤Ù¤ë¤³¤È¤ÈÅù²Á¤Ç¤¢¤ë¡£
-.SH ÊÖ¤êÃÍ
-ʸ»ú
-.I c
-¤¬Ä´¤Ù¤¿Ê¸»ú¤Î¼ïÎà¤Ë¹ç¤Ã¤Æ¤¤¤ì¤Ð 0 °Ê³°¤òÊÖ¤¹¡£
-¤½¤¦¤Ç¤Ê¤±¤ì¤Ð 0 ¤òÊÖ¤¹¡£
-.SH ½àµò
-C99, 4.3BSD.
-C89 ¤Ç¤Ï¡¢¤³¤ì¤é¤Î´Ø¿ô¤Î¤¦¤Á
-.BR isascii ()
-¤È
-.BR isblank ()
-°Ê³°¤Î
-¤¹¤Ù¤Æ¤¬µ¬Äꤵ¤ì¤Æ¤¤¤ë¡£
-.BR isascii ()
-¤Ï BSD ¤ä SVr4 ¤Î³ÈÄ¥¤Ç¤¢¤ë¡£
-.BR isblank ()
-¤Ï POSIX.1-2001 ¤È C99 7.4.1.3 ¤Ë½àµò¤·¤Æ¤¤¤ë¡£
-POSIX.1-2008 ¤Ï¡¢
-.BR isascii ()
-¤òÇÑ»ßͽÄê¤È¤·¤Æ¤¤¤ë¡£
-¥í¡¼¥«¥é¥¤¥º¤µ¤ì¤¿¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ç¤Ï¡¢°Ü¿¢À­¤ò³ÎÊݤ·¤Ä¤Ä¡¢
-¤³¤Î´Ø¿ô¤ò»ÈÍѤ¹¤ë¤³¤È¤Ï¤Ç¤­¤Ê¤¤ÅÀ¤ËÃí°Õ¤¹¤ë¤³¤È¡£
-.SH Ãí°Õ
-¤¢¤ëʸ»ú¤¬¤É¤Î¼ïÎà¤ËÆþ¤ë¤«¤È¤¤¤¦¤³¤È¤Ï¡¢¸½ºß¤Î¥í¥±¡¼¥ë¤Ë°Í¸¤¹¤ë¡£
-¤¿¤È¤¨¤Ð¡¢¥Ç¥Õ¥©¥ë¥È¤Î
-.B "C"
-¥í¥±¡¼¥ë¤Ç¤Ï
-.BR isupper ()
-¤Ï A ¤Î¥¦¥à¥é¥¦¥È¤òǧ¼±¤Ç¤­¤Ê¤¤¤Î¤Ç¡¢¤½¤ì¤¬Âçʸ»ú¤À¤È¤¤¤¦¤³¤È¤¬¤ï¤«¤é¤Ê¤¤¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR iswalnum (3),
-.BR iswalpha (3),
-.BR iswblank (3),
-.BR iswcntrl (3),
-.BR iswdigit (3),
-.BR iswgraph (3),
-.BR iswlower (3),
-.BR iswprint (3),
-.BR iswpunct (3),
-.BR iswspace (3),
-.BR iswupper (3),
-.BR iswxdigit (3),
-.BR setlocale (3),
-.BR toascii (3),
-.BR tolower (3),
-.BR toupper (3),
-.BR ascii (7),
-.BR locale (7)
+\fB0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F\fP の文字であるかどうかを調べることと等価である。
+.SH 返り値
+文字 \fIc\fP が調べた文字の種類に合っていれば 0 以外を返す。 そうでなければ 0 を返す。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+.\" FIXME: need a thread-safety statement about the *_l functions
+関数 \fBisalnum\fP(), \fBisalpha\fP(), \fBisascii\fP(), \fBisblank\fP(), \fBiscntrl\fP(),
+\fBisdigit\fP(), \fBisgraph\fP(), \fBislower\fP(), \fBisprint\fP(), \fBispunct\fP(),
+\fBisspace\fP(), \fBisupper\fP(), \fBisxdigit\fP() はスレッドセーフである。
+.SH バージョン
+\fBisalnum_l\fP(), \fBisalpha_l\fP(), \fBisblank_l\fP(), \fBiscntrl_l\fP(),
+\fBisdigit_l\fP(), \fBisgraph_l\fP(), \fBislower_l\fP(), \fBisprint_l\fP(),
+\fBispunct_l\fP(), \fBisspace_l\fP(), \fBisupper_l\fP(), \fBisxdigit_l\fP(),
+\fBisascii_l\fP() は glibc 2.3 以降で利用可能である。
+.SH 準拠
+C89 では \fBisalnum\fP(), \fBisalpha\fP(), \fBiscntrl\fP(), \fBisdigit\fP(), \fBisgraph\fP(),
+\fBislower\fP(), \fBisprint\fP(), \fBispunct\fP(), \fBisspace\fP(), \fBisupper\fP(),
+\fBisxdigit\fP() が規定されているが、 \fBisascii\fP() と \fBisblank\fP() は規定されていない。 POSIX.1\-2001
+でもこれらの関数は規定されており、\fBisascii\fP() と \fBisblank\fP() も規定されている (\fBisascii\fP() は XSI
+拡張)。 C99 では、ここで挙げた関数のうち \fBisascii\fP() 以外の全てが規定されている。
+
+POSIX.1\-2008 では \fBisascii\fP()
+は廃止予定とされている。ローカライズするアプリケーションで移植性がある形では使用できない点に注意すること。
+
+POSIX.\-1\-2008 では \fBisalnum_l\fP(), \fBisalpha_l\fP(), \fBisblank_l\fP(),
+\fBiscntrl_l\fP(), \fBisdigit_l\fP(), \fBisgraph_l\fP(), \fBislower_l\fP(),
+\fBisprint_l\fP(), \fBispunct_l\fP(), \fBisspace_l\fP(), \fBisupper_l\fP(),
+\fBisxdigit_l\fP() が規定されている。
+
+\fBisascii_l\fP() は GNU 拡張である。
+.SH 注意
+ある文字がどの種類に入るかということは、現在のロケールに依存する。 たとえば、デフォルトの \fBC\fP ロケールでは \fBisupper\fP()  は A
+のウムラウトを認識できないので、それが大文字だということがわからない。
+.SH 関連項目
+\fBiswalnum\fP(3), \fBiswalpha\fP(3), \fBiswblank\fP(3), \fBiswcntrl\fP(3),
+\fBiswdigit\fP(3), \fBiswgraph\fP(3), \fBiswlower\fP(3), \fBiswprint\fP(3),
+\fBiswpunct\fP(3), \fBiswspace\fP(3), \fBiswupper\fP(3), \fBiswxdigit\fP(3),
+\fBnewlocale\fP(3), \fBsetlocale\fP(3), \fBuselocale\fP(3), \fBtoascii\fP(3),
+\fBtolower\fP(3), \fBtoupper\fP(3), \fBascii\fP(7), \fBlocale\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.64 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。