mirror/fmt
1
0
Fork 0
mirror of https://github.com/fmtlib/fmt.git synced 2024-12-24 12:14:26 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add documentation for '%' format type. (#1071)

Browse Source
This commit is contained in:
Gawain Bolton 2019-03-06 22:50:32 +01:00 committed by Victor Zverovich
parent d8434baa03
commit 2d981bb133
1 changed files with 11 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/syntax.rst
View File

@ -264,6 +264,10 @@ The available presentation types for floating-point values are:
| | ``'E'`` if the number gets too large. The | | | ``'E'`` if the number gets too large. The |
| | representations of infinity and NaN are uppercased, too. | | | representations of infinity and NaN are uppercased, too. |
+---------+----------------------------------------------------------+ +---------+----------------------------------------------------------+
| ``'%'`` | Fixed point as a percentage. This is similar to ``'f'``, |
| | but the argument is multiplied by 100 and a percent sign |
| | ``%`` is appended. |
+---------+----------------------------------------------------------+
| none | The same as ``'g'``. | | none | The same as ``'g'``. |
+---------+----------------------------------------------------------+ +---------+----------------------------------------------------------+
@ -357,6 +361,13 @@ Replacing ``%+f``, ``%-f``, and ``% f`` and specifying a sign::
format("{:-f}; {:-f}", 3.14, -3.14); // show only the minus -- same as '{:f}; {:f}' format("{:-f}; {:-f}", 3.14, -3.14); // show only the minus -- same as '{:f}; {:f}'
// Result: "3.140000; -3.140000" // Result: "3.140000; -3.140000"
As a percentage::
format("{0:f} or {0:%}", .635);
// Result: "0.635000 or 63.500000%"
format("{:*^{}.{}%}", 1., 15, 2); // With fill, dynamic width and dynamic precision.
// Result: "****100.00%****"
Replacing ``%x`` and ``%o`` and converting the value to different bases:: Replacing ``%x`` and ``%o`` and converting the value to different bases::
format("int: {0:d}; hex: {0:x}; oct: {0:o}; bin: {0:b}", 42); format("int: {0:d}; hex: {0:x}; oct: {0:o}; bin: {0:b}", 42);
@ -412,4 +423,3 @@ Padded hex byte with prefix and always prints both hex characters::
9 9 11 1001 9 9 11 1001
10 A 12 1010 10 A 12 1010
11 B 13 1011 11 B 13 1011