|
|
|
|
|
|
|
|
|
|
|
Version 11 (Geändert)
Position (Suchtext; String{; Start{; Längegefunden{; *}}}) 
Zahl
| Parameter | Typ | Beschreibung | |
| Suchtext | String | | Zu suchender Text |
| String | String | | String für die Suche |
| Start | Zahl | | Stelle in String, wo die Suche beginnt |
| Längegefunden | Lange Ganzzahl |  | Länge des gefundenen String |
| * | * | | Mit Stern: Suche berücksichtigt diakritische Zeichen |
| Funktionsergebnis | Zahl | | Position des ersten Auftretens |
Beschreibung
Die Funktion Position gibt die Position des ersten Auftretens von Suchtext in String zurück. Wurde Suchtext nicht gefunden, gibt Position den Wert 0 zurück.
Findet Position ein Vorkommen von Suchtext, gibt sie die Position des ersten Zeichens in String zurück.
Fragen Sie innerhalb eines leeren String nach einer Position, gibt Position den Wert Null (0) zurück.
Die Suche beginnt standardmäßig mit dem ersten Zeichen von String.Mit dem Parameter Start können Sie das erste Zeichen angeben, mit dem die Suche in String beginnen soll.
Der Parameter Längegefunden gibt die Länge der Zeichenkette zurück, die aktuell durch die Suche gefunden wird. Dieser Parameter ist zum korrektenVerwalten von Buchstaben mit einem oder mehr Zeichen notwendig, z.B. ß und ss, ae und æ, etc.
Ist der optionale Parameter * übergeben, gelten diese Buchstaben als ungleich (ae # æ). Bei Berücksichtigung diakritischer Zeichen ist Längegefunden immer identisch mit der Länge von Suchtext (wenn ein Auftreten gefunden wurde).
Der Parameter * gibt an, dass die Suche diakritische Zeichen berück-sichtigen, also Groß/Kleinschreibung und Zeichen mit bzw. ohne Akzent unterschiedlich werten soll, z.B. a#A, a#à.
Warnung: Der Joker (@) kann mit Position nicht benutzt werden. Übergeben Sie zum Beispiel in Suchtext "abc@", sucht die Funktion nach "abc@" und nicht nach "abc" plus beliebigen Zeichen.
Beispiele
1. Dieses Beispiel zeigt die Verwendung von Position.
vlResult := Position ("ll"; "Wille") ` vlResult ergibt 3
vlResult := Position (vtText1; vtText2)
` Übergibt das erste Auftreten von vtText1 in vtText2
$posFound:=Position("Tag";"Montag ist der erste Tag";1) `gibt 4 zurück
$posFound:=Position("Tag";"Montag ist der erste Tag";8) `gibt 22 zurück
$posFound:=Position("TAG;"Montag ist der erste Tag";1;*) `gibt 0 zurück
$posFound:=Position("œ";"Bœuf";1;$stringlength)
`$posFound gibt 2 und $stringlength 1 zurück
2. Im folgenden Beispiel werden mit Längegefunden alle Vorkommen von aegis in einem Text gefunden, egal ob es "ægis" oder "aegis" geschrie-ben wird.
$start:=1
Repeat
$pos:=Position("aegis";$thetext;$start;$stringlength)
$start:=$start+$stringlength
Until($pos=0)
Referenz
Substring, Vergleichsoperatoren.
Capitalize, Filter Keystroke, Passing Parameters, Strings, Text To Array, VCard Import Export, vCard Import Export
|
|
|
|
|
|
|
|
|
|
|