Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Email::AddressParser(3User Contributed Perl DocumentatiEmail::AddressParser(3)

NAME
       Email::AddressParser - RFC 2822 Address Parsing and Creation

SYNOPSIS
	 use Email::AddressParser;

	 my @addresses = Email::AddressParser->parse($line);
	 my $address   = Email::AddressParser->new(Tony	=> 'tony@localhost');

	 print $address->format;

VERSION
       version 0.01

DESCRIPTION
       This class is a near drop-in replacement	for the	regex parsing of
       Email::Address, which has serious issues	for production use
       (exponential to infinite	computation time in some cases). It uses code
       from Mark Crispin's c-client library to implement the parsing. The
       resulting parser	is much	more stable than the regex-based version of
       Email::Address.

       Note, RFC2822 comments are removed by this version (you can pass	them
       in, and you can ask for them, but they will always be empty).

   Class Methods
       parse
	     my	@addrs = Email::Address->parse(
	       q[me@local, Tony	<me@local>, "Tony" <me@local>]
	     );

	   This	method returns a list of "Email::Address" objects it finds in
	   the input string.

	   There are no	comment	nesting	limitations on this method, though all
	   comments will be ignored.

       new
	     my	$address = Email::Address->new(undef, 'tony@local');
	     my	$address = Email::Address->new('tony kay', 'tony@local');
	     my	$address = Email::Address->new(undef, 'tony@local', '(tony)');

	   Constructs and returns a new	"Email::AddressParser" object. Takes
	   four	positional arguments: phrase, email, and comment.

   Instance Methods
       phrase
	     my	$phrase	= $address->phrase;
	     $address->phrase( "Me oh my" );

	   Accessor for	the phrase portion of an address.

       address my $addr	= $address->address; $addr->address(
       "me@PROTECTED.com" );
	   Accessor for	the address portion of an address.

       comment
	     my	$comment = $address->comment;
	     $address->comment(	"(Work address)" );

	   Accessor for	the comment portion of an address. Currently a no-op.

       format
	     my	$printable = $address->format;

	   Returns a properly formatted	RFC 2822 address representing the
	   object.

SEE ALSO
       Email::Address.

AUTHOR
       Parser by Mark Crispin. Perl integration	by Anthony Kay
       <tkay@cs.uoregon.edu>. Most documentation shamelessly borrowed from
       Email::Address.

COPYRIGHT
       All parsing code	is Copyright (c) 1988-2006 University of Washington,
       under the Apache	License	2.0. The Perl integration is licesened under
       the same	terms as Perl itself.

POD ERRORS
       Hey! The	above document had some	coding errors, which are explained
       below:

       Around line 153:
	   You forgot a	'=back'	before '=head2'

perl v5.24.1			  2007-03-27	       Email::AddressParser(3)

NAME | SYNOPSIS | VERSION | DESCRIPTION | SEE ALSO | AUTHOR | COPYRIGHT | POD ERRORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Email::AddressParser&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help