format_to

format_to (C++20 형식 문자열을 출력 반복자에 기록)

이 페이지는 C++20 표준 라이브러리의 std::format_to 함수에 대해 설명해요. format_to는 주어진 형식 문자열에 따라 인자를 문자열로 변환하고, 그 결과를 출력 반복자(out)에 기록하는 함수 템플릿이에요. 로케일 지정 오버로드도 있어서 지역화된 형식 지정도 지원해요.

출처: cppreference

본문

개요

형식 문자열 fmt에 따라 인자를 형식화하고, 그 결과를 출력 반복자 out에 써요. loc이 제공되면 로케일별 형식 지정에 사용해요.

다음과 동일해요:

• 오버로드 (1,3)에서는 CharT를 char로, 오버로드 (2,4)에서는 wchar_t로 둬요.
• 이 오버로드들은 OutputIt이 std::output_iterator<const CharT&> 개념을 만족할 때만 오버로드 해석에 참여해요.

다음 조건 중 하나라도 만족되면 동작이 정의되지 않아요:

• OutputIt이 std::output_iterator<const CharT&>를 모델링하지 않아요.
• Args 안의 어떤 Ti에 대해 std::formatter<Ti, CharT>가 BasicFormatter 요구 사항(std::make_format_args와 std::make_wformat_args에서 요구하는)을 충족하지 못해요.

매개변수

반환값

출력 범위의 끝을 가리키는 반복자예요.

예외

형식화나 반복자 연산에서 발생하는 모든 예외를 전파해요.

참고

P2216R3 이후로, 형식 문자열이 상수 표현식이 아니면 오류예요. 이 경우 std::vformat_to 또는 std::runtime_format(since C++26)을 사용할 수 있어요.

예제

#include <format>
#include <iostream>
#include <iterator>
#include <string>

int main()
{
    std::string buffer;
    
    std::format_to
    (
        std::back_inserter(buffer), // < OutputIt
        "Hello, C++{}!\n",          // < fmt
        "20"                        // < arg
    );
    std::cout << buffer;
    buffer.clear();
    
    std::format_to
    (
        std::back_inserter(buffer), // < OutputIt
        "Hello, {0}::{1}!{2}",      // < fmt
        "std",                      // < arg {0}
        "format_to()",              // < arg {1}
        "\n",                       // < arg {2}
        "extra param(s)..."         // < unused
    );
    std::cout << buffer << std::flush;
    
    std::wstring wbuffer;
    std::format_to
    (
        std::back_inserter(wbuffer),// < OutputIt
        L"Hello, {2}::{1}!{0}",     // < fmt
        L"\n",                      // < arg {0}
        L"format_to()",             // < arg {1}
        L"std",                     // < arg {2}
        L"...is not..."             // < unused
        L"...an error!"             // < unused
    );
    std::wcout << wbuffer;
}

출력:

Hello, C++20!
Hello, std::format_to()!
Hello, std::format_to()!

결함 보고서

다음 동작 변경 결함 보고서는 이미 게시된 C++ 표준에 소급 적용되었어요.

같이 보기

더 알아보기 (Learn more)

cppreference