wctomb_s, _wctomb_s_l

아티클
06/09/2015

와이드 바이트 문자를 해당 멀티바이트 문자로 변환합니다. wctomb, _wctomb_l 의 버젼은 보안 향상과 관련된 CRT의 보안 기능로 설명됩니다.

errno_t wctomb_s(
   int *pRetValue,
   char *mbchar,
   size_t sizeInBytes,
   wchar_t wchar 
);
errno_t _wctomb_s_l(
   int *pRetValue,
   char *mbchar,
   size_t sizeInBytes,
   wchar_t wchar,
   _locale_t locale
);

매개 변수

[out] pRetValue
바이트의 수 또는 결과를 나타내는 코드
[out] mbchar
멀티 바이트 문자의 주소입니다.
[in] sizeInBytes
버퍼의 크기 : mbchar
[in] wchar
와이드 문자
[in] locale
사용할 로캘입니다.

반환 값

성공 시 0이고, 실패 시 오류 코드입니다.

오류 조건

mbchar	sizeInBytes	반환 값	pRetValue
NULL	>0	EINVAL	수정 안 됨
any	>INT_MAX	EINVAL	수정 안 됨
any	너무 작습니다.	EINVAL	수정 안 됨

위의 오류 조건이 발생하는 경우, 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용된 경우, wctomb 은 EINVAL 를 반환하고, errno 에 EINVAL를 설정합니다.

설명

wctomb_s 함수는 자신의 wchar 인수를 해당하는 멀티 바이트 문자로 변환하고 결과를 mbchar에 저장합니다. 프로그램의 모든 위치에서 함수를 호출할 수 있습니다.

wctomb_s가 와이드 문자를 멀티 바이트 문자로 변환할 때, 와이드 문자의 바이트의 크기(MB_CUR_MAX보다는 작은 값)를 pRetValue가 가리키는 정수에 넣습니다. wchar가 와이드 null 문자(L'\0')일 경우, wctomb_s는 pRetValue를 1로 채웁니다. 대상 포인터 mbchar가 NULL 이면 wctomb_s는 pRetValue에 0을 저장합니다. 현재 로케일에서의 변환이 불가능 한 경우 wctomb_s는 pRetValue에 -1을 저장합니다.

wctomb_s 는 로캘 종속 정보에 대해 현재의 로캘을 사용 합니다. _wctomb_s_l 는 전달 된 로캘을 사용 하는 것을 제외하고는 동일합니다. 자세한 내용은 로캘을 참조하십시오.

요구 사항

루틴	필수 헤더
wctomb_s	<stdlib.h>
_wctomb_s_l	<stdlib.h>

호환성에 대한 자세한 내용은 소개 단원의 호환성 부분을 참조하십시오.

예제

이 프로그램은 wctomb 함수의 동작을 보여 줍니다.

// crt_wctomb_s.cpp
#include <stdio.h>
#include <stdlib.h>

int main( void )
{
    int i;
    wchar_t wc = L'a';
    char *pmb = (char *)malloc( MB_CUR_MAX );

    printf_s( "Convert a wide character:\n" );
    wctomb_s( &i, pmb, MB_CUR_MAX, wc );
    printf_s( "   Characters converted: %u\n", i );
    printf_s( "   Multibyte character: %.1s\n\n", pmb );
}