'use strict'; module.exports = function (math) { var util = require('../../util/index'), isString = util.string.isString; /** * Interpolate values into a string template. * * Syntax: * * math.print(template, values) * math.print(template, values, precision) * * Example usage: * * // the following outputs: 'Lucy is 5 years old' * math.print('Lucy is $age years old', {age: 5}); * * // the following outputs: 'The value of pi is 3.141592654' * math.print('The value of pi is $pi', {pi: math.pi}, 10); * * // the following outputs: 'hello Mary! The date is 2013-03-23' * math.print('Hello $user.name! The date is $date', { * user: { * name: 'Mary', * }, * date: new Date(2013, 2, 23).toISOString().substring(0, 10) * }); * * See also: * * format * * @param {String} template A string containing variable placeholders. * @param {Object} values An object containing variables which will * be filled in in the template. * @param {Number} [precision] Number of digits to format numbers. * If not provided, the value will not be rounded. * @return {String} Interpolated string */ math.print = function print (template, values, precision) { var num = arguments.length; if (num != 2 && num != 3) { throw new math.error.ArgumentsError('print', num, 2, 3); } if (!isString(template)) { throw new TypeError('String expected as first parameter in function format'); } if (!(values instanceof Object)) { throw new TypeError('Object expected as second parameter in function format'); } // format values into a string return template.replace(/\$([\w\.]+)/g, function (original, key) { var keys = key.split('.'); var value = values[keys.shift()]; while (keys.length && value !== undefined) { var k = keys.shift(); value = k ? value[k] : value + '.'; } if (value !== undefined) { if (!isString(value)) { return math.format(value, precision); } else { return value; } } return original; } ); }; };