wcstombs, _wcstombs_l

아티클
06/09/2015

와이드 문자의 시퀀스를 해당하는 멀티 바이트 문자의 시퀀스로 변환합니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. wcstombs_s, _wcstombs_s_l를 참조하십시오.

size_t wcstombs(
   char *mbstr,
   const wchar_t *wcstr,
   size_t count 
);
size_t _wcstombs_l(
   char *mbstr,
   const wchar_t *wcstr,
   size_t count,
   _locale_t locale
);
template <size_t size>
size_t wcstombs(
   char (&mbstr)[size],
   const wchar_t *wcstr,
   size_t count 
); // C++ only
template <size_t size>
size_t _wcstombs_l(
   char (&mbstr)[size],
   const wchar_t *wcstr,
   size_t count,
   _locale_t locale
); // C++ only

매개 변수

mbstr
주소는 멀티바이트 문자의 시퀀스입니다.
wcstr
주소는 와이드 문자의 시퀀스입니다.
count
멀티바이트 출력 문자열에서 저장할 수 있는 최대 바이트의 수입니다.
locale
사용할 로캘입니다.

반환 값

만약 wcstombs가 성공적으로 멀티바이트 문자열을 변환했다면, 그것은 종료 NULL(만약 있다면)를 제외하고 멀티바이트 출력 문자열에 쓰여진 바이트의 숫자를 반환합니다. mbstr 인수가 NULL이면, wcstombs은 대상 문자열의 요구 크기를 바이트의 형태로 반환합니다. 만약 wcstombs가 와이드 문자와 부딪혔을 경우, 그것은 멀티 바이트 문자로 변환될 수 없고, -1 캐스트를 형식 size_t로 반환하고 errno을 EILSEQ로 설정합니다.

설명

wcstombs 함수는 wcstr가 가리키는 와이드 문자의 문자열을 해당하는 멀티 바이트 문자로 변환하고 그 결과를 mbstr 배열에 저장합니다. count 매개 변수는 멀티 바이트 출력 문자열에 저장할 수 있는 바이트의 최대 숫자를 표시합니다. (이는 mbstr의 크기입니다.) 일반적으로, 와이드 문자열을 변환할 때 필요한 바이트의 수는 알려져 있지 않습니다. 일부 와이드 문자는 출력 문자열에서 오직 1바이트만 요구할 것입니다. 그 외에는 2바이트를 요구합니다. 모든 와이드 문자(NULL 와이드 문자를 포함하여) 멀티 바이트 출력 문자열에 두 바이트가 있는 경우, 결과는 맞는 것이 보장됩니다.

wcstombs 이 count 가 발생할 때나 그 이 전에 와이드 null문자(L'\0')를 발견한다면, 이것은 8비트 0으로 변환하고 멈춥니다. 따라서 멀티 바이트 문자 문자열에서 mbstr는 null로 끝나는 경우에 wcstombs 와이드 null 문자로 변환 하는 동안 발생 합니다. 만일 wcstr 와 mbstr 에 의해 가르켜진 시퀀스가 겹쳐질 경우, wcstombs 의 동작은 정의되지 않습니다.

mbstr 인수가 NULL이면, wcstombs은 대상 문자열의 요구 크기를 바이트의 형태로 반환합니다.

wcstombs 매개 변수의 유효성을 검사합니다. 만약 wcstr가 NULL이거나 count가 INT_MAX보다 더 큰 경우, 이 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속 실행하는 것이 허용되었다면, 함수는 errno을 EINVAL로 설정하고 -1을 반환합니다.

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

C++에서 이러한 함수는 보다 최신의 보안 대응 함수를 호출하는 템플릿 오버로드를 갖고 있습니다. 자세한 내용은 안전한 템플릿 오버로드을 참조하십시오.

요구 사항

루틴	필수 헤더
wcstombs	<stdlib.h>
_wcstombs_l	<stdlib.h>

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

예제

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

// crt_wcstombs.c
// compile with: /W3
// This example demonstrates the use
// of wcstombs, which converts a string
// of wide characters to a string of 
// multibyte characters.

#include <stdlib.h>
#include <stdio.h>

#define BUFFER_SIZE 100

int main( void )
{
    size_t  count;
    char    *pMBBuffer = (char *)malloc( BUFFER_SIZE );
    wchar_t *pWCBuffer = L"Hello, world.";

    printf("Convert wide-character string:\n" );

    count = wcstombs(pMBBuffer, pWCBuffer, BUFFER_SIZE ); // C4996
    // Note: wcstombs is deprecated; consider using wcstombs_s instead
    printf("   Characters converted: %u\n",
            count );
    printf("    Multibyte character: %s\n\n",
           pMBBuffer );

    free(pMBBuffer);
}