Add a note to the Compatiblity section suggesting that these functions

only be used for byte values. Add cross-references to the wide-char
counterparts.
This commit is contained in:
tjr 2002-10-06 10:15:38 +00:00
parent 586be0c8e4
commit b5f0d0d8f2
13 changed files with 162 additions and 13 deletions

View File

@ -36,7 +36,7 @@
.\" @(#)isalnum.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISALNUM 3
.Os
.Sh NAME
@ -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
Although
.Fn isalnum
accepts arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn iswalnum
function should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr isalpha 3 ,
.Xr isdigit 3 ,
.Xr iswalnum 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS

View File

@ -36,7 +36,7 @@
.\" @(#)isalpha.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISALPHA 3
.Os
.Sh NAME
@ -86,10 +86,22 @@ The
.Fn isalpha
function returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh COMPATIBILITY
Although
.Fn isalpha
accepts arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn iswalpha
function should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr islower 3 ,
.Xr isupper 3 ,
.Xr iswalpha 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS

View File

@ -32,7 +32,7 @@
.\" @(#)isascii.3 8.2 (Berkeley) 12/11/93
.\" $FreeBSD$
.\"
.Dd December 11, 1993
.Dd October 6, 2002
.Dt ISASCII 3
.Os
.Sh NAME
@ -53,4 +53,5 @@ character, which is any character
between 0 and octal 0177 inclusive.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswascii 3 ,
.Xr ascii 7

View File

@ -32,7 +32,7 @@
.\" @(#)isblank.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISBLANK 3
.Os
.Sh NAME
@ -66,6 +66,17 @@ representable as an
.Li unsigned char
or the value of
.Dv EOF .
.Sh COMPATIBILITY
Although
.Fn isblank
accepts arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn iswblank
function should be used instead for maximum portability.
.Sh RETURN VALUES
The
.Fn isblank
@ -73,6 +84,7 @@ function returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswblank 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS

View File

@ -36,7 +36,7 @@
.\" @(#)iscntrl.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISCNTRL 3
.Os
.Sh NAME
@ -78,8 +78,20 @@ The
.Fn iscntrl
function returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh COMPATIBILITY
Although
.Fn iscntrl
accepts arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn iwcntrl
function should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswcntrl 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS

View File

@ -36,7 +36,7 @@
.\" @(#)isdigit.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISDIGIT 3
.Os
.Sh NAME
@ -76,8 +76,20 @@ The
.Fn isdigit
function returns 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
.Bx 4.4
extension and the
.Fn iswdigit
function should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswdigit 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS

View File

@ -36,7 +36,7 @@
.\" @(#)isgraph.3 8.2 (Berkeley) 12/11/93
.\" $FreeBSD$
.\"
.Dd December 11, 1993
.Dd October 6, 2002
.Dt ISGRAPH 3
.Os
.Sh NAME
@ -93,8 +93,20 @@ The
.Fn isgraph
function returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh COMPATIBILITY
Although
.Fn isgraph
accepts arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn iswgraph
function should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswgraph 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS

View File

@ -36,7 +36,7 @@
.\" @(#)islower.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISLOWER 3
.Os
.Sh NAME
@ -77,8 +77,20 @@ The
.Fn islower
function returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh COMPATIBILITY
Although
.Fn islower
accepts arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn iswlower
function should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswlower 3 ,
.Xr multibyte 3 ,
.Xr tolower 3 ,
.Xr ascii 7

View File

@ -36,7 +36,7 @@
.\" @(#)isprint.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISPRINT 3
.Os
.Sh NAME
@ -91,8 +91,20 @@ The
.Fn isprint
function returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh COMPATIBILITY
Although
.Fn isprint
accepts arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn iswprint
function should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswprint 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS

View File

@ -36,7 +36,7 @@
.\" @(#)ispunct.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISPUNCT 3
.Os
.Sh NAME
@ -83,8 +83,20 @@ The
.Fn ispunct
function returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh COMPATIBILITY
Although
.Fn ispunct
accepts arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn iswpunct
function should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswpunct 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS

View File

@ -36,7 +36,7 @@
.\" @(#)isspace.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISSPACE 3
.Os
.Sh NAME
@ -75,8 +75,20 @@ The
.Fn isspace
function returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh COMPATIBILITY
Although
.Fn isspace
accepts arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn iswspace
function should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswspace 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS

View File

@ -36,7 +36,7 @@
.\" @(#)isupper.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISUPPER 3
.Os
.Sh NAME
@ -77,8 +77,20 @@ The
.Fn isupper
function returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh COMPATIBILITY
Although
.Fn isupper
accepts arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn iswupper
function should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswupper 3 ,
.Xr multibyte 3 ,
.Xr toupper 3 ,
.Xr ascii 7

View File

@ -36,7 +36,7 @@
.\" @(#)isxdigit.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd June 4, 1993
.Dd October 6, 2002
.Dt ISXDIGIT 3
.Os
.Sh NAME
@ -78,8 +78,24 @@ The
.Fn isxdigit
function returns zero if the character tests false and
returns non-zero if the character tests true.
.Sh COMPATIBILITY
Although
.Fn isxdigit
and
.Fn ishexnumber
accept arguments outside of the range of the
.Vt "unsigned char"
type in locales with large character sets,
this is a
.Bx 4.4
extension and the
.Fn isxwdigit
and
.Fn iswhexnumber
functions should be used instead for maximum portability.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr iswxdigit 3 ,
.Xr multibyte 3 ,
.Xr ascii 7
.Sh STANDARDS