summaryrefslogtreecommitdiffstats
path: root/lib/libc
diff options
context:
space:
mode:
authortjr <tjr@FreeBSD.org>2004-04-11 05:19:19 +0000
committertjr <tjr@FreeBSD.org>2004-04-11 05:19:19 +0000
commite768e0d54f96ff401447c2949c417f61eb6e7301 (patch)
tree019635e2f6e93eaca9a57977373e8ac2291bde1d /lib/libc
parent39f40945124d3ae32ea38fcf4f156602b4e007b9 (diff)
downloadFreeBSD-src-e768e0d54f96ff401447c2949c417f61eb6e7301.zip
FreeBSD-src-e768e0d54f96ff401447c2949c417f61eb6e7301.tar.gz
Document the meaning of the zero return value.
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/locale/mblen.39
-rw-r--r--lib/libc/locale/mbtowc.38
2 files changed, 11 insertions, 6 deletions
diff --git a/lib/libc/locale/mblen.3 b/lib/libc/locale/mblen.3
index 39ff6a6..6e3a2f2 100644
--- a/lib/libc/locale/mblen.3
+++ b/lib/libc/locale/mblen.3
@@ -37,7 +37,7 @@
.\" From FreeBSD: src/lib/libc/locale/multibyte.3,v 1.22 2003/11/08 03:23:11 tjr Exp
.\" $FreeBSD$
.\"
-.Dd April 7, 2004
+.Dd April 11, 2004
.Dt MBLEN 3
.Os
.Sh NAME
@@ -79,9 +79,12 @@ Otherwise, if
.Fa mbchar
is not a null pointer,
.Fn mblen
-returns the number of bytes processed in
+either returns 0 if
+.Fa mbchar
+represents the null wide character, or returns
+the number of bytes processed in
.Fa mbchar ,
-or \-1 if no multibyte character
+or returns \-1 if no multibyte character
could be recognized or converted.
In this case,
.Fn mblen Ns No 's
diff --git a/lib/libc/locale/mbtowc.3 b/lib/libc/locale/mbtowc.3
index fbc0ceb..850e055 100644
--- a/lib/libc/locale/mbtowc.3
+++ b/lib/libc/locale/mbtowc.3
@@ -37,7 +37,7 @@
.\" From FreeBSD: src/lib/libc/locale/multibyte.3,v 1.22 2003/11/08 03:23:11 tjr Exp
.\" $FreeBSD$
.\"
-.Dd April 7, 2004
+.Dd April 11, 2004
.Dt MBTOWC 3
.Os
.Sh NAME
@@ -81,10 +81,12 @@ Otherwise, if
.Fa mbchar
is not a null pointer,
.Fn mbtowc
-returns
+either returns 0 if
+.Fa mbchar
+represents the null wide character, or returns
the number of bytes processed in
.Fa mbchar ,
-or \-1 if no multibyte character
+or returns \-1 if no multibyte character
could be recognized or converted.
In this case,
.Fn mbtowc Ns No 's
OpenPOWER on IntegriCloud