xrtMailAddressCursorInit
初始化严格地址列表游标。
bool xrtMailAddressCursorInit( xmailaddresscursor* pCursor, xstrview Text, uint32 iFlags );
| 参数 | 说明 |
|---|---|
| xmailaddresscursor* pCursor | 游标 |
| xstrview Text | 文本视图 |
| uint32 iFlags | 标志位 |
返回：初始化严格地址列表游标。
示例已编译验证
mailaddresscursorinit obj; xrtMailAddressCursorInit(&obj, pCursor, Text, iFlags);
xrtMailAddressNext
返回下一个 mailbox、group begin 或 group end 借用视图。
xmailnext xrtMailAddressNext( xmailaddresscursor* pCursor, xmailaddressview* pAddress );
| 参数 | 说明 |
|---|---|
| xmailaddresscursor* pCursor | 游标 |
| xmailaddressview* pAddress | 地址 |
返回：返回下一个 mailbox、group begin 或 group end 借用视图。
示例已编译验证
/* 返回下一个 mailbox、group begin 或 group end 借用视图。 */ result = xrtMailAddressNext(pCursor, pAddress);
xrtMailAddressValid
验证一个完整 addr-spec，可选返回拆分后的 local-part 与 domain。
bool xrtMailAddressValid( xstrview Address, uint32 iFlags, xstrview* pLocal, xstrview* pDomain );
| 参数 | 说明 |
|---|---|
| xstrview Address | 地址 |
| uint32 iFlags | 标志位 |
| xstrview* pLocal | 本地地址 |
| xstrview* pDomain | Doman 参数 |
返回：验证一个完整 addr-spec，可选返回拆分后的 local-part 与 domain。
示例已编译验证
/* 验证一个完整 addr-spec，可选返回拆分后的 local-part 与 domain。 */ result = xrtMailAddressValid(Address, iFlags, pLocal, pDomain);
xrtMailAddressWrite
XRT_API bool xrtMailAddressWrite( xstrview Name, xstrview Address, xmailwordencoding Encoding, uint32 iFlags, char* sOutput, size_t iCapacity, size_t* pOutputSize );
;
返回：XRT_API bool xrtMailAddressWrite( xstrview Name, xstrview Address, xmailwordencoding Encoding, uint32 iFlags, char* sOutput, size_t iCapacity, size_t* pOutputSize );
示例已编译验证
/* XRT_API bool xrtMailAddressWrite( xstrview Name, xstrview Address, xmailwordencoding Encoding, uint32 iFlags, char* sOutput, size_t iCapacity, size_t* pOutputSize ); */ result = xrtMailAddressWrite();
xrtMailAddress
创建由 xrtFree 释放的规范 mailbox 文本。
str xrtMailAddress( xstrview Name, xstrview Address, xmailwordencoding Encoding, uint32 iFlags, size_t* pOutputSize );
| 参数 | 说明 |
|---|---|
| xstrview Name | 名称（xstrview） |
| xstrview Address | 地址 |
| xmailwordencoding Encoding | 编码 |
| uint32 iFlags | 标志位 |
| size_t* pOutputSize | 出：输出长度 |
返回：创建由 xrtFree 释放的规范 mailbox 文本。
示例已编译验证
/* 创建由 xrtFree 释放的规范 mailbox 文本。 */ result = xrtMailAddress(Name, Address, Encoding, iFlags, pOutputSize);
xrtMailAddressListWrite
写出逗号和空格分隔的规范 mailbox 列表；空数组写出空文本。
bool xrtMailAddressListWrite( const xmailaddress* pAddresses, size_t iCount, xmailwordencoding Encoding, uint32 iFlags, char* sOutput, size_t iCapacity, size_t* pOutputSize );
| 参数 | 说明 |
|---|---|
| const xmailaddress* pAddresses | 地址数组 |
| size_t iCount | 数量 |
| xmailwordencoding Encoding | 编码 |
| uint32 iFlags | 标志位 |
| char* sOutput | 输出缓冲 |
| size_t iCapacity | 容量 |
| size_t* pOutputSize | 出：输出长度 |
返回：写出逗号和空格分隔的规范 mailbox 列表；空数组写出空文本。
示例已编译验证
/* 写出逗号和空格分隔的规范 mailbox 列表；空数组写出空文本。 */ result = xrtMailAddressListWrite(pAddresses, iCount, Encoding, iFlags, sOutput, iCapacity, pOutputSize);
xrtMailAddressList
创建由 xrtFree 释放的规范 mailbox 列表。
str xrtMailAddressList( const xmailaddress* pAddresses, size_t iCount, xmailwordencoding Encoding, uint32 iFlags, size_t* pOutputSize );
| 参数 | 说明 |
|---|---|
| const xmailaddress* pAddresses | 地址数组 |
| size_t iCount | 数量 |
| xmailwordencoding Encoding | 编码 |
| uint32 iFlags | 标志位 |
| size_t* pOutputSize | 出：输出长度 |
返回：创建由 xrtFree 释放的规范 mailbox 列表。
示例已编译验证
/* 创建由 xrtFree 释放的规范 mailbox 列表。 */ result = xrtMailAddressList(pAddresses, iCount, Encoding, iFlags, pOutputSize);