wctomb, _wctomb_l

와이드 문자를 해당 멀티바이트 문자로 변환합니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. 를 참조하세요wctomb_s. _wctomb_s_l

구문

int wctomb(
   char *mbchar,
   wchar_t wchar
);
int _wctomb_l(
   char *mbchar,
   wchar_t wchar,
   _locale_t locale
);

매개 변수

mbchar
멀티바이트 문자의 주소입니다.

wchar
와이드 문자입니다.

반환 값

wctomb는 와이드 문자를 멀티바이트 문자로 변환하는 경우 와이드 문자의 바이트 수(항상 MB_CUR_MAX보다 크지 않음)를 반환합니다. wchar이 와이드 문자 null 문자(L'\0')이면 wctomb는 1을 반환합니다. 대상 포인터 mbchar 가 NULLwctomb 있으면 0을 반환합니다. 현재 로캘 wctomb 에서 변환이 불가능한 경우 -1을 반환하고 errno 로 설정 EILSEQ됩니다.

설명

wctomb 함수는 wchar 인수를 해당 멀티바이트 문자로 변환하고 결과를 mbchar에 저장합니다. 모든 프로그램에서 언제든지 이 함수를 호출할 수 있습니다. wctomb는 로캘 종속 동작에 대해 현재 로캘을 사용합니다. _wctomb_l은 대신 전달된 로캘을 사용하는 것을 제외하고는 wctomb와 같습니다. 자세한 내용은 Locale을 참조하세요.

wctomb는 매개 변수의 유효성을 검사합니다. 이 경우 mbchar 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출NULL됩니다. 계속해서 실행하도록 허용된 경우 errno 는 EINVAL 로 설정되고 함수는 -1을 반환합니다.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

요구 사항

루틴에서 반환된 값	필수 헤더
wctomb	<stdlib.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

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

// crt_wctomb.cpp
// compile with: /W3
#include <stdio.h>
#include <stdlib.h>

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

   printf( "Convert a wide character:\n" );
   i = wctomb( pmb, wc ); // C4996
   // Note: wctomb is deprecated; consider using wctomb_s
   printf( "   Characters converted: %u\n", i );
   printf( "   Multibyte character: %.1s\n\n", pmb );
}

Convert a wide character:
   Characters converted: 1
   Multibyte character: a

참고 항목

데이터 변환
Locale
_mbclen, mblen, _mblen_l
mbstowcs, _mbstowcs_l
mbtowc, _mbtowc_l
wcstombs, _wcstombs_l
WideCharToMultiByte