1 \section{\module{fpformat
} ---
2 Floating point conversions
}
4 \declaremodule{standard
}{fpformat
}
5 \sectionauthor{Moshe Zadka
}{mzadka@geocities.com
}
6 \modulesynopsis{General floating point formatting functions.
}
9 The
\module{fpformat
} module defines functions for dealing with
10 floating point numbers representations in
100\% pure
11 Python.
\strong{Note:
} This module is unneeded: everything here could
12 be done via the
\code{\%
} string interpolation operator.
14 The
\module{fpformat
} module defines the following functions and an
18 \begin{funcdesc
}{fix
}{x, digs
}
19 Format
\var{x
} as
\code{[-
]ddd.ddd
} with
\var{digs
} digits after the
20 point and at least one digit before.
21 If
\code{\var{digs
} <=
0}, the decimal point is suppressed.
23 \var{x
} can be either a number or a string that looks like
24 one.
\var{digs
} is an integer.
26 Return value is a string.
29 \begin{funcdesc
}{sci
}{x, digs
}
30 Format
\var{x
} as
\code{[-
]d.dddE
[+-
]ddd
} with
\var{digs
} digits after the
31 point and exactly one digit before.
32 If
\code{\var{digs
} <=
0}, one digit is kept and the point is suppressed.
34 \var{x
} can be either a real number, or a string that looks like
35 one.
\var{digs
} is an integer.
37 Return value is a string.
40 \begin{excdesc
}{NotANumber
}
41 Exception raised when a string passed to
\function{fix()
} or
42 \function{sci()
} as the
\var{x
} parameter does not look like a number.
43 This is a subclass of
\exception{ValueError
} when the standard
44 exceptions are strings. The exception value is the improperly
45 formatted string that caused the exception to be raised.
52 >>> fpformat.fix(
1.23,
1)