| I/O manipulators | ||||
| Print functions(C++23) | ||||
| C-style I/O | ||||
| Buffers | ||||
(C++23) | ||||
(C++98/26*) | ||||
(C++20) | ||||
| Streams | ||||
| Abstractions | ||||
| File I/O | ||||
| String I/O | ||||
| Array I/O | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++98/26*) | ||||
(C++98/26*) | ||||
(C++98/26*) | ||||
| Synchronized Output | ||||
(C++20) | ||||
| Types | ||||
| Error category interface | ||||
(C++11) | ||||
(C++11) |
| Global objects | ||||
| Member functions | ||||
(C++11) | ||||
| Formatted output | ||||
| Unformatted output | ||||
| Positioning | ||||
| Miscellaneous | ||||
(C++11) | ||||
| Member classes | ||||
| Non-member functions | ||||
print(std::ostream) (C++23) | ||||
(C++23) | ||||
(C++23) | ||||
Defined in header <ostream> | ||
template<class...Args> void print(std::ostream& os,std::format_string<Args...> fmt, Args&&...args); | (since C++23) | |
Formatsargs according to the format stringfmt, and inserts the result intoos stream.
If theordinary literal encoding is UTF-8, equivalent to:
The behavior is undefined ifstd::formatter<Ti,char> does not meet theBasicFormatter requirements for anyTi inArgs (as required bystd::make_format_args).
Contents |
| os | - | output stream to insert data into | ||||||||||||||||||||||||||||||||||||||||||||||
| fmt | - | an object that represents the format string. The format string consists of
Each replacement field has the following format:
1) replacement field without a format specification 2) replacement field with a format specification
| ||||||||||||||||||||||||||||||||||||||||||||||
| args... | - | arguments to be formatted | ||||||||||||||||||||||||||||||||||||||||||||||
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_print | 202207L | (C++23) | Formatted output |
__cpp_lib_format | 202207L | (C++23) | Exposingstd::basic_format_string |
#include <array>#include <cctype>#include <cstdio>#include <format>#include <numbers>#include <ranges>#include <sstream> int main(){std::array<char,24> buf;std::format_to(buf.begin(),"{:.15f}",std::numbers::sqrt2); unsigned num{}, sum{}; for(auto n: buf| std::views::filter(isdigit)| std::views::transform([](char x){return x-'0';})| std::views::take_while([&sum](char){return sum<42;})) sum+= n,++num; std::stringstream stream; #ifdef __cpp_lib_printstd::print(stream,#else stream<<std::format(#endif"√2\N{ALMOST EQUAL TO} {0}.\n""The sum of its first {1} digits is {2}.",std::numbers::sqrt2, num, sum); std::puts(stream.str().data());}
Output:
√2 ≈ 1.4142135623730951.The sum of its first 13 digits is 42.
(C++23) | outputsformatted representation of the arguments with appended'\n' (function template)[edit] |
(C++23) | prints tostdout or a file stream usingformatted representation of the arguments (function template)[edit] |
(C++20) | stores formatted representation of the arguments in a new string (function template)[edit] |