diff Doc/lib/libstdtypes.tex @ 34029:81a1f754d32c legacy-trunk

Clarify the ordering of dictionary keys.
author Raymond Hettinger <python@rcn.com>
date Thu, 25 Nov 2004 05:16:19 +0000
parents 023801332395
children 43c00f0e6305
line wrap: on
line diff
--- a/Doc/lib/libstdtypes.tex	Thu Nov 25 04:47:09 2004 +0000
+++ b/Doc/lib/libstdtypes.tex	Thu Nov 25 05:16:19 2004 +0000
@@ -1367,8 +1367,10 @@
 
 \item[(2)] \versionadded{2.2}
 
-\item[(3)] Keys and values are listed in random order.  If
-\method{items()}, \method{keys()}, \method{values()},
+\item[(3)] Keys and values are listed in an arbitrary order which is
+non-random, varies across Python implementations, and depends on the
+dictionary's history of insertions and deletions.
+If \method{items()}, \method{keys()}, \method{values()},
 \method{iteritems()}, \method{iterkeys()}, and \method{itervalues()}
 are called with no intervening modifications to the dictionary, the
 lists will directly correspond.  This allows the creation of