Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNPublicado

At

At( <cSearch>, <cString> ) --> nPosition

Devuelve la primera posición de un texto dentro de otra string.

StringsBúsquedaTextoLocalizaçãoFunções essenciais
01 · DESCRIPCIÓN GENERAL

Descripción general

Devuelve la primera posición de un texto dentro de otra string. Esta página fue creada a partir del material histórico de capacitación y organizada para consulta rápida, con notas prácticas y uso cuidadoso en entornos Protheus actuales.

02 · SINTAXIS

Sintaxis

At( <cSearch>, <cString> ) --> nPosition

Parámetros

cSearch
CarácterObligatorio

Parámetro utilizado por la función. Consulta la página fuente en portugués para la redacción original detallada mientras esta entrada esté en revisión.

cString
CarácterObligatorio

Parámetro utilizado por la función. Consulta la página fuente en portugués para la redacción original detallada mientras esta entrada esté en revisión.

03 · EJEMPLO PRÁCTICO

Ubicando separador de correo

User Function ExAtCorreo()
    Local cCorreo := "usuario@empresa.com"
    Local nPosicion := At("@", cCorreo)

    If nPosicion > 0
        MsgInfo("Usuario: " + SubStr(cCorreo, 1, nPosicion - 1))
    Else
        MsgStop("Correo sin separador @.")
    EndIf
Return
Resultado esperado

La posición de @ permite separar el usuario antes del dominio.

BUENAS PRÁCTICAS
  • 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().
ERRORES COMUNES
  • Esta entrada está en revisión porque fue estructurada a partir de material histórico de capacitación.
  • Confirma el comportamiento en la versión de Protheus/AppServer utilizada en tu entorno.

Contenido relacionado

REFERENCIAS
  1. TOTVS. At. TOTVSTEC / TDN. Referencia oficial de la función de ubicación de la primera ocurrencia en una cadena.
  2. Programação em ADVPL Completo. Material de capacitación registrado en la documentación oficial, sección 4.5.4, p. 45-50. Contenido resumido, revisado y ejemplos adaptados.
Estado
Publicado
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha