NAME POE::Sugar::Args - Get "pretty", OO representation of args. SYNOPSIS use POE::Sugar::Args; sub _start { my $poe = sweeten_args; $poe->kernel->yield( '_stop' ); } # or, the long, boring way sub _stop { my $poe = POE::Sugar::Args->new( @_ ); delete $poe->heap->{client}; } ABSTRACT This module give an OO representation to arguments POE passes to event states. I will not lie to you. This adds heavy, bulky code underneath. On the other hand, it makes arguments for POE events much more palatable. Of course, this is a Sugar module, meaning, it will rot your program in odd (you'll be hooked) and unexpected ways (performace), but you took the candy so you can suffer the consequences. Good luck. DESCRIPTION Exports This function will get "@_" from the calling state by doing deep, dark voodoo. It will construct the "POE::Sugar::Args" object for you. Very handy. Methods new Constructs an object. Expects all of "@_" that's passed to an event state. object If this state was initialized as an "object_state" in the session, the object will be here. session POE::Session object. kernel POE::Kernel object. heap Your heap. state Event name that invoked the state. sender Reference to the session that send the event. caller_file The calling file. caller_line The calling line. args All arguments this event was called with. AUTHOR Casey West THANKS Rocco Caputo -- Much help with code and overall inspiration. COPYRIGHT Copyright (c) 2003 Casey West. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. SEE ALSO the perl manpage, the Devel::Caller manpage, the DB manpage, the perldebguts manpage.