Skip to content

F
fmt
Commit d6047cdc authored by Victor Zverovich's avatar Victor Zverovich
Browse files
Options

Update changelog

parent 810241b3
Hide whitespace changes
Inline Side-by-side
Showing with 498 additions and 497 deletions
ChangeLog.md
View file @ d6047cdc
7.0.0 - TBD 7.0.0 - TBD
=========== ===========
* Reduced the library size. For example, on macOS the stripped binary statically * Reduced the library size. For example, on macOS a stripped binary
linked with {fmt} [shrank from \~368k to less than statically linked with {fmt} [shrank from \~368k to less than 100k](
100k](http://www.zverovich.net/2020/05/21/reducing-library-size.html). http://www.zverovich.net/2020/05/21/reducing-library-size.html).
* Added a simpler and more efficient [format string compilation * Added a simpler and more efficient [format string compilation API](
API](https://fmt.dev/dev/api.html#compile-api): https://fmt.dev/dev/api.html#compile-api):
``` {.c++} ```c++
#include <fmt/compile.h> #include <fmt/compile.h>
// Converts 42 into std::string using the most efficient method and no // Converts 42 into std::string using the most efficient method and no
...@@ -18,12 +18,13 @@ ...@@ -18,12 +18,13 @@
The old `fmt::compile` API is now deprecated. The old `fmt::compile` API is now deprecated.
* Optimized integer formatting: `format_to` with format string compilation and a * Optimized integer formatting: `format_to` with format string compilation and
stack-allocated buffer is now [faster than to\_chars on both libc++ and a stack-allocated buffer is now [faster than `to_chars` on both libc++ and
libstdc++](http://www.zverovich.net/2020/06/13/fast-int-to-string-revisited.html). libstdc++](
http://www.zverovich.net/2020/06/13/fast-int-to-string-revisited.html).
* Applied extern templates to improve compile times when using the core API and * Applied extern templates to improve compile times when using the core API and
`fmt/format.h` ([\#1452]()). For example, on macOS with clang the compile time `fmt/format.h` (#1452). For example, on macOS with clang the compile time
of a test TU dropped from 2.3s to 0.3s with `-O2` and from 0.6s to 0.3s with of a test TU dropped from 2.3s to 0.3s with `-O2` and from 0.6s to 0.3s with
the default settings (`-O0`). the default settings (`-O0`).
...@@ -55,7 +56,7 @@ ...@@ -55,7 +56,7 @@
* Named arguments are now stored on stack (no dynamic memory allocations) and * Named arguments are now stored on stack (no dynamic memory allocations) and
the generated binary code is more compact and efficient. For example the generated binary code is more compact and efficient. For example
``` {.c++} ```c++
#include <fmt/core.h> #include <fmt/core.h>
int main() { int main() {
...@@ -65,7 +66,7 @@ ...@@ -65,7 +66,7 @@
compiles to just ([godbolt](https://godbolt.org/z/NcfEp_)) compiles to just ([godbolt](https://godbolt.org/z/NcfEp_))
``` {.asm} ```asm
.LC0: .LC0:
.string "answer" .string "answer"
.LC1: .LC1:
...@@ -92,9 +93,9 @@ ...@@ -92,9 +93,9 @@
.asciz "answer" .asciz "answer"
``` ```
* Implemented compile-time checks for dynamic width and precision ([\#1614]()): * Implemented compile-time checks for dynamic width and precision (#1614):
``` {.c++} ```c++
#include <fmt/format.h> #include <fmt/format.h>
int main() { int main() {
...@@ -115,9 +116,9 @@ ...@@ -115,9 +116,9 @@
if (id >= num_args_) on_error("argument not found"); if (id >= num_args_) on_error("argument not found");
^ ^
* Added sentinel support to `fmt::join` ([\#1689]()): * Added sentinel support to `fmt::join` (#1689):
``` {.c++} ```c++
struct zstring_sentinel {}; struct zstring_sentinel {};
bool operator==(const char* p, zstring_sentinel) { return *p == '\0'; } bool operator==(const char* p, zstring_sentinel) { return *p == '\0'; }
bool operator!=(const char* p, zstring_sentinel) { return *p != '\0'; } bool operator!=(const char* p, zstring_sentinel) { return *p != '\0'; }
...@@ -135,15 +136,15 @@ ...@@ -135,15 +136,15 @@
Thanks [\@BRevzin (Barry Revzin)](https://github.com/BRevzin). Thanks [\@BRevzin (Barry Revzin)](https://github.com/BRevzin).
* Added support for named args, `clear` and `reserve` to * Added support for named args, `clear` and `reserve` to
`dynamic_format_arg_store` ([\#1655](), [\#1663](), [\#1674](), [\#1677]()). `dynamic_format_arg_store` (#1655, #1663, #1674, #1677).
Thanks [\@vsolontsov-ll (Vladimir Thanks [\@vsolontsov-ll (Vladimir
Solontsov)](https://github.com/vsolontsov-ll). Solontsov)](https://github.com/vsolontsov-ll).
* Added support for the `'c'` format specifier to integral types for * Added support for the `'c'` format specifier to integral types for
compatibility with `std::format` ([\#1652]()). compatibility with `std::format` (#1652).
* Implemented the `'L'` format specifier for locale-specific formatting of * Implemented the `'L'` format specifier for locale-specific formatting of
floating-point numbers for compatibility with `std::format` ([\#1624]()). The floating-point numbers for compatibility with `std::format` (#1624). The
`'n'` specifier is now disabled by default but can be enabled via the `'n'` specifier is now disabled by default but can be enabled via the
`FMT_DEPRECATED_N_SPECIFIER` macro. `FMT_DEPRECATED_N_SPECIFIER` macro.
...@@ -152,14 +153,14 @@ ...@@ -152,14 +153,14 @@
* Optimized handling of small format strings. For example, * Optimized handling of small format strings. For example,
``` {.c++} ```c++
fmt::format("Result: {}: ({},{},{},{})", str1, str2, str3, str4, str5) fmt::format("Result: {}: ({},{},{},{})", str1, str2, str3, str4, str5)
``` ```
is now \~40% faster ([\#1685]()). is now \~40% faster (#1685).
* Improved compatibility between `fmt::printf` with the standard specs * Improved compatibility between `fmt::printf` with the standard specs
([\#1595](), [\#1682](), [\#1683](), [\#1687](), [\#1699](), [\#1717]()). (#1595, #1682, #1683, #1687, #1699, #1717).
Thanks [\@rimathia](https://github.com/rimathia). Thanks [\@rimathia](https://github.com/rimathia).
* Fixed handling of `` operator<<` overloads that use ``copyfmt\`[ * Fixed handling of `` operator<<` overloads that use ``copyfmt\`[
...@@ -179,24 +180,24 @@ ...@@ -179,24 +180,24 @@
* Deprecated `arg_formatter`. * Deprecated `arg_formatter`.
* Renamed the `internal` namespace to `detail` ([\#1538]()). The former is still * Renamed the `internal` namespace to `detail` (#1538). The former is still
provided as an alias if the `FMT_USE_INTERNAL` macro is defined. provided as an alias if the `FMT_USE_INTERNAL` macro is defined.
* Added the `FMT_OS` CMake option to control inclusion of OS-specific APIs in * Added the `FMT_OS` CMake option to control inclusion of OS-specific APIs in
the fmt target. This can be useful for embedded platforms ([\#1654](), the fmt target. This can be useful for embedded platforms (#1654,
[\#1656]()). Thanks [\@kwesolowski (Krzysztof #1656). Thanks [\@kwesolowski (Krzysztof
Wesolowski)](https://github.com/kwesolowski). Wesolowski)](https://github.com/kwesolowski).
* Replaced `FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION` with the `FMT_FUZZ` macro * Replaced `FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION` with the `FMT_FUZZ` macro
to prevent interferring with fuzzing of projects using {fmt} ([\#1650]()). to prevent interferring with fuzzing of projects using {fmt} (#1650).
Thanks [\@asraa (Asra Ali)](https://github.com/asraa). Thanks [\@asraa (Asra Ali)](https://github.com/asraa).
* Fixed compatibility with emscripten ([\#1736](), [\#1737]()). Thanks * Fixed compatibility with emscripten (#1736, #1737). Thanks
[\@ArthurSonzogni (Arthur Sonzogni)](https://github.com/ArthurSonzogni). [\@ArthurSonzogni (Arthur Sonzogni)](https://github.com/ArthurSonzogni).
* Improved documentation ([\#704](), [\#1643](), [\#1660](), [\#1681](), * Improved documentation (#704, #1643, #1660, #1681,
[\#1691](), [\#1706](), [\#1714](), [\#1721](), [\#1739](), [\#1740](), #1691, #1706, #1714, #1721, #1739, #1740,
[\#1741]()). Thanks [\@senior7515 (Alexander #1741). Thanks [\@senior7515 (Alexander
Gallego)](https://github.com/senior7515), [\@lsr0 (Lindsay Gallego)](https://github.com/senior7515), [\@lsr0 (Lindsay
Roberts)](https://github.com/lsr0), [\@puetzk (Kevin Roberts)](https://github.com/lsr0), [\@puetzk (Kevin
Puetz)](https://github.com/puetzk), [\@fpelliccioni (Fernando Puetz)](https://github.com/puetzk), [\@fpelliccioni (Fernando
...@@ -206,18 +207,18 @@ ...@@ -206,18 +207,18 @@
(文佳鹏)](https://github.com/jiapengwen), [\@gsjaardema (Greg (文佳鹏)](https://github.com/jiapengwen), [\@gsjaardema (Greg
Sjaardema)](https://github.com/gsjaardema). Sjaardema)](https://github.com/gsjaardema).
* Implemented various build configuration fixes and improvements ([\#1603](), * Implemented various build configuration fixes and improvements (#1603,
[\#1657](), [\#1702](), [\#1728]()). Thanks [\@scramsby (Scott #1657, #1702, #1728). Thanks [\@scramsby (Scott
Ramsby)](https://github.com/scramsby), [\@jtojnar (Jan Ramsby)](https://github.com/scramsby), [\@jtojnar (Jan
Tojnar)](https://github.com/jtojnar), [\@orivej (Orivej Tojnar)](https://github.com/jtojnar), [\@orivej (Orivej
Desh)](https://github.com/orivej), [\@flagarde](https://github.com/flagarde). Desh)](https://github.com/orivej), [\@flagarde](https://github.com/flagarde).
* Fixed various warnings and compilation issues ([\#1616](), [\#1620](), * Fixed various warnings and compilation issues (#1616, #1620,
[\#1622](), [\#1625](), [\#1627](), [\#1628](), [\#1629](), [\#1631](), #1622, #1625, #1627, #1628, #1629, #1631,
[\#1633](), [\#1649](), [\#1658](), [\#1661](), [\#1667](), [\#1668](), #1633, #1649, #1658, #1661, #1667, #1668,
[\#1669](), [\#1692](), [\#1696](), [\#1697](), [\#1707](), [\#1712](), #1669, #1692, #1696, #1697, #1707, #1712,
[\#1716](), [\#1722](), [\#1724](), [\#1729](), [\#1738](), [\#1742](), #1716, #1722, #1724, #1729, #1738, #1742,
[\#1743](), [\#1744](), [\#1747](), [\#1750]()). Thanks [\@gsjaardema (Greg #1743, #1744, #1747, #1750). Thanks [\@gsjaardema (Greg
Sjaardema)](https://github.com/gsjaardema), [\@gabime (Gabi Sjaardema)](https://github.com/gsjaardema), [\@gabime (Gabi
Melman)](https://github.com/gabime), [\@johnor Melman)](https://github.com/gabime), [\@johnor
(Johan)](https://github.com/johnor), [\@gabime (Dmitry (Johan)](https://github.com/johnor), [\@gabime (Dmitry
...@@ -236,9 +237,9 @@ ...@@ -236,9 +237,9 @@
6.2.1 - 2020-05-09 6.2.1 - 2020-05-09
================== ==================
* Fixed ostream support in `sprintf` ([\#1631]()). * Fixed ostream support in `sprintf` (#1631).
* Fixed type detection when using implicit conversion to `string_view` and * Fixed type detection when using implicit conversion to `string_view` and
ostream `operator<<` inconsistently ([\#1662]()). ostream `operator<<` inconsistently (#1662).
6.2.0 - 2020-04-05 6.2.0 - 2020-04-05
================== ==================
...@@ -246,7 +247,7 @@ ...@@ -246,7 +247,7 @@
* Improved error reporting when trying to format an object of a non-formattable * Improved error reporting when trying to format an object of a non-formattable
type: type:
``` {.c++} ```c++
fmt::format("{}", S()); fmt::format("{}", S());
``` ```
...@@ -268,9 +269,9 @@ ...@@ -268,9 +269,9 @@
* Reduced the library size by \~10%. * Reduced the library size by \~10%.
* Always print decimal point if `#` is specified ([\#1476](), [\#1498]()): * Always print decimal point if `#` is specified (#1476, #1498):
``` {.c++} ```c++
fmt::print("{:#.0f}", 42.0); fmt::print("{:#.0f}", 42.0);
``` ```
...@@ -292,9 +293,9 @@ ...@@ -292,9 +293,9 @@
* Used `type_identity` to block unnecessary template argument deduction. Thanks * Used `type_identity` to block unnecessary template argument deduction. Thanks
Tim Song. Tim Song.
* Improved UTF-8 handling ([\#1109]()): * Improved UTF-8 handling (#1109):
``` {.c++} ```c++
fmt::print("┌{0:─^{2}}┐\n" fmt::print("┌{0:─^{2}}┐\n"
"│{1: ^{2}}│\n" "│{1: ^{2}}│\n"
"└{0:─^{2}}┘\n", "", "Привет, мир!", 20); "└{0:─^{2}}┘\n", "", "Привет, мир!", 20);
...@@ -308,9 +309,9 @@ ...@@ -308,9 +309,9 @@
on systems that support Unicode. on systems that support Unicode.
* Added experimental dynamic argument storage ([\#1170](), [\#1584]()): * Added experimental dynamic argument storage (#1170, #1584):
``` {.c++} ```c++
fmt::dynamic_format_arg_store<fmt::format_context> store; fmt::dynamic_format_arg_store<fmt::format_context> store;
store.push_back("answer"); store.push_back("answer");
store.push_back(42); store.push_back(42);
...@@ -324,57 +325,57 @@ ...@@ -324,57 +325,57 @@
Thanks [\@vsolontsov-ll (Vladimir Thanks [\@vsolontsov-ll (Vladimir
Solontsov)](https://github.com/vsolontsov-ll). Solontsov)](https://github.com/vsolontsov-ll).
* Made `fmt::join` accept `initializer_list` ([\#1591]()). Thanks [\@Rapotkinnik * Made `fmt::join` accept `initializer_list` (#1591). Thanks [\@Rapotkinnik
(Nikolay Rapotkin)](https://github.com/Rapotkinnik). (Nikolay Rapotkin)](https://github.com/Rapotkinnik).
* Fixed handling of empty tuples ([\#1588]()). * Fixed handling of empty tuples (#1588).
* Fixed handling of output iterators in `format_to_n` ([\#1506]()). * Fixed handling of output iterators in `format_to_n` (#1506).
* Fixed formatting of `std::chrono::duration` types to wide output ([\#1533]()). * Fixed formatting of `std::chrono::duration` types to wide output (#1533).
Thanks [\@zeffy (pilao)](https://github.com/zeffy). Thanks [\@zeffy (pilao)](https://github.com/zeffy).
* Added const `begin` and `end` overload to buffers ([\#1553]()). Thanks * Added const `begin` and `end` overload to buffers (#1553). Thanks
[\@dominicpoeschko](https://github.com/dominicpoeschko). [\@dominicpoeschko](https://github.com/dominicpoeschko).
* Added the ability to disable floating-point formatting via `FMT_USE_FLOAT`, * Added the ability to disable floating-point formatting via `FMT_USE_FLOAT`,
`FMT_USE_DOUBLE` and `FMT_USE_LONG_DOUBLE` macros for extremely `FMT_USE_DOUBLE` and `FMT_USE_LONG_DOUBLE` macros for extremely
memory-constrained embedded system ([\#1590]()). Thanks [\@albaguirre (Alberto memory-constrained embedded system (#1590). Thanks [\@albaguirre (Alberto
Aguirre)](https://github.com/albaguirre). Aguirre)](https://github.com/albaguirre).
* Made `FMT_STRING` work with `constexpr` `string_view` ([\#1589]()). Thanks * Made `FMT_STRING` work with `constexpr` `string_view` (#1589). Thanks
[\@scramsby (Scott Ramsby)](https://github.com/scramsby). [\@scramsby (Scott Ramsby)](https://github.com/scramsby).
* Implemented a minor optimization in the format string parser ([\#1560]()). * Implemented a minor optimization in the format string parser (#1560).
Thanks [\@IkarusDeveloper](https://github.com/IkarusDeveloper). Thanks [\@IkarusDeveloper](https://github.com/IkarusDeveloper).
* Improved attribute detection ([\#1469](), [\#1475](), [\#1576]()). Thanks * Improved attribute detection (#1469, #1475, #1576). Thanks
[\@federico-busato (Federico)](https://github.com/federico-busato), [\@federico-busato (Federico)](https://github.com/federico-busato),
[\@chronoxor (Ivan Shynkarenka)](https://github.com/chronoxor), [\@chronoxor (Ivan Shynkarenka)](https://github.com/chronoxor),
[\@refnum](https://github.com/refnum). [\@refnum](https://github.com/refnum).
* Improved documentation ([\#1481](), [\#1523]()). Thanks [\@JackBoosY * Improved documentation (#1481, #1523). Thanks [\@JackBoosY
(Jack·Boos·Yu)](https://github.com/JackBoosY), [\@imba-tjd (Jack·Boos·Yu)](https://github.com/JackBoosY), [\@imba-tjd
(谭九鼎)](https://github.com/imba-tjd). (谭九鼎)](https://github.com/imba-tjd).
* Fixed symbol visibility on Linux when compiling with `-fvisibility=hidden` * Fixed symbol visibility on Linux when compiling with `-fvisibility=hidden`
([\#1535]()). Thanks [\@milianw (Milian Wolff)](https://github.com/milianw). (#1535). Thanks [\@milianw (Milian Wolff)](https://github.com/milianw).
* Implemented various build configuration fixes and improvements ([\#1264](), * Implemented various build configuration fixes and improvements (#1264,
[\#1460](), [\#1534](), [\#1536](), [\#1545](), [\#1546](), [\#1566](), #1460, #1534, #1536, #1545, #1546, #1566,
[\#1582](), [\#1597](), [\#1598]()). Thanks [\@ambitslix (Attila M. #1582, #1597, #1598). Thanks [\@ambitslix (Attila M.
Szilagyi)](https://github.com/ambitslix), [\@jwillikers (Jordan Szilagyi)](https://github.com/ambitslix), [\@jwillikers (Jordan
Williams)](https://github.com/jwillikers), [\@stac47 (Laurent Williams)](https://github.com/jwillikers), [\@stac47 (Laurent
Stacul)](https://github.com/stac47). Stacul)](https://github.com/stac47).
* Fixed various warnings and compilation issues ([\#1433](), [\#1461](), * Fixed various warnings and compilation issues (#1433, #1461,
[\#1470](), [\#1480](), [\#1485](), [\#1492](), [\#1493](), [\#1504](), #1470, #1480, #1485, #1492, #1493, #1504,
[\#1505](), [\#1512](), [\#1515](), [\#1516](), [\#1518](), [\#1519](), #1505, #1512, #1515, #1516, #1518, #1519,
[\#1520](), [\#1521](), [\#1522](), [\#1524](), [\#1530](), [\#1531](), #1520, #1521, #1522, #1524, #1530, #1531,
[\#1532](), [\#1539](), [\#1547](), [\#1548](), [\#1554](), [\#1567](), #1532, #1539, #1547, #1548, #1554, #1567,
[\#1568](), [\#1569](), [\#1571](), [\#1573](), [\#1575](), [\#1581](), #1568, #1569, #1571, #1573, #1575, #1581,
[\#1583](), [\#1586](), [\#1587](), [\#1594](), [\#1596](), [\#1604](), #1583, #1586, #1587, #1594, #1596, #1604,
[\#1606](), [\#1607](), [\#1609]()). Thanks [\@marti4d (Chris #1606, #1607, #1609). Thanks [\@marti4d (Chris
Martin)](https://github.com/marti4d), Martin)](https://github.com/marti4d),
[\@iPherian](https://github.com/iPherian), [\@iPherian](https://github.com/iPherian),
[\@parkertomatoes](https://github.com/parkertomatoes), [\@gsjaardema (Greg [\@parkertomatoes](https://github.com/parkertomatoes), [\@gsjaardema (Greg
...@@ -394,18 +395,18 @@ ...@@ -394,18 +395,18 @@
6.1.2 - 2019-12-11 6.1.2 - 2019-12-11
================== ==================
* Fixed ABI compatibility with `libfmt.so.6.0.0` ([\#1471]()). * Fixed ABI compatibility with `libfmt.so.6.0.0` (#1471).
* Fixed handling types convertible to `std::string_view` ([\#1451]()). Thanks * Fixed handling types convertible to `std::string_view` (#1451). Thanks
[\@denizevrenci (Deniz Evrenci)](https://github.com/denizevrenci). [\@denizevrenci (Deniz Evrenci)](https://github.com/denizevrenci).
* Made CUDA test an opt-in enabled via the `FMT_CUDA_TEST` CMake option. * Made CUDA test an opt-in enabled via the `FMT_CUDA_TEST` CMake option.
* Fixed sign conversion warnings ([\#1440]()). Thanks [\@0x8000-0000 (Florin * Fixed sign conversion warnings (#1440). Thanks [\@0x8000-0000 (Florin
Iucha)](https://github.com/0x8000-0000). Iucha)](https://github.com/0x8000-0000).
6.1.1 - 2019-12-04 6.1.1 - 2019-12-04
================== ==================
* Fixed shared library build on Windows ([\#1443](), [\#1445](), [\#1446](), * Fixed shared library build on Windows (#1443, #1445, #1446,
[\#1450]()). Thanks [\@egorpugin (Egor Pugin)](https://github.com/egorpugin), #1450). Thanks [\@egorpugin (Egor Pugin)](https://github.com/egorpugin),
[\@bbolli (Beat Bolli)](https://github.com/bbolli). [\@bbolli (Beat Bolli)](https://github.com/bbolli).
* Added a missing decimal point in exponent notation with trailing zeros. * Added a missing decimal point in exponent notation with trailing zeros.
* Removed deprecated `format_arg_store::TYPES`. * Removed deprecated `format_arg_store::TYPES`.
...@@ -416,7 +417,7 @@ ...@@ -416,7 +417,7 @@
* {fmt} now formats IEEE 754 `float` and `double` using the shortest decimal * {fmt} now formats IEEE 754 `float` and `double` using the shortest decimal
representation with correct rounding by default: representation with correct rounding by default:
``` {.c++} ```c++
#include <cmath> #include <cmath>
#include <fmt/core.h> #include <fmt/core.h>
...@@ -451,10 +452,10 @@ ...@@ -451,10 +452,10 @@
* {fmt} no longer converts `float` arguments to `double`. In particular this * {fmt} no longer converts `float` arguments to `double`. In particular this
improves the default (shortest) representation of floats and makes improves the default (shortest) representation of floats and makes
`fmt::format` consistent with `std::format` specs ([\#1336](), [\#1353](), `fmt::format` consistent with `std::format` specs (#1336, #1353,
[\#1360](), [\#1361]()): #1360, #1361):
``` {.c++} ```c++
fmt::print("{}", 0.1f); fmt::print("{}", 0.1f);
``` ```
...@@ -463,11 +464,11 @@ ...@@ -463,11 +464,11 @@
Thanks [\@orivej (Orivej Desh)](https://github.com/orivej). Thanks [\@orivej (Orivej Desh)](https://github.com/orivej).
* Made floating-point formatting output consistent with `printf`/iostreams * Made floating-point formatting output consistent with `printf`/iostreams
([\#1376](), [\#1417]()). (#1376, #1417).
* Added support for 128-bit integers ([\#1287]()): * Added support for 128-bit integers (#1287):
``` {.c++} ```c++
fmt::print("{}", std::numeric_limits<__int128_t>::max()); fmt::print("{}", std::numeric_limits<__int128_t>::max());
``` ```
...@@ -476,17 +477,17 @@ ...@@ -476,17 +477,17 @@
Thanks [\@denizevrenci (Deniz Evrenci)](https://github.com/denizevrenci). Thanks [\@denizevrenci (Deniz Evrenci)](https://github.com/denizevrenci).
* The overload of `print` that takes `text_style` is now atomic, i.e. the output * The overload of `print` that takes `text_style` is now atomic, i.e. the output
from different threads doesn\'t interleave ([\#1351]()). Thanks [\@tankiJong from different threads doesn\'t interleave (#1351). Thanks [\@tankiJong
(Tanki Zhang)](https://github.com/tankiJong). (Tanki Zhang)](https://github.com/tankiJong).
* Made compile time in the header-only mode \~20% faster by reducing the number * Made compile time in the header-only mode \~20% faster by reducing the number
of template instantiations. `wchar_t` overload of `vprint` was moved from of template instantiations. `wchar_t` overload of `vprint` was moved from
`fmt/core.h` to `fmt/format.h`. `fmt/core.h` to `fmt/format.h`.
* Added an overload of `fmt::join` that works with tuples ([\#1322](), * Added an overload of `fmt::join` that works with tuples (#1322,
[\#1330]()): #1330):
``` {.c++} ```c++
#include <tuple> #include <tuple>
#include <fmt/ranges.h> #include <fmt/ranges.h>
...@@ -502,15 +503,15 @@ ...@@ -502,15 +503,15 @@
* Changed formatting of octal zero with prefix from \"00\" to \"0\": * Changed formatting of octal zero with prefix from \"00\" to \"0\":
``` {.c++} ```c++
fmt::print("{:#o}", 0); fmt::print("{:#o}", 0);
``` ```
prints `0`. prints `0`.
* The locale is now passed to ostream insertion (`<<`) operators ([\#1406]()): * The locale is now passed to ostream insertion (`<<`) operators (#1406):
``` {.c++} ```c++
#include <fmt/locale.h> #include <fmt/locale.h>
#include <fmt/ostream.h> #include <fmt/ostream.h>
...@@ -530,13 +531,13 @@ ...@@ -530,13 +531,13 @@
Thanks [\@dlaugt (Daniel Laügt)](https://github.com/dlaugt). Thanks [\@dlaugt (Daniel Laügt)](https://github.com/dlaugt).
* Locale-specific number formatting now uses grouping ([\#1393](), [\#1394]()). * Locale-specific number formatting now uses grouping (#1393, #1394).
Thanks [\@skrdaniel](https://github.com/skrdaniel). Thanks [\@skrdaniel](https://github.com/skrdaniel).
* Fixed handling of types with deleted implicit rvalue conversion to * Fixed handling of types with deleted implicit rvalue conversion to
`const char**` ([\#1421]()): `const char**` (#1421):
``` {.c++} ```c++
struct mystring { struct mystring {
operator const char*() const&; operator const char*() const&;
operator const char*() &; operator const char*() &;
...@@ -548,51 +549,51 @@ ...@@ -548,51 +549,51 @@
``` ```
* Enums are now mapped to correct underlying types instead of `int` * Enums are now mapped to correct underlying types instead of `int`
([\#1286]()). Thanks [\@agmt (Egor Seredin)](https://github.com/agmt). (#1286). Thanks [\@agmt (Egor Seredin)](https://github.com/agmt).
* Enum classes are no longer implicitly converted to `int` ([\#1424]()). * Enum classes are no longer implicitly converted to `int` (#1424).
* Added `basic_format_parse_context` for consistency with C++20 `std::format` * Added `basic_format_parse_context` for consistency with C++20 `std::format`
and deprecated `basic_parse_context`. and deprecated `basic_parse_context`.
* Fixed handling of UTF-8 in precision ([\#1389](), [\#1390]()). Thanks * Fixed handling of UTF-8 in precision (#1389, #1390). Thanks
[\@tajtiattila (Attila Tajti)](https://github.com/tajtiattila). [\@tajtiattila (Attila Tajti)](https://github.com/tajtiattila).
* {fmt} can now be installed on Linux, macOS and Windows with * {fmt} can now be installed on Linux, macOS and Windows with
[Conda](https://docs.conda.io/en/latest/) using its [Conda](https://docs.conda.io/en/latest/) using its
[conda-forge](https://conda-forge.org) [conda-forge](https://conda-forge.org)
[package](https://github.com/conda-forge/fmt-feedstock) ([\#1410]()): [package](https://github.com/conda-forge/fmt-feedstock) (#1410):
conda install -c conda-forge fmt conda install -c conda-forge fmt
Thanks [\@tdegeus (Tom de Geus)](https://github.com/tdegeus). Thanks [\@tdegeus (Tom de Geus)](https://github.com/tdegeus).
* Added a CUDA test ([\#1285](), [\#1317]()). Thanks [\@luncliff (Park * Added a CUDA test (#1285, #1317). Thanks [\@luncliff (Park
DongHa)](https://github.com/luncliff) and DongHa)](https://github.com/luncliff) and
[\@risa2000](https://github.com/risa2000). [\@risa2000](https://github.com/risa2000).
* Improved documentation ([\#1276](), [\#1291](), [\#1296](), [\#1315](), * Improved documentation (#1276, #1291, #1296, #1315,
[\#1332](), [\#1337](), [\#1395]() [\#1418]()). Thanks [\@waywardmonkeys #1332, #1337, #1395 #1418). Thanks [\@waywardmonkeys
(Bruce Mitchener)](https://github.com/waywardmonkeys), [\@pauldreik (Paul (Bruce Mitchener)](https://github.com/waywardmonkeys), [\@pauldreik (Paul
Dreik)](https://github.com/pauldreik), [\@jackoalan (Jack Dreik)](https://github.com/pauldreik), [\@jackoalan (Jack
Andersen)](https://github.com/jackoalan). Andersen)](https://github.com/jackoalan).
* Various code improvements ([\#1358](), [\#1407]()). Thanks [\@orivej (Orivej * Various code improvements (#1358, #1407). Thanks [\@orivej (Orivej
Desh)](https://github.com/orivej), [\@dpacbach (David P. Desh)](https://github.com/orivej), [\@dpacbach (David P.
Sicilia)](https://github.com/dpacbach), Sicilia)](https://github.com/dpacbach),
* Fixed compile-time format string checks for user-defined types ([\#1292]()). * Fixed compile-time format string checks for user-defined types (#1292).
* Worked around a false positive in `unsigned-integer-overflow` sanitizer * Worked around a false positive in `unsigned-integer-overflow` sanitizer
([\#1377]()). (#1377).
* Fixed various warnings and compilation issues ([\#1273](), [\#1278](), * Fixed various warnings and compilation issues (#1273, #1278,
[\#1280](), [\#1281](), [\#1288](), [\#1290](), [\#1301](), [\#1305](), #1280, #1281, #1288, #1290, #1301, #1305,
[\#1306](), [\#1309](), [\#1312](), [\#1313](), [\#1316](), [\#1319](), #1306, #1309, #1312, #1313, #1316, #1319,
[\#1320](), [\#1326](), [\#1328](), [\#1344](), [\#1345](), [\#1347](), #1320, #1326, #1328, #1344, #1345, #1347,
[\#1349](), [\#1354](), [\#1362](), [\#1366](), [\#1364](), [\#1370](), #1349, #1354, #1362, #1366, #1364, #1370,
[\#1371](), [\#1385](), [\#1388](), [\#1397](), [\#1414](), [\#1416](), #1371, #1385, #1388, #1397, #1414, #1416,
[\#1422]() [\#1427](), [\#1431](), [\#1433]()). Thanks #1422 #1427, #1431, #1433). Thanks
[\@hhb](https://github.com/hhb), [\@gsjaardema (Greg [\@hhb](https://github.com/hhb), [\@gsjaardema (Greg
Sjaardema)](https://github.com/gsjaardema), [\@gabime (Gabi Sjaardema)](https://github.com/gsjaardema), [\@gabime (Gabi
Melman)](https://github.com/gabime), [\@neheb (Rosen Melman)](https://github.com/gabime), [\@neheb (Rosen
...@@ -618,7 +619,7 @@ ...@@ -618,7 +619,7 @@
* Floating-point formatting is now locale-independent by default: * Floating-point formatting is now locale-independent by default:
``` {.c++} ```c++
#include <locale> #include <locale>
#include <fmt/core.h> #include <fmt/core.h>
...@@ -632,7 +633,7 @@ ...@@ -632,7 +633,7 @@
For locale-specific formatting use the `n` specifier: For locale-specific formatting use the `n` specifier:
``` {.c++} ```c++
std::locale::global(std::locale("ru_RU.UTF-8")); std::locale::global(std::locale("ru_RU.UTF-8"));
fmt::print("value = {:n}", 4.2); fmt::print("value = {:n}", 4.2);
``` ```
...@@ -643,7 +644,7 @@ ...@@ -643,7 +644,7 @@
(disabled by default). To enable it compile with the `FMT_USE_GRISU` macro (disabled by default). To enable it compile with the `FMT_USE_GRISU` macro
defined to 1: defined to 1:
``` {.c++} ```c++
#define FMT_USE_GRISU 1 #define FMT_USE_GRISU 1
#include <fmt/format.h> #include <fmt/format.h>
...@@ -661,13 +662,13 @@ ...@@ -661,13 +662,13 @@
std::format](http://eel.is/c++draft/format), removing the undocumented std::format](http://eel.is/c++draft/format), removing the undocumented
`basic_format_context::parse_context()` function. `basic_format_context::parse_context()` function.
* Added [oss-fuzz](https://github.com/google/oss-fuzz) support ([\#1199]()). * Added [oss-fuzz](https://github.com/google/oss-fuzz) support (#1199).
Thanks [\@pauldreik (Paul Dreik)](https://github.com/pauldreik). Thanks [\@pauldreik (Paul Dreik)](https://github.com/pauldreik).
* `formatter` specializations now always take precedence over `operator<<` * `formatter` specializations now always take precedence over `operator<<`
([\#952]()): (#952):
``` {.c++} ```c++
#include <iostream> #include <iostream>
#include <fmt/ostream.h> #include <fmt/ostream.h>
...@@ -691,9 +692,9 @@ ...@@ -691,9 +692,9 @@
``` ```
* Introduced the experimental `fmt::compile` function that does format string * Introduced the experimental `fmt::compile` function that does format string
compilation ([\#618](), [\#1169](), [\#1171]()): compilation (#618, #1169, #1171):
``` {.c++} ```c++
#include <fmt/compile.h> #include <fmt/compile.h>
auto f = fmt::compile<int>("{}"); auto f = fmt::compile<int>("{}");
...@@ -707,17 +708,17 @@ ...@@ -707,17 +708,17 @@
types. Thanks [\@stryku (Mateusz Janek)](https://github.com/stryku). types. Thanks [\@stryku (Mateusz Janek)](https://github.com/stryku).
* Added experimental `%` format specifier that formats floating-point values as * Added experimental `%` format specifier that formats floating-point values as
percentages ([\#1060](), [\#1069](), [\#1071]()): percentages (#1060, #1069, #1071):
``` {.c++} ```c++
auto s = fmt::format("{:.1%}", 0.42); // s == "42.0%" auto s = fmt::format("{:.1%}", 0.42); // s == "42.0%"
``` ```
Thanks [\@gawain-bolton (Gawain Bolton)](https://github.com/gawain-bolton). Thanks [\@gawain-bolton (Gawain Bolton)](https://github.com/gawain-bolton).
* Implemented precision for floating-point durations ([\#1004](), [\#1012]()): * Implemented precision for floating-point durations (#1004, #1012):
``` {.c++} ```c++
auto s = fmt::format("{:.1}", std::chrono::duration<double>(1.234)); auto s = fmt::format("{:.1}", std::chrono::duration<double>(1.234));
// s == 1.2s // s == 1.2s
``` ```
...@@ -725,9 +726,9 @@ ...@@ -725,9 +726,9 @@
Thanks [\@DanielaE (Daniela Engert)](https://github.com/DanielaE). Thanks [\@DanielaE (Daniela Engert)](https://github.com/DanielaE).
* Implemented `chrono` format specifiers `%Q` and `%q` that give the value and * Implemented `chrono` format specifiers `%Q` and `%q` that give the value and
the unit respectively ([\#1019]()): the unit respectively (#1019):
``` {.c++} ```c++
auto value = fmt::format("{:%Q}", 42s); // value == "42" auto value = fmt::format("{:%Q}", 42s); // value == "42"
auto unit = fmt::format("{:%q}", 42s); // unit == "s" auto unit = fmt::format("{:%q}", 42s); // unit == "s"
``` ```
...@@ -736,7 +737,7 @@ ...@@ -736,7 +737,7 @@
* Fixed handling of dynamic width in chrono formatter: * Fixed handling of dynamic width in chrono formatter:
``` {.c++} ```c++
auto s = fmt::format("{0:{1}%H:%M:%S}", std::chrono::seconds(12345), 12); auto s = fmt::format("{0:{1}%H:%M:%S}", std::chrono::seconds(12345), 12);
// ^ width argument index ^ width // ^ width argument index ^ width
// s == "03:25:45 " // s == "03:25:45 "
...@@ -747,9 +748,9 @@ ...@@ -747,9 +748,9 @@
* Removed deprecated `fmt/time.h`. Use `fmt/chrono.h` instead. * Removed deprecated `fmt/time.h`. Use `fmt/chrono.h` instead.
* Added `fmt::format` and `fmt::vformat` overloads that take `text_style` * Added `fmt::format` and `fmt::vformat` overloads that take `text_style`
([\#993](), [\#994]()): (#993, #994):
``` {.c++} ```c++
#include <fmt/color.h> #include <fmt/color.h>
std::string message = fmt::format(fmt::emphasis::bold | fg(fmt::color::red), std::string message = fmt::format(fmt::emphasis::bold | fg(fmt::color::red),
...@@ -762,20 +763,20 @@ ...@@ -762,20 +763,20 @@
`print` overloads that take `text_style` instead. `print` overloads that take `text_style` instead.
* Made `std::unique_ptr` and `std::shared_ptr` formattable as pointers via * Made `std::unique_ptr` and `std::shared_ptr` formattable as pointers via
`fmt::ptr` ([\#1121]()): `fmt::ptr` (#1121):
``` {.c++} ```c++
std::unique_ptr<int> p = ...; std::unique_ptr<int> p = ...;
fmt::print("{}", fmt::ptr(p)); // prints p as a pointer fmt::print("{}", fmt::ptr(p)); // prints p as a pointer
``` ```
Thanks [\@sighingnow (Tao He)](https://github.com/sighingnow). Thanks [\@sighingnow (Tao He)](https://github.com/sighingnow).
* Made `print` and `vprint` report I/O errors ([\#1098](), [\#1099]()). Thanks * Made `print` and `vprint` report I/O errors (#1098, #1099). Thanks
[\@BillyDonahue (Billy Donahue)](https://github.com/BillyDonahue). [\@BillyDonahue (Billy Donahue)](https://github.com/BillyDonahue).
* Marked deprecated APIs with the `[[deprecated]]` attribute and removed * Marked deprecated APIs with the `[[deprecated]]` attribute and removed
internal uses of deprecated APIs ([\#1022]()). Thanks [\@eliaskosunen (Elias internal uses of deprecated APIs (#1022). Thanks [\@eliaskosunen (Elias
Kosunen)](https://github.com/eliaskosunen). Kosunen)](https://github.com/eliaskosunen).
* Modernized the codebase using more C++11 features and removing workarounds. * Modernized the codebase using more C++11 features and removing workarounds.
...@@ -800,35 +801,35 @@ ...@@ -800,35 +801,35 @@
* Moved SFINAE to template parameters to reduce symbol sizes. * Moved SFINAE to template parameters to reduce symbol sizes.
* Switched to `fputws` for writing wide strings so that it\'s no longer required * Switched to `fputws` for writing wide strings so that it\'s no longer required
to call `_setmode` on Windows ([\#1229](), [\#1243]()). Thanks [\@jackoalan to call `_setmode` on Windows (#1229, #1243). Thanks [\@jackoalan
(Jack Andersen)](https://github.com/jackoalan). (Jack Andersen)](https://github.com/jackoalan).
* Improved literal-based API ([\#1254]()). Thanks [\@sylveon (Charles * Improved literal-based API (#1254). Thanks [\@sylveon (Charles
Milette)](https://github.com/sylveon). Milette)](https://github.com/sylveon).
* Added support for exotic platforms without `uintptr_t` such as IBM i (AS/400) * Added support for exotic platforms without `uintptr_t` such as IBM i (AS/400)
which has 128-bit pointers and only 64-bit integers ([\#1059]()). which has 128-bit pointers and only 64-bit integers (#1059).
* Added [Sublime Text syntax highlighting * Added [Sublime Text syntax highlighting
config](https://github.com/fmtlib/fmt/blob/master/support/C%2B%2B.sublime-syntax) config](https://github.com/fmtlib/fmt/blob/master/support/C%2B%2B.sublime-syntax)
([\#1037]()). Thanks [\@Kronuz (Germán Méndez (#1037). Thanks [\@Kronuz (Germán Méndez
Bravo)](https://github.com/Kronuz). Bravo)](https://github.com/Kronuz).
* Added the `FMT_ENFORCE_COMPILE_STRING` macro to enforce the use of * Added the `FMT_ENFORCE_COMPILE_STRING` macro to enforce the use of
compile-time format strings ([\#1231]()). Thanks [\@jackoalan (Jack compile-time format strings (#1231). Thanks [\@jackoalan (Jack
Andersen)](https://github.com/jackoalan). Andersen)](https://github.com/jackoalan).
* Stopped setting `CMAKE_BUILD_TYPE` if {fmt} is a subproject ([\#1081]()). * Stopped setting `CMAKE_BUILD_TYPE` if {fmt} is a subproject (#1081).
* Various build improvements ([\#1039](), [\#1078](), [\#1091](), [\#1103](), * Various build improvements (#1039, #1078, #1091, #1103,
[\#1177]()). Thanks [\@luncliff (Park DongHa)](https://github.com/luncliff), #1177). Thanks [\@luncliff (Park DongHa)](https://github.com/luncliff),
[\@jasonszang (Jason Shuo Zang)](https://github.com/jasonszang), [\@olafhering [\@jasonszang (Jason Shuo Zang)](https://github.com/jasonszang), [\@olafhering
(Olaf Hering)](https://github.com/olafhering), (Olaf Hering)](https://github.com/olafhering),
[\@Lecetem](https://github.com/Lectem), [\@pauldreik (Paul [\@Lecetem](https://github.com/Lectem), [\@pauldreik (Paul
Dreik)](https://github.com/pauldreik). Dreik)](https://github.com/pauldreik).
* Improved documentation ([\#1049](), [\#1051](), [\#1083](), [\#1113](), * Improved documentation (#1049, #1051, #1083, #1113,
[\#1114](), [\#1146](), [\#1180](), [\#1250](), [\#1252](), [\#1265]()). #1114, #1146, #1180, #1250, #1252, #1265).
Thanks [\@mikelui (Michael Lui)](https://github.com/mikelui), [\@foonathan Thanks [\@mikelui (Michael Lui)](https://github.com/mikelui), [\@foonathan
(Jonathan Müller)](https://github.com/foonathan), [\@BillyDonahue (Billy (Jonathan Müller)](https://github.com/foonathan), [\@BillyDonahue (Billy
Donahue)](https://github.com/BillyDonahue), [\@jwakely (Jonathan Donahue)](https://github.com/BillyDonahue), [\@jwakely (Jonathan
...@@ -836,52 +837,52 @@ ...@@ -836,52 +837,52 @@
Salah)](https://github.com/kaisbe), [\@sdebionne (Samuel Salah)](https://github.com/kaisbe), [\@sdebionne (Samuel
Debionne)](https://github.com/sdebionne). Debionne)](https://github.com/sdebionne).
* Fixed ambiguous formatter specialization in `fmt/ranges.h` ([\#1123]()). * Fixed ambiguous formatter specialization in `fmt/ranges.h` (#1123).
* Fixed formatting of a non-empty `std::filesystem::path` which is an infinitely * Fixed formatting of a non-empty `std::filesystem::path` which is an infinitely
deep range of its components ([\#1268]()). deep range of its components (#1268).
* Fixed handling of general output iterators when formatting characters * Fixed handling of general output iterators when formatting characters
([\#1056](), [\#1058]()). Thanks [\@abolz (Alexander (#1056, #1058). Thanks [\@abolz (Alexander
Bolz)](https://github.com/abolz). Bolz)](https://github.com/abolz).
* Fixed handling of output iterators in `formatter` specialization for ranges * Fixed handling of output iterators in `formatter` specialization for ranges
([\#1064]()). (#1064).
* Fixed handling of exotic character types ([\#1188]()). * Fixed handling of exotic character types (#1188).
* Made chrono formatting work with exceptions disabled ([\#1062]()). * Made chrono formatting work with exceptions disabled (#1062).
* Fixed DLL visibility issues ([\#1134](), [\#1147]()). Thanks * Fixed DLL visibility issues (#1134, #1147). Thanks
[\@denchat](https://github.com/denchat). [\@denchat](https://github.com/denchat).
* Disabled the use of UDL template extension on GCC 9 ([\#1148]()). * Disabled the use of UDL template extension on GCC 9 (#1148).
* Removed misplaced `format` compile-time checks from `printf` ([\#1173]()). * Removed misplaced `format` compile-time checks from `printf` (#1173).
* Fixed issues in the experimental floating-point formatter ([\#1072](), * Fixed issues in the experimental floating-point formatter (#1072,
[\#1129](), [\#1153](), [\#1155](), [\#1210](), [\#1222]()). Thanks #1129, #1153, #1155, #1210, #1222). Thanks
[\@alabuzhev (Alex Alabuzhev)](https://github.com/alabuzhev). [\@alabuzhev (Alex Alabuzhev)](https://github.com/alabuzhev).
* Fixed bugs discovered by fuzzing or during fuzzing integration ([\#1124](), * Fixed bugs discovered by fuzzing or during fuzzing integration (#1124,
[\#1127](), [\#1132](), [\#1135](), [\#1136](), [\#1141](), [\#1142](), #1127, #1132, #1135, #1136, #1141, #1142,
[\#1178](), [\#1179](), [\#1194]()). Thanks [\@pauldreik (Paul #1178, #1179, #1194). Thanks [\@pauldreik (Paul
Dreik)](https://github.com/pauldreik). Dreik)](https://github.com/pauldreik).
* Fixed building tests on FreeBSD and Hurd ([\#1043]()). Thanks [\@jackyf * Fixed building tests on FreeBSD and Hurd (#1043). Thanks [\@jackyf
(Eugene V. Lyubimkin)](https://github.com/jackyf). (Eugene V. Lyubimkin)](https://github.com/jackyf).
* Fixed various warnings and compilation issues ([\#998](), [\#1006](), * Fixed various warnings and compilation issues (#998, #1006,
[\#1008](), [\#1011](), [\#1025](), [\#1027](), [\#1028](), [\#1029](), #1008, #1011, #1025, #1027, #1028, #1029,
[\#1030](), [\#1031](), [\#1054](), [\#1063](), [\#1068](), [\#1074](), #1030, #1031, #1054, #1063, #1068, #1074,
[\#1075](), [\#1079](), [\#1086](), [\#1088](), [\#1089](), [\#1094](), #1075, #1079, #1086, #1088, #1089, #1094,
[\#1101](), [\#1102](), [\#1105](), [\#1107](), [\#1115](), [\#1117](), #1101, #1102, #1105, #1107, #1115, #1117,
[\#1118](), [\#1120](), [\#1123](), [\#1139](), [\#1140](), [\#1143](), #1118, #1120, #1123, #1139, #1140, #1143,
[\#1144](), [\#1150](), [\#1151](), [\#1152](), [\#1154](), [\#1156](), #1144, #1150, #1151, #1152, #1154, #1156,
[\#1159](), [\#1175](), [\#1181](), [\#1186](), [\#1187](), [\#1191](), #1159, #1175, #1181, #1186, #1187, #1191,
[\#1197](), [\#1200](), [\#1203](), [\#1205](), [\#1206](), [\#1213](), #1197, #1200, #1203, #1205, #1206, #1213,
[\#1214](), [\#1217](), [\#1228](), [\#1230](), [\#1232](), [\#1235](), #1214, #1217, #1228, #1230, #1232, #1235,
[\#1236](), [\#1240]()). Thanks [\@DanielaE (Daniela #1236, #1240). Thanks [\@DanielaE (Daniela
Engert)](https://github.com/DanielaE), Engert)](https://github.com/DanielaE),
[\@mwinterb](https://github.com/mwinterb), [\@eliaskosunen (Elias [\@mwinterb](https://github.com/mwinterb), [\@eliaskosunen (Elias
Kosunen)](https://github.com/eliaskosunen), Kosunen)](https://github.com/eliaskosunen),
...@@ -906,7 +907,7 @@ ...@@ -906,7 +907,7 @@
* Introduced experimental chrono formatting support: * Introduced experimental chrono formatting support:
``` {.c++} ```c++
#include <fmt/chrono.h> #include <fmt/chrono.h>
int main() { int main() {
...@@ -923,9 +924,9 @@ ...@@ -923,9 +924,9 @@
* Added experimental support for emphasis (bold, italic, underline, * Added experimental support for emphasis (bold, italic, underline,
strikethrough), colored output to a file stream, and improved colored strikethrough), colored output to a file stream, and improved colored
formatting API ([\#961](), [\#967](), [\#973]()): formatting API (#961, #967, #973):
``` {.c++} ```c++
#include <fmt/color.h> #include <fmt/color.h>
int main() { int main() {
...@@ -944,9 +945,9 @@ ...@@ -944,9 +945,9 @@
Thanks [\@Rakete1111 (Nicolas)](https://github.com/Rakete1111). Thanks [\@Rakete1111 (Nicolas)](https://github.com/Rakete1111).
* Added support for 4-bit terminal colors ([\#968](), [\#974]()) * Added support for 4-bit terminal colors (#968, #974)
``` {.c++} ```c++
#include <fmt/color.h> #include <fmt/color.h>
int main() { int main() {
...@@ -961,11 +962,11 @@ ...@@ -961,11 +962,11 @@
Thanks [\@Rakete1111 (Nicolas)](https://github.com/Rakete1111). Thanks [\@Rakete1111 (Nicolas)](https://github.com/Rakete1111).
* Parameterized formatting functions on the type of the format string * Parameterized formatting functions on the type of the format string
([\#880](), [\#881](), [\#883](), [\#885](), [\#897](), [\#920]()). Any object (#880, #881, #883, #885, #897, #920). Any object
of type `S` that has an overloaded `to_string_view(const S&)` returning of type `S` that has an overloaded `to_string_view(const S&)` returning
`fmt::string_view` can be used as a format string: `fmt::string_view` can be used as a format string:
``` {.c++} ```c++
namespace my_ns { namespace my_ns {
inline string_view to_string_view(const my_string& s) { inline string_view to_string_view(const my_string& s) {
return {s.data(), s.length()}; return {s.data(), s.length()};
...@@ -977,25 +978,25 @@ ...@@ -977,25 +978,25 @@
Thanks [\@DanielaE (Daniela Engert)](https://github.com/DanielaE). Thanks [\@DanielaE (Daniela Engert)](https://github.com/DanielaE).
* Made `std::string_view` work as a format string ([\#898]()): * Made `std::string_view` work as a format string (#898):
``` {.c++} ```c++
auto message = fmt::format(std::string_view("The answer is {}."), 42); auto message = fmt::format(std::string_view("The answer is {}."), 42);
``` ```
Thanks [\@DanielaE (Daniela Engert)](https://github.com/DanielaE). Thanks [\@DanielaE (Daniela Engert)](https://github.com/DanielaE).
* Added wide string support to compile-time format string checks ([\#924]()): * Added wide string support to compile-time format string checks (#924):
``` {.c++} ```c++
print(fmt(L"{:f}"), 42); // compile-time error: invalid type specifier print(fmt(L"{:f}"), 42); // compile-time error: invalid type specifier
``` ```
Thanks [\@XZiar](https://github.com/XZiar). Thanks [\@XZiar](https://github.com/XZiar).
* Made colored print functions work with wide strings ([\#867]()): * Made colored print functions work with wide strings (#867):
``` {.c++} ```c++
#include <fmt/color.h> #include <fmt/color.h>
int main() { int main() {
...@@ -1005,16 +1006,16 @@ ...@@ -1005,16 +1006,16 @@
Thanks [\@DanielaE (Daniela Engert)](https://github.com/DanielaE). Thanks [\@DanielaE (Daniela Engert)](https://github.com/DanielaE).
* Introduced experimental Unicode support ([\#628](), [\#891]()): * Introduced experimental Unicode support (#628, #891):
``` {.c++} ```c++
using namespace fmt::literals; using namespace fmt::literals;
auto s = fmt::format("{:*^5}"_u, "🤡"_u); // s == "**🤡**"_u auto s = fmt::format("{:*^5}"_u, "🤡"_u); // s == "**🤡**"_u
``` ```
* Improved locale support: * Improved locale support:
``` {.c++} ```c++
#include <fmt/locale.h> #include <fmt/locale.h>
struct numpunct : std::numpunct<char> { struct numpunct : std::numpunct<char> {
...@@ -1027,10 +1028,10 @@ ...@@ -1027,10 +1028,10 @@
// s == "1~234~567" // s == "1~234~567"
``` ```
* Constrained formatting functions on proper iterator types ([\#921]()). Thanks * Constrained formatting functions on proper iterator types (#921). Thanks
[\@DanielaE (Daniela Engert)](https://github.com/DanielaE). [\@DanielaE (Daniela Engert)](https://github.com/DanielaE).
* Added `make_printf_args` and `make_wprintf_args` functions ([\#934]()). Thanks * Added `make_printf_args` and `make_wprintf_args` functions (#934). Thanks
[\@tnovotny](https://github.com/tnovotny). [\@tnovotny](https://github.com/tnovotny).
* Deprecated `fmt::visit`, `parse_context`, and `wparse_context`. Use * Deprecated `fmt::visit`, `parse_context`, and `wparse_context`. Use
...@@ -1038,49 +1039,49 @@ ...@@ -1038,49 +1039,49 @@
instead. instead.
* Removed undocumented `basic_fixed_buffer` which has been superseded by the * Removed undocumented `basic_fixed_buffer` which has been superseded by the
iterator-based API ([\#873](), [\#902]()). Thanks [\@superfunc (hollywood iterator-based API (#873, #902). Thanks [\@superfunc (hollywood
programmer)](https://github.com/superfunc). programmer)](https://github.com/superfunc).
* Disallowed repeated leading zeros in an argument ID: * Disallowed repeated leading zeros in an argument ID:
``` {.c++} ```c++
fmt::print("{000}", 42); // error fmt::print("{000}", 42); // error
``` ```
* Reintroduced support for gcc 4.4. * Reintroduced support for gcc 4.4.
* Fixed compilation on platforms with exotic `double` ([\#878]()). * Fixed compilation on platforms with exotic `double` (#878).
* Improved documentation ([\#164](), [\#877](), [\#901](), [\#906](), * Improved documentation (#164, #877, #901, #906,
[\#979]()). Thanks [\@kookjr (Mathew Cucuzella)](https://github.com/kookjr), #979). Thanks [\@kookjr (Mathew Cucuzella)](https://github.com/kookjr),
[\@DarkDimius (Dmitry Petrashko)](https://github.com/DarkDimius), [\@DarkDimius (Dmitry Petrashko)](https://github.com/DarkDimius),
[\@HecticSerenity](https://github.com/HecticSerenity). [\@HecticSerenity](https://github.com/HecticSerenity).
* Added pkgconfig support which makes it easier to consume the library from * Added pkgconfig support which makes it easier to consume the library from
meson and other build systems ([\#916]()). Thanks [\@colemickens (Cole meson and other build systems (#916). Thanks [\@colemickens (Cole
Mickens)](https://github.com/colemickens). Mickens)](https://github.com/colemickens).
* Various build improvements ([\#909](), [\#926](), [\#937](), [\#953](), * Various build improvements (#909, #926, #937, #953,
[\#959]()). Thanks [\@tchaikov (Kefu Chai)](https://github.com/tchaikov), #959). Thanks [\@tchaikov (Kefu Chai)](https://github.com/tchaikov),
[\@luncliff (Park DongHa)](https://github.com/luncliff), [\@AndreasSchoenle [\@luncliff (Park DongHa)](https://github.com/luncliff), [\@AndreasSchoenle
(Andreas Schönle)](https://github.com/AndreasSchoenle), (Andreas Schönle)](https://github.com/AndreasSchoenle),
[\@hotwatermorning](https://github.com/hotwatermorning), [\@Zefz [\@hotwatermorning](https://github.com/hotwatermorning), [\@Zefz
(JohanJansen)](https://github.com/Zefz). (JohanJansen)](https://github.com/Zefz).
* Improved `string_view` construction performance ([\#914]()). Thanks [\@gabime * Improved `string_view` construction performance (#914). Thanks [\@gabime
(Gabi Melman)](https://github.com/gabime). (Gabi Melman)](https://github.com/gabime).
* Fixed non-matching char types ([\#895]()). Thanks [\@DanielaE (Daniela * Fixed non-matching char types (#895). Thanks [\@DanielaE (Daniela
Engert)](https://github.com/DanielaE). Engert)](https://github.com/DanielaE).
* Fixed `format_to_n` with `std::back_insert_iterator` ([\#913]()). Thanks * Fixed `format_to_n` with `std::back_insert_iterator` (#913). Thanks
[\@DanielaE (Daniela Engert)](https://github.com/DanielaE). [\@DanielaE (Daniela Engert)](https://github.com/DanielaE).
* Fixed locale-dependent formatting ([\#905]()). * Fixed locale-dependent formatting (#905).
* Fixed various compiler warnings and errors ([\#882](), [\#886](), [\#933](), * Fixed various compiler warnings and errors (#882, #886, #933,
[\#941](), [\#931](), [\#943](), [\#954](), [\#956](), [\#962](), [\#965](), #941, #931, #943, #954, #956, #962, #965,
[\#977](), [\#983](), [\#989]()). Thanks [\@Luthaf (Guillaume #977, #983, #989). Thanks [\@Luthaf (Guillaume
Fraux)](https://github.com/Luthaf), [\@stevenhoving (Steven Fraux)](https://github.com/Luthaf), [\@stevenhoving (Steven
Hoving)](https://github.com/stevenhoving), [\@christinaa (Kristina Hoving)](https://github.com/stevenhoving), [\@christinaa (Kristina
Brooks)](https://github.com/christinaa), [\@lgritz (Larry Brooks)](https://github.com/christinaa), [\@lgritz (Larry
...@@ -1092,16 +1093,16 @@ ...@@ -1092,16 +1093,16 @@
5.2.1 - 2018-09-21 5.2.1 - 2018-09-21
================== ==================
* Fixed `visit` lookup issues on gcc 7 & 8 ([\#870]()). Thanks * Fixed `visit` lookup issues on gcc 7 & 8 (#870). Thanks
[\@medithe](https://github.com/medithe). [\@medithe](https://github.com/medithe).
* Fixed linkage errors on older gcc. * Fixed linkage errors on older gcc.
* Prevented `fmt/range.h` from specializing `fmt::basic_string_view` ([\#865](), * Prevented `fmt/range.h` from specializing `fmt::basic_string_view` (#865,
[\#868]()). Thanks [\@hhggit (dual)](https://github.com/hhggit). #868). Thanks [\@hhggit (dual)](https://github.com/hhggit).
* Improved error message when formatting unknown types ([\#872]()). Thanks * Improved error message when formatting unknown types (#872). Thanks
[\@foonathan (Jonathan Müller)](https://github.com/foonathan), [\@foonathan (Jonathan Müller)](https://github.com/foonathan),
* Disabled templated user-defined literals when compiled under nvcc ([\#875]()). * Disabled templated user-defined literals when compiled under nvcc (#875).
Thanks [\@CandyGumdrop (Candy Gumdrop)](https://github.com/CandyGumdrop), Thanks [\@CandyGumdrop (Candy Gumdrop)](https://github.com/CandyGumdrop),
* Fixed `format_to` formatting to `wmemory_buffer` ([\#874]()). * Fixed `format_to` formatting to `wmemory_buffer` (#874).
5.2.0 - 2018-09-13 5.2.0 - 2018-09-13
================== ==================
...@@ -1126,16 +1127,16 @@ ...@@ -1126,16 +1127,16 @@
enable it define the `FMT_STRING_ALIAS` macro to 1 before including enable it define the `FMT_STRING_ALIAS` macro to 1 before including
`fmt/format.h`: `fmt/format.h`:
``` {.c++} ```c++
#define FMT_STRING_ALIAS 1 #define FMT_STRING_ALIAS 1
#include <fmt/format.h> #include <fmt/format.h>
std::string answer = format(fmt("{}"), 42); std::string answer = format(fmt("{}"), 42);
``` ```
* Added compile-time format string checks to `format_to` overload that takes * Added compile-time format string checks to `format_to` overload that takes
`fmt::memory_buffer` ([\#783]()): `fmt::memory_buffer` (#783):
``` {.c++} ```c++
fmt::memory_buffer buf; fmt::memory_buffer buf;
// Compile-time error: invalid type specifier. // Compile-time error: invalid type specifier.
fmt::format_to(buf, fmt("{:d}"), "foo"); fmt::format_to(buf, fmt("{:d}"), "foo");
...@@ -1148,7 +1149,7 @@ ...@@ -1148,7 +1149,7 @@
* Added formatting support for types explicitly convertible to * Added formatting support for types explicitly convertible to
`fmt::string_view`: `fmt::string_view`:
``` {.c++} ```c++
struct foo { struct foo {
explicit operator fmt::string_view() const { return "foo"; } explicit operator fmt::string_view() const { return "foo"; }
}; };
...@@ -1161,32 +1162,32 @@ ...@@ -1161,32 +1162,32 @@
function overloads with a single function template parameterized on the string function overloads with a single function template parameterized on the string
type. type.
* Added support for dynamic argument lists ([\#814](), [\#819]()). Thanks * Added support for dynamic argument lists (#814, #819). Thanks
[\@MikePopoloski (Michael Popoloski)](https://github.com/MikePopoloski). [\@MikePopoloski (Michael Popoloski)](https://github.com/MikePopoloski).
* Reduced executable size overhead for embedded targets using newlib nano by * Reduced executable size overhead for embedded targets using newlib nano by
making locale dependency optional ([\#839]()). Thanks [\@teajay-fr (Thomas making locale dependency optional (#839). Thanks [\@teajay-fr (Thomas
Benard)](https://github.com/teajay-fr). Benard)](https://github.com/teajay-fr).
* Keep `noexcept` specifier when exceptions are disabled ([\#801](), [\#810]()). * Keep `noexcept` specifier when exceptions are disabled (#801, #810).
Thanks [\@qis (Alexej Harm)](https://github.com/qis). Thanks [\@qis (Alexej Harm)](https://github.com/qis).
* Fixed formatting of user-defined types providing `operator<<` with * Fixed formatting of user-defined types providing `operator<<` with
`format_to_n` ([\#806]()). Thanks [\@mkurdej (Marek `format_to_n` (#806). Thanks [\@mkurdej (Marek
Kurdej)](https://github.com/mkurdej). Kurdej)](https://github.com/mkurdej).
* Fixed dynamic linkage of new symbols ([\#808]()). * Fixed dynamic linkage of new symbols (#808).
* Fixed global initialization issue ([\#807]()): * Fixed global initialization issue (#807):
``` {.c++} ```c++
// This works on compilers with constexpr support. // This works on compilers with constexpr support.
static const std::string answer = fmt::format("{}", 42); static const std::string answer = fmt::format("{}", 42);
``` ```
* Fixed various compiler warnings and errors ([\#804](), [\#809](), [\#811](), * Fixed various compiler warnings and errors (#804, #809, #811,
[\#822](), [\#827](), [\#830](), [\#838](), [\#843](), [\#844](), [\#851](), #822, #827, #830, #838, #843, #844, #851,
[\#852](), [\#854]()). Thanks [\@henryiii (Henry #852, #854). Thanks [\@henryiii (Henry
Schreiner)](https://github.com/henryiii), Schreiner)](https://github.com/henryiii),
[\@medithe](https://github.com/medithe), and [\@eliasdaler (Elias [\@medithe](https://github.com/medithe), and [\@eliasdaler (Elias
Daler)](https://github.com/eliasdaler). Daler)](https://github.com/eliasdaler).
...@@ -1197,7 +1198,7 @@ ...@@ -1197,7 +1198,7 @@
* Added experimental support for RGB color output enabled with the * Added experimental support for RGB color output enabled with the
`FMT_EXTENDED_COLORS` macro: `FMT_EXTENDED_COLORS` macro:
``` {.c++} ```c++
#define FMT_EXTENDED_COLORS #define FMT_EXTENDED_COLORS
#define FMT_HEADER_ONLY // or compile fmt with FMT_EXTENDED_COLORS defined #define FMT_HEADER_ONLY // or compile fmt with FMT_EXTENDED_COLORS defined
#include <fmt/format.h> #include <fmt/format.h>
...@@ -1206,45 +1207,45 @@ ...@@ -1206,45 +1207,45 @@
``` ```
The old API (the `print_colored` and `vprint_colored` functions and the The old API (the `print_colored` and `vprint_colored` functions and the
`color` enum) is now deprecated. ([\#762]() [\#767]()). thanks [\@Remotion `color` enum) is now deprecated. (#762 #767). thanks [\@Remotion
(Remo)](https://github.com/Remotion). (Remo)](https://github.com/Remotion).
* Added quotes to strings in ranges and tuples ([\#766]()). Thanks [\@Remotion * Added quotes to strings in ranges and tuples (#766). Thanks [\@Remotion
(Remo)](https://github.com/Remotion). (Remo)](https://github.com/Remotion).
* Made `format_to` work with `basic_memory_buffer` ([\#776]()). * Made `format_to` work with `basic_memory_buffer` (#776).
* Added `vformat_to_n` and `wchar_t` overload of `format_to_n` ([\#764](), * Added `vformat_to_n` and `wchar_t` overload of `format_to_n` (#764,
[\#769]()). #769).
* Made `is_range` and `is_tuple_like` part of public (experimental) API to allow * Made `is_range` and `is_tuple_like` part of public (experimental) API to allow
specialization for user-defined types ([\#751](), [\#759]()). Thanks [\@drrlvn specialization for user-defined types (#751, #759). Thanks [\@drrlvn
(Dror Levin)](https://github.com/drrlvn). (Dror Levin)](https://github.com/drrlvn).
* Added more compilers to continuous integration and increased `FMT_PEDANTIC` * Added more compilers to continuous integration and increased `FMT_PEDANTIC`
warning levels ([\#736]()). Thanks [\@eliaskosunen (Elias warning levels (#736). Thanks [\@eliaskosunen (Elias
Kosunen)](https://github.com/eliaskosunen). Kosunen)](https://github.com/eliaskosunen).
* Fixed compilation with MSVC 2013. * Fixed compilation with MSVC 2013.
* Fixed handling of user-defined types in `format_to` ([\#793]()). * Fixed handling of user-defined types in `format_to` (#793).
* Forced linking of inline `vformat` functions into the library ([\#795]()). * Forced linking of inline `vformat` functions into the library (#795).
* Fixed incorrect call to on\_align in `'{:}='` ([\#750]()). * Fixed incorrect call to on\_align in `'{:}='` (#750).
* Fixed floating-point formatting to a non-back\_insert\_iterator with sign & * Fixed floating-point formatting to a non-back\_insert\_iterator with sign &
numeric alignment specified ([\#756]()). numeric alignment specified (#756).
* Fixed formatting to an array with `format_to_n` ([\#778]()). * Fixed formatting to an array with `format_to_n` (#778).
* Fixed formatting of more than 15 named arguments ([\#754]()). * Fixed formatting of more than 15 named arguments (#754).
* Fixed handling of compile-time strings when including `fmt/ostream.h`. * Fixed handling of compile-time strings when including `fmt/ostream.h`.
([\#768]()). (#768).
* Fixed various compiler warnings and errors ([\#742](), [\#748](), [\#752](), * Fixed various compiler warnings and errors (#742, #748, #752,
[\#770](), [\#775](), [\#779](), [\#780](), [\#790](), [\#792](), [\#800]()). #770, #775, #779, #780, #790, #792, #800).
Thanks [\@Remotion (Remo)](https://github.com/Remotion), [\@gabime (Gabi Thanks [\@Remotion (Remo)](https://github.com/Remotion), [\@gabime (Gabi
Melman)](https://github.com/gabime), [\@foonathan (Jonathan Melman)](https://github.com/gabime), [\@foonathan (Jonathan
Müller)](https://github.com/foonathan), [\@Dark-Passenger (Dhruv Müller)](https://github.com/foonathan), [\@Dark-Passenger (Dhruv
...@@ -1270,7 +1271,7 @@ ...@@ -1270,7 +1271,7 @@
checks](https://fmt.dev/dev/api.html#compile-time-format-string-checks). For checks](https://fmt.dev/dev/api.html#compile-time-format-string-checks). For
example example
``` {.c++} ```c++
#include <fmt/format.h> #include <fmt/format.h>
std::string s = format(fmt("{:d}"), "foo"); std::string s = format(fmt("{:d}"), "foo");
...@@ -1292,7 +1293,7 @@ ...@@ -1292,7 +1293,7 @@
* Separated format string parsing and formatting in the extension API to enable * Separated format string parsing and formatting in the extension API to enable
compile-time format string processing. For example compile-time format string processing. For example
``` {.c++} ```c++
struct Answer {}; struct Answer {};
namespace fmt { namespace fmt {
...@@ -1330,7 +1331,7 @@ ...@@ -1330,7 +1331,7 @@
* Added [iterator * Added [iterator
support](https://fmt.dev/dev/api.html#output-iterator-support): support](https://fmt.dev/dev/api.html#output-iterator-support):
``` {.c++} ```c++
#include <vector> #include <vector>
#include <fmt/format.h> #include <fmt/format.h>
...@@ -1341,9 +1342,9 @@ ...@@ -1341,9 +1342,9 @@
* Added the * Added the
[format\_to\_n](https://fmt.dev/dev/api.html#_CPPv2N3fmt11format_to_nE8OutputItNSt6size_tE11string_viewDpRK4Args) [format\_to\_n](https://fmt.dev/dev/api.html#_CPPv2N3fmt11format_to_nE8OutputItNSt6size_tE11string_viewDpRK4Args)
function that restricts the output to the specified number of characters function that restricts the output to the specified number of characters
([\#298]()): (#298):
``` {.c++} ```c++
char out[4]; char out[4];
fmt::format_to_n(out, sizeof(out), "{}", 12345); fmt::format_to_n(out, sizeof(out), "{}", 12345);
// out == "1234" (without terminating '\0') // out == "1234" (without terminating '\0')
...@@ -1353,7 +1354,7 @@ ...@@ -1353,7 +1354,7 @@
[formatted\_size](https://fmt.dev/dev/api.html#_CPPv2N3fmt14formatted_sizeE11string_viewDpRK4Args) [formatted\_size](https://fmt.dev/dev/api.html#_CPPv2N3fmt14formatted_sizeE11string_viewDpRK4Args)
function for computing the output size: function for computing the output size:
``` {.c++} ```c++
#include <fmt/format.h> #include <fmt/format.h>
auto size = fmt::formatted_size("{}", 12345); // size == 5 auto size = fmt::formatted_size("{}", 12345); // size == 5
...@@ -1362,7 +1363,7 @@ ...@@ -1362,7 +1363,7 @@
* Improved compile times by reducing dependencies on standard headers and * Improved compile times by reducing dependencies on standard headers and
providing a lightweight [core API](https://fmt.dev/dev/api.html#core-api): providing a lightweight [core API](https://fmt.dev/dev/api.html#core-api):
``` {.c++} ```c++
#include <fmt/core.h> #include <fmt/core.h>
fmt::print("The answer is {}.", 42); fmt::print("The answer is {}.", 42);
...@@ -1375,7 +1376,7 @@ ...@@ -1375,7 +1376,7 @@
[make\_format\_args](https://fmt.dev/dev/api.html#_CPPv2N3fmt16make_format_argsEDpRK4Args) [make\_format\_args](https://fmt.dev/dev/api.html#_CPPv2N3fmt16make_format_argsEDpRK4Args)
function for capturing formatting arguments: function for capturing formatting arguments:
``` {.c++} ```c++
// Prints formatted error message. // Prints formatted error message.
void vreport_error(const char *format, fmt::format_args args) { void vreport_error(const char *format, fmt::format_args args) {
fmt::print("Error: "); fmt::print("Error: ");
...@@ -1388,13 +1389,13 @@ ...@@ -1388,13 +1389,13 @@
``` ```
* Added the `make_printf_args` function for capturing `printf` arguments * Added the `make_printf_args` function for capturing `printf` arguments
([\#687](), [\#694]()). Thanks [\@Kronuz (Germán Méndez (#687, #694). Thanks [\@Kronuz (Germán Méndez
Bravo)](https://github.com/Kronuz). Bravo)](https://github.com/Kronuz).
* Added prefix `v` to non-variadic functions taking `format_args` to distinguish * Added prefix `v` to non-variadic functions taking `format_args` to distinguish
them from variadic ones: them from variadic ones:
``` {.c++} ```c++
std::string vformat(string_view format_str, format_args args); std::string vformat(string_view format_str, format_args args);
template <typename... Args> template <typename... Args>
...@@ -1402,9 +1403,9 @@ ...@@ -1402,9 +1403,9 @@
``` ```
* Added experimental support for formatting ranges, containers and tuple-like * Added experimental support for formatting ranges, containers and tuple-like
types in `fmt/ranges.h` ([\#735]()): types in `fmt/ranges.h` (#735):
``` {.c++} ```c++
#include <fmt/ranges.h> #include <fmt/ranges.h>
std::vector<int> v = {1, 2, 3}; std::vector<int> v = {1, 2, 3};
...@@ -1413,9 +1414,9 @@ ...@@ -1413,9 +1414,9 @@
Thanks [\@Remotion (Remo)](https://github.com/Remotion). Thanks [\@Remotion (Remo)](https://github.com/Remotion).
* Implemented `wchar_t` date and time formatting ([\#712]()): * Implemented `wchar_t` date and time formatting (#712):
``` {.c++} ```c++
#include <fmt/time.h> #include <fmt/time.h>
std::time_t t = std::time(nullptr); std::time_t t = std::time(nullptr);
...@@ -1424,16 +1425,16 @@ ...@@ -1424,16 +1425,16 @@
Thanks [\@DanielaE (Daniela Engert)](https://github.com/DanielaE). Thanks [\@DanielaE (Daniela Engert)](https://github.com/DanielaE).
* Provided more wide string overloads ([\#724]()). Thanks [\@DanielaE (Daniela * Provided more wide string overloads (#724). Thanks [\@DanielaE (Daniela
Engert)](https://github.com/DanielaE). Engert)](https://github.com/DanielaE).
* Switched from a custom null-terminated string view class to `string_view` in * Switched from a custom null-terminated string view class to `string_view` in
the format API and provided `fmt::string_view` which implements a subset of the format API and provided `fmt::string_view` which implements a subset of
`std::string_view` API for pre-C++17 systems. `std::string_view` API for pre-C++17 systems.
* Added support for `std::experimental::string_view` ([\#607]()): * Added support for `std::experimental::string_view` (#607):
``` {.c++} ```c++
#include <fmt/core.h> #include <fmt/core.h>
#include <experimental/string_view> #include <experimental/string_view>
...@@ -1445,7 +1446,7 @@ ...@@ -1445,7 +1446,7 @@
* Allowed mixing named and automatic arguments: * Allowed mixing named and automatic arguments:
``` {.c++} ```c++
fmt::format("{} {two}", 1, fmt::arg("two", 2)); fmt::format("{} {two}", 1, fmt::arg("two", 2));
``` ```
...@@ -1454,10 +1455,10 @@ ...@@ -1454,10 +1455,10 @@
format strings. format strings.
* Disallowed formatting of multibyte strings into a wide character target * Disallowed formatting of multibyte strings into a wide character target
([\#606]()). (#606).
* Improved documentation ([\#515](), [\#614](), [\#617](), [\#661](), * Improved documentation (#515, #614, #617, #661,
[\#680]()). Thanks [\@ibell (Ian Bell)](https://github.com/ibell), #680). Thanks [\@ibell (Ian Bell)](https://github.com/ibell),
[\@mihaitodor (Mihai Todor)](https://github.com/mihaitodor), and [\@mihaitodor (Mihai Todor)](https://github.com/mihaitodor), and
[\@johnthagen](https://github.com/johnthagen). [\@johnthagen](https://github.com/johnthagen).
...@@ -1465,37 +1466,37 @@ ...@@ -1465,37 +1466,37 @@
* Introduced an inline namespace for symbol versioning. * Introduced an inline namespace for symbol versioning.
* Added debug postfix `d` to the `fmt` library name ([\#636]()). * Added debug postfix `d` to the `fmt` library name (#636).
* Removed unnecessary `fmt/` prefix in includes ([\#397]()). Thanks [\@chronoxor * Removed unnecessary `fmt/` prefix in includes (#397). Thanks [\@chronoxor
(Ivan Shynkarenka)](https://github.com/chronoxor). (Ivan Shynkarenka)](https://github.com/chronoxor).
* Moved `fmt/*.h` to `include/fmt/*.h` to prevent irrelevant files and * Moved `fmt/*.h` to `include/fmt/*.h` to prevent irrelevant files and
directories appearing on the include search paths when fmt is used as a directories appearing on the include search paths when fmt is used as a
subproject and moved source files to the `src` directory. subproject and moved source files to the `src` directory.
* Added qmake project file `support/fmt.pro` ([\#641]()). Thanks [\@cowo78 * Added qmake project file `support/fmt.pro` (#641). Thanks [\@cowo78
(Giuseppe Corbelli)](https://github.com/cowo78). (Giuseppe Corbelli)](https://github.com/cowo78).
* Added Gradle build file `support/build.gradle` ([\#649]()). Thanks [\@luncliff * Added Gradle build file `support/build.gradle` (#649). Thanks [\@luncliff
(Park DongHa)](https://github.com/luncliff). (Park DongHa)](https://github.com/luncliff).
* Removed `FMT_CPPFORMAT` CMake option. * Removed `FMT_CPPFORMAT` CMake option.
* Fixed a name conflict with the macro `CHAR_WIDTH` in glibc ([\#616]()). Thanks * Fixed a name conflict with the macro `CHAR_WIDTH` in glibc (#616). Thanks
[\@aroig (Abdó Roig-Maranges)](https://github.com/aroig). [\@aroig (Abdó Roig-Maranges)](https://github.com/aroig).
* Fixed handling of nested braces in `fmt::join` ([\#638]()). * Fixed handling of nested braces in `fmt::join` (#638).
* Added `SOURCELINK_SUFFIX` for compatibility with Sphinx 1.5 ([\#497]()). * Added `SOURCELINK_SUFFIX` for compatibility with Sphinx 1.5 (#497).
Thanks [\@ginggs (Graham Inggs)](https://github.com/ginggs). Thanks [\@ginggs (Graham Inggs)](https://github.com/ginggs).
* Added a missing `inline` in the header-only mode ([\#626]()). Thanks [\@aroig * Added a missing `inline` in the header-only mode (#626). Thanks [\@aroig
(Abdó Roig-Maranges)](https://github.com/aroig). (Abdó Roig-Maranges)](https://github.com/aroig).
* Fixed various compiler warnings ([\#640](), [\#656](), [\#679](), [\#681](), * Fixed various compiler warnings (#640, #656, #679, #681,
[\#705]{.title-ref}\_\_, [\#715](), [\#717](), [\#720](), [\#723](), [\#705]{.title-ref}\_\_, #715, #717, #720, #723,
[\#726](), [\#730](), [\#739]()). Thanks #726, #730, #739). Thanks
[\@peterbell10](https://github.com/peterbell10), [\@peterbell10](https://github.com/peterbell10),
[\@LarsGullik](https://github.com/LarsGullik), [\@foonathan (Jonathan [\@LarsGullik](https://github.com/LarsGullik), [\@foonathan (Jonathan
Müller)](https://github.com/foonathan), [\@eliaskosunen (Elias Müller)](https://github.com/foonathan), [\@eliaskosunen (Elias
...@@ -1504,83 +1505,83 @@ ...@@ -1504,83 +1505,83 @@
Engert)](https://github.com/DanielaE), and Engert)](https://github.com/DanielaE), and
[\@mwinterb](https://github.com/mwinterb). [\@mwinterb](https://github.com/mwinterb).
* Worked around an MSVC bug and fixed several warnings ([\#653]()). Thanks * Worked around an MSVC bug and fixed several warnings (#653). Thanks
[\@alabuzhev (Alex Alabuzhev)](https://github.com/alabuzhev). [\@alabuzhev (Alex Alabuzhev)](https://github.com/alabuzhev).
* Worked around GCC bug 67371 ([\#682]()). * Worked around GCC bug 67371 (#682).
* Fixed compilation with `-fno-exceptions` ([\#655]()). Thanks [\@chenxiaolong * Fixed compilation with `-fno-exceptions` (#655). Thanks [\@chenxiaolong
(Andrew Gunnerson)](https://github.com/chenxiaolong). (Andrew Gunnerson)](https://github.com/chenxiaolong).
* Made `constexpr remove_prefix` gcc version check tighter ([\#648]()). * Made `constexpr remove_prefix` gcc version check tighter (#648).
* Renamed internal type enum constants to prevent collision with poorly written * Renamed internal type enum constants to prevent collision with poorly written
C libraries ([\#644]()). C libraries (#644).
* Added detection of `wostream operator<<` ([\#650]()). * Added detection of `wostream operator<<` (#650).
* Fixed compilation on OpenBSD ([\#660]()). Thanks * Fixed compilation on OpenBSD (#660). Thanks
[\@hubslave](https://github.com/hubslave). [\@hubslave](https://github.com/hubslave).
* Fixed compilation on FreeBSD 12 ([\#732]()). Thanks * Fixed compilation on FreeBSD 12 (#732). Thanks
[\@dankm](https://github.com/dankm). [\@dankm](https://github.com/dankm).
* Fixed compilation when there is a mismatch between `-std` options between the * Fixed compilation when there is a mismatch between `-std` options between the
library and user code ([\#664]()). library and user code (#664).
* Fixed compilation with GCC 7 and `-std=c++11` ([\#734]()). * Fixed compilation with GCC 7 and `-std=c++11` (#734).
* Improved generated binary code on GCC 7 and older ([\#668]()). * Improved generated binary code on GCC 7 and older (#668).
* Fixed handling of numeric alignment with no width ([\#675]()). * Fixed handling of numeric alignment with no width (#675).
* Fixed handling of empty strings in UTF8/16 converters ([\#676]()). Thanks * Fixed handling of empty strings in UTF8/16 converters (#676). Thanks
[\@vgalka-sl (Vasili Galka)](https://github.com/vgalka-sl). [\@vgalka-sl (Vasili Galka)](https://github.com/vgalka-sl).
* Fixed formatting of an empty `string_view` ([\#689]()). * Fixed formatting of an empty `string_view` (#689).
* Fixed detection of `string_view` on libc++ ([\#686]()). * Fixed detection of `string_view` on libc++ (#686).
* Fixed DLL issues ([\#696]()). Thanks * Fixed DLL issues (#696). Thanks
[\@sebkoenig](https://github.com/sebkoenig). [\@sebkoenig](https://github.com/sebkoenig).
* Fixed compile checks for mixing narrow and wide strings ([\#690]()). * Fixed compile checks for mixing narrow and wide strings (#690).
* Disabled unsafe implicit conversion to `std::string` ([\#729]()). * Disabled unsafe implicit conversion to `std::string` (#729).
* Fixed handling of reused format specs (as in `fmt::join`) for pointers * Fixed handling of reused format specs (as in `fmt::join`) for pointers
([\#725]()). Thanks [\@mwinterb](https://github.com/mwinterb). (#725). Thanks [\@mwinterb](https://github.com/mwinterb).
* Fixed installation of `fmt/ranges.h` ([\#738]()). Thanks * Fixed installation of `fmt/ranges.h` (#738). Thanks
[\@sv1990](https://github.com/sv1990). [\@sv1990](https://github.com/sv1990).
4.1.0 - 2017-12-20 4.1.0 - 2017-12-20
================== ==================
* Added `fmt::to_wstring()` in addition to `fmt::to_string()` ([\#559]()). * Added `fmt::to_wstring()` in addition to `fmt::to_string()` (#559).
Thanks [\@alabuzhev (Alex Alabuzhev)](https://github.com/alabuzhev). Thanks [\@alabuzhev (Alex Alabuzhev)](https://github.com/alabuzhev).
* Added support for C++17 `std::string_view` ([\#571]() and [\#578]()). Thanks * Added support for C++17 `std::string_view` (#571 and #578). Thanks
[\@thelostt (Mário Feroldi)](https://github.com/thelostt) and [\@thelostt (Mário Feroldi)](https://github.com/thelostt) and
[\@mwinterb](https://github.com/mwinterb). [\@mwinterb](https://github.com/mwinterb).
* Enabled stream exceptions to catch errors ([\#581]()). Thanks * Enabled stream exceptions to catch errors (#581). Thanks
[\@crusader-mike](https://github.com/crusader-mike). [\@crusader-mike](https://github.com/crusader-mike).
* Allowed formatting of class hierarchies with `fmt::format_arg()` ([\#547]()). * Allowed formatting of class hierarchies with `fmt::format_arg()` (#547).
Thanks [\@rollbear (Björn Fahller)](https://github.com/rollbear). Thanks [\@rollbear (Björn Fahller)](https://github.com/rollbear).
* Removed limitations on character types ([\#563]()). Thanks [\@Yelnats321 * Removed limitations on character types (#563). Thanks [\@Yelnats321
(Elnar Dakeshov)](https://github.com/Yelnats321). (Elnar Dakeshov)](https://github.com/Yelnats321).
* Conditionally enabled use of `std::allocator_traits` ([\#583]()). Thanks * Conditionally enabled use of `std::allocator_traits` (#583). Thanks
[\@mwinterb](https://github.com/mwinterb). [\@mwinterb](https://github.com/mwinterb).
* Added support for `const` variadic member function emulation with * Added support for `const` variadic member function emulation with
`FMT_VARIADIC_CONST` ([\#591]()). Thanks [\@ludekvodicka (Ludek `FMT_VARIADIC_CONST` (#591). Thanks [\@ludekvodicka (Ludek
Vodicka)](https://github.com/ludekvodicka). Vodicka)](https://github.com/ludekvodicka).
* Various bugfixes: bad overflow check, unsupported implicit type conversion * Various bugfixes: bad overflow check, unsupported implicit type conversion
when determining formatting function, test segfaults ([\#551]()), ill-formed when determining formatting function, test segfaults (#551), ill-formed
macros ([\#542]()) and ambiguous overloads ([\#580]()). Thanks [\@xylosper macros (#542) and ambiguous overloads (#580). Thanks [\@xylosper
(Byoung-young Lee)](https://github.com/xylosper). (Byoung-young Lee)](https://github.com/xylosper).
* Prevented warnings on MSVC ([\#605](), [\#602](), and [\#545]()), clang * Prevented warnings on MSVC (#605, #602, and #545), clang
([\#582]()), GCC ([\#573]()), various conversion warnings ([\#609](), (#582), GCC (#573), various conversion warnings (#609,
[\#567](), [\#553]() and [\#553]()), and added `override` and `[[noreturn]]` #567, #553 and #553), and added `override` and `[[noreturn]]`
([\#549]() and [\#555]()). Thanks [\@alabuzhev (Alex (#549 and #555). Thanks [\@alabuzhev (Alex
Alabuzhev)](https://github.com/alabuzhev), [\@virgiliofornazin (Virgilio Alabuzhev)](https://github.com/alabuzhev), [\@virgiliofornazin (Virgilio
Alexandre Fornazin)](https://gihtub.com/virgiliofornazin), [\@alexanderbock Alexandre Fornazin)](https://gihtub.com/virgiliofornazin), [\@alexanderbock
(Alexander Bock)](https://github.com/alexanderbock), (Alexander Bock)](https://github.com/alexanderbock),
...@@ -1589,8 +1590,8 @@ ...@@ -1589,8 +1590,8 @@
Cimalando)](https://github.com/jpcima), [\@thelostt (Mário Cimalando)](https://github.com/jpcima), [\@thelostt (Mário
Feroldi)](https://github.com/thelostt), and [\@Manu343726 (Manu Feroldi)](https://github.com/thelostt), and [\@Manu343726 (Manu
Sánchez)](https://github.com/Manu343726). Sánchez)](https://github.com/Manu343726).
* Improved CMake: Used `GNUInstallDirs` to set installation location ([\#610]()) * Improved CMake: Used `GNUInstallDirs` to set installation location (#610)
and fixed warnings ([\#536]() and [\#556]()). Thanks [\@mikecrowe (Mike and fixed warnings (#536 and #556). Thanks [\@mikecrowe (Mike
Crowe)](https://github.com/mikecrowe), Crowe)](https://github.com/mikecrowe),
[\@evgen231](https://github.com/evgen231) and [\@henryiii (Henry [\@evgen231](https://github.com/evgen231) and [\@henryiii (Henry
Schreiner)](https://github.com/henryiii). Schreiner)](https://github.com/henryiii).
...@@ -1599,14 +1600,14 @@ ...@@ -1599,14 +1600,14 @@
================== ==================
* Removed old compatibility headers `cppformat/*.h` and CMake options * Removed old compatibility headers `cppformat/*.h` and CMake options
([\#527]()). Thanks [\@maddinat0r (Alex (#527). Thanks [\@maddinat0r (Alex
Martin)](https://github.com/maddinat0r). Martin)](https://github.com/maddinat0r).
* Added `string.h` containing `fmt::to_string()` as alternative to * Added `string.h` containing `fmt::to_string()` as alternative to
`std::to_string()` as well as other string writer functionality ([\#326]() and `std::to_string()` as well as other string writer functionality (#326 and
[\#441]()): #441):
``` {.c++} ```c++
#include "fmt/string.h" #include "fmt/string.h"
std::string answer = fmt::to_string(42); std::string answer = fmt::to_string(42);
...@@ -1615,11 +1616,11 @@ ...@@ -1615,11 +1616,11 @@
Thanks to [\@glebov-andrey (Andrey Glebov)](https://github.com/glebov-andrey). Thanks to [\@glebov-andrey (Andrey Glebov)](https://github.com/glebov-andrey).
* Moved `fmt::printf()` to new `printf.h` header and allowed `%s` as generic * Moved `fmt::printf()` to new `printf.h` header and allowed `%s` as generic
specifier ([\#453]()), made `%.f` more conformant to regular `printf()` specifier (#453), made `%.f` more conformant to regular `printf()`
([\#490]()), added custom writer support ([\#476]()) and implemented missing (#490), added custom writer support (#476) and implemented missing
custom argument formatting ([\#339]() and [\#340]()): custom argument formatting (#339 and #340):
``` {.c++} ```c++
#include "fmt/printf.h" #include "fmt/printf.h"
// %s format specifier can be used with any argument type. // %s format specifier can be used with any argument type.
...@@ -1628,17 +1629,17 @@ ...@@ -1628,17 +1629,17 @@
Thanks [\@mojoBrendan](https://github.com/mojoBrendan), [\@manylegged (Arthur Thanks [\@mojoBrendan](https://github.com/mojoBrendan), [\@manylegged (Arthur
Danskin)](https://github.com/manylegged) and [\@spacemoose (Glen Danskin)](https://github.com/manylegged) and [\@spacemoose (Glen
Stark)](https://github.com/spacemoose). See also [\#360](), [\#335]() and Stark)](https://github.com/spacemoose). See also #360, #335 and
[\#331](). #331.
* Added `container.h` containing a `BasicContainerWriter` to write to containers * Added `container.h` containing a `BasicContainerWriter` to write to containers
like `std::vector` ([\#450]()). Thanks [\@polyvertex (Jean-Charles like `std::vector` (#450). Thanks [\@polyvertex (Jean-Charles
Lefebvre)](https://github.com/polyvertex). Lefebvre)](https://github.com/polyvertex).
* Added `fmt::join()` function that takes a range and formats its elements * Added `fmt::join()` function that takes a range and formats its elements
separated by a given string ([\#466]()): separated by a given string (#466):
``` {.c++} ```c++
#include "fmt/format.h" #include "fmt/format.h"
std::vector<double> v = {1.2, 3.4, 5.6}; std::vector<double> v = {1.2, 3.4, 5.6};
...@@ -1649,107 +1650,107 @@ ...@@ -1649,107 +1650,107 @@
Thanks [\@olivier80](https://github.com/olivier80). Thanks [\@olivier80](https://github.com/olivier80).
* Added support for custom formatting specifications to simplify customization * Added support for custom formatting specifications to simplify customization
of built-in formatting ([\#444]()). Thanks [\@polyvertex (Jean-Charles of built-in formatting (#444). Thanks [\@polyvertex (Jean-Charles
Lefebvre)](https://github.com/polyvertex). See also [\#439](). Lefebvre)](https://github.com/polyvertex). See also #439.
* Added `fmt::format_system_error()` for error code formatting ([\#323]() and * Added `fmt::format_system_error()` for error code formatting (#323 and
[\#526]()). Thanks [\@maddinat0r (Alex #526). Thanks [\@maddinat0r (Alex
Martin)](https://github.com/maddinat0r). Martin)](https://github.com/maddinat0r).
* Added thread-safe `fmt::localtime()` and `fmt::gmtime()` as replacement for * Added thread-safe `fmt::localtime()` and `fmt::gmtime()` as replacement for
the standard version to `time.h` ([\#396]()). Thanks the standard version to `time.h` (#396). Thanks
[\@codicodi](https://github.com/codicodi). [\@codicodi](https://github.com/codicodi).
* Internal improvements to `NamedArg` and `ArgLists` ([\#389]() and [\#390]()). * Internal improvements to `NamedArg` and `ArgLists` (#389 and #390).
Thanks [\@chronoxor](https://github.com/chronoxor). Thanks [\@chronoxor](https://github.com/chronoxor).
* Fixed crash due to bug in `FormatBuf` ([\#493]()). Thanks * Fixed crash due to bug in `FormatBuf` (#493). Thanks
[\@effzeh](https://github.com/effzeh). See also [\#480]() and [\#491](). [\@effzeh](https://github.com/effzeh). See also #480 and #491.
* Fixed handling of wide strings in `fmt::StringWriter`. * Fixed handling of wide strings in `fmt::StringWriter`.
* Improved compiler error messages ([\#357]()). * Improved compiler error messages (#357).
* Fixed various warnings and issues with various compilers ([\#494](), * Fixed various warnings and issues with various compilers (#494,
[\#499](), [\#483](), [\#485](), [\#482](), [\#475](), [\#473]() and #499, #483, #485, #482, #475, #473 and
[\#414]()). Thanks [\@chronoxor](https://github.com/chronoxor), #414). Thanks [\@chronoxor](https://github.com/chronoxor),
[\@zhaohuaxishi](https://github.com/zhaohuaxishi), [\@pkestene (Pierre [\@zhaohuaxishi](https://github.com/zhaohuaxishi), [\@pkestene (Pierre
Kestener)](https://github.com/pkestene), [\@dschmidt (Dominik Kestener)](https://github.com/pkestene), [\@dschmidt (Dominik
Schmidt)](https://github.com/dschmidt) and [\@0x414c (Alexey Schmidt)](https://github.com/dschmidt) and [\@0x414c (Alexey
Gorishny)](https://github.com/0x414c) . Gorishny)](https://github.com/0x414c) .
* Improved CMake: targets are now namespaced ([\#511]() and [\#513]()), added * Improved CMake: targets are now namespaced (#511 and #513), added
support for header-only `printf.h` ([\#354]()), fixed issue with minimal support for header-only `printf.h` (#354), fixed issue with minimal
supported library subset ([\#418](), [\#419]() and [\#420]()). Thanks supported library subset (#418, #419 and #420). Thanks
[\@bjoernthiel (Bjoern Thiel)](https://github.com/bjoernthiel), [\@niosHD [\@bjoernthiel (Bjoern Thiel)](https://github.com/bjoernthiel), [\@niosHD
(Mario Werner)](https://github.com/niosHD), [\@LogicalKnight (Sean (Mario Werner)](https://github.com/niosHD), [\@LogicalKnight (Sean
LK)](https://github.com/LogicalKnight) and [\@alabuzhev (Alex LK)](https://github.com/LogicalKnight) and [\@alabuzhev (Alex
Alabuzhev)](https://github.com/alabuzhev). Alabuzhev)](https://github.com/alabuzhev).
* Improved documentation. Thanks to [\@pwm1234 * Improved documentation. Thanks to [\@pwm1234
(Phil)](https://github.com/pwm1234) for [\#393](). (Phil)](https://github.com/pwm1234) for #393.
3.0.2 - 2017-06-14 3.0.2 - 2017-06-14
================== ==================
* Added `FMT_VERSION` macro ([\#411]()). * Added `FMT_VERSION` macro (#411).
* Used `FMT_NULL` instead of literal `0` ([\#409]()). Thanks [\@alabuzhev (Alex * Used `FMT_NULL` instead of literal `0` (#409). Thanks [\@alabuzhev (Alex
Alabuzhev)](https://github.com/alabuzhev). Alabuzhev)](https://github.com/alabuzhev).
* Added extern templates for `format_float` ([\#413]()). * Added extern templates for `format_float` (#413).
* Fixed implicit conversion issue ([\#507]()). * Fixed implicit conversion issue (#507).
* Fixed signbit detection ([\#423]()). * Fixed signbit detection (#423).
* Fixed naming collision ([\#425]()). * Fixed naming collision (#425).
* Fixed missing intrinsic for C++/CLI ([\#457]()). Thanks [\@calumr (Calum * Fixed missing intrinsic for C++/CLI (#457). Thanks [\@calumr (Calum
Robinson)](https://github.com/calumr) Robinson)](https://github.com/calumr)
* Fixed Android detection ([\#458]()). Thanks [\@Gachapen (Magnus Bjerke * Fixed Android detection (#458). Thanks [\@Gachapen (Magnus Bjerke
Vik)](https://github.com/Gachapen). Vik)](https://github.com/Gachapen).
* Use lean `windows.h` if not in header-only mode ([\#503]()). Thanks * Use lean `windows.h` if not in header-only mode (#503). Thanks
[\@Quentin01 (Quentin Buathier)](https://github.com/Quentin01). [\@Quentin01 (Quentin Buathier)](https://github.com/Quentin01).
* Fixed issue with CMake exporting C++11 flag ([\#445]()). Thanks [\@EricWF * Fixed issue with CMake exporting C++11 flag (#445). Thanks [\@EricWF
(Eric)](https://github.com/EricWF). (Eric)](https://github.com/EricWF).
* Fixed issue with nvcc and MSVC compiler bug and MinGW ([\#505]()). * Fixed issue with nvcc and MSVC compiler bug and MinGW (#505).
* Fixed DLL issues ([\#469]() and [\#502]()). Thanks [\@richardeakin (Richard * Fixed DLL issues (#469 and #502). Thanks [\@richardeakin (Richard
Eakin)](https://github.com/richardeakin) and [\@AndreasSchoenle (Andreas Eakin)](https://github.com/richardeakin) and [\@AndreasSchoenle (Andreas
Schönle)](https://github.com/AndreasSchoenle). Schönle)](https://github.com/AndreasSchoenle).
* Fixed test compilation under FreeBSD ([\#433]()). * Fixed test compilation under FreeBSD (#433).
* Fixed various warnings ([\#403](), [\#410]() and [\#510]()). Thanks * Fixed various warnings (#403, #410 and #510). Thanks
[\@Lecetem](https://github.com/Lectem), [\@chenhayat (Chen [\@Lecetem](https://github.com/Lectem), [\@chenhayat (Chen
Hayat)](https://github.com/chenhayat) and Hayat)](https://github.com/chenhayat) and
[\@trozen](https://github.com/trozen). [\@trozen](https://github.com/trozen).
* Worked around a broken `__builtin_clz` in clang with MS codegen ([\#519]()). * Worked around a broken `__builtin_clz` in clang with MS codegen (#519).
* Removed redundant include ([\#479]()). * Removed redundant include (#479).
* Fixed documentation issues. * Fixed documentation issues.
3.0.1 - 2016-11-01 3.0.1 - 2016-11-01
================== ==================
* Fixed handling of thousands separator ([\#353]()). * Fixed handling of thousands separator (#353).
* Fixed handling of `unsigned char` strings ([\#373]()). * Fixed handling of `unsigned char` strings (#373).
* Corrected buffer growth when formatting time ([\#367]()). * Corrected buffer growth when formatting time (#367).
* Removed warnings under MSVC and clang ([\#318](), [\#250](), also merged * Removed warnings under MSVC and clang (#318, #250, also merged
[\#385]() and [\#361]()). Thanks [\@jcelerier (Jean-Michaël #385 and #361). Thanks [\@jcelerier (Jean-Michaël
Celerier)](https://github.com/jcelerier) and [\@nmoehrle (Nils Celerier)](https://github.com/jcelerier) and [\@nmoehrle (Nils
Moehrle)](https://github.com/nmoehrle). Moehrle)](https://github.com/nmoehrle).
* Fixed compilation issues under Android ([\#327](), [\#345]() and [\#381]()), * Fixed compilation issues under Android (#327, #345 and #381),
FreeBSD ([\#358]()), Cygwin ([\#388]()), MinGW ([\#355]()) as well as other FreeBSD (#358), Cygwin (#388), MinGW (#355) as well as other
issues ([\#350](), [\#366](), [\#348](), [\#402](), [\#405]()). Thanks to issues (#350, #366, #348, #402, #405). Thanks to
[\@dpantele (Dmitry)](https://github.com/dpantele), [\@hghwng (Hugh [\@dpantele (Dmitry)](https://github.com/dpantele), [\@hghwng (Hugh
Wang)](https://github.com/hghwng), [\@arvedarved (Tilman Wang)](https://github.com/hghwng), [\@arvedarved (Tilman
Keskinöz)](https://github.com/arvedarved), [\@LogicalKnight Keskinöz)](https://github.com/arvedarved), [\@LogicalKnight
(Sean)](https://github.com/LogicalKnight) and [\@JanHellwig (Jan (Sean)](https://github.com/LogicalKnight) and [\@JanHellwig (Jan
Hellwig)](https://github.com/janhellwig). Hellwig)](https://github.com/janhellwig).
* Fixed some documentation issues and extended specification ([\#320](), * Fixed some documentation issues and extended specification (#320,
[\#333](), [\#347](), [\#362]()). Thanks to [\@smellman (Taro Matsuzawa aka. #333, #347, #362). Thanks to [\@smellman (Taro Matsuzawa aka.
btm)](https://github.com/smellman). btm)](https://github.com/smellman).
3.0.0 - 2016-05-07 3.0.0 - 2016-05-07
================== ==================
* The project has been renamed from C++ Format (cppformat) to fmt for * The project has been renamed from C++ Format (cppformat) to fmt for
consistency with the used namespace and macro prefix ([\#307]()). Library consistency with the used namespace and macro prefix (#307). Library
headers are now located in the `fmt` directory: headers are now located in the `fmt` directory:
``` {.c++} ```c++
#include "fmt/format.h" #include "fmt/format.h"
``` ```
...@@ -1761,9 +1762,9 @@ ...@@ -1761,9 +1762,9 @@
* Added support for * Added support for
[strftime](http://en.cppreference.com/w/cpp/chrono/c/strftime)-like [date and [strftime](http://en.cppreference.com/w/cpp/chrono/c/strftime)-like [date and
time formatting](https://fmt.dev/3.0.0/api.html#date-and-time-formatting) time formatting](https://fmt.dev/3.0.0/api.html#date-and-time-formatting)
([\#283]()): (#283):
``` {.c++} ```c++
#include "fmt/time.h" #include "fmt/time.h"
std::time_t t = std::time(nullptr); std::time_t t = std::time(nullptr);
...@@ -1774,7 +1775,7 @@ ...@@ -1774,7 +1775,7 @@
* `std::ostream` support including formatting of user-defined types that provide * `std::ostream` support including formatting of user-defined types that provide
overloaded `operator<<` has been moved to `fmt/ostream.h`: overloaded `operator<<` has been moved to `fmt/ostream.h`:
``` {.c++} ```c++
#include "fmt/ostream.h" #include "fmt/ostream.h"
class Date { class Date {
...@@ -1793,42 +1794,42 @@ ...@@ -1793,42 +1794,42 @@
``` ```
* Added support for [custom argument * Added support for [custom argument
formatters](https://fmt.dev/3.0.0/api.html#argument-formatters) ([\#235]()). formatters](https://fmt.dev/3.0.0/api.html#argument-formatters) (#235).
* Added support for locale-specific integer formatting with the `n` specifier * Added support for locale-specific integer formatting with the `n` specifier
([\#305]()): (#305):
``` {.c++} ```c++
std::setlocale(LC_ALL, "en_US.utf8"); std::setlocale(LC_ALL, "en_US.utf8");
fmt::print("cppformat: {:n}\n", 1234567); // prints 1,234,567 fmt::print("cppformat: {:n}\n", 1234567); // prints 1,234,567
``` ```
* Sign is now preserved when formatting an integer with an incorrect `printf` * Sign is now preserved when formatting an integer with an incorrect `printf`
format specifier ([\#265]()): format specifier (#265):
``` {.c++} ```c++
fmt::printf("%lld", -42); // prints -42 fmt::printf("%lld", -42); // prints -42
``` ```
Note that it would be an undefined behavior in `std::printf`. Note that it would be an undefined behavior in `std::printf`.
* Length modifiers such as `ll` are now optional in printf formatting functions * Length modifiers such as `ll` are now optional in printf formatting functions
and the correct type is determined automatically ([\#255]()): and the correct type is determined automatically (#255):
``` {.c++} ```c++
fmt::printf("%d", std::numeric_limits<long long>::max()); fmt::printf("%d", std::numeric_limits<long long>::max());
``` ```
Note that it would be an undefined behavior in `std::printf`. Note that it would be an undefined behavior in `std::printf`.
* Added initial support for custom formatters ([\#231]()). * Added initial support for custom formatters (#231).
* Fixed detection of user-defined literal support on Intel C++ compiler * Fixed detection of user-defined literal support on Intel C++ compiler
([\#311](), [\#312]()). Thanks to [\@dean0x7d (Dean (#311, #312). Thanks to [\@dean0x7d (Dean
Moldovan)](https://github.com/dean0x7d) and [\@speth (Ray Moldovan)](https://github.com/dean0x7d) and [\@speth (Ray
Speth)](https://github.com/speth). Speth)](https://github.com/speth).
* Reduced compile time ([\#243](), [\#249](), [\#317]()): * Reduced compile time (#243, #249, #317):
![image](https://cloud.githubusercontent.com/assets/4831417/11614060/%0Ab9e826d2-9c36-11e5-8666-d4131bf503ef.png) ![image](https://cloud.githubusercontent.com/assets/4831417/11614060/%0Ab9e826d2-9c36-11e5-8666-d4131bf503ef.png)
...@@ -1836,46 +1837,46 @@ ...@@ -1836,46 +1837,46 @@
Thanks to [\@dean0x7d (Dean Moldovan)](https://github.com/dean0x7d). Thanks to [\@dean0x7d (Dean Moldovan)](https://github.com/dean0x7d).
* Compile test fixes ([\#313]()). Thanks to [\@dean0x7d (Dean * Compile test fixes (#313). Thanks to [\@dean0x7d (Dean
Moldovan)](https://github.com/dean0x7d). Moldovan)](https://github.com/dean0x7d).
* Documentation fixes ([\#239](), [\#248](), [\#252](), [\#258](), [\#260](), * Documentation fixes (#239, #248, #252, #258, #260,
[\#301](), [\#309]()). Thanks to #301, #309). Thanks to
[\@ReadmeCritic](https://github.com/ReadmeCritic) [\@Gachapen (Magnus Bjerke [\@ReadmeCritic](https://github.com/ReadmeCritic) [\@Gachapen (Magnus Bjerke
Vik)](https://github.com/Gachapen) and [\@jwilk (Jakub Vik)](https://github.com/Gachapen) and [\@jwilk (Jakub
Wilk)](https://github.com/jwilk). Wilk)](https://github.com/jwilk).
* Fixed compiler and sanitizer warnings ([\#244](), [\#256](), [\#259](), * Fixed compiler and sanitizer warnings (#244, #256, #259,
[\#263](), [\#274](), [\#277](), [\#286](), [\#291](), [\#296](), [\#308]()) #263, #274, #277, #286, #291, #296, #308)
Thanks to [\@mwinterb](https://github.com/mwinterb), [\@pweiskircher (Patrik Thanks to [\@mwinterb](https://github.com/mwinterb), [\@pweiskircher (Patrik
Weiskircher)](https://github.com/pweiskircher), Weiskircher)](https://github.com/pweiskircher),
[\@Naios](https://github.com/Naios). [\@Naios](https://github.com/Naios).
* Improved compatibility with Windows Store apps ([\#280](), [\#285]()). Thanks * Improved compatibility with Windows Store apps (#280, #285). Thanks
to [\@mwinterb](https://github.com/mwinterb). to [\@mwinterb](https://github.com/mwinterb).
* Added tests of compatibility with older C++ standards ([\#273]()). Thanks to * Added tests of compatibility with older C++ standards (#273). Thanks to
[\@niosHD](https://github.com/niosHD). [\@niosHD](https://github.com/niosHD).
* Fixed Android build ([\#271]()). Thanks to * Fixed Android build (#271). Thanks to
[\@newnon](https://github.com/newnon). [\@newnon](https://github.com/newnon).
* Changed `ArgMap` to be backed by a vector instead of a map. ([\#261](), * Changed `ArgMap` to be backed by a vector instead of a map. (#261,
[\#262]()). Thanks to [\@mwinterb](https://github.com/mwinterb). #262). Thanks to [\@mwinterb](https://github.com/mwinterb).
* Added `fprintf` overload that writes to a `std::ostream` ([\#251]()). Thanks * Added `fprintf` overload that writes to a `std::ostream` (#251). Thanks
to [nickhutchinson (Nicholas Hutchinson)](https://github.com/nickhutchinson). to [nickhutchinson (Nicholas Hutchinson)](https://github.com/nickhutchinson).
* Export symbols when building a Windows DLL ([\#245]()). Thanks to [macdems * Export symbols when building a Windows DLL (#245). Thanks to [macdems
(Maciek Dems)](https://github.com/macdems). (Maciek Dems)](https://github.com/macdems).
* Fixed compilation on Cygwin ([\#304]()). * Fixed compilation on Cygwin (#304).
* Implemented a workaround for a bug in Apple LLVM version 4.2 of clang * Implemented a workaround for a bug in Apple LLVM version 4.2 of clang
([\#276]()). (#276).
* Implemented a workaround for Google Test bug * Implemented a workaround for Google Test bug
[\#705](https://github.com/google/googletest/issues/705) on gcc 6 ([\#268]()). [\#705](https://github.com/google/googletest/issues/705) on gcc 6 (#268).
Thanks to [octoploid](https://github.com/octoploid). Thanks to [octoploid](https://github.com/octoploid).
* Removed Biicode support because the latter has been discontinued. * Removed Biicode support because the latter has been discontinued.
...@@ -1884,14 +1885,14 @@ ...@@ -1884,14 +1885,14 @@
================== ==================
* The install location for generated CMake files is now configurable via the * The install location for generated CMake files is now configurable via the
`FMT_CMAKE_DIR` CMake variable ([\#299]()). Thanks to `FMT_CMAKE_DIR` CMake variable (#299). Thanks to
[\@niosHD](https://github.com/niosHD). [\@niosHD](https://github.com/niosHD).
* Documentation fixes ([\#252]()). * Documentation fixes (#252).
2.1.0 - 2016-03-21 2.1.0 - 2016-03-21
================== ==================
* Project layout and build system improvements ([\#267]()): * Project layout and build system improvements (#267):
* The code have been moved to the `cppformat` directory. Including * The code have been moved to the `cppformat` directory. Including
`format.h` from the top-level directory is deprecated but works via a `format.h` from the top-level directory is deprecated but works via a
...@@ -1908,11 +1909,11 @@ ...@@ -1908,11 +1909,11 @@
2.0.1 - 2016-03-13 2.0.1 - 2016-03-13
================== ==================
* Improved CMake find and package support ([\#264]()). Thanks to * Improved CMake find and package support (#264). Thanks to
[\@niosHD](https://github.com/niosHD). [\@niosHD](https://github.com/niosHD).
* Fix compile error with Android NDK and mingw32 ([\#241]()). Thanks to * Fix compile error with Android NDK and mingw32 (#241). Thanks to
[\@Gachapen (Magnus Bjerke Vik)](https://github.com/Gachapen). [\@Gachapen (Magnus Bjerke Vik)](https://github.com/Gachapen).
* Documentation fixes ([\#248](), [\#260]()). * Documentation fixes (#248, #260).
2.0.0 - 2015-12-01 2.0.0 - 2015-12-01
================== ==================
...@@ -1920,18 +1921,18 @@ ...@@ -1920,18 +1921,18 @@
General General
------- -------
* \[Breaking\] Named arguments ([\#169](), [\#173](), [\#174]()): * \[Breaking\] Named arguments (#169, #173, #174):
``` {.c++} ```c++
fmt::print("The answer is {answer}.", fmt::arg("answer", 42)); fmt::print("The answer is {answer}.", fmt::arg("answer", 42));
``` ```
Thanks to [\@jamboree](https://github.com/jamboree). Thanks to [\@jamboree](https://github.com/jamboree).
* \[Experimental\] User-defined literals for format and named arguments * \[Experimental\] User-defined literals for format and named arguments
([\#204](), [\#206](), [\#207]()): (#204, #206, #207):
``` {.c++} ```c++
using namespace fmt::literals; using namespace fmt::literals;
fmt::print("The answer is {answer}.", "answer"_a=42); fmt::print("The answer is {answer}.", "answer"_a=42);
``` ```
...@@ -1939,73 +1940,73 @@ General ...@@ -1939,73 +1940,73 @@ General
Thanks to [\@dean0x7d (Dean Moldovan)](https://github.com/dean0x7d). Thanks to [\@dean0x7d (Dean Moldovan)](https://github.com/dean0x7d).
* \[Breaking\] Formatting of more than 16 arguments is now supported when using * \[Breaking\] Formatting of more than 16 arguments is now supported when using
variadic templates ([\#141]()). Thanks to variadic templates (#141). Thanks to
[\@Shauren](https://github.com/Shauren). [\@Shauren](https://github.com/Shauren).
* Runtime width specification ([\#168]()): * Runtime width specification (#168):
``` {.c++} ```c++
fmt::format("{0:{1}}", 42, 5); // gives " 42" fmt::format("{0:{1}}", 42, 5); // gives " 42"
``` ```
Thanks to [\@jamboree](https://github.com/jamboree). Thanks to [\@jamboree](https://github.com/jamboree).
* \[Breaking\] Enums are now formatted with an overloaded `std::ostream` * \[Breaking\] Enums are now formatted with an overloaded `std::ostream`
insertion operator (`operator<<`) if available ([\#232]()). insertion operator (`operator<<`) if available (#232).
* \[Breaking\] Changed default `bool` format to textual, \"true\" or \"false\" * \[Breaking\] Changed default `bool` format to textual, \"true\" or \"false\"
([\#170]()): (#170):
``` {.c++} ```c++
fmt::print("{}", true); // prints "true" fmt::print("{}", true); // prints "true"
``` ```
To print `bool` as a number use numeric format specifier such as `d`: To print `bool` as a number use numeric format specifier such as `d`:
``` {.c++} ```c++
fmt::print("{:d}", true); // prints "1" fmt::print("{:d}", true); // prints "1"
``` ```
* `fmt::printf` and `fmt::sprintf` now support formatting of `bool` with the * `fmt::printf` and `fmt::sprintf` now support formatting of `bool` with the
`%s` specifier giving textual output, \"true\" or \"false\" ([\#223]()): `%s` specifier giving textual output, \"true\" or \"false\" (#223):
``` {.c++} ```c++
fmt::printf("%s", true); // prints "true" fmt::printf("%s", true); // prints "true"
``` ```
Thanks to [\@LarsGullik](https://github.com/LarsGullik). Thanks to [\@LarsGullik](https://github.com/LarsGullik).
* \[Breaking\] `signed char` and `unsigned char` are now formatted as integers * \[Breaking\] `signed char` and `unsigned char` are now formatted as integers
by default ([\#217]()). by default (#217).
* \[Breaking\] Pointers to C strings can now be formatted with the `p` specifier * \[Breaking\] Pointers to C strings can now be formatted with the `p` specifier
([\#223]()): (#223):
``` {.c++} ```c++
fmt::print("{:p}", "test"); // prints pointer value fmt::print("{:p}", "test"); // prints pointer value
``` ```
Thanks to [\@LarsGullik](https://github.com/LarsGullik). Thanks to [\@LarsGullik](https://github.com/LarsGullik).
* \[Breaking\] `fmt::printf` and `fmt::sprintf` now print null pointers as * \[Breaking\] `fmt::printf` and `fmt::sprintf` now print null pointers as
`(nil)` and null strings as `(null)` for consistency with glibc ([\#226]()). `(nil)` and null strings as `(null)` for consistency with glibc (#226).
Thanks to [\@LarsGullik](https://github.com/LarsGullik). Thanks to [\@LarsGullik](https://github.com/LarsGullik).
* \[Breaking\] `fmt::(s)printf` now supports formatting of objects of * \[Breaking\] `fmt::(s)printf` now supports formatting of objects of
user-defined types that provide an overloaded `std::ostream` insertion user-defined types that provide an overloaded `std::ostream` insertion
operator (`operator<<`) ([\#201]()): operator (`operator<<`) (#201):
``` {.c++} ```c++
fmt::printf("The date is %s", Date(2012, 12, 9)); fmt::printf("The date is %s", Date(2012, 12, 9));
``` ```
* \[Breaking\] The `Buffer` template is now part of the public API and can be * \[Breaking\] The `Buffer` template is now part of the public API and can be
used to implement custom memory buffers ([\#140]()). Thanks to [\@polyvertex used to implement custom memory buffers (#140). Thanks to [\@polyvertex
(Jean-Charles Lefebvre)](https://github.com/polyvertex). (Jean-Charles Lefebvre)](https://github.com/polyvertex).
* \[Breaking\] Improved compatibility between `BasicStringRef` and * \[Breaking\] Improved compatibility between `BasicStringRef` and
[std::experimental::basic\_string\_view](http://en.cppreference.com/w/cpp/experimental/basic_string_view) [std::experimental::basic\_string\_view](http://en.cppreference.com/w/cpp/experimental/basic_string_view)
([\#100](), [\#159](), [\#183]()): (#100, #159, #183):
* Comparison operators now compare string content, not pointers * Comparison operators now compare string content, not pointers
* `BasicStringRef::c_str` replaced by `BasicStringRef::data` * `BasicStringRef::c_str` replaced by `BasicStringRef::data`
...@@ -2014,31 +2015,31 @@ General ...@@ -2014,31 +2015,31 @@ General
References to null-terminated strings are now represented by a new class, References to null-terminated strings are now represented by a new class,
`BasicCStringRef`. `BasicCStringRef`.
* Dependency on pthreads introduced by Google Test is now optional ([\#185]()). * Dependency on pthreads introduced by Google Test is now optional (#185).
* New CMake options `FMT_DOC`, `FMT_INSTALL` and `FMT_TEST` to control * New CMake options `FMT_DOC`, `FMT_INSTALL` and `FMT_TEST` to control
generation of `doc`, `install` and `test` targets respectively, on by default generation of `doc`, `install` and `test` targets respectively, on by default
([\#197](), [\#198](), [\#200]()). Thanks to [\@maddinat0r (Alex (#197, #198, #200). Thanks to [\@maddinat0r (Alex
Martin)](https://github.com/maddinat0r). Martin)](https://github.com/maddinat0r).
* `noexcept` is now used when compiling with MSVC2015 ([\#215]()). Thanks to * `noexcept` is now used when compiling with MSVC2015 (#215). Thanks to
[\@dmkrepo (Dmitriy)](https://github.com/dmkrepo). [\@dmkrepo (Dmitriy)](https://github.com/dmkrepo).
* Added an option to disable use of `windows.h` when `FMT_USE_WINDOWS_H` is * Added an option to disable use of `windows.h` when `FMT_USE_WINDOWS_H` is
defined as 0 before including `format.h` ([\#171]()). Thanks to [\@alfps defined as 0 before including `format.h` (#171). Thanks to [\@alfps
(Alf P. Steinbach)](https://github.com/alfps). (Alf P. Steinbach)](https://github.com/alfps).
* \[Breaking\] `windows.h` is now included with `NOMINMAX` unless * \[Breaking\] `windows.h` is now included with `NOMINMAX` unless
`FMT_WIN_MINMAX` is defined. This is done to prevent breaking code using `FMT_WIN_MINMAX` is defined. This is done to prevent breaking code using
`std::min` and `std::max` and only affects the header-only configuration `std::min` and `std::max` and only affects the header-only configuration
([\#152](), [\#153](), [\#154]()). Thanks to (#152, #153, #154). Thanks to
[\@DevO2012](https://github.com/DevO2012). [\@DevO2012](https://github.com/DevO2012).
* Improved support for custom character types ([\#171]()). Thanks to [\@alfps * Improved support for custom character types (#171). Thanks to [\@alfps
(Alf P. Steinbach)](https://github.com/alfps). (Alf P. Steinbach)](https://github.com/alfps).
* Added an option to disable use of IOStreams when `FMT_USE_IOSTREAMS` is * Added an option to disable use of IOStreams when `FMT_USE_IOSTREAMS` is
defined as 0 before including `format.h` ([\#205](), [\#208]()). Thanks to defined as 0 before including `format.h` (#205, #208). Thanks to
[\@JodiTheTigger](https://github.com/JodiTheTigger). [\@JodiTheTigger](https://github.com/JodiTheTigger).
* Improved detection of `isnan`, `isinf` and `signbit`. * Improved detection of `isnan`, `isinf` and `signbit`.
...@@ -2047,32 +2048,32 @@ Optimization ...@@ -2047,32 +2048,32 @@ Optimization
------------ ------------
* Made formatting of user-defined types more efficient with a custom stream * Made formatting of user-defined types more efficient with a custom stream
buffer ([\#92](), [\#230]()). Thanks to buffer (#92, #230). Thanks to
[\@NotImplemented](https://github.com/NotImplemented). [\@NotImplemented](https://github.com/NotImplemented).
* Further improved performance of `fmt::Writer` on integer formatting and fixed * Further improved performance of `fmt::Writer` on integer formatting and fixed
a minor regression. Now it is \~7% faster than `karma::generate` on Karma\'s a minor regression. Now it is \~7% faster than `karma::generate` on Karma\'s
benchmark ([\#186]()). benchmark (#186).
* \[Breaking\] Reduced [compiled code * \[Breaking\] Reduced [compiled code
size](https://github.com/fmtlib/fmt#compile-time-and-code-bloat) ([\#143](), size](https://github.com/fmtlib/fmt#compile-time-and-code-bloat) (#143,
[\#149]()). #149).
Distribution Distribution
------------ ------------
* \[Breaking\] Headers are now installed in * \[Breaking\] Headers are now installed in
`${CMAKE_INSTALL_PREFIX}/include/cppformat` ([\#178]()). Thanks to [\@jackyf `${CMAKE_INSTALL_PREFIX}/include/cppformat` (#178). Thanks to [\@jackyf
(Eugene V. Lyubimkin)](https://github.com/jackyf). (Eugene V. Lyubimkin)](https://github.com/jackyf).
* \[Breaking\] Changed the library name from `format` to `cppformat` for * \[Breaking\] Changed the library name from `format` to `cppformat` for
consistency with the project name and to avoid potential conflicts consistency with the project name and to avoid potential conflicts
([\#178]()). Thanks to [\@jackyf (Eugene V. (#178). Thanks to [\@jackyf (Eugene V.
Lyubimkin)](https://github.com/jackyf). Lyubimkin)](https://github.com/jackyf).
* C++ Format is now available in [Debian](https://www.debian.org/) GNU/Linux * C++ Format is now available in [Debian](https://www.debian.org/) GNU/Linux
([stretch](https://packages.debian.org/source/stretch/cppformat), ([stretch](https://packages.debian.org/source/stretch/cppformat),
[sid](https://packages.debian.org/source/sid/cppformat)) and derived [sid](https://packages.debian.org/source/sid/cppformat)) and derived
distributions such as [Ubuntu](https://launchpad.net/ubuntu/+source/cppformat) distributions such as [Ubuntu](https://launchpad.net/ubuntu/+source/cppformat)
15.10 and later ([\#155]()): 15.10 and later (#155):
$ sudo apt-get install libcppformat1-dev $ sudo apt-get install libcppformat1-dev
...@@ -2083,7 +2084,7 @@ Distribution ...@@ -2083,7 +2084,7 @@ Distribution
available. Thanks to Dave Johansen. available. Thanks to Dave Johansen.
* C++ Format can now be installed via [Homebrew](http://brew.sh/) on OS X * C++ Format can now be installed via [Homebrew](http://brew.sh/) on OS X
([\#157]()): (#157):
$ brew install cppformat $ brew install cppformat
...@@ -2093,58 +2094,58 @@ Documentation ...@@ -2093,58 +2094,58 @@ Documentation
------------- -------------
* Migrated from ReadTheDocs to GitHub Pages for better responsiveness and * Migrated from ReadTheDocs to GitHub Pages for better responsiveness and
reliability ([\#128]()). New documentation address is reliability (#128). New documentation address is
<http://cppformat.github.io/>. <http://cppformat.github.io/>.
* Added [Building the * Added [Building the
documentation](https://fmt.dev/2.0.0/usage.html#building-the-documentation) documentation](https://fmt.dev/2.0.0/usage.html#building-the-documentation)
section to the documentation. section to the documentation.
* Documentation build script is now compatible with Python 3 and newer pip * Documentation build script is now compatible with Python 3 and newer pip
versions ([\#189](), [\#209]()). Thanks to versions (#189, #209). Thanks to
[\@JodiTheTigger](https://github.com/JodiTheTigger) and [\@JodiTheTigger](https://github.com/JodiTheTigger) and
[\@xentec](https://github.com/xentec). [\@xentec](https://github.com/xentec).
* Documentation fixes and improvements ([\#36](), [\#75](), [\#125](), * Documentation fixes and improvements (#36, #75, #125,
[\#160](), [\#161](), [\#162](), [\#165](), [\#210]()). Thanks to [\@syohex #160, #161, #162, #165, #210). Thanks to [\@syohex
(Syohei YOSHIDA)](https://github.com/syohex) and bug reporters. (Syohei YOSHIDA)](https://github.com/syohex) and bug reporters.
* Fixed out-of-tree documentation build ([\#177]()). Thanks to [\@jackyf * Fixed out-of-tree documentation build (#177). Thanks to [\@jackyf
(Eugene V. Lyubimkin)](https://github.com/jackyf). (Eugene V. Lyubimkin)](https://github.com/jackyf).
Fixes Fixes
----- -----
* Fixed `initializer_list` detection ([\#136]()). Thanks to [\@Gachapen (Magnus * Fixed `initializer_list` detection (#136). Thanks to [\@Gachapen (Magnus
Bjerke Vik)](https://github.com/Gachapen). Bjerke Vik)](https://github.com/Gachapen).
* \[Breaking\] Fixed formatting of enums with numeric format specifiers in * \[Breaking\] Fixed formatting of enums with numeric format specifiers in
`fmt::(s)printf` ([\#131](), [\#139]()): `fmt::(s)printf` (#131, #139):
``` {.c++} ```c++
enum { ANSWER = 42 }; enum { ANSWER = 42 };
fmt::printf("%d", ANSWER); fmt::printf("%d", ANSWER);
``` ```
Thanks to [\@Naios](https://github.com/Naios). Thanks to [\@Naios](https://github.com/Naios).
* Improved compatibility with old versions of MinGW ([\#129](), [\#130](), * Improved compatibility with old versions of MinGW (#129, #130,
[\#132]()). Thanks to [\@cstamford (Christopher #132). Thanks to [\@cstamford (Christopher
Stamford)](https://github.com/cstamford). Stamford)](https://github.com/cstamford).
* Fixed a compile error on MSVC with disabled exceptions ([\#144]()). * Fixed a compile error on MSVC with disabled exceptions (#144).
* Added a workaround for broken implementation of variadic templates in MSVC2012 * Added a workaround for broken implementation of variadic templates in MSVC2012
([\#148]()). (#148).
* Placed the anonymous namespace within `fmt` namespace for the header-only * Placed the anonymous namespace within `fmt` namespace for the header-only
configuration ([\#171]()). Thanks to [\@alfps (Alf P. configuration (#171). Thanks to [\@alfps (Alf P.
Steinbach)](https://github.com/alfps). Steinbach)](https://github.com/alfps).
* Fixed issues reported by Coverity Scan ([\#187](), [\#192]()). * Fixed issues reported by Coverity Scan (#187, #192).
* Implemented a workaround for a name lookup bug in MSVC2010 ([\#188]()). * Implemented a workaround for a name lookup bug in MSVC2010 (#188).
* Fixed compiler warnings ([\#95](), [\#96](), [\#114](), [\#135](), [\#142](), * Fixed compiler warnings (#95, #96, #114, #135, #142,
[\#145](), [\#146](), [\#158](), [\#163](), [\#175](), [\#190](), [\#191](), #145, #146, #158, #163, #175, #190, #191,
[\#194](), [\#196](), [\#216](), [\#218](), [\#220](), [\#229](), [\#233](), #194, #196, #216, #218, #220, #229, #233,
[\#234](), [\#236](), [\#281](), [\#289]()). Thanks to [\@seanmiddleditch #234, #236, #281, #289). Thanks to [\@seanmiddleditch
(Sean Middleditch)](https://github.com/seanmiddleditch), [\@dixlorenz (Dix (Sean Middleditch)](https://github.com/seanmiddleditch), [\@dixlorenz (Dix
Lorenz)](https://github.com/dixlorenz), [\@CarterLi Lorenz)](https://github.com/dixlorenz), [\@CarterLi
(李通洲)](https://github.com/CarterLi), [\@Naios](https://github.com/Naios), (李通洲)](https://github.com/CarterLi), [\@Naios](https://github.com/Naios),
...@@ -2159,37 +2160,37 @@ Fixes ...@@ -2159,37 +2160,37 @@ Fixes
(Johan)](https://github.com/Jopie64). (Johan)](https://github.com/Jopie64).
* Fixed portability issues (mostly causing test failures) on ARM, ppc64, * Fixed portability issues (mostly causing test failures) on ARM, ppc64,
ppc64le, s390x and SunOS 5.11 i386 ([\#138](), [\#179](), [\#180](), ppc64le, s390x and SunOS 5.11 i386 (#138, #179, #180,
[\#202](), [\#225](), [Red Hat Bugzilla Bug #202, #225, [Red Hat Bugzilla Bug
1260297](https://bugzilla.redhat.com/show_bug.cgi?id=1260297)). Thanks to 1260297](https://bugzilla.redhat.com/show_bug.cgi?id=1260297)). Thanks to
[\@Naios](https://github.com/Naios), [\@jackyf (Eugene V. [\@Naios](https://github.com/Naios), [\@jackyf (Eugene V.
Lyubimkin)](https://github.com/jackyf) and Dave Johansen. Lyubimkin)](https://github.com/jackyf) and Dave Johansen.
* Fixed a name conflict with macro `free` defined in `crtdbg.h` when * Fixed a name conflict with macro `free` defined in `crtdbg.h` when
`_CRTDBG_MAP_ALLOC` is set ([\#211]()). `_CRTDBG_MAP_ALLOC` is set (#211).
* Fixed shared library build on OS X ([\#212]()). Thanks to [\@dean0x7d (Dean * Fixed shared library build on OS X (#212). Thanks to [\@dean0x7d (Dean
Moldovan)](https://github.com/dean0x7d). Moldovan)](https://github.com/dean0x7d).
* Fixed an overload conflict on MSVC when `/Zc:wchar_t-` option is specified * Fixed an overload conflict on MSVC when `/Zc:wchar_t-` option is specified
([\#214]()). Thanks to [\@slavanap (Vyacheslav (#214). Thanks to [\@slavanap (Vyacheslav
Napadovsky)](https://github.com/slavanap). Napadovsky)](https://github.com/slavanap).
* Improved compatibility with MSVC 2008 ([\#236]()). Thanks to [\@Jopie64 * Improved compatibility with MSVC 2008 (#236). Thanks to [\@Jopie64
(Johan)](https://github.com/Jopie64). (Johan)](https://github.com/Jopie64).
* Improved compatibility with bcc32 ([\#227]()). * Improved compatibility with bcc32 (#227).
* Fixed `static_assert` detection on Clang ([\#228]()). Thanks to [\@dean0x7d * Fixed `static_assert` detection on Clang (#228). Thanks to [\@dean0x7d
(Dean Moldovan)](https://github.com/dean0x7d). (Dean Moldovan)](https://github.com/dean0x7d).
1.1.0 - 2015-03-06 1.1.0 - 2015-03-06
================== ==================
* Added `BasicArrayWriter`, a class template that provides operations for * Added `BasicArrayWriter`, a class template that provides operations for
formatting and writing data into a fixed-size array ([\#105]() and [\#122]()): formatting and writing data into a fixed-size array (#105 and #122):
``` {.c++} ```c++
char buffer[100]; char buffer[100];
fmt::ArrayWriter w(buffer); fmt::ArrayWriter w(buffer);
w.write("The answer is {}", 42); w.write("The answer is {}", 42);
...@@ -2200,22 +2201,22 @@ Fixes ...@@ -2200,22 +2201,22 @@ Fixes
Format. Format.
* C++ Format now uses MSVC intrinsics for better formatting performance * C++ Format now uses MSVC intrinsics for better formatting performance
([\#115](), [\#116](), [\#118]() and [\#121]()). Previously these (#115, #116, #118 and #121). Previously these
optimizations where only used on GCC and Clang. Thanks to optimizations where only used on GCC and Clang. Thanks to
[\@CarterLi](https://github.com/CarterLi) and [\@CarterLi](https://github.com/CarterLi) and
[\@objectx](https://github.com/objectx). [\@objectx](https://github.com/objectx).
* CMake install target ([\#119]()). Thanks to * CMake install target (#119). Thanks to
[\@TrentHouliston](https://github.com/TrentHouliston). [\@TrentHouliston](https://github.com/TrentHouliston).
You can now install C++ Format with `make install` command. You can now install C++ Format with `make install` command.
* Improved [Biicode](http://www.biicode.com/) support ([\#98]() and [\#104]()). * Improved [Biicode](http://www.biicode.com/) support (#98 and #104).
Thanks to [\@MariadeAnton](https://github.com/MariadeAnton) and Thanks to [\@MariadeAnton](https://github.com/MariadeAnton) and
[\@franramirez688](https://github.com/franramirez688). [\@franramirez688](https://github.com/franramirez688).
* Improved support for building with [Android * Improved support for building with [Android
NDK](https://developer.android.com/tools/sdk/ndk/index.html) ([\#107]()). NDK](https://developer.android.com/tools/sdk/ndk/index.html) (#107).
Thanks to [\@newnon](https://github.com/newnon). Thanks to [\@newnon](https://github.com/newnon).
The [android-ndk-example](https://github.com/fmtlib/android-ndk-example) The [android-ndk-example](https://github.com/fmtlib/android-ndk-example)
...@@ -2223,23 +2224,23 @@ Fixes ...@@ -2223,23 +2224,23 @@ Fixes
![image](https://raw.githubusercontent.com/fmtlib/android-ndk-example/%0Amaster/screenshot.png) ![image](https://raw.githubusercontent.com/fmtlib/android-ndk-example/%0Amaster/screenshot.png)
* Improved documentation of `SystemError` and `WindowsError` ([\#54]()). * Improved documentation of `SystemError` and `WindowsError` (#54).
* Various code improvements ([\#110](), [\#111]() [\#112]()). Thanks to * Various code improvements (#110, #111 #112). Thanks to
[\@CarterLi](https://github.com/CarterLi). [\@CarterLi](https://github.com/CarterLi).
* Improved compile-time errors when formatting wide into narrow strings * Improved compile-time errors when formatting wide into narrow strings
([\#117]()). (#117).
* Fixed `BasicWriter::write` without formatting arguments when C++11 support is * Fixed `BasicWriter::write` without formatting arguments when C++11 support is
disabled ([\#109]()). disabled (#109).
* Fixed header-only build on OS X with GCC 4.9 ([\#124]()). * Fixed header-only build on OS X with GCC 4.9 (#124).
* Fixed packaging issues ([\#94]()). * Fixed packaging issues (#94).
* Added [changelog](https://github.com/fmtlib/fmt/blob/master/ChangeLog.rst) * Added [changelog](https://github.com/fmtlib/fmt/blob/master/ChangeLog.rst)
([\#103]()). (#103).
1.0.0 - 2015-02-05 1.0.0 - 2015-02-05
================== ==================
...@@ -2247,31 +2248,31 @@ Fixes ...@@ -2247,31 +2248,31 @@ Fixes
* Add support for a header-only configuration when `FMT_HEADER_ONLY` is defined * Add support for a header-only configuration when `FMT_HEADER_ONLY` is defined
before including `format.h`: before including `format.h`:
``` {.c++} ```c++
#define FMT_HEADER_ONLY #define FMT_HEADER_ONLY
#include "format.h" #include "format.h"
``` ```
* Compute string length in the constructor of `BasicStringRef` instead of the * Compute string length in the constructor of `BasicStringRef` instead of the
`size` method ([\#79]()). This eliminates size computation for string literals `size` method (#79). This eliminates size computation for string literals
on reasonable optimizing compilers. on reasonable optimizing compilers.
* Fix formatting of types with overloaded `operator <<` for `std::wostream` * Fix formatting of types with overloaded `operator <<` for `std::wostream`
([\#86]()): (#86):
``` {.c++} ```c++
fmt::format(L"The date is {0}", Date(2012, 12, 9)); fmt::format(L"The date is {0}", Date(2012, 12, 9));
``` ```
* Fix linkage of tests on Arch Linux ([\#89]()). * Fix linkage of tests on Arch Linux (#89).
* Allow precision specifier for non-float arguments ([\#90]()): * Allow precision specifier for non-float arguments (#90):
``` {.c++} ```c++
fmt::print("{:.3}\n", "Carpet"); // prints "Car" fmt::print("{:.3}\n", "Carpet"); // prints "Car"
``` ```
* Fix build on Android NDK ([\#93]()) * Fix build on Android NDK (#93)
* Improvements to documentation build procedure. * Improvements to documentation build procedure.
...@@ -2293,30 +2294,30 @@ Fixes ...@@ -2293,30 +2294,30 @@ Fixes
Old code: Old code:
``` {.c++} ```c++
fmt::Writer w; fmt::Writer w;
``` ```
New code: New code:
``` {.c++} ```c++
fmt::MemoryWriter w; fmt::MemoryWriter w;
``` ```
If you pass `fmt::Writer` by reference, you can continue to do so: If you pass `fmt::Writer` by reference, you can continue to do so:
``` {.c++} ```c++
void f(fmt::Writer &w); void f(fmt::Writer &w);
``` ```
This doesn\'t affect the formatting API. This doesn\'t affect the formatting API.
* Support for custom memory allocators ([\#69]()) * Support for custom memory allocators (#69)
* Formatting functions now accept [signed char]{.title-ref} and [unsigned * Formatting functions now accept [signed char]{.title-ref} and [unsigned
char]{.title-ref} strings as arguments ([\#73]()): char]{.title-ref} strings as arguments (#73):
``` {.c++} ```c++
auto s = format("GLSL version: {}", glGetString(GL_VERSION)); auto s = format("GLSL version: {}", glGetString(GL_VERSION));
``` ```
...@@ -2339,14 +2340,14 @@ Fixes ...@@ -2339,14 +2340,14 @@ Fixes
* Safe printf implementation with a POSIX extension for positional arguments: * Safe printf implementation with a POSIX extension for positional arguments:
``` {.c++} ```c++
fmt::printf("Elapsed time: %.2f seconds", 1.23); fmt::printf("Elapsed time: %.2f seconds", 1.23);
fmt::printf("%1$s, %3$d %2$s", weekday, month, day); fmt::printf("%1$s, %3$d %2$s", weekday, month, day);
``` ```
* Arguments of `char` type can now be formatted as integers ([\#55]()): * Arguments of `char` type can now be formatted as integers (#55):
``` {.c++} ```c++
fmt::format("0x{0:02X}", 'a'); fmt::format("0x{0:02X}", 'a');
``` ```
...@@ -2367,7 +2368,7 @@ Fixes ...@@ -2367,7 +2368,7 @@ Fixes
wrapper functions defined with the `FMT_VARIADIC` macro. You can use this wrapper functions defined with the `FMT_VARIADIC` macro. You can use this
macro for defining your own portable variadic functions: macro for defining your own portable variadic functions:
``` {.c++} ```c++
void report_error(const char *format, const fmt::ArgList &args) { void report_error(const char *format, const fmt::ArgList &args) {
fmt::print("Error: {}"); fmt::print("Error: {}");
fmt::print(format, args); fmt::print(format, args);
...@@ -2385,20 +2386,20 @@ Fixes ...@@ -2385,20 +2386,20 @@ Fixes
* Simplified common case of formatting an `std::string`. Now it requires a * Simplified common case of formatting an `std::string`. Now it requires a
single function call: single function call:
``` {.c++} ```c++
std::string s = format("The answer is {}.", 42); std::string s = format("The answer is {}.", 42);
``` ```
Previously it required 2 function calls: Previously it required 2 function calls:
``` {.c++} ```c++
std::string s = str(Format("The answer is {}.") << 42); std::string s = str(Format("The answer is {}.") << 42);
``` ```
Instead of unsafe `c_str` function, `fmt::Writer` should be used directly to Instead of unsafe `c_str` function, `fmt::Writer` should be used directly to
bypass creation of `std::string`: bypass creation of `std::string`:
``` {.c++} ```c++
fmt::Writer w; fmt::Writer w;
w.write("The answer is {}.", 42); w.write("The answer is {}.", 42);
w.c_str(); // returns a C string w.c_str(); // returns a C string
...@@ -2411,7 +2412,7 @@ Fixes ...@@ -2411,7 +2412,7 @@ Fixes
* Improved consistency in naming functions that are a part of the public API. * Improved consistency in naming functions that are a part of the public API.
Now all public functions are lowercase following the standard library Now all public functions are lowercase following the standard library
conventions. Previously it was a combination of lowercase and conventions. Previously it was a combination of lowercase and
CapitalizedWords. Issue [\#50](). CapitalizedWords. Issue #50.
* Old functions are marked as deprecated and will be removed in the next * Old functions are marked as deprecated and will be removed in the next
release. release.
...@@ -2420,14 +2421,14 @@ Fixes ...@@ -2420,14 +2421,14 @@ Fixes
* Experimental support for printf format specifications (work in progress): * Experimental support for printf format specifications (work in progress):
``` {.c++} ```c++
fmt::printf("The answer is %d.", 42); fmt::printf("The answer is %d.", 42);
std::string s = fmt::sprintf("Look, a %s!", "string"); std::string s = fmt::sprintf("Look, a %s!", "string");
``` ```
* Support for hexadecimal floating point format specifiers `a` and `A`: * Support for hexadecimal floating point format specifiers `a` and `A`:
``` {.c++} ```c++
print("{:a}", -42.0); // Prints -0x1.5p+5 print("{:a}", -42.0); // Prints -0x1.5p+5
print("{:A}", -42.0); // Prints -0X1.5P+5 print("{:A}", -42.0); // Prints -0X1.5P+5
``` ```
...@@ -2442,7 +2443,7 @@ Fixes ...@@ -2442,7 +2443,7 @@ Fixes
* `Writer::Format` now has a variadic overload: * `Writer::Format` now has a variadic overload:
``` {.c++} ```c++
Writer out; Writer out;
out.Format("Look, I'm {}!", "variadic"); out.Format("Look, I'm {}!", "variadic");
``` ```
...@@ -2451,7 +2452,7 @@ Fixes ...@@ -2451,7 +2452,7 @@ Fixes
`Format` function now returns `Writer` instead of `std::string`. Use the `str` `Format` function now returns `Writer` instead of `std::string`. Use the `str`
function to convert it to `std::string`: function to convert it to `std::string`:
``` {.c++} ```c++
std::string s = str(Format("Look, I'm {}!", "variadic")); std::string s = str(Format("Look, I'm {}!", "variadic"));
``` ```
...@@ -2464,7 +2465,7 @@ Fixes ...@@ -2464,7 +2465,7 @@ Fixes
`SystemError` containing the formatted message and system-specific error `SystemError` containing the formatted message and system-specific error
description. For example, the following code description. For example, the following code
``` {.c++} ```c++
FILE *f = fopen(filename, "r"); FILE *f = fopen(filename, "r");
if (!f) if (!f)
ThrowSystemError(errno, "Failed to open file '{}'") << filename; ThrowSystemError(errno, "Failed to open file '{}'") << filename;
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment