IKC::Specifier(3pm) User Contributed Perl Documentation IKC::Specifier(3pm) NAME POE::Component::IKC::Specifier - IKC event specifer SYNOPSIS use POE; use POE::Component::IKC::Specifier; $state=specifier_parse('poe://*/timeserver/connect'); print 'The foreign state is '.specifier_name($state); DESCRIPTION This is a helper module that encapsulates POE IKC specifiers. An IKC specifier is a way of designating either a kernel, a session or a state within a IKC cluster. IKC specifiers have the folloing format : poe:://kernel/session/state kernel may a kernel name, a kernel ID, blank (for local kernel), a '*' (all known foreign kernels) or host:port (not currently supported). session may be any session alias that has been published by the foreign kernel. state is a state that has been published by a foreign session. Examples : "poe://Pulse/timeserver/connect" State 'connect' in session 'timeserver' on kernel 'Pulse'. "poe:/timeserver/connect" State 'connect' in session 'timeserver' on the local kernel. "poe://*/timeserver/connect" State 'connect' in session 'timeserver' on any known foreign kernel. "poe://Billy/bob/" Session 'bob' on foreign kernel 'Billy'. EXPORTED FUNCTIONS "specifier_parse($spec)" Turn a specifier into the internal representation (hash ref). Returns undef() if the specifier wasn't valid. print Dumper specifer_parse('poe://Pulse/timeserver/time'); would print $VAR1 = { kernel => 'Pulse', session => 'timeserver', state => 'time', }; Note : the internal representation might very well change some day. "specifier_name($spec)" Turns a specifier into a string. BUGS AUTHOR Philip Gwyn, <perl-ikc at pied.nu> COPYRIGHT AND LICENSE Copyright 1999-2011 by Philip Gwyn. All rights reserved. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See <http://www.perl.com/language/misc/Artistic.html> SEE ALSO POE, POE::Component::IKC::Responder perl v5.12.4 2011-08-27 IKC::Specifier(3pm)