strncmp

Сравните первые символы n (чувствительных к регистру) строк

Синтаксис

tf = strncmp(s1,s2,n)

Описание

пример

tf = strncmp(s1,s2,n) сравнивает первые символы n s1 и s2. Функция возвращает 1 (true), если эти два идентичны и 0 (false) в противном случае. Текст рассматривается идентичным, если размер и содержимое каждого являются тем же самым до первых символов n каждой части текста. Результат возврата tf имеет тип данных logical.

Первые два входных параметра могут быть любой комбинацией строковых массивов, векторов символов и массивов ячеек из символьных векторов.

Примеры

свернуть все

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

s1 = 'Kansas City, KS';
s2 = 'Kansas City, MO';
tf = strncmp(s1,s2,11)
tf = logical
   1

tf является 1, потому что оба вектора символов запускаются с 'Kansas City'.

Сравните эти два вектора символов с помощью strcmp.

tf = strcmp(s1,s2)
tf = logical
   0

tf является 0, потому что s1 и s2 заканчиваются различными символами.

Начиная в R2017a, можно создать строки с помощью двойных кавычек. Создайте массив строк, который содержит имена. Найдите имена, которые запускаются с 'Jean'.

s1 = ["Jacques";
      "Jean";
      "Jeanne";
      "Jean-Luc";
      "Julie"];
s2 = "Jean";

tf = strncmp(s1,s2,4)
tf = 5x1 logical array

   0
   1
   1
   1
   0

tf является 1 для всех имен, чьи сначала четырьмя символами является 'Jean'.

Также можно использовать функцию startsWith.

tf = startsWith(s1,s2)
tf = 5x1 logical array

   0
   1
   1
   1
   0

Входные параметры

свернуть все

Введите текст, с каждым входом, заданным как вектор символов, символьный массив, массив ячеек из символьных векторов или массив строк. Порядок входных параметров не влияет на результаты сравнения.

  • Если и s1 и s2 являются строковыми массивами или массивами ячеек из символьных векторов, то s1 и s2 должны быть одного размера, если один из них не является скаляром.

  • Если и s1 и s2 являются символьными массивами с несколькими строками, то s1 и s2 могут иметь различные количества строк.

  • При сравнении нескалярного массива ячеек из символьных векторов или массива строк к многострочному символьному массиву, массив ячеек или массив строк должны быть вектор-столбцом с одинаковым числом строк как символьный массив.

Типы данных: char | cell | string

Количество символов, чтобы выдержать сравнение, заданный как целое число.

  • Если n является 0, то strncmp всегда возвращает 1. Условно, нулевым символом вектора символов или скаляра строки всегда является '', 0-by-0 символьный массив.

  • Если n является меньше, чем 0, то strncmp обрабатывает его как 0.

  • Если n больше, чем длина самого короткого входного текста, то strncmp возвращает 0.

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Выходные аргументы

свернуть все

Истинный или ложный результат, возвращенный как 1 или 0 типа данных logical.

  • Если каждый вход является или скаляром строки или вектором символов, то tf является скаляром.

  • Если по крайней мере один вход является или массивом строк или массивом ячеек из символьных векторов, то tf является массивом тот же размер как входной массив.

  • Если один вход является символьным массивом с несколькими строками, и другой вход является или скалярной ячейкой или скаляром строки, то tf является n-by-1 массив, где n является количеством строк в символьном массиве.

  • Если оба входных параметров являются символьными массивами, то tf является скаляром.

Советы

  • Функция strncmp предназначается для сравнения текста. Если используется на числовых массивах, strncmp всегда возвращает 0.

  • Для нечувствительного к регистру текстового сравнения используйте strncmpi вместо strncmp.

  • Несмотря на то, что strncmp совместно использует имя с функцией C, он не следует соглашению языка C возврата 0, когда вводы текста соответствуют.

Расширенные возможности

Представлено до R2006a

Для просмотра документации необходимо авторизоваться на сайте