Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

StrTokArr

StrTokArr(cText,cToken) -> aParts

Separa uma string em elementos de array.

StrTokArrAdvPL
01 · VISÃO GERAL

Visão geral

Cada caractere de cToken atua como delimitador independente. Assim, "::" não define necessariamente uma sequência indivisível; para separador composto, confira StrTokArr2. A fonte também informa interrupção no primeiro ASCII 0 da string. O exemplo evita campos vazios e usa delimitador simples, sem inferir regras de CSV, aspas ou escape. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

StrTokArr(cText,cToken) -> aParts

Parâmetros

cText
CaractereObrigatório

Texto de origem.

cToken
CaractereObrigatório

Caracteres delimitadores.

Retorno

Array de partes.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed676()
    Local aPartes := StrTokArr("A;B;C",";")
    // Uma posicao por token neste exemplo sem campos vazios.
    ConOut(Len(aPartes))
    ConOut(aPartes[2])
Return Nil
Resultado esperado

Exibe 3 e B. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Testar tokens vazios, delimitadores repetidos e entrada com NUL no build-alvo.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. StrTokArr. Sintaxe e observações. TDN. Consulta em 2026-10-28.
  2. Atilio. dan-atilio/AdvPL. Maratona de Exemplos/Exemplo_435_Funcoes_Separa_StrTokArr_e_StrTokArr2.prw. Arquivo completo consultado; adaptação editorial. Consulta em 2026-10-28.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha