mbsrtowcs_s

아티클
02/21/2013

와이드 문자열을 멀티 바이트 문자 문자열 표현으로 변환 합니다.버전 mbsrtowcs 와 보안 기능 향상에 설명 된 대로 CRT의 보안 기능.

errno_t mbsrtowcs_s(
   size_t *pReturnValue,
   wchar_t *wcstr,
   size_t sizeInWords,
   const char **mbstr,
   size_t count,
   mbstate_t *mbstate
);
template <size_t size>
errno_t mbsrtowcs_s(
   size_t *pReturnValue,
   wchar_t (&wcstr)[size],
   const char **mbstr,
   size_t count,
   mbstate_t *mbstate
); // C++ only

매개 변수

[out] pReturnValue
문자를 변환 합니다.
[out] wcstr
결과 변환 된 와이드 문자열을 위한 버퍼의 주소입니다.
[out] sizeInWords
크기를 wcstr 단어 (와이드 문자)입니다.
[in] mbstr
변환 하는 멀티 바이트 문자 문자열의 위치를 가리킵니다.
[in] count
최대 와이드 문자를 저장 하는 wcstr 종료 null을 포함 하지 않은 버퍼를 또는 _TRUNCATE.
[in] mbstate
에 대 한 포인터를 mbstate_t 변환 상태 개체입니다.

반환 값

연결에 성공 하면 0, 실패 시 오류 코드입니다.

오류 조건	값을 반환 하 고errno
wcstris NULL and sizeInWords > 0	EINVAL
mbstr가 NULL인 경우	EINVAL
대상 버퍼가 너무 작아 변환 된 문자열을 포함할 수 있습니다 (않는 한 count 입니다 _TRUNCATE. 아래의 설명 부분 참조)	ERANGE

이러한 조건 중 하나라도 발생 하는 경우 잘못 된 매개 변수가 예외에 설명 된 대로 호출 될 매개 변수 유효성 검사 .실행 계속 수 있으면 함수가 오류 코드를 반환 하 고 설정 하는 errno 는 표에 표시 된 대로.

설명

mbsrtowcs_s 함수 포인터가 가리키는 멀티 바이트 문자 문자열 변환 mbstr 와이드 문자 포인터가 가리키는 버퍼에 저장 wcstr, 포함 된 변환 상태를 사용 하 여 mbstate.이러한 조건 중 하나가 만족 될 때까지 각 문자에 대 한 변환을 계속 합니다.

멀티 바이트 null 문자를 발견 했습니다.
잘못 된 멀티 바이트 문자가 나타날 때
저장 된 와이드 문자는 wcstr equals 버퍼 count.

항상 대상 문자열은 null로 끝나는 (오류 경우에)입니다.

경우 count 특수 값인 _TRUNCATE, 다음 mbsrtowcs_s 여전히 그대로 두고 공간에 null 종결자에 대 한 대상 버퍼에 맞게 최대한 will 문자열로 변환 합니다.

경우 mbsrtowcs_s 성공적으로 원본 문자열 변환 와이드 문자 null 종결자를 포함 하 여 변환 된 문자열의 크기를 넣습니다 *pReturnValue (제공 pReturnValue 수 없습니다 NULL).이런 경우에는 wcstr 인수가 NULL 및 필요한 버퍼 크기를 결정할 수 있습니다.Note that if wcstr is NULL, count is ignored.

경우 mbstate 입니다 NULL, 내부 mbstate_t 상태 변환이 사용 됩니다.

경우 mbsrtowcs_s 에 잘못 된 멀티 바이트 문자가 발견-1 배치 *pReturnValue, 빈 문자열로 설정 하는 대상 버퍼, 설정 errno 에 EILSEQ, 반환 하 고 EILSEQ.

시퀀스 가리키는 경우 mbstr 및 wcstr 겹치는 동작을 mbsrtowcs_s 는 정의 되지 않습니다.mbsrtowcs_s현재 로캘 LC_TYPE 범주별으로 영향을 받습니다.

보안 정보
확인 wcstr 및 mbstr 서로 중첩 되지 않습니다 및 count 올바르게 변환 하려면 멀티 바이트 문자 수를 반영 합니다.

mbsrtowcs_s 다른 함수에서 mbstowcs_s, _mbstowcs_s_l 를 재시작 하면 됩니다.변환 상태 저장 됩니다 mbstate 같은 또는 다른 다시 시작 함수 호출에 대 한.혼합 가지가 함수를 사용 하는 경우 결과가 정의 되지 않습니다.예를 들어, 응용 프로그램 사용 mbsrlen 대신 mbslen에 대 한 이후의 호출 하는 경우, mbsrtowcs_s 대신 사용 된mbstowcs_s.

C + +에서이 함수를 사용 하 여 템플릿 오버 로드에 의해 단순화 됩니다. 오버 로드에서 버퍼 길이가 자동으로 유추할 수 있습니다 (size 인수를 지정할 필요가 없습니다) 및 해당 보안에서 이미지와 이전, 안전 하지 않은 함수가 자동으로 바꿀 수 있습니다.자세한 내용은 보안 템플릿 오버 로드를 참조하십시오.