Function DE Version 1.90

@Contains

List Misc Text

Syntax

@Contains(TEXT1;TEXT2);
@Contains(TEXTLIST1;TEXT2);
@Contains(TEXT1;TEXTLIST2);
@Contains(TEXTLIST1;TEXTLIST2);
@Contains(TEXT1;TEXT2;RETPOS3);
@Contains(TEXTLIST1;TEXT2;RETPOS3);
@Contains(TEXT1;TEXTLIST2;RETPOS3);
@Contains(TEXTLIST1;TEXTLIST2;RETPOS3);

Beschreibung

Ermittelt ob im TEXT/TEXTLIST TEXT1/TEXTLIST1 der TEXT TEXT2 oder ein Element der TEXTLIST TEXTLIST2 ganz oder teilweise enthalten ist und gibt TRUE zurück wenn dies der Fall ist. Eine Ausnahme bildet eine leere TEXTLIST1, die nichts enthalten kann, auch keine leere TEXTLIST2. In diesem Fall ist das Ergebnis also immer FALSE.
Wenn @Contains mit 3 Parametern aufgerufen wird (RETPOS3) wird in diesem die Position des Elementes in der Liste zurückgegeben, bei dem der Vergleich das erste mal positiv verlief.

Beispiel: @Contains(TEXT1;TEXT2)

TEXT1:="Hallo Welt";
TEXT2:="Welt";
@Contains(TEXT1;TEXT2); ergibt 1

TEXT1:="Hallo Welt";
TEXT2:="Erde";
@Contains(TEXT1;TEXT2); ergibt 0

Beispiel: @Contains(TEXTLIST1;TEXT2)

TEXTLIST1:="Suche":"Brauche":"Möchte";
TEXT2:="cht";
@Contains(TEXTLIST1;TEXT2); ergibt 1

TEXTLIST1:="Suche":"Brauche":"Möchte";
TEXT2:="Verkaufe";
@Contains(TEXTLIST1;TEXT2); ergibt 0

Hier wird TEXT2 in einem Element von TEXTLIST1 gesucht.


Beispiel: @Contains(TEXT1;TEXTLIST2)

TEXT1:="Su";
TEXTLIST2:="Suche":"Brauche":"Möchte";
@Contains(TEXT1;TEXTLIST2); ergibt 0

TEXT1:="Möchte";
TEXTLIST2:="Suche":"Brauche":"Möchte";
@Contains(TEXT1;TEXTLIST2); ergibt 1

Hier wird ein Element der TEXTLIST2 in TEXT1 gesucht.

Beispiel: @Contains(TEXTLIST1;TEXTLIST2)

TEXTLIST1:="Müller":"Huber":"Maier";
TEXTLIST2:="Klein":"Schulze":"Müller";
@Contains(TEXTLIST1;TEXTLIST2); ergibt 1

TEXTLIST1:="Müller":"Huber":"Maier";
TEXTLIST2:="Klein":"Schulze":"Meyer";
@Contains(TEXTLIST1;TEXTLIST2); ergibt 0

TEXTLIST1:="";
TEXTLIST2:="";
@Contains(TEXTLIST1;TEXTLIST2); ergibt 0;

Hier wird ein Element von TEXTLIST2 in TEXTLIST1 gesucht.

Beispiel: @Contains(TEXTLIST1;TEXT2;RETPOS3)

TEXTLIST1:="Suche":"Brauche":"Möchte";
TEXT2:="cht";
@Contains(TEXTLIST1;TEXT2;RETPOS3); ergibt 1
In RETPOS3 wird 3 zurückgegben.

TEXTLIST1:="Suche":"Brauche":"Möchte";
TEXT2:="Verkaufe";
@Contains(TEXTLIST1;TEXT2;RETPOS3); ergibt 0
Der Inhalt von RETPOS3 ist undefiniert.

Hier wird TEXT2 in einem Element von TEXTLIST1 gesucht.