strncmp, , wcsncmp_mbsncmp_mbsncmp_l

Сравнивает символы двух строк вплоть до указанного количества.

Синтаксис

int strncmp(
   const char *string1,
   const char *string2,
   size_t count
);
int wcsncmp(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count
);
int _mbsncmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count
);
int _mbsncmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);int _mbsnbcmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count
);

Параметры

string1, string2
Строки для сравнения.

count
Число сравниваемых символов.

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

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

Возвращаемое значение отражает взаимосвязь подстрок string1 и string2, как показано ниже.

При ошибке _mbsncmp проверки параметров и _mbsncmp_l возврате _NLSCMPERROR, который определен в <string.h> и <mbstring.h>.

Замечания

Функция strncmp выполняет порядковое сравнение не более чем count первых символов в string1 и string2 и возвращает значение, указывающее отношение между подстроками. strncmp — чувствительная к регистру версия _strnicmp. wcsncmp и _mbsncmp — чувствительные к регистру версии _wcsnicmp и _mbsnicmp.

Функции wcsncmp и _mbsncmp являются версиями функции strncmp для расширенных и многобайтовых символов. Аргументы wcsncmp являются строками расширенных символов. Аргументы _mbsncmp являются строками многобайтовых символов. _mbsncmp распознает последовательности многобайтовых символов в соответствии с многобайтовой кодовой страницей и возвращает _NLSCMPERROR при ошибке.

Кроме того, функции _mbsncmp и _mbsncmp_l проверяют свои параметры. Если string1 или string2 является пустым указателем и count не равен 0, вызывается обработчик недопустимых параметров, как описано в разделе проверки параметров. Если выполнение может быть продолжено, то функции _mbsncmp и _mbsncmp_l возвращают ошибку _NLSCMPERROR и устанавливают для errno значение EINVAL. strncmp и wcsncmp не проверяйте их параметры. В остальном эти функции ведут себя одинаково.

Способ сравнения _mbsncmp и _mbsncmp_l зависит от настройки категории LC_CTYPE языкового стандарта. Эта категория определяет обнаружение начальных и конечных байтов в многобайтовых символах. Дополнительные сведения см. в разделе setlocale. Функция _mbsncmp использует текущий языковой стандарт для данной функциональности, зависящей от языкового стандарта. Функция _mbsncmp_l идентична за исключением того, что она использует вместо этого параметр locale. Дополнительные сведения см. в разделе Locale. Если языковой стандарт является однобайтовым, поведение этих функций идентично поведению strncmp.

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

Сопоставления подпрограмм универсального текста

Требования

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

Пример

// crt_strncmp.c
#include <string.h>
#include <stdio.h>

char string1[] = "The quick brown dog jumps over the lazy fox";
char string2[] = "The QUICK brown fox jumps over the lazy dog";

int main( void )
{
   char tmp[20];
   int result;
   printf( "Compare strings:\n      %s\n      %s\n\n",
           string1, string2 );
   printf( "Function:   strncmp (first 10 characters only)\n" );
   result = strncmp( string1, string2 , 10 );
   if( result > 0 )
      strcpy_s( tmp, sizeof(tmp), "greater than" );
   else if( result < 0 )
      strcpy_s( tmp, sizeof(tmp), "less than" );
   else
      strcpy_s( tmp, sizeof(tmp), "equal to" );
   printf( "Result:      String 1 is %s string 2\n\n", tmp );
   printf( "Function:   strnicmp _strnicmp (first 10 characters only)\n" );
   result = _strnicmp( string1, string2, 10 );
   if( result > 0 )
      strcpy_s( tmp, sizeof(tmp), "greater than" );
   else if( result < 0 )
      strcpy_s( tmp, sizeof(tmp), "less than" );
   else
      strcpy_s( tmp, sizeof(tmp), "equal to" );
   printf( "Result:      String 1 is %s string 2\n", tmp );
}

Compare strings:
      The quick brown dog jumps over the lazy fox
      The QUICK brown fox jumps over the lazy dog

Function:   strncmp (first 10 characters only)
Result:      String 1 is greater than string 2

Function:   strnicmp _strnicmp (first 10 characters only)
Result:      String 1 is equal to string 2

См. также

Обработка строк
Локаль
Интерпретация последовательностей многобайтовых символов
_mbsnbcmp, _mbsnbcmp_l
_mbsnbicmp, _mbsnbicmp_l
strcmp, , wcscmp_mbscmp
Функции strcoll
_strnicmp, , _wcsnicmp_strnicmp_l_mbsnicmp_wcsnicmp_l,_mbsnicmp_l
strrchr, , wcsrchr_mbsrchr_mbsrchr_l
_strset, , _strset_l_wcsset_l_wcsset_mbsset,_mbsset_l
strspn, , wcsspn_mbsspn_mbsspn_l