5.3.3 Разбиение и объединение строк

: str = substr (s, offset)

: substr (s, offset, len)

Возвращает подстроку s, которая начинается с символа под номером offset и имеет длину len символов.

Нумерация позиций смещений начинается с 1. Если offset отрицательно, извлечение начинается на таком расстоянии от конца строки.

Если len не указано, подстрока продолжается до конца s. Отрицательное значение len извлекает строку до позиции, находящейся на расстоянии len символов от конца строки.

Примеры:

substr ("This is a test string", 6, 9)
     ⇒ "is a test"
substr ("This is a test string", -11)
     ⇒ "test string"
substr ("This is a test string", -11, -7)
     ⇒ "test"

Эта функция создана по образцу эквивалентной функции в Perl.

: [tok, rem] = strtok (str)

: [tok, rem] = strtok (str, delim)

Находит все символы строки str вплоть до первого символа, входящего в строку delim, не включая этот символ.

str также может быть массивом ячеек со строками; в этом случае функция выполняется для каждой отдельной строки и возвращает массив ячеек с токенами и остатками строк.

Начальные разделители игнорируются. Если delim не указано, предполагается, что разделителем являются пробельные символы.

Если запрошен аргумент rem, он содержит остаток строки, начиная с первого разделителя.

Примеры:

strtok ("this is the life")
     ⇒ "this"

[tok, rem] = strtok ("14*27+31", "+-*/")
     ⇒
        tok = 14
        rem = *27+31

См. также: index, strsplit, strchr, isspace.

: [cstr] = strsplit (str)

: [cstr] = strsplit (str, del)

: [cstr] = strsplit (…, name, value)

: [cstr, matches] = strsplit (…)

Разбивает строку str с помощью разделителей, заданных в del, и возвращает массив ячеек с подстроками.

Если разделитель не указан, строка разбивается по пробельным символам {" ", "\f", "\n", "\r", "\t", "\v"}. В противном случае del должен быть строкой или массивом ячеек со строками. По умолчанию последовательные разделители во входной строке s объединяются в один, в результате чего выполняется одно разбиение.

Поддерживаются следующие аргументы в виде пар name/value:

• collapsedelimiters, которому можно присвоить значение true (по умолчанию) или false.
• delimitertype, которому можно присвоить значение "simple" (по умолчанию) или "regularexpression". Простой разделитель точно соответствует указанному тексту. В противном случае используется синтаксис регулярных выражений, описанный в regexp.

Необязательный второй выходной аргумент matches возвращает разделители, найденные в исходной строке.

Примеры с простыми разделителями:

strsplit ("a b c")
      ⇒
          {
            [1,1] = a
            [1,2] = b
            [1,3] = c
          }

strsplit ("a,b,c", ",")
      ⇒
          {
            [1,1] = a
            [1,2] = b
            [1,3] = c
          }

strsplit ("a foo b,bar c", {" ", ",", "foo", "bar"})
      ⇒
          {
            [1,1] = a
            [1,2] = b
            [1,3] = c
          }

strsplit ("a,,b, c", {",", " "}, "collapsedelimiters", false)
      ⇒
          {
            [1,1] = a
            [1,2] =
            [1,3] = b
            [1,4] =
            [1,5] = c
          }

Примеры с разделителями в виде регулярных выражений:

strsplit ("a foo b,bar c", ',|\s|foo|bar', ...
          "delimitertype", "regularexpression")
⇒
{
            [1,1] = a
            [1,2] = b
            [1,3] = c
}

strsplit ("a,,b, c", '[, ]', "collapsedelimiters", false, ...
          "delimitertype", "regularexpression")
⇒
{
            [1,1] = a
            [1,2] =
            [1,3] = b
            [1,4] =
            [1,5] = c
}

strsplit ("a,\t,b, c", {',', '\s'}, "delimitertype", "regularexpression")
⇒
{
            [1,1] = a
            [1,2] = b
            [1,3] = c
}

strsplit ("a,\t,b, c", {',', ' ', '\t'}, "collapsedelimiters", false)
⇒
{
            [1,1] = a
            [1,2] =
            [1,3] =
            [1,4] = b
            [1,5] =
            [1,6] = c
}

См. также: ostrsplit, strjoin, strtok, regexp.

: [cstr] = ostrsplit (s, sep)

: [cstr] = ostrsplit (s, sep, strip_empty)

Разбивает строку s с помощью одного или нескольких разделителей sep и возвращает массив ячеек со строками.

Последовательные разделители, а также разделители в начале и конце строки приводят к появлению пустых строк, если только strip_empty не равно true. Значение strip_empty по умолчанию — false.

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

Пример:

ostrsplit ("a,b,c", ",")
      ⇒
          {
            [1,1] = a
            [1,2] = b
            [1,3] = c
          }

ostrsplit (["a,b" ; "cde"], ",")
      ⇒
          {
            [1,1] = a
            [1,2] = b
            [1,3] = cde
          }

См. также: strsplit, strtok.

: str = strjoin (cstr)

: str = strjoin (cstr, delimiter)

Объединяет элементы массива ячеек со строками cstr в одну строку.

Если delimiter не указан, элементы cstr разделяются пробелом.

Если delimiter задан как строка, массив ячеек со строками объединяется с использованием этой строки. Поддерживаются escape-последовательности.

Если delimiter — это массив ячеек со строками, длина которого на единицу меньше длины cstr, элементы cstr объединяются путем чередования с элементами массива ячеек delimiter. Escape-последовательности не поддерживаются.

strjoin ({'Octave','Scilab','Lush','Yorick'}, '*')
      ⇒ 'Octave*Scilab*Lush*Yorick'

См. также: strsplit.