다음을 통해 공유


CA2WEX 클래스

이 클래스는 문자열 변환 매크로 CA2TEX, CA2CTEX, CT2WEX 및 CT2CWEX 및 typedef CA2W에서 사용됩니다.

Important

이 클래스와 해당 멤버는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다.

구문

template <int t_nBufferLength = 128>
class CA2WEX

매개 변수

t_nBufferLength
변환 프로세스에 사용되는 버퍼의 크기입니다. 기본 길이는 128바이트입니다.

멤버

공용 생성자

속성 설명
CA2WEX::CA2WEX 생성자입니다.
CA2WEX::~CA2WEX 소멸자입니다.

Public 연산자

속성 설명
CA2WEX::operator LPWSTR 변환 연산자입니다.

공용 데이터 멤버

속성 설명
CA2WEX::m_psz 원본 문자열을 저장하는 데이터 멤버입니다.
CA2WEX::m_szBuffer 변환된 문자열을 저장하는 데 사용되는 정적 버퍼입니다.

설명

추가 기능이 필요하지 않은 경우 코드에서 CA2TEX, CA2CTEX, CT2WEX, CT2CWEX 또는 CA2W를 사용합니다.

이 클래스에는 변환 결과를 저장하는 데 사용되는 고정 크기 정적 버퍼가 포함되어 있습니다. 결과가 너무 커서 정적 버퍼에 맞지 않는 경우 클래스는 malloc를 사용하여 메모리를 할당하여 개체가 범위를 벗어날 때 메모리를 해제합니다. 이렇게 하면 이전 버전의 ATL에서 사용할 수 있는 텍스트 변환 매크로와 달리 이 클래스는 루프에서 안전하게 사용할 수 있으며 스택이 오버플로되지 않습니다.

클래스가 힙에 메모리를 할당하려고 시도하고 실패하면 E_OUTOFMEMORY 인수를 사용하여 호출 AtlThrow 됩니다.

기본적으로 ATL 변환 클래스 및 매크로는 변환에 현재 스레드의 ANSI 코드 페이지를 사용합니다. 특정 변환에 대해 해당 동작을 재정의하려면 코드 페이지를 클래스의 생성자에 대한 두 번째 매개 변수로 지정합니다.

다음 매크로는 이 클래스를 기반으로 합니다.

  • CA2TEX

  • CA2CTEX

  • CT2WEX

  • CT2CWEX

다음 typedef는 이 클래스를 기반으로 합니다.

  • CA2W

이러한 텍스트 변환 매크로에 대한 자세한 내용은 ATL 및 MFC 문자열 변환 매크로를 참조하세요.

예시

이러한 문자열 변환 매크로를 사용하는 예제는 ATL 및 MFC 문자열 변환 매크로를 참조하세요.

요구 사항

헤더: atlconv.h

CA2WEX::CA2WEX

생성자입니다.

CA2WEX(LPCSTR psz, UINT nCodePage) throw(...);
CA2WEX(LPCSTR psz) throw(...);

매개 변수

psz
변환할 텍스트 문자열입니다.

nCodePage
변환을 수행하는 데 사용되는 코드 페이지입니다. 자세한 내용은 Windows SDK 함수 MultiByteToWideChar 에 대한 코드 페이지 매개 변수 토론을 참조하세요.

설명

변환 프로세스에 사용되는 버퍼를 할당합니다.

CA2WEX::~CA2WEX

소멸자입니다.

~CA2WEX() throw();

설명

할당된 버퍼를 해제합니다.

CA2WEX::m_psz

원본 문자열을 저장하는 데이터 멤버입니다.

LPWSTR m_psz;

CA2WEX::m_szBuffer

변환된 문자열을 저장하는 데 사용되는 정적 버퍼입니다.

wchar_t m_szBuffer[t_nBufferLength];

CA2WEX::operator LPWSTR

변환 연산자입니다.

operator LPWSTR() const throw();

Return Value

텍스트 문자열을 LPWSTR 형식으로 반환합니다.

참고 항목

CA2AEX 클래스
CA2CAEX 클래스
CW2AEX 클래스
CW2CWEX 클래스
CW2WEX 클래스
클래스 개요