diff options
| author | SynaptiCAD, Inc. <sales@syncad.com> | 1998-05-02 12:29:22 -0400 |
|---|---|---|
| committer | Gurusamy Sarathy <gsar@cpan.org> | 1998-05-03 18:44:38 +0000 |
| commit | c6601927a584c0fd18d5a6bb3b4c95cff46a2c6a (patch) | |
| tree | 4fc5a886d98f21577629597c6221d7e7060684c3 /pod/perlguts.pod | |
| parent | 9f699bd937481e601436dfa5b4c405c05ed9188f (diff) | |
| download | perl-c6601927a584c0fd18d5a6bb3b4c95cff46a2c6a.tar.gz | |
[win32] make hv_iterinit() return HvKEYS()
Message-Id: <3.0.1.32.19980502162922.009e6320@www.syncad.com>
Subject: incorrect return value for hv_iterinit
p4raw-id: //depot/win32/perl@914
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 |