AT( )-Funktion

  • Artikel

Gibt die numerische Anfangsposition zurück, an der ein Zeichenausdruck oder der Inhalt eines Memofeldes zum ersten Mal in einem anderen Zeichenausdruck oder Memofeld vorkommt, und zwar vom äußersten linken Zeichen aus gerechnet.

AT(cSearchExpression, cExpressionSearched [, nOccurrence])

Rückgabewerte

Numerisch

Parameter

  • cSearchExpression
    Gibt den Zeichenausdruck an, nach dem AT( ) 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.

  • nOccurrence
    Gibt an, nach dem wievielten Vorkommen (ersten, zweiten, dritten usw.) von cSearchExpression in cExpressionSearched gesucht werden soll. Standardmäßig sucht AT( ) nach dem ersten Vorkommen von cSearchExpression (nOccurrence = 1). Durch Angabe von nOccurrence können Sie weitere Vorkommen von cSearchExpression in cExpressionSearched suchen. Wenn nOccurrence größer ist als die Anzahl der Vorkommen von cSearchExpression in cExpressionSearched, gibt AT( ) den Wert 0 zurück.

Hinweise

AT( ) sucht im zweiten Zeichenausdruck nach dem ersten Vorkommen des ersten Zeichenausdrucks. Ist die Suche erfolgreich, gibt AT( ) eine ganze Zahl zurück, die die Position des ersten Zeichens des gefundenen Zeichenausdrucks angibt. Ist die Suche nicht erfolgreich, gibt AT( ) den Wert 0 zurück.

Die mit AT( ) ausgeführte Suche berücksichtigt Groß- und Kleinschreibung. Wenn Sie einen Suchvorgang ausführen möchten, bei dem die Groß-/Kleinschreibung nicht berücksichtigt wird, verwenden Sie die ATC( )-Funktion.

Beispiel

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

Siehe auch

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