Startseite / Vorlagenentwicklung / Vorlagensyntax / Funktionen / in Anweisungen / legacyCompare

legacyCompare(...)

Die Vergleichsoperatoren in einem $CMS_IF(...)$-Ausdruck weichen zwischen FIRSTspirit 3.1 und 4.0 voneinander ab.

In FIRSTspirit 4.0 können diese Vergleichoperatoren mit Hilfe der "legacyCompare(...)"-Funktion verwendet werden.

Die Funktion kann nur innerhalb der Bedingung eines $CMS_IF(...)$-Ausdrucks verwendet werden.

Die "legacyCompare(...)"-Funktion wird in einer späteren FIRSTspirit-Version entfallen.

Die Funktion sollte daher nicht mehr verwendet werden und die Ausdrücke auf die FIRSTspirit 4.0-Syntax umgestellt werden (vgl. $CMS_IF(...)$-Anweisungen ).

Syntax von legacyCompare(...)

Bei Verwendung von legacyCompare(...) muss folgende Syntax eingehalten werden:

$CMS_IF(legacyCompare(OBJEKT_1, OPERATOR, OBJEKT_2))$
  ...
$CMS_END_IF$

Alle Parameter von legacyCompare(...) sind Pflichtparameter.

Parameter von legacyCompare(...)

legacyCompare(...) verfügt über die drei Parameter:

OBJEKT_1
OPERATOR
OBJEKT_2

OBJEKT1 / OBJEKT2

Bei den Parametern OBJEKT1 und OBJEKT2 kann es sich um einen Ausdruck handeln, z.B. eine Variable oder Konstante .

OPERATOR

Für OPERATOR können folgende Schlüsselbegriffe verwendet werden:

OPERATOR	Beschreibung
==	Der Vergleich von OBJEKT_1 und OBJEKT_2 liefert wahr zurück, wenn OBJEKT_1 und OBJEKT_2 identisch sind.
!=	Der Vergleich von OBJEKT_1 und OBJEKT_2 liefert wahr zurück, wenn OBJEKT_1 und OBJEKT_2 nicht identisch sind.
contains	Der Vergleich von OBJEKT_1 und OBJEKT_2 liefert wahr zurück, wenn OBJEKT_1 OBJEKT_2 enthält.
endsWith	Der Vergleich von OBJEKT_1 und OBJEKT_2 liefert wahr zurück, wenn OBJEKT_1 mit OBJEKT_2 endet.
even	Der Vergleich von OBJEKT_1 liefert wahr zurück, wenn OBJEKT_1 gerade ist. Die Angabe für OBJEKT_2 wird ignoriert. Es wird empfohlen für OBJEKT_2 null anzugeben, um deutlich zu machen, dass der Wert für den Vergleich nicht berücksichtigt wird.
greaterOrEqualThan	Der Vergleich von OBJEKT_1 und OBJEKT_2 liefert wahr zurück, wenn OBJEKT_1 größer oder gleich OBJEKT_2 ist.
greaterThan	Der Vergleich von OBJEKT_1 und OBJEKT_2 liefert wahr zurück, wenn OBJEKT_1 größer als OBJEKT_2 ist.
lessOrEqualThan	Der Vergleich von OBJEKT_1 und OBJEKT_2 liefert wahr zurück, wenn OBJEKT_1 kleiner oder gleich OBJEKT_2 ist.
lessThan	Der Vergleich von OBJEKT_1 und OBJEKT_2 liefert wahr zurück, wenn OBJEKT_1 kleiner als OBJEKT_2 ist.
odd	Der Vergleich von OBJEKT_1 liefert wahr zurück, wenn OBJEKT_1 ungerade ist. Die Angabe für OBJEKT_2 wird ignoriert. Es wird empfohlen für OBJEKT_2 null anzugeben, um deutlich zu machen, dass der Wert für den Vergleich nicht berücksichtigt wird.
startsWith	Der Vergleich von OBJEKT_1 und OBJEKT_2 liefert wahr zurück, wenn OBJEKT_1 mit OBJEKT_2 beginnt.

Beispiele zu legacyCompare(...)

Nachfolgend werden einige Beispiele zur Verwendung der Anweisung innerhalb von Vorlagen gezeigt. Die Beispiele sollen die konkrete Auswirkung der Anweisung verdeutlichen und eine Hilfe für den Vorlagenentwickler bei der Erstellung eigener Vorlagen sein.

Für die Verwendung innerhalb eines Projekts, müssen die hier gezeigten Beispiele angepasst werden! Beispielsweise müssen Variablennamen auf die spezifischen Variablennamen des Projekts geändert werden, in dem die Anweisung verwendet werden soll.

1. Beispiel: Gerade Prüfung

Codebeispiel:

$CMS_IF(legacyCompare(3, "even", null))$
  Gerade
$CMS_ELSE$
  Ungerade
$CMS_END_IF$

Beschreibung:

In dem Beispiel wird überprüft, ob die Konstante 3 gerade ist.

Ausgabe:

Ungerade

2. Beispiel: Gerade-Prüfung ohne legacyCompare(...)

Codebeispiel:

$CMS_IF(3.even)$
  Gerade
$CMS_ELSE$
  Ungerade
$CMS_END_IF$

Beschreibung:

In dem Beispiel wird überprüft, ob die Konstante 3 gerade ist.

Ausgabe:

Ungerade

Druckversion | Seitenanfang