]> git.ipfire.org Git - thirdparty/man-pages.git/commitdiff
man/man3/strto[u]l.3: BUGS: Signed numbers and white space are not rejected
authorAlejandro Colomar <alx@kernel.org>
Fri, 21 Mar 2025 20:35:52 +0000 (21:35 +0100)
committerAlejandro Colomar <alx@kernel.org>
Sun, 23 Mar 2025 13:56:53 +0000 (14:56 +0100)
Link: <https://stackoverflow.com/questions/60955490/strtoul-what-is-the-correct-return-value-for-very-negative-strings>
Reported-by: Bruno Haible <bruno@clisp.org>
Co-authored-by: Bruno Haible <bruno@clisp.org>
Signed-off-by: Bruno Haible <bruno@clisp.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
man/man3/strtol.3
man/man3/strtoul.3

index 9323873a9d47421dfc033caaabe90083948c1175..f9c9af4bcbc6fb1b1a98dd2fe017ad2ba69f06fc 100644 (file)
@@ -224,6 +224,13 @@ if (errno == EINVAL)
     goto unsupported_base;
 .EE
 .in
+.SH BUGS
+.SS White space
+These functions silently accept leading white space.
+To reject white space, call
+.BR isspace (3)
+before
+.BR strtol ().
 .SH EXAMPLES
 The program shown below demonstrates the use of
 .BR strtol ().
index 9eb260dae45e61db42a8cc80c18a58e0f8abf0fa..c4f8961a4d04281db6b755937bc21d78193ecbcb 100644 (file)
@@ -204,11 +204,19 @@ to 0 before the call,
 and then determine if an error occurred by checking whether
 .I errno
 has a nonzero value after the call.
-.P
-Negative values are considered valid input and are
-silently converted to the equivalent
-.I "unsigned long"
-value.
+.SH BUGS
+.SS Signed numbers
+Some negative values
+are considered valid input and
+are silently converted to
+.IR "\%unsigned\ long" .
+.SS White space
+These functions silently accept leading whitespace.
+.SS isalnum(3)
+To reject white space and/or a sign, call
+.BR isalnum (3)
+before
+.BR strtoul ().
 .SH EXAMPLES
 See the example on the
 .BR strtol (3)