Difference between revisions of "cpp/io/basic ostream/println"
From cppreference.com
< cpp | io | basic ostream
m (→Exceptions: templitized) |
m (→Notes: ~FTM) |
||
| Line 30: | Line 30: | ||
===Notes=== | ===Notes=== | ||
| − | {{ftm begin|std=1|value=1}} | + | {{ftm begin|std=1|value=1|comment=1}} |
| − | {{ftm|std=C++23|value=202207L|__cpp_lib_print}} | + | {{ftm|std=C++23|value=202207L|__cpp_lib_print|Formatted output}} |
| − | {{ftm|std=C++23|value=202207L|__cpp_lib_format}} | + | {{ftm|std=C++23|value=202207L|__cpp_lib_format|Exposing {{lc|std::basic_format_string}}}} |
{{ftm end}} | {{ftm end}} | ||
Revision as of 05:04, 4 October 2022
| Defined in header <ostream>
|
||
| template< class... Args > void println( std::ostream& os, std::format_string<Args...> fmt, Args&&... args ); |
(since C++23) | |
Formats args according to the format string fmt with appended '\n' (which means that each output ends with a new-line), and inserts the result into os stream.
Equivalent to: std::print(os, "{}\n", std::format(fmt, std::forward<Args>(args)...));
The behavior is undefined if std::formatter<Ti, char> does not meet the BasicFormatter requirements for any Ti in Args (as required by std::make_format_args).
Contents |
Parameters
| os | - | output stream to insert data into | ||||||||||||||||||||||||||||||||||||||||||||||
| fmt | - |
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 | ||||||||||||||||||||||||||||||||||||||||||||||
Return value
(none)
Exceptions
- std::bad_alloc on allocation failure.
- Propagate any exception thrown by any formatter, e.g. std::format_error, without regard to the value of os.exceptions() and without turning on ios_base::badbit in the error state of os.
- May throw ios_base::failure caused by os.setstate(ios_base::badbit) which is called if an insertion into os fails.
Notes
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_print |
202207L | (C++23) | Formatted output |
__cpp_lib_format |
202207L | (C++23) | Exposing std::basic_format_string |
Example
| This section is incomplete Reason: no example |
See also
| (C++23) |
outputs formatted representation of the arguments (function template) |
| (C++23) |
same as std::print except that each print is terminated by additional new line (function template) |
| (C++20) |
stores formatted representation of the arguments in a new string (function template) |
