[Python-checkins] r54739 - peps/trunk/pep-3116.txt

[guido.van.rossum]

Author: guido.van.rossum
Date: Tue Apr 10 22:58:53 2007
New Revision: 54739

Modified:
   peps/trunk/pep-3116.txt
Log:
Like seek(), truncate() always returns the new current position.
All write() methods return the number of bytes/characters written
(for buffered and text files, this is always the lenth of the input).


Modified: peps/trunk/pep-3116.txt
==============================================================================
--- peps/trunk/pep-3116.txt	(original)
+++ peps/trunk/pep-3116.txt	Tue Apr 10 22:58:53 2007
@@ -86,7 +86,7 @@
 
     ``.tell() -> int``
 
-    ``.truncate(n: int = None) -> None``
+    ``.truncate(n: int = None) -> int``
 
     ``.close() -> None``
 
@@ -162,17 +162,17 @@
 
     ``.readinto(b: bytes) -> int``
 
-    ``.write(b: bytes) -> None``
+    ``.write(b: bytes) -> int``
 
        Write ``b`` bytes to the buffer.  The bytes are not guaranteed to
        be written to the Raw I/O object immediately; they may be
-       buffered.
+       buffered.  Returns ``len(b)``.
 
     ``.seek(pos: int, whence: int = 0) -> int``
 
     ``.tell() -> int``
 
-    ``.truncate(pos: int = None) -> None``
+    ``.truncate(pos: int = None) -> int``
 
     ``.flush() -> None``
 
@@ -275,7 +275,7 @@
 
     ``.read(n: int = -1) -> str``
 
-    ``.write(s: str) -> None``
+    ``.write(s: str) -> int``
 
     ``.tell() -> object``
 
@@ -288,7 +288,7 @@
         Seek to position ``pos``.  If ``pos`` is non-zero, it must
         be a cookie returned from ``.tell()`` and ``whence`` must be zero.
 
-    ``.truncate(pos: object = None) -> None``
+    ``.truncate(pos: object = None) -> int``
 
         Like ``BufferedIOBase.truncate()``, except that ``pos`` (if
         not ``None``) must be a cookie previously returned by ``.tell()``.