std:: format_to_n, std:: format_to_n_result

Formatiere args gemäß der Formatzeichenkette fmt und schreibe das Ergebnis an den Ausgabeiterator out . Es werden maximal n Zeichen geschrieben. Falls vorhanden, wird loc für lokalisierungsabhängige Formatierung verwendet.

Lassen Sie CharT für Überladungen (1,3) char sein und wchar_t für Überladungen (2,4) .

Diese Überladungen nehmen nur dann an der Überladungsauflösung teil, wenn OutputIt das Konzept std:: output_iterator < const CharT & > erfüllt.

Das Verhalten ist undefiniert, wenn OutputIt nicht das Konzept std:: output_iterator < const CharT & > erfüllt (die semantischen Anforderungen nicht erfüllt), oder wenn std:: formatter < std:: remove_cvref_t < Ti > , CharT > die BasicFormatter Anforderungen für irgendein Ti in Args nicht erfüllt.

Parameter

Rückgabewert

Ein format_to_n_result bei dem das out Mitglied ein Iterator hinter dem Ende des Ausgabebereichs ist und das size Mitglied die gesamte (nicht abgeschnittene) Ausgabegröße darstellt.

Ausnahmen

Leitet alle Ausnahmen weiter, die durch Formatierer- oder Iterator-Operationen ausgelöst werden.

Hinweise

Die libstdc++-Implementierung vor GCC-13.3 hatte einen Fehler bei der Meldung des korrekten format_to_n_result :: out -Werts.

Beispiel

#include <format>
#include <initializer_list>
#include <iomanip>
#include <iostream>
#include <string_view>
int main()
{
    char buffer[64];
    for (std::size_t max_chars_to_write : {std::size(buffer) - 1, 23uz, 21uz})
    {
        const std::format_to_n_result result =
            std::format_to_n(
                buffer, max_chars_to_write,
                "Hubble's H{2} {3} {0}{4}{1} km/sec/Mpc.", // 24 bytes w/o formatters
                71,       // {0}, occupies 2 bytes
                8,        // {1}, occupies 1 byte
                "\u2080", // {2}, occupies 3 bytes, '₀' (SUBSCRIPT ZERO)
                "\u2245", // {3}, occupies 3 bytes, '≅' (APPROXIMATELY EQUAL TO)
                "\u00B1"  // {4}, occupies 2 bytes, '±' (PLUS-MINUS SIGN)
                ); // 24 + 2 + 1 + 3 + 3 + 2 == 35, no trailing '\0'
        *result.out = '\0'; // adds terminator to buffer
        const std::string_view str(buffer, result.out);
        std::cout << "Buffer until '\\0': " << std::quoted(str) << '\n'
                  << "Max chars to write: " << max_chars_to_write << '\n'
                  << "result.out offset: " << result.out - buffer << '\n'
                  << "Untruncated output size: " << result.size << "\n\n";
    }
}

Buffer until '\0': "Hubble's H₀ ≅ 71±8 km/sec/Mpc."
Max chars to write: 63
result.out offset: 35
Untruncated output size: 35
Buffer until '\0': "Hubble's H₀ ≅ 71±8"
Max chars to write: 23
result.out offset: 23
Untruncated output size: 35
Buffer until '\0': "Hubble's H₀ ≅ 71�"
Max chars to write: 21
result.out offset: 21
Untruncated output size: 35

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch