From: Guido van Rossum <guido@python.org>
Date: Tue, 8 Aug 2000 16:15:49 +0000 (+0000)
Subject: Barry's patch to document the new setdefault() method.  Slightly
X-Git-Tag: v2.0b1~537
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8141cf5c76a1a47ccacc14aa4594fcc89499799a;p=thirdparty%2FPython%2Fcpython.git

Barry's patch to document the new setdefault() method.  Slightly
clarified the summary for default() in the table to indicate the side
effect.
---

diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex
index 842b23ba08a9..3adfc6e4d9b2 100644
--- a/Doc/lib/libstdtypes.tex
+++ b/Doc/lib/libstdtypes.tex
@@ -591,6 +591,10 @@ arbitrary objects):
           {\code{\var{a}[\var{k}]} if \code{\var{a}.has_key(\var{k})},
            else \var{x}}
           {(4)}
+  \lineiii{\var{a}.setdefault(\var{k}\optional{, \var{x}})}
+          {\code{\var{a}[\var{k}]} if \code{\var{a}.has_key(\var{k})},
+           else \var{x} (also setting it)}
+          {(5)}
 \end{tableiii}
 
 \noindent
@@ -611,6 +615,10 @@ correspond.  This allows the creation of \code{(\var{value},
 \item[(4)] Never raises an exception if \var{k} is not in the map,
 instead it returns \var{x}.  \var{x} is optional; when \var{x} is not
 provided and \var{k} is not in the map, \code{None} is returned.
+
+\item[(5)] \function{setdefault()} is like \function{get()}, except
+that if \var{k} is missing, \var{x} is both returned and inserted into
+the dictionary as the value of \var{k}.
 \end{description}