]> granicus.if.org Git - python/commitdiff
Merged revisions 70992,70995 via svnmerge from
authorBenjamin Peterson <benjamin@python.org>
Wed, 1 Apr 2009 21:22:20 +0000 (21:22 +0000)
committerBenjamin Peterson <benjamin@python.org>
Wed, 1 Apr 2009 21:22:20 +0000 (21:22 +0000)
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r70992 | georg.brandl | 2009-04-01 16:00:55 -0500 (Wed, 01 Apr 2009) | 1 line

  #4572: add SEEK_* values as constants in io.py.
........
  r70995 | benjamin.peterson | 2009-04-01 16:12:54 -0500 (Wed, 01 Apr 2009) | 1 line

  add seek constants to __all__
........

Doc/library/io.rst
Lib/io.py

index e06ab3fd89b8f519d8cee76a73dec1e4316f289e..9e4161a2336fa436caa842ceb31b5dcaf9b1a296 100644 (file)
@@ -270,12 +270,18 @@ I/O Base Classes
       interpreted relative to the position indicated by *whence*.  Values for
       *whence* are:
 
-      * ``0`` -- start of the stream (the default); *offset* should be zero or positive
-      * ``1`` -- current stream position; *offset* may be negative
-      * ``2`` -- end of the stream; *offset* is usually negative
+      * :data:`SEEK_SET` or ``0`` -- start of the stream (the default);
+        *offset* should be zero or positive
+      * :data:`SEEK_CUR` or ``1`` -- current stream position; *offset* may
+        be negative
+      * :data:`SEEK_END` or ``2`` -- end of the stream; *offset* is usually
+        negative
 
       Return the new absolute position.
 
+      .. versionadded:: 2.7
+         The ``SEEK_*`` constants
+
    .. method:: seekable()
 
       Return ``True`` if the stream supports random access.  If ``False``,
index 8a8cf699af63d1c9a8184ad8d5e0da4956cb70d5..56ceb58ce10d83fa38c2d6b0953f25794091d4fd 100644 (file)
--- a/Lib/io.py
+++ b/Lib/io.py
@@ -52,7 +52,8 @@ __author__ = ("Guido van Rossum <guido@python.org>, "
 __all__ = ["BlockingIOError", "open", "IOBase", "RawIOBase", "FileIO",
            "BytesIO", "StringIO", "BufferedIOBase",
            "BufferedReader", "BufferedWriter", "BufferedRWPair",
-           "BufferedRandom", "TextIOBase", "TextIOWrapper"]
+           "BufferedRandom", "TextIOBase", "TextIOWrapper",
+           "SEEK_SET", "SEEK_CUR", "SEEK_END"]
 
 
 import _io
@@ -65,6 +66,11 @@ from _io import (DEFAULT_BUFFER_SIZE, BlockingIOError, UnsupportedOperation,
 
 OpenWrapper = _io.open # for compatibility with _pyio
 
+# for seek()
+SEEK_SET = 0
+SEEK_CUR = 1
+SEEK_END = 2
+
 # Declaring ABCs in C is tricky so we do it here.
 # Method descriptions and default implementations are inherited from the C
 # version however.