XPath:Funkcje:translate

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

Spis treści 1 Składnia 2 Argumenty 3 Zwraca 4 Uwagi 5 Definicja 6 Gecko

Funkcja translate ocenia ciąg i zbiór znaków do przetłumaczenia i zwraca przetłumaczony łańcuch znaków.

[edytuj] Składnia

translate( łańcuch , abc , XYZ )

[edytuj] Argumenty

string

Oceniany łańcuch znaków.

abc

Ciąg znaków, które zostaną zastąpione.

XYZ

Ciąg znaków, które użyte zostaną do zastąpienia. Pierwszy znak w XYZ zastąpi każde wystąpienie pierwszego znaku w abc, które pojawi się w łańcuch.

[edytuj] Zwraca

Przetłumaczony łańcuch znaków.

[edytuj] Uwagi

W XPath funkcja translate nie jest wystarczającym rozwiązaniem w przypadku konwersji we wszystkich językach. Przyszłe wersje XPath mogą dostarczyć dodatkowych funkcji dla przypadku konwersji.

Jednakże jest to obecnie rozwiązanie najbliższe funkcji, która potrafi skonwertować łańcuch znaków do małych lub dużych znaków.

Przykład

<xsl:value-of select="translate('The quick brown fox.', 'abcdefghijklmnopqrstuvwxyz', 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'" />

Otrzymamy

THE QUICK BROWN FOX.

• Jeśli abc jest dłuższy niż XYZ, to każde wystąpienie znaków w abc, które nie ma odpowiadającego znaku w XYZ, zostanie usunięte.

Przykład

<xsl:value-of select="translate('The quick brown fox.', 'brown', 'red'" />

Otrzymamy

The quick red fdx.

• Jeśli XYZ zawiera więcej znaków niż abc, dodatkowe znaki są ignorowane.

[edytuj] Definicja

XPath 1.0 4.2

[edytuj] Gecko

Obsługuje.