mime::parser::reader(3) [osx man page]

MIME::Parser::Reader(3) 				User Contributed Perl Documentation				   MIME::Parser::Reader(3)

NAME

       MIME::Parser::Reader - a line-oriented reader for a MIME::Parser

SYNOPSIS

       This module is used internally by MIME::Parser; you probably don't need to be looking at it at all.  But just in case...

	   ### Create a top-level reader, where chunks end at EOF:
	   $rdr = MIME::Parser::Reader->new();

	   ### Spawn a child reader, where chunks also end at a boundary:
	   $subrdr = $rdr->spawn->add_boundary($bound);

	   ### Spawn a child reader, where chunks also end at a given string:
	   $subrdr = $rdr->spawn->add_terminator($string);

	   ### Read until boundary or terminator:
	   $subrdr->read_chunk($in, $out);

DESCRIPTION

       A line-oriented reader which can deal with virtual end-of-stream defined by a collection of boundaries.

       Warning: this is a private class solely for use by MIME::Parser.  This class has no official public interface

SEE ALSO

       MIME::Tools, MIME::Parser

perl v5.16.2							    2011-11-21						   MIME::Parser::Reader(3)

MIME::Parser::Results(3)				User Contributed Perl Documentation				  MIME::Parser::Results(3)

NAME

       MIME::Parser::Results - results of the last entity parsed

SYNOPSIS

       Before reading further, you should see MIME::Parser to make sure that you understand where this module fits into the grand scheme of
       things.	Go on, do it now.  I'll wait.

       Ready?  Ok...

	  ### Do parse, get results:
	  my $entity = eval { $parser->parse(*STDIN); };
	  my $results  = $parser->results;

	  ### Get all messages logged:
	  @msgs = $results->msgs;

	  ### Get messages of specific types (also tests if there were problems):
	  $had_errors	= $results->errors;
	  $had_warnings = $results->warnings;

	  ### Get outermost header:
	  $top_head  = $results->top_head;

DESCRIPTION

       Results from the last MIME::Parser parse.

PUBLIC INTERFACE

       new Constructor.

       msgs
	   Instance method.  Return all messages that we logged, in order.  Every message is a string beginning with its type followed by ": ";
	   the current types are "debug", "warning", and "error".

       errors
	   Instance method.  Return all error messages that we logged, in order.  A convenience front-end onto msgs().

       warnings
	   Instance method.  Return all warning messages that we logged, in order.  A convenience front-end onto msgs().

       top_head
	   Instance method.  Return the topmost header, if we were able to read it.  This may be useful if the parse fails.

SEE ALSO

       MIME::Tools, MIME::Parser

AUTHOR

       Eryq (eryq@zeegee.com), ZeeGee Software Inc (http://www.zeegee.com).

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

perl v5.18.2							    2008-06-30						  MIME::Parser::Results(3)