🚀 ADVPL – Retorna uma string de acordo array enviado. Conversão de array. Usado para IN
🔧
📌 Descrição
A função ArrTokStr é amplamente utilizada no ADVPL para converter arrays em strings formatadas. Ela é extremamente útil em cenários como:
✅ Montagem dinâmica de cláusulas IN
✅ Criação de filtros SQL (Query IN)
✅ Conversão e formatação de arrays em texto
💡 Essa função facilita a padronização e evita concatenações manuais, tornando o código mais limpo e legível.
🧩 Sintaxe
ArrTokStr( aStr, cDelimita, nTamLin )
⚙️ Parâmetros
| Par |
Nome |
Tipo |
Descrição |
Default |
| 01 |
aStr |
Array |
Array contendo os valores que serão convertidos em string |
{ } |
| 02 |
cDelimita |
Character |
Delimitador utilizado entre os elementos do array |
| |
| 03 |
nTamLin |
Numérico |
Tamanho máximo da linha gerada (0 para ilimitado) |
0 |
🔁 Retorno
| Retorno |
Tipo |
Descrição |
| cRet |
Caracter |
String formatada conforme os parâmetros informados |
💻 Exemplo
#INCLUDE "TOTVS.CH"
User Function ArrTokStr()
ArrTokStr( {'eurai','rapelli'}, "'(" )
Return( Nil )
ℹ️ Informações adicionais
✔️ Ideal para filtros dinâmicos
✔️ Evita erros de concatenação
✔️ Muito utilizado em queries SQL no Protheus
😎 Gostou?
Compartilhe com seus amigos, salve para consultas futuras e deixe seu comentário!
#advpl #totvs #protheus #workflow #array #sqlin #desenvolvimento #erp #programacao #backend #rotinas
