使用FROM_FORMAT、SUBJECT_FORMAT以及所有 DSN_* 通道選項指定的格式化範本為 UTF-8 字串,其可能包含文字列文字和替換序列的組合。假定範例電子郵件位址為
Jane Doe <user@siroe>
識別的替代序列顯示於以下的表 C–17 中︰
表 C–17 替代序列
序列 |
說明 |
---|---|
$a |
以創建者電子郵件位址的本機與網域部分替代 (例如,「user@siroe」) |
$d |
以創建者電子郵件位址的網域部分替代 (例如,「 domain」) |
$p |
以創建者電子郵件位址的片語部分 (如果有) 替代 (例如,「Jane Doe」) |
$s |
以 Subject: 標頭行的內容替代 |
$u |
以創建者電子郵件位址的本機部分替代 (例如,「user」) |
\x |
以文字字元「x」替代 |
例如,格式化範本
From: $a
會產生文字字串
From: user@siroe
建構
${xy:alternate text}
可用於在序列 x 關聯的文字中進行替換。如果該文字為空白字串,則會使用與序列 y 關聯的文字。而如果此文字也為空白字串,則以替代文字進行替代。例如,考量格式化範本
From: ${pa:unknown sender}
對於創建者電子郵件位址
John Doe <jdoe@siroe.com>
該位址中包含片語部分,因此範本產生:
From: John Doe
但是對於位址
jdoe@siroe.com
該位址缺少片語,因此產生
From: jdoe@siroe.com
而對於空白創建者位址,則會產生
From: unknown sender