develooper Front page | perl.perl5.porters | Postings from January 2012

[perl #47948] [documentation] Hash::Util::FieldHash

Thread Next
From:
James E Keenan via RT
Date:
January 12, 2012 17:05
Subject:
[perl #47948] [documentation] Hash::Util::FieldHash
Message ID:
rt-3.6.HEAD-14510-1326416715-1347.47948-15-0@perl.org
On Thu Nov 29 02:44:21 2007, A_M_C@bigpond.net.au wrote:

> -----------------------------------------------------------------
> In the documentation for Hash::Util::FieldHash, the section
> Garbage-Collected Hashes says that deleting a key whilst iterating
> through the hash will cause bad things to happen (I paraphrase). This
> is
> at variance with a recent posting by Mark Dominus at
> http://blog.plover.com/ where he says that adding keys will cause
> unpredictable behaviour but deleting keys will not. In fact a fair bit
> of trouble was taken Larry Wall to make sure it doesn't.
> 
> Assuming MJD is correct and the implementation of hashes in 5.10.0
> hasn't changed this behaviour (it was current at 5.8.8) the
> documentation should warn about *creating* objects whilst iterating
> over
> fields.
> 

I am attaching the relevant section of the POD for Hash::Util::FieldHash
as it appears in Perl 5.14.2.

p5p list:  Does the OP's contention about the documentation have merit?
 If so, what is to be done?

Thank you very much.
Jim Keenan

---
via perlbug:  queue: perl5 status: new
https://rt.perl.org:443/rt3/Ticket/Display.html?id=47948

Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About