_memicmp, _memicmp_l

Статья
06/09/2015

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

int _memicmp(
   const void *buf1,
   const void *buf2,
   size_t count 
);
int _memicmp_l(
   const void *buf1,
   const void *buf2,
   size_t count,
   _locale_t locale
);

Параметры

buf1
Первый буфер.
buf2
Второй буфер.
count
Число символов,
locale
Языковой стандарт, который необходимо использовать.

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

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

Возвращаемое значение	Связь первых байтов количества первого и второго буферов
< 0	buf1 меньше чем buf2.
0	buf1 идентичен buf2.
> 0	Параметр buf1 больше значения свойства buf2.
_NLSCMPERROR	Произошла ошибка.

Заметки

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

Если buf1 или buf2 является указателем null, то функция вызывает обработчик недопустимого параметра, как описано в Проверка параметров. Если выполнение разрешено для продолжить, функция возвращает _NLSCMPERROR и задает errno в EINVAL.

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

Требования

Подпрограмма	Обязательный заголовок
_memicmp	<memory.h> или <string.h>
_memicmp_l	<memory.h> или <string.h>

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

Пример

// 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" );
}