PostgreSQL Source Code  git master
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros
pg_locale.h
Go to the documentation of this file.
1 /*-----------------------------------------------------------------------
2  *
3  * PostgreSQL locale utilities
4  *
5  * src/include/utils/pg_locale.h
6  *
7  * Copyright (c) 2002-2017, PostgreSQL Global Development Group
8  *
9  *-----------------------------------------------------------------------
10  */
11 
12 #ifndef _PG_LOCALE_
13 #define _PG_LOCALE_
14 
15 #if defined(LOCALE_T_IN_XLOCALE) || defined(WCSTOMBS_L_IN_XLOCALE)
16 #include <xlocale.h>
17 #endif
18 #ifdef USE_ICU
19 #include <unicode/ucol.h>
20 #endif
21 
22 #include "utils/guc.h"
23 
24 #ifdef USE_ICU
25 /*
26  * ucol_strcollUTF8() was introduced in ICU 50, but it is buggy before ICU 53.
27  * (see
28  * <https://www.postgresql.org/message-id/flat/f1438ec6-22aa-4029-9a3b-26f79d330e72%40manitou-mail.org>)
29  */
30 #if U_ICU_VERSION_MAJOR_NUM >= 53
31 #define HAVE_UCOL_STRCOLLUTF8 1
32 #else
33 #undef HAVE_UCOL_STRCOLLUTF8
34 #endif
35 #endif
36 
37 
38 /* GUC settings */
39 extern char *locale_messages;
40 extern char *locale_monetary;
41 extern char *locale_numeric;
42 extern char *locale_time;
43 
44 /* lc_time localization cache */
45 extern char *localized_abbrev_days[];
46 extern char *localized_full_days[];
47 extern char *localized_abbrev_months[];
48 extern char *localized_full_months[];
49 
50 
51 extern bool check_locale_messages(char **newval, void **extra, GucSource source);
52 extern void assign_locale_messages(const char *newval, void *extra);
53 extern bool check_locale_monetary(char **newval, void **extra, GucSource source);
54 extern void assign_locale_monetary(const char *newval, void *extra);
55 extern bool check_locale_numeric(char **newval, void **extra, GucSource source);
56 extern void assign_locale_numeric(const char *newval, void *extra);
57 extern bool check_locale_time(char **newval, void **extra, GucSource source);
58 extern void assign_locale_time(const char *newval, void *extra);
59 
60 extern bool check_locale(int category, const char *locale, char **canonname);
61 extern char *pg_perm_setlocale(int category, const char *locale);
62 extern void check_strxfrm_bug(void);
63 
64 extern bool lc_collate_is_c(Oid collation);
65 extern bool lc_ctype_is_c(Oid collation);
66 
67 /*
68  * Return the POSIX lconv struct (contains number/money formatting
69  * information) with locale information for all categories.
70  */
71 extern struct lconv *PGLC_localeconv(void);
72 
73 extern void cache_locale_time(void);
74 
75 
76 /*
77  * We define our own wrapper around locale_t so we can keep the same
78  * function signatures for all builds, while not having to create a
79  * fake version of the standard type locale_t in the global namespace.
80  * pg_locale_t is occasionally checked for truth, so make it a pointer.
81  */
83 {
84  char provider;
85  union
86  {
87 #ifdef HAVE_LOCALE_T
88  locale_t lt;
89 #endif
90 #ifdef USE_ICU
91  struct
92  {
93  const char *locale;
94  UCollator *ucol;
95  } icu;
96 #endif
97  int dummy; /* in case we have neither LOCALE_T nor ICU */
98  } info;
99 };
100 
102 
103 extern pg_locale_t pg_newlocale_from_collation(Oid collid);
104 
105 extern char *get_collation_actual_version(char collprovider, const char *collcollate);
106 
107 #ifdef USE_ICU
108 extern int32_t icu_to_uchar(UChar **buff_uchar, const char *buff, size_t nbytes);
109 extern int32_t icu_from_uchar(char **result, const UChar *buff_uchar, int32_t len_uchar);
110 #endif
111 
112 /* These functions convert from/to libc's wchar_t, *not* pg_wchar_t */
113 #ifdef USE_WIDE_UPPER_LOWER
114 extern size_t wchar2char(char *to, const wchar_t *from, size_t tolen,
115  pg_locale_t locale);
116 extern size_t char2wchar(wchar_t *to, size_t tolen,
117  const char *from, size_t fromlen, pg_locale_t locale);
118 #endif
119 
120 #endif /* _PG_LOCALE_ */
char * pg_perm_setlocale(int category, const char *locale)
Definition: pg_locale.c:151
bool check_locale_monetary(char **newval, void **extra, GucSource source)
Definition: pg_locale.c:307
bool lc_collate_is_c(Oid collation)
Definition: pg_locale.c:1128
#define locale_t
Definition: win32.h:323
char * locale_time
Definition: pg_locale.c:91
bool check_locale_numeric(char **newval, void **extra, GucSource source)
Definition: pg_locale.c:319
union pg_locale_struct::@120 info
bool check_locale_messages(char **newval, void **extra, GucSource source)
Definition: pg_locale.c:353
return result
Definition: formatting.c:1633
struct lconv * PGLC_localeconv(void)
Definition: pg_locale.c:483
unsigned int Oid
Definition: postgres_ext.h:31
GucSource
Definition: guc.h:105
bool check_locale(int category, const char *locale, char **canonname)
Definition: pg_locale.c:264
void assign_locale_monetary(const char *newval, void *extra)
Definition: pg_locale.c:313
bool lc_ctype_is_c(Oid collation)
Definition: pg_locale.c:1178
void assign_locale_messages(const char *newval, void *extra)
Definition: pg_locale.c:376
char * locale_monetary
Definition: pg_locale.c:89
pg_locale_t pg_newlocale_from_collation(Oid collid)
Definition: pg_locale.c:1275
char * get_collation_actual_version(char collprovider, const char *collcollate)
Definition: pg_locale.c:1445
char * localized_full_days[]
Definition: pg_locale.c:95
bool check_locale_time(char **newval, void **extra, GucSource source)
Definition: pg_locale.c:331
struct pg_locale_struct * pg_locale_t
Definition: pg_locale.h:101
char * locale_messages
Definition: pg_locale.c:88
void cache_locale_time(void)
Definition: pg_locale.c:786
void check_strxfrm_bug(void)
Definition: pg_locale.c:993
char * localized_full_months[]
Definition: pg_locale.c:97
void assign_locale_numeric(const char *newval, void *extra)
Definition: pg_locale.c:325
#define newval
char * locale_numeric
Definition: pg_locale.c:90
void assign_locale_time(const char *newval, void *extra)
Definition: pg_locale.c:337
static char * locale
Definition: initdb.c:123
int int32_t
Definition: crypt.c:108
char * localized_abbrev_days[]
Definition: pg_locale.c:94
char * localized_abbrev_months[]
Definition: pg_locale.c:96