5.3.4 Поиск в строках

Поскольку строка — это массив символов, сравнение строк выполняется по элементу, как показано в следующем примере:

GNU = "GNU's Not UNIX";
spaces = (GNU == " ")
     ⇒ spaces =
       0   0   0   0   0   1   0   0   0   1   0   0   0   0

Чтобы определить, равны ли две строки, необходимо использовать функцию strcmp. Она сравнивает полные строки и чувствительна к регистру. strncmp сравнивает только первые N символы (с N в качестве параметра). strcmpi и strncmpi — это соответствующие функции для сравнения без учёта регистра.

: strcmp (s1, s2) ¶

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

Если s1 или s2 является массивом ячеек строк, возвращается массив той же размерности, содержащий значения, описанные выше, для каждого элемента массива ячеек. Другим аргументом также может быть массив ячеек строк (той же размерности или с одним элементом), матрица char или строка.

Внимание: Для совместимости с MATLAB, функция strcmp Octave возвращает 1, если строковые значения равны, и 0 в противном случае. Это противоположно соответствующей функции библиотеки C.

См. также: strcmpi, strncmp, strncmpi.

: strncmp (s1, s2, n) ¶

Возвращает 1, если первые n символов строк s1 и s2 совпадают, и 0 в противном случае.

strncmp ("abce", "abcd", 3)
      ⇒ 1

Если s1 или s2 является массивом ячеек строк, возвращается массив той же размерности, содержащий значения, описанные выше, для каждого элемента массива ячеек. Другим аргументом также может быть массив ячеек строк (той же размерности или с одним элементом), матрица char или строка.

strncmp ("abce", {"abcd", "bca", "abc"}, 3)
     ⇒ [1, 0, 1]

Внимание: Для совместимости с MATLAB, функция strncmp Octave возвращает 1, если строковые значения равны, и 0 в противном случае. Это противоположно соответствующей функции библиотеки C.

См. также: strncmpi, strcmp, strcmpi.

: strcmpi (s1, s2) ¶

Возвращает 1, если строковые значения s1 и s2 совпадают без учёта регистра букв, и 0 в противном случае.

Если s1 или s2 является массивом ячеек строк, возвращается массив той же размерности, содержащий значения, описанные выше, для каждого элемента массива ячеек. Другим аргументом также может быть массив ячеек строк (той же размерности или с одним элементом), матрица char или строка.

Внимание: Для совместимости с MATLAB, функция strcmp Octave возвращает 1, если строковые значения равны, и 0 в противном случае. Это противоположно соответствующей функции библиотеки C.

Внимание: Национальные алфавиты не поддерживаются.

См. также: strcmp, strncmp, strncmpi.

: strncmpi (s1, s2, n) ¶

Возвращает 1, если первые n символов строк s1 и s2 совпадают без учёта регистра букв, и 0 в противном случае.

Если s1 или s2 является массивом ячеек строк, возвращается массив той же размерности, содержащий значения, описанные выше, для каждого элемента массива ячеек. Другим аргументом также может быть массив ячеек строк (той же размерности или с одним элементом), матрица char или строка.

Внимание: Для совместимости с MATLAB, функция strncmpi Octave возвращает 1, если строковые значения равны, и 0 в противном случае. Это противоположно соответствующей функции библиотеки C.

Внимание: Национальные алфавиты не поддерживаются.

См. также: strncmp, strcmp, strcmpi.

Несмотря на эти функции сравнения, существуют более специализированные функции для поиска индекса позиции шаблона поиска в строке.

: retval = startsWith (str, pattern) ¶

: retval = startsWith (str, pattern, "IgnoreCase", ignore_case) ¶

Проверяет, начинаются ли строки с шаблонов.

Возвращает массив логических значений, указывающих, какие строки в входном str (одиночная строка или массив ячеек строк) начинаются с входного pattern (одиночная строка или массив ячеек строк).

Если значение параметра "IgnoreCase" равно true, функция игнорирует регистр букв в str и pattern. По умолчанию сравнение чувствительно к регистру.

Примеры:

## one string and one pattern while considering case
startsWith ("hello", "he")
      ⇒  1


## one string and one pattern while ignoring case
startsWith ("hello", "HE", "IgnoreCase", true)
      ⇒  1


## multiple strings and multiple patterns while considering case
startsWith ({"lab work.pptx", "data.txt", "foundations.ppt"},
            {"lab", "data"})
      ⇒  1  1  0


## multiple strings and one pattern while considering case
startsWith ({"DATASHEET.ods", "data.txt", "foundations.ppt"},
            "data", "IgnoreCase", false)
      ⇒  0  1  0


## multiple strings and one pattern while ignoring case
startsWith ({"DATASHEET.ods", "data.txt", "foundations.ppt"},
            "data", "IgnoreCase", true)
      ⇒  1  1  0

См. также: endsWith, regexp, strncmp, strncmpi.

: retval = endsWith (str, pattern) ¶

: retval = endsWith (str, pattern, "IgnoreCase", ignore_case) ¶

Проверяет, заканчиваются ли строки шаблонами.

Возвращает массив логических значений, указывающих, какие строки в входном str (одиночная строка или массив ячеек строк) заканчиваются входным pattern (одиночная строка или массив ячеек строк).

Если значение параметра "IgnoreCase" равно true, функция игнорирует регистр букв в str и pattern. По умолчанию сравнение чувствительно к регистру.

Примеры:

## one string and one pattern while considering case
endsWith ("hello", "lo")
      ⇒  1


## one string and one pattern while ignoring case
endsWith ("hello", "LO", "IgnoreCase", true)
      ⇒  1


## multiple strings and multiple patterns while considering case
endsWith ({"tests.txt", "mydoc.odt", "myFunc.m", "results.pptx"},
          {".docx", ".odt", ".txt"})
      ⇒  1  1  0  0


## multiple strings and one pattern while considering case
endsWith ({"TESTS.TXT", "mydoc.odt", "result.txt", "myFunc.m"},
          ".txt", "IgnoreCase", false)
      ⇒  0  0  1  0


## multiple strings and one pattern while ignoring case
endsWith ({"TESTS.TXT", "mydoc.odt", "result.txt", "myFunc.m"},
          ".txt", "IgnoreCase", true)
      ⇒  1  0  1  0

См. также: startsWith, regexp, strncmp, strncmpi.

: findstr (s, t) ¶

: findstr (s, t, overlap) ¶

Эта функция устарела. Используйте strfind вместо неё.

Возвращает вектор всех позиций в большей из двух строк s и t, где начинается вхождение меньшей из двух строк.

Если необязательный аргумент overlap имеет значение true (по умолчанию), возвращаемый вектор может включать перекрывающиеся позиции. Например:

findstr ("ababab", "a")
     ⇒ [1, 3, 5];
findstr ("abababa", "aba", 0)
     ⇒ [1, 5]

Внимание: findstr устарела. Используйте strfind во всём новом коде.

См. также: strfind, strmatch, strcmp, strncmp, strcmpi, strncmpi, find.

: idx = strchr (str, chars) ¶

: idx = strchr (str, chars, n) ¶

: idx = strchr (str, chars, n, direction) ¶

: [i, j] = strchr (…) ¶

Ищет в строке str вхождения символов из набора chars.

Возвращаемое(ые) значение(я), а также аргументы n и direction ведут себя аналогично в find.

Это будет быстрее, чем использование regexp в большинстве случаев.

См. также: find.

: index (s, t) ¶

: index (s, t, direction) ¶

Возвращает позицию первого вхождения строки t в строке s или 0, если вхождение не найдено.

s также может быть строковой матрицей или массивом ячеек строк.

Например:

index ("Teststring", "t")
    ⇒ 4

Если direction — "first", возвращается первый найденный элемент. Если direction — "last", возвращается последний найденный элемент.

См. также: find, rindex.

: rindex (s, t) ¶

Возвращает позицию последнего вхождения символьной строки t в символьной строке s, или 0, если совпадение не найдено.

s также может быть массивом строк или ячейковым массивом строк.

Например:

rindex ("Teststring", "t")
     ⇒ 6

Функция rindex эквивалентна функции index со значением direction, установленным в "last".

См. также: find, index.

: idx = unicode_idx (str) ¶

Возвращает массив с индексами для каждого кодированного в UTF-8 символа в str.

unicode_idx ("aäbc")
     ⇒ [1, 2, 2, 3, 4]

: idx = strfind (str, pattern) ¶

: idx = strfind (cellstr, pattern) ¶

: idx = strfind (…, "overlaps", val) ¶

: idx = strfind (…, "forcecelloutput", val) ¶

Ищет pattern в строке str и возвращает начальный индекс каждого такого вхождения в векторе idx.

Если совпадение не найдено, или pattern длиннее str, или pattern пустое, тогда idx — пустой массив [].

Необязательный аргумент "overlaps" определяет, может ли шаблон соответствовать любой позиции в str (true), или только для уникальных вхождений полного шаблона (false). По умолчанию — true.

Если указан ячейковый массив строк cellstr, то idx — ячейковый массив векторов, как указано выше.

Необязательный аргумент "forcecelloutput" принудительно возвращает idx как ячейковый массив векторов. По умолчанию — false.

Примеры:

strfind ("abababa", "aba")
     ⇒ [1, 3, 5]


strfind ("abababa", "aba", "overlaps", false)
     ⇒ [1, 5]


strfind ({"abababa", "bebebe", "ab"}, "aba")
     ⇒
        {
          [1,1] =

             1   3   5

          [1,2] = [](1x0)
          [1,3] = [](1x0)
        }


strfind ("abababa", "aba", "forcecelloutput", true)
     ⇒
        {
          [1,1] =

             1   3   5
        }

См. также: regexp, regexpi, find.

: strmatch (s, A) ¶

: strmatch (s, A, "exact") ¶

Эта функция устарела. Используйте альтернативу, такую как strncmp или strcmp вместо неё.

Возвращает индексы элементов A, которые начинаются с строки s.

Второй аргумент A должен быть строкой, символьной матрицей или ячейковым массивом строк.

Если третий аргумент "exact" не указан, то s необходимо только соответствовать A до длины s. Конечные пробелы и нули в s и A игнорируются при поиске совпадений.

Например:

strmatch ("apple", "apple juice")
     ⇒ 1

strmatch ("apple", ["apple  "; "apple juice"; "an apple"])
     ⇒ [1; 2]

strmatch ("apple", ["apple  "; "apple juice"; "an apple"], "exact")
     ⇒ [1]

Внимание: strmatch устарела (и может давать неверные результаты в MATLAB при использовании с ячейковыми массивами строк). Используйте strncmp (обычный случай) или strcmp ("exact" случай) во всем новом коде. Другие возможные замены, в зависимости от приложения, включают regexp или validatestring.

См. также: strncmp, strcmp, regexp, strfind, validatestring.