Função: StrTokArr2
Retorna um array, de acordo com os dados passados como parâmetro à função. Desta forma, a função receberá uma string e uma sequência de um ou mais caracteres, que representa um separador, onde cada porção da string entre as ocorrências do separador será um elemento do array retornado.
StrTokArr2 ( < cValue>, < cToken>, [lEmptyStr] ) --> aRet
Nome | Tipo | Descrição | Obrigatório | Referência |
cValue | Caracter | Indica a string que será separada. | X | |
cToken | Caracter | Indica um ou mais caracteres ( Token ) que serão utilizados como separadores. | X | |
lEmptyStr | Lógico | Indica se elementos vazios também devem ser retornados. Valor default = .F. |
aRet
- (vetor)
- Retorna um array de caracteres que representa a string passada como parâmetro tokenizada pelo separador informado.
- A função StrTokArr2() considera a sequencia de caracteres informada em cToken como um separador, enquanto a função StrTokArr() considera cada caractere informado em cToken como um separador.
- A função StrTokArr2() ignora qualquer ocorrência de ASCII 0 na string informada como parâmetro, podendo ser utilizada para tokenização de strings com caracteres especiais e de controle.
User Function Exemplo()
//+----------------------------------------------------------------------------+
//|Exemplifica o uso da função StrTokArr2 |
//|Depende da função varinfo() do framework do ERP |
//|O resultado com o retorno da função será gerado no log de console |
//+----------------------------------------------------------------------------+
varinfo("a1",strtokarr("A," ,",")) //retorna {"A"}
varinfo("a2",strtokarr(",B" ,",")) //retorna {"B"}
varinfo("a3",strtokarr("," ,",")) //retorna {}
varinfo("a4",strtokarr("A,,B" ,",")) //retorna {"A","B"}
varinfo("a5",strtokarr("A,,,B" ,",")) //retorna {"A","B"}
varinfo("a6",strtokarr("ABRACADABRA" ,"BRA")) //retorna {"A","CADA"}
varinfo("a1",strtokarr("A," ,",",.t.)) //retorna {"A",""}
varinfo("a2",strtokarr(",B" ,",",.t.)) //retorna {"","B"}
varinfo("a3",strtokarr("," ,",",.t.)) //retorna {"",""}
varinfo("a4",strtokarr("A,,B" ,",",.t.)) //retorna {"A","","B"}
varinfo("a5",strtokarr("A,,,B" ,",",.t.)) //retorna {"A","","","B"}
varinfo("a6",strtokarr("ABRACADABRA" ,"BRA",.t.)) //retorna {"A","CADA",""}
MsgInfo("Verifique o resultado no log de console.", "StrTokArr2 - Exemplo")
Return
Protheus 11, Protheus 12
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas