Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

isascii() and toascii() are defined for all integers unlike the other 

functions. Explicitely mention "undefined behavior".
This commit is contained in:
cbiere 2007-01-18 11:33:13 +00:00
parent 672e3eab7c
commit 75289275f1
2 changed files with 5 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
lib/libc/gen/ctype.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ctype.3,v 1.15 2007/01/18 08:33:34 rillig Exp $
.\" $NetBSD: ctype.3,v 1.16 2007/01/18 11:33:13 cbiere Exp $
.\"
.\" Copyright (c) 1991 Regents of the University of California.
.\" All rights reserved.
@ -30,7 +30,7 @@
.\"
.\" @(#)ctype.3 6.5 (Berkeley) 4/19/91
.\"
.Dd January 18, 2006
.Dd January 18, 2007
.Dt CTYPE 3
.Os
.Sh NAME
@ -46,10 +46,8 @@
.Nm isgraph ,
.Nm iscntrl ,
.Nm isblank ,
.Nm isascii ,
.Nm toupper ,
.Nm tolower ,
.Nm toascii
.Nd character classification and mapping functions
.Sh LIBRARY
.Lb libc
@ -69,10 +67,8 @@
.Fn isgraph c
.Fn iscntrl c
.Fn isblank c
.Fn isascii c
.Fn toupper c
.Fn tolower c
.Fn toascii c
.Sh DESCRIPTION
The above functions perform character tests and conversions on the integer
.Ar c .
@ -84,6 +80,7 @@ restricted subset is actually valid as an argument.
The argument must either be the value of the macro
.Dv EOF
or representable as an unsigned char.
Otherwise the behavior is undefined.
When testing an expression having the type
.Tn plain char ,
the argument should be cast to an unsigned char.
@ -100,7 +97,6 @@ while (*s != '\\0') {
.Sh SEE ALSO
.Xr isalnum 3 ,
.Xr isalpha 3 ,
.Xr isascii 3 ,
.Xr isblank 3 ,
.Xr iscntrl 3 ,
.Xr isdigit 3 ,
@ -111,15 +107,11 @@ while (*s != '\\0') {
.Xr isspace 3 ,
.Xr isupper 3 ,
.Xr isxdigit 3 ,
.Xr toascii 3 ,
.Xr tolower 3 ,
.Xr toupper 3 ,
.Xr ascii 7
.Sh STANDARDS
These functions, with the exception of
.Fn isblank ,
.Fn isascii ,
and
.Fn toascii ,
conform to
.St -ansiC .

13
lib/libc/gen/toascii.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: toascii.3,v 1.10 2007/01/18 08:35:07 rillig Exp $
.\" $NetBSD: toascii.3,v 1.11 2007/01/18 11:33:13 cbiere Exp $
.\"
.\" Copyright (c) 1993
.\" The Regents of the University of California. All rights reserved.
@ -44,8 +44,7 @@
.Sh DESCRIPTION
The
.Fn toascii
function strips all but the low 7 bits from a letter,
including parity or other marker bits.
function returns the argument with all but the lower 7 bits cleared.
.Sh RETURN VALUES
The
.Fn toascii
@ -73,11 +72,3 @@ The
.Fn toascii
function conforms to
.St -xpg4 .
.Sh CAVEATS
The argument to
.Fn toascii
must be
.Dv EOF
or representable as an
.Li unsigned char ;
otherwise, the behavior is undefined.