num_put 클래스

아티클
01/10/2024

숫자 값을 형식 CharType시퀀스로 변환하는 것을 제어하는 로캘 패싯 역할을 할 수 있는 개체를 설명하는 클래스 템플릿입니다.

구문

template <class CharType,
    class OutputIterator = ostreambuf_iterator<CharType>>
class num_put : public locale::facet;

매개 변수

Chartype
로캘의 문자를 인코딩하기 위해 프로그램 내 사용하는 형식입니다.

OutputIterator
숫자 put 함수가 출력을 쓰는 반복기의 형식입니다.

설명

모든 로캘 패싯과 마찬가지로, 고정 개체 ID에는 초기값 0이 저장되어 있습니다. 저장된 값에 액세스를 처음 시도하면 id에 고유한 양수 값이 저장됩니다.

생성자

생성자	Description
num_put	`num_put` 형식의 개체에 대한 생성자입니다.

Typedef

형식 이름	설명
char_type	로캘에서 사용하는 문자를 설명하기 위해 사용하는 형식입니다.
iter_type	출력 반복기에 대해 설명하는 형식입니다.

멤버 함수

멤버 함수	설명
do_put	숫자를 지정된 로캘에 대해 서식이 지정된 숫자를 나타내는 `CharType`의 시퀀스로 변환하기 위해 호출하는 가상 함수입니다.
put	숫자를 지정된 로캘에 대해 서식이 지정된 숫자를 나타내는 `CharType`의 시퀀스로 변환합니다.

요구 사항

헤더:<로캘>

네임스페이스: std

num_put::char_type

로캘에서 사용하는 문자를 설명하기 위해 사용하는 형식입니다.

typedef CharType char_type;

설명

이 형식은 템플릿 매개 변수 CharType의 동의어입니다.

num_put::d o_put

숫자를 지정된 로캘에 대해 서식이 지정된 숫자를 나타내는 CharType의 시퀀스로 변환하기 위해 호출하는 가상 함수입니다.

virtual iter_type do_put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    bool val) const;

virtual iter_type do_put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    long val) const;

virtual iter_type do_put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    unsigned long val) const;

virtual iter_type do_put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    double val) const;

virtual iter_type do_put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    long double val) const;

virtual iter_type do_put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    const void* val) const;

virtual iter_type do_put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    const long long val) const;

virtual iter_type do_put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    const unsigned long long val) const;

매개 변수

next
삽입된 문자열의 첫 번째 요소 주소를 지정하는 반복기입니다.

_Iosbase
출력 및 출력 서식 지정을 위한 플래그에 문장 부호를 적용하는 데 사용되는 numpunct 패싯이 들어 있는 로캘을 포함하는 스트림을 지정합니다.

_채우기
간격에 사용되는 문자입니다.

val
출력할 숫자 또는 부울 형식입니다.

Return Value

생성된 마지막 요소에서 한 위치 다음의 위치 주소를 지정하는 출력 반복기입니다.

설명

첫 번째 가상 보호 멤버 함수는 val 값에서 정수 출력 필드를 생성하기 위해 옆에서 시작하는 순차적 요소를 생성합니다. 함수는 생성된 정수 출력 필드를 지나 요소를 삽입할 다음 위치를 지정하는 반복기를 반환합니다.

정수 출력 필드는 일련의 char 요소를 파일에 생성하기 위해 print 함수가 사용하는 것과 같은 규칙을 통해 생성됩니다. 이러한 각 char 요소는 간단한 일대일 매핑을 통해 동일한 형식 CharType 요소에 매핑되는 것으로 간주됩니다. 그러나 do_put 인쇄 함수는 공백 또는 숫자 0이 있는 필드를 채는 대신 사용합니다 fill. 동일한 인쇄 변환 사양은 다음과 같이 결정됩니다.

iosbase. flags & ios_base::basefield == ios_base::oct, 변환 사양은 .lo
iosbase.flags &ios_base::basefield == ios_base::hex인 경우 변환 사양은 .lx
그렇지 않으면 변환 사양은 ld입니다.

iosbase. width가 0이 아닌 경우 이 값의 필드 너비가 앞에 추가됩니다. 그런 후에 이 함수는 iosbase. width(0)을 호출하여 필드 너비를 0으로 다시 설정합니다.

출력 필드를 지정하는 데 필요한 최소 요소 수 N이 iosbase. width보다 작은 경우에만 채우기가 수행됩니다. 이러한 패딩은 채우기의 N - 너비 복사본 시퀀스로 구성됩니다. 그런 후에 다음과 같이 채우기가 수행됩니다.

iosbase. 플래그 앞에 ios_base::adjustfield == ios_base::플래그가 - 추가됩니다. 채우기는 생성된 텍스트 뒤에서 수행됩니다.
iosbase.flags &ios_base::adjustfieldios_base:: == 내부인 경우 플래그 0 앞에 추가됩니다. 숫자 출력 필드의 경우에는 print 함수가 0으로 채우는 위치에서 채우기가 수행됩니다.
그렇지 않은 경우에는 추가 플래그가 앞에 추가되지 않습니다. 채우기는 생성된 시퀀스 앞에서 수행됩니다.

그리고 마지막으로 다음과 같이 채우기가 수행됩니다.

iosbase. flags & ios_base::showpos 가 0이 아닌 경우 플래그 + 앞에 변환 사양이 추가됩니다.
iosbase. flags & ios_base::showbase 가 0이 아닌 경우 플래그 # 앞에 변환 사양이 추가됩니다.

정수 출력 필드의 형식은 numpunct Elem(iosbase use_facet 호출에 의해 반환된 로 <캘 패싯fac에<의해 추가로 결정됩니다. >getloc). 특별한 사항

fac. grouping은 숫자가 소수점 왼쪽으로 그룹화되는 방법을 결정합니다.
fac. thousands_sep는 소수점 왼쪽의 숫자 그룹을 구분하는 시퀀스를 결정합니다.

fac, grouping에 의해 그룹화 제약 조건이 적용되지 않는 경우(해당 첫 번째 요소값이 CHAR_MAX임) fac. thousands_sep의 인스턴스가 출력 필드에서 생성되지 않습니다. 그렇지 않은 경우에는 인쇄 변환이 수행된 후에 구분 기호가 삽입됩니다.

두 번째 보호된 가상 구성원 함수는 다음 코드와 같습니다.

virtual iter_type do_put(iter_type next,
    ios_base& _Iosbase,
    CharType _Fill,
    unsigned long val) const;

이 함수는 ld의 변환 사양을 lu로 대체한다는 점을 제외하면 첫 번째 함수와 동일하게 동작합니다.

세 번째 보호된 가상 구성원 함수는 다음 코드와 같습니다.

virtual iter_type do_put(iter_type next,
    ios_base& _Iosbase,
    CharType _Fill,
    double val) const;

이 함수는 val. fac. decimal_point의 값에서 부동 소수점 출력 필드를 생성하며 정수 자릿수와 소수 자릿수를 구분하는 시퀀스를 결정한다는 점을 제외하면 첫 번째 함수와 동일하게 동작합니다. 동일한 인쇄 변환 사양은 다음과 같이 결정됩니다.

iosbase. flags & ios_base::floatfield == ios_base::fixed, 변환 사양은 .lf
iosbase. flags &ios_base::floatfieldios_base:: == scientific, 변환 사양은 .le iosbase. flags & ios_base::uppercase is nonzero, e replaced with E.
그렇지 않으면 변환 사양은 lg입니다. iosbase. flags &ios_base::uppercase가 0이 아니고 . gG

iosbase. flags &ios_base::fixed가 0이 아니거나 iosbase인 경우 precision이 0보다 크면 iosbase. precision 값이 포함된 전체 자릿수가 변환 사양 앞에 추가됩니다. 모든 채우기는 정수 출력 필드에 대해 동일하게 동작합니다. 채우기 문자는 fill입니다. 그리고 마지막으로 다음과 같이 채우기가 수행됩니다.

iosbase. flags & ios_base::showpos 가 0이 아닌 경우 플래그 + 앞에 변환 사양이 추가됩니다.
iosbase. flags & ios_base::showpoint 가 0이 아닌 경우 플래그 # 앞에 변환 사양이 추가됩니다.

네 번째 보호된 가상 구성원 함수는 다음 코드와 같습니다.

virtual iter_type do_put(iter_type next,
    ios_base& _Iosbase,
    CharType _Fill,
    long double val) const;

는 변환 사양의 한정 l 자를 .로 대체 L한다는 점을 제외하고 세 번째와 동일하게 동작합니다.

다섯 번째 보호된 가상 구성원 함수는 다음 코드와 같습니다.

virtual iter_type do_put(iter_type next,
    ios_base& _Iosbase,
    CharType _Fill,
    const void* val) const;

이 함수는 변환 사양이 p 및 채우기를 지하는 데 필요한 한정자라는 점을 제외하면 첫 번째 함수와 동일하게 동작합니다.

여섯 번째 보호된 가상 구성원 함수는 다음 코드와 같습니다.

virtual iter_type do_put(iter_type next,
    ios_base& _Iosbase,
    CharType _Fill,
    bool val) const;

는 val에서 부울 출력 필드를 생성한다는 점을 제외하고 첫 번째 출력 필드와 동일하게 동작합니다.

부울 출력 필드는 두 가지 형식 중 하나를 사용합니다. boolalpha인 경우 iosbase.flags & ios_base::멤버 함수는 false일반적으로 0(for) 또는 1true(forfalse)의 생성된 시퀀스를 생성하는 반환do_put(_Next, _Iosbase, _Fill, (long)val)합니다. 그렇지 않으면 생성된 시퀀스가 fac입니다.falsename(forfalse) 또는 fac입니다.truename(fortrue)입니다.

일곱 번째 보호된 가상 구성원 함수는 다음 코드와 같습니다.

virtual iter_type do_put(iter_type next,
    ios_base& iosbase,
    Elem fill,
    long long val) const;

이 함수는 ld의 변환 사양을 lld로 대체한다는 점을 제외하면 첫 번째 함수와 동일하게 동작합니다.

여덟 번째 보호된 가상 구성원 함수는 다음 코드와 같습니다.

virtual iter_type do_put(iter_type next,
    ios_base& iosbase,
    Elem fill,
    unsigned long long val) const;

이 함수는 ld의 변환 사양을 llu로 대체한다는 점을 제외하면 첫 번째 함수와 동일하게 동작합니다.

예시

do_put을 호출하는 put에 대한 예제를 참조하세요.

num_put::iter_type

출력 반복기에 대해 설명하는 형식입니다.

typedef OutputIterator iter_type;

설명

이 형식은 템플릿 매개 변수 OutputIterator와 동일한 의미입니다.

num_put::num_put

num_put 형식의 개체에 대한 생성자입니다.

explicit num_put(size_t _Refs = 0);

매개 변수

_심판
개체에 대한 메모리 관리의 유형을 지정하는 데 사용하는 정수 값입니다.

설명

_Refs 매개 변수 및 해당 중요도에 사용할 수 있는 값은 다음과 같습니다.

0: 개체를 포함하는 로캘에 의해 개체의 수명이 관리됩니다.
1: 개체의 수명을 수동으로 관리해야 합니다.
> 1: 이러한 값은 정의되지 않습니다.

소멸자는 보호되므로 직접적인 예제는 확인할 수 없습니다.

생성자는 locale::facet(_ Refs)를 통해 해당 기준 개체를 초기화합니다.

num_put::p ut

숫자를 지정된 로캘에 CharType대해 서식이 지정된 숫자를 나타내는 s의 시퀀스로 변환합니다.

iter_type put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    bool val) const;

iter_type put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    long val) const;

iter_type put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    unsigned long val) const;

iter_type put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    Long long val) const;

iter_type put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    Unsigned long long val) const;

iter_type put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    double val) const;

iter_type put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    long double val) const;

iter_type put(
    iter_type dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    const void* val) const;

매개 변수

dest
삽입된 문자열의 첫 번째 요소 주소를 지정하는 반복기입니다.

_Iosbase
출력 및 출력 서식 지정을 위한 플래그에 문장 부호를 적용하는 데 사용되는 numpunct 패싯이 들어 있는 로캘을 포함하는 스트림을 지정합니다.

_채우기
간격에 사용되는 문자입니다.

val
출력할 숫자 또는 부울 형식입니다.

Return Value

생성된 마지막 요소에서 한 위치 다음의 위치 주소를 지정하는 출력 반복기입니다.

설명

모든 구성원 함수는 do_put( next, _Iosbase, _Fill, val)을 반환합니다.

예시

// num_put_put.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
#include <sstream>
using namespace std;
int main( )
{
   locale loc( "german_germany" );
   basic_stringstream<char> psz2;
   ios_base::iostate st = 0;
   long double fVal;
   cout << "The thousands separator is: "
        << use_facet < numpunct <char> >(loc).thousands_sep( )
        << endl;

   psz2.imbue( loc );
   use_facet < num_put < char > >
      ( loc ).put(basic_ostream<char>::_Iter(psz2.rdbuf( ) ),
                    psz2, ' ', fVal=1000.67);

   if ( st & ios_base::failbit )
      cout << "num_put( ) FAILED" << endl;
   else
      cout << "num_put( ) = " << psz2.rdbuf( )->str( ) << endl;
}

The thousands separator is: .
num_put( ) = 1.000,67

참고 항목

<로캘>
facet 클래스
C++ 표준 라이브러리의 스레드 보안

Share via

num_put 클래스

구문

매개 변수

설명

생성자

Typedef

멤버 함수

요구 사항

num_put::char_type

설명

num_put::d o_put

매개 변수

Return Value

설명

예시

num_put::iter_type

설명

num_put::num_put

매개 변수

설명

num_put::p ut

매개 변수

Return Value

설명

예시

참고 항목

피드백

피드백

추가 리소스