Namespaces
Variants

std:: basic_format_args

From cppreference.net
C++
Text processing library
Formatting library
Standard format specification
Formatting functions
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
Format strings
(C++20) (C++20) (C++20)
(C++26)
Formatting concepts
(C++23)
Formatter
(C++20)
(C++23)
(C++23)
(C++23)
(C++23)
(C++20) (C++20) (C++20)
(C++20) (C++20) (C++20)
(C++23)
(C++23)
Formatting arguments
(C++20)
(C++20)
basic_format_args format_args wformat_args
(C++20) (C++20) (C++20)
(C++20) (deprecated in C++26)
(C++20) (C++20)
Format error
(C++20)
헤더에 정의됨 <format>
template < class Context >
class basic_format_args ;
(1) (C++20부터)
using format_args = basic_format_args < std:: format_context > ;
(2) (C++20부터)
using wformat_args = basic_format_args < std:: wformat_context > ;
(3) (C++20부터)

서식 지정 인수에 대한 액세스를 제공합니다.

목차

멤버 함수

(constructor)
basic_format_args 객체를 생성합니다
(public member function)
get
지정된 인덱스의 포맷팅 인수를 반환합니다
(public member function)

std::basic_format_args:: basic_format_args

template < class ... Args >
basic_format_args ( const /*format-arg-store*/ < Context, Args... > & store ) noexcept ;

basic_format_args 객체를 std::make_format_args 또는 std::make_wformat_args 호출 결과로부터 생성합니다.

std::basic_format_args:: get

std:: basic_format_arg < Context > get ( std:: size_t i ) const noexcept ;

args 에 전달된 인수 패킷에서 i 번째 인수를 보유하는 std::basic_format_arg 을 반환합니다. 여기서 args 는 std::make_format_args 또는 std::make_wformat_args 에 전달된 매개변수 팩입니다.

해당 서식 인수가 없는 경우(즉, * this 가 기본 생성되었거나 i 가 서식 인수의 개수보다 작지 않은 경우), 기본 생성된 std::basic_format_arg ( std::monostate 객체를 보유함)을 반환합니다.

추론 가이드

template < class Context, class ... Args >
basic_format_args ( /*format-arg-store*/ < Context, Args... > ) - > basic_format_args < Context > ;
(C++20 이후)

참고 사항

std::basic_format_args 는 참조 의미론(reference semantics)을 가집니다. 프로그래머는 * this 가 store 의 수명을 초과하지 않도록 해야 합니다(이 store는 차례로 std::make_format_args 또는 std::make_wformat_args 에 전달된 인수들의 수명을 초과하지 않아야 합니다).

예제

이 섹션은 불완전합니다
이유: 예제가 없음

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

DR 적용 대상 게시된 동작 올바른 동작
P2216R3 C++20 format_args_t 가 vformat_to 의 과도한 매개변수화로 인해 제공됨 제거됨
LWG 3810 C++20 basic_format_args 에 deduction guide가 없음 추가됨
LWG 4106 C++20 basic_format_args 가 기본 생성 가능했음 기본 생성자 제거됨

참고 항목

(C++20)
사용자 정의 포매터를 위한 서식 인수에 대한 접근을 제공하는 클래스 템플릿
(클래스 템플릿)