PostgreSQL Source Code  git master
pg_wchar.h File Reference
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  pg_enc2name
 
struct  pg_enc2gettext
 
struct  pg_wchar_tbl
 
struct  pg_mb_radix_tree
 
struct  pg_utf_to_local_combined
 
struct  pg_local_to_utf_combined
 

Macros

#define MAX_MULTIBYTE_CHAR_LEN   4
 
#define SS2   0x8e /* single shift 2 (JIS0201) */
 
#define SS3   0x8f /* single shift 3 (JIS0212) */
 
#define ISSJISHEAD(c)   (((c) >= 0x81 && (c) <= 0x9f) || ((c) >= 0xe0 && (c) <= 0xfc))
 
#define ISSJISTAIL(c)   (((c) >= 0x40 && (c) <= 0x7e) || ((c) >= 0x80 && (c) <= 0xfc))
 
#define LC_ISO8859_1   0x81 /* ISO8859 Latin 1 */
 
#define LC_ISO8859_2   0x82 /* ISO8859 Latin 2 */
 
#define LC_ISO8859_3   0x83 /* ISO8859 Latin 3 */
 
#define LC_ISO8859_4   0x84 /* ISO8859 Latin 4 */
 
#define LC_TIS620   0x85 /* Thai (not supported yet) */
 
#define LC_ISO8859_7   0x86 /* Greek (not supported yet) */
 
#define LC_ISO8859_6   0x87 /* Arabic (not supported yet) */
 
#define LC_ISO8859_8   0x88 /* Hebrew (not supported yet) */
 
#define LC_JISX0201K   0x89 /* Japanese 1 byte kana */
 
#define LC_JISX0201R   0x8a /* Japanese 1 byte Roman */
 
#define LC_KOI8_R   0x8b /* Cyrillic KOI8-R */
 
#define LC_ISO8859_5   0x8c /* ISO8859 Cyrillic */
 
#define LC_ISO8859_9   0x8d /* ISO8859 Latin 5 (not supported yet) */
 
#define LC_ISO8859_15   0x8e /* ISO8859 Latin 15 (not supported yet) */
 
#define IS_LC1(c)   ((unsigned char)(c) >= 0x81 && (unsigned char)(c) <= 0x8d)
 
#define LC_JISX0208_1978   0x90 /* Japanese Kanji, old JIS (not supported) */
 
#define LC_GB2312_80   0x91 /* Chinese */
 
#define LC_JISX0208   0x92 /* Japanese Kanji (JIS X 0208) */
 
#define LC_KS5601   0x93 /* Korean */
 
#define LC_JISX0212   0x94 /* Japanese Kanji (JIS X 0212) */
 
#define LC_CNS11643_1   0x95 /* CNS 11643-1992 Plane 1 */
 
#define LC_CNS11643_2   0x96 /* CNS 11643-1992 Plane 2 */
 
#define LC_JISX0213_1
 
#define LC_BIG5_1
 
#define LC_BIG5_2
 
#define IS_LC2(c)   ((unsigned char)(c) >= 0x90 && (unsigned char)(c) <= 0x99)
 
#define LCPRV1_A   0x9a
 
#define LCPRV1_B   0x9b
 
#define IS_LCPRV1(c)   ((unsigned char)(c) == LCPRV1_A || (unsigned char)(c) == LCPRV1_B)
 
#define IS_LCPRV1_A_RANGE(c)   ((unsigned char)(c) >= 0xa0 && (unsigned char)(c) <= 0xdf)
 
#define IS_LCPRV1_B_RANGE(c)   ((unsigned char)(c) >= 0xe0 && (unsigned char)(c) <= 0xef)
 
#define LCPRV2_A   0x9c
 
#define LCPRV2_B   0x9d
 
#define IS_LCPRV2(c)   ((unsigned char)(c) == LCPRV2_A || (unsigned char)(c) == LCPRV2_B)
 
#define IS_LCPRV2_A_RANGE(c)   ((unsigned char)(c) >= 0xf0 && (unsigned char)(c) <= 0xf4)
 
#define IS_LCPRV2_B_RANGE(c)   ((unsigned char)(c) >= 0xf5 && (unsigned char)(c) <= 0xfe)
 
#define LC_SISHENG
 
#define LC_IPA
 
#define LC_VISCII_LOWER
 
#define LC_VISCII_UPPER
 
#define LC_ARABIC_DIGIT   0xa4 /* Arabic digit (not supported) */
 
#define LC_ARABIC_1_COLUMN   0xa5 /* Arabic 1-column (not supported) */
 
#define LC_ASCII_RIGHT_TO_LEFT
 
#define LC_LAO
 
#define LC_ARABIC_2_COLUMN   0xa8 /* Arabic 1-column (not supported) */
 
#define LC_INDIAN_1_COLUMN
 
#define LC_TIBETAN_1_COLUMN
 
#define LC_UNICODE_SUBSET_2
 
#define LC_UNICODE_SUBSET_3
 
#define LC_UNICODE_SUBSET
 
#define LC_ETHIOPIC   0xf5 /* Ethiopic characters (not supported) */
 
#define LC_CNS11643_3   0xf6 /* CNS 11643-1992 Plane 3 */
 
#define LC_CNS11643_4   0xf7 /* CNS 11643-1992 Plane 4 */
 
#define LC_CNS11643_5   0xf8 /* CNS 11643-1992 Plane 5 */
 
#define LC_CNS11643_6   0xf9 /* CNS 11643-1992 Plane 6 */
 
#define LC_CNS11643_7   0xfa /* CNS 11643-1992 Plane 7 */
 
#define LC_INDIAN_2_COLUMN
 
#define LC_TIBETAN   0xfc /* Tibetan (not supported) */
 
#define PG_ENCODING_BE_LAST   PG_KOI8U
 
#define PG_VALID_BE_ENCODING(_enc)   ((_enc) >= 0 && (_enc) <= PG_ENCODING_BE_LAST)
 
#define PG_ENCODING_IS_CLIENT_ONLY(_enc)   ((_enc) > PG_ENCODING_BE_LAST && (_enc) < _PG_LAST_ENCODING_)
 
#define PG_VALID_ENCODING(_enc)   ((_enc) >= 0 && (_enc) < _PG_LAST_ENCODING_)
 
#define PG_VALID_FE_ENCODING(_enc)   PG_VALID_ENCODING(_enc)
 
#define MAX_CONVERSION_GROWTH   4
 
#define MAX_UNICODE_EQUIVALENT_STRING   16
 
#define CHECK_ENCODING_CONVERSION_ARGS(srcencoding, destencoding)
 

Typedefs

typedef unsigned int pg_wchar
 
typedef enum pg_enc pg_enc
 
typedef struct pg_enc2name pg_enc2name
 
typedef struct pg_enc2gettext pg_enc2gettext
 
typedef int(* mb2wchar_with_len_converter) (const unsigned char *from, pg_wchar *to, int len)
 
typedef int(* wchar2mb_with_len_converter) (const pg_wchar *from, unsigned char *to, int len)
 
typedef int(* mblen_converter) (const unsigned char *mbstr)
 
typedef int(* mbdisplaylen_converter) (const unsigned char *mbstr)
 
typedef bool(* mbcharacter_incrementer) (unsigned char *mbstr, int len)
 
typedef int(* mbverifier) (const unsigned char *mbstr, int len)
 
typedef uint32(* utf_local_conversion_func) (uint32 code)
 

Enumerations

enum  pg_enc {
  PG_SQL_ASCII = 0, PG_EUC_JP, PG_EUC_CN, PG_EUC_KR,
  PG_EUC_TW, PG_EUC_JIS_2004, PG_UTF8, PG_MULE_INTERNAL,
  PG_LATIN1, PG_LATIN2, PG_LATIN3, PG_LATIN4,
  PG_LATIN5, PG_LATIN6, PG_LATIN7, PG_LATIN8,
  PG_LATIN9, PG_LATIN10, PG_WIN1256, PG_WIN1258,
  PG_WIN866, PG_WIN874, PG_KOI8R, PG_WIN1251,
  PG_WIN1252, PG_ISO_8859_5, PG_ISO_8859_6, PG_ISO_8859_7,
  PG_ISO_8859_8, PG_WIN1250, PG_WIN1253, PG_WIN1254,
  PG_WIN1255, PG_WIN1257, PG_KOI8U, PG_SJIS,
  PG_BIG5, PG_GBK, PG_UHC, PG_GB18030,
  PG_JOHAB, PG_SHIFT_JIS_2004, _PG_LAST_ENCODING_
}
 

Functions

static bool is_valid_unicode_codepoint (pg_wchar c)
 
static bool is_utf16_surrogate_first (pg_wchar c)
 
static bool is_utf16_surrogate_second (pg_wchar c)
 
static pg_wchar surrogate_pair_to_codepoint (pg_wchar first, pg_wchar second)
 
int pg_char_to_encoding (const char *name)
 
const char * pg_encoding_to_char (int encoding)
 
int pg_valid_server_encoding_id (int encoding)
 
int pg_encoding_mblen (int encoding, const char *mbstr)
 
int pg_encoding_dsplen (int encoding, const char *mbstr)
 
int pg_encoding_verifymb (int encoding, const char *mbstr, int len)
 
int pg_encoding_max_length (int encoding)
 
int pg_valid_client_encoding (const char *name)
 
int pg_valid_server_encoding (const char *name)
 
bool is_encoding_supported_by_icu (int encoding)
 
const char * get_encoding_name_for_icu (int encoding)
 
unsigned char * unicode_to_utf8 (pg_wchar c, unsigned char *utf8string)
 
pg_wchar utf8_to_unicode (const unsigned char *c)
 
bool pg_utf8_islegal (const unsigned char *source, int length)
 
int pg_utf_mblen (const unsigned char *s)
 
int pg_mule_mblen (const unsigned char *s)
 
int pg_mb2wchar (const char *from, pg_wchar *to)
 
int pg_mb2wchar_with_len (const char *from, pg_wchar *to, int len)
 
int pg_encoding_mb2wchar_with_len (int encoding, const char *from, pg_wchar *to, int len)
 
int pg_wchar2mb (const pg_wchar *from, char *to)
 
int pg_wchar2mb_with_len (const pg_wchar *from, char *to, int len)
 
int pg_encoding_wchar2mb_with_len (int encoding, const pg_wchar *from, char *to, int len)
 
int pg_char_and_wchar_strcmp (const char *s1, const pg_wchar *s2)
 
int pg_wchar_strncmp (const pg_wchar *s1, const pg_wchar *s2, size_t n)
 
int pg_char_and_wchar_strncmp (const char *s1, const pg_wchar *s2, size_t n)
 
size_t pg_wchar_strlen (const pg_wchar *wstr)
 
int pg_mblen (const char *mbstr)
 
int pg_dsplen (const char *mbstr)
 
int pg_mbstrlen (const char *mbstr)
 
int pg_mbstrlen_with_len (const char *mbstr, int len)
 
int pg_mbcliplen (const char *mbstr, int len, int limit)
 
int pg_encoding_mbcliplen (int encoding, const char *mbstr, int len, int limit)
 
int pg_mbcharcliplen (const char *mbstr, int len, int limit)
 
int pg_database_encoding_max_length (void)
 
mbcharacter_incrementer pg_database_encoding_character_incrementer (void)
 
int PrepareClientEncoding (int encoding)
 
int SetClientEncoding (int encoding)
 
void InitializeClientEncoding (void)
 
int pg_get_client_encoding (void)
 
const char * pg_get_client_encoding_name (void)
 
void SetDatabaseEncoding (int encoding)
 
int GetDatabaseEncoding (void)
 
const char * GetDatabaseEncodingName (void)
 
void SetMessageEncoding (int encoding)
 
int GetMessageEncoding (void)
 
unsigned char * pg_do_encoding_conversion (unsigned char *src, int len, int src_encoding, int dest_encoding)
 
char * pg_client_to_server (const char *s, int len)
 
char * pg_server_to_client (const char *s, int len)
 
char * pg_any_to_server (const char *s, int len, int encoding)
 
char * pg_server_to_any (const char *s, int len, int encoding)
 
void pg_unicode_to_server (pg_wchar c, unsigned char *s)
 
unsigned short BIG5toCNS (unsigned short big5, unsigned char *lc)
 
unsigned short CNStoBIG5 (unsigned short cns, unsigned char lc)
 
void UtfToLocal (const unsigned char *utf, int len, unsigned char *iso, const pg_mb_radix_tree *map, const pg_utf_to_local_combined *cmap, int cmapsize, utf_local_conversion_func conv_func, int encoding)
 
void LocalToUtf (const unsigned char *iso, int len, unsigned char *utf, const pg_mb_radix_tree *map, const pg_local_to_utf_combined *cmap, int cmapsize, utf_local_conversion_func conv_func, int encoding)
 
bool pg_verifymbstr (const char *mbstr, int len, bool noError)
 
bool pg_verify_mbstr (int encoding, const char *mbstr, int len, bool noError)
 
int pg_verify_mbstr_len (int encoding, const char *mbstr, int len, bool noError)
 
void check_encoding_conversion_args (int src_encoding, int dest_encoding, int len, int expected_src_encoding, int expected_dest_encoding)
 
void report_invalid_encoding (int encoding, const char *mbstr, int len) pg_attribute_noreturn()
 
void report_untranslatable_char (int src_encoding, int dest_encoding, const char *mbstr, int len) pg_attribute_noreturn()
 
void local2local (const unsigned char *l, unsigned char *p, int len, int src_encoding, int dest_encoding, const unsigned char *tab)
 
void latin2mic (const unsigned char *l, unsigned char *p, int len, int lc, int encoding)
 
void mic2latin (const unsigned char *mic, unsigned char *p, int len, int lc, int encoding)
 
void latin2mic_with_table (const unsigned char *l, unsigned char *p, int len, int lc, int encoding, const unsigned char *tab)
 
void mic2latin_with_table (const unsigned char *mic, unsigned char *p, int len, int lc, int encoding, const unsigned char *tab)
 

Variables

const pg_enc2name pg_enc2name_tbl []
 
const pg_enc2gettext pg_enc2gettext_tbl []
 
const pg_wchar_tbl pg_wchar_table []
 

Macro Definition Documentation

◆ CHECK_ENCODING_CONVERSION_ARGS

#define CHECK_ENCODING_CONVERSION_ARGS (   srcencoding,
  destencoding 
)
Value:
(srcencoding), \
(destencoding))
#define PG_GETARG_INT32(n)
Definition: fmgr.h:269
void check_encoding_conversion_args(int src_encoding, int dest_encoding, int len, int expected_src_encoding, int expected_dest_encoding)
Definition: mbutils.c:1546

Definition at line 506 of file pg_wchar.h.

Referenced by big5_to_euc_tw(), big5_to_mic(), big5_to_utf8(), euc_cn_to_mic(), euc_cn_to_utf8(), euc_jis_2004_to_shift_jis_2004(), euc_jis_2004_to_utf8(), euc_jp_to_mic(), euc_jp_to_sjis(), euc_jp_to_utf8(), euc_kr_to_mic(), euc_kr_to_utf8(), euc_tw_to_big5(), euc_tw_to_mic(), euc_tw_to_utf8(), gb18030_to_utf8(), gbk_to_utf8(), iso8859_1_to_utf8(), iso8859_to_utf8(), iso_to_koi8r(), iso_to_mic(), iso_to_win1251(), iso_to_win866(), johab_to_utf8(), koi8r_to_iso(), koi8r_to_mic(), koi8r_to_utf8(), koi8r_to_win1251(), koi8r_to_win866(), koi8u_to_utf8(), latin1_to_mic(), latin2_to_mic(), latin2_to_win1250(), latin3_to_mic(), latin4_to_mic(), mic_to_big5(), mic_to_euc_cn(), mic_to_euc_jp(), mic_to_euc_kr(), mic_to_euc_tw(), mic_to_iso(), mic_to_koi8r(), mic_to_latin1(), mic_to_latin2(), mic_to_latin3(), mic_to_latin4(), mic_to_sjis(), mic_to_win1250(), mic_to_win1251(), mic_to_win866(), shift_jis_2004_to_euc_jis_2004(), shift_jis_2004_to_utf8(), sjis_to_euc_jp(), sjis_to_mic(), sjis_to_utf8(), uhc_to_utf8(), utf8_to_big5(), utf8_to_euc_cn(), utf8_to_euc_jis_2004(), utf8_to_euc_jp(), utf8_to_euc_kr(), utf8_to_euc_tw(), utf8_to_gb18030(), utf8_to_gbk(), utf8_to_iso8859(), utf8_to_iso8859_1(), utf8_to_johab(), utf8_to_koi8r(), utf8_to_koi8u(), utf8_to_shift_jis_2004(), utf8_to_sjis(), utf8_to_uhc(), utf8_to_win(), win1250_to_latin2(), win1250_to_mic(), win1251_to_iso(), win1251_to_koi8r(), win1251_to_mic(), win1251_to_win866(), win866_to_iso(), win866_to_koi8r(), win866_to_mic(), win866_to_win1251(), and win_to_utf8().

◆ IS_LC1

#define IS_LC1 (   c)    ((unsigned char)(c) >= 0x81 && (unsigned char)(c) <= 0x8d)

◆ IS_LC2

#define IS_LC2 (   c)    ((unsigned char)(c) >= 0x90 && (unsigned char)(c) <= 0x99)

◆ IS_LCPRV1

#define IS_LCPRV1 (   c)    ((unsigned char)(c) == LCPRV1_A || (unsigned char)(c) == LCPRV1_B)

Definition at line 152 of file pg_wchar.h.

Referenced by pg_mule2wchar_with_len(), pg_mule_dsplen(), and pg_mule_mblen().

◆ IS_LCPRV1_A_RANGE

#define IS_LCPRV1_A_RANGE (   c)    ((unsigned char)(c) >= 0xa0 && (unsigned char)(c) <= 0xdf)

Definition at line 153 of file pg_wchar.h.

Referenced by pg_wchar2mule_with_len().

◆ IS_LCPRV1_B_RANGE

#define IS_LCPRV1_B_RANGE (   c)    ((unsigned char)(c) >= 0xe0 && (unsigned char)(c) <= 0xef)

Definition at line 155 of file pg_wchar.h.

Referenced by pg_wchar2mule_with_len().

◆ IS_LCPRV2

#define IS_LCPRV2 (   c)    ((unsigned char)(c) == LCPRV2_A || (unsigned char)(c) == LCPRV2_B)

Definition at line 164 of file pg_wchar.h.

Referenced by pg_mule2wchar_with_len(), pg_mule_dsplen(), and pg_mule_mblen().

◆ IS_LCPRV2_A_RANGE

#define IS_LCPRV2_A_RANGE (   c)    ((unsigned char)(c) >= 0xf0 && (unsigned char)(c) <= 0xf4)

Definition at line 165 of file pg_wchar.h.

Referenced by pg_wchar2mule_with_len().

◆ IS_LCPRV2_B_RANGE

#define IS_LCPRV2_B_RANGE (   c)    ((unsigned char)(c) >= 0xf5 && (unsigned char)(c) <= 0xfe)

Definition at line 167 of file pg_wchar.h.

Referenced by pg_wchar2mule_with_len().

◆ ISSJISHEAD

#define ISSJISHEAD (   c)    (((c) >= 0x81 && (c) <= 0x9f) || ((c) >= 0xe0 && (c) <= 0xfc))

Definition at line 41 of file pg_wchar.h.

Referenced by pg_sjis_verifier(), and sjis2mic().

◆ ISSJISTAIL

#define ISSJISTAIL (   c)    (((c) >= 0x40 && (c) <= 0x7e) || ((c) >= 0x80 && (c) <= 0xfc))

Definition at line 42 of file pg_wchar.h.

Referenced by pg_sjis_verifier(), and sjis2mic().

◆ LC_ARABIC_1_COLUMN

#define LC_ARABIC_1_COLUMN   0xa5 /* Arabic 1-column (not supported) */

Definition at line 182 of file pg_wchar.h.

◆ LC_ARABIC_2_COLUMN

#define LC_ARABIC_2_COLUMN   0xa8 /* Arabic 1-column (not supported) */

Definition at line 188 of file pg_wchar.h.

◆ LC_ARABIC_DIGIT

#define LC_ARABIC_DIGIT   0xa4 /* Arabic digit (not supported) */

Definition at line 181 of file pg_wchar.h.

◆ LC_ASCII_RIGHT_TO_LEFT

#define LC_ASCII_RIGHT_TO_LEFT
Value:
0xa6 /* ASCII (left half of ISO8859-1) with
* right-to-left direction (not
* supported) */

Definition at line 183 of file pg_wchar.h.

◆ LC_BIG5_1

#define LC_BIG5_1
Value:
0x98 /* Plane 1 Chinese traditional (not
* supported) */

Definition at line 138 of file pg_wchar.h.

◆ LC_BIG5_2

#define LC_BIG5_2
Value:
0x99 /* Plane 1 Chinese traditional (not
* supported) */

Definition at line 140 of file pg_wchar.h.

◆ LC_CNS11643_1

#define LC_CNS11643_1   0x95 /* CNS 11643-1992 Plane 1 */

Definition at line 134 of file pg_wchar.h.

Referenced by BIG5toCNS(), CNStoBIG5(), euc_tw2mic(), mic2big5(), and mic2euc_tw().

◆ LC_CNS11643_2

#define LC_CNS11643_2   0x96 /* CNS 11643-1992 Plane 2 */

Definition at line 135 of file pg_wchar.h.

Referenced by BIG5toCNS(), CNStoBIG5(), euc_tw2mic(), mic2big5(), and mic2euc_tw().

◆ LC_CNS11643_3

#define LC_CNS11643_3   0xf6 /* CNS 11643-1992 Plane 3 */

Definition at line 204 of file pg_wchar.h.

Referenced by big52mic(), BIG5toCNS(), CNStoBIG5(), euc_tw2mic(), and mic2euc_tw().

◆ LC_CNS11643_4

#define LC_CNS11643_4   0xf7 /* CNS 11643-1992 Plane 4 */

Definition at line 205 of file pg_wchar.h.

Referenced by big52mic(), BIG5toCNS(), and CNStoBIG5().

◆ LC_CNS11643_5

#define LC_CNS11643_5   0xf8 /* CNS 11643-1992 Plane 5 */

Definition at line 206 of file pg_wchar.h.

◆ LC_CNS11643_6

#define LC_CNS11643_6   0xf9 /* CNS 11643-1992 Plane 6 */

Definition at line 207 of file pg_wchar.h.

◆ LC_CNS11643_7

#define LC_CNS11643_7   0xfa /* CNS 11643-1992 Plane 7 */

Definition at line 208 of file pg_wchar.h.

Referenced by mic2euc_tw().

◆ LC_ETHIOPIC

#define LC_ETHIOPIC   0xf5 /* Ethiopic characters (not supported) */

Definition at line 203 of file pg_wchar.h.

◆ LC_GB2312_80

#define LC_GB2312_80   0x91 /* Chinese */

Definition at line 130 of file pg_wchar.h.

Referenced by euc_cn2mic(), and mic2euc_cn().

◆ LC_INDIAN_1_COLUMN

#define LC_INDIAN_1_COLUMN
Value:
0xf0 /* Indian charset for 1-column width
* glyphs (not supported) */

Definition at line 193 of file pg_wchar.h.

◆ LC_INDIAN_2_COLUMN

#define LC_INDIAN_2_COLUMN
Value:
0xfb /* Indian charset for 2-column width
* glyphs (not supported) */

Definition at line 209 of file pg_wchar.h.

◆ LC_IPA

#define LC_IPA
Value:
0xa1 /* IPA (International Phonetic
* Association) (not supported) */

Definition at line 175 of file pg_wchar.h.

◆ LC_ISO8859_1

#define LC_ISO8859_1   0x81 /* ISO8859 Latin 1 */

Definition at line 102 of file pg_wchar.h.

Referenced by latin1_to_mic(), and mic_to_latin1().

◆ LC_ISO8859_15

#define LC_ISO8859_15   0x8e /* ISO8859 Latin 15 (not supported yet) */

Definition at line 119 of file pg_wchar.h.

◆ LC_ISO8859_2

#define LC_ISO8859_2   0x82 /* ISO8859 Latin 2 */

Definition at line 103 of file pg_wchar.h.

Referenced by latin2_to_mic(), mic_to_latin2(), mic_to_win1250(), and win1250_to_mic().

◆ LC_ISO8859_3

#define LC_ISO8859_3   0x83 /* ISO8859 Latin 3 */

Definition at line 104 of file pg_wchar.h.

Referenced by latin3_to_mic(), and mic_to_latin3().

◆ LC_ISO8859_4

#define LC_ISO8859_4   0x84 /* ISO8859 Latin 4 */

Definition at line 105 of file pg_wchar.h.

Referenced by latin4_to_mic(), and mic_to_latin4().

◆ LC_ISO8859_5

#define LC_ISO8859_5   0x8c /* ISO8859 Cyrillic */

Definition at line 117 of file pg_wchar.h.

◆ LC_ISO8859_6

#define LC_ISO8859_6   0x87 /* Arabic (not supported yet) */

Definition at line 108 of file pg_wchar.h.

◆ LC_ISO8859_7

#define LC_ISO8859_7   0x86 /* Greek (not supported yet) */

Definition at line 107 of file pg_wchar.h.

◆ LC_ISO8859_8

#define LC_ISO8859_8   0x88 /* Hebrew (not supported yet) */

Definition at line 109 of file pg_wchar.h.

◆ LC_ISO8859_9

#define LC_ISO8859_9   0x8d /* ISO8859 Latin 5 (not supported yet) */

Definition at line 118 of file pg_wchar.h.

◆ LC_JISX0201K

#define LC_JISX0201K   0x89 /* Japanese 1 byte kana */

Definition at line 110 of file pg_wchar.h.

Referenced by euc_jp2mic(), mic2euc_jp(), mic2sjis(), and sjis2mic().

◆ LC_JISX0201R

#define LC_JISX0201R   0x8a /* Japanese 1 byte Roman */

Definition at line 111 of file pg_wchar.h.

◆ LC_JISX0208

#define LC_JISX0208   0x92 /* Japanese Kanji (JIS X 0208) */

Definition at line 131 of file pg_wchar.h.

Referenced by euc_jp2mic(), mic2euc_jp(), mic2sjis(), and sjis2mic().

◆ LC_JISX0208_1978

#define LC_JISX0208_1978   0x90 /* Japanese Kanji, old JIS (not supported) */

Definition at line 129 of file pg_wchar.h.

◆ LC_JISX0212

#define LC_JISX0212   0x94 /* Japanese Kanji (JIS X 0212) */

Definition at line 133 of file pg_wchar.h.

Referenced by euc_jp2mic(), mic2euc_jp(), mic2sjis(), and sjis2mic().

◆ LC_JISX0213_1

#define LC_JISX0213_1
Value:
0x97 /* Japanese Kanji (JIS X 0213 Plane 1)
* (not supported) */

Definition at line 136 of file pg_wchar.h.

◆ LC_KOI8_R

#define LC_KOI8_R   0x8b /* Cyrillic KOI8-R */

◆ LC_KS5601

#define LC_KS5601   0x93 /* Korean */

Definition at line 132 of file pg_wchar.h.

Referenced by euc_kr2mic(), and mic2euc_kr().

◆ LC_LAO

#define LC_LAO
Value:
0xa7 /* Lao characters (ISO10646 0E80..0EDF)
* (not supported) */

Definition at line 186 of file pg_wchar.h.

◆ LC_SISHENG

#define LC_SISHENG
Value:
0xa0 /* Chinese SiSheng characters for
* PinYin/ZhuYin (not supported) */

Definition at line 173 of file pg_wchar.h.

◆ LC_TIBETAN

#define LC_TIBETAN   0xfc /* Tibetan (not supported) */

Definition at line 211 of file pg_wchar.h.

◆ LC_TIBETAN_1_COLUMN

#define LC_TIBETAN_1_COLUMN
Value:
0xf1 /* Tibetan 1-column width glyphs (not
* supported) */

Definition at line 195 of file pg_wchar.h.

◆ LC_TIS620

#define LC_TIS620   0x85 /* Thai (not supported yet) */

Definition at line 106 of file pg_wchar.h.

◆ LC_UNICODE_SUBSET

#define LC_UNICODE_SUBSET
Value:
0xf4 /* Unicode characters of the range
* U+0100..U+24FF. (not supported) */

Definition at line 201 of file pg_wchar.h.

◆ LC_UNICODE_SUBSET_2

#define LC_UNICODE_SUBSET_2
Value:
0xf2 /* Unicode characters of the range
* U+2500..U+33FF. (not supported) */

Definition at line 197 of file pg_wchar.h.

◆ LC_UNICODE_SUBSET_3

#define LC_UNICODE_SUBSET_3
Value:
0xf3 /* Unicode characters of the range
* U+E000..U+FFFF. (not supported) */

Definition at line 199 of file pg_wchar.h.

◆ LC_VISCII_LOWER

#define LC_VISCII_LOWER
Value:
0xa2 /* Vietnamese VISCII1.1 lower-case (not
* supported) */

Definition at line 177 of file pg_wchar.h.

◆ LC_VISCII_UPPER

#define LC_VISCII_UPPER
Value:
0xa3 /* Vietnamese VISCII1.1 upper-case (not
* supported) */

Definition at line 179 of file pg_wchar.h.

◆ LCPRV1_A

#define LCPRV1_A   0x9a

Definition at line 150 of file pg_wchar.h.

Referenced by pg_wchar2mule_with_len().

◆ LCPRV1_B

#define LCPRV1_B   0x9b

Definition at line 151 of file pg_wchar.h.

Referenced by pg_wchar2mule_with_len().

◆ LCPRV2_A

#define LCPRV2_A   0x9c

Definition at line 162 of file pg_wchar.h.

Referenced by pg_wchar2mule_with_len().

◆ LCPRV2_B

#define LCPRV2_B   0x9d

Definition at line 163 of file pg_wchar.h.

Referenced by big52mic(), euc_tw2mic(), mic2big5(), mic2euc_tw(), and pg_wchar2mule_with_len().

◆ MAX_CONVERSION_GROWTH

#define MAX_CONVERSION_GROWTH   4

◆ MAX_MULTIBYTE_CHAR_LEN

#define MAX_MULTIBYTE_CHAR_LEN   4

◆ MAX_UNICODE_EQUIVALENT_STRING

#define MAX_UNICODE_EQUIVALENT_STRING   16

Definition at line 325 of file pg_wchar.h.

Referenced by json_lex_string(), map_xml_name_to_sql_identifier(), and str_udeescape().

◆ PG_ENCODING_BE_LAST

#define PG_ENCODING_BE_LAST   PG_KOI8U

Definition at line 289 of file pg_wchar.h.

Referenced by get_encoding_name_for_icu().

◆ PG_ENCODING_IS_CLIENT_ONLY

#define PG_ENCODING_IS_CLIENT_ONLY (   _enc)    ((_enc) > PG_ENCODING_BE_LAST && (_enc) < _PG_LAST_ENCODING_)

Definition at line 298 of file pg_wchar.h.

Referenced by BeginCopyFrom(), and BeginCopyTo().

◆ PG_VALID_BE_ENCODING

◆ PG_VALID_ENCODING

◆ PG_VALID_FE_ENCODING

#define PG_VALID_FE_ENCODING (   _enc)    PG_VALID_ENCODING(_enc)

Definition at line 305 of file pg_wchar.h.

Referenced by pg_valid_client_encoding(), PrepareClientEncoding(), and SetClientEncoding().

◆ SS2

◆ SS3

Typedef Documentation

◆ mb2wchar_with_len_converter

typedef int(* mb2wchar_with_len_converter) (const unsigned char *from, pg_wchar *to, int len)

Definition at line 360 of file pg_wchar.h.

◆ mbcharacter_incrementer

typedef bool(* mbcharacter_incrementer) (unsigned char *mbstr, int len)

Definition at line 372 of file pg_wchar.h.

◆ mbdisplaylen_converter

typedef int(* mbdisplaylen_converter) (const unsigned char *mbstr)

Definition at line 370 of file pg_wchar.h.

◆ mblen_converter

typedef int(* mblen_converter) (const unsigned char *mbstr)

Definition at line 368 of file pg_wchar.h.

◆ mbverifier

typedef int(* mbverifier) (const unsigned char *mbstr, int len)

Definition at line 374 of file pg_wchar.h.

◆ pg_enc

typedef enum pg_enc pg_enc

◆ pg_enc2gettext

◆ pg_enc2name

typedef struct pg_enc2name pg_enc2name

◆ pg_wchar

typedef unsigned int pg_wchar

Definition at line 25 of file pg_wchar.h.

◆ utf_local_conversion_func

typedef uint32(* utf_local_conversion_func) (uint32 code)

Definition at line 498 of file pg_wchar.h.

◆ wchar2mb_with_len_converter

typedef int(* wchar2mb_with_len_converter) (const pg_wchar *from, unsigned char *to, int len)

Definition at line 364 of file pg_wchar.h.

Enumeration Type Documentation

◆ pg_enc

enum pg_enc
Enumerator
PG_SQL_ASCII 
PG_EUC_JP 
PG_EUC_CN 
PG_EUC_KR 
PG_EUC_TW 
PG_EUC_JIS_2004 
PG_UTF8 
PG_MULE_INTERNAL 
PG_LATIN1 
PG_LATIN2 
PG_LATIN3 
PG_LATIN4 
PG_LATIN5 
PG_LATIN6 
PG_LATIN7 
PG_LATIN8 
PG_LATIN9 
PG_LATIN10 
PG_WIN1256 
PG_WIN1258 
PG_WIN866 
PG_WIN874 
PG_KOI8R 
PG_WIN1251 
PG_WIN1252 
PG_ISO_8859_5 
PG_ISO_8859_6 
PG_ISO_8859_7 
PG_ISO_8859_8 
PG_WIN1250 
PG_WIN1253 
PG_WIN1254 
PG_WIN1255 
PG_WIN1257 
PG_KOI8U 
PG_SJIS 
PG_BIG5 
PG_GBK 
PG_UHC 
PG_GB18030 
PG_JOHAB 
PG_SHIFT_JIS_2004 
_PG_LAST_ENCODING_ 

Definition at line 238 of file pg_wchar.h.

239 {
240  PG_SQL_ASCII = 0, /* SQL/ASCII */
241  PG_EUC_JP, /* EUC for Japanese */
242  PG_EUC_CN, /* EUC for Chinese */
243  PG_EUC_KR, /* EUC for Korean */
244  PG_EUC_TW, /* EUC for Taiwan */
245  PG_EUC_JIS_2004, /* EUC-JIS-2004 */
246  PG_UTF8, /* Unicode UTF8 */
247  PG_MULE_INTERNAL, /* Mule internal code */
248  PG_LATIN1, /* ISO-8859-1 Latin 1 */
249  PG_LATIN2, /* ISO-8859-2 Latin 2 */
250  PG_LATIN3, /* ISO-8859-3 Latin 3 */
251  PG_LATIN4, /* ISO-8859-4 Latin 4 */
252  PG_LATIN5, /* ISO-8859-9 Latin 5 */
253  PG_LATIN6, /* ISO-8859-10 Latin6 */
254  PG_LATIN7, /* ISO-8859-13 Latin7 */
255  PG_LATIN8, /* ISO-8859-14 Latin8 */
256  PG_LATIN9, /* ISO-8859-15 Latin9 */
257  PG_LATIN10, /* ISO-8859-16 Latin10 */
258  PG_WIN1256, /* windows-1256 */
259  PG_WIN1258, /* Windows-1258 */
260  PG_WIN866, /* (MS-DOS CP866) */
261  PG_WIN874, /* windows-874 */
262  PG_KOI8R, /* KOI8-R */
263  PG_WIN1251, /* windows-1251 */
264  PG_WIN1252, /* windows-1252 */
265  PG_ISO_8859_5, /* ISO-8859-5 */
266  PG_ISO_8859_6, /* ISO-8859-6 */
267  PG_ISO_8859_7, /* ISO-8859-7 */
268  PG_ISO_8859_8, /* ISO-8859-8 */
269  PG_WIN1250, /* windows-1250 */
270  PG_WIN1253, /* windows-1253 */
271  PG_WIN1254, /* windows-1254 */
272  PG_WIN1255, /* windows-1255 */
273  PG_WIN1257, /* windows-1257 */
274  PG_KOI8U, /* KOI8-U */
275  /* PG_ENCODING_BE_LAST points to the above entry */
276 
277  /* followings are for client encoding only */
278  PG_SJIS, /* Shift JIS (Windows-932) */
279  PG_BIG5, /* Big5 (Windows-950) */
280  PG_GBK, /* GBK (Windows-936) */
281  PG_UHC, /* UHC (Windows-949) */
282  PG_GB18030, /* GB18030 */
283  PG_JOHAB, /* EUC for Korean JOHAB */
284  PG_SHIFT_JIS_2004, /* Shift-JIS-2004 */
285  _PG_LAST_ENCODING_ /* mark only */
286 
287 } pg_enc;
pg_enc
Definition: pg_wchar.h:238

Function Documentation

◆ BIG5toCNS()

unsigned short BIG5toCNS ( unsigned short  big5,
unsigned char *  lc 
)

Definition at line 292 of file big5.c.

References b1c4, b2c3, BinarySearchRange(), i, LC_CNS11643_1, LC_CNS11643_2, LC_CNS11643_3, and LC_CNS11643_4.

Referenced by big52mic(), and surrogate_pair_to_codepoint().

293 {
294  unsigned short cns = 0;
295  int i;
296 
297  if (big5 < 0xc940U)
298  {
299  /* level 1 */
300 
301  for (i = 0; i < sizeof(b1c4) / (sizeof(unsigned short) * 2); i++)
302  {
303  if (b1c4[i][0] == big5)
304  {
305  *lc = LC_CNS11643_4;
306  return (b1c4[i][1] | 0x8080U);
307  }
308  }
309 
310  if (0 < (cns = BinarySearchRange(big5Level1ToCnsPlane1, 23, big5)))
311  *lc = LC_CNS11643_1;
312  }
313  else if (big5 == 0xc94aU)
314  {
315  /* level 2 */
316  *lc = LC_CNS11643_1;
317  cns = 0x4442;
318  }
319  else
320  {
321  /* level 2 */
322  for (i = 0; i < sizeof(b2c3) / (sizeof(unsigned short) * 2); i++)
323  {
324  if (b2c3[i][0] == big5)
325  {
326  *lc = LC_CNS11643_3;
327  return (b2c3[i][1] | 0x8080U);
328  }
329  }
330 
331  if (0 < (cns = BinarySearchRange(big5Level2ToCnsPlane2, 46, big5)))
332  *lc = LC_CNS11643_2;
333  }
334 
335  if (0 == cns)
336  { /* no mapping Big5 to CNS 11643-1992 */
337  *lc = 0;
338  return (unsigned short) '?';
339  }
340 
341  return cns | 0x8080;
342 }
#define LC_CNS11643_1
Definition: pg_wchar.h:134
static unsigned short BinarySearchRange(const codes_t *array, int high, unsigned short code)
Definition: big5.c:208
static const codes_t big5Level2ToCnsPlane2[48]
Definition: big5.c:84
#define LC_CNS11643_4
Definition: pg_wchar.h:205
static const codes_t big5Level1ToCnsPlane1[25]
Definition: big5.c:25
#define LC_CNS11643_2
Definition: pg_wchar.h:135
#define LC_CNS11643_3
Definition: pg_wchar.h:204
static const unsigned short b1c4[][2]
Definition: big5.c:189
int i
static const unsigned short b2c3[][2]
Definition: big5.c:197

◆ check_encoding_conversion_args()

void check_encoding_conversion_args ( int  src_encoding,
int  dest_encoding,
int  len,
int  expected_src_encoding,
int  expected_dest_encoding 
)

Definition at line 1546 of file mbutils.c.

References elog, ERROR, name, pg_enc2name_tbl, and PG_VALID_ENCODING.

Referenced by surrogate_pair_to_codepoint().

1551 {
1552  if (!PG_VALID_ENCODING(src_encoding))
1553  elog(ERROR, "invalid source encoding ID: %d", src_encoding);
1554  if (src_encoding != expected_src_encoding && expected_src_encoding >= 0)
1555  elog(ERROR, "expected source encoding \"%s\", but got \"%s\"",
1556  pg_enc2name_tbl[expected_src_encoding].name,
1557  pg_enc2name_tbl[src_encoding].name);
1558  if (!PG_VALID_ENCODING(dest_encoding))
1559  elog(ERROR, "invalid destination encoding ID: %d", dest_encoding);
1560  if (dest_encoding != expected_dest_encoding && expected_dest_encoding >= 0)
1561  elog(ERROR, "expected destination encoding \"%s\", but got \"%s\"",
1562  pg_enc2name_tbl[expected_dest_encoding].name,
1563  pg_enc2name_tbl[dest_encoding].name);
1564  if (len < 0)
1565  elog(ERROR, "encoding conversion length must not be negative");
1566 }
#define ERROR
Definition: elog.h:43
#define PG_VALID_ENCODING(_enc)
Definition: pg_wchar.h:301
const pg_enc2name pg_enc2name_tbl[]
Definition: encnames.c:309
const char * name
Definition: encode.c:561
#define elog(elevel,...)
Definition: elog.h:228

◆ CNStoBIG5()

unsigned short CNStoBIG5 ( unsigned short  cns,
unsigned char  lc 
)

Definition at line 345 of file big5.c.

References b1c4, b2c3, BinarySearchRange(), i, LC_CNS11643_1, LC_CNS11643_2, LC_CNS11643_3, and LC_CNS11643_4.

Referenced by mic2big5(), and surrogate_pair_to_codepoint().

346 {
347  int i;
348  unsigned int big5 = 0;
349 
350  cns &= 0x7f7f;
351 
352  switch (lc)
353  {
354  case LC_CNS11643_1:
355  big5 = BinarySearchRange(cnsPlane1ToBig5Level1, 24, cns);
356  break;
357  case LC_CNS11643_2:
358  big5 = BinarySearchRange(cnsPlane2ToBig5Level2, 47, cns);
359  break;
360  case LC_CNS11643_3:
361  for (i = 0; i < sizeof(b2c3) / (sizeof(unsigned short) * 2); i++)
362  {
363  if (b2c3[i][1] == cns)
364  return b2c3[i][0];
365  }
366  break;
367  case LC_CNS11643_4:
368  for (i = 0; i < sizeof(b1c4) / (sizeof(unsigned short) * 2); i++)
369  {
370  if (b1c4[i][1] == cns)
371  return b1c4[i][0];
372  }
373  default:
374  break;
375  }
376  return big5;
377 }
#define LC_CNS11643_1
Definition: pg_wchar.h:134
static unsigned short BinarySearchRange(const codes_t *array, int high, unsigned short code)
Definition: big5.c:208
#define LC_CNS11643_4
Definition: pg_wchar.h:205
static const codes_t cnsPlane2ToBig5Level2[49]
Definition: big5.c:136
static const codes_t cnsPlane1ToBig5Level1[26]
Definition: big5.c:54
#define LC_CNS11643_2
Definition: pg_wchar.h:135
#define LC_CNS11643_3
Definition: pg_wchar.h:204
static const unsigned short b1c4[][2]
Definition: big5.c:189
int i
static const unsigned short b2c3[][2]
Definition: big5.c:197

◆ get_encoding_name_for_icu()

const char* get_encoding_name_for_icu ( int  encoding)

Definition at line 470 of file encnames.c.

References pg_encname::encoding, lengthof, pg_enc2icu_tbl, PG_ENCODING_BE_LAST, PG_VALID_BE_ENCODING, and StaticAssertStmt.

Referenced by get_collation_version_for_oid(), and surrogate_pair_to_codepoint().

471 {
473  "pg_enc2icu_tbl incomplete");
474 
476  return NULL;
477  return pg_enc2icu_tbl[encoding];
478 }
#define lengthof(array)
Definition: c.h:730
#define StaticAssertStmt(condition, errmessage)
Definition: c.h:914
#define PG_ENCODING_BE_LAST
Definition: pg_wchar.h:289
static const char *const pg_enc2icu_tbl[]
Definition: encnames.c:415
#define PG_VALID_BE_ENCODING(_enc)
Definition: pg_wchar.h:295
int32 encoding
Definition: pg_database.h:41

◆ GetDatabaseEncoding()

int GetDatabaseEncoding ( void  )

Definition at line 1151 of file mbutils.c.

References pg_enc2name::encoding.

Referenced by ascii(), BeginCopyFrom(), BeginCopyTo(), char2wchar(), chr(), CollationCreate(), CollationGetCollid(), compareStrings(), convert_from_utf8(), convert_to_utf8(), cstr2sv(), dblink_connect(), dblink_get_conn(), DefineCollation(), Generic_Text_IC_like(), GenericMatchText(), get_collation_oid(), get_collation_version_for_oid(), get_json_object_as_hash(), InitializeClientEncoding(), IsThereCollationInNamespace(), json_recv(), jsonb_from_cstring(), locate_stem_module(), LogicalOutputWrite(), makeJsonLexContext(), p_isspecial(), ParallelWorkerMain(), pg_database_encoding_character_incrementer(), pg_database_encoding_max_length(), pg_generic_charinc(), pg_perm_setlocale(), pg_set_regex_collation(), pg_unicode_to_server(), pg_verifymbstr(), pgss_store(), PLyUnicode_Bytes(), populate_array_json(), PrepareClientEncoding(), read_extension_script_file(), SetClientEncoding(), SetMessageEncoding(), SPI_sql_row_to_xmlelement(), surrogate_pair_to_codepoint(), sv2cstr(), text_position_setup(), to_ascii_default(), type_maximum_size(), unicode_norm_form_from_string(), varstr_abbrev_convert(), varstr_cmp(), varstr_sortsupport(), varstrfastcmp_locale(), wchar2char(), xml_in(), xml_is_document(), xmlparse(), and xpath_exists().

1152 {
1153  return DatabaseEncoding->encoding;
1154 }
pg_enc encoding
Definition: pg_wchar.h:338
static const pg_enc2name * DatabaseEncoding
Definition: mbutils.c:81

◆ GetDatabaseEncodingName()

const char* GetDatabaseEncodingName ( void  )

◆ GetMessageEncoding()

int GetMessageEncoding ( void  )

Definition at line 1198 of file mbutils.c.

References pg_enc2name::encoding.

Referenced by DebugFileOpen(), report_untranslatable_char(), SetMessageEncoding(), and surrogate_pair_to_codepoint().

1199 {
1200  return MessageEncoding->encoding;
1201 }
pg_enc encoding
Definition: pg_wchar.h:338
static const pg_enc2name * MessageEncoding
Definition: mbutils.c:82

◆ InitializeClientEncoding()

void InitializeClientEncoding ( void  )

Definition at line 281 of file mbutils.c.

References Assert, backend_startup_complete, ereport, errcode(), errmsg(), FATAL, FindDefaultConversionProc(), fmgr_info_cxt(), GetDatabaseEncoding(), GetDatabaseEncodingName(), IsTransactionState(), MemoryContextAlloc(), name, OidIsValid, pending_client_encoding, pg_enc2name_tbl, PG_SQL_ASCII, PG_UTF8, PrepareClientEncoding(), SetClientEncoding(), and TopMemoryContext.

Referenced by InitPostgres(), and surrogate_pair_to_codepoint().

282 {
283  int current_server_encoding;
284 
287 
290  {
291  /*
292  * Oops, the requested conversion is not available. We couldn't fail
293  * before, but we can now.
294  */
295  ereport(FATAL,
296  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
297  errmsg("conversion between %s and %s is not supported",
300  }
301 
302  /*
303  * Also look up the UTF8-to-server conversion function if needed. Since
304  * the server encoding is fixed within any one backend process, we don't
305  * have to do this more than once.
306  */
307  current_server_encoding = GetDatabaseEncoding();
308  if (current_server_encoding != PG_UTF8 &&
309  current_server_encoding != PG_SQL_ASCII)
310  {
311  Oid utf8_to_server_proc;
312 
314  utf8_to_server_proc =
316  current_server_encoding);
317  /* If there's no such conversion, just leave the pointer as NULL */
318  if (OidIsValid(utf8_to_server_proc))
319  {
320  FmgrInfo *finfo;
321 
323  sizeof(FmgrInfo));
324  fmgr_info_cxt(utf8_to_server_proc, finfo,
326  /* Set Utf8ToServerConvProc only after data is fully valid */
327  Utf8ToServerConvProc = finfo;
328  }
329  }
330 }
Definition: fmgr.h:56
static FmgrInfo * Utf8ToServerConvProc
Definition: mbutils.c:75
int PrepareClientEncoding(int encoding)
Definition: mbutils.c:110
static bool backend_startup_complete
Definition: mbutils.c:90
static int pending_client_encoding
Definition: mbutils.c:91
int errcode(int sqlerrcode)
Definition: elog.c:691
unsigned int Oid
Definition: postgres_ext.h:31
#define OidIsValid(objectId)
Definition: c.h:706
#define FATAL
Definition: elog.h:52
const pg_enc2name pg_enc2name_tbl[]
Definition: encnames.c:309
int SetClientEncoding(int encoding)
Definition: mbutils.c:208
void fmgr_info_cxt(Oid functionId, FmgrInfo *finfo, MemoryContext mcxt)
Definition: fmgr.c:136
MemoryContext TopMemoryContext
Definition: mcxt.c:44
int GetDatabaseEncoding(void)
Definition: mbutils.c:1151
#define ereport(elevel,...)
Definition: elog.h:155
#define Assert(condition)
Definition: c.h:800
const char * GetDatabaseEncodingName(void)
Definition: mbutils.c:1157
Oid FindDefaultConversionProc(int32 for_encoding, int32 to_encoding)
Definition: namespace.c:3709
bool IsTransactionState(void)
Definition: xact.c:371
const char * name
Definition: encode.c:561
int errmsg(const char *fmt,...)
Definition: elog.c:902
void * MemoryContextAlloc(MemoryContext context, Size size)
Definition: mcxt.c:797

◆ is_encoding_supported_by_icu()

bool is_encoding_supported_by_icu ( int  encoding)

Definition at line 459 of file encnames.c.

References pg_enc2icu_tbl, and PG_VALID_BE_ENCODING.

Referenced by lookup_collation(), and surrogate_pair_to_codepoint().

460 {
462  return false;
463  return (pg_enc2icu_tbl[encoding] != NULL);
464 }
static const char *const pg_enc2icu_tbl[]
Definition: encnames.c:415
#define PG_VALID_BE_ENCODING(_enc)
Definition: pg_wchar.h:295
int32 encoding
Definition: pg_database.h:41

◆ is_utf16_surrogate_first()

static bool is_utf16_surrogate_first ( pg_wchar  c)
inlinestatic

Definition at line 524 of file pg_wchar.h.

Referenced by json_lex_string(), and str_udeescape().

525 {
526  return (c >= 0xD800 && c <= 0xDBFF);
527 }
char * c

◆ is_utf16_surrogate_second()

static bool is_utf16_surrogate_second ( pg_wchar  c)
inlinestatic

Definition at line 530 of file pg_wchar.h.

Referenced by json_lex_string(), and str_udeescape().

531 {
532  return (c >= 0xDC00 && c <= 0xDFFF);
533 }
char * c

◆ is_valid_unicode_codepoint()

static bool is_valid_unicode_codepoint ( pg_wchar  c)
inlinestatic

Definition at line 518 of file pg_wchar.h.

Referenced by check_unicode_value(), and pg_unicode_to_server().

519 {
520  return (c > 0 && c <= 0x10FFFF);
521 }
char * c

◆ latin2mic()

void latin2mic ( const unsigned char *  l,
unsigned char *  p,
int  len,
int  lc,
int  encoding 
)

Definition at line 71 of file conv.c.

References IS_HIGHBIT_SET, and report_invalid_encoding().

Referenced by koi8r_to_mic(), latin1_to_mic(), latin2_to_mic(), latin3_to_mic(), latin4_to_mic(), and surrogate_pair_to_codepoint().

73 {
74  int c1;
75 
76  while (len > 0)
77  {
78  c1 = *l;
79  if (c1 == 0)
80  report_invalid_encoding(encoding, (const char *) l, len);
81  if (IS_HIGHBIT_SET(c1))
82  *p++ = lc;
83  *p++ = c1;
84  l++;
85  len--;
86  }
87  *p = '\0';
88 }
void report_invalid_encoding(int encoding, const char *mbstr, int len)
Definition: mbutils.c:1575
#define IS_HIGHBIT_SET(ch)
Definition: c.h:1152
int32 encoding
Definition: pg_database.h:41

◆ latin2mic_with_table()

void latin2mic_with_table ( const unsigned char *  l,
unsigned char *  p,
int  len,
int  lc,
int  encoding,
const unsigned char *  tab 
)

Definition at line 148 of file conv.c.

References HIGHBIT, IS_HIGHBIT_SET, PG_MULE_INTERNAL, report_invalid_encoding(), and report_untranslatable_char().

Referenced by iso_to_mic(), surrogate_pair_to_codepoint(), win1250_to_mic(), win1251_to_mic(), and win866_to_mic().

154 {
155  unsigned char c1,
156  c2;
157 
158  while (len > 0)
159  {
160  c1 = *l;
161  if (c1 == 0)
162  report_invalid_encoding(encoding, (const char *) l, len);
163  if (!IS_HIGHBIT_SET(c1))
164  *p++ = c1;
165  else
166  {
167  c2 = tab[c1 - HIGHBIT];
168  if (c2)
169  {
170  *p++ = lc;
171  *p++ = c2;
172  }
173  else
175  (const char *) l, len);
176  }
177  l++;
178  len--;
179  }
180  *p = '\0';
181 }
void report_invalid_encoding(int encoding, const char *mbstr, int len)
Definition: mbutils.c:1575
#define IS_HIGHBIT_SET(ch)
Definition: c.h:1152
#define HIGHBIT
Definition: c.h:1151
int32 encoding
Definition: pg_database.h:41
void report_untranslatable_char(int src_encoding, int dest_encoding, const char *mbstr, int len)
Definition: mbutils.c:1607

◆ local2local()

void local2local ( const unsigned char *  l,
unsigned char *  p,
int  len,
int  src_encoding,
int  dest_encoding,
const unsigned char *  tab 
)

Definition at line 30 of file conv.c.

References HIGHBIT, IS_HIGHBIT_SET, report_invalid_encoding(), and report_untranslatable_char().

Referenced by iso_to_koi8r(), iso_to_win1251(), iso_to_win866(), koi8r_to_iso(), koi8r_to_win1251(), koi8r_to_win866(), latin2_to_win1250(), surrogate_pair_to_codepoint(), win1250_to_latin2(), win1251_to_iso(), win1251_to_koi8r(), win1251_to_win866(), win866_to_iso(), win866_to_koi8r(), and win866_to_win1251().

36 {
37  unsigned char c1,
38  c2;
39 
40  while (len > 0)
41  {
42  c1 = *l;
43  if (c1 == 0)
44  report_invalid_encoding(src_encoding, (const char *) l, len);
45  if (!IS_HIGHBIT_SET(c1))
46  *p++ = c1;
47  else
48  {
49  c2 = tab[c1 - HIGHBIT];
50  if (c2)
51  *p++ = c2;
52  else
53  report_untranslatable_char(src_encoding, dest_encoding,
54  (const char *) l, len);
55  }
56  l++;
57  len--;
58  }
59  *p = '\0';
60 }
void report_invalid_encoding(int encoding, const char *mbstr, int len)
Definition: mbutils.c:1575
#define IS_HIGHBIT_SET(ch)
Definition: c.h:1152
#define HIGHBIT
Definition: c.h:1151
void report_untranslatable_char(int src_encoding, int dest_encoding, const char *mbstr, int len)
Definition: mbutils.c:1607

◆ LocalToUtf()

void LocalToUtf ( const unsigned char *  iso,
int  len,
unsigned char *  utf,
const pg_mb_radix_tree map,
const pg_local_to_utf_combined cmap,
int  cmapsize,
utf_local_conversion_func  conv_func,
int  encoding 
)

Definition at line 621 of file conv.c.

References compare4(), elog, ereport, errcode(), errmsg(), ERROR, IS_HIGHBIT_SET, pg_encoding_verifymb(), pg_mb_radix_conv(), PG_UTF8, PG_VALID_ENCODING, report_invalid_encoding(), report_untranslatable_char(), store_coded_char(), pg_local_to_utf_combined::utf1, and pg_local_to_utf_combined::utf2.

Referenced by big5_to_utf8(), euc_cn_to_utf8(), euc_jis_2004_to_utf8(), euc_jp_to_utf8(), euc_kr_to_utf8(), euc_tw_to_utf8(), gb18030_to_utf8(), gbk_to_utf8(), iso8859_to_utf8(), johab_to_utf8(), koi8r_to_utf8(), koi8u_to_utf8(), shift_jis_2004_to_utf8(), sjis_to_utf8(), surrogate_pair_to_codepoint(), uhc_to_utf8(), and win_to_utf8().

627 {
628  uint32 iiso;
629  int l;
630  const pg_local_to_utf_combined *cp;
631 
633  ereport(ERROR,
634  (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
635  errmsg("invalid encoding number: %d", encoding)));
636 
637  for (; len > 0; len -= l)
638  {
639  unsigned char b1 = 0;
640  unsigned char b2 = 0;
641  unsigned char b3 = 0;
642  unsigned char b4 = 0;
643 
644  /* "break" cases all represent errors */
645  if (*iso == '\0')
646  break;
647 
648  if (!IS_HIGHBIT_SET(*iso))
649  {
650  /* ASCII case is easy, assume it's one-to-one conversion */
651  *utf++ = *iso++;
652  l = 1;
653  continue;
654  }
655 
656  l = pg_encoding_verifymb(encoding, (const char *) iso, len);
657  if (l < 0)
658  break;
659 
660  /* collect coded char of length l */
661  if (l == 1)
662  b4 = *iso++;
663  else if (l == 2)
664  {
665  b3 = *iso++;
666  b4 = *iso++;
667  }
668  else if (l == 3)
669  {
670  b2 = *iso++;
671  b3 = *iso++;
672  b4 = *iso++;
673  }
674  else if (l == 4)
675  {
676  b1 = *iso++;
677  b2 = *iso++;
678  b3 = *iso++;
679  b4 = *iso++;
680  }
681  else
682  {
683  elog(ERROR, "unsupported character length %d", l);
684  iiso = 0; /* keep compiler quiet */
685  }
686  iiso = (b1 << 24 | b2 << 16 | b3 << 8 | b4);
687 
688  if (map)
689  {
690  uint32 converted = pg_mb_radix_conv(map, l, b1, b2, b3, b4);
691 
692  if (converted)
693  {
694  utf = store_coded_char(utf, converted);
695  continue;
696  }
697 
698  /* If there's a combined character map, try that */
699  if (cmap)
700  {
701  cp = bsearch(&iiso, cmap, cmapsize,
703 
704  if (cp)
705  {
706  utf = store_coded_char(utf, cp->utf1);
707  utf = store_coded_char(utf, cp->utf2);
708  continue;
709  }
710  }
711  }
712 
713  /* if there's a conversion function, try that */
714  if (conv_func)
715  {
716  uint32 converted = (*conv_func) (iiso);
717 
718  if (converted)
719  {
720  utf = store_coded_char(utf, converted);
721  continue;
722  }
723  }
724 
725  /* failed to translate this character */
727  (const char *) (iso - l), len);
728  }
729 
730  /* if we broke out of loop early, must be invalid input */
731  if (len > 0)
732  report_invalid_encoding(encoding, (const char *) iso, len);
733 
734  *utf = '\0';
735 }
static int compare4(const void *p1, const void *p2)
Definition: conv.c:264
void report_invalid_encoding(int encoding, const char *mbstr, int len)
Definition: mbutils.c:1575
int errcode(int sqlerrcode)
Definition: elog.c:691
static unsigned char * store_coded_char(unsigned char *dest, uint32 code)
Definition: conv.c:278
int pg_encoding_verifymb(int encoding, const char *mbstr, int len)
Definition: wchar.c:1578
#define IS_HIGHBIT_SET(ch)
Definition: c.h:1152
#define ERROR
Definition: elog.h:43
#define PG_VALID_ENCODING(_enc)
Definition: pg_wchar.h:301
static uint32 pg_mb_radix_conv(const pg_mb_radix_tree *rt, int l, unsigned char b1, unsigned char b2, unsigned char b3, unsigned char b4)
Definition: conv.c:298
unsigned int uint32
Definition: c.h:429
#define ereport(elevel,...)
Definition: elog.h:155
int32 encoding
Definition: pg_database.h:41
void report_untranslatable_char(int src_encoding, int dest_encoding, const char *mbstr, int len)
Definition: mbutils.c:1607
int errmsg(const char *fmt,...)
Definition: elog.c:902
#define elog(elevel,...)
Definition: elog.h:228

◆ mic2latin()

void mic2latin ( const unsigned char *  mic,
unsigned char *  p,
int  len,
int  lc,
int  encoding 
)

Definition at line 99 of file conv.c.

References IS_HIGHBIT_SET, PG_MULE_INTERNAL, pg_mule_mblen(), report_invalid_encoding(), and report_untranslatable_char().

Referenced by mic_to_koi8r(), mic_to_latin1(), mic_to_latin2(), mic_to_latin3(), mic_to_latin4(), and surrogate_pair_to_codepoint().

101 {
102  int c1;
103 
104  while (len > 0)
105  {
106  c1 = *mic;
107  if (c1 == 0)
108  report_invalid_encoding(PG_MULE_INTERNAL, (const char *) mic, len);
109  if (!IS_HIGHBIT_SET(c1))
110  {
111  /* easy for ASCII */
112  *p++ = c1;
113  mic++;
114  len--;
115  }
116  else
117  {
118  int l = pg_mule_mblen(mic);
119 
120  if (len < l)
121  report_invalid_encoding(PG_MULE_INTERNAL, (const char *) mic,
122  len);
123  if (l != 2 || c1 != lc || !IS_HIGHBIT_SET(mic[1]))
125  (const char *) mic, len);
126  *p++ = mic[1];
127  mic += 2;
128  len -= 2;
129  }
130  }
131  *p = '\0';
132 }
int pg_mule_mblen(const unsigned char *s)
Definition: wchar.c:839
void report_invalid_encoding(int encoding, const char *mbstr, int len)
Definition: mbutils.c:1575
#define IS_HIGHBIT_SET(ch)
Definition: c.h:1152
int32 encoding
Definition: pg_database.h:41
void report_untranslatable_char(int src_encoding, int dest_encoding, const char *mbstr, int len)
Definition: mbutils.c:1607

◆ mic2latin_with_table()

void mic2latin_with_table ( const unsigned char *  mic,
unsigned char *  p,
int  len,
int  lc,
int  encoding,
const unsigned char *  tab 
)

Definition at line 196 of file conv.c.

References HIGHBIT, IS_HIGHBIT_SET, PG_MULE_INTERNAL, pg_mule_mblen(), report_invalid_encoding(), and report_untranslatable_char().

Referenced by mic_to_iso(), mic_to_win1250(), mic_to_win1251(), mic_to_win866(), and surrogate_pair_to_codepoint().

202 {
203  unsigned char c1,
204  c2;
205 
206  while (len > 0)
207  {
208  c1 = *mic;
209  if (c1 == 0)
210  report_invalid_encoding(PG_MULE_INTERNAL, (const char *) mic, len);
211  if (!IS_HIGHBIT_SET(c1))
212  {
213  /* easy for ASCII */
214  *p++ = c1;
215  mic++;
216  len--;
217  }
218  else
219  {
220  int l = pg_mule_mblen(mic);
221 
222  if (len < l)
223  report_invalid_encoding(PG_MULE_INTERNAL, (const char *) mic,
224  len);
225  if (l != 2 || c1 != lc || !IS_HIGHBIT_SET(mic[1]) ||
226  (c2 = tab[mic[1] - HIGHBIT]) == 0)
227  {
229  (const char *) mic, len);
230  break; /* keep compiler quiet */
231  }
232  *p++ = c2;
233  mic += 2;
234  len -= 2;
235  }
236  }
237  *p = '\0';
238 }
int pg_mule_mblen(const unsigned char *s)
Definition: wchar.c:839
void report_invalid_encoding(int encoding, const char *mbstr, int len)
Definition: mbutils.c:1575
#define IS_HIGHBIT_SET(ch)
Definition: c.h:1152
#define HIGHBIT
Definition: c.h:1151
int32 encoding
Definition: pg_database.h:41
void report_untranslatable_char(int src_encoding, int dest_encoding, const char *mbstr, int len)
Definition: mbutils.c:1607

◆ pg_any_to_server()

char* pg_any_to_server ( const char *  s,
int  len,
int  encoding 
)

Definition at line 619 of file mbutils.c.

References pg_enc2name::encoding, ereport, errcode(), errmsg(), ERROR, i, IS_HIGHBIT_SET, name, perform_default_encoding_conversion(), pg_do_encoding_conversion(), pg_enc2name_tbl, PG_SQL_ASCII, PG_VALID_BE_ENCODING, pg_verify_mbstr(), and unconstify.

Referenced by ASN1_STRING_to_text(), cache_single_string(), CopyReadLine(), db_encoding_convert(), dsnowball_lexize(), pg_client_to_server(), pg_stat_statements_internal(), pgp_armor_headers(), PLyUnicode_Bytes(), read_extension_script_file(), surrogate_pair_to_codepoint(), tsearch_readline(), utf_u2e(), X509_NAME_to_cstring(), and xml_recv().

620 {
621  if (len <= 0)
622  return unconstify(char *, s); /* empty string is always valid */
623 
626  {
627  /*
628  * No conversion is needed, but we must still validate the data.
629  */
630  (void) pg_verify_mbstr(DatabaseEncoding->encoding, s, len, false);
631  return unconstify(char *, s);
632  }
633 
635  {
636  /*
637  * No conversion is possible, but we must still validate the data,
638  * because the client-side code might have done string escaping using
639  * the selected client_encoding. If the client encoding is ASCII-safe
640  * then we just do a straight validation under that encoding. For an
641  * ASCII-unsafe encoding we have a problem: we dare not pass such data
642  * to the parser but we have no way to convert it. We compromise by
643  * rejecting the data if it contains any non-ASCII characters.
644  */
646  (void) pg_verify_mbstr(encoding, s, len, false);
647  else
648  {
649  int i;
650 
651  for (i = 0; i < len; i++)
652  {
653  if (s[i] == '\0' || IS_HIGHBIT_SET(s[i]))
654  ereport(ERROR,
655  (errcode(ERRCODE_CHARACTER_NOT_IN_REPERTOIRE),
656  errmsg("invalid byte value for encoding \"%s\": 0x%02x",
658  (unsigned char) s[i])));
659  }
660  }
661  return unconstify(char *, s);
662  }
663 
664  /* Fast path if we can use cached conversion function */
666  return perform_default_encoding_conversion(s, len, true);
667 
668  /* General case ... will not work outside transactions */
669  return (char *) pg_do_encoding_conversion((unsigned char *) unconstify(char *, s),
670  len,
671  encoding,
673 }
static char * perform_default_encoding_conversion(const char *src, int len, bool is_client_to_server)
Definition: mbutils.c:726
int errcode(int sqlerrcode)
Definition: elog.c:691
static const pg_enc2name * ClientEncoding
Definition: mbutils.c:80
unsigned char * pg_do_encoding_conversion(unsigned char *src, int len, int src_encoding, int dest_encoding)
Definition: mbutils.c:356
bool pg_verify_mbstr(int encoding, const char *mbstr, int len, bool noError)
Definition: mbutils.c:1457
#define IS_HIGHBIT_SET(ch)
Definition: c.h:1152
#define ERROR
Definition: elog.h:43
const pg_enc2name pg_enc2name_tbl[]
Definition: encnames.c:309
#define unconstify(underlying_type, expr)
Definition: c.h:1239
pg_enc encoding
Definition: pg_wchar.h:338
#define ereport(elevel,...)
Definition: elog.h:155
#define PG_VALID_BE_ENCODING(_enc)
Definition: pg_wchar.h:295
int32 encoding
Definition: pg_database.h:41
const char * name
Definition: encode.c:561
int errmsg(const char *fmt,...)
Definition: elog.c:902
static const pg_enc2name * DatabaseEncoding
Definition: mbutils.c:81
int i

◆ pg_char_and_wchar_strcmp()

int pg_char_and_wchar_strcmp ( const char *  s1,
const pg_wchar s2 
)

Definition at line 41 of file wstrcmp.c.

Referenced by surrogate_pair_to_codepoint().

42 {
43  while ((pg_wchar) *s1 == *s2++)
44  if (*s1++ == 0)
45  return 0;
46  return *(const unsigned char *) s1 - *(const pg_wchar *) (s2 - 1);
47 }
char * s1
unsigned int pg_wchar
Definition: mbprint.c:31
char * s2

◆ pg_char_and_wchar_strncmp()

int pg_char_and_wchar_strncmp ( const char *  s1,
const pg_wchar s2,
size_t  n 
)

Definition at line 55 of file wstrncmp.c.

Referenced by cclass(), element(), and surrogate_pair_to_codepoint().

56 {
57  if (n == 0)
58  return 0;
59  do
60  {
61  if ((pg_wchar) ((unsigned char) *s1) != *s2++)
62  return ((pg_wchar) ((unsigned char) *s1) - *(s2 - 1));
63  if (*s1++ == 0)
64  break;
65  } while (--n != 0);
66  return 0;
67 }
char * s1
unsigned int pg_wchar
Definition: mbprint.c:31
char * s2

◆ pg_char_to_encoding()

int pg_char_to_encoding ( const char *  name)

Definition at line 550 of file encnames.c.

Referenced by surrogate_pair_to_codepoint().

551 {
552  unsigned int nel = lengthof(pg_encname_tbl);
553  const pg_encname *base = pg_encname_tbl,
554  *last = base + nel - 1,
555  *position;
556  int result;
557  char buff[NAMEDATALEN],
558  *key;
559 
560  if (name == NULL || *name == '\0')
561  return -1;
562 
563  if (strlen(name) >= NAMEDATALEN)
564  return -1; /* it's certainly not in the table */
565 
566  key = clean_encoding_name(name, buff);
567 
568  while (last >= base)
569  {
570  position = base + ((last - base) >> 1);
571  result = key[0] - position->name[0];
572 
573  if (result == 0)
574  {
575  result = strcmp(key, position->name);
576  if (result == 0)
577  return position->encoding;
578  }
579  if (result < 0)
580  last = position - 1;
581  else
582  base = position + 1;
583  }
584  return -1;
585 }
#define lengthof(array)
Definition: c.h:730
#define NAMEDATALEN
static const pg_encname pg_encname_tbl[]
Definition: encnames.c:39
const char * name
Definition: encode.c:561
static char * clean_encoding_name(const char *key, char *newkey)
Definition: encnames.c:525

◆ pg_client_to_server()

char* pg_client_to_server ( const char *  s,
int  len 
)

Definition at line 603 of file mbutils.c.

References pg_enc2name::encoding, and pg_any_to_server().

Referenced by exec_bind_message(), parse_fcall_arguments(), pq_getmsgstring(), pq_getmsgtext(), and surrogate_pair_to_codepoint().

604 {
605  return pg_any_to_server(s, len, ClientEncoding->encoding);
606 }
static const pg_enc2name * ClientEncoding
Definition: mbutils.c:80
pg_enc encoding
Definition: pg_wchar.h:338
char * pg_any_to_server(const char *s, int len, int encoding)
Definition: mbutils.c:619

◆ pg_database_encoding_character_incrementer()

mbcharacter_incrementer pg_database_encoding_character_incrementer ( void  )

Definition at line 1413 of file mbutils.c.

References GetDatabaseEncoding(), PG_EUC_JP, pg_eucjp_increment(), pg_generic_charinc(), PG_UTF8, and pg_utf8_increment().

Referenced by make_greater_string(), and surrogate_pair_to_codepoint().

1414 {
1415  /*
1416  * Eventually it might be best to add a field to pg_wchar_table[], but for
1417  * now we just use a switch.
1418  */
1419  switch (GetDatabaseEncoding())
1420  {
1421  case PG_UTF8:
1422  return pg_utf8_increment;
1423 
1424  case PG_EUC_JP:
1425  return pg_eucjp_increment;
1426 
1427  default:
1428  return pg_generic_charinc;
1429  }
1430 }
static bool pg_eucjp_increment(unsigned char *charptr, int length)
Definition: mbutils.c:1327
static bool pg_utf8_increment(unsigned char *charptr, int length)
Definition: mbutils.c:1249
static bool pg_generic_charinc(unsigned char *charptr, int len)
Definition: mbutils.c:1215
int GetDatabaseEncoding(void)
Definition: mbutils.c:1151

◆ pg_database_encoding_max_length()

◆ pg_do_encoding_conversion()

unsigned char* pg_do_encoding_conversion ( unsigned char *  src,
int  len,
int  src_encoding,
int  dest_encoding 
)

Definition at line 356 of file mbutils.c.

References CStringGetDatum, CurrentMemoryContext, elog, ereport, errcode(), errdetail(), errmsg(), ERROR, FindDefaultConversionProc(), Int32GetDatum, IsTransactionState(), MAX_CONVERSION_GROWTH, MaxAllocHugeSize, MaxAllocSize, MemoryContextAllocHuge(), OidFunctionCall5, OidIsValid, pg_encoding_to_char(), PG_SQL_ASCII, pg_verify_mbstr(), and repalloc().

Referenced by convert_charset(), pg_any_to_server(), pg_convert(), pg_server_to_any(), report_untranslatable_char(), surrogate_pair_to_codepoint(), and xml_is_document().

358 {
359  unsigned char *result;
360  Oid proc;
361 
362  if (len <= 0)
363  return src; /* empty string is always valid */
364 
365  if (src_encoding == dest_encoding)
366  return src; /* no conversion required, assume valid */
367 
368  if (dest_encoding == PG_SQL_ASCII)
369  return src; /* any string is valid in SQL_ASCII */
370 
371  if (src_encoding == PG_SQL_ASCII)
372  {
373  /* No conversion is possible, but we must validate the result */
374  (void) pg_verify_mbstr(dest_encoding, (const char *) src, len, false);
375  return src;
376  }
377 
378  if (!IsTransactionState()) /* shouldn't happen */
379  elog(ERROR, "cannot perform encoding conversion outside a transaction");
380 
381  proc = FindDefaultConversionProc(src_encoding, dest_encoding);
382  if (!OidIsValid(proc))
383  ereport(ERROR,
384  (errcode(ERRCODE_UNDEFINED_FUNCTION),
385  errmsg("default conversion function for encoding \"%s\" to \"%s\" does not exist",
386  pg_encoding_to_char(src_encoding),
387  pg_encoding_to_char(dest_encoding))));
388 
389  /*
390  * Allocate space for conversion result, being wary of integer overflow.
391  *
392  * len * MAX_CONVERSION_GROWTH is typically a vast overestimate of the
393  * required space, so it might exceed MaxAllocSize even though the result
394  * would actually fit. We do not want to hand back a result string that
395  * exceeds MaxAllocSize, because callers might not cope gracefully --- but
396  * if we just allocate more than that, and don't use it, that's fine.
397  */
398  if ((Size) len >= (MaxAllocHugeSize / (Size) MAX_CONVERSION_GROWTH))
399  ereport(ERROR,
400  (errcode(ERRCODE_PROGRAM_LIMIT_EXCEEDED),
401  errmsg("out of memory"),
402  errdetail("String of %d bytes is too long for encoding conversion.",
403  len)));
404 
405  result = (unsigned char *)
407  (Size) len * MAX_CONVERSION_GROWTH + 1);
408 
409  OidFunctionCall5(proc,
410  Int32GetDatum(src_encoding),
411  Int32GetDatum(dest_encoding),
412  CStringGetDatum(src),
413  CStringGetDatum(result),
414  Int32GetDatum(len));
415 
416  /*
417  * If the result is large, it's worth repalloc'ing to release any extra
418  * space we asked for. The cutoff here is somewhat arbitrary, but we
419  * *must* check when len * MAX_CONVERSION_GROWTH exceeds MaxAllocSize.
420  */
421  if (len > 1000000)
422  {
423  Size resultlen = strlen((char *) result);
424 
425  if (resultlen >= MaxAllocSize)
426  ereport(ERROR,
427  (errcode(ERRCODE_PROGRAM_LIMIT_EXCEEDED),
428  errmsg("out of memory"),
429  errdetail("String of %d bytes is too long for encoding conversion.",
430  len)));
431 
432  result = (unsigned char *) repalloc(result, resultlen + 1);
433  }
434 
435  return result;
436 }
int errcode(int sqlerrcode)
Definition: elog.c:691
unsigned int Oid
Definition: postgres_ext.h:31
#define OidIsValid(objectId)
Definition: c.h:706
#define MaxAllocHugeSize
Definition: memutils.h:44
bool pg_verify_mbstr(int encoding, const char *mbstr, int len, bool noError)
Definition: mbutils.c:1457
#define ERROR
Definition: elog.h:43
void * MemoryContextAllocHuge(MemoryContext context, Size size)
Definition: mcxt.c:1106
int errdetail(const char *fmt,...)
Definition: elog.c:1035
#define CStringGetDatum(X)
Definition: postgres.h:578
MemoryContext CurrentMemoryContext
Definition: mcxt.c:38
#define MaxAllocSize
Definition: memutils.h:40
#define ereport(elevel,...)
Definition: elog.h:155
const char * pg_encoding_to_char(int encoding)
Definition: encnames.c:588
size_t Size
Definition: c.h:528
Oid FindDefaultConversionProc(int32 for_encoding, int32 to_encoding)
Definition: namespace.c:3709
bool IsTransactionState(void)
Definition: xact.c:371
void * repalloc(void *pointer, Size size)
Definition: mcxt.c:1070
#define MAX_CONVERSION_GROWTH
Definition: pg_wchar.h:316
#define Int32GetDatum(X)
Definition: postgres.h:479
int errmsg(const char *fmt,...)
Definition: elog.c:902
#define elog(elevel,...)
Definition: elog.h:228
#define OidFunctionCall5(functionId, arg1, arg2, arg3, arg4, arg5)
Definition: fmgr.h:672

◆ pg_dsplen()

int pg_dsplen ( const char *  mbstr)

Definition at line 914 of file mbutils.c.

References pg_wchar_tbl::dsplen, pg_enc2name::encoding, and pg_wchar_table.

Referenced by p_isspecial(), and surrogate_pair_to_codepoint().

915 {
916  return pg_wchar_table[DatabaseEncoding->encoding].dsplen((const unsigned char *) mbstr);
917 }
mbdisplaylen_converter dsplen
Definition: pg_wchar.h:383
pg_enc encoding
Definition: pg_wchar.h:338
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505
static const pg_enc2name * DatabaseEncoding
Definition: mbutils.c:81

◆ pg_encoding_dsplen()

int pg_encoding_dsplen ( int  encoding,
const char *  mbstr 
)

Definition at line 1565 of file wchar.c.

References PG_SQL_ASCII, and PG_VALID_ENCODING.

Referenced by PQdsplen(), reportErrorPosition(), and surrogate_pair_to_codepoint().

1566 {
1567  return (PG_VALID_ENCODING(encoding) ?
1568  pg_wchar_table[encoding].dsplen((const unsigned char *) mbstr) :
1569  pg_wchar_table[PG_SQL_ASCII].dsplen((const unsigned char *) mbstr));
1570 }
#define PG_VALID_ENCODING(_enc)
Definition: pg_wchar.h:301
int32 encoding
Definition: pg_database.h:41
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505

◆ pg_encoding_max_length()

int pg_encoding_max_length ( int  encoding)

Definition at line 1589 of file wchar.c.

References Assert, encoding, pg_wchar_tbl::maxmblen, and PG_VALID_ENCODING.

Referenced by ascii(), chr(), pg_encoding_mbcliplen(), pg_verify_mbstr_len(), reportErrorPosition(), surrogate_pair_to_codepoint(), and type_maximum_size().

1590 {
1592 
1594 }
int maxmblen
Definition: pg_wchar.h:385
#define PG_VALID_ENCODING(_enc)
Definition: pg_wchar.h:301
#define Assert(condition)
Definition: c.h:800
int32 encoding
Definition: pg_database.h:41
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505

◆ pg_encoding_mb2wchar_with_len()

int pg_encoding_mb2wchar_with_len ( int  encoding,
const char *  from,
pg_wchar to,
int  len 
)

Definition at line 877 of file mbutils.c.

References encoding, pg_wchar_tbl::mb2wchar_with_len, and pg_wchar_table.

Referenced by surrogate_pair_to_codepoint(), and xml_is_document().

879 {
880  return pg_wchar_table[encoding].mb2wchar_with_len((const unsigned char *) from, to, len);
881 }
int32 encoding
Definition: pg_database.h:41
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505
mb2wchar_with_len_converter mb2wchar_with_len
Definition: pg_wchar.h:378

◆ pg_encoding_mbcliplen()

int pg_encoding_mbcliplen ( int  encoding,
const char *  mbstr,
int  len,
int  limit 
)

Definition at line 977 of file mbutils.c.

References cliplen(), encoding, pg_wchar_tbl::mblen, pg_encoding_max_length(), and pg_wchar_table.

Referenced by pg_mbcliplen(), and surrogate_pair_to_codepoint().

979 {
980  mblen_converter mblen_fn;
981  int clen = 0;
982  int l;
983 
984  /* optimization for single byte encoding */
986  return cliplen(mbstr, len, limit);
987 
988  mblen_fn = pg_wchar_table[encoding].mblen;
989 
990  while (len > 0 && *mbstr)
991  {
992  l = (*mblen_fn) ((const unsigned char *) mbstr);
993  if ((clen + l) > limit)
994  break;
995  clen += l;
996  if (clen == limit)
997  break;
998  len -= l;
999  mbstr += l;
1000  }
1001  return clen;
1002 }
int(* mblen_converter)(const unsigned char *mbstr)
Definition: pg_wchar.h:368
int pg_encoding_max_length(int encoding)
Definition: wchar.c:1589
static int cliplen(const char *str, int len, int limit)
Definition: mbutils.c:1034
int32 encoding
Definition: pg_database.h:41
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505
mblen_converter mblen
Definition: pg_wchar.h:382

◆ pg_encoding_mblen()

int pg_encoding_mblen ( int  encoding,
const char *  mbstr 
)

Definition at line 1554 of file wchar.c.

References PG_SQL_ASCII, and PG_VALID_ENCODING.

Referenced by CopyAttributeOutCSV(), CopyAttributeOutText(), CopyReadLineText(), json_lex_string(), PQescapeInternal(), PQescapeStringInternal(), PQmblen(), report_invalid_encoding(), report_untranslatable_char(), reportErrorPosition(), surrogate_pair_to_codepoint(), and xml_is_document().

1555 {
1556  return (PG_VALID_ENCODING(encoding) ?
1557  pg_wchar_table[encoding].mblen((const unsigned char *) mbstr) :
1558  pg_wchar_table[PG_SQL_ASCII].mblen((const unsigned char *) mbstr));
1559 }
#define PG_VALID_ENCODING(_enc)
Definition: pg_wchar.h:301
int32 encoding
Definition: pg_database.h:41
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505

◆ pg_encoding_to_char()

const char* pg_encoding_to_char ( int  encoding)

Definition at line 588 of file encnames.c.

Referenced by surrogate_pair_to_codepoint().

589 {
591  {
592  const pg_enc2name *p = &pg_enc2name_tbl[encoding];
593 
594  Assert(encoding == p->encoding);
595  return p->name;
596  }
597  return "";
598 }
#define PG_VALID_ENCODING(_enc)
Definition: pg_wchar.h:301
const pg_enc2name pg_enc2name_tbl[]
Definition: encnames.c:309
const char * name
Definition: pg_wchar.h:337
pg_enc encoding
Definition: pg_wchar.h:338
#define Assert(condition)
Definition: c.h:800
int32 encoding
Definition: pg_database.h:41

◆ pg_encoding_verifymb()

int pg_encoding_verifymb ( int  encoding,
const char *  mbstr,
int  len 
)

Definition at line 1578 of file wchar.c.

References PG_SQL_ASCII, and PG_VALID_ENCODING.

Referenced by big52mic(), euc_jis_20042shift_jis_2004(), euc_jp2mic(), euc_jp2sjis(), euc_kr2mic(), euc_tw2mic(), LocalToUtf(), mic2big5(), mic2euc_jp(), mic2euc_kr(), mic2euc_tw(), mic2sjis(), shift_jis_20042euc_jis_2004(), sjis2euc_jp(), and surrogate_pair_to_codepoint().

1579 {
1580  return (PG_VALID_ENCODING(encoding) ?
1581  pg_wchar_table[encoding].mbverify((const unsigned char *) mbstr, len) :
1582  pg_wchar_table[PG_SQL_ASCII].mbverify((const unsigned char *) mbstr, len));
1583 }
#define PG_VALID_ENCODING(_enc)
Definition: pg_wchar.h:301
int32 encoding
Definition: pg_database.h:41
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505

◆ pg_encoding_wchar2mb_with_len()

int pg_encoding_wchar2mb_with_len ( int  encoding,
const pg_wchar from,
char *  to,
int  len 
)

Definition at line 899 of file mbutils.c.

References encoding, pg_wchar_table, and pg_wchar_tbl::wchar2mb_with_len.

Referenced by surrogate_pair_to_codepoint().

901 {
902  return pg_wchar_table[encoding].wchar2mb_with_len(from, (unsigned char *) to, len);
903 }
wchar2mb_with_len_converter wchar2mb_with_len
Definition: pg_wchar.h:380
int32 encoding
Definition: pg_database.h:41
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505

◆ pg_get_client_encoding()

int pg_get_client_encoding ( void  )

Definition at line 336 of file mbutils.c.

References pg_enc2name::encoding.

Referenced by BeginCopyFrom(), BeginCopyTo(), surrogate_pair_to_codepoint(), and xml_send().

337 {
338  return ClientEncoding->encoding;
339 }
static const pg_enc2name * ClientEncoding
Definition: mbutils.c:80
pg_enc encoding
Definition: pg_wchar.h:338

◆ pg_get_client_encoding_name()

const char* pg_get_client_encoding_name ( void  )

Definition at line 345 of file mbutils.c.

References pg_enc2name::name.

Referenced by surrogate_pair_to_codepoint().

346 {
347  return ClientEncoding->name;
348 }
static const pg_enc2name * ClientEncoding
Definition: mbutils.c:80
const char * name
Definition: pg_wchar.h:337

◆ pg_mb2wchar()

int pg_mb2wchar ( const char *  from,
pg_wchar to 
)

Definition at line 863 of file mbutils.c.

References pg_enc2name::encoding, pg_wchar_tbl::mb2wchar_with_len, and pg_wchar_table.

Referenced by surrogate_pair_to_codepoint().

864 {
865  return pg_wchar_table[DatabaseEncoding->encoding].mb2wchar_with_len((const unsigned char *) from, to, strlen(from));
866 }
pg_enc encoding
Definition: pg_wchar.h:338
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505
static const pg_enc2name * DatabaseEncoding
Definition: mbutils.c:81
mb2wchar_with_len_converter mb2wchar_with_len
Definition: pg_wchar.h:378

◆ pg_mb2wchar_with_len()

int pg_mb2wchar_with_len ( const char *  from,
pg_wchar to,
int  len 
)

Definition at line 870 of file mbutils.c.

References pg_enc2name::encoding, pg_wchar_tbl::mb2wchar_with_len, and pg_wchar_table.

Referenced by check_ident_usermap(), CheckAffix(), NIAddAffix(), parse_ident_line(), RE_compile(), RE_compile_and_cache(), RE_execute(), replace_text_regexp(), setup_regexp_matches(), surrogate_pair_to_codepoint(), and TParserInit().

871 {
872  return pg_wchar_table[DatabaseEncoding->encoding].mb2wchar_with_len((const unsigned char *) from, to, len);
873 }
pg_enc encoding
Definition: pg_wchar.h:338
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505
static const pg_enc2name * DatabaseEncoding
Definition: mbutils.c:81
mb2wchar_with_len_converter mb2wchar_with_len
Definition: pg_wchar.h:378

◆ pg_mbcharcliplen()

int pg_mbcharcliplen ( const char *  mbstr,
int  len,
int  limit 
)

Definition at line 1009 of file mbutils.c.

References cliplen(), pg_database_encoding_max_length(), and pg_mblen().

Referenced by bpchar(), bpchar_input(), surrogate_pair_to_codepoint(), text_left(), text_right(), varchar(), and varchar_input().

1010 {
1011  int clen = 0;
1012  int nch = 0;
1013  int l;
1014 
1015  /* optimization for single byte encoding */
1017  return cliplen(mbstr, len, limit);
1018 
1019  while (len > 0 && *mbstr)
1020  {
1021  l = pg_mblen(mbstr);
1022  nch++;
1023  if (nch > limit)
1024  break;
1025  clen += l;
1026  len -= l;
1027  mbstr += l;
1028  }
1029  return clen;
1030 }
static int cliplen(const char *str, int len, int limit)
Definition: mbutils.c:1034
int pg_mblen(const char *mbstr)
Definition: mbutils.c:907
int pg_database_encoding_max_length(void)
Definition: mbutils.c:1436

◆ pg_mbcliplen()

◆ pg_mblen()

int pg_mblen ( const char *  mbstr)

Definition at line 907 of file mbutils.c.

References pg_enc2name::encoding, pg_wchar_tbl::mblen, and pg_wchar_table.

Referenced by addCompoundAffixFlagValue(), appendStringInfoRegexpSubstr(), bit_in(), charlen_to_bytelen(), check_replace_text_has_escape_char(), DCH_from_char(), dotrim(), find_word(), findchar(), findchar2(), findwrd(), gbt_var_node_cp_len(), get_hex(), get_modifiers(), get_nextfield(), get_val(), get_wildcard_part(), getlexeme(), getNextFlagFromString(), gettoken_query(), gettoken_query_standard(), gettoken_query_websearch(), gettoken_tsvector(), infix(), initTrie(), lpad(), make_trigrams(), map_sql_identifier_to_xml_name(), map_xml_name_to_sql_identifier(), match_prosrc_to_literal(), mb_strchr(), NIImportAffixes(), NIImportDictionary(), NIImportOOAffixes(), NUM_eat_non_data_chars(), NUM_processor(), parse_affentry(), parse_format(), parse_hstore(), parse_lquery(), parse_ltree(), parse_or_operator(), parse_re_flags(), pg_base64_decode(), pg_mbcharcliplen(), pg_mbstrlen(), pg_mbstrlen_with_len(), readstoplist(), report_json_context(), rpad(), RS_compile(), RS_execute(), RS_isRegis(), similar_escape_internal(), split_text(), surrogate_pair_to_codepoint(), t_isalpha(), t_isdigit(), t_isprint(), t_isspace(), text_format(), text_position_get_match_pos(), text_position_next(), text_reverse(), text_substring(), text_to_bits(), thesaurusRead(), TParserGet(), translate(), ts_stat_sql(), tsvectorout(), unaccent_lexize(), varbit_in(), varstr_levenshtein(), wchareq(), and xml_is_document().

908 {
909  return pg_wchar_table[DatabaseEncoding->encoding].mblen((const unsigned char *) mbstr);
910 }
pg_enc encoding
Definition: pg_wchar.h:338
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505
static const pg_enc2name * DatabaseEncoding
Definition: mbutils.c:81
mblen_converter mblen
Definition: pg_wchar.h:382

◆ pg_mbstrlen()

int pg_mbstrlen ( const char *  mbstr)

Definition at line 921 of file mbutils.c.

References pg_database_encoding_max_length(), and pg_mblen().

Referenced by cache_locale_time(), NUM_processor(), surrogate_pair_to_codepoint(), and text_format_append_string().

922 {
923  int len = 0;
924 
925  /* optimization for single byte encoding */
927  return strlen(mbstr);
928 
929  while (*mbstr)
930  {
931  mbstr += pg_mblen(mbstr);
932  len++;
933  }
934  return len;
935 }
int pg_mblen(const char *mbstr)
Definition: mbutils.c:907
int pg_database_encoding_max_length(void)
Definition: mbutils.c:1436

◆ pg_mbstrlen_with_len()

int pg_mbstrlen_with_len ( const char *  mbstr,
int  len 
)

Definition at line 941 of file mbutils.c.

References pg_database_encoding_max_length(), and pg_mblen().

Referenced by bpchar(), bpchar_input(), bpcharlen(), executor_errposition(), lpad(), match_prosrc_to_query(), parser_errposition(), plpgsql_scanner_errposition(), rpad(), similar_escape_internal(), surrogate_pair_to_codepoint(), text_left(), text_length(), text_right(), text_substring(), unicode_is_normalized(), unicode_normalize_func(), and varstr_levenshtein().

942 {
943  int len = 0;
944 
945  /* optimization for single byte encoding */
947  return limit;
948 
949  while (limit > 0 && *mbstr)
950  {
951  int l = pg_mblen(mbstr);
952 
953  limit -= l;
954  mbstr += l;
955  len++;
956  }
957  return len;
958 }
int pg_mblen(const char *mbstr)
Definition: mbutils.c:907
int pg_database_encoding_max_length(void)
Definition: mbutils.c:1436

◆ pg_mule_mblen()

int pg_mule_mblen ( const unsigned char *  s)

Definition at line 839 of file wchar.c.

References IS_LC1, IS_LC2, IS_LCPRV1, and IS_LCPRV2.

Referenced by mic2latin(), mic2latin_with_table(), pg_mule_verifier(), and surrogate_pair_to_codepoint().

840 {
841  int len;
842 
843  if (IS_LC1(*s))
844  len = 2;
845  else if (IS_LCPRV1(*s))
846  len = 3;
847  else if (IS_LC2(*s))
848  len = 3;
849  else if (IS_LCPRV2(*s))
850  len = 4;
851  else
852  len = 1; /* assume ASCII */
853  return len;
854 }
#define IS_LC2(c)
Definition: pg_wchar.h:144
#define IS_LCPRV2(c)
Definition: pg_wchar.h:164
#define IS_LCPRV1(c)
Definition: pg_wchar.h:152
#define IS_LC1(c)
Definition: pg_wchar.h:123

◆ pg_server_to_any()

char* pg_server_to_any ( const char *  s,
int  len,
int  encoding 
)

Definition at line 692 of file mbutils.c.

References pg_enc2name::encoding, perform_default_encoding_conversion(), pg_do_encoding_conversion(), PG_SQL_ASCII, pg_verify_mbstr(), and unconstify.

Referenced by compareStrings(), CopyAttributeOutCSV(), CopyAttributeOutText(), CopyTo(), dsnowball_lexize(), hv_fetch_string(), hv_store_string(), pg_server_to_client(), PLyUnicode_AsString(), surrogate_pair_to_codepoint(), utf_e2u(), and xml_is_document().

693 {
694  if (len <= 0)
695  return unconstify(char *, s); /* empty string is always valid */
696 
699  return unconstify(char *, s); /* assume data is valid */
700 
702  {
703  /* No conversion is possible, but we must validate the result */
704  (void) pg_verify_mbstr(encoding, s, len, false);
705  return unconstify(char *, s);
706  }
707 
708  /* Fast path if we can use cached conversion function */
710  return perform_default_encoding_conversion(s, len, false);
711 
712  /* General case ... will not work outside transactions */
713  return (char *) pg_do_encoding_conversion((unsigned char *) unconstify(char *, s),
714  len,
716  encoding);
717 }
static char * perform_default_encoding_conversion(const char *src, int len, bool is_client_to_server)
Definition: mbutils.c:726
static const pg_enc2name * ClientEncoding
Definition: mbutils.c:80
unsigned char * pg_do_encoding_conversion(unsigned char *src, int len, int src_encoding, int dest_encoding)
Definition: mbutils.c:356
bool pg_verify_mbstr(int encoding, const char *mbstr, int len, bool noError)
Definition: mbutils.c:1457
#define unconstify(underlying_type, expr)
Definition: c.h:1239
pg_enc encoding
Definition: pg_wchar.h:338
int32 encoding
Definition: pg_database.h:41
static const pg_enc2name * DatabaseEncoding
Definition: mbutils.c:81

◆ pg_server_to_client()

char* pg_server_to_client ( const char *  s,
int  len 
)

Definition at line 681 of file mbutils.c.

References pg_enc2name::encoding, and pg_server_to_any().

Referenced by pq_puttextmessage(), pq_sendcountedtext(), pq_sendstring(), pq_sendtext(), pq_writestring(), and surrogate_pair_to_codepoint().

682 {
683  return pg_server_to_any(s, len, ClientEncoding->encoding);
684 }
static const pg_enc2name * ClientEncoding
Definition: mbutils.c:80
char * pg_server_to_any(const char *s, int len, int encoding)
Definition: mbutils.c:692
pg_enc encoding
Definition: pg_wchar.h:338

◆ pg_unicode_to_server()

void pg_unicode_to_server ( pg_wchar  c,
unsigned char *  s 
)

Definition at line 806 of file mbutils.c.

References CStringGetDatum, ereport, errcode(), errmsg(), ERROR, FunctionCall5, GetDatabaseEncoding(), GetDatabaseEncodingName(), Int32GetDatum, is_valid_unicode_codepoint(), MAX_MULTIBYTE_CHAR_LEN, name, pg_enc2name_tbl, PG_UTF8, pg_utf_mblen(), and unicode_to_utf8().

Referenced by json_lex_string(), map_xml_name_to_sql_identifier(), str_udeescape(), and surrogate_pair_to_codepoint().

807 {
808  unsigned char c_as_utf8[MAX_MULTIBYTE_CHAR_LEN + 1];
809  int c_as_utf8_len;
810  int server_encoding;
811 
812  /*
813  * Complain if invalid Unicode code point. The choice of errcode here is
814  * debatable, but really our caller should have checked this anyway.
815  */
817  ereport(ERROR,
818  (errcode(ERRCODE_SYNTAX_ERROR),
819  errmsg("invalid Unicode code point")));
820 
821  /* Otherwise, if it's in ASCII range, conversion is trivial */
822  if (c <= 0x7F)
823  {
824  s[0] = (unsigned char) c;
825  s[1] = '\0';
826  return;
827  }
828 
829  /* If the server encoding is UTF-8, we just need to reformat the code */
830  server_encoding = GetDatabaseEncoding();
831  if (server_encoding == PG_UTF8)
832  {
833  unicode_to_utf8(c, s);
834  s[pg_utf_mblen(s)] = '\0';
835  return;
836  }
837 
838  /* For all other cases, we must have a conversion function available */
839  if (Utf8ToServerConvProc == NULL)
840  ereport(ERROR,
841  (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
842  errmsg("conversion between %s and %s is not supported",
845 
846  /* Construct UTF-8 source string */
847  unicode_to_utf8(c, c_as_utf8);
848  c_as_utf8_len = pg_utf_mblen(c_as_utf8);
849  c_as_utf8[c_as_utf8_len] = '\0';
850 
851  /* Convert, or throw error if we can't */
854  Int32GetDatum(server_encoding),
855  CStringGetDatum(c_as_utf8),
856  CStringGetDatum(s),
857  Int32GetDatum(c_as_utf8_len));
858 }
static FmgrInfo * Utf8ToServerConvProc
Definition: mbutils.c:75
unsigned char * unicode_to_utf8(pg_wchar c, unsigned char *utf8string)
Definition: wchar.c:483
static bool is_valid_unicode_codepoint(pg_wchar c)
Definition: pg_wchar.h:518
int errcode(int sqlerrcode)
Definition: elog.c:691
#define ERROR
Definition: elog.h:43
#define FunctionCall5(flinfo, arg1, arg2, arg3, arg4, arg5)
Definition: fmgr.h:652
char * c
const pg_enc2name pg_enc2name_tbl[]
Definition: encnames.c:309
#define CStringGetDatum(X)
Definition: postgres.h:578
#define MAX_MULTIBYTE_CHAR_LEN
Definition: pg_wchar.h:30
int GetDatabaseEncoding(void)
Definition: mbutils.c:1151
#define ereport(elevel,...)
Definition: elog.h:155
const char * GetDatabaseEncodingName(void)
Definition: mbutils.c:1157
const char * name
Definition: encode.c:561
int pg_utf_mblen(const unsigned char *s)
Definition: wchar.c:549
#define Int32GetDatum(X)
Definition: postgres.h:479
int errmsg(const char *fmt,...)
Definition: elog.c:902

◆ pg_utf8_islegal()

bool pg_utf8_islegal ( const unsigned char *  source,
int  length 
)

Definition at line 1442 of file wchar.c.

References source.

Referenced by chr(), pg_utf8_string_len(), pg_utf8_verifier(), surrogate_pair_to_codepoint(), utf8_to_iso8859_1(), and UtfToLocal().

1443 {
1444  unsigned char a;
1445 
1446  switch (length)
1447  {
1448  default:
1449  /* reject lengths 5 and 6 for now */
1450  return false;
1451  case 4:
1452  a = source[3];
1453  if (a < 0x80 || a > 0xBF)
1454  return false;
1455  /* FALL THRU */
1456  case 3:
1457  a = source[2];
1458  if (a < 0x80 || a > 0xBF)
1459  return false;
1460  /* FALL THRU */
1461  case 2:
1462  a = source[1];
1463  switch (*source)
1464  {
1465  case 0xE0:
1466  if (a < 0xA0 || a > 0xBF)
1467  return false;
1468  break;
1469  case 0xED:
1470  if (a < 0x80 || a > 0x9F)
1471  return false;
1472  break;
1473  case 0xF0:
1474  if (a < 0x90 || a > 0xBF)
1475  return false;
1476  break;
1477  case 0xF4:
1478  if (a < 0x80 || a > 0x8F)
1479  return false;
1480  break;
1481  default:
1482  if (a < 0x80 || a > 0xBF)
1483  return false;
1484  break;
1485  }
1486  /* FALL THRU */
1487  case 1:
1488  a = *source;
1489  if (a >= 0x80 && a < 0xC2)
1490  return false;
1491  if (a > 0xF4)
1492  return false;
1493  break;
1494  }
1495  return true;
1496 }
static rewind_source * source
Definition: pg_rewind.c:79

◆ pg_utf_mblen()

int pg_utf_mblen ( const unsigned char *  s)

Definition at line 549 of file wchar.c.

Referenced by json_lex_string(), pg_saslprep(), pg_unicode_to_server(), pg_utf8_string_len(), pg_utf8_verifier(), pg_wchar2utf_with_len(), surrogate_pair_to_codepoint(), unicode_is_normalized(), unicode_normalize_func(), utf8_to_iso8859_1(), and UtfToLocal().

550 {
551  int len;
552 
553  if ((*s & 0x80) == 0)
554  len = 1;
555  else if ((*s & 0xe0) == 0xc0)
556  len = 2;
557  else if ((*s & 0xf0) == 0xe0)
558  len = 3;
559  else if ((*s & 0xf8) == 0xf0)
560  len = 4;
561 #ifdef NOT_USED
562  else if ((*s & 0xfc) == 0xf8)
563  len = 5;
564  else if ((*s & 0xfe) == 0xfc)
565  len = 6;
566 #endif
567  else
568  len = 1;
569  return len;
570 }

◆ pg_valid_client_encoding()

int pg_valid_client_encoding ( const char *  name)

Definition at line 486 of file encnames.c.

References enc, pg_char_to_encoding(), and PG_VALID_FE_ENCODING.

Referenced by check_client_encoding(), and surrogate_pair_to_codepoint().

487 {
488  int enc;
489 
490  if ((enc = pg_char_to_encoding(name)) < 0)
491  return -1;
492 
493  if (!PG_VALID_FE_ENCODING(enc))
494  return -1;
495 
496  return enc;
497 }
int pg_char_to_encoding(const char *name)
Definition: encnames.c:550
struct pg_encoding enc
Definition: encode.c:562
#define PG_VALID_FE_ENCODING(_enc)
Definition: pg_wchar.h:305
const char * name
Definition: encode.c:561

◆ pg_valid_server_encoding()

int pg_valid_server_encoding ( const char *  name)

Definition at line 500 of file encnames.c.

References enc, pg_char_to_encoding(), and PG_VALID_BE_ENCODING.

Referenced by createdb(), get_encoding_id(), parse_extension_control_file(), and surrogate_pair_to_codepoint().

501 {
502  int enc;
503 
504  if ((enc = pg_char_to_encoding(name)) < 0)
505  return -1;
506 
507  if (!PG_VALID_BE_ENCODING(enc))
508  return -1;
509 
510  return enc;
511 }
int pg_char_to_encoding(const char *name)
Definition: encnames.c:550
struct pg_encoding enc
Definition: encode.c:562
#define PG_VALID_BE_ENCODING(_enc)
Definition: pg_wchar.h:295
const char * name
Definition: encode.c:561

◆ pg_valid_server_encoding_id()

int pg_valid_server_encoding_id ( int  encoding)

Definition at line 514 of file encnames.c.

Referenced by surrogate_pair_to_codepoint().

515 {
517 }
#define PG_VALID_BE_ENCODING(_enc)
Definition: pg_wchar.h:295
int32 encoding
Definition: pg_database.h:41

◆ pg_verify_mbstr()

bool pg_verify_mbstr ( int  encoding,
const char *  mbstr,
int  len,
bool  noError 
)

Definition at line 1457 of file mbutils.c.

References pg_verify_mbstr_len().

Referenced by AddFileToBackupManifest(), LogicalOutputWrite(), pg_any_to_server(), pg_do_encoding_conversion(), pg_server_to_any(), and surrogate_pair_to_codepoint().

1458 {
1459  return pg_verify_mbstr_len(encoding, mbstr, len, noError) >= 0;
1460 }
int32 encoding
Definition: pg_database.h:41
int pg_verify_mbstr_len(int encoding, const char *mbstr, int len, bool noError)
Definition: mbutils.c:1474

◆ pg_verify_mbstr_len()

int pg_verify_mbstr_len ( int  encoding,
const char *  mbstr,
int  len,
bool  noError 
)

Definition at line 1474 of file mbutils.c.

References Assert, encoding, IS_HIGHBIT_SET, pg_wchar_tbl::mbverify, pg_encoding_max_length(), PG_VALID_ENCODING, pg_wchar_table, and report_invalid_encoding().

Referenced by length_in_encoding(), pg_convert(), pg_verify_mbstr(), pg_verifymbstr(), read_extension_script_file(), and surrogate_pair_to_codepoint().

1475 {
1476  mbverifier mbverify;
1477  int mb_len;
1478 
1480 
1481  /*
1482  * In single-byte encodings, we need only reject nulls (\0).
1483  */
1484  if (pg_encoding_max_length(encoding) <= 1)
1485  {
1486  const char *nullpos = memchr(mbstr, 0, len);
1487 
1488  if (nullpos == NULL)
1489  return len;
1490  if (noError)
1491  return -1;
1492  report_invalid_encoding(encoding, nullpos, 1);
1493  }
1494 
1495  /* fetch function pointer just once */
1496  mbverify = pg_wchar_table[encoding].mbverify;
1497 
1498  mb_len = 0;
1499 
1500  while (len > 0)
1501  {
1502  int l;
1503 
1504  /* fast path for ASCII-subset characters */
1505  if (!IS_HIGHBIT_SET(*mbstr))
1506  {
1507  if (*mbstr != '\0')
1508  {
1509  mb_len++;
1510  mbstr++;
1511  len--;
1512  continue;
1513  }
1514  if (noError)
1515  return -1;
1516  report_invalid_encoding(encoding, mbstr, len);
1517  }
1518 
1519  l = (*mbverify) ((const unsigned char *) mbstr, len);
1520 
1521  if (l < 0)
1522  {
1523  if (noError)
1524  return -1;
1525  report_invalid_encoding(encoding, mbstr, len);
1526  }
1527 
1528  mbstr += l;
1529  len -= l;
1530  mb_len++;
1531  }
1532  return mb_len;
1533 }
void report_invalid_encoding(int encoding, const char *mbstr, int len)
Definition: mbutils.c:1575
#define IS_HIGHBIT_SET(ch)
Definition: c.h:1152
int pg_encoding_max_length(int encoding)
Definition: wchar.c:1589
#define PG_VALID_ENCODING(_enc)
Definition: pg_wchar.h:301
int(* mbverifier)(const unsigned char *mbstr, int len)
Definition: pg_wchar.h:374
#define Assert(condition)
Definition: c.h:800
int32 encoding
Definition: pg_database.h:41
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505
mbverifier mbverify
Definition: pg_wchar.h:384

◆ pg_verifymbstr()

bool pg_verifymbstr ( const char *  mbstr,
int  len,
bool  noError 
)

Definition at line 1446 of file mbutils.c.

References GetDatabaseEncoding(), and pg_verify_mbstr_len().

Referenced by char2wchar(), CopyReadAttributesText(), plperl_spi_exec(), plperl_spi_prepare(), plperl_spi_query(), PLy_cursor_query(), PLy_output(), PLy_spi_execute_query(), PLy_spi_prepare(), PLyObject_AsString(), read_text_file(), spg_text_leaf_consistent(), and surrogate_pair_to_codepoint().

1447 {
1448  return
1449  pg_verify_mbstr_len(GetDatabaseEncoding(), mbstr, len, noError) >= 0;
1450 }
int GetDatabaseEncoding(void)
Definition: mbutils.c:1151
int pg_verify_mbstr_len(int encoding, const char *mbstr, int len, bool noError)
Definition: mbutils.c:1474

◆ pg_wchar2mb()

int pg_wchar2mb ( const pg_wchar from,
char *  to 
)

Definition at line 885 of file mbutils.c.

References pg_enc2name::encoding, pg_wchar_strlen(), pg_wchar_table, and pg_wchar_tbl::wchar2mb_with_len.

Referenced by surrogate_pair_to_codepoint().

886 {
887  return pg_wchar_table[DatabaseEncoding->encoding].wchar2mb_with_len(from, (unsigned char *) to, pg_wchar_strlen(from));
888 }
size_t pg_wchar_strlen(const pg_wchar *str)
Definition: wstrncmp.c:70
wchar2mb_with_len_converter wchar2mb_with_len
Definition: pg_wchar.h:380
pg_enc encoding
Definition: pg_wchar.h:338
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505
static const pg_enc2name * DatabaseEncoding
Definition: mbutils.c:81

◆ pg_wchar2mb_with_len()

int pg_wchar2mb_with_len ( const pg_wchar from,
char *  to,
int  len 
)

Definition at line 892 of file mbutils.c.

References pg_enc2name::encoding, pg_wchar_table, and pg_wchar_tbl::wchar2mb_with_len.

Referenced by build_regexp_match_result(), build_regexp_split_result(), convertPgWchar(), regexp_fixed_prefix(), and surrogate_pair_to_codepoint().

893 {
894  return pg_wchar_table[DatabaseEncoding->encoding].wchar2mb_with_len(from, (unsigned char *) to, len);
895 }
wchar2mb_with_len_converter wchar2mb_with_len
Definition: pg_wchar.h:380
pg_enc encoding
Definition: pg_wchar.h:338
const pg_wchar_tbl pg_wchar_table[]
Definition: wchar.c:1505
static const pg_enc2name * DatabaseEncoding
Definition: mbutils.c:81

◆ pg_wchar_strlen()

size_t pg_wchar_strlen ( const pg_wchar wstr)

Definition at line 70 of file wstrncmp.c.

Referenced by pg_wchar2mb(), and surrogate_pair_to_codepoint().

71 {
72  const pg_wchar *s;
73 
74  for (s = str; *s; ++s)
75  ;
76  return (s - str);
77 }
unsigned int pg_wchar
Definition: mbprint.c:31

◆ pg_wchar_strncmp()

int pg_wchar_strncmp ( const pg_wchar s1,
const pg_wchar s2,
size_t  n 
)

Definition at line 40 of file wstrncmp.c.

Referenced by surrogate_pair_to_codepoint().

41 {
42  if (n == 0)
43  return 0;
44  do
45  {
46  if (*s1 != *s2++)
47  return (*s1 - *(s2 - 1));
48  if (*s1++ == 0)
49  break;
50  } while (--n != 0);
51  return 0;
52 }
char * s1
char * s2

◆ PrepareClientEncoding()

int PrepareClientEncoding ( int  encoding)

Definition at line 110 of file mbutils.c.

References backend_startup_complete, ConvProcInfo::c_encoding, encoding, FindDefaultConversionProc(), fmgr_info_cxt(), GetDatabaseEncoding(), IsTransactionState(), lcons(), lfirst, MemoryContextAlloc(), MemoryContextSwitchTo(), OidIsValid, PG_SQL_ASCII, PG_VALID_FE_ENCODING, ConvProcInfo::s_encoding, ConvProcInfo::to_client_info, ConvProcInfo::to_server_info, and TopMemoryContext.

Referenced by check_client_encoding(), InitializeClientEncoding(), and surrogate_pair_to_codepoint().

111 {
112  int current_server_encoding;
113  ListCell *lc;
114 
116  return -1;
117 
118  /* Can't do anything during startup, per notes above */
120  return 0;
121 
122  current_server_encoding = GetDatabaseEncoding();
123 
124  /*
125  * Check for cases that require no conversion function.
126  */
127  if (current_server_encoding == encoding ||
128  current_server_encoding == PG_SQL_ASCII ||
130  return 0;
131 
132  if (IsTransactionState())
133  {
134  /*
135  * If we're in a live transaction, it's safe to access the catalogs,
136  * so look up the functions. We repeat the lookup even if the info is
137  * already cached, so that we can react to changes in the contents of
138  * pg_conversion.
139  */
140  Oid to_server_proc,
141  to_client_proc;
142  ConvProcInfo *convinfo;
143  MemoryContext oldcontext;
144 
145  to_server_proc = FindDefaultConversionProc(encoding,
146  current_server_encoding);
147  if (!OidIsValid(to_server_proc))
148  return -1;
149  to_client_proc = FindDefaultConversionProc(current_server_encoding,
150  encoding);
151  if (!OidIsValid(to_client_proc))
152  return -1;
153 
154  /*
155  * Load the fmgr info into TopMemoryContext (could still fail here)
156  */
158  sizeof(ConvProcInfo));
159  convinfo->s_encoding = current_server_encoding;
160  convinfo->c_encoding = encoding;
161  fmgr_info_cxt(to_server_proc, &convinfo->to_server_info,
163  fmgr_info_cxt(to_client_proc, &convinfo->to_client_info,
165 
166  /* Attach new info to head of list */
168  ConvProcList = lcons(convinfo, ConvProcList);
169  MemoryContextSwitchTo(oldcontext);
170 
171  /*
172  * We cannot yet remove any older entry for the same encoding pair,
173  * since it could still be in use. SetClientEncoding will clean up.
174  */
175 
176  return 0; /* success */
177  }
178  else
179  {
180  /*
181  * If we're not in a live transaction, the only thing we can do is
182  * restore a previous setting using the cache. This covers all
183  * transaction-rollback cases. The only case it might not work for is
184  * trying to change client_encoding on the fly by editing
185  * postgresql.conf and SIGHUP'ing. Which would probably be a stupid
186  * thing to do anyway.
187  */
188  foreach(lc, ConvProcList)
189  {
190  ConvProcInfo *oldinfo = (ConvProcInfo *) lfirst(lc);
191 
192  if (oldinfo->s_encoding == current_server_encoding &&
193  oldinfo->c_encoding == encoding)
194  return 0;
195  }
196 
197  return -1; /* it's not cached, so fail */
198  }
199 }
FmgrInfo to_server_info
Definition: mbutils.c:57
FmgrInfo to_client_info
Definition: mbutils.c:58
static bool backend_startup_complete
Definition: mbutils.c:90
static MemoryContext MemoryContextSwitchTo(MemoryContext context)
Definition: palloc.h:109
unsigned int Oid
Definition: postgres_ext.h:31
#define OidIsValid(objectId)
Definition: c.h:706
int s_encoding
Definition: mbutils.c:55
static List * ConvProcList
Definition: mbutils.c:61
#define PG_VALID_FE_ENCODING(_enc)
Definition: pg_wchar.h:305
void fmgr_info_cxt(Oid functionId, FmgrInfo *finfo, MemoryContext mcxt)
Definition: fmgr.c:136
MemoryContext TopMemoryContext
Definition: mcxt.c:44
int GetDatabaseEncoding(void)
Definition: mbutils.c:1151
List * lcons(void *datum, List *list)
Definition: list.c:453
#define lfirst(lc)
Definition: pg_list.h:169
Oid FindDefaultConversionProc(int32 for_encoding, int32 to_encoding)
Definition: namespace.c:3709
bool IsTransactionState(void)
Definition: xact.c:371
int32 encoding
Definition: pg_database.h:41
void * MemoryContextAlloc(MemoryContext context, Size size)
Definition: mcxt.c:797
int c_encoding
Definition: mbutils.c:56

◆ report_invalid_encoding()

void report_invalid_encoding ( int  encoding,
const char *  mbstr,
int  len 
)

Definition at line 1575 of file mbutils.c.

References buf, ereport, errcode(), errmsg(), ERROR, Min, name, pg_enc2name_tbl, pg_encoding_mblen(), and sprintf.

Referenced by big52mic(), euc_cn2mic(), euc_jis_20042shift_jis_2004(), euc_jp2mic(), euc_jp2sjis(), euc_kr2mic(), euc_tw2mic(), iso8859_1_to_utf8(), latin2mic(), latin2mic_with_table(), local2local(), LocalToUtf(), mic2big5(), mic2euc_cn(), mic2euc_jp(), mic2euc_kr(), mic2euc_tw(), mic2latin(), mic2latin_with_table(), mic2sjis(), pg_verify_mbstr_len(), shift_jis_20042euc_jis_2004(), sjis2euc_jp(), sjis2mic(), surrogate_pair_to_codepoint(), utf8_to_iso8859_1(), and UtfToLocal().

1576 {
1577  int l = pg_encoding_mblen(encoding, mbstr);
1578  char buf[8 * 5 + 1];
1579  char *p = buf;
1580  int j,
1581  jlimit;
1582 
1583  jlimit = Min(l, len);
1584  jlimit = Min(jlimit, 8); /* prevent buffer overrun */
1585 
1586  for (j = 0; j < jlimit; j++)
1587  {
1588  p += sprintf(p, "0x%02x", (unsigned char) mbstr[j]);
1589  if (j < jlimit - 1)
1590  p += sprintf(p, " ");
1591  }
1592 
1593  ereport(ERROR,
1594  (errcode(ERRCODE_CHARACTER_NOT_IN_REPERTOIRE),
1595  errmsg("invalid byte sequence for encoding \"%s\": %s",
1597  buf)));
1598 }
#define Min(x, y)
Definition: c.h:982
int errcode(int sqlerrcode)
Definition: elog.c:691
#define sprintf
Definition: port.h:217
#define ERROR
Definition: elog.h:43
static char * buf
Definition: pg_test_fsync.c:68
const pg_enc2name pg_enc2name_tbl[]
Definition: encnames.c:309
int pg_encoding_mblen(int encoding, const char *mbstr)
Definition: wchar.c:1554
#define ereport(elevel,...)
Definition: elog.h:155
int32 encoding
Definition: pg_database.h:41
const char * name
Definition: encode.c:561
int errmsg(const char *fmt,...)
Definition: elog.c:902

◆ report_untranslatable_char()

void report_untranslatable_char ( int  src_encoding,
int  dest_encoding,
const char *  mbstr,
int  len 
)

Definition at line 1607 of file mbutils.c.

References buf, ereport, errcode(), errmsg(), ERROR, GetMessageEncoding(), IsTransactionState(), Min, name, palloc(), pfree(), pg_do_encoding_conversion(), pg_enc2name_tbl, pg_encoding_mblen(), PG_SQL_ASCII, PG_UTF8, sprintf, and generate_unaccent_rules::str.

Referenced by big52mic(), latin2mic_with_table(), local2local(), LocalToUtf(), mic2big5(), mic2euc_cn(), mic2euc_jp(), mic2euc_kr(), mic2euc_tw(), mic2latin(), mic2latin_with_table(), mic2sjis(), surrogate_pair_to_codepoint(), utf8_to_iso8859_1(), and UtfToLocal().

1609 {
1610  int l = pg_encoding_mblen(src_encoding, mbstr);
1611  char buf[8 * 5 + 1];
1612  char *p = buf;
1613  int j,
1614  jlimit;
1615 
1616  jlimit = Min(l, len);
1617  jlimit = Min(jlimit, 8); /* prevent buffer overrun */
1618 
1619  for (j = 0; j < jlimit; j++)
1620  {
1621  p += sprintf(p, "0x%02x", (unsigned char) mbstr[j]);
1622  if (j < jlimit - 1)
1623  p += sprintf(p, " ");
1624  }
1625 
1626  ereport(ERROR,
1627  (errcode(ERRCODE_UNTRANSLATABLE_CHARACTER),
1628  errmsg("character with byte sequence %s in encoding \"%s\" has no equivalent in encoding \"%s\"",
1629  buf,
1630  pg_enc2name_tbl[src_encoding].name,
1631  pg_enc2name_tbl[dest_encoding].name)));
1632 }
#define Min(x, y)
Definition: c.h:982
int errcode(int sqlerrcode)
Definition: elog.c:691
#define sprintf
Definition: port.h:217
#define ERROR
Definition: elog.h:43
static char * buf
Definition: pg_test_fsync.c:68
const pg_enc2name pg_enc2name_tbl[]
Definition: encnames.c:309
int pg_encoding_mblen(int encoding, const char *mbstr)
Definition: wchar.c:1554
#define ereport(elevel,...)
Definition: elog.h:155
const char * name
Definition: encode.c:561
int errmsg(const char *fmt,...)
Definition: elog.c:902

◆ SetClientEncoding()

int SetClientEncoding ( int  encoding)

Definition at line 208 of file mbutils.c.

References backend_startup_complete, ConvProcInfo::c_encoding, encoding, foreach_delete_current, GetDatabaseEncoding(), lfirst, pending_client_encoding, pfree(), pg_enc2name_tbl, PG_SQL_ASCII, PG_VALID_FE_ENCODING, ConvProcInfo::s_encoding, ConvProcInfo::to_client_info, and ConvProcInfo::to_server_info.

Referenced by assign_client_encoding(), InitializeClientEncoding(), ParallelWorkerMain(), and surrogate_pair_to_codepoint().

209 {
210  int current_server_encoding;
211  bool found;
212  ListCell *lc;
213 
215  return -1;
216 
217  /* Can't do anything during startup, per notes above */
219  {
221  return 0;
222  }
223 
224  current_server_encoding = GetDatabaseEncoding();
225 
226  /*
227  * Check for cases that require no conversion function.
228  */
229  if (current_server_encoding == encoding ||
230  current_server_encoding == PG_SQL_ASCII ||
232  {
234  ToServerConvProc = NULL;
235  ToClientConvProc = NULL;
236  return 0;
237  }
238 
239  /*
240  * Search the cache for the entry previously prepared by
241  * PrepareClientEncoding; if there isn't one, we lose. While at it,
242  * release any duplicate entries so that repeated Prepare/Set cycles don't
243  * leak memory.
244  */
245  found = false;
246  foreach(lc, ConvProcList)
247  {
248  ConvProcInfo *convinfo = (ConvProcInfo *) lfirst(lc);
249 
250  if (convinfo->s_encoding == current_server_encoding &&
251  convinfo->c_encoding == encoding)
252  {
253  if (!found)
254  {
255  /* Found newest entry, so set up */
257  ToServerConvProc = &convinfo->to_server_info;
258  ToClientConvProc = &convinfo->to_client_info;
259  found = true;
260  }
261  else
262  {
263  /* Duplicate entry, release it */
265  pfree(convinfo);
266  }
267  }
268  }
269 
270  if (found)
271  return 0; /* success */
272  else
273  return -1; /* it's not cached, so fail */
274 }
FmgrInfo to_server_info
Definition: mbutils.c:57
FmgrInfo to_client_info
Definition: mbutils.c:58
static bool backend_startup_complete
Definition: mbutils.c:90
static int pending_client_encoding
Definition: mbutils.c:91
static FmgrInfo * ToServerConvProc
Definition: mbutils.c:67
static const pg_enc2name * ClientEncoding
Definition: mbutils.c:80
#define foreach_delete_current(lst, cell)
Definition: pg_list.h:357
int s_encoding
Definition: mbutils.c:55
void pfree(void *pointer)
Definition: mcxt.c:1057
static List * ConvProcList
Definition: mbutils.c:61
const pg_enc2name pg_enc2name_tbl[]
Definition: encnames.c:309
#define PG_VALID_FE_ENCODING(_enc)
Definition: pg_wchar.h:305
int GetDatabaseEncoding(void)
Definition: mbutils.c:1151
#define lfirst(lc)
Definition: pg_list.h:169
int32 encoding
Definition: pg_database.h:41
static FmgrInfo * ToClientConvProc
Definition: mbutils.c:68
int c_encoding
Definition: mbutils.c:56

◆ SetDatabaseEncoding()

void SetDatabaseEncoding ( int  encoding)

Definition at line 1045 of file mbutils.c.

References Assert, elog, encoding, pg_enc2name::encoding, ERROR, pg_enc2name_tbl, and PG_VALID_BE_ENCODING.

Referenced by CheckMyDatabase(), and surrogate_pair_to_codepoint().

1046 {
1048  elog(ERROR, "invalid database encoding: %d", encoding);
1049 
1052 }
#define ERROR
Definition: elog.h:43
const pg_enc2name pg_enc2name_tbl[]
Definition: encnames.c:309
pg_enc encoding
Definition: pg_wchar.h:338
#define PG_VALID_BE_ENCODING(_enc)
Definition: pg_wchar.h:295
#define Assert(condition)
Definition: c.h:800
int32 encoding
Definition: pg_database.h:41
static const pg_enc2name * DatabaseEncoding
Definition: mbutils.c:81
#define elog(elevel,...)
Definition: elog.h:228

◆ SetMessageEncoding()

void SetMessageEncoding ( int  encoding)

Definition at line 1055 of file mbutils.c.

References Assert, CurrentMemoryContext, elog, encoding, pg_enc2name::encoding, GetDatabaseEncoding(), GetMessageEncoding(), i, LOG, pg_enc2gettext::name, name, pg_enc2gettext_tbl, pg_enc2name_tbl, pg_get_encoding_from_locale(), PG_SQL_ASCII, pg_strcasecmp(), PG_VALID_ENCODING, setlocale, and write_stderr.

Referenced by pg_perm_setlocale(), and surrogate_pair_to_codepoint().

1056 {
1057  /* Some calls happen before we can elog()! */
1059 
1062 }
#define PG_VALID_ENCODING(_enc)
Definition: pg_wchar.h:301
const pg_enc2name pg_enc2name_tbl[]
Definition: encnames.c:309
pg_enc encoding
Definition: pg_wchar.h:338
#define Assert(condition)
Definition: c.h:800
int32 encoding
Definition: pg_database.h:41
static const pg_enc2name * MessageEncoding
Definition: mbutils.c:82

◆ surrogate_pair_to_codepoint()

static pg_wchar surrogate_pair_to_codepoint ( pg_wchar  first,
pg_wchar  second 
)
inlinestatic

Definition at line 536 of file pg_wchar.h.

References BIG5toCNS(), check_encoding_conversion_args(), CNStoBIG5(), pg_enc2name::encoding, get_encoding_name_for_icu(), GetDatabaseEncoding(), GetDatabaseEncodingName(), GetMessageEncoding(), InitializeClientEncoding(), is_encoding_supported_by_icu(), latin2mic(), latin2mic_with_table(), local2local(), LocalToUtf(), mic2latin(), mic2latin_with_table(), pg_enc2name::name, pg_any_to_server(), pg_attribute_noreturn, pg_char_and_wchar_strcmp(), pg_char_and_wchar_strncmp(), pg_char_to_encoding(), pg_client_to_server(), pg_database_encoding_character_incrementer(), pg_database_encoding_max_length(), pg_do_encoding_conversion(), pg_dsplen(), pg_encoding_dsplen(), pg_encoding_max_length(), pg_encoding_mb2wchar_with_len(), pg_encoding_mbcliplen(), pg_encoding_mblen(), pg_encoding_to_char(), pg_encoding_verifymb(), pg_encoding_wchar2mb_with_len(), pg_get_client_encoding(), pg_get_client_encoding_name(), pg_mb2wchar(), pg_mb2wchar_with_len(), pg_mbcharcliplen(), pg_mbcliplen(), pg_mblen(), pg_mbstrlen(), pg_mbstrlen_with_len(), pg_mule_mblen(), pg_server_to_any(), pg_server_to_client(), pg_unicode_to_server(), pg_utf8_islegal(), pg_utf_mblen(), pg_valid_client_encoding(), pg_valid_server_encoding(), pg_valid_server_encoding_id(), pg_verify_mbstr(), pg_verify_mbstr_len(), pg_verifymbstr(), pg_wchar2mb(), pg_wchar2mb_with_len(), pg_wchar_strlen(), pg_wchar_strncmp(), PrepareClientEncoding(), report_invalid_encoding(), report_untranslatable_char(), s1, s2, SetClientEncoding(), SetDatabaseEncoding(), SetMessageEncoding(), source, generate_unaccent_rules::str, unicode_to_utf8(), utf8_to_unicode(), and UtfToLocal().

Referenced by json_lex_string(), and str_udeescape().

537 {
538  return ((first & 0x3FF) << 10) + 0x10000 + (second & 0x3FF);
539 }

◆ unicode_to_utf8()

unsigned char* unicode_to_utf8 ( pg_wchar  c,
unsigned char *  utf8string 
)

Definition at line 483 of file wchar.c.

Referenced by json_lex_string(), pg_saslprep(), pg_unicode_to_server(), pg_wchar2utf_with_len(), surrogate_pair_to_codepoint(), and unicode_normalize_func().

484 {
485  if (c <= 0x7F)
486  {
487  utf8string[0] = c;
488  }
489  else if (c <= 0x7FF)
490  {
491  utf8string[0] = 0xC0 | ((c >> 6) & 0x1F);
492  utf8string[1] = 0x80 | (c & 0x3F);
493  }
494  else if (c <= 0xFFFF)
495  {
496  utf8string[0] = 0xE0 | ((c >> 12) & 0x0F);
497  utf8string[1] = 0x80 | ((c >> 6) & 0x3F);
498  utf8string[2] = 0x80 | (c & 0x3F);
499  }
500  else
501  {
502  utf8string[0] = 0xF0 | ((c >> 18) & 0x07);
503  utf8string[1] = 0x80 | ((c >> 12) & 0x3F);
504  utf8string[2] = 0x80 | ((c >> 6) & 0x3F);
505  utf8string[3] = 0x80 | (c & 0x3F);
506  }
507 
508  return utf8string;
509 }
char * c

◆ utf8_to_unicode()

pg_wchar utf8_to_unicode ( const unsigned char *  c)

Definition at line 686 of file wchar.c.

Referenced by pg_saslprep(), pg_utf_dsplen(), surrogate_pair_to_codepoint(), unicode_is_normalized(), and unicode_normalize_func().

687 {
688  if ((*c & 0x80) == 0)
689  return (pg_wchar) c[0];
690  else if ((*c & 0xe0) == 0xc0)
691  return (pg_wchar) (((c[0] & 0x1f) << 6) |
692  (c[1] & 0x3f));
693  else if ((*c & 0xf0) == 0xe0)
694  return (pg_wchar) (((c[0] & 0x0f) << 12) |
695  ((c[1] & 0x3f) << 6) |
696  (c[2] & 0x3f));
697  else if ((*c & 0xf8) == 0xf0)
698  return (pg_wchar) (((c[0] & 0x07) << 18) |
699  ((c[1] & 0x3f) << 12) |
700  ((c[2] & 0x3f) << 6) |
701  (c[3] & 0x3f));
702  else
703  /* that is an invalid code on purpose */
704  return 0xffffffff;
705 }
char * c
unsigned int pg_wchar
Definition: mbprint.c:31

◆ UtfToLocal()

void UtfToLocal ( const unsigned char *  utf,
int  len,
unsigned char *  iso,
const pg_mb_radix_tree map,
const pg_utf_to_local_combined cmap,
int  cmapsize,
utf_local_conversion_func  conv_func,
int  encoding 
)

Definition at line 429 of file conv.c.

References pg_utf_to_local_combined::code, compare3(), elog, ereport, errcode(), errmsg(), ERROR, pg_mb_radix_conv(), PG_UTF8, pg_utf8_islegal(), pg_utf_mblen(), PG_VALID_ENCODING, report_invalid_encoding(), report_untranslatable_char(), and store_coded_char().

Referenced by surrogate_pair_to_codepoint(), utf8_to_big5(), utf8_to_euc_cn(), utf8_to_euc_jis_2004(), utf8_to_euc_jp(), utf8_to_euc_kr(), utf8_to_euc_tw(), utf8_to_gb18030(), utf8_to_gbk(), utf8_to_iso8859(), utf8_to_johab(), utf8_to_koi8r(), utf8_to_koi8u(), utf8_to_shift_jis_2004(), utf8_to_sjis(), utf8_to_uhc(), and utf8_to_win().

435 {
436  uint32 iutf;
437  int l;
438  const pg_utf_to_local_combined *cp;
439 
441  ereport(ERROR,
442  (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
443  errmsg("invalid encoding number: %d", encoding)));
444 
445  for (; len > 0; len -= l)
446  {
447  unsigned char b1 = 0;
448  unsigned char b2 = 0;
449  unsigned char b3 = 0;
450  unsigned char b4 = 0;
451 
452  /* "break" cases all represent errors */
453  if (*utf == '\0')
454  break;
455 
456  l = pg_utf_mblen(utf);
457  if (len < l)
458  break;
459 
460  if (!pg_utf8_islegal(utf, l))
461  break;
462 
463  if (l == 1)
464  {
465  /* ASCII case is easy, assume it's one-to-one conversion */
466  *iso++ = *utf++;
467  continue;
468  }
469 
470  /* collect coded char of length l */
471  if (l == 2)
472  {
473  b3 = *utf++;
474  b4 = *utf++;
475  }
476  else if (l == 3)
477  {
478  b2 = *utf++;
479  b3 = *utf++;
480  b4 = *utf++;
481  }
482  else if (l == 4)
483  {
484  b1 = *utf++;
485  b2 = *utf++;
486  b3 = *utf++;
487  b4 = *utf++;
488  }
489  else
490  {
491  elog(ERROR, "unsupported character length %d", l);
492  iutf = 0; /* keep compiler quiet */
493  }
494  iutf = (b1 << 24 | b2 << 16 | b3 << 8 | b4);
495 
496  /* First, try with combined map if possible */
497  if (cmap && len > l)
498  {
499  const unsigned char *utf_save = utf;
500  int len_save = len;
501  int l_save = l;
502 
503  /* collect next character, same as above */
504  len -= l;
505 
506  l = pg_utf_mblen(utf);
507  if (len < l)
508  break;
509 
510  if (!pg_utf8_islegal(utf, l))
511  break;
512 
513  /* We assume ASCII character cannot be in combined map */
514  if (l > 1)
515  {
516  uint32 iutf2;
517  uint32 cutf[2];
518 
519  if (l == 2)
520  {
521  iutf2 = *utf++ << 8;
522  iutf2 |= *utf++;
523  }
524  else if (l == 3)
525  {
526  iutf2 = *utf++ << 16;
527  iutf2 |= *utf++ << 8;
528  iutf2 |= *utf++;
529  }
530  else if (l == 4)
531  {
532  iutf2 = *utf++ << 24;
533  iutf2 |= *utf++ << 16;
534  iutf2 |= *utf++ << 8;
535  iutf2 |= *utf++;
536  }
537  else
538  {
539  elog(ERROR, "unsupported character length %d", l);
540  iutf2 = 0; /* keep compiler quiet */
541  }
542 
543  cutf[0] = iutf;
544  cutf[1] = iutf2;
545 
546  cp = bsearch(cutf, cmap, cmapsize,
548 
549  if (cp)
550  {
551  iso = store_coded_char(iso, cp->code);
552  continue;
553  }
554  }
555 
556  /* fail, so back up to reprocess second character next time */
557  utf = utf_save;
558  len = len_save;
559  l = l_save;
560  }
561 
562  /* Now check ordinary map */
563  if (map)
564  {
565  uint32 converted = pg_mb_radix_conv(map, l, b1, b2, b3, b4);
566 
567  if (converted)
568  {
569  iso = store_coded_char(iso, converted);
570  continue;
571  }
572  }
573 
574  /* if there's a conversion function, try that */
575  if (conv_func)
576  {
577  uint32 converted = (*conv_func) (iutf);
578 
579  if (converted)
580  {
581  iso = store_coded_char(iso, converted);
582  continue;
583  }
584  }
585 
586  /* failed to translate this character */
588  (const char *) (utf - l), len);
589  }
590 
591  /* if we broke out of loop early, must be invalid input */
592  if (len > 0)
593  report_invalid_encoding(PG_UTF8, (const char *) utf, len);
594 
595  *iso = '\0';
596 }
bool pg_utf8_islegal(const unsigned char *source, int length)
Definition: wchar.c:1442
void report_invalid_encoding(int encoding, const char *mbstr, int len)
Definition: mbutils.c:1575
int errcode(int sqlerrcode)
Definition: elog.c:691
static unsigned char * store_coded_char(unsigned char *dest, uint32 code)
Definition: conv.c:278
#define ERROR
Definition: elog.h:43
#define PG_VALID_ENCODING(_enc)
Definition: pg_wchar.h:301
static uint32 pg_mb_radix_conv(const pg_mb_radix_tree *rt, int l, unsigned char b1, unsigned char b2, unsigned char b3, unsigned char b4)
Definition: conv.c:298
unsigned int uint32
Definition: c.h:429
#define ereport(elevel,...)
Definition: elog.h:155
static int compare3(const void *p1, const void *p2)
Definition: conv.c:245
int32 encoding
Definition: pg_database.h:41
void report_untranslatable_char(int src_encoding, int dest_encoding, const char *mbstr, int len)
Definition: mbutils.c:1607
int pg_utf_mblen(const unsigned char *s)
Definition: wchar.c:549
int errmsg(const char *fmt,...)
Definition: elog.c:902
#define elog(elevel,...)
Definition: elog.h:228

Variable Documentation

◆ pg_enc2gettext_tbl

const pg_enc2gettext pg_enc2gettext_tbl[]

Definition at line 361 of file encnames.c.

Referenced by SetMessageEncoding().

◆ pg_enc2name_tbl

◆ pg_wchar_table