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 にリストされたファイルを添付します。

例

添付ファイルを含むメッセージの送信

2 つの添付ファイルを含むメッセージを電子メール アドレスに送信します。

sendmail('[e-mail]',...
         'Test subject','Test message',...
         {'folder/attach1.html','attach2.doc'});

改行のあるメッセージの送信

改行を強制したメッセージ (10 を使用) を電子メール アドレスに送信します。

sendmail('[e-mail]','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 — 電子メールの受信者

string スカラー | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

電子メールの受信者。string スカラー、string 配列、文字ベクトル、または文字ベクトルの cell 配列として指定します。受信者が 1 名の場合は、recipients を文字ベクトルまたは string として指定します。受信者が複数の場合は、recipients を文字ベクトルの cell 配列、または string 配列として指定します。

subject — 件名

string スカラー | 文字ベクトル

電子メールの件名。string スカラーまたは文字ベクトルとして指定します。

message — メッセージ テキスト

string スカラー | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

電子メールのメッセージ テキスト。string スカラー、string 配列、文字ベクトル、または文字ベクトルの cell 配列として指定します。message が文字ベクトルまたは string の場合、sendmail は自動的に 75 文字でテキストを折り返します。メッセージ テキストに改行を強制するには、10 を使用します。message が文字ベクトルの cell 配列、または string 配列の場合、各要素はテキストの新しい行を表します。

sendmail は HTML 形式のメッセージをサポートしません。ただし、HTML ファイルを添付ファイルとして送信できます。

attachments — 添付ファイル

string スカラー | 文字ベクトル | string 配列 | 文字ベクトルの cell 配列

添付ファイル。ファイル パスを string スカラー、string 配列、文字ベクトル、または文字ベクトルの cell 配列として指定します。

詳細

基本設定の設定

• sendmail がシステム レジストリから電子メール アドレスまたは送信 SMTP メール サーバーを判断できない場合、関数 setpref を使用してこれらの設定を指定します。以下に例を示します。

  setpref('Internet','SMTP_Server','my_server.example.com');
  setpref('Internet','E_mail','[e-mail]');

  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','[e-mail]');
  setpref('Internet','SMTP_Password','mypassword');

ヒント

• Microsoft Outlook がある Windows^® システムでは、actxserver により COM サーバーにアクセスして直接 Outlook から電子メールを送信できます。例については、Can I send e-mail through MATLAB using Microsoft Outlook? を参照してください。

バージョン履歴

R2006a で導入

参考

getpref | setpref

トピック

• インターネットへの接続のためのプロキシ サーバー設定の指定
• Can I send e-mail through MATLAB using Microsoft Outlook?