Split string

4D v19

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 case insensitive	Inteiro longo	2	As strings são comparadas segundo a linguagem atual dos dados sem levar em consideração as diferenças de maiúsculas e minúsculas. Note que os signos diacríticos são levados em consideração. Por exemplo, "A" é considerado a mesma coisa que "a". Entretanto "a" não é considerado o mesmo que "à" . Pode ser combinado com: sk char codes sk diacritic insensitive sk kana insensitive sk strict sk whole word (comando Position unicamente)
sk char codes	Inteiro longo	1	As strings são comparadas segundo os códigos de caracteres. Os parâmetros atuais da linguagem de dados não são levados em consideração durante a comparação. Pode ser combinada com: sk case insensitive Só para os intervalos "a-z" ou "A-Z". (por exemplo., Alpha = alpha, mas Alpha # âlphà)
sk diacritic insensitive	Inteiro longo	4	As strings são comparadas de acordo com a linguagem atual dos dados. Entretanto, os acentos ou símbolos das letras são ignorados. Por exemplo, "a" é considerado a mesma coisa que "à". Pode ser combinado com sk case insensitive sk kana insensitive sk strict sk width insensitive sk whole word (comando Position unicamente)
sk ignore empty strings	Inteiro longo	1	Remove strings vazias da coleção resultante (são ignorados)
sk kana insensitive	Inteiro longo	8	Para a linguagem japonesa. Strings são comparadas de acordo com o sentido (não o estilo de escrita) na linguagem de dados atual. por exemplo, "あ" em hiragana é considerada a mesma coisa que "ア" em katakana. Quando esta opção for estabelecida, sk width insensitive está implícito (considerado estabelecido), entretanto, o contrário não é verdade. Pode ser combinado com: sk case insensitive sk diacritic insensitive sk strict sk width insensitive
sk strict	Inteiro longo	0	Strings são comparadas para correspondências exatas de acordo com a linguagem atual. Na maioria dos casos, capitalização e marcas diacríticas de letras são levadas em consideração durante a comparação. Pode ser combinado com: sk case insensitive sk diacritic insensitive sk kana insensitive sk width insensitive
sk trim spaces	Inteiro longo	2	Retira os caracteres espaço no começo e fim das substrings
sk whole word	Inteiro longo	32	Strings são comparadas de acordo com a lingaugem de dados atual. Apenas strings que são palavras completas são consideradas. Strings correspondentes a outras strings não são consideradas. Por exemplo, "where" não é considerado quando encontrado dentro de "somewhere". Pode ser combinado com: sk case insensitive (Position apenas comandos) sk diacritic insensitive (Position apenas comandos)
sk width insensitive	Inteiro longo	16	Para a linguagem japonesa. Strings são comparadas por tamanho de caractere de acordo com a linguagem de dados atual. por exemplo, "ｱ" é considerado o mesmo que "ア". Can be combined with: sk case insensitive sk diacritic insensitive sk kana insensitive sk strict

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

collection.join( )
TEXT TO ARRAY