Lannert <lannert@uni-duesseldorf.de>.
of items with expensive comparison operations, this can be an
improvement over the more common approach. The module is called
\module{bisect} because it uses a basic bisection algorithm to do its
-work. The source code may be used a useful reference for a working
-example of the algorithm (i.e., the boundary conditions are already
-right!).
+work. The source code may be most useful as a working example of the
+algorithm (i.e., the boundary conditions are already right!).
The following functions are provided:
The \code{locale} module opens access to the \POSIX{} locale database
-and functionality. The \POSIX{} locale mechanism allows applications
-to integrate certain cultural aspects into an applications, without
+and functionality. The \POSIX{} locale mechanism allows programmers
+to deal with certain cultural issues in an application, without
requiring the programmer to know all the specifics of each country
where the software is executed.
characteristics, and then restore the \samp{C} numeric locale.
When Python code uses the \module{locale} module to change the locale,
-this also affect the embedding application. If the embedding
+this also affects the embedding application. If the embedding
application doesn't want this to happen, it should remove the
\module{_locale} extension module (which does all the work) from the
table of built-in modules in the \file{config.c} file, and make sure
unchanged.
\end{funcdesc}
-\begin{funcdesc}{getsize}{path}
-Return the size, in bytes, of \var{filename}. Raise
-\exception{os.error} if the file does not exist or is inaccessible.
+\begin{funcdesc}{getatime}{path}
+Return the time of last access of \var{filename}. The return
+value is integer giving the number of seconds since the epoch (see the
+\refmodule{time} module). Raise \exception{os.error} if the file does
+not exist or is inaccessible.
\versionadded{1.5.2}
\end{funcdesc}
\versionadded{1.5.2}
\end{funcdesc}
-\begin{funcdesc}{getatime}{path}
-Return the time of last access of \var{filename}. The return
-value is integer giving the number of seconds since the epoch (see the
-\refmodule{time} module). Raise \exception{os.error} if the file does
-not exist or is inaccessible.
+\begin{funcdesc}{getsize}{path}
+Return the size, in bytes, of \var{filename}. Raise
+\exception{os.error} if the file does not exist or is inaccessible.
\versionadded{1.5.2}
\end{funcdesc}
\end{funcdesc}
\begin{funcdesc}{setlogmask}{maskpri}
-This function set the priority mask to \var{maskpri} and returns the
+Set the priority mask to \var{maskpri} and return the
previous mask value. Calls to \function{syslog()} with a priority
level not set in \var{maskpri} are ignored. The default is to log all
priorities. The function \code{LOG_MASK(\var{pri})} calculates the
to and including \var{pri}.
\end{funcdesc}
+
The module defines the following constants:
\begin{description}
integer; this variable is initialized to \code{1} unless the
environment variable \envvar{PYTHONY2K} is set to a non-empty string,
in which case it is initialized to \code{0}. Thus, you can set
-\envvar{PYTHONY2K} in the environment to \code{x} to require 4-digit
+\envvar{PYTHONY2K} to a non-empty string in the environment to require 4-digit
years for all year input. When 2-digit years are accepted, they are
converted according to the \POSIX{} or X/Open standard: values 69-99
are mapped to 1969-1999, and values 0--68 are mapped to 2000--2068.
program-specific customization file.
Programs with security or privacy concerns should \emph{not} import
-this module; a user can easily break into a a program by placing
+this module; a user can easily break into a program by placing
arbitrary code in the \file{.pythonrc.py} file.
Modules for general use should \emph{not} import this module; it may
\begin{methoddesc}{translate_references}{data}
Translate all entity and character references in \var{data} and
-returns the translated string.
+return the translated string.
\end{methoddesc}
\begin{methoddesc}{handle_xml}{encoding, standalone}