# python – How to truncate float values?

## python – How to truncate float values?

``````round(1.923328437452, 3)
``````

See Pythons documentation on the standard types. Youll need to scroll down a bit to get to the round function. Essentially the second number says how many decimal places to round it to.

First, the function, for those who just want some copy-and-paste code:

``````def truncate(f, n):
Truncates/pads a float f to n decimal places without rounding
s = {}.format(f)
if e in s or E in s:
return {0:.{1}f}.format(f, n)
i, p, d = s.partition(.)
return ..join([i, (d+0*n)[:n]])
``````

This is valid in Python 2.7 and 3.1+. For older versions, its not possible to get the same intelligent rounding effect (at least, not without a lot of complicated code), but rounding to 12 decimal places before truncation will work much of the time:

``````def truncate(f, n):
Truncates/pads a float f to n decimal places without rounding
s = %.12f % f
i, p, d = s.partition(.)
return ..join([i, (d+0*n)[:n]])
``````

# Explanation

The core of the underlying method is to convert the value to a string at full precision and then just chop off everything beyond the desired number of characters. The latter step is easy; it can be done either with string manipulation

``````i, p, d = s.partition(.)
..join([i, (d+0*n)[:n]])
``````

or the `decimal` module

``````str(Decimal(s).quantize(Decimal((0, (1,), -n)), rounding=ROUND_DOWN))
``````

The first step, converting to a string, is quite difficult because there are some pairs of floating point literals (i.e. what you write in the source code) which both produce the same binary representation and yet should be truncated differently. For example, consider 0.3 and 0.29999999999999998. If you write `0.3` in a Python program, the compiler encodes it using the IEEE floating-point format into the sequence of bits (assuming a 64-bit float)

``````0011111111010011001100110011001100110011001100110011001100110011
``````

This is the closest value to 0.3 that can accurately be represented as an IEEE float. But if you write `0.29999999999999998` in a Python program, the compiler translates it into exactly the same value. In one case, you meant it to be truncated (to one digit) as `0.3`, whereas in the other case you meant it to be truncated as `0.2`, but Python can only give one answer. This is a fundamental limitation of Python, or indeed any programming language without lazy evaluation. The truncation function only has access to the binary value stored in the computers memory, not the string you actually typed into the source code.1

If you decode the sequence of bits back into a decimal number, again using the IEEE 64-bit floating-point format, you get

``````0.2999999999999999888977697537484345957637...
``````

so a naive implementation would come up with `0.2` even though thats probably not what you want. For more on floating-point representation error, see the Python tutorial.

Its very rare to be working with a floating-point value that is so close to a round number and yet is intentionally not equal to that round number. So when truncating, it probably makes sense to choose the nicest decimal representation out of all that could correspond to the value in memory. Python 2.7 and up (but not 3.0) includes a sophisticated algorithm to do just that, which we can access through the default string formatting operation.

``````{}.format(f)
``````

The only caveat is that this acts like a `g` format specification, in the sense that it uses exponential notation (`1.23e+4`) if the number is large or small enough. So the method has to catch this case and handle it differently. There are a few cases where using an `f` format specification instead causes a problem, such as trying to truncate `3e-10` to 28 digits of precision (it produces `0.0000000002999999999999999980`), and Im not yet sure how best to handle those.

If you actually are working with `float`s that are very close to round numbers but intentionally not equal to them (like 0.29999999999999998 or 99.959999999999994), this will produce some false positives, i.e. itll round numbers that you didnt want rounded. In that case the solution is to specify a fixed precision.

``````{0:.{1}f}.format(f, sys.float_info.dig + n + 2)
``````

The number of digits of precision to use here doesnt really matter, it only needs to be large enough to ensure that any rounding performed in the string conversion doesnt bump up the value to its nice decimal representation. I think `sys.float_info.dig + n + 2` may be enough in all cases, but if not that `2` might have to be increased, and it doesnt hurt to do so.

In earlier versions of Python (up to 2.6, or 3.0), the floating point number formatting was a lot more crude, and would regularly produce things like

``````>>> 1.1
1.1000000000000001
``````

If this is your situation, if you do want to use nice decimal representations for truncation, all you can do (as far as I know) is pick some number of digits, less than the full precision representable by a `float`, and round the number to that many digits before truncating it. A typical choice is 12,

``````%.12f % f
``````

but you can adjust this to suit the numbers youre using.

1Well… I lied. Technically, you can instruct Python to re-parse its own source code and extract the part corresponding to the first argument you pass to the truncation function. If that argument is a floating-point literal, you can just cut it off a certain number of places after the decimal point and return that. However this strategy doesnt work if the argument is a variable, which makes it fairly useless. The following is presented for entertainment value only:

``````def trunc_introspect(f, n):
Truncates/pads the float f to n decimal places by looking at the callers source code
current_frame = None
caller_frame = None
s = inspect.stack()
try:
current_frame = s
caller_frame = s
for token_type, token_string, _, _, _ in gen:
if token_type == tokenize.NAME and token_string == current_frame:
next(gen) # left parenthesis
token_type, token_string, _, _, _ = next(gen) # float literal
if token_type == tokenize.NUMBER:
try:
cut_point = token_string.index(.) + n + 1
except ValueError: # no decimal in string
else:
if len(token_string) < cut_point:
token_string += 0 * (cut_point - len(token_string))
else:
raise ValueError(Unable to find floating-point literal (this probably means you called {} with a variable).format(current_frame))
break
finally:
del s, current_frame, caller_frame
``````

Generalizing this to handle the case where you pass in a variable seems like a lost cause, since youd have to trace backwards through the programs execution until you find the floating-point literal which gave the variable its value. If there even is one. Most variables will be initialized from user input or mathematical expressions, in which case the binary representation is all there is.

#### python – How to truncate float values?

The result of `round` is a float, so watch out (example is from Python 2.6):

``````>>> round(1.923328437452, 3)
1.923
>>> round(1.23456, 3)
1.2350000000000001
``````

You will be better off when using a formatted string:

``````>>> %.3f % 1.923328437452
1.923
>>> %.3f % 1.23456
1.235
``````