_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
.
Внимание
Функции _mbsupr
и _mbsupr_l
не могут использоваться в приложениях, запускаемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.
Синтаксис
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.
Сопоставления подпрограмм универсального текста
Подпрограмма TCHAR.H | _UNICODE и _MBCS не определен |
_MBCS Определенные |
_UNICODE Определенные |
---|---|---|---|
_tcsupr |
_strupr |
_mbsupr |
_wcsupr |
_tcsupr_l |
_strupr_l |
_mbsupr_l |
_wcsupr_l |
Требования
Маршрут | Обязательный заголовок |
---|---|
_strupr , _strupr_l |
<string.h> |
_wcsupr , _wcsupr_l |
<string.h> или <wchar.h> |
_mbsupr , _mbsupr_l |
<mbstring.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость.
Пример
Пример см. в примере _strlwr
.
См. также
Локаль
Обработка строк
_strlwr
, , _wcslwr
_strlwr_l
_mbslwr
_wcslwr_l
,_mbslwr_l