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,向如下所示赋给结构体: