xmail/imap

bool xrtImapAtomValid(xstrview Atom);

/* 判断文本是否可以作为 IMAP atom 使用。 */
result = xrtImapAtomValid(Atom);

bool xrtImapSequenceSetValid(xstrview Set);

/* 验证序号集合、UID 集合或 SEARCHRES 的 `$` 引用。 */
result = xrtImapSequenceSetValid(Set);

bool xrtImapResponseParse( xstrview Line, ximapresponseview* pResponse );

/* 解析 tagged、untagged 或 continuation 响应行。 */
result = xrtImapResponseParse(Line, pResponse);

xmailnext xrtImapLiteralParse( xstrview Line, ximapliteralview* pLiteral );

/* 查找行尾 literal 标记；无标记返回 END，合法标记返回 ITEM。 */
result = xrtImapLiteralParse(Line, pLiteral);

xmailnext xrtImapCodeParse( xstrview Text, ximapcodeview* pCode );

/* 解析文本开头的 `[code arguments]`；没有响应码返回 END。 */
result = xrtImapCodeParse(Text, pCode);

xmailnext xrtImapNumberParse( xstrview Text, ximapnumberview* pNumber );

/* 解析 `number name [text]`；不是数字响应返回 END。 */
result = xrtImapNumberParse(Text, pNumber);

bool xrtImapAtomCursorInit( ximapatomcursor* pCursor, xstrview Text );

imapatomcursorinit obj;
xrtImapAtomCursorInit(&obj, pCursor, Text);

xmailnext xrtImapAtomNext( ximapatomcursor* pCursor, xstrview* pAtom );

/* 返回下一 atom；控制字符或 IMAP atom-specials 返回错误。 */
result = xrtImapAtomNext(pCursor, pAtom);

uint64 xrtImapCapability(xstrview Capability);

/* 返回已知 IMAP capability 的稳定标记，未知扩展返回零。 */
result = xrtImapCapability(Capability);

bool xrtImapQuoteWrite( xstrview Text, char* sOutput, size_t iCapacity, size_t* pOutputSize );

/* 写出转义后的 IMAP quoted string，容量包含末尾零字节。 */
result = xrtImapQuoteWrite(Text, sOutput, iCapacity, pOutputSize);

str xrtImapQuote(xstrview Text, size_t* pOutputSize);

/* 创建由 xrtFree 释放的 IMAP quoted string。 */
result = xrtImapQuote(Text, pOutputSize);

bool xrtImapCommandWrite( xstrview Tag, xstrview Command, xstrview Arguments, size_t iMaxLine, char* sOutput, size_t iCapacity, size_t* pOutputSize );

/* 安全写出 `Tag Command [Arguments]\r\n`。 */
result = xrtImapCommandWrite(Tag, Command, Arguments, iMaxLine, sOutput, iCapacity, pOutputSize);

str xrtImapCommand( xstrview Tag, xstrview Command, xstrview Arguments, size_t iMaxLine, size_t* pOutputSize );

/* 创建由 xrtFree 释放的 IMAP 命令行。 */
result = xrtImapCommand(Tag, Command, Arguments, iMaxLine, pOutputSize);