fn:string-to-codepoints

(Auszug aus "XSLT 2.0 & XPath 2.0" von Frank Bongers, Kapitel 5.)

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

   

Kategorie: Stringfunktionen – Codepoint-Umwandlung

Herkunft: XPath 2.0

Rückgabewert: Eine Sequenz aus Ganzzahlen xs:integer; die Unicode-Code­point-"erte, die die Zeichen des Eingabestrings repräsentieren.

Aufruf/Argumente:

fn:string-to-codepoints($eingabestring)

$eingabestring:
Obligatorisch. Ein String xs:string, dessen Zeichen in eine Sequenz aus Unicode-Codepoint-Werten umgewandelt werden sollen.

Verwendungszweck:

Die Funktion fn:string-to-codepoints() ist das Gegenstück zu fn:codepoints-to-string(). Sie gibt eine Sequenz von Integerwerten zurück, die jeweils einem Unicode-Codepoint entsprechen und die einzelnen Zeichen repräsentieren, aus denen sich der Eingabestring zusammensetzt. Ist der Eingabestring der leere String, so gibt die Funktion die leere Sequenz zurück.

Eine denkbare Problematik ergibt sich aus der Unicode-Spezifikation, die gleichen abstrakten Zeichen unter Umständen mehrere unterschiedliche Codepoints (oder eine Folge von Codepoints) zuordnet. Die Umwandlung muss also nicht eindeutig sein. Beispielsweise ist das Zeichen Å durch den Codepoint 0197 (»latin capital letter a with ring above«) oder den Codepoint 8491 (»Ångström-Sign«) darstellbar.

Anmerkung: Der »Unicode Codespace«, der zur Definition von Codepoints verwendet werden kann, umfasst den Ganzzahlenbereich von 0 bis 10FFFF (Hex), also 0 bis 1.114.111 (Dezimal).

Beispiel – Anwendung auf einen Eingabestring:

fn:string-to-codepoints('Hallo Welt!')

ergibt die Sequenz (72, 97, 108, 108, 111, 32, 87, 101, 108, 116, 33).

Jedes Zeichen des Eingabestrings ist hierin durch die Dezimalzahl seines Uni­code-Codepoints repräsentiert, so etwa das H (Unicode U+0072) durch 72.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:string-to-codepoints($arg as xs:string?) as xs:integer*

   

<< zurück

vor >>