xhttp/multipart

返回：XRT_API void xrtMultipartLimitsInit(xmultipartlimits* pLimits);

multipartlimitsinit obj;
xrtMultipartLimitsInit(&obj);

返回：校验并复制已经解码的 MIME boundary；输出可以未对齐。

/* 校验并复制已经解码的 MIME boundary；输出可以未对齐。 */
result = xrtMultipartBoundaryParse(Text, pBoundary);

返回：从 multipart Content-Type 中严格读取并解码 boundary 参数。

/* 从 multipart Content-Type 中严格读取并解码 boundary 参数。 */
result = xrtMultipartBoundaryFromContentType(ContentType, pBoundary);

返回：返回借用边界结构的视图；无效结构返回空视图并设置错误。

/* 返回借用边界结构的视图；无效结构返回空视图并设置错误。 */
result = xrtMultipartBoundaryView(pBoundary);

返回：使用 128 位系统安全随机数原子生成 boundary；输出可以未对齐。

/* 使用 128 位系统安全随机数原子生成 boundary；输出可以未对齐。 */
result = xrtMultipartBoundaryRandom(pBoundary);

返回：XRT_API xhttpnext xrtMultipartNext( xbytesview Body, const xmultipartboundary* pBoundary, size_t* pOffset, xmultipartpart* pPart, xmultiparterrorinfo* pError );

/* XRT_API xhttpnext xrtMultipartNext( xbytesview Body, const xmultipartboundary* pBoundary, size_t* pOffset, xmultipartpart* pPart, xmultiparterrorinfo* pError ); */
result = xrtMultipartNext();

返回：按限制严格验证完整 multipart 正文，要求存在至少一个 Part 和关闭边界。

/* 按限制严格验证完整 multipart 正文，要求存在至少一个 Part 和关闭边界。 */
result = xrtMultipartValidate(Body, pBoundary, pLimits, pError);

返回：XRT_API bool xrtMultipartValidateCount( xbytesview Body, const xmultipartboundary* pBoundary, const xmultipartlimits* pLimits, uint32 Flags, size_t* pPartCount, xmultiparterrorinfo* pError );

/* XRT_API bool xrtMultipartValidateCount( xbytesview Body, const xmultipartboundary* pBoundary, const xmultipartlimits* pLimits, uint32 Flags, size_t* pPartCount, xmultiparterrorinfo* pError ); */
result = xrtMultipartValidateCount();

返回：XRT_API bool xrtMultipartParse( xbytesview Body, const xmultipartboundary* pBoundary, xmultipartpart* pParts, size_t iCapacity, size_t* pCount, const xmultipartlimits* pLimits, xmultiparterrorinfo* pError );

/* XRT_API bool xrtMultipartParse( xbytesview Body, const xmultipartboundary* pBoundary, xmultipartpart* pParts, size_t iCapacity, size_t* pCount, const xmultipartlimits* pLimits, xmultiparterrorinfo* pError ); */
result = xrtMultipartParse();

返回：验证 Part 具备 RFC 7578 form-data 所需的 disposition 类型和 name 参数。

/* 验证 Part 具备 RFC 7578 form-data 所需的 disposition 类型和 name 参数。 */
result = xrtMultipartFormPartValid(pPart);

返回：读取 form-data 字段名；结果不附加零字符。

/* 读取 form-data 字段名；结果不附加零字符。 */
result = xrtMultipartPartNameWrite(pPart, pOutput, iCapacity, pSize);

返回：读取上传文件名；优先采用受支持的 filename*，结果不附加零字符。

/* 读取上传文件名；优先采用受支持的 filename*，结果不附加零字符。 */
result = xrtMultipartPartFileNameWrite(pPart, pOutput, iCapacity, pSize);

返回：XRT_API bool xrtMultipartReaderInit( xmultipartreader* pReader, const xmultipartboundary* pBoundary, const xmultipartlimits* pLimits );

multipartreaderinit obj;
xrtMultipartReaderInit(&obj);

返回：保留 boundary 与限制并重置解析进度，便于复用 Reader 对象。

/* 保留 boundary 与限制并重置解析进度，便于复用 Reader 对象。 */
result = xrtMultipartReaderReset(pReader);

返回：XRT_API xmultipartreadstatus xrtMultipartReaderRead( xmultipartreader* pReader, xbytesview Input, bool bEnd, size_t* pConsumed, xmultipartpart* pPart, xbytesview* pData, xmultiparterrorinfo* pError );

/* XRT_API xmultipartreadstatus xrtMultipartReaderRead( xmultipartreader* pReader, xbytesview Input, bool bEnd, size_t* pConsumed, xmultipartpart* pPart, xbytesview* pData, xmultiparterrorinfo* pError ); */
result = xrtMultipartReaderRead();

返回：判断 Reader 是否已经消费关闭 boundary 和全部 epilogue。

/* 判断 Reader 是否已经消费关闭 boundary 和全部 epilogue。 */
result = xrtMultipartReaderDone(pReader);

返回：XRT_API bool xrtMultipartContentTypeWrite( const xmultipartboundary* pBoundary, void* pOutput, size_t iCapacity, size_t* pSize );

/* XRT_API bool xrtMultipartContentTypeWrite( const xmultipartboundary* pBoundary, void* pOutput, size_t iCapacity, size_t* pSize ); */
result = xrtMultipartContentTypeWrite();

返回：XRT_API bool xrtMultipartPartHeadWrite( const xmultipartboundary* pBoundary, const xhttpfield* pFields, size_t iFieldCount, void* pOutput, size_t iCapacity, size_t* pSize );

/* XRT_API bool xrtMultipartPartHeadWrite( const xmultipartboundary* pBoundary, const xhttpfield* pFields, size_t iFieldCount, void* pOutput, size_t iCapacity, size_t* pSize ); */
result = xrtMultipartPartHeadWrite();

返回：XRT_API bool xrtMultipartFormHeadWrite( const xmultipartboundary* pBoundary, xstrview Name, const xstrview* pFilename, xstrview ContentType, void* pOutput, size_t iCapacity, size_t* pSize );

/* XRT_API bool xrtMultipartFormHeadWrite( const xmultipartboundary* pBoundary, xstrview Name, const xstrview* pFilename, xstrview ContentType, void* pOutput, size_t iCapacity, size_t* pSize ); */
result = xrtMultipartFormHeadWrite();

返回：写出 Part 正文后的 CRLF，可与 PartHeadWrite 和零复制正文发送组合使用。

/* 写出 Part 正文后的 CRLF，可与 PartHeadWrite 和零复制正文发送组合使用。 */
result = xrtMultipartPartEndWrite(pOutput, iCapacity, pSize);

返回：一次写出原始 Part；容量不足时不产生部分结果。

/* 一次写出原始 Part；容量不足时不产生部分结果。 */
result = xrtMultipartPartWrite(pBoundary, pFields, iFieldCount, Body, pOutput, iCapacity, pSize);

返回：写出一个 form-data 普通字段 Part。

/* 写出一个 form-data 普通字段 Part。 */
result = xrtMultipartFieldWrite(pBoundary, Name, Value, pOutput, iCapacity, pSize);

返回：XRT_API bool xrtMultipartFileWrite( const xmultipartboundary* pBoundary, xstrview Name, xstrview Filename, xstrview ContentType, xbytesview Body, void* pOutput, size_t iCapacity, size_t* pSize );

/* XRT_API bool xrtMultipartFileWrite( const xmultipartboundary* pBoundary, xstrview Name, xstrview Filename, xstrview ContentType, xbytesview Body, void* pOutput, size_t iCapacity, size_t* pSize ); */
result = xrtMultipartFileWrite();

返回：写出关闭 boundary；它必须位于最后一个 PartEndWrite 之后。

/* 写出关闭 boundary；它必须位于最后一个 PartEndWrite 之后。 */
result = xrtMultipartCloseWrite(pBoundary, pOutput, iCapacity, pSize);