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

Document the range type, as suggested by Denis S. Otkidach 

<den@analyt.chem.msu.ru>.
This commit is contained in:
Fred Drake 2000-08-14 15:37:59 +00:00
parent b7520774e2
commit 107b9679c4
1 changed files with 24 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
Doc/lib/libstdtypes.tex
View File

@ -312,8 +312,8 @@ division by \code{pow(2, \var{n})} without overflow check.
\subsection{Sequence Types \label{typesseq}} \subsection{Sequence Types \label{typesseq}}
There are five sequence types: strings, Unicode strings, lists, There are six sequence types: strings, Unicode strings, lists,
tuples, and buffers. tuples, buffers, and ranges.
Strings literals are written in single or double quotes: Strings literals are written in single or double quotes:
\code{'xyzzy'}, \code{"frobozz"}. See chapter 2 of the \code{'xyzzy'}, \code{"frobozz"}. See chapter 2 of the
@ -327,7 +327,10 @@ or without enclosing parentheses, but an empty tuple must have the
enclosing parentheses, e.g., \code{a, b, c} or \code{()}. A single enclosing parentheses, e.g., \code{a, b, c} or \code{()}. A single
item tuple must have a trailing comma, e.g., \code{(d,)}. Buffers are item tuple must have a trailing comma, e.g., \code{(d,)}. Buffers are
not directly support by Python syntax, but can created by calling the not directly support by Python syntax, but can created by calling the
builtin function \function{buffer()}.\bifuncindex{buffer} builtin function \function{buffer()}.\bifuncindex{buffer} Ranges are
similar to buffers in that there is no specific syntax to create them,
but they are created using the \function{xrange()}
function.\bifuncindex{xrange}
\indexii{sequence}{types} \indexii{sequence}{types}
\indexii{string}{type} \indexii{string}{type}
\indexii{Unicode}{type} \indexii{Unicode}{type}
@ -630,10 +633,27 @@ In this case no \code{*} specifiers may occur in a format (since they
require a sequential parameter list). require a sequential parameter list).
Additional string operations are defined in standard module Additional string operations are defined in standard module
\module{string} and in built-in module \module{re}. \refmodule{string} and in built-in module \refmodule{re}.
\refstmodindex{string} \refstmodindex{string}
\refstmodindex{re} \refstmodindex{re}
\subsubsection{Range Type \label{typesseq-range}}
The range\indexii{range}{type} type is an immutable sequence which is
commonly used for looping. The advantage of the range type is that a
range object will always take the same amount of memory, no matter the
size of the range it represents. There are no consistent performance
advantages.
Range objects behave like tuples, and offer a single method:
\begin{methoddesc}[range]{tolist}{}
Return a list object which represents the same values as the range
object.
\end{methoddesc}
\subsubsection{Mutable Sequence Types \label{typesseq-mutable}} \subsubsection{Mutable Sequence Types \label{typesseq-mutable}}
List objects support additional operations that allow in-place List objects support additional operations that allow in-place