graphviz::regex(3pm) [debian man page]

GraphViz::Regex(3pm)					User Contributed Perl Documentation				      GraphViz::Regex(3pm)

NAME

       GraphViz::Regex - Visualise a regular expression

SYNOPSIS

	 use GraphViz::Regex;

	 my $regex = '(([abcd0-9])|(foo))';

	 my $graph = GraphViz::Regex->new($regex);
	 print $graph->as_png;

DESCRIPTION

       This module attempts to visualise a Perl regular expression. Understanding regular expressions is tricky at the best of times, and regexess
       almost always evolve in ways unforseen at the start. This module aims to visualise a regex as a graph in order to make the structure clear
       and aid in understanding the regex.

       The graph visualises how the Perl regular expression engine attempts to match the regex. Simple text matches or character classes are
       represented by.box-shaped nodes. Alternations are represented by a diamond-shaped node which points to the alternations. Repetitions are
       represented by self-edges with a label of the repetition type (the nodes being repeated are pointed to be a full edge, a dotted edge points
       to what to match after the repetition). Matched patterns (such as $1, $2, etc.) are represented by a 'START $1' .. 'END $1' node pair.

       This uses the GraphViz module to draw the graph.

METHODS

   new
       This is the constructor. It takes one mandatory argument, which is a string of the regular expression to be visualised. A GraphViz object
       is returned.

	 my $graph = GraphViz::Regex->new($regex);

   as_*
       The regex can be visualised in a number of different graphical formats. Methods include as_ps, as_hpgl, as_pcl, as_mif, as_pic, as_gd,
       as_gd2, as_gif, as_jpeg, as_png, as_wbmp, as_ismap, as_imap, as_vrml, as_vtx, as_mp, as_fig, as_svg. See the GraphViz documentation for
       more information. The two most common methods are:

	 # Print out a PNG-format file
	 print $g->as_png;

	 # Print out a PostScript-format file
	 print $g->as_ps;

BUGS

       Note that this module relies on debugging information provided by Perl, and is known to fail on at least two versions of Perl: 5.005_03 and
       5.7.1. Sorry about that - please use a more recent version of Perl if you want to use this module.

AUTHOR

       Leon Brocard <acme@astray.com>

COPYRIGHT

       Copyright (C) 2000-1, Leon Brocard

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

perl v5.14.2							    2012-04-02						      GraphViz::Regex(3pm)

DateTime::Format::Builder::Parser::Regex(3pm)		User Contributed Perl Documentation	     DateTime::Format::Builder::Parser::Regex(3pm)

NAME

       DateTime::Format::Builder::Parser::Regex - Regex based date parsing

SYNOPSIS

	  my $parser = DateTime::Format::Builder->create_parser(
	       regex  => qr/^(dddd)(dd)(dd)T(dd)(dd)(dd)$/,
	       params => [ qw( year month day hour minute second ) ],
	  );

SPECIFICATION

       In addition to the common keys, "Regex" supports:

       o   regex is a regular expression that should capture elements of the datetime string.  This is a required element. This is the key whose
	   presence indicates it's a specification that belongs to this class.

       o   params is an arrayref of key names. The captures from the regex are mapped to these ($1 to the first element, $2 to the second, and so
	   on) and handed to "DateTime->new()".  This is a required element.

       o   extra is a hashref of extra arguments you wish to give to "DateTime->new()". For example, you could set the "year" or "time_zone" to
	   defaults:

	       extra => { year => 2004, time_zone => "Australia/Sydney" },

       o   constructor is either an arrayref or a coderef. If an arrayref then the first element is a class name or object, and the second element
	   is a method name (or coderef since Perl allows that sort of thing).	The arguments to the call are anything in $p and anything given in
	   the "extra" option above.

	   If only a coderef is supplied, then it is called with arguments of $self, $p and "extra".

	   In short:

		       $self->$coderef( %$p, %{ $self->{extra} } );

	   The method is expected to return a valid DateTime object, or undef in event of failure, but can conceivably return anything it likes.
	   So long as it's 'true'.

THANKS

       See the main module's section.

SUPPORT

       Support for this module is provided via the datetime@perl.org email list. See http://lists.perl.org/ for more details.

       Alternatively, log them via the CPAN RT system via the web or email:

	   http://perl.dellah.org/rt/dtbuilder
	   bug-datetime-format-builder@rt.cpan.org

       This makes it much easier for me to track things and thus means your problem is less likely to be neglected.

LICENCE AND COPYRIGHT

       Copyright X Iain Truskett, 2003. All rights reserved.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.000 or,
       at your option, any later version of Perl 5 you may have available.

       The full text of the licences can be found in the Artistic and COPYING files included with this module, or in perlartistic and perlgpl as
       supplied with Perl 5.8.1 and later.

AUTHOR

       Iain Truskett <spoon@cpan.org>

SEE ALSO

       "datetime@perl.org" mailing list.

       http://datetime.perl.org/

       perl, DateTime, DateTime::Format::Builder

perl v5.10.1							    2010-03-14			     DateTime::Format::Builder::Parser::Regex(3pm)