dwww Home | Manual pages | Find package

Net::DNS::Mailbox(3pm)User Contributed Perl DocumentatioNet::DNS::Mailbox(3pm)

NAME
       Net::DNS::Mailbox - DNS mailbox representation

SYNOPSIS
           use Net::DNS::Mailbox;

           $mailbox = Net::DNS::Mailbox->new('user@example.com');
           $address = $mailbox->address;

DESCRIPTION
       The Net::DNS::Mailbox module implements a subclass of DNS domain name
       objects representing the DNS coded form of RFC822 mailbox address.

       The Net::DNS::Mailbox1035 and Net::DNS::Mailbox2535 packages implement
       mailbox representation subtypes which provide the name compression and
       canonicalisation specified by RFC1035 and RFC2535.  These are necessary
       to meet the backward compatibility requirements introduced by RFC3597.

METHODS
   new
           $mailbox = Net::DNS::Mailbox->new('John Doe <john.doe@example.com>');
           $mailbox = Net::DNS::Mailbox->new('john.doe@example.com');
           $mailbox = Net::DNS::Mailbox->new('john\.doe.example.com');

       Creates a mailbox object representing the RFC822 mail address specified
       by the character string argument. An encoded domain name is also
       accepted for backward compatibility with Net::DNS 0.68 and earlier.

       The argument string consists of printable characters from the 7-bit
       ASCII repertoire.

   address
           $address = $mailbox->address;

       Returns a character string containing the RFC822 mailbox address
       corresponding to the encoded domain name representation described in
       RFC1035 section 8.

COPYRIGHT
       Copyright (c)2009,2012 Dick Franks.

       All rights reserved.

LICENSE
       Permission to use, copy, modify, and distribute this software and its
       documentation for any purpose and without fee is hereby granted,
       provided that the original copyright notices appear in all copies and
       that both copyright notice and this permission notice appear in
       supporting documentation, and that the name of the author not be used
       in advertising or publicity pertaining to distribution of the software
       without specific prior written permission.

       THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
       OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
       MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
       IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
       CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
       TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
       SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

SEE ALSO
       perl, Net::DNS, Net::DNS::DomainName, RFC1035, RFC5322 (RFC822)

perl v5.32.1                      2021-12-18            Net::DNS::Mailbox(3pm)

Generated by dwww version 1.14 on Fri Jan 24 06:06:28 CET 2025.