📄 websurlparse.htm
字号:
<html><head><!- Copyright (c) Go Ahead Software Inc., 1995-2000. All Rights Reserved. -><title>websUrlParse -- GoAhead WebServer API</title><link rel="stylesheet" href="../../../style/doc.css" type="text/css"></head><body><table width="550"> <tr><td><TABLE border=0 width=100% cellspacing=0 cellpadding=0 CLASS="apiTitle"> <TR> <td class="titleLeft" align=left width="33%"><b>websUrlParse</b></TD><td class="titleCenter" align=center width="33%"><b> GoAhead WebServer API</b></TD><td class="titleRight" align=right width="33%"><B> GoAhead EMF</B></TD></TR> </TABLE><HR> <h2>Synopsis</h2><p>Parse a URL into its component parts.</p><h2>Prototype</h2><pre> #include "webs.h" int <B>websUrlParse</B>(char_t *url, char_t **buf, char_t **host, char_t **path, char_t **port, char_t **query, char_t **proto, char_t **tag, char_t **ext);</pre><h2>Parameters</h2><table width=100% BORDER="0" CELLPADDING="0" CELLSPACING="0"> <TR> <TD VALIGN="TOP" WIDTH="6%">url <TD WIDTH="94%">Source URL to parse.<TR> <TD VALIGN="TOP" WIDTH="6%">buf <TD WIDTH="94%">Pointer to buffer used to hold the parsed components.<TR> <TD VALIGN="TOP" WIDTH="6%">host <TD WIDTH="94%">Host name. <TR> <TD VALIGN="TOP" WIDTH="6%">path <TD WIDTH="94%">URL path portion after the host name and optional port. <TR> <TD VALIGN="TOP" WIDTH="6%">query <TD WIDTH="94%">Optional query string portion after "?" .<TR> <TD VALIGN="TOP" WIDTH="6%">proto <TD WIDTH="94%">Protocol. Usually "http".<TR> <TD VALIGN="TOP" WIDTH="6%">tag <TD WIDTH="94%">Optional tag portion after "#".<TR> <TD VALIGN="TOP" WIDTH="6%">ext <TD WIDTH="94%">Document file name extension.</TD></TR></table><h2>Description</h2><P> The websUrlParse procedure cracks the URL into its constituent components. To store the parts, websUrlParse allocates a dynamic buffer. This must eventually be freed via <A href="../basicapi/bfree.htm">bfree</A> by the caller.</P><P>websUrlParse stores pointers to the URL components in <EM>host, path, port, query, proto, tag </EM>and <EM>ext. </EM>If any of these parameters contains NULL, that component is ignored.</P><P> <B>Note:</B> Tag parsing is not fully supported.</P><h2>Return Value</h2><p> Returns 0 if successful. Returns -1 if memory cannot be allocated to hold the results.</p><h2>Example</h2><pre> char_t *host, *port, *buf; websUrlParse(url, &buf, &host, NULL, &port, NULL, NULL, NULL, NULL); </pre><h2>Stability Classification</h2><p>Stable.</p><h2>See Also</h2><p> <A href="../basicapi/balloc.htm">balloc</A>, <A href="../basicapi/bfree.htm">bfree</A>, <A href="websUrlType.htm">websUrlType</A> </p></td></tr></table></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -