Python int(): String to Integer Conversion & Multi-Base Parsing

1. Syntax & Formal Parameter Specifications 🔝

The int() constructor provides two calling signatures:

# Formal syntax of built-in int()
# Form 1: Numeric conversion or zero-arg constructor
val = int([x])

# Form 2: String conversion with explicit base (2 to 36)
parsed_val = int(string_value, base=10)

2. Basic Usage: Truncation & String Parsing 🔝

When converting floating-point numbers, int() truncates strictly toward zero:

# 1. Zero-argument and float truncation
print("int():     ", int())       # 0
print("int('45'): ", int('45'))   # 45

# Floats are truncated toward zero (fractional part discarded)
print("int(4.1):  ", int(4.1))    # 4
print("int(4.99): ", int(4.99))   # 4
print("int(-4.99):", int(-4.99))  # -4 (truncation toward zero, NOT floor!)

# 2. String with surrounding whitespace and underscores
print("int('  100  '):   ", int('  100  '))    # 100
print("int('1_000_000'): ", int('1_000_000'))  # 1000000

Output:

int():      0
int('45'):  45
int(4.1):   4
int(4.99):  4
int(-4.99): -4
int('  100  '):    100
int('1_000_000'):  1000000

3. Multi-Base Parsing: Binary, Octal, Hex & Base-36 🔝

With an explicit base argument, int() parses strings in that radix (up to base 36):

# Parsing strings across different numeric radixes (base 2 to 36)
# Base 2 (Binary)
print("Base 2  '1011':", int('1011', 2))   # 11

# Base 8 (Octal)
print("Base 8  '71':  ", int('71', 8))     # 57

# Base 16 (Hexadecimal)
print("Base 16 'cd':  ", int('cd', 16))    # 205
print("Base 16 '0xca':", int('0xca', 16))  # 202 (optional prefix tolerated)

# Base 36 (Alphanumeric digits 0-9 and a-z)
print("Base 36 'z':   ", int('z', 36))     # 35
print("Base 36 'python':", int('python', 36)) # 1573355473

Output:

Base 2  '1011': 11
Base 8  '71':   57
Base 16 'cd':   205
Base 16 '0xca': 202
Base 36 'z':    35
Base 36 'python': 1573355473

4. Custom Class Integration with __int__() and __index__() 🔝

Classes define integer conversion by implementing __int__() or __index__():

# Custom classes implementing __index__() or __int__()
class MoneyAmount:
    def __init__(self, dollars: int, cents: int):
        self.dollars = dollars
        self.cents = cents

    def __int__(self) -> int:
        # Returns total cents as integer
        return self.dollars * 100 + self.cents

wallet = MoneyAmount(12, 50)
print("Wallet object:       ", wallet)
print("int(wallet) in cents:", int(wallet))

Output:

Wallet object:        <__main__.MoneyAmount object at ...>
int(wallet) in cents: 1250

5. Unbounded Arbitrary Precision Integers 🔝

Python 3 integers have unbounded arbitrary precision, growing as needed in RAM:

# Arbitrary precision in Python 3 integers
# In Python 3, integers have unbounded size, limited only by available RAM
huge_power = int(2) ** 256
print("2^256 bit length:  ", huge_power.bit_length())
print("2^256 decimal string length:", len(str(huge_power)))

Output:

2^256 bit length:   257
2^256 decimal string length: 78

6. Production Recipes & Practical Applications 🔝

Below are real-world recipes utilizing int() for safe parsing and base-36 URL slug conversions:

# Recipe A: Safe integer parser with fallback
def safe_int(raw: str, default: int = 0) -> int:
    try:
        return int(float(str(raw).strip()))
    except (ValueError, TypeError):
        return default

print("safe_int('  45.8  '):", safe_int("  45.8  "))
print("safe_int(None):      ", safe_int(None))

# Recipe B: Base-36 slug decoding
print("Decode 'qglj' base 36:", int('qglj', 36))

Output:

safe_int('  45.8  '): 45
safe_int(None):       0
Decode 'qglj' base 36: 1234567

7. Common Pitfalls & Developer Traps 🔝

# Pitfall 1: int() does NOT directly parse decimal string floats
try:
    int("4.5")  # ValueError!
except ValueError as err:
    print("ValueError caught:", err)

# Solution for string floats: convert to float first, then int
print("int(float('4.5')):", int(float("4.5")))

# Pitfall 2: Explicit base cannot be used with non-string numbers
try:
    int(123, 16)  # TypeError!
except TypeError as err:
    print("TypeError caught: ", err)

Output:

ValueError caught: invalid literal for int() with base 10: '4.5'
int(float('4.5')): 4
TypeError caught:  int() can't convert non-string with explicit base

8. Interactive Notebook & Practice Exercises 🔝

Practice integer conversions, base-36 parsing, and safe string parsers in our companion Jupyter Notebook:

Self-Verifying Assertion Suite

Run these unit checks directly in Python or your local environment to verify int() mechanics:

def test_int_mechanics():
    # 1. Basic conversions
    assert int() == 0
    assert int(4.9) == 4
    assert int(-4.9) == -4
    assert int(" 42 ") == 42
    
    # 2. Base conversions
    assert int("1011", 2) == 11
    assert int("71", 8) == 57
    assert int("cd", 16) == 205
    assert int("z", 36) == 35
    
    # 3. Custom __int__
    class Item:
        def __int__(self): return 99
    assert int(Item()) == 99
    
    print("All int() unit assertions passed! 100% verified.")

test_int_mechanics()

Output:

All int() unit assertions passed! 100% verified.

9. Related Built-in Functions & Type Tools 🔝

Subhendu Mohapatra

Author & Instructor at plus2net

I write and maintain practical tutorials on Python, PHP, SQL, JavaScript, HTML, jQuery, and web development at plus2net. The tutorials focus on clear explanations, working examples, and code that readers can test and adapt while learning.

About the author   Watch on YouTube

Connect: