From 182b48aa777a2c9c453f729c162412b6900b055d Mon Sep 17 00:00:00 2001 From: Ruben Bridgewater Date: Tue, 14 May 2019 00:23:07 +0200 Subject: doc: update `util.format` formatters documentation This includes the information that some inputs are handled differently than others (e.g., `Symbols` are partially represented as `NaN`). PR-URL: https://github.com/nodejs/node/pull/27621 Reviewed-By: Roman Reiss --- doc/api/util.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) (limited to 'doc/api/util.md') diff --git a/doc/api/util.md b/doc/api/util.md index c0b909d438..e0b30e9a97 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -220,13 +220,15 @@ as a `printf`-like format string which can contain zero or more format specifiers. Each specifier is replaced with the converted value from the corresponding argument. Supported specifiers are: -* `%s` - `String` will be used to convert all values except `BigInt` and - `Object`. `BigInt` values will be represented with an `n` and Objects are +* `%s` - `String` will be used to convert all values except `BigInt`, `Object` + and `-0`. `BigInt` values will be represented with an `n` and Objects are inspected using `util.inspect()` with options - `{ depth: 0, colors: false, compact: 3 }`. -* `%d` - `Number` will be used to convert all values except `BigInt`. -* `%i` - `parseInt(value, 10)` is used for all values except `BigInt`. -* `%f` - `parseFloat(value)` is used for all values. + `{ depth: 0, colors: false, compact: 3 }`. +* `%d` - `Number` will be used to convert all values except `BigInt` and + `Symbol`. +* `%i` - `parseInt(value, 10)` is used for all values except `BigInt` and + `Symbol`. +* `%f` - `parseFloat(value)` is used for all values expect `Symbol`. * `%j` - JSON. Replaced with the string `'[Circular]'` if the argument contains circular references. * `%o` - `Object`. A string representation of an object with generic JavaScript -- cgit v1.2.3