sendmail

向地址列表发送电子邮件

全页折叠

语法

sendmail(recipients,subject)

sendmail(recipients,subject,message)

sendmail(recipients,subject,message,attachments)

说明

示例

sendmail(recipients,subject) 向指定的收件人发送具有指定主题的电子邮件。

注意

sendmail 不支持主要电子邮件提供商，如 Gmail 和 Microsoft^® Outlook^®。sendmail 仅支持具有基于基本用户名和密码的身份验证和传输层安全性 (TLS)1.0 的电子邮件服务器。有关详细信息，请参阅设置预设项。

示例

sendmail(recipients,subject,message) 包括指定的消息。

示例

sendmail(recipients,subject,message,attachments) 附加 attachments 中列出的文件。

示例

全部折叠

发送带附件的消息

将包含两个附件的消息发送到一个电子邮件地址：

sendmail('user@otherdomain.com',...
         'Test subject','Test message',...
         {'folder/attach1.html','attach2.doc'});

发送带有换行符的消息

将包含强制换行符（使用 10）的消息发送到电子邮件地址：

sendmail('user@otherdomain.com','New subject', ...
        ['Line1 of message' 10 'Line2 of message' 10 ...
         'Line3 of message' 10 'Line4 of message']);

生成的消息为：

Line1 of message
Line2 of message
Line3 of message
Line4 of message

输入参数

全部折叠

`recipients` — 电子邮件收件人
字符串标量 | 字符串数组 | 字符向量 | 字符向量元胞数组

电子邮件收件人，指定为字符串标量、字符串数组、字符向量或字符向量的元胞数组。对于单个收件人，请将 recipients 指定为字符向量或字符串。对于多个收件人，请将 recipients 指定为字符向量元胞数组或字符串数组。

`subject` — 主题行
字符串标量 | 字符向量

电子邮件的主题行，指定为字符串标量或字符向量。

`message` — 消息文本
字符串标量 | 字符串数组 | 字符向量 | 字符向量元胞数组

电子邮件的消息文本，指定为字符串标量、字符串数组、字符向量或字符向量元胞数组。如果 message 是字符向量或字符串，则 sendmail 自动在 75 个字符处对文本换行。要强制在消息文本中换行，请使用 10。如果 message 是字符向量元胞数组或字符串数组，则每个元素代表一行新文本。

sendmail 不支持 HTML 格式的消息。不过，您可以按附件形式发送 HTML 文件。

`attachments` — 附加的文件
字符串标量 | 字符向量 | 字符串数组 | 字符向量元胞数组

附加的文件，其文件路径指定为字符串标量、字符串数组、字符向量或字符向量元胞数组。

详细信息

全部折叠

设置预设项

如果 sendmail 无法根据系统注册表确定您的电子邮件地址或传出 SMTP 邮件服务器，请使用 setpref 函数指定这些设置。例如：
```
setpref('Internet','SMTP_Server','my_server.example.com');
setpref('Internet','E_mail','my_email@example.com');
```
要确定用于调用 setpref 的 SMTP 服务器，请检查您的电子邮件应用程序的预设，或咨询您的电子邮件系统管理员。如果您无法轻易地确定服务器名称，请尝试 'mail' 这个常见默认值，例如：
```
setpref('Internet','SMTP_Server','mail');
```
要覆盖默认的字符编码，请按如下方式设置电子邮件字符编码的预设：
```
setpref('Internet','E_mail_Charset',encoding); 
```
其中 encoding 是一个指定字符编码的字符向量，例如 'SJIS'。
默认情况下，sendmail 函数不支持需要身份验证的电子邮件服务器。要支持这些服务器，请使用以下形式的命令更改您的系统设置并设置 SMTP 用户名和密码的预设：
```
props = java.lang.System.getProperties;
props.setProperty('mail.smtp.auth','true');

setpref('Internet','SMTP_Username','myaddress@example.com');
setpref('Internet','SMTP_Password','mypassword');
```