# phpman > perldoc > Mail::Send

## NAME
    [Mail::Send](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ASend/markdown) - Simple electronic mail interface

## SYNOPSIS
      require [Mail::Send](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ASend/markdown);

      $msg = [Mail::Send](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ASend/markdown)->new;
      $msg = [Mail::Send](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ASend/markdown)->new(Subject => 'example', To => 'timbo');

      $msg->to('user@host');
      $msg->to('user@host', '<user2@example.com>');
      $msg->subject('example subject');
      $msg->cc('user@host');
      $msg->bcc('someone@else');

      $msg->set($header, @values);
      $msg->add($header, @values);
      $msg->delete($header);

      # Launch mailer and set headers. The filehandle returned
      # by open() is an instance of the [Mail::Mailer](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AMailer/markdown) class.
      # Arguments to the open() method are passed to the [Mail::Mailer](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AMailer/markdown)
      # constructor.

      $fh = $msg->open;   # some default mailer
      $fh = $msg->open('sendmail'); # explicit
      print $fh "Body of message";
      $fh->close          # complete the message and send it
          or die "couldn't send whole message: $!\n";

## DESCRIPTION
    [Mail::Send](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ASend/markdown) creates e-mail messages without using the [Mail::Header](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AHeader/markdown) knowledge, which means that
    all escaping and folding must be done by you! Also: do not forget to escape leading dots.
    Simplicity has its price.

    When you have time, take a look at [Mail::Transport](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ATransport/markdown) which is part of the MailBox suite.

## METHODS
### Constructors
    [Mail::Send](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ASend/markdown)->new(PAIRS)
        A list of header fields (provided as key-value PAIRS) can be used to initialize the object,
        limited to the few provided as method: "to", "subject", "cc", and "bcc". For other header
        fields, use add().

### Header fields
    $obj->add($fieldname, @values)
        Add values to the list of defined values for the $fieldname.

    $obj->bcc(@values)
    $obj->cc(@values)
    $obj->delete($fieldname)
    $obj->set($fieldname, @values)
        The @values will replace the old values for the $fieldname. Returned is the LIST of values
        after modification.

    $obj->subject(@values)
    $obj->to(@values)

### Sending
    $obj->open(%options)
        The %options are used to initiate a mailer object via [Mail::Mailer::new](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AMailer%3A%3Anew/markdown)(). Then
        [Mail::Mailer::open](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AMailer%3A%3Aopen/markdown)() is called with the knowledge collected in this "[Mail::Send](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ASend/markdown)" object.

        Be warned: this module implements raw smtp, which means that you have to escape lines which
        start with a dot, by adding one in front.

## SEE ALSO
    This module is part of the MailTools distribution, <http://perl.overmeer.net/mailtools/>.

## AUTHORS
    The MailTools bundle was developed by Graham Barr. Later, Mark Overmeer took over maintenance
    without commitment to further development.

    [Mail::Cap](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ACap/markdown) by Gisle Aas <<aas@oslonett.no>>. [Mail::Field::AddrList](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3AAddrList/markdown) by Peter Orbaek <<poe@cit.dk>>.
    [Mail::Mailer](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AMailer/markdown) and [Mail::Send](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ASend/markdown) by Tim Bunce <<Tim.Bunce@ig.co.uk>>. For other contributors see
    ChangeLog.

## LICENSE
    Copyrights 1995-2000 Graham Barr <<gbarr@pobox.com>> and 2001-2017 Mark Overmeer
    <<perl@overmeer.net>>.

    This program is free software; you can redistribute it and/or modify it under the same terms as
    Perl itself. See <http://www.perl.com/perl/misc/Artistic.html>