STRTRAN( )-Funktion

Durchsucht einen Zeichenausdruck oder ein Memofeld nach dem Auftreten eines zweiten Zeichenausdrucks oder Memofeldes und ersetzt diese jeweils durch einen dritten Zeichenausdruck oder ein drittes Memofeld.

STRTRAN(cSearched, cExpressionSought [, cReplacement]
   [, nStartOccurrence] [, nNumberOfOccurrences] [, nFlags])

Rückgabewerte

Zeichen

Parameter

• cSearched
  Gibt den Zeichenausdruck an, der durchsucht wird. cSearched kann ein Memofeld sein.

• cExpressionSought
  Gibt den Zeichenausdruck an, nach dem in cSearched gesucht wird. Bei der Suche wird die Groß- und Kleinschreibung berücksichtigt. cExpressionSought kann auch ein Memofeld sein.

• cReplacement
  Gibt den Zeichenausdruck an, der cSearchFor bei jedem Auftreten in cSearched ersetzt. Wenn Sie cReplacement nicht angeben, wird cExpressionSought bei jedem Auftreten durch eine leere Zeichenfolge ersetzt.

• nStartOccurrence
  Gibt an, bei welchem Auftreten von cExpressionSought die Ersetzung beginnen soll. Wenn Sie beispielsweise für nStartOccurrence den Wert 4 angeben, beginnt das Ersetzen beim vierten Auftreten von cExpressionSought in cSearched. Die ersten drei aufgetretenen Ausdrücke werden nicht geändert. Ohne Angabe von nStartOccurrence beginnt das Ersetzen standardmäßig beim ersten Auftreten von cExpressionSought.

• nNumberOfOccurrences
  Gibt an, wie oft cExpressionSought ersetzt werden soll. Wenn Sie nNumberOfOccurrences nicht angeben, wird cExpressionSought bei jedem Auftreten ersetzt, beginnend mit dem in nStartOccurrence angegebenen Auftreten.

• nFlags
  Gibt an, ob bei der Suche die Groß-/Kleinschreibung berücksichtigt werden soll, und zwar entsprechend den Werten in der folgenden Liste:

  Wert für nFlags	Beschreibung
  0   (Standard)	Beim Suchen wird die Groß-/Kleinschreibung berücksichtigt, das Ersetzen findet mit dem exakten cReplacement-Text statt. Dies entspricht dem Verhalten bei der früheren Version von Visual FoxPro.
  1	Beim Suchen wird die Groß-/Kleinschreibung nicht berücksichtigt, das Ersetzen findet mit dem exakten cReplacement-Text statt.
  2	Beim Suchen wird die Groß-/Kleinschreibung berücksichtigt, das Ersetzen findet mit dem exakten cReplacement-Text statt.
  3	Beim Suchen wird die Groß-/Kleinschreibung nicht berücksichtigt. Die Groß-/Kleinschreibung beim Parameter cReplacement wird an die Groß-/Kleinschreibung beim Parameter cExpressionSought angepasst, der ersetzt wird.

  Sie können auch Standardverhaltensweisen angeben, indem Sie –1 als Wert für nFlags übergeben.

Hinweise

Sie können angeben, wo die Ersetzung beginnen und wie oft diese durchgeführt werden soll. STRTRAN( ) gibt die Ergebniszeichenfolge zurück. Geben Sie den Wert –1 für optionale Parameter ein, die übersprungen werden sollen. Gleiches gilt, wenn Sie nur die Einstellung für nFlags angeben müssen.

Beispiel

STORE 'abracadabra' TO gcString
? STRTRAN(gcString, 'a', 'z')  && Displays zbrzczdzbrz
? STRTRAN(gcString, 'a', 'q', 2, 3)  && Displays abrqcqdqbra

Siehe auch

CHRTRAN( ) | CHRTRANC( ) | STUFF( ) | Erstellung von Zeichenausdrücken | STUFFC( )-Funktion