_strupr, , _strupr_l_mbsupr_l_mbsupr_wcsupr_l,_wcsupr

Преобразует строку в верхний регистр. Доступны более безопасные версии этих функций; see_strupr_s, _strupr_s_l_wcsupr_s_l_mbsupr_s_wcsupr_s_mbsupr_s_l.

Синтаксис

char *_strupr(
   char *str
);
wchar_t *_wcsupr(
   wchar_t *str
);
unsigned char *_mbsupr(
   unsigned char *str
);
char *_strupr_l(
   char *str,
   _locale_t locale
);
wchar_t *_wcsupr_l(
   wchar_t *str,
   _locale_t locale
);
unsigned char *_mbsupr_l(
   unsigned char *str,
   _locale_t locale
);
template <size_t size>
char *_strupr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcsupr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbsupr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strupr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcsupr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbsupr_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

Параметры

str
Строка для преобразования букв.

locale
Используемый языковой стандарт.

Возвращаемое значение

Возвращает указатель на измененную строку. Так как изменение осуществляется на месте, возвращенный указатель совпадает с указателем, переданным в качестве входного аргумента. Нет зарезервированных возвращаемых значений для указания ошибки.

Замечания

Функция _strupr преобразует "на месте" каждую строчную букву в строке str в прописную. Преобразование определяется категорией LC_CTYPE языкового стандарта. Другие символы не затрагиваются. Дополнительные сведения о методе LC_CTYPE см. в разделе setlocale. Версии этих функций без суффикса _l используют текущий языковой стандарт. Версии с суффиксом _l идентичны им, но они используют языковой стандарт, переданный в качестве аргумента. Дополнительные сведения см. в разделе Locale.

Функции _wcsupr и _mbsupr являются версиями функции _strupr для расширенных и многобайтовых символов. Аргумент и возвращаемое значение _wcsupr являются строками расширенных символов. Аргумент и возвращаемое значение _mbsupr являются строками многобайтовых символов. В остальном эти три функции ведут себя идентично.

Если str имеет значение NULL, вызывается обработчик недопустимых параметров, как описано в разделе проверки параметров. Если продолжение выполнения разрешено, эти функции возвращают исходную строку и устанавливают для errno значение EINVAL.

В C++ эти функции имеют шаблонные перегрузки, которые вызывают более новые и безопасные аналоги этих функций. Дополнительные сведения см. в разделе "Безопасные перегрузки шаблонов".

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Требования

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

Пример см. в примере _strlwr.

См. также

Локаль
Обработка строк
_strlwr, , _wcslwr_strlwr_l_mbslwr_wcslwr_l,_mbslwr_l