xhttp/http_link

void xrtHttpLinkCursorInit(xhttplinkcursor* pCursor);

httplinkcursorinit obj;
xrtHttpLinkCursorInit(&obj, pCursor);

void xrtHttpLinkFieldCursorInit( xhttplinkfieldcursor* pCursor );

httplinkfieldcursorinit obj;
xrtHttpLinkFieldCursorInit(&obj, pCursor);

bool xrtHttpLinkElementParse( xstrview Element, xhttplink* pLink );

/* 严格解析一个 link-value；rel 必须存在，结果借用 Element。 */
result = xrtHttpLinkElementParse(Element, pLink);

bool xrtHttpLinkValid(xstrview Value);

/* 严格验证完整 Link 字段值；空列表符合 RFC 的列表语法。 */
result = xrtHttpLinkValid(Value);

xhttpnext xrtHttpLinkNext( xstrview Value, xhttplinkcursor* pCursor, xhttplink* pLink );

/* 按线路顺序迭代一个完整 Link 字段值。 */
result = xrtHttpLinkNext(Value, pCursor, pLink);

xhttpnext xrtHttpLinkFieldNext( const xhttpfield* pFields, size_t iCount, xhttplinkfieldcursor* pCursor, xhttplink* pLink );

/* 跨重复 Link 字段行按线路顺序迭代链接。 */
result = xrtHttpLinkFieldNext(pFields, iCount, pCursor, pLink);

xhttpnext xrtHttpLinkParam( const xhttplink* pLink, xstrview Name, xhttpparam* pParam );

/* 严格查找第一个参数；未命中返回 END，结果借用 Link 字段。 */
result = xrtHttpLinkParam(pLink, Name, pParam);

xhttpnext xrtHttpLinkRelationFind( const xhttplink* pLink, xstrview Relation );

/* 按 RFC 8288 的大小写不敏感规则查找关系类型。 */
result = xrtHttpLinkRelationFind(pLink, Relation);

bool xrtHttpLinkAnchorWrite( const xhttplink* pLink, void* pOutput, size_t iCapacity, size_t* pSize );

/* 解码 anchor 参数；不存在时返回 VALUE 错误，不执行 URI 解析。 */
result = xrtHttpLinkAnchorWrite(pLink, pOutput, iCapacity, pSize);

str xrtHttpLinkAnchorBuild( const xhttplink* pLink, size_t* pSize );

/* 构建零结尾 anchor，返回值由 xrtFree 释放。 */
result = xrtHttpLinkAnchorBuild(pLink, pSize);

bool xrtHttpLinkTitleWrite( const xhttplink* pLink, void* pOutput, size_t iCapacity, size_t* pSize );

/* 读取 UTF-8 标题；优先 title*，不支持的字符集回退 title。 */
result = xrtHttpLinkTitleWrite(pLink, pOutput, iCapacity, pSize);

str xrtHttpLinkTitleBuild( const xhttplink* pLink, size_t* pSize );

/* 构建零结尾 UTF-8 标题，返回值由 xrtFree 释放。 */
result = xrtHttpLinkTitleBuild(pLink, pSize);

bool xrtHttpLinkTargetResolve( const xhttplink* pLink, const xurl* pBase, void* pOutput, size_t iCapacity, size_t* pSize );

/* 零分配使用 RFC 3986 Base 解析链接目标；输出不带零结尾。 */
result = xrtHttpLinkTargetResolve(pLink, pBase, pOutput, iCapacity, pSize);

str xrtHttpLinkTargetResolveBuild( const xhttplink* pLink, const xurl* pBase, size_t* pSize );

/* 分配并解析链接目标，返回值由 xrtFree 释放。 */
result = xrtHttpLinkTargetResolveBuild(pLink, pBase, pSize);

bool xrtHttpLinkElementWrite( const xhttplinkvalue* pLink, void* pOutput, size_t iCapacity, size_t* pSize );

/* 规范写出一个 link-value，不附加字段名称或 CRLF。 */
result = xrtHttpLinkElementWrite(pLink, pOutput, iCapacity, pSize);

bool xrtHttpLinkWrite( const xhttplinkvalue* pLinks, size_t iCount, void* pOutput, size_t iCapacity, size_t* pSize );

/* 规范写出逗号分隔的 Link 元素数组。 */
result = xrtHttpLinkWrite(pLinks, iCount, pOutput, iCapacity, pSize);

str xrtHttpLinkBuild( const xhttplinkvalue* pLinks, size_t iCount, size_t* pSize );

/* 构建零结尾 Link 字段值，返回值由 xrtFree 释放。 */
result = xrtHttpLinkBuild(pLinks, iCount, pSize);