From 1b3f7d2103791ceee4a17b0f9f5860baa1512c7a Mon Sep 17 00:00:00 2001 From: Chip Salzenberg Date: Tue, 29 Apr 1997 16:33:47 +1200 Subject: [PATCH] Refresh description of sprintf() --- pod/perl.pod | 4 ++-- pod/perlfunc.pod | 19 ++++++++----------- 2 files changed, 10 insertions(+), 13 deletions(-) diff --git a/pod/perl.pod b/pod/perl.pod index c7b8452..3036f35 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -275,8 +275,8 @@ switch? The B<-w> switch is not mandatory. Perl is at the mercy of your machine's definitions of various -operations such as type casting, atof(), and sprintf(). The latter -can even trigger a core dump when passed ludicrous input values. +operations such as type casting, atof(), and floating-point +output with sprintf(). If your stdio requires a seek or eof between reads and writes on a particular stream, so does Perl. (This doesn't apply to sysread() diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index 823355b..e3c4c95 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -3118,19 +3118,19 @@ Perl's sprintf() permits the following universally-known conversions: %f a floating-point number, in fixed decimal notation %g a floating-point number, in %e or %f notation -In addition, Perl permits the following ANSI-invented conversions: +In addition, Perl permits the following widely-supported conversions: - %i a synonym for %d %X like %x, but using upper-case letters %E like %e, but using an upper-case "E" %G like %g, but with an upper-case "E" (if applicable) %p a pointer (outputs the Perl value's address in hexadecimal) - %n special: B into the next variable in the parameter - list the number of characters printed so far + %n special: *stores* the number of characters output so far + into the next variable in the parameter list -Finally, for backward (and we do mean "backward") compatibility, -Perl permits these nonstandard but unaccountably popular conversions: +Finally, for backward (and we do mean "backward") compatibility, Perl +permits these unnecessary but widely-supported conversions: + %i a synonym for %d %D a synonym for %ld %U a synonym for %lu %O a synonym for %lo @@ -3143,17 +3143,14 @@ and the conversion letter: + prefix positive number with a plus sign - left-justify within the field 0 use zeros, not spaces, to right-justify + # prefix octal with "0", hex with "0x" number minimum field width .number "precision": digits after decimal point for floating-point, max length for string, minimum length for integer l interpret integer as C type "long" or "unsigned long" - -In addition, Perl permits the following ANSI-invented flags: - - # prefix octal with "0", hex with "0x" h interpret integer as C type "short" or "unsigned short" -Finally, there is one Perl-specific flag: +There is also one Perl-specific flag: V interpret integer as Perl's standard integer type -- 2.7.4