diff options
| author | Guido van Rossum <guido@python.org> | 1994-06-23 12:14:07 (GMT) |
|---|---|---|
| committer | Guido van Rossum <guido@python.org> | 1994-06-23 12:14:07 (GMT) |
| commit | 8b605eb06a51566f8a77072bfd706b4953f4a201 (patch) | |
| tree | fe022613cb6717623a21825aaec6cc0103d4fa00 | |
| parent | a84ec5196566646667947841413713ec031d7387 (diff) | |
| download | cpython-8b605eb06a51566f8a77072bfd706b4953f4a201.zip cpython-8b605eb06a51566f8a77072bfd706b4953f4a201.tar.gz cpython-8b605eb06a51566f8a77072bfd706b4953f4a201.tar.bz2 | |
documented writelines()
| -rw-r--r-- | Doc/lib/libtypes.tex | 15 | ||||
| -rw-r--r-- | Doc/libtypes.tex | 15 |
2 files changed, 24 insertions, 6 deletions
diff --git a/Doc/lib/libtypes.tex b/Doc/lib/libtypes.tex index 5fde9d0..b5dadaf 100644 --- a/Doc/lib/libtypes.tex +++ b/Doc/lib/libtypes.tex @@ -294,9 +294,12 @@ operator (modulo) with a string left argument interprets this string as a C sprintf format string to be applied to the right argument, and returns the string resulting from this formatting operation. -Unless the format string requires exactly one argument, the right -argument should be a tuple of the correct size. The following format -characters are understood: \%, c, s, i, d, u, o, x, X, e, E, f, g, G. +The right argument should be a tuple with one item for each argument +required by the format string; if the string requires a single +argument, the right argument may also be a single non-tuple object.% +\footnote{A tuple object in this case should be a singleton.} +The following format characters are understood: +\%, c, s, i, d, u, o, x, X, e, E, f, g, G. Width and precision may be a * to specify that an integer argument specifies the actual width or precision. The flag characters -, +, blank, \# and 0 are understood. The size specifiers h, l or L may be @@ -605,6 +608,12 @@ Files have the following methods: Write a string to the file. There is no return value. \end{funcdesc} +\begin{funcdesc}{writelines}{list} +Write a list of strings to the file. There is no return value. +(The name is intended to match \code{readlines}; \code{writelines} +does not add line separators.) +\end{funcdesc} + \subsubsection{Internal Objects.} (See the Python Reference Manual for these.) diff --git a/Doc/libtypes.tex b/Doc/libtypes.tex index 5fde9d0..b5dadaf 100644 --- a/Doc/libtypes.tex +++ b/Doc/libtypes.tex @@ -294,9 +294,12 @@ operator (modulo) with a string left argument interprets this string as a C sprintf format string to be applied to the right argument, and returns the string resulting from this formatting operation. -Unless the format string requires exactly one argument, the right -argument should be a tuple of the correct size. The following format -characters are understood: \%, c, s, i, d, u, o, x, X, e, E, f, g, G. +The right argument should be a tuple with one item for each argument +required by the format string; if the string requires a single +argument, the right argument may also be a single non-tuple object.% +\footnote{A tuple object in this case should be a singleton.} +The following format characters are understood: +\%, c, s, i, d, u, o, x, X, e, E, f, g, G. Width and precision may be a * to specify that an integer argument specifies the actual width or precision. The flag characters -, +, blank, \# and 0 are understood. The size specifiers h, l or L may be @@ -605,6 +608,12 @@ Files have the following methods: Write a string to the file. There is no return value. \end{funcdesc} +\begin{funcdesc}{writelines}{list} +Write a list of strings to the file. There is no return value. +(The name is intended to match \code{readlines}; \code{writelines} +does not add line separators.) +\end{funcdesc} + \subsubsection{Internal Objects.} (See the Python Reference Manual for these.) |