Print (SP-Tag)

Name

<sp:print> - Ausgabe-Tag

Syntax

 <sp:print name="variable" encoding="html"/>

Beschreibung

Der Print-Tag dient zur Ausgabe von Texten, Expression sowie Daten und Zahlen in beliegem Formaten.

Attribute

Name	Type	Required	Default
name	Attribute	Ja oder text bzw. expression	None
text	Text	Ja oder name bzw. expression	None
expression	Expression	Ja oder name bzw. text	None
default	Text	Nein	None
encoding	Text	Nein	None
encrypt	Text	Nein	None
locale	Locale	Nein	None
dateformat	Text	Nein	None
decimalformat	Text	Nein	None

name

Attribute das ausgegeben werden soll (Siehe „Attribut“).

text

Alternative zu name (Siehe „Text“).

expression

Alternative zu name (Siehe „Expression“).

default

Auszugebender Default-Wert, wenn das Ergebnis von name bzw. text bzw. expression leer ist.

encoding

Encodiert die Auszugebende Zeichenkette mit dem angegebenen Encoding. Es ist möglich eine kommaseparierte Liste von Encodings anzugeben, die nacheinander ausgeführt werden. Gültige Werte sind:

none

kein encoding

html

encoded HTML-Text

xml

encoded XML-Text

script

encoded für JavaScript, PHP, JSP, o.ä (escaped \n, \r, \r\n, " und ')

url

encoded eine URL (entsprechend dem Charset des Publishers)

url; charset=latin1

encoded eine URL (mit dem übergebenen Charset)

entity

encoded alle Entitäten

plain

encoded <, > und Zeilenenden (\n, \r, \r\n)

ascii

encoded Windows-Sonderzeichen nach ASCII

path

encoded einen Verzeichnisnamen

filename

encoded einen Dateinamen

encrypt

Encryptet die Auszugebende Zeichenkette mit dem angegebenen Encrypting. Es ist möglich eine kommaseparierte Liste von Encryptins anzugeben, die nacheinander ausgeführt werden. Gültige Werte sind:

3des

Triple DES Crypting Algorithmus

locale

Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.

dateformat

Angaben zur Datumsformatierung (Siehe Abschnitt 2.1.3, „Datumsformate“).

decimalformat

Angaben zur Dezimalformatierung (Siehe Abschnitt 2.1.4, „Nummernformate“).

Beispiele

Ausgabe einer Variablen

Template Quelltext

Nicht definierte Variablen liefern: <sp:print name="var"/><br>
Sie können aber einen Default-Wert haben: <sp:print name="var" default="Hallo"/>

Ausgabe

Nicht definierte Variablen liefern:
Sie können aber einen Default-Wert haben: Hallo

Ausgabe einer Expression

Template Quelltext

<sp:set name="x" value="7"/>
<sp:set name="y" value="12"/>
<%--
  Auf Variablen greift man mit ${} zu
--%>
Der Print-Tag kann auch rechnen:
(7 + 12) * 2 - 3 = <sp:print expression="(${x} + ${y}) * 2 - 3"/>

Ausgabe

Der Print-Tag kann auch rechnen:
(7 + 12) * 2 - 3 = 35