From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Wed, 2 Aug 2000 22:08:51 +0000 (+0000)
Subject: Document the IVdf UVuf UVof UVxf.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=9dd9db0b5e99ed70382d82a6b55eda97b58bfa75;p=p5sagit%2Fp5-mst-13.2.git

Document the IVdf UVuf UVof UVxf.

p4raw-id: //depot/perl@6496
---

diff --git a/pod/perlguts.pod b/pod/perlguts.pod
index 8c440c8..f2b4b90 100644
--- a/pod/perlguts.pod
+++ b/pod/perlguts.pod
@@ -1877,6 +1877,19 @@ This function isn't exported out of the Perl core.
 If you edit F<embed.pl>, you will need to run C<make regen_headers> to
 force a rebuild of F<embed.h> and other auto-generated files.
 
+=head2 Formatted Printing of IVs and UVs
+
+If you are printing IVs or UVs instead of the stdio(3) style formatting
+codes like C<%d> you should use the following macros for portability
+
+	IVdf		IV in decimal
+	UVuf		UV in decimal
+	UVof		UV in octal
+	UVxf		UV in hexadecimal
+
+For example: printf("IV is %"IVdf"\n", iv);  That will expand
+to whatever is the correct format for the IVs.
+
 =head2 Source Documentation
 
 There's an effort going on to document the internal functions and