Share via

ATLINE( ) (Función)

  • Artículo

Devuelve el número de línea de la primera aparición de una expresión de caracteres o campo memo dentro de otra expresión de caracteres o campo memo, a partir de la primera línea.

ATLINE(cSearchExpression, cExpressionSearched)

Valores devueltos

Numeric

Parámetros

  • cSearchExpression
    Especifica la expresión de caracteres que Microsoft Visual FoxPro 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.

    Utilice MLINE( ) para devolver como una cadena de caracteres la línea que contiene la expresión de caracteres coincidente.

    Sugerencia   ATLINE( ) ofrece una forma muy útil de buscar en los campos memo.

Observaciones

ATLINE( ) busca en la segunda expresión de caracteres la aparición de la primera expresión de caracteres. Al examinar las expresiones, ATLINE( ) tiene en cuenta si los caracteres están en mayúsculas o en minúsculas. Utilice ATCLINE( ) para realizar una búsqueda que no distinga mayúsculas y minúsculas.

Si la búsqueda se realiza con éxito, ATLINE( ) devolverá el número de la línea donde se produce la coincidencia. Si la búsqueda no se realiza con éxito, ATLINE( ) devolverá 0.

El número de línea que devuelve ATLINE( ) está determinado por el valor de SET MEMOWIDTH, aunque cExpressionSearched no sea un campo memo. Para obtener más información, vea SET MEMOWIDTH.

Ejemplo

El ejemplo 1 encuentra la primera vez que aparece una cadena de caracteres en un campo memo y muestra el nombre y apellidos del empleado, y la línea del campo memo que contiene la cadena de caracteres.

El ejemplo 2 muestra cómo afecta el ancho de memo a ATLINE( ).

* Example 1
CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'Data\testdata')
USE employee  && Open employee table

CLEAR
STORE 'Japanese' TO gcFindString  && Case sensitive
LOCATE FOR ATLINE(gcFindString, notes) != 0
? First_Name
?? Last_Name
? MLINE(notes, ATLINE(gcFindString, notes))

* Example 2
STORE '1234567890ABCDEFGHIJ' TO gcString
SET MEMOWIDTH TO 20
? ATLINE('AB', gcString)  && Displays 1
SET MEMOWIDTH TO 10
? ATLINE('AB', gcString)  && Displays 2

Vea también

AT( ) | AT_C( ) | ATC( ) | ATCC( ) (Función) | ATCLINE( ) (Función) | LEFT( ) | RAT( ) | RATLINE( ) | RIGHT( ) | SUBSTR( ) | LEFTC( ) | RIGHTC( ) | SUBSTRC( ) | MLINE( ) | SET MEMOWIDTH | $ (Operador) | OCCURS( ) | INLIST( )