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  -  DATETIME::FORMAT::BUILDER::PARSER::GENERIC (3)

.ds Aq ’

NAME

DateTime::Format::Builder::Parser::generic - Useful routines

CONTENTS

VERSION

version 0.81

METHODS

    Useful

new

Standard constructor. Returns a blessed hash; any arguments are placed in the hash. This is useful for storing information between methods.

generic_parser

This is a method provided solely for the benefit of Parser implementations. It semi-neatly abstracts a lot of the work involved.

Basically, it takes parameters matching the assorted callbacks from the parser declarations and makes a coderef out of it all.

Currently recognized callbacks are:
o on_match
o on_fail
o preprocess
o postprocess

    Methods for subclassing

These are methods you should define when writing your own subclass.

<B>NoteB>: these methods do not exist in this class. There is no point trying to call $self->SUPER::do_match( ... ).

do_match

do_match is the first phase. Arguments are the date and @args. self, label, args. Return value must be defined if you match successfully.

post_match

post_match is called after the appropriate callback out of on_match/on_fail is done. It’s passed the date, the return value from do_match and the parsing hash.

Its return value is used as the post argument to the postprocess callback, and as the second argument to make.

make

make takes the original input, the return value from post_match and the parsing hash and should return a DateTime object or undefined.

    Delegations

For use of Parser, this module also delegates valid_params and params. This is just convenience to save typing the following:



    DateTime::Format::Builder::Parser->valid_params( blah )



Instead we get to type:



    $self->valid_params( blah );
    __PACKAGE__->valid_params( blah );



WRITING A SUBCLASS

Rather than attempt to explain how it all works, I think it’s best if you take a look at Regex.pm and Strptime.pm as examples and work from there.

SUPPORT

See DateTime::Format::Builder for details.

SEE ALSO

datetime@perl.org mailing list.

http://datetime.perl.org/

perl, DateTime, DateTime::Format::Builder, DateTime::Format::Builder::Parser.

AUTHORS

o Dave Rolsky <autarch@urth.org>
o Iain Truskett

COPYRIGHT AND LICENSE

This software is Copyright (c) 2013 by Dave Rolsky.

This is free software, licensed under:



  The Artistic License 2.0 (GPL Compatible)



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


perl v5.20.3 DATETIME::FORMAT::BUILDER::PARSER::GENERIC (3) 2013-04-03

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