Namespaces
Variants

std:: print (std::ostream)

From cppreference.net
C++
Input/output library
std::basic_ostream
Definiert im Header <ostream>
template < class ... Args >
void print ( std:: ostream & os, std:: format_string < Args... > fmt, Args && ... args ) ;
(seit C++23)

Formatiert args gemäß der Formatzeichenkette fmt und fügt das Ergebnis in den os -Stream ein.

Wenn die ordinary literal encoding UTF-8 ist, entspricht dies:

Das Verhalten ist undefiniert, falls std:: formatter < Ti, char > nicht die BasicFormatter -Anforderungen für irgendein Ti in Args erfüllt (wie von std:: make_format_args gefordert).

Inhaltsverzeichnis

Parameter

os - Ausgabestrom, in den Daten eingefügt werden
fmt -
ein Objekt, das die Formatzeichenkette repräsentiert. Die Formatzeichenkette besteht aus
  • gewöhnlichen Zeichen (außer { und } ), die unverändert in die Ausgabe kopiert werden,
  • Escape-Sequenzen { { und } } , die in der Ausgabe durch { bzw. } ersetzt werden, und
  • Ersetzungsfeldern.

Jedes Ersetzungsfeld hat folgendes Format:

{ arg-id (optional) } (1)
{ arg-id (optional) : format-spec } (2)
1) Ersetzungsfeld ohne Formatangabe
2) Ersetzungsfeld mit Formatangabe
arg-id - gibt den Index des Arguments in args an, dessen Wert für die Formatierung verwendet wird; falls ausgelassen, werden die Argumente in Reihenfolge verwendet.

Die arg-id s in einer Formatzeichenkette müssen entweder alle angegeben oder alle ausgelassen werden. Das Vermischen von manueller und automatischer Indizierung ist ein Fehler.

format-spec - die Formatangabe, definiert durch die std::formatter -Spezialisierung für das entsprechende Argument. Darf nicht mit } beginnen.

(seit C++23)
(seit C++26)
  • Für andere formatierbare Typen wird die Formatangabe durch benutzerdefinierte formatter -Spezialisierungen bestimmt.
args... - zu formatierende Argumente

Exceptions

Hinweise

Feature-Test Makro Wert Std Feature
__cpp_lib_print 202207L (C++23) Formatierte Ausgabe
__cpp_lib_format 202207L (C++23) Verfügbarmachung von std::basic_format_string

Beispiel

Code ausführen 
#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_print
    std::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());
}

Ausgabe: 

√2 ≈ 1.4142135623730951.
The sum of its first 13 digits is 42.

Siehe auch

(C++23)
gibt eine formatierte Darstellung der Argumente mit angehängtem ' \n ' aus
(Funktionsschablone)
(C++23)
gibt auf stdout oder einen Dateistrom unter Verwendung einer formatierten Darstellung der Argumente aus
(Funktionsschablone)
(C++20)
speichert eine formatierte Darstellung der Argumente in einer neuen Zeichenkette
(Funktionsschablone)