summaryrefslogtreecommitdiffstats
path: root/lib/libc
diff options
context:
space:
mode:
authorache <ache@FreeBSD.org>2000-03-28 11:36:31 +0000
committerache <ache@FreeBSD.org>2000-03-28 11:36:31 +0000
commit68cad6a3ea16260f64504618a039d82f59a2e758 (patch)
treed03574a56cf99abdf7df704af4d8a6cfcb81996f /lib/libc
parente3991c3acfdd37e221e19eeb7dac3709d7aa2f9d (diff)
downloadFreeBSD-src-68cad6a3ea16260f64504618a039d82f59a2e758.zip
FreeBSD-src-68cad6a3ea16260f64504618a039d82f59a2e758.tar.gz
Describe valid argument domain for 8-bit wide locales to prevent common error
calling ctype functions with signed char as an argument.
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/locale/isalnum.32
-rw-r--r--lib/libc/locale/isalpha.32
-rw-r--r--lib/libc/locale/isascii.32
-rw-r--r--lib/libc/locale/isblank.32
-rw-r--r--lib/libc/locale/iscntrl.32
-rw-r--r--lib/libc/locale/isdigit.32
-rw-r--r--lib/libc/locale/isgraph.32
-rw-r--r--lib/libc/locale/islower.32
-rw-r--r--lib/libc/locale/isprint.32
-rw-r--r--lib/libc/locale/ispunct.32
-rw-r--r--lib/libc/locale/isspace.32
-rw-r--r--lib/libc/locale/isupper.32
-rw-r--r--lib/libc/locale/isxdigit.32
-rw-r--r--lib/libc/locale/tolower.32
-rw-r--r--lib/libc/locale/toupper.32
15 files changed, 30 insertions, 0 deletions
diff --git a/lib/libc/locale/isalnum.3 b/lib/libc/locale/isalnum.3
index 60ad8c4..b548c58 100644
--- a/lib/libc/locale/isalnum.3
+++ b/lib/libc/locale/isalnum.3
@@ -54,6 +54,8 @@ function tests for any character for which
or
.Xr isdigit 3
is true.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/isalpha.3 b/lib/libc/locale/isalpha.3
index 5dd0a04..4bfed34 100644
--- a/lib/libc/locale/isalpha.3
+++ b/lib/libc/locale/isalpha.3
@@ -54,6 +54,8 @@ function tests for any character for which
or
.Xr islower 3
is true.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/isascii.3 b/lib/libc/locale/isascii.3
index 9700218..bdb183b 100644
--- a/lib/libc/locale/isascii.3
+++ b/lib/libc/locale/isascii.3
@@ -49,6 +49,8 @@ function tests for an
.Tn ASCII
character, which is any character with a value less than or
equal to octal 0177.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
.Sh SEE ALSO
.Xr ctype 3 ,
.Xr ascii 7
diff --git a/lib/libc/locale/isblank.3 b/lib/libc/locale/isblank.3
index c0ec34d..545cbe6 100644
--- a/lib/libc/locale/isblank.3
+++ b/lib/libc/locale/isblank.3
@@ -46,6 +46,8 @@
The
.Fn isblank
function tests for a space or tab character.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
.Sh RETURN VALUES
The
.Fn isblank
diff --git a/lib/libc/locale/iscntrl.3 b/lib/libc/locale/iscntrl.3
index ea01001..4289e4c 100644
--- a/lib/libc/locale/iscntrl.3
+++ b/lib/libc/locale/iscntrl.3
@@ -50,6 +50,8 @@
The
.Fn iscntrl
function tests for any control character.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/isdigit.3 b/lib/libc/locale/isdigit.3
index fa3a736..24c3e78 100644
--- a/lib/libc/locale/isdigit.3
+++ b/lib/libc/locale/isdigit.3
@@ -50,6 +50,8 @@
The
.Fn isdigit
function tests for any decimal-digit character.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/isgraph.3 b/lib/libc/locale/isgraph.3
index 347af3a..5327398 100644
--- a/lib/libc/locale/isgraph.3
+++ b/lib/libc/locale/isgraph.3
@@ -50,6 +50,8 @@
The
.Fn isgraph
function tests for any printing character except space.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/islower.3 b/lib/libc/locale/islower.3
index 5d767c2..37e3022 100644
--- a/lib/libc/locale/islower.3
+++ b/lib/libc/locale/islower.3
@@ -50,6 +50,8 @@
The
.Fn islower
function tests for any lower-case letters.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/isprint.3 b/lib/libc/locale/isprint.3
index 6bf1f55..6af2257 100644
--- a/lib/libc/locale/isprint.3
+++ b/lib/libc/locale/isprint.3
@@ -50,6 +50,8 @@
The
.Fn isprint
function tests for any printing character including space (' ').
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/ispunct.3 b/lib/libc/locale/ispunct.3
index f80d41c..5d8bf72 100644
--- a/lib/libc/locale/ispunct.3
+++ b/lib/libc/locale/ispunct.3
@@ -53,6 +53,8 @@ function tests for any printing character except for space (' ') or a
character for which
.Xr isalnum 3
is true.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/isspace.3 b/lib/libc/locale/isspace.3
index e8fa978..d1e8795 100644
--- a/lib/libc/locale/isspace.3
+++ b/lib/libc/locale/isspace.3
@@ -50,6 +50,8 @@
The
.Fn isspace
function tests for the standard white-space characters.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/isupper.3 b/lib/libc/locale/isupper.3
index 1ec34d7..b060345 100644
--- a/lib/libc/locale/isupper.3
+++ b/lib/libc/locale/isupper.3
@@ -50,6 +50,8 @@
The
.Fn isupper
function tests for any upper-case letter.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/isxdigit.3 b/lib/libc/locale/isxdigit.3
index f2e2ec8..fc0dae9 100644
--- a/lib/libc/locale/isxdigit.3
+++ b/lib/libc/locale/isxdigit.3
@@ -50,6 +50,8 @@
The
.Fn isxdigit
function tests for any hexadecimal-digit character.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
In the ASCII character set, this includes the following characters
(with their numeric values shown in octal):
.Pp
diff --git a/lib/libc/locale/tolower.3 b/lib/libc/locale/tolower.3
index 1bd82c2..dfb7c25 100644
--- a/lib/libc/locale/tolower.3
+++ b/lib/libc/locale/tolower.3
@@ -51,6 +51,8 @@ The
.Fn tolower
function converts an upper-case letter to the corresponding lower-case
letter.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
.Sh RETURN VALUES
If the argument is an upper-case letter, the
.Fn tolower
diff --git a/lib/libc/locale/toupper.3 b/lib/libc/locale/toupper.3
index 33742da..28bc027 100644
--- a/lib/libc/locale/toupper.3
+++ b/lib/libc/locale/toupper.3
@@ -51,6 +51,8 @@ The
.Fn toupper
function converts a lower-case letter to the corresponding
upper-case letter.
+For 8-bit wide locales the value of the argument is
+representable as an unsigned char or the value of EOF.
.SH RETURN VALUES
If the argument is a lower-case letter, the
.Fn toupper
OpenPOWER on IntegriCloud