Libc-1082.20.4.tar.gz

[apple/libc.git] / locale / FreeBSD / wctype.3

diff --git a/locale/FreeBSD/wctype.3 b/locale/FreeBSD/wctype.3
index b24edcb5728ac72bddbc045929e86778a56ed0b2..517597291278a787850b8862ed965231dc212c0d 100644 (file)
--- a/locale/FreeBSD/wctype.3
+++ b/locale/FreeBSD/wctype.3
@@ -22,36 +22,57 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/lib/libc/locale/wctype.3,v 1.4 2002/11/29 17:35:09 ru Exp $
+.\" $FreeBSD: src/lib/libc/locale/wctype.3,v 1.7 2006/10/13 16:11:12 ru Exp $
 .\"
-.Dd October 3, 2002
+.Dd March 27, 2004
 .Dt WCTYPE 3
 .Os
 .Sh NAME
-.Nm iswctype , wctype
+.Nm iswctype ,
+.Nm iswctype_l ,
+.Nm wctype ,
+.Nm wctype_l
 .Nd "wide character class functions"
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In wctype.h
 .Ft int
-.Fn iswctype "wint_t wc" "wctype_t charclass"
+.Fo iswctype
+.Fa "wint_t wc"
+.Fa "wctype_t charclass"
+.Fc
 .Ft wctype_t
-.Fn wctype "const char *property"
+.Fo wctype
+.Fa "const char *property"
+.Fc
+.In wctype.h
+.In xlocale.h
+.Ft int
+.Fo iswctype_l
+.Fa "wint_t wc"
+.Fa "wctype_t charclass"
+.Fa "locale_t loc"
+.Fc
+.Ft wctype_t
+.Fo wctype_l
+.Fa "const char *property"
+.Fa "locale_t loc"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn wctype
 function returns a value of type
-.Vt wctype_t
+.Vt wctype_t ,
 which represents the requested wide character class and
 may be used as the second argument for calls to
 .Fn iswctype .
 .Pp
 The following character class names are recognised:
-.Bl -column -offset indent ".Li alnum" ".Li cntrl" ".Li phonogram" ".Li print" ".Li special"
-.It Li "alnum  cntrl   ideogram        print   special"
-.It Li "alpha  digit   lower   punct   upper"
-.It Li "blank  graph   phonogram       space   xdigit"
+.Bl -column -offset indent ".Li alnum" ".Li cntrl" ".Li ideogram" ".Li print" ".Li space"
+.It Li "alnum  cntrl   ideogram        print   space   xdigit"
+.It Li "alpha  digit   lower   punct   special"
+.It Li "blank  graph   phonogram       rune    upper"
 .El
 .Pp
 The
@@ -60,6 +81,18 @@ function checks whether the wide character
 .Fa wc
 is in the character class
 .Fa charclass .
+.Pp
+Although the
+.Fn iswctype
+and
+.Fn wctype
+functions use the current locale, the
+.Fn iswctype_l
+and
+.Fn wctype_l
+functions may be passed locales directly. See
+.Xr xlocale 3
+for more information.
 .Sh RETURN VALUES
 The
 .Fn iswctype
@@ -75,7 +108,7 @@ The
 .Fn wctype
 function returns 0 if
 .Fa property
-is invalid, otherwise it returns a value of type
+is invalid; otherwise, it returns a value of type
 .Vt wctype_t
 that can be used in subsequent calls to
 .Fn iswctype .
@@ -94,7 +127,9 @@ myiswalpha(wint_t wc)
 }
 .Ed
 .Sh SEE ALSO
-.Xr ctype 3
+.Xr ctype 3 ,
+.Xr nextwctype 3 ,
+.Xr xlocale 3
 .Sh STANDARDS
 The
 .Fn iswctype
@@ -104,9 +139,10 @@ functions conform to
 .St -p1003.1-2001 .
 The
 .Dq Li ideogram ,
-.Dq Li phonogram
+.Dq Li phonogram ,
+.Dq Li special ,
 and
-.Dq Li special
+.Dq Li rune
 character classes are extensions.
 .Sh HISTORY
 The