1Net::DNS::Mailbox(3) User Contributed Perl Documentation Net::DNS::Mailbox(3)
2
3
4
6 Net::DNS::Mailbox - DNS mailbox representation
7
9 use Net::DNS::Mailbox;
10
11 $mailbox = Net::DNS::Mailbox->new('user@example.com');
12 $address = $mailbox->address;
13
15 The Net::DNS::Mailbox module implements a subclass of DNS domain name
16 objects representing the DNS coded form of RFC822 mailbox address.
17
18 The Net::DNS::Mailbox1035 and Net::DNS::Mailbox2535 packages implement
19 mailbox representation subtypes which provide the name compression and
20 canonicalisation specified by RFC1035 and RFC2535. These are necessary
21 to meet the backward compatibility requirements introduced by RFC3597.
22
24 new
25 $mailbox = Net::DNS::Mailbox->new('John Doe <john.doe@example.com>');
26 $mailbox = Net::DNS::Mailbox->new('john.doe@example.com');
27 $mailbox = Net::DNS::Mailbox->new('john\.doe.example.com');
28
29 Creates a mailbox object representing the RFC822 mail address specified
30 by the character string argument. An encoded domain name is also
31 accepted for backward compatibility with Net::DNS 0.68 and earlier.
32
33 The argument string consists of printable characters from the 7-bit
34 ASCII repertoire.
35
36 address
37 $address = $mailbox->address;
38
39 Returns a character string containing the RFC822 mailbox address
40 corresponding to the encoded domain name representation described in
41 RFC1035 section 8.
42
44 Copyright (c)2009,2012 Dick Franks.
45
46 All rights reserved.
47
49 Permission to use, copy, modify, and distribute this software and its
50 documentation for any purpose and without fee is hereby granted,
51 provided that the above copyright notice appear in all copies and that
52 both that copyright notice and this permission notice appear in
53 supporting documentation, and that the name of the author not be used
54 in advertising or publicity pertaining to distribution of the software
55 without specific prior written permission.
56
57 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
58 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
59 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
60 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
61 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
62 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
63 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
64
66 perl, Net::DNS, Net::DNS::DomainName, RFC1035, RFC5322 (RFC822)
67
68
69
70perl v5.32.1 2021-01-27 Net::DNS::Mailbox(3)