traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Markup and nits.

This commit is contained in:
Raymond Hettinger 2003-02-21 01:45:34 +00:00
parent 785d0a37e5
commit 1b18ba49ab
1 changed files with 11 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
Doc/lib/libitertools.tex
View File

@ -18,14 +18,14 @@ avoid the readability and reliability problems which arise when many
different individuals create their own slightly varying implementations, different individuals create their own slightly varying implementations,
each with their own quirks and naming conventions. each with their own quirks and naming conventions.
The tools are designed to combine readily with each another. This makes The tools are designed to combine readily with one another. This makes
it easy to construct more specialized tools succinctly and efficiently it easy to construct more specialized tools succinctly and efficiently
in pure Python. in pure Python.
For instance, SML provides a tabulation tool: \code{tabulate(\var{f})} For instance, SML provides a tabulation tool: \code{tabulate(f)}
which produces a sequence \code{f(0), f(1), ...}. This toolbox which produces a sequence \code{f(0), f(1), ...}. This toolbox
provides \function{imap()} and \function{count()} which can be combined provides \function{imap()} and \function{count()} which can be combined
to form \code{imap(\var{f}, count())} and produce an equivalent result. to form \code{imap(f, count())} and produce an equivalent result.
Whether cast in pure python form or C code, tools that use iterators Whether cast in pure python form or C code, tools that use iterators
are more memory efficient (and faster) than their list based counterparts. are more memory efficient (and faster) than their list based counterparts.
@ -75,10 +75,9 @@ by functions or loops that truncate the stream.
\begin{verbatim} \begin{verbatim}
def count(n=0): def count(n=0):
cnt = n
while True: while True:
yield cnt yield n
cnt += 1 n += 1
\end{verbatim} \end{verbatim}
Note, \function{count()} does not check for overflow and will return Note, \function{count()} does not check for overflow and will return
@ -208,16 +207,16 @@ by functions or loops that truncate the stream.
\end{verbatim} \end{verbatim}
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{repeat}{obj} \begin{funcdesc}{repeat}{object}
Make an iterator that returns \var{obj} over and over again. Make an iterator that returns \var{object} over and over again.
Used as argument to \function{imap()} for invariant parameters Used as argument to \function{imap()} for invariant parameters
to the called function. Also used with function{izip()} to create to the called function. Also used with \function{izip()} to create
an invariant part of a tuple record. Equivalent to: an invariant part of a tuple record. Equivalent to:
\begin{verbatim} \begin{verbatim}
def repeat(x): def repeat(object):
while True: while True:
yield x yield object
\end{verbatim} \end{verbatim}
\end{funcdesc} \end{funcdesc}
@ -226,7 +225,7 @@ by functions or loops that truncate the stream.
obtained from the iterable. Used instead of \function{imap()} when obtained from the iterable. Used instead of \function{imap()} when
argument parameters are already grouped in tuples from a single iterable argument parameters are already grouped in tuples from a single iterable
(the data has been ``pre-zipped''). The difference between (the data has been ``pre-zipped''). The difference between
\function{imap()} and \function{starmap} parallels the distinction \function{imap()} and \function{starmap()} parallels the distinction
between \code{function(a,b)} and \code{function(*c)}. between \code{function(a,b)} and \code{function(*c)}.
Equivalent to: Equivalent to: