NAME

Hash::Dispatch - Find CODE in a hash (hashlike)

VERSION

version 0.0010

SYNOPSIS

            

              
              
$dispatch = Hash::Dispatch->dispatch(
    'xyzzy' => sub {
        return 'xyzzy';
    },
    qr/.../ => 'xyzzy',
    ...
);
$result = $dispatch->dispatch( 'xyzzy' );
$result->value->( ... );
            
          

DESCRIPTION

Hash::Dispatch is a tool for creating a hash-like lookup for returning a CODE reference

It is hash-like because a query against the dispatcher will only return once a CODE reference a found. If a key (a string or regular expression) maps to a string, then that will cause the lookup to begin again with the new value, recursing until a CODE reference is found or a deadend is reached:

            

              
              
a => CODE0
b => CODE1
c => CODE2
d => a
qr/z/ => c
query( a ) => CODE0
query( b ) => CODE1
query( d ) => CODE0
query( xyzzy ) => CODE2
query( j ) => undef
            
          

Hash::Dispatch will throw an exception if it is cycling:

            

              
              
a => b
b => a
query( a ) => {{{ Exception! }}}
            
          

USAGE

$dispatcher = Hash::Dispatch->dispatch( ... )

Returns a new $dispatcher with the given mapping

$result = $dispatcher->dispatch( <query> )

Search $dispatcher with <query>

Returns an object with a ->value method that contains the CODE reference

Returns undef is nothing is found

AUTHOR

Robert Krimen <robertkrimen@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Robert Krimen.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.