diff options
| -rw-r--r-- | Doc/lib/libfuncs.tex | 12 | ||||
| -rw-r--r-- | Doc/libfuncs.tex | 12 |
2 files changed, 24 insertions, 0 deletions
diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex index e0b36f3..73bc145 100644 --- a/Doc/lib/libfuncs.tex +++ b/Doc/lib/libfuncs.tex @@ -354,3 +354,15 @@ its goal is to return a printable string. >>> if type(x) == type(''): print 'It is a string' \end{verbatim}\ecode \end{funcdesc} + +\begin{funcdesc}{xrange}{start\, end\, step} +This function is very similar to \code{range()}, but returns an +``xrange object'' instead of a list. This is an opaque sequence type +which yields the same values as the corresponding list, without +actually storing them all simultaneously. The advantage of +\code{xrange()} over \code{range()} is minimal (since \code{xrange()} +still has to create the values when asked for them) except when a very +large range is used on a memory-starved machine (e.g. DOS) or when all +of the range's elements are never used (e.g. when the loop is usually +terminated with \code{break}). +\end{funcdesc} diff --git a/Doc/libfuncs.tex b/Doc/libfuncs.tex index e0b36f3..73bc145 100644 --- a/Doc/libfuncs.tex +++ b/Doc/libfuncs.tex @@ -354,3 +354,15 @@ its goal is to return a printable string. >>> if type(x) == type(''): print 'It is a string' \end{verbatim}\ecode \end{funcdesc} + +\begin{funcdesc}{xrange}{start\, end\, step} +This function is very similar to \code{range()}, but returns an +``xrange object'' instead of a list. This is an opaque sequence type +which yields the same values as the corresponding list, without +actually storing them all simultaneously. The advantage of +\code{xrange()} over \code{range()} is minimal (since \code{xrange()} +still has to create the values when asked for them) except when a very +large range is used on a memory-starved machine (e.g. DOS) or when all +of the range's elements are never used (e.g. when the loop is usually +terminated with \code{break}). +\end{funcdesc} |