wctomb, _wctomb_l

아티클
06/09/2015

와이드 바이트 문자를 해당 멀티바이트 문자로 변환합니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. 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가 NULL이면, wctomb는 0을 반환합니다. 현재 로캘에서 변환이 불가능한 경우, wctomb는 -1을 반환하고, errno가 EILSEQ으로 설정됩니다.

설명

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

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

요구 사항

루틴	필수 헤더
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 );
}