fn:codepoint-equal

(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-Vergleich

Herkunft: XPath 2.0

Rückgabewert: Ein Boolescher Wert xs:boolean; der Wert true, wenn die Argumente von den Codepoints übereinstimmen, sonst false.

Aufruf/Argumente:

fn:codepoints-equal($eingabestring, $vergleichsstring)

$eingabestring:
Ein String xs:string, dessen Codepoints anhand der Unicode-Collation mit denen eines Vergleichsstrings verglichen werden sollen. Die leere Sequenz ist als Argument gestattet – die Funktion gibt in diesem Fall eine leere Ergebnissequenz zurück.

$vergleichsstring:
Ein String xs:string, dessen Codepoints mit denen des als ersten Arguments übergebenen Strings verglichen werden sollen. Die leere Sequenz ist als Argument gestattet – die Funktion gibt in diesem Fall eine leere Ergebnissequenz zurück.

Verwendungszweck:

Die Funktion fn:codepoints-equal() vergleicht die Unicode-Codepoints der Zeichen zweier, ihr übergebener Zeichenketten. Sie verwendet hierfür die Unicode Codepoint Collation, die von jeder XPath-Implementierung unterstützt werden muss. Die Funktion gibt den Booleschen Wert true zurück, wenn beide Argumente übergeben wurden und die Codepoints aller Zeichen der Strings paarweise übereinstimmen, sprich, wenn die Eingabestrings einander entsprechen. In allen anderen Fällen wird false zurückgegeben.

Wird für ein oder beide Argumente die leere Sequenz übergeben, so gibt die Funktion eine leere Ergebnissequenz zurück (in diesem Fall wird also kein Boolescher Wert ausgegeben!)

Beispiele:

Beispiel 1 – Vergleich zweier identischer Strings:

fn:codepoints-equal( 'Mein Beispielstring',
                     'Mein Beispielstring'
  )

ergibt den Wert true.

Beispiel 2 – Vergleich zweier unterschiedlicher Strings:

fn:codepoints-equal( 'Was muß das muß!',
                     'Was muss das muss!'
  )

ergibt den Wert false.

Beispiel 3 – Übergabe der leeren Sequenz:

fn:codepoints-equal( 'Ist jetzt auch egal...',
                     ()
  )

Anstelle eines zweiten Arguments wird die leere Sequenz übergeben. Die Funktion gibt folglich eine leere Ergebissequenz zurück.

Funktionsdefinition:

XPath 1.0:

Funktion nicht verfügbar

XPath 2.0:

fn:codepoint-equal($comparand1 as xs:string?,
                   $comparand2 as xs:string?) as xs:boolean?

   

<< zurück

vor >>