source: Dev/branches/rest-dojo-ui/client/dojo/io-query.js @ 256

define(["./_base/lang"], function(lang){
        // module:
        //              dojo/io-query
        // summary:
        //              This module defines query string processing functions.

    var backstop = {};

    function objectToQuery(/*Object*/ map){
        // summary:
        //              takes a name/value mapping object and returns a string representing
        //              a URL-encoded version of that object.
        // example:
        //              this object:
        //
        //      |       {
        //      |               blah: "blah",
        //      |               multi: [
        //      |                       "thud",
        //      |                       "thonk"
        //      |               ]
        //      |       };
        //
        // yields the following query string:
        //
        //      |       "blah=blah&multi=thud&multi=thonk"

        // FIXME: need to implement encodeAscii!!
        var enc = encodeURIComponent, pairs = [];
        for(var name in map){
            var value = map[name];
            if(value != backstop[name]){
                var assign = enc(name) + "=";
                if(lang.isArray(value)){
                    for(var i = 0, l = value.length; i < l; ++i){
                        pairs.push(assign + enc(value[i]));
                    }
                }else{
                    pairs.push(assign + enc(value));
                }
            }
        }
        return pairs.join("&"); // String
    }

    function queryToObject(/*String*/ str){
        // summary:
        //              Create an object representing a de-serialized query section of a
        //              URL. Query keys with multiple values are returned in an array.
        //
        // example:
        //              This string:
        //
        //      |               "foo=bar&foo=baz&thinger=%20spaces%20=blah&zonk=blarg&"
        //
        //              results in this object structure:
        //
        //      |               {
        //      |                       foo: [ "bar", "baz" ],
        //      |                       thinger: " spaces =blah",
        //      |                       zonk: "blarg"
        //      |               }
        //
        //              Note that spaces and other urlencoded entities are correctly
        //              handled.

        // FIXME: should we grab the URL string if we're not passed one?
        var dec = decodeURIComponent, qp = str.split("&"), ret = {}, name, val;
        for(var i = 0, l = qp.length, item; i < l; ++i){
            item = qp[i];
            if(item.length){
                var s = item.indexOf("=");
                if(s < 0){
                    name = dec(item);
                    val = "";
                }else{
                    name = dec(item.slice(0, s));
                    val  = dec(item.slice(s + 1));
                }
                if(typeof ret[name] == "string"){ // inline'd type check
                    ret[name] = [ret[name]];
                }

                if(lang.isArray(ret[name])){
                    ret[name].push(val);
                }else{
                    ret[name] = val;
                }
            }
        }
        return ret; // Object
    }

    return {
        objectToQuery: objectToQuery,
        queryToObject: queryToObject
    };
});