_memicmp, _memicmp_l

Сравнивает символы в двух буферах (без учета регистра).

Синтаксис

int _memicmp(
   const void *buffer1,
   const void *buffer2,
   size_t count
);
int _memicmp_l(
   const void *buffer1,
   const void *buffer2,
   size_t count,
   _locale_t locale
);

Параметры

buffer1
Первый буфер.

buffer2
Второй буфер.

count
Число символов.

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

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

Возвращаемое значение показывает связь между буферами.

Замечания

Функция _memicmp сравнивает первые символы (count) двух буферов buffer1 и buffer2 по байтам. Сравнение не учитывает регистр.

Если какой-либо buffer1 или buffer2 является пустым указателем, эта функция вызывает недопустимый обработчик параметров, как описано в разделе "Проверка параметров". Если выполнение может быть продолжено, функция возвращает _NLSCMPERROR и устанавливает для параметра errno значение EINVAL.

Функция _memicmp использует текущий языковой стандарт для аспектов поведения, обусловленных языковыми стандартами; функция _memicmp_l идентична за исключением того, что она использует переданный языковой стандарт. Дополнительные сведения см. в разделе Locale.

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

Требования

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

Пример

// crt_memicmp.c
// This program uses _memicmp to compare
// the first 29 letters of the strings named first and
// second without regard to the case of the letters.

#include <memory.h>
#include <stdio.h>
#include <string.h>

int main( void )
{
   int result;
   char first[] = "Those Who Will Not Learn from History";
   char second[] = "THOSE WHO WILL NOT LEARN FROM their mistakes";
   // Note that the 29th character is right here ^

   printf( "Compare '%.29s' to '%.29s'\n", first, second );
   result = _memicmp( first, second, 29 );
   if( result < 0 )
      printf( "First is less than second.\n" );
   else if( result == 0 )
      printf( "First is equal to second.\n" );
   else if( result > 0 )
      printf( "First is greater than second.\n" );
}

Compare 'Those Who Will Not Learn from' to 'THOSE WHO WILL NOT LEARN FROM'
First is equal to second.

См. также

Манипуляция буфером
_memccpy
memchr, wmemchr
memcmp, wmemcmp
memcpy, wmemcpy
memset, wmemset
_stricmp, , _wcsicmp_stricmp_l_mbsicmp_wcsicmp_l,_mbsicmp_l
_strnicmp, , _wcsnicmp_strnicmp_l_mbsnicmp_wcsnicmp_l,_mbsnicmp_l