Comando
SplitText()
Divide uma string por um separador e carrega as partes em uma variável de lista. Utilizado como fonte de dados para o Foreach(), iterando parte por parte. O separador pode ser um caractere único ou uma string multicaractere.
Propriedades disponíveis dentro do Foreach:
O separador é passado como string completa — útil para separadores de mais de um caractere como
Propriedades disponíveis dentro do Foreach:
$variavel.Count: total de partes$variavel.$Item: valor da parte atual (string)O separador é passado como string completa — útil para separadores de mais de um caractere como
|| ou , (vírgula e espaço). Sem RemoveEmptyEntries, separadores consecutivos geram itens vazios na lista.
SplitText(variavel, texto, separador [, RemoveEmptyEntries])Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
variavel | Sim | Nome da variável de lista. Deve começar com $. Ex: $partes. |
texto | Sim | Texto a dividir. Geralmente uma variável contendo o texto completo. |
separador | Sim | String separadora. Pode ser um caractere (',', ';', '\n') ou uma string multicaractere ('||', ', '). |
RemoveEmptyEntries | Não | Informe RemoveEmptyEntries para ignorar partes vazias resultantes de separadores consecutivos. Se omitido, partes vazias são mantidas. |
Exemplos
// Dividir lista separada por vírgula:
string $lista = 'maçã,banana,laranja,uva'
SplitText($frutas, $lista, ',', RemoveEmptyEntries)
Foreach ($frutas) {
Output($frutas.$Item)
}