In perl.git, the branch blead has been updated
<http://perl5.git.perl.org/perl.git/commitdiff/cfe3322a9b07f6d396890b6c564e7ad953719819?hp=58121923d35f3fce15ffab40b74e3f4e62419b25>
- Log -----------------------------------------------------------------
commit cfe3322a9b07f6d396890b6c564e7ad953719819
Author: David Golden <dagol...@cpan.org>
Date: Tue May 13 14:13:09 2014 -0400
clarify SvPV documentation
-----------------------------------------------------------------------
Summary of changes:
sv.h | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/sv.h b/sv.h
index f5e2827..6332974 100644
--- a/sv.h
+++ b/sv.h
@@ -1509,8 +1509,10 @@ Like C<SvPV_force>, but doesn't process get magic.
=for apidoc Am|char*|SvPV|SV* sv|STRLEN len
Returns a pointer to the string in the SV, or a stringified form of
the SV if the SV does not contain a string. The SV may cache the
-stringified version becoming C<SvPOK>. Handles 'get' magic. See also
-C<SvPVx> for a version which guarantees to evaluate sv only once.
+stringified version becoming C<SvPOK>. Handles 'get' magic. The
+C<len> variable will be set to the length of the string (this is a macro, so
+don't use C<&len>). See also C<SvPVx> for a version which guarantees to
+evaluate sv only once.
Note that there is no guarantee that the return value of C<SvPV()> is
equal to C<SvPVX(sv)>, or that C<SvPVX(sv)> contains valid data, or that
--
Perl5 Master Repository
