### Navigation

- index
- modules |
- next |
- previous |
- home|
- search|
- documentation »
- The IPython API »

# utils.strdispatch

## Module: `utils.strdispatch`

Inheritance diagram for `IPython.utils.strdispatch`:

String dispatch class to match regexps and dispatch commands.

## `StrDispatch`

class `IPython.utils.strdispatch.``StrDispatch`

  Bases: `object`

  Dispatch (lookup) a set of strings / regexps for match.

  Example:

      >>> dis = StrDispatch()
      >>> dis.add_s('hei',34, priority = 4)
      >>> dis.add_s('hei',123, priority = 2)
      >>> dis.add_re('h.i', 686)
      >>> print list(dis.flat_matches('hei'))
      [123, 34, 686]

  `__init__`()
  `add_re`(regex, obj, priority=0)

    Adds a target regexp for dispatching

  `add_s`(s, obj, priority=0)

    Adds a target ‘string’ for dispatching

  `dispatch`(key)

    Get a seq of Commandchain objects that match key

  `flat_matches`(key)

    Yield all ‘value’ targets, without priority

  `s_matches`(key)

### Navigation

- index
- modules |
- next |
- previous |
- home|
- search|
- documentation »
- The IPython API »