Share via

AT( ) (Función)

  • Artículo

Devuelve la posición numérica inicial de la primera aparición de una expresión de caracteres o de un campo memo en otra expresión de caracteres o campo memo; se cuenta desde el carácter situado más a la izquierda.

AT(cSearchExpression, cExpressionSearched [, nOccurrence])

Valores devueltos

Numeric

Parámetros

  • cSearchExpression
    Especifica la expresión de caracteres que AT( ) busca en cExpressionSearched.

  • cExpressionSearched
    Especifica la expresión de caracteres en que se busca la expresión indicada por cSearchExpression.

    Tanto cSearchExpression como cExpressionSearched pueden ser campos memo de cualquier tamaño.

  • nOccurrence
    Especifica qué aparición (primera, segunda, tercera, etc.) de cSearchExpression se busca en cExpressionSearched. De forma predeterminada, AT( ) busca la primera aparición de cSearchExpression (nOccurrence = 1). Si incluye nOccurrence, podrá buscar otras apariciones adicionales de cSearchExpression en cExpressionSearched. AT( ) devolverá 0 si nOccurrence es mayor que el número de veces que cSearchExpression aparece en cExpressionSearched.

Observaciones

AT( ) busca en la segunda expresión de caracteres la primera aparición de la primera expresión de caracteres. Luego devuelve un valor entero que indica la posición del primer carácter de la expresión de caracteres encontrada. Si la expresión de caracteres no se encuentra, AT( ) devolverá 0.

La búsqueda realizada por AT( ) distingue mayúsculas de minúsculas. Para realizar una búsqueda que no distinga entre ambas, utilice ATC( ).

Ejemplo

STORE 'Now is the time for all good men' TO gcString
STORE 'is the' TO gcFindString
CLEAR
? AT(gcFindString,gcString)  && Displays 5
STORE 'IS' TO gcFindString
? AT(gcFindString,gcString)  && Displays 0, case-sensitive

Vea también

AT_C( ) | ATC( ) | ATCLINE( ) | ATLINE( ) | LEFT( ) | RAT( ) | RATLINE( ) | RIGHT( ) | SUBSTR( ) | ATCC( ) | LEFTC( ) | RIGHTC( ) | SUBSTRC( ) | $ (Operador) | OCCURS( ) | INLIST( )