Exceptions (CSCI-UA.0002-008

Exceptions in the Wild

What are some exceptions that we've seen? That is, what errors have occurred during runtime?

using an out of range index on a list or string that's
dividing by zero
using an undefined variable
using an operator on incompatible types
converting a value to a type that it can't be converted to
Let's try to cause some exceptions!

Exception Examples

Traceback (most recent call last):
  File "/tmp/exceptions.py", line 1, in <module>
    5 / 0
ZeroDivisionError: integer division or modulo by zero

Traceback (most recent call last):
  File "/tmp/exceptions.py", line 1, in <module>
    int("foo")
ValueError: invalid literal for int() with base 10: 'foo'

Traceback (most recent call last):
  File "/tmp/exceptions.py", line 2, in <module>
    print(a[3])
IndexError: list index out of range

Traceback (most recent call last):
  File "/tmp/exceptions.py", line 1, in <module>
    "foo" + 5
TypeError: cannot concatenate 'str' and 'int' objects

A Closer Look at a Runtime Error

Traceback (most recent call last):
  File "/tmp/exceptions.py", line 1, in <module>
    "foo" + 5
TypeError: cannot concatenate 'str' and 'int' objects

We see the following details:

which file caused the exception
the line number
the actual code that caused it
the kind of exception / error plus some additional details

Types of Exceptions

A list of all exception types can be found at: http://docs.python.org/3.2/library/exceptions.html

The base exception is just Exception, but there are specific ones after that. From the previous slides, and our past experience programming, some exceptions we've seen include:

ZeroDivisionError
IndexError
TypeError
NameError
ValueError

What do all of These Errors Mean!?

ZeroDivisionError
IndexError
TypeError
NameError
ValueError

ZeroDivisionError - divide by zero
IndexError - index out of range
TypeError - function or operation applied to inappropriate type
NameError - name (variable, function, etc) doesn't exist / not yet declared
ValueError - function or operation gets right type, but inappropriate value

Great, so Now What?

We can gracefully recover from exceptions!

For example, a common source of runtime errors is user input…

A Short Program

Let's write a simple interactive program that converts inches to feet:

ask for numeric input - some number of inches
accept decimal values as well, such as 1.5 inches
divide that number by 12 to get feet
print out the result

inches = input("inches\n>")
print(float(inches)/12)

Soooo… That Works Great

Let's try running the program…

Everything works fine until? Is there a certain kind of input that will cause an error in this program?

inches
>asdf
Traceback (most recent call last):
  File "foo.py", line 2, in <module>
    print(float(inches)/23)
ValueError: invalid literal for int() with base 10: 'asdf'

Can We Prevent This Error from Happening?

…Maybe! Let's try a couple of things. →

How about isdigit and isnumeric?

s = 'asdf'
print(s.isdigit())
print(s.isnumeric())

But they don't let legitimate input through!

s = '3.2'
print(s.isdigit())
print(s.isnumeric())

"Defensive Programming" Continued

Any other ways to allow strings like 3.2 in, but still prevent strings that are not composed numbers and a decimal point? →

loop through every character, and make sure that it's only a number or a decimal point!?
use find to check for decimal; create another string without that and check if it's a digit
ughhhh … nevermind, these all seem a bit clunky

EAFP

Sometimes it's…

Easier to Ask Forgiveness than Permission

instead of defensive programming…
let's just try it
and ask for forgiveness if we made a mistake

Exception Handling

There's a construct in most programming languages that lets you handle exceptions. In python, that construct is a try-except block. It's similar to an if-else:

try:
	# stuff that I want to do
except:
	# stuff to do if an error occurs

try-except

The try block watches out for any statements within that block that causes errors.
If there is an error, the code in the except block will be run.
Otherwise, the code will execute normally (ignoring the except block)

try-except Example 1

What is the output of this code?

a = [1, 2, 3]
try:
	print(a[100])
except:
	print("sorry, try another!")

sorry, try another!

try-except Example 2

What is the output of this code?

a = [1, 2, 3]
try:
	print(a[0])
except:
	print("sorry, try another!")

Let's Take Another Look at Our Conversion Program

Let's modify our program so that it behaves in a similar way, but uses try-except instead of testing with an if statement first.

inches = input("inches\n>")
print(float(inches)/12)

inches = input("inches\n>")
try:
    print(float(inches)/12)
except:
    print("don't do that")

Other Exceptions

We saw that we could handle a ValueError in our program. Can that exception happen in the following program? Are there any other exceptions (that we just talked about in an earlier slide) that can happen? →

# of slices in a pie
people = input("how many people are eating pizza?\n>")
print("Each person can have %s slices" % (8/int(people)))

ValueError - for non numeric input
ZeroDivisionError - for 0 as input

Fixing the Pizza Pie Problems

How do we fix it (original code below)? →

# of slices in a pie
people = input("how many people are eating pizza?\n>")
print("Each person can have %s slices" % (8/int(people)))

# of slizes in a pie
people = input("how many people are eating pizza?\n>")
try:
    print("Each person can have %s slices" % (8/int(people)))
except:
    print("No one's gettin' nuthin'")

Fixing the Pizza Pie Problems Continued

What if we want to deal with ValueErrors and ZeroDivisionError differently?

Say either:

That's not a number! (ValueError)
More for me! (ZeroDivisionError)

Specific Exceptions, Multiple Except Blocks

You can catch specific exception types, and add an arbitrary number of except blocks for every exception type that may occur.

try:
	# some tricky stuff
except NameOfErrorType1:
	# handle it gracefully
except NameOfErrorType2:
	# handle it gracefully too

Back to Pizza

So… let's apply that to our pizza program →

people = input("how many people are eating pizza?\n>")
try:
    print("Each person can have %s slices" % (8/int(people)))
except:
    print("No one's gettin' nuthin'")

people = input("how many people are eating pizza?\n>")
try:
    print("Each person can have %s slices" % (8/int(people)))
except ZeroDivisionError:
    print("More for me!")
except ValueError:
    print("That's not a number!")

Implement Three Card Monte

Here's a text version of three card monte.

pick a cup: 0, 1, or 2
>0
['.', 'o', 'o']
you win

pick a cup: 0, 1, or 2
>0
['o', '.', 'o']
you lose

pick a cup: 0, 1, or 2
>asdf
['.', 'o', 'o']
not a number
you lose

pick a cup: 0, 1, or 2
>400
['o', '.', 'o']
that cup doesn't exist
you lose

Three Card Monte Requirements

in our version, we're using "cups"
keep a penny under 1 cup
represent the three cups as a list
'o' for empty '.' for a penny
"shuffle" the list
ask for input… a number that's 0, 1, or 2
if the program gets non-numeric input, say that it's not a number
if the number causes an IndexError, say that the cup doesn't exist
if either exception occurs, the player loses
if the user finds the penny, the player wins

A Potential Solution

import random
cups = ['o', '.', 'o']
random.shuffle(cups)
n = input("pick a cup: 0, 1, or 2\n>")
result = None

print(cups)
try:
    result = cups[int(n)]
except IndexError:
    print("that cup doesn't exist")
except ValueError:
    print("not a number")

if result == ".":
    print("you win")
else:
    print("you lose")

Exceptions