join

Junta os elementos de um array de strings ou de texto em um único texto.

Categoria: Language Fundamentals > Data Types

Sintaxe

newStr = join(str)

Junta os elementos de str com um espaço entre eles.

newStr = join(str, delimiter)

Junta com delimiter entre os vizinhos.

Descrição

join é o inverso de split. Para um vetor, concatena todos os elementos em ordem; o delimitador vai só entre os elementos, nunca nas pontas. A classe do resultado segue a da entrada, então um cell array de vetores de caracteres dá um vetor de caracteres.

No MATLAB, join também combina duas tables casando variáveis-chave, como um join de banco de dados.

Argumentos de entrada

str
Array de strings ou cell array de vetores de caracteres.
delimiter
Texto colocado entre os elementos. O padrão é um espaço.

Argumentos de saída

newStr
Uma string quando str é um array de strings, ou um vetor de caracteres quando str é um cell array.

Exemplo

Juntando textos

join(["a", "b", "c"], "-")
join({'one', 'two', 'three'})
join({'x', 'y'}, ', ')
Saída
ans = "a-b-c"
ans = 'one two three'
ans = 'x, y'

Observações

O join do MatLivre funciona com texto e com duas tables. Uma matriz de strings é juntada com todos os elementos na ordem de armazenamento, não linha a linha.

Veja também

split strjoin strcat plus innerjoin