summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorTodd C. Miller <millert@cvs.openbsd.org>2007-06-29 18:54:38 +0000
committerTodd C. Miller <millert@cvs.openbsd.org>2007-06-29 18:54:38 +0000
commit9abcd7f511bf56c5ebee9161300a84017c166e2d (patch)
tree0ed90345176c3ec19e8d4d954cf8540a010d67d9 /lib
parent6bc5c42cc0e8eaa1ed76a8138a98c8335ac227e9 (diff)
Document behavior when no conversion could be performed. Adapted
from FreeBSD. With help from jmc@.
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/stdlib/strtol.312
-rw-r--r--lib/libc/stdlib/strtoul.310
2 files changed, 17 insertions, 5 deletions
diff --git a/lib/libc/stdlib/strtol.3 b/lib/libc/stdlib/strtol.3
index 74361671ffb..4eb767885ba 100644
--- a/lib/libc/stdlib/strtol.3
+++ b/lib/libc/stdlib/strtol.3
@@ -29,9 +29,9 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: strtol.3,v 1.17 2007/05/31 19:19:31 jmc Exp $
+.\" $OpenBSD: strtol.3,v 1.18 2007/06/29 18:54:37 millert Exp $
.\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: June 29 2007 $
.Dt STRTOL 3
.Os
.Sh NAME
@@ -151,8 +151,14 @@ The
.Fn strtoimax ,
and
.Fn strtoq
-functions returns the result of the conversion,
+functions return the result of the conversion,
unless the value would underflow or overflow.
+If no conversion could be performed, 0 is returned;
+the global variable
+.Va errno
+is also set to
+.Er EINVAL,
+though this is not portable across all platforms.
If overflow or underflow occurs,
.Va errno
is set to
diff --git a/lib/libc/stdlib/strtoul.3 b/lib/libc/stdlib/strtoul.3
index 4e7fb641bc4..30a09aa2891 100644
--- a/lib/libc/stdlib/strtoul.3
+++ b/lib/libc/stdlib/strtoul.3
@@ -29,9 +29,9 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: strtoul.3,v 1.17 2007/05/31 19:19:32 jmc Exp $
+.\" $OpenBSD: strtoul.3,v 1.18 2007/06/29 18:54:37 millert Exp $
.\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: June 29 2007 $
.Dt STRTOUL 3
.Os
.Sh NAME
@@ -175,6 +175,12 @@ and the global variable
.Va errno
is set to
.Er ERANGE .
+If no conversion could be performed, 0 is returned;
+the global variable
+.Va errno
+is also set to
+.Er EINVAL,
+though this is not portable across all platforms.
.Pp
There is no way to determine if
.Fn strtoul