Mercurial > cpython-lru_cache-weakref
diff Doc/lib/libtypes.tex @ 5808:dffd22146aab legacy-trunk
Added fileno(); added readlines(sizehint).
AMK's sed job.
| author | Guido van Rossum <guido@python.org> |
|---|---|
| date | Thu, 17 Jul 1997 16:05:47 +0000 |
| parents | e5de707300e1 |
| children | 4d55bfe1febb |
line wrap: on
line diff
--- a/Doc/lib/libtypes.tex Thu Jul 17 15:58:43 1997 +0000 +++ b/Doc/lib/libtypes.tex Thu Jul 17 16:05:47 1997 +0000 @@ -405,13 +405,13 @@ the formats in the string must have a parenthesized key into that dictionary inserted immediately after the \code{\%} character, and each format formats the corresponding entry from the mapping. E.g. -\begin{verbatim} - >>> count = 2 - >>> language = 'Python' - >>> print '%(language)s has %(count)03d quote types.' % vars() - Python has 002 quote types. - >>> -\end{verbatim} +\bcode\begin{verbatim} +>>> count = 2 +>>> language = 'Python' +>>> print '%(language)s has %(count)03d quote types.' % vars() +Python has 002 quote types. +>>> +\end{verbatim}\ecode In this case no * specifiers may occur in a format (since they require a sequential parameter list). @@ -685,6 +685,13 @@ \code{0}. \end{funcdesc} +\begin{funcdesc}{fileno}{} +Return the integer ``file descriptor'' that is used by the underlying +implementation to request I/O operations from the operating system. +This can be useful for other, lower level interfaces that use file +descriptors, e.g. module \code{fcntl} or \code{os.read} and friends. +\end{funcdesc} + \begin{funcdesc}{read}{\optional{size}} Read at most \var{size} bytes from the file (less if the read hits \EOF{} or no more data is immediately available on a pipe, tty or @@ -714,9 +721,11 @@ input. \end{funcdesc} -\begin{funcdesc}{readlines}{} +\begin{funcdesc}{readlines}{\optional{sizehint}} Read until \EOF{} using \code{readline()} and return a list containing - the lines thus read. + the lines thus read. If the optional \var{bufferhint} argument is + present, instead of reading up to \EOF{}, whole lines totalling + approximately \var{sizehint} bytes are read. \end{funcdesc} \begin{funcdesc}{seek}{offset\, whence} @@ -751,6 +760,12 @@ does not add line separators.) \end{funcdesc} +Classes that are trying to simulate a file object should also have a +writable \code{softspace} attribute, which should be initialized to +zero. (\code{softspace} is used by the \code{print} statement.) This +will be automatic for classes implemented in Python; types implemented +in C will have to provide a writable \code{softspace} attribute. + \subsubsection{Internal Objects} (See the Python Reference Manual for these.)
