Top Related Projects
Fast C++ logging library.
Abseil Common Libraries (C++)
An open-source C++ library developed and used at Facebook.
C++ implementation of the Google logging module
JSON for Modern C++
Quick Overview
fmt is a modern formatting library for C++ that provides a fast and safe alternative to C stdio and C++ iostreams. It offers simple and efficient string formatting with a Python-like syntax, type-safe format string compilation, and support for user-defined types.
Pros
- Fast and efficient performance, often outperforming traditional C++ I/O methods
- Type-safe and compile-time checked format strings
- Easy-to-use API with Python-like syntax
- Extensive support for various data types and customization options
Cons
- Requires C++11 or later, which may not be available in all environments
- Adds an external dependency to projects
- Learning curve for developers accustomed to traditional C++ I/O methods
Code Examples
- Basic string formatting:
#include <fmt/core.h>
std::string name = "Alice";
int age = 30;
std::string result = fmt::format("My name is {} and I'm {} years old.", name, age);
- Positional arguments and named arguments:
#include <fmt/core.h>
std::string result = fmt::format("The {1} in the {0} says {2}.", "hat", "cat", "meow");
result = fmt::format("I am {age} years old and my name is {name}.", fmt::arg("name", "Bob"), fmt::arg("age", 25));
- Custom type formatting:
#include <fmt/format.h>
struct Point {
int x, y;
};
template <> struct fmt::formatter<Point> {
constexpr auto parse(format_parse_context& ctx) -> decltype(ctx.begin()) {
return ctx.begin();
}
template <typename FormatContext>
auto format(const Point& p, FormatContext& ctx) -> decltype(ctx.out()) {
return fmt::format_to(ctx.out(), "({}, {})", p.x, p.y);
}
};
Point p{1, 2};
std::string result = fmt::format("The point is: {}", p);
Getting Started
To use fmt in your project:
- Install fmt using a package manager or download it from GitHub.
- Include the necessary headers in your C++ file:
#include <fmt/core.h>
// For extended functionality:
// #include <fmt/format.h>
- Link against the fmt library when compiling.
- Use the
fmt::formatfunction or other fmt features in your code:
#include <fmt/core.h>
#include <iostream>
int main() {
std::string message = fmt::format("Hello, {}!", "World");
std::cout << message << std::endl;
return 0;
}
Competitor Comparisons
Fast C++ logging library.
Pros of spdlog
- Comprehensive logging framework with built-in asynchronous logging and file rotation
- Supports multiple sinks (console, file, syslog, etc.) out of the box
- Includes a thread-safe logger registry for easy management of multiple loggers
Cons of spdlog
- Slightly higher memory footprint due to additional features
- May have a steeper learning curve for users who only need basic formatting
Code Comparison
spdlog:
#include "spdlog/spdlog.h"
spdlog::info("Welcome to spdlog!");
spdlog::error("An error message with arg: {}", 1);
fmt:
#include <fmt/core.h>
fmt::print("Welcome to fmt!\n");
fmt::print(stderr, "An error message with arg: {}\n", 1);
Both libraries offer similar formatting syntax, but spdlog provides additional logging-specific features. fmt focuses on string formatting and I/O, while spdlog builds upon fmt's functionality to offer a complete logging solution.
spdlog is ideal for projects requiring a full-featured logging system, whereas fmt is better suited for general string formatting and I/O operations. The choice between the two depends on the specific needs of your project.
Abseil Common Libraries (C++)
Pros of abseil-cpp
- Broader scope: Offers a wide range of utilities beyond string formatting
- Google-backed: Developed and maintained by Google, ensuring high quality and long-term support
- Seamless integration: Designed to work well with other Google libraries and projects
Cons of abseil-cpp
- Steeper learning curve: More complex due to its broader scope
- Larger footprint: Includes many components, which may increase binary size
- Less specialized: String formatting is just one of many features, potentially less optimized than fmt
Code Comparison
fmt:
#include <fmt/core.h>
std::string s = fmt::format("Hello, {}!", "world");
abseil-cpp:
#include "absl/strings/str_format.h"
std::string s = absl::StrFormat("Hello, %s!", "world");
Both libraries provide similar functionality for string formatting, but fmt uses a more modern syntax with curly braces, while abseil-cpp uses printf-style format specifiers. fmt is generally considered more type-safe and easier to use for string formatting specifically, while abseil-cpp offers a broader set of utilities beyond just formatting.
An open-source C++ library developed and used at Facebook.
Pros of Folly
- Broader scope: Folly is a comprehensive C++ library with a wide range of utilities and components
- Performance-oriented: Designed for high-performance applications at scale
- Active development: Regularly updated with new features and optimizations
Cons of Folly
- Steeper learning curve: More complex due to its extensive feature set
- Larger footprint: Heavier library compared to fmt's focused approach
- Potential overkill: May be excessive for projects only needing formatting capabilities
Code Comparison
fmt:
#include <fmt/core.h>
std::string s = fmt::format("Hello, {}!", "world");
Folly:
#include <folly/Format.h>
std::string s = folly::format("Hello, {}!", "world").str();
Both libraries offer similar formatting functionality, but Folly provides a broader set of utilities beyond just formatting. fmt is more focused and lightweight, making it easier to integrate for specific formatting needs. Folly, on the other hand, offers a comprehensive suite of tools for large-scale C++ development, which may be beneficial for more complex projects but could be overwhelming for simpler applications.
C++ implementation of the Google logging module
Pros of glog
- More comprehensive logging system with severity levels and conditional logging
- Includes additional features like stack trace logging and crash handling
- Better integration with Google's ecosystem of tools and libraries
Cons of glog
- Heavier and more complex than fmt, which may be overkill for simpler projects
- Less focus on formatting capabilities compared to fmt
- Slower compilation times due to its larger codebase
Code Comparison
glog:
#include <glog/logging.h>
int main(int argc, char* argv[]) {
google::InitGoogleLogging(argv[0]);
LOG(INFO) << "Hello, World!";
return 0;
}
fmt:
#include <fmt/core.h>
int main() {
fmt::print("Hello, {}!\n", "World");
return 0;
}
glog provides a more structured logging approach with severity levels, while fmt focuses on efficient and flexible string formatting. glog is better suited for larger projects requiring comprehensive logging, whereas fmt is ideal for projects needing fast and simple formatting capabilities.
JSON for Modern C++
Pros of json
- Specialized for JSON parsing and manipulation
- Extensive JSON-specific features (e.g., serialization, deserialization)
- Intuitive API for working with JSON data structures
Cons of json
- Limited to JSON-related operations
- Larger library size compared to fmt
- May have slower performance for simple string operations
Code Comparison
json:
#include <nlohmann/json.hpp>
using json = nlohmann::json;
json j = {{"name", "John"}, {"age", 30}};
std::string serialized = j.dump();
fmt:
#include <fmt/core.h>
std::string name = "John";
int age = 30;
std::string formatted = fmt::format("Name: {}, Age: {}", name, age);
Summary
While json excels in JSON-specific tasks, fmt is a more general-purpose formatting library. json offers robust JSON handling but may be overkill for simple string operations. fmt provides efficient and type-safe formatting for various data types but lacks JSON-specific features. Choose json for JSON-centric projects and fmt for general string formatting and output needs.
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
{fmt} is an open-source formatting library providing a fast and safe alternative to C stdio and C++ iostreams.
Q&A: ask questions on StackOverflow with the tag fmt.
Try {fmt} in Compiler Explorer.
Features
- Simple format API with positional arguments for localization
- Implementation of C++20 std::format and C++23 std::print
- Format string syntax similar to Python's format
- Fast IEEE 754 floating-point formatter with correct rounding, shortness and round-trip guarantees using the Dragonbox algorithm
- Portable Unicode support
- Safe printf implementation including the POSIX extension for positional arguments
- Extensibility: support for user-defined types
- High performance: faster than common standard library
implementations of
(s)printf, iostreams,to_stringandto_chars, see Speed tests and Converting a hundred million integers to strings per second - Small code size both in terms of source code with the minimum
configuration consisting of just three files,
base.h,format.handformat-inl.h, and compiled code; see Compile time and code bloat - Reliability: the library has an extensive set of tests and is continuously fuzzed
- Safety: the library is fully type-safe, errors in format strings can be reported at compile time, automatic memory management prevents buffer overflow errors
- Ease of use: small self-contained code base, no external dependencies, permissive MIT license
- Portability with consistent output across platforms and support for older compilers
- Clean warning-free codebase even on high warning levels such as
-Wall -Wextra -pedantic - Locale independence by default
- Optional header-only configuration enabled with the
FMT_HEADER_ONLYmacro
See the documentation for more details.
Examples
Print to stdout (run)
#include <fmt/base.h>
int main() {
fmt::print("Hello, world!\n");
}
Format a string (run)
std::string s = fmt::format("The answer is {}.", 42);
// s == "The answer is 42."
Format a string using positional arguments (run)
std::string s = fmt::format("I'd rather be {1} than {0}.", "right", "happy");
// s == "I'd rather be happy than right."
Print dates and times (run)
#include <fmt/chrono.h>
int main() {
auto now = std::chrono::system_clock::now();
fmt::print("Date and time: {}\n", now);
fmt::print("Time: {:%H:%M}\n", now);
}
Output:
Date and time: 2023-12-26 19:10:31.557195597
Time: 19:10
Print a container (run)
#include <vector>
#include <fmt/ranges.h>
int main() {
std::vector<int> v = {1, 2, 3};
fmt::print("{}\n", v);
}
Output:
[1, 2, 3]
Check a format string at compile time
std::string s = fmt::format("{:d}", "I am not a number");
This gives a compile-time error in C++20 because d is an invalid
format specifier for a string.
Write a file from a single thread
#include <fmt/os.h>
int main() {
auto out = fmt::output_file("guide.txt");
out.print("Don't {}", "Panic");
}
This can be up to 9 times faster than fprintf.
Print with colors and text styles
#include <fmt/color.h>
int main() {
fmt::print(fg(fmt::color::crimson) | fmt::emphasis::bold,
"Hello, {}!\n", "world");
fmt::print(fg(fmt::color::floral_white) | bg(fmt::color::slate_gray) |
fmt::emphasis::underline, "Olá, {}!\n", "Mundo");
fmt::print(fg(fmt::color::steel_blue) | fmt::emphasis::italic,
"ä½ å¥½{}ï¼\n", "ä¸ç");
}
Output on a modern terminal with Unicode support:
Performance
{fmt} can be tens of percent to 20â30 times faster than sprintf and
iostreams, especially for numeric formatting. It minimizes dynamic memory
allocations and can optionally compile format strings into efficient formatting code.
See format-benchmark and dtoa-benchmark for benchmarks and methodology.
Time per double (smaller is better):
ostringstream and sprintf are omitted because they are an order of
magnitude slower than the other methods.
Compile time and code bloat
The script bloat-test.py from format-benchmark tests compile
time and code bloat for nontrivial projects. It generates 100 translation units
and uses printf() or its alternative five times in each to simulate a
medium-sized project. The resulting executable size and compile time on an
Apple M5 Max running macOS 26.6.2 with Apple Clang 21.0.0
(clang-2100.1.1.101), taking the best of three runs, are shown in the following
tables.
Optimized build (-O3)
| Method | Compile Time, s | Executable size, KiB | Stripped size, KiB |
|---|---|---|---|
| printf | 1.2 | 54 | 50 |
| IOStreams | 21.8 | 98 | 84 |
| {fmt} 12.2 | 4.2 | 54 | 50 |
| tinyformat | 25.5 | 164 | 136 |
| Boost Format 1.88 | 43.4 | 550 | 333 |
| stb_sprintf | 1.4 | 87 | 83 |
{fmt} is fast to compile and is comparable to printf in terms of per-call
binary size (within a rounding error on this system).
Non-optimized build
| Method | Compile Time, s | Executable size, KiB | Stripped size, KiB |
|---|---|---|---|
| printf | 1.1 | 54 | 50 |
| IOStreams | 20.7 | 88 | 68 |
| {fmt} 12.2 | 4.0 | 87 | 84 |
| tinyformat | 21.8 | 188 | 145 |
| Boost Format 1.88 | 30.0 | 749 | 430 |
| stb_sprintf | 1.2 | 103 | 99 |
libc, libc++, and libfmt were linked as shared libraries to compare
formatting function overhead only. tinyformat, Boost Format, and stb_sprintf
are header-only libraries.
Projects using {fmt}
Notable users include:
Top Related Projects
Fast C++ logging library.
Abseil Common Libraries (C++)
An open-source C++ library developed and used at Facebook.
C++ implementation of the Google logging module
JSON for Modern C++
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot