ATLINE( )-Funktion

Gibt die Nummer der Zeile zurück, in der ein Zeichenausdruck oder der Inhalt eines Memofeldes zum ersten Mal in einem anderen Zeichenausdruck oder Memofeld vorkommt, und zwar von der ersten Zeile ausgehend.

ATLINE(cSearchExpression, cExpressionSearched)

Rückgabewerte

Numerisch

Parameter

• cSearchExpression
  Gibt den Zeichenausdruck an, nach dem Microsoft Visual FoxPro in cExpressionSearched sucht.

• cExpressionSearched
  Gibt den Zeichenausdruck an, nach dem mit cSearchExpression gesucht wird.

  Sowohl cSearchExpression als auch cExpressionSearched können Memofelder beliebiger Größe sein.

  Mit Hilfe von MLINE( ) können Sie die Zeile anzeigen, in der der gesuchte Zeichenausdruck als Zeichenfolge gefunden wurde.

  Tipp   ATLINE( ) bietet sich an, wenn Memofelder durchsucht werden sollen.

Hinweise

ATLINE( ) sucht im zweiten Zeichenausdruck nach dem ersten Zeichenausdruck. Mit ATLINE( ) werden Zeichenausdrücke unter Berücksichtigung der Groß-/Kleinschreibung durchsucht. Wenn Sie einen Suchvorgang ausführen möchten, bei dem die Groß-/Kleinschreibung nicht berücksichtigt werden soll, verwenden Sie die ATCLINE( )-Funktion.

Wurde der Suchvorgang erfolgreich abgeschlossen, gibt ATLINE( ) die Nummer der Zeile zurück, in der die Übereinstimmung entdeckt wurde. Wurde der Suchvorgang nicht erfolgreich abgeschlossen, gibt ATLINE( ) den Wert 0 zurück.

Bei einer von ATLINE( ) zurückgegebenen Zeilennummer wird immer der Wert von SET MEMOWIDTH berücksichtigt, auch wenn es sich bei cExpressionSearched um kein Memofeld handelt. Weitere Informationen finden Sie unter SET MEMOWIDTH.

Beispiel

In Beispiel 1 wird das erste Vorkommen einer Zeichenfolge in einem Memofeld gesucht, und anschließend wird der Vor- und Nachname des Mitarbeiters sowie die Zeile des Memofeldes angezeigt, die die Zeichenfolge enthält.

Beispiel 2 demonstriert, wie die Breite des Memofeldes die ATLINE( )-Funktion beeinflusst.

* 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

Siehe auch

AT( ) | AT_C( ) | ATC( ) | ATCC( )-Funktion | ATCLINE( )-Funktion | LEFT( ) | RAT( ) | RATLINE( ) | RIGHT( ) | SUBSTR( ) | LEFTC( ) | RIGHTC( ) | SUBSTRC( ) | MLINE( ) | SET MEMOWIDTH | $-Operator | OCCURS( ) | INLIST( )