Commit f90c0595 authored by Heikki Linnakangas's avatar Heikki Linnakangas

doc: \123 and \x12 escapes in COPY are in database encoding.

The backslash sequences, including \123 and \x12 escapes, are interpreted
after encoding conversion. The docs failed to mention that.

Backpatch to all supported versions.

Reported-by: Andreas Grob
Discussion: https://www.postgresql.org/message-id/17142-9181542ca1df75ab%40postgresql.org
parent b3d24cc0
...@@ -636,12 +636,12 @@ COPY <replaceable class="parameter">count</replaceable> ...@@ -636,12 +636,12 @@ COPY <replaceable class="parameter">count</replaceable>
<row> <row>
<entry><literal>\</literal><replaceable>digits</replaceable></entry> <entry><literal>\</literal><replaceable>digits</replaceable></entry>
<entry>Backslash followed by one to three octal digits specifies <entry>Backslash followed by one to three octal digits specifies
the character with that numeric code</entry> the byte with that numeric code</entry>
</row> </row>
<row> <row>
<entry><literal>\x</literal><replaceable>digits</replaceable></entry> <entry><literal>\x</literal><replaceable>digits</replaceable></entry>
<entry>Backslash <literal>x</literal> followed by one or two hex digits specifies <entry>Backslash <literal>x</literal> followed by one or two hex digits specifies
the character with that numeric code</entry> the byte with that numeric code</entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
...@@ -673,6 +673,12 @@ COPY <replaceable class="parameter">count</replaceable> ...@@ -673,6 +673,12 @@ COPY <replaceable class="parameter">count</replaceable>
or vice versa). or vice versa).
</para> </para>
<para>
All backslash sequences are interpreted after encoding conversion.
The bytes specified with the octal and hex-digit backslash sequences must
form valid characters in the database encoding.
</para>
<para> <para>
<command>COPY TO</command> will terminate each row with a Unix-style <command>COPY TO</command> will terminate each row with a Unix-style
newline (<quote><literal>\n</literal></quote>). Servers running on Microsoft Windows instead newline (<quote><literal>\n</literal></quote>). Servers running on Microsoft Windows instead
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment