2017-06-24 13:38:25 +00:00
4.0.0 - TBD
-----------
* Removed old compatibility headers `` cppformat/*.h `` and CMake options (`#527 <https://github.com/pull/527> `_ ). Thanks `@maddinat0r (Alex Martin) <https://github.com/maddinat0r> `_ .
* Added `` string.h `` containing `` fmt::to_string() `` as alternative to `` std::to_string() `` as well as other string writer functionality (`#326 <https://github.com/fmtlib/fmt/issues/326> `_ and `#441 <https://github.com/fmtlib/fmt/pull/441> `_ ):
.. code :: c++
#include "fmt/string.h"
std::string answer = fmt::to_string(42);
Thanks to `@glebov-andrey (Andrey Glebov) <https://github.com/glebov-andrey> `_ .
* Moved `` fmt::printf() `` to new `` printf.h `` header and allowed `` %s `` as generic specifier (`#453 <https://github.com/fmtlib/fmt/pull/453> `_ ), made `` %.f `` more conformant to regular `` printf() `` (`#490 <https://github.com/fmtlib/fmt/pull/490> `_ ), added custom writer support (`#476 <https://github.com/fmtlib/fmt/issues/476> `_ ) and implemented missing custom argument formatting (`#339 <https://github.com/fmtlib/fmt/pull/339> `_ and `#340 <https://github.com/fmtlib/fmt/pull/340> `_ ):
.. code :: c++
#include "fmt/printf.h"
// %s format specifier can be used with any argument type.
fmt::printf("%s", 42);
Thanks `@mojoBrendan <https://github.com/mojoBrendan> `_ , `@manylegged (Arthur Danskin) <https://github.com/manylegged> `_ and `@spacemoose (Glen Stark) <https://github.com/spacemoose> `_ . See also `#360 <https://github.com/fmtlib/fmt/issues/360> `_ , `#335 <https://github.com/fmtlib/fmt/issues/335> `_ and `#331 <https://github.com/fmtlib/fmt/issues/331> `_ .
* Added `` container.h `` containing a `` BasicContainerWriter `` to write to containers like `` std::vector `` (`#450 <https://github.com/fmtlib/fmt/pull/450> `_ ). Thanks `@polyvertex (Jean-Charles Lefebvre) <https://github.com/polyvertex> `_ .
* Added `` fmt::join() `` function that takes a range and formats its elements separated by a given string (`#466 <https://github.com/fmtlib/fmt/pull/466> `_ ):
.. code :: c++
#include "fmt/format.h"
std::vector<double> v = {1.2, 3.4, 5.6};
// Prints "(+01.20, +03.40, +05.60)".
fmt::print("({:+06.2f})", fmt::join(v.begin(), v.end(), ", "));
Thanks `@olivier80 <https://github.com/olivier80> `_ .
* Added support for custom formatting specifications to simplify customization of built-in formatting (`#444 <https://github.com/fmtlib/fmt/pull/444> `_ ). Thanks `@polyvertex (Jean-Charles Lefebvre) <https://github.com/polyvertex> `_ . See also `#439 <https://github.com/fmtlib/fmt/issues/439> `_ .
* Added `` fmt::format_system_error() `` for error code formatting (`#323 <https://github.com/fmtlib/fmt/issues/323> `_ and `#526 <https://github.com/fmtlib/fmt/pull/526> `_ ). Thanks `@maddinat0r (Alex Martin) <https://github.com/maddinat0r> `_ .
* Added thread-safe `` fmt::localtime() `` and `` fmt::gmtime() `` as replacement for the standard version to `` time.h `` (`#396 <https://github.com/fmtlib/fmt/pull/396> `_ ). Thanks `@codicodi <https://github.com/codicodi> `_ .
* Internal improvements to `` NamedArg `` and `` ArgLists `` (`#389 <https://github.com/fmtlib/fmt/pull/389> `_ and `#390 <https://github.com/fmtlib/fmt/pull/390> `_ ). Thanks `@chronoxor <https://github.com/chronoxor> `_ .
* Fixed crash due to bug in `` FormatBuf `` (`#493 <https://github.com/fmtlib/fmt/pull/493> `_ ). Thanks `@effzeh <https://github.com/effzeh> `_ . See also `#480 <https://github.com/fmtlib/fmt/issues/480> `_ and `#491 <https://github.com/fmtlib/fmt/issues/491> `_ .
* Fixed handling of wide strings in `` fmt::StringWriter `` .
* Improved compiler error messages (`#357 <https://github.com/fmtlib/fmt/issues/357> `_ ).
* Fixed various warnings and issues with various compilers (`#494 <https://github.com/fmtlib/fmt/pull/494> `_ , `#499 <https://github.com/fmtlib/fmt/pull/499> `_ , `#483 <https://github.com/fmtlib/fmt/pull/483> `_ , `#519 <https://github.com/fmtlib/fmt/pull/519> `_ , `#485 <https://github.com/fmtlib/fmt/pull/485> `_ , `#482 <https://github.com/fmtlib/fmt/pull/482> `_ , `#475 <https://github.com/fmtlib/fmt/pull/475> `_ , `#473 <https://github.com/fmtlib/fmt/pull/473> `_ and `#414 <https://github.com/fmtlib/fmt/pull/414> `_ ). Thanks `@chronoxor <https://github.com/chronoxor> `_ , `@zhaohuaxishi <https://github.com/zhaohuaxishi> `_ , `@pkestene (Pierre Kestener) <https://github.com/pkestene> `_ , `@dschmidt (Dominik Schmidt) <https://github.com/dschmidt> `_ and `@0x414c (Alexey Gorishny) <https://github.com/0x414c> `_ .
* Improved CMake: targets are now namespaced (`#511 <https://github.com/fmtlib/fmt/pull/511> `_ and `#513 <https://github.com/fmtlib/fmt/pull/513> `_ ), supported header-only `` printf.h `` (`#354 <https://github.com/fmtlib/fmt/pull/354> `_ ), fixed issue with minimal supported library subset (`#418 <https://github.com/fmtlib/fmt/issues/418> `_ , `#419 <https://github.com/fmtlib/fmt/pull/419> `_ and `#420 <https://github.com/fmtlib/fmt/pull/420> `_ ). Thanks `@bjoernthiel (Bjoern Thiel) <https://github.com/bjoernthiel> `_ ,
`@niosHD (Mario Werner) <https://github.com/niosHD> `_ , `@LogicalKnight (Sean LK) <https://github.com/LogicalKnight> `_ and `@alabuzhev (Alex Alabuzhev) <https://github.com/alabuzhev> `_ .
* Improved documentation. Thanks to `@pwm1234 (Phil) <https://github.com/pwm1234> `_ for `#393 <https://github.com/fmtlib/fmt/pull/393> `_ .
2017-06-14 16:20:51 +00:00
3.0.2 - 2017-06-14
------------------
* Added `` FMT_VERSION `` macro (`#411 <https://github.com/fmtlib/fmt/issues/411> `_ ).
* Used `` FMT_NULL `` instead of literal `` 0 `` (`#409 <https://github.com/fmtlib/fmt/pull/409> `_ ). Thanks `@alabuzhev (Alex Alabuzhev) <https://github.com/alabuzhev> `_ .
* Added extern templates for `` format_float `` (`#413 <https://github.com/fmtlib/fmt/issues/413> `_ ).
* Fixed implicit conversion issue (`#507 <https://github.com/fmtlib/fmt/issues/507> `_ ).
* Fixed signbit detection (`#423 <https://github.com/fmtlib/fmt/issues/423> `_ ).
* Fixed naming collision (`#425 <https://github.com/fmtlib/fmt/issues/425> `_ ).
* Fixed missing intrinsic for C++/CLI (`#457 <https://github.com/fmtlib/fmt/pull/457> `_ ). Thanks `@calumr (Calum Robinson) <https://github.com/calumr> `_
* Fixed Android detection (`#458 <https://github.com/fmtlib/fmt/pull/458> `_ ). Thanks `@Gachapen (Magnus Bjerke Vik) <https://github.com/Gachapen> `_ .
* Use lean `` windows.h `` if not in header-only mode (`#503 <https://github.com/fmtlib/fmt/pull/503> `_ ). Thanks `@Quentin01 (Quentin Buathier) <https://github.com/Quentin01> `_ .
* Fixed issue with CMake exporting C++11 flag (`#445 <https://github.com/fmtlib/fmt/pull/455> `_ ). Thanks `@EricWF (Eric) <https://github.com/EricWF> `_ .
* Fixed issue with nvcc and MSVC compiler bug and MinGW (`#505 <https://github.com/fmtlib/fmt/issues/505> `_ ).
* Fixed DLL issues (`#469 <https://github.com/fmtlib/fmt/pull/469> `_ and `#502 <https://github.com/fmtlib/fmt/pull/502> `_ ). Thanks `@richardeakin (Richard Eakin) <https://github.com/richardeakin> `_ and `@AndreasSchoenle (Andreas Schönle) <https://github.com/AndreasSchoenle> `_ .
* Fixed test compilation under FreeBSD (`#433 <https://github.com/fmtlib/fmt/issues/433> `_ ).
* Fixed various warnings (`#403 <https://github.com/fmtlib/fmt/pull/403> `_ , `#410 <https://github.com/fmtlib/fmt/pull/410> `_ and `#510 <https://github.com/fmtlib/fmt/pull/510> `_ ). Thanks `@Lecetem <https://github.com/Lectem> `_ , `@chenhayat (Chen Hayat) <https://github.com/chenhayat> `_ and `@trozen <https://github.com/trozen> `_ .
* Removed redundant include (`#479 <https://github.com/fmtlib/fmt/issues/479> `_ ).
* Fixed documentation issues.
2016-11-01 09:49:34 +00:00
3.0.1 - 2016-11-01
------------------
* Fixed handling of thousands seperator (`#353 <https://github.com/fmtlib/fmt/issues/353> `_ )
* Fixed handling of `` unsigned char `` strings (`#373 <https://github.com/fmtlib/fmt/issues/373> `_ )
* Corrected buffer growth when formatting time (`#367 <https://github.com/fmtlib/fmt/issues/367> `_ )
* Removed warnings under MSVC and clang (`#318 <https://github.com/fmtlib/fmt/issues/318> `_ , `#250 <https://github.com/fmtlib/fmt/issues/250> `_ , also merged `#385 <https://github.com/fmtlib/fmt/pull/385> `_ and `#361 <https://github.com/fmtlib/fmt/pull/361> `_ ). Thanks `@jcelerier (Jean-Michaël Celerier) <https://github.com/jcelerier> `_ and `@nmoehrle (Nils Moehrle) <https://github.com/nmoehrle> `_ .
* Fixed compilation issues under Android (`#327 <https://github.com/fmtlib/fmt/pull/327> `_ , `#345 <https://github.com/fmtlib/fmt/issues/345> `_ and `#381 <https://github.com/fmtlib/fmt/pull/381> `_ ), FreeBSD (`#358 <https://github.com/fmtlib/fmt/pull/358> `_ ), Cygwin (`#388 <https://github.com/fmtlib/fmt/issues/388> `_ ), MinGW (`#355 <https://github.com/fmtlib/fmt/issues/355> `_ ) as well as other issues (`#350 <https://github.com/fmtlib/fmt/issues/350> `_ , `#366 <https://github.com/fmtlib/fmt/issues/355> `_ , `#348 <https://github.com/fmtlib/fmt/pull/348> `_ , `#402 <https://github.com/fmtlib/fmt/pull/402> `_ , `#405 <https://github.com/fmtlib/fmt/pull/405> `_ ). Thanks to `@dpantele (Dmitry) <https://github.com/dpantele> `_ , `@hghwng (Hugh Wang) <https://github.com/hghwng> `_ , `@arvedarved (Tilman Keskinöz) <https://github.com/arvedarved> `_ , `@LogicalKnight (Sean) <https://github.com/LogicalKnight> `_ and `@JanHellwig (Jan Hellwig) <https://github.com/janhellwig> `_ .
* Fixed some documentation issues and extended specification (`#320 <https://github.com/fmtlib/fmt/issues/320> `_ , `#333 <https://github.com/fmtlib/fmt/pull/333> `_ , `#347 <https://github.com/fmtlib/fmt/issues/347> `_ , `#362 <https://github.com/fmtlib/fmt/pull/362> `_ ). Thanks to `@smellman (Taro Matsuzawa aka. btm) <https://github.com/smellman> `_ .
2016-05-07 16:50:47 +00:00
3.0.0 - 2016-05-07
------------------
2016-05-04 15:49:29 +00:00
* The project has been renamed from C++ Format (cppformat) to fmt for
consistency with the used namespace and macro prefix
(`#307 <https://github.com/fmtlib/fmt/issues/307> `_ ).
Library headers are now located in the `` fmt `` directory:
.. code :: c++
#include "fmt/format.h"
2016-05-05 15:20:12 +00:00
Including `` format.h `` from the `` cppformat `` directory is deprecated
2016-05-04 15:49:29 +00:00
but works via a proxy header which will be removed in the next major version.
2016-05-07 15:59:19 +00:00
The documentation is now available at http://fmtlib.net.
2016-05-04 15:49:29 +00:00
2016-05-07 14:50:56 +00:00
* Added support for `strftime <http://en.cppreference.com/w/cpp/chrono/c/strftime> `_ -like
2016-05-07 16:37:38 +00:00
`date and time formatting <http://fmtlib.net/3.0.0/api.html#date-and-time-formatting> `_
2016-05-07 14:50:56 +00:00
(`#283 <https://github.com/fmtlib/fmt/issues/283> `_ ):
.. code :: c++
#include "fmt/time.h"
std::time_t t = std::time(nullptr);
// Prints "The date is 2016-04-29." (with the current date)
fmt::print("The date is {:%Y-%m-%d}.", *std::localtime(&t));
2016-05-07 15:50:51 +00:00
* `` std::ostream `` support including formatting of user-defined types that provide
overloaded `` operator<< `` has been moved to `` fmt/ostream.h `` :
.. code :: c++
#include "fmt/ostream.h"
class Date {
int year_, month_, day_;
public:
Date(int year, int month, int day) : year_(year), month_(month), day_(day) {}
friend std::ostream &operator<<(std::ostream &os, const Date &d) {
return os << d.year_ << '-' << d.month_ << '-' << d.day_;
}
};
std::string s = fmt::format("The date is {}", Date(2012, 12, 9));
// s == "The date is 2012-12-9"
2016-05-07 14:50:56 +00:00
* Added support for `custom argument formatters
2016-05-07 16:37:38 +00:00
<http://fmtlib.net/3.0.0/api.html#argument-formatters>`_
2016-05-07 14:50:56 +00:00
(`#235 <https://github.com/fmtlib/fmt/issues/235> `_ ).
* Added support for locale-specific integer formatting with the `` n `` specifier
(`#305 <https://github.com/fmtlib/fmt/issues/305> `_ ):
.. code :: c++
std::setlocale(LC_ALL, "en_US.utf8");
fmt::print("cppformat: {:n}\n", 1234567); // prints 1,234,567
* Sign is now preserved when formatting an integer with an incorrect `` printf ``
format specifier (`#265 <https://github.com/fmtlib/fmt/issues/265> `_ ):
.. code :: c++
fmt::printf("%lld", -42); // prints -42
Note that it would be an undefined behavior in `` std::printf `` .
2016-05-07 16:21:26 +00:00
* Length modifiers such as `` ll `` are now optional in printf formatting
2016-05-07 14:50:56 +00:00
functions and the correct type is determined automatically
(`#255 <https://github.com/fmtlib/fmt/issues/255> `_ ):
.. code :: c++
fmt::printf("%d", std::numeric_limits<long long>::max());
Note that it would be an undefined behavior in `` std::printf `` .
* Added initial support for custom formatters
(`#231 <https://github.com/fmtlib/fmt/issues/231> `_ ).
2016-05-04 15:49:29 +00:00
* Fixed detection of user-defined literal support on Intel C++ compiler
(`#311 <https://github.com/fmtlib/fmt/issues/311> `_ ,
`#312 <https://github.com/fmtlib/fmt/pull/312> `_ ).
Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d> `_ and
`@speth (Ray Speth) <https://github.com/speth> `_ .
2016-05-07 15:44:51 +00:00
* Reduced compile time
2016-05-05 15:20:12 +00:00
(`#243 <https://github.com/fmtlib/fmt/pull/243> `_ ,
2016-05-07 15:44:51 +00:00
`#249 <https://github.com/fmtlib/fmt/pull/249> `_ ,
`#317 <https://github.com/fmtlib/fmt/issues/317> `_ ):
.. image :: https://cloud.githubusercontent.com/assets/4831417/11614060/
b9e826d2-9c36-11e5-8666-d4131bf503ef.png
.. image :: https://cloud.githubusercontent.com/assets/4831417/11614080/
6ac903cc-9c37-11e5-8165-26df6efae364.png
2016-05-05 15:20:12 +00:00
Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d> `_ .
2016-05-04 15:49:29 +00:00
* Compile test fixes (`#313 <https://github.com/fmtlib/fmt/pull/313> `_ ).
Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d> `_ .
2016-05-07 14:50:56 +00:00
* Documentation fixes (`#239 <https://github.com/fmtlib/fmt/pull/239> `_ ,
`#248 <https://github.com/fmtlib/fmt/issues/248> `_ ,
`#252 <https://github.com/fmtlib/fmt/issues/252> `_ ,
`#258 <https://github.com/fmtlib/fmt/pull/258> `_ ,
`#260 <https://github.com/fmtlib/fmt/issues/260> `_ ,
`#301 <https://github.com/fmtlib/fmt/issues/301> `_ ,
2016-05-05 15:20:12 +00:00
`#309 <https://github.com/fmtlib/fmt/pull/309> `_ ).
Thanks to `@ReadmeCritic <https://github.com/ReadmeCritic> `_
`@Gachapen (Magnus Bjerke Vik) <https://github.com/Gachapen> `_ and
`@jwilk (Jakub Wilk) <https://github.com/jwilk> `_ .
2016-05-04 15:49:29 +00:00
2016-11-01 09:49:34 +00:00
* Fixed compiler and sanitizer warnings (
`#244 <https://github.com/fmtlib/fmt/issues/244> `_ ,
2016-05-07 14:50:56 +00:00
`#256 <https://github.com/fmtlib/fmt/pull/256> `_ ,
2016-05-05 15:20:12 +00:00
`#259 <https://github.com/fmtlib/fmt/pull/259> `_ ,
2016-05-07 14:50:56 +00:00
`#263 <https://github.com/fmtlib/fmt/issues/263> `_ ,
`#274 <https://github.com/fmtlib/fmt/issues/274> `_ ,
2016-05-04 15:49:29 +00:00
`#277 <https://github.com/fmtlib/fmt/pull/277> `_ ,
2016-05-07 14:50:56 +00:00
`#286 <https://github.com/fmtlib/fmt/pull/286> `_ ,
`#291 <https://github.com/fmtlib/fmt/issues/291> `_ ,
`#296 <https://github.com/fmtlib/fmt/issues/296> `_ ,
`#308 <https://github.com/fmtlib/fmt/issues/308> `_ )
2016-05-04 15:49:29 +00:00
Thanks to `@mwinterb <https://github.com/mwinterb> `_ ,
`@pweiskircher (Patrik Weiskircher) <https://github.com/pweiskircher> `_ ,
`@Naios <https://github.com/Naios> `_ .
* Improved compatibility with Windows Store apps
(`#280 <https://github.com/fmtlib/fmt/issues/280> `_ ,
`#285 <https://github.com/fmtlib/fmt/pull/285> `_ )
Thanks to `@mwinterb <https://github.com/mwinterb> `_ .
* Added tests of compatibility with older C++ standards
(`#273 <https://github.com/fmtlib/fmt/pull/273> `_ ).
Thanks to `@niosHD <https://github.com/niosHD> `_ .
* Fixed Android build (`#271 <https://github.com/fmtlib/fmt/pull/271> `_ ).
Thanks to `@newnon <https://github.com/newnon> `_ .
* Changed `` ArgMap `` to be backed by a vector instead of a map.
2016-05-07 14:50:56 +00:00
(`#261 <https://github.com/fmtlib/fmt/issues/261> `_ ,
`#262 <https://github.com/fmtlib/fmt/pull/262> `_ ).
2016-05-04 15:49:29 +00:00
Thanks to `@mwinterb <https://github.com/mwinterb> `_ .
2016-05-05 15:20:12 +00:00
* Added `` fprintf `` overload that writes to a `` std::ostream ``
(`#251 <https://github.com/fmtlib/fmt/pull/251> `_ ).
Thanks to `nickhutchinson (Nicholas Hutchinson) <https://github.com/nickhutchinson> `_ .
* Export symbols when building a Windows DLL
(`#245 <https://github.com/fmtlib/fmt/pull/245> `_ ).
Thanks to `macdems (Maciek Dems) <https://github.com/macdems> `_ .
2016-05-07 14:50:56 +00:00
* Fixed compilation on Cygwin (`#304 <https://github.com/fmtlib/fmt/issues/304> `_ ).
* Implemented a workaround for a bug in Apple LLVM version 4.2 of clang
(`#276 <https://github.com/fmtlib/fmt/issues/276> `_ ).
* Implemented a workaround for Google Test bug
`#705 <https://github.com/google/googletest/issues/705> `_ on gcc 6
(`#268 <https://github.com/fmtlib/fmt/issues/268> `_ ).
Thanks to `octoploid <https://github.com/octoploid> `_ .
2016-05-07 15:59:19 +00:00
* Removed Biicode support because the latter has been discontinued.
2016-04-11 19:17:15 +00:00
2.1.1 - 2016-04-11
------------------
2016-04-11 19:13:36 +00:00
* The install location for generated CMake files is now configurable via
the `` FMT_CMAKE_DIR `` CMake variable
2016-04-28 13:45:50 +00:00
(`#299 <https://github.com/fmtlib/fmt/pull/299> `_ ).
2016-04-11 19:13:36 +00:00
Thanks to `@niosHD <https://github.com/niosHD> `_ .
2016-04-28 13:45:50 +00:00
* Documentation fixes (`#252 <https://github.com/fmtlib/fmt/issues/252> `_ ).
2016-04-11 19:13:36 +00:00
2016-03-21 14:58:24 +00:00
2.1.0 - 2016-03-21
------------------
2016-03-21 14:57:06 +00:00
* Project layout and build system improvements
2016-04-28 13:45:50 +00:00
(`#267 <https://github.com/fmtlib/fmt/pull/267> `_ ):
2016-03-21 14:57:06 +00:00
* The code have been moved to the `` cppformat `` directory.
Including `` format.h `` from the top-level directory is deprecated
but works via a proxy header which will be removed in the next
major version.
* C++ Format CMake targets now have proper interface definitions.
* Installed version of the library now supports the header-only
configuration.
* Targets `` doc `` , `` install `` , and `` test `` are now disabled if C++ Format
is included as a CMake subproject. They can be enabled by setting
`` FMT_DOC `` , `` FMT_INSTALL `` , and `` FMT_TEST `` in the parent project.
Thanks to `@niosHD <https://github.com/niosHD> `_ .
2016-03-17 14:28:21 +00:00
2.0.1 - 2016-03-13
------------------
* Improved CMake find and package support
2016-04-28 13:45:50 +00:00
(`#264 <https://github.com/fmtlib/fmt/issues/264> `_ ).
2016-03-17 14:28:21 +00:00
Thanks to `@niosHD <https://github.com/niosHD> `_ .
* Fix compile error with Android NDK and mingw32
2016-04-28 13:45:50 +00:00
(`#241 <https://github.com/fmtlib/fmt/issues/241> `_ ).
2016-03-17 14:28:21 +00:00
Thanks to `@Gachapen (Magnus Bjerke Vik) <https://github.com/Gachapen> `_ .
* Documentation fixes
2016-04-28 13:45:50 +00:00
(`#248 <https://github.com/fmtlib/fmt/issues/248> `_ ,
`#260 <https://github.com/fmtlib/fmt/issues/260> `_ ).
2016-03-17 14:28:21 +00:00
2015-12-01 15:33:30 +00:00
2.0.0 - 2015-12-01
------------------
2015-10-23 13:52:12 +00:00
2015-11-30 16:10:49 +00:00
General
~~~~~~~
2015-10-29 14:28:47 +00:00
2015-11-30 16:10:49 +00:00
* [Breaking] Named arguments
2016-04-28 13:45:50 +00:00
(`#169 <https://github.com/fmtlib/fmt/pull/169> `_ ,
`#173 <https://github.com/fmtlib/fmt/pull/173> `_ ,
`#174 <https://github.com/fmtlib/fmt/pull/174> `_ ):
2015-10-30 14:43:15 +00:00
2015-11-30 16:10:49 +00:00
.. code :: c++
fmt::print("The answer is {answer}.", fmt::arg("answer", 42));
Thanks to `@jamboree <https://github.com/jamboree> `_ .
* [Experimental] User-defined literals for format and named arguments
2016-04-28 13:45:50 +00:00
(`#204 <https://github.com/fmtlib/fmt/pull/204> `_ ,
`#206 <https://github.com/fmtlib/fmt/pull/206> `_ ,
`#207 <https://github.com/fmtlib/fmt/pull/207> `_ ):
2015-10-29 14:24:39 +00:00
.. code :: c++
2015-11-30 16:10:49 +00:00
using namespace fmt::literals;
fmt::print("The answer is {answer}.", "answer"_a=42);
2015-10-29 14:24:39 +00:00
2015-11-30 16:10:49 +00:00
Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d> `_ .
2015-10-29 14:24:39 +00:00
2015-11-30 16:10:49 +00:00
* [Breaking] Formatting of more than 16 arguments is now supported when using
variadic templates
2016-04-28 13:45:50 +00:00
(`#141 <https://github.com/fmtlib/fmt/issues/141> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@Shauren <https://github.com/Shauren> `_ .
* Runtime width specification
2016-04-28 13:45:50 +00:00
(`#168 <https://github.com/fmtlib/fmt/pull/168> `_ ):
2015-11-30 16:10:49 +00:00
.. code :: c++
fmt::format("{0:{1}}", 42, 5); // gives " 42"
Thanks to `@jamboree <https://github.com/jamboree> `_ .
* [Breaking] Enums are now formatted with an overloaded `` std::ostream `` insertion
operator (`` operator<< `` ) if available
2016-04-28 13:45:50 +00:00
(`#232 <https://github.com/fmtlib/fmt/issues/232> `_ ).
2015-11-30 16:10:49 +00:00
* [Breaking] Changed default `` bool `` format to textual, "true" or "false"
2016-04-28 13:45:50 +00:00
(`#170 <https://github.com/fmtlib/fmt/issues/170> `_ ):
2015-11-30 16:10:49 +00:00
.. code :: c++
fmt::print("{}", true); // prints "true"
To print `` bool `` as a number use numeric format specifier such as `` d `` :
.. code :: c++
fmt::print("{:d}", true); // prints "1"
* `` fmt::printf `` and `` fmt::sprintf `` now support formatting of `` bool `` with the
`` %s `` specifier giving textual output, "true" or "false"
2016-04-28 13:45:50 +00:00
(`#223 <https://github.com/fmtlib/fmt/pull/223> `_ ):
2015-11-30 16:10:49 +00:00
.. code :: c++
fmt::printf("%s", true); // prints "true"
Thanks to `@LarsGullik <https://github.com/LarsGullik> `_ .
2015-11-30 16:17:47 +00:00
* [Breaking] `` signed char `` and `` unsigned char `` are now formatted as integers by default
2016-04-28 13:45:50 +00:00
(`#217 <https://github.com/fmtlib/fmt/pull/217> `_ ).
2015-11-30 16:10:49 +00:00
* [Breaking] Pointers to C strings can now be formatted with the `` p `` specifier
2016-04-28 13:45:50 +00:00
(`#223 <https://github.com/fmtlib/fmt/pull/223> `_ ):
2015-11-30 16:10:49 +00:00
.. code :: c++
fmt::print("{:p}", "test"); // prints pointer value
Thanks to `@LarsGullik <https://github.com/LarsGullik> `_ .
* [Breaking] `` fmt::printf `` and `` fmt::sprintf `` now print null pointers as `` (nil) ``
and null strings as `` (null) `` for consistency with glibc
2016-04-28 13:45:50 +00:00
(`#226 <https://github.com/fmtlib/fmt/pull/226> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@LarsGullik <https://github.com/LarsGullik> `_ .
* [Breaking] `` fmt::(s)printf `` now supports formatting of objects of user-defined types
that provide an overloaded `` std::ostream `` insertion operator (`` operator<< `` )
2016-04-28 13:45:50 +00:00
(`#201 <https://github.com/fmtlib/fmt/issues/201> `_ ):
2015-11-30 16:10:49 +00:00
.. code :: c++
fmt::printf("The date is %s", Date(2012, 12, 9));
2015-10-29 14:16:59 +00:00
2015-10-29 15:26:03 +00:00
* [Breaking] The `` Buffer `` template is now part of the public API and can be used
2015-10-29 14:14:21 +00:00
to implement custom memory buffers
2016-04-28 13:45:50 +00:00
(`#140 <https://github.com/fmtlib/fmt/issues/140> `_ ).
2015-10-29 14:14:21 +00:00
Thanks to `@polyvertex (Jean-Charles Lefebvre) <https://github.com/polyvertex> `_ .
2015-11-30 16:10:49 +00:00
* [Breaking] Improved compatibility between `` BasicStringRef `` and
`std::experimental::basic_string_view
<http://en.cppreference.com/w/cpp/experimental/basic_string_view>`_
2016-04-28 13:45:50 +00:00
(`#100 <https://github.com/fmtlib/fmt/issues/100> `_ ,
`#159 <https://github.com/fmtlib/fmt/issues/159> `_ ,
`#183 <https://github.com/fmtlib/fmt/issues/183> `_ ):
2015-10-30 14:35:18 +00:00
2015-11-30 16:10:49 +00:00
- Comparison operators now compare string content, not pointers
- `` BasicStringRef::c_str `` replaced by `` BasicStringRef::data ``
- `` BasicStringRef `` is no longer assumed to be null-terminated
2015-10-30 14:35:18 +00:00
2015-11-30 16:17:47 +00:00
References to null-terminated strings are now represented by a new class,
`` BasicCStringRef `` .
2015-11-30 16:10:49 +00:00
* Dependency on pthreads introduced by Google Test is now optional
2016-04-28 13:45:50 +00:00
(`#185 <https://github.com/fmtlib/fmt/issues/185> `_ ).
2015-10-29 13:44:51 +00:00
2015-11-30 16:10:49 +00:00
* New CMake options `` FMT_DOC `` , `` FMT_INSTALL `` and `` FMT_TEST `` to control
generation of `` doc `` , `` install `` and `` test `` targets respectively, on by default
2016-04-28 13:45:50 +00:00
(`#197 <https://github.com/fmtlib/fmt/issues/197> `_ ,
`#198 <https://github.com/fmtlib/fmt/issues/198> `_ ,
`#200 <https://github.com/fmtlib/fmt/issues/200> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@maddinat0r (Alex Martin) <https://github.com/maddinat0r> `_ .
* `` noexcept `` is now used when compiling with MSVC2015
2016-04-28 13:45:50 +00:00
(`#215 <https://github.com/fmtlib/fmt/pull/215> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@dmkrepo (Dmitriy) <https://github.com/dmkrepo> `_ .
* Added an option to disable use of `` windows.h `` when `` FMT_USE_WINDOWS_H ``
is defined as 0 before including `` format.h ``
2016-04-28 13:45:50 +00:00
(`#171 <https://github.com/fmtlib/fmt/issues/171> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@alfps (Alf P. Steinbach) <https://github.com/alfps> `_ .
2015-10-29 13:28:51 +00:00
2015-10-29 13:24:15 +00:00
* [Breaking] `` windows.h `` is now included with `` NOMINMAX `` unless
`` 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
2016-04-28 13:45:50 +00:00
(`#152 <https://github.com/fmtlib/fmt/issues/152> `_ ,
`#153 <https://github.com/fmtlib/fmt/pull/153> `_ ,
`#154 <https://github.com/fmtlib/fmt/pull/154> `_ ).
2015-10-29 13:24:15 +00:00
Thanks to `@DevO2012 <https://github.com/DevO2012> `_ .
2015-11-30 16:10:49 +00:00
* Improved support for custom character types
2016-04-28 13:45:50 +00:00
(`#171 <https://github.com/fmtlib/fmt/issues/171> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@alfps (Alf P. Steinbach) <https://github.com/alfps> `_ .
* Added an option to disable use of IOStreams when `` FMT_USE_IOSTREAMS ``
is defined as 0 before including `` format.h ``
2016-04-28 13:45:50 +00:00
(`#205 <https://github.com/fmtlib/fmt/issues/205> `_ ,
`#208 <https://github.com/fmtlib/fmt/pull/208> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@JodiTheTigger <https://github.com/JodiTheTigger> `_ .
* Improved detection of `` isnan `` , `` isinf `` and `` signbit `` .
Optimization
~~~~~~~~~~~~
* Made formatting of user-defined types more efficient with a custom stream buffer
2016-04-28 13:45:50 +00:00
(`#92 <https://github.com/fmtlib/fmt/issues/92> `_ ,
`#230 <https://github.com/fmtlib/fmt/pull/230> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@NotImplemented <https://github.com/NotImplemented> `_ .
* 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 benchmark
2016-04-28 13:45:50 +00:00
(`#186 <https://github.com/fmtlib/fmt/issues/186> `_ ).
2015-11-30 16:10:49 +00:00
* [Breaking] Reduced `compiled code size
2016-04-28 13:45:50 +00:00
<https://github.com/fmtlib/fmt#compile-time-and-code-bloat>`_
(`#143 <https://github.com/fmtlib/fmt/issues/143> `_ ,
`#149 <https://github.com/fmtlib/fmt/pull/149> `_ ).
2015-11-30 16:10:49 +00:00
Distribution
~~~~~~~~~~~~
* [Breaking] Headers are now installed in
`` ${CMAKE_INSTALL_PREFIX}/include/cppformat ``
2016-04-28 13:45:50 +00:00
(`#178 <https://github.com/fmtlib/fmt/issues/178> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf> `_ .
* [Breaking] Changed the library name from `` format `` to `` cppformat ``
for consistency with the project name and to avoid potential conflicts
2016-04-28 13:45:50 +00:00
(`#178 <https://github.com/fmtlib/fmt/issues/178> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf> `_ .
2015-10-28 15:31:12 +00:00
* C++ Format is now available in `Debian <https://www.debian.org/> `_ GNU/Linux
(`stretch <https://packages.debian.org/source/stretch/cppformat> `_ ,
`sid <https://packages.debian.org/source/sid/cppformat> `_ ) and
derived distributions such as
`Ubuntu <https://launchpad.net/ubuntu/+source/cppformat> `_ 15.10 and later
2016-04-28 13:45:50 +00:00
(`#155 <https://github.com/fmtlib/fmt/issues/155> `_ )::
2015-10-28 15:31:12 +00:00
$ sudo apt-get install libcppformat1-dev
2015-10-28 14:49:31 +00:00
Thanks to `@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf> `_ .
2015-11-30 16:22:03 +00:00
* `Packages for Fedora and RHEL <https://admin.fedoraproject.org/pkgdb/package/cppformat/> `_
are now available. Thanks to Dave Johansen.
2015-10-28 15:31:12 +00:00
* C++ Format can now be installed via `Homebrew <http://brew.sh/> `_ on OS X
2016-04-28 13:45:50 +00:00
(`#157 <https://github.com/fmtlib/fmt/issues/157> `_ )::
2015-10-28 15:31:12 +00:00
$ brew install cppformat
Thanks to `@ortho <https://github.com/ortho> `_ , Anatoliy Bulukin.
2015-11-30 16:10:49 +00:00
Documentation
~~~~~~~~~~~~~
2015-10-28 04:55:57 +00:00
2015-11-30 16:10:49 +00:00
* Migrated from ReadTheDocs to GitHub Pages for better responsiveness
and reliability
2016-04-28 13:45:50 +00:00
(`#128 <https://github.com/fmtlib/fmt/issues/128> `_ ).
2015-11-30 16:10:49 +00:00
New documentation address is http://cppformat.github.io/.
2015-10-28 04:55:57 +00:00
2015-11-30 16:17:47 +00:00
2015-11-30 16:10:49 +00:00
* Added `Building the documentation
2016-05-07 16:37:38 +00:00
<http://fmtlib.net/2.0.0/usage.html#building-the-documentation>`_
2015-11-30 16:10:49 +00:00
section to the documentation.
2015-10-28 04:55:57 +00:00
2015-11-30 16:10:49 +00:00
* Documentation build script is now compatible with Python 3 and newer pip versions.
2016-04-28 13:45:50 +00:00
(`#189 <https://github.com/fmtlib/fmt/pull/189> `_ ,
`#209 <https://github.com/fmtlib/fmt/issues/209> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@JodiTheTigger <https://github.com/JodiTheTigger> `_ and
`@xentec <https://github.com/xentec> `_ .
2015-10-29 14:41:26 +00:00
* Documentation fixes and improvements
2016-04-28 13:45:50 +00:00
(`#36 <https://github.com/fmtlib/fmt/issues/36> `_ ,
`#75 <https://github.com/fmtlib/fmt/issues/75> `_ ,
`#125 <https://github.com/fmtlib/fmt/issues/125> `_ ,
`#160 <https://github.com/fmtlib/fmt/pull/160> `_ ,
`#161 <https://github.com/fmtlib/fmt/pull/161> `_ ,
`#162 <https://github.com/fmtlib/fmt/issues/162> `_ ,
`#165 <https://github.com/fmtlib/fmt/issues/165> `_ ,
`#210 <https://github.com/fmtlib/fmt/issues/210> `_ ).
2015-10-30 13:56:07 +00:00
Thanks to `@syohex (Syohei YOSHIDA) <https://github.com/syohex> `_ and
bug reporters.
2015-10-28 14:08:45 +00:00
2015-11-30 16:10:49 +00:00
* Fixed out-of-tree documentation build
2016-04-28 13:45:50 +00:00
(`#177 <https://github.com/fmtlib/fmt/issues/177> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf> `_ .
2015-10-30 13:56:07 +00:00
2015-11-30 16:10:49 +00:00
Fixes
~~~~~
2015-10-30 13:56:07 +00:00
2015-11-30 16:10:49 +00:00
* Fixed `` initializer_list `` detection
2016-04-28 13:45:50 +00:00
(`#136 <https://github.com/fmtlib/fmt/issues/136> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@Gachapen (Magnus Bjerke Vik) <https://github.com/Gachapen> `_ .
2015-10-30 13:56:07 +00:00
2015-11-30 16:10:49 +00:00
* [Breaking] Fixed formatting of enums with numeric format specifiers in
`` fmt::(s)printf ``
2016-04-28 13:45:50 +00:00
(`#131 <https://github.com/fmtlib/fmt/issues/131> `_ ,
`#139 <https://github.com/fmtlib/fmt/issues/139> `_ ):
2015-10-30 13:45:56 +00:00
.. code :: c++
2015-11-30 16:10:49 +00:00
enum { ANSWER = 42 };
fmt::printf("%d", ANSWER);
2015-10-27 14:03:42 +00:00
2015-11-30 16:10:49 +00:00
Thanks to `@Naios <https://github.com/Naios> `_ .
2015-10-27 14:03:42 +00:00
2015-11-30 16:10:49 +00:00
* Improved compatibility with old versions of MinGW
2016-04-28 13:45:50 +00:00
(`#129 <https://github.com/fmtlib/fmt/issues/129> `_ ,
`#130 <https://github.com/fmtlib/fmt/pull/130> `_ ,
`#132 <https://github.com/fmtlib/fmt/issues/132> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@cstamford (Christopher Stamford) <https://github.com/cstamford> `_ .
2015-10-28 15:00:25 +00:00
2015-11-30 16:10:49 +00:00
* Fixed a compile error on MSVC with disabled exceptions
2016-04-28 13:45:50 +00:00
(`#144 <https://github.com/fmtlib/fmt/issues/144> `_ ).
2015-10-23 15:15:45 +00:00
2015-11-30 16:10:49 +00:00
* Added a workaround for broken implementation of variadic templates in MSVC2012
2016-04-28 13:45:50 +00:00
(`#148 <https://github.com/fmtlib/fmt/issues/148> `_ ).
2015-10-23 15:15:45 +00:00
2015-11-30 16:10:49 +00:00
* Placed the anonymous namespace within `` fmt `` namespace for the header-only
configuration
2016-04-28 13:45:50 +00:00
(`#171 <https://github.com/fmtlib/fmt/issues/171> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@alfps (Alf P. Steinbach) <https://github.com/alfps> `_ .
2015-10-23 15:04:00 +00:00
2015-11-30 16:10:49 +00:00
* Fixed issues reported by Coverity Scan
2016-04-28 13:45:50 +00:00
(`#187 <https://github.com/fmtlib/fmt/issues/187> `_ ,
`#192 <https://github.com/fmtlib/fmt/issues/192> `_ ).
2015-10-23 14:23:54 +00:00
2015-10-23 15:15:45 +00:00
* Implemented a workaround for a name lookup bug in MSVC2010
2016-04-28 13:45:50 +00:00
(`#188 <https://github.com/fmtlib/fmt/issues/188> `_ ).
2015-10-23 14:20:54 +00:00
2015-10-30 13:45:56 +00:00
* Fixed compiler warnings
2016-04-28 13:45:50 +00:00
(`#95 <https://github.com/fmtlib/fmt/issues/95> `_ ,
`#96 <https://github.com/fmtlib/fmt/issues/96> `_ ,
`#114 <https://github.com/fmtlib/fmt/pull/114> `_ ,
`#135 <https://github.com/fmtlib/fmt/issues/135> `_ ,
`#142 <https://github.com/fmtlib/fmt/issues/142> `_ ,
`#145 <https://github.com/fmtlib/fmt/issues/145> `_ ,
`#146 <https://github.com/fmtlib/fmt/issues/146> `_ ,
`#158 <https://github.com/fmtlib/fmt/issues/158> `_ ,
`#163 <https://github.com/fmtlib/fmt/issues/163> `_ ,
`#175 <https://github.com/fmtlib/fmt/issues/175> `_ ,
`#190 <https://github.com/fmtlib/fmt/issues/190> `_ ,
`#191 <https://github.com/fmtlib/fmt/pull/191> `_ ,
`#194 <https://github.com/fmtlib/fmt/issues/194> `_ ,
`#196 <https://github.com/fmtlib/fmt/pull/196> `_ ,
`#216 <https://github.com/fmtlib/fmt/issues/216> `_ ,
`#218 <https://github.com/fmtlib/fmt/pull/218> `_ ,
`#220 <https://github.com/fmtlib/fmt/pull/220> `_ ,
`#229 <https://github.com/fmtlib/fmt/pull/229> `_ ,
`#233 <https://github.com/fmtlib/fmt/issues/233> `_ ,
`#234 <https://github.com/fmtlib/fmt/issues/234> `_ ,
2016-05-07 14:50:56 +00:00
`#236 <https://github.com/fmtlib/fmt/pull/236> `_ ,
`#281 <https://github.com/fmtlib/fmt/issues/281> `_ ,
`#289 <https://github.com/fmtlib/fmt/issues/289> `_ ).
2015-11-30 15:22:51 +00:00
Thanks to `@seanmiddleditch (Sean Middleditch) <https://github.com/seanmiddleditch> `_ ,
`@dixlorenz (Dix Lorenz) <https://github.com/dixlorenz> `_ ,
2015-12-01 15:20:33 +00:00
`@CarterLi (李通洲) <https://github.com/CarterLi> `_ ,
2015-11-30 15:22:51 +00:00
`@Naios <https://github.com/Naios> `_ ,
2015-10-29 13:28:51 +00:00
`@fmatthew5876 (Matthew Fioravante) <https://github.com/fmatthew5876> `_ ,
2015-10-28 15:13:36 +00:00
`@LevskiWeng (Levski Weng) <https://github.com/LevskiWeng> `_ ,
2015-10-28 14:08:45 +00:00
`@rpopescu <https://github.com/rpopescu> `_ ,
2015-10-30 13:24:36 +00:00
`@gabime (Gabi Melman) <https://github.com/gabime> `_ ,
2015-11-30 16:10:49 +00:00
`@cubicool (Jeremy Moles) <https://github.com/cubicool> `_ ,
`@jkflying (Julian Kent) <https://github.com/jkflying> `_ ,
2015-12-01 15:20:33 +00:00
`@LogicalKnight (Sean L) <https://github.com/LogicalKnight> `_ ,
`@inguin (Ingo van Lil) <https://github.com/inguin> `_ and
`@Jopie64 (Johan) <https://github.com/Jopie64> `_ .
2015-10-23 14:09:26 +00:00
2015-10-30 14:35:18 +00:00
* Fixed portability issues (mostly causing test failures) on ARM, ppc64, ppc64le,
s390x and SunOS 5.11 i386 (
2016-04-28 13:45:50 +00:00
`#138 <https://github.com/fmtlib/fmt/issues/138> `_ ,
`#179 <https://github.com/fmtlib/fmt/issues/179> `_ ,
`#180 <https://github.com/fmtlib/fmt/issues/180> `_ ,
`#202 <https://github.com/fmtlib/fmt/issues/202> `_ ,
`#225 <https://github.com/fmtlib/fmt/issues/225> `_ ,
2015-10-23 14:10:24 +00:00
`Red Hat Bugzilla Bug 1260297 <https://bugzilla.redhat.com/show_bug.cgi?id=1260297> `_ ).
2015-10-30 14:35:18 +00:00
Thanks to `@Naios <https://github.com/Naios> `_ ,
`@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf> `_ and Dave Johansen.
2015-10-23 14:00:45 +00:00
2015-10-23 13:52:12 +00:00
* Fixed a name conflict with macro `` free `` defined in
`` crtdbg.h `` when `` _CRTDBG_MAP_ALLOC `` is set
2016-04-28 13:45:50 +00:00
(`#211 <https://github.com/fmtlib/fmt/issues/211> `_ ).
2015-10-23 13:52:12 +00:00
2015-10-29 15:24:31 +00:00
* Fixed shared library build on OS X
2016-04-28 13:45:50 +00:00
(`#212 <https://github.com/fmtlib/fmt/pull/212> `_ ).
2015-10-29 15:24:31 +00:00
Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d> `_ .
2015-10-29 13:44:51 +00:00
* Fixed an overload conflict on MSVC when `` /Zc:wchar_t- `` option is specified
2016-04-28 13:45:50 +00:00
(`#214 <https://github.com/fmtlib/fmt/pull/214> `_ ).
2015-10-25 15:58:05 +00:00
Thanks to `@slavanap (Vyacheslav Napadovsky) <https://github.com/slavanap> `_ .
2015-12-01 15:20:33 +00:00
* Improved compatibility with MSVC 2008
2016-04-28 13:45:50 +00:00
(`#236 <https://github.com/fmtlib/fmt/pull/236> `_ ).
2015-12-01 15:20:33 +00:00
Thanks to `@Jopie64 (Johan) <https://github.com/Jopie64> `_ .
2015-11-30 15:22:51 +00:00
* Improved compatibility with bcc32
2016-04-28 13:45:50 +00:00
(`#227 <https://github.com/fmtlib/fmt/issues/227> `_ ).
2015-11-30 15:22:51 +00:00
2015-11-30 16:10:49 +00:00
* Fixed `` static_assert `` detection on Clang
2016-04-28 13:45:50 +00:00
(`#228 <https://github.com/fmtlib/fmt/pull/228> `_ ).
2015-11-30 16:10:49 +00:00
Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d> `_ .
2015-11-30 15:22:51 +00:00
2015-03-06 16:33:25 +00:00
1.1.0 - 2015-03-06
------------------
2015-03-06 15:18:44 +00:00
2015-03-06 16:14:19 +00:00
* Added `` BasicArrayWriter `` , a class template that provides operations for
formatting and writing data into a fixed-size array
2016-04-28 13:45:50 +00:00
(`#105 <https://github.com/fmtlib/fmt/issues/105> `_ and
`#122 <https://github.com/fmtlib/fmt/issues/122> `_ ):
2015-03-06 16:14:19 +00:00
.. code :: c++
char buffer[100];
fmt::ArrayWriter w(buffer);
w.write("The answer is {}", 42);
2015-03-06 15:32:28 +00:00
* Added `0 A.D. <http://play0ad.com/> `_ and `PenUltima Online (POL)
<http://www.polserver.com/>`_ to the list of notable projects using C++ Format.
2015-03-06 15:18:44 +00:00
2015-03-06 16:03:11 +00:00
* C++ Format now uses MSVC intrinsics for better formatting performance
2016-04-28 13:45:50 +00:00
(`#115 <https://github.com/fmtlib/fmt/pull/115> `_ ,
`#116 <https://github.com/fmtlib/fmt/pull/116> `_ ,
`#118 <https://github.com/fmtlib/fmt/pull/118> `_ and
`#121 <https://github.com/fmtlib/fmt/pull/121> `_ ).
2015-03-06 15:52:06 +00:00
Previously these optimizations where only used on GCC and Clang.
2015-03-06 16:03:11 +00:00
Thanks to `@CarterLi <https://github.com/CarterLi> `_ and
`@objectx <https://github.com/objectx> `_ .
2016-04-28 13:45:50 +00:00
* CMake install target (`#119 <https://github.com/fmtlib/fmt/pull/119> `_ ).
2015-03-06 16:03:11 +00:00
Thanks to `@TrentHouliston <https://github.com/TrentHouliston> `_ .
You can now install C++ Format with `` make install `` command.
2015-03-06 15:52:06 +00:00
2015-03-06 15:18:44 +00:00
* Improved `Biicode <http://www.biicode.com/> `_ support
2016-04-28 13:45:50 +00:00
(`#98 <https://github.com/fmtlib/fmt/pull/98> `_ and
`#104 <https://github.com/fmtlib/fmt/pull/104> `_ ). Thanks to
2015-03-06 15:18:44 +00:00
`@MariadeAnton <https://github.com/MariadeAnton> `_ and
`@franramirez688 <https://github.com/franramirez688> `_ .
2016-05-01 10:29:21 +00:00
* Improved support for building with `Android NDK
2015-03-06 15:32:28 +00:00
<https://developer.android.com/tools/sdk/ndk/index.html>`_
2016-04-28 13:45:50 +00:00
(`#107 <https://github.com/fmtlib/fmt/pull/107> `_ ).
2015-03-06 15:32:28 +00:00
Thanks to `@newnon <https://github.com/newnon> `_ .
2016-04-28 13:45:50 +00:00
The `android-ndk-example <https://github.com/fmtlib/android-ndk-example> `_
2015-03-06 15:32:28 +00:00
repository provides and example of using C++ Format with Android NDK:
2016-04-28 13:45:50 +00:00
.. image :: https://raw.githubusercontent.com/fmtlib/android-ndk-example/
2015-03-06 15:32:28 +00:00
master/screenshot.png
* Improved documentation of `` SystemError `` and `` WindowsError ``
2016-04-28 13:45:50 +00:00
(`#54 <https://github.com/fmtlib/fmt/issues/54> `_ ).
2015-03-06 15:18:44 +00:00
2015-03-06 15:52:06 +00:00
* Various code improvements
2016-04-28 13:45:50 +00:00
(`#110 <https://github.com/fmtlib/fmt/pull/110> `_ ,
`#111 <https://github.com/fmtlib/fmt/pull/111> `_
`#112 <https://github.com/fmtlib/fmt/pull/112> `_ ).
2015-03-06 15:52:06 +00:00
Thanks to `@CarterLi <https://github.com/CarterLi> `_ .
2015-03-06 16:03:11 +00:00
* Improved compile-time errors when formatting wide into narrow strings
2016-04-28 13:45:50 +00:00
(`#117 <https://github.com/fmtlib/fmt/issues/117> `_ ).
2015-03-06 16:03:11 +00:00
2015-03-06 15:52:06 +00:00
* Fixed `` BasicWriter::write `` without formatting arguments when C++11 support
2016-04-28 13:45:50 +00:00
is disabled (`#109 <https://github.com/fmtlib/fmt/issues/109> `_ ).
2015-03-06 15:52:06 +00:00
2015-03-06 16:14:19 +00:00
* Fixed header-only build on OS X with GCC 4.9
2016-04-28 13:45:50 +00:00
(`#124 <https://github.com/fmtlib/fmt/issues/124> `_ ).
2015-03-06 16:14:19 +00:00
2016-04-28 13:45:50 +00:00
* Fixed packaging issues (`#94 <https://github.com/fmtlib/fmt/issues/94> `_ ).
2015-03-06 15:18:44 +00:00
2016-04-28 13:45:50 +00:00
* Added `changelog <https://github.com/fmtlib/fmt/blob/master/ChangeLog.rst> `_
(`#103 <https://github.com/fmtlib/fmt/issues/103> `_ ).
2015-03-06 16:14:19 +00:00
2015-03-05 16:04:27 +00:00
1.0.0 - 2015-02-05
------------------
* Add support for a header-only configuration when `` FMT_HEADER_ONLY `` is
defined before including `` format.h `` :
.. code :: c++
#define FMT_HEADER_ONLY
#include "format.h"
* Compute string length in the constructor of `` BasicStringRef ``
instead of the `` size `` method
2016-04-28 13:45:50 +00:00
(`#79 <https://github.com/fmtlib/fmt/issues/79> `_ ).
2015-03-05 16:04:27 +00:00
This eliminates size computation for string literals on reasonable optimizing
compilers.
* Fix formatting of types with overloaded `` operator << `` for `` std::wostream ``
2016-04-28 13:45:50 +00:00
(`#86 <https://github.com/fmtlib/fmt/issues/86> `_ ):
2015-03-05 16:04:27 +00:00
.. code :: c++
fmt::format(L"The date is {0}", Date(2012, 12, 9));
* Fix linkage of tests on Arch Linux
2016-04-28 13:45:50 +00:00
(`#89 <https://github.com/fmtlib/fmt/issues/89> `_ ).
2015-03-05 16:04:27 +00:00
* Allow precision specifier for non-float arguments
2016-04-28 13:45:50 +00:00
(`#90 <https://github.com/fmtlib/fmt/issues/90> `_ ):
2015-03-05 16:04:27 +00:00
.. code :: c++
fmt::print("{:.3}\n", "Carpet"); // prints "Car"
* Fix build on Android NDK
2016-04-28 13:45:50 +00:00
(`#93 <https://github.com/fmtlib/fmt/issues/93> `_ )
2015-03-05 16:04:27 +00:00
* Improvements to documentation build procedure.
* Remove `` FMT_SHARED `` CMake variable in favor of standard `BUILD_SHARED_LIBS
<http://www.cmake.org/cmake/help/v3.0/variable/BUILD_SHARED_LIBS.html>`_.
* Fix error handling in `` fmt::fprintf `` .
* Fix a number of warnings.
2015-03-05 15:26:44 +00:00
0.12.0 - 2014-10-25
-------------------
* [Breaking] Improved separation between formatting and buffer management.
`` Writer `` is now a base class that cannot be instantiated directly.
The new `` MemoryWriter `` class implements the default buffer management
with small allocations done on stack. So `` fmt::Writer `` should be replaced
with `` fmt::MemoryWriter `` in variable declarations.
Old code:
.. code :: c++
fmt::Writer w;
New code:
.. code :: c++
fmt::MemoryWriter w;
If you pass `` fmt::Writer `` by reference, you can continue to do so:
.. code :: c++
void f(fmt::Writer &w);
This doesn't affect the formatting API.
* Support for custom memory allocators
2016-04-28 13:45:50 +00:00
(`#69 <https://github.com/fmtlib/fmt/issues/69> `_ )
2015-03-05 15:26:44 +00:00
* Formatting functions now accept `signed char` and `unsigned char` strings as
2016-04-28 13:45:50 +00:00
arguments (`#73 <https://github.com/fmtlib/fmt/issues/73> `_ ):
2015-03-05 15:26:44 +00:00
.. code :: c++
auto s = format("GLSL version: {}", glGetString(GL_VERSION));
* Reduced code bloat. According to the new `benchmark results
2016-04-28 13:45:50 +00:00
<https://github.com/fmtlib/fmt#compile-time-and-code-bloat>`_,
2015-03-05 15:26:44 +00:00
cppformat is close to `` printf `` and by the order of magnitude better than
Boost Format in terms of compiled code size.
2015-03-05 15:31:27 +00:00
* Improved appearance of the documentation on mobile by using the `Sphinx
Bootstrap theme <http://ryan-roemer.github.io/sphinx-bootstrap-theme/>`_:
2015-03-05 15:26:44 +00:00
2015-03-05 16:15:26 +00:00
.. |old| image :: https://cloud.githubusercontent.com/assets/576385/4792130/
cd256436-5de3-11e4-9a62-c077d0c2b003.png
2015-03-05 15:29:54 +00:00
2015-03-05 16:15:26 +00:00
.. |new| image :: https://cloud.githubusercontent.com/assets/576385/4792131/
cd29896c-5de3-11e4-8f59-cac952942bf0.png
2015-03-05 15:29:54 +00:00
+-------+-------+
| Old | New |
+-------+-------+
| |old| | |new| |
+-------+-------+
2015-03-05 15:26:44 +00:00
2015-03-05 02:49:23 +00:00
0.11.0 - 2014-08-21
-------------------
* Safe printf implementation with a POSIX extension for positional arguments:
.. code :: c++
fmt::printf("Elapsed time: %.2f seconds", 1.23);
fmt::printf("%1$s, %3$d %2$s", weekday, month, day);
2015-03-05 03:02:59 +00:00
* Arguments of `` char `` type can now be formatted as integers
2016-04-28 13:45:50 +00:00
(Issue `#55 <https://github.com/fmtlib/fmt/issues/55> `_ ):
2015-03-05 02:49:23 +00:00
.. code :: c++
fmt::format("0x{0:02X}", 'a');
* Deprecated parts of the API removed.
* The library is now built and tested on MinGW with Appveyor in addition to
existing test platforms Linux/GCC, OS X/Clang, Windows/MSVC.
2015-03-05 02:30:00 +00:00
0.10.0 - 2014-07-01
-------------------
**Improved API**
* All formatting methods are now implemented as variadic functions instead
of using `` operator<< `` for feeding arbitrary arguments into a temporary
formatter object. This works both with C++11 where variadic templates are
used and with older standards where variadic functions are emulated by
providing lightweight wrapper functions defined with the `` FMT_VARIADIC ``
macro. You can use this macro for defining your own portable variadic
functions:
.. code :: c++
void report_error(const char *format, const fmt::ArgList &args) {
fmt::print("Error: {}");
fmt::print(format, args);
}
FMT_VARIADIC(void, report_error, const char *)
report_error("file not found: {}", path);
Apart from a more natural syntax, this also improves performance as there
is no need to construct temporary formatter objects and control arguments'
2016-05-01 10:29:21 +00:00
lifetimes. Because the wrapper functions are very lightweight, this doesn't
2015-03-05 02:30:00 +00:00
cause code bloat even in pre-C++11 mode.
* Simplified common case of formatting an `` std::string `` . Now it requires a
single function call:
.. code :: c++
std::string s = format("The answer is {}.", 42);
Previously it required 2 function calls:
.. code :: c++
std::string s = str(Format("The answer is {}.") << 42);
Instead of unsafe `` c_str `` function, `` fmt::Writer `` should be used directly
to bypass creation of `` std::string `` :
.. code :: c++
fmt::Writer w;
w.write("The answer is {}.", 42);
w.c_str(); // returns a C string
This doesn't do dynamic memory allocation for small strings and is less error
prone as the lifetime of the string is the same as for `` std::string::c_str ``
which is well understood (hopefully).
* Improved consistency in naming functions that are a part of the public API.
Now all public functions are lowercase following the standard library
conventions. Previously it was a combination of lowercase and
2015-03-05 03:02:59 +00:00
CapitalizedWords.
2016-04-28 13:45:50 +00:00
Issue `#50 <https://github.com/fmtlib/fmt/issues/50> `_ .
2015-03-05 02:30:00 +00:00
* Old functions are marked as deprecated and will be removed in the next
release.
**Other Changes**
* Experimental support for printf format specifications (work in progress):
.. code :: c++
fmt::printf("The answer is %d.", 42);
std::string s = fmt::sprintf("Look, a %s!", "string");
* Support for hexadecimal floating point format specifiers `` a `` and `` A `` :
.. code :: c++
print("{:a}", -42.0); // Prints -0x1.5p+5
print("{:A}", -42.0); // Prints -0X1.5P+5
* CMake option `` FMT_SHARED `` that specifies whether to build format as a
shared library (off by default).
2015-03-05 02:10:08 +00:00
0.9.0 - 2014-05-13
------------------
* More efficient implementation of variadic formatting functions.
2015-03-05 02:16:26 +00:00
* `` Writer::Format `` now has a variadic overload:
.. code :: c++
2015-03-05 02:10:08 +00:00
Writer out;
out.Format("Look, I'm {}!", "variadic");
* For efficiency and consistency with other overloads, variadic overload of
2015-03-05 02:16:26 +00:00
the `` Format `` function now returns `` Writer `` instead of `` std::string `` .
Use the `` str `` function to convert it to `` std::string `` :
.. code :: c++
2015-03-05 02:10:08 +00:00
std::string s = str(Format("Look, I'm {}!", "variadic"));
2015-03-05 02:16:26 +00:00
* Replaced formatter actions with output sinks: `` NoAction `` -> `` NullSink `` ,
`` Write `` -> `` FileSink `` , `` ColorWriter `` -> `` ANSITerminalSink `` .
This improves naming consistency and shouldn't affect client code unless
these classes are used directly which should be rarely needed.
* Added `` ThrowSystemError `` function that formats a message and throws
`` SystemError `` containing the formatted message and system-specific error
description. For example, the following code
2015-03-05 02:10:08 +00:00
2015-03-05 02:16:26 +00:00
.. code :: c++
2015-03-05 02:10:08 +00:00
FILE *f = fopen(filename, "r");
if (!f)
ThrowSystemError(errno, "Failed to open file '{}'") << filename;
2015-03-05 02:16:26 +00:00
will throw `` SystemError `` exception with description
2015-03-05 02:10:08 +00:00
"Failed to open file '<filename>': No such file or directory" if file
doesn't exist.
2015-03-05 02:49:23 +00:00
* Support for AppVeyor continuous integration platform.
2015-03-05 02:10:08 +00:00
2015-03-05 02:16:26 +00:00
* `` Format `` now throws `` SystemError `` in case of I/O errors.
2015-03-05 02:10:08 +00:00
* Improve test infrastructure. Print functions are now tested by redirecting
the output to a pipe.
0.8.0 - 2014-04-14
------------------
* Initial release