xhttp/query

;

/* XRT_API xquerynext xrtQueryNext( xstrview Query, size_t* pOffset, xquerypair* pPair ); */
result = xrtQueryNext();

bool xrtQueryCount(xstrview Query, size_t* pCount);

/* 统计查询项；正常空查询返回零，失败时不修改 Count。 */
result = xrtQueryCount(Query, pCount);

bool xrtQueryValidate( xstrview Query, const xquerylimits* pLimits, size_t* pCount );

/* 按显式 pair/key/value 限额验证结构；Limits 为空时仅统计。 */
result = xrtQueryValidate(Query, pLimits, pCount);

;

/* XRT_API xquerynext xrtQueryFind( xstrview Query, xstrview Key, size_t* pOffset, xquerypair* pPair ); */
result = xrtQueryFind();

bool xrtQueryRawWrite( const xquerypair* pPairs, size_t iCount, void* pOutput, size_t iCapacity, size_t* pSize );

/* 写出不含前导问号和零结尾的已编码原始查询；空输出可查询精确长度。 */
result = xrtQueryRawWrite(pPairs, iCount, pOutput, iCapacity, pSize);

str xrtQueryRawBuild( const xquerypair* pPairs, size_t iCount, size_t* pSize );

/* 分配并构建零结尾的已编码原始查询；返回值由 xrtFree 释放。 */
result = xrtQueryRawBuild(pPairs, iCount, pSize);

bool xrtQueryWrite( const xquerypair* pPairs, size_t iCount, void* pOutput, size_t iCapacity, size_t* pSize );

/* 按 RFC 3986 编码键和值并写出查询；空输出可查询不含零结尾的精确长度。 */
result = xrtQueryWrite(pPairs, iCount, pOutput, iCapacity, pSize);

str xrtQueryBuild( const xquerypair* pPairs, size_t iCount, size_t* pSize );

/* 按 RFC 3986 编码键和值并构建零结尾查询；返回值由 xrtFree 释放。 */
result = xrtQueryBuild(pPairs, iCount, pSize);