_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

아티클
06/09/2015

현재 로캘 또는 전달 되는 지정된 로캘을 사용하여 대문자 문자열을 변환합니다. 이러한 버전의 _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++에서는 템플릿 오버로드로 인해 이러한 함수를 사용하는 것이 보다 간단해 집니다. 오버로드는 버퍼 길이를 자동으로 유추할 수 있으며(크기 인수를 지정할 필요가 없어짐), 기존의 비보안 함수를 보다 최신의 보안 대응 함수로 자동으로 바꿀 수 있습니다. 자세한 내용은 안전한 템플릿 오버로드을 참조하십시오.

이러한 함수의 디버그 버전은 우선 0xFD로 버퍼를 채웁니다. 이 동작을 사용하지 않으려면 _CrtSetDebugFillThreshold를 사용하십시오.

제네릭 텍스트 라우팅 매핑