Name
charset_recode — Translate a string to another character set
Synopsis
any
charset_recode
(
|
in src_string varchar/nvarchar , |
| in src_charset varchar , | |
in
dst_charset
varchar
); |
Description
This function translates a string from a given source charset to a destination charset. It provides a generic way of recoding string entities.
The src_charset may be a narrow or a wide
string . If it's a narrow string (
VARCHAR ) then the src_charset
is taken into account and defines the current encoding of the
src_string . In any other case
src_charset is ignored.
src_charset and
dst_charset are names of system-defined 8
bit charset tables. Use charsets_list to
obtain a list of currently defined character sets and aliases. If
either of these is null, then the charset in effect is used. There
are two special character set names - "UTF-8" and "_WIDE_" - that
are recognized by this function. These represent UTF-8 encoding of
characters and wide string ( NVARCHAR ).
Parameters
src_string
The input data to be converted. String or wide string.
src_charset
Input data character set, string .
dst_charset
The charset to convert to, string .
Examples
Example 24.38. Recoding a narrow ISO-8859-1 string as UTF-8
select cast (charset_recode ('\xA9', 'ISO-8859-1', 'UTF-8') as varbinary)
-- converts "Copyright sign" to UTF-8 (output 0xC2A9)
select cast (charset_recode ('\xC0', 'WINDOWS-1251', 'ISO-8859-5') as varbinary)
-- converts "Cyrillic A" from WINDOWS-1251 charset to ISO-8859-5 (output 0xB0).
select cast (charset_recode (N'\x410', '_WIDE_', 'WINDOWS-1251') as varbinary)
-- converts "Cyrillic A" from Unicode to WINDOWS-1251 charset (result '\xC0').
select charset_recode (N'\x410', '_WIDE_', 'ISO-8859-1')
-- converts "Cyrillic A" from Unicode to ISO-8859-1 charset (Not available : result '?').