ATC( )-Funktion

Gibt die numerische Anfangsposition des ersten Auftretens eines Zeichenausdrucks oder eines Memofeldes innerhalb eines anderen Zeichenausdrucks oder eines Memofeldes zurück, ohne die Groß-/Kleinschreibung dieser beiden Ausdrücke zu berücksichtigen.

ATC(cSearchExpression, cExpressionSearched [, nOccurrence])

Rückgabewerte

Numerisch

Parameter

• cSearchExpression
  Gibt den Zeichenausdruck an, nach dem ATC( ) 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 ATC( ) nach dem ersten Vorkommen von cSearchExpression (nOccurrence = 1). Durch Angabe von nOccurrence können Sie weitere Vorkommen von cSearchExpression in cExpressionSearched suchen.

Hinweise

ATC( ) sucht im zweiten Zeichenausdruck nach dem ersten Zeichenausdruck, ohne dabei für die beiden Ausdrücke die Groß-/Kleinschreibung (Groß- oder Kleinbuchstaben) zu berücksichtigen. Soll bei einem Suchvorgang die Groß-/Kleinschreibung berücksichtigt werden, verwenden Sie die AT( )-Funktion.

ATC( ) gibt eine ganze Zahl zurück, die die Position angibt, an der das erste Zeichen des gesuchten Zeichenausdrucks gefunden wurde. Wird der jeweilige Zeichenausdruck nicht gefunden, gibt ATC( ) den Wert 0 zurück.

Beispiel

STORE 'Now is the time for all good men ... ' TO gcString
STORE 'IS THE' TO gcFindString
CLEAR
? ATC(gcFindString, gcString)  && Displays 5
STORE 'is' TO gcFindString
? ATC(gcFindString, gcString)  && Displays 5
? ATC('now',gcString)  && Displays 1

Siehe auch

AT( ) | AT_C( ) | ATCC( ) | ATCLINE( ) | ATLINE( ) | LEFT( ) | RAT( ) | RATLINE( ) | RIGHT( ) | SUBSTR( ) | LEFTC( ) | RIGHTC( ) | SUBSTRC( )