# Query String
~~~
稳定度: 3 - 稳定
~~~
这个模块提供一些处理 query string 的工具。它提供下列方法:
### querystring.stringify(obj, [sep], [eq])
序列化一个对象到一个 query string。可以选择是否覆盖默认的分割符(`'&'`)和分配符(`'='`)。
实例:
~~~
querystring.stringify({foo: 'bar', baz: 'qux'}, ';', ':')
// 返回如下字串
'foo:bar;baz:qux'
~~~
### querystring.parse(str, [sep], [eq], [options])
将一个 query string 反序列化为一个对象。可以选择是否覆盖默认的分割符(`'&'`)和分配符(`'='`)。
options对象可能包含`maxKeys`属性(默认为1000),它可以用来限制处理过的键(key)的数量.设为0可以去除键(key)的数量限制.
实例:
~~~
querystring.parse('foo=bar&baz=qux&baz=quux&corge')
// returns
{ foo: 'bar', baz: ['qux', 'quux'], corge: '' }
~~~
### querystring.escape
供 `querystring.stringify` 使用的转意函数,在必要的时候可被重写。
### querystring.unescape
供 `querystring.parse` 使用的反转意函数,在必要的时候可被重写。