Libc-583.tar.gz

[apple/libc.git] / locale / isalnum.3

diff --git a/locale/isalnum.3 b/locale/isalnum.3
index 91d3112c00b67bba3262c138109632cf43d19000..3739051efc0f97a0d4f985cb6894c67a724ba8eb 100644 (file)
--- a/locale/isalnum.3
+++ b/locale/isalnum.3
@@ -34,9 +34,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)isalnum.3  8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/locale/isalnum.3,v 1.7.2.7 2001/12/14 18:33:54 ru Exp $
+.\" $FreeBSD: src/lib/libc/locale/isalnum.3,v 1.19 2004/08/21 07:37:08 tjr Exp $
 .\"
-.Dd June 4, 1993
+.Dd August 21, 2004
 .Dt ISALNUM 3
 .Os
 .Sh NAME
@@ -59,14 +59,14 @@ is true.
 For single C
 .Va char Ns s
 locales (see
-.Xr multibyte 3 )
+.Xr multibyte 3 ) ,
 the value of the argument is
 representable as an
 .Li unsigned char
 or the value of
 .Dv EOF .
 In the ASCII character set, this includes the following characters
-(with their numeric values shown in octal):
+(preceded by their numeric values, in octal):
 .Pp
 .Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
 .It "\&060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3'' \t064\ ``4''"
@@ -88,10 +88,22 @@ The
 .Fn isalnum
 function returns zero if the character tests false and
 returns non-zero if the character tests true.
+.Sh COMPATIBILITY
+The
+.Bx 4.4
+extension of accepting arguments outside of the range of the
+.Vt "unsigned char"
+type in locales with large character sets is considered obsolete
+and may not be supported in future releases.
+The
+.Fn iswalnum
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
+.Xr isalnum_l 3 ,
 .Xr isalpha 3 ,
 .Xr isdigit 3 ,
+.Xr iswalnum 3 ,
 .Xr multibyte 3 ,
 .Xr ascii 7
 .Sh STANDARDS