if (!dojo._hasResource["dojox.string.sprintf"]) { // _hasResource checks added // by build. Do not use // _hasResource directly in // your code. dojo._hasResource["dojox.string.sprintf"] = true; dojo.provide("dojox.string.sprintf"); dojo.require("dojox.string.tokenize"); dojox.string.sprintf = function(/* String */format, /* mixed... */filler) { for (var args = [], i = 1; i < arguments.length; i++) { args.push(arguments[i]); } var formatter = new dojox.string.sprintf.Formatter(format); return formatter.format.apply(formatter, args); } dojox.string.sprintf.Formatter = function(/* String */format) { var tokens = []; this._mapped = false; this._format = format; this._tokens = dojox.string.tokenize(format, this._re, this._parseDelim, this); } dojo.extend(dojox.string.sprintf.Formatter, { _re : /\%(?:\(([\w_]+)\)|([1-9]\d*)\$)?([0 +\-\#]*)(\*|\d+)?(\.)?(\*|\d+)?[hlL]?([\%scdeEfFgGiouxX])/g, _parseDelim : function(mapping, intmapping, flags, minWidth, period, precision, specifier) { if (mapping) { this._mapped = true; } return { mapping : mapping, intmapping : intmapping, flags : flags, _minWidth : minWidth, // May be dependent on parameters period : period, _precision : precision, // May be dependent on parameters specifier : specifier }; }, _specifiers : { b : { base : 2, isInt : true }, o : { base : 8, isInt : true }, x : { base : 16, isInt : true }, X : { extend : ["x"], toUpper : true }, d : { base : 10, isInt : true }, i : { extend : ["d"] }, u : { extend : ["d"], isUnsigned : true }, c : { setArg : function(token) { if (!isNaN(token.arg)) { var num = parseInt(token.arg); if (num < 0 || num > 127) { throw new Error("invalid character code passed to %c in sprintf"); } token.arg = isNaN(num) ? "" + num : String .fromCharCode(num); } } }, s : { setMaxWidth : function(token) { token.maxWidth = (token.period == ".") ? token.precision : -1; } }, e : { isDouble : true, doubleNotation : "e" }, E : { extend : ["e"], toUpper : true }, f : { isDouble : true, doubleNotation : "f" }, F : { extend : ["f"] }, g : { isDouble : true, doubleNotation : "g" }, G : { extend : ["g"], toUpper : true } }, format : function(/* mixed... */filler) { if (this._mapped && typeof filler != "object") { throw new Error("format requires a mapping"); } var str = ""; var position = 0; for (var i = 0, token; i < this._tokens.length; i++) { token = this._tokens[i]; if (typeof token == "string") { str += token; } else { if (this._mapped) { if (typeof filler[token.mapping] == "undefined") { throw new Error("missing key " + token.mapping); } token.arg = filler[token.mapping]; } else { if (token.intmapping) { var position = parseInt(token.intmapping) - 1; } if (position >= arguments.length) { throw new Error("got " + arguments.length + " printf arguments, insufficient for '" + this._format + "'"); } token.arg = arguments[position++]; } if (!token.compiled) { token.compiled = true; token.sign = ""; token.zeroPad = false; token.rightJustify = false; token.alternative = false; var flags = {}; for (var fi = token.flags.length; fi--;) { var flag = token.flags.charAt(fi); flags[flag] = true; switch (flag) { case " " : token.sign = " "; break; case "+" : token.sign = "+"; break; case "0" : token.zeroPad = (flags["-"]) ? false : true; break; case "-" : token.rightJustify = true; token.zeroPad = false; break; case "\#" : token.alternative = true; break; default : throw Error("bad formatting flag '" + token.flags.charAt(fi) + "'"); } } token.minWidth = (token._minWidth) ? parseInt(token._minWidth) : 0; token.maxWidth = -1; token.toUpper = false; token.isUnsigned = false; token.isInt = false; token.isDouble = false; token.precision = 1; if (token.period == '.') { if (token._precision) { token.precision = parseInt(token._precision); } else { token.precision = 0; } } var mixins = this._specifiers[token.specifier]; if (typeof mixins == "undefined") { throw new Error("unexpected specifier '" + token.specifier + "'"); } if (mixins.extend) { dojo.mixin(mixins, this._specifiers[mixins.extend]); delete mixins.extend; } dojo.mixin(token, mixins); } if (typeof token.setArg == "function") { token.setArg(token); } if (typeof token.setMaxWidth == "function") { token.setMaxWidth(token); } if (token._minWidth == "*") { if (this._mapped) { throw new Error("* width not supported in mapped formats"); } token.minWidth = parseInt(arguments[position++]); if (isNaN(token.minWidth)) { throw new Error("the argument for * width at position " + position + " is not a number in " + this._format); } // negative width means rightJustify if (token.minWidth < 0) { token.rightJustify = true; token.minWidth = -token.minWidth; } } if (token._precision == "*" && token.period == ".") { if (this._mapped) { throw new Error("* precision not supported in mapped formats"); } token.precision = parseInt(arguments[position++]); if (isNaN(token.precision)) { throw Error("the argument for * precision at position " + position + " is not a number in " + this._format); } // negative precision means unspecified if (token.precision < 0) { token.precision = 1; token.period = ''; } } if (token.isInt) { // a specified precision means no zero padding if (token.period == '.') { token.zeroPad = false; } this.formatInt(token); } else if (token.isDouble) { if (token.period != '.') { token.precision = 6; } this.formatDouble(token); } this.fitField(token); str += "" + token.arg; } } return str; }, _zeros10 : '0000000000', _spaces10 : ' ', formatInt : function(token) { var i = parseInt(token.arg); if (!isFinite(i)) { // isNaN(f) || f == Number.POSITIVE_INFINITY || // f == Number.NEGATIVE_INFINITY) // allow this only if arg is number if (typeof token.arg != "number") { throw new Error("format argument '" + token.arg + "' not an integer; parseInt returned " + i); } // return '' + i; i = 0; } // if not base 10, make negatives be positive // otherwise, (-10).toString(16) is '-a' instead of 'fffffff6' if (i < 0 && (token.isUnsigned || token.base != 10)) { i = 0xffffffff + i + 1; } if (i < 0) { token.arg = (-i).toString(token.base); this.zeroPad(token); token.arg = "-" + token.arg; } else { token.arg = i.toString(token.base); // need to make sure that argument 0 with precision==0 is // formatted as '' if (!i && !token.precision) { token.arg = ""; } else { this.zeroPad(token); } if (token.sign) { token.arg = token.sign + token.arg; } } if (token.base == 16) { if (token.alternative) { token.arg = '0x' + token.arg; } toke.art = token.toUpper ? token.arg.toUpperCase() : token.arg .toLowerCase(); } if (token.base == 8) { if (token.alternative && token.arg.charAt(0) != '0') { token.arg = '0' + token.arg; } } }, formatDouble : function(token) { var f = parseFloat(token.arg); if (!isFinite(f)) { // isNaN(f) || f == Number.POSITIVE_INFINITY || // f == Number.NEGATIVE_INFINITY) // allow this only if arg is number if (typeof token.arg != "number") { throw new Error("format argument '" + token.arg + "' not a float; parseFloat returned " + f); } // C99 says that for 'f': // infinity -> '[-]inf' or '[-]infinity' ('[-]INF' or // '[-]INFINITY' for 'F') // NaN -> a string starting with 'nan' ('NAN' for 'F') // this is not commonly implemented though. // return '' + f; f = 0; } switch (token.doubleNotation) { case 'e' : { token.arg = f.toExponential(token.precision); break; } case 'f' : { token.arg = f.toFixed(token.precision); break; } case 'g' : { // C says use 'e' notation if exponent is < -4 or is >= prec // ECMAScript for toPrecision says use exponential notation // if exponent is >= prec, // though step 17 of toPrecision indicates a test for < -6 // to force exponential. if (Math.abs(f) < 0.0001) { // print("forcing exponential notation for f=" + f); token.arg = f.toExponential(token.precision > 0 ? token.precision - 1 : token.precision); } else { token.arg = f.toPrecision(token.precision); } // In C, unlike 'f', 'gG' removes trailing 0s from // fractional part, unless alternative format flag ("#"). // But ECMAScript formats toPrecision as 0.00100000. So // remove trailing 0s. if (!token.alternative) { // print("replacing trailing 0 in '" + s + "'"); token.arg = token.arg.replace(/(\..*[^0])0*/, "$1"); // if fractional part is entirely 0, remove it and // decimal point token.arg = token.arg.replace(/\.0*e/, 'e').replace( /\.0$/, ''); } break; } default : throw new Error("unexpected double notation '" + token.doubleNotation + "'"); } // C says that exponent must have at least two digits. // But ECMAScript does not; toExponential results in things like // "1.000000e-8" and "1.000000e+8". // Note that s.replace(/e([\+\-])(\d)/, "e$10$2") won't work because // of the "$10" instead of "$1". // And replace(re, func) isn't supported on IE50 or Safari1. token.arg = token.arg.replace(/e\+(\d)$/, "e+0$1").replace( /e\-(\d)$/, "e-0$1"); // Ensure a '0' before the period. // Opera implements (0.001).toString() as '0.001', but // (0.001).toFixed(1) is '.001' if (dojo.isOpera) { token.arg = token.arg.replace(/^\./, '0.'); } // if alt, ensure a decimal point if (token.alternative) { token.arg = token.arg.replace(/^(\d+)$/, "$1."); token.arg = token.arg.replace(/^(\d+)e/, "$1.e"); } if (f >= 0 && token.sign) { token.arg = token.sign + token.arg; } token.arg = token.toUpper ? token.arg.toUpperCase() : token.arg .toLowerCase(); }, zeroPad : function(token, /* Int */length) { length = (arguments.length == 2) ? length : token.precision; if (typeof token.arg != "string") { token.arg = "" + token.arg; } var tenless = length - 10; while (token.arg.length < tenless) { token.arg = (token.rightJustify) ? token.arg + this._zeros10 : this._zeros10 + token.arg; } var pad = length - token.arg.length; token.arg = (token.rightJustify) ? token.arg + this._zeros10.substring(0, pad) : this._zeros10 .substring(0, pad) + token.arg; }, fitField : function(token) { if (token.maxWidth >= 0 && token.arg.length > token.maxWidth) { return token.arg.substring(0, token.maxWidth); } if (token.zeroPad) { this.zeroPad(token, token.minWidth); return; } this.spacePad(token); }, spacePad : function(token, /* Int */length) { length = (arguments.length == 2) ? length : token.minWidth; if (typeof token.arg != 'string') { token.arg = '' + token.arg; } var tenless = length - 10; while (token.arg.length < tenless) { token.arg = (token.rightJustify) ? token.arg + this._spaces10 : this._spaces10 + token.arg; } var pad = length - token.arg.length; token.arg = (token.rightJustify) ? token.arg + this._spaces10.substring(0, pad) : this._spaces10 .substring(0, pad) + token.arg; } }); }