diff options
| -rw-r--r-- | handy.h | 15 | ||||
| -rw-r--r-- | pod/perlapi.pod | 15 |
2 files changed, 16 insertions, 14 deletions
@@ -550,18 +550,19 @@ C<id> is an integer id between 0 and 1299 (used to identify leaks). =for apidoc Am|void|Newx|void* ptr|int nitems|type The XSUB-writer's interface to the C C<malloc> function. +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 superceded by a new build option, +PERL_MEM_LOG (see L<perlhack/PERL_MEM_LOG>). The older API is still +there for use in XS modules supporting older perls. + =for apidoc Am|void|Newxc|void* ptr|int nitems|type|cast The XSUB-writer's interface to the C C<malloc> function, with -cast. +cast. See also C<Newx>. =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>. - -In 5.9.3, we removed the 1st parameter, a debug aid, from the api. It -was used to uniquely identify each usage of these allocation -functions, but was deemed unnecessary with the availability of better -memory tracking tools, valgrind for example. +memory is zeroed with C<memzero>. See also C<Newx>. =for apidoc Am|void|Renew|void* ptr|int nitems|type The XSUB-writer's interface to the C C<realloc> function. diff --git a/pod/perlapi.pod b/pod/perlapi.pod index eb5dca944e..8dfce3376e 100644 --- a/pod/perlapi.pod +++ b/pod/perlapi.pod @@ -1603,6 +1603,12 @@ Found in file handy.h The XSUB-writer's interface to the C C<malloc> function. +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 superceded by a new build option, +PERL_MEM_LOG (see L<perlhack/PERL_MEM_LOG>). The older API is still +there for use in XS modules supporting older perls. + void Newx(void* ptr, int nitems, type) =for hackers @@ -1611,7 +1617,7 @@ Found in file handy.h =item Newxc The XSUB-writer's interface to the C C<malloc> function, with -cast. +cast. See also C<Newx>. void Newxc(void* ptr, int nitems, type, cast) @@ -1621,12 +1627,7 @@ Found in file handy.h =item Newxz The XSUB-writer's interface to the C C<malloc> function. The allocated -memory is zeroed with C<memzero>. - -In 5.9.3, we removed the 1st parameter, a debug aid, from the api. It -was used to uniquely identify each usage of these allocation -functions, but was deemed unnecessary with the availability of better -memory tracking tools, valgrind for example. +memory is zeroed with C<memzero>. See also C<Newx>. void Newxz(void* ptr, int nitems, type) |