Python isalnum() Method

What You’ll Learn

The isalnum() method returns True when every character in a string is a letter or digit and the string is not empty. It is a quick way to validate usernames, product codes, and other input that should contain only alphanumeric characters—no spaces, punctuation, or symbols.

Definition and Usage

In Python, isalnum() inspects each character in a string. If every character is a letter (a–z, A–Z, or Unicode letters) or a digit (0–9) and the string has at least one character, it returns True. Otherwise it returns False. For example, "Hello123".isalnum() is True, but "Hello 123".isalnum() is False because of the space.

📝 Syntax

The isalnum() method takes no parameters:

string.isalnum()

Syntax Rules

• string — any valid Python str object.
• Return value — True if all characters are alphanumeric and the string is non-empty; otherwise False.
• No arguments — passing arguments raises TypeError.
• Read-only — the original string is never modified.
• Unicode — letters from other languages (like é or ñ) count as letters in Python 3.

↩ Return Value

isalnum() always returns a boolean—never an integer or string. It returns True only when the string contains one or more characters and every character is a letter or digit. It returns False for empty strings, strings with spaces, and strings with any symbol or punctuation.

print("Hello123".isalnum())   # True
print("Hello 123".isalnum())  # False (space)
print("".isalnum())            # False (empty)
print("12345".isalnum())       # True (digits only)
print("Hello!".isalnum())      # False (punctuation)

Examples Gallery

Run these examples in any Python 3 interpreter. Each one shows a common validation scenario.

text = "Hello123"
result = text.isalnum()

print("Text:  ", text)
print("Result:", result)

Text:   Hello123
Result: True

text = "Hello 123"
result = text.isalnum()

print("Text:  ", repr(text))
print("Result:", result)

Text:   'Hello 123'
Result: False

samples = ["", "ABC", "123", "Hello!", "user_name"]

for text in samples:
    print(repr(text), "→", text.isalnum())

'' → False
'ABC' → True
'123' → True
'Hello!' → False
'user_name' → False

def is_valid_username(name):
    cleaned = name.strip()
    if not cleaned:
        return False, "Username cannot be empty."
    if not cleaned.isalnum():
        return False, "Use letters and numbers only."
    return True, "Username accepted."

for candidate in ["Mari123", "Mari 123", "Mari_123"]:
    ok, message = is_valid_username(candidate)
    print(candidate, "→", message)

Mari123 → Username accepted.
Mari 123 → Use letters and numbers only.
Mari_123 → Use letters and numbers only.

text = "abc123"

print("isalnum():", text.isalnum())
print("isalpha():", text.isalpha())
print("isdigit():", text.isdigit())

print()
print("123".isalnum(), "123".isalpha(), "123".isdigit())
print("abc".isalnum(), "abc".isalpha(), "abc".isdigit())

isalnum(): True
isalpha(): False
isdigit(): False

True False True
True True False

🚀 Common Use Cases

• Username validation — reject names with spaces or special characters.
• Product codes — verify SKU or serial numbers contain only letters and digits.
• Form processing — quick check before saving user input to a database.
• Password rules (partial) — as one step in a larger validation (note: symbols are often required in passwords).
• Filtering data — skip or flag rows where a field is not alphanumeric.

📝 Notes

• Spaces, punctuation, underscores, and symbols all cause False.
• An empty string "" always returns False—there must be at least one alphanumeric character.
• Unicode letters (like é or ñ) count as letters in Python 3.
• isalnum() does not check string length—combine it with len() for min/max rules.
• Store the result in a variable if you need to use it multiple times on the same string.

💡 Best Practices