downcase_identifier(): use method table from locale provider.
authorJeff Davis <[email protected]>
Tue, 16 Dec 2025 23:32:41 +0000 (15:32 -0800)
committerJeff Davis <[email protected]>
Tue, 16 Dec 2025 23:32:41 +0000 (15:32 -0800)
Previously, libc's tolower() was always used for lowercasing
identifiers, regardless of the database locale (though only characters
beyond 127 in single-byte encodings were affected). Refactor to allow
each provider to supply its own implementation of identifier
downcasing.

For historical compatibility, when using a single-byte encoding, ICU
still relies on tolower().

One minor behavior change is that, before the database default locale
is initialized, it uses ASCII semantics to downcase the
identifiers. Previously, it would use the postmaster's LC_CTYPE
setting from the environment. While that could have some effect during
GUC processing, for example, it would have been fragile to rely on the
environment setting anyway. (Also, it only matters when the encoding
is single-byte.)

Reviewed-by: Chao Li <[email protected]>
Reviewed-by: Peter Eisentraut <[email protected]>
Discussion: https://postgr.es/m/450ceb6260cad30d7afdf155d991a9caafee7c0d[email protected]

src/backend/parser/scansup.c
src/backend/utils/adt/pg_locale.c
src/backend/utils/adt/pg_locale_builtin.c
src/backend/utils/adt/pg_locale_icu.c
src/backend/utils/adt/pg_locale_libc.c
src/include/utils/pg_locale.h

index 2feb2b6cf5a968e153ff4416e8223302f5702a08..d63cb865260b6627d77e404a14371024cba4b0c5 100644 (file)
@@ -18,6 +18,7 @@
 
 #include "mb/pg_wchar.h"
 #include "parser/scansup.h"
+#include "utils/pg_locale.h"
 
 
 /*
@@ -46,35 +47,22 @@ char *
 downcase_identifier(const char *ident, int len, bool warn, bool truncate)
 {
    char       *result;
-   int         i;
-   bool        enc_is_single_byte;
-
-   result = palloc(len + 1);
-   enc_is_single_byte = pg_database_encoding_max_length() == 1;
+   size_t      needed pg_attribute_unused();
 
    /*
-    * SQL99 specifies Unicode-aware case normalization, which we don't yet
-    * have the infrastructure for.  Instead we use tolower() to provide a
-    * locale-aware translation.  However, there are some locales where this
-    * is not right either (eg, Turkish may do strange things with 'i' and
-    * 'I').  Our current compromise is to use tolower() for characters with
-    * the high bit set, as long as they aren't part of a multi-byte
-    * character, and use an ASCII-only downcasing for 7-bit characters.
+    * Preserves string length.
+    *
+    * NB: if we decide to support Unicode-aware identifier case folding, then
+    * we need to account for a change in string length.
     */
-   for (i = 0; i < len; i++)
-   {
-       unsigned char ch = (unsigned char) ident[i];
+   result = palloc(len + 1);
 
-       if (ch >= 'A' && ch <= 'Z')
-           ch += 'a' - 'A';
-       else if (enc_is_single_byte && IS_HIGHBIT_SET(ch) && isupper(ch))
-           ch = tolower(ch);
-       result[i] = (char) ch;
-   }
-   result[i] = '\0';
+   needed = pg_downcase_ident(result, len + 1, ident, len);
+   Assert(needed == len);
+   Assert(result[len] == '\0');
 
-   if (i >= NAMEDATALEN && truncate)
-       truncate_identifier(result, i, warn);
+   if (len >= NAMEDATALEN && truncate)
+       truncate_identifier(result, len, warn);
 
    return result;
 }
index 8a3796aa5d0083e65c2dc6120df174d0264a5941..ee08ac045b7b216b0f1777a5f723069025001067 100644 (file)
@@ -1352,6 +1352,26 @@ pg_strfold(char *dst, size_t dstsize, const char *src, ssize_t srclen,
        return locale->ctype->strfold(dst, dstsize, src, srclen, locale);
 }
 
+/*
+ * Lowercase an identifier using the database default locale.
+ *
+ * For historical reasons, does not use ordinary locale behavior. Should only
+ * be used for identifiers. XXX: can we make this equivalent to
+ * pg_strfold(..., default_locale)?
+ */
+size_t
+pg_downcase_ident(char *dst, size_t dstsize, const char *src, ssize_t srclen)
+{
+   pg_locale_t locale = default_locale;
+
+   if (locale == NULL || locale->ctype == NULL ||
+       locale->ctype->downcase_ident == NULL)
+       return strlower_c(dst, dstsize, src, srclen);
+   else
+       return locale->ctype->downcase_ident(dst, dstsize, src, srclen,
+                                            locale);
+}
+
 /*
  * pg_strcoll
  *
index 0c2920112bbb676bfa4d45e67e6cb74b532b73d0..145b4641b1b82d431d470d4b1a3cd0265349ba0d 100644 (file)
@@ -208,6 +208,8 @@ static const struct ctype_methods ctype_methods_builtin = {
    .strtitle = strtitle_builtin,
    .strupper = strupper_builtin,
    .strfold = strfold_builtin,
+   /* uses plain ASCII semantics for historical reasons */
+   .downcase_ident = NULL,
    .wc_isdigit = wc_isdigit_builtin,
    .wc_isalpha = wc_isalpha_builtin,
    .wc_isalnum = wc_isalnum_builtin,
index 18d026deda8e7d6db0296b9d14b9ed0b53be6b85..69f22b47a68c1fb6c5aeb87869c9cd4cf75ab390 100644 (file)
@@ -61,6 +61,8 @@ static size_t strupper_icu(char *dest, size_t destsize, const char *src,
                           ssize_t srclen, pg_locale_t locale);
 static size_t strfold_icu(char *dest, size_t destsize, const char *src,
                          ssize_t srclen, pg_locale_t locale);
+static size_t downcase_ident_icu(char *dst, size_t dstsize, const char *src,
+                                ssize_t srclen, pg_locale_t locale);
 static int strncoll_icu(const char *arg1, ssize_t len1,
                         const char *arg2, ssize_t len2,
                         pg_locale_t locale);
@@ -123,7 +125,7 @@ static int32_t u_strFoldCase_default(UChar *dest, int32_t destCapacity,
 
 /*
  * XXX: many of the functions below rely on casts directly from pg_wchar to
- * UChar32, which is correct for the UTF-8 encoding, but not in general.
+ * UChar32, which is correct for UTF-8 and LATIN1, but not in general.
  */
 
 static pg_wchar
@@ -227,6 +229,7 @@ static const struct ctype_methods ctype_methods_icu = {
    .strtitle = strtitle_icu,
    .strupper = strupper_icu,
    .strfold = strfold_icu,
+   .downcase_ident = downcase_ident_icu,
    .wc_isdigit = wc_isdigit_icu,
    .wc_isalpha = wc_isalpha_icu,
    .wc_isalnum = wc_isalnum_icu,
@@ -564,6 +567,37 @@ strfold_icu(char *dest, size_t destsize, const char *src, ssize_t srclen,
    return result_len;
 }
 
+/*
+ * For historical compatibility, behavior is not multibyte-aware.
+ *
+ * NB: uses libc tolower() for single-byte encodings (also for historical
+ * compatibility), and therefore relies on the global LC_CTYPE setting.
+ */
+static size_t
+downcase_ident_icu(char *dst, size_t dstsize, const char *src,
+                  ssize_t srclen, pg_locale_t locale)
+{
+   int         i;
+   bool        enc_is_single_byte;
+
+   enc_is_single_byte = pg_database_encoding_max_length() == 1;
+   for (i = 0; i < srclen && i < dstsize; i++)
+   {
+       unsigned char ch = (unsigned char) src[i];
+
+       if (ch >= 'A' && ch <= 'Z')
+           ch = pg_ascii_tolower(ch);
+       else if (enc_is_single_byte && IS_HIGHBIT_SET(ch) && isupper(ch))
+           ch = tolower(ch);
+       dst[i] = (char) ch;
+   }
+
+   if (i < dstsize)
+       dst[i] = '\0';
+
+   return srclen;
+}
+
 /*
  * strncoll_icu_utf8
  *
index 3baa5816b5fc842c20cd9bb973dfe7dcc21c999e..ab6117aaace5713b57e235bd63cdd513c6d830cc 100644 (file)
@@ -318,12 +318,41 @@ tolower_libc_mb(pg_wchar wc, pg_locale_t locale)
        return wc;
 }
 
+/*
+ * Characters A..Z always downcase to a..z, even in the Turkish
+ * locale. Characters beyond 127 use tolower().
+ */
+static size_t
+downcase_ident_libc_sb(char *dst, size_t dstsize, const char *src,
+                      ssize_t srclen, pg_locale_t locale)
+{
+   locale_t    loc = locale->lt;
+   int         i;
+
+   for (i = 0; i < srclen && i < dstsize; i++)
+   {
+       unsigned char ch = (unsigned char) src[i];
+
+       if (ch >= 'A' && ch <= 'Z')
+           ch = pg_ascii_tolower(ch);
+       else if (IS_HIGHBIT_SET(ch) && isupper_l(ch, loc))
+           ch = tolower_l(ch, loc);
+       dst[i] = (char) ch;
+   }
+
+   if (i < dstsize)
+       dst[i] = '\0';
+
+   return srclen;
+}
+
 static const struct ctype_methods ctype_methods_libc_sb = {
    .strlower = strlower_libc_sb,
    .strtitle = strtitle_libc_sb,
    .strupper = strupper_libc_sb,
    /* in libc, casefolding is the same as lowercasing */
    .strfold = strlower_libc_sb,
+   .downcase_ident = downcase_ident_libc_sb,
    .wc_isdigit = wc_isdigit_libc_sb,
    .wc_isalpha = wc_isalpha_libc_sb,
    .wc_isalnum = wc_isalnum_libc_sb,
@@ -349,6 +378,8 @@ static const struct ctype_methods ctype_methods_libc_other_mb = {
    .strupper = strupper_libc_mb,
    /* in libc, casefolding is the same as lowercasing */
    .strfold = strlower_libc_mb,
+   /* uses plain ASCII semantics for historical reasons */
+   .downcase_ident = NULL,
    .wc_isdigit = wc_isdigit_libc_sb,
    .wc_isalpha = wc_isalpha_libc_sb,
    .wc_isalnum = wc_isalnum_libc_sb,
@@ -370,6 +401,8 @@ static const struct ctype_methods ctype_methods_libc_utf8 = {
    .strupper = strupper_libc_mb,
    /* in libc, casefolding is the same as lowercasing */
    .strfold = strlower_libc_mb,
+   /* uses plain ASCII semantics for historical reasons */
+   .downcase_ident = NULL,
    .wc_isdigit = wc_isdigit_libc_mb,
    .wc_isalpha = wc_isalpha_libc_mb,
    .wc_isalnum = wc_isalnum_libc_mb,
index 6cf1985963d7e52c29c92ee3face97a8125b81e3..1e584819c5e9faad309266a247cf2333318b2dcc 100644 (file)
@@ -110,6 +110,9 @@ struct ctype_methods
    size_t      (*strfold) (char *dest, size_t destsize,
                            const char *src, ssize_t srclen,
                            pg_locale_t locale);
+   size_t      (*downcase_ident) (char *dest, size_t destsize,
+                                  const char *src, ssize_t srclen,
+                                  pg_locale_t locale);
 
    /* required */
    bool        (*wc_isdigit) (pg_wchar wc, pg_locale_t locale);
@@ -187,6 +190,8 @@ extern size_t pg_strupper(char *dst, size_t dstsize,
 extern size_t pg_strfold(char *dst, size_t dstsize,
                         const char *src, ssize_t srclen,
                         pg_locale_t locale);
+extern size_t pg_downcase_ident(char *dst, size_t dstsize,
+                               const char *src, ssize_t srclen);
 extern int pg_strcoll(const char *arg1, const char *arg2, pg_locale_t locale);
 extern int pg_strncoll(const char *arg1, ssize_t len1,
                        const char *arg2, ssize_t len2, pg_locale_t locale);