wctomb, _wctomb_l

아티클
02/21/2013

와이드 문자 해당 멀티 바이트 문자로 변환 합니다.이러한 함수를 더 안전한 버전을 사용할 수 있습니다. see 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 문자 ('\ 0' L)입니다 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 );
}