_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr
Преобразование строки в прописными буквами.Существуют более безопасные версии этих функций; см. раздел _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.
Важно |
---|
_mbsupr и _mbsupr_l нельзя использовать в приложениях, выполняемых в среды выполнения Windows.Дополнительные сведения см. в разделе Функции CRT не поддерживаются при /ZW. |
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 идентичны за исключением того, что они используют языковой стандарт, вместо этого в.Для получения дополнительной информации см. Языковой стандарт.
_wcsupr и _mbsupr — двубайтовая и многобайтовая символьные версии _strupr.Аргумент и возвращаемое значение _wcsupr характерные черты; одно из строки _mbsupr многобайтовой кодировки.В остальных случаях эти три функции ведут себя идентично.
Если указатель str, обработчик вызывается недопустимого параметра, как описано в разделе Проверка параметров.Если среда выполнения может продолжить, эти функции возвращают исходную строку и свойству errno задано значение EINVAL.
В C++, эти функции имеют перегруженные шаблонные версии, которые вызывают более новые и безопасные аналоги этих функций.Для получения дополнительной информации см. Предоставляйте перегруженный шаблона.
Универсальное текстовое сопоставление функций
Функция 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.