xref: /sqlite-3.40.0/src/expr.c (revision 355ef361)
1cce7d176Sdrh /*
2b19a2bc6Sdrh ** 2001 September 15
3cce7d176Sdrh **
4b19a2bc6Sdrh ** The author disclaims copyright to this source code.  In place of
5b19a2bc6Sdrh ** a legal notice, here is a blessing:
6cce7d176Sdrh **
7b19a2bc6Sdrh **    May you do good and not evil.
8b19a2bc6Sdrh **    May you find forgiveness for yourself and forgive others.
9b19a2bc6Sdrh **    May you share freely, never taking more than you give.
10cce7d176Sdrh **
11cce7d176Sdrh *************************************************************************
121ccde15dSdrh ** This file contains routines used for analyzing expressions and
13b19a2bc6Sdrh ** for generating VDBE code that evaluates expressions in SQLite.
14cce7d176Sdrh **
15*355ef361Sdrh ** $Id: expr.c,v 1.203 2005/06/06 16:59:24 drh Exp $
16cce7d176Sdrh */
17cce7d176Sdrh #include "sqliteInt.h"
1804738cb9Sdrh #include <ctype.h>
19a2e00042Sdrh 
20e014a838Sdanielk1977 /*
21e014a838Sdanielk1977 ** Return the 'affinity' of the expression pExpr if any.
22e014a838Sdanielk1977 **
23e014a838Sdanielk1977 ** If pExpr is a column, a reference to a column via an 'AS' alias,
24e014a838Sdanielk1977 ** or a sub-select with a column as the return value, then the
25e014a838Sdanielk1977 ** affinity of that column is returned. Otherwise, 0x00 is returned,
26e014a838Sdanielk1977 ** indicating no affinity for the expression.
27e014a838Sdanielk1977 **
28e014a838Sdanielk1977 ** i.e. the WHERE clause expresssions in the following statements all
29e014a838Sdanielk1977 ** have an affinity:
30e014a838Sdanielk1977 **
31e014a838Sdanielk1977 ** CREATE TABLE t1(a);
32e014a838Sdanielk1977 ** SELECT * FROM t1 WHERE a;
33e014a838Sdanielk1977 ** SELECT a AS b FROM t1 WHERE b;
34e014a838Sdanielk1977 ** SELECT * FROM t1 WHERE (select a from t1);
35e014a838Sdanielk1977 */
36bf3b721fSdanielk1977 char sqlite3ExprAffinity(Expr *pExpr){
37a37cdde0Sdanielk1977   if( pExpr->op==TK_AS ){
38bf3b721fSdanielk1977     return sqlite3ExprAffinity(pExpr->pLeft);
39a37cdde0Sdanielk1977   }
40a37cdde0Sdanielk1977   if( pExpr->op==TK_SELECT ){
41bf3b721fSdanielk1977     return sqlite3ExprAffinity(pExpr->pSelect->pEList->a[0].pExpr);
42a37cdde0Sdanielk1977   }
43a37cdde0Sdanielk1977   return pExpr->affinity;
44a37cdde0Sdanielk1977 }
45a37cdde0Sdanielk1977 
4653db1458Sdrh /*
470202b29eSdanielk1977 ** Return the default collation sequence for the expression pExpr. If
480202b29eSdanielk1977 ** there is no default collation type, return 0.
490202b29eSdanielk1977 */
507cedc8d4Sdanielk1977 CollSeq *sqlite3ExprCollSeq(Parse *pParse, Expr *pExpr){
517cedc8d4Sdanielk1977   CollSeq *pColl = 0;
520202b29eSdanielk1977   if( pExpr ){
537cedc8d4Sdanielk1977     pColl = pExpr->pColl;
547cedc8d4Sdanielk1977     if( pExpr->op==TK_AS && !pColl ){
557cedc8d4Sdanielk1977       return sqlite3ExprCollSeq(pParse, pExpr->pLeft);
560202b29eSdanielk1977     }
570202b29eSdanielk1977   }
587cedc8d4Sdanielk1977   if( sqlite3CheckCollSeq(pParse, pColl) ){
597cedc8d4Sdanielk1977     pColl = 0;
607cedc8d4Sdanielk1977   }
617cedc8d4Sdanielk1977   return pColl;
620202b29eSdanielk1977 }
630202b29eSdanielk1977 
640202b29eSdanielk1977 /*
65626a879aSdrh ** pExpr is an operand of a comparison operator.  aff2 is the
66626a879aSdrh ** type affinity of the other operand.  This routine returns the
6753db1458Sdrh ** type affinity that should be used for the comparison operator.
6853db1458Sdrh */
69e014a838Sdanielk1977 char sqlite3CompareAffinity(Expr *pExpr, char aff2){
70bf3b721fSdanielk1977   char aff1 = sqlite3ExprAffinity(pExpr);
71e014a838Sdanielk1977   if( aff1 && aff2 ){
72e014a838Sdanielk1977     /* Both sides of the comparison are columns. If one has numeric or
73e014a838Sdanielk1977     ** integer affinity, use that. Otherwise use no affinity.
74e014a838Sdanielk1977     */
75e014a838Sdanielk1977     if( aff1==SQLITE_AFF_INTEGER || aff2==SQLITE_AFF_INTEGER ){
76e014a838Sdanielk1977       return SQLITE_AFF_INTEGER;
77e014a838Sdanielk1977     }else if( aff1==SQLITE_AFF_NUMERIC || aff2==SQLITE_AFF_NUMERIC ){
78e014a838Sdanielk1977       return SQLITE_AFF_NUMERIC;
79e014a838Sdanielk1977     }else{
80e014a838Sdanielk1977       return SQLITE_AFF_NONE;
81e014a838Sdanielk1977     }
82e014a838Sdanielk1977   }else if( !aff1 && !aff2 ){
835f6a87b3Sdrh     /* Neither side of the comparison is a column.  Compare the
845f6a87b3Sdrh     ** results directly.
85e014a838Sdanielk1977     */
865f6a87b3Sdrh     /* return SQLITE_AFF_NUMERIC;  // Ticket #805 */
875f6a87b3Sdrh     return SQLITE_AFF_NONE;
88e014a838Sdanielk1977   }else{
89e014a838Sdanielk1977     /* One side is a column, the other is not. Use the columns affinity. */
90e014a838Sdanielk1977     return (aff1 + aff2);
91e014a838Sdanielk1977   }
92e014a838Sdanielk1977 }
93e014a838Sdanielk1977 
9453db1458Sdrh /*
9553db1458Sdrh ** pExpr is a comparison operator.  Return the type affinity that should
9653db1458Sdrh ** be applied to both operands prior to doing the comparison.
9753db1458Sdrh */
98e014a838Sdanielk1977 static char comparisonAffinity(Expr *pExpr){
99e014a838Sdanielk1977   char aff;
100e014a838Sdanielk1977   assert( pExpr->op==TK_EQ || pExpr->op==TK_IN || pExpr->op==TK_LT ||
101e014a838Sdanielk1977           pExpr->op==TK_GT || pExpr->op==TK_GE || pExpr->op==TK_LE ||
102e014a838Sdanielk1977           pExpr->op==TK_NE );
103e014a838Sdanielk1977   assert( pExpr->pLeft );
104bf3b721fSdanielk1977   aff = sqlite3ExprAffinity(pExpr->pLeft);
105e014a838Sdanielk1977   if( pExpr->pRight ){
106e014a838Sdanielk1977     aff = sqlite3CompareAffinity(pExpr->pRight, aff);
107e014a838Sdanielk1977   }
108e014a838Sdanielk1977   else if( pExpr->pSelect ){
109e014a838Sdanielk1977     aff = sqlite3CompareAffinity(pExpr->pSelect->pEList->a[0].pExpr, aff);
110e014a838Sdanielk1977   }
111e014a838Sdanielk1977   else if( !aff ){
112e014a838Sdanielk1977     aff = SQLITE_AFF_NUMERIC;
113e014a838Sdanielk1977   }
114e014a838Sdanielk1977   return aff;
115e014a838Sdanielk1977 }
116e014a838Sdanielk1977 
117e014a838Sdanielk1977 /*
118e014a838Sdanielk1977 ** pExpr is a comparison expression, eg. '=', '<', IN(...) etc.
119e014a838Sdanielk1977 ** idx_affinity is the affinity of an indexed column. Return true
120e014a838Sdanielk1977 ** if the index with affinity idx_affinity may be used to implement
121e014a838Sdanielk1977 ** the comparison in pExpr.
122e014a838Sdanielk1977 */
123e014a838Sdanielk1977 int sqlite3IndexAffinityOk(Expr *pExpr, char idx_affinity){
124e014a838Sdanielk1977   char aff = comparisonAffinity(pExpr);
125e014a838Sdanielk1977   return
126e014a838Sdanielk1977     (aff==SQLITE_AFF_NONE) ||
127e014a838Sdanielk1977     (aff==SQLITE_AFF_NUMERIC && idx_affinity==SQLITE_AFF_INTEGER) ||
128e014a838Sdanielk1977     (aff==SQLITE_AFF_INTEGER && idx_affinity==SQLITE_AFF_NUMERIC) ||
129e014a838Sdanielk1977     (aff==idx_affinity);
130e014a838Sdanielk1977 }
131e014a838Sdanielk1977 
132a37cdde0Sdanielk1977 /*
133a37cdde0Sdanielk1977 ** Return the P1 value that should be used for a binary comparison
134a37cdde0Sdanielk1977 ** opcode (OP_Eq, OP_Ge etc.) used to compare pExpr1 and pExpr2.
135a37cdde0Sdanielk1977 ** If jumpIfNull is true, then set the low byte of the returned
136a37cdde0Sdanielk1977 ** P1 value to tell the opcode to jump if either expression
137a37cdde0Sdanielk1977 ** evaluates to NULL.
138a37cdde0Sdanielk1977 */
139e014a838Sdanielk1977 static int binaryCompareP1(Expr *pExpr1, Expr *pExpr2, int jumpIfNull){
140bf3b721fSdanielk1977   char aff = sqlite3ExprAffinity(pExpr2);
141e014a838Sdanielk1977   return (((int)sqlite3CompareAffinity(pExpr1, aff))<<8)+(jumpIfNull?1:0);
142a37cdde0Sdanielk1977 }
143a37cdde0Sdanielk1977 
144a2e00042Sdrh /*
1450202b29eSdanielk1977 ** Return a pointer to the collation sequence that should be used by
1460202b29eSdanielk1977 ** a binary comparison operator comparing pLeft and pRight.
1470202b29eSdanielk1977 **
1480202b29eSdanielk1977 ** If the left hand expression has a collating sequence type, then it is
1490202b29eSdanielk1977 ** used. Otherwise the collation sequence for the right hand expression
1500202b29eSdanielk1977 ** is used, or the default (BINARY) if neither expression has a collating
1510202b29eSdanielk1977 ** type.
1520202b29eSdanielk1977 */
1537cedc8d4Sdanielk1977 static CollSeq* binaryCompareCollSeq(Parse *pParse, Expr *pLeft, Expr *pRight){
1547cedc8d4Sdanielk1977   CollSeq *pColl = sqlite3ExprCollSeq(pParse, pLeft);
1550202b29eSdanielk1977   if( !pColl ){
1567cedc8d4Sdanielk1977     pColl = sqlite3ExprCollSeq(pParse, pRight);
1570202b29eSdanielk1977   }
1580202b29eSdanielk1977   return pColl;
1590202b29eSdanielk1977 }
1600202b29eSdanielk1977 
1610202b29eSdanielk1977 /*
162be5c89acSdrh ** Generate code for a comparison operator.
163be5c89acSdrh */
164be5c89acSdrh static int codeCompare(
165be5c89acSdrh   Parse *pParse,    /* The parsing (and code generating) context */
166be5c89acSdrh   Expr *pLeft,      /* The left operand */
167be5c89acSdrh   Expr *pRight,     /* The right operand */
168be5c89acSdrh   int opcode,       /* The comparison opcode */
169be5c89acSdrh   int dest,         /* Jump here if true.  */
170be5c89acSdrh   int jumpIfNull    /* If true, jump if either operand is NULL */
171be5c89acSdrh ){
172be5c89acSdrh   int p1 = binaryCompareP1(pLeft, pRight, jumpIfNull);
173be5c89acSdrh   CollSeq *p3 = binaryCompareCollSeq(pParse, pLeft, pRight);
174be5c89acSdrh   return sqlite3VdbeOp3(pParse->pVdbe, opcode, p1, dest, (void*)p3, P3_COLLSEQ);
175be5c89acSdrh }
176be5c89acSdrh 
177be5c89acSdrh /*
178a76b5dfcSdrh ** Construct a new expression node and return a pointer to it.  Memory
179a76b5dfcSdrh ** for this node is obtained from sqliteMalloc().  The calling function
180a76b5dfcSdrh ** is responsible for making sure the node eventually gets freed.
181a76b5dfcSdrh */
182e4e72072Sdrh Expr *sqlite3Expr(int op, Expr *pLeft, Expr *pRight, const Token *pToken){
183a76b5dfcSdrh   Expr *pNew;
184a76b5dfcSdrh   pNew = sqliteMalloc( sizeof(Expr) );
185a76b5dfcSdrh   if( pNew==0 ){
186d5d56523Sdanielk1977     /* When malloc fails, delete pLeft and pRight. Expressions passed to
187d5d56523Sdanielk1977     ** this function must always be allocated with sqlite3Expr() for this
188d5d56523Sdanielk1977     ** reason.
189d5d56523Sdanielk1977     */
190d5d56523Sdanielk1977     sqlite3ExprDelete(pLeft);
191d5d56523Sdanielk1977     sqlite3ExprDelete(pRight);
192a76b5dfcSdrh     return 0;
193a76b5dfcSdrh   }
194a76b5dfcSdrh   pNew->op = op;
195a76b5dfcSdrh   pNew->pLeft = pLeft;
196a76b5dfcSdrh   pNew->pRight = pRight;
197a58fdfb1Sdanielk1977   pNew->iAgg = -1;
198a76b5dfcSdrh   if( pToken ){
1994b59ab5eSdrh     assert( pToken->dyn==0 );
200145716b3Sdrh     pNew->span = pNew->token = *pToken;
201145716b3Sdrh   }else if( pLeft && pRight ){
2024adee20fSdanielk1977     sqlite3ExprSpan(pNew, &pLeft->span, &pRight->span);
203a76b5dfcSdrh   }
204a76b5dfcSdrh   return pNew;
205a76b5dfcSdrh }
206a76b5dfcSdrh 
207a76b5dfcSdrh /*
2084e0cff60Sdrh ** When doing a nested parse, you can include terms in an expression
2094e0cff60Sdrh ** that look like this:   #0 #1 #2 ...  These terms refer to elements
2104e0cff60Sdrh ** on the stack.  "#0" (or just "#") means the top of the stack.
2112958a4e6Sdrh ** "#1" means the next down on the stack.  And so forth.  #-1 means
2122958a4e6Sdrh ** memory location 0.  #-2 means memory location 1.  And so forth.
2134e0cff60Sdrh **
2144e0cff60Sdrh ** This routine is called by the parser to deal with on of those terms.
2154e0cff60Sdrh ** It immediately generates code to store the value in a memory location.
2164e0cff60Sdrh ** The returns an expression that will code to extract the value from
2174e0cff60Sdrh ** that memory location as needed.
2184e0cff60Sdrh */
2194e0cff60Sdrh Expr *sqlite3RegisterExpr(Parse *pParse, Token *pToken){
2204e0cff60Sdrh   Vdbe *v = pParse->pVdbe;
2214e0cff60Sdrh   Expr *p;
2224e0cff60Sdrh   int depth;
2234e0cff60Sdrh   if( v==0 ) return 0;
2244e0cff60Sdrh   if( pParse->nested==0 ){
2254e0cff60Sdrh     sqlite3ErrorMsg(pParse, "near \"%T\": syntax error", pToken);
2264e0cff60Sdrh     return 0;
2274e0cff60Sdrh   }
2284e0cff60Sdrh   p = sqlite3Expr(TK_REGISTER, 0, 0, pToken);
22973c42a13Sdrh   if( p==0 ){
23073c42a13Sdrh     return 0;  /* Malloc failed */
23173c42a13Sdrh   }
2324e0cff60Sdrh   depth = atoi(&pToken->z[1]);
2332958a4e6Sdrh   if( depth>=0 ){
2344e0cff60Sdrh     p->iTable = pParse->nMem++;
2354e0cff60Sdrh     sqlite3VdbeAddOp(v, OP_Dup, depth, 0);
2364e0cff60Sdrh     sqlite3VdbeAddOp(v, OP_MemStore, p->iTable, 1);
2372958a4e6Sdrh   }else{
2382958a4e6Sdrh     p->iTable = -1-depth;
2392958a4e6Sdrh   }
2404e0cff60Sdrh   return p;
2414e0cff60Sdrh }
2424e0cff60Sdrh 
2434e0cff60Sdrh /*
24491bb0eedSdrh ** Join two expressions using an AND operator.  If either expression is
24591bb0eedSdrh ** NULL, then just return the other expression.
24691bb0eedSdrh */
24791bb0eedSdrh Expr *sqlite3ExprAnd(Expr *pLeft, Expr *pRight){
24891bb0eedSdrh   if( pLeft==0 ){
24991bb0eedSdrh     return pRight;
25091bb0eedSdrh   }else if( pRight==0 ){
25191bb0eedSdrh     return pLeft;
25291bb0eedSdrh   }else{
25391bb0eedSdrh     return sqlite3Expr(TK_AND, pLeft, pRight, 0);
25491bb0eedSdrh   }
25591bb0eedSdrh }
25691bb0eedSdrh 
25791bb0eedSdrh /*
2586977fea8Sdrh ** Set the Expr.span field of the given expression to span all
259a76b5dfcSdrh ** text between the two given tokens.
260a76b5dfcSdrh */
2614adee20fSdanielk1977 void sqlite3ExprSpan(Expr *pExpr, Token *pLeft, Token *pRight){
2624efc4754Sdrh   assert( pRight!=0 );
2634efc4754Sdrh   assert( pLeft!=0 );
26471c697efSdrh   if( !sqlite3_malloc_failed && pRight->z && pLeft->z ){
265ad6d9460Sdrh     assert( pLeft->dyn==0 || pLeft->z[pLeft->n]==0 );
266145716b3Sdrh     if( pLeft->dyn==0 && pRight->dyn==0 ){
2676977fea8Sdrh       pExpr->span.z = pLeft->z;
26897903fefSdrh       pExpr->span.n = pRight->n + (pRight->z - pLeft->z);
2694b59ab5eSdrh     }else{
2706977fea8Sdrh       pExpr->span.z = 0;
2714b59ab5eSdrh     }
272a76b5dfcSdrh   }
273a76b5dfcSdrh }
274a76b5dfcSdrh 
275a76b5dfcSdrh /*
276a76b5dfcSdrh ** Construct a new expression node for a function with multiple
277a76b5dfcSdrh ** arguments.
278a76b5dfcSdrh */
2794adee20fSdanielk1977 Expr *sqlite3ExprFunction(ExprList *pList, Token *pToken){
280a76b5dfcSdrh   Expr *pNew;
281a76b5dfcSdrh   pNew = sqliteMalloc( sizeof(Expr) );
282a76b5dfcSdrh   if( pNew==0 ){
283d5d56523Sdanielk1977     sqlite3ExprListDelete(pList); /* Avoid leaking memory when malloc fails */
284a76b5dfcSdrh     return 0;
285a76b5dfcSdrh   }
286a76b5dfcSdrh   pNew->op = TK_FUNCTION;
287a76b5dfcSdrh   pNew->pList = pList;
288a76b5dfcSdrh   if( pToken ){
2894b59ab5eSdrh     assert( pToken->dyn==0 );
290a76b5dfcSdrh     pNew->token = *pToken;
291a76b5dfcSdrh   }else{
292a76b5dfcSdrh     pNew->token.z = 0;
293a76b5dfcSdrh   }
2946977fea8Sdrh   pNew->span = pNew->token;
295a76b5dfcSdrh   return pNew;
296a76b5dfcSdrh }
297a76b5dfcSdrh 
298a76b5dfcSdrh /*
299fa6bc000Sdrh ** Assign a variable number to an expression that encodes a wildcard
300fa6bc000Sdrh ** in the original SQL statement.
301fa6bc000Sdrh **
302fa6bc000Sdrh ** Wildcards consisting of a single "?" are assigned the next sequential
303fa6bc000Sdrh ** variable number.
304fa6bc000Sdrh **
305fa6bc000Sdrh ** Wildcards of the form "?nnn" are assigned the number "nnn".  We make
306fa6bc000Sdrh ** sure "nnn" is not too be to avoid a denial of service attack when
307fa6bc000Sdrh ** the SQL statement comes from an external source.
308fa6bc000Sdrh **
309fa6bc000Sdrh ** Wildcards of the form ":aaa" or "$aaa" are assigned the same number
310fa6bc000Sdrh ** as the previous instance of the same wildcard.  Or if this is the first
311fa6bc000Sdrh ** instance of the wildcard, the next sequenial variable number is
312fa6bc000Sdrh ** assigned.
313fa6bc000Sdrh */
314fa6bc000Sdrh void sqlite3ExprAssignVarNumber(Parse *pParse, Expr *pExpr){
315fa6bc000Sdrh   Token *pToken;
316fa6bc000Sdrh   if( pExpr==0 ) return;
317fa6bc000Sdrh   pToken = &pExpr->token;
318fa6bc000Sdrh   assert( pToken->n>=1 );
319fa6bc000Sdrh   assert( pToken->z!=0 );
320fa6bc000Sdrh   assert( pToken->z[0]!=0 );
321fa6bc000Sdrh   if( pToken->n==1 ){
322fa6bc000Sdrh     /* Wildcard of the form "?".  Assign the next variable number */
323fa6bc000Sdrh     pExpr->iTable = ++pParse->nVar;
324fa6bc000Sdrh   }else if( pToken->z[0]=='?' ){
325fa6bc000Sdrh     /* Wildcard of the form "?nnn".  Convert "nnn" to an integer and
326fa6bc000Sdrh     ** use it as the variable number */
327fa6bc000Sdrh     int i;
328fa6bc000Sdrh     pExpr->iTable = i = atoi(&pToken->z[1]);
329fa6bc000Sdrh     if( i<1 || i>SQLITE_MAX_VARIABLE_NUMBER ){
330fa6bc000Sdrh       sqlite3ErrorMsg(pParse, "variable number must be between ?1 and ?%d",
331fa6bc000Sdrh           SQLITE_MAX_VARIABLE_NUMBER);
332fa6bc000Sdrh     }
333fa6bc000Sdrh     if( i>pParse->nVar ){
334fa6bc000Sdrh       pParse->nVar = i;
335fa6bc000Sdrh     }
336fa6bc000Sdrh   }else{
337fa6bc000Sdrh     /* Wildcards of the form ":aaa" or "$aaa".  Reuse the same variable
338fa6bc000Sdrh     ** number as the prior appearance of the same name, or if the name
339fa6bc000Sdrh     ** has never appeared before, reuse the same variable number
340fa6bc000Sdrh     */
341fa6bc000Sdrh     int i, n;
342fa6bc000Sdrh     n = pToken->n;
343fa6bc000Sdrh     for(i=0; i<pParse->nVarExpr; i++){
344fa6bc000Sdrh       Expr *pE;
345fa6bc000Sdrh       if( (pE = pParse->apVarExpr[i])!=0
346fa6bc000Sdrh           && pE->token.n==n
347fa6bc000Sdrh           && memcmp(pE->token.z, pToken->z, n)==0 ){
348fa6bc000Sdrh         pExpr->iTable = pE->iTable;
349fa6bc000Sdrh         break;
350fa6bc000Sdrh       }
351fa6bc000Sdrh     }
352fa6bc000Sdrh     if( i>=pParse->nVarExpr ){
353fa6bc000Sdrh       pExpr->iTable = ++pParse->nVar;
354fa6bc000Sdrh       if( pParse->nVarExpr>=pParse->nVarExprAlloc-1 ){
355fa6bc000Sdrh         pParse->nVarExprAlloc += pParse->nVarExprAlloc + 10;
356fa6bc000Sdrh         pParse->apVarExpr = sqliteRealloc(pParse->apVarExpr,
357fa6bc000Sdrh                        pParse->nVarExprAlloc*sizeof(pParse->apVarExpr[0]) );
358fa6bc000Sdrh       }
359fa6bc000Sdrh       if( !sqlite3_malloc_failed ){
360fa6bc000Sdrh         assert( pParse->apVarExpr!=0 );
361fa6bc000Sdrh         pParse->apVarExpr[pParse->nVarExpr++] = pExpr;
362fa6bc000Sdrh       }
363fa6bc000Sdrh     }
364fa6bc000Sdrh   }
365fa6bc000Sdrh }
366fa6bc000Sdrh 
367fa6bc000Sdrh /*
368a2e00042Sdrh ** Recursively delete an expression tree.
369a2e00042Sdrh */
3704adee20fSdanielk1977 void sqlite3ExprDelete(Expr *p){
371a2e00042Sdrh   if( p==0 ) return;
3724efc4754Sdrh   if( p->span.dyn ) sqliteFree((char*)p->span.z);
3734efc4754Sdrh   if( p->token.dyn ) sqliteFree((char*)p->token.z);
3744adee20fSdanielk1977   sqlite3ExprDelete(p->pLeft);
3754adee20fSdanielk1977   sqlite3ExprDelete(p->pRight);
3764adee20fSdanielk1977   sqlite3ExprListDelete(p->pList);
3774adee20fSdanielk1977   sqlite3SelectDelete(p->pSelect);
378a2e00042Sdrh   sqliteFree(p);
379a2e00042Sdrh }
380a2e00042Sdrh 
381a76b5dfcSdrh 
382a76b5dfcSdrh /*
383ff78bd2fSdrh ** The following group of routines make deep copies of expressions,
384ff78bd2fSdrh ** expression lists, ID lists, and select statements.  The copies can
385ff78bd2fSdrh ** be deleted (by being passed to their respective ...Delete() routines)
386ff78bd2fSdrh ** without effecting the originals.
387ff78bd2fSdrh **
3884adee20fSdanielk1977 ** The expression list, ID, and source lists return by sqlite3ExprListDup(),
3894adee20fSdanielk1977 ** sqlite3IdListDup(), and sqlite3SrcListDup() can not be further expanded
390ad3cab52Sdrh ** by subsequent calls to sqlite*ListAppend() routines.
391ff78bd2fSdrh **
392ad3cab52Sdrh ** Any tables that the SrcList might point to are not duplicated.
393ff78bd2fSdrh */
3944adee20fSdanielk1977 Expr *sqlite3ExprDup(Expr *p){
395ff78bd2fSdrh   Expr *pNew;
396ff78bd2fSdrh   if( p==0 ) return 0;
397fcb78a49Sdrh   pNew = sqliteMallocRaw( sizeof(*p) );
398ff78bd2fSdrh   if( pNew==0 ) return 0;
3993b167c75Sdrh   memcpy(pNew, p, sizeof(*pNew));
4006977fea8Sdrh   if( p->token.z!=0 ){
401b9ecf6faSdrh     pNew->token.z = sqliteStrNDup(p->token.z, p->token.n);
4024b59ab5eSdrh     pNew->token.dyn = 1;
4034b59ab5eSdrh   }else{
4044efc4754Sdrh     assert( pNew->token.z==0 );
4054b59ab5eSdrh   }
4066977fea8Sdrh   pNew->span.z = 0;
4074adee20fSdanielk1977   pNew->pLeft = sqlite3ExprDup(p->pLeft);
4084adee20fSdanielk1977   pNew->pRight = sqlite3ExprDup(p->pRight);
4094adee20fSdanielk1977   pNew->pList = sqlite3ExprListDup(p->pList);
4104adee20fSdanielk1977   pNew->pSelect = sqlite3SelectDup(p->pSelect);
411aee18ef8Sdanielk1977   pNew->pTab = p->pTab;
412ff78bd2fSdrh   return pNew;
413ff78bd2fSdrh }
4144adee20fSdanielk1977 void sqlite3TokenCopy(Token *pTo, Token *pFrom){
4154b59ab5eSdrh   if( pTo->dyn ) sqliteFree((char*)pTo->z);
4164b59ab5eSdrh   if( pFrom->z ){
4174b59ab5eSdrh     pTo->n = pFrom->n;
4184b59ab5eSdrh     pTo->z = sqliteStrNDup(pFrom->z, pFrom->n);
4194b59ab5eSdrh     pTo->dyn = 1;
4204b59ab5eSdrh   }else{
4214b59ab5eSdrh     pTo->z = 0;
4224b59ab5eSdrh   }
4234b59ab5eSdrh }
4244adee20fSdanielk1977 ExprList *sqlite3ExprListDup(ExprList *p){
425ff78bd2fSdrh   ExprList *pNew;
426145716b3Sdrh   struct ExprList_item *pItem, *pOldItem;
427ff78bd2fSdrh   int i;
428ff78bd2fSdrh   if( p==0 ) return 0;
429ff78bd2fSdrh   pNew = sqliteMalloc( sizeof(*pNew) );
430ff78bd2fSdrh   if( pNew==0 ) return 0;
4314305d103Sdrh   pNew->nExpr = pNew->nAlloc = p->nExpr;
4323e7bc9caSdrh   pNew->a = pItem = sqliteMalloc( p->nExpr*sizeof(p->a[0]) );
433e0048400Sdanielk1977   if( pItem==0 ){
434e0048400Sdanielk1977     sqliteFree(pNew);
435e0048400Sdanielk1977     return 0;
436e0048400Sdanielk1977   }
437145716b3Sdrh   pOldItem = p->a;
438145716b3Sdrh   for(i=0; i<p->nExpr; i++, pItem++, pOldItem++){
4394b59ab5eSdrh     Expr *pNewExpr, *pOldExpr;
440145716b3Sdrh     pItem->pExpr = pNewExpr = sqlite3ExprDup(pOldExpr = pOldItem->pExpr);
4416977fea8Sdrh     if( pOldExpr->span.z!=0 && pNewExpr ){
4426977fea8Sdrh       /* Always make a copy of the span for top-level expressions in the
4434b59ab5eSdrh       ** expression list.  The logic in SELECT processing that determines
4444b59ab5eSdrh       ** the names of columns in the result set needs this information */
4454adee20fSdanielk1977       sqlite3TokenCopy(&pNewExpr->span, &pOldExpr->span);
4464b59ab5eSdrh     }
4471f3e905cSdrh     assert( pNewExpr==0 || pNewExpr->span.z!=0
44824b03fd0Sdanielk1977             || pOldExpr->span.z==0 || sqlite3_malloc_failed );
449145716b3Sdrh     pItem->zName = sqliteStrDup(pOldItem->zName);
450145716b3Sdrh     pItem->sortOrder = pOldItem->sortOrder;
451145716b3Sdrh     pItem->isAgg = pOldItem->isAgg;
4523e7bc9caSdrh     pItem->done = 0;
453ff78bd2fSdrh   }
454ff78bd2fSdrh   return pNew;
455ff78bd2fSdrh }
45693758c8dSdanielk1977 
45793758c8dSdanielk1977 /*
45893758c8dSdanielk1977 ** If cursors, triggers, views and subqueries are all omitted from
45993758c8dSdanielk1977 ** the build, then none of the following routines, except for
46093758c8dSdanielk1977 ** sqlite3SelectDup(), can be called. sqlite3SelectDup() is sometimes
46193758c8dSdanielk1977 ** called with a NULL argument.
46293758c8dSdanielk1977 */
4636a67fe8eSdanielk1977 #if !defined(SQLITE_OMIT_VIEW) || !defined(SQLITE_OMIT_TRIGGER) \
4646a67fe8eSdanielk1977  || !defined(SQLITE_OMIT_SUBQUERY)
4654adee20fSdanielk1977 SrcList *sqlite3SrcListDup(SrcList *p){
466ad3cab52Sdrh   SrcList *pNew;
467ad3cab52Sdrh   int i;
468113088ecSdrh   int nByte;
469ad3cab52Sdrh   if( p==0 ) return 0;
470113088ecSdrh   nByte = sizeof(*p) + (p->nSrc>0 ? sizeof(p->a[0]) * (p->nSrc-1) : 0);
4714efc4754Sdrh   pNew = sqliteMallocRaw( nByte );
472ad3cab52Sdrh   if( pNew==0 ) return 0;
4734305d103Sdrh   pNew->nSrc = pNew->nAlloc = p->nSrc;
474ad3cab52Sdrh   for(i=0; i<p->nSrc; i++){
4754efc4754Sdrh     struct SrcList_item *pNewItem = &pNew->a[i];
4764efc4754Sdrh     struct SrcList_item *pOldItem = &p->a[i];
4774efc4754Sdrh     pNewItem->zDatabase = sqliteStrDup(pOldItem->zDatabase);
4784efc4754Sdrh     pNewItem->zName = sqliteStrDup(pOldItem->zName);
4794efc4754Sdrh     pNewItem->zAlias = sqliteStrDup(pOldItem->zAlias);
4804efc4754Sdrh     pNewItem->jointype = pOldItem->jointype;
4814efc4754Sdrh     pNewItem->iCursor = pOldItem->iCursor;
482a1cb183dSdanielk1977     pNewItem->pTab = pOldItem->pTab;
483a1cb183dSdanielk1977     if( pNewItem->pTab ){
484a1cb183dSdanielk1977       pNewItem->pTab->isTransient = 0;
485a1cb183dSdanielk1977     }
4864adee20fSdanielk1977     pNewItem->pSelect = sqlite3SelectDup(pOldItem->pSelect);
4874adee20fSdanielk1977     pNewItem->pOn = sqlite3ExprDup(pOldItem->pOn);
4884adee20fSdanielk1977     pNewItem->pUsing = sqlite3IdListDup(pOldItem->pUsing);
4896c18b6e0Sdanielk1977     pNewItem->colUsed = pOldItem->colUsed;
490ad3cab52Sdrh   }
491ad3cab52Sdrh   return pNew;
492ad3cab52Sdrh }
4934adee20fSdanielk1977 IdList *sqlite3IdListDup(IdList *p){
494ff78bd2fSdrh   IdList *pNew;
495ff78bd2fSdrh   int i;
496ff78bd2fSdrh   if( p==0 ) return 0;
4974efc4754Sdrh   pNew = sqliteMallocRaw( sizeof(*pNew) );
498ff78bd2fSdrh   if( pNew==0 ) return 0;
4994305d103Sdrh   pNew->nId = pNew->nAlloc = p->nId;
5004efc4754Sdrh   pNew->a = sqliteMallocRaw( p->nId*sizeof(p->a[0]) );
501d5d56523Sdanielk1977   if( pNew->a==0 ){
502d5d56523Sdanielk1977     sqliteFree(pNew);
503d5d56523Sdanielk1977     return 0;
504d5d56523Sdanielk1977   }
505ff78bd2fSdrh   for(i=0; i<p->nId; i++){
5064efc4754Sdrh     struct IdList_item *pNewItem = &pNew->a[i];
5074efc4754Sdrh     struct IdList_item *pOldItem = &p->a[i];
5084efc4754Sdrh     pNewItem->zName = sqliteStrDup(pOldItem->zName);
5094efc4754Sdrh     pNewItem->idx = pOldItem->idx;
510ff78bd2fSdrh   }
511ff78bd2fSdrh   return pNew;
512ff78bd2fSdrh }
5134adee20fSdanielk1977 Select *sqlite3SelectDup(Select *p){
514ff78bd2fSdrh   Select *pNew;
515ff78bd2fSdrh   if( p==0 ) return 0;
5164efc4754Sdrh   pNew = sqliteMallocRaw( sizeof(*p) );
517ff78bd2fSdrh   if( pNew==0 ) return 0;
518ff78bd2fSdrh   pNew->isDistinct = p->isDistinct;
5194adee20fSdanielk1977   pNew->pEList = sqlite3ExprListDup(p->pEList);
5204adee20fSdanielk1977   pNew->pSrc = sqlite3SrcListDup(p->pSrc);
5214adee20fSdanielk1977   pNew->pWhere = sqlite3ExprDup(p->pWhere);
5224adee20fSdanielk1977   pNew->pGroupBy = sqlite3ExprListDup(p->pGroupBy);
5234adee20fSdanielk1977   pNew->pHaving = sqlite3ExprDup(p->pHaving);
5244adee20fSdanielk1977   pNew->pOrderBy = sqlite3ExprListDup(p->pOrderBy);
525ff78bd2fSdrh   pNew->op = p->op;
5264adee20fSdanielk1977   pNew->pPrior = sqlite3SelectDup(p->pPrior);
527a2dc3b1aSdanielk1977   pNew->pLimit = sqlite3ExprDup(p->pLimit);
528a2dc3b1aSdanielk1977   pNew->pOffset = sqlite3ExprDup(p->pOffset);
5297b58daeaSdrh   pNew->iLimit = -1;
5307b58daeaSdrh   pNew->iOffset = -1;
531dc1bdc4fSdanielk1977   pNew->ppOpenTemp = 0;
532a1cb183dSdanielk1977   pNew->isResolved = p->isResolved;
533a1cb183dSdanielk1977   pNew->isAgg = p->isAgg;
534ff78bd2fSdrh   return pNew;
535ff78bd2fSdrh }
53693758c8dSdanielk1977 #else
53793758c8dSdanielk1977 Select *sqlite3SelectDup(Select *p){
53893758c8dSdanielk1977   assert( p==0 );
53993758c8dSdanielk1977   return 0;
54093758c8dSdanielk1977 }
54193758c8dSdanielk1977 #endif
542ff78bd2fSdrh 
543ff78bd2fSdrh 
544ff78bd2fSdrh /*
545a76b5dfcSdrh ** Add a new element to the end of an expression list.  If pList is
546a76b5dfcSdrh ** initially NULL, then create a new expression list.
547a76b5dfcSdrh */
5484adee20fSdanielk1977 ExprList *sqlite3ExprListAppend(ExprList *pList, Expr *pExpr, Token *pName){
549a76b5dfcSdrh   if( pList==0 ){
550a76b5dfcSdrh     pList = sqliteMalloc( sizeof(ExprList) );
551a76b5dfcSdrh     if( pList==0 ){
552d5d56523Sdanielk1977       goto no_mem;
553a76b5dfcSdrh     }
5544efc4754Sdrh     assert( pList->nAlloc==0 );
555a76b5dfcSdrh   }
5564305d103Sdrh   if( pList->nAlloc<=pList->nExpr ){
557d5d56523Sdanielk1977     struct ExprList_item *a;
558d5d56523Sdanielk1977     int n = pList->nAlloc*2 + 4;
559d5d56523Sdanielk1977     a = sqliteRealloc(pList->a, n*sizeof(pList->a[0]));
560d5d56523Sdanielk1977     if( a==0 ){
561d5d56523Sdanielk1977       goto no_mem;
562a76b5dfcSdrh     }
563d5d56523Sdanielk1977     pList->a = a;
564d5d56523Sdanielk1977     pList->nAlloc = n;
565a76b5dfcSdrh   }
5664efc4754Sdrh   assert( pList->a!=0 );
5674efc4754Sdrh   if( pExpr || pName ){
5684efc4754Sdrh     struct ExprList_item *pItem = &pList->a[pList->nExpr++];
5694efc4754Sdrh     memset(pItem, 0, sizeof(*pItem));
570a99db3b6Sdrh     pItem->zName = sqlite3NameFromToken(pName);
571e94ddc9eSdanielk1977     pItem->pExpr = pExpr;
572a76b5dfcSdrh   }
573a76b5dfcSdrh   return pList;
574d5d56523Sdanielk1977 
575d5d56523Sdanielk1977 no_mem:
576d5d56523Sdanielk1977   /* Avoid leaking memory if malloc has failed. */
577d5d56523Sdanielk1977   sqlite3ExprDelete(pExpr);
578d5d56523Sdanielk1977   sqlite3ExprListDelete(pList);
579d5d56523Sdanielk1977   return 0;
580a76b5dfcSdrh }
581a76b5dfcSdrh 
582a76b5dfcSdrh /*
583a76b5dfcSdrh ** Delete an entire expression list.
584a76b5dfcSdrh */
5854adee20fSdanielk1977 void sqlite3ExprListDelete(ExprList *pList){
586a76b5dfcSdrh   int i;
587be5c89acSdrh   struct ExprList_item *pItem;
588a76b5dfcSdrh   if( pList==0 ) return;
5891bdd9b57Sdrh   assert( pList->a!=0 || (pList->nExpr==0 && pList->nAlloc==0) );
5901bdd9b57Sdrh   assert( pList->nExpr<=pList->nAlloc );
591be5c89acSdrh   for(pItem=pList->a, i=0; i<pList->nExpr; i++, pItem++){
592be5c89acSdrh     sqlite3ExprDelete(pItem->pExpr);
593be5c89acSdrh     sqliteFree(pItem->zName);
594a76b5dfcSdrh   }
595a76b5dfcSdrh   sqliteFree(pList->a);
596a76b5dfcSdrh   sqliteFree(pList);
597a76b5dfcSdrh }
598a76b5dfcSdrh 
599a76b5dfcSdrh /*
600626a879aSdrh ** Walk an expression tree.  Call xFunc for each node visited.
60173b211abSdrh **
602626a879aSdrh ** The return value from xFunc determines whether the tree walk continues.
603626a879aSdrh ** 0 means continue walking the tree.  1 means do not walk children
604626a879aSdrh ** of the current node but continue with siblings.  2 means abandon
605626a879aSdrh ** the tree walk completely.
606626a879aSdrh **
607626a879aSdrh ** The return value from this routine is 1 to abandon the tree walk
608626a879aSdrh ** and 0 to continue.
609626a879aSdrh */
610a58fdfb1Sdanielk1977 static int walkExprList(ExprList *, int (*)(void *, Expr*), void *);
611626a879aSdrh static int walkExprTree(Expr *pExpr, int (*xFunc)(void*,Expr*), void *pArg){
612626a879aSdrh   int rc;
613626a879aSdrh   if( pExpr==0 ) return 0;
614626a879aSdrh   rc = (*xFunc)(pArg, pExpr);
615626a879aSdrh   if( rc==0 ){
616626a879aSdrh     if( walkExprTree(pExpr->pLeft, xFunc, pArg) ) return 1;
617626a879aSdrh     if( walkExprTree(pExpr->pRight, xFunc, pArg) ) return 1;
618a58fdfb1Sdanielk1977     if( walkExprList(pExpr->pList, xFunc, pArg) ) return 1;
619626a879aSdrh   }
620626a879aSdrh   return rc>1;
621626a879aSdrh }
622626a879aSdrh 
623626a879aSdrh /*
624a58fdfb1Sdanielk1977 ** Call walkExprTree() for every expression in list p.
625a58fdfb1Sdanielk1977 */
626a58fdfb1Sdanielk1977 static int walkExprList(ExprList *p, int (*xFunc)(void *, Expr*), void *pArg){
627a58fdfb1Sdanielk1977   int i;
628a58fdfb1Sdanielk1977   struct ExprList_item *pItem;
629a58fdfb1Sdanielk1977   if( !p ) return 0;
630a58fdfb1Sdanielk1977   for(i=p->nExpr, pItem=p->a; i>0; i--, pItem++){
631a58fdfb1Sdanielk1977     if( walkExprTree(pItem->pExpr, xFunc, pArg) ) return 1;
632a58fdfb1Sdanielk1977   }
633a58fdfb1Sdanielk1977   return 0;
634a58fdfb1Sdanielk1977 }
635a58fdfb1Sdanielk1977 
636a58fdfb1Sdanielk1977 /*
637a58fdfb1Sdanielk1977 ** Call walkExprTree() for every expression in Select p, not including
638a58fdfb1Sdanielk1977 ** expressions that are part of sub-selects in any FROM clause or the LIMIT
639a58fdfb1Sdanielk1977 ** or OFFSET expressions..
640a58fdfb1Sdanielk1977 */
641a58fdfb1Sdanielk1977 static int walkSelectExpr(Select *p, int (*xFunc)(void *, Expr*), void *pArg){
642a58fdfb1Sdanielk1977   walkExprList(p->pEList, xFunc, pArg);
643a58fdfb1Sdanielk1977   walkExprTree(p->pWhere, xFunc, pArg);
644a58fdfb1Sdanielk1977   walkExprList(p->pGroupBy, xFunc, pArg);
645a58fdfb1Sdanielk1977   walkExprTree(p->pHaving, xFunc, pArg);
646a58fdfb1Sdanielk1977   walkExprList(p->pOrderBy, xFunc, pArg);
647a58fdfb1Sdanielk1977   return 0;
648a58fdfb1Sdanielk1977 }
649a58fdfb1Sdanielk1977 
650a58fdfb1Sdanielk1977 
651a58fdfb1Sdanielk1977 /*
652626a879aSdrh ** This routine is designed as an xFunc for walkExprTree().
653626a879aSdrh **
654626a879aSdrh ** pArg is really a pointer to an integer.  If we can tell by looking
65573b211abSdrh ** at pExpr that the expression that contains pExpr is not a constant
65673b211abSdrh ** expression, then set *pArg to 0 and return 2 to abandon the tree walk.
65773b211abSdrh ** If pExpr does does not disqualify the expression from being a constant
65873b211abSdrh ** then do nothing.
65973b211abSdrh **
66073b211abSdrh ** After walking the whole tree, if no nodes are found that disqualify
66173b211abSdrh ** the expression as constant, then we assume the whole expression
66273b211abSdrh ** is constant.  See sqlite3ExprIsConstant() for additional information.
663626a879aSdrh */
664626a879aSdrh static int exprNodeIsConstant(void *pArg, Expr *pExpr){
665626a879aSdrh   switch( pExpr->op ){
666626a879aSdrh     case TK_ID:
667626a879aSdrh     case TK_COLUMN:
668626a879aSdrh     case TK_DOT:
669626a879aSdrh     case TK_AGG_FUNCTION:
670626a879aSdrh     case TK_FUNCTION:
671fe2093d7Sdrh #ifndef SQLITE_OMIT_SUBQUERY
672fe2093d7Sdrh     case TK_SELECT:
673fe2093d7Sdrh     case TK_EXISTS:
674fe2093d7Sdrh #endif
675626a879aSdrh       *((int*)pArg) = 0;
676626a879aSdrh       return 2;
677626a879aSdrh     default:
678626a879aSdrh       return 0;
679626a879aSdrh   }
680626a879aSdrh }
681626a879aSdrh 
682626a879aSdrh /*
683fef5208cSdrh ** Walk an expression tree.  Return 1 if the expression is constant
684fef5208cSdrh ** and 0 if it involves variables.
6852398937bSdrh **
6862398937bSdrh ** For the purposes of this function, a double-quoted string (ex: "abc")
6872398937bSdrh ** is considered a variable but a single-quoted string (ex: 'abc') is
6882398937bSdrh ** a constant.
689fef5208cSdrh */
6904adee20fSdanielk1977 int sqlite3ExprIsConstant(Expr *p){
691626a879aSdrh   int isConst = 1;
692626a879aSdrh   walkExprTree(p, exprNodeIsConstant, &isConst);
693626a879aSdrh   return isConst;
694fef5208cSdrh }
695fef5208cSdrh 
696fef5208cSdrh /*
69773b211abSdrh ** If the expression p codes a constant integer that is small enough
698202b2df7Sdrh ** to fit in a 32-bit integer, return 1 and put the value of the integer
699202b2df7Sdrh ** in *pValue.  If the expression is not an integer or if it is too big
700202b2df7Sdrh ** to fit in a signed 32-bit integer, return 0 and leave *pValue unchanged.
701e4de1febSdrh */
7024adee20fSdanielk1977 int sqlite3ExprIsInteger(Expr *p, int *pValue){
703e4de1febSdrh   switch( p->op ){
704e4de1febSdrh     case TK_INTEGER: {
705fec19aadSdrh       if( sqlite3GetInt32(p->token.z, pValue) ){
706e4de1febSdrh         return 1;
707e4de1febSdrh       }
708202b2df7Sdrh       break;
709202b2df7Sdrh     }
7104b59ab5eSdrh     case TK_UPLUS: {
7114adee20fSdanielk1977       return sqlite3ExprIsInteger(p->pLeft, pValue);
7124b59ab5eSdrh     }
713e4de1febSdrh     case TK_UMINUS: {
714e4de1febSdrh       int v;
7154adee20fSdanielk1977       if( sqlite3ExprIsInteger(p->pLeft, &v) ){
716e4de1febSdrh         *pValue = -v;
717e4de1febSdrh         return 1;
718e4de1febSdrh       }
719e4de1febSdrh       break;
720e4de1febSdrh     }
721e4de1febSdrh     default: break;
722e4de1febSdrh   }
723e4de1febSdrh   return 0;
724e4de1febSdrh }
725e4de1febSdrh 
726e4de1febSdrh /*
727c4a3c779Sdrh ** Return TRUE if the given string is a row-id column name.
728c4a3c779Sdrh */
7294adee20fSdanielk1977 int sqlite3IsRowid(const char *z){
7304adee20fSdanielk1977   if( sqlite3StrICmp(z, "_ROWID_")==0 ) return 1;
7314adee20fSdanielk1977   if( sqlite3StrICmp(z, "ROWID")==0 ) return 1;
7324adee20fSdanielk1977   if( sqlite3StrICmp(z, "OID")==0 ) return 1;
733c4a3c779Sdrh   return 0;
734c4a3c779Sdrh }
735c4a3c779Sdrh 
736c4a3c779Sdrh /*
7378141f61eSdrh ** Given the name of a column of the form X.Y.Z or Y.Z or just Z, look up
7388141f61eSdrh ** that name in the set of source tables in pSrcList and make the pExpr
7398141f61eSdrh ** expression node refer back to that source column.  The following changes
7408141f61eSdrh ** are made to pExpr:
7418141f61eSdrh **
7428141f61eSdrh **    pExpr->iDb           Set the index in db->aDb[] of the database holding
7438141f61eSdrh **                         the table.
7448141f61eSdrh **    pExpr->iTable        Set to the cursor number for the table obtained
7458141f61eSdrh **                         from pSrcList.
7468141f61eSdrh **    pExpr->iColumn       Set to the column number within the table.
7478141f61eSdrh **    pExpr->op            Set to TK_COLUMN.
7488141f61eSdrh **    pExpr->pLeft         Any expression this points to is deleted
7498141f61eSdrh **    pExpr->pRight        Any expression this points to is deleted.
7508141f61eSdrh **
7518141f61eSdrh ** The pDbToken is the name of the database (the "X").  This value may be
7528141f61eSdrh ** NULL meaning that name is of the form Y.Z or Z.  Any available database
7538141f61eSdrh ** can be used.  The pTableToken is the name of the table (the "Y").  This
7548141f61eSdrh ** value can be NULL if pDbToken is also NULL.  If pTableToken is NULL it
7558141f61eSdrh ** means that the form of the name is Z and that columns from any table
7568141f61eSdrh ** can be used.
7578141f61eSdrh **
7588141f61eSdrh ** If the name cannot be resolved unambiguously, leave an error message
7598141f61eSdrh ** in pParse and return non-zero.  Return zero on success.
7608141f61eSdrh */
7618141f61eSdrh static int lookupName(
7628141f61eSdrh   Parse *pParse,      /* The parsing context */
7638141f61eSdrh   Token *pDbToken,     /* Name of the database containing table, or NULL */
7648141f61eSdrh   Token *pTableToken,  /* Name of table containing column, or NULL */
7658141f61eSdrh   Token *pColumnToken, /* Name of the column. */
766626a879aSdrh   NameContext *pNC,    /* The name context used to resolve the name */
7678141f61eSdrh   Expr *pExpr          /* Make this EXPR node point to the selected column */
7688141f61eSdrh ){
7698141f61eSdrh   char *zDb = 0;       /* Name of the database.  The "X" in X.Y.Z */
7708141f61eSdrh   char *zTab = 0;      /* Name of the table.  The "Y" in X.Y.Z or Y.Z */
7718141f61eSdrh   char *zCol = 0;      /* Name of the column.  The "Z" */
7728141f61eSdrh   int i, j;            /* Loop counters */
7738141f61eSdrh   int cnt = 0;         /* Number of matching column names */
7748141f61eSdrh   int cntTab = 0;      /* Number of matching table names */
7759bb575fdSdrh   sqlite3 *db = pParse->db;  /* The database */
77651669863Sdrh   struct SrcList_item *pItem;       /* Use for looping over pSrcList items */
77751669863Sdrh   struct SrcList_item *pMatch = 0;  /* The matching pSrcList item */
77873b211abSdrh   NameContext *pTopNC = pNC;        /* First namecontext in the list */
7798141f61eSdrh 
7808141f61eSdrh   assert( pColumnToken && pColumnToken->z ); /* The Z in X.Y.Z cannot be NULL */
781a99db3b6Sdrh   zDb = sqlite3NameFromToken(pDbToken);
782a99db3b6Sdrh   zTab = sqlite3NameFromToken(pTableToken);
783a99db3b6Sdrh   zCol = sqlite3NameFromToken(pColumnToken);
78424b03fd0Sdanielk1977   if( sqlite3_malloc_failed ){
785d5d56523Sdanielk1977     goto lookupname_end;
7868141f61eSdrh   }
7878141f61eSdrh 
7888141f61eSdrh   pExpr->iTable = -1;
789626a879aSdrh   while( pNC && cnt==0 ){
790626a879aSdrh     SrcList *pSrcList = pNC->pSrcList;
791626a879aSdrh     ExprList *pEList = pNC->pEList;
792626a879aSdrh 
793626a879aSdrh     /* assert( zTab==0 || pEList==0 ); */
794b3bce662Sdanielk1977     if( pSrcList ){
79551669863Sdrh       for(i=0, pItem=pSrcList->a; i<pSrcList->nSrc; i++, pItem++){
7968141f61eSdrh         Table *pTab = pItem->pTab;
7978141f61eSdrh         Column *pCol;
7988141f61eSdrh 
7998141f61eSdrh         if( pTab==0 ) continue;
8008141f61eSdrh         assert( pTab->nCol>0 );
8018141f61eSdrh         if( zTab ){
8028141f61eSdrh           if( pItem->zAlias ){
8038141f61eSdrh             char *zTabName = pItem->zAlias;
8044adee20fSdanielk1977             if( sqlite3StrICmp(zTabName, zTab)!=0 ) continue;
8058141f61eSdrh           }else{
8068141f61eSdrh             char *zTabName = pTab->zName;
8074adee20fSdanielk1977             if( zTabName==0 || sqlite3StrICmp(zTabName, zTab)!=0 ) continue;
8084adee20fSdanielk1977             if( zDb!=0 && sqlite3StrICmp(db->aDb[pTab->iDb].zName, zDb)!=0 ){
8098141f61eSdrh               continue;
8108141f61eSdrh             }
8118141f61eSdrh           }
8128141f61eSdrh         }
8138141f61eSdrh         if( 0==(cntTab++) ){
8148141f61eSdrh           pExpr->iTable = pItem->iCursor;
8158141f61eSdrh           pExpr->iDb = pTab->iDb;
81651669863Sdrh           pMatch = pItem;
8178141f61eSdrh         }
8188141f61eSdrh         for(j=0, pCol=pTab->aCol; j<pTab->nCol; j++, pCol++){
8194adee20fSdanielk1977           if( sqlite3StrICmp(pCol->zName, zCol)==0 ){
8208141f61eSdrh             cnt++;
8218141f61eSdrh             pExpr->iTable = pItem->iCursor;
82251669863Sdrh             pMatch = pItem;
8238141f61eSdrh             pExpr->iDb = pTab->iDb;
8248141f61eSdrh             /* Substitute the rowid (column -1) for the INTEGER PRIMARY KEY */
8258141f61eSdrh             pExpr->iColumn = j==pTab->iPKey ? -1 : j;
826a37cdde0Sdanielk1977             pExpr->affinity = pTab->aCol[j].affinity;
8270202b29eSdanielk1977             pExpr->pColl = pTab->aCol[j].pColl;
828*355ef361Sdrh             if( pItem->jointype & JT_NATURAL ){
829*355ef361Sdrh               /* If this match occurred in the left table of a natural join,
830*355ef361Sdrh               ** then skip the right table to avoid a duplicate match */
831*355ef361Sdrh               pItem++;
832*355ef361Sdrh               i++;
833*355ef361Sdrh             }
8348141f61eSdrh             break;
8358141f61eSdrh           }
8368141f61eSdrh         }
8378141f61eSdrh       }
838b3bce662Sdanielk1977     }
8398141f61eSdrh 
840b7f9164eSdrh #ifndef SQLITE_OMIT_TRIGGER
8418141f61eSdrh     /* If we have not already resolved the name, then maybe
8428141f61eSdrh     ** it is a new.* or old.* trigger argument reference
8438141f61eSdrh     */
8448141f61eSdrh     if( zDb==0 && zTab!=0 && cnt==0 && pParse->trigStack!=0 ){
8458141f61eSdrh       TriggerStack *pTriggerStack = pParse->trigStack;
8468141f61eSdrh       Table *pTab = 0;
8474adee20fSdanielk1977       if( pTriggerStack->newIdx != -1 && sqlite3StrICmp("new", zTab) == 0 ){
8488141f61eSdrh         pExpr->iTable = pTriggerStack->newIdx;
8498141f61eSdrh         assert( pTriggerStack->pTab );
8508141f61eSdrh         pTab = pTriggerStack->pTab;
8514adee20fSdanielk1977       }else if( pTriggerStack->oldIdx != -1 && sqlite3StrICmp("old", zTab)==0 ){
8528141f61eSdrh         pExpr->iTable = pTriggerStack->oldIdx;
8538141f61eSdrh         assert( pTriggerStack->pTab );
8548141f61eSdrh         pTab = pTriggerStack->pTab;
8558141f61eSdrh       }
8568141f61eSdrh 
8578141f61eSdrh       if( pTab ){
8588141f61eSdrh         int j;
8598141f61eSdrh         Column *pCol = pTab->aCol;
8608141f61eSdrh 
8618141f61eSdrh         pExpr->iDb = pTab->iDb;
8628141f61eSdrh         cntTab++;
8638141f61eSdrh         for(j=0; j < pTab->nCol; j++, pCol++) {
8644adee20fSdanielk1977           if( sqlite3StrICmp(pCol->zName, zCol)==0 ){
8658141f61eSdrh             cnt++;
8668141f61eSdrh             pExpr->iColumn = j==pTab->iPKey ? -1 : j;
867a37cdde0Sdanielk1977             pExpr->affinity = pTab->aCol[j].affinity;
8680202b29eSdanielk1977             pExpr->pColl = pTab->aCol[j].pColl;
869aee18ef8Sdanielk1977             pExpr->pTab = pTab;
8708141f61eSdrh             break;
8718141f61eSdrh           }
8728141f61eSdrh         }
8738141f61eSdrh       }
8748141f61eSdrh     }
875b7f9164eSdrh #endif /* !defined(SQLITE_OMIT_TRIGGER) */
8768141f61eSdrh 
8778141f61eSdrh     /*
8788141f61eSdrh     ** Perhaps the name is a reference to the ROWID
8798141f61eSdrh     */
8804adee20fSdanielk1977     if( cnt==0 && cntTab==1 && sqlite3IsRowid(zCol) ){
8818141f61eSdrh       cnt = 1;
8828141f61eSdrh       pExpr->iColumn = -1;
883a37cdde0Sdanielk1977       pExpr->affinity = SQLITE_AFF_INTEGER;
8848141f61eSdrh     }
8858141f61eSdrh 
8868141f61eSdrh     /*
8878141f61eSdrh     ** If the input is of the form Z (not Y.Z or X.Y.Z) then the name Z
8888141f61eSdrh     ** might refer to an result-set alias.  This happens, for example, when
8898141f61eSdrh     ** we are resolving names in the WHERE clause of the following command:
8908141f61eSdrh     **
8918141f61eSdrh     **     SELECT a+b AS x FROM table WHERE x<10;
8928141f61eSdrh     **
8938141f61eSdrh     ** In cases like this, replace pExpr with a copy of the expression that
8948141f61eSdrh     ** forms the result set entry ("a+b" in the example) and return immediately.
8958141f61eSdrh     ** Note that the expression in the result set should have already been
8968141f61eSdrh     ** resolved by the time the WHERE clause is resolved.
8978141f61eSdrh     */
89879d5f63fSdrh     if( cnt==0 && pEList!=0 && zTab==0 ){
8998141f61eSdrh       for(j=0; j<pEList->nExpr; j++){
9008141f61eSdrh         char *zAs = pEList->a[j].zName;
9014adee20fSdanielk1977         if( zAs!=0 && sqlite3StrICmp(zAs, zCol)==0 ){
9028141f61eSdrh           assert( pExpr->pLeft==0 && pExpr->pRight==0 );
9038141f61eSdrh           pExpr->op = TK_AS;
9048141f61eSdrh           pExpr->iColumn = j;
9054adee20fSdanielk1977           pExpr->pLeft = sqlite3ExprDup(pEList->a[j].pExpr);
90615ccce1cSdrh           cnt = 1;
9078141f61eSdrh           assert( zTab==0 && zDb==0 );
90815ccce1cSdrh           goto lookupname_end_2;
9098141f61eSdrh         }
9108141f61eSdrh       }
9118141f61eSdrh     }
9128141f61eSdrh 
913626a879aSdrh     /* Advance to the next name context.  The loop will exit when either
914626a879aSdrh     ** we have a match (cnt>0) or when we run out of name contexts.
915626a879aSdrh     */
916626a879aSdrh     if( cnt==0 ){
917626a879aSdrh       pNC = pNC->pNext;
918626a879aSdrh     }
919626a879aSdrh   }
920626a879aSdrh 
9218141f61eSdrh   /*
9228141f61eSdrh   ** If X and Y are NULL (in other words if only the column name Z is
9238141f61eSdrh   ** supplied) and the value of Z is enclosed in double-quotes, then
9248141f61eSdrh   ** Z is a string literal if it doesn't match any column names.  In that
9258141f61eSdrh   ** case, we need to return right away and not make any changes to
9268141f61eSdrh   ** pExpr.
92715ccce1cSdrh   **
92815ccce1cSdrh   ** Because no reference was made to outer contexts, the pNC->nRef
92915ccce1cSdrh   ** fields are not changed in any context.
9308141f61eSdrh   */
9318141f61eSdrh   if( cnt==0 && zTab==0 && pColumnToken->z[0]=='"' ){
9328141f61eSdrh     sqliteFree(zCol);
9338141f61eSdrh     return 0;
9348141f61eSdrh   }
9358141f61eSdrh 
9368141f61eSdrh   /*
9378141f61eSdrh   ** cnt==0 means there was not match.  cnt>1 means there were two or
9388141f61eSdrh   ** more matches.  Either way, we have an error.
9398141f61eSdrh   */
9408141f61eSdrh   if( cnt!=1 ){
9418141f61eSdrh     char *z = 0;
9428141f61eSdrh     char *zErr;
9438141f61eSdrh     zErr = cnt==0 ? "no such column: %s" : "ambiguous column name: %s";
9448141f61eSdrh     if( zDb ){
9454adee20fSdanielk1977       sqlite3SetString(&z, zDb, ".", zTab, ".", zCol, 0);
9468141f61eSdrh     }else if( zTab ){
9474adee20fSdanielk1977       sqlite3SetString(&z, zTab, ".", zCol, 0);
9488141f61eSdrh     }else{
9498141f61eSdrh       z = sqliteStrDup(zCol);
9508141f61eSdrh     }
9514adee20fSdanielk1977     sqlite3ErrorMsg(pParse, zErr, z);
9528141f61eSdrh     sqliteFree(z);
95373b211abSdrh     pTopNC->nErr++;
9548141f61eSdrh   }
9558141f61eSdrh 
95651669863Sdrh   /* If a column from a table in pSrcList is referenced, then record
95751669863Sdrh   ** this fact in the pSrcList.a[].colUsed bitmask.  Column 0 causes
95851669863Sdrh   ** bit 0 to be set.  Column 1 sets bit 1.  And so forth.  If the
95951669863Sdrh   ** column number is greater than the number of bits in the bitmask
96051669863Sdrh   ** then set the high-order bit of the bitmask.
96151669863Sdrh   */
96251669863Sdrh   if( pExpr->iColumn>=0 && pMatch!=0 ){
96351669863Sdrh     int n = pExpr->iColumn;
96451669863Sdrh     if( n>=sizeof(Bitmask)*8 ){
96551669863Sdrh       n = sizeof(Bitmask)*8-1;
96651669863Sdrh     }
96751669863Sdrh     assert( pMatch->iCursor==pExpr->iTable );
96851669863Sdrh     pMatch->colUsed |= 1<<n;
96951669863Sdrh   }
97051669863Sdrh 
971d5d56523Sdanielk1977 lookupname_end:
9728141f61eSdrh   /* Clean up and return
9738141f61eSdrh   */
9748141f61eSdrh   sqliteFree(zDb);
9758141f61eSdrh   sqliteFree(zTab);
9764adee20fSdanielk1977   sqlite3ExprDelete(pExpr->pLeft);
9778141f61eSdrh   pExpr->pLeft = 0;
9784adee20fSdanielk1977   sqlite3ExprDelete(pExpr->pRight);
9798141f61eSdrh   pExpr->pRight = 0;
9808141f61eSdrh   pExpr->op = TK_COLUMN;
98115ccce1cSdrh lookupname_end_2:
98215ccce1cSdrh   sqliteFree(zCol);
983626a879aSdrh   if( cnt==1 ){
984b3bce662Sdanielk1977     assert( pNC!=0 );
985626a879aSdrh     sqlite3AuthRead(pParse, pExpr, pNC->pSrcList);
986aee18ef8Sdanielk1977     if( pMatch && !pMatch->pSelect ){
987aee18ef8Sdanielk1977       pExpr->pTab = pMatch->pTab;
988aee18ef8Sdanielk1977     }
98915ccce1cSdrh     /* Increment the nRef value on all name contexts from TopNC up to
99015ccce1cSdrh     ** the point where the name matched. */
99115ccce1cSdrh     for(;;){
99215ccce1cSdrh       assert( pTopNC!=0 );
99315ccce1cSdrh       pTopNC->nRef++;
99415ccce1cSdrh       if( pTopNC==pNC ) break;
99515ccce1cSdrh       pTopNC = pTopNC->pNext;
996626a879aSdrh     }
99715ccce1cSdrh     return 0;
99815ccce1cSdrh   } else {
99915ccce1cSdrh     return 1;
100015ccce1cSdrh   }
10018141f61eSdrh }
10028141f61eSdrh 
10038141f61eSdrh /*
1004626a879aSdrh ** This routine is designed as an xFunc for walkExprTree().
1005626a879aSdrh **
100673b211abSdrh ** Resolve symbolic names into TK_COLUMN operators for the current
1007626a879aSdrh ** node in the expression tree.  Return 0 to continue the search down
100873b211abSdrh ** the tree or 2 to abort the tree walk.
100973b211abSdrh **
101073b211abSdrh ** This routine also does error checking and name resolution for
101173b211abSdrh ** function names.  The operator for aggregate functions is changed
101273b211abSdrh ** to TK_AGG_FUNCTION.
1013626a879aSdrh */
1014626a879aSdrh static int nameResolverStep(void *pArg, Expr *pExpr){
1015626a879aSdrh   NameContext *pNC = (NameContext*)pArg;
1016626a879aSdrh   SrcList *pSrcList;
1017626a879aSdrh   Parse *pParse;
1018626a879aSdrh 
1019b3bce662Sdanielk1977   if( pExpr==0 ) return 1;
1020626a879aSdrh   assert( pNC!=0 );
1021626a879aSdrh   pSrcList = pNC->pSrcList;
1022626a879aSdrh   pParse = pNC->pParse;
1023b3bce662Sdanielk1977 
1024626a879aSdrh   if( ExprHasAnyProperty(pExpr, EP_Resolved) ) return 1;
1025626a879aSdrh   ExprSetProperty(pExpr, EP_Resolved);
1026626a879aSdrh #ifndef NDEBUG
1027626a879aSdrh   if( pSrcList ){
1028940fac9dSdanielk1977     int i;
1029626a879aSdrh     for(i=0; i<pSrcList->nSrc; i++){
1030626a879aSdrh       assert( pSrcList->a[i].iCursor>=0 && pSrcList->a[i].iCursor<pParse->nTab);
1031626a879aSdrh     }
1032626a879aSdrh   }
1033626a879aSdrh #endif
1034626a879aSdrh   switch( pExpr->op ){
1035626a879aSdrh     /* Double-quoted strings (ex: "abc") are used as identifiers if
1036626a879aSdrh     ** possible.  Otherwise they remain as strings.  Single-quoted
1037626a879aSdrh     ** strings (ex: 'abc') are always string literals.
1038626a879aSdrh     */
1039626a879aSdrh     case TK_STRING: {
1040626a879aSdrh       if( pExpr->token.z[0]=='\'' ) break;
1041626a879aSdrh       /* Fall thru into the TK_ID case if this is a double-quoted string */
1042626a879aSdrh     }
1043626a879aSdrh     /* A lone identifier is the name of a column.
1044626a879aSdrh     */
1045626a879aSdrh     case TK_ID: {
1046626a879aSdrh       lookupName(pParse, 0, 0, &pExpr->token, pNC, pExpr);
1047626a879aSdrh       return 1;
1048626a879aSdrh     }
1049626a879aSdrh 
1050626a879aSdrh     /* A table name and column name:     ID.ID
1051626a879aSdrh     ** Or a database, table and column:  ID.ID.ID
1052626a879aSdrh     */
1053626a879aSdrh     case TK_DOT: {
1054626a879aSdrh       Token *pColumn;
1055626a879aSdrh       Token *pTable;
1056626a879aSdrh       Token *pDb;
1057626a879aSdrh       Expr *pRight;
1058626a879aSdrh 
1059b3bce662Sdanielk1977       /* if( pSrcList==0 ) break; */
1060626a879aSdrh       pRight = pExpr->pRight;
1061626a879aSdrh       if( pRight->op==TK_ID ){
1062626a879aSdrh         pDb = 0;
1063626a879aSdrh         pTable = &pExpr->pLeft->token;
1064626a879aSdrh         pColumn = &pRight->token;
1065626a879aSdrh       }else{
1066626a879aSdrh         assert( pRight->op==TK_DOT );
1067626a879aSdrh         pDb = &pExpr->pLeft->token;
1068626a879aSdrh         pTable = &pRight->pLeft->token;
1069626a879aSdrh         pColumn = &pRight->pRight->token;
1070626a879aSdrh       }
1071626a879aSdrh       lookupName(pParse, pDb, pTable, pColumn, pNC, pExpr);
1072626a879aSdrh       return 1;
1073626a879aSdrh     }
1074626a879aSdrh 
1075626a879aSdrh     /* Resolve function names
1076626a879aSdrh     */
1077b71090fdSdrh     case TK_CONST_FUNC:
1078626a879aSdrh     case TK_FUNCTION: {
1079626a879aSdrh       ExprList *pList = pExpr->pList;    /* The argument list */
1080626a879aSdrh       int n = pList ? pList->nExpr : 0;  /* Number of arguments */
1081626a879aSdrh       int no_such_func = 0;       /* True if no such function exists */
1082626a879aSdrh       int wrong_num_args = 0;     /* True if wrong number of arguments */
1083626a879aSdrh       int is_agg = 0;             /* True if is an aggregate function */
1084626a879aSdrh       int i;
1085626a879aSdrh       int nId;                    /* Number of characters in function name */
1086626a879aSdrh       const char *zId;            /* The function name. */
108773b211abSdrh       FuncDef *pDef;              /* Information about the function */
108873b211abSdrh       int enc = pParse->db->enc;  /* The database encoding */
1089626a879aSdrh 
1090b71090fdSdrh       zId = pExpr->token.z;
1091b71090fdSdrh       nId = pExpr->token.n;
1092626a879aSdrh       pDef = sqlite3FindFunction(pParse->db, zId, nId, n, enc, 0);
1093626a879aSdrh       if( pDef==0 ){
1094626a879aSdrh         pDef = sqlite3FindFunction(pParse->db, zId, nId, -1, enc, 0);
1095626a879aSdrh         if( pDef==0 ){
1096626a879aSdrh           no_such_func = 1;
1097626a879aSdrh         }else{
1098626a879aSdrh           wrong_num_args = 1;
1099626a879aSdrh         }
1100626a879aSdrh       }else{
1101626a879aSdrh         is_agg = pDef->xFunc==0;
1102626a879aSdrh       }
1103626a879aSdrh       if( is_agg && !pNC->allowAgg ){
1104626a879aSdrh         sqlite3ErrorMsg(pParse, "misuse of aggregate function %.*s()", nId,zId);
1105626a879aSdrh         pNC->nErr++;
1106626a879aSdrh         is_agg = 0;
1107626a879aSdrh       }else if( no_such_func ){
1108626a879aSdrh         sqlite3ErrorMsg(pParse, "no such function: %.*s", nId, zId);
1109626a879aSdrh         pNC->nErr++;
1110626a879aSdrh       }else if( wrong_num_args ){
1111626a879aSdrh         sqlite3ErrorMsg(pParse,"wrong number of arguments to function %.*s()",
1112626a879aSdrh              nId, zId);
1113626a879aSdrh         pNC->nErr++;
1114626a879aSdrh       }
1115626a879aSdrh       if( is_agg ){
1116626a879aSdrh         pExpr->op = TK_AGG_FUNCTION;
1117626a879aSdrh         pNC->hasAgg = 1;
1118626a879aSdrh       }
111973b211abSdrh       if( is_agg ) pNC->allowAgg = 0;
1120626a879aSdrh       for(i=0; pNC->nErr==0 && i<n; i++){
112173b211abSdrh         walkExprTree(pList->a[i].pExpr, nameResolverStep, pNC);
1122626a879aSdrh       }
112373b211abSdrh       if( is_agg ) pNC->allowAgg = 1;
1124626a879aSdrh       /* FIX ME:  Compute pExpr->affinity based on the expected return
1125626a879aSdrh       ** type of the function
1126626a879aSdrh       */
1127626a879aSdrh       return is_agg;
1128626a879aSdrh     }
1129b3bce662Sdanielk1977 #ifndef SQLITE_OMIT_SUBQUERY
1130b3bce662Sdanielk1977     case TK_SELECT:
1131b3bce662Sdanielk1977     case TK_EXISTS:
1132b3bce662Sdanielk1977 #endif
1133b3bce662Sdanielk1977     case TK_IN: {
1134b3bce662Sdanielk1977       if( pExpr->pSelect ){
1135b3bce662Sdanielk1977         int nRef = pNC->nRef;
1136b3bce662Sdanielk1977         sqlite3SelectResolve(pParse, pExpr->pSelect, pNC);
1137b3bce662Sdanielk1977         assert( pNC->nRef>=nRef );
1138b3bce662Sdanielk1977         if( nRef!=pNC->nRef ){
1139b3bce662Sdanielk1977           ExprSetProperty(pExpr, EP_VarSelect);
1140b3bce662Sdanielk1977         }
1141b3bce662Sdanielk1977       }
1142b3bce662Sdanielk1977     }
1143626a879aSdrh   }
1144626a879aSdrh   return 0;
1145626a879aSdrh }
1146626a879aSdrh 
1147626a879aSdrh /*
1148cce7d176Sdrh ** This routine walks an expression tree and resolves references to
1149967e8b73Sdrh ** table columns.  Nodes of the form ID.ID or ID resolve into an
1150aacc543eSdrh ** index to the table in the table list and a column offset.  The
1151aacc543eSdrh ** Expr.opcode for such nodes is changed to TK_COLUMN.  The Expr.iTable
1152aacc543eSdrh ** value is changed to the index of the referenced table in pTabList
1153832508b7Sdrh ** plus the "base" value.  The base value will ultimately become the
1154aacc543eSdrh ** VDBE cursor number for a cursor that is pointing into the referenced
1155aacc543eSdrh ** table.  The Expr.iColumn value is changed to the index of the column
1156aacc543eSdrh ** of the referenced table.  The Expr.iColumn value for the special
1157aacc543eSdrh ** ROWID column is -1.  Any INTEGER PRIMARY KEY column is tried as an
1158aacc543eSdrh ** alias for ROWID.
115919a775c2Sdrh **
1160626a879aSdrh ** Also resolve function names and check the functions for proper
1161626a879aSdrh ** usage.  Make sure all function names are recognized and all functions
1162626a879aSdrh ** have the correct number of arguments.  Leave an error message
1163626a879aSdrh ** in pParse->zErrMsg if anything is amiss.  Return the number of errors.
1164626a879aSdrh **
116573b211abSdrh ** If the expression contains aggregate functions then set the EP_Agg
116673b211abSdrh ** property on the expression.
1167626a879aSdrh */
1168626a879aSdrh int sqlite3ExprResolveNames(
1169b3bce662Sdanielk1977   NameContext *pNC,       /* Namespace to resolve expressions in. */
1170b3bce662Sdanielk1977   Expr *pExpr             /* The expression to be analyzed. */
1171626a879aSdrh ){
117273b211abSdrh   if( pExpr==0 ) return 0;
1173b3bce662Sdanielk1977   walkExprTree(pExpr, nameResolverStep, pNC);
1174b3bce662Sdanielk1977   if( pNC->nErr>0 ){
117573b211abSdrh     ExprSetProperty(pExpr, EP_Error);
117673b211abSdrh   }
117773b211abSdrh   return ExprHasProperty(pExpr, EP_Error);
1178626a879aSdrh }
1179626a879aSdrh 
11801398ad36Sdrh /*
11811398ad36Sdrh ** A pointer instance of this structure is used to pass information
11821398ad36Sdrh ** through walkExprTree into codeSubqueryStep().
11831398ad36Sdrh */
11841398ad36Sdrh typedef struct QueryCoder QueryCoder;
11851398ad36Sdrh struct QueryCoder {
11861398ad36Sdrh   Parse *pParse;       /* The parsing context */
11871398ad36Sdrh   NameContext *pNC;    /* Namespace of first enclosing query */
11881398ad36Sdrh };
11891398ad36Sdrh 
1190626a879aSdrh 
1191626a879aSdrh /*
1192626a879aSdrh ** Generate code for subqueries and IN operators.
1193626a879aSdrh **
119473b211abSdrh ** IN operators comes in two forms:
1195fef5208cSdrh **
1196fef5208cSdrh **           expr IN (exprlist)
1197fef5208cSdrh ** and
1198fef5208cSdrh **           expr IN (SELECT ...)
1199fef5208cSdrh **
1200fef5208cSdrh ** The first form is handled by creating a set holding the list
1201fef5208cSdrh ** of allowed values.  The second form causes the SELECT to generate
1202fef5208cSdrh ** a temporary table.
1203cce7d176Sdrh */
120451522cd3Sdrh #ifndef SQLITE_OMIT_SUBQUERY
1205b3bce662Sdanielk1977 void sqlite3CodeSubselect(Parse *pParse, Expr *pExpr){
1206b3bce662Sdanielk1977   int label = 0;                         /* Address after sub-select code */
1207b3bce662Sdanielk1977   Vdbe *v = sqlite3GetVdbe(pParse);
1208b3bce662Sdanielk1977   if( v==0 ) return;
1209b3bce662Sdanielk1977 
1210b3bce662Sdanielk1977   /* If this is not a variable (correlated) select, then execute
1211b3bce662Sdanielk1977   ** it only once. Unless this is part of a trigger program. In
1212b3bce662Sdanielk1977   ** that case re-execute every time (this could be optimized).
1213b3bce662Sdanielk1977   */
1214b3bce662Sdanielk1977   if( !ExprHasAnyProperty(pExpr, EP_VarSelect) && !pParse->trigStack ){
1215b3bce662Sdanielk1977     int mem = pParse->nMem++;
1216b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_MemLoad, mem, 0);
1217b3bce662Sdanielk1977     label = sqlite3VdbeMakeLabel(v);
1218b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_If, 0, label);
1219b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_Integer, 1, 0);
1220b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_MemStore, mem, 1);
1221b3bce662Sdanielk1977   }
1222b3bce662Sdanielk1977 
1223b3bce662Sdanielk1977   if( pExpr->pSelect ){
1224b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_AggContextPush, 0, 0);
1225b3bce662Sdanielk1977   }
12266a3ea0e6Sdrh 
1227cce7d176Sdrh   switch( pExpr->op ){
1228fef5208cSdrh     case TK_IN: {
1229e014a838Sdanielk1977       char affinity;
1230d3d39e93Sdrh       KeyInfo keyInfo;
12310202b29eSdanielk1977       int addr;        /* Address of OP_OpenTemp instruction */
1232d3d39e93Sdrh 
1233bf3b721fSdanielk1977       affinity = sqlite3ExprAffinity(pExpr->pLeft);
1234e014a838Sdanielk1977 
1235e014a838Sdanielk1977       /* Whether this is an 'x IN(SELECT...)' or an 'x IN(<exprlist>)'
1236e014a838Sdanielk1977       ** expression it is handled the same way. A temporary table is
1237e014a838Sdanielk1977       ** filled with single-field index keys representing the results
1238e014a838Sdanielk1977       ** from the SELECT or the <exprlist>.
1239fef5208cSdrh       **
1240e014a838Sdanielk1977       ** If the 'x' expression is a column value, or the SELECT...
1241e014a838Sdanielk1977       ** statement returns a column value, then the affinity of that
1242e014a838Sdanielk1977       ** column is used to build the index keys. If both 'x' and the
1243e014a838Sdanielk1977       ** SELECT... statement are columns, then numeric affinity is used
1244e014a838Sdanielk1977       ** if either column has NUMERIC or INTEGER affinity. If neither
1245e014a838Sdanielk1977       ** 'x' nor the SELECT... statement are columns, then numeric affinity
1246e014a838Sdanielk1977       ** is used.
1247fef5208cSdrh       */
1248832508b7Sdrh       pExpr->iTable = pParse->nTab++;
12490202b29eSdanielk1977       addr = sqlite3VdbeAddOp(v, OP_OpenTemp, pExpr->iTable, 0);
1250d3d39e93Sdrh       memset(&keyInfo, 0, sizeof(keyInfo));
1251d3d39e93Sdrh       keyInfo.nField = 1;
1252f3218feaSdrh       sqlite3VdbeAddOp(v, OP_SetNumColumns, pExpr->iTable, 1);
1253e014a838Sdanielk1977 
1254e014a838Sdanielk1977       if( pExpr->pSelect ){
1255e014a838Sdanielk1977         /* Case 1:     expr IN (SELECT ...)
1256e014a838Sdanielk1977         **
1257e014a838Sdanielk1977         ** Generate code to write the results of the select into the temporary
1258e014a838Sdanielk1977         ** table allocated and opened above.
1259e014a838Sdanielk1977         */
1260e014a838Sdanielk1977         int iParm = pExpr->iTable +  (((int)affinity)<<16);
1261be5c89acSdrh         ExprList *pEList;
1262e014a838Sdanielk1977         assert( (pExpr->iTable&0x0000FFFF)==pExpr->iTable );
1263b3bce662Sdanielk1977         sqlite3Select(pParse, pExpr->pSelect, SRT_Set, iParm, 0, 0, 0, 0);
1264be5c89acSdrh         pEList = pExpr->pSelect->pEList;
1265be5c89acSdrh         if( pEList && pEList->nExpr>0 ){
12667cedc8d4Sdanielk1977           keyInfo.aColl[0] = binaryCompareCollSeq(pParse, pExpr->pLeft,
1267be5c89acSdrh               pEList->a[0].pExpr);
12680202b29eSdanielk1977         }
1269fef5208cSdrh       }else if( pExpr->pList ){
1270fef5208cSdrh         /* Case 2:     expr IN (exprlist)
1271fef5208cSdrh         **
1272e014a838Sdanielk1977 	** For each expression, build an index key from the evaluation and
1273e014a838Sdanielk1977         ** store it in the temporary table. If <expr> is a column, then use
1274e014a838Sdanielk1977         ** that columns affinity when building index keys. If <expr> is not
1275e014a838Sdanielk1977         ** a column, use numeric affinity.
1276fef5208cSdrh         */
1277e014a838Sdanielk1977         int i;
1278e014a838Sdanielk1977         if( !affinity ){
1279e014a838Sdanielk1977           affinity = SQLITE_AFF_NUMERIC;
1280e014a838Sdanielk1977         }
12810202b29eSdanielk1977         keyInfo.aColl[0] = pExpr->pLeft->pColl;
1282e014a838Sdanielk1977 
1283e014a838Sdanielk1977         /* Loop through each expression in <exprlist>. */
1284fef5208cSdrh         for(i=0; i<pExpr->pList->nExpr; i++){
1285fef5208cSdrh           Expr *pE2 = pExpr->pList->a[i].pExpr;
1286e014a838Sdanielk1977 
1287e014a838Sdanielk1977           /* Check that the expression is constant and valid. */
12884adee20fSdanielk1977           if( !sqlite3ExprIsConstant(pE2) ){
12894adee20fSdanielk1977             sqlite3ErrorMsg(pParse,
1290da93d238Sdrh               "right-hand side of IN operator must be constant");
1291b3bce662Sdanielk1977             return;
12924794b980Sdrh           }
1293e014a838Sdanielk1977 
1294e014a838Sdanielk1977           /* Evaluate the expression and insert it into the temp table */
12954adee20fSdanielk1977           sqlite3ExprCode(pParse, pE2);
129694a11211Sdrh           sqlite3VdbeOp3(v, OP_MakeRecord, 1, 0, &affinity, 1);
12970f69c1e3Sdanielk1977           sqlite3VdbeAddOp(v, OP_String8, 0, 0);
1298e014a838Sdanielk1977           sqlite3VdbeAddOp(v, OP_PutStrKey, pExpr->iTable, 0);
1299fef5208cSdrh         }
1300fef5208cSdrh       }
13010202b29eSdanielk1977       sqlite3VdbeChangeP3(v, addr, (void *)&keyInfo, P3_KEYINFO);
1302b3bce662Sdanielk1977       break;
1303fef5208cSdrh     }
1304fef5208cSdrh 
130551522cd3Sdrh     case TK_EXISTS:
130619a775c2Sdrh     case TK_SELECT: {
1307fef5208cSdrh       /* This has to be a scalar SELECT.  Generate code to put the
1308fef5208cSdrh       ** value of this select in a memory cell and record the number
1309967e8b73Sdrh       ** of the memory cell in iColumn.
1310fef5208cSdrh       */
131151522cd3Sdrh       int sop;
131251522cd3Sdrh       Select *pSel;
13131398ad36Sdrh 
1314967e8b73Sdrh       pExpr->iColumn = pParse->nMem++;
131551522cd3Sdrh       pSel = pExpr->pSelect;
131651522cd3Sdrh       if( pExpr->op==TK_SELECT ){
131751522cd3Sdrh         sop = SRT_Mem;
131851522cd3Sdrh       }else{
131951522cd3Sdrh         static const Token one = { "1", 0, 1 };
132051522cd3Sdrh         sop = SRT_Exists;
132151522cd3Sdrh         sqlite3ExprListDelete(pSel->pEList);
132251522cd3Sdrh         pSel->pEList = sqlite3ExprListAppend(0,
132351522cd3Sdrh                           sqlite3Expr(TK_INTEGER, 0, 0, &one), 0);
132451522cd3Sdrh       }
1325b3bce662Sdanielk1977       sqlite3Select(pParse, pSel, sop, pExpr->iColumn, 0, 0, 0, 0);
1326b3bce662Sdanielk1977       break;
132719a775c2Sdrh     }
1328cce7d176Sdrh   }
1329b3bce662Sdanielk1977 
1330b3bce662Sdanielk1977   if( pExpr->pSelect ){
1331b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_AggContextPop, 0, 0);
1332b3bce662Sdanielk1977   }
1333b3bce662Sdanielk1977   if( label<0 ){
1334b3bce662Sdanielk1977     sqlite3VdbeResolveLabel(v, label);
1335b3bce662Sdanielk1977   }
1336b3bce662Sdanielk1977   return;
1337cce7d176Sdrh }
133851522cd3Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
1339cce7d176Sdrh 
1340cce7d176Sdrh /*
1341fec19aadSdrh ** Generate an instruction that will put the integer describe by
1342fec19aadSdrh ** text z[0..n-1] on the stack.
1343fec19aadSdrh */
1344fec19aadSdrh static void codeInteger(Vdbe *v, const char *z, int n){
1345fec19aadSdrh   int i;
13466fec0762Sdrh   if( sqlite3GetInt32(z, &i) ){
13476fec0762Sdrh     sqlite3VdbeAddOp(v, OP_Integer, i, 0);
13486fec0762Sdrh   }else if( sqlite3FitsIn64Bits(z) ){
13496fec0762Sdrh     sqlite3VdbeOp3(v, OP_Integer, 0, 0, z, n);
1350fec19aadSdrh   }else{
1351fec19aadSdrh     sqlite3VdbeOp3(v, OP_Real, 0, 0, z, n);
1352fec19aadSdrh   }
1353fec19aadSdrh }
1354fec19aadSdrh 
1355fec19aadSdrh /*
1356cce7d176Sdrh ** Generate code into the current Vdbe to evaluate the given
13571ccde15dSdrh ** expression and leave the result on the top of stack.
1358f2bc013cSdrh **
1359f2bc013cSdrh ** This code depends on the fact that certain token values (ex: TK_EQ)
1360f2bc013cSdrh ** are the same as opcode values (ex: OP_Eq) that implement the corresponding
1361f2bc013cSdrh ** operation.  Special comments in vdbe.c and the mkopcodeh.awk script in
1362f2bc013cSdrh ** the make process cause these values to align.  Assert()s in the code
1363f2bc013cSdrh ** below verify that the numbers are aligned correctly.
1364cce7d176Sdrh */
13654adee20fSdanielk1977 void sqlite3ExprCode(Parse *pParse, Expr *pExpr){
1366cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
1367cce7d176Sdrh   int op;
13687977a17fSdanielk1977   if( v==0 ) return;
13697977a17fSdanielk1977   if( pExpr==0 ){
13707977a17fSdanielk1977     sqlite3VdbeAddOp(v, OP_String8, 0, 0);  /* Empty expression evals to NULL */
13717977a17fSdanielk1977     return;
13727977a17fSdanielk1977   }
1373f2bc013cSdrh   op = pExpr->op;
1374f2bc013cSdrh   switch( op ){
1375967e8b73Sdrh     case TK_COLUMN: {
1376a58fdfb1Sdanielk1977       if( !pParse->fillAgg && pExpr->iAgg>=0 ){
1377a58fdfb1Sdanielk1977         sqlite3VdbeAddOp(v, OP_AggGet, pExpr->iAggCtx, pExpr->iAgg);
1378c4a3c779Sdrh       }else if( pExpr->iColumn>=0 ){
13794adee20fSdanielk1977         sqlite3VdbeAddOp(v, OP_Column, pExpr->iTable, pExpr->iColumn);
1380aee18ef8Sdanielk1977         sqlite3ColumnDefault(v, pExpr->pTab, pExpr->iColumn);
1381c4a3c779Sdrh       }else{
13824adee20fSdanielk1977         sqlite3VdbeAddOp(v, OP_Recno, pExpr->iTable, 0);
13832282792aSdrh       }
1384cce7d176Sdrh       break;
1385cce7d176Sdrh     }
1386cce7d176Sdrh     case TK_INTEGER: {
1387fec19aadSdrh       codeInteger(v, pExpr->token.z, pExpr->token.n);
1388fec19aadSdrh       break;
138951e9a445Sdrh     }
1390fec19aadSdrh     case TK_FLOAT:
1391fec19aadSdrh     case TK_STRING: {
1392f2bc013cSdrh       assert( TK_FLOAT==OP_Real );
1393f2bc013cSdrh       assert( TK_STRING==OP_String8 );
1394fec19aadSdrh       sqlite3VdbeOp3(v, op, 0, 0, pExpr->token.z, pExpr->token.n);
13954adee20fSdanielk1977       sqlite3VdbeDequoteP3(v, -1);
1396cce7d176Sdrh       break;
1397cce7d176Sdrh     }
13985338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_BLOB_LITERAL
1399c572ef7fSdanielk1977     case TK_BLOB: {
1400f2bc013cSdrh       assert( TK_BLOB==OP_HexBlob );
1401c572ef7fSdanielk1977       sqlite3VdbeOp3(v, op, 0, 0, pExpr->token.z+1, pExpr->token.n-1);
1402c572ef7fSdanielk1977       sqlite3VdbeDequoteP3(v, -1);
1403c572ef7fSdanielk1977       break;
1404c572ef7fSdanielk1977     }
14055338a5f7Sdanielk1977 #endif
1406cce7d176Sdrh     case TK_NULL: {
14070f69c1e3Sdanielk1977       sqlite3VdbeAddOp(v, OP_String8, 0, 0);
1408cce7d176Sdrh       break;
1409cce7d176Sdrh     }
141050457896Sdrh     case TK_VARIABLE: {
14114adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Variable, pExpr->iTable, 0);
1412895d7472Sdrh       if( pExpr->token.n>1 ){
1413895d7472Sdrh         sqlite3VdbeChangeP3(v, -1, pExpr->token.z, pExpr->token.n);
1414895d7472Sdrh       }
141550457896Sdrh       break;
141650457896Sdrh     }
14174e0cff60Sdrh     case TK_REGISTER: {
14184e0cff60Sdrh       sqlite3VdbeAddOp(v, OP_MemLoad, pExpr->iTable, 0);
14194e0cff60Sdrh       break;
14204e0cff60Sdrh     }
1421c9b84a1fSdrh     case TK_LT:
1422c9b84a1fSdrh     case TK_LE:
1423c9b84a1fSdrh     case TK_GT:
1424c9b84a1fSdrh     case TK_GE:
1425c9b84a1fSdrh     case TK_NE:
1426c9b84a1fSdrh     case TK_EQ: {
1427f2bc013cSdrh       assert( TK_LT==OP_Lt );
1428f2bc013cSdrh       assert( TK_LE==OP_Le );
1429f2bc013cSdrh       assert( TK_GT==OP_Gt );
1430f2bc013cSdrh       assert( TK_GE==OP_Ge );
1431f2bc013cSdrh       assert( TK_EQ==OP_Eq );
1432f2bc013cSdrh       assert( TK_NE==OP_Ne );
1433a37cdde0Sdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
1434a37cdde0Sdanielk1977       sqlite3ExprCode(pParse, pExpr->pRight);
1435be5c89acSdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op, 0, 0);
1436a37cdde0Sdanielk1977       break;
1437c9b84a1fSdrh     }
1438cce7d176Sdrh     case TK_AND:
1439cce7d176Sdrh     case TK_OR:
1440cce7d176Sdrh     case TK_PLUS:
1441cce7d176Sdrh     case TK_STAR:
1442cce7d176Sdrh     case TK_MINUS:
1443bf4133cbSdrh     case TK_REM:
1444bf4133cbSdrh     case TK_BITAND:
1445bf4133cbSdrh     case TK_BITOR:
144617c40294Sdrh     case TK_SLASH:
1447bf4133cbSdrh     case TK_LSHIFT:
1448855eb1cfSdrh     case TK_RSHIFT:
14490040077dSdrh     case TK_CONCAT: {
1450f2bc013cSdrh       assert( TK_AND==OP_And );
1451f2bc013cSdrh       assert( TK_OR==OP_Or );
1452f2bc013cSdrh       assert( TK_PLUS==OP_Add );
1453f2bc013cSdrh       assert( TK_MINUS==OP_Subtract );
1454f2bc013cSdrh       assert( TK_REM==OP_Remainder );
1455f2bc013cSdrh       assert( TK_BITAND==OP_BitAnd );
1456f2bc013cSdrh       assert( TK_BITOR==OP_BitOr );
1457f2bc013cSdrh       assert( TK_SLASH==OP_Divide );
1458f2bc013cSdrh       assert( TK_LSHIFT==OP_ShiftLeft );
1459f2bc013cSdrh       assert( TK_RSHIFT==OP_ShiftRight );
1460f2bc013cSdrh       assert( TK_CONCAT==OP_Concat );
14614adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
14624adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pRight);
1463855eb1cfSdrh       sqlite3VdbeAddOp(v, op, 0, 0);
14640040077dSdrh       break;
14650040077dSdrh     }
1466cce7d176Sdrh     case TK_UMINUS: {
1467fec19aadSdrh       Expr *pLeft = pExpr->pLeft;
1468fec19aadSdrh       assert( pLeft );
1469fec19aadSdrh       if( pLeft->op==TK_FLOAT || pLeft->op==TK_INTEGER ){
1470fec19aadSdrh         Token *p = &pLeft->token;
14716e142f54Sdrh         char *z = sqliteMalloc( p->n + 2 );
14726e142f54Sdrh         sprintf(z, "-%.*s", p->n, p->z);
1473fec19aadSdrh         if( pLeft->op==TK_FLOAT ){
1474fec19aadSdrh           sqlite3VdbeOp3(v, OP_Real, 0, 0, z, p->n+1);
1475e6840900Sdrh         }else{
1476fec19aadSdrh           codeInteger(v, z, p->n+1);
1477e6840900Sdrh         }
14786e142f54Sdrh         sqliteFree(z);
14796e142f54Sdrh         break;
14806e142f54Sdrh       }
14811ccde15dSdrh       /* Fall through into TK_NOT */
14826e142f54Sdrh     }
1483bf4133cbSdrh     case TK_BITNOT:
14846e142f54Sdrh     case TK_NOT: {
1485f2bc013cSdrh       assert( TK_BITNOT==OP_BitNot );
1486f2bc013cSdrh       assert( TK_NOT==OP_Not );
14874adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
14884adee20fSdanielk1977       sqlite3VdbeAddOp(v, op, 0, 0);
1489cce7d176Sdrh       break;
1490cce7d176Sdrh     }
1491cce7d176Sdrh     case TK_ISNULL:
1492cce7d176Sdrh     case TK_NOTNULL: {
1493cce7d176Sdrh       int dest;
1494f2bc013cSdrh       assert( TK_ISNULL==OP_IsNull );
1495f2bc013cSdrh       assert( TK_NOTNULL==OP_NotNull );
14964adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Integer, 1, 0);
14974adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
14984adee20fSdanielk1977       dest = sqlite3VdbeCurrentAddr(v) + 2;
14994adee20fSdanielk1977       sqlite3VdbeAddOp(v, op, 1, dest);
15004adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_AddImm, -1, 0);
1501a37cdde0Sdanielk1977       break;
1502f2bc013cSdrh     }
15032282792aSdrh     case TK_AGG_FUNCTION: {
15044adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_AggGet, 0, pExpr->iAgg);
15052282792aSdrh       break;
15062282792aSdrh     }
1507b71090fdSdrh     case TK_CONST_FUNC:
1508cce7d176Sdrh     case TK_FUNCTION: {
1509cce7d176Sdrh       ExprList *pList = pExpr->pList;
151089425d5eSdrh       int nExpr = pList ? pList->nExpr : 0;
15110bce8354Sdrh       FuncDef *pDef;
15124b59ab5eSdrh       int nId;
15134b59ab5eSdrh       const char *zId;
1514682f68b0Sdanielk1977       int p2 = 0;
1515682f68b0Sdanielk1977       int i;
1516d8123366Sdanielk1977       u8 enc = pParse->db->enc;
1517dc1bdc4fSdanielk1977       CollSeq *pColl = 0;
1518b71090fdSdrh       zId = pExpr->token.z;
1519b71090fdSdrh       nId = pExpr->token.n;
1520d8123366Sdanielk1977       pDef = sqlite3FindFunction(pParse->db, zId, nId, nExpr, enc, 0);
15210bce8354Sdrh       assert( pDef!=0 );
1522f9b596ebSdrh       nExpr = sqlite3ExprCodeExprList(pParse, pList);
1523682f68b0Sdanielk1977       for(i=0; i<nExpr && i<32; i++){
1524d02eb1fdSdanielk1977         if( sqlite3ExprIsConstant(pList->a[i].pExpr) ){
1525d02eb1fdSdanielk1977           p2 |= (1<<i);
1526d02eb1fdSdanielk1977         }
1527dc1bdc4fSdanielk1977         if( pDef->needCollSeq && !pColl ){
1528dc1bdc4fSdanielk1977           pColl = sqlite3ExprCollSeq(pParse, pList->a[i].pExpr);
1529dc1bdc4fSdanielk1977         }
1530dc1bdc4fSdanielk1977       }
1531dc1bdc4fSdanielk1977       if( pDef->needCollSeq ){
1532dc1bdc4fSdanielk1977         if( !pColl ) pColl = pParse->db->pDfltColl;
1533d8123366Sdanielk1977         sqlite3VdbeOp3(v, OP_CollSeq, 0, 0, (char *)pColl, P3_COLLSEQ);
1534682f68b0Sdanielk1977       }
1535682f68b0Sdanielk1977       sqlite3VdbeOp3(v, OP_Function, nExpr, p2, (char*)pDef, P3_FUNCDEF);
15366ec2733bSdrh       break;
15376ec2733bSdrh     }
1538fe2093d7Sdrh #ifndef SQLITE_OMIT_SUBQUERY
1539fe2093d7Sdrh     case TK_EXISTS:
154019a775c2Sdrh     case TK_SELECT: {
1541b3bce662Sdanielk1977       sqlite3CodeSubselect(pParse, pExpr);
15424adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_MemLoad, pExpr->iColumn, 0);
1543ad6d9460Sdrh       VdbeComment((v, "# load subquery result"));
154419a775c2Sdrh       break;
154519a775c2Sdrh     }
1546fef5208cSdrh     case TK_IN: {
1547fef5208cSdrh       int addr;
154894a11211Sdrh       char affinity;
1549b3bce662Sdanielk1977       sqlite3CodeSubselect(pParse, pExpr);
1550e014a838Sdanielk1977 
1551e014a838Sdanielk1977       /* Figure out the affinity to use to create a key from the results
1552e014a838Sdanielk1977       ** of the expression. affinityStr stores a static string suitable for
1553ededfd5eSdanielk1977       ** P3 of OP_MakeRecord.
1554e014a838Sdanielk1977       */
155594a11211Sdrh       affinity = comparisonAffinity(pExpr);
1556e014a838Sdanielk1977 
15574adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Integer, 1, 0);
1558e014a838Sdanielk1977 
1559e014a838Sdanielk1977       /* Code the <expr> from "<expr> IN (...)". The temporary table
1560e014a838Sdanielk1977       ** pExpr->iTable contains the values that make up the (...) set.
1561e014a838Sdanielk1977       */
15624adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
15634adee20fSdanielk1977       addr = sqlite3VdbeCurrentAddr(v);
1564e014a838Sdanielk1977       sqlite3VdbeAddOp(v, OP_NotNull, -1, addr+4);            /* addr + 0 */
15654adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Pop, 2, 0);
15660f69c1e3Sdanielk1977       sqlite3VdbeAddOp(v, OP_String8, 0, 0);
1567e014a838Sdanielk1977       sqlite3VdbeAddOp(v, OP_Goto, 0, addr+7);
156894a11211Sdrh       sqlite3VdbeOp3(v, OP_MakeRecord, 1, 0, &affinity, 1);   /* addr + 4 */
1569e014a838Sdanielk1977       sqlite3VdbeAddOp(v, OP_Found, pExpr->iTable, addr+7);
1570e014a838Sdanielk1977       sqlite3VdbeAddOp(v, OP_AddImm, -1, 0);                  /* addr + 6 */
1571e014a838Sdanielk1977 
1572fef5208cSdrh       break;
1573fef5208cSdrh     }
157493758c8dSdanielk1977 #endif
1575fef5208cSdrh     case TK_BETWEEN: {
1576be5c89acSdrh       Expr *pLeft = pExpr->pLeft;
1577be5c89acSdrh       struct ExprList_item *pLItem = pExpr->pList->a;
1578be5c89acSdrh       Expr *pRight = pLItem->pExpr;
1579be5c89acSdrh       sqlite3ExprCode(pParse, pLeft);
15804adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Dup, 0, 0);
1581be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
1582be5c89acSdrh       codeCompare(pParse, pLeft, pRight, OP_Ge, 0, 0);
15834adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Pull, 1, 0);
1584be5c89acSdrh       pLItem++;
1585be5c89acSdrh       pRight = pLItem->pExpr;
1586be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
1587be5c89acSdrh       codeCompare(pParse, pLeft, pRight, OP_Le, 0, 0);
15884adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_And, 0, 0);
1589fef5208cSdrh       break;
1590fef5208cSdrh     }
159151e9a445Sdrh     case TK_UPLUS:
1592a2e00042Sdrh     case TK_AS: {
15934adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
1594a2e00042Sdrh       break;
1595a2e00042Sdrh     }
159617a7f8ddSdrh     case TK_CASE: {
159717a7f8ddSdrh       int expr_end_label;
1598f5905aa7Sdrh       int jumpInst;
1599f5905aa7Sdrh       int addr;
1600f5905aa7Sdrh       int nExpr;
160117a7f8ddSdrh       int i;
1602be5c89acSdrh       ExprList *pEList;
1603be5c89acSdrh       struct ExprList_item *aListelem;
160417a7f8ddSdrh 
160517a7f8ddSdrh       assert(pExpr->pList);
160617a7f8ddSdrh       assert((pExpr->pList->nExpr % 2) == 0);
160717a7f8ddSdrh       assert(pExpr->pList->nExpr > 0);
1608be5c89acSdrh       pEList = pExpr->pList;
1609be5c89acSdrh       aListelem = pEList->a;
1610be5c89acSdrh       nExpr = pEList->nExpr;
16114adee20fSdanielk1977       expr_end_label = sqlite3VdbeMakeLabel(v);
161217a7f8ddSdrh       if( pExpr->pLeft ){
16134adee20fSdanielk1977         sqlite3ExprCode(pParse, pExpr->pLeft);
1614cce7d176Sdrh       }
1615f5905aa7Sdrh       for(i=0; i<nExpr; i=i+2){
1616be5c89acSdrh         sqlite3ExprCode(pParse, aListelem[i].pExpr);
161717a7f8ddSdrh         if( pExpr->pLeft ){
16184adee20fSdanielk1977           sqlite3VdbeAddOp(v, OP_Dup, 1, 1);
1619be5c89acSdrh           jumpInst = codeCompare(pParse, pExpr->pLeft, aListelem[i].pExpr,
1620be5c89acSdrh                                  OP_Ne, 0, 1);
16214adee20fSdanielk1977           sqlite3VdbeAddOp(v, OP_Pop, 1, 0);
1622f5905aa7Sdrh         }else{
16234adee20fSdanielk1977           jumpInst = sqlite3VdbeAddOp(v, OP_IfNot, 1, 0);
162417a7f8ddSdrh         }
1625be5c89acSdrh         sqlite3ExprCode(pParse, aListelem[i+1].pExpr);
16264adee20fSdanielk1977         sqlite3VdbeAddOp(v, OP_Goto, 0, expr_end_label);
16274adee20fSdanielk1977         addr = sqlite3VdbeCurrentAddr(v);
16284adee20fSdanielk1977         sqlite3VdbeChangeP2(v, jumpInst, addr);
162917a7f8ddSdrh       }
1630f570f011Sdrh       if( pExpr->pLeft ){
16314adee20fSdanielk1977         sqlite3VdbeAddOp(v, OP_Pop, 1, 0);
1632f570f011Sdrh       }
163317a7f8ddSdrh       if( pExpr->pRight ){
16344adee20fSdanielk1977         sqlite3ExprCode(pParse, pExpr->pRight);
163517a7f8ddSdrh       }else{
16360f69c1e3Sdanielk1977         sqlite3VdbeAddOp(v, OP_String8, 0, 0);
163717a7f8ddSdrh       }
16384adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, expr_end_label);
16396f34903eSdanielk1977       break;
16406f34903eSdanielk1977     }
16415338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_TRIGGER
16426f34903eSdanielk1977     case TK_RAISE: {
16436f34903eSdanielk1977       if( !pParse->trigStack ){
16444adee20fSdanielk1977         sqlite3ErrorMsg(pParse,
1645da93d238Sdrh                        "RAISE() may only be used within a trigger-program");
16466f34903eSdanielk1977 	return;
16476f34903eSdanielk1977       }
1648ad6d9460Sdrh       if( pExpr->iColumn!=OE_Ignore ){
1649ad6d9460Sdrh          assert( pExpr->iColumn==OE_Rollback ||
16506f34903eSdanielk1977                  pExpr->iColumn == OE_Abort ||
1651ad6d9460Sdrh                  pExpr->iColumn == OE_Fail );
16524adee20fSdanielk1977          sqlite3VdbeOp3(v, OP_Halt, SQLITE_CONSTRAINT, pExpr->iColumn,
1653701a0aebSdrh                         pExpr->token.z, pExpr->token.n);
16544adee20fSdanielk1977          sqlite3VdbeDequoteP3(v, -1);
16556f34903eSdanielk1977       } else {
16566f34903eSdanielk1977          assert( pExpr->iColumn == OE_Ignore );
1657344737f6Sdrh          sqlite3VdbeAddOp(v, OP_ContextPop, 0, 0);
1658ad6d9460Sdrh          sqlite3VdbeAddOp(v, OP_Goto, 0, pParse->trigStack->ignoreJump);
1659ad6d9460Sdrh          VdbeComment((v, "# raise(IGNORE)"));
16606f34903eSdanielk1977       }
166117a7f8ddSdrh     }
16625338a5f7Sdanielk1977 #endif
166317a7f8ddSdrh     break;
166417a7f8ddSdrh   }
1665cce7d176Sdrh }
1666cce7d176Sdrh 
166793758c8dSdanielk1977 #ifndef SQLITE_OMIT_TRIGGER
1668cce7d176Sdrh /*
166925303780Sdrh ** Generate code that evalutes the given expression and leaves the result
167025303780Sdrh ** on the stack.  See also sqlite3ExprCode().
167125303780Sdrh **
167225303780Sdrh ** This routine might also cache the result and modify the pExpr tree
167325303780Sdrh ** so that it will make use of the cached result on subsequent evaluations
167425303780Sdrh ** rather than evaluate the whole expression again.  Trivial expressions are
167525303780Sdrh ** not cached.  If the expression is cached, its result is stored in a
167625303780Sdrh ** memory location.
167725303780Sdrh */
167825303780Sdrh void sqlite3ExprCodeAndCache(Parse *pParse, Expr *pExpr){
167925303780Sdrh   Vdbe *v = pParse->pVdbe;
168025303780Sdrh   int iMem;
168125303780Sdrh   int addr1, addr2;
168225303780Sdrh   if( v==0 ) return;
168325303780Sdrh   addr1 = sqlite3VdbeCurrentAddr(v);
168425303780Sdrh   sqlite3ExprCode(pParse, pExpr);
168525303780Sdrh   addr2 = sqlite3VdbeCurrentAddr(v);
168625303780Sdrh   if( addr2>addr1+1 || sqlite3VdbeGetOp(v, addr1)->opcode==OP_Function ){
168725303780Sdrh     iMem = pExpr->iTable = pParse->nMem++;
168825303780Sdrh     sqlite3VdbeAddOp(v, OP_MemStore, iMem, 0);
168925303780Sdrh     pExpr->op = TK_REGISTER;
169025303780Sdrh   }
169125303780Sdrh }
169293758c8dSdanielk1977 #endif
169325303780Sdrh 
169425303780Sdrh /*
1695268380caSdrh ** Generate code that pushes the value of every element of the given
1696f9b596ebSdrh ** expression list onto the stack.
1697268380caSdrh **
1698268380caSdrh ** Return the number of elements pushed onto the stack.
1699268380caSdrh */
17004adee20fSdanielk1977 int sqlite3ExprCodeExprList(
1701268380caSdrh   Parse *pParse,     /* Parsing context */
1702f9b596ebSdrh   ExprList *pList    /* The expression list to be coded */
1703268380caSdrh ){
1704268380caSdrh   struct ExprList_item *pItem;
1705268380caSdrh   int i, n;
1706268380caSdrh   Vdbe *v;
1707268380caSdrh   if( pList==0 ) return 0;
17084adee20fSdanielk1977   v = sqlite3GetVdbe(pParse);
1709268380caSdrh   n = pList->nExpr;
1710268380caSdrh   for(pItem=pList->a, i=0; i<n; i++, pItem++){
17114adee20fSdanielk1977     sqlite3ExprCode(pParse, pItem->pExpr);
1712268380caSdrh   }
1713f9b596ebSdrh   return n;
1714268380caSdrh }
1715268380caSdrh 
1716268380caSdrh /*
1717cce7d176Sdrh ** Generate code for a boolean expression such that a jump is made
1718cce7d176Sdrh ** to the label "dest" if the expression is true but execution
1719cce7d176Sdrh ** continues straight thru if the expression is false.
1720f5905aa7Sdrh **
1721f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false), then
1722f5905aa7Sdrh ** take the jump if the jumpIfNull flag is true.
1723f2bc013cSdrh **
1724f2bc013cSdrh ** This code depends on the fact that certain token values (ex: TK_EQ)
1725f2bc013cSdrh ** are the same as opcode values (ex: OP_Eq) that implement the corresponding
1726f2bc013cSdrh ** operation.  Special comments in vdbe.c and the mkopcodeh.awk script in
1727f2bc013cSdrh ** the make process cause these values to align.  Assert()s in the code
1728f2bc013cSdrh ** below verify that the numbers are aligned correctly.
1729cce7d176Sdrh */
17304adee20fSdanielk1977 void sqlite3ExprIfTrue(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
1731cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
1732cce7d176Sdrh   int op = 0;
1733daffd0e5Sdrh   if( v==0 || pExpr==0 ) return;
1734f2bc013cSdrh   op = pExpr->op;
1735f2bc013cSdrh   switch( op ){
1736cce7d176Sdrh     case TK_AND: {
17374adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
17384adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, d2, !jumpIfNull);
17394adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
17404adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
1741cce7d176Sdrh       break;
1742cce7d176Sdrh     }
1743cce7d176Sdrh     case TK_OR: {
17444adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
17454adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
1746cce7d176Sdrh       break;
1747cce7d176Sdrh     }
1748cce7d176Sdrh     case TK_NOT: {
17494adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
1750cce7d176Sdrh       break;
1751cce7d176Sdrh     }
1752cce7d176Sdrh     case TK_LT:
1753cce7d176Sdrh     case TK_LE:
1754cce7d176Sdrh     case TK_GT:
1755cce7d176Sdrh     case TK_GE:
1756cce7d176Sdrh     case TK_NE:
17570ac65892Sdrh     case TK_EQ: {
1758f2bc013cSdrh       assert( TK_LT==OP_Lt );
1759f2bc013cSdrh       assert( TK_LE==OP_Le );
1760f2bc013cSdrh       assert( TK_GT==OP_Gt );
1761f2bc013cSdrh       assert( TK_GE==OP_Ge );
1762f2bc013cSdrh       assert( TK_EQ==OP_Eq );
1763f2bc013cSdrh       assert( TK_NE==OP_Ne );
17644adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
17654adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pRight);
1766be5c89acSdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op, dest, jumpIfNull);
1767cce7d176Sdrh       break;
1768cce7d176Sdrh     }
1769cce7d176Sdrh     case TK_ISNULL:
1770cce7d176Sdrh     case TK_NOTNULL: {
1771f2bc013cSdrh       assert( TK_ISNULL==OP_IsNull );
1772f2bc013cSdrh       assert( TK_NOTNULL==OP_NotNull );
17734adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
17744adee20fSdanielk1977       sqlite3VdbeAddOp(v, op, 1, dest);
1775cce7d176Sdrh       break;
1776cce7d176Sdrh     }
1777fef5208cSdrh     case TK_BETWEEN: {
17780202b29eSdanielk1977       /* The expression "x BETWEEN y AND z" is implemented as:
17790202b29eSdanielk1977       **
17800202b29eSdanielk1977       ** 1 IF (x < y) GOTO 3
17810202b29eSdanielk1977       ** 2 IF (x <= z) GOTO <dest>
17820202b29eSdanielk1977       ** 3 ...
17830202b29eSdanielk1977       */
1784f5905aa7Sdrh       int addr;
1785be5c89acSdrh       Expr *pLeft = pExpr->pLeft;
1786be5c89acSdrh       Expr *pRight = pExpr->pList->a[0].pExpr;
1787be5c89acSdrh       sqlite3ExprCode(pParse, pLeft);
17884adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Dup, 0, 0);
1789be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
1790be5c89acSdrh       addr = codeCompare(pParse, pLeft, pRight, OP_Lt, 0, !jumpIfNull);
17910202b29eSdanielk1977 
1792be5c89acSdrh       pRight = pExpr->pList->a[1].pExpr;
1793be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
1794be5c89acSdrh       codeCompare(pParse, pLeft, pRight, OP_Le, dest, jumpIfNull);
17950202b29eSdanielk1977 
17964adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Integer, 0, 0);
17974adee20fSdanielk1977       sqlite3VdbeChangeP2(v, addr, sqlite3VdbeCurrentAddr(v));
17984adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Pop, 1, 0);
1799fef5208cSdrh       break;
1800fef5208cSdrh     }
1801cce7d176Sdrh     default: {
18024adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr);
18034adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_If, jumpIfNull, dest);
1804cce7d176Sdrh       break;
1805cce7d176Sdrh     }
1806cce7d176Sdrh   }
1807cce7d176Sdrh }
1808cce7d176Sdrh 
1809cce7d176Sdrh /*
181066b89c8fSdrh ** Generate code for a boolean expression such that a jump is made
1811cce7d176Sdrh ** to the label "dest" if the expression is false but execution
1812cce7d176Sdrh ** continues straight thru if the expression is true.
1813f5905aa7Sdrh **
1814f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false) then
1815f5905aa7Sdrh ** jump if jumpIfNull is true or fall through if jumpIfNull is false.
1816cce7d176Sdrh */
18174adee20fSdanielk1977 void sqlite3ExprIfFalse(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
1818cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
1819cce7d176Sdrh   int op = 0;
1820daffd0e5Sdrh   if( v==0 || pExpr==0 ) return;
1821f2bc013cSdrh 
1822f2bc013cSdrh   /* The value of pExpr->op and op are related as follows:
1823f2bc013cSdrh   **
1824f2bc013cSdrh   **       pExpr->op            op
1825f2bc013cSdrh   **       ---------          ----------
1826f2bc013cSdrh   **       TK_ISNULL          OP_NotNull
1827f2bc013cSdrh   **       TK_NOTNULL         OP_IsNull
1828f2bc013cSdrh   **       TK_NE              OP_Eq
1829f2bc013cSdrh   **       TK_EQ              OP_Ne
1830f2bc013cSdrh   **       TK_GT              OP_Le
1831f2bc013cSdrh   **       TK_LE              OP_Gt
1832f2bc013cSdrh   **       TK_GE              OP_Lt
1833f2bc013cSdrh   **       TK_LT              OP_Ge
1834f2bc013cSdrh   **
1835f2bc013cSdrh   ** For other values of pExpr->op, op is undefined and unused.
1836f2bc013cSdrh   ** The value of TK_ and OP_ constants are arranged such that we
1837f2bc013cSdrh   ** can compute the mapping above using the following expression.
1838f2bc013cSdrh   ** Assert()s verify that the computation is correct.
1839f2bc013cSdrh   */
1840f2bc013cSdrh   op = ((pExpr->op+(TK_ISNULL&1))^1)-(TK_ISNULL&1);
1841f2bc013cSdrh 
1842f2bc013cSdrh   /* Verify correct alignment of TK_ and OP_ constants
1843f2bc013cSdrh   */
1844f2bc013cSdrh   assert( pExpr->op!=TK_ISNULL || op==OP_NotNull );
1845f2bc013cSdrh   assert( pExpr->op!=TK_NOTNULL || op==OP_IsNull );
1846f2bc013cSdrh   assert( pExpr->op!=TK_NE || op==OP_Eq );
1847f2bc013cSdrh   assert( pExpr->op!=TK_EQ || op==OP_Ne );
1848f2bc013cSdrh   assert( pExpr->op!=TK_LT || op==OP_Ge );
1849f2bc013cSdrh   assert( pExpr->op!=TK_LE || op==OP_Gt );
1850f2bc013cSdrh   assert( pExpr->op!=TK_GT || op==OP_Le );
1851f2bc013cSdrh   assert( pExpr->op!=TK_GE || op==OP_Lt );
1852f2bc013cSdrh 
1853cce7d176Sdrh   switch( pExpr->op ){
1854cce7d176Sdrh     case TK_AND: {
18554adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
18564adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
1857cce7d176Sdrh       break;
1858cce7d176Sdrh     }
1859cce7d176Sdrh     case TK_OR: {
18604adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
18614adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, d2, !jumpIfNull);
18624adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
18634adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
1864cce7d176Sdrh       break;
1865cce7d176Sdrh     }
1866cce7d176Sdrh     case TK_NOT: {
18674adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
1868cce7d176Sdrh       break;
1869cce7d176Sdrh     }
1870cce7d176Sdrh     case TK_LT:
1871cce7d176Sdrh     case TK_LE:
1872cce7d176Sdrh     case TK_GT:
1873cce7d176Sdrh     case TK_GE:
1874cce7d176Sdrh     case TK_NE:
1875cce7d176Sdrh     case TK_EQ: {
18764adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
18774adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pRight);
1878be5c89acSdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op, dest, jumpIfNull);
1879cce7d176Sdrh       break;
1880cce7d176Sdrh     }
1881cce7d176Sdrh     case TK_ISNULL:
1882cce7d176Sdrh     case TK_NOTNULL: {
18834adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
18844adee20fSdanielk1977       sqlite3VdbeAddOp(v, op, 1, dest);
1885cce7d176Sdrh       break;
1886cce7d176Sdrh     }
1887fef5208cSdrh     case TK_BETWEEN: {
18880202b29eSdanielk1977       /* The expression is "x BETWEEN y AND z". It is implemented as:
18890202b29eSdanielk1977       **
18900202b29eSdanielk1977       ** 1 IF (x >= y) GOTO 3
18910202b29eSdanielk1977       ** 2 GOTO <dest>
18920202b29eSdanielk1977       ** 3 IF (x > z) GOTO <dest>
18930202b29eSdanielk1977       */
1894fef5208cSdrh       int addr;
1895be5c89acSdrh       Expr *pLeft = pExpr->pLeft;
1896be5c89acSdrh       Expr *pRight = pExpr->pList->a[0].pExpr;
1897be5c89acSdrh       sqlite3ExprCode(pParse, pLeft);
18984adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Dup, 0, 0);
1899be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
19004adee20fSdanielk1977       addr = sqlite3VdbeCurrentAddr(v);
1901be5c89acSdrh       codeCompare(pParse, pLeft, pRight, OP_Ge, addr+3, !jumpIfNull);
1902be5c89acSdrh 
19034adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Pop, 1, 0);
19044adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Goto, 0, dest);
1905be5c89acSdrh       pRight = pExpr->pList->a[1].pExpr;
1906be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
1907be5c89acSdrh       codeCompare(pParse, pLeft, pRight, OP_Gt, dest, jumpIfNull);
1908fef5208cSdrh       break;
1909fef5208cSdrh     }
1910cce7d176Sdrh     default: {
19114adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr);
19124adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_IfNot, jumpIfNull, dest);
1913cce7d176Sdrh       break;
1914cce7d176Sdrh     }
1915cce7d176Sdrh   }
1916cce7d176Sdrh }
19172282792aSdrh 
19182282792aSdrh /*
19192282792aSdrh ** Do a deep comparison of two expression trees.  Return TRUE (non-zero)
19202282792aSdrh ** if they are identical and return FALSE if they differ in any way.
19212282792aSdrh */
19224adee20fSdanielk1977 int sqlite3ExprCompare(Expr *pA, Expr *pB){
19232282792aSdrh   int i;
19242282792aSdrh   if( pA==0 ){
19252282792aSdrh     return pB==0;
19262282792aSdrh   }else if( pB==0 ){
19272282792aSdrh     return 0;
19282282792aSdrh   }
19292282792aSdrh   if( pA->op!=pB->op ) return 0;
19304adee20fSdanielk1977   if( !sqlite3ExprCompare(pA->pLeft, pB->pLeft) ) return 0;
19314adee20fSdanielk1977   if( !sqlite3ExprCompare(pA->pRight, pB->pRight) ) return 0;
19322282792aSdrh   if( pA->pList ){
19332282792aSdrh     if( pB->pList==0 ) return 0;
19342282792aSdrh     if( pA->pList->nExpr!=pB->pList->nExpr ) return 0;
19352282792aSdrh     for(i=0; i<pA->pList->nExpr; i++){
19364adee20fSdanielk1977       if( !sqlite3ExprCompare(pA->pList->a[i].pExpr, pB->pList->a[i].pExpr) ){
19372282792aSdrh         return 0;
19382282792aSdrh       }
19392282792aSdrh     }
19402282792aSdrh   }else if( pB->pList ){
19412282792aSdrh     return 0;
19422282792aSdrh   }
19432282792aSdrh   if( pA->pSelect || pB->pSelect ) return 0;
19442f2c01e5Sdrh   if( pA->iTable!=pB->iTable || pA->iColumn!=pB->iColumn ) return 0;
19452282792aSdrh   if( pA->token.z ){
19462282792aSdrh     if( pB->token.z==0 ) return 0;
19476977fea8Sdrh     if( pB->token.n!=pA->token.n ) return 0;
19484adee20fSdanielk1977     if( sqlite3StrNICmp(pA->token.z, pB->token.z, pB->token.n)!=0 ) return 0;
19492282792aSdrh   }
19502282792aSdrh   return 1;
19512282792aSdrh }
19522282792aSdrh 
19532282792aSdrh /*
19542282792aSdrh ** Add a new element to the pParse->aAgg[] array and return its index.
195573b211abSdrh ** The new element is initialized to zero.  The calling function is
195673b211abSdrh ** expected to fill it in.
19572282792aSdrh */
19582282792aSdrh static int appendAggInfo(Parse *pParse){
19592282792aSdrh   if( (pParse->nAgg & 0x7)==0 ){
19602282792aSdrh     int amt = pParse->nAgg + 8;
19616d4abfbeSdrh     AggExpr *aAgg = sqliteRealloc(pParse->aAgg, amt*sizeof(pParse->aAgg[0]));
19626d4abfbeSdrh     if( aAgg==0 ){
19632282792aSdrh       return -1;
19642282792aSdrh     }
19656d4abfbeSdrh     pParse->aAgg = aAgg;
19662282792aSdrh   }
19672282792aSdrh   memset(&pParse->aAgg[pParse->nAgg], 0, sizeof(pParse->aAgg[0]));
19682282792aSdrh   return pParse->nAgg++;
19692282792aSdrh }
19702282792aSdrh 
19712282792aSdrh /*
1972626a879aSdrh ** This is an xFunc for walkExprTree() used to implement
1973626a879aSdrh ** sqlite3ExprAnalyzeAggregates().  See sqlite3ExprAnalyzeAggregates
1974626a879aSdrh ** for additional information.
19752282792aSdrh **
1976626a879aSdrh ** This routine analyzes the aggregate function at pExpr.
19772282792aSdrh */
1978626a879aSdrh static int analyzeAggregate(void *pArg, Expr *pExpr){
19792282792aSdrh   int i;
19802282792aSdrh   AggExpr *aAgg;
1981a58fdfb1Sdanielk1977   NameContext *pNC = (NameContext *)pArg;
1982a58fdfb1Sdanielk1977   Parse *pParse = pNC->pParse;
1983a58fdfb1Sdanielk1977   SrcList *pSrcList = pNC->pSrcList;
19842282792aSdrh 
19852282792aSdrh   switch( pExpr->op ){
1986967e8b73Sdrh     case TK_COLUMN: {
1987a58fdfb1Sdanielk1977       for(i=0; pSrcList && i<pSrcList->nSrc; i++){
1988a58fdfb1Sdanielk1977         if( pExpr->iTable==pSrcList->a[i].iCursor ){
19892282792aSdrh           aAgg = pParse->aAgg;
19902282792aSdrh           for(i=0; i<pParse->nAgg; i++){
19912282792aSdrh             if( aAgg[i].isAgg ) continue;
19922282792aSdrh             if( aAgg[i].pExpr->iTable==pExpr->iTable
1993967e8b73Sdrh              && aAgg[i].pExpr->iColumn==pExpr->iColumn ){
19942282792aSdrh               break;
19952282792aSdrh             }
19962282792aSdrh           }
19972282792aSdrh           if( i>=pParse->nAgg ){
19982282792aSdrh             i = appendAggInfo(pParse);
19992282792aSdrh             if( i<0 ) return 1;
20002282792aSdrh             pParse->aAgg[i].isAgg = 0;
20012282792aSdrh             pParse->aAgg[i].pExpr = pExpr;
20022282792aSdrh           }
2003aaf88729Sdrh           pExpr->iAgg = i;
2004a58fdfb1Sdanielk1977           pExpr->iAggCtx = pNC->nDepth;
2005a58fdfb1Sdanielk1977           return 1;
2006a58fdfb1Sdanielk1977         }
2007a58fdfb1Sdanielk1977       }
2008626a879aSdrh       return 1;
20092282792aSdrh     }
20102282792aSdrh     case TK_AGG_FUNCTION: {
2011a58fdfb1Sdanielk1977       if( pNC->nDepth==0 ){
20122282792aSdrh         aAgg = pParse->aAgg;
20132282792aSdrh         for(i=0; i<pParse->nAgg; i++){
20142282792aSdrh           if( !aAgg[i].isAgg ) continue;
20154adee20fSdanielk1977           if( sqlite3ExprCompare(aAgg[i].pExpr, pExpr) ){
20162282792aSdrh             break;
20172282792aSdrh           }
20182282792aSdrh         }
20192282792aSdrh         if( i>=pParse->nAgg ){
2020d8123366Sdanielk1977           u8 enc = pParse->db->enc;
20212282792aSdrh           i = appendAggInfo(pParse);
20222282792aSdrh           if( i<0 ) return 1;
20232282792aSdrh           pParse->aAgg[i].isAgg = 1;
20242282792aSdrh           pParse->aAgg[i].pExpr = pExpr;
20254adee20fSdanielk1977           pParse->aAgg[i].pFunc = sqlite3FindFunction(pParse->db,
20266977fea8Sdrh                pExpr->token.z, pExpr->token.n,
2027d8123366Sdanielk1977                pExpr->pList ? pExpr->pList->nExpr : 0, enc, 0);
20282282792aSdrh         }
20292282792aSdrh         pExpr->iAgg = i;
2030626a879aSdrh         return 1;
20312282792aSdrh       }
20322282792aSdrh     }
2033a58fdfb1Sdanielk1977   }
2034a58fdfb1Sdanielk1977   if( pExpr->pSelect ){
2035a58fdfb1Sdanielk1977     pNC->nDepth++;
2036a58fdfb1Sdanielk1977     walkSelectExpr(pExpr->pSelect, analyzeAggregate, pNC);
2037a58fdfb1Sdanielk1977     pNC->nDepth--;
2038a58fdfb1Sdanielk1977   }
2039626a879aSdrh   return 0;
20402282792aSdrh }
2041626a879aSdrh 
2042626a879aSdrh /*
2043626a879aSdrh ** Analyze the given expression looking for aggregate functions and
2044626a879aSdrh ** for variables that need to be added to the pParse->aAgg[] array.
2045626a879aSdrh ** Make additional entries to the pParse->aAgg[] array as necessary.
2046626a879aSdrh **
2047626a879aSdrh ** This routine should only be called after the expression has been
2048626a879aSdrh ** analyzed by sqlite3ExprResolveNames().
2049626a879aSdrh **
2050626a879aSdrh ** If errors are seen, leave an error message in zErrMsg and return
2051626a879aSdrh ** the number of errors.
2052626a879aSdrh */
2053a58fdfb1Sdanielk1977 int sqlite3ExprAnalyzeAggregates(NameContext *pNC, Expr *pExpr){
2054a58fdfb1Sdanielk1977   int nErr = pNC->pParse->nErr;
2055a58fdfb1Sdanielk1977   walkExprTree(pExpr, analyzeAggregate, pNC);
2056a58fdfb1Sdanielk1977   return pNC->pParse->nErr - nErr;
20572282792aSdrh }
2058