5.3.1 Объединение строк

Строки можно объединять с помощью матричной записи (см. Строки, Массивы символов), что зачастую является наиболее естественным методом. Например:

fullname = [fname ".txt"];
email = ["<" user "@" domain ">"];

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

Функцию newline можно использовать для объединения строк таким образом, чтобы они отображались как несколько строк текста.

: newline

Возвращает символ новой строки.

Это эквивалентно "\n".

Пример кода

joined_string = [newline "line1" newline "line2"]
⇒
line1
line2

См. также: strcat, strjoin, strsplit.

Кроме того, существуют и другие функции для объединения объектов строк, которые могут быть полезны в определённых ситуациях: char, strvcat, strcat, и cstrcat. Наконец, можно использовать функции общего назначения для объединения: см. cat, horzcat и vertcat.

• Все функции объединения строк, кроме cstrcat, преобразуют числовой ввод в символьные данные, взяв соответствующий символ UTF-8 для каждого элемента (или многобайтовую последовательность), как показано в следующем примере:

  char ([98, 97, 110, 97, 110, 97])
     ⇒ banana

  Для преобразования между кодировками локалей и UTF-8 см. unicode2native и native2unicode.

• char и strvcat объединяют строки вертикально, в то время как strcat и cstrcat объединяют строки горизонтально. Например:

  char ("an apple", "two pears")
      ⇒ an apple
         two pears
  
  
  strcat ("oc", "tave", " is", " good", " for you")
       ⇒ octave is good for you

• char генерирует пустую строку в выводе для каждой пустой строки во входных данных. strvcat, с другой стороны, удаляет пустые строки.

  char ("orange", "green", "", "red")
      ⇒ orange
         green
  
         red
  
  
  strvcat ("orange", "green", "", "red")
      ⇒ orange
         green
         red

• Все функции объединения строк, кроме cstrcat, также принимают данные массива ячеек (см. Массивы ячеек). char и strvcat преобразуют массивы ячеек в массивы символов, в то время как strcat объединяет строки внутри ячеек массивов ячеек:

  char ({"red", "green", "", "blue"})
       ⇒ red
          green
  
          blue
  
  
  strcat ({"abc"; "ghi"}, {"def"; "jkl"})
       ⇒
          {
            [1,1] = abcdef
            [2,1] = ghijkl
          }

• strcat удаляет заключительные пробелы в аргументах (кроме массивов ячеек), в то время как cstrcat оставляет пробелы без изменений. Оба вида поведения могут быть полезны, как видно из примеров:

  strcat (["dir1";"directory2"], ["/";"/"], ["file1";"file2"])
       ⇒ dir1/file1
          directory2/file2
  
  
  cstrcat (["thirteen apples"; "a banana"], [" 5$";" 1$"])
        ⇒ thirteen apples 5$
           a banana        1$

  Обратите внимание, что в приведенном выше примере для cstrcat, пробелы берутся из внутренней представления строк в массиве строк (см. Массивы символов).

: char (x)

: char (x, …)

: char (s1, s2, …)

: char (cell_array)

Создаёт массив строк из одной или нескольких числовых матриц, матриц символов или массивов ячеек.

Аргументы объединяются вертикально. Возвращаемые значения дополняются пробелами по мере необходимости, чтобы каждая строка массива строк имела одинаковую длину. Пустые входные строки имеют значение и будут объединены в выводе.

Для числового ввода каждый элемент преобразуется в соответствующий символ ASCII. Ошибка диапазона возникает, если входной элемент находится вне диапазона ASCII (0-255).

Для массивов ячеек каждый элемент объединяется отдельно. Массивы ячеек, преобразованные с помощью char, в основном могут быть преобразованы обратно с помощью cellstr. Например:

char ([97, 98, 99], "", {"98", "99", 100}, "str1", ["ha", "lf"])
   ⇒ ["abc "
       "    "
       "98  "
       "99  "
       "d   "
       "str1"
       "half"]

См. также: strvcat, cellstr.

: strvcat (x)

: strvcat (x, …)

: strvcat (s1, s2, …)

: strvcat (cell_array)

Создаёт массив символов из одной или нескольких числовых матриц, матриц символов или массивов ячеек.

Аргументы объединяются вертикально. Возвращаемые значения дополняются пробелами по мере необходимости, чтобы каждая строка массива строк имела одинаковую длину. В отличие от char, пустые строки удаляются и не появятся в выводе.

Для числового ввода каждый элемент преобразуется в соответствующий символ ASCII. Ошибка диапазона возникает, если входной элемент находится вне диапазона ASCII (0-255).

Для массивов ячеек каждый элемент объединяется отдельно. Массивы ячеек, преобразованные с помощью strvcat, в основном могут быть преобразованы обратно с помощью cellstr. Например:

strvcat ([97, 98, 99], "", {"98", "99", 100}, "str1", ["ha", "lf"])
      ⇒ ["abc "
          "98  "
          "99  "
          "d   "
          "str1"
          "half"]

См. также: char, strcat, cstrcat.

: strcat (s1, s2, …)

Возвращает строку, содержащую все аргументы, объединённые горизонтально.

Если аргументы являются строками массива ячеек, strcat возвращает строку массива ячеек с объединёнными отдельными ячейками. Для числового ввода каждый элемент преобразуется в соответствующий символ ASCII. Заключительные пробелы для любого ввода символьной строки удаляются перед объединением строк. Обратите внимание, что значения строковых массивов ячеек не обрезаются от пробелов.

Например:

strcat ("|", " leading space is preserved", "|")
    ⇒ | leading space is preserved|

strcat ("|", "trailing space is eliminated ", "|")
    ⇒ |trailing space is eliminated|

strcat ("homogeneous space |", "  ", "| is also eliminated")
    ⇒ homogeneous space || is also eliminated

s = [ "ab"; "cde" ];
strcat (s, s, s)
    ⇒
        "ababab   "
        "cdecdecde"

s = { "ab"; "cd " };
strcat (s, s, s)
    ⇒
        {
          [1,1] = ababab
          [2,1] = cd cd cd
        }

См. также: cstrcat, char, strvcat.

: cstrcat (s1, s2, …)

Возвращает строку, содержащую все аргументы, объединённые горизонтально с сохранением заключительных пробелов.

Например:

cstrcat ("ab   ", "cd")
      ⇒ "ab   cd"

s = [ "ab"; "cde" ];
cstrcat (s, s, s)
      ⇒ "ab ab ab "
         "cdecdecde"

См. также: strcat, char, strvcat.