diff options
Diffstat (limited to 'pod/perlguts.pod')
| -rw-r--r-- | pod/perlguts.pod | 11 |
1 files changed, 7 insertions, 4 deletions
diff --git a/pod/perlguts.pod b/pod/perlguts.pod index 9b7cab627e..83986c9f25 100644 --- a/pod/perlguts.pod +++ b/pod/perlguts.pod @@ -1888,10 +1888,13 @@ Prepares a starting point to traverse a hash table. I32 hv_iterinit (HV* tb) -Note that hv_iterinit I<currently> returns the number of I<buckets> in -the hash and I<not> the number of keys (as indicated in the Advanced -Perl Programming book). This may change in future. Use the HvKEYS(hv) -macro to find the number of keys in a hash. +Returns the number of keys in the hash (i.e. the same as C<HvKEYS(tb)>). +The return value is currently only meaningful for hashes without tie +magic. + +NOTE: Before version 5.004_65, C<hv_iterinit> used to return the number +of hash buckets that happen to be in use. If you still need that +esoteric value, you can get it through the macro C<HvFILL(tb)>. =item hv_iterkey |