# 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` 使用的反轉意函數,在必要的時候可被重寫。