coffee/fmt
1
0
Fork 0
mirror of https://github.com/fmtlib/fmt.git synced 2026-06-15 08:26:13 +08:00
Code Issues Packages Projects Releases Wiki Activity

Improve docs

Browse Source
This commit is contained in:
Victor Zverovich 2026-06-02 10:05:34 -07:00
parent dea98ad228
commit 889da4274e
1 changed files with 9 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
doc/syntax.md
View File

@ -104,7 +104,7 @@ already at least as wide as *width*; the value is never truncated to fit.
fmt::format("[{:<10}]", "42"); // Result: "[42 ]" fmt::format("[{:<10}]", "42"); // Result: "[42 ]"
fmt::format("[{:>10}]", "42"); // Result: "[ 42]" fmt::format("[{:>10}]", "42"); // Result: "[ 42]"
fmt::format("[{:^10}]", "42"); // Result: "[ 42 ]" fmt::format("[{:^10}]", "42"); // Result: "[ 42 ]"
fmt::format("[{:*^10}]", "42"); // Result: "[****42****]" -- '*' as fill fmt::format("[{:*^10}]", "42"); // Result: "[****42****]" - '*' as fill
``` ```
### Sign ### Sign
@ -174,9 +174,12 @@ This keeps fixed *width* values visually consistent in monospace renderings
that combine Latin and CJK text. that combine Latin and CJK text.
```c++ ```c++
fmt::format("[{:6}]", 42); // Result: "[ 42]" -- right-aligned by default fmt::format("[{:6}]", 42);
fmt::format("[{:6}]", "hi"); // Result: "[hi ]" -- left-aligned by default // Result: "[ 42]" - right-aligned by default
fmt::format("[{:{}}]", 42, 6); // Result: "[ 42]" -- width from an argument fmt::format("[{:6}]", "hi");
// Result: "[hi ]" - left-aligned by default
fmt::format("[{:{}}]", 42, 6);
// Result: "[ 42]" - width from an argument
``` ```
### Precision ### Precision
@ -200,7 +203,8 @@ string, the string must still be null-terminated.
fmt::format("{:.2f}", 3.14159); // Result: "3.14" fmt::format("{:.2f}", 3.14159); // Result: "3.14"
fmt::format("{:.3g}", 3.14159); // Result: "3.14" fmt::format("{:.3g}", 3.14159); // Result: "3.14"
fmt::format("{:.4}", "hello, world"); // Result: "hell" fmt::format("{:.4}", "hello, world"); // Result: "hell"
fmt::format("{:.{}f}", 3.14159, 4); // Result: "3.1416" -- precision from an argument fmt::format("{:.{}f}", 3.14159, 4);
// Result: "3.1416" - precision from an argument
``` ```
### Locale (`L`) ### Locale (`L`)