X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=original%2Fman3%2Fisalpha.3;h=3786939573d618e64f44dec34d31ef851adfdfbf;hb=110dba020f489b75aff2497105f7970c05e2b87c;hp=4b1cd5b880bd4f20347c34a477e401fae48d0e8c;hpb=c03a7a882c608ebf399d1b044ce7a6daa922351a;p=linuxjm%2FLDP_man-pages.git

diff --git a/original/man3/isalpha.3 b/original/man3/isalpha.3
index 4b1cd5b8..37869395 100644
--- a/original/man3/isalpha.3
+++ b/original/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,47 +20,54 @@
 .\"
 .\" 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)
 .\"
-.TH ISALPHA 3 2010-09-20 "GNU" "Linux Programmer's Manual"
+.TH ISALPHA 3 2014-03-18 "GNU" "Linux Programmer's Manual"
 .SH NAME
 isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower,
-isprint, ispunct, isspace, isupper, isxdigit \- character
-classification routines
+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
+\- character classification functions
 .SH SYNOPSIS
 .nf
 .B #include <ctype.h>
 .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" );
+.BI "int isalnum(int " c );
+.BI "int isalpha(int " c );
+.BI "int iscntrl(int " c );
+.BI "int isdigit(int " c );
+.BI "int isgraph(int " c );
+.BI "int islower(int " c );
+.BI "int isprint(int " c );
+.BI "int ispunct(int " c );
+.BI "int isspace(int " c );
+.BI "int isupper(int " c );
+.BI "int isxdigit(int " c );
+
+.BI "int isascii(int " c );
+.BI "int isblank(int " c );
+
+.BI "int isalnum_l(int " c ", locale_t " locale );
+.BI "int isalpha_l(int " c ", locale_t " locale );
+.BI "int isblank_l(int " c ", locale_t " locale );
+.BI "int iscntrl_l(int " c ", locale_t " locale );
+.BI "int isdigit_l(int " c ", locale_t " locale );
+.BI "int isgraph_l(int " c ", locale_t " locale );
+.BI "int islower_l(int " c ", locale_t " locale );
+.BI "int isprint_l(int " c ", locale_t " locale );
+.BI "int ispunct_l(int " c ", locale_t " locale );
+.BI "int isspace_l(int " c ", locale_t " locale );
+.BI "int isupper_l(int " c ", locale_t " locale );
+.BI "int isxdigit_l(int " c ", locale_t " locale );
+
+.BI "int isascii_l(int " c ", locale_t " locale );
 .fi
 .sp
 .in -4n
@@ -73,6 +81,7 @@ Feature Test Macro Requirements for glibc (see
 _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE
 .br
 .RE
+
 .BR isblank ():
 .RS 4
 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
@@ -81,6 +90,41 @@ _POSIX_C_SOURCE\ >=\ 200112L;
 or
 .I cc\ -std=c99
 .RE
+
+.BR isalnum_l (),
+.BR isalpha_l (),
+.BR isblank_l (),
+.BR iscntrl_l (),
+.BR isdigit_l (),
+.BR isgraph_l (),
+.BR islower_l (),
+.BR isprint_l (),
+.BR ispunct_l (),
+.BR isspace_l (),
+.BR isupper_l (),
+.BR isxdigit_l ():
+.PD 0
+.RS 4
+.TP
+Since glibc 2.10:
+_XOPEN_SOURCE\ >=\ 700
+.TP
+Before glibc 2.10:
+_GNU_SOURCE
+.RE
+.PD
+
+.BR isascii_l ():
+.PD 0
+.RS 4
+.TP
+Since glibc 2.10:
+_XOPEN_SOURCE\ >=\ 700 && (_SVID_SOURCE || _BSD_SOURCE)
+.TP
+Before glibc 2.10:
+_GNU_SOURCE
+.RE
+.PD
 .ad
 .SH DESCRIPTION
 These functions check whether
@@ -89,7 +133,26 @@ which must have the value of an
 .I unsigned char
 or
 .BR EOF ,
-falls into a certain character class according to the current locale.
+falls into a certain character class according to the specified locale.
+The functions without the
+"_l" suffix perform the check based on the current locale.
+
+The functions with the "_l" suffix perform the check
+based on the locale specified by the locale object
+.IR locale .
+The behavior of these functions is undefined if
+.I locale
+is the special locale object
+.B LC_GLOBAL_LOCALE
+(see
+.BR duplocale (3))
+or is not a valid locale object handle.
+
+The list below explains the operation of the functions without
+the "_l" suffix;
+the functions with the "_l" suffix differ only in using the locale object
+.I locale
+instead of the current locale.
 .TP
 .BR isalnum ()
 checks for an alphanumeric character; it is equivalent to
@@ -101,8 +164,7 @@ locale, it is equivalent to
 .BI "(isupper(" c ") || islower(" c "))" \fR.
 In some locales, there may be additional characters for which
 .BR isalpha ()
-is true\(emletters which are neither upper case nor lower
-case.
+is true\(emletters which are neither uppercase nor lowercase.
 .TP
 .BR isascii ()
 checks whether \fIc\fP is a 7-bit
@@ -123,7 +185,7 @@ checks for a digit (0 through 9).
 checks for any printable character except space.
 .TP
 .BR islower ()
-checks for a lower-case character.
+checks for a lowercase character.
 .TP
 .BR isprint ()
 checks for any printable character including space.
@@ -153,38 +215,106 @@ and vertical tab
 checks for an uppercase letter.
 .TP
 .BR isxdigit ()
-checks for a hexadecimal digits, that is, one of
+checks for hexadecimal digits, that is, one of
 .br
 .BR "0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F" .
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The values returned are nonzero if the character
 .I c
-falls into the tested class, and a zero value
-if not.
-.SH "CONFORMING TO"
-C99, 4.3BSD.
-C89 specifies all of these functions except
+falls into the tested class, and zero if not.
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR isalnum (),
+.BR isalpha (),
+.BR isascii (),
+.BR isblank (),
+.BR iscntrl (),
+.BR isdigit (),
+.BR isgraph (),
+.BR islower (),
+.BR isprint (),
+.BR ispunct (),
+.BR isspace (),
+.BR isupper (),
+and
+.BR isxdigit ()
+functions are thread-safe.
+.\" FIXME: need a thread-safety statement about the *_l functions
+.SH VERSIONS
+.BR isalnum_l (),
+.BR isalpha_l (),
+.BR isblank_l (),
+.BR iscntrl_l (),
+.BR isdigit_l (),
+.BR isgraph_l (),
+.BR islower_l (),
+.BR isprint_l (),
+.BR ispunct_l (),
+.BR isspace_l (),
+.BR isupper_l (),
+.BR isxdigit_l (),
+and
+.BR isascii_l ()
+are available since glibc 2.3.
+.SH CONFORMING TO
+C89 specifies
+.BR isalnum (),
+.BR isalpha (),
+.BR iscntrl (),
+.BR isdigit (),
+.BR isgraph (),
+.BR islower (),
+.BR isprint (),
+.BR ispunct (),
+.BR isspace (),
+.BR isupper (),
+and
+.BR isxdigit (),
+but not
 .BR isascii ()
 and
 .BR isblank ().
+POSIX.1-2001
+also specifies those functions, and also
 .BR isascii ()
-is a BSD extension
-and is also an SVr4 extension.
-.BR isblank ()
-conforms to POSIX.1-2001 and C99 7.4.1.3.
+(as an XSI extension)
+and
+.BR isblank ().
+C99 specifies all of the preceding functions, except
+.BR isascii ().
+
 POSIX.1-2008 marks
 .BR isascii ()
 as obsolete,
 noting that it cannot be used portably in a localized application.
+
+POSIX.1-2008 specifies
+.BR isalnum_l (),
+.BR isalpha_l (),
+.BR isblank_l (),
+.BR iscntrl_l (),
+.BR isdigit_l (),
+.BR isgraph_l (),
+.BR islower_l (),
+.BR isprint_l (),
+.BR ispunct_l (),
+.BR isspace_l (),
+.BR isupper_l (),
+and
+.BR isxdigit_l ().
+
+.BR isascii_l ()
+is a GNU extension.
 .SH NOTES
-The details of what characters belong into which class depend on the current
+The details of what characters belong to which class depend on the
 locale.
 For example,
 .BR isupper ()
 will not recognize an A-umlaut (\(:A) as an uppercase letter in the default
 .B "C"
 locale.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR iswalnum (3),
 .BR iswalpha (3),
 .BR iswblank (3),
@@ -197,9 +327,20 @@ locale.
 .BR iswspace (3),
 .BR iswupper (3),
 .BR iswxdigit (3),
+.BR newlocale (3),
 .BR setlocale (3),
+.BR uselocale (3),
 .BR toascii (3),
 .BR tolower (3),
 .BR toupper (3),
 .BR ascii (7),
 .BR locale (7)
+.SH COLOPHON
+This page is part of release 3.68 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.