» Startseite » Haupt-Referenz » Funktions-Referenz » text2xml()

text2xml()

Syntax:

Parameter:

Beschreibung:

Diese Funktion konvertiert die Zeichenkette text gemäß XML/HTML/HTTP Regeln in eine neue Zeichenkette. Als zweiter Parameter mode_bits wird eine Bitfeld erwartet, die festlegt, welche Zeichen in welcher Art gewandelt werden.

Die folgenden Konstanten definieren, so weit nicht anders erwähnt, einzelne Bits und können mittels OR-Operation ('|') miteinander verknüpft werden:

• _CONV_LT
  Das Zeichen '<' wird in in die Zeichenfolge '&lt;' gewandelt.
• _CONV_GT
  Das Zeichen '>' wird in die Zeichenfolge '&gt;' gewandelt.
• _CONV_AMP
  Das Zeichen '&' wird in die Zeichenfolge '&amp;' gewandelt.
• _CONV_APOS
  Das Zeichen ''' wird in die Zeichenfolge '&apos;' gewandelt.
• _CONV_QUOT
  Das Zeichen '"' wird in die Zeichenfolge '&quot;' gewandelt.
• _CONV_HASH
  Das Zeichen '#' wird in die Zeichenfolge '&#x23;' gewandelt.
• _CONV_PERCENT
  Das Zeichen '%' wird in die Zeichenfolge '&#x25;' gewandelt.
• _CONV_PLUS
  Das Zeichen '+' wird in die Zeichenfolge '&#x2b;' gewandelt.
• _CONV_SLASH
  Das Zeichen '/' wird in die Zeichenfolge '&#x2f;' gewandelt.
• _CONV_QMARK
  Das Zeichen '?' wird in die Zeichenfolge '&#x3f;' gewandelt.
• _CONV_CDATA
  Die Sequenz ']]>', die das Ende eines CDATA Bereiches festlegt, wird in ']] >' geändert.
• _CONV_CDATA_DELIM
  Der Text wird in CDATA-Klammern eingebettet: Am Beginn wird '<![CDATA[' und am Ende wird ']]>' eingefügt.
• _CONV_SPECIAL
  Alle Zeichen mit dem ASCII-Kode >=128 werden mittels einer internen Tabelle in eine Zeichenfolge der Form '&name;' gewandelt. Zeichen, für die kein Namenseintrag existiert, werden in eine Zeichenfolge der Form '&#xnn;' gewandelt, wobei nn die Hexadezimal-Repräsentation des Zeichens ist.
• _CONV_CODENUM
  Alle Zeichen mit dem ASCII-Kode >=128 werden in eine Zeichenfolge der Form '&#xnn;' gewandelt, wobei nn die Hexadezimal-Repräsentation des Zeichens ist. _CONV_CODENUM hat Vorrang vor _CONV_SPECIAL.
• _CONV_CONTROL
  Alle Zeichen mit dem ASCII-Kode <32 mit Ausnahme von TAB, CR und LF werden die Zeichenfolge '&#xnn;' gewandelt, wobei nn die Hexadezimal-Repräsentation des Zeichens ist.
• _CONV_TAB_CR_LF
  Die Zeichen TAB, CR und LF werden in die Zeichenfolge '&#x09;', '&#x0d;' und '&#x0a;' gewandelt.
• _CONV_DECIMAL
  Bei den Umwandlungen in eine Hexadezimal-Darstellung '&#xnn;' wird anstatt dieser Hexadezimal-Darstellung eine Dezimaldarstellung der Form '&#nnn;' verwendet.
• _CONV_COPY_UTF8
  UTF8-Sequenzen werden in der Eingabe erkannt und unverändert an die Ausgabe weitergereicht. Die Option _CONV_FROM_UTF8 hat Vorrang.
• _CONV_FROM_UTF8
  UTF8-Sequenzen werden, falls möglich, in den ANSI-Zeichensatz umgewandelt.

  Für Zeichen, die nicht in ANSI umgewandelt werden können, wird der erste mögliche der folgenden Schritte durchgeführt:

  • Ist _CONV_COPY_UTF8 gesetzt, dann wird das Zeichen unverändert kopiert.
  • Ist _CONV_CODENUM gesetzt, dann wird das Zeichen in eine Zeichenfolge der Form '&#xnnn;' gewandelt, wobei nnn die Hexadezimal-Repräsentation des Zeichens ist.
  • Ist _CONV_TO_UTF8 gesetzt, dann wird das Zeichen unverändert kopiert.
  • Das Zeichen wird ignoriert.
• _CONV_TO_UTF8
  Alle Zeichen >=128, die nicht bereits umgewandelt worden sind, werden in eine UTF-8 Sequenz gewandelt. Die beiden Optionen _CONV_CODENUM und _CONV_SPECIAL haben Vorrang vor _CONV_TO_UTF8.
• _CONV_WIN_ANSI
  Der Windows-ANSI-Zeichensatz besitzt zusätzliche Zeichen und den Nummer [0x80..0x9f], mit denen Unicodezeichen >=0x100 dargestellt werden können. Ist nun das Bit _CONV_WIN_ANSI gesetzt, dann werden solche Unicode-Zeichen automatisch in das entsprechende Windows-ANSI-Zeichen konvertiert.

Die folgende Liste enthält kombinierte Optionen für bestimmte Zwecke:

• _CONV_LT_GT := _CONV_LT | _CONV_GT
  Kurzfassung, um '<' und '>' umzuwandeln.
• _CONV_ALL_CHARS := _CONV_LT_GT | _CONV_AMP | _CONV_PERCENT | _CONV_APOS | _CONV_QUOT | _CONV_SPECIAL
  Alle speziellen Zeichen werden umgewandelt.
• _CONV_ALL_CONTROL := _CONV_CONTROL | _CONV_TAB_CR_LF
  Alle Zeichen mit dem ASCII-Kode <32 einschließlich TAB, CR und LF werden nach '&#xnn;' gewandelt.
• _CONV_HTML_ATTRIB := _CONV_LT | _CONV_AMP | _CONV_QUOT | _CONV_SPECIAL
  Die Zeichen werden gewandelt, wie es für HTML-Attribute vorgesehen ist. Wichtig ist die Annahme, dass das Attribut in doppelten Hochkommata (") eingeschlossen ist.
• _CONV_HTML_TEXT := _CONV_LT | _CONV_AMP | _CONV_SPECIAL
  Die Zeichen werden gewandelt, wie es für einen normalen HTML-Text vorgesehen ist.
• _CONV_XML_ATTRIB := _CONV_LT | _CONV_AMP | _CONV_QUOT | _CONV_CODENUM | _CONV_ALL_CONTROL
  Die Zeichen werden gewandelt, wie es für XML-Attribute vorgesehen ist. Wichtig ist die Annahme, dass das Attribut in doppelten Hochkommata (") eingeschlossen ist.
• _CONV_XML_TEXT := _CONV_LT | _CONV_AMP | _CONV_CODENUM | _CONV_CONTROL
  Die Zeichen werden gewandelt, wie es für einen normalen XML-Text vorgesehen ist.
• _CONV_XML_CDATA := _CONV_CDATA | _CONV_CDATA_DELIM
  Die Zeichen werden in einen CDATA Block gewandelt.
• _CONV_STD_HTML := _CONV_SPECIAL | _CONV_CONTROL
  Dieses ist die Standardeinstellung, die für HTML-Texte mindestens verwendet werden sollte.
• _CONV_STD_XML := _CONV_CODENUM | _CONV_CONTROL
  Dieses ist die Standardeinstellung, die für XML-Texte mindestens verwendet werden sollte.
• _CONV_QUERY_STD := _CONV_AMP | _CONV_PERCENT | _CONV_HASH | _CONV_PLUS | _CONV_SPECIAL | _CONV_CONTROL
  Dieses ist die Standardeinstellung, die für die Umwandlung einer HTTP-Query mittels text2query() verwendet werden sollte. Weitere Flags können ergänzt werden.
• _CONV_QUERY_ALL := _CONV_QUERY_STD | _CONV_SLASH | _CONV_QMARK
  Dieses sind alle Flags, die für die Umwandlung einer HTTP-Query mittels text2query() verwendet werden können. Alle anderen Flags werden ignoriert.

Funktionsergebnis:   STRING

Als Funktionsergebnis wird die umgewandelte Zeichenkette geliefert.

Siehe auch:
 xml2text()   text2query()   text2utf8() 

Weitere ähnliche Funktionen: