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
- Pipe-Form und Aufruf-Form
- Verkettung
- Verschachtelung
- Attribute nach einem Operator
- Operatoren in Parametern von Funktionen
- Wie Parameter zugeordnet werden
- Unbekannte Operatoren und fehlende Parameter
- 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 registeredWie 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:
- Gibt das Template an dieser Position einen Wert an, wird er ausgewertet und unter dem Namen des Parameters gespeichert.
- Wenn nicht, und der Parameter ist
required, wird die WarnungParameter '<name>' (<position>) missinggeschrieben. - Ein fehlender Parameter bekommt seinen
defaultaus 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 registeredEin 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) missingVerwandte Seiten
- Zurück: Zugriff auf Attribute
- Weiter: Funktionen und Operatoren
- Überblick über Operatoren
- Referenz der Operatoren
- Jeder Template-Operator
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
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.