TOTVSTEC

Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 2 Próxima »

 

 

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.

Sintaxe

StrTokArr2 ( < cValue>, < cToken>, [lEmptyStr] ) --> aRet

Parâmetros/Elementos

 

NomeTipoDescriçãoObrigatórioReferência
cValueCaracterIndica a string que será separada.X 
cTokenCaracterIndica um ou mais caracteres ( Token ) que serão utilizados como separadores.X 
lEmptyStrLógicoIndica se elementos vazios também devem ser retornados. Valor default = .F.  

 

Retorno
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.
  • A função StrTokArr2 está disponível apenas a partir da Build 7.00.131227A com data de geração superior a 08/09/2014.

 

Exemplos

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

 

Abrangência
Protheus 11, Protheus 12

 

 

 

 

  • Sem rótulos