Libc-391.tar.gz

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

diff --git a/locale/FreeBSD/isdigit.3 b/locale/FreeBSD/isdigit.3
index 8fecc59878cfb89dc8fc7d1e2da20ccec9fa0af2..1c8bea863b8cebb2108a607c58b8b76019934c31 100644 (file)
--- a/locale/FreeBSD/isdigit.3
+++ b/locale/FreeBSD/isdigit.3
@@ -34,9 +34,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)isdigit.3  8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/locale/isdigit.3,v 1.16 2002/10/06 10:15:38 tjr Exp $
+.\" $FreeBSD: src/lib/libc/locale/isdigit.3,v 1.19 2004/08/21 07:37:08 tjr Exp $
 .\"
-.Dd October 6, 2002
+.Dd August 21, 2004
 .Dt ISDIGIT 3
 .Os
 .Sh NAME
@@ -53,15 +53,21 @@
 .Sh DESCRIPTION
 The
 .Fn isdigit
-function tests for any decimal-digit character.
-For any locale,
-this includes the following characters only:
+function tests for a decimal digit character.
+Regardless of locale, this includes the following characters only:
 .Pp
 .Bl -column \&``0''______ \&``0''______ \&``0''______ \&``0''______ \&``0''______
 .It "\&``0''\t``1''\t``2''\t``3''\t``4''"
 .It "\&``5''\t``6''\t``7''\t``8''\t``9''"
 .El
 .Pp
+The
+.Fn isnumber
+function behaves similarly to
+.Fn isdigit ,
+but may recognize additional characters, depending on the current locale
+setting.
+.Pp
 For single C
 .Va char Ns s
 locales (see
@@ -74,19 +80,20 @@ or the value of
 .Sh RETURN VALUES
 The
 .Fn isdigit
-function returns zero if the character tests false and
+and
+.Fn isnumber
+functions return zero if the character tests false and
 returns non-zero if the character tests true.
 .Sh COMPATIBILITY
-Although
-.Fn isdigit
-accepts arguments outside of the range of the
-.Vt "unsigned char"
-type in locales with large character sets,
-this is a
+The
 .Bx 4.4
-extension and the
+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 iswdigit
-function should be used instead for maximum portability.
+function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr iswdigit 3 ,
@@ -97,3 +104,8 @@ The
 .Fn isdigit
 function conforms to
 .St -isoC .
+.Sh HISTORY
+The
+.Fn isnumber
+function appeared in
+.Bx 4.4 .