Text-Operatoren #

Die Template-Sprache hat keinen Operator zum Verketten von Zeichenketten wie . oder ~; diese Aufgabe übernimmt concat. Er und indent werden von eZTemplateTextOperator (lib/eztemplate/classes/eztemplatetextoperator.php) über lib/eztemplate/classes/eztemplateautoload.php registriert.

Inhalt #

1. concat
2. indent
3. Verwandte Seiten

concat #

concat #

Verbindet die gepipte Eingabe (sofern vorhanden) und jeden Parameter der Reihe nach zu einer Zeichenkette. Zahlen werden in Text umgewandelt.

Eingabe: optional, sie kommt zuerst. Gibt eine Zeichenkette zurück. concat maskiert nicht; wenden Sie daher wash auf das Ergebnis oder auf jeden nicht vertrauenswürdigen Teil an, bevor Sie es in HTML ausgeben. Generierte Referenz: concat.

Das Beispiel verwendet das Thema Running auf einer Entwicklungsinstallation (Knoten 163):

{def $node = fetch( 'content', 'node', hash( 'node_id', 163 ) )}
{concat( 'Topic: ', $node.name, ' (node ', $node.node_id, ')' )|wash}
{'/'|concat( $node.url_alias )}
{concat( 'class ', 'ng-', $node.class_identifier )}

Ausgabe:

Topic: Running (node 163)
/running
class ng-ng_topic

Objekte. Der Interpreter (modify()) überspringt stillschweigend einen Parameter, der ein Objekt ist:

{def $node = fetch( 'content', 'node', hash( 'node_id', 163 ) )}
[{concat( 'object skipped: ', $node )}]

Ausgabe:

[object skipped: ]

Die kompilierte Form (concatTransformation()) verbindet die Werte mit dem PHP-Operator ., und PHP kann einen Knoten nicht in eine Zeichenkette umwandeln. Auf einer Entwicklungsinstallation brach dasselbe Template kompiliert mit Error: Object of class eZContentObjectTreeNode could not be converted to string ab und erzeugte überhaupt keine Ausgabe, nicht einmal den Text davor. Übergeben Sie immer das gemeinte Attribut ($node.name), nie das Objekt.

indent #

indent #

Setzt ein Füllzeichen vor die erste Zeile und hinter jeden Zeilenumbruch der Eingabe.

Jeder andere Typ ergibt Leerzeichen. Eine negative Anzahl schreibt den Fehler "The value of the "count" argument is negative" in das Debug-Protokoll und lässt den Text unverändert. Gibt eine Zeichenkette zurück. Nützlich für Klartextausgabe wie den Text von E-Mails; in HTML werden Leerräume zusammengefasst. Generierte Referenz: indent.

{def $text = "line one
line two"}
[{$text|indent( 4 )}]
[{$text|indent( 2, 'custom', '> ' )}]
[{$text|indent( 1, 'tab' )|bin2hex|extract_left( 4 )}] (09 = a tab)

Ausgabe:

[    line one
    line two]
[> > line one
> > line two]
[096c] (09 = a tab)

Verwandte Seiten #

• Zeichenketten-Operatoren: wash, shorten, trim
• PHP-Zeichenkettenfunktionen: kodieren und formatieren: sprintf für formatierten Text
• Array-Operatoren: append bei Zeichenketten und implode
• Alle Template-Operatoren (generiert)
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.