Split string

4D v20 R7

Split string


Split string ( stringAseparar ; string {; opções} ) -> Resultado

Parâmetro	Tipo	Descrição
stringAseparar	Texto	Valor string
string	Texto	String que stringAseparar separa. Se string vazia (""), cada caractere de stringAseparar é uma substring
opções	Inteiro longo	Opções referentes a strings vazias e espaços
Resultado	Collection	Coleção de substrings

Descrição

O comando Split string devolve uma coleção de strings, criada ao dividir stringAseparar em substrings nos limites especificados pelo parâmetro separador. As substrings na coleção devolvida não incluem o separador.

Se não encontrar um separador em stringAseparar, Split string devolve uma coleção que contém um elemento único, stringAseparar. Se passar uma string vazia em separador, Split string devolve uma coleção de cada caractere de stringAseparar.

No parâmetro opções, pode passar uma combinação das constantes abaixo do tema Strings:

Constante	Tipo	Valor	Comentário
sk ignore empty strings	Inteiro longo	1	Remove strings vazias da coleção resultante (são ignorados)
sk trim spaces	Inteiro longo	2	Retira os caracteres espaço no começo e fim das substrings

Exemplo 1

 C_TEXT($vt)

 C_COLLECTION($col)

 $col:=New collection

 

 $vt:="John;Doe;120 jefferson st.;Riverside;; NJ; 08075"

 $col:=Split string($vt;";") //["John","Doe","120 jefferson st.","Riverside",""," NJ"," 08075"]

 $col:=Split string($vt;";";sk ignore empty strings) //["John","Doe","120 jefferson st.","Riverside"," NJ"," 08075"]

 $col:=Split string($vt;";";sk ignore empty strings+sk trim spaces) //["John","Doe","120 jefferson st.","Riverside","NJ","08075"]

Exemplo 2

O parâmetro separador pode ser uma string de múltiplos caracteres:

 C_TEXT($vt)

 C_COLLECTION($col)

 $vt:="Name<tab>Smith<tab>age<tab>40"

 $col:=Split string($vt;"<tab>")

  //$col=["Name","Smith","age","40"]

Ver também

TEXT TO ARRAY