Python str.isdecimal() Method: Decimal Character Validation

Syntax & Parameters 🔝

string.isdecimal()

Basic Examples: Digits, Letters & Decimals 🔝

Standard ASCII digits 0-9 return True. Any non-digit character—such as letters, punctuation, spaces, or decimal points—returns False:

# 1. Standard digits (0-9)
s1 = "12345"
print(f"\'{s1}\'.isdecimal():", s1.isdecimal())

# 2. Mixed alphanumeric string
s2 = "234ab"
print(f"\'{s2}\'.isdecimal():", s2.isdecimal())

# 3. Floating-point number (period is punctuation)
s3 = "234.45"
print(f"\'{s3}\'.isdecimal():", s3.isdecimal())

# 4. Negative integer (minus sign is punctuation)
s4 = "-10"
print(f"\'{s4}\'.isdecimal():", s4.isdecimal())

# 5. Empty string
s5 = ""
print(f"Empty string.isdecimal():", s5.isdecimal())

Output:

'12345'.isdecimal(): True
'234ab'.isdecimal(): False
'234.45'.isdecimal(): False
'-10'.isdecimal(): False
Empty string.isdecimal(): False

The int() Conversion Trap: isdecimal() vs. isdigit() 🔝

A critical reason to use isdecimal() instead of isdigit() is preventing runtime crashes when converting strings to integers using int():

superscript_str = "2²"

print("isdigit():", superscript_str.isdigit())      # Output: True
print("isdecimal():", superscript_str.isdecimal())  # Output: False

try:
    val = int(superscript_str)
except ValueError as e:
    print("int() conversion failed:", e)

Output:

isdigit(): True
isdecimal(): False
int() conversion failed: invalid literal for int() with base 10: '2²'

Unicode Decimal Characters (Non-Latin Digits) 🔝

Decimal characters are defined by the Unicode General Category Nd (Decimal Number). This includes base-10 digits from writing systems worldwide, such as Arabic-Indic and Devanagari numerals. Crucially, Python's int() function can directly parse these into standard integers:

# Devanagari numerals: १२३ (123)
devanagari_num = "\u0967\u0968\u0969"

print("Devanagari text:", devanagari_num)
print("isdecimal():", devanagari_num.isdecimal())    # Output: True
print("Parsed integer:", int(devanagari_num))        # Output: 123
print("Type:", type(int(devanagari_num)))

Output:

Devanagari text: १२३
isdecimal(): True
Parsed integer: 123
Type: <class 'int'>

Comparison Matrix: isdecimal() vs. isdigit() vs. isnumeric() 🔝

Use this reference table to choose the exact validation method for your requirements:

Practical Solution: Validating PINs and Numeric IDs 🔝

When collecting postal PIN codes, credit card OTPs, or numerical account identifiers, isdecimal() provides the exact filter required to reject spaces, letters, and punctuation:

def validate_pin(pin: str) -> bool:
    # Valid PIN must be strictly decimal digits and exactly 4 or 6 characters
    return pin.isdecimal() and len(pin) in (4, 6)

print("validate_pin(\'500081\'):", validate_pin("500081"))  # Output: True
print("validate_pin(\'1234\'):", validate_pin("1234"))      # Output: True
print("validate_pin(\'12a4\'):", validate_pin("12a4"))      # Output: False
print("validate_pin(\'12 34\'):", validate_pin("12 34"))    # Output: False

Hands-on Exercise with Assertions 🔝

Write an order verification routine that extracts only valid base-10 numerical quantity strings from user inputs, converts them safely to integers, and calculates total items sold:

order_inputs = ["5", "12", "2²", "N/A", "8", "10.5", "0"]

# Filter only true decimal inputs that can safely be converted to int
valid_quantities = [int(qty) for qty in order_inputs if qty.isdecimal()]
total_quantity = sum(valid_quantities)

assert valid_quantities == [5, 12, 8, 0]
assert total_quantity == 25
print("Valid Quantities:", valid_quantities)
print("Total Units Ordered:", total_quantity)
print("All unit assertions passed successfully!")

More Details & Related Guides 🔝

• Python Strings Overview — Master string creation, slicing, methods, and formatting.
• str.isnumeric() Method — Broadest numeric check supporting Unicode fractions and Roman numerals.
• str.isdigit() Method — Check if characters are digits including superscripts.
• str.isalnum() Method — Validate alphanumeric characters (letters and numbers).
• str.find() Method — Locate substring index positions safely without exceptions.

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: