cSearchCaractereObrigatório
Caractere ou sequência de caracteres que será procurada.
FUNçãOPublicado
At
At( <cSearch>, <cString> ) --> nPositionRetorna a primeira posição de uma sequência de caracteres dentro de outra string.
Visão geral
At() localiza a primeira ocorrência de um caractere ou trecho de texto dentro de uma string maior. O retorno é a posição inicial encontrada, usando contagem iniciada em 1. Quando a sequência não é encontrada, o retorno é 0. É uma função útil para validar separadores, extrair partes de textos estruturados e identificar se determinado marcador existe antes de aplicar SubStr().
Sintaxe
At( <cSearch>, <cString> ) --> nPositionParâmetros
cStringCaractereObrigatório
Texto onde a busca será realizada.
Localizando separador de e-mail
User Function ExAtEmail()
Local cEmail := "usuario@empresa.com"
Local nPosicao := At("@", cEmail)
If nPosicao > 0
MsgInfo("Usuário: " + SubStr(cEmail, 1, nPosicao - 1))
Else
MsgStop("E-mail sem separador @.")
EndIf
ReturnResultado esperado
A posição do @ permite separar a parte do usuário antes do domínio.
- Use At() quando precisar da primeira ocorrência de um separador ou marcador.
- Combine com SubStr() para extrair a parte anterior ou posterior ao texto encontrado.
- Para localizar a última ocorrência, use Rat().
- Teste o retorno maior que zero antes de usar a posição em cálculos de SubStr().
- O índice retornado começa em 1, não em 0 como em muitas linguagens modernas.
- Quando não encontra a sequência, At() retorna 0; usar esse valor diretamente em SubStr() tende a gerar regra incorreta.
- A busca é literal. Se houver variação de maiúsculas e minúsculas, normalize os textos com Upper() ou Lower().
- Para textos vindos de campos Character do Protheus, considere AllTrim() quando espaços à direita puderem interferir na regra.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.