---
title: translate
slug: Web/XPath/Functions/translate
tags:
  - Dokumentacje
  - Wszystkie_kategorie
  - XSLT
  - XSLT:Dokumentacje
translation_of: Web/XPath/Functions/translate
original_slug: Web/XPath/Funkcje/translate
---
<p>{{ XsltRef() }}</p>

<p><br>
 Funkcja <code>translate</code> ocenia ciąg i zbiór znaków do przetłumaczenia i zwraca przetłumaczony łańcuch znaków.</p>

<h3 id="Sk.C5.82adnia" name="Sk.C5.82adnia">Składnia</h3>

<pre class="eval">translate( <em><code>string</code></em>,<em> abc</em>, <em>XYZ</em> )
</pre>

<h3 id="Argumenty" name="Argumenty">Argumenty</h3>

<dl>
 <dt><em><code>string</code></em></dt>
 <dd>Oceniany łańcuch znaków.</dd>
</dl>

<dl>
 <dt><em><code>abc</code></em></dt>
 <dd>Ciąg znaków, które zostaną zastąpione.</dd>
</dl>

<dl>
 <dt><em><code>XYZ</code></em></dt>
 <dd>Ciąg znaków, które użyte zostaną do zastąpienia. Pierwszy znak w <em><code>XYZ</code></em> zastąpi każde wystąpienie pierwszego znaku w <em><code>abc</code></em>, które pojawi się w<em><code> </code></em> <em><code>string</code></em> .</dd>
</dl>

<h3 id="Zwraca" name="Zwraca">Zwraca</h3>

<p>Przetłumaczony łańcuch znaków.</p>

<h3 id="Uwagi" name="Uwagi">Uwagi</h3>

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

<p>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.</p>

<p>Przykład</p>

<pre class="eval">&lt;xsl:value-of select="translate('The quick brown fox.', 'abcdefghijklmnopqrstuvwxyz', 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'" /&gt;
</pre>

<p>Otrzymamy</p>

<pre class="eval">THE QUICK BROWN FOX.
</pre>

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

<p>Przykład</p>

<pre class="eval">&lt;xsl:value-of select="translate('The quick brown fox.', 'brown', 'red'" /&gt;
</pre>

<p>Otrzymamy</p>

<pre class="eval">The quick red fox.
</pre>

<ul>
 <li>Jeśli<em><code> XYZ</code></em> zawiera więcej znaków niż <em><code>abc</code></em>, dodatkowe znaki są ignorowane.</li>
</ul>

<h3 id="Definicja" name="Definicja">Definicja</h3>

<p><a class="external" href="http://www.w3.org/TR/xpath#function-translate">XPath 1.0 4.2</a></p>

<h3 id="Gecko" name="Gecko">Gecko</h3>

<p>Obsługuje.</p>

<div class="noinclude"> </div>

<p>{{ languages( { "en": "en/XPath/Functions/translate", "fr": "fr/XPath/Fonctions/translate", "ja": "ja/XPath/Functions/translate" } ) }}</p>