summaryrefslogtreecommitdiff
path: root/sv.h
diff options
context:
space:
mode:
authorDaniel Dragan <bulk88@hotmail.com>2013-03-05 22:51:01 -0500
committerNicholas Clark <nick@ccl4.org>2013-03-06 13:01:43 +0100
commitf615be485d8c90f01432a39e678e01c615e2c15e (patch)
tree15dd56dec60d98611b72a8a51450a93729ca7679 /sv.h
parenta420522db95b77620564c1be75cece4504eabef1 (diff)
downloadperl-f615be485d8c90f01432a39e678e01c615e2c15e.tar.gz
better POD for SvPVX, pre-5.9.3 Perls
PV/char * was moved to SV head in commit 7b2c381cf3 . Prior to this, PV was in SV body, and sv_any can be NULL, so accessing SvPVX without checking type on old Perls was a SEGV. Make a note of this so others don't find out the hard way.
Diffstat (limited to 'sv.h')
-rw-r--r--sv.h3
1 files changed, 2 insertions, 1 deletions
diff --git a/sv.h b/sv.h
index 94ba1e6e23..fd3da2dd5a 100644
--- a/sv.h
+++ b/sv.h
@@ -730,7 +730,8 @@ Only use when you are sure SvNOK is true. See also C<SvNV()>.
=for apidoc Am|char*|SvPVX|SV* sv
Returns a pointer to the physical string in the SV. The SV must contain a
-string.
+string. Prior to 5.9.3 it is not safe to execute this macro unless the SV's
+type >= SVt_PV.
This is also used to store the name of an autoloaded subroutine in an XS
AUTOLOAD routine. See L<perlguts/Autoloading with XSUBs>.