GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  APP::INFO::HANDLER::PRINT (3)

.ds Aq ’

NAME

App::Info::Handler::Print - Print App::Info event messages

CONTENTS

SYNOPSIS



  use App::Info::Category::FooApp;
  use App::Info::Handler::Print;

  my $stdout = App::Info::Handler::Print->new( fh => stdout );
  my $app = App::Info::Category::FooApp->new( on_info => $stdout );

  # Or...
  my $app = App::Info::Category::FooApp->new( on_error => stderr );



DESCRIPTION

App::Info::Handler::Print objects handle App::Info events by printing their messages to a filehandle. This means that if you want event messages to print to a file or to a system filehandle, you can easily do it with this class. You’ll find, however, that App::Info::Handler::Print is most effective for info and error events; unknown and prompt events are better handled by event handlers that know how to prompt users for data. See App::Info::Handler::Prompt for an example of that functionality.

Upon loading, App::Info::Handler::Print registers itself with App::Info::Handler, setting up a couple of strings that can be passed to an App::Info concrete subclass constructor. These strings are shortcuts that tell App::Info how to create the proper App::Info::Handler::Print object for handling events. The registered strings are:
stdout Prints event messages to STDOUT.
stderr Prints event messages to STDERR.
See the new() constructor below for how to have App::Info::Handler::Print print event messages to different filehandle.

INTERFACE

    Constructor

new



  my $stderr_handler = App::Info::Handler::Print->new;
  $stderr_handler = App::Info::Handler::Print->new( fh => stderr );
  my $stdout_handler = App::Info::Handler::Print->new( fh => stdout );
  my $fh = FileHandle->new($file);
  my $fh_handler = App::Info::Handler::Print->new( fh => $fh );



Constructs a new App::Info::Handler::Print and returns it. It can take a single parameterized argument, fh, which can be any one of the following values:
stderr Constructs a App::Info::Handler::Print object that prints App::Info event messages to STDERR.
stdout Constructs a App::Info::Handler::Print object that prints App::Info event messages to STDOUT.
FileHandle
GLOB Pass in a reference and App::Info::Handler::Print will assume that it’s a filehandle reference that it can print to. Note that passing in something that can’t be printed to will trigger an exception when App::Info::Handler::Print tries to print to it.
If the fh parameter is not passed, new() will default to creating an App::Info::Handler::Print object that prints App::Info event messages to STDOUT.

handler

This method is called by App::Info to print out the message from events.

SUPPORT

This module is stored in an open GitHub repository <http://github.com/theory/app-info/>. Feel free to fork and contribute!

Please file bug reports via GitHub Issues <http://github.com/theory/app-info/issues/> or by sending mail to bug-App-Info@rt.cpan.org <mailto:bug-App-Info@rt.cpan.org>.

AUTHOR

David E. Wheeler <david@justatheory.com>

SEE ALSO

App::Info documents the event handling interface.

App::Info::Handler::Carp handles events by passing their messages Carp module functions.

App::Info::Handler::Prompt offers event handling more appropriate for unknown and confirm events.

App::Info::Handler describes how to implement custom App::Info event handlers.

COPYRIGHT AND LICENSE

Copyright (c) 2002-2011, David E. Wheeler. Some Rights Reserved.

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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 APP::INFO::HANDLER::PRINT (3) 2016-03-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.