Namespaces
Variants

std::ctype<CharT>:: widen, do_widen

From cppreference.net
C++
Text processing library
Localization library
std::ctype
헤더 파일에 정의됨 <locale>
public :
CharT widen ( char c ) const ;
(1)
public :
const char * widen ( const char * beg, const char * end, CharT * dst ) const ;
(2)
protected :
virtual CharT do_widen ( char c ) const ;
(3)
protected :
virtual const char * do_widen ( const char * beg, const char * end, CharT * dst ) const ;
(4)
1,2) 공개 멤버 함수로, 가장 파생된 클래스의 해당 protected 가상 멤버 함수 do_widen 오버로드를 호출합니다. 오버로드 (1)은 do_widen ( c ) 를 호출하고, 오버로드 (2)는 do_widen ( beg, end, dst ) 를 호출합니다.
3) 단일 바이트 문자 c 를 가장 간단하고 합리적인 변환을 사용하여 해당하는 와이드 문자 표현으로 변환합니다. 일반적으로 이는 멀티바이트 인코딩이 단일 바이트인 문자(예: UTF-8에서 U+0000-U+007F)에만 적용됩니다.
4) 문자 배열 [ beg , end ) 의 모든 문자에 대해, 해당 확장 문자를 dst 가 가리키는 문자 배열의 연속적인 위치에 기록합니다.

확장(widening)은 항상 와이드 문자를 반환하지만, basic source character set (until C++23) basic character set (since C++23) 에 속하는 문자들만 고유하고 명확하게 정의된 확장 변환을 보장하며, 이는 역변환도 보장됩니다( narrow() 에 의해). 실제로는, 멀티바이트 표현이 단일 바이트인 모든 문자들은 일반적으로 해당 와이드 문자로 확장되며, 나머지 가능한 단일 바이트 값들은 일반적으로 동일한 플레이스홀더 값(일반적으로 CharT ( - 1 ) )로 매핑됩니다.

확장(widening)은 성공할 경우, is() 가 인식하는 모든 문자 분류 범위를 보존합니다.

목차

매개변수

c - 변환할 문자
dflt - 변환이 실패할 경우 반환할 기본값
beg - 변환할 문자 배열의 첫 번째 문자를 가리키는 포인터
end - 변환할 문자 배열의 끝 다음을 가리키는 포인터
dst - 채울 문자 배열의 첫 번째 요소를 가리키는 포인터

반환값

1,3) 확장된 문자.
2,4) end

예제

이 코드 실행 
#include <iostream>
#include <locale>
void try_widen(const std::ctype<wchar_t>& f, char c)
{
    wchar_t w = f.widen(c);
    std::cout << "The single-byte character " << +(unsigned char)c
              << " widens to " << +w << '\n';
}
int main()
{
    std::locale::global(std::locale("cs_CZ.iso88592"));
    auto& f = std::use_facet<std::ctype<wchar_t>>(std::locale());
    std::cout << std::hex << std::showbase << "In Czech ISO-8859-2 locale:\n";
    try_widen(f, 'a');
    try_widen(f, '\xdf'); // German letter ß (U+00df) in ISO-8859-2
    try_widen(f, '\xec'); // Czech letter ě (U+011b) in ISO-8859-2
    std::locale::global(std::locale("cs_CZ.utf8"));
    auto& f2 = std::use_facet<std::ctype<wchar_t>>(std::locale());
    std::cout << "In Czech UTF-8 locale:\n";
    try_widen(f2, 'a');
    try_widen(f2, '\xdf'); 
    try_widen(f2, '\xec'); 
}

가능한 출력: 

In Czech ISO-8859-2 locale:
The single-byte character 0x61 widens to 0x61
The single-byte character 0xdf widens to 0xdf
The single-byte character 0xec widens to 0x11b
In Czech UTF-8 locale:
The single-byte character 0x61 widens to 0x61
The single-byte character 0xdf widens to 0xffffffff
The single-byte character 0xec widens to 0xffffffff

결함 보고서

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

DR 적용 대상 게시된 동작 올바른 동작
LWG 153 C++98 widen 항상 오버로드 (4) 호출 해당 오버로드 호출

참고 항목

do_narrow 를 호출합니다
(public member function)
문자를 확장합니다
( std::basic_ios<CharT,Traits> 의 public member function)
가능한 경우 단일 바이트 narrow 문자를 wide 문자로 확장합니다
(function)