From: Alvaro Herrera <alvherre@alvh.no-ip.org>
Date: Sat, 16 Oct 2010 04:11:38 +0000 (-0300)
Subject: Document that translate() removes characters in "from" that don't have
X-Git-Tag: REL9_1_ALPHA2~73
X-Git-Url: http://git.postgresql.org/gitweb/?a=commitdiff_plain;h=33ae03f4003adb27651d00688016d1c4a979686f;p=postgresql.git

Document that translate() removes characters in "from" that don't have
a corresponding "to" character.

Author: Josh Kupershmidt
---

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 5d422afef26..183b72cda48 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1866,10 +1866,12 @@
         Any character in <parameter>string</parameter> that matches a
         character in the <parameter>from</parameter> set is replaced by
         the corresponding character in the <parameter>to</parameter>
-        set
+        set. If <parameter>from</parameter> is longer than
+        <parameter>to</parameter>, occurrences of the extra characters in
+        <parameter>from</parameter> are removed.
        </entry>
-       <entry><literal>translate('12345', '14', 'ax')</literal></entry>
-       <entry><literal>a23x5</literal></entry>
+       <entry><literal>translate('12345', '143', 'ax')</literal></entry>
+       <entry><literal>a2x5</literal></entry>
       </row>       
       
      </tbody>