7ae5032025b2344c0157d06e1a17b431b77a8a9f
[atutor.git] / mods / atutor_opencaps / opencaps / js / json / json2.js
1 /*
2     http://www.JSON.org/json2.js
3     2009-06-29
4
5     Public Domain.
6
7     NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.
8
9     See http://www.JSON.org/js.html
10
11     This file creates a global JSON object containing two methods: stringify
12     and parse.
13
14         JSON.stringify(value, replacer, space)
15             value       any JavaScript value, usually an object or array.
16
17             replacer    an optional parameter that determines how object
18                         values are stringified for objects. It can be a
19                         function or an array of strings.
20
21             space       an optional parameter that specifies the indentation
22                         of nested structures. If it is omitted, the text will
23                         be packed without extra whitespace. If it is a number,
24                         it will specify the number of spaces to indent at each
25                         level. If it is a string (such as '\t' or ' '),
26                         it contains the characters used to indent at each level.
27
28             This method produces a JSON text from a JavaScript value.
29
30             When an object value is found, if the object contains a toJSON
31             method, its toJSON method will be called and the result will be
32             stringified. A toJSON method does not serialize: it returns the
33             value represented by the name/value pair that should be serialized,
34             or undefined if nothing should be serialized. The toJSON method
35             will be passed the key associated with the value, and this will be
36             bound to the object holding the key.
37
38             For example, this would serialize Dates as ISO strings.
39
40                 Date.prototype.toJSON = function (key) {
41                     function f(n) {
42                         // Format integers to have at least two digits.
43                         return n < 10 ? '0' + n : n;
44                     }
45
46                     return this.getUTCFullYear()   + '-' +
47                          f(this.getUTCMonth() + 1) + '-' +
48                          f(this.getUTCDate())      + 'T' +
49                          f(this.getUTCHours())     + ':' +
50                          f(this.getUTCMinutes())   + ':' +
51                          f(this.getUTCSeconds())   + 'Z';
52                 };
53
54             You can provide an optional replacer method. It will be passed the
55             key and value of each member, with this bound to the containing
56             object. The value that is returned from your method will be
57             serialized. If your method returns undefined, then the member will
58             be excluded from the serialization.
59
60             If the replacer parameter is an array of strings, then it will be
61             used to select the members to be serialized. It filters the results
62             such that only members with keys listed in the replacer array are
63             stringified.
64
65             Values that do not have JSON representations, such as undefined or
66             functions, will not be serialized. Such values in objects will be
67             dropped; in arrays they will be replaced with null. You can use
68             a replacer function to replace those with JSON values.
69             JSON.stringify(undefined) returns undefined.
70
71             The optional space parameter produces a stringification of the
72             value that is filled with line breaks and indentation to make it
73             easier to read.
74
75             If the space parameter is a non-empty string, then that string will
76             be used for indentation. If the space parameter is a number, then
77             the indentation will be that many spaces.
78
79             Example:
80
81             text = JSON.stringify(['e', {pluribus: 'unum'}]);
82             // text is '["e",{"pluribus":"unum"}]'
83
84
85             text = JSON.stringify(['e', {pluribus: 'unum'}], null, '\t');
86             // text is '[\n\t"e",\n\t{\n\t\t"pluribus": "unum"\n\t}\n]'
87
88             text = JSON.stringify([new Date()], function (key, value) {
89                 return this[key] instanceof Date ?
90                     'Date(' + this[key] + ')' : value;
91             });
92             // text is '["Date(---current time---)"]'
93
94
95         JSON.parse(text, reviver)
96             This method parses a JSON text to produce an object or array.
97             It can throw a SyntaxError exception.
98
99             The optional reviver parameter is a function that can filter and
100             transform the results. It receives each of the keys and values,
101             and its return value is used instead of the original value.
102             If it returns what it received, then the structure is not modified.
103             If it returns undefined then the member is deleted.
104
105             Example:
106
107             // Parse the text. Values that look like ISO date strings will
108             // be converted to Date objects.
109
110             myData = JSON.parse(text, function (key, value) {
111                 var a;
112                 if (typeof value === 'string') {
113                     a =
114 /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}(?:\.\d*)?)Z$/.exec(value);
115                     if (a) {
116                         return new Date(Date.UTC(+a[1], +a[2] - 1, +a[3], +a[4],
117                             +a[5], +a[6]));
118                     }
119                 }
120                 return value;
121             });
122
123             myData = JSON.parse('["Date(09/09/2001)"]', function (key, value) {
124                 var d;
125                 if (typeof value === 'string' &&
126                         value.slice(0, 5) === 'Date(' &&
127                         value.slice(-1) === ')') {
128                     d = new Date(value.slice(5, -1));
129                     if (d) {
130                         return d;
131                     }
132                 }
133                 return value;
134             });
135
136
137     This is a reference implementation. You are free to copy, modify, or
138     redistribute.
139
140     This code should be minified before deployment.
141     See http://javascript.crockford.com/jsmin.html
142
143     USE YOUR OWN COPY. IT IS EXTREMELY UNWISE TO LOAD CODE FROM SERVERS YOU DO
144     NOT CONTROL.
145 */
146
147 /*jslint evil: true */
148
149 /*members "", "\b", "\t", "\n", "\f", "\r", "\"", JSON, "\\", apply,
150     call, charCodeAt, getUTCDate, getUTCFullYear, getUTCHours,
151     getUTCMinutes, getUTCMonth, getUTCSeconds, hasOwnProperty, join,
152     lastIndex, length, parse, prototype, push, replace, slice, stringify,
153     test, toJSON, toString, valueOf
154 */
155
156 // Create a JSON object only if one does not already exist. We create the
157 // methods in a closure to avoid creating global variables.
158
159 var JSON = JSON || {};
160
161 (function () {
162
163     function f(n) {
164         // Format integers to have at least two digits.
165         return n < 10 ? '0' + n : n;
166     }
167
168     if (typeof Date.prototype.toJSON !== 'function') {
169
170         Date.prototype.toJSON = function (key) {
171
172             return isFinite(this.valueOf()) ?
173                    this.getUTCFullYear()   + '-' +
174                  f(this.getUTCMonth() + 1) + '-' +
175                  f(this.getUTCDate())      + 'T' +
176                  f(this.getUTCHours())     + ':' +
177                  f(this.getUTCMinutes())   + ':' +
178                  f(this.getUTCSeconds())   + 'Z' : null;
179         };
180
181         String.prototype.toJSON =
182         Number.prototype.toJSON =
183         Boolean.prototype.toJSON = function (key) {
184             return this.valueOf();
185         };
186     }
187
188     var cx = /[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
189         escapable = /[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
190         gap,
191         indent,
192         meta = {    // table of character substitutions
193             '\b': '\\b',
194             '\t': '\\t',
195             '\n': '\\n',
196             '\f': '\\f',
197             '\r': '\\r',
198             '"' : '\\"',
199             '\\': '\\\\'
200         },
201         rep;
202
203
204     function quote(string) {
205
206 // If the string contains no control characters, no quote characters, and no
207 // backslash characters, then we can safely slap some quotes around it.
208 // Otherwise we must also replace the offending characters with safe escape
209 // sequences.
210
211         escapable.lastIndex = 0;
212         return escapable.test(string) ?
213             '"' + string.replace(escapable, function (a) {
214                 var c = meta[a];
215                 return typeof c === 'string' ? c :
216                     '\\u' + ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
217             }) + '"' :
218             '"' + string + '"';
219     }
220
221
222     function str(key, holder) {
223
224 // Produce a string from holder[key].
225
226         var i,          // The loop counter.
227             k,          // The member key.
228             v,          // The member value.
229             length,
230             mind = gap,
231             partial,
232             value = holder[key];
233
234 // If the value has a toJSON method, call it to obtain a replacement value.
235
236         if (value && typeof value === 'object' &&
237                 typeof value.toJSON === 'function') {
238             value = value.toJSON(key);
239         }
240
241 // If we were called with a replacer function, then call the replacer to
242 // obtain a replacement value.
243
244         if (typeof rep === 'function') {
245             value = rep.call(holder, key, value);
246         }
247
248 // What happens next depends on the value's type.
249
250         switch (typeof value) {
251         case 'string':
252             return quote(value);
253
254         case 'number':
255
256 // JSON numbers must be finite. Encode non-finite numbers as null.
257
258             return isFinite(value) ? String(value) : 'null';
259
260         case 'boolean':
261         case 'null':
262
263 // If the value is a boolean or null, convert it to a string. Note:
264 // typeof null does not produce 'null'. The case is included here in
265 // the remote chance that this gets fixed someday.
266
267             return String(value);
268
269 // If the type is 'object', we might be dealing with an object or an array or
270 // null.
271
272         case 'object':
273
274 // Due to a specification blunder in ECMAScript, typeof null is 'object',
275 // so watch out for that case.
276
277             if (!value) {
278                 return 'null';
279             }
280
281 // Make an array to hold the partial results of stringifying this object value.
282
283             gap += indent;
284             partial = [];
285
286 // Is the value an array?
287
288             if (Object.prototype.toString.apply(value) === '[object Array]') {
289
290 // The value is an array. Stringify every element. Use null as a placeholder
291 // for non-JSON values.
292
293                 length = value.length;
294                 for (i = 0; i < length; i += 1) {
295                     partial[i] = str(i, value) || 'null';
296                 }
297
298 // Join all of the elements together, separated with commas, and wrap them in
299 // brackets.
300
301                 v = partial.length === 0 ? '[]' :
302                     gap ? '[\n' + gap +
303                             partial.join(',\n' + gap) + '\n' +
304                                 mind + ']' :
305                           '[' + partial.join(',') + ']';
306                 gap = mind;
307                 return v;
308             }
309
310 // If the replacer is an array, use it to select the members to be stringified.
311
312             if (rep && typeof rep === 'object') {
313                 length = rep.length;
314                 for (i = 0; i < length; i += 1) {
315                     k = rep[i];
316                     if (typeof k === 'string') {
317                         v = str(k, value);
318                         if (v) {
319                             partial.push(quote(k) + (gap ? ': ' : ':') + v);
320                         }
321                     }
322                 }
323             } else {
324
325 // Otherwise, iterate through all of the keys in the object.
326
327                 for (k in value) {
328                     if (Object.hasOwnProperty.call(value, k)) {
329                         v = str(k, value);
330                         if (v) {
331                             partial.push(quote(k) + (gap ? ': ' : ':') + v);
332                         }
333                     }
334                 }
335             }
336
337 // Join all of the member texts together, separated with commas,
338 // and wrap them in braces.
339
340             v = partial.length === 0 ? '{}' :
341                 gap ? '{\n' + gap + partial.join(',\n' + gap) + '\n' +
342                         mind + '}' : '{' + partial.join(',') + '}';
343             gap = mind;
344             return v;
345         }
346     }
347
348 // If the JSON object does not yet have a stringify method, give it one.
349
350     if (typeof JSON.stringify !== 'function') {
351         JSON.stringify = function (value, replacer, space) {
352
353 // The stringify method takes a value and an optional replacer, and an optional
354 // space parameter, and returns a JSON text. The replacer can be a function
355 // that can replace values, or an array of strings that will select the keys.
356 // A default replacer method can be provided. Use of the space parameter can
357 // produce text that is more easily readable.
358
359             var i;
360             gap = '';
361             indent = '';
362
363 // If the space parameter is a number, make an indent string containing that
364 // many spaces.
365
366             if (typeof space === 'number') {
367                 for (i = 0; i < space; i += 1) {
368                     indent += ' ';
369                 }
370
371 // If the space parameter is a string, it will be used as the indent string.
372
373             } else if (typeof space === 'string') {
374                 indent = space;
375             }
376
377 // If there is a replacer, it must be a function or an array.
378 // Otherwise, throw an error.
379
380             rep = replacer;
381             if (replacer && typeof replacer !== 'function' &&
382                     (typeof replacer !== 'object' ||
383                      typeof replacer.length !== 'number')) {
384                 throw new Error('JSON.stringify');
385             }
386
387 // Make a fake root object containing our value under the key of ''.
388 // Return the result of stringifying the value.
389
390             return str('', {'': value});
391         };
392     }
393
394
395 // If the JSON object does not yet have a parse method, give it one.
396
397     if (typeof JSON.parse !== 'function') {
398         JSON.parse = function (text, reviver) {
399
400 // The parse method takes a text and an optional reviver function, and returns
401 // a JavaScript value if the text is a valid JSON text.
402
403             var j;
404
405             function walk(holder, key) {
406
407 // The walk method is used to recursively walk the resulting structure so
408 // that modifications can be made.
409
410                 var k, v, value = holder[key];
411                 if (value && typeof value === 'object') {
412                     for (k in value) {
413                         if (Object.hasOwnProperty.call(value, k)) {
414                             v = walk(value, k);
415                             if (v !== undefined) {
416                                 value[k] = v;
417                             } else {
418                                 delete value[k];
419                             }
420                         }
421                     }
422                 }
423                 return reviver.call(holder, key, value);
424             }
425
426
427 // Parsing happens in four stages. In the first stage, we replace certain
428 // Unicode characters with escape sequences. JavaScript handles many characters
429 // incorrectly, either silently deleting them, or treating them as line endings.
430
431             cx.lastIndex = 0;
432             if (cx.test(text)) {
433                 text = text.replace(cx, function (a) {
434                     return '\\u' +
435                         ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
436                 });
437             }
438
439 // In the second stage, we run the text against regular expressions that look
440 // for non-JSON patterns. We are especially concerned with '()' and 'new'
441 // because they can cause invocation, and '=' because it can cause mutation.
442 // But just to be safe, we want to reject all unexpected forms.
443
444 // We split the second stage into 4 regexp operations in order to work around
445 // crippling inefficiencies in IE's and Safari's regexp engines. First we
446 // replace the JSON backslash pairs with '@' (a non-JSON character). Second, we
447 // replace all simple value tokens with ']' characters. Third, we delete all
448 // open brackets that follow a colon or comma or that begin the text. Finally,
449 // we look to see that the remaining characters are only whitespace or ']' or
450 // ',' or ':' or '{' or '}'. If that is so, then the text is safe for eval.
451
452             if (/^[\],:{}\s]*$/.
453 test(text.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, '@').
454 replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, ']').
455 replace(/(?:^|:|,)(?:\s*\[)+/g, ''))) {
456
457 // In the third stage we use the eval function to compile the text into a
458 // JavaScript structure. The '{' operator is subject to a syntactic ambiguity
459 // in JavaScript: it can begin a block or an object literal. We wrap the text
460 // in parens to eliminate the ambiguity.
461
462                 j = eval('(' + text + ')');
463
464 // In the optional fourth stage, we recursively walk the new structure, passing
465 // each name/value pair to a reviver function for possible transformation.
466
467                 return typeof reviver === 'function' ?
468                     walk({'': j}, '') : j;
469             }
470
471 // If the text is not JSON parseable, then a SyntaxError is thrown.
472
473             throw new SyntaxError('JSON.parse');
474         };
475     }
476 }());