Module: utils.strdispatch — IPython 2.3.1 documentation

### Navigation

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

# Module: `utils.strdispatch`

String dispatch class to match regexps and dispatch commands.

## 1 Class

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

### Navigation

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