astro py:docs

- Index
- Modules

### Navigation

- next »
- « previous |
- Astropy v1.1.1 »
- Astropy Core Package Utilities (`astropy.utils`) »
- format_exception

# format_exception

`astropy.utils.misc.``format_exception`(msg, *args, **kwargs)

  Given an exception message string, uses new-style formatting arguments `{filename}`, `{lineno}`, `{func}` and/or `{text}` to fill in information about the exception that occurred. For example:

  > try:
  >   1/0
  > except:
  >   raise ZeroDivisionError(
  >     format_except(‘A divide by zero occurred in {filename} at ‘
  >       ‘line {lineno} of function {func}.’))

  Any additional positional or keyword arguments passed to this function are also used to format the message.

  Note

  This uses `sys.exc_info` to gather up the information needed to fill in the formatting arguments. Python 2.x and 3.x have slightly different behavior regarding `sys.exc_info` (the latter will not carry it outside a handled exception), so it’s not wise to use this outside of an `except` clause - if it is, this will substitute ‘<unkown>’ for the 4 formatting arguments.