From: Chris Jerdonek Date: Wed, 14 Nov 2012 10:13:28 +0000 (-0800) Subject: Link to "XRange Type" section in xrange() built-in function documentation. X-Git-Tag: v2.7.4rc1~378 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9e173ebde29fa3586c94d5bf0570547bca851ea9;p=thirdparty%2FPython%2Fcpython.git Link to "XRange Type" section in xrange() built-in function documentation. --- diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index 0d4f912ed99e..5082479a8f60 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1523,14 +1523,16 @@ available. They are listed here in alphabetical order. .. function:: xrange(stop) xrange(start, stop[, step]) - This function is very similar to :func:`range`, but returns an "xrange object" + This function is very similar to :func:`range`, but returns an :ref:`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 :func:`xrange` over :func:`range` is minimal (since :func:`xrange` still has to create the values when asked for them) except when a very large range is used on a memory-starved machine or when all of the range's elements are never used (such as when the loop is usually terminated with - :keyword:`break`). + :keyword:`break`). For more information on xrange objects, see + :ref:`typesseq-xrange` and :ref:`typesseq`. .. impl-detail::