CompareText("'Text1'", "'Text2'", ' CaseSensitive=1*')
Anmerkung: Der ursprüngliche Name dieser Funktion war TextCompare. Sie wurde später in CompareText umbenannt. Aus Kompatibilitätsgründen ist die Funktion TextCompare weiter verwendbar, die Argumente sind identisch.
Argumente
|
'Text1' |
Angabe des ersten Vergleichstextes |
|
|
'Text2' |
Angabe des zweiten Vergleichstextes |
|
|
'CaseSensitive*' |
Optionaler Parameter (Voreinstellung =1) zur Festlegung, ob ein Case-sensitiver Vergleich (Berücksichtigung von Groß- und Kleinschreibung) gemacht werden soll |
|
|
'CaseSensitive' ≠ 0 |
Groß- und Kleinschreibung berücksichtigen |
|
|
'CaseSensitive' = 0 |
Groß- und Kleinschreibung ignorieren |
|
Parameter, die mit * enden, werden nur einmalig zu Beginn der Erfassung übernommen.
Beschreibung
Diese Funktion vergleicht 2 Texte alphabetisch miteinander. Das bedeutet, dass die Zeichen der 2 Strings einzeln miteinander verglichen werden, beginnend mit dem linken Zeichen. Die Funktion verwendet die gegenwärtige Kultureinstellung (Windows), um kulturspezifische Informationen zu Schreibweise und alphabetischer Reihenfolge zu erhalten. Der Vergleich berücksichtigt weder mehrstellige Zahlenwerte, noch Wortbedeutung oder die Länge des Strings. Ein Leerzeichen wird beim Vergleich berücksichtigt. Mit dem optionalen Parameter 'CaseSensitiv=1' kann bestimmt werden ob Groß- und Kleinschreibung berücksichtigt werden soll ( =1 oder keine Angabe), oder nicht (<>1).
Dynamischer Text kann mithilfe eines Textsignals verwendet werden. Ein Textsignal wird in rechteckige Klammern [ ] gesetzt. Es ist ebenso möglich einen konstanten Text einzugeben, indem der Text einfach in Anführungszeichen gesetzt wird.
Als Ergebnis gibt die Funktion einen Analogwert aus.
Ergebnisse
|
-1 |
wenn die Zeichen des ersten Textes im Alphabet vor den Zeichen des zweiten Textes stehen |
|
0 |
wenn die beiden Texte gleich sind |
|
1 |
wenn die Zeichen des ersten Textes im Alphabet nach den Zeichen des zweiten Textes stehen |
Beispiel
Die folgende Tabelle zeigt einige Beispiele:
|
Text1 |
Text2 |
Ergebnis |
Anmerkung |
|
|
CompareText ("Text1","Text2",0) |
CompareText ("Text1","Text2",1) |
|||
|
1234 abcd |
1234 abcd |
0 |
0 |
1 = 2 |
|
1234 abcd |
1234 bcde |
-1 |
-1 |
1 < 2 "a" steht vor "b" |
|
1234 Abcd |
1234 abcd |
0 |
1 |
1 = 2 (Groß-/Kleinschreibung nicht berücksichtigt) 1 > 2 (Groß-/Kleinschreibung berücksichtigt) "A" steht nach "a" |
|
12340 abcd |
1234 ˽ abcd |
1 |
1 |
1 > 2 "0" steht nach " ˽" |
|
1234 0abcd |
1234 abcd |
-1 |
-1 |
1 < 2 "0" steht vor "a" |
|
12034 abcd |
1234 abcd |
-1 |
-1 |
1 < 2 "0" steht vor "3" |
|
1234 abcd |
1y34 abcd |
-1 |
-1 |
1 < 2 "2" steht vor "y" |
|
1z34 abcd |
1Y34 abcd |
1 |
1 |
1 > 1 "z" steht nach "Y" |