mirrors
/
cpython
mirror of https://github.com/python/cpython.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

add warning about strop

This commit is contained in:
Guido van Rossum 1995-03-02 12:37:30 +00:00
parent dc46c7f734
commit 0bf4d892eb
2 changed files with 30 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
Doc/lib/libstring.tex
View File

@ -3,8 +3,11 @@
\stmodindex{string} \stmodindex{string}
This module defines some constants useful for checking character This module defines some constants useful for checking character
classes, some exceptions, and some useful string functions. classes and some useful string functions. See the modules
The constants are: \code{regex} and \code{regsub} for string functions based on regular
expressions.
The constants defined in this module are are:
\renewcommand{\indexsubitem}{(data in module string)} \renewcommand{\indexsubitem}{(data in module string)}
\begin{datadesc}{digits} \begin{datadesc}{digits}
@ -48,11 +51,7 @@ The constants are:
undefined. undefined.
\end{datadesc} \end{datadesc}
The exceptions are: The functions defined in this module are:
\renewcommand{\indexsubitem}{(exception in module string)}
The functions are:
\renewcommand{\indexsubitem}{(in module string)} \renewcommand{\indexsubitem}{(in module string)}
@ -169,3 +168,12 @@ The string is never truncated.
Pad a numeric string on the left with zero digits until the given Pad a numeric string on the left with zero digits until the given
width is reached. Strings starting with a sign are handled correctly. width is reached. Strings starting with a sign are handled correctly.
\end{funcdesc} \end{funcdesc}
This module is implemented in Python. Much of its functionality has
been reimplemented in the built-in module \code{strop}. However, you
should \emph{never} import the latter module directly. When
\code{string} discovers that \code{strop} exists, it transparently
replaces parts of itself with the implementation from \code{strop}.
After initialization, there is \emph{no} overhead in using
\code{string} instead of \code{strop}.
\bimodindex{strop}

22
Doc/libstring.tex
View File

@ -3,8 +3,11 @@
\stmodindex{string} \stmodindex{string}
This module defines some constants useful for checking character This module defines some constants useful for checking character
classes, some exceptions, and some useful string functions. classes and some useful string functions. See the modules
The constants are: \code{regex} and \code{regsub} for string functions based on regular
expressions.
The constants defined in this module are are:
\renewcommand{\indexsubitem}{(data in module string)} \renewcommand{\indexsubitem}{(data in module string)}
\begin{datadesc}{digits} \begin{datadesc}{digits}
@ -48,11 +51,7 @@ The constants are:
undefined. undefined.
\end{datadesc} \end{datadesc}
The exceptions are: The functions defined in this module are:
\renewcommand{\indexsubitem}{(exception in module string)}
The functions are:
\renewcommand{\indexsubitem}{(in module string)} \renewcommand{\indexsubitem}{(in module string)}
@ -169,3 +168,12 @@ The string is never truncated.
Pad a numeric string on the left with zero digits until the given Pad a numeric string on the left with zero digits until the given
width is reached. Strings starting with a sign are handled correctly. width is reached. Strings starting with a sign are handled correctly.
\end{funcdesc} \end{funcdesc}
This module is implemented in Python. Much of its functionality has
been reimplemented in the built-in module \code{strop}. However, you
should \emph{never} import the latter module directly. When
\code{string} discovers that \code{strop} exists, it transparently
replaces parts of itself with the implementation from \code{strop}.
After initialization, there is \emph{no} overhead in using
\code{string} instead of \code{strop}.
\bimodindex{strop}