X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=release%2Fman3%2Fisalpha.3;h=2f96ad313a617991aabdeccd8a0c2dabad3aa623;hb=4040bbeba90e43150eae99330d7a1d6826050e62;hp=92bd3785e087aa05b408a40c7f728551016166e9;hpb=7e089fcc022461849bbc09437103cc337a88dd9c;p=linuxjm%2FLDP_man-pages.git diff --git a/release/man3/isalpha.3 b/release/man3/isalpha.3 index 92bd3785..2f96ad31 100644 --- a/release/man3/isalpha.3 +++ b/release/man3/isalpha.3 @@ -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. @@ -19,13 +20,19 @@ .\" .\" 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 .\" 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 @@ -33,181 +40,184 @@ .\" Updated 2005-02-26, Akihiro MOTOKI .\" 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 +\fB#include \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/ に書かれている。