diff options
Diffstat (limited to 'pod/perlapi.pod')
| -rw-r--r-- | pod/perlapi.pod | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/pod/perlapi.pod b/pod/perlapi.pod index df9572a87f..b7cb7b30d0 100644 --- a/pod/perlapi.pod +++ b/pod/perlapi.pod @@ -3918,6 +3918,17 @@ incremented. =for hackers Found in file sv.h +=item newSVpvn_utf8 +X<newSVpvn_utf8> + +Creates a new SV and copies a string into it. If utf8 is true, calls +C<SvUTF8_on> on the new SV. Implemented as a wrapper around C<newSVpvn_flags>. + + SV* newSVpvn_utf8(NULLOK const char* s, STRLEN len, U32 utf8) + +=for hackers +Found in file sv.h + =item SvCUR X<SvCUR> @@ -5137,6 +5148,25 @@ C<len> bytes long. If the C<s> argument is NULL the new SV will be undefined. =for hackers Found in file sv.c +=item newSVpvn_flags +X<newSVpvn_flags> + +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. If the C<s> argument is NULL the new SV will be undefined. +Currently the only flag bit accepted is SVf_UTF8. If this is set, then it +will be set on the new SV. C<newSVpvn_utf8()> is a convenience wrapper for +this function, defined as + + #define newSVpvn_utf8(s, len, u) \ + newSVpvn_flags((s), (len), (u) ? SVf_UTF8 : 0) + + SV* newSVpvn_flags(const char* s, STRLEN len, U32 flags) + +=for hackers +Found in file sv.c + =item newSVpvn_share X<newSVpvn_share> |