diff options
author | Fred Drake <fdrake@acm.org> | 2001-12-26 20:06:40 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2001-12-26 20:06:40 (GMT) |
commit | ab2dc1d73060cae4ae78727b3c7b58fa5442ec36 (patch) | |
tree | 4a63f33b37218c6b9b44d83dceb7d2e0935bdbd4 /Doc/lib | |
parent | 3d422662ad7f2783b5864704e233d717500efd6f (diff) | |
download | cpython-ab2dc1d73060cae4ae78727b3c7b58fa5442ec36.zip cpython-ab2dc1d73060cae4ae78727b3c7b58fa5442ec36.tar.gz cpython-ab2dc1d73060cae4ae78727b3c7b58fa5442ec36.tar.bz2 |
Added index entries similar to some recommended by Skip, and used the word
"interpolation" in the text, to make the string formatting material easier to
find.
This closes SF bug #487165.
Bugfix: this should be applied for Python 2.2.1.
Diffstat (limited to 'Doc/lib')
-rw-r--r-- | Doc/lib/libstdtypes.tex | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex index a92928e..2ba87c4 100644 --- a/Doc/lib/libstdtypes.tex +++ b/Doc/lib/libstdtypes.tex @@ -681,20 +681,24 @@ Return a copy of the string converted to uppercase. \subsubsection{String Formatting Operations \label{typesseq-strings}} \index{formatting, string (\%{})} +\index{interpolation, string (\%{})} \index{string!formatting} +\index{string!interpolation} \index{printf-style formatting} \index{sprintf-style formatting} \index{\protect\%{} formatting} +\index{\protect\%{} interpolation} String and Unicode objects have one unique built-in operation: the -\code{\%} operator (modulo). Given \code{\var{format} \% -\var{values}} (where \var{format} is a string or Unicode object), -\code{\%} conversion specifications in \var{format} are replaced with -zero or more elements of \var{values}. The effect is similar to the -using \cfunction{sprintf()} in the C language. If \var{format} is a -Unicode object, or if any of the objects being converted using the -\code{\%s} conversion are Unicode objects, the result will be a -Unicode object as well. +\code{\%} operator (modulo). This is also known as the string +\emph{formatting} or \emph{interpolation} operator. Given +\code{\var{format} \% \var{values}} (where \var{format} is a string or +Unicode object), \code{\%} conversion specifications in \var{format} +are replaced with zero or more elements of \var{values}. The effect +is similar to the using \cfunction{sprintf()} in the C language. If +\var{format} is a Unicode object, or if any of the objects being +converted using the \code{\%s} conversion are Unicode objects, the +result will be a Unicode object as well. If \var{format} requires a single argument, \var{values} may be a single non-tuple object. \footnote{A tuple object in this case should |