fmt/ChangeLog.rst

901 lines
33 KiB
ReStructuredText
Raw Normal View History

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``.
* 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-05-08 14:27:41 +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