translate-Funktion

Gibt die erste Argumentzeichenfolge zurück, wobei jedes Vorkommen von Zeichen aus der zweiten Argumentzeichenfolge durch das Zeichen an der entsprechenden Position in der dritten Argumentzeichenfolge ersetzt wurde.

string translate(string, string, string)

Hinweise

Diese Funktion führt eine Zuordnung von Zeichen für das erste Argument durch. Das zweite und dritte Argument beschreiben das Zuordnungsschema.

Der folgende Funktionsaufruf gibt "BAr" zurück.

translate("bar","abc","ABC")

Wenn in der zweiten Argumentzeichenfolge ein Zeichen vorhanden ist, an der entsprechenden Position in der dritten Argumentzeichenfolge jedoch nicht (da die zweite Argumentzeichenfolge länger ist als die dritte), werden die Vorkommen dieses Zeichens in der ersten Argumentzeichenfolge entfernt.

Der folgende Funktionsaufruf gibt AAA zurück.

translate("--aaa--","abc-","ABC")

Wenn ein Zeichen mehr als einmal in der zweiten Argumentzeichenfolge vorkommt, bestimmt das erste Vorkommen das zu ersetzende Zeichen. Wenn die dritte Argumentzeichenfolge länger ist als die zweite Argumentzeichenfolge, werden die überzähligen Zeichen ignoriert.

Wenn ein Argument nicht vom Typ string ist, wird es zunächst mithilfe der string()-Funktion in eine Zeichenfolge konvertiert. Anschließend wird das Ergebnis dieser Konvertierung ausgewertet.

Vorsicht:
Zeichenfolgenkonvertierungen für Knotengruppen, die als Argumente an diese Funktion übergeben werden, führen möglicherweise zu unerwarteten Ergebnissen.Weitere Informationen finden Sie unter string-Funktion.

Bei dieser Funktion muss die Groß- und Kleinschreibung berücksichtigt werden.

Beispiel

In diesem Beispiel werden die vorhergehenden translate()-Ausdrücke veranschaulicht.

XML-Datei

Keine; die XSLT-Datei ruft sich selbst auf.

XSLT-Datei (translate.xsl)

Formatierte Ausgabe

translate("bar","abc","ABC") = BAr translate("--aaa--","abc-","ABC") = AAA

Prozessorausgabe

<?xml version="1.0" encoding="UTF-16"?>   translate("bar","abc","ABC") =       BAr<br />translate("--aaa--","abc-","ABC") =       AAA

Siehe auch

Verweis

Referenz zu XML-Datentypen