Share via


split()

A split() função usa uma cadeia de caracteres e a divide em subcadeias de caracteres com base em um delimitador especificado, retornando as subcadeias de caracteres em uma matriz. Opcionalmente, você pode recuperar uma subcadeia de caracteres específica especificando seu índice.

Syntax

split(Fonte,delimitador [,requestedIndex])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
source string ✔️ A cadeia de caracteres de origem que é dividida de acordo com o delimitador especificado.
delimiter string ✔️ O delimitador que será usado para dividir a cadeia de caracteres de origem.
requestedIndex int Um índice baseado em zero. Se fornecida, a matriz de cadeia de caracteres retornada conterá a subcadeia de caracteres solicitada no índice, se ela existir.

Retornos

Uma matriz de subcadeias de caracteres obtida separando a cadeia de caracteres de origem pelo delimitador especificado ou uma única subcadeia de caracteres no RequestedIndex especificado.

Observação

Para manipular ainda mais a matriz resultante, consulte acessadores de objetos dinâmicos.

Exemplos

print
    split("aa_bb", "_"),           // ["aa","bb"]
    split("aaa_bbb_ccc", "_", 1),  // ["bbb"]
    split("", "_"),                // [""]
    split("a__b", "_"),            // ["a","","b"]
    split("aabbcc", "bb")          // ["aa","cc"]
print_0 print_1 print_2 print_3 print4
["aa","bb"] ["bbb"] [""] ["a","","b"] ["aa","cc"]