ref: 2fe3b28f86ed4aa291fb8a620b948abe9c6a1f84
dir: /sys/src/cmd/python/Doc/lib/libfpformat.tex/
\section{\module{fpformat} --- Floating point conversions} \declaremodule{standard}{fpformat} \sectionauthor{Moshe Zadka}{[email protected]} \modulesynopsis{General floating point formatting functions.} The \module{fpformat} module defines functions for dealing with floating point numbers representations in 100\% pure Python. \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 passed to \function{fix()} or \function{sci()} as the \var{x} parameter does not look like a number. This is a subclass of \exception{ValueError} when the standard exceptions are strings. The exception value is the improperly formatted string that caused the exception to be raised. \end{excdesc} Example: \begin{verbatim} >>> import fpformat >>> fpformat.fix(1.23, 1) '1.2' \end{verbatim}