/* jQuery strings - 0.3 http://code.google.com/p/jquery-utils/ (c) Maxime Haineault http://haineault.com MIT License (http://www.opensource.org/licenses/mit-license.php) Implementation of Python3K advanced string formatting http://www.python.org/dev/peps/pep-3101/ Documentation: http://code.google.com/p/jquery-utils/wiki/StringFormat */ (function($){ var strings = { strConversion: { // tries to translate any objects type into string gracefully __repr: function(i){ switch(this.__getType(i)) { case 'array':case 'date':case 'number': return i.toString(); case 'object': var o = []; for (x=0; x 0) { o = new Array(Math.ceil(l / p.length)).join(p).substr(0, t = !t ? l : t == 1 ? 0 : Math.ceil(l / 2)) + str + p.substr(0, l - t); } return o; }, __getInput: function(arg, args) { var key = arg.getKey(); switch(this.__getType(args)){ case 'object': // Thanks to Jonathan Works for the patch var keys = key.split('.'); var obj = args; for(var subkey = 0; subkey < keys.length; subkey++){ obj = obj[keys[subkey]]; } if (typeof(obj) != 'undefined') { if (strings.strConversion.__getType(obj) == 'array') { return arg.getFormat().match(/\.\*/) && obj[1] || obj; } return obj; } else { // TODO: try by numerical index } break; case 'array': key = parseInt(key, 10); if (arg.getFormat().match(/\.\*/) && typeof args[key+1] != 'undefined') { return args[key+1]; } else if (typeof args[key] != 'undefined') { return args[key]; } else { return key; } break; } return '{'+key+'}'; }, __formatToken: function(token, args) { var arg = new Argument(token, args); return strings.strConversion[arg.getFormat().slice(-1)](this.__getInput(arg, args), arg); }, // Signed integer decimal. d: function(input, arg){ var o = parseInt(input, 10); // enforce base 10 var p = arg.getPaddingLength(); if (p) { return this.__pad(o.toString(), p, arg.getPaddingString(), 0); } else { return o; } }, // Signed integer decimal. i: function(input, args){ return this.d(input, args); }, // Unsigned octal o: function(input, arg){ var o = input.toString(8); if (arg.isAlternate()) { o = this.__pad(o, o.length+1, '0', 0); } return this.__pad(o, arg.getPaddingLength(), arg.getPaddingString(), 0); }, // Unsigned decimal u: function(input, args) { return Math.abs(this.d(input, args)); }, // Unsigned hexadecimal (lowercase) x: function(input, arg){ var o = parseInt(input, 10).toString(16); o = this.__pad(o, arg.getPaddingLength(), arg.getPaddingString(),0); return arg.isAlternate() ? '0x'+o : o; }, // Unsigned hexadecimal (uppercase) X: function(input, arg){ return this.x(input, arg).toUpperCase(); }, // Floating point exponential format (lowercase) e: function(input, arg){ return parseFloat(input, 10).toExponential(arg.getPrecision()); }, // Floating point exponential format (uppercase) E: function(input, arg){ return this.e(input, arg).toUpperCase(); }, // Floating point decimal format f: function(input, arg){ return this.__pad(parseFloat(input, 10).toFixed(arg.getPrecision()), arg.getPaddingLength(), arg.getPaddingString(),0); }, // Floating point decimal format (alias) F: function(input, args){ return this.f(input, args); }, // Floating point format. Uses exponential format if exponent is greater than -4 or less than precision, decimal format otherwise g: function(input, arg){ var o = parseFloat(input, 10); return (o.toString().length > 6) ? Math.round(o.toExponential(arg.getPrecision())): o; }, // Floating point format. Uses exponential format if exponent is greater than -4 or less than precision, decimal format otherwise G: function(input, args){ return this.g(input, args); }, // Single character (accepts integer or single character string). c: function(input, args) { var match = input.match(/\w|\d/); return match && match[0] || ''; }, // String (converts any JavaScript object to anotated format) r: function(input, args) { return this.__repr(input); }, // String (converts any JavaScript object using object.toString()) s: function(input, args) { return input.toString && input.toString() || ''+input; } }, format: function(str, args) { var end = 0; var start = 0; var match = false; var buffer = []; var token = ''; var tmp = (str||'').split(''); for(start=0; start < tmp.length; start++) { if (tmp[start] == '{' && tmp[start+1] !='{') { end = str.indexOf('}', start); token = tmp.slice(start+1, end).join(''); if (tmp[start-1] != '{' && tmp[end+1] != '}') { var tokenArgs = (typeof arguments[1] != 'object')? arguments2Array(arguments, 2): args || []; buffer.push(strings.strConversion.__formatToken(token, tokenArgs)); } else { buffer.push(token); } } else if (start > end || buffer.length < 1) { buffer.push(tmp[start]); } } return (buffer.length > 1)? buffer.join(''): buffer[0]; }, calc: function(str, args) { return eval(format(str, args)); }, repeat: function(s, n) { return new Array(n+1).join(s); }, UTF8encode: function(s) { return unescape(encodeURIComponent(s)); }, UTF8decode: function(s) { return decodeURIComponent(escape(s)); }, tpl: function() { var out = ''; var render = true; // Set // $.tpl('ui.test', ['', helloWorld ,'']); if (arguments.length == 2 && $.isArray(arguments[1])) { this[arguments[0]] = arguments[1].join(''); return $(this[arguments[0]]); } // $.tpl('ui.test', 'hello world'); if (arguments.length == 2 && $.isString(arguments[1])) { this[arguments[0]] = arguments[1]; return $(this[arguments[0]]); } // Call // $.tpl('ui.test'); if (arguments.length == 1) { return $(this[arguments[0]]); } // $.tpl('ui.test', false); if (arguments.length == 2 && arguments[1] == false) { return this[arguments[0]]; } // $.tpl('ui.test', {value:blah}); if (arguments.length == 2 && $.isObject(arguments[1])) { return $($.format(this[arguments[0]], arguments[1])); } // $.tpl('ui.test', {value:blah}, false); if (arguments.length == 3 && $.isObject(arguments[1])) { return (arguments[2] == true) ? $.format(this[arguments[0]], arguments[1]) : $($.format(this[arguments[0]], arguments[1])); } } }; var Argument = function(arg, args) { this.__arg = arg; this.__args = args; this.__max_precision = parseFloat('1.'+ (new Array(32)).join('1'), 10).toString().length-3; this.__def_precision = 6; this.getString = function(){ return this.__arg; }; this.getKey = function(){ return this.__arg.split(':')[0]; }; this.getFormat = function(){ var match = this.getString().split(':'); return (match && match[1])? match[1]: 's'; }; this.getPrecision = function(){ var match = this.getFormat().match(/\.(\d+|\*)/g); if (!match) { return this.__def_precision; } else { match = match[0].slice(1); if (match != '*') { return parseInt(match, 10); } else if(strings.strConversion.__getType(this.__args) == 'array') { return this.__args[1] && this.__args[0] || this.__def_precision; } else if(strings.strConversion.__getType(this.__args) == 'object') { return this.__args[this.getKey()] && this.__args[this.getKey()][0] || this.__def_precision; } else { return this.__def_precision; } } }; this.getPaddingLength = function(){ var match = false; if (this.isAlternate()) { match = this.getString().match(/0?#0?(\d+)/); if (match && match[1]) { return parseInt(match[1], 10); } } match = this.getString().match(/(0|\.)(\d+|\*)/g); return match && parseInt(match[0].slice(1), 10) || 0; }; this.getPaddingString = function(){ var o = ''; if (this.isAlternate()) { o = ' '; } // 0 take precedence on alternate format if (this.getFormat().match(/#0|0#|^0|\.\d+/)) { o = '0'; } return o; }; this.getFlags = function(){ var match = this.getString().matc(/^(0|\#|\-|\+|\s)+/); return match && match[0].split('') || []; }; this.isAlternate = function() { return !!this.getFormat().match(/^0?#/); }; }; var arguments2Array = function(args, shift) { var o = []; for (l=args.length, x=(shift || 0)-1; x