Add a HINT about the likely reason for 'invalid multibyte character for locale' failure.

tglsfdc · tglsfdc · commit a1bc728cf92c · 2004-10-19T15:04:17.000Z
diff --git a/src/backend/utils/adt/oracle_compat.c b/src/backend/utils/adt/oracle_compat.c
@@ -9,7 +9,7 @@
  *
  *
  * IDENTIFICATION
- *	$PostgreSQL: pgsql/src/backend/utils/adt/oracle_compat.c,v 1.55 2004/08/29 05:06:49 momjian Exp $
+ *	$PostgreSQL: pgsql/src/backend/utils/adt/oracle_compat.c,v 1.56 2004/10/19 15:04:17 tgl Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -96,7 +96,8 @@ texttowcs(const text *txt)
 		pg_verifymbstr(workstr, nbytes, false);
 		ereport(ERROR,
 				(errcode(ERRCODE_CHARACTER_NOT_IN_REPERTOIRE),
-				 errmsg("invalid multibyte character for locale")));
+				 errmsg("invalid multibyte character for locale"),
+				 errhint("The server's LC_CTYPE locale is probably incompatible with the database encoding.")));
 	}
 
 	Assert(ncodes <= (size_t) nbytes);

Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@`
`9`	`9`	`*`
`10`	`10`	`*`
`11`	`11`	`* IDENTIFICATION`
`12`		`- * $PostgreSQL: pgsql/src/backend/utils/adt/oracle_compat.c,v 1.55 2004/08/29 05:06:49 momjian Exp $`
	`12`	`+ * $PostgreSQL: pgsql/src/backend/utils/adt/oracle_compat.c,v 1.56 2004/10/19 15:04:17 tgl Exp $`
`13`	`13`	`*`
`14`	`14`	`*-------------------------------------------------------------------------`
`15`	`15`	`*/`
`@@ -96,7 +96,8 @@ texttowcs(const text *txt)`
`96`	`96`	`pg_verifymbstr(workstr, nbytes, false);`
`97`	`97`	`ereport(ERROR,`
`98`	`98`	`(errcode(ERRCODE_CHARACTER_NOT_IN_REPERTOIRE),`
`99`		`- errmsg("invalid multibyte character for locale")));`
	`99`	`+ errmsg("invalid multibyte character for locale"),`
	`100`	`+ errhint("The server's LC_CTYPE locale is probably incompatible with the database encoding.")));`
`100`	`101`	`}`
`101`	`102`
`102`	`103`	`Assert(ncodes <= (size_t) nbytes);`