ValueError when parsing input in Python (Fix)

ValueError often happens when your program reads text with input() and then tries to convert that text into a number.

This usually affects code that uses int() or float(). For example, the user might type letters instead of digits, leave the input blank, or enter a decimal when your code expects a whole number.

This page shows:

• what the error means
• how to reproduce it
• simple ways to fix it
• how to prevent it in beginner-friendly code

Quick fix #

user_text = input("Enter a number: ").strip()

try:
    number = int(user_text)
    print("You entered:", number)
except ValueError:
    print("Please enter a whole number only.")

Use try-except when converting input with int() or float(). strip() also helps remove accidental spaces.

What this error means #

ValueError means Python received a value of the correct general type, but the content is not valid for the operation.

When parsing input, this often happens when you try to:

• convert text to an integer with int()
• convert text to a decimal number with float()
• unpack values from split() and the number of parts is wrong

Common examples:

• int("abc")
• int("")
• float("")
• a, b = input().split() when the input does not contain exactly two parts

If you are new to exceptions, see Python errors and exceptions explained.

Common example that causes the error #

A very common beginner pattern is this:

age = int(input("Enter your age: "))
print("Next year you will be", age + 1)

This works only if the user enters a valid whole number.

If the user types hello, Python raises an error:

age = int(input("Enter your age: "))

Example input:

hello

Typical error message:

ValueError: invalid literal for int() with base 10: 'hello'

That happens because input() always returns a string. If you want to learn more about that, see Python input() function explained and Python int() function explained.

Fix 1: Use try-except around the conversion #

This is the best fix when input comes from a real user.

Wrap the conversion in a try-except block so your program does not crash.

user_text = input("Enter a whole number: ")

try:
    number = int(user_text)
    print("Valid number:", number)
except ValueError:
    print("That was not a valid whole number.")

What this does:

• try: runs the risky code
• if int(user_text) fails, Python jumps to except ValueError:
• your program prints a helpful message instead of stopping

You can do the same with float():

user_text = input("Enter a decimal number: ")

try:
    number = float(user_text)
    print("Valid number:", number)
except ValueError:
    print("Please enter a valid number.")

If you want more practice with this pattern, see how to use try-except blocks in Python.

Fix 2: Validate input before converting #

Sometimes you want to reject bad input before calling int().

For simple positive integers, isdigit() can help:

user_text = input("Enter a whole number: ").strip()

if user_text.isdigit():
    number = int(user_text)
    print("Valid number:", number)
else:
    print("Please enter digits only.")

This works for values like:

• "5"
• "42"
• "123"

But it does not work for:

• negative numbers like "-5"
• decimals like "3.14"
• empty strings like ""

So isdigit() is useful for simple checks, but it is not a complete replacement for try-except.

Fix 3: Clean the input first #

Sometimes the text is almost correct, but it contains spaces or formatting that causes problems.

Use strip() to remove spaces at the start and end:

user_text = input("Enter a number: ").strip()

try:
    number = int(user_text)
    print(number)
except ValueError:
    print("Invalid input")

This helps with input like:

"  25  "

You can also clean other formatting if needed. For example, some users may paste numbers with commas:

user_text = input("Enter a number: ").strip()
user_text = user_text.replace(",", "")

try:
    number = int(user_text)
    print("Parsed number:", number)
except ValueError:
    print("Please enter a valid whole number.")

Example:

• "1,000" becomes "1000"

Be careful with replacements. Only clean the formats you actually expect.

Fix 4: Ask again until the input is valid #

For many beginner programs, the best user experience is to keep asking until the user enters valid input.

while True:
    user_text = input("Enter a whole number: ").strip()

    try:
        number = int(user_text)
        break
    except ValueError:
        print("That was not a valid whole number. Try again.")

print("You entered:", number)

Why this is useful:

• the program does not crash
• the user gets another chance
• your code stays simple and focused

You can use the same pattern with float() if you expect decimal input. For a full walkthrough, see how to convert user input to numbers in Python.

Special cases beginners hit #

Some ValueError cases are confusing at first. Here are a few common ones.

int('3.5') #

print(int("3.5"))

This raises ValueError because "3.5" is a decimal string, not a whole number string.

If you expect decimal input, use float() instead:

print(float("3.5"))

float('') #

print(float(""))

This raises ValueError because an empty string is not a number.

This often happens when:

• the user just presses Enter
• you forgot to check for empty input

Unpacking from split() #

a, b = input("Enter two values: ").split()
print(a, b)

This works only if the input has exactly two parts.

For example:

• input: "10 20" → works
• input: "10" → not enough values
• input: "10 20 30" → too many values

These cases can raise different ValueError messages. See:

• ValueError: not enough values to unpack (fix)
• ValueError: too many values to unpack (fix)

How to debug the input value #

If the error does not make sense, inspect the actual input.

Useful debugging lines:

user_input = input("Enter something: ")

print(user_input)
print(repr(user_input))
print(type(user_input))

Why repr() helps:

• it shows hidden spaces
• it makes empty strings easier to see
• it can reveal unexpected characters

Example:

user_input = " 42 "
print(user_input)        # looks like:  42
print(repr(user_input))  # shows: ' 42 '

For split() problems, inspect the list of parts:

parts = input("Enter values: ").split()
print(parts, len(parts))

This helps you see whether you got the number of values you expected.

When to use int() vs float() #

Choose the conversion based on the kind of number you expect.

Use int() for whole numbers:

• 5
• 42
• 100

Use float() for decimal numbers:

• 3.14
• 2.0
• 0.5

Example:

whole = int("5")
decimal = float("3.14")

print(whole)
print(decimal)

If your program may receive either whole numbers or decimals, float() is often the better choice.

For example:

user_text = input("Enter a number: ").strip()

try:
    number = float(user_text)
    print("Valid number:", number)
except ValueError:
    print("Please enter a valid number.")

If needed, you can later convert a valid float to an integer, but only if that makes sense for your program. See Python float() function explained for more details.

Common causes #

This error often happens because:

• user entered letters instead of digits
• user entered a decimal when int() was used
• input was empty
• input had extra spaces or formatting
• code unpacked the wrong number of values from split()
• program assumed input was always valid

FAQ #

Why does int('3.0') raise ValueError? #

Because int() expects a whole number string like "3", not a decimal string like "3.0". Convert with float() first if needed.

Does strip() fix ValueError by itself? #

Only sometimes. It removes spaces at the start and end, but it does not turn invalid text like "abc" into a number.

Should I use isdigit() instead of try-except? #

isdigit() is useful for simple cases, but try-except is more flexible and handles more real input situations.

Can input() return an int automatically? #

No. input() always returns a string, so you must convert it yourself.

See also #

• Python input() function explained
• Python int() function explained
• Python float() function explained
• How to convert user input to numbers in Python
• How to use try-except blocks in Python
• ValueError: invalid literal for int() with base 10 (fix)
• ValueError: could not convert string to float (fix)