Share via

ATCLINE( ) (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 en otra expresión de caracteres o campo memo, sin importar que los caracteres estén en mayúsculas o en minúsculas.

ATCLINE(cSearchExpression, cExpressionSearched)

Valores devueltos

Numeric

Parámetros

  • cSearchExpression
    Especifica la expresión de caracteres que ATCLINE( ) 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 la línea que contiene la expresión de caracteres coincidente.

    Sugerencia   ATCLINE( ) ofrece una forma cómoda de buscar en campos memo.

Observaciones

Si la búsqueda se realiza con éxito, ATCLINE( ) devolverá el número de la línea que contiene la primera expresión de caracteres. Si la búsqueda no se realiza con éxito, ATCLINE( ) devolverá 0.

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

Utilice ATLINE( ) para realizar una búsqueda en la que se distinga entre mayúsculas y minúsculas.

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 demuestra cómo afecta el ancho de memo a ATCLINE( ).

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

CLEAR
STORE 'JAPANESE' TO gcFindString  && Case insensitive
LOCATE FOR ATCLINE(gcFindString, notes) != 0
? First_Name
?? Last_Name
? MLINE(notes, ATCLINE(gcFindString, notes))

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

Vea también

AT( ) | AT_C( ) | ATC( ) | ATCC( ) (Función) | ATLINE( ) | LEFT( ) | RAT( ) | RATLINE( ) | RIGHT( ) | SUBSTR( ) | LEFTC( ) | RIGHTC( ) | SUBSTRC( ) | MLINE( ) | SET MEMOWIDTH