Error Encyclopedia | Value Error

ValueErrors in Python

In Python, a value is the information that is stored within a certain object. To encounter a ValueError in Python means that is a problem with the content of the object you tried to assign the value to.

This is not to be confused with types in Python. For instance, imagine you have a dog and you try to put it in a fish tank. This would be an example of a type error, because animals of type ‘dog’ certainly are not the same as animals of type ‘fish’.

On the other hand, imagine we tried to put a Great Dane into a Chihuahua’s kennel. This would be a problem with the value of the dog, because although they are both of type ‘dog’, a Chihuahua’s kennel would not be able to accept a dog the size of a Great Dane.

To see this more clearly in Python, note the following examples:

        
          >>> int(5.6754) 

          5 

        Fig. 1: A valid int conversion

Since the float 5.6754 is numeric data, Python can convert it to an integer. The following, however, won't work so well:

        
          >>> int("dog") 

          Traceback (most recent call last): 

            File "<stdin>", line 1, in <module> 

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

        Fig. 2: A decidedly invalid int conversion

In PyLearn, we would see the following message:

        
          >>> int("dog") 

          ValueError: int() cannot convert 'dog' into an integer. 

        Fig. 3: The same message, PyLearn-style

Any time you wish to convert the type of an object, you need to make sure that the value associated with that object is a valid value.

Other ValueErrors in Python

You can also trigger a ValueError in Python when you try to perform an operation on a value that doesn’t exist. For instance, imagine the following example:

        
          >>> myVar = 5 

          >>> list = [] 

          >>> list.remove(myVar) 

          Traceback (most recent call last): 

            File "<stdin>", line 1, in <module> 

          ValueError: list.remove(x): x not in list

In this example, we define a variable ‘myVar’ to have the value 5. We then try to remove this value from a list that doesn’t contain that value. Because 5 is not in the list, we cannot remove it, and Python returns a value error.

Additionally, you can also raise a ValueError in Python if you try to ‘unpack’ more values than you have. For instance:

        
          >>> a, b, c, d = [3, 4, 5] 

          Traceback (most recent call last): 

            File "<stdin>", line 1, in <module> 

          ValueError: need more than 3 values to unpack

This returns a value error, because there are too few values on the right-hand side for Python to ‘unpack.’ When Python tries to assign ‘d’ to a value on the right-hand side, it is unable to find any matching value to ‘unpack’, and thus throws a ValueError.