NAME

Sisimai::RFC5322 - Email address related utilities

SYNOPSIS

use Sisimai::RFC5322;

print Sisimai::RFC5322->is_emailaddress('neko@example.jp');    # 1
print Sisimai::RFC5322->is_domainpart('example.jp');           # 1
print Sisimai::RFC5322->is_mailerdaemon('neko@example.jp');    # 0

DESCRIPTION

Sisimai::RFC5322 provide methods for checking email address.

CLASS METHODS

is_emailaddress(email address)

is_emailaddress() checks the argument is valid email address or not.

print Sisimai::RFC5322->is_emailaddress('neko@example.jp');  # 1
print Sisimai::RFC5322->is_emailaddress('neko%example.jp');  # 0

my $addr_with_name = [
    'Stray cat <neko@example.jp',
    '=?UTF-8?B?55m954yr?= <shironeko@example.co.jp>',
];
for my $e ( @$addr_with_name ) {
    print Sisimai::RFC5322->is_emailaddress($e); # 1
}

is_domainpart(Domain)

is_domainpart() checks the argument is valid domain part of a email address or not.

print Sisimai::RFC5322->is_domainpart('neko@example.jp');  # 0
print Sisimai::RFC5322->is_domainpart('neko.example.jp');  # 1

is_domainpart(Domain)

is_mailerdaemon() checks the argument is mailer-daemon or not.

print Sisimai::RFC5322->is_mailerdaemon('neko@example.jp');          # 0
print Sisimai::RFC5322->is_mailerdaemon('mailer-daemon@example.jp'); # 1

received(String)

received() returns array reference which include host names in the Received header.

my $v = 'from mx.example.org (c1.example.net [192.0.2.1]) by mx.example.jp';
my $r = Sisimai::RFC5322->received($v);

warn Dumper $r; 
$VAR1 = [
    'mx.example.org',
    'mx.example.jp'
];

weedout(Array)

weedout() returns string including only necessary fields from message/rfc822 part. This method is called from only Sisimai::MTA/MSP modules.

my $v = <<'EOM';
From: postmaster@nyaan.example.org
To: kijitora@example.jp
Subject: Delivery failure
X-Mailer: Neko mailer v2.22
EOM

my $r = Sisimai::RFC5322->weedout([split("\n", $v)]);
print $$r;

From: postmaster@nyaan.example.org
To: kijitora@example.jp
Subject: Delivery failure

AUTHOR

azumakuniyuki

COPYRIGHT

Copyright (C) 2014-2016 azumakuniyuki, All rights reserved.

LICENSE

This software is distributed under The BSD 2-Clause License.