_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Статья
04/10/2013

Преобразование строки в нижний регистр.Существуют более безопасные версии этих функций; см. раздел _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.

Важно
_mbslwr и _mbslwr_l нельзя использовать в приложениях, выполняемых в среды выполнения Windows.Дополнительные сведения см. в разделе Функции CRT не поддерживаются при /ZW.

char *_strlwr(
   char * str
);
wchar_t *_wcslwr(
   wchar_t * str
);
unsigned char *_mbslwr(
   unsigned char * str
);
char *_strlwr_l(
   char * str,
   _locale_t locale
);
wchar_t *_wcslwr_l(
   wchar_t * str,
   _locale_t locale
);
unsigned char *_mbslwr_l(
   unsigned char * str,
   _locale_t locale 
);
template <size_t size>
char *_strlwr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcslwr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbslwr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strlwr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcslwr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbslwr_l(
   unsigned char (&str)[size],
   _locale_t locale 
); // C++ only

Параметры

str
Завершенная объединения строки, чтобы преобразовать в нижний регистр.
locale
Используемый языковой стандарт.

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

Каждая из этих функций возвращает указатель на преобразованной строке.Поскольку внесения изменений на месте, указатель возвращаемой аналогичен указатель передается в качестве аргумента.Возвращаемое значение не зарезервировано для отображения ошибки.

Заметки

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

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

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

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

Универсальное текстовое сопоставление функций

Функция TCHAR.H	неопределенные _UNICODE & _MBCS	определенные _MBCS	Определение _UNICODE
_tcslwr	_strlwr	_mbslwr	_wcslwr
_tcslwr_l	_strlwr_l	_mbslwr_l	_wcslwr_l

Требования

Функция	Требуемый заголовок
_strlwr, _strlwr_l	<string.h>
_wcslwr, _wcslwr_l	<string.h> или <wchar.h>
_mbslwr, _mbslwr_l	<mbstring.h>

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

Пример

// crt_strlwr.c
// compile with: /W3
// This program uses _strlwr and _strupr to create
// uppercase and lowercase copies of a mixed-case string.
#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[100] = "The String to End All Strings!";
   char * copy1 = _strdup( string ); // make two copies
   char * copy2 = _strdup( string );

   _strlwr( copy1 ); // C4996
   // Note: _strlwr is deprecated; consider using _strlwr_s instead
   _strupr( copy2 ); // C4996
   // Note: _strupr is deprecated; consider using _strupr_s instead

   printf( "Mixed: %s\n", string );
   printf( "Lower: %s\n", copy1 );
   printf( "Upper: %s\n", copy2 );

   free( copy1 );
   free( copy2 );
}