Namespaces
Variants

std:: print (std::ostream)

From cppreference.net
헤더에 정의됨 <ostream>
template < class ... Args >
void print ( std:: ostream & os, std:: format_string < Args... > fmt, Args && ... args ) ;
(C++23부터)

형식 문자열 fmt 에 따라 args 를 포맷하고, 결과를 os 스트림에 삽입합니다.

만약 ordinary literal encoding 이 UTF-8인 경우, 다음과 동일합니다:

std:: formatter < Ti, char > Args 내의 어떤 Ti 에 대해서도 BasicFormatter 요구사항을 충족하지 않을 경우( std:: make_format_args 에 의해 요구되는 대로), 동작은 정의되지 않습니다.

목차

매개변수

os - 데이터를 삽입할 출력 스트림
fmt - 형식 문자열을 나타내는 객체. 형식 문자열은 다음으로 구성됩니다:
  • 일반 문자( { } 제외), 출력에 변경 없이 복사됩니다,
  • 이스케이프 시퀀스 { { } } , 출력에서 각각 { } 로 대체됩니다, 그리고
  • 치환 필드.

각 치환 필드는 다음 형식을 가집니다:

{ arg-id (선택 사항) } (1)
{ arg-id (선택 사항) : format-spec } (2)
1) 형식 명세 없음 치환 필드
2) 형식 명세 포함 치환 필드
arg-id - 서식 지정에 사용할 args 내 인자의 인덱스를 지정합니다; 생략하면 인자가 순서대로 사용됩니다.

형식 문자열 내 arg-id 들은 모두 존재하거나 모두 생략되어야 합니다. 수동 및 자동 인덱싱을 혼합하는 것은 오류입니다.

format-spec - 해당 인자에 대한 std::formatter 특수화에 의해 정의된 형식 명세. } 로 시작할 수 없습니다.

(C++23부터)
(C++26부터)
  • 다른 서식 가능 타입의 경우, 형식 명세는 사용자 정의 formatter 특수화에 의해 결정됩니다.
args... - 서식 지정할 인자들

예외

참고 사항

기능 테스트 매크로 표준 기능
__cpp_lib_print 202207L (C++23) 형식화된 출력
__cpp_lib_format 202207L (C++23) std::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_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());
}

출력:

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

참고 항목

인수의 형식화된 표현을 출력하고 ' \n ' 을 추가함
(함수 템플릿)
(C++23)
인수의 형식화된 표현을 사용하여 stdout 또는 파일 스트림에 출력함
(함수 템플릿)
(C++20)
인수의 형식화된 표현을 새 문자열에 저장함
(함수 템플릿)