Advertise grok_atou.

diff --git a/pod/perlclib.pod b/pod/perlclib.pod
index 23cca04..b7d8c10 100644 (file)
--- a/pod/perlclib.pod
+++ b/pod/perlclib.pod
@@ -200,7 +200,8 @@ C<toUPPER_uni>, as described in L<perlapi/Character case changing>.)
  Instead Of:                 Use:
 
  atof(s)                     Atof(s)
- atol(s)                     Atol(s)
+ atoi(s)                     grok_atou(s, &e)
+ atol(s)                     grok_atou(s, &e)
  strtod(s, &p)               Nothing.  Just don't use it.
  strtol(s, &p, n)            Strtol(s, &p, n)
  strtoul(s, &p, n)           Strtoul(s, &p, n)

diff --git a/pod/perlhacktips.pod b/pod/perlhacktips.pod
index c673dde..1d8aa19 100644 (file)
--- a/pod/perlhacktips.pod
+++ b/pod/perlhacktips.pod
@@ -623,6 +623,14 @@ of the program is UTF-8.  What happens is that the C<%s> and its operand are
 simply skipped without any notice.
 L<https://sourceware.org/bugzilla/show_bug.cgi?id=6530>.
 
+=item *
+
+Do not use atoi()
+
+Use grok_atou() instead.  atoi() has ill-defined behavior on overflows,
+and cannot be used for incremental parsing.  It is also affected by locale,
+which can be construed as a bug.
+
 =back
 
 =head1 DEBUGGING