/ 
MMS-MailMessage-ProviderParsed-0.01
/ MMS::MailMessage::ProviderParsed

NAME

MMS::MailMessage::ProviderParsed - A class representing a parsed MMS (or picture) message, that has been parsed as originating from a specific network provider.

VERSION

Version 0.01

SYNOPSIS

This class is used by MMS::Parser to provide a final data storage class after the MMS has been parsed by the provider mail parser. It inherits from the MMS::MailMessage class and extends it's methods to allow access to parsed properties.

METHODS

The MMS::MailMessage::ProviderParsed class inherits all the methods from it's parent class MMS::MailMessage.

Constructor

new()

Return a new MMS::MailMessage::ProviderParsed object.

Regular Methods

addpicture MIME::Entity

Adds the supplied MIME::Entity attachment to the picture stack for the message. This method is mainly used by the MMS::MailProviderParser class to add pictures while parsing.

addvideo MIME::Entity

Adds the supplied MIME::Entity attachment to the video stack for the message. This method is mainly used by the MMS::MailProviderParser class to add videos while parsing.

pictures

Returns an array of pictures from the message.

videos

Returns an array of videos from the message.

datetime STRING

Returns the time and date the MMS was sent when invoked with no supplied parameter. When supplied with a parameter it sets the object property to the supplied parameter. This returns the headerdatetime property if a datetime property has not been explicitly set.

from STRING

Returns the sending email address the MMS was sent from when invoked with no supplied parameter. When supplied with a parameter it sets the object property to the supplied parameter. This returns the headerfrom property if a from property has not been explicitly set.

to STRING

Returns the recieving email address the MMS was sent to when invoked with no supplied parameter. When supplied with a parameter it sets the object property to the supplied parameter. This returns the headerto property if a to property has not been explicitly set.

subject STRING

Returns the MMS subject when invoked with no supplied parameter. When supplied with a parameter it sets the object property to the supplied parameter. This returns the headersubject property if a subject property has not been explicitly set.

text STRING

Returns the MMS body text when invoked with no supplied parameter. When supplied with a parameter it sets the object property to the supplied parameter. This returns the headertext property if a text property has not been explicitly set.

retrievemimeattachments STRING

Expects a mime-type to be passed as an argument and a regular expression match using the supplied string is applied to each attachment in the attachment stack of the message object and a reference to an array of objects where the mime-type matches the supplied string is returned. In the event no attachment was matched to the supplied mime-type an undef value is returned.

AUTHOR

Rob Lee, <robl@robl.co.uk>

BUGS

Please report any bugs or feature requests to bug-mms-message-providerparsed@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=MMS-MailMessage-ProviderParsed. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

NOTES

To quote the perl artistic license ('perldoc perlartistic') :

10. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

ACKNOWLEDGEMENTS

As per usual this module is sprinkled with a little Deb magic.

COPYRIGHT & LICENSE

Copyright 2005 Rob Lee, all rights reserved.

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