diff options
| author | Father Chrysostomos <sprout@cpan.org> | 2010-10-29 22:12:55 -0700 |
|---|---|---|
| committer | Father Chrysostomos <sprout@cpan.org> | 2010-10-29 22:49:04 -0700 |
| commit | 2ffab0983a1bec84ae1240ada5aa5e685645180b (patch) | |
| tree | d1991ff162bc9fb027b6a27c9614e662f262641e /pod/perlmroapi.pod | |
| parent | 8d33f8487218977896bf09e4869394036331cad1 (diff) | |
| download | perl-2ffab0983a1bec84ae1240ada5aa5e685645180b.tar.gz | |
perlmroapi: suggest HvNAME as a fallback
Diffstat (limited to 'pod/perlmroapi.pod')
| -rw-r--r-- | pod/perlmroapi.pod | 14 |
1 files changed, 8 insertions, 6 deletions
diff --git a/pod/perlmroapi.pod b/pod/perlmroapi.pod index f010b75449..74bd9b2a77 100644 --- a/pod/perlmroapi.pod +++ b/pod/perlmroapi.pod @@ -55,12 +55,14 @@ depth if it needs to recurse. The function should return a reference to an array containing the parent classes in order. The names of the classes should be the result of calling -C<HvENAME()> on the stash. The caller is responsible for incrementing the -reference count of the array returned if it wants to keep the structure. -Hence, if you have created a temporary value that you keep no pointer to, -C<sv_2mortal()> to ensure that it is disposed of correctly. If you have -cached your return value, then return a pointer to it without changing the -reference count. +C<HvENAME()> on the stash. In those cases where C<HvENAME()> returns null, +C<HvNAME()> should be used instead. + +The caller is responsible for incrementing the reference count of the array +returned if it wants to keep the structure. Hence, if you have created a +temporary value that you keep no pointer to, C<sv_2mortal()> to ensure that +it is disposed of correctly. If you have cached your return value, then +return a pointer to it without changing the reference count. =head1 Caching |