Re: [PATCH] my_snprintf

Message-ID: <4464E1F1.9010706@gmail.com>

p4raw-id: //depot/perl@28183

1 files changed, 25 insertions, 0 deletions

diff --git a/pod/perlapi.pod b/pod/perlapi.pod
index d608eef3c3..c3b6074873 100644
--- a/pod/perlapi.pod
+++ b/pod/perlapi.pod
@@ -2245,6 +2245,19 @@ Fill the sv with current working directory
 =for hackers
 Found in file util.c
 
+=item my_snprintf
+X<my_snprintf>
+
+The C library C<snprintf> functionality, if available and
+standards-compliant (uses C<vsnprintf>, actually).  If the
+C<vsnprintf> is not available, will unfortunately use the unsafe
+C<vsprintf>.  Consider using C<sv_vcatpvf> instead.
+
+	int	my_snprintf(char *buffer, const Size_t len, const char *format, ...)
+
+=for hackers
+Found in file util.c
+
 =item my_sprintf
 X<my_sprintf>
 
@@ -2257,6 +2270,18 @@ need the wrapper function - usually this is a direct call to C<sprintf>.
 =for hackers
 Found in file util.c
 
+=item my_vsnprintf
+X<my_vsnprintf>
+
+The C library C<vsnprintf> if available and standards-compliant,
+but if the C<vsnprintf> is not available, will unfortunately use
+the unsafe C<vsprintf>.  Consider using C<sv_vcatpvf> instead.
+
+	int	my_vsnprintf(char *buffer, const Size_t len, const char *format, va_list ap)
+
+=for hackers
+Found in file util.c
+
 =item new_version
 X<new_version>