Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Operatoren in Ausdrücken

Wie Operatoren geschrieben und ausgewertet werden - die Pipe-Form und die Aufruf-Form, was der Eingabewert in jeder ist, Verkettung, Operatoren als Parameter verschachteln, Attribute nach einem Operator, Operatoren in…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/template-language/operators-in-expressions.md

On this page

This page is a translation. Read the English original

Operatoren in Ausdrücken

Ein Operator ist eine benannte Umwandlung eines Werts. Im Parserbaum ist er ein Element vom Typ TYPE_OPERATOR, das den Namen des Operators und die Ausdrücke seiner Parameter hält (parseVariableTag() in lib/eztemplate/classes/eztemplateelementparser.php); zur Laufzeit ordnet eZTemplate::processOperator() in lib/eztemplate/classes/eztemplate.php die Parameter zu und ruft modify() der Operatorklasse auf. Diese Seite zeigt, was das für das Schreiben von Ausdrücken bedeutet.

Inhalt

  1. Pipe-Form und Aufruf-Form
  2. Verkettung
  3. Verschachtelung
  4. Attribute nach einem Operator
  5. Operatoren in Parametern von Funktionen
  6. Wie Parameter zugeordnet werden
  7. Unbekannte Operatoren und fehlende Parameter
  8. Verwandte Seiten

Pipe-Form und Aufruf-Form

Derselbe Operator lässt sich auf zwei Arten schreiben:

  • Pipe-Form, {$value|name( params )}: Der Wert vor der Pipe ist die Eingabe des Operators.
  • Aufruf-Form, {name( params )}: Es gibt keine Eingabe; die Eingabe ist null.

Operatoren unterscheiden sich darin, was sie mit der Eingabe tun. upcase arbeitet nur auf seiner Eingabe, die Aufruf-Form ergibt also nichts. sum addiert die Eingabe zu seinen Parametern, wenn es eine gibt. concat stellt die Eingabe vor seine Parameter:

[{'abc'|upcase}] [{upcase( 'abc' )}]
[{2|sum( 3 )}] [{sum( 2, 3 )}]
[{'a'|concat( 'b', 'c' )}] [{concat( 'a', 'b', 'c' )}]

Ausgabe:

[ABC] []
[5] [5]
[abc] [abc]

Eine Eingabe, die ein Operator nicht nutzen kann, ist kein Fehler. sum behandelt eine nicht numerische Eingabe als nichts, was zu addieren wäre:

[{'ignored'|sum( 1, 2 )}] [{5|sum( 1, 2 )}]

Ausgabe:

[3] [8]

Welche Form ein Operator akzeptiert, gehört zu seiner Dokumentation. Die erzeugte Seite jedes Operators sagt, ob er auf seiner Eingabe arbeitet (jeder Template-Operator).

Verkettung

Jedes | gibt das Ergebnis des vorigen Operators an den nächsten weiter, von links nach rechts:

[{'  Hello Template World  '|trim|downcase|shorten( 12 )|upfirst}]
[{array( 3, 1, 2 )|count|mul( 10 )|sum( 5 )}]

Ausgabe:

[Hello tem...]
[35]

Verschachtelung

Parameter sind vollständige Ausdrücke: Variablen, Literale, andere Operatoren in beiden Formen, mit ihren eigenen Attributen. Bedingungen werden so gebaut, weil es keine Operatoren in Infixschreibweise gibt:

{def $a = 4 $b = 2}
[{concat( 'sum=', sum( $a, $b ), ', product=', mul( $a, $b ) )}]
[{if and( $a|gt( 1 ), $b|lt( 5 ), or( $a|eq( 4 ), $b|eq( 0 ) ) )}all true{/if}]
[{cond( $a|gt( $b ), 'a wins', 'b wins' )}]

Ausgabe:

[sum=6, product=8]
[all true]
[a wins]

cond gibt den Wert nach der ersten zutreffenden Bedingung zurück; bei einer ungeraden Zahl von Parametern ist der letzte der Wert, wenn keine zutrifft, gleich welcher: cond( ezini_hasvariable( 'S', 'List', 'menu.ini' ), ezini( 'S', 'List', 'menu.ini' ), array() ) ist eine leere Liste, wenn die Einstellung fehlt, mit und ohne Template-Kompilierung. Bis Exponential 6.0.14 ging einem Template ohne Kompilierung (TemplateCompile=disabled) dort ein leeres Array, ein leerer Hash, 0, '' oder false() verloren und es bekam keinen Wert, der alles enthält ($list|contains( 'x' ) war wahr). Templates, die auch auf diesen Versionen laufen müssen, setzen zuerst den leeren Wert und ändern ihn in einem {if}.

Attribute nach einem Operator

Ein Punkt oder eckige Klammern können auf einen Operatoraufruf folgen. Das Attribut wird aus dem Ergebnis des Operators gelesen:

[{fetch( 'content', 'node', hash( 'node_id', 89 ) ).name}]
[{fetch( 'content', 'node', hash( 'node_id', 89 ) ).children|count}]
[{array( 'x', 'y', 'z' )|reverse.0}]

Ausgabe:

[Fit & Healthy]
[16]
[z]

Operatoren in Parametern von Funktionen

Parameter von Funktionen sind ebenfalls Ausdrücke; ein Operator kann also das Array eines foreach oder den Wert eines def liefern:

{foreach array( 'b', 'a', 'c' )|reverse as $letter}{$letter|upcase}{/foreach}
{def $label = concat( 'Item ', 3|inc )}[{$label}]

Ausgabe:

CAB[Item 4]

Umgekehrt gilt das nicht: Eine Funktion ist kein Wert und lässt sich nicht in einem Ausdruck aufrufen. if( ... ) in einem Ausdruck wird als Operator namens if gesucht, den es nicht gibt:

[{concat( 'a', if( true() ) )}]

Ausgabe:

[a]

Von der Template-Engine protokolliert:

WARNING : Operator 'if' is not registered

Wie Parameter zugeordnet werden

Parameter sind positionsabhängig. Eine Operatorklasse kann in namedParameterList() Namen für sie angeben (pro Operator, wenn namedParameterPerOperator() true zurückgibt). processOperator() geht diese Liste der Reihe nach durch:

  1. Gibt das Template an dieser Position einen Wert an, wird er ausgewertet und unter dem Namen des Parameters gespeichert.
  2. Wenn nicht, und der Parameter ist required, wird die Warnung Parameter '<name>' (<position>) missing geschrieben.
  3. Ein fehlender Parameter bekommt seinen default aus der Liste. Hat die Liste auch keinen Standardwert, bekommt er null, und die Engine warnt einmal pro Operator und Parameter, dass es keinen Standardwert gibt.

modify() des Operators bekommt dann den Eingabewert (als Referenz; was es dort hinterlässt, ist das Ergebnis), die rohen Ausdrücke der Parameter und die benannten Werte. Operatoren, die beliebig viele Parameter nehmen, wie sum oder concat, geben keine an und werten die rohen Ausdrücke selbst aus. Wie Sie eine solche Klasse schreiben, steht in Template-Operatoren schreiben.

Unbekannte Operatoren und fehlende Parameter

Ein nicht registrierter Operatorname schreibt Operator '<name>' is not registered und lässt die Eingabe unverändert. Die Seite wird weiter gerendert, was Tippfehler verbirgt:

[{'kept as it is'|nosuchoperator( 1 )}]

Ausgabe:

[kept as it is]

Von der Template-Engine protokolliert:

WARNING : Operator 'nosuchoperator' is not registered

Ein fehlender Pflichtparameter wird gemeldet, und dann läuft der Operator mit dem, was er hat. datetime braucht die Formatklasse als ersten Parameter; ohne sie wird der Zeitstempel unformatiert ausgegeben, und zwei Meldungen werden protokolliert:

[{1674667522|datetime}]

Ausgabe:

[1674667522]

Von der Template-Engine protokolliert:

ERROR datetime: DateTime class '' is not defined
WARNING eZTemplateOperatorElement: Parameter 'class' (0) missing

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x