blob: 129686ad575ad9499e7f38beb1b0b05186a1d8cb [file] [log] [blame]
drh348784e2000-05-29 20:41:49 +00001/*
drhb19a2bc2001-09-16 00:13:26 +00002** 2001 September 15
drh348784e2000-05-29 20:41:49 +00003**
drhb19a2bc2001-09-16 00:13:26 +00004** The author disclaims copyright to this source code. In place of
5** a legal notice, here is a blessing:
drh348784e2000-05-29 20:41:49 +00006**
drhb19a2bc2001-09-16 00:13:26 +00007** May you do good and not evil.
8** May you find forgiveness for yourself and forgive others.
9** May you share freely, never taking more than you give.
drh348784e2000-05-29 20:41:49 +000010**
11*************************************************************************
12** This file contains SQLite's grammar for SQL. Process this file
13** using the lemon parser generator to generate C code that runs
14** the parser. Lemon will also generate a header file containing
15** numeric codes for all of the tokens.
drh348784e2000-05-29 20:41:49 +000016*/
drh487e2622005-06-25 18:42:14 +000017
18// All token codes are small integers with #defines that begin with "TK_"
drh348784e2000-05-29 20:41:49 +000019%token_prefix TK_
drh487e2622005-06-25 18:42:14 +000020
21// The type of the data attached to each token is Token. This is also the
22// default type for non-terminals.
23//
drh348784e2000-05-29 20:41:49 +000024%token_type {Token}
drhf57b14a2001-09-14 18:54:08 +000025%default_type {Token}
drh487e2622005-06-25 18:42:14 +000026
27// The generated parser function takes a 4th argument as follows:
drh348784e2000-05-29 20:41:49 +000028%extra_argument {Parse *pParse}
drh487e2622005-06-25 18:42:14 +000029
30// This code runs whenever there is a syntax error
31//
drh348784e2000-05-29 20:41:49 +000032%syntax_error {
drh128255f2008-12-08 16:01:12 +000033 UNUSED_PARAMETER(yymajor); /* Silence some compiler warnings */
drh4b2f9362008-01-22 23:37:09 +000034 assert( TOKEN.z[0] ); /* The tokenizer always gives us a token */
35 sqlite3ErrorMsg(pParse, "near \"%T\": syntax error", &TOKEN);
drh348784e2000-05-29 20:41:49 +000036}
drh8fc33452006-02-27 21:58:07 +000037%stack_overflow {
38 sqlite3ErrorMsg(pParse, "parser stack overflow");
39}
drh487e2622005-06-25 18:42:14 +000040
41// The name of the generated procedure that implements the parser
42// is as follows:
danielk19774adee202004-05-08 08:23:19 +000043%name sqlite3Parser
drh487e2622005-06-25 18:42:14 +000044
45// The following text is included near the beginning of the C source
46// code file that implements the parser.
47//
drh348784e2000-05-29 20:41:49 +000048%include {
49#include "sqliteInt.h"
drh9bbca4c2001-11-06 04:00:18 +000050
51/*
drhd3ec02d2009-06-12 02:27:14 +000052** Disable all error recovery processing in the parser push-down
53** automaton.
54*/
55#define YYNOERRORRECOVERY 1
56
57/*
drh8a415d32009-06-12 13:53:51 +000058** Make yytestcase() the same as testcase()
59*/
60#define yytestcase(X) testcase(X)
61
62/*
drh82415f22015-11-09 19:33:42 +000063** Indicate that sqlite3ParserFree() will never be called with a null
64** pointer.
65*/
drh644f4c12015-11-12 15:04:05 +000066#define YYPARSEFREENEVERNULL 1
drh82415f22015-11-09 19:33:42 +000067
68/*
drhd26cc542017-01-28 20:46:37 +000069** In the amalgamation, the parse.c file generated by lemon and the
70** tokenize.c file are concatenated. In that case, sqlite3RunParser()
71** has access to the the size of the yyParser object and so the parser
72** engine can be allocated from stack. In that case, only the
73** sqlite3ParserInit() and sqlite3ParserFinalize() routines are invoked
74** and the sqlite3ParserAlloc() and sqlite3ParserFree() routines can be
75** omitted.
76*/
77#ifdef SQLITE_AMALGAMATION
78# define sqlite3Parser_ENGINEALWAYSONSTACK 1
79#endif
80
81/*
drh82415f22015-11-09 19:33:42 +000082** Alternative datatype for the argument to the malloc() routine passed
83** into sqlite3ParserAlloc(). The default is size_t.
84*/
85#define YYMALLOCARGTYPE u64
86
87/*
drhad3cab52002-05-24 02:04:32 +000088** An instance of this structure holds information about the
89** LIMIT clause of a SELECT statement.
drh9bbca4c2001-11-06 04:00:18 +000090*/
drhad3cab52002-05-24 02:04:32 +000091struct LimitVal {
danielk1977a2dc3b12005-02-05 12:48:48 +000092 Expr *pLimit; /* The LIMIT expression. NULL if there is no limit */
93 Expr *pOffset; /* The OFFSET expression. NULL if there is none */
drhad3cab52002-05-24 02:04:32 +000094};
danielk1977c3f9bad2002-05-15 08:30:12 +000095
96/*
drhad3cab52002-05-24 02:04:32 +000097** An instance of the following structure describes the event of a
98** TRIGGER. "a" is the event type, one of TK_UPDATE, TK_INSERT,
99** TK_DELETE, or TK_INSTEAD. If the event is of the form
100**
101** UPDATE ON (a,b,c)
102**
103** Then the "b" IdList records the list "a,b,c".
danielk1977c3f9bad2002-05-15 08:30:12 +0000104*/
drhad3cab52002-05-24 02:04:32 +0000105struct TrigEvent { int a; IdList * b; };
drhcaec2f12003-01-07 02:47:47 +0000106
drh25d65432004-07-22 15:02:25 +0000107/*
drh4a642b62016-02-05 01:55:27 +0000108** Disable lookaside memory allocation for objects that might be
109** shared across database connections.
110*/
111static void disableLookaside(Parse *pParse){
112 pParse->disableLookaside++;
113 pParse->db->lookaside.bDisable++;
114}
115
drhcaec2f12003-01-07 02:47:47 +0000116} // end %include
drh348784e2000-05-29 20:41:49 +0000117
drh826fb5a2004-02-14 23:59:57 +0000118// Input is a single SQL command
drhc4a3c772001-04-04 11:48:57 +0000119input ::= cmdlist.
drh094b2bb2002-03-13 18:54:07 +0000120cmdlist ::= cmdlist ecmd.
drh826fb5a2004-02-14 23:59:57 +0000121cmdlist ::= ecmd.
drhb7f91642004-10-31 02:22:47 +0000122ecmd ::= SEMI.
123ecmd ::= explain cmdx SEMI.
drh8549d552016-01-07 17:09:43 +0000124explain ::= .
drhb7f91642004-10-31 02:22:47 +0000125%ifndef SQLITE_OMIT_EXPLAIN
drh8549d552016-01-07 17:09:43 +0000126explain ::= EXPLAIN. { pParse->explain = 1; }
127explain ::= EXPLAIN QUERY PLAN. { pParse->explain = 2; }
drh154d4b22006-09-21 11:02:16 +0000128%endif SQLITE_OMIT_EXPLAIN
drh200a81d2008-08-08 14:19:41 +0000129cmdx ::= cmd. { sqlite3FinishCoding(pParse); }
drh348784e2000-05-29 20:41:49 +0000130
drh382c0242001-10-06 16:33:02 +0000131///////////////////// Begin and end transactions. ////////////////////////////
drhc4a3c772001-04-04 11:48:57 +0000132//
drhfa86c412002-02-02 15:01:15 +0000133
drh684917c2004-10-05 02:41:42 +0000134cmd ::= BEGIN transtype(Y) trans_opt. {sqlite3BeginTransaction(pParse, Y);}
drhc4a3c772001-04-04 11:48:57 +0000135trans_opt ::= .
136trans_opt ::= TRANSACTION.
drh5ad1a6c2002-07-01 12:27:09 +0000137trans_opt ::= TRANSACTION nm.
drh684917c2004-10-05 02:41:42 +0000138%type transtype {int}
139transtype(A) ::= . {A = TK_DEFERRED;}
drhcf82f0d2016-02-17 04:33:10 +0000140transtype(A) ::= DEFERRED(X). {A = @X; /*A-overwrites-X*/}
141transtype(A) ::= IMMEDIATE(X). {A = @X; /*A-overwrites-X*/}
142transtype(A) ::= EXCLUSIVE(X). {A = @X; /*A-overwrites-X*/}
drh07a3b112017-07-06 01:28:02 +0000143cmd ::= COMMIT|END(X) trans_opt. {sqlite3EndTransaction(pParse,@X);}
144cmd ::= ROLLBACK(X) trans_opt. {sqlite3EndTransaction(pParse,@X);}
drhc4a3c772001-04-04 11:48:57 +0000145
danielk1977fd7f0452008-12-17 17:30:26 +0000146savepoint_opt ::= SAVEPOINT.
147savepoint_opt ::= .
148cmd ::= SAVEPOINT nm(X). {
149 sqlite3Savepoint(pParse, SAVEPOINT_BEGIN, &X);
150}
151cmd ::= RELEASE savepoint_opt nm(X). {
152 sqlite3Savepoint(pParse, SAVEPOINT_RELEASE, &X);
153}
154cmd ::= ROLLBACK trans_opt TO savepoint_opt nm(X). {
155 sqlite3Savepoint(pParse, SAVEPOINT_ROLLBACK, &X);
156}
157
drh382c0242001-10-06 16:33:02 +0000158///////////////////// The CREATE TABLE statement ////////////////////////////
drh348784e2000-05-29 20:41:49 +0000159//
160cmd ::= create_table create_table_args.
drhd9da78a2009-03-24 15:08:09 +0000161create_table ::= createkw temp(T) TABLE ifnotexists(E) nm(Y) dbnm(Z). {
danielk1977f1a381e2006-06-16 08:01:02 +0000162 sqlite3StartTable(pParse,&Y,&Z,T,0,0,E);
drh969fa7c2002-02-18 18:30:32 +0000163}
drhdabd04c2016-02-17 01:46:19 +0000164createkw(A) ::= CREATE(A). {disableLookaside(pParse);}
165
drhfaa59552005-12-29 23:33:54 +0000166%type ifnotexists {int}
167ifnotexists(A) ::= . {A = 0;}
168ifnotexists(A) ::= IF NOT EXISTS. {A = 1;}
drhf57b3392001-10-08 13:22:32 +0000169%type temp {int}
danielk197753c0f742005-03-29 03:10:59 +0000170%ifndef SQLITE_OMIT_TEMPDB
drhd24cc422003-03-27 12:51:24 +0000171temp(A) ::= TEMP. {A = 1;}
drh154d4b22006-09-21 11:02:16 +0000172%endif SQLITE_OMIT_TEMPDB
drhd24cc422003-03-27 12:51:24 +0000173temp(A) ::= . {A = 0;}
drh5969da42013-10-21 02:14:45 +0000174create_table_args ::= LP columnlist conslist_opt(X) RP(E) table_options(F). {
175 sqlite3EndTable(pParse,&X,&E,F,0);
drh969fa7c2002-02-18 18:30:32 +0000176}
177create_table_args ::= AS select(S). {
drh5969da42013-10-21 02:14:45 +0000178 sqlite3EndTable(pParse,0,0,0,S);
drh633e6d52008-07-28 19:34:53 +0000179 sqlite3SelectDelete(pParse->db, S);
drh969fa7c2002-02-18 18:30:32 +0000180}
drh3334d082015-11-10 13:45:21 +0000181%type table_options {int}
drh5969da42013-10-21 02:14:45 +0000182table_options(A) ::= . {A = 0;}
183table_options(A) ::= WITHOUT nm(X). {
184 if( X.n==5 && sqlite3_strnicmp(X.z,"rowid",5)==0 ){
drhfccda8a2015-05-27 13:06:55 +0000185 A = TF_WithoutRowid | TF_NoVisibleRowid;
drh5969da42013-10-21 02:14:45 +0000186 }else{
187 A = 0;
188 sqlite3ErrorMsg(pParse, "unknown table option: %.*s", X.n, X.z);
189 }
190}
drh986dde72016-02-29 13:37:21 +0000191columnlist ::= columnlist COMMA columnname carglist.
192columnlist ::= columnname carglist.
drh2881ab62016-02-27 23:25:36 +0000193columnname(A) ::= nm(A) typetoken(Y). {sqlite3AddColumn(pParse,&A,&Y);}
drhc4a3c772001-04-04 11:48:57 +0000194
drh31d6fd52017-04-14 19:03:10 +0000195// The following directive causes tokens ABORT, AFTER, ASC, etc. to
196// fallback to ID if they will not parse as their original value.
197// This obviates the need for the "id" nonterminal.
198//
199%fallback ID
200 ABORT ACTION AFTER ANALYZE ASC ATTACH BEFORE BEGIN BY CASCADE CAST COLUMNKW
201 CONFLICT DATABASE DEFERRED DESC DETACH EACH END EXCLUSIVE EXPLAIN FAIL FOR
202 IGNORE IMMEDIATE INITIALLY INSTEAD LIKE_KW MATCH NO PLAN
203 QUERY KEY OF OFFSET PRAGMA RAISE RECURSIVE RELEASE REPLACE RESTRICT ROW
204 ROLLBACK SAVEPOINT TEMP TRIGGER VACUUM VIEW VIRTUAL WITH WITHOUT
205%ifdef SQLITE_OMIT_COMPOUND_SELECT
206 EXCEPT INTERSECT UNION
207%endif SQLITE_OMIT_COMPOUND_SELECT
208 REINDEX RENAME CTIME_KW IF
209 .
210%wildcard ANY.
211
drhf7b54962013-05-28 12:11:54 +0000212// Define operator precedence early so that this is the first occurrence
drh2d3917d2004-02-22 16:27:00 +0000213// of the operator tokens in the grammer. Keeping the operators together
214// causes them to be assigned integer values that are close together,
215// which keeps parser tables smaller.
216//
drhf2bc0132004-10-04 13:19:23 +0000217// The token values assigned to these symbols is determined by the order
218// in which lemon first sees them. It must be the case that ISNULL/NOTNULL,
219// NE/EQ, GT/LE, and GE/LT are separated by only a single value. See
220// the sqlite3ExprIfFalse() routine for additional information on this
221// constraint.
222//
drh2d3917d2004-02-22 16:27:00 +0000223%left OR.
224%left AND.
225%right NOT.
drh03bea702006-06-13 15:37:26 +0000226%left IS MATCH LIKE_KW BETWEEN IN ISNULL NOTNULL NE EQ.
drh9a432672004-10-04 13:38:09 +0000227%left GT LE LT GE.
danielk19777c6303c2004-11-17 16:41:29 +0000228%right ESCAPE.
drh2d3917d2004-02-22 16:27:00 +0000229%left BITAND BITOR LSHIFT RSHIFT.
230%left PLUS MINUS.
231%left STAR SLASH REM.
drha34001c2007-02-02 12:44:37 +0000232%left CONCAT.
233%left COLLATE.
drh7ba5bc52009-09-22 20:08:34 +0000234%right BITNOT.
drh2d3917d2004-02-22 16:27:00 +0000235
drh7cc84c22016-04-11 13:36:42 +0000236// An IDENTIFIER can be a generic identifier, or one of several
237// keywords. Any non-standard keyword can also be an identifier.
238//
239%token_class id ID|INDEXED.
240
drh7cc84c22016-04-11 13:36:42 +0000241
drhc4a3c772001-04-04 11:48:57 +0000242// And "ids" is an identifer-or-string.
243//
drhf59b12f2014-01-11 03:54:05 +0000244%token_class ids ID|STRING.
drhc4a3c772001-04-04 11:48:57 +0000245
drh5ad1a6c2002-07-01 12:27:09 +0000246// The name of a column or table can be any of the following:
247//
248%type nm {Token}
drh4dd0d3f2016-02-17 01:18:33 +0000249nm(A) ::= id(A).
250nm(A) ::= STRING(A).
251nm(A) ::= JOIN_KW(A).
drh5ad1a6c2002-07-01 12:27:09 +0000252
drh986dde72016-02-29 13:37:21 +0000253// A typetoken is really zero or more tokens that form a type name such
drh487e2622005-06-25 18:42:14 +0000254// as can be found after the column name in a CREATE TABLE statement.
255// Multiple tokens are concatenated to form the value of the typetoken.
256//
257%type typetoken {Token}
drh986dde72016-02-29 13:37:21 +0000258typetoken(A) ::= . {A.n = 0; A.z = 0;}
drh4dd0d3f2016-02-17 01:18:33 +0000259typetoken(A) ::= typename(A).
260typetoken(A) ::= typename(A) LP signed RP(Y). {
261 A.n = (int)(&Y.z[Y.n] - A.z);
drh487e2622005-06-25 18:42:14 +0000262}
drh4dd0d3f2016-02-17 01:18:33 +0000263typetoken(A) ::= typename(A) LP signed COMMA signed RP(Y). {
264 A.n = (int)(&Y.z[Y.n] - A.z);
drh487e2622005-06-25 18:42:14 +0000265}
drh382c0242001-10-06 16:33:02 +0000266%type typename {Token}
drh4dd0d3f2016-02-17 01:18:33 +0000267typename(A) ::= ids(A).
268typename(A) ::= typename(A) ids(Y). {A.n=Y.n+(int)(Y.z-A.z);}
drh60218d22007-04-06 11:26:00 +0000269signed ::= plus_num.
270signed ::= minus_num.
drh487e2622005-06-25 18:42:14 +0000271
272// "carglist" is a list of additional constraints that come after the
273// column name and column type in a CREATE TABLE statement.
274//
drh4dc330d2012-05-07 19:21:36 +0000275carglist ::= carglist ccons.
drh348784e2000-05-29 20:41:49 +0000276carglist ::= .
drh4dc330d2012-05-07 19:21:36 +0000277ccons ::= CONSTRAINT nm(X). {pParse->constraintName = X;}
drhb7916a72009-05-27 10:31:29 +0000278ccons ::= DEFAULT term(X). {sqlite3AddDefaultValue(pParse,&X);}
279ccons ::= DEFAULT LP expr(X) RP. {sqlite3AddDefaultValue(pParse,&X);}
280ccons ::= DEFAULT PLUS term(X). {sqlite3AddDefaultValue(pParse,&X);}
danielk1977f96a3772008-10-23 05:45:07 +0000281ccons ::= DEFAULT MINUS(A) term(X). {
drhb7916a72009-05-27 10:31:29 +0000282 ExprSpan v;
drhabfd35e2016-12-06 22:47:23 +0000283 v.pExpr = sqlite3PExpr(pParse, TK_UMINUS, X.pExpr, 0);
drhb7916a72009-05-27 10:31:29 +0000284 v.zStart = A.z;
285 v.zEnd = X.zEnd;
286 sqlite3AddDefaultValue(pParse,&v);
danielk19777977a172004-11-09 12:44:37 +0000287}
drh2b7acc32006-12-20 02:15:00 +0000288ccons ::= DEFAULT id(X). {
drhb7916a72009-05-27 10:31:29 +0000289 ExprSpan v;
drh43303de2016-02-17 12:34:03 +0000290 spanExpr(&v, pParse, TK_STRING, X);
drhb7916a72009-05-27 10:31:29 +0000291 sqlite3AddDefaultValue(pParse,&v);
danielk19777977a172004-11-09 12:44:37 +0000292}
drh348784e2000-05-29 20:41:49 +0000293
drh382c0242001-10-06 16:33:02 +0000294// In addition to the type name, we also care about the primary key and
295// UNIQUE constraints.
drh348784e2000-05-29 20:41:49 +0000296//
drh0d316a42002-08-11 20:10:47 +0000297ccons ::= NULL onconf.
drhb7916a72009-05-27 10:31:29 +0000298ccons ::= NOT NULL onconf(R). {sqlite3AddNotNull(pParse, R);}
drhfdd6e852005-12-16 01:06:16 +0000299ccons ::= PRIMARY KEY sortorder(Z) onconf(R) autoinc(I).
drhb7916a72009-05-27 10:31:29 +0000300 {sqlite3AddPrimaryKey(pParse,0,R,I,Z);}
drh62340f82016-05-31 21:18:15 +0000301ccons ::= UNIQUE onconf(R). {sqlite3CreateIndex(pParse,0,0,0,0,R,0,0,0,0,
302 SQLITE_IDXTYPE_UNIQUE);}
drhb7916a72009-05-27 10:31:29 +0000303ccons ::= CHECK LP expr(X) RP. {sqlite3AddCheckConstraint(pParse,X.pExpr);}
drh108aa002015-08-24 20:21:20 +0000304ccons ::= REFERENCES nm(T) eidlist_opt(TA) refargs(R).
drhb7916a72009-05-27 10:31:29 +0000305 {sqlite3CreateForeignKey(pParse,0,&T,TA,R);}
306ccons ::= defer_subclause(D). {sqlite3DeferForeignKey(pParse,D);}
307ccons ::= COLLATE ids(C). {sqlite3AddCollateType(pParse, &C);}
drh04738cb2002-06-02 18:19:00 +0000308
drh205f48e2004-11-05 00:43:11 +0000309// The optional AUTOINCREMENT keyword
310%type autoinc {int}
drh2958a4e2004-11-12 03:56:15 +0000311autoinc(X) ::= . {X = 0;}
312autoinc(X) ::= AUTOINCR. {X = 1;}
drh205f48e2004-11-05 00:43:11 +0000313
drhc2eef3b2002-08-31 18:53:06 +0000314// The next group of rules parses the arguments to a REFERENCES clause
315// that determine if the referential integrity checking is deferred or
316// or immediate and which determine what action to take if a ref-integ
317// check fails.
drh04738cb2002-06-02 18:19:00 +0000318//
drhc2eef3b2002-08-31 18:53:06 +0000319%type refargs {int}
drhfcf486c2009-10-21 13:48:24 +0000320refargs(A) ::= . { A = OE_None*0x0101; /* EV: R-19803-45884 */}
drh4dd0d3f2016-02-17 01:18:33 +0000321refargs(A) ::= refargs(A) refarg(Y). { A = (A & ~Y.mask) | Y.value; }
drhc2eef3b2002-08-31 18:53:06 +0000322%type refarg {struct {int value; int mask;}}
323refarg(A) ::= MATCH nm. { A.value = 0; A.mask = 0x000000; }
drhc29c5aa12009-12-09 21:43:36 +0000324refarg(A) ::= ON INSERT refact. { A.value = 0; A.mask = 0x000000; }
drhc2eef3b2002-08-31 18:53:06 +0000325refarg(A) ::= ON DELETE refact(X). { A.value = X; A.mask = 0x0000ff; }
326refarg(A) ::= ON UPDATE refact(X). { A.value = X<<8; A.mask = 0x00ff00; }
drhc2eef3b2002-08-31 18:53:06 +0000327%type refact {int}
drhfcf486c2009-10-21 13:48:24 +0000328refact(A) ::= SET NULL. { A = OE_SetNull; /* EV: R-33326-45252 */}
329refact(A) ::= SET DEFAULT. { A = OE_SetDflt; /* EV: R-33326-45252 */}
330refact(A) ::= CASCADE. { A = OE_Cascade; /* EV: R-33326-45252 */}
331refact(A) ::= RESTRICT. { A = OE_Restrict; /* EV: R-33326-45252 */}
332refact(A) ::= NO ACTION. { A = OE_None; /* EV: R-33326-45252 */}
drhc2eef3b2002-08-31 18:53:06 +0000333%type defer_subclause {int}
dan1da40a32009-09-19 17:00:31 +0000334defer_subclause(A) ::= NOT DEFERRABLE init_deferred_pred_opt. {A = 0;}
drhc2eef3b2002-08-31 18:53:06 +0000335defer_subclause(A) ::= DEFERRABLE init_deferred_pred_opt(X). {A = X;}
336%type init_deferred_pred_opt {int}
337init_deferred_pred_opt(A) ::= . {A = 0;}
338init_deferred_pred_opt(A) ::= INITIALLY DEFERRED. {A = 1;}
339init_deferred_pred_opt(A) ::= INITIALLY IMMEDIATE. {A = 0;}
drh348784e2000-05-29 20:41:49 +0000340
drhaeb281c2012-05-08 11:17:33 +0000341conslist_opt(A) ::= . {A.n = 0; A.z = 0;}
drh4dd0d3f2016-02-17 01:18:33 +0000342conslist_opt(A) ::= COMMA(A) conslist.
drhab35eae2012-05-12 18:29:53 +0000343conslist ::= conslist tconscomma tcons.
344conslist ::= tcons.
345tconscomma ::= COMMA. {pParse->constraintName.n = 0;}
346tconscomma ::= .
347tcons ::= CONSTRAINT nm(X). {pParse->constraintName = X;}
drh108aa002015-08-24 20:21:20 +0000348tcons ::= PRIMARY KEY LP sortlist(X) autoinc(I) RP onconf(R).
drhb7916a72009-05-27 10:31:29 +0000349 {sqlite3AddPrimaryKey(pParse,X,R,I,0);}
drh108aa002015-08-24 20:21:20 +0000350tcons ::= UNIQUE LP sortlist(X) RP onconf(R).
drh62340f82016-05-31 21:18:15 +0000351 {sqlite3CreateIndex(pParse,0,0,0,X,R,0,0,0,0,
352 SQLITE_IDXTYPE_UNIQUE);}
drhb7916a72009-05-27 10:31:29 +0000353tcons ::= CHECK LP expr(E) RP onconf.
354 {sqlite3AddCheckConstraint(pParse,E.pExpr);}
drh108aa002015-08-24 20:21:20 +0000355tcons ::= FOREIGN KEY LP eidlist(FA) RP
356 REFERENCES nm(T) eidlist_opt(TA) refargs(R) defer_subclause_opt(D). {
danielk19774adee202004-05-08 08:23:19 +0000357 sqlite3CreateForeignKey(pParse, FA, &T, TA, R);
358 sqlite3DeferForeignKey(pParse, D);
drhc2eef3b2002-08-31 18:53:06 +0000359}
360%type defer_subclause_opt {int}
361defer_subclause_opt(A) ::= . {A = 0;}
drh4dd0d3f2016-02-17 01:18:33 +0000362defer_subclause_opt(A) ::= defer_subclause(A).
drh9cfcf5d2002-01-29 18:41:24 +0000363
364// The following is a non-standard extension that allows us to declare the
365// default behavior when there is a constraint conflict.
366//
367%type onconf {int}
drh3334d082015-11-10 13:45:21 +0000368%type orconf {int}
drh1c928532002-01-31 15:54:21 +0000369%type resolvetype {int}
drh74ad7fe2004-10-07 03:06:28 +0000370onconf(A) ::= . {A = OE_Default;}
371onconf(A) ::= ON CONFLICT resolvetype(X). {A = X;}
372orconf(A) ::= . {A = OE_Default;}
drh3334d082015-11-10 13:45:21 +0000373orconf(A) ::= OR resolvetype(X). {A = X;}
drh4dd0d3f2016-02-17 01:18:33 +0000374resolvetype(A) ::= raisetype(A).
drh74ad7fe2004-10-07 03:06:28 +0000375resolvetype(A) ::= IGNORE. {A = OE_Ignore;}
376resolvetype(A) ::= REPLACE. {A = OE_Replace;}
drh348784e2000-05-29 20:41:49 +0000377
drh382c0242001-10-06 16:33:02 +0000378////////////////////////// The DROP TABLE /////////////////////////////////////
drh348784e2000-05-29 20:41:49 +0000379//
drha0733842005-12-29 01:11:36 +0000380cmd ::= DROP TABLE ifexists(E) fullname(X). {
381 sqlite3DropTable(pParse, X, 0, E);
danielk1977a8858102004-05-28 12:11:21 +0000382}
drha0733842005-12-29 01:11:36 +0000383%type ifexists {int}
384ifexists(A) ::= IF EXISTS. {A = 1;}
385ifexists(A) ::= . {A = 0;}
drh348784e2000-05-29 20:41:49 +0000386
drha76b5df2002-02-23 02:32:10 +0000387///////////////////// The CREATE VIEW statement /////////////////////////////
388//
drhb7f91642004-10-31 02:22:47 +0000389%ifndef SQLITE_OMIT_VIEW
drh108aa002015-08-24 20:21:20 +0000390cmd ::= createkw(X) temp(T) VIEW ifnotexists(E) nm(Y) dbnm(Z) eidlist_opt(C)
drh8981b902015-08-24 17:42:49 +0000391 AS select(S). {
392 sqlite3CreateView(pParse, &X, &Y, &Z, C, S, T, E);
drha76b5df2002-02-23 02:32:10 +0000393}
drha0733842005-12-29 01:11:36 +0000394cmd ::= DROP VIEW ifexists(E) fullname(X). {
395 sqlite3DropTable(pParse, X, 1, E);
drha76b5df2002-02-23 02:32:10 +0000396}
drh154d4b22006-09-21 11:02:16 +0000397%endif SQLITE_OMIT_VIEW
drha76b5df2002-02-23 02:32:10 +0000398
drh382c0242001-10-06 16:33:02 +0000399//////////////////////// The SELECT statement /////////////////////////////////
drh348784e2000-05-29 20:41:49 +0000400//
dan7d562db2014-01-11 19:19:36 +0000401cmd ::= select(X). {
drhedf83d12014-01-22 18:31:27 +0000402 SelectDest dest = {SRT_Output, 0, 0, 0, 0, 0};
drh7d10d5a2008-08-20 16:35:10 +0000403 sqlite3Select(pParse, X, &dest);
drh633e6d52008-07-28 19:34:53 +0000404 sqlite3SelectDelete(pParse->db, X);
drh9bb61fe2000-06-05 16:01:39 +0000405}
drhefb72512000-05-31 20:00:52 +0000406
drh9bb61fe2000-06-05 16:01:39 +0000407%type select {Select*}
drh633e6d52008-07-28 19:34:53 +0000408%destructor select {sqlite3SelectDelete(pParse->db, $$);}
dan7d562db2014-01-11 19:19:36 +0000409%type selectnowith {Select*}
410%destructor selectnowith {sqlite3SelectDelete(pParse->db, $$);}
drh82c3d632000-06-06 21:56:07 +0000411%type oneselect {Select*}
drh633e6d52008-07-28 19:34:53 +0000412%destructor oneselect {sqlite3SelectDelete(pParse->db, $$);}
drh9bb61fe2000-06-05 16:01:39 +0000413
drh772460f2015-04-16 14:13:12 +0000414%include {
415 /*
416 ** For a compound SELECT statement, make sure p->pPrior->pNext==p for
417 ** all elements in the list. And make sure list length does not exceed
418 ** SQLITE_LIMIT_COMPOUND_SELECT.
419 */
drhe318a7f2015-04-16 23:04:17 +0000420 static void parserDoubleLinkSelect(Parse *pParse, Select *p){
drhd227a292014-02-09 18:02:09 +0000421 if( p->pPrior ){
drh772460f2015-04-16 14:13:12 +0000422 Select *pNext = 0, *pLoop;
423 int mxSelect, cnt = 0;
drhd227a292014-02-09 18:02:09 +0000424 for(pLoop=p; pLoop; pNext=pLoop, pLoop=pLoop->pPrior, cnt++){
425 pLoop->pNext = pNext;
426 pLoop->selFlags |= SF_Compound;
427 }
drh772460f2015-04-16 14:13:12 +0000428 if( (p->selFlags & SF_MultiValue)==0 &&
429 (mxSelect = pParse->db->aLimit[SQLITE_LIMIT_COMPOUND_SELECT])>0 &&
430 cnt>mxSelect
drha0c01762015-01-05 16:27:43 +0000431 ){
drhd227a292014-02-09 18:02:09 +0000432 sqlite3ErrorMsg(pParse, "too many terms in compound SELECT");
433 }
434 }
drh772460f2015-04-16 14:13:12 +0000435 }
436}
437
438select(A) ::= with(W) selectnowith(X). {
439 Select *p = X;
440 if( p ){
441 p->pWith = W;
442 parserDoubleLinkSelect(pParse, p);
dana9f5c132014-01-13 16:36:40 +0000443 }else{
444 sqlite3WithDelete(pParse->db, W);
445 }
drhcf82f0d2016-02-17 04:33:10 +0000446 A = p; /*A-overwrites-W*/
dana9f5c132014-01-13 16:36:40 +0000447}
dan7d562db2014-01-11 19:19:36 +0000448
drh4dd0d3f2016-02-17 01:18:33 +0000449selectnowith(A) ::= oneselect(A).
drhb7f91642004-10-31 02:22:47 +0000450%ifndef SQLITE_OMIT_COMPOUND_SELECT
drh4dd0d3f2016-02-17 01:18:33 +0000451selectnowith(A) ::= selectnowith(A) multiselect_op(Y) oneselect(Z). {
drhc0bf4932014-02-19 01:31:02 +0000452 Select *pRhs = Z;
drh4dd0d3f2016-02-17 01:18:33 +0000453 Select *pLhs = A;
drhc0bf4932014-02-19 01:31:02 +0000454 if( pRhs && pRhs->pPrior ){
455 SrcList *pFrom;
456 Token x;
457 x.n = 0;
drh772460f2015-04-16 14:13:12 +0000458 parserDoubleLinkSelect(pParse, pRhs);
drhc0bf4932014-02-19 01:31:02 +0000459 pFrom = sqlite3SrcListAppendFromTerm(pParse,0,0,0,&x,pRhs,0,0);
460 pRhs = sqlite3SelectNew(pParse,0,pFrom,0,0,0,0,0,0,0);
461 }
462 if( pRhs ){
463 pRhs->op = (u8)Y;
drh00d5ab72015-05-20 00:15:27 +0000464 pRhs->pPrior = pLhs;
465 if( ALWAYS(pLhs) ) pLhs->selFlags &= ~SF_MultiValue;
drh772460f2015-04-16 14:13:12 +0000466 pRhs->selFlags &= ~SF_MultiValue;
drhd58d3272013-08-05 22:05:02 +0000467 if( Y!=TK_ALL ) pParse->hasCompound = 1;
drh43b78822007-06-15 17:03:14 +0000468 }else{
drh00d5ab72015-05-20 00:15:27 +0000469 sqlite3SelectDelete(pParse->db, pLhs);
drhdaffd0e2001-04-11 14:28:42 +0000470 }
drhc0bf4932014-02-19 01:31:02 +0000471 A = pRhs;
drh82c3d632000-06-06 21:56:07 +0000472}
drh0a36c572002-02-18 22:49:59 +0000473%type multiselect_op {int}
drhcf82f0d2016-02-17 04:33:10 +0000474multiselect_op(A) ::= UNION(OP). {A = @OP; /*A-overwrites-OP*/}
drhfd405312005-11-06 04:06:59 +0000475multiselect_op(A) ::= UNION ALL. {A = TK_ALL;}
drhcf82f0d2016-02-17 04:33:10 +0000476multiselect_op(A) ::= EXCEPT|INTERSECT(OP). {A = @OP; /*A-overwrites-OP*/}
drh154d4b22006-09-21 11:02:16 +0000477%endif SQLITE_OMIT_COMPOUND_SELECT
drhabd4c722014-09-20 18:18:33 +0000478oneselect(A) ::= SELECT(S) distinct(D) selcollist(W) from(X) where_opt(Y)
drh9bbca4c2001-11-06 04:00:18 +0000479 groupby_opt(P) having_opt(Q) orderby_opt(Z) limit_opt(L). {
drh43303de2016-02-17 12:34:03 +0000480#if SELECTTRACE_ENABLED
481 Token s = S; /*A-overwrites-S*/
482#endif
drh17435752007-08-16 04:30:38 +0000483 A = sqlite3SelectNew(pParse,W,X,Y,P,Q,Z,D,L.pLimit,L.pOffset);
drhabd4c722014-09-20 18:18:33 +0000484#if SELECTTRACE_ENABLED
drheb9b8842014-09-21 00:27:26 +0000485 /* Populate the Select.zSelName[] string that is used to help with
drhabd4c722014-09-20 18:18:33 +0000486 ** query planner debugging, to differentiate between multiple Select
487 ** objects in a complex query.
488 **
489 ** If the SELECT keyword is immediately followed by a C-style comment
490 ** then extract the first few alphanumeric characters from within that
drheb9b8842014-09-21 00:27:26 +0000491 ** comment to be the zSelName value. Otherwise, the label is #N where
drhabd4c722014-09-20 18:18:33 +0000492 ** is an integer that is incremented with each SELECT statement seen.
493 */
494 if( A!=0 ){
drh43303de2016-02-17 12:34:03 +0000495 const char *z = s.z+6;
drhabd4c722014-09-20 18:18:33 +0000496 int i;
drheb9b8842014-09-21 00:27:26 +0000497 sqlite3_snprintf(sizeof(A->zSelName), A->zSelName, "#%d",
drhabd4c722014-09-20 18:18:33 +0000498 ++pParse->nSelect);
499 while( z[0]==' ' ) z++;
500 if( z[0]=='/' && z[1]=='*' ){
501 z += 2;
502 while( z[0]==' ' ) z++;
503 for(i=0; sqlite3Isalnum(z[i]); i++){}
drheb9b8842014-09-21 00:27:26 +0000504 sqlite3_snprintf(sizeof(A->zSelName), A->zSelName, "%.*s", i, z);
drhabd4c722014-09-20 18:18:33 +0000505 }
506 }
507#endif /* SELECTRACE_ENABLED */
drh9bb61fe2000-06-05 16:01:39 +0000508}
drh4dd0d3f2016-02-17 01:18:33 +0000509oneselect(A) ::= values(A).
drh75593d92014-01-10 20:46:55 +0000510
511%type values {Select*}
512%destructor values {sqlite3SelectDelete(pParse->db, $$);}
513values(A) ::= VALUES LP nexprlist(X) RP. {
514 A = sqlite3SelectNew(pParse,X,0,0,0,0,0,SF_Values,0,0);
515}
drh4dd0d3f2016-02-17 01:18:33 +0000516values(A) ::= values(A) COMMA LP exprlist(Y) RP. {
517 Select *pRight, *pLeft = A;
drh772460f2015-04-16 14:13:12 +0000518 pRight = sqlite3SelectNew(pParse,Y,0,0,0,0,0,SF_Values|SF_MultiValue,0,0);
drhf3151f02015-04-16 20:27:09 +0000519 if( ALWAYS(pLeft) ) pLeft->selFlags &= ~SF_MultiValue;
drh75593d92014-01-10 20:46:55 +0000520 if( pRight ){
521 pRight->op = TK_ALL;
drh772460f2015-04-16 14:13:12 +0000522 pRight->pPrior = pLeft;
drh75593d92014-01-10 20:46:55 +0000523 A = pRight;
524 }else{
drh772460f2015-04-16 14:13:12 +0000525 A = pLeft;
drh75593d92014-01-10 20:46:55 +0000526 }
527}
drh9bb61fe2000-06-05 16:01:39 +0000528
529// The "distinct" nonterminal is true (1) if the DISTINCT keyword is
530// present and false (0) if it is not.
531//
drh3334d082015-11-10 13:45:21 +0000532%type distinct {int}
drh832ee3d2012-12-18 19:36:11 +0000533distinct(A) ::= DISTINCT. {A = SF_Distinct;}
drh7cea7f92015-05-29 01:35:19 +0000534distinct(A) ::= ALL. {A = SF_All;}
drhefb72512000-05-31 20:00:52 +0000535distinct(A) ::= . {A = 0;}
drh348784e2000-05-29 20:41:49 +0000536
drh9bb61fe2000-06-05 16:01:39 +0000537// selcollist is a list of expressions that are to become the return
drh7c917d12001-12-16 20:05:05 +0000538// values of the SELECT statement. The "*" in statements like
539// "SELECT * FROM ..." is encoded as a special expression with an
drh1a1d3cd2015-11-19 16:33:31 +0000540// opcode of TK_ASTERISK.
drh9bb61fe2000-06-05 16:01:39 +0000541//
drh348784e2000-05-29 20:41:49 +0000542%type selcollist {ExprList*}
drh633e6d52008-07-28 19:34:53 +0000543%destructor selcollist {sqlite3ExprListDelete(pParse->db, $$);}
drh348784e2000-05-29 20:41:49 +0000544%type sclp {ExprList*}
drh633e6d52008-07-28 19:34:53 +0000545%destructor sclp {sqlite3ExprListDelete(pParse->db, $$);}
drh4dd0d3f2016-02-17 01:18:33 +0000546sclp(A) ::= selcollist(A) COMMA.
drh348784e2000-05-29 20:41:49 +0000547sclp(A) ::= . {A = 0;}
drh4dd0d3f2016-02-17 01:18:33 +0000548selcollist(A) ::= sclp(A) expr(X) as(Y). {
549 A = sqlite3ExprListAppend(pParse, A, X.pExpr);
drhb7916a72009-05-27 10:31:29 +0000550 if( Y.n>0 ) sqlite3ExprListSetName(pParse, A, &Y, 1);
551 sqlite3ExprListSetSpan(pParse,A,&X);
drh01f3f252002-05-24 16:14:15 +0000552}
drh4dd0d3f2016-02-17 01:18:33 +0000553selcollist(A) ::= sclp(A) STAR. {
drh1a1d3cd2015-11-19 16:33:31 +0000554 Expr *p = sqlite3Expr(pParse->db, TK_ASTERISK, 0);
drh4dd0d3f2016-02-17 01:18:33 +0000555 A = sqlite3ExprListAppend(pParse, A, p);
drh7c917d12001-12-16 20:05:05 +0000556}
drh0cd874b2016-09-26 12:38:22 +0000557selcollist(A) ::= sclp(A) nm(X) DOT STAR. {
drhabfd35e2016-12-06 22:47:23 +0000558 Expr *pRight = sqlite3PExpr(pParse, TK_ASTERISK, 0, 0);
559 Expr *pLeft = sqlite3ExprAlloc(pParse->db, TK_ID, &X, 1);
560 Expr *pDot = sqlite3PExpr(pParse, TK_DOT, pLeft, pRight);
drh4dd0d3f2016-02-17 01:18:33 +0000561 A = sqlite3ExprListAppend(pParse,A, pDot);
drh54473222002-04-04 02:10:55 +0000562}
drh01f3f252002-05-24 16:14:15 +0000563
564// An option "AS <id>" phrase that can follow one of the expressions that
565// define the result set, or one of the tables in the FROM clause.
566//
567%type as {Token}
drh74ad7fe2004-10-07 03:06:28 +0000568as(X) ::= AS nm(Y). {X = Y;}
drh4dd0d3f2016-02-17 01:18:33 +0000569as(X) ::= ids(X).
drh986dde72016-02-29 13:37:21 +0000570as(X) ::= . {X.n = 0; X.z = 0;}
drh9bb61fe2000-06-05 16:01:39 +0000571
drh348784e2000-05-29 20:41:49 +0000572
drhad3cab52002-05-24 02:04:32 +0000573%type seltablist {SrcList*}
drh633e6d52008-07-28 19:34:53 +0000574%destructor seltablist {sqlite3SrcListDelete(pParse->db, $$);}
drhad3cab52002-05-24 02:04:32 +0000575%type stl_prefix {SrcList*}
drh633e6d52008-07-28 19:34:53 +0000576%destructor stl_prefix {sqlite3SrcListDelete(pParse->db, $$);}
drhad3cab52002-05-24 02:04:32 +0000577%type from {SrcList*}
drh633e6d52008-07-28 19:34:53 +0000578%destructor from {sqlite3SrcListDelete(pParse->db, $$);}
drh348784e2000-05-29 20:41:49 +0000579
drh01f3f252002-05-24 16:14:15 +0000580// A complete FROM clause.
581//
drh17435752007-08-16 04:30:38 +0000582from(A) ::= . {A = sqlite3DbMallocZero(pParse->db, sizeof(*A));}
drhfbdc7f62008-12-03 23:23:40 +0000583from(A) ::= FROM seltablist(X). {
drh61dfc312006-12-16 16:25:15 +0000584 A = X;
585 sqlite3SrcListShiftJoinType(A);
586}
drh01f3f252002-05-24 16:14:15 +0000587
588// "seltablist" is a "Select Table List" - the content of the FROM clause
589// in a SELECT statement. "stl_prefix" is a prefix of this list.
590//
drh4dd0d3f2016-02-17 01:18:33 +0000591stl_prefix(A) ::= seltablist(A) joinop(Y). {
drh8a48b9c2015-08-19 15:20:00 +0000592 if( ALWAYS(A && A->nSrc>0) ) A->a[A->nSrc-1].fg.jointype = (u8)Y;
drh01f3f252002-05-24 16:14:15 +0000593}
drh348784e2000-05-29 20:41:49 +0000594stl_prefix(A) ::= . {A = 0;}
drh4dd0d3f2016-02-17 01:18:33 +0000595seltablist(A) ::= stl_prefix(A) nm(Y) dbnm(D) as(Z) indexed_opt(I)
drhe9240412012-12-18 13:12:03 +0000596 on_opt(N) using_opt(U). {
drh4dd0d3f2016-02-17 01:18:33 +0000597 A = sqlite3SrcListAppendFromTerm(pParse,A,&Y,&D,&Z,0,N,U);
danielk1977b1c685b2008-10-06 16:18:39 +0000598 sqlite3SrcListIndexedBy(pParse, A, &I);
drhc4a3c772001-04-04 11:48:57 +0000599}
drh4dd0d3f2016-02-17 01:18:33 +0000600seltablist(A) ::= stl_prefix(A) nm(Y) dbnm(D) LP exprlist(E) RP as(Z)
drh01d230c2015-08-19 17:11:37 +0000601 on_opt(N) using_opt(U). {
drh4dd0d3f2016-02-17 01:18:33 +0000602 A = sqlite3SrcListAppendFromTerm(pParse,A,&Y,&D,&Z,0,N,U);
drh01d230c2015-08-19 17:11:37 +0000603 sqlite3SrcListFuncArgs(pParse, A, E);
604}
drh51522cd2005-01-20 13:36:19 +0000605%ifndef SQLITE_OMIT_SUBQUERY
drh4dd0d3f2016-02-17 01:18:33 +0000606 seltablist(A) ::= stl_prefix(A) LP select(S) RP
drh51522cd2005-01-20 13:36:19 +0000607 as(Z) on_opt(N) using_opt(U). {
drh4dd0d3f2016-02-17 01:18:33 +0000608 A = sqlite3SrcListAppendFromTerm(pParse,A,0,0,&Z,S,N,U);
drhd5feede2002-05-08 21:46:14 +0000609 }
drh4dd0d3f2016-02-17 01:18:33 +0000610 seltablist(A) ::= stl_prefix(A) LP seltablist(F) RP
drhfbdc7f62008-12-03 23:23:40 +0000611 as(Z) on_opt(N) using_opt(U). {
drh4dd0d3f2016-02-17 01:18:33 +0000612 if( A==0 && Z.n==0 && N==0 && U==0 ){
drhfbdc7f62008-12-03 23:23:40 +0000613 A = F;
drh832ee3d2012-12-18 19:36:11 +0000614 }else if( F->nSrc==1 ){
drh4dd0d3f2016-02-17 01:18:33 +0000615 A = sqlite3SrcListAppendFromTerm(pParse,A,0,0,&Z,0,N,U);
drh832ee3d2012-12-18 19:36:11 +0000616 if( A ){
617 struct SrcList_item *pNew = &A->a[A->nSrc-1];
618 struct SrcList_item *pOld = F->a;
619 pNew->zName = pOld->zName;
620 pNew->zDatabase = pOld->zDatabase;
drh3c449c62013-04-30 14:06:57 +0000621 pNew->pSelect = pOld->pSelect;
drh832ee3d2012-12-18 19:36:11 +0000622 pOld->zName = pOld->zDatabase = 0;
drh3c449c62013-04-30 14:06:57 +0000623 pOld->pSelect = 0;
drh832ee3d2012-12-18 19:36:11 +0000624 }
625 sqlite3SrcListDelete(pParse->db, F);
drhfbdc7f62008-12-03 23:23:40 +0000626 }else{
627 Select *pSubquery;
628 sqlite3SrcListShiftJoinType(F);
drh832ee3d2012-12-18 19:36:11 +0000629 pSubquery = sqlite3SelectNew(pParse,0,F,0,0,0,0,SF_NestedFrom,0,0);
drh4dd0d3f2016-02-17 01:18:33 +0000630 A = sqlite3SrcListAppendFromTerm(pParse,A,0,0,&Z,pSubquery,N,U);
drhfbdc7f62008-12-03 23:23:40 +0000631 }
632 }
drh154d4b22006-09-21 11:02:16 +0000633%endif SQLITE_OMIT_SUBQUERY
drhb733d032004-01-24 20:18:12 +0000634
drh113088e2003-03-20 01:16:58 +0000635%type dbnm {Token}
636dbnm(A) ::= . {A.z=0; A.n=0;}
637dbnm(A) ::= DOT nm(X). {A = X;}
638
drh74ad7fe2004-10-07 03:06:28 +0000639%type fullname {SrcList*}
drh633e6d52008-07-28 19:34:53 +0000640%destructor fullname {sqlite3SrcListDelete(pParse->db, $$);}
drhcf82f0d2016-02-17 04:33:10 +0000641fullname(A) ::= nm(X) dbnm(Y).
642 {A = sqlite3SrcListAppend(pParse->db,0,&X,&Y); /*A-overwrites-X*/}
drh74ad7fe2004-10-07 03:06:28 +0000643
drh01f3f252002-05-24 16:14:15 +0000644%type joinop {int}
drhfd405312005-11-06 04:06:59 +0000645joinop(X) ::= COMMA|JOIN. { X = JT_INNER; }
drhcf82f0d2016-02-17 04:33:10 +0000646joinop(X) ::= JOIN_KW(A) JOIN.
647 {X = sqlite3JoinType(pParse,&A,0,0); /*X-overwrites-A*/}
648joinop(X) ::= JOIN_KW(A) nm(B) JOIN.
649 {X = sqlite3JoinType(pParse,&A,&B,0); /*X-overwrites-A*/}
drh5ad1a6c2002-07-01 12:27:09 +0000650joinop(X) ::= JOIN_KW(A) nm(B) nm(C) JOIN.
drhcf82f0d2016-02-17 04:33:10 +0000651 {X = sqlite3JoinType(pParse,&A,&B,&C);/*X-overwrites-A*/}
drh01f3f252002-05-24 16:14:15 +0000652
653%type on_opt {Expr*}
drh633e6d52008-07-28 19:34:53 +0000654%destructor on_opt {sqlite3ExprDelete(pParse->db, $$);}
drhb7916a72009-05-27 10:31:29 +0000655on_opt(N) ::= ON expr(E). {N = E.pExpr;}
drh01f3f252002-05-24 16:14:15 +0000656on_opt(N) ::= . {N = 0;}
657
danielk197785574e32008-10-06 05:32:18 +0000658// Note that this block abuses the Token type just a little. If there is
659// no "INDEXED BY" clause, the returned token is empty (z==0 && n==0). If
660// there is an INDEXED BY clause, then the token is populated as per normal,
661// with z pointing to the token data and n containing the number of bytes
662// in the token.
663//
664// If there is a "NOT INDEXED" clause, then (z==0 && n==1), which is
danielk1977b1c685b2008-10-06 16:18:39 +0000665// normally illegal. The sqlite3SrcListIndexedBy() function
danielk197785574e32008-10-06 05:32:18 +0000666// recognizes and interprets this as a special case.
667//
668%type indexed_opt {Token}
669indexed_opt(A) ::= . {A.z=0; A.n=0;}
670indexed_opt(A) ::= INDEXED BY nm(X). {A = X;}
671indexed_opt(A) ::= NOT INDEXED. {A.z=0; A.n=1;}
672
drh01f3f252002-05-24 16:14:15 +0000673%type using_opt {IdList*}
drh633e6d52008-07-28 19:34:53 +0000674%destructor using_opt {sqlite3IdListDelete(pParse->db, $$);}
drh81eba732013-10-19 23:31:56 +0000675using_opt(U) ::= USING LP idlist(L) RP. {U = L;}
drh01f3f252002-05-24 16:14:15 +0000676using_opt(U) ::= . {U = 0;}
677
678
drh348784e2000-05-29 20:41:49 +0000679%type orderby_opt {ExprList*}
drh633e6d52008-07-28 19:34:53 +0000680%destructor orderby_opt {sqlite3ExprListDelete(pParse->db, $$);}
drh108aa002015-08-24 20:21:20 +0000681
682// the sortlist non-terminal stores a list of expression where each
683// expression is optionally followed by ASC or DESC to indicate the
684// sort order.
685//
drh348784e2000-05-29 20:41:49 +0000686%type sortlist {ExprList*}
drh633e6d52008-07-28 19:34:53 +0000687%destructor sortlist {sqlite3ExprListDelete(pParse->db, $$);}
drh348784e2000-05-29 20:41:49 +0000688
689orderby_opt(A) ::= . {A = 0;}
690orderby_opt(A) ::= ORDER BY sortlist(X). {A = X;}
drh4dd0d3f2016-02-17 01:18:33 +0000691sortlist(A) ::= sortlist(A) COMMA expr(Y) sortorder(Z). {
692 A = sqlite3ExprListAppend(pParse,A,Y.pExpr);
drhbc622bc2015-08-24 15:39:42 +0000693 sqlite3ExprListSetSortOrder(A,Z);
drh9bb61fe2000-06-05 16:01:39 +0000694}
drh8395b7b2012-01-28 19:44:22 +0000695sortlist(A) ::= expr(Y) sortorder(Z). {
drhcf82f0d2016-02-17 04:33:10 +0000696 A = sqlite3ExprListAppend(pParse,0,Y.pExpr); /*A-overwrites-Y*/
drhbc622bc2015-08-24 15:39:42 +0000697 sqlite3ExprListSetSortOrder(A,Z);
drh9bb61fe2000-06-05 16:01:39 +0000698}
drh348784e2000-05-29 20:41:49 +0000699
700%type sortorder {int}
701
drh8e2ca022002-06-17 17:07:19 +0000702sortorder(A) ::= ASC. {A = SQLITE_SO_ASC;}
703sortorder(A) ::= DESC. {A = SQLITE_SO_DESC;}
drhbc622bc2015-08-24 15:39:42 +0000704sortorder(A) ::= . {A = SQLITE_SO_UNDEFINED;}
drh348784e2000-05-29 20:41:49 +0000705
drh22827922000-06-06 17:27:05 +0000706%type groupby_opt {ExprList*}
drh633e6d52008-07-28 19:34:53 +0000707%destructor groupby_opt {sqlite3ExprListDelete(pParse->db, $$);}
drh6206d502000-06-19 19:09:08 +0000708groupby_opt(A) ::= . {A = 0;}
drh9245c242007-06-20 12:18:31 +0000709groupby_opt(A) ::= GROUP BY nexprlist(X). {A = X;}
drh22827922000-06-06 17:27:05 +0000710
711%type having_opt {Expr*}
drh633e6d52008-07-28 19:34:53 +0000712%destructor having_opt {sqlite3ExprDelete(pParse->db, $$);}
drh6206d502000-06-19 19:09:08 +0000713having_opt(A) ::= . {A = 0;}
drhb7916a72009-05-27 10:31:29 +0000714having_opt(A) ::= HAVING expr(X). {A = X.pExpr;}
drh22827922000-06-06 17:27:05 +0000715
drhad3cab52002-05-24 02:04:32 +0000716%type limit_opt {struct LimitVal}
drh15926592007-04-06 15:02:13 +0000717
718// The destructor for limit_opt will never fire in the current grammar.
719// The limit_opt non-terminal only occurs at the end of a single production
720// rule for SELECT statements. As soon as the rule that create the
721// limit_opt non-terminal reduces, the SELECT statement rule will also
722// reduce. So there is never a limit_opt non-terminal on the stack
723// except as a transient. So there is never anything to destroy.
724//
725//%destructor limit_opt {
drh633e6d52008-07-28 19:34:53 +0000726// sqlite3ExprDelete(pParse->db, $$.pLimit);
727// sqlite3ExprDelete(pParse->db, $$.pOffset);
drh15926592007-04-06 15:02:13 +0000728//}
drhb7916a72009-05-27 10:31:29 +0000729limit_opt(A) ::= . {A.pLimit = 0; A.pOffset = 0;}
730limit_opt(A) ::= LIMIT expr(X). {A.pLimit = X.pExpr; A.pOffset = 0;}
danielk1977a2dc3b12005-02-05 12:48:48 +0000731limit_opt(A) ::= LIMIT expr(X) OFFSET expr(Y).
drhb7916a72009-05-27 10:31:29 +0000732 {A.pLimit = X.pExpr; A.pOffset = Y.pExpr;}
danielk1977a2dc3b12005-02-05 12:48:48 +0000733limit_opt(A) ::= LIMIT expr(X) COMMA expr(Y).
drhb7916a72009-05-27 10:31:29 +0000734 {A.pOffset = X.pExpr; A.pLimit = Y.pExpr;}
drh9bbca4c2001-11-06 04:00:18 +0000735
drh382c0242001-10-06 16:33:02 +0000736/////////////////////////// The DELETE statement /////////////////////////////
737//
shane273f6192008-10-10 04:34:16 +0000738%ifdef SQLITE_ENABLE_UPDATE_DELETE_LIMIT
dan4e9119d2014-01-13 15:12:23 +0000739cmd ::= with(C) DELETE FROM fullname(X) indexed_opt(I) where_opt(W)
drh931577f2008-10-10 14:27:16 +0000740 orderby_opt(O) limit_opt(L). {
danb290f112014-01-17 14:59:27 +0000741 sqlite3WithPush(pParse, C, 1);
danielk1977b1c685b2008-10-06 16:18:39 +0000742 sqlite3SrcListIndexedBy(pParse, X, &I);
shane49ffdbf2008-10-10 18:25:45 +0000743 W = sqlite3LimitWhere(pParse, X, W, O, L.pLimit, L.pOffset, "DELETE");
744 sqlite3DeleteFrom(pParse,X,W);
danielk1977b1c685b2008-10-06 16:18:39 +0000745}
shane4281bd42008-10-07 05:27:11 +0000746%endif
shane273f6192008-10-10 04:34:16 +0000747%ifndef SQLITE_ENABLE_UPDATE_DELETE_LIMIT
dan4e9119d2014-01-13 15:12:23 +0000748cmd ::= with(C) DELETE FROM fullname(X) indexed_opt(I) where_opt(W). {
danb290f112014-01-17 14:59:27 +0000749 sqlite3WithPush(pParse, C, 1);
shane4281bd42008-10-07 05:27:11 +0000750 sqlite3SrcListIndexedBy(pParse, X, &I);
751 sqlite3DeleteFrom(pParse,X,W);
752}
753%endif
drh348784e2000-05-29 20:41:49 +0000754
755%type where_opt {Expr*}
drh633e6d52008-07-28 19:34:53 +0000756%destructor where_opt {sqlite3ExprDelete(pParse->db, $$);}
drh348784e2000-05-29 20:41:49 +0000757
758where_opt(A) ::= . {A = 0;}
drhb7916a72009-05-27 10:31:29 +0000759where_opt(A) ::= WHERE expr(X). {A = X.pExpr;}
drh348784e2000-05-29 20:41:49 +0000760
drh382c0242001-10-06 16:33:02 +0000761////////////////////////// The UPDATE command ////////////////////////////////
762//
shane273f6192008-10-10 04:34:16 +0000763%ifdef SQLITE_ENABLE_UPDATE_DELETE_LIMIT
danbfe31e72014-01-15 14:17:31 +0000764cmd ::= with(C) UPDATE orconf(R) fullname(X) indexed_opt(I) SET setlist(Y)
drh8b471862014-01-11 13:22:17 +0000765 where_opt(W) orderby_opt(O) limit_opt(L). {
danb290f112014-01-17 14:59:27 +0000766 sqlite3WithPush(pParse, C, 1);
danielk1977b1c685b2008-10-06 16:18:39 +0000767 sqlite3SrcListIndexedBy(pParse, X, &I);
drhb1a6c3c2008-03-20 16:30:17 +0000768 sqlite3ExprListCheckLength(pParse,Y,"set list");
shane49ffdbf2008-10-10 18:25:45 +0000769 W = sqlite3LimitWhere(pParse, X, W, O, L.pLimit, L.pOffset, "UPDATE");
770 sqlite3Update(pParse,X,Y,W,R);
danielk19777a15a4b2007-05-08 17:54:43 +0000771}
shane4281bd42008-10-07 05:27:11 +0000772%endif
shane273f6192008-10-10 04:34:16 +0000773%ifndef SQLITE_ENABLE_UPDATE_DELETE_LIMIT
dan4e9119d2014-01-13 15:12:23 +0000774cmd ::= with(C) UPDATE orconf(R) fullname(X) indexed_opt(I) SET setlist(Y)
drhe9240412012-12-18 13:12:03 +0000775 where_opt(W). {
danb290f112014-01-17 14:59:27 +0000776 sqlite3WithPush(pParse, C, 1);
shane4281bd42008-10-07 05:27:11 +0000777 sqlite3SrcListIndexedBy(pParse, X, &I);
778 sqlite3ExprListCheckLength(pParse,Y,"set list");
779 sqlite3Update(pParse,X,Y,W,R);
780}
781%endif
drh348784e2000-05-29 20:41:49 +0000782
drhf8db1bc2005-04-22 02:38:37 +0000783%type setlist {ExprList*}
drh633e6d52008-07-28 19:34:53 +0000784%destructor setlist {sqlite3ExprListDelete(pParse->db, $$);}
drhf8db1bc2005-04-22 02:38:37 +0000785
drh4dd0d3f2016-02-17 01:18:33 +0000786setlist(A) ::= setlist(A) COMMA nm(X) EQ expr(Y). {
787 A = sqlite3ExprListAppend(pParse, A, Y.pExpr);
drhb7916a72009-05-27 10:31:29 +0000788 sqlite3ExprListSetName(pParse, A, &X, 1);
789}
drha1251bc2016-08-20 00:51:37 +0000790setlist(A) ::= setlist(A) COMMA LP idlist(X) RP EQ expr(Y). {
791 A = sqlite3ExprListAppendVector(pParse, A, X, Y.pExpr);
792}
drhb7916a72009-05-27 10:31:29 +0000793setlist(A) ::= nm(X) EQ expr(Y). {
794 A = sqlite3ExprListAppend(pParse, 0, Y.pExpr);
795 sqlite3ExprListSetName(pParse, A, &X, 1);
796}
drha1251bc2016-08-20 00:51:37 +0000797setlist(A) ::= LP idlist(X) RP EQ expr(Y). {
798 A = sqlite3ExprListAppendVector(pParse, 0, X, Y.pExpr);
799}
drh348784e2000-05-29 20:41:49 +0000800
drh382c0242001-10-06 16:33:02 +0000801////////////////////////// The INSERT command /////////////////////////////////
802//
drh8981b902015-08-24 17:42:49 +0000803cmd ::= with(W) insert_cmd(R) INTO fullname(X) idlist_opt(F) select(S). {
danb290f112014-01-17 14:59:27 +0000804 sqlite3WithPush(pParse, W, 1);
dan4e9119d2014-01-13 15:12:23 +0000805 sqlite3Insert(pParse, X, S, F, R);
806}
drh8981b902015-08-24 17:42:49 +0000807cmd ::= with(W) insert_cmd(R) INTO fullname(X) idlist_opt(F) DEFAULT VALUES.
dan4e9119d2014-01-13 15:12:23 +0000808{
danb290f112014-01-17 14:59:27 +0000809 sqlite3WithPush(pParse, W, 1);
dan4e9119d2014-01-13 15:12:23 +0000810 sqlite3Insert(pParse, X, 0, F, R);
811}
drh348784e2000-05-29 20:41:49 +0000812
drh3334d082015-11-10 13:45:21 +0000813%type insert_cmd {int}
drhfa86c412002-02-02 15:01:15 +0000814insert_cmd(A) ::= INSERT orconf(R). {A = R;}
815insert_cmd(A) ::= REPLACE. {A = OE_Replace;}
816
drh8981b902015-08-24 17:42:49 +0000817%type idlist_opt {IdList*}
818%destructor idlist_opt {sqlite3IdListDelete(pParse->db, $$);}
drh81eba732013-10-19 23:31:56 +0000819%type idlist {IdList*}
820%destructor idlist {sqlite3IdListDelete(pParse->db, $$);}
drh348784e2000-05-29 20:41:49 +0000821
drh8981b902015-08-24 17:42:49 +0000822idlist_opt(A) ::= . {A = 0;}
823idlist_opt(A) ::= LP idlist(X) RP. {A = X;}
drh4dd0d3f2016-02-17 01:18:33 +0000824idlist(A) ::= idlist(A) COMMA nm(Y).
825 {A = sqlite3IdListAppend(pParse->db,A,&Y);}
drh81eba732013-10-19 23:31:56 +0000826idlist(A) ::= nm(Y).
drhcf82f0d2016-02-17 04:33:10 +0000827 {A = sqlite3IdListAppend(pParse->db,0,&Y); /*A-overwrites-Y*/}
drh348784e2000-05-29 20:41:49 +0000828
drh382c0242001-10-06 16:33:02 +0000829/////////////////////////// Expression Processing /////////////////////////////
830//
drh348784e2000-05-29 20:41:49 +0000831
drhb7916a72009-05-27 10:31:29 +0000832%type expr {ExprSpan}
833%destructor expr {sqlite3ExprDelete(pParse->db, $$.pExpr);}
834%type term {ExprSpan}
835%destructor term {sqlite3ExprDelete(pParse->db, $$.pExpr);}
836
837%include {
838 /* This is a utility routine used to set the ExprSpan.zStart and
839 ** ExprSpan.zEnd values of pOut so that the span covers the complete
840 ** range of text beginning with pStart and going to the end of pEnd.
841 */
842 static void spanSet(ExprSpan *pOut, Token *pStart, Token *pEnd){
843 pOut->zStart = pStart->z;
844 pOut->zEnd = &pEnd->z[pEnd->n];
845 }
846
847 /* Construct a new Expr object from a single identifier. Use the
848 ** new Expr to populate pOut. Set the span of pOut to be the identifier
849 ** that created the expression.
850 */
drh43303de2016-02-17 12:34:03 +0000851 static void spanExpr(ExprSpan *pOut, Parse *pParse, int op, Token t){
drh0cd874b2016-09-26 12:38:22 +0000852 Expr *p = sqlite3DbMallocRawNN(pParse->db, sizeof(Expr)+t.n+1);
853 if( p ){
854 memset(p, 0, sizeof(Expr));
855 p->op = (u8)op;
856 p->flags = EP_Leaf;
857 p->iAgg = -1;
858 p->u.zToken = (char*)&p[1];
859 memcpy(p->u.zToken, t.z, t.n);
860 p->u.zToken[t.n] = 0;
861 if( sqlite3Isquote(p->u.zToken[0]) ){
862 if( p->u.zToken[0]=='"' ) p->flags |= EP_DblQuoted;
863 sqlite3Dequote(p->u.zToken);
864 }
865#if SQLITE_MAX_EXPR_DEPTH>0
866 p->nHeight = 1;
867#endif
868 }
869 pOut->pExpr = p;
drh43303de2016-02-17 12:34:03 +0000870 pOut->zStart = t.z;
871 pOut->zEnd = &t.z[t.n];
drhb7916a72009-05-27 10:31:29 +0000872 }
873}
drh348784e2000-05-29 20:41:49 +0000874
drh4dd0d3f2016-02-17 01:18:33 +0000875expr(A) ::= term(A).
drh43303de2016-02-17 12:34:03 +0000876expr(A) ::= LP(B) expr(X) RP(E).
877 {spanSet(&A,&B,&E); /*A-overwrites-B*/ A.pExpr = X.pExpr;}
drh43303de2016-02-17 12:34:03 +0000878expr(A) ::= id(X). {spanExpr(&A,pParse,TK_ID,X); /*A-overwrites-X*/}
879expr(A) ::= JOIN_KW(X). {spanExpr(&A,pParse,TK_ID,X); /*A-overwrites-X*/}
drh5ad1a6c2002-07-01 12:27:09 +0000880expr(A) ::= nm(X) DOT nm(Y). {
drh410c3012016-09-24 17:42:43 +0000881 Expr *temp1 = sqlite3ExprAlloc(pParse->db, TK_ID, &X, 1);
882 Expr *temp2 = sqlite3ExprAlloc(pParse->db, TK_ID, &Y, 1);
drhcf82f0d2016-02-17 04:33:10 +0000883 spanSet(&A,&X,&Y); /*A-overwrites-X*/
drhabfd35e2016-12-06 22:47:23 +0000884 A.pExpr = sqlite3PExpr(pParse, TK_DOT, temp1, temp2);
drhe1b6a5b2000-07-29 13:06:59 +0000885}
drhd24cc422003-03-27 12:51:24 +0000886expr(A) ::= nm(X) DOT nm(Y) DOT nm(Z). {
drh410c3012016-09-24 17:42:43 +0000887 Expr *temp1 = sqlite3ExprAlloc(pParse->db, TK_ID, &X, 1);
888 Expr *temp2 = sqlite3ExprAlloc(pParse->db, TK_ID, &Y, 1);
889 Expr *temp3 = sqlite3ExprAlloc(pParse->db, TK_ID, &Z, 1);
drhabfd35e2016-12-06 22:47:23 +0000890 Expr *temp4 = sqlite3PExpr(pParse, TK_DOT, temp2, temp3);
drhcf82f0d2016-02-17 04:33:10 +0000891 spanSet(&A,&X,&Z); /*A-overwrites-X*/
drhabfd35e2016-12-06 22:47:23 +0000892 A.pExpr = sqlite3PExpr(pParse, TK_DOT, temp1, temp4);
drhd24cc422003-03-27 12:51:24 +0000893}
drh980a89e2017-07-12 17:26:44 +0000894term(A) ::= NULL|FLOAT|BLOB(X). {spanExpr(&A,pParse,@X,X); /*A-overwrites-X*/}
895term(A) ::= STRING(X). {spanExpr(&A,pParse,@X,X); /*A-overwrites-X*/}
drh0cd874b2016-09-26 12:38:22 +0000896term(A) ::= INTEGER(X). {
897 A.pExpr = sqlite3ExprAlloc(pParse->db, TK_INTEGER, &X, 1);
898 A.zStart = X.z;
899 A.zEnd = X.z + X.n;
drh0cd874b2016-09-26 12:38:22 +0000900}
drh7c972de2003-09-06 22:18:07 +0000901expr(A) ::= VARIABLE(X). {
drh8679fba2016-04-11 01:43:33 +0000902 if( !(X.z[0]=='#' && sqlite3Isdigit(X.z[1])) ){
drhde25a882016-10-03 15:28:24 +0000903 u32 n = X.n;
drh8f3b1372016-04-11 01:26:31 +0000904 spanExpr(&A, pParse, TK_VARIABLE, X);
drhde25a882016-10-03 15:28:24 +0000905 sqlite3ExprAssignVarNumber(pParse, A.pExpr, n);
drh8f3b1372016-04-11 01:26:31 +0000906 }else{
drhf59b12f2014-01-11 03:54:05 +0000907 /* When doing a nested parse, one can include terms in an expression
908 ** that look like this: #1 #2 ... These terms refer to registers
909 ** in the virtual machine. #N is the N-th register. */
drh8f3b1372016-04-11 01:26:31 +0000910 Token t = X; /*A-overwrites-X*/
911 assert( t.n>=2 );
drh43303de2016-02-17 12:34:03 +0000912 spanSet(&A, &t, &t);
drhf59b12f2014-01-11 03:54:05 +0000913 if( pParse->nested==0 ){
drh43303de2016-02-17 12:34:03 +0000914 sqlite3ErrorMsg(pParse, "near \"%T\": syntax error", &t);
drhf59b12f2014-01-11 03:54:05 +0000915 A.pExpr = 0;
916 }else{
drhabfd35e2016-12-06 22:47:23 +0000917 A.pExpr = sqlite3PExpr(pParse, TK_REGISTER, 0, 0);
drh43303de2016-02-17 12:34:03 +0000918 if( A.pExpr ) sqlite3GetInt32(&t.z[1], &A.pExpr->iTable);
drhf59b12f2014-01-11 03:54:05 +0000919 }
drhf59b12f2014-01-11 03:54:05 +0000920 }
drh7c972de2003-09-06 22:18:07 +0000921}
drh4dd0d3f2016-02-17 01:18:33 +0000922expr(A) ::= expr(A) COLLATE ids(C). {
923 A.pExpr = sqlite3ExprAddCollateToken(pParse, A.pExpr, &C, 1);
drhb7916a72009-05-27 10:31:29 +0000924 A.zEnd = &C.z[C.n];
drh8b4c40d2007-02-01 23:02:45 +0000925}
drh487e2622005-06-25 18:42:14 +0000926%ifndef SQLITE_OMIT_CAST
927expr(A) ::= CAST(X) LP expr(E) AS typetoken(T) RP(Y). {
drh43303de2016-02-17 12:34:03 +0000928 spanSet(&A,&X,&Y); /*A-overwrites-X*/
drhabfd35e2016-12-06 22:47:23 +0000929 A.pExpr = sqlite3ExprAlloc(pParse->db, TK_CAST, &T, 1);
930 sqlite3ExprAttachSubtrees(pParse->db, A.pExpr, E.pExpr, 0);
drh487e2622005-06-25 18:42:14 +0000931}
drh154d4b22006-09-21 11:02:16 +0000932%endif SQLITE_OMIT_CAST
drhf59b12f2014-01-11 03:54:05 +0000933expr(A) ::= id(X) LP distinct(D) exprlist(Y) RP(E). {
drh994704d2009-06-12 12:04:16 +0000934 if( Y && Y->nExpr>pParse->db->aLimit[SQLITE_LIMIT_FUNCTION_ARG] ){
drhe5c941b2007-05-08 13:58:26 +0000935 sqlite3ErrorMsg(pParse, "too many arguments on function %T", &X);
drh4e05c832007-05-11 01:44:50 +0000936 }
drhb7916a72009-05-27 10:31:29 +0000937 A.pExpr = sqlite3ExprFunction(pParse, Y, &X);
938 spanSet(&A,&X,&E);
drh7cea7f92015-05-29 01:35:19 +0000939 if( D==SF_Distinct && A.pExpr ){
drhb7916a72009-05-27 10:31:29 +0000940 A.pExpr->flags |= EP_Distinct;
drhfd357972005-09-09 01:33:19 +0000941 }
drhe1b6a5b2000-07-29 13:06:59 +0000942}
drhf59b12f2014-01-11 03:54:05 +0000943expr(A) ::= id(X) LP STAR RP(E). {
drhb7916a72009-05-27 10:31:29 +0000944 A.pExpr = sqlite3ExprFunction(pParse, 0, &X);
945 spanSet(&A,&X,&E);
drhe1b6a5b2000-07-29 13:06:59 +0000946}
drhb71090f2005-05-23 17:26:51 +0000947term(A) ::= CTIME_KW(OP). {
drh10f468f2013-11-21 14:44:38 +0000948 A.pExpr = sqlite3ExprFunction(pParse, 0, &OP);
drhb7916a72009-05-27 10:31:29 +0000949 spanSet(&A, &OP, &OP);
950}
951
952%include {
953 /* This routine constructs a binary expression node out of two ExprSpan
954 ** objects and uses the result to populate a new ExprSpan object.
955 */
956 static void spanBinaryExpr(
drhb7916a72009-05-27 10:31:29 +0000957 Parse *pParse, /* The parsing context. Errors accumulate here */
958 int op, /* The binary operation */
drh4dd0d3f2016-02-17 01:18:33 +0000959 ExprSpan *pLeft, /* The left operand, and output */
drhb7916a72009-05-27 10:31:29 +0000960 ExprSpan *pRight /* The right operand */
961 ){
drhabfd35e2016-12-06 22:47:23 +0000962 pLeft->pExpr = sqlite3PExpr(pParse, op, pLeft->pExpr, pRight->pExpr);
drh4dd0d3f2016-02-17 01:18:33 +0000963 pLeft->zEnd = pRight->zEnd;
drh417ec632006-08-14 14:23:41 +0000964 }
drh9109b7f2015-10-28 16:05:10 +0000965
966 /* If doNot is true, then add a TK_NOT Expr-node wrapper around the
967 ** outside of *ppExpr.
968 */
drh4dd0d3f2016-02-17 01:18:33 +0000969 static void exprNot(Parse *pParse, int doNot, ExprSpan *pSpan){
970 if( doNot ){
drhabfd35e2016-12-06 22:47:23 +0000971 pSpan->pExpr = sqlite3PExpr(pParse, TK_NOT, pSpan->pExpr, 0);
drh4dd0d3f2016-02-17 01:18:33 +0000972 }
drh9109b7f2015-10-28 16:05:10 +0000973 }
drhb71090f2005-05-23 17:26:51 +0000974}
drhb7916a72009-05-27 10:31:29 +0000975
drh8bd0d582016-08-20 18:06:14 +0000976expr(A) ::= LP(L) nexprlist(X) COMMA expr(Y) RP(R). {
977 ExprList *pList = sqlite3ExprListAppend(pParse, X, Y.pExpr);
drhabfd35e2016-12-06 22:47:23 +0000978 A.pExpr = sqlite3PExpr(pParse, TK_VECTOR, 0, 0);
dan71c57db2016-07-09 20:23:55 +0000979 if( A.pExpr ){
drh8bd0d582016-08-20 18:06:14 +0000980 A.pExpr->x.pList = pList;
dan71c57db2016-07-09 20:23:55 +0000981 spanSet(&A, &L, &R);
drh8bd0d582016-08-20 18:06:14 +0000982 }else{
983 sqlite3ExprListDelete(pParse->db, pList);
dan71c57db2016-07-09 20:23:55 +0000984 }
985}
986
drh4dd0d3f2016-02-17 01:18:33 +0000987expr(A) ::= expr(A) AND(OP) expr(Y). {spanBinaryExpr(pParse,@OP,&A,&Y);}
988expr(A) ::= expr(A) OR(OP) expr(Y). {spanBinaryExpr(pParse,@OP,&A,&Y);}
989expr(A) ::= expr(A) LT|GT|GE|LE(OP) expr(Y).
990 {spanBinaryExpr(pParse,@OP,&A,&Y);}
991expr(A) ::= expr(A) EQ|NE(OP) expr(Y). {spanBinaryExpr(pParse,@OP,&A,&Y);}
992expr(A) ::= expr(A) BITAND|BITOR|LSHIFT|RSHIFT(OP) expr(Y).
993 {spanBinaryExpr(pParse,@OP,&A,&Y);}
994expr(A) ::= expr(A) PLUS|MINUS(OP) expr(Y).
995 {spanBinaryExpr(pParse,@OP,&A,&Y);}
996expr(A) ::= expr(A) STAR|SLASH|REM(OP) expr(Y).
997 {spanBinaryExpr(pParse,@OP,&A,&Y);}
998expr(A) ::= expr(A) CONCAT(OP) expr(Y). {spanBinaryExpr(pParse,@OP,&A,&Y);}
drh410c3012016-09-24 17:42:43 +0000999%type likeop {Token}
drh7e84b372017-02-20 14:30:17 +00001000likeop(A) ::= LIKE_KW|MATCH(A).
drh410c3012016-09-24 17:42:43 +00001001likeop(A) ::= NOT LIKE_KW|MATCH(X). {A=X; A.n|=0x80000000; /*A-overwrite-X*/}
drh4dd0d3f2016-02-17 01:18:33 +00001002expr(A) ::= expr(A) likeop(OP) expr(Y). [LIKE_KW] {
drh8aa34ae2006-03-13 12:54:09 +00001003 ExprList *pList;
drh410c3012016-09-24 17:42:43 +00001004 int bNot = OP.n & 0x80000000;
1005 OP.n &= 0x7fffffff;
drhb7916a72009-05-27 10:31:29 +00001006 pList = sqlite3ExprListAppend(pParse,0, Y.pExpr);
drh4dd0d3f2016-02-17 01:18:33 +00001007 pList = sqlite3ExprListAppend(pParse,pList, A.pExpr);
drh410c3012016-09-24 17:42:43 +00001008 A.pExpr = sqlite3ExprFunction(pParse, pList, &OP);
1009 exprNot(pParse, bNot, &A);
drhb7916a72009-05-27 10:31:29 +00001010 A.zEnd = Y.zEnd;
1011 if( A.pExpr ) A.pExpr->flags |= EP_InfixFunc;
drh0ac65892002-04-20 14:24:41 +00001012}
drh4dd0d3f2016-02-17 01:18:33 +00001013expr(A) ::= expr(A) likeop(OP) expr(Y) ESCAPE expr(E). [LIKE_KW] {
drh1dca1452010-07-19 02:30:33 +00001014 ExprList *pList;
drh410c3012016-09-24 17:42:43 +00001015 int bNot = OP.n & 0x80000000;
1016 OP.n &= 0x7fffffff;
drh1dca1452010-07-19 02:30:33 +00001017 pList = sqlite3ExprListAppend(pParse,0, Y.pExpr);
drh4dd0d3f2016-02-17 01:18:33 +00001018 pList = sqlite3ExprListAppend(pParse,pList, A.pExpr);
drh1dca1452010-07-19 02:30:33 +00001019 pList = sqlite3ExprListAppend(pParse,pList, E.pExpr);
drh410c3012016-09-24 17:42:43 +00001020 A.pExpr = sqlite3ExprFunction(pParse, pList, &OP);
1021 exprNot(pParse, bNot, &A);
drh1dca1452010-07-19 02:30:33 +00001022 A.zEnd = E.zEnd;
1023 if( A.pExpr ) A.pExpr->flags |= EP_InfixFunc;
1024}
danielk19777c6303c2004-11-17 16:41:29 +00001025
drhb7916a72009-05-27 10:31:29 +00001026%include {
1027 /* Construct an expression node for a unary postfix operator
1028 */
1029 static void spanUnaryPostfix(
drhb7916a72009-05-27 10:31:29 +00001030 Parse *pParse, /* Parsing context to record errors */
1031 int op, /* The operator */
drh4dd0d3f2016-02-17 01:18:33 +00001032 ExprSpan *pOperand, /* The operand, and output */
drhb7916a72009-05-27 10:31:29 +00001033 Token *pPostOp /* The operand token for setting the span */
1034 ){
drhabfd35e2016-12-06 22:47:23 +00001035 pOperand->pExpr = sqlite3PExpr(pParse, op, pOperand->pExpr, 0);
drh4dd0d3f2016-02-17 01:18:33 +00001036 pOperand->zEnd = &pPostOp->z[pPostOp->n];
drhb7916a72009-05-27 10:31:29 +00001037 }
drhe1b6a5b2000-07-29 13:06:59 +00001038}
drhb7916a72009-05-27 10:31:29 +00001039
drh4dd0d3f2016-02-17 01:18:33 +00001040expr(A) ::= expr(A) ISNULL|NOTNULL(E). {spanUnaryPostfix(pParse,@E,&A,&E);}
1041expr(A) ::= expr(A) NOT NULL(E). {spanUnaryPostfix(pParse,TK_NOTNULL,&A,&E);}
drh6a2fe092009-09-23 02:29:36 +00001042
drh6a517412009-11-12 03:46:34 +00001043%include {
1044 /* A routine to convert a binary TK_IS or TK_ISNOT expression into a
1045 ** unary TK_ISNULL or TK_NOTNULL expression. */
1046 static void binaryToUnaryIfNull(Parse *pParse, Expr *pY, Expr *pA, int op){
1047 sqlite3 *db = pParse->db;
dan895c00e2016-01-28 18:22:46 +00001048 if( pA && pY && pY->op==TK_NULL ){
shaneh5e17e8b2009-12-03 04:40:47 +00001049 pA->op = (u8)op;
drh6a517412009-11-12 03:46:34 +00001050 sqlite3ExprDelete(db, pA->pRight);
1051 pA->pRight = 0;
1052 }
1053 }
1054}
1055
drh6a2fe092009-09-23 02:29:36 +00001056// expr1 IS expr2
1057// expr1 IS NOT expr2
1058//
1059// If expr2 is NULL then code as TK_ISNULL or TK_NOTNULL. If expr2
1060// is any other expression, code as TK_IS or TK_ISNOT.
1061//
drh4dd0d3f2016-02-17 01:18:33 +00001062expr(A) ::= expr(A) IS expr(Y). {
1063 spanBinaryExpr(pParse,TK_IS,&A,&Y);
drh6a517412009-11-12 03:46:34 +00001064 binaryToUnaryIfNull(pParse, Y.pExpr, A.pExpr, TK_ISNULL);
drh6a2fe092009-09-23 02:29:36 +00001065}
drh4dd0d3f2016-02-17 01:18:33 +00001066expr(A) ::= expr(A) IS NOT expr(Y). {
1067 spanBinaryExpr(pParse,TK_ISNOT,&A,&Y);
drh6a517412009-11-12 03:46:34 +00001068 binaryToUnaryIfNull(pParse, Y.pExpr, A.pExpr, TK_NOTNULL);
drh6a2fe092009-09-23 02:29:36 +00001069}
drhb7916a72009-05-27 10:31:29 +00001070
1071%include {
1072 /* Construct an expression node for a unary prefix operator
1073 */
1074 static void spanUnaryPrefix(
1075 ExprSpan *pOut, /* Write the new expression node here */
1076 Parse *pParse, /* Parsing context to record errors */
1077 int op, /* The operator */
1078 ExprSpan *pOperand, /* The operand */
1079 Token *pPreOp /* The operand token for setting the span */
1080 ){
drhb7916a72009-05-27 10:31:29 +00001081 pOut->zStart = pPreOp->z;
drhabfd35e2016-12-06 22:47:23 +00001082 pOut->pExpr = sqlite3PExpr(pParse, op, pOperand->pExpr, 0);
drhb7916a72009-05-27 10:31:29 +00001083 pOut->zEnd = pOperand->zEnd;
1084 }
drh33048c02001-10-01 14:29:22 +00001085}
drhb7916a72009-05-27 10:31:29 +00001086
1087
1088
drh43303de2016-02-17 12:34:03 +00001089expr(A) ::= NOT(B) expr(X).
1090 {spanUnaryPrefix(&A,pParse,@B,&X,&B);/*A-overwrites-B*/}
1091expr(A) ::= BITNOT(B) expr(X).
1092 {spanUnaryPrefix(&A,pParse,@B,&X,&B);/*A-overwrites-B*/}
drh7ba5bc52009-09-22 20:08:34 +00001093expr(A) ::= MINUS(B) expr(X). [BITNOT]
drh43303de2016-02-17 12:34:03 +00001094 {spanUnaryPrefix(&A,pParse,TK_UMINUS,&X,&B);/*A-overwrites-B*/}
drh7ba5bc52009-09-22 20:08:34 +00001095expr(A) ::= PLUS(B) expr(X). [BITNOT]
drh43303de2016-02-17 12:34:03 +00001096 {spanUnaryPrefix(&A,pParse,TK_UPLUS,&X,&B);/*A-overwrites-B*/}
drhb7916a72009-05-27 10:31:29 +00001097
drh2e3a1f12004-10-06 14:39:28 +00001098%type between_op {int}
1099between_op(A) ::= BETWEEN. {A = 0;}
1100between_op(A) ::= NOT BETWEEN. {A = 1;}
drh4dd0d3f2016-02-17 01:18:33 +00001101expr(A) ::= expr(A) between_op(N) expr(X) AND expr(Y). [BETWEEN] {
drhb7916a72009-05-27 10:31:29 +00001102 ExprList *pList = sqlite3ExprListAppend(pParse,0, X.pExpr);
1103 pList = sqlite3ExprListAppend(pParse,pList, Y.pExpr);
drhabfd35e2016-12-06 22:47:23 +00001104 A.pExpr = sqlite3PExpr(pParse, TK_BETWEEN, A.pExpr, 0);
drhb7916a72009-05-27 10:31:29 +00001105 if( A.pExpr ){
1106 A.pExpr->x.pList = pList;
drh53f733c2005-09-16 02:38:09 +00001107 }else{
drh633e6d52008-07-28 19:34:53 +00001108 sqlite3ExprListDelete(pParse->db, pList);
drh53f733c2005-09-16 02:38:09 +00001109 }
drh4dd0d3f2016-02-17 01:18:33 +00001110 exprNot(pParse, N, &A);
drhb7916a72009-05-27 10:31:29 +00001111 A.zEnd = Y.zEnd;
drhfef52082000-06-06 01:50:43 +00001112}
drh51522cd2005-01-20 13:36:19 +00001113%ifndef SQLITE_OMIT_SUBQUERY
danielk19773e8c37e2005-01-21 03:12:14 +00001114 %type in_op {int}
1115 in_op(A) ::= IN. {A = 0;}
1116 in_op(A) ::= NOT IN. {A = 1;}
drh4dd0d3f2016-02-17 01:18:33 +00001117 expr(A) ::= expr(A) in_op(N) LP exprlist(Y) RP(E). [IN] {
drh094430e2010-07-14 18:24:06 +00001118 if( Y==0 ){
dan473c1bf2010-07-15 11:14:21 +00001119 /* Expressions of the form
1120 **
1121 ** expr1 IN ()
1122 ** expr1 NOT IN ()
1123 **
1124 ** simplify to constants 0 (false) and 1 (true), respectively,
1125 ** regardless of the value of expr1.
1126 */
drh4dd0d3f2016-02-17 01:18:33 +00001127 sqlite3ExprDelete(pParse->db, A.pExpr);
drhabfd35e2016-12-06 22:47:23 +00001128 A.pExpr = sqlite3ExprAlloc(pParse->db, TK_INTEGER,&sqlite3IntTokens[N],1);
drh2b59b3a2014-03-20 13:26:47 +00001129 }else if( Y->nExpr==1 ){
1130 /* Expressions of the form:
1131 **
1132 ** expr1 IN (?1)
1133 ** expr1 NOT IN (?2)
1134 **
drhfbb24d12014-03-20 17:03:30 +00001135 ** with exactly one value on the RHS can be simplified to something
1136 ** like this:
drh2b59b3a2014-03-20 13:26:47 +00001137 **
drhfbb24d12014-03-20 17:03:30 +00001138 ** expr1 == ?1
1139 ** expr1 <> ?2
1140 **
1141 ** But, the RHS of the == or <> is marked with the EP_Generic flag
1142 ** so that it may not contribute to the computation of comparison
1143 ** affinity or the collating sequence to use for comparison. Otherwise,
1144 ** the semantics would be subtly different from IN or NOT IN.
drh2b59b3a2014-03-20 13:26:47 +00001145 */
drhfbb24d12014-03-20 17:03:30 +00001146 Expr *pRHS = Y->a[0].pExpr;
drh2b59b3a2014-03-20 13:26:47 +00001147 Y->a[0].pExpr = 0;
1148 sqlite3ExprListDelete(pParse->db, Y);
drh5b1420e2014-03-20 19:04:56 +00001149 /* pRHS cannot be NULL because a malloc error would have been detected
1150 ** before now and control would have never reached this point */
1151 if( ALWAYS(pRHS) ){
drhfbb24d12014-03-20 17:03:30 +00001152 pRHS->flags &= ~EP_Collate;
1153 pRHS->flags |= EP_Generic;
1154 }
drhabfd35e2016-12-06 22:47:23 +00001155 A.pExpr = sqlite3PExpr(pParse, N ? TK_NE : TK_EQ, A.pExpr, pRHS);
danielk1977d5d56522005-03-16 12:15:20 +00001156 }else{
drhabfd35e2016-12-06 22:47:23 +00001157 A.pExpr = sqlite3PExpr(pParse, TK_IN, A.pExpr, 0);
drh094430e2010-07-14 18:24:06 +00001158 if( A.pExpr ){
1159 A.pExpr->x.pList = Y;
drh2308ed32015-02-09 16:09:34 +00001160 sqlite3ExprSetHeightAndFlags(pParse, A.pExpr);
drh094430e2010-07-14 18:24:06 +00001161 }else{
1162 sqlite3ExprListDelete(pParse->db, Y);
1163 }
drh4dd0d3f2016-02-17 01:18:33 +00001164 exprNot(pParse, N, &A);
danielk1977d5d56522005-03-16 12:15:20 +00001165 }
drhb7916a72009-05-27 10:31:29 +00001166 A.zEnd = &E.z[E.n];
danielk19773e8c37e2005-01-21 03:12:14 +00001167 }
drh51522cd2005-01-20 13:36:19 +00001168 expr(A) ::= LP(B) select(X) RP(E). {
drh43303de2016-02-17 12:34:03 +00001169 spanSet(&A,&B,&E); /*A-overwrites-B*/
drhabfd35e2016-12-06 22:47:23 +00001170 A.pExpr = sqlite3PExpr(pParse, TK_SELECT, 0, 0);
drh08de4f72016-04-11 01:06:47 +00001171 sqlite3PExprAddSelect(pParse, A.pExpr, X);
drh51522cd2005-01-20 13:36:19 +00001172 }
drh4dd0d3f2016-02-17 01:18:33 +00001173 expr(A) ::= expr(A) in_op(N) LP select(Y) RP(E). [IN] {
drhabfd35e2016-12-06 22:47:23 +00001174 A.pExpr = sqlite3PExpr(pParse, TK_IN, A.pExpr, 0);
drh08de4f72016-04-11 01:06:47 +00001175 sqlite3PExprAddSelect(pParse, A.pExpr, Y);
drh4dd0d3f2016-02-17 01:18:33 +00001176 exprNot(pParse, N, &A);
drhb7916a72009-05-27 10:31:29 +00001177 A.zEnd = &E.z[E.n];
drh51522cd2005-01-20 13:36:19 +00001178 }
drh5fbab882016-07-02 12:08:14 +00001179 expr(A) ::= expr(A) in_op(N) nm(Y) dbnm(Z) paren_exprlist(E). [IN] {
drh17435752007-08-16 04:30:38 +00001180 SrcList *pSrc = sqlite3SrcListAppend(pParse->db, 0,&Y,&Z);
drh08de4f72016-04-11 01:06:47 +00001181 Select *pSelect = sqlite3SelectNew(pParse, 0,pSrc,0,0,0,0,0,0,0);
drh9de47572016-07-02 12:33:21 +00001182 if( E ) sqlite3SrcListFuncArgs(pParse, pSelect ? pSrc : 0, E);
drhabfd35e2016-12-06 22:47:23 +00001183 A.pExpr = sqlite3PExpr(pParse, TK_IN, A.pExpr, 0);
drh08de4f72016-04-11 01:06:47 +00001184 sqlite3PExprAddSelect(pParse, A.pExpr, pSelect);
drh4dd0d3f2016-02-17 01:18:33 +00001185 exprNot(pParse, N, &A);
drhb7916a72009-05-27 10:31:29 +00001186 A.zEnd = Z.z ? &Z.z[Z.n] : &Y.z[Y.n];
drh51522cd2005-01-20 13:36:19 +00001187 }
1188 expr(A) ::= EXISTS(B) LP select(Y) RP(E). {
drh43303de2016-02-17 12:34:03 +00001189 Expr *p;
1190 spanSet(&A,&B,&E); /*A-overwrites-B*/
drhabfd35e2016-12-06 22:47:23 +00001191 p = A.pExpr = sqlite3PExpr(pParse, TK_EXISTS, 0, 0);
drh08de4f72016-04-11 01:06:47 +00001192 sqlite3PExprAddSelect(pParse, p, Y);
drh51522cd2005-01-20 13:36:19 +00001193 }
drh154d4b22006-09-21 11:02:16 +00001194%endif SQLITE_OMIT_SUBQUERY
drhfef52082000-06-06 01:50:43 +00001195
drh17a7f8d2002-03-24 13:13:27 +00001196/* CASE expressions */
1197expr(A) ::= CASE(C) case_operand(X) case_exprlist(Y) case_else(Z) END(E). {
drh43303de2016-02-17 12:34:03 +00001198 spanSet(&A,&C,&E); /*A-overwrites-C*/
drhabfd35e2016-12-06 22:47:23 +00001199 A.pExpr = sqlite3PExpr(pParse, TK_CASE, X, 0);
drhb7916a72009-05-27 10:31:29 +00001200 if( A.pExpr ){
drhc5cd1242013-09-12 16:50:49 +00001201 A.pExpr->x.pList = Z ? sqlite3ExprListAppend(pParse,Y,Z) : Y;
drh2308ed32015-02-09 16:09:34 +00001202 sqlite3ExprSetHeightAndFlags(pParse, A.pExpr);
drh53f733c2005-09-16 02:38:09 +00001203 }else{
drh633e6d52008-07-28 19:34:53 +00001204 sqlite3ExprListDelete(pParse->db, Y);
drhc5cd1242013-09-12 16:50:49 +00001205 sqlite3ExprDelete(pParse->db, Z);
drh53f733c2005-09-16 02:38:09 +00001206 }
drh17a7f8d2002-03-24 13:13:27 +00001207}
1208%type case_exprlist {ExprList*}
drh633e6d52008-07-28 19:34:53 +00001209%destructor case_exprlist {sqlite3ExprListDelete(pParse->db, $$);}
drh4dd0d3f2016-02-17 01:18:33 +00001210case_exprlist(A) ::= case_exprlist(A) WHEN expr(Y) THEN expr(Z). {
1211 A = sqlite3ExprListAppend(pParse,A, Y.pExpr);
drhb7916a72009-05-27 10:31:29 +00001212 A = sqlite3ExprListAppend(pParse,A, Z.pExpr);
drh17a7f8d2002-03-24 13:13:27 +00001213}
1214case_exprlist(A) ::= WHEN expr(Y) THEN expr(Z). {
drhb7916a72009-05-27 10:31:29 +00001215 A = sqlite3ExprListAppend(pParse,0, Y.pExpr);
1216 A = sqlite3ExprListAppend(pParse,A, Z.pExpr);
drh17a7f8d2002-03-24 13:13:27 +00001217}
1218%type case_else {Expr*}
drh633e6d52008-07-28 19:34:53 +00001219%destructor case_else {sqlite3ExprDelete(pParse->db, $$);}
drhb7916a72009-05-27 10:31:29 +00001220case_else(A) ::= ELSE expr(X). {A = X.pExpr;}
drh17a7f8d2002-03-24 13:13:27 +00001221case_else(A) ::= . {A = 0;}
1222%type case_operand {Expr*}
drh633e6d52008-07-28 19:34:53 +00001223%destructor case_operand {sqlite3ExprDelete(pParse->db, $$);}
drhcf82f0d2016-02-17 04:33:10 +00001224case_operand(A) ::= expr(X). {A = X.pExpr; /*A-overwrites-X*/}
drh17a7f8d2002-03-24 13:13:27 +00001225case_operand(A) ::= . {A = 0;}
drh348784e2000-05-29 20:41:49 +00001226
1227%type exprlist {ExprList*}
drh633e6d52008-07-28 19:34:53 +00001228%destructor exprlist {sqlite3ExprListDelete(pParse->db, $$);}
drh9245c242007-06-20 12:18:31 +00001229%type nexprlist {ExprList*}
drh633e6d52008-07-28 19:34:53 +00001230%destructor nexprlist {sqlite3ExprListDelete(pParse->db, $$);}
drh348784e2000-05-29 20:41:49 +00001231
drh4dd0d3f2016-02-17 01:18:33 +00001232exprlist(A) ::= nexprlist(A).
drh9245c242007-06-20 12:18:31 +00001233exprlist(A) ::= . {A = 0;}
drh4dd0d3f2016-02-17 01:18:33 +00001234nexprlist(A) ::= nexprlist(A) COMMA expr(Y).
1235 {A = sqlite3ExprListAppend(pParse,A,Y.pExpr);}
drh17435752007-08-16 04:30:38 +00001236nexprlist(A) ::= expr(Y).
drhcf82f0d2016-02-17 04:33:10 +00001237 {A = sqlite3ExprListAppend(pParse,0,Y.pExpr); /*A-overwrites-Y*/}
drh9245c242007-06-20 12:18:31 +00001238
drha5224732016-07-25 14:40:43 +00001239%ifndef SQLITE_OMIT_SUBQUERY
drh5fbab882016-07-02 12:08:14 +00001240/* A paren_exprlist is an optional expression list contained inside
1241** of parenthesis */
1242%type paren_exprlist {ExprList*}
1243%destructor paren_exprlist {sqlite3ExprListDelete(pParse->db, $$);}
1244paren_exprlist(A) ::= . {A = 0;}
1245paren_exprlist(A) ::= LP exprlist(X) RP. {A = X;}
drha5224732016-07-25 14:40:43 +00001246%endif SQLITE_OMIT_SUBQUERY
drh5fbab882016-07-02 12:08:14 +00001247
drhcce7d172000-05-31 15:34:51 +00001248
drh382c0242001-10-06 16:33:02 +00001249///////////////////////////// The CREATE INDEX command ///////////////////////
1250//
drhd9da78a2009-03-24 15:08:09 +00001251cmd ::= createkw(S) uniqueflag(U) INDEX ifnotexists(NE) nm(X) dbnm(D)
drh108aa002015-08-24 20:21:20 +00001252 ON nm(Y) LP sortlist(Z) RP where_opt(W). {
drh17435752007-08-16 04:30:38 +00001253 sqlite3CreateIndex(pParse, &X, &D,
1254 sqlite3SrcListAppend(pParse->db,0,&Y,0), Z, U,
drh62340f82016-05-31 21:18:15 +00001255 &S, W, SQLITE_SO_ASC, NE, SQLITE_IDXTYPE_APPDEF);
drh9cfcf5d2002-01-29 18:41:24 +00001256}
drh717e6402001-09-27 03:22:32 +00001257
1258%type uniqueflag {int}
drh74ad7fe2004-10-07 03:06:28 +00001259uniqueflag(A) ::= UNIQUE. {A = OE_Abort;}
1260uniqueflag(A) ::= . {A = OE_None;}
drh348784e2000-05-29 20:41:49 +00001261
drh348784e2000-05-29 20:41:49 +00001262
drh108aa002015-08-24 20:21:20 +00001263// The eidlist non-terminal (Expression Id List) generates an ExprList
1264// from a list of identifiers. The identifier names are in ExprList.a[].zName.
1265// This list is stored in an ExprList rather than an IdList so that it
1266// can be easily sent to sqlite3ColumnsExprList().
1267//
1268// eidlist is grouped with CREATE INDEX because it used to be the non-terminal
1269// used for the arguments to an index. That is just an historical accident.
1270//
1271// IMPORTANT COMPATIBILITY NOTE: Some prior versions of SQLite accepted
1272// COLLATE clauses and ASC or DESC keywords on ID lists in inappropriate
1273// places - places that might have been stored in the sqlite_master schema.
1274// Those extra features were ignored. But because they might be in some
1275// (busted) old databases, we need to continue parsing them when loading
1276// historical schemas.
1277//
1278%type eidlist {ExprList*}
1279%destructor eidlist {sqlite3ExprListDelete(pParse->db, $$);}
1280%type eidlist_opt {ExprList*}
1281%destructor eidlist_opt {sqlite3ExprListDelete(pParse->db, $$);}
1282
1283%include {
1284 /* Add a single new term to an ExprList that is used to store a
1285 ** list of identifiers. Report an error if the ID list contains
1286 ** a COLLATE clause or an ASC or DESC keyword, except ignore the
1287 ** error while parsing a legacy schema.
1288 */
1289 static ExprList *parserAddExprIdListTerm(
1290 Parse *pParse,
1291 ExprList *pPrior,
1292 Token *pIdToken,
1293 int hasCollate,
1294 int sortOrder
1295 ){
1296 ExprList *p = sqlite3ExprListAppend(pParse, pPrior, 0);
1297 if( (hasCollate || sortOrder!=SQLITE_SO_UNDEFINED)
1298 && pParse->db->init.busy==0
1299 ){
1300 sqlite3ErrorMsg(pParse, "syntax error after column name \"%.*s\"",
1301 pIdToken->n, pIdToken->z);
1302 }
1303 sqlite3ExprListSetName(pParse, p, pIdToken, 1);
1304 return p;
1305 }
1306} // end %include
1307
1308eidlist_opt(A) ::= . {A = 0;}
1309eidlist_opt(A) ::= LP eidlist(X) RP. {A = X;}
drh4dd0d3f2016-02-17 01:18:33 +00001310eidlist(A) ::= eidlist(A) COMMA nm(Y) collate(C) sortorder(Z). {
1311 A = parserAddExprIdListTerm(pParse, A, &Y, C, Z);
danielk19770202b292004-06-09 09:55:16 +00001312}
drh108aa002015-08-24 20:21:20 +00001313eidlist(A) ::= nm(Y) collate(C) sortorder(Z). {
drhcf82f0d2016-02-17 04:33:10 +00001314 A = parserAddExprIdListTerm(pParse, 0, &Y, C, Z); /*A-overwrites-Y*/
danielk19770202b292004-06-09 09:55:16 +00001315}
danielk19770202b292004-06-09 09:55:16 +00001316
drh108aa002015-08-24 20:21:20 +00001317%type collate {int}
1318collate(C) ::= . {C = 0;}
1319collate(C) ::= COLLATE ids. {C = 1;}
drha34001c2007-02-02 12:44:37 +00001320
drh348784e2000-05-29 20:41:49 +00001321
drh8aff1012001-12-22 14:49:24 +00001322///////////////////////////// The DROP INDEX command /////////////////////////
drh382c0242001-10-06 16:33:02 +00001323//
drh4d91a702006-01-04 15:54:36 +00001324cmd ::= DROP INDEX ifexists(E) fullname(X). {sqlite3DropIndex(pParse, X, E);}
drh982cef72000-05-30 16:27:03 +00001325
drh382c0242001-10-06 16:33:02 +00001326///////////////////////////// The VACUUM command /////////////////////////////
1327//
drh154d4b22006-09-21 11:02:16 +00001328%ifndef SQLITE_OMIT_VACUUM
drhfdbcdee2007-03-27 14:44:50 +00001329%ifndef SQLITE_OMIT_ATTACH
drh9ef5e772016-08-19 14:20:56 +00001330cmd ::= VACUUM. {sqlite3Vacuum(pParse,0);}
1331cmd ::= VACUUM nm(X). {sqlite3Vacuum(pParse,&X);}
drhfdbcdee2007-03-27 14:44:50 +00001332%endif SQLITE_OMIT_ATTACH
drh154d4b22006-09-21 11:02:16 +00001333%endif SQLITE_OMIT_VACUUM
drhf57b14a2001-09-14 18:54:08 +00001334
drh382c0242001-10-06 16:33:02 +00001335///////////////////////////// The PRAGMA command /////////////////////////////
1336//
drh13d70422004-11-13 15:59:14 +00001337%ifndef SQLITE_OMIT_PRAGMA
drhada2ee02009-04-03 01:43:57 +00001338cmd ::= PRAGMA nm(X) dbnm(Z). {sqlite3Pragma(pParse,&X,&Z,0,0);}
1339cmd ::= PRAGMA nm(X) dbnm(Z) EQ nmnum(Y). {sqlite3Pragma(pParse,&X,&Z,&Y,0);}
drha3eb4b42007-01-27 02:38:29 +00001340cmd ::= PRAGMA nm(X) dbnm(Z) LP nmnum(Y) RP. {sqlite3Pragma(pParse,&X,&Z,&Y,0);}
drhada2ee02009-04-03 01:43:57 +00001341cmd ::= PRAGMA nm(X) dbnm(Z) EQ minus_num(Y).
1342 {sqlite3Pragma(pParse,&X,&Z,&Y,1);}
1343cmd ::= PRAGMA nm(X) dbnm(Z) LP minus_num(Y) RP.
1344 {sqlite3Pragma(pParse,&X,&Z,&Y,1);}
1345
drhcf82f0d2016-02-17 04:33:10 +00001346nmnum(A) ::= plus_num(A).
1347nmnum(A) ::= nm(A).
1348nmnum(A) ::= ON(A).
1349nmnum(A) ::= DELETE(A).
1350nmnum(A) ::= DEFAULT(A).
drh154d4b22006-09-21 11:02:16 +00001351%endif SQLITE_OMIT_PRAGMA
drhf59b12f2014-01-11 03:54:05 +00001352%token_class number INTEGER|FLOAT.
drh8395b7b2012-01-28 19:44:22 +00001353plus_num(A) ::= PLUS number(X). {A = X;}
drhcf82f0d2016-02-17 04:33:10 +00001354plus_num(A) ::= number(A).
drhf57b14a2001-09-14 18:54:08 +00001355minus_num(A) ::= MINUS number(X). {A = X;}
danielk1977c3f9bad2002-05-15 08:30:12 +00001356//////////////////////////// The CREATE TRIGGER command /////////////////////
drhf0f258b2003-04-21 18:48:45 +00001357
drhb7f91642004-10-31 02:22:47 +00001358%ifndef SQLITE_OMIT_TRIGGER
1359
drhd9da78a2009-03-24 15:08:09 +00001360cmd ::= createkw trigger_decl(A) BEGIN trigger_cmd_list(S) END(Z). {
drh4b59ab52002-08-24 18:24:51 +00001361 Token all;
1362 all.z = A.z;
drhb27b7f52008-12-10 18:03:45 +00001363 all.n = (int)(Z.z - A.z) + Z.n;
danielk19774adee202004-05-08 08:23:19 +00001364 sqlite3FinishTrigger(pParse, S, &all);
drhf0f258b2003-04-21 18:48:45 +00001365}
1366
drhfdd48a72006-09-11 23:45:48 +00001367trigger_decl(A) ::= temp(T) TRIGGER ifnotexists(NOERR) nm(B) dbnm(Z)
1368 trigger_time(C) trigger_event(D)
drh60218d22007-04-06 11:26:00 +00001369 ON fullname(E) foreach_clause when_clause(G). {
1370 sqlite3BeginTrigger(pParse, &B, &Z, C, D.a, D.b, E, G, T, NOERR);
drhcf82f0d2016-02-17 04:33:10 +00001371 A = (Z.n==0?B:Z); /*A-overwrites-T*/
danielk1977c3f9bad2002-05-15 08:30:12 +00001372}
1373
drhc4dd3fd2008-01-22 01:48:05 +00001374%type trigger_time {int}
drh6559e2c2017-06-28 14:26:37 +00001375trigger_time(A) ::= BEFORE|AFTER(X). { A = @X; /*A-overwrites-X*/ }
danielk1977c3f9bad2002-05-15 08:30:12 +00001376trigger_time(A) ::= INSTEAD OF. { A = TK_INSTEAD;}
1377trigger_time(A) ::= . { A = TK_BEFORE; }
1378
drhad3cab52002-05-24 02:04:32 +00001379%type trigger_event {struct TrigEvent}
drh633e6d52008-07-28 19:34:53 +00001380%destructor trigger_event {sqlite3IdListDelete(pParse->db, $$.b);}
drhcf82f0d2016-02-17 04:33:10 +00001381trigger_event(A) ::= DELETE|INSERT(X). {A.a = @X; /*A-overwrites-X*/ A.b = 0;}
1382trigger_event(A) ::= UPDATE(X). {A.a = @X; /*A-overwrites-X*/ A.b = 0;}
1383trigger_event(A) ::= UPDATE OF idlist(X).{A.a = TK_UPDATE; A.b = X;}
danielk1977c3f9bad2002-05-15 08:30:12 +00001384
drh60218d22007-04-06 11:26:00 +00001385foreach_clause ::= .
1386foreach_clause ::= FOR EACH ROW.
danielk1977c3f9bad2002-05-15 08:30:12 +00001387
drh0bb132b2004-07-20 14:06:51 +00001388%type when_clause {Expr*}
drh633e6d52008-07-28 19:34:53 +00001389%destructor when_clause {sqlite3ExprDelete(pParse->db, $$);}
danielk1977c3f9bad2002-05-15 08:30:12 +00001390when_clause(A) ::= . { A = 0; }
drhb7916a72009-05-27 10:31:29 +00001391when_clause(A) ::= WHEN expr(X). { A = X.pExpr; }
danielk1977c3f9bad2002-05-15 08:30:12 +00001392
drh0bb132b2004-07-20 14:06:51 +00001393%type trigger_cmd_list {TriggerStep*}
drh633e6d52008-07-28 19:34:53 +00001394%destructor trigger_cmd_list {sqlite3DeleteTriggerStep(pParse->db, $$);}
drh4dd0d3f2016-02-17 01:18:33 +00001395trigger_cmd_list(A) ::= trigger_cmd_list(A) trigger_cmd(X) SEMI. {
1396 assert( A!=0 );
1397 A->pLast->pNext = X;
1398 A->pLast = X;
drha69d9162003-04-17 22:57:53 +00001399}
drh4dd0d3f2016-02-17 01:18:33 +00001400trigger_cmd_list(A) ::= trigger_cmd(A) SEMI. {
1401 assert( A!=0 );
1402 A->pLast = A;
drh81238962008-08-11 14:26:35 +00001403}
danielk1977c3f9bad2002-05-15 08:30:12 +00001404
drhb1819a02009-07-03 15:37:27 +00001405// Disallow qualified table names on INSERT, UPDATE, and DELETE statements
1406// within a trigger. The table to INSERT, UPDATE, or DELETE is always in
1407// the same database as the table that the trigger fires on.
1408//
1409%type trnm {Token}
drh4dd0d3f2016-02-17 01:18:33 +00001410trnm(A) ::= nm(A).
drhb1819a02009-07-03 15:37:27 +00001411trnm(A) ::= nm DOT nm(X). {
1412 A = X;
1413 sqlite3ErrorMsg(pParse,
1414 "qualified table names are not allowed on INSERT, UPDATE, and DELETE "
1415 "statements within triggers");
1416}
1417
1418// Disallow the INDEX BY and NOT INDEXED clauses on UPDATE and DELETE
1419// statements within triggers. We make a specific error message for this
1420// since it is an exception to the default grammar rules.
1421//
1422tridxby ::= .
1423tridxby ::= INDEXED BY nm. {
1424 sqlite3ErrorMsg(pParse,
1425 "the INDEXED BY clause is not allowed on UPDATE or DELETE statements "
1426 "within triggers");
1427}
1428tridxby ::= NOT INDEXED. {
1429 sqlite3ErrorMsg(pParse,
1430 "the NOT INDEXED clause is not allowed on UPDATE or DELETE statements "
1431 "within triggers");
1432}
1433
1434
1435
drh0bb132b2004-07-20 14:06:51 +00001436%type trigger_cmd {TriggerStep*}
drh633e6d52008-07-28 19:34:53 +00001437%destructor trigger_cmd {sqlite3DeleteTriggerStep(pParse->db, $$);}
danielk1977c3f9bad2002-05-15 08:30:12 +00001438// UPDATE
drhb1819a02009-07-03 15:37:27 +00001439trigger_cmd(A) ::=
1440 UPDATE orconf(R) trnm(X) tridxby SET setlist(Y) where_opt(Z).
drh43303de2016-02-17 12:34:03 +00001441 {A = sqlite3TriggerUpdateStep(pParse->db, &X, Y, Z, R);}
danielk1977c3f9bad2002-05-15 08:30:12 +00001442
1443// INSERT
drh8981b902015-08-24 17:42:49 +00001444trigger_cmd(A) ::= insert_cmd(R) INTO trnm(X) idlist_opt(F) select(S).
drh43303de2016-02-17 12:34:03 +00001445 {A = sqlite3TriggerInsertStep(pParse->db, &X, F, S, R);/*A-overwrites-R*/}
danielk1977c3f9bad2002-05-15 08:30:12 +00001446
1447// DELETE
drhb1819a02009-07-03 15:37:27 +00001448trigger_cmd(A) ::= DELETE FROM trnm(X) tridxby where_opt(Y).
drh43303de2016-02-17 12:34:03 +00001449 {A = sqlite3TriggerDeleteStep(pParse->db, &X, Y);}
danielk1977c3f9bad2002-05-15 08:30:12 +00001450
1451// SELECT
drhcf82f0d2016-02-17 04:33:10 +00001452trigger_cmd(A) ::= select(X).
drh43303de2016-02-17 12:34:03 +00001453 {A = sqlite3TriggerSelectStep(pParse->db, X); /*A-overwrites-X*/}
danielk1977c3f9bad2002-05-15 08:30:12 +00001454
danielk19776f349032002-06-11 02:25:40 +00001455// The special RAISE expression that may occur in trigger programs
drh4b59ab52002-08-24 18:24:51 +00001456expr(A) ::= RAISE(X) LP IGNORE RP(Y). {
drhcf82f0d2016-02-17 04:33:10 +00001457 spanSet(&A,&X,&Y); /*A-overwrites-X*/
drhabfd35e2016-12-06 22:47:23 +00001458 A.pExpr = sqlite3PExpr(pParse, TK_RAISE, 0, 0);
drhb7916a72009-05-27 10:31:29 +00001459 if( A.pExpr ){
1460 A.pExpr->affinity = OE_Ignore;
drh8aa34ae2006-03-13 12:54:09 +00001461 }
drh4b59ab52002-08-24 18:24:51 +00001462}
drh74ad7fe2004-10-07 03:06:28 +00001463expr(A) ::= RAISE(X) LP raisetype(T) COMMA nm(Z) RP(Y). {
drhcf82f0d2016-02-17 04:33:10 +00001464 spanSet(&A,&X,&Y); /*A-overwrites-X*/
drhabfd35e2016-12-06 22:47:23 +00001465 A.pExpr = sqlite3ExprAlloc(pParse->db, TK_RAISE, &Z, 1);
drhb7916a72009-05-27 10:31:29 +00001466 if( A.pExpr ) {
1467 A.pExpr->affinity = (char)T;
drh8aa34ae2006-03-13 12:54:09 +00001468 }
drh4b59ab52002-08-24 18:24:51 +00001469}
drh154d4b22006-09-21 11:02:16 +00001470%endif !SQLITE_OMIT_TRIGGER
drhb7f91642004-10-31 02:22:47 +00001471
drh74ad7fe2004-10-07 03:06:28 +00001472%type raisetype {int}
1473raisetype(A) ::= ROLLBACK. {A = OE_Rollback;}
1474raisetype(A) ::= ABORT. {A = OE_Abort;}
1475raisetype(A) ::= FAIL. {A = OE_Fail;}
1476
danielk19776f349032002-06-11 02:25:40 +00001477
danielk1977c3f9bad2002-05-15 08:30:12 +00001478//////////////////////// DROP TRIGGER statement //////////////////////////////
drhb7f91642004-10-31 02:22:47 +00001479%ifndef SQLITE_OMIT_TRIGGER
drhfdd48a72006-09-11 23:45:48 +00001480cmd ::= DROP TRIGGER ifexists(NOERR) fullname(X). {
1481 sqlite3DropTrigger(pParse,X,NOERR);
danielk1977c3f9bad2002-05-15 08:30:12 +00001482}
drh154d4b22006-09-21 11:02:16 +00001483%endif !SQLITE_OMIT_TRIGGER
drh113088e2003-03-20 01:16:58 +00001484
1485//////////////////////// ATTACH DATABASE file AS name /////////////////////////
drhfdbcdee2007-03-27 14:44:50 +00001486%ifndef SQLITE_OMIT_ATTACH
danielk1977f744bb52005-12-06 17:19:11 +00001487cmd ::= ATTACH database_kw_opt expr(F) AS expr(D) key_opt(K). {
drhb7916a72009-05-27 10:31:29 +00001488 sqlite3Attach(pParse, F.pExpr, D.pExpr, K);
drh1c2d8412003-03-31 00:30:47 +00001489}
drhfdbcdee2007-03-27 14:44:50 +00001490cmd ::= DETACH database_kw_opt expr(D). {
drhb7916a72009-05-27 10:31:29 +00001491 sqlite3Detach(pParse, D.pExpr);
drhfdbcdee2007-03-27 14:44:50 +00001492}
1493
drhc4dd3fd2008-01-22 01:48:05 +00001494%type key_opt {Expr*}
drh633e6d52008-07-28 19:34:53 +00001495%destructor key_opt {sqlite3ExprDelete(pParse->db, $$);}
danielk1977f744bb52005-12-06 17:19:11 +00001496key_opt(A) ::= . { A = 0; }
drhb7916a72009-05-27 10:31:29 +00001497key_opt(A) ::= KEY expr(X). { A = X.pExpr; }
drh113088e2003-03-20 01:16:58 +00001498
1499database_kw_opt ::= DATABASE.
1500database_kw_opt ::= .
drhfdbcdee2007-03-27 14:44:50 +00001501%endif SQLITE_OMIT_ATTACH
drh4343fea2004-11-05 23:46:15 +00001502
1503////////////////////////// REINDEX collation //////////////////////////////////
1504%ifndef SQLITE_OMIT_REINDEX
1505cmd ::= REINDEX. {sqlite3Reindex(pParse, 0, 0);}
1506cmd ::= REINDEX nm(X) dbnm(Y). {sqlite3Reindex(pParse, &X, &Y);}
drh154d4b22006-09-21 11:02:16 +00001507%endif SQLITE_OMIT_REINDEX
danielk19779fd2a9a2004-11-12 13:42:30 +00001508
drh9f18e8a2005-07-08 12:13:04 +00001509/////////////////////////////////// ANALYZE ///////////////////////////////////
1510%ifndef SQLITE_OMIT_ANALYZE
1511cmd ::= ANALYZE. {sqlite3Analyze(pParse, 0, 0);}
1512cmd ::= ANALYZE nm(X) dbnm(Y). {sqlite3Analyze(pParse, &X, &Y);}
1513%endif
1514
danielk19779fd2a9a2004-11-12 13:42:30 +00001515//////////////////////// ALTER TABLE table ... ////////////////////////////////
1516%ifndef SQLITE_OMIT_ALTERTABLE
1517cmd ::= ALTER TABLE fullname(X) RENAME TO nm(Z). {
1518 sqlite3AlterRenameTable(pParse,X,&Z);
1519}
drh986dde72016-02-29 13:37:21 +00001520cmd ::= ALTER TABLE add_column_fullname
1521 ADD kwcolumn_opt columnname(Y) carglist. {
1522 Y.n = (int)(pParse->sLastToken.z-Y.z) + pParse->sLastToken.n;
danielk197719a8e7e2005-03-17 05:03:38 +00001523 sqlite3AlterFinishAddColumn(pParse, &Y);
1524}
1525add_column_fullname ::= fullname(X). {
drh4a642b62016-02-05 01:55:27 +00001526 disableLookaside(pParse);
danielk197719a8e7e2005-03-17 05:03:38 +00001527 sqlite3AlterBeginAddColumn(pParse, X);
1528}
1529kwcolumn_opt ::= .
1530kwcolumn_opt ::= COLUMNKW.
drh154d4b22006-09-21 11:02:16 +00001531%endif SQLITE_OMIT_ALTERTABLE
drhe09daa92006-06-10 13:29:31 +00001532
1533//////////////////////// CREATE VIRTUAL TABLE ... /////////////////////////////
1534%ifndef SQLITE_OMIT_VIRTUALTABLE
drhb9bb7c12006-06-11 23:41:55 +00001535cmd ::= create_vtab. {sqlite3VtabFinishParse(pParse,0);}
1536cmd ::= create_vtab LP vtabarglist RP(X). {sqlite3VtabFinishParse(pParse,&X);}
drhb421b892012-01-28 19:41:53 +00001537create_vtab ::= createkw VIRTUAL TABLE ifnotexists(E)
1538 nm(X) dbnm(Y) USING nm(Z). {
1539 sqlite3VtabBeginParse(pParse, &X, &Y, &Z, E);
drhb9bb7c12006-06-11 23:41:55 +00001540}
drhe09daa92006-06-10 13:29:31 +00001541vtabarglist ::= vtabarg.
1542vtabarglist ::= vtabarglist COMMA vtabarg.
drhb9bb7c12006-06-11 23:41:55 +00001543vtabarg ::= . {sqlite3VtabArgInit(pParse);}
1544vtabarg ::= vtabarg vtabargtoken.
1545vtabargtoken ::= ANY(X). {sqlite3VtabArgExtend(pParse,&X);}
1546vtabargtoken ::= lp anylist RP(X). {sqlite3VtabArgExtend(pParse,&X);}
1547lp ::= LP(X). {sqlite3VtabArgExtend(pParse,&X);}
1548anylist ::= .
drhaaac8b42009-05-11 18:22:30 +00001549anylist ::= anylist LP anylist RP.
1550anylist ::= anylist ANY.
drh154d4b22006-09-21 11:02:16 +00001551%endif SQLITE_OMIT_VIRTUALTABLE
drh8b471862014-01-11 13:22:17 +00001552
1553
1554//////////////////////// COMMON TABLE EXPRESSIONS ////////////////////////////
dan7d562db2014-01-11 19:19:36 +00001555%type with {With*}
1556%type wqlist {With*}
1557%destructor with {sqlite3WithDelete(pParse->db, $$);}
dan4e9119d2014-01-13 15:12:23 +00001558%destructor wqlist {sqlite3WithDelete(pParse->db, $$);}
dan7d562db2014-01-11 19:19:36 +00001559
1560with(A) ::= . {A = 0;}
drh8b471862014-01-11 13:22:17 +00001561%ifndef SQLITE_OMIT_CTE
dan7d562db2014-01-11 19:19:36 +00001562with(A) ::= WITH wqlist(W). { A = W; }
1563with(A) ::= WITH RECURSIVE wqlist(W). { A = W; }
1564
drh108aa002015-08-24 20:21:20 +00001565wqlist(A) ::= nm(X) eidlist_opt(Y) AS LP select(Z) RP. {
drhcf82f0d2016-02-17 04:33:10 +00001566 A = sqlite3WithAdd(pParse, 0, &X, Y, Z); /*A-overwrites-X*/
dan7d562db2014-01-11 19:19:36 +00001567}
drh4dd0d3f2016-02-17 01:18:33 +00001568wqlist(A) ::= wqlist(A) COMMA nm(X) eidlist_opt(Y) AS LP select(Z) RP. {
1569 A = sqlite3WithAdd(pParse, A, &X, Y, Z);
drh8b471862014-01-11 13:22:17 +00001570}
1571%endif SQLITE_OMIT_CTE