lang • split

Split

StringArray = Split ( String [ , Separators , Escape , IgnoreVoid , KeepEscape ] )

Divide uma string em substrings delimitadas por separadores e caracteres de escape.

  • String é a string para dividir.

  • Separators é uma lista de caracteres de separação.

  • Escape é um caractere de escape. Qualquer caracteres separadores fechados entre dois caracteres de escape são ignorados no processo de divisão. Se Escape contém dois caracteres, então o primeiro é o caractere de de escape Inicial,e o segundo é o caractere Final.

  • IgnoreVoids é um booleano que indica a Split() para não retornar elementos nulos.

  • KeepEscape é um booleano que indica para manter os caracteres de escape encontrados nas strings retornadas.

Esta função retorna uma matriz de strings preenchida com cada substring detectada. Separadores e caracteres de escape não são retornados.

Por padrão, o caractere vírgula é o separador, e não há caracteres de escape.

Se uma string contém caracteres de escape, então estes caracteres de escape devem ser duplicados.

Separador e caracteres de escape são apenas caracteres ASCII individuais de um byte. Você não pode usar esta função para dividir uma string com um caractere não-ASCII ou uma outra string.

Por exemplo: Split(MyString, "\r\n") irá dividir MyString usando "\r" ou "\n" como separador, mas não a string completa "\r\n".

Exemplos

Dim Elt As String[]
Dim Sb As String

Elt = Split(" Gambas Almost Means BASIC  !\n'Você concorda?'", " \n", "'")

FOR EACH Sb IN Elt
  PRINT "("; Sb; ") ";
NEXT
PRINT

() (Gambas) (Almost) (Means) (BASIC) () (!) (Você concorda?)
Elt = Split(" Gambas Almost Means BASIC  !\n'Você concorda?'", " \n", "'", TRUE)

FOR EACH Sb IN Elt
  PRINT "("; Sb; ") ";
NEXT
PRINT

(Gambas) (Almost) (Means) (BASIC) (!) (Você concorda?)
Elt = Split("(Gambas) (Almost) (Means) (BASIC) (!) (Você concorda?)", " ", "()")

FOR EACH Sb IN Elt
  PRINT Sb; ".";
NEXT
PRINT

Gambas.Almost.Means.BASIC.!.Você concorda?.

Veja também