Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Removed some spurios biindex calls. 

Added description of file.truncate().
Added warning to write() about buffering.
This commit is contained in:
Guido van Rossum 1996-05-02 15:28:53 +00:00
parent 59b328e11e
commit 316a430098
2 changed files with 22 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
Doc/lib/libtypes.tex
View File

@ -639,9 +639,6 @@ built-in functions and methods, e.g.\ \code{posix.popen()} and
\code{posix.fdopen()} and the \code{makefile()} method of socket
objects.
\bifuncindex{open}
\bifuncindex{popen}
\bifuncindex{fdopen}
\bifuncindex{makefile}
When a file operation fails for an I/O-related reason, the exception
\code{IOError} is raised. This includes situations where the
@ -712,8 +709,18 @@ Files have the following methods:
Return the file's current position, like \code{stdio}'s \code{ftell()}.
\end{funcdesc}
\begin{funcdesc}{truncate}{\optional{size}}
Truncate the file's size. If the optional size argument present, the
file is truncated to (at most) that size. The size defaults to the
current position. Availability of this function depends on the
operating system version (e.g., not all {\UNIX} versions support this
operation).
\end{funcdesc}
\begin{funcdesc}{write}{str}
Write a string to the file. There is no return value.
Write a string to the file. There is no return value. Note: due to
buffering, the string may not actually show up in the file until
the \code{flush()} or \code{close()} method is called.
\end{funcdesc}
\begin{funcdesc}{writelines}{list}

15
Doc/libtypes.tex
View File

@ -639,9 +639,6 @@ built-in functions and methods, e.g.\ \code{posix.popen()} and
\code{posix.fdopen()} and the \code{makefile()} method of socket
objects.
\bifuncindex{open}
\bifuncindex{popen}
\bifuncindex{fdopen}
\bifuncindex{makefile}
When a file operation fails for an I/O-related reason, the exception
\code{IOError} is raised. This includes situations where the
@ -712,8 +709,18 @@ Files have the following methods:
Return the file's current position, like \code{stdio}'s \code{ftell()}.
\end{funcdesc}
\begin{funcdesc}{truncate}{\optional{size}}
Truncate the file's size. If the optional size argument present, the
file is truncated to (at most) that size. The size defaults to the
current position. Availability of this function depends on the
operating system version (e.g., not all {\UNIX} versions support this
operation).
\end{funcdesc}
\begin{funcdesc}{write}{str}
Write a string to the file. There is no return value.
Write a string to the file. There is no return value. Note: due to
buffering, the string may not actually show up in the file until
the \code{flush()} or \code{close()} method is called.
\end{funcdesc}
\begin{funcdesc}{writelines}{list}