In perl.git, the branch blead has been updated <http://perl5.git.perl.org/perl.git/commitdiff/0d7b27597cc56fd28bf02a6f3e4caeec29e98f62?hp=aa13e525452842be4732a0b9d771f3641019dc96>
- Log ----------------------------------------------------------------- commit 0d7b27597cc56fd28bf02a6f3e4caeec29e98f62 Author: Matthew Horsfall (alh) <[email protected]> Date: Wed Dec 18 08:59:02 2013 -0500 Note usage compatability of Safefree / Newx and friends ----------------------------------------------------------------------- Summary of changes: handy.h | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/handy.h b/handy.h index b63fa59..6b0334e 100644 --- a/handy.h +++ b/handy.h @@ -1565,6 +1565,8 @@ typedef U32 line_t; =for apidoc Am|void|Newx|void* ptr|int nitems|type The XSUB-writer's interface to the C C<malloc> function. +Memory obtained by this should B<ONLY> be freed with L<"Safefree">. + In 5.9.3, Newx() and friends replace the older New() API, and drops the first parameter, I<x>, a debug aid which allowed callers to identify themselves. This aid has been superseded by a new build option, @@ -1575,20 +1577,30 @@ there for use in XS modules supporting older perls. The XSUB-writer's interface to the C C<malloc> function, with cast. See also C<Newx>. +Memory obtained by this should B<ONLY> be freed with L<"Safefree">. + =for apidoc Am|void|Newxz|void* ptr|int nitems|type The XSUB-writer's interface to the C C<malloc> function. The allocated memory is zeroed with C<memzero>. See also C<Newx>. +Memory obtained by this should B<ONLY> be freed with L<"Safefree">. + =for apidoc Am|void|Renew|void* ptr|int nitems|type The XSUB-writer's interface to the C C<realloc> function. +Memory obtained by this should B<ONLY> be freed with L<"Safefree">. + =for apidoc Am|void|Renewc|void* ptr|int nitems|type|cast The XSUB-writer's interface to the C C<realloc> function, with cast. +Memory obtained by this should B<ONLY> be freed with L<"Safefree">. + =for apidoc Am|void|Safefree|void* ptr The XSUB-writer's interface to the C C<free> function. +This should B<ONLY> be used on memory obtained using L<"Newx"> and friends. + =for apidoc Am|void|Move|void* src|void* dest|int nitems|type The XSUB-writer's interface to the C C<memmove> function. The C<src> is the source, C<dest> is the destination, C<nitems> is the number of items, and -- Perl5 Master Repository
