Sofia-SIP辅助文档十七 - Sofia SIP用户代理库 - "url" - URL模块

http://sofia-sip.sourceforge.net/refdocs/url/index.html，翻译自官网的这张网页。

模块元信息

Sofia url模块包括一些使用URL数据类型url_t的宏和函数，他们可以解析和打印URL。

联系人:

Pekka Pessi < Pekka.Pessi@nokia-email.address.hidden>

状态:

Sofia SIP Core library

许可:

LGPL

使用URL库

URL库提供了URL的数据类型以及与之相关的辅助函数。URL解析器可以将URL里的组件分离出来放入url_t结构体内。

注：

请注意我们认为URL和URI是可互相替换的术语。

正式的URI语法在RFC 3986里被严格定义。

URLs包括可打印ASCII字符集的一个子集。这个子集不包括空格和在基于文本的协议中通常用作分隔符的字符，例如< > # %和 " （双引号），这些字符的位置在ECMA-5中预留给了国家扩展。在US-ASCII中，这些字符是：{ } | \ ^ [ ] `。

还有九个字符在URI的某些部分有着特殊的含义。这些保留字符用来分隔URL中的各个语法部分。这些保留字符是：@ / ; ? & = + and $。

URL库能够理解两种URL语法。首先，基本语法，例如被用于ftp:，http:和rtsp:这些URL：

scheme ":" ["//" [ user [":" password ] "@"] host [":" port ] ] ["/" path ] ["?" query ] ["#" fragment ]

另一种，被用于mailto:，sip:，im:，tel和pres:等URL：

scheme ":" [ [ user [":" password ] "@"] host [":" port ] ] [";" params ] ["?" query ] ["#" fragment ]

注意url解析器会认为“*”是一个合法的URL。

例如：

http://example.org:7100/cgi-bin/query?key=90786
ftp://user:pass\@ftp.example.com/pub/
sip:user:pass\@example.com;user=ip
tel:+358718008000

字串转换成#url_t

url_make()函数可以将一个字串转换成新生成的url_t结构体。URL中的各个组件会被分离出来。如果十六进制表示法的编码字符在URL的这一部分是合法字符，那么就可以移出这个十六进制表示的字串。例如，"%41"被解码成"A"在user部分，但"%40" (@)不做任何转换。（This is called canonization of the URL fields.）

url_format()函数可以生成URL，它有着类似于printf()函数相似的格式化功能。

例如，当我们想从如下字串中生成一个URL

sip:joe%2Euser@example%2Ecom;method=%4D%45%53%53%41%47%45?body=CANNED%20MSG

各个组件是\0结束的，canonized，向如下所示赋给结构体：