Int. In Python we use int() to convert values. The int keyword is not used to declare values like in other languages. Instead it converts strings and floats.
For floats, int will always truncate the number (remove the part after the decimal place). So 1.9 will become 1.1. For strings, only valid strings can be converted without an error.
Numbers example. Here we use int() on some floating-point numbers. We see that the part after the decimal place is removed—the fractional value is discarded.
Note No rounding actually occurs with int(). Instead it just truncates the value.
# Use int to convert floats to integers.# ... The value is always rounded down (truncated).
value = 1.5
result = int(value)
print(value, "INT =", result)
value = 1.9
result = int(value)
print(value, "INT =", result)
value = -1.9
result = int(value)
print(value, "INT =", result)1.5 INT = 1
1.9 INT = 1
-1.9 INT = -1
Parse string. Now let's use int() on a string value. If the string contains only digits like "123" then we can transform the string into a number. We test it in an if-statement.
# Convert a string containing an integer to an int.
data = "123"
result = int(data)
print(data, "INT =", result)
# The result is an integer value.
if result == 123:
print(True)123 INT = 123
True
Int error. With int we must be careful not to try to parse a string that does not contain an integer value. A ValueError will occur, and this is disruptive.
# This fails as the string is not in a valid format.
data = "cat"
result = int(data)Traceback (most recent call last):
File "C:\programs\file.py", line 6, in <module>
result = int(data)
ValueError: invalid literal for int() with base 10: 'cat'
Isdigit. With isdigit() we can test a string for an integer value before converting it to an int with int(). This prevents the ValueError on invalid strings.
Here We have an array of string literals. Some of them are valid ints like 123 and 0, but some like "cat" and "bird" are not.
Result We use isdigit to test strings to see if they can be parsed with int. Then we parse only the ones that are valid.
values = ["123", "cat", "bird", "12.34", "0"]
# Loop over strings.
for v in values:
# See if string is all digits.
if v.isdigit():
# Parse string with int.
result = int(v)
print(v, "INT =", result)
else:
# String will fail parsing.
print(v, "ISDIGIT =", False)123 INT = 123
cat ISDIGIT = False
bird ISDIGIT = False
12.34 ISDIGIT = False
0 INT = 0
A summary. Int is an important built-in function in Python. It is not used to specify an integer like 5. But it can convert a string like "5" to 5, or a float like 5.3 to an integer.
Dot Net Perls is a collection of pages with code examples, which are updated to stay current. Programming is an art, and it can be learned from examples.
Donate to this site to help offset the costs of running the server. Sites like this will cease to exist if there is no financial support for them.
Sam Allen is passionate about computer languages, and he maintains 100% of the material available on this website. He hopes it makes the world a nicer place.
This page was last updated on Oct 13, 2021 (image).