This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Re: newSVpvn(NULL, 0); doesn't work as advertised
authorMarcus Holland-Moritz <mhx-perl@gmx.net>
Fri, 4 Jun 2004 16:29:44 +0000 (18:29 +0200)
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>
Tue, 8 Jun 2004 13:53:40 +0000 (13:53 +0000)
Message-Id: <20040604162944.4011f1c6@r2d2>

p4raw-id: //depot/perl@22905

pod/perlapi.pod
sv.c

index 7505652..c8f1bfd 100644 (file)
@@ -2866,7 +2866,7 @@ Found in file sv.c
 Creates a new SV and copies a string into it.  The reference count for the
 SV is set to 1.  Note that if C<len> is zero, Perl will create a zero length
 string.  You are responsible for ensuring that the source string is at least
-C<len> bytes long.
+C<len> bytes long.  If the C<s> argument is NULL the new SV will be undefined.
 
        SV*     newSVpvn(const char* s, STRLEN len)
 
@@ -4559,7 +4559,8 @@ Found in file sv.c
 =item sv_setpvn
 
 Copies a string into an SV.  The C<len> parameter indicates the number of
-bytes to be copied.  Does not handle 'set' magic.  See C<sv_setpvn_mg>.
+bytes to be copied.  If the C<ptr> argument is NULL the SV will become
+undefined.  Does not handle 'set' magic.  See C<sv_setpvn_mg>.
 
        void    sv_setpvn(SV* sv, const char* ptr, STRLEN len)
 
diff --git a/sv.c b/sv.c
index 501d09f..fe1d406 100644 (file)
--- a/sv.c
+++ b/sv.c
@@ -4760,7 +4760,8 @@ Perl_sv_setsv_cow(pTHX_ SV *dstr, SV *sstr)
 =for apidoc sv_setpvn
 
 Copies a string into an SV.  The C<len> parameter indicates the number of
-bytes to be copied.  Does not handle 'set' magic.  See C<sv_setpvn_mg>.
+bytes to be copied.  If the C<ptr> argument is NULL the SV will become
+undefined.  Does not handle 'set' magic.  See C<sv_setpvn_mg>.
 
 =cut
 */
@@ -7616,7 +7617,7 @@ Perl_newSVpv(pTHX_ const char *s, STRLEN len)
 Creates a new SV and copies a string into it.  The reference count for the
 SV is set to 1.  Note that if C<len> is zero, Perl will create a zero length
 string.  You are responsible for ensuring that the source string is at least
-C<len> bytes long.
+C<len> bytes long.  If the C<s> argument is NULL the new SV will be undefined.
 
 =cut
 */