NAME

URI::cid - RFC 2392 cid: URI implementation

VERSION

Version 0.02

SYNOPSIS

    use URI;

    my $cid = $URI->new('cid:');
    $cid->cid('c6a62d04-1037-475e-a2be-ea38f9a78b64@foobar.local')

    # or, pull it straight from the header:

    my $cid = URI::cid->parse($mimepart->header('Content-ID'));

    # and put it back:

    $mimepart->header('Content-ID' => $cid->format);

DESCRIPTION

RFC 2392 defines a straight-forward method of expressing the contents of email Message-ID and Content-ID headers as URIs. This module provides some utility methods for working with them.

METHODS

cid

Get or set the Content-ID.

parse

Parse (i.e., remove the confining angle-brackets from) a Content-ID header.

format

Format a cid: URI as a Content-ID header value.

SEE ALSO

http://tools.ietf.org/html/rfc2392

Email::Simple

Email::MIME

AUTHOR

Dorian Taylor, <dorian at cpan.org>

BUGS

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

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc URI::cid

You can also look for information at:

• RT: CPAN's request tracker (report bugs here)

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=URI-mid

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/URI-mid

• CPAN Ratings

  http://cpanratings.perl.org/d/URI-mid

• Search CPAN

  http://search.cpan.org/dist/URI-mid/

LICENSE AND COPYRIGHT

Copyright 2012 Dorian Taylor.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    L<http://www.apache.org/licenses/LICENSE-2.0>

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

cpanm URI::mid

perl -MCPAN -e shell
install URI::mid