This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlfunc.pod: add a description for octal strings for oct()
authorTAKAI Kousuke <62541129+t-a-k@users.noreply.github.com>
Sat, 31 Oct 2020 05:15:27 +0000 (14:15 +0900)
committerKarl Williamson <khw@cpan.org>
Tue, 8 Dec 2020 04:52:14 +0000 (21:52 -0700)
These sentences are borrowed from the description for hex().

pod/perlfunc.pod

index d1c2ffa..de24eef 100644 (file)
@@ -4432,7 +4432,10 @@ X<oct> X<octal> X<hex> X<hexadecimal> X<binary> X<bin>
 =for Pod::Functions convert a string to an octal number
 
 Interprets EXPR as an octal string and returns the corresponding
-value.  (If EXPR happens to start off with C<0x> or C<x>, interprets it as a
+value.  An octal string consists of octal digits and, as of Perl 5.33.5,
+an optional C<0o> or C<o> prefix.  Each octal digit may be preceded by
+a single underscore, which will be ignored.
+(If EXPR happens to start off with C<0x> or C<x>, interprets it as a
 hex string.  If EXPR starts off with C<0b> or C<b>, it is interpreted as a
 binary string.  Leading whitespace is ignored in all three cases.)
 The following will handle decimal, binary, octal, and hex in standard