std::strncmp

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Строки

Строки с завершающим нулём

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

basic_string_view (C++17)

char_traits

 

Однобайтовые строки с завершающим нулём

Функции
Манипуляции с символами
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
Преобразование в числовые форматы
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
Манипуляции со строками
strcpy strncpy strxfrm	strcat strncat
Проверка строки
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
Манипуляции с памятью
memchr memcmp memset	memcpy memmove
Разное
strerror

 

<tbody> </tbody>

Определено в заголовочном файле <cstring>
int strncmp( const char* lhs, const char* rhs, std::size_t count );

Сравнивает не более count символов двух массивов, возможно завершающихся нулём. Сравнение производится лексикографически. Символы, следующие за нулевым символом, не сравниваются.

Знак результата это знак разницы между значениями первой пары символов (оба интерпретируются как unsigned char), которые различаются в сравниваемых массивах.

Поведение не определено, когда доступ происходит за концом массива lhs или rhs. Поведение не определено, если lhs или rhs является нулевым указателем.

Параметры

lhs, rhs	—	указатели на массивы с, возможно, нулевым завершающим символом для сравнения
count	—	максимальное количество символов для сравнения

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

Отрицательное значение, если lhs находится перед rhs в лексикографическом порядке.

Ноль, если lhs и rhs равны или если count равно нулю.

Положительное значение, если lhs находится после rhs в лексикографическом порядке.

Примечание

Эта функция не зависит от локали, в отличие от std::strcoll и std::strxfrm.

Пример

Запустить этот код

#include <cstring>
#include <iostream>

void demo(const char* lhs, const char* rhs, int sz)
{
    const int rc = std::strncmp(lhs, rhs, sz);
    if (rc < 0)
        std::cout << "Первые " << sz << " символов ["
                  << lhs << "] предшествуют [" << rhs << "]\n";
    else if (rc > 0)
        std::cout << "Первые " << sz << " символов ["
                  << lhs << "] следуют за [" << rhs << "]\n";
    else
        std::cout << "Первые " << sz << " символов ["
                  << lhs << "] равны [" << rhs << "]\n";
}

int main()
{
    demo("Hello, world!", "Hello, everybody!", 13);
    demo("Hello, everybody!", "Hello, world!", 13);
    demo("Hello, everybody!", "Hello, world!", 7);
    demo("Hello, everybody!" + 12, "Hello, somebody!" + 11, 5);
}

Вывод:

Первые 13 символов [Hello, world!] следуют за [Hello, everybody!]
Первые 13 символов [Hello, everybody!] предшествуют [Hello, world!]
Первые 7 символов [Hello, everybody!] равны [Hello, world!]
Первые 5 символов [body!] равны [body!]

Смотрите также

strcmp	сравнивает две строки (функция)
wcsncmp	сравнивает определённое количество символов из двух широких строк (функция)
memcmp	сравнивает два буфера (функция)
strcoll	сравнивает две строки в соответствии с текущей локалью (функция)
Документация C по strncmp