Split string

Split string ( stringAseparar ; string {; opções} ) : Collection

Parâmetro	Tipo		Descrição
stringAseparar	Text	→	Valor string
string	Text	→	String que stringAseparar separa. Se string vazia (""), cada caractere de stringAseparar é uma substring
opções	Integer	→	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

 var $vt : Text
 var $col : Collection
 $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:

 var $vt : Text
 var $col : Collection
 $vt:="NameSmithage40"
 $col:=Split string($vt;"")
  //$col=["Name","Smith","age","40"]

Ver também

TEXT TO ARRAY

Propriedades

Número do comando	1554
Thread-seguro	✓