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"]