_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

아티클
04/10/2013

현재 로캘을 사용 하 여 문자열을 대문자로 변환 하거나 지정 된 로케일에 전달 합니다.이러한 버전의 수 _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr 에 설명 된 대로 보안 향상 기능을 CRT의 보안 기능.

중요
_mbsupr_s및 _mbsupr_s_l Windows 런타임에서 실행 되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /zw에 지원 되는 CRT 함수.

errno_t _strupr_s(
   char *str,
   size_t numberOfElements
);
errno_t _wcsupr_s(
   wchar_t * str,
   size_t numberOfElements
);
errno_t _strupr_s_l(
   char * str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _wcsupr_s_l(
   wchar_t * str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _mbsupr_s(
   unsigned char *str,
   size_t numberOfElements
);
errno_t _mbsupr_s_l(
   unsigned char *str,
   size_t numberOfElements,
   _locale_t locale
);
template <size_t size>
errno_t _strupr_s(
   char (&str)[size]
); // C++ only
template <size_t size>
errno_t _wcsupr_s(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
errno_t _strupr_s_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _wcsupr_s_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _mbsupr_s(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
errno_t _mbsupr_s_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

매개 변수

str
대문자로 표시 하는 문자열입니다.
numberOfElements
버퍼의 크기입니다.
locale
사용 하는 로캘.

반환 값

성공 하는 경우에 0입니다. 실패 시는 0이 아닌 오류 코드입니다.

이러한 함수 매개 변수의 유효성을 검사 합니다.경우 str 되는 NULL 에 설명 된 대로 포인터에 잘못 된 매개 변수 처리기 호출 매개 변수 유효성 검사 .실행을 계속 하도록 허용 된 경우에 함수 반환 EINVAL 로 설정 하 고 errno 에 EINVAL.경우 numberOfElements 문자열의 길이 보다 짧으면 함수 반환 된 ERANGE 및 설정 errno 에 ERANGE.

설명

_strupr_s 내부에서 각 소문자 변환 함수 str 대문자입니다._wcsupr_s와이드 문자 버전인 _strupr_s._mbsupr_s멀티 바이트 문자 버전인 _strupr_s.

변환에 의해 결정 됩니다의 LC_CTYPE 로케일의 범주 설정입니다.다른 문자는 영향을 받지 않습니다.에 대 한 자세한 내용은 LC_CTYPE을 참조 하십시오 setlocale.없이 이러한 함수 버전을 _l 접미사 사용 현재 로케일입니다. 비전 생성과 비전 변경에는 _l 접미사는 대신 전달 된 로캘을 사용 하는 것을 제외 하 고 동일 합니다.자세한 내용은 로캘을 참조하십시오.

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

이러한 함수의 디버그 버전이 먼저 0xFD 사용 하 여 버퍼를 채웁니다.이 동작을 비활성화 하려면 _CrtSetDebugFillThreshold.

일반 텍스트 루틴 매핑