NAME

       IM::Address - RFC822 style address parser

SYNOPSIS

        use IM::Address;

        $pure_address_portion = &extract_addr($address_with_comment);

        $replaced_address = &replace_addr($original_address_with_comment,
            $pure_notation_of_old_address, $pure_notation_of_new_address);

        ($first, $rest) = &fetch_addr($address_list, $pure_address_flag);

DESCRIPTION

       The IM::Address module is a parser for RFC822 style address.

       This modules is provided by IM (Internet Message).

EXAMPLES

        $a = "Motonori Nakamura <motonori\@econ.kyoto-u.ac.jp>";
        &extract_addr($a) returns "motonori@econ.kyoto-u.ac.jp".

        $a = "Motonori Nakamura <motonori\@econ.kyoto-u.ac.jp>";
        $b = "motonori\@econ.kyoto-u.ac.jp";
        $c = "motonori\@wide.ad.jp";
        &replace_addr($a, $b, $c) returns "Motonori Nakamura <motonori@wide.ad.jp>".

        $a = "kazu, nom, motonori";
        &fetch_addr($a, 0) returns ("kazu", " nom, motonori").

COPYRIGHT

       IM (Internet Message) is copyrighted by IM developing team.  You can redistribute it
       and/or modify it under the modified BSD license.  See the copyright file for more details.