mirror of https://github.com/python/cpython.git
52 lines
1.4 KiB
TeX
52 lines
1.4 KiB
TeX
|
\section{\module{fpformat} ---
|
||
|
|
Floating point conversions}
|
||
|
|
|
||
|
|
\declaremodule{standard}{fpformat}
|
||
|
|
\sectionauthor{Moshe Zadka}{mzadka@geocities.com}
|
||
|
|
\modulesynopsis{General floating point formatting functions.}
|
||
|
|
|
||
|
|
|
||
|
|
The \module{fpformat} module defines functions for dealing with
|
||
|
|
floating point numbers representations in 100\% pure
|
||
|
|
Python. \strong{Note:} This module is unneeded: everything here could
|
||
|
|
be done via the \code{\%} string interpolation operator.
|
||
|
|
|
||
|
|
The \module{fpformat} module defines the following functions and an
|
||
|
|
exception:
|
||
|
|
|
||
|
|
|
||
|
|
\begin{funcdesc}{fix}{x, digs}
|
||
|
|
Format \var{x} as \code{[-]ddd.ddd} with \var{digs} digits after the
|
||
|
|
point and at least one digit before.
|
||
|
|
If \code{\var{digs} <= 0}, the decimal point is suppressed.
|
||
|
|
|
||
|
|
\var{x} can be either a number or a string that looks like
|
||
|
|
one. \var{digs} is an integer.
|
||
|
|
|
||
|
|
Return value is a string.
|
||
|
|
\end{funcdesc}
|
||
|
|
|
||
|
|
\begin{funcdesc}{sci}{x, digs}
|
||
|
|
Format \var{x} as \code{[-]d.dddE[+-]ddd} with \var{digs} digits after the
|
||
|
|
point and exactly one digit before.
|
||
|
|
If \code{\var{digs} <= 0}, one digit is kept and the point is suppressed.
|
||
|
|
|
||
|
|
\var{x} can be either a real number, or a string that looks like
|
||
|
|
one. \var{digs} is an integer.
|
||
|
|
|
||
|
|
Return value is a string.
|
||
|
|
\end{funcdesc}
|
||
|
|
|
||
|
|
\begin{excdesc}{NotANumber}
|
||
|
|
Exception raised when a string does not look like a number when the
|
||
|
|
documentation says it should.
|
||
|
|
\end{excdesc}
|
||
|
|
|
||
|
|
Example:
|
||
|
|
|
||
|
|
\begin{verbatim}
|
||
|
|
>>> import fpformat
|
||
|
|
>>> fpformat.fix(1.23, 1)
|
||
|
|
'1.2'
|
||
|
|
\end{verbatim}
|