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

At

At( <cCaractere>, <cString> )

Retorna a primeira posição de um texto dentro de outra string.

StringsPesquisaTexto
01 · VISÃO GERAL

Visão geral

At() localiza a primeira ocorrência de um caractere ou trecho de texto dentro de uma string maior. Quando encontra, retorna a posição inicial; quando não encontra, o resultado deve ser tratado como ausência da ocorrência.

02 · SINTAXE

Sintaxe

At( <cCaractere>, <cString> )

Parâmetros

cCaractere
CaractereObrigatório

Caractere ou trecho procurado.

cString
CaractereObrigatório

Texto onde a busca será realizada.

03 · EXEMPLO PRÁTICO

Localizando separador

User Function ExAt()
    Local cEmail := "usuario@empresa.com"
    Local nPosicao := At("@", cEmail)

    If nPosicao > 0
        MsgInfo("Usuário: " + SubStr(cEmail, 1, nPosicao - 1))
    EndIf
Return
Resultado esperado

A posição do @ permite separar a parte do usuário antes do domínio.

BOAS PRÁTICAS
  • Combine com SubStr() para extrair partes depois de um separador.
  • Para localizar a última ocorrência, use Rat().
ARMADILHAS COMUNS
  • Sempre teste se a posição foi encontrada antes de usá-la em SubStr().
  • A busca é textual; padronize maiúsculas/minúsculas com Upper() ou Lower() quando necessário.

Conteúdos relacionados

REFERÊNCIAS
  1. Programação em ADVPL Completo. Documentação oficial histórica de treinamento, seção 4.5.4, p. 45-50. Conteúdo resumido, revisado e exemplos adaptados.
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