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

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

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

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

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

: c = 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, пробелы берутся из внутреннего представления строк в строковом массиве (см. Массивы символов).

: C = char (A) ¶

: C = char (A, …) ¶

: C = char (str1, str2, …) ¶

: C = 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.

: C = strvcat (A) ¶

: C = strvcat (A, …) ¶

: C = strvcat (str1, str2, …) ¶

: C = 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.

: str = 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.

: str = cstrcat (s1, s2, …) ¶

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

Например:

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

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

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