-
+
<productname>PostgreSQL</productname> Error Codes
INVALID ESCAPE SEQUENCE
+|
+22P06
+NONSTANDARD USE OF ESCAPE CHARACTER
+
+
|
22010
INVALID INDICATOR PARAMETER VALUE
Kerberos service name to use when authenticating with Kerberos 4 or 5.
This must match the service name specified in the server
configuration for Kerberos authentication to succeed. (See also
- .)
+ .)
is_superuser,
session_authorization,
DateStyle,
-TimeZone, and
-integer_datetimes.
+TimeZone,
+integer_datetimes, and
+standard_compliant_strings.
(server_encoding, TimeZone, and
-integer_datetimes were not reported by releases before 8.0.)
+integer_datetimes were not reported by releases before 8.0;
+standard_compliant_strings was not reported by releases
+before 8.1.)
Note that
server_version,
server_encoding and
in a numeric form that is much easier to compare against.
+If no value for standard_compliant_strings is reported,
+applications may assume it is false, that is, backslashes
+are treated as escapes in string literals. Also, the presence of this
+parameter may be taken as an indication that the escape string syntax
+(E'...') is accepted.
+
+
Although the returned pointer is declared const, it in fact
points to mutable storage associated with the PGconn structure.
-
+
Frontend/Backend Protocol
is_superuser,
session_authorization,
DateStyle,
- TimeZone, and
- integer_datetimes.
+ TimeZone,
+ integer_datetimes, and
+ standard_compliant_strings.
(server_encoding, TimeZone, and
- integer_datetimes were not reported by releases before 8.0.)
+ integer_datetimes were not reported by releases before 8.0;
+ standard_compliant_strings was not reported by releases
+ before 8.1.)
Note that
server_version,
server_encoding and
When on, a warning is issued if a backslash
- (\) appears in a ordinary, non-escape syntax
- ('') string. To log the statement that generated the
- warning, set log_min_error_statement to
- error. The default is off.
+ (\) appears in an ordinary string literal
+ ('...' syntax). The default is off.
- Escape string syntax (E'') should be used for
+ Escape string syntax (E'...') should be used for
escapes, because in future versions of
PostgreSQL ordinary strings will have
the standard-compliant behavior of treating backslashes
-
- escape_string_syntax (boolean)
-
-
escape_string_syntax configuration parameter-
-
- Reports whether escape string syntax (E'') is
- supported. This variable is used by applications that need to
- determine if escape string syntax can be used in their code.
-
-
-
-
-
+
standard_compliant_strings (boolean)
- Reports whether ordinary, non-escape syntax strings
- ('') treat backslashes literally, as specified in
- the SQL standard. This variable is used by applications that
- need to know how ordinary strings are processed`.
+ Reports whether ordinary string literals
+ ('...') treat backslashes literally, as specified in
+ the SQL standard. The value is currently always false,
+ indicating that backslashes are treated as escapes. It is planned
+ that this will change to true in a future
+
PostgreSQL release when string literal
+ syntax changes to meet the standard. Applications may check this
+ parameter to determine how string literals will be processed.
+ The presence of this parameter can also be taken as an indication
+ that the escape string syntax (E'...') is supported.
PostgreSQL also allows single quotes
to be escaped with a backslash (\'). However,
future versions of
PostgreSQL will not
- support this so applications using this should convert to the
+ allow this, so applications using backslashes should convert to the
standard-compliant method outlined above.
eventually treat backslashes as literal characters to be
standard-compliant. The proper way to specify escape processing is
to use the escape string syntax to indicate that escape
- processing is desired. Escape string syntax is specified by placing
- the the letter E (upper or lower case) before
+ processing is desired. Escape string syntax is specified by writing
+ the letter E (upper or lower case) just before
the string, e.g. E'\041'. This method will work in all
future versions of
PostgreSQL.
* Portions Copyright (c) 1994, Regents of the University of California
*
* IDENTIFICATION
- * $PostgreSQL: pgsql/src/backend/parser/scan.l,v 1.126 2005/06/26 03:03:38 momjian Exp $
+ * $PostgreSQL: pgsql/src/backend/parser/scan.l,v 1.127 2005/06/26 19:16:05 tgl Exp $
*
*-------------------------------------------------------------------------
*/
extern YYSTYPE yylval;
static int xcdepth = 0; /* depth of nesting in slash-star comments */
-static char *dolqstart; /* current $foo$ quote start string */
-static bool warn_on_first_escape;
+static char *dolqstart; /* current $foo$ quote start string */
+
+/*
+ * GUC variable. This is a DIRECT violation of the warning given at the
+ * head of gram.y, ie flex/bison code must not depend on any GUC variables;
+ * as such, changing its value can induce very unintuitive behavior.
+ * But we shall have to live with it as a short-term thing until the switch
+ * to SQL-standard string syntax is complete.
+ */
bool escape_string_warning;
+static bool warn_on_first_escape;
+
/*
* literalbuf is used to accumulate literal values when multiple rules
* are needed to parse a single literal. Call startlit to reset buffer
static void addlit(char *ytext, int yleng);
static void addlitchar(unsigned char ychar);
static char *litbufdup(void);
+static int pg_err_position(void);
static void check_escape_warning(void);
/*
/* National character */
xnstart [nN]{quote}
-/* Quote string does not warn about escapes */
+/* Quoted string that allows backslash escapes */
xestart [eE]{quote}
-xeinside [^']*
/* Extended quote
* xqdouble implements embedded quote, ''''
{
if (warn_on_first_escape && escape_string_warning)
ereport(WARNING,
- (errcode(ERRCODE_INVALID_USE_OF_ESCAPE_CHARACTER),
- errmsg("Invalid use of \\' in a normal string"),
- errhint("Use '' to place quotes in strings, or use the escape string syntax (E'').")));
+ (errcode(ERRCODE_NONSTANDARD_USE_OF_ESCAPE_CHARACTER),
+ errmsg("nonstandard use of \\' in a string literal"),
+ errhint("Use '' to write quotes in strings, or use the escape string syntax (E'...')."),
+ errposition(pg_err_position())));
+ warn_on_first_escape = false; /* warn only once per string */
}
else if (yytext[1] == '\\')
{
if (warn_on_first_escape && escape_string_warning)
ereport(WARNING,
- (errcode(ERRCODE_INVALID_USE_OF_ESCAPE_CHARACTER),
- errmsg("Invalid use of \\\\ in a normal string"),
- errhint("Use the escape string syntax for backslashes, e.g. E'\\\\'.")));
+ (errcode(ERRCODE_NONSTANDARD_USE_OF_ESCAPE_CHARACTER),
+ errmsg("nonstandard use of \\\\ in a string literal"),
+ errhint("Use the escape string syntax for backslashes, e.g., E'\\\\'."),
+ errposition(pg_err_position())));
+ warn_on_first_escape = false; /* warn only once per string */
}
else
check_escape_warning();
%%
-void
-yyerror(const char *message)
+static int
+pg_err_position(void)
{
const char *loc = token_start ? token_start : yytext;
- int cursorpos;
/* in multibyte encodings, return index in characters not bytes */
- cursorpos = pg_mbstrlen_with_len(scanbuf, loc - scanbuf) + 1;
+ return pg_mbstrlen_with_len(scanbuf, loc - scanbuf) + 1;
+}
+
+void
+yyerror(const char *message)
+{
+ const char *loc = token_start ? token_start : yytext;
+ int cursorpos = pg_err_position();
if (*loc == YY_END_OF_BUFFER_CHAR)
{
{
if (warn_on_first_escape && escape_string_warning)
ereport(WARNING,
- (errcode(ERRCODE_INVALID_USE_OF_ESCAPE_CHARACTER),
- errmsg("Invalid use of escapes in an ordinary string"),
- errhint("Use the escape string syntax for escapes, e.g. E'\\r\\n'.")));
+ (errcode(ERRCODE_NONSTANDARD_USE_OF_ESCAPE_CHARACTER),
+ errmsg("nonstandard use of escape in a string literal"),
+ errhint("Use the escape string syntax for escapes, e.g., E'\\r\\n'."),
+ errposition(pg_err_position())));
warn_on_first_escape = false; /* warn only once per string */
}
* Written by Peter Eisentraut
. *
* IDENTIFICATION
- * $PostgreSQL: pgsql/src/backend/utils/misc/guc.c,v 1.269 2005/06/26 03:03:41 momjian Exp $
+ * $PostgreSQL: pgsql/src/backend/utils/misc/guc.c,v 1.270 2005/06/26 19:16:06 tgl Exp $
*
*--------------------------------------------------------------------
*/
static int max_identifier_length;
static int block_size;
static bool integer_datetimes;
-static bool escape_string_syntax;
static bool standard_compliant_strings;
/* should be static, but commands/variable.c needs to get at it */
{
{"escape_string_warning", PGC_USERSET, COMPAT_OPTIONS_PREVIOUS,
- gettext_noop("Warn about backslash escapes in ordinary, non-escape-syntax strings."),
+ gettext_noop("Warn about backslash escapes in ordinary string literals."),
NULL
},
&escape_string_warning,
false, NULL, NULL
},
- {
- {"escape_string_syntax", PGC_INTERNAL, PRESET_OPTIONS,
- gettext_noop("Escape string syntax (E'') is supported."),
- NULL,
- GUC_REPORT | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
- },
- &escape_string_syntax,
- true, NULL, NULL
- },
-
{
{"standard_compliant_strings", PGC_INTERNAL, PRESET_OPTIONS,
- gettext_noop("'' strings treat backslashes literally."),
+ gettext_noop("'...' strings treat backslashes literally."),
NULL,
GUC_REPORT | GUC_NOT_IN_SAMPLE | GUC_DISALLOW_IN_FILE
},
* Portions Copyright (c) 1994, Regents of the University of California
*
* IDENTIFICATION
- * $PostgreSQL: pgsql/src/bin/psql/psqlscan.l,v 1.14 2005/06/02 17:45:19 tgl Exp $
+ * $PostgreSQL: pgsql/src/bin/psql/psqlscan.l,v 1.15 2005/06/26 19:16:06 tgl Exp $
*
*-------------------------------------------------------------------------
*/
xbstart [bB]{quote}
xbinside [^']*
-/* Hexadecimal number
- */
+/* Hexadecimal number */
xhstart [xX]{quote}
xhinside [^']*
-/* National character
- */
+/* National character */
xnstart [nN]{quote}
+/* Quoted string that allows backslash escapes */
+xestart [eE]{quote}
+
/* Extended quote
- * xqdouble implements embedded quote
+ * xqdouble implements embedded quote, ''''
*/
xqstart {quote}
xqdouble {quote}{quote}
BEGIN(xq);
ECHO;
}
+{xestart} {
+ BEGIN(xq);
+ ECHO;
+ }
{quotestop} |
{quotefail} {
yyless(1);
*
* Copyright (c) 2003-2005, PostgreSQL Global Development Group
*
- * $PostgreSQL: pgsql/src/include/utils/errcodes.h,v 1.17 2005/01/01 20:44:30 tgl Exp $
+ * $PostgreSQL: pgsql/src/include/utils/errcodes.h,v 1.18 2005/06/26 19:16:06 tgl Exp $
*
*-------------------------------------------------------------------------
*/
#define ERRCODE_INVALID_ESCAPE_CHARACTER MAKE_SQLSTATE('2','2', '0','1','9')
#define ERRCODE_INVALID_ESCAPE_OCTET MAKE_SQLSTATE('2','2', '0','0','D')
#define ERRCODE_INVALID_ESCAPE_SEQUENCE MAKE_SQLSTATE('2','2', '0','2','5')
+#define ERRCODE_NONSTANDARD_USE_OF_ESCAPE_CHARACTER MAKE_SQLSTATE('2','2', 'P','0','6')
#define ERRCODE_INVALID_INDICATOR_PARAMETER_VALUE MAKE_SQLSTATE('2','2', '0','1','0')
#define ERRCODE_INVALID_LIMIT_VALUE MAKE_SQLSTATE('2','2', '0','2','0')
#define ERRCODE_INVALID_PARAMETER_VALUE MAKE_SQLSTATE('2','2', '0','2','3')
* procedural language
*
* IDENTIFICATION
- * $PostgreSQL: pgsql/src/pl/plpgsql/src/scan.l,v 1.41 2005/06/22 01:35:02 neilc Exp $
+ * $PostgreSQL: pgsql/src/pl/plpgsql/src/scan.l,v 1.42 2005/06/26 19:16:07 tgl Exp $
*
* This software is copyrighted by Jan Wieck - Hamburg.
*
start_charpos = yytext;
BEGIN(IN_STRING);
}
+[eE]' {
+ /* for now, treat the same as a regular literal */
+ start_lineno = plpgsql_scanner_lineno();
+ start_charpos = yytext;
+ BEGIN(IN_STRING);
+ }
\\. { }
\\ { /* can only happen with \ at EOF */ }
'' { }
memcpy(result, yytext + dolqlen, len);
result[len] = '\0';
}
+ else if (*yytext == 'E' || *yytext == 'e')
+ {
+ /* Token is an E'...' string */
+ result = (char *) palloc(yyleng + 1); /* more than enough room */
+ len = 0;
+ for (cp = yytext + 2; *cp; cp++)
+ {
+ if (*cp == '\'')
+ {
+ if (cp[1] == '\'')
+ result[len++] = *cp++;
+ /* else it must be string end quote */
+ }
+ else if (*cp == '\\')
+ {
+ if (cp[1] != '\0') /* just a paranoid check */
+ result[len++] = *(++cp);
+ }
+ else
+ result[len++] = *cp;
+ }
+ result[len] = '\0';
+ }
else
{
/* Token is a '...' string */
result = (char *) palloc(yyleng + 1); /* more than enough room */
len = 0;
- for (cp = yytext; *cp; cp++)
+ for (cp = yytext + 1; *cp; cp++)
{
if (*cp == '\'')
{
if (cp[1] == '\'')
result[len++] = *cp++;
- /* else it must be string start or end quote */
+ /* else it must be string end quote */
}
else if (*cp == '\\')
{
projects / postgresql.git / commitdiff