`split`

Divide um texto em partes separadas nos delimitadores.

Categoria: Language Fundamentals > Data Types

Sintaxe

C = split(str)

Divide nos espaços em branco.

C = split(str, delim)

Divide no delimitador delim, ou em qualquer um de vários delimitadores dados como array.

C = split(___, 'CollapseDelimiters', tf)

Controla se delimitadores adjacentes contam como um.

[C, matches] = split(___)

Também retorna os delimitadores encontrados.

Descrição

split sempre retorna uma parte a mais do que o número de delimitadores encontrados. Para uma entrada em array, as partes ficam ao longo de uma nova dimensão. Por padrão delimitadores adjacentes são tratados como um só, então "a--b" dividido em "-" dá a e b. Para dividir em vários caracteres diferentes, passe um string array como [",", ";"].

A saída é um string array quando a entrada é string e um cell array quando é vetor de caracteres. strsplit é o equivalente mais antigo para vetores de caracteres.

Argumentos de entrada

str: String array, vetor de caracteres ou cell array de vetores de caracteres.
delim: Texto delimitador, array de delimitadores ou um padrão.

Argumentos de saída

C: Para uma única string, um string array coluna com as partes; para um vetor de caracteres, um cell array.
matches: Os delimitadores que separaram as partes.

Exemplo

split("a,b,c", ",")
split("one two three")
split("a1b2c", ["1","2"])

Saída

ans = 3×1 string array

    "a"
    "b"
    "c"
ans = 3×1 string array

    "one"
    "two"
    "three"
ans = 3×1 string array

    "a"
    "b"
    "c"

Observações

No MatLivre o padrão de 'CollapseDelimiters' não é aplicado (delimitadores adjacentes geram partes vazias) e a segunda saída matches não está disponível.

Veja também

strsplit splitlines join regexp extractBefore strtok