xref: /sqlite-3.40.0/src/expr.c (revision 873fac0c)
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*873fac0cSdrh ** $Id: expr.c,v 1.204 2005/06/06 17:11:46 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 ){
820*873fac0cSdrh             IdList *pUsing;
8218141f61eSdrh             cnt++;
8228141f61eSdrh             pExpr->iTable = pItem->iCursor;
82351669863Sdrh             pMatch = pItem;
8248141f61eSdrh             pExpr->iDb = pTab->iDb;
8258141f61eSdrh             /* Substitute the rowid (column -1) for the INTEGER PRIMARY KEY */
8268141f61eSdrh             pExpr->iColumn = j==pTab->iPKey ? -1 : j;
827a37cdde0Sdanielk1977             pExpr->affinity = pTab->aCol[j].affinity;
8280202b29eSdanielk1977             pExpr->pColl = pTab->aCol[j].pColl;
829355ef361Sdrh             if( pItem->jointype & JT_NATURAL ){
830355ef361Sdrh               /* If this match occurred in the left table of a natural join,
831355ef361Sdrh               ** then skip the right table to avoid a duplicate match */
832355ef361Sdrh               pItem++;
833355ef361Sdrh               i++;
834355ef361Sdrh             }
835*873fac0cSdrh             if( (pUsing = pItem->pUsing)!=0 ){
836*873fac0cSdrh               /* If this match occurs on a column that is in the USING clause
837*873fac0cSdrh               ** of a join, skip the search of the right table of the join
838*873fac0cSdrh               ** to avoid a duplicate match there. */
839*873fac0cSdrh               int k;
840*873fac0cSdrh               for(k=0; k<pUsing->nId; k++){
841*873fac0cSdrh                 if( sqlite3StrICmp(pUsing->a[k].zName, zCol)==0 ){
842*873fac0cSdrh                   pItem++;
843*873fac0cSdrh                   i++;
844*873fac0cSdrh                   break;
845*873fac0cSdrh                 }
846*873fac0cSdrh               }
847*873fac0cSdrh             }
8488141f61eSdrh             break;
8498141f61eSdrh           }
8508141f61eSdrh         }
8518141f61eSdrh       }
852b3bce662Sdanielk1977     }
8538141f61eSdrh 
854b7f9164eSdrh #ifndef SQLITE_OMIT_TRIGGER
8558141f61eSdrh     /* If we have not already resolved the name, then maybe
8568141f61eSdrh     ** it is a new.* or old.* trigger argument reference
8578141f61eSdrh     */
8588141f61eSdrh     if( zDb==0 && zTab!=0 && cnt==0 && pParse->trigStack!=0 ){
8598141f61eSdrh       TriggerStack *pTriggerStack = pParse->trigStack;
8608141f61eSdrh       Table *pTab = 0;
8614adee20fSdanielk1977       if( pTriggerStack->newIdx != -1 && sqlite3StrICmp("new", zTab) == 0 ){
8628141f61eSdrh         pExpr->iTable = pTriggerStack->newIdx;
8638141f61eSdrh         assert( pTriggerStack->pTab );
8648141f61eSdrh         pTab = pTriggerStack->pTab;
8654adee20fSdanielk1977       }else if( pTriggerStack->oldIdx != -1 && sqlite3StrICmp("old", zTab)==0 ){
8668141f61eSdrh         pExpr->iTable = pTriggerStack->oldIdx;
8678141f61eSdrh         assert( pTriggerStack->pTab );
8688141f61eSdrh         pTab = pTriggerStack->pTab;
8698141f61eSdrh       }
8708141f61eSdrh 
8718141f61eSdrh       if( pTab ){
8728141f61eSdrh         int j;
8738141f61eSdrh         Column *pCol = pTab->aCol;
8748141f61eSdrh 
8758141f61eSdrh         pExpr->iDb = pTab->iDb;
8768141f61eSdrh         cntTab++;
8778141f61eSdrh         for(j=0; j < pTab->nCol; j++, pCol++) {
8784adee20fSdanielk1977           if( sqlite3StrICmp(pCol->zName, zCol)==0 ){
8798141f61eSdrh             cnt++;
8808141f61eSdrh             pExpr->iColumn = j==pTab->iPKey ? -1 : j;
881a37cdde0Sdanielk1977             pExpr->affinity = pTab->aCol[j].affinity;
8820202b29eSdanielk1977             pExpr->pColl = pTab->aCol[j].pColl;
883aee18ef8Sdanielk1977             pExpr->pTab = pTab;
8848141f61eSdrh             break;
8858141f61eSdrh           }
8868141f61eSdrh         }
8878141f61eSdrh       }
8888141f61eSdrh     }
889b7f9164eSdrh #endif /* !defined(SQLITE_OMIT_TRIGGER) */
8908141f61eSdrh 
8918141f61eSdrh     /*
8928141f61eSdrh     ** Perhaps the name is a reference to the ROWID
8938141f61eSdrh     */
8944adee20fSdanielk1977     if( cnt==0 && cntTab==1 && sqlite3IsRowid(zCol) ){
8958141f61eSdrh       cnt = 1;
8968141f61eSdrh       pExpr->iColumn = -1;
897a37cdde0Sdanielk1977       pExpr->affinity = SQLITE_AFF_INTEGER;
8988141f61eSdrh     }
8998141f61eSdrh 
9008141f61eSdrh     /*
9018141f61eSdrh     ** If the input is of the form Z (not Y.Z or X.Y.Z) then the name Z
9028141f61eSdrh     ** might refer to an result-set alias.  This happens, for example, when
9038141f61eSdrh     ** we are resolving names in the WHERE clause of the following command:
9048141f61eSdrh     **
9058141f61eSdrh     **     SELECT a+b AS x FROM table WHERE x<10;
9068141f61eSdrh     **
9078141f61eSdrh     ** In cases like this, replace pExpr with a copy of the expression that
9088141f61eSdrh     ** forms the result set entry ("a+b" in the example) and return immediately.
9098141f61eSdrh     ** Note that the expression in the result set should have already been
9108141f61eSdrh     ** resolved by the time the WHERE clause is resolved.
9118141f61eSdrh     */
91279d5f63fSdrh     if( cnt==0 && pEList!=0 && zTab==0 ){
9138141f61eSdrh       for(j=0; j<pEList->nExpr; j++){
9148141f61eSdrh         char *zAs = pEList->a[j].zName;
9154adee20fSdanielk1977         if( zAs!=0 && sqlite3StrICmp(zAs, zCol)==0 ){
9168141f61eSdrh           assert( pExpr->pLeft==0 && pExpr->pRight==0 );
9178141f61eSdrh           pExpr->op = TK_AS;
9188141f61eSdrh           pExpr->iColumn = j;
9194adee20fSdanielk1977           pExpr->pLeft = sqlite3ExprDup(pEList->a[j].pExpr);
92015ccce1cSdrh           cnt = 1;
9218141f61eSdrh           assert( zTab==0 && zDb==0 );
92215ccce1cSdrh           goto lookupname_end_2;
9238141f61eSdrh         }
9248141f61eSdrh       }
9258141f61eSdrh     }
9268141f61eSdrh 
927626a879aSdrh     /* Advance to the next name context.  The loop will exit when either
928626a879aSdrh     ** we have a match (cnt>0) or when we run out of name contexts.
929626a879aSdrh     */
930626a879aSdrh     if( cnt==0 ){
931626a879aSdrh       pNC = pNC->pNext;
932626a879aSdrh     }
933626a879aSdrh   }
934626a879aSdrh 
9358141f61eSdrh   /*
9368141f61eSdrh   ** If X and Y are NULL (in other words if only the column name Z is
9378141f61eSdrh   ** supplied) and the value of Z is enclosed in double-quotes, then
9388141f61eSdrh   ** Z is a string literal if it doesn't match any column names.  In that
9398141f61eSdrh   ** case, we need to return right away and not make any changes to
9408141f61eSdrh   ** pExpr.
94115ccce1cSdrh   **
94215ccce1cSdrh   ** Because no reference was made to outer contexts, the pNC->nRef
94315ccce1cSdrh   ** fields are not changed in any context.
9448141f61eSdrh   */
9458141f61eSdrh   if( cnt==0 && zTab==0 && pColumnToken->z[0]=='"' ){
9468141f61eSdrh     sqliteFree(zCol);
9478141f61eSdrh     return 0;
9488141f61eSdrh   }
9498141f61eSdrh 
9508141f61eSdrh   /*
9518141f61eSdrh   ** cnt==0 means there was not match.  cnt>1 means there were two or
9528141f61eSdrh   ** more matches.  Either way, we have an error.
9538141f61eSdrh   */
9548141f61eSdrh   if( cnt!=1 ){
9558141f61eSdrh     char *z = 0;
9568141f61eSdrh     char *zErr;
9578141f61eSdrh     zErr = cnt==0 ? "no such column: %s" : "ambiguous column name: %s";
9588141f61eSdrh     if( zDb ){
9594adee20fSdanielk1977       sqlite3SetString(&z, zDb, ".", zTab, ".", zCol, 0);
9608141f61eSdrh     }else if( zTab ){
9614adee20fSdanielk1977       sqlite3SetString(&z, zTab, ".", zCol, 0);
9628141f61eSdrh     }else{
9638141f61eSdrh       z = sqliteStrDup(zCol);
9648141f61eSdrh     }
9654adee20fSdanielk1977     sqlite3ErrorMsg(pParse, zErr, z);
9668141f61eSdrh     sqliteFree(z);
96773b211abSdrh     pTopNC->nErr++;
9688141f61eSdrh   }
9698141f61eSdrh 
97051669863Sdrh   /* If a column from a table in pSrcList is referenced, then record
97151669863Sdrh   ** this fact in the pSrcList.a[].colUsed bitmask.  Column 0 causes
97251669863Sdrh   ** bit 0 to be set.  Column 1 sets bit 1.  And so forth.  If the
97351669863Sdrh   ** column number is greater than the number of bits in the bitmask
97451669863Sdrh   ** then set the high-order bit of the bitmask.
97551669863Sdrh   */
97651669863Sdrh   if( pExpr->iColumn>=0 && pMatch!=0 ){
97751669863Sdrh     int n = pExpr->iColumn;
97851669863Sdrh     if( n>=sizeof(Bitmask)*8 ){
97951669863Sdrh       n = sizeof(Bitmask)*8-1;
98051669863Sdrh     }
98151669863Sdrh     assert( pMatch->iCursor==pExpr->iTable );
98251669863Sdrh     pMatch->colUsed |= 1<<n;
98351669863Sdrh   }
98451669863Sdrh 
985d5d56523Sdanielk1977 lookupname_end:
9868141f61eSdrh   /* Clean up and return
9878141f61eSdrh   */
9888141f61eSdrh   sqliteFree(zDb);
9898141f61eSdrh   sqliteFree(zTab);
9904adee20fSdanielk1977   sqlite3ExprDelete(pExpr->pLeft);
9918141f61eSdrh   pExpr->pLeft = 0;
9924adee20fSdanielk1977   sqlite3ExprDelete(pExpr->pRight);
9938141f61eSdrh   pExpr->pRight = 0;
9948141f61eSdrh   pExpr->op = TK_COLUMN;
99515ccce1cSdrh lookupname_end_2:
99615ccce1cSdrh   sqliteFree(zCol);
997626a879aSdrh   if( cnt==1 ){
998b3bce662Sdanielk1977     assert( pNC!=0 );
999626a879aSdrh     sqlite3AuthRead(pParse, pExpr, pNC->pSrcList);
1000aee18ef8Sdanielk1977     if( pMatch && !pMatch->pSelect ){
1001aee18ef8Sdanielk1977       pExpr->pTab = pMatch->pTab;
1002aee18ef8Sdanielk1977     }
100315ccce1cSdrh     /* Increment the nRef value on all name contexts from TopNC up to
100415ccce1cSdrh     ** the point where the name matched. */
100515ccce1cSdrh     for(;;){
100615ccce1cSdrh       assert( pTopNC!=0 );
100715ccce1cSdrh       pTopNC->nRef++;
100815ccce1cSdrh       if( pTopNC==pNC ) break;
100915ccce1cSdrh       pTopNC = pTopNC->pNext;
1010626a879aSdrh     }
101115ccce1cSdrh     return 0;
101215ccce1cSdrh   } else {
101315ccce1cSdrh     return 1;
101415ccce1cSdrh   }
10158141f61eSdrh }
10168141f61eSdrh 
10178141f61eSdrh /*
1018626a879aSdrh ** This routine is designed as an xFunc for walkExprTree().
1019626a879aSdrh **
102073b211abSdrh ** Resolve symbolic names into TK_COLUMN operators for the current
1021626a879aSdrh ** node in the expression tree.  Return 0 to continue the search down
102273b211abSdrh ** the tree or 2 to abort the tree walk.
102373b211abSdrh **
102473b211abSdrh ** This routine also does error checking and name resolution for
102573b211abSdrh ** function names.  The operator for aggregate functions is changed
102673b211abSdrh ** to TK_AGG_FUNCTION.
1027626a879aSdrh */
1028626a879aSdrh static int nameResolverStep(void *pArg, Expr *pExpr){
1029626a879aSdrh   NameContext *pNC = (NameContext*)pArg;
1030626a879aSdrh   SrcList *pSrcList;
1031626a879aSdrh   Parse *pParse;
1032626a879aSdrh 
1033b3bce662Sdanielk1977   if( pExpr==0 ) return 1;
1034626a879aSdrh   assert( pNC!=0 );
1035626a879aSdrh   pSrcList = pNC->pSrcList;
1036626a879aSdrh   pParse = pNC->pParse;
1037b3bce662Sdanielk1977 
1038626a879aSdrh   if( ExprHasAnyProperty(pExpr, EP_Resolved) ) return 1;
1039626a879aSdrh   ExprSetProperty(pExpr, EP_Resolved);
1040626a879aSdrh #ifndef NDEBUG
1041626a879aSdrh   if( pSrcList ){
1042940fac9dSdanielk1977     int i;
1043626a879aSdrh     for(i=0; i<pSrcList->nSrc; i++){
1044626a879aSdrh       assert( pSrcList->a[i].iCursor>=0 && pSrcList->a[i].iCursor<pParse->nTab);
1045626a879aSdrh     }
1046626a879aSdrh   }
1047626a879aSdrh #endif
1048626a879aSdrh   switch( pExpr->op ){
1049626a879aSdrh     /* Double-quoted strings (ex: "abc") are used as identifiers if
1050626a879aSdrh     ** possible.  Otherwise they remain as strings.  Single-quoted
1051626a879aSdrh     ** strings (ex: 'abc') are always string literals.
1052626a879aSdrh     */
1053626a879aSdrh     case TK_STRING: {
1054626a879aSdrh       if( pExpr->token.z[0]=='\'' ) break;
1055626a879aSdrh       /* Fall thru into the TK_ID case if this is a double-quoted string */
1056626a879aSdrh     }
1057626a879aSdrh     /* A lone identifier is the name of a column.
1058626a879aSdrh     */
1059626a879aSdrh     case TK_ID: {
1060626a879aSdrh       lookupName(pParse, 0, 0, &pExpr->token, pNC, pExpr);
1061626a879aSdrh       return 1;
1062626a879aSdrh     }
1063626a879aSdrh 
1064626a879aSdrh     /* A table name and column name:     ID.ID
1065626a879aSdrh     ** Or a database, table and column:  ID.ID.ID
1066626a879aSdrh     */
1067626a879aSdrh     case TK_DOT: {
1068626a879aSdrh       Token *pColumn;
1069626a879aSdrh       Token *pTable;
1070626a879aSdrh       Token *pDb;
1071626a879aSdrh       Expr *pRight;
1072626a879aSdrh 
1073b3bce662Sdanielk1977       /* if( pSrcList==0 ) break; */
1074626a879aSdrh       pRight = pExpr->pRight;
1075626a879aSdrh       if( pRight->op==TK_ID ){
1076626a879aSdrh         pDb = 0;
1077626a879aSdrh         pTable = &pExpr->pLeft->token;
1078626a879aSdrh         pColumn = &pRight->token;
1079626a879aSdrh       }else{
1080626a879aSdrh         assert( pRight->op==TK_DOT );
1081626a879aSdrh         pDb = &pExpr->pLeft->token;
1082626a879aSdrh         pTable = &pRight->pLeft->token;
1083626a879aSdrh         pColumn = &pRight->pRight->token;
1084626a879aSdrh       }
1085626a879aSdrh       lookupName(pParse, pDb, pTable, pColumn, pNC, pExpr);
1086626a879aSdrh       return 1;
1087626a879aSdrh     }
1088626a879aSdrh 
1089626a879aSdrh     /* Resolve function names
1090626a879aSdrh     */
1091b71090fdSdrh     case TK_CONST_FUNC:
1092626a879aSdrh     case TK_FUNCTION: {
1093626a879aSdrh       ExprList *pList = pExpr->pList;    /* The argument list */
1094626a879aSdrh       int n = pList ? pList->nExpr : 0;  /* Number of arguments */
1095626a879aSdrh       int no_such_func = 0;       /* True if no such function exists */
1096626a879aSdrh       int wrong_num_args = 0;     /* True if wrong number of arguments */
1097626a879aSdrh       int is_agg = 0;             /* True if is an aggregate function */
1098626a879aSdrh       int i;
1099626a879aSdrh       int nId;                    /* Number of characters in function name */
1100626a879aSdrh       const char *zId;            /* The function name. */
110173b211abSdrh       FuncDef *pDef;              /* Information about the function */
110273b211abSdrh       int enc = pParse->db->enc;  /* The database encoding */
1103626a879aSdrh 
1104b71090fdSdrh       zId = pExpr->token.z;
1105b71090fdSdrh       nId = pExpr->token.n;
1106626a879aSdrh       pDef = sqlite3FindFunction(pParse->db, zId, nId, n, enc, 0);
1107626a879aSdrh       if( pDef==0 ){
1108626a879aSdrh         pDef = sqlite3FindFunction(pParse->db, zId, nId, -1, enc, 0);
1109626a879aSdrh         if( pDef==0 ){
1110626a879aSdrh           no_such_func = 1;
1111626a879aSdrh         }else{
1112626a879aSdrh           wrong_num_args = 1;
1113626a879aSdrh         }
1114626a879aSdrh       }else{
1115626a879aSdrh         is_agg = pDef->xFunc==0;
1116626a879aSdrh       }
1117626a879aSdrh       if( is_agg && !pNC->allowAgg ){
1118626a879aSdrh         sqlite3ErrorMsg(pParse, "misuse of aggregate function %.*s()", nId,zId);
1119626a879aSdrh         pNC->nErr++;
1120626a879aSdrh         is_agg = 0;
1121626a879aSdrh       }else if( no_such_func ){
1122626a879aSdrh         sqlite3ErrorMsg(pParse, "no such function: %.*s", nId, zId);
1123626a879aSdrh         pNC->nErr++;
1124626a879aSdrh       }else if( wrong_num_args ){
1125626a879aSdrh         sqlite3ErrorMsg(pParse,"wrong number of arguments to function %.*s()",
1126626a879aSdrh              nId, zId);
1127626a879aSdrh         pNC->nErr++;
1128626a879aSdrh       }
1129626a879aSdrh       if( is_agg ){
1130626a879aSdrh         pExpr->op = TK_AGG_FUNCTION;
1131626a879aSdrh         pNC->hasAgg = 1;
1132626a879aSdrh       }
113373b211abSdrh       if( is_agg ) pNC->allowAgg = 0;
1134626a879aSdrh       for(i=0; pNC->nErr==0 && i<n; i++){
113573b211abSdrh         walkExprTree(pList->a[i].pExpr, nameResolverStep, pNC);
1136626a879aSdrh       }
113773b211abSdrh       if( is_agg ) pNC->allowAgg = 1;
1138626a879aSdrh       /* FIX ME:  Compute pExpr->affinity based on the expected return
1139626a879aSdrh       ** type of the function
1140626a879aSdrh       */
1141626a879aSdrh       return is_agg;
1142626a879aSdrh     }
1143b3bce662Sdanielk1977 #ifndef SQLITE_OMIT_SUBQUERY
1144b3bce662Sdanielk1977     case TK_SELECT:
1145b3bce662Sdanielk1977     case TK_EXISTS:
1146b3bce662Sdanielk1977 #endif
1147b3bce662Sdanielk1977     case TK_IN: {
1148b3bce662Sdanielk1977       if( pExpr->pSelect ){
1149b3bce662Sdanielk1977         int nRef = pNC->nRef;
1150b3bce662Sdanielk1977         sqlite3SelectResolve(pParse, pExpr->pSelect, pNC);
1151b3bce662Sdanielk1977         assert( pNC->nRef>=nRef );
1152b3bce662Sdanielk1977         if( nRef!=pNC->nRef ){
1153b3bce662Sdanielk1977           ExprSetProperty(pExpr, EP_VarSelect);
1154b3bce662Sdanielk1977         }
1155b3bce662Sdanielk1977       }
1156b3bce662Sdanielk1977     }
1157626a879aSdrh   }
1158626a879aSdrh   return 0;
1159626a879aSdrh }
1160626a879aSdrh 
1161626a879aSdrh /*
1162cce7d176Sdrh ** This routine walks an expression tree and resolves references to
1163967e8b73Sdrh ** table columns.  Nodes of the form ID.ID or ID resolve into an
1164aacc543eSdrh ** index to the table in the table list and a column offset.  The
1165aacc543eSdrh ** Expr.opcode for such nodes is changed to TK_COLUMN.  The Expr.iTable
1166aacc543eSdrh ** value is changed to the index of the referenced table in pTabList
1167832508b7Sdrh ** plus the "base" value.  The base value will ultimately become the
1168aacc543eSdrh ** VDBE cursor number for a cursor that is pointing into the referenced
1169aacc543eSdrh ** table.  The Expr.iColumn value is changed to the index of the column
1170aacc543eSdrh ** of the referenced table.  The Expr.iColumn value for the special
1171aacc543eSdrh ** ROWID column is -1.  Any INTEGER PRIMARY KEY column is tried as an
1172aacc543eSdrh ** alias for ROWID.
117319a775c2Sdrh **
1174626a879aSdrh ** Also resolve function names and check the functions for proper
1175626a879aSdrh ** usage.  Make sure all function names are recognized and all functions
1176626a879aSdrh ** have the correct number of arguments.  Leave an error message
1177626a879aSdrh ** in pParse->zErrMsg if anything is amiss.  Return the number of errors.
1178626a879aSdrh **
117973b211abSdrh ** If the expression contains aggregate functions then set the EP_Agg
118073b211abSdrh ** property on the expression.
1181626a879aSdrh */
1182626a879aSdrh int sqlite3ExprResolveNames(
1183b3bce662Sdanielk1977   NameContext *pNC,       /* Namespace to resolve expressions in. */
1184b3bce662Sdanielk1977   Expr *pExpr             /* The expression to be analyzed. */
1185626a879aSdrh ){
118673b211abSdrh   if( pExpr==0 ) return 0;
1187b3bce662Sdanielk1977   walkExprTree(pExpr, nameResolverStep, pNC);
1188b3bce662Sdanielk1977   if( pNC->nErr>0 ){
118973b211abSdrh     ExprSetProperty(pExpr, EP_Error);
119073b211abSdrh   }
119173b211abSdrh   return ExprHasProperty(pExpr, EP_Error);
1192626a879aSdrh }
1193626a879aSdrh 
11941398ad36Sdrh /*
11951398ad36Sdrh ** A pointer instance of this structure is used to pass information
11961398ad36Sdrh ** through walkExprTree into codeSubqueryStep().
11971398ad36Sdrh */
11981398ad36Sdrh typedef struct QueryCoder QueryCoder;
11991398ad36Sdrh struct QueryCoder {
12001398ad36Sdrh   Parse *pParse;       /* The parsing context */
12011398ad36Sdrh   NameContext *pNC;    /* Namespace of first enclosing query */
12021398ad36Sdrh };
12031398ad36Sdrh 
1204626a879aSdrh 
1205626a879aSdrh /*
1206626a879aSdrh ** Generate code for subqueries and IN operators.
1207626a879aSdrh **
120873b211abSdrh ** IN operators comes in two forms:
1209fef5208cSdrh **
1210fef5208cSdrh **           expr IN (exprlist)
1211fef5208cSdrh ** and
1212fef5208cSdrh **           expr IN (SELECT ...)
1213fef5208cSdrh **
1214fef5208cSdrh ** The first form is handled by creating a set holding the list
1215fef5208cSdrh ** of allowed values.  The second form causes the SELECT to generate
1216fef5208cSdrh ** a temporary table.
1217cce7d176Sdrh */
121851522cd3Sdrh #ifndef SQLITE_OMIT_SUBQUERY
1219b3bce662Sdanielk1977 void sqlite3CodeSubselect(Parse *pParse, Expr *pExpr){
1220b3bce662Sdanielk1977   int label = 0;                         /* Address after sub-select code */
1221b3bce662Sdanielk1977   Vdbe *v = sqlite3GetVdbe(pParse);
1222b3bce662Sdanielk1977   if( v==0 ) return;
1223b3bce662Sdanielk1977 
1224b3bce662Sdanielk1977   /* If this is not a variable (correlated) select, then execute
1225b3bce662Sdanielk1977   ** it only once. Unless this is part of a trigger program. In
1226b3bce662Sdanielk1977   ** that case re-execute every time (this could be optimized).
1227b3bce662Sdanielk1977   */
1228b3bce662Sdanielk1977   if( !ExprHasAnyProperty(pExpr, EP_VarSelect) && !pParse->trigStack ){
1229b3bce662Sdanielk1977     int mem = pParse->nMem++;
1230b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_MemLoad, mem, 0);
1231b3bce662Sdanielk1977     label = sqlite3VdbeMakeLabel(v);
1232b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_If, 0, label);
1233b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_Integer, 1, 0);
1234b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_MemStore, mem, 1);
1235b3bce662Sdanielk1977   }
1236b3bce662Sdanielk1977 
1237b3bce662Sdanielk1977   if( pExpr->pSelect ){
1238b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_AggContextPush, 0, 0);
1239b3bce662Sdanielk1977   }
12406a3ea0e6Sdrh 
1241cce7d176Sdrh   switch( pExpr->op ){
1242fef5208cSdrh     case TK_IN: {
1243e014a838Sdanielk1977       char affinity;
1244d3d39e93Sdrh       KeyInfo keyInfo;
12450202b29eSdanielk1977       int addr;        /* Address of OP_OpenTemp instruction */
1246d3d39e93Sdrh 
1247bf3b721fSdanielk1977       affinity = sqlite3ExprAffinity(pExpr->pLeft);
1248e014a838Sdanielk1977 
1249e014a838Sdanielk1977       /* Whether this is an 'x IN(SELECT...)' or an 'x IN(<exprlist>)'
1250e014a838Sdanielk1977       ** expression it is handled the same way. A temporary table is
1251e014a838Sdanielk1977       ** filled with single-field index keys representing the results
1252e014a838Sdanielk1977       ** from the SELECT or the <exprlist>.
1253fef5208cSdrh       **
1254e014a838Sdanielk1977       ** If the 'x' expression is a column value, or the SELECT...
1255e014a838Sdanielk1977       ** statement returns a column value, then the affinity of that
1256e014a838Sdanielk1977       ** column is used to build the index keys. If both 'x' and the
1257e014a838Sdanielk1977       ** SELECT... statement are columns, then numeric affinity is used
1258e014a838Sdanielk1977       ** if either column has NUMERIC or INTEGER affinity. If neither
1259e014a838Sdanielk1977       ** 'x' nor the SELECT... statement are columns, then numeric affinity
1260e014a838Sdanielk1977       ** is used.
1261fef5208cSdrh       */
1262832508b7Sdrh       pExpr->iTable = pParse->nTab++;
12630202b29eSdanielk1977       addr = sqlite3VdbeAddOp(v, OP_OpenTemp, pExpr->iTable, 0);
1264d3d39e93Sdrh       memset(&keyInfo, 0, sizeof(keyInfo));
1265d3d39e93Sdrh       keyInfo.nField = 1;
1266f3218feaSdrh       sqlite3VdbeAddOp(v, OP_SetNumColumns, pExpr->iTable, 1);
1267e014a838Sdanielk1977 
1268e014a838Sdanielk1977       if( pExpr->pSelect ){
1269e014a838Sdanielk1977         /* Case 1:     expr IN (SELECT ...)
1270e014a838Sdanielk1977         **
1271e014a838Sdanielk1977         ** Generate code to write the results of the select into the temporary
1272e014a838Sdanielk1977         ** table allocated and opened above.
1273e014a838Sdanielk1977         */
1274e014a838Sdanielk1977         int iParm = pExpr->iTable +  (((int)affinity)<<16);
1275be5c89acSdrh         ExprList *pEList;
1276e014a838Sdanielk1977         assert( (pExpr->iTable&0x0000FFFF)==pExpr->iTable );
1277b3bce662Sdanielk1977         sqlite3Select(pParse, pExpr->pSelect, SRT_Set, iParm, 0, 0, 0, 0);
1278be5c89acSdrh         pEList = pExpr->pSelect->pEList;
1279be5c89acSdrh         if( pEList && pEList->nExpr>0 ){
12807cedc8d4Sdanielk1977           keyInfo.aColl[0] = binaryCompareCollSeq(pParse, pExpr->pLeft,
1281be5c89acSdrh               pEList->a[0].pExpr);
12820202b29eSdanielk1977         }
1283fef5208cSdrh       }else if( pExpr->pList ){
1284fef5208cSdrh         /* Case 2:     expr IN (exprlist)
1285fef5208cSdrh         **
1286e014a838Sdanielk1977 	** For each expression, build an index key from the evaluation and
1287e014a838Sdanielk1977         ** store it in the temporary table. If <expr> is a column, then use
1288e014a838Sdanielk1977         ** that columns affinity when building index keys. If <expr> is not
1289e014a838Sdanielk1977         ** a column, use numeric affinity.
1290fef5208cSdrh         */
1291e014a838Sdanielk1977         int i;
1292e014a838Sdanielk1977         if( !affinity ){
1293e014a838Sdanielk1977           affinity = SQLITE_AFF_NUMERIC;
1294e014a838Sdanielk1977         }
12950202b29eSdanielk1977         keyInfo.aColl[0] = pExpr->pLeft->pColl;
1296e014a838Sdanielk1977 
1297e014a838Sdanielk1977         /* Loop through each expression in <exprlist>. */
1298fef5208cSdrh         for(i=0; i<pExpr->pList->nExpr; i++){
1299fef5208cSdrh           Expr *pE2 = pExpr->pList->a[i].pExpr;
1300e014a838Sdanielk1977 
1301e014a838Sdanielk1977           /* Check that the expression is constant and valid. */
13024adee20fSdanielk1977           if( !sqlite3ExprIsConstant(pE2) ){
13034adee20fSdanielk1977             sqlite3ErrorMsg(pParse,
1304da93d238Sdrh               "right-hand side of IN operator must be constant");
1305b3bce662Sdanielk1977             return;
13064794b980Sdrh           }
1307e014a838Sdanielk1977 
1308e014a838Sdanielk1977           /* Evaluate the expression and insert it into the temp table */
13094adee20fSdanielk1977           sqlite3ExprCode(pParse, pE2);
131094a11211Sdrh           sqlite3VdbeOp3(v, OP_MakeRecord, 1, 0, &affinity, 1);
13110f69c1e3Sdanielk1977           sqlite3VdbeAddOp(v, OP_String8, 0, 0);
1312e014a838Sdanielk1977           sqlite3VdbeAddOp(v, OP_PutStrKey, pExpr->iTable, 0);
1313fef5208cSdrh         }
1314fef5208cSdrh       }
13150202b29eSdanielk1977       sqlite3VdbeChangeP3(v, addr, (void *)&keyInfo, P3_KEYINFO);
1316b3bce662Sdanielk1977       break;
1317fef5208cSdrh     }
1318fef5208cSdrh 
131951522cd3Sdrh     case TK_EXISTS:
132019a775c2Sdrh     case TK_SELECT: {
1321fef5208cSdrh       /* This has to be a scalar SELECT.  Generate code to put the
1322fef5208cSdrh       ** value of this select in a memory cell and record the number
1323967e8b73Sdrh       ** of the memory cell in iColumn.
1324fef5208cSdrh       */
132551522cd3Sdrh       int sop;
132651522cd3Sdrh       Select *pSel;
13271398ad36Sdrh 
1328967e8b73Sdrh       pExpr->iColumn = pParse->nMem++;
132951522cd3Sdrh       pSel = pExpr->pSelect;
133051522cd3Sdrh       if( pExpr->op==TK_SELECT ){
133151522cd3Sdrh         sop = SRT_Mem;
133251522cd3Sdrh       }else{
133351522cd3Sdrh         static const Token one = { "1", 0, 1 };
133451522cd3Sdrh         sop = SRT_Exists;
133551522cd3Sdrh         sqlite3ExprListDelete(pSel->pEList);
133651522cd3Sdrh         pSel->pEList = sqlite3ExprListAppend(0,
133751522cd3Sdrh                           sqlite3Expr(TK_INTEGER, 0, 0, &one), 0);
133851522cd3Sdrh       }
1339b3bce662Sdanielk1977       sqlite3Select(pParse, pSel, sop, pExpr->iColumn, 0, 0, 0, 0);
1340b3bce662Sdanielk1977       break;
134119a775c2Sdrh     }
1342cce7d176Sdrh   }
1343b3bce662Sdanielk1977 
1344b3bce662Sdanielk1977   if( pExpr->pSelect ){
1345b3bce662Sdanielk1977     sqlite3VdbeAddOp(v, OP_AggContextPop, 0, 0);
1346b3bce662Sdanielk1977   }
1347b3bce662Sdanielk1977   if( label<0 ){
1348b3bce662Sdanielk1977     sqlite3VdbeResolveLabel(v, label);
1349b3bce662Sdanielk1977   }
1350b3bce662Sdanielk1977   return;
1351cce7d176Sdrh }
135251522cd3Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
1353cce7d176Sdrh 
1354cce7d176Sdrh /*
1355fec19aadSdrh ** Generate an instruction that will put the integer describe by
1356fec19aadSdrh ** text z[0..n-1] on the stack.
1357fec19aadSdrh */
1358fec19aadSdrh static void codeInteger(Vdbe *v, const char *z, int n){
1359fec19aadSdrh   int i;
13606fec0762Sdrh   if( sqlite3GetInt32(z, &i) ){
13616fec0762Sdrh     sqlite3VdbeAddOp(v, OP_Integer, i, 0);
13626fec0762Sdrh   }else if( sqlite3FitsIn64Bits(z) ){
13636fec0762Sdrh     sqlite3VdbeOp3(v, OP_Integer, 0, 0, z, n);
1364fec19aadSdrh   }else{
1365fec19aadSdrh     sqlite3VdbeOp3(v, OP_Real, 0, 0, z, n);
1366fec19aadSdrh   }
1367fec19aadSdrh }
1368fec19aadSdrh 
1369fec19aadSdrh /*
1370cce7d176Sdrh ** Generate code into the current Vdbe to evaluate the given
13711ccde15dSdrh ** expression and leave the result on the top of stack.
1372f2bc013cSdrh **
1373f2bc013cSdrh ** This code depends on the fact that certain token values (ex: TK_EQ)
1374f2bc013cSdrh ** are the same as opcode values (ex: OP_Eq) that implement the corresponding
1375f2bc013cSdrh ** operation.  Special comments in vdbe.c and the mkopcodeh.awk script in
1376f2bc013cSdrh ** the make process cause these values to align.  Assert()s in the code
1377f2bc013cSdrh ** below verify that the numbers are aligned correctly.
1378cce7d176Sdrh */
13794adee20fSdanielk1977 void sqlite3ExprCode(Parse *pParse, Expr *pExpr){
1380cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
1381cce7d176Sdrh   int op;
13827977a17fSdanielk1977   if( v==0 ) return;
13837977a17fSdanielk1977   if( pExpr==0 ){
13847977a17fSdanielk1977     sqlite3VdbeAddOp(v, OP_String8, 0, 0);  /* Empty expression evals to NULL */
13857977a17fSdanielk1977     return;
13867977a17fSdanielk1977   }
1387f2bc013cSdrh   op = pExpr->op;
1388f2bc013cSdrh   switch( op ){
1389967e8b73Sdrh     case TK_COLUMN: {
1390a58fdfb1Sdanielk1977       if( !pParse->fillAgg && pExpr->iAgg>=0 ){
1391a58fdfb1Sdanielk1977         sqlite3VdbeAddOp(v, OP_AggGet, pExpr->iAggCtx, pExpr->iAgg);
1392c4a3c779Sdrh       }else if( pExpr->iColumn>=0 ){
13934adee20fSdanielk1977         sqlite3VdbeAddOp(v, OP_Column, pExpr->iTable, pExpr->iColumn);
1394aee18ef8Sdanielk1977         sqlite3ColumnDefault(v, pExpr->pTab, pExpr->iColumn);
1395c4a3c779Sdrh       }else{
13964adee20fSdanielk1977         sqlite3VdbeAddOp(v, OP_Recno, pExpr->iTable, 0);
13972282792aSdrh       }
1398cce7d176Sdrh       break;
1399cce7d176Sdrh     }
1400cce7d176Sdrh     case TK_INTEGER: {
1401fec19aadSdrh       codeInteger(v, pExpr->token.z, pExpr->token.n);
1402fec19aadSdrh       break;
140351e9a445Sdrh     }
1404fec19aadSdrh     case TK_FLOAT:
1405fec19aadSdrh     case TK_STRING: {
1406f2bc013cSdrh       assert( TK_FLOAT==OP_Real );
1407f2bc013cSdrh       assert( TK_STRING==OP_String8 );
1408fec19aadSdrh       sqlite3VdbeOp3(v, op, 0, 0, pExpr->token.z, pExpr->token.n);
14094adee20fSdanielk1977       sqlite3VdbeDequoteP3(v, -1);
1410cce7d176Sdrh       break;
1411cce7d176Sdrh     }
14125338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_BLOB_LITERAL
1413c572ef7fSdanielk1977     case TK_BLOB: {
1414f2bc013cSdrh       assert( TK_BLOB==OP_HexBlob );
1415c572ef7fSdanielk1977       sqlite3VdbeOp3(v, op, 0, 0, pExpr->token.z+1, pExpr->token.n-1);
1416c572ef7fSdanielk1977       sqlite3VdbeDequoteP3(v, -1);
1417c572ef7fSdanielk1977       break;
1418c572ef7fSdanielk1977     }
14195338a5f7Sdanielk1977 #endif
1420cce7d176Sdrh     case TK_NULL: {
14210f69c1e3Sdanielk1977       sqlite3VdbeAddOp(v, OP_String8, 0, 0);
1422cce7d176Sdrh       break;
1423cce7d176Sdrh     }
142450457896Sdrh     case TK_VARIABLE: {
14254adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Variable, pExpr->iTable, 0);
1426895d7472Sdrh       if( pExpr->token.n>1 ){
1427895d7472Sdrh         sqlite3VdbeChangeP3(v, -1, pExpr->token.z, pExpr->token.n);
1428895d7472Sdrh       }
142950457896Sdrh       break;
143050457896Sdrh     }
14314e0cff60Sdrh     case TK_REGISTER: {
14324e0cff60Sdrh       sqlite3VdbeAddOp(v, OP_MemLoad, pExpr->iTable, 0);
14334e0cff60Sdrh       break;
14344e0cff60Sdrh     }
1435c9b84a1fSdrh     case TK_LT:
1436c9b84a1fSdrh     case TK_LE:
1437c9b84a1fSdrh     case TK_GT:
1438c9b84a1fSdrh     case TK_GE:
1439c9b84a1fSdrh     case TK_NE:
1440c9b84a1fSdrh     case TK_EQ: {
1441f2bc013cSdrh       assert( TK_LT==OP_Lt );
1442f2bc013cSdrh       assert( TK_LE==OP_Le );
1443f2bc013cSdrh       assert( TK_GT==OP_Gt );
1444f2bc013cSdrh       assert( TK_GE==OP_Ge );
1445f2bc013cSdrh       assert( TK_EQ==OP_Eq );
1446f2bc013cSdrh       assert( TK_NE==OP_Ne );
1447a37cdde0Sdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
1448a37cdde0Sdanielk1977       sqlite3ExprCode(pParse, pExpr->pRight);
1449be5c89acSdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op, 0, 0);
1450a37cdde0Sdanielk1977       break;
1451c9b84a1fSdrh     }
1452cce7d176Sdrh     case TK_AND:
1453cce7d176Sdrh     case TK_OR:
1454cce7d176Sdrh     case TK_PLUS:
1455cce7d176Sdrh     case TK_STAR:
1456cce7d176Sdrh     case TK_MINUS:
1457bf4133cbSdrh     case TK_REM:
1458bf4133cbSdrh     case TK_BITAND:
1459bf4133cbSdrh     case TK_BITOR:
146017c40294Sdrh     case TK_SLASH:
1461bf4133cbSdrh     case TK_LSHIFT:
1462855eb1cfSdrh     case TK_RSHIFT:
14630040077dSdrh     case TK_CONCAT: {
1464f2bc013cSdrh       assert( TK_AND==OP_And );
1465f2bc013cSdrh       assert( TK_OR==OP_Or );
1466f2bc013cSdrh       assert( TK_PLUS==OP_Add );
1467f2bc013cSdrh       assert( TK_MINUS==OP_Subtract );
1468f2bc013cSdrh       assert( TK_REM==OP_Remainder );
1469f2bc013cSdrh       assert( TK_BITAND==OP_BitAnd );
1470f2bc013cSdrh       assert( TK_BITOR==OP_BitOr );
1471f2bc013cSdrh       assert( TK_SLASH==OP_Divide );
1472f2bc013cSdrh       assert( TK_LSHIFT==OP_ShiftLeft );
1473f2bc013cSdrh       assert( TK_RSHIFT==OP_ShiftRight );
1474f2bc013cSdrh       assert( TK_CONCAT==OP_Concat );
14754adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
14764adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pRight);
1477855eb1cfSdrh       sqlite3VdbeAddOp(v, op, 0, 0);
14780040077dSdrh       break;
14790040077dSdrh     }
1480cce7d176Sdrh     case TK_UMINUS: {
1481fec19aadSdrh       Expr *pLeft = pExpr->pLeft;
1482fec19aadSdrh       assert( pLeft );
1483fec19aadSdrh       if( pLeft->op==TK_FLOAT || pLeft->op==TK_INTEGER ){
1484fec19aadSdrh         Token *p = &pLeft->token;
14856e142f54Sdrh         char *z = sqliteMalloc( p->n + 2 );
14866e142f54Sdrh         sprintf(z, "-%.*s", p->n, p->z);
1487fec19aadSdrh         if( pLeft->op==TK_FLOAT ){
1488fec19aadSdrh           sqlite3VdbeOp3(v, OP_Real, 0, 0, z, p->n+1);
1489e6840900Sdrh         }else{
1490fec19aadSdrh           codeInteger(v, z, p->n+1);
1491e6840900Sdrh         }
14926e142f54Sdrh         sqliteFree(z);
14936e142f54Sdrh         break;
14946e142f54Sdrh       }
14951ccde15dSdrh       /* Fall through into TK_NOT */
14966e142f54Sdrh     }
1497bf4133cbSdrh     case TK_BITNOT:
14986e142f54Sdrh     case TK_NOT: {
1499f2bc013cSdrh       assert( TK_BITNOT==OP_BitNot );
1500f2bc013cSdrh       assert( TK_NOT==OP_Not );
15014adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
15024adee20fSdanielk1977       sqlite3VdbeAddOp(v, op, 0, 0);
1503cce7d176Sdrh       break;
1504cce7d176Sdrh     }
1505cce7d176Sdrh     case TK_ISNULL:
1506cce7d176Sdrh     case TK_NOTNULL: {
1507cce7d176Sdrh       int dest;
1508f2bc013cSdrh       assert( TK_ISNULL==OP_IsNull );
1509f2bc013cSdrh       assert( TK_NOTNULL==OP_NotNull );
15104adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Integer, 1, 0);
15114adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
15124adee20fSdanielk1977       dest = sqlite3VdbeCurrentAddr(v) + 2;
15134adee20fSdanielk1977       sqlite3VdbeAddOp(v, op, 1, dest);
15144adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_AddImm, -1, 0);
1515a37cdde0Sdanielk1977       break;
1516f2bc013cSdrh     }
15172282792aSdrh     case TK_AGG_FUNCTION: {
15184adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_AggGet, 0, pExpr->iAgg);
15192282792aSdrh       break;
15202282792aSdrh     }
1521b71090fdSdrh     case TK_CONST_FUNC:
1522cce7d176Sdrh     case TK_FUNCTION: {
1523cce7d176Sdrh       ExprList *pList = pExpr->pList;
152489425d5eSdrh       int nExpr = pList ? pList->nExpr : 0;
15250bce8354Sdrh       FuncDef *pDef;
15264b59ab5eSdrh       int nId;
15274b59ab5eSdrh       const char *zId;
1528682f68b0Sdanielk1977       int p2 = 0;
1529682f68b0Sdanielk1977       int i;
1530d8123366Sdanielk1977       u8 enc = pParse->db->enc;
1531dc1bdc4fSdanielk1977       CollSeq *pColl = 0;
1532b71090fdSdrh       zId = pExpr->token.z;
1533b71090fdSdrh       nId = pExpr->token.n;
1534d8123366Sdanielk1977       pDef = sqlite3FindFunction(pParse->db, zId, nId, nExpr, enc, 0);
15350bce8354Sdrh       assert( pDef!=0 );
1536f9b596ebSdrh       nExpr = sqlite3ExprCodeExprList(pParse, pList);
1537682f68b0Sdanielk1977       for(i=0; i<nExpr && i<32; i++){
1538d02eb1fdSdanielk1977         if( sqlite3ExprIsConstant(pList->a[i].pExpr) ){
1539d02eb1fdSdanielk1977           p2 |= (1<<i);
1540d02eb1fdSdanielk1977         }
1541dc1bdc4fSdanielk1977         if( pDef->needCollSeq && !pColl ){
1542dc1bdc4fSdanielk1977           pColl = sqlite3ExprCollSeq(pParse, pList->a[i].pExpr);
1543dc1bdc4fSdanielk1977         }
1544dc1bdc4fSdanielk1977       }
1545dc1bdc4fSdanielk1977       if( pDef->needCollSeq ){
1546dc1bdc4fSdanielk1977         if( !pColl ) pColl = pParse->db->pDfltColl;
1547d8123366Sdanielk1977         sqlite3VdbeOp3(v, OP_CollSeq, 0, 0, (char *)pColl, P3_COLLSEQ);
1548682f68b0Sdanielk1977       }
1549682f68b0Sdanielk1977       sqlite3VdbeOp3(v, OP_Function, nExpr, p2, (char*)pDef, P3_FUNCDEF);
15506ec2733bSdrh       break;
15516ec2733bSdrh     }
1552fe2093d7Sdrh #ifndef SQLITE_OMIT_SUBQUERY
1553fe2093d7Sdrh     case TK_EXISTS:
155419a775c2Sdrh     case TK_SELECT: {
1555b3bce662Sdanielk1977       sqlite3CodeSubselect(pParse, pExpr);
15564adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_MemLoad, pExpr->iColumn, 0);
1557ad6d9460Sdrh       VdbeComment((v, "# load subquery result"));
155819a775c2Sdrh       break;
155919a775c2Sdrh     }
1560fef5208cSdrh     case TK_IN: {
1561fef5208cSdrh       int addr;
156294a11211Sdrh       char affinity;
1563b3bce662Sdanielk1977       sqlite3CodeSubselect(pParse, pExpr);
1564e014a838Sdanielk1977 
1565e014a838Sdanielk1977       /* Figure out the affinity to use to create a key from the results
1566e014a838Sdanielk1977       ** of the expression. affinityStr stores a static string suitable for
1567ededfd5eSdanielk1977       ** P3 of OP_MakeRecord.
1568e014a838Sdanielk1977       */
156994a11211Sdrh       affinity = comparisonAffinity(pExpr);
1570e014a838Sdanielk1977 
15714adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Integer, 1, 0);
1572e014a838Sdanielk1977 
1573e014a838Sdanielk1977       /* Code the <expr> from "<expr> IN (...)". The temporary table
1574e014a838Sdanielk1977       ** pExpr->iTable contains the values that make up the (...) set.
1575e014a838Sdanielk1977       */
15764adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
15774adee20fSdanielk1977       addr = sqlite3VdbeCurrentAddr(v);
1578e014a838Sdanielk1977       sqlite3VdbeAddOp(v, OP_NotNull, -1, addr+4);            /* addr + 0 */
15794adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Pop, 2, 0);
15800f69c1e3Sdanielk1977       sqlite3VdbeAddOp(v, OP_String8, 0, 0);
1581e014a838Sdanielk1977       sqlite3VdbeAddOp(v, OP_Goto, 0, addr+7);
158294a11211Sdrh       sqlite3VdbeOp3(v, OP_MakeRecord, 1, 0, &affinity, 1);   /* addr + 4 */
1583e014a838Sdanielk1977       sqlite3VdbeAddOp(v, OP_Found, pExpr->iTable, addr+7);
1584e014a838Sdanielk1977       sqlite3VdbeAddOp(v, OP_AddImm, -1, 0);                  /* addr + 6 */
1585e014a838Sdanielk1977 
1586fef5208cSdrh       break;
1587fef5208cSdrh     }
158893758c8dSdanielk1977 #endif
1589fef5208cSdrh     case TK_BETWEEN: {
1590be5c89acSdrh       Expr *pLeft = pExpr->pLeft;
1591be5c89acSdrh       struct ExprList_item *pLItem = pExpr->pList->a;
1592be5c89acSdrh       Expr *pRight = pLItem->pExpr;
1593be5c89acSdrh       sqlite3ExprCode(pParse, pLeft);
15944adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Dup, 0, 0);
1595be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
1596be5c89acSdrh       codeCompare(pParse, pLeft, pRight, OP_Ge, 0, 0);
15974adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Pull, 1, 0);
1598be5c89acSdrh       pLItem++;
1599be5c89acSdrh       pRight = pLItem->pExpr;
1600be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
1601be5c89acSdrh       codeCompare(pParse, pLeft, pRight, OP_Le, 0, 0);
16024adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_And, 0, 0);
1603fef5208cSdrh       break;
1604fef5208cSdrh     }
160551e9a445Sdrh     case TK_UPLUS:
1606a2e00042Sdrh     case TK_AS: {
16074adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
1608a2e00042Sdrh       break;
1609a2e00042Sdrh     }
161017a7f8ddSdrh     case TK_CASE: {
161117a7f8ddSdrh       int expr_end_label;
1612f5905aa7Sdrh       int jumpInst;
1613f5905aa7Sdrh       int addr;
1614f5905aa7Sdrh       int nExpr;
161517a7f8ddSdrh       int i;
1616be5c89acSdrh       ExprList *pEList;
1617be5c89acSdrh       struct ExprList_item *aListelem;
161817a7f8ddSdrh 
161917a7f8ddSdrh       assert(pExpr->pList);
162017a7f8ddSdrh       assert((pExpr->pList->nExpr % 2) == 0);
162117a7f8ddSdrh       assert(pExpr->pList->nExpr > 0);
1622be5c89acSdrh       pEList = pExpr->pList;
1623be5c89acSdrh       aListelem = pEList->a;
1624be5c89acSdrh       nExpr = pEList->nExpr;
16254adee20fSdanielk1977       expr_end_label = sqlite3VdbeMakeLabel(v);
162617a7f8ddSdrh       if( pExpr->pLeft ){
16274adee20fSdanielk1977         sqlite3ExprCode(pParse, pExpr->pLeft);
1628cce7d176Sdrh       }
1629f5905aa7Sdrh       for(i=0; i<nExpr; i=i+2){
1630be5c89acSdrh         sqlite3ExprCode(pParse, aListelem[i].pExpr);
163117a7f8ddSdrh         if( pExpr->pLeft ){
16324adee20fSdanielk1977           sqlite3VdbeAddOp(v, OP_Dup, 1, 1);
1633be5c89acSdrh           jumpInst = codeCompare(pParse, pExpr->pLeft, aListelem[i].pExpr,
1634be5c89acSdrh                                  OP_Ne, 0, 1);
16354adee20fSdanielk1977           sqlite3VdbeAddOp(v, OP_Pop, 1, 0);
1636f5905aa7Sdrh         }else{
16374adee20fSdanielk1977           jumpInst = sqlite3VdbeAddOp(v, OP_IfNot, 1, 0);
163817a7f8ddSdrh         }
1639be5c89acSdrh         sqlite3ExprCode(pParse, aListelem[i+1].pExpr);
16404adee20fSdanielk1977         sqlite3VdbeAddOp(v, OP_Goto, 0, expr_end_label);
16414adee20fSdanielk1977         addr = sqlite3VdbeCurrentAddr(v);
16424adee20fSdanielk1977         sqlite3VdbeChangeP2(v, jumpInst, addr);
164317a7f8ddSdrh       }
1644f570f011Sdrh       if( pExpr->pLeft ){
16454adee20fSdanielk1977         sqlite3VdbeAddOp(v, OP_Pop, 1, 0);
1646f570f011Sdrh       }
164717a7f8ddSdrh       if( pExpr->pRight ){
16484adee20fSdanielk1977         sqlite3ExprCode(pParse, pExpr->pRight);
164917a7f8ddSdrh       }else{
16500f69c1e3Sdanielk1977         sqlite3VdbeAddOp(v, OP_String8, 0, 0);
165117a7f8ddSdrh       }
16524adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, expr_end_label);
16536f34903eSdanielk1977       break;
16546f34903eSdanielk1977     }
16555338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_TRIGGER
16566f34903eSdanielk1977     case TK_RAISE: {
16576f34903eSdanielk1977       if( !pParse->trigStack ){
16584adee20fSdanielk1977         sqlite3ErrorMsg(pParse,
1659da93d238Sdrh                        "RAISE() may only be used within a trigger-program");
16606f34903eSdanielk1977 	return;
16616f34903eSdanielk1977       }
1662ad6d9460Sdrh       if( pExpr->iColumn!=OE_Ignore ){
1663ad6d9460Sdrh          assert( pExpr->iColumn==OE_Rollback ||
16646f34903eSdanielk1977                  pExpr->iColumn == OE_Abort ||
1665ad6d9460Sdrh                  pExpr->iColumn == OE_Fail );
16664adee20fSdanielk1977          sqlite3VdbeOp3(v, OP_Halt, SQLITE_CONSTRAINT, pExpr->iColumn,
1667701a0aebSdrh                         pExpr->token.z, pExpr->token.n);
16684adee20fSdanielk1977          sqlite3VdbeDequoteP3(v, -1);
16696f34903eSdanielk1977       } else {
16706f34903eSdanielk1977          assert( pExpr->iColumn == OE_Ignore );
1671344737f6Sdrh          sqlite3VdbeAddOp(v, OP_ContextPop, 0, 0);
1672ad6d9460Sdrh          sqlite3VdbeAddOp(v, OP_Goto, 0, pParse->trigStack->ignoreJump);
1673ad6d9460Sdrh          VdbeComment((v, "# raise(IGNORE)"));
16746f34903eSdanielk1977       }
167517a7f8ddSdrh     }
16765338a5f7Sdanielk1977 #endif
167717a7f8ddSdrh     break;
167817a7f8ddSdrh   }
1679cce7d176Sdrh }
1680cce7d176Sdrh 
168193758c8dSdanielk1977 #ifndef SQLITE_OMIT_TRIGGER
1682cce7d176Sdrh /*
168325303780Sdrh ** Generate code that evalutes the given expression and leaves the result
168425303780Sdrh ** on the stack.  See also sqlite3ExprCode().
168525303780Sdrh **
168625303780Sdrh ** This routine might also cache the result and modify the pExpr tree
168725303780Sdrh ** so that it will make use of the cached result on subsequent evaluations
168825303780Sdrh ** rather than evaluate the whole expression again.  Trivial expressions are
168925303780Sdrh ** not cached.  If the expression is cached, its result is stored in a
169025303780Sdrh ** memory location.
169125303780Sdrh */
169225303780Sdrh void sqlite3ExprCodeAndCache(Parse *pParse, Expr *pExpr){
169325303780Sdrh   Vdbe *v = pParse->pVdbe;
169425303780Sdrh   int iMem;
169525303780Sdrh   int addr1, addr2;
169625303780Sdrh   if( v==0 ) return;
169725303780Sdrh   addr1 = sqlite3VdbeCurrentAddr(v);
169825303780Sdrh   sqlite3ExprCode(pParse, pExpr);
169925303780Sdrh   addr2 = sqlite3VdbeCurrentAddr(v);
170025303780Sdrh   if( addr2>addr1+1 || sqlite3VdbeGetOp(v, addr1)->opcode==OP_Function ){
170125303780Sdrh     iMem = pExpr->iTable = pParse->nMem++;
170225303780Sdrh     sqlite3VdbeAddOp(v, OP_MemStore, iMem, 0);
170325303780Sdrh     pExpr->op = TK_REGISTER;
170425303780Sdrh   }
170525303780Sdrh }
170693758c8dSdanielk1977 #endif
170725303780Sdrh 
170825303780Sdrh /*
1709268380caSdrh ** Generate code that pushes the value of every element of the given
1710f9b596ebSdrh ** expression list onto the stack.
1711268380caSdrh **
1712268380caSdrh ** Return the number of elements pushed onto the stack.
1713268380caSdrh */
17144adee20fSdanielk1977 int sqlite3ExprCodeExprList(
1715268380caSdrh   Parse *pParse,     /* Parsing context */
1716f9b596ebSdrh   ExprList *pList    /* The expression list to be coded */
1717268380caSdrh ){
1718268380caSdrh   struct ExprList_item *pItem;
1719268380caSdrh   int i, n;
1720268380caSdrh   Vdbe *v;
1721268380caSdrh   if( pList==0 ) return 0;
17224adee20fSdanielk1977   v = sqlite3GetVdbe(pParse);
1723268380caSdrh   n = pList->nExpr;
1724268380caSdrh   for(pItem=pList->a, i=0; i<n; i++, pItem++){
17254adee20fSdanielk1977     sqlite3ExprCode(pParse, pItem->pExpr);
1726268380caSdrh   }
1727f9b596ebSdrh   return n;
1728268380caSdrh }
1729268380caSdrh 
1730268380caSdrh /*
1731cce7d176Sdrh ** Generate code for a boolean expression such that a jump is made
1732cce7d176Sdrh ** to the label "dest" if the expression is true but execution
1733cce7d176Sdrh ** continues straight thru if the expression is false.
1734f5905aa7Sdrh **
1735f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false), then
1736f5905aa7Sdrh ** take the jump if the jumpIfNull flag is true.
1737f2bc013cSdrh **
1738f2bc013cSdrh ** This code depends on the fact that certain token values (ex: TK_EQ)
1739f2bc013cSdrh ** are the same as opcode values (ex: OP_Eq) that implement the corresponding
1740f2bc013cSdrh ** operation.  Special comments in vdbe.c and the mkopcodeh.awk script in
1741f2bc013cSdrh ** the make process cause these values to align.  Assert()s in the code
1742f2bc013cSdrh ** below verify that the numbers are aligned correctly.
1743cce7d176Sdrh */
17444adee20fSdanielk1977 void sqlite3ExprIfTrue(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
1745cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
1746cce7d176Sdrh   int op = 0;
1747daffd0e5Sdrh   if( v==0 || pExpr==0 ) return;
1748f2bc013cSdrh   op = pExpr->op;
1749f2bc013cSdrh   switch( op ){
1750cce7d176Sdrh     case TK_AND: {
17514adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
17524adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, d2, !jumpIfNull);
17534adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
17544adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
1755cce7d176Sdrh       break;
1756cce7d176Sdrh     }
1757cce7d176Sdrh     case TK_OR: {
17584adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
17594adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
1760cce7d176Sdrh       break;
1761cce7d176Sdrh     }
1762cce7d176Sdrh     case TK_NOT: {
17634adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
1764cce7d176Sdrh       break;
1765cce7d176Sdrh     }
1766cce7d176Sdrh     case TK_LT:
1767cce7d176Sdrh     case TK_LE:
1768cce7d176Sdrh     case TK_GT:
1769cce7d176Sdrh     case TK_GE:
1770cce7d176Sdrh     case TK_NE:
17710ac65892Sdrh     case TK_EQ: {
1772f2bc013cSdrh       assert( TK_LT==OP_Lt );
1773f2bc013cSdrh       assert( TK_LE==OP_Le );
1774f2bc013cSdrh       assert( TK_GT==OP_Gt );
1775f2bc013cSdrh       assert( TK_GE==OP_Ge );
1776f2bc013cSdrh       assert( TK_EQ==OP_Eq );
1777f2bc013cSdrh       assert( TK_NE==OP_Ne );
17784adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
17794adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pRight);
1780be5c89acSdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op, dest, jumpIfNull);
1781cce7d176Sdrh       break;
1782cce7d176Sdrh     }
1783cce7d176Sdrh     case TK_ISNULL:
1784cce7d176Sdrh     case TK_NOTNULL: {
1785f2bc013cSdrh       assert( TK_ISNULL==OP_IsNull );
1786f2bc013cSdrh       assert( TK_NOTNULL==OP_NotNull );
17874adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
17884adee20fSdanielk1977       sqlite3VdbeAddOp(v, op, 1, dest);
1789cce7d176Sdrh       break;
1790cce7d176Sdrh     }
1791fef5208cSdrh     case TK_BETWEEN: {
17920202b29eSdanielk1977       /* The expression "x BETWEEN y AND z" is implemented as:
17930202b29eSdanielk1977       **
17940202b29eSdanielk1977       ** 1 IF (x < y) GOTO 3
17950202b29eSdanielk1977       ** 2 IF (x <= z) GOTO <dest>
17960202b29eSdanielk1977       ** 3 ...
17970202b29eSdanielk1977       */
1798f5905aa7Sdrh       int addr;
1799be5c89acSdrh       Expr *pLeft = pExpr->pLeft;
1800be5c89acSdrh       Expr *pRight = pExpr->pList->a[0].pExpr;
1801be5c89acSdrh       sqlite3ExprCode(pParse, pLeft);
18024adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Dup, 0, 0);
1803be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
1804be5c89acSdrh       addr = codeCompare(pParse, pLeft, pRight, OP_Lt, 0, !jumpIfNull);
18050202b29eSdanielk1977 
1806be5c89acSdrh       pRight = pExpr->pList->a[1].pExpr;
1807be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
1808be5c89acSdrh       codeCompare(pParse, pLeft, pRight, OP_Le, dest, jumpIfNull);
18090202b29eSdanielk1977 
18104adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Integer, 0, 0);
18114adee20fSdanielk1977       sqlite3VdbeChangeP2(v, addr, sqlite3VdbeCurrentAddr(v));
18124adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Pop, 1, 0);
1813fef5208cSdrh       break;
1814fef5208cSdrh     }
1815cce7d176Sdrh     default: {
18164adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr);
18174adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_If, jumpIfNull, dest);
1818cce7d176Sdrh       break;
1819cce7d176Sdrh     }
1820cce7d176Sdrh   }
1821cce7d176Sdrh }
1822cce7d176Sdrh 
1823cce7d176Sdrh /*
182466b89c8fSdrh ** Generate code for a boolean expression such that a jump is made
1825cce7d176Sdrh ** to the label "dest" if the expression is false but execution
1826cce7d176Sdrh ** continues straight thru if the expression is true.
1827f5905aa7Sdrh **
1828f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false) then
1829f5905aa7Sdrh ** jump if jumpIfNull is true or fall through if jumpIfNull is false.
1830cce7d176Sdrh */
18314adee20fSdanielk1977 void sqlite3ExprIfFalse(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
1832cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
1833cce7d176Sdrh   int op = 0;
1834daffd0e5Sdrh   if( v==0 || pExpr==0 ) return;
1835f2bc013cSdrh 
1836f2bc013cSdrh   /* The value of pExpr->op and op are related as follows:
1837f2bc013cSdrh   **
1838f2bc013cSdrh   **       pExpr->op            op
1839f2bc013cSdrh   **       ---------          ----------
1840f2bc013cSdrh   **       TK_ISNULL          OP_NotNull
1841f2bc013cSdrh   **       TK_NOTNULL         OP_IsNull
1842f2bc013cSdrh   **       TK_NE              OP_Eq
1843f2bc013cSdrh   **       TK_EQ              OP_Ne
1844f2bc013cSdrh   **       TK_GT              OP_Le
1845f2bc013cSdrh   **       TK_LE              OP_Gt
1846f2bc013cSdrh   **       TK_GE              OP_Lt
1847f2bc013cSdrh   **       TK_LT              OP_Ge
1848f2bc013cSdrh   **
1849f2bc013cSdrh   ** For other values of pExpr->op, op is undefined and unused.
1850f2bc013cSdrh   ** The value of TK_ and OP_ constants are arranged such that we
1851f2bc013cSdrh   ** can compute the mapping above using the following expression.
1852f2bc013cSdrh   ** Assert()s verify that the computation is correct.
1853f2bc013cSdrh   */
1854f2bc013cSdrh   op = ((pExpr->op+(TK_ISNULL&1))^1)-(TK_ISNULL&1);
1855f2bc013cSdrh 
1856f2bc013cSdrh   /* Verify correct alignment of TK_ and OP_ constants
1857f2bc013cSdrh   */
1858f2bc013cSdrh   assert( pExpr->op!=TK_ISNULL || op==OP_NotNull );
1859f2bc013cSdrh   assert( pExpr->op!=TK_NOTNULL || op==OP_IsNull );
1860f2bc013cSdrh   assert( pExpr->op!=TK_NE || op==OP_Eq );
1861f2bc013cSdrh   assert( pExpr->op!=TK_EQ || op==OP_Ne );
1862f2bc013cSdrh   assert( pExpr->op!=TK_LT || op==OP_Ge );
1863f2bc013cSdrh   assert( pExpr->op!=TK_LE || op==OP_Gt );
1864f2bc013cSdrh   assert( pExpr->op!=TK_GT || op==OP_Le );
1865f2bc013cSdrh   assert( pExpr->op!=TK_GE || op==OP_Lt );
1866f2bc013cSdrh 
1867cce7d176Sdrh   switch( pExpr->op ){
1868cce7d176Sdrh     case TK_AND: {
18694adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
18704adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
1871cce7d176Sdrh       break;
1872cce7d176Sdrh     }
1873cce7d176Sdrh     case TK_OR: {
18744adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
18754adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, d2, !jumpIfNull);
18764adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
18774adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
1878cce7d176Sdrh       break;
1879cce7d176Sdrh     }
1880cce7d176Sdrh     case TK_NOT: {
18814adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
1882cce7d176Sdrh       break;
1883cce7d176Sdrh     }
1884cce7d176Sdrh     case TK_LT:
1885cce7d176Sdrh     case TK_LE:
1886cce7d176Sdrh     case TK_GT:
1887cce7d176Sdrh     case TK_GE:
1888cce7d176Sdrh     case TK_NE:
1889cce7d176Sdrh     case TK_EQ: {
18904adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
18914adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pRight);
1892be5c89acSdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op, dest, jumpIfNull);
1893cce7d176Sdrh       break;
1894cce7d176Sdrh     }
1895cce7d176Sdrh     case TK_ISNULL:
1896cce7d176Sdrh     case TK_NOTNULL: {
18974adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr->pLeft);
18984adee20fSdanielk1977       sqlite3VdbeAddOp(v, op, 1, dest);
1899cce7d176Sdrh       break;
1900cce7d176Sdrh     }
1901fef5208cSdrh     case TK_BETWEEN: {
19020202b29eSdanielk1977       /* The expression is "x BETWEEN y AND z". It is implemented as:
19030202b29eSdanielk1977       **
19040202b29eSdanielk1977       ** 1 IF (x >= y) GOTO 3
19050202b29eSdanielk1977       ** 2 GOTO <dest>
19060202b29eSdanielk1977       ** 3 IF (x > z) GOTO <dest>
19070202b29eSdanielk1977       */
1908fef5208cSdrh       int addr;
1909be5c89acSdrh       Expr *pLeft = pExpr->pLeft;
1910be5c89acSdrh       Expr *pRight = pExpr->pList->a[0].pExpr;
1911be5c89acSdrh       sqlite3ExprCode(pParse, pLeft);
19124adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Dup, 0, 0);
1913be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
19144adee20fSdanielk1977       addr = sqlite3VdbeCurrentAddr(v);
1915be5c89acSdrh       codeCompare(pParse, pLeft, pRight, OP_Ge, addr+3, !jumpIfNull);
1916be5c89acSdrh 
19174adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Pop, 1, 0);
19184adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_Goto, 0, dest);
1919be5c89acSdrh       pRight = pExpr->pList->a[1].pExpr;
1920be5c89acSdrh       sqlite3ExprCode(pParse, pRight);
1921be5c89acSdrh       codeCompare(pParse, pLeft, pRight, OP_Gt, dest, jumpIfNull);
1922fef5208cSdrh       break;
1923fef5208cSdrh     }
1924cce7d176Sdrh     default: {
19254adee20fSdanielk1977       sqlite3ExprCode(pParse, pExpr);
19264adee20fSdanielk1977       sqlite3VdbeAddOp(v, OP_IfNot, jumpIfNull, dest);
1927cce7d176Sdrh       break;
1928cce7d176Sdrh     }
1929cce7d176Sdrh   }
1930cce7d176Sdrh }
19312282792aSdrh 
19322282792aSdrh /*
19332282792aSdrh ** Do a deep comparison of two expression trees.  Return TRUE (non-zero)
19342282792aSdrh ** if they are identical and return FALSE if they differ in any way.
19352282792aSdrh */
19364adee20fSdanielk1977 int sqlite3ExprCompare(Expr *pA, Expr *pB){
19372282792aSdrh   int i;
19382282792aSdrh   if( pA==0 ){
19392282792aSdrh     return pB==0;
19402282792aSdrh   }else if( pB==0 ){
19412282792aSdrh     return 0;
19422282792aSdrh   }
19432282792aSdrh   if( pA->op!=pB->op ) return 0;
19444adee20fSdanielk1977   if( !sqlite3ExprCompare(pA->pLeft, pB->pLeft) ) return 0;
19454adee20fSdanielk1977   if( !sqlite3ExprCompare(pA->pRight, pB->pRight) ) return 0;
19462282792aSdrh   if( pA->pList ){
19472282792aSdrh     if( pB->pList==0 ) return 0;
19482282792aSdrh     if( pA->pList->nExpr!=pB->pList->nExpr ) return 0;
19492282792aSdrh     for(i=0; i<pA->pList->nExpr; i++){
19504adee20fSdanielk1977       if( !sqlite3ExprCompare(pA->pList->a[i].pExpr, pB->pList->a[i].pExpr) ){
19512282792aSdrh         return 0;
19522282792aSdrh       }
19532282792aSdrh     }
19542282792aSdrh   }else if( pB->pList ){
19552282792aSdrh     return 0;
19562282792aSdrh   }
19572282792aSdrh   if( pA->pSelect || pB->pSelect ) return 0;
19582f2c01e5Sdrh   if( pA->iTable!=pB->iTable || pA->iColumn!=pB->iColumn ) return 0;
19592282792aSdrh   if( pA->token.z ){
19602282792aSdrh     if( pB->token.z==0 ) return 0;
19616977fea8Sdrh     if( pB->token.n!=pA->token.n ) return 0;
19624adee20fSdanielk1977     if( sqlite3StrNICmp(pA->token.z, pB->token.z, pB->token.n)!=0 ) return 0;
19632282792aSdrh   }
19642282792aSdrh   return 1;
19652282792aSdrh }
19662282792aSdrh 
19672282792aSdrh /*
19682282792aSdrh ** Add a new element to the pParse->aAgg[] array and return its index.
196973b211abSdrh ** The new element is initialized to zero.  The calling function is
197073b211abSdrh ** expected to fill it in.
19712282792aSdrh */
19722282792aSdrh static int appendAggInfo(Parse *pParse){
19732282792aSdrh   if( (pParse->nAgg & 0x7)==0 ){
19742282792aSdrh     int amt = pParse->nAgg + 8;
19756d4abfbeSdrh     AggExpr *aAgg = sqliteRealloc(pParse->aAgg, amt*sizeof(pParse->aAgg[0]));
19766d4abfbeSdrh     if( aAgg==0 ){
19772282792aSdrh       return -1;
19782282792aSdrh     }
19796d4abfbeSdrh     pParse->aAgg = aAgg;
19802282792aSdrh   }
19812282792aSdrh   memset(&pParse->aAgg[pParse->nAgg], 0, sizeof(pParse->aAgg[0]));
19822282792aSdrh   return pParse->nAgg++;
19832282792aSdrh }
19842282792aSdrh 
19852282792aSdrh /*
1986626a879aSdrh ** This is an xFunc for walkExprTree() used to implement
1987626a879aSdrh ** sqlite3ExprAnalyzeAggregates().  See sqlite3ExprAnalyzeAggregates
1988626a879aSdrh ** for additional information.
19892282792aSdrh **
1990626a879aSdrh ** This routine analyzes the aggregate function at pExpr.
19912282792aSdrh */
1992626a879aSdrh static int analyzeAggregate(void *pArg, Expr *pExpr){
19932282792aSdrh   int i;
19942282792aSdrh   AggExpr *aAgg;
1995a58fdfb1Sdanielk1977   NameContext *pNC = (NameContext *)pArg;
1996a58fdfb1Sdanielk1977   Parse *pParse = pNC->pParse;
1997a58fdfb1Sdanielk1977   SrcList *pSrcList = pNC->pSrcList;
19982282792aSdrh 
19992282792aSdrh   switch( pExpr->op ){
2000967e8b73Sdrh     case TK_COLUMN: {
2001a58fdfb1Sdanielk1977       for(i=0; pSrcList && i<pSrcList->nSrc; i++){
2002a58fdfb1Sdanielk1977         if( pExpr->iTable==pSrcList->a[i].iCursor ){
20032282792aSdrh           aAgg = pParse->aAgg;
20042282792aSdrh           for(i=0; i<pParse->nAgg; i++){
20052282792aSdrh             if( aAgg[i].isAgg ) continue;
20062282792aSdrh             if( aAgg[i].pExpr->iTable==pExpr->iTable
2007967e8b73Sdrh              && aAgg[i].pExpr->iColumn==pExpr->iColumn ){
20082282792aSdrh               break;
20092282792aSdrh             }
20102282792aSdrh           }
20112282792aSdrh           if( i>=pParse->nAgg ){
20122282792aSdrh             i = appendAggInfo(pParse);
20132282792aSdrh             if( i<0 ) return 1;
20142282792aSdrh             pParse->aAgg[i].isAgg = 0;
20152282792aSdrh             pParse->aAgg[i].pExpr = pExpr;
20162282792aSdrh           }
2017aaf88729Sdrh           pExpr->iAgg = i;
2018a58fdfb1Sdanielk1977           pExpr->iAggCtx = pNC->nDepth;
2019a58fdfb1Sdanielk1977           return 1;
2020a58fdfb1Sdanielk1977         }
2021a58fdfb1Sdanielk1977       }
2022626a879aSdrh       return 1;
20232282792aSdrh     }
20242282792aSdrh     case TK_AGG_FUNCTION: {
2025a58fdfb1Sdanielk1977       if( pNC->nDepth==0 ){
20262282792aSdrh         aAgg = pParse->aAgg;
20272282792aSdrh         for(i=0; i<pParse->nAgg; i++){
20282282792aSdrh           if( !aAgg[i].isAgg ) continue;
20294adee20fSdanielk1977           if( sqlite3ExprCompare(aAgg[i].pExpr, pExpr) ){
20302282792aSdrh             break;
20312282792aSdrh           }
20322282792aSdrh         }
20332282792aSdrh         if( i>=pParse->nAgg ){
2034d8123366Sdanielk1977           u8 enc = pParse->db->enc;
20352282792aSdrh           i = appendAggInfo(pParse);
20362282792aSdrh           if( i<0 ) return 1;
20372282792aSdrh           pParse->aAgg[i].isAgg = 1;
20382282792aSdrh           pParse->aAgg[i].pExpr = pExpr;
20394adee20fSdanielk1977           pParse->aAgg[i].pFunc = sqlite3FindFunction(pParse->db,
20406977fea8Sdrh                pExpr->token.z, pExpr->token.n,
2041d8123366Sdanielk1977                pExpr->pList ? pExpr->pList->nExpr : 0, enc, 0);
20422282792aSdrh         }
20432282792aSdrh         pExpr->iAgg = i;
2044626a879aSdrh         return 1;
20452282792aSdrh       }
20462282792aSdrh     }
2047a58fdfb1Sdanielk1977   }
2048a58fdfb1Sdanielk1977   if( pExpr->pSelect ){
2049a58fdfb1Sdanielk1977     pNC->nDepth++;
2050a58fdfb1Sdanielk1977     walkSelectExpr(pExpr->pSelect, analyzeAggregate, pNC);
2051a58fdfb1Sdanielk1977     pNC->nDepth--;
2052a58fdfb1Sdanielk1977   }
2053626a879aSdrh   return 0;
20542282792aSdrh }
2055626a879aSdrh 
2056626a879aSdrh /*
2057626a879aSdrh ** Analyze the given expression looking for aggregate functions and
2058626a879aSdrh ** for variables that need to be added to the pParse->aAgg[] array.
2059626a879aSdrh ** Make additional entries to the pParse->aAgg[] array as necessary.
2060626a879aSdrh **
2061626a879aSdrh ** This routine should only be called after the expression has been
2062626a879aSdrh ** analyzed by sqlite3ExprResolveNames().
2063626a879aSdrh **
2064626a879aSdrh ** If errors are seen, leave an error message in zErrMsg and return
2065626a879aSdrh ** the number of errors.
2066626a879aSdrh */
2067a58fdfb1Sdanielk1977 int sqlite3ExprAnalyzeAggregates(NameContext *pNC, Expr *pExpr){
2068a58fdfb1Sdanielk1977   int nErr = pNC->pParse->nErr;
2069a58fdfb1Sdanielk1977   walkExprTree(pExpr, analyzeAggregate, pNC);
2070a58fdfb1Sdanielk1977   return pNC->pParse->nErr - nErr;
20712282792aSdrh }
2072