331

I have read the official definition of "raise", but I still don't quite understand what it does.

In simplest terms, what is "raise"?

Example usage would help.

2
  • 39
    It's known as throw in some other languages.
    – voithos
    Commented Dec 19, 2012 at 17:29
  • 2
    I guess a relevant addition to this question: does raise exits the function automatically or does one need to return after raise?
    – alisa
    Commented May 31, 2018 at 18:12

6 Answers 6

410

It has two purposes.

jackcogdill has given the first one:

It's used for raising your own errors.

if something:
   raise Exception('My error!')

The second is to reraise the current exception in an exception handler, so that it can be handled further up the call stack.

try:
  generate_exception()
except SomeException as e:
  if not can_handle(e):
    raise
  handle_exception(e)
4
  • 23
    I typed that in and got "global name 'error' is not defined". To others new to Python, you need "raise Exception('My error!')". You replace "error" with your Exception name. A list of standard exceptions you can use is here: docs.python.org/2/library/exceptions.html Commented Feb 28, 2014 at 16:59
  • 6
    Note that in python 3.x the new syntax is except SomeException as e:
    – P-Gn
    Commented Nov 10, 2016 at 10:18
  • 1
    @user1735003, what does the as e do? How is it different from except SomeException?
    – alpha_989
    Commented Jan 14, 2018 at 2:46
  • 5
    @alpha_989: It lets you get the actual exception instance. Commented Jan 14, 2018 at 2:47
62

raise without any arguments is a special use of python syntax. It means get the exception and re-raise it. If this usage it could have been called reraise.

    raise

From The Python Language Reference:

If no expressions are present, raise re-raises the last exception that was active in the current scope.

If raise is used alone without any argument is strictly used for reraise-ing. If done in the situation that is not at a reraise of another exception, the following error is shown: RuntimeError: No active exception to reraise

51

It's used for raising errors.

if something:
    raise Exception('My error!')

Some examples here

24

Besides raise Exception("message") and raise Python 3 introduced a new form, raise Exception("message") from e. It's called exception chaining, it allows you to preserve the original exception (the root cause) with its traceback.

It's very similar to inner exceptions from C#.

More info: https://www.python.org/dev/peps/pep-3134/

1
  • 2
    When I follow this approach, is it recommended to print the trace on the bottom level where the error occurs, or at the highlest level to that catches the carried error?
    – alper
    Commented Apr 28, 2020 at 0:12
18

You can use it to raise errors as part of error-checking:

if (a < b):
    raise ValueError()

Or handle some errors, and then pass them on as part of error-handling:

try:
    f = open('file.txt', 'r')
except IOError:
    # do some processing here
    # and then pass the error on
    raise
0
13

raise causes an exception to be raised. Some other languages use the verb 'throw' instead.

It's intended to signal an error situation; it flags that the situation is exceptional to the normal flow.

Raised exceptions can be caught again by code 'upstream' (a surrounding block, or a function earlier on the stack) to handle it, using a try, except combination.

3
  • During re-raising and catching the exception to the top level. should I print the trace on bottom call where error occurs or the most higher call? or it is recommend to do raise Exception("message") from e to carry the error tothe top level?
    – alper
    Commented Apr 28, 2020 at 0:07
  • 1
    @alper: not sure what you are asking. If you are catching an exception in an except ...: handler, the traceback will include the whole stack, from the point where your Python program started up to the place where the exception was raised. So it doesn't matter where in the stack your handler is located, really. If you need to re-raise the exception after handling, use raise, nothing else. Commented Apr 29, 2020 at 11:38
  • 2
    @alper: raise Exception("message") from e replaces the e exception with a new exception, but just a plain Exception instance carries no meaning. If e was a TypeError or ValueError or LibrarySpecificException you can't now catch those specific exceptions anymore, because you replaced it with Exception. Commented Apr 29, 2020 at 11:39

Not the answer you're looking for? Browse other questions tagged or ask your own question.