light9: static/QueryString.js annotate

annotate static/QueryString.js @ 1149:ef29453b307f

EE song time fetcher now coasts forwards with local clock Ignore-this: 23dc3675c7ac6a877367979bff5ed12a

author	drewp@bigasterisk.com
date	Sat, 14 Jun 2014 22:30:15 +0000
parents	a4632a7b2e17
children

rev	line source
1041 a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	1 // This is public domain code written in 2011 by Jan Wolter and distributed
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	2 // for free at http://unixpapa.com/js/querystring.html
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	3 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	4 // Query String Parser
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	5 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	6 // qs= new QueryString()
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	7 // qs= new QueryString(string)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	8 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	9 // Create a query string object based on the given query string. If
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	10 // no string is given, we use the one from the current page by default.
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	11 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	12 // qs.value(key)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	13 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	14 // Return a value for the named key. If the key was not defined,
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	15 // it will return undefined. If the key was multiply defined it will
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	16 // return the last value set. If it was defined without a value, it
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	17 // will return an empty string.
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	18 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	19 // qs.values(key)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	20 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	21 // Return an array of values for the named key. If the key was not
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	22 // defined, an empty array will be returned. If the key was multiply
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	23 // defined, the values will be given in the order they appeared on
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	24 // in the query string.
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	25 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	26 // qs.keys()
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	27 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	28 // Return an array of unique keys in the query string. The order will
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	29 // not necessarily be the same as in the original query, and repeated
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	30 // keys will only be listed once.
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	31 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	32 // QueryString.decode(string)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	33 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	34 // This static method is an error tolerant version of the builtin
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	35 // function decodeURIComponent(), modified to also change pluses into
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	36 // spaces, so that it is suitable for query string decoding. You
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	37 // shouldn't usually need to call this yourself as the value(),
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	38 // values(), and keys() methods already decode everything they return.
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	39 //
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	40 // Note: W3C recommends that ; be accepted as an alternative to & for
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	41 // separating query string fields. To support that, simply insert a semicolon
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	42 // immediately after each ampersand in the regular expression in the first
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	43 // function below.
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	44
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	45 function QueryString(qs)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	46 {
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	47 this.dict= {};
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	48
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	49 // If no query string was passed in use the one from the current page
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	50 if (!qs) qs= location.search;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	51
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	52 // Delete leading question mark, if there is one
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	53 if (qs.charAt(0) == '?') qs= qs.substring(1);
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	54
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	55 // Parse it
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	56 var re= /([^=&]+)(=([^&]*))?/g;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	57 while (match= re.exec(qs))
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	58 {
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	59 var key= decodeURIComponent(match[1].replace(/\+/g,' '));
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	60 var value= match[3] ? QueryString.decode(match[3]) : '';
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	61 if (this.dict[key])
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	62 this.dict[key].push(value);
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	63 else
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	64 this.dict[key]= [value];
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	65 }
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	66 }
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	67
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	68 QueryString.decode= function(s)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	69 {
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	70 s= s.replace(/\+/g,' ');
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	71 s= s.replace(/%([EF][0-9A-F])%([89AB][0-9A-F])%([89AB][0-9A-F])/gi,
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	72 function(code,hex1,hex2,hex3)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	73 {
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	74 var n1= parseInt(hex1,16)-0xE0;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	75 var n2= parseInt(hex2,16)-0x80;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	76 if (n1 == 0 && n2 < 32) return code;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	77 var n3= parseInt(hex3,16)-0x80;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	78 var n= (n1<<12) + (n2<<6) + n3;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	79 if (n > 0xFFFF) return code;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	80 return String.fromCharCode(n);
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	81 });
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	82 s= s.replace(/%([CD][0-9A-F])%([89AB][0-9A-F])/gi,
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	83 function(code,hex1,hex2)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	84 {
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	85 var n1= parseInt(hex1,16)-0xC0;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	86 if (n1 < 2) return code;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	87 var n2= parseInt(hex2,16)-0x80;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	88 return String.fromCharCode((n1<<6)+n2);
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	89 });
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	90 s= s.replace(/%([0-7][0-9A-F])/gi,
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	91 function(code,hex)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	92 {
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	93 return String.fromCharCode(parseInt(hex,16));
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	94 });
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	95 return s;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	96 };
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	97
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	98 QueryString.prototype.value= function (key)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	99 {
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	100 var a= this.dict[key];
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	101 return a ? a[a.length-1] : undefined;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	102 };
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	103
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	104 QueryString.prototype.values= function (key)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	105 {
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	106 var a= this.dict[key];
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	107 return a ? a : [];
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	108 };
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	109
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	110 QueryString.prototype.keys= function ()
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	111 {
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	112 var a= [];
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	113 for (var key in this.dict)
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	114 a.push(key);
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	115 return a;
a4632a7b2e17 upgrade knockout and jquery, simplify the static/ dirs for all web services Drew Perttula <drewp@bigasterisk.com> parents: diff changeset	116 };