xref: /sqlite-3.40.0/src/expr.c (revision bb53ecb1)
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 */
15cce7d176Sdrh #include "sqliteInt.h"
16a2e00042Sdrh 
17e014a838Sdanielk1977 /*
18e014a838Sdanielk1977 ** Return the 'affinity' of the expression pExpr if any.
19e014a838Sdanielk1977 **
20e014a838Sdanielk1977 ** If pExpr is a column, a reference to a column via an 'AS' alias,
21e014a838Sdanielk1977 ** or a sub-select with a column as the return value, then the
22e014a838Sdanielk1977 ** affinity of that column is returned. Otherwise, 0x00 is returned,
23e014a838Sdanielk1977 ** indicating no affinity for the expression.
24e014a838Sdanielk1977 **
25e014a838Sdanielk1977 ** i.e. the WHERE clause expresssions in the following statements all
26e014a838Sdanielk1977 ** have an affinity:
27e014a838Sdanielk1977 **
28e014a838Sdanielk1977 ** CREATE TABLE t1(a);
29e014a838Sdanielk1977 ** SELECT * FROM t1 WHERE a;
30e014a838Sdanielk1977 ** SELECT a AS b FROM t1 WHERE b;
31e014a838Sdanielk1977 ** SELECT * FROM t1 WHERE (select a from t1);
32e014a838Sdanielk1977 */
33bf3b721fSdanielk1977 char sqlite3ExprAffinity(Expr *pExpr){
34580c8c18Sdrh   int op;
35580c8c18Sdrh   pExpr = sqlite3ExprSkipCollate(pExpr);
369bec6fb3Smistachkin   if( pExpr->flags & EP_Generic ) return 0;
37580c8c18Sdrh   op = pExpr->op;
38487e262fSdrh   if( op==TK_SELECT ){
396ab3a2ecSdanielk1977     assert( pExpr->flags&EP_xIsSelect );
406ab3a2ecSdanielk1977     return sqlite3ExprAffinity(pExpr->x.pSelect->pEList->a[0].pExpr);
41a37cdde0Sdanielk1977   }
42487e262fSdrh #ifndef SQLITE_OMIT_CAST
43487e262fSdrh   if( op==TK_CAST ){
4433e619fcSdrh     assert( !ExprHasProperty(pExpr, EP_IntValue) );
45fdaac671Sdrh     return sqlite3AffinityType(pExpr->u.zToken, 0);
46487e262fSdrh   }
47487e262fSdrh #endif
48259a455fSdanielk1977   if( (op==TK_AGG_COLUMN || op==TK_COLUMN || op==TK_REGISTER)
49259a455fSdanielk1977    && pExpr->pTab!=0
50259a455fSdanielk1977   ){
517d10d5a6Sdrh     /* op==TK_REGISTER && pExpr->pTab!=0 happens when pExpr was originally
527d10d5a6Sdrh     ** a TK_COLUMN but was previously evaluated and cached in a register */
537d10d5a6Sdrh     int j = pExpr->iColumn;
547d10d5a6Sdrh     if( j<0 ) return SQLITE_AFF_INTEGER;
557d10d5a6Sdrh     assert( pExpr->pTab && j<pExpr->pTab->nCol );
567d10d5a6Sdrh     return pExpr->pTab->aCol[j].affinity;
577d10d5a6Sdrh   }
58a37cdde0Sdanielk1977   return pExpr->affinity;
59a37cdde0Sdanielk1977 }
60a37cdde0Sdanielk1977 
6153db1458Sdrh /*
628b4c40d8Sdrh ** Set the collating sequence for expression pExpr to be the collating
63ae80ddeaSdrh ** sequence named by pToken.   Return a pointer to a new Expr node that
64ae80ddeaSdrh ** implements the COLLATE operator.
650a8a406eSdrh **
660a8a406eSdrh ** If a memory allocation error occurs, that fact is recorded in pParse->db
670a8a406eSdrh ** and the pExpr parameter is returned unchanged.
688b4c40d8Sdrh */
694ef7efadSdrh Expr *sqlite3ExprAddCollateToken(
704ef7efadSdrh   Parse *pParse,           /* Parsing context */
714ef7efadSdrh   Expr *pExpr,             /* Add the "COLLATE" clause to this expression */
724ef7efadSdrh   const Token *pCollName   /* Name of collating sequence */
734ef7efadSdrh ){
740a8a406eSdrh   if( pCollName->n>0 ){
75ae80ddeaSdrh     Expr *pNew = sqlite3ExprAlloc(pParse->db, TK_COLLATE, pCollName, 1);
76ae80ddeaSdrh     if( pNew ){
77ae80ddeaSdrh       pNew->pLeft = pExpr;
78a4c3c87eSdrh       pNew->flags |= EP_Collate|EP_Skip;
790a8a406eSdrh       pExpr = pNew;
80ae80ddeaSdrh     }
810a8a406eSdrh   }
820a8a406eSdrh   return pExpr;
830a8a406eSdrh }
840a8a406eSdrh Expr *sqlite3ExprAddCollateString(Parse *pParse, Expr *pExpr, const char *zC){
850a8a406eSdrh   Token s;
86261d8a51Sdrh   assert( zC!=0 );
870a8a406eSdrh   s.z = zC;
880a8a406eSdrh   s.n = sqlite3Strlen30(s.z);
89261d8a51Sdrh   return sqlite3ExprAddCollateToken(pParse, pExpr, &s);
900a8a406eSdrh }
910a8a406eSdrh 
920a8a406eSdrh /*
93a4c3c87eSdrh ** Skip over any TK_COLLATE or TK_AS operators and any unlikely()
94a4c3c87eSdrh ** or likelihood() function at the root of an expression.
950a8a406eSdrh */
960a8a406eSdrh Expr *sqlite3ExprSkipCollate(Expr *pExpr){
97a4c3c87eSdrh   while( pExpr && ExprHasProperty(pExpr, EP_Skip) ){
98a4c3c87eSdrh     if( ExprHasProperty(pExpr, EP_Unlikely) ){
99cca9f3d2Sdrh       assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
100cca9f3d2Sdrh       assert( pExpr->x.pList->nExpr>0 );
101a4c3c87eSdrh       assert( pExpr->op==TK_FUNCTION );
102cca9f3d2Sdrh       pExpr = pExpr->x.pList->a[0].pExpr;
103cca9f3d2Sdrh     }else{
104a4c3c87eSdrh       assert( pExpr->op==TK_COLLATE || pExpr->op==TK_AS );
105d91eba96Sdrh       pExpr = pExpr->pLeft;
106cca9f3d2Sdrh     }
107d91eba96Sdrh   }
1080a8a406eSdrh   return pExpr;
1098b4c40d8Sdrh }
1108b4c40d8Sdrh 
1118b4c40d8Sdrh /*
112ae80ddeaSdrh ** Return the collation sequence for the expression pExpr. If
113ae80ddeaSdrh ** there is no defined collating sequence, return NULL.
114ae80ddeaSdrh **
115ae80ddeaSdrh ** The collating sequence might be determined by a COLLATE operator
116ae80ddeaSdrh ** or by the presence of a column with a defined collating sequence.
117ae80ddeaSdrh ** COLLATE operators take first precedence.  Left operands take
118ae80ddeaSdrh ** precedence over right operands.
1190202b29eSdanielk1977 */
1207cedc8d4Sdanielk1977 CollSeq *sqlite3ExprCollSeq(Parse *pParse, Expr *pExpr){
121ae80ddeaSdrh   sqlite3 *db = pParse->db;
1227cedc8d4Sdanielk1977   CollSeq *pColl = 0;
1237d10d5a6Sdrh   Expr *p = pExpr;
124261d8a51Sdrh   while( p ){
125ae80ddeaSdrh     int op = p->op;
126fbb24d10Sdrh     if( p->flags & EP_Generic ) break;
127ae80ddeaSdrh     if( op==TK_CAST || op==TK_UPLUS ){
128ae80ddeaSdrh       p = p->pLeft;
129ae80ddeaSdrh       continue;
130ae80ddeaSdrh     }
13136e78309Sdan     if( op==TK_COLLATE || (op==TK_REGISTER && p->op2==TK_COLLATE) ){
1327a66da13Sdrh       pColl = sqlite3GetCollSeq(pParse, ENC(db), 0, p->u.zToken);
133ae80ddeaSdrh       break;
134ae80ddeaSdrh     }
135ae80ddeaSdrh     if( p->pTab!=0
136ae80ddeaSdrh      && (op==TK_AGG_COLUMN || op==TK_COLUMN
137ae80ddeaSdrh           || op==TK_REGISTER || op==TK_TRIGGER)
138ae80ddeaSdrh     ){
1397d10d5a6Sdrh       /* op==TK_REGISTER && p->pTab!=0 happens when pExpr was originally
1407d10d5a6Sdrh       ** a TK_COLUMN but was previously evaluated and cached in a register */
1417d10d5a6Sdrh       int j = p->iColumn;
1427d10d5a6Sdrh       if( j>=0 ){
143ae80ddeaSdrh         const char *zColl = p->pTab->aCol[j].zColl;
144c4a64facSdrh         pColl = sqlite3FindCollSeq(db, ENC(db), zColl, 0);
1450202b29eSdanielk1977       }
1467d10d5a6Sdrh       break;
1477d10d5a6Sdrh     }
148ae80ddeaSdrh     if( p->flags & EP_Collate ){
149261d8a51Sdrh       if( ALWAYS(p->pLeft) && (p->pLeft->flags & EP_Collate)!=0 ){
1507d10d5a6Sdrh         p = p->pLeft;
151ae80ddeaSdrh       }else{
152ae80ddeaSdrh         p = p->pRight;
153ae80ddeaSdrh       }
154ae80ddeaSdrh     }else{
155ae80ddeaSdrh       break;
156ae80ddeaSdrh     }
1570202b29eSdanielk1977   }
1587cedc8d4Sdanielk1977   if( sqlite3CheckCollSeq(pParse, pColl) ){
1597cedc8d4Sdanielk1977     pColl = 0;
1607cedc8d4Sdanielk1977   }
1617cedc8d4Sdanielk1977   return pColl;
1620202b29eSdanielk1977 }
1630202b29eSdanielk1977 
1640202b29eSdanielk1977 /*
165626a879aSdrh ** pExpr is an operand of a comparison operator.  aff2 is the
166626a879aSdrh ** type affinity of the other operand.  This routine returns the
16753db1458Sdrh ** type affinity that should be used for the comparison operator.
16853db1458Sdrh */
169e014a838Sdanielk1977 char sqlite3CompareAffinity(Expr *pExpr, char aff2){
170bf3b721fSdanielk1977   char aff1 = sqlite3ExprAffinity(pExpr);
171e014a838Sdanielk1977   if( aff1 && aff2 ){
1728df447f0Sdrh     /* Both sides of the comparison are columns. If one has numeric
1738df447f0Sdrh     ** affinity, use that. Otherwise use no affinity.
174e014a838Sdanielk1977     */
1758a51256cSdrh     if( sqlite3IsNumericAffinity(aff1) || sqlite3IsNumericAffinity(aff2) ){
176e014a838Sdanielk1977       return SQLITE_AFF_NUMERIC;
177e014a838Sdanielk1977     }else{
178e014a838Sdanielk1977       return SQLITE_AFF_NONE;
179e014a838Sdanielk1977     }
180e014a838Sdanielk1977   }else if( !aff1 && !aff2 ){
1815f6a87b3Sdrh     /* Neither side of the comparison is a column.  Compare the
1825f6a87b3Sdrh     ** results directly.
183e014a838Sdanielk1977     */
1845f6a87b3Sdrh     return SQLITE_AFF_NONE;
185e014a838Sdanielk1977   }else{
186e014a838Sdanielk1977     /* One side is a column, the other is not. Use the columns affinity. */
187fe05af87Sdrh     assert( aff1==0 || aff2==0 );
188e014a838Sdanielk1977     return (aff1 + aff2);
189e014a838Sdanielk1977   }
190e014a838Sdanielk1977 }
191e014a838Sdanielk1977 
19253db1458Sdrh /*
19353db1458Sdrh ** pExpr is a comparison operator.  Return the type affinity that should
19453db1458Sdrh ** be applied to both operands prior to doing the comparison.
19553db1458Sdrh */
196e014a838Sdanielk1977 static char comparisonAffinity(Expr *pExpr){
197e014a838Sdanielk1977   char aff;
198e014a838Sdanielk1977   assert( pExpr->op==TK_EQ || pExpr->op==TK_IN || pExpr->op==TK_LT ||
199e014a838Sdanielk1977           pExpr->op==TK_GT || pExpr->op==TK_GE || pExpr->op==TK_LE ||
2006a2fe093Sdrh           pExpr->op==TK_NE || pExpr->op==TK_IS || pExpr->op==TK_ISNOT );
201e014a838Sdanielk1977   assert( pExpr->pLeft );
202bf3b721fSdanielk1977   aff = sqlite3ExprAffinity(pExpr->pLeft);
203e014a838Sdanielk1977   if( pExpr->pRight ){
204e014a838Sdanielk1977     aff = sqlite3CompareAffinity(pExpr->pRight, aff);
2056ab3a2ecSdanielk1977   }else if( ExprHasProperty(pExpr, EP_xIsSelect) ){
2066ab3a2ecSdanielk1977     aff = sqlite3CompareAffinity(pExpr->x.pSelect->pEList->a[0].pExpr, aff);
2076ab3a2ecSdanielk1977   }else if( !aff ){
208de087bd5Sdrh     aff = SQLITE_AFF_NONE;
209e014a838Sdanielk1977   }
210e014a838Sdanielk1977   return aff;
211e014a838Sdanielk1977 }
212e014a838Sdanielk1977 
213e014a838Sdanielk1977 /*
214e014a838Sdanielk1977 ** pExpr is a comparison expression, eg. '=', '<', IN(...) etc.
215e014a838Sdanielk1977 ** idx_affinity is the affinity of an indexed column. Return true
216e014a838Sdanielk1977 ** if the index with affinity idx_affinity may be used to implement
217e014a838Sdanielk1977 ** the comparison in pExpr.
218e014a838Sdanielk1977 */
219e014a838Sdanielk1977 int sqlite3IndexAffinityOk(Expr *pExpr, char idx_affinity){
220e014a838Sdanielk1977   char aff = comparisonAffinity(pExpr);
2218a51256cSdrh   switch( aff ){
2228a51256cSdrh     case SQLITE_AFF_NONE:
2238a51256cSdrh       return 1;
2248a51256cSdrh     case SQLITE_AFF_TEXT:
2258a51256cSdrh       return idx_affinity==SQLITE_AFF_TEXT;
2268a51256cSdrh     default:
2278a51256cSdrh       return sqlite3IsNumericAffinity(idx_affinity);
2288a51256cSdrh   }
229e014a838Sdanielk1977 }
230e014a838Sdanielk1977 
231a37cdde0Sdanielk1977 /*
23235573356Sdrh ** Return the P5 value that should be used for a binary comparison
233a37cdde0Sdanielk1977 ** opcode (OP_Eq, OP_Ge etc.) used to compare pExpr1 and pExpr2.
234a37cdde0Sdanielk1977 */
23535573356Sdrh static u8 binaryCompareP5(Expr *pExpr1, Expr *pExpr2, int jumpIfNull){
23635573356Sdrh   u8 aff = (char)sqlite3ExprAffinity(pExpr2);
2371bd10f8aSdrh   aff = (u8)sqlite3CompareAffinity(pExpr1, aff) | (u8)jumpIfNull;
23835573356Sdrh   return aff;
239a37cdde0Sdanielk1977 }
240a37cdde0Sdanielk1977 
241a2e00042Sdrh /*
2420202b29eSdanielk1977 ** Return a pointer to the collation sequence that should be used by
2430202b29eSdanielk1977 ** a binary comparison operator comparing pLeft and pRight.
2440202b29eSdanielk1977 **
2450202b29eSdanielk1977 ** If the left hand expression has a collating sequence type, then it is
2460202b29eSdanielk1977 ** used. Otherwise the collation sequence for the right hand expression
2470202b29eSdanielk1977 ** is used, or the default (BINARY) if neither expression has a collating
2480202b29eSdanielk1977 ** type.
249bcbb04e5Sdanielk1977 **
250bcbb04e5Sdanielk1977 ** Argument pRight (but not pLeft) may be a null pointer. In this case,
251bcbb04e5Sdanielk1977 ** it is not considered.
2520202b29eSdanielk1977 */
253bcbb04e5Sdanielk1977 CollSeq *sqlite3BinaryCompareCollSeq(
254bcbb04e5Sdanielk1977   Parse *pParse,
255bcbb04e5Sdanielk1977   Expr *pLeft,
256bcbb04e5Sdanielk1977   Expr *pRight
257bcbb04e5Sdanielk1977 ){
258ec41ddacSdrh   CollSeq *pColl;
259ec41ddacSdrh   assert( pLeft );
260ae80ddeaSdrh   if( pLeft->flags & EP_Collate ){
261ae80ddeaSdrh     pColl = sqlite3ExprCollSeq(pParse, pLeft);
262ae80ddeaSdrh   }else if( pRight && (pRight->flags & EP_Collate)!=0 ){
263ae80ddeaSdrh     pColl = sqlite3ExprCollSeq(pParse, pRight);
264ec41ddacSdrh   }else{
265ec41ddacSdrh     pColl = sqlite3ExprCollSeq(pParse, pLeft);
2660202b29eSdanielk1977     if( !pColl ){
2677cedc8d4Sdanielk1977       pColl = sqlite3ExprCollSeq(pParse, pRight);
2680202b29eSdanielk1977     }
269ec41ddacSdrh   }
2700202b29eSdanielk1977   return pColl;
2710202b29eSdanielk1977 }
2720202b29eSdanielk1977 
2730202b29eSdanielk1977 /*
274be5c89acSdrh ** Generate code for a comparison operator.
275be5c89acSdrh */
276be5c89acSdrh static int codeCompare(
277be5c89acSdrh   Parse *pParse,    /* The parsing (and code generating) context */
278be5c89acSdrh   Expr *pLeft,      /* The left operand */
279be5c89acSdrh   Expr *pRight,     /* The right operand */
280be5c89acSdrh   int opcode,       /* The comparison opcode */
28135573356Sdrh   int in1, int in2, /* Register holding operands */
282be5c89acSdrh   int dest,         /* Jump here if true.  */
283be5c89acSdrh   int jumpIfNull    /* If true, jump if either operand is NULL */
284be5c89acSdrh ){
28535573356Sdrh   int p5;
28635573356Sdrh   int addr;
28735573356Sdrh   CollSeq *p4;
28835573356Sdrh 
28935573356Sdrh   p4 = sqlite3BinaryCompareCollSeq(pParse, pLeft, pRight);
29035573356Sdrh   p5 = binaryCompareP5(pLeft, pRight, jumpIfNull);
29135573356Sdrh   addr = sqlite3VdbeAddOp4(pParse->pVdbe, opcode, in2, dest, in1,
29235573356Sdrh                            (void*)p4, P4_COLLSEQ);
2931bd10f8aSdrh   sqlite3VdbeChangeP5(pParse->pVdbe, (u8)p5);
29435573356Sdrh   return addr;
295be5c89acSdrh }
296be5c89acSdrh 
2974b5255acSdanielk1977 #if SQLITE_MAX_EXPR_DEPTH>0
2984b5255acSdanielk1977 /*
2994b5255acSdanielk1977 ** Check that argument nHeight is less than or equal to the maximum
3004b5255acSdanielk1977 ** expression depth allowed. If it is not, leave an error message in
3014b5255acSdanielk1977 ** pParse.
3024b5255acSdanielk1977 */
3037d10d5a6Sdrh int sqlite3ExprCheckHeight(Parse *pParse, int nHeight){
3044b5255acSdanielk1977   int rc = SQLITE_OK;
3054b5255acSdanielk1977   int mxHeight = pParse->db->aLimit[SQLITE_LIMIT_EXPR_DEPTH];
3064b5255acSdanielk1977   if( nHeight>mxHeight ){
3074b5255acSdanielk1977     sqlite3ErrorMsg(pParse,
3084b5255acSdanielk1977        "Expression tree is too large (maximum depth %d)", mxHeight
3094b5255acSdanielk1977     );
3104b5255acSdanielk1977     rc = SQLITE_ERROR;
3114b5255acSdanielk1977   }
3124b5255acSdanielk1977   return rc;
3134b5255acSdanielk1977 }
3144b5255acSdanielk1977 
3154b5255acSdanielk1977 /* The following three functions, heightOfExpr(), heightOfExprList()
3164b5255acSdanielk1977 ** and heightOfSelect(), are used to determine the maximum height
3174b5255acSdanielk1977 ** of any expression tree referenced by the structure passed as the
3184b5255acSdanielk1977 ** first argument.
3194b5255acSdanielk1977 **
3204b5255acSdanielk1977 ** If this maximum height is greater than the current value pointed
3214b5255acSdanielk1977 ** to by pnHeight, the second parameter, then set *pnHeight to that
3224b5255acSdanielk1977 ** value.
3234b5255acSdanielk1977 */
3244b5255acSdanielk1977 static void heightOfExpr(Expr *p, int *pnHeight){
3254b5255acSdanielk1977   if( p ){
3264b5255acSdanielk1977     if( p->nHeight>*pnHeight ){
3274b5255acSdanielk1977       *pnHeight = p->nHeight;
3284b5255acSdanielk1977     }
3294b5255acSdanielk1977   }
3304b5255acSdanielk1977 }
3314b5255acSdanielk1977 static void heightOfExprList(ExprList *p, int *pnHeight){
3324b5255acSdanielk1977   if( p ){
3334b5255acSdanielk1977     int i;
3344b5255acSdanielk1977     for(i=0; i<p->nExpr; i++){
3354b5255acSdanielk1977       heightOfExpr(p->a[i].pExpr, pnHeight);
3364b5255acSdanielk1977     }
3374b5255acSdanielk1977   }
3384b5255acSdanielk1977 }
3394b5255acSdanielk1977 static void heightOfSelect(Select *p, int *pnHeight){
3404b5255acSdanielk1977   if( p ){
3414b5255acSdanielk1977     heightOfExpr(p->pWhere, pnHeight);
3424b5255acSdanielk1977     heightOfExpr(p->pHaving, pnHeight);
3434b5255acSdanielk1977     heightOfExpr(p->pLimit, pnHeight);
3444b5255acSdanielk1977     heightOfExpr(p->pOffset, pnHeight);
3454b5255acSdanielk1977     heightOfExprList(p->pEList, pnHeight);
3464b5255acSdanielk1977     heightOfExprList(p->pGroupBy, pnHeight);
3474b5255acSdanielk1977     heightOfExprList(p->pOrderBy, pnHeight);
3484b5255acSdanielk1977     heightOfSelect(p->pPrior, pnHeight);
3494b5255acSdanielk1977   }
3504b5255acSdanielk1977 }
3514b5255acSdanielk1977 
3524b5255acSdanielk1977 /*
3534b5255acSdanielk1977 ** Set the Expr.nHeight variable in the structure passed as an
3544b5255acSdanielk1977 ** argument. An expression with no children, Expr.pList or
3554b5255acSdanielk1977 ** Expr.pSelect member has a height of 1. Any other expression
3564b5255acSdanielk1977 ** has a height equal to the maximum height of any other
3574b5255acSdanielk1977 ** referenced Expr plus one.
3584b5255acSdanielk1977 */
3594b5255acSdanielk1977 static void exprSetHeight(Expr *p){
3604b5255acSdanielk1977   int nHeight = 0;
3614b5255acSdanielk1977   heightOfExpr(p->pLeft, &nHeight);
3624b5255acSdanielk1977   heightOfExpr(p->pRight, &nHeight);
3636ab3a2ecSdanielk1977   if( ExprHasProperty(p, EP_xIsSelect) ){
3646ab3a2ecSdanielk1977     heightOfSelect(p->x.pSelect, &nHeight);
3656ab3a2ecSdanielk1977   }else{
3666ab3a2ecSdanielk1977     heightOfExprList(p->x.pList, &nHeight);
3676ab3a2ecSdanielk1977   }
3684b5255acSdanielk1977   p->nHeight = nHeight + 1;
3694b5255acSdanielk1977 }
3704b5255acSdanielk1977 
3714b5255acSdanielk1977 /*
3724b5255acSdanielk1977 ** Set the Expr.nHeight variable using the exprSetHeight() function. If
3734b5255acSdanielk1977 ** the height is greater than the maximum allowed expression depth,
3744b5255acSdanielk1977 ** leave an error in pParse.
3754b5255acSdanielk1977 */
3764b5255acSdanielk1977 void sqlite3ExprSetHeight(Parse *pParse, Expr *p){
3774b5255acSdanielk1977   exprSetHeight(p);
3787d10d5a6Sdrh   sqlite3ExprCheckHeight(pParse, p->nHeight);
3794b5255acSdanielk1977 }
3804b5255acSdanielk1977 
3814b5255acSdanielk1977 /*
3824b5255acSdanielk1977 ** Return the maximum height of any expression tree referenced
3834b5255acSdanielk1977 ** by the select statement passed as an argument.
3844b5255acSdanielk1977 */
3854b5255acSdanielk1977 int sqlite3SelectExprHeight(Select *p){
3864b5255acSdanielk1977   int nHeight = 0;
3874b5255acSdanielk1977   heightOfSelect(p, &nHeight);
3884b5255acSdanielk1977   return nHeight;
3894b5255acSdanielk1977 }
3904b5255acSdanielk1977 #else
3914b5255acSdanielk1977   #define exprSetHeight(y)
3924b5255acSdanielk1977 #endif /* SQLITE_MAX_EXPR_DEPTH>0 */
3934b5255acSdanielk1977 
394be5c89acSdrh /*
395b7916a78Sdrh ** This routine is the core allocator for Expr nodes.
396b7916a78Sdrh **
397a76b5dfcSdrh ** Construct a new expression node and return a pointer to it.  Memory
398b7916a78Sdrh ** for this node and for the pToken argument is a single allocation
399b7916a78Sdrh ** obtained from sqlite3DbMalloc().  The calling function
400a76b5dfcSdrh ** is responsible for making sure the node eventually gets freed.
401b7916a78Sdrh **
402b7916a78Sdrh ** If dequote is true, then the token (if it exists) is dequoted.
403b7916a78Sdrh ** If dequote is false, no dequoting is performance.  The deQuote
404b7916a78Sdrh ** parameter is ignored if pToken is NULL or if the token does not
405b7916a78Sdrh ** appear to be quoted.  If the quotes were of the form "..." (double-quotes)
406b7916a78Sdrh ** then the EP_DblQuoted flag is set on the expression node.
40733e619fcSdrh **
40833e619fcSdrh ** Special case:  If op==TK_INTEGER and pToken points to a string that
40933e619fcSdrh ** can be translated into a 32-bit integer, then the token is not
41033e619fcSdrh ** stored in u.zToken.  Instead, the integer values is written
41133e619fcSdrh ** into u.iValue and the EP_IntValue flag is set.  No extra storage
41233e619fcSdrh ** is allocated to hold the integer text and the dequote flag is ignored.
413a76b5dfcSdrh */
414b7916a78Sdrh Expr *sqlite3ExprAlloc(
415a1644fd8Sdanielk1977   sqlite3 *db,            /* Handle for sqlite3DbMallocZero() (may be null) */
41617435752Sdrh   int op,                 /* Expression opcode */
417b7916a78Sdrh   const Token *pToken,    /* Token argument.  Might be NULL */
418b7916a78Sdrh   int dequote             /* True to dequote */
41917435752Sdrh ){
420a76b5dfcSdrh   Expr *pNew;
42133e619fcSdrh   int nExtra = 0;
422cf697396Sshane   int iValue = 0;
423b7916a78Sdrh 
424b7916a78Sdrh   if( pToken ){
42533e619fcSdrh     if( op!=TK_INTEGER || pToken->z==0
42633e619fcSdrh           || sqlite3GetInt32(pToken->z, &iValue)==0 ){
427b7916a78Sdrh       nExtra = pToken->n+1;
428d50ffc41Sdrh       assert( iValue>=0 );
42933e619fcSdrh     }
430a76b5dfcSdrh   }
431b7916a78Sdrh   pNew = sqlite3DbMallocZero(db, sizeof(Expr)+nExtra);
432b7916a78Sdrh   if( pNew ){
4331bd10f8aSdrh     pNew->op = (u8)op;
434a58fdfb1Sdanielk1977     pNew->iAgg = -1;
435a76b5dfcSdrh     if( pToken ){
43633e619fcSdrh       if( nExtra==0 ){
43733e619fcSdrh         pNew->flags |= EP_IntValue;
43833e619fcSdrh         pNew->u.iValue = iValue;
43933e619fcSdrh       }else{
440d9da78a2Sdrh         int c;
44133e619fcSdrh         pNew->u.zToken = (char*)&pNew[1];
442b07028f7Sdrh         assert( pToken->z!=0 || pToken->n==0 );
443b07028f7Sdrh         if( pToken->n ) memcpy(pNew->u.zToken, pToken->z, pToken->n);
44433e619fcSdrh         pNew->u.zToken[pToken->n] = 0;
445b7916a78Sdrh         if( dequote && nExtra>=3
446d9da78a2Sdrh              && ((c = pToken->z[0])=='\'' || c=='"' || c=='[' || c=='`') ){
44733e619fcSdrh           sqlite3Dequote(pNew->u.zToken);
44824fb627aSdrh           if( c=='"' ) pNew->flags |= EP_DblQuoted;
449a34001c9Sdrh         }
450a34001c9Sdrh       }
45133e619fcSdrh     }
452b7916a78Sdrh #if SQLITE_MAX_EXPR_DEPTH>0
453b7916a78Sdrh     pNew->nHeight = 1;
454b7916a78Sdrh #endif
455a34001c9Sdrh   }
456a76b5dfcSdrh   return pNew;
457a76b5dfcSdrh }
458a76b5dfcSdrh 
459a76b5dfcSdrh /*
460b7916a78Sdrh ** Allocate a new expression node from a zero-terminated token that has
461b7916a78Sdrh ** already been dequoted.
462b7916a78Sdrh */
463b7916a78Sdrh Expr *sqlite3Expr(
464b7916a78Sdrh   sqlite3 *db,            /* Handle for sqlite3DbMallocZero() (may be null) */
465b7916a78Sdrh   int op,                 /* Expression opcode */
466b7916a78Sdrh   const char *zToken      /* Token argument.  Might be NULL */
467b7916a78Sdrh ){
468b7916a78Sdrh   Token x;
469b7916a78Sdrh   x.z = zToken;
470b7916a78Sdrh   x.n = zToken ? sqlite3Strlen30(zToken) : 0;
471b7916a78Sdrh   return sqlite3ExprAlloc(db, op, &x, 0);
472b7916a78Sdrh }
473b7916a78Sdrh 
474b7916a78Sdrh /*
475b7916a78Sdrh ** Attach subtrees pLeft and pRight to the Expr node pRoot.
476b7916a78Sdrh **
477b7916a78Sdrh ** If pRoot==NULL that means that a memory allocation error has occurred.
478b7916a78Sdrh ** In that case, delete the subtrees pLeft and pRight.
479b7916a78Sdrh */
480b7916a78Sdrh void sqlite3ExprAttachSubtrees(
481b7916a78Sdrh   sqlite3 *db,
482b7916a78Sdrh   Expr *pRoot,
483b7916a78Sdrh   Expr *pLeft,
484b7916a78Sdrh   Expr *pRight
485b7916a78Sdrh ){
486b7916a78Sdrh   if( pRoot==0 ){
487b7916a78Sdrh     assert( db->mallocFailed );
488b7916a78Sdrh     sqlite3ExprDelete(db, pLeft);
489b7916a78Sdrh     sqlite3ExprDelete(db, pRight);
490b7916a78Sdrh   }else{
491b7916a78Sdrh     if( pRight ){
492b7916a78Sdrh       pRoot->pRight = pRight;
493ae80ddeaSdrh       pRoot->flags |= EP_Collate & pRight->flags;
494b7916a78Sdrh     }
495b7916a78Sdrh     if( pLeft ){
496b7916a78Sdrh       pRoot->pLeft = pLeft;
497ae80ddeaSdrh       pRoot->flags |= EP_Collate & pLeft->flags;
498b7916a78Sdrh     }
499b7916a78Sdrh     exprSetHeight(pRoot);
500b7916a78Sdrh   }
501b7916a78Sdrh }
502b7916a78Sdrh 
503b7916a78Sdrh /*
504bf664469Sdrh ** Allocate a Expr node which joins as many as two subtrees.
505b7916a78Sdrh **
506bf664469Sdrh ** One or both of the subtrees can be NULL.  Return a pointer to the new
507bf664469Sdrh ** Expr node.  Or, if an OOM error occurs, set pParse->db->mallocFailed,
508bf664469Sdrh ** free the subtrees and return NULL.
509206f3d96Sdrh */
51017435752Sdrh Expr *sqlite3PExpr(
51117435752Sdrh   Parse *pParse,          /* Parsing context */
51217435752Sdrh   int op,                 /* Expression opcode */
51317435752Sdrh   Expr *pLeft,            /* Left operand */
51417435752Sdrh   Expr *pRight,           /* Right operand */
51517435752Sdrh   const Token *pToken     /* Argument token */
51617435752Sdrh ){
5175fb52caaSdrh   Expr *p;
5185fb52caaSdrh   if( op==TK_AND && pLeft && pRight ){
5195fb52caaSdrh     /* Take advantage of short-circuit false optimization for AND */
5205fb52caaSdrh     p = sqlite3ExprAnd(pParse->db, pLeft, pRight);
5215fb52caaSdrh   }else{
5225fb52caaSdrh     p = sqlite3ExprAlloc(pParse->db, op, pToken, 1);
523b7916a78Sdrh     sqlite3ExprAttachSubtrees(pParse->db, p, pLeft, pRight);
5245fb52caaSdrh   }
5252b359bdbSdan   if( p ) {
5262b359bdbSdan     sqlite3ExprCheckHeight(pParse, p->nHeight);
5272b359bdbSdan   }
5284e0cff60Sdrh   return p;
5294e0cff60Sdrh }
5304e0cff60Sdrh 
5314e0cff60Sdrh /*
532991a1985Sdrh ** If the expression is always either TRUE or FALSE (respectively),
533991a1985Sdrh ** then return 1.  If one cannot determine the truth value of the
534991a1985Sdrh ** expression at compile-time return 0.
535991a1985Sdrh **
536991a1985Sdrh ** This is an optimization.  If is OK to return 0 here even if
537991a1985Sdrh ** the expression really is always false or false (a false negative).
538991a1985Sdrh ** But it is a bug to return 1 if the expression might have different
539991a1985Sdrh ** boolean values in different circumstances (a false positive.)
5405fb52caaSdrh **
5415fb52caaSdrh ** Note that if the expression is part of conditional for a
5425fb52caaSdrh ** LEFT JOIN, then we cannot determine at compile-time whether or not
5435fb52caaSdrh ** is it true or false, so always return 0.
5445fb52caaSdrh */
545991a1985Sdrh static int exprAlwaysTrue(Expr *p){
546991a1985Sdrh   int v = 0;
547991a1985Sdrh   if( ExprHasProperty(p, EP_FromJoin) ) return 0;
548991a1985Sdrh   if( !sqlite3ExprIsInteger(p, &v) ) return 0;
549991a1985Sdrh   return v!=0;
550991a1985Sdrh }
5515fb52caaSdrh static int exprAlwaysFalse(Expr *p){
5525fb52caaSdrh   int v = 0;
5535fb52caaSdrh   if( ExprHasProperty(p, EP_FromJoin) ) return 0;
5545fb52caaSdrh   if( !sqlite3ExprIsInteger(p, &v) ) return 0;
5555fb52caaSdrh   return v==0;
5565fb52caaSdrh }
5575fb52caaSdrh 
5585fb52caaSdrh /*
55991bb0eedSdrh ** Join two expressions using an AND operator.  If either expression is
56091bb0eedSdrh ** NULL, then just return the other expression.
5615fb52caaSdrh **
5625fb52caaSdrh ** If one side or the other of the AND is known to be false, then instead
5635fb52caaSdrh ** of returning an AND expression, just return a constant expression with
5645fb52caaSdrh ** a value of false.
56591bb0eedSdrh */
5661e536953Sdanielk1977 Expr *sqlite3ExprAnd(sqlite3 *db, Expr *pLeft, Expr *pRight){
56791bb0eedSdrh   if( pLeft==0 ){
56891bb0eedSdrh     return pRight;
56991bb0eedSdrh   }else if( pRight==0 ){
57091bb0eedSdrh     return pLeft;
5715fb52caaSdrh   }else if( exprAlwaysFalse(pLeft) || exprAlwaysFalse(pRight) ){
5725fb52caaSdrh     sqlite3ExprDelete(db, pLeft);
5735fb52caaSdrh     sqlite3ExprDelete(db, pRight);
5745fb52caaSdrh     return sqlite3ExprAlloc(db, TK_INTEGER, &sqlite3IntTokens[0], 0);
57591bb0eedSdrh   }else{
576b7916a78Sdrh     Expr *pNew = sqlite3ExprAlloc(db, TK_AND, 0, 0);
577b7916a78Sdrh     sqlite3ExprAttachSubtrees(db, pNew, pLeft, pRight);
578b7916a78Sdrh     return pNew;
579a76b5dfcSdrh   }
580a76b5dfcSdrh }
581a76b5dfcSdrh 
582a76b5dfcSdrh /*
583a76b5dfcSdrh ** Construct a new expression node for a function with multiple
584a76b5dfcSdrh ** arguments.
585a76b5dfcSdrh */
58617435752Sdrh Expr *sqlite3ExprFunction(Parse *pParse, ExprList *pList, Token *pToken){
587a76b5dfcSdrh   Expr *pNew;
588633e6d57Sdrh   sqlite3 *db = pParse->db;
5894b202ae2Sdanielk1977   assert( pToken );
590b7916a78Sdrh   pNew = sqlite3ExprAlloc(db, TK_FUNCTION, pToken, 1);
591a76b5dfcSdrh   if( pNew==0 ){
592d9da78a2Sdrh     sqlite3ExprListDelete(db, pList); /* Avoid memory leak when malloc fails */
593a76b5dfcSdrh     return 0;
594a76b5dfcSdrh   }
5956ab3a2ecSdanielk1977   pNew->x.pList = pList;
5966ab3a2ecSdanielk1977   assert( !ExprHasProperty(pNew, EP_xIsSelect) );
5974b5255acSdanielk1977   sqlite3ExprSetHeight(pParse, pNew);
598a76b5dfcSdrh   return pNew;
599a76b5dfcSdrh }
600a76b5dfcSdrh 
601a76b5dfcSdrh /*
602fa6bc000Sdrh ** Assign a variable number to an expression that encodes a wildcard
603fa6bc000Sdrh ** in the original SQL statement.
604fa6bc000Sdrh **
605fa6bc000Sdrh ** Wildcards consisting of a single "?" are assigned the next sequential
606fa6bc000Sdrh ** variable number.
607fa6bc000Sdrh **
608fa6bc000Sdrh ** Wildcards of the form "?nnn" are assigned the number "nnn".  We make
609fa6bc000Sdrh ** sure "nnn" is not too be to avoid a denial of service attack when
610fa6bc000Sdrh ** the SQL statement comes from an external source.
611fa6bc000Sdrh **
61251f49f17Sdrh ** Wildcards of the form ":aaa", "@aaa", or "$aaa" are assigned the same number
613fa6bc000Sdrh ** as the previous instance of the same wildcard.  Or if this is the first
614fa6bc000Sdrh ** instance of the wildcard, the next sequenial variable number is
615fa6bc000Sdrh ** assigned.
616fa6bc000Sdrh */
617fa6bc000Sdrh void sqlite3ExprAssignVarNumber(Parse *pParse, Expr *pExpr){
61817435752Sdrh   sqlite3 *db = pParse->db;
619b7916a78Sdrh   const char *z;
62017435752Sdrh 
621fa6bc000Sdrh   if( pExpr==0 ) return;
622c5cd1249Sdrh   assert( !ExprHasProperty(pExpr, EP_IntValue|EP_Reduced|EP_TokenOnly) );
62333e619fcSdrh   z = pExpr->u.zToken;
624b7916a78Sdrh   assert( z!=0 );
625b7916a78Sdrh   assert( z[0]!=0 );
626b7916a78Sdrh   if( z[1]==0 ){
627fa6bc000Sdrh     /* Wildcard of the form "?".  Assign the next variable number */
628b7916a78Sdrh     assert( z[0]=='?' );
6298677d308Sdrh     pExpr->iColumn = (ynVar)(++pParse->nVar);
630124c0b49Sdrh   }else{
631124c0b49Sdrh     ynVar x = 0;
632124c0b49Sdrh     u32 n = sqlite3Strlen30(z);
633124c0b49Sdrh     if( z[0]=='?' ){
634fa6bc000Sdrh       /* Wildcard of the form "?nnn".  Convert "nnn" to an integer and
635fa6bc000Sdrh       ** use it as the variable number */
636c8d735aeSdan       i64 i;
637124c0b49Sdrh       int bOk = 0==sqlite3Atoi64(&z[1], &i, n-1, SQLITE_UTF8);
638124c0b49Sdrh       pExpr->iColumn = x = (ynVar)i;
639c5499befSdrh       testcase( i==0 );
640c5499befSdrh       testcase( i==1 );
641c5499befSdrh       testcase( i==db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER]-1 );
642c5499befSdrh       testcase( i==db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER] );
643c8d735aeSdan       if( bOk==0 || i<1 || i>db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER] ){
644fa6bc000Sdrh         sqlite3ErrorMsg(pParse, "variable number must be between ?1 and ?%d",
645bb4957f8Sdrh             db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER]);
646124c0b49Sdrh         x = 0;
647fa6bc000Sdrh       }
648fa6bc000Sdrh       if( i>pParse->nVar ){
6491df2db7fSshaneh         pParse->nVar = (int)i;
650fa6bc000Sdrh       }
651fa6bc000Sdrh     }else{
65251f49f17Sdrh       /* Wildcards like ":aaa", "$aaa" or "@aaa".  Reuse the same variable
653fa6bc000Sdrh       ** number as the prior appearance of the same name, or if the name
654fa6bc000Sdrh       ** has never appeared before, reuse the same variable number
655fa6bc000Sdrh       */
656124c0b49Sdrh       ynVar i;
657124c0b49Sdrh       for(i=0; i<pParse->nzVar; i++){
658503a686eSdrh         if( pParse->azVar[i] && strcmp(pParse->azVar[i],z)==0 ){
659124c0b49Sdrh           pExpr->iColumn = x = (ynVar)i+1;
660fa6bc000Sdrh           break;
661fa6bc000Sdrh         }
662fa6bc000Sdrh       }
663124c0b49Sdrh       if( x==0 ) x = pExpr->iColumn = (ynVar)(++pParse->nVar);
664fa6bc000Sdrh     }
665124c0b49Sdrh     if( x>0 ){
666124c0b49Sdrh       if( x>pParse->nzVar ){
667124c0b49Sdrh         char **a;
668124c0b49Sdrh         a = sqlite3DbRealloc(db, pParse->azVar, x*sizeof(a[0]));
669124c0b49Sdrh         if( a==0 ) return;  /* Error reported through db->mallocFailed */
670124c0b49Sdrh         pParse->azVar = a;
671124c0b49Sdrh         memset(&a[pParse->nzVar], 0, (x-pParse->nzVar)*sizeof(a[0]));
672124c0b49Sdrh         pParse->nzVar = x;
673124c0b49Sdrh       }
674124c0b49Sdrh       if( z[0]!='?' || pParse->azVar[x-1]==0 ){
675124c0b49Sdrh         sqlite3DbFree(db, pParse->azVar[x-1]);
676124c0b49Sdrh         pParse->azVar[x-1] = sqlite3DbStrNDup(db, z, n);
677fa6bc000Sdrh       }
678fa6bc000Sdrh     }
679fa6bc000Sdrh   }
680bb4957f8Sdrh   if( !pParse->nErr && pParse->nVar>db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER] ){
681832b2664Sdanielk1977     sqlite3ErrorMsg(pParse, "too many SQL variables");
682832b2664Sdanielk1977   }
683fa6bc000Sdrh }
684fa6bc000Sdrh 
685fa6bc000Sdrh /*
686f6963f99Sdan ** Recursively delete an expression tree.
687a2e00042Sdrh */
688f6963f99Sdan void sqlite3ExprDelete(sqlite3 *db, Expr *p){
689f6963f99Sdan   if( p==0 ) return;
690d50ffc41Sdrh   /* Sanity check: Assert that the IntValue is non-negative if it exists */
691d50ffc41Sdrh   assert( !ExprHasProperty(p, EP_IntValue) || p->u.iValue>=0 );
692c5cd1249Sdrh   if( !ExprHasProperty(p, EP_TokenOnly) ){
693c5cd1249Sdrh     /* The Expr.x union is never used at the same time as Expr.pRight */
694c5cd1249Sdrh     assert( p->x.pList==0 || p->pRight==0 );
695633e6d57Sdrh     sqlite3ExprDelete(db, p->pLeft);
696633e6d57Sdrh     sqlite3ExprDelete(db, p->pRight);
697c5cd1249Sdrh     if( ExprHasProperty(p, EP_MemToken) ) sqlite3DbFree(db, p->u.zToken);
6986ab3a2ecSdanielk1977     if( ExprHasProperty(p, EP_xIsSelect) ){
6996ab3a2ecSdanielk1977       sqlite3SelectDelete(db, p->x.pSelect);
7006ab3a2ecSdanielk1977     }else{
7016ab3a2ecSdanielk1977       sqlite3ExprListDelete(db, p->x.pList);
7026ab3a2ecSdanielk1977     }
7036ab3a2ecSdanielk1977   }
70433e619fcSdrh   if( !ExprHasProperty(p, EP_Static) ){
705633e6d57Sdrh     sqlite3DbFree(db, p);
706a2e00042Sdrh   }
70733e619fcSdrh }
708a2e00042Sdrh 
709d2687b77Sdrh /*
7106ab3a2ecSdanielk1977 ** Return the number of bytes allocated for the expression structure
7116ab3a2ecSdanielk1977 ** passed as the first argument. This is always one of EXPR_FULLSIZE,
7126ab3a2ecSdanielk1977 ** EXPR_REDUCEDSIZE or EXPR_TOKENONLYSIZE.
7136ab3a2ecSdanielk1977 */
7146ab3a2ecSdanielk1977 static int exprStructSize(Expr *p){
7156ab3a2ecSdanielk1977   if( ExprHasProperty(p, EP_TokenOnly) ) return EXPR_TOKENONLYSIZE;
7166ab3a2ecSdanielk1977   if( ExprHasProperty(p, EP_Reduced) ) return EXPR_REDUCEDSIZE;
7176ab3a2ecSdanielk1977   return EXPR_FULLSIZE;
7186ab3a2ecSdanielk1977 }
7196ab3a2ecSdanielk1977 
7206ab3a2ecSdanielk1977 /*
72133e619fcSdrh ** The dupedExpr*Size() routines each return the number of bytes required
72233e619fcSdrh ** to store a copy of an expression or expression tree.  They differ in
72333e619fcSdrh ** how much of the tree is measured.
72433e619fcSdrh **
72533e619fcSdrh **     dupedExprStructSize()     Size of only the Expr structure
72633e619fcSdrh **     dupedExprNodeSize()       Size of Expr + space for token
72733e619fcSdrh **     dupedExprSize()           Expr + token + subtree components
72833e619fcSdrh **
72933e619fcSdrh ***************************************************************************
73033e619fcSdrh **
73133e619fcSdrh ** The dupedExprStructSize() function returns two values OR-ed together:
73233e619fcSdrh ** (1) the space required for a copy of the Expr structure only and
73333e619fcSdrh ** (2) the EP_xxx flags that indicate what the structure size should be.
73433e619fcSdrh ** The return values is always one of:
73533e619fcSdrh **
73633e619fcSdrh **      EXPR_FULLSIZE
73733e619fcSdrh **      EXPR_REDUCEDSIZE   | EP_Reduced
73833e619fcSdrh **      EXPR_TOKENONLYSIZE | EP_TokenOnly
73933e619fcSdrh **
74033e619fcSdrh ** The size of the structure can be found by masking the return value
74133e619fcSdrh ** of this routine with 0xfff.  The flags can be found by masking the
74233e619fcSdrh ** return value with EP_Reduced|EP_TokenOnly.
74333e619fcSdrh **
74433e619fcSdrh ** Note that with flags==EXPRDUP_REDUCE, this routines works on full-size
74533e619fcSdrh ** (unreduced) Expr objects as they or originally constructed by the parser.
74633e619fcSdrh ** During expression analysis, extra information is computed and moved into
74733e619fcSdrh ** later parts of teh Expr object and that extra information might get chopped
74833e619fcSdrh ** off if the expression is reduced.  Note also that it does not work to
74933e619fcSdrh ** make a EXPRDUP_REDUCE copy of a reduced expression.  It is only legal
75033e619fcSdrh ** to reduce a pristine expression tree from the parser.  The implementation
75133e619fcSdrh ** of dupedExprStructSize() contain multiple assert() statements that attempt
75233e619fcSdrh ** to enforce this constraint.
7536ab3a2ecSdanielk1977 */
7546ab3a2ecSdanielk1977 static int dupedExprStructSize(Expr *p, int flags){
7556ab3a2ecSdanielk1977   int nSize;
75633e619fcSdrh   assert( flags==EXPRDUP_REDUCE || flags==0 ); /* Only one flag value allowed */
757aecd8021Sdrh   assert( EXPR_FULLSIZE<=0xfff );
758aecd8021Sdrh   assert( (0xfff & (EP_Reduced|EP_TokenOnly))==0 );
7596ab3a2ecSdanielk1977   if( 0==(flags&EXPRDUP_REDUCE) ){
7606ab3a2ecSdanielk1977     nSize = EXPR_FULLSIZE;
7616ab3a2ecSdanielk1977   }else{
762c5cd1249Sdrh     assert( !ExprHasProperty(p, EP_TokenOnly|EP_Reduced) );
76333e619fcSdrh     assert( !ExprHasProperty(p, EP_FromJoin) );
764c5cd1249Sdrh     assert( !ExprHasProperty(p, EP_MemToken) );
765ebb6a65dSdrh     assert( !ExprHasProperty(p, EP_NoReduce) );
766aecd8021Sdrh     if( p->pLeft || p->x.pList ){
76733e619fcSdrh       nSize = EXPR_REDUCEDSIZE | EP_Reduced;
76833e619fcSdrh     }else{
769aecd8021Sdrh       assert( p->pRight==0 );
77033e619fcSdrh       nSize = EXPR_TOKENONLYSIZE | EP_TokenOnly;
77133e619fcSdrh     }
7726ab3a2ecSdanielk1977   }
7736ab3a2ecSdanielk1977   return nSize;
7746ab3a2ecSdanielk1977 }
7756ab3a2ecSdanielk1977 
7766ab3a2ecSdanielk1977 /*
77733e619fcSdrh ** This function returns the space in bytes required to store the copy
77833e619fcSdrh ** of the Expr structure and a copy of the Expr.u.zToken string (if that
77933e619fcSdrh ** string is defined.)
7806ab3a2ecSdanielk1977 */
7816ab3a2ecSdanielk1977 static int dupedExprNodeSize(Expr *p, int flags){
78233e619fcSdrh   int nByte = dupedExprStructSize(p, flags) & 0xfff;
78333e619fcSdrh   if( !ExprHasProperty(p, EP_IntValue) && p->u.zToken ){
78433e619fcSdrh     nByte += sqlite3Strlen30(p->u.zToken)+1;
7856ab3a2ecSdanielk1977   }
786bc73971dSdanielk1977   return ROUND8(nByte);
7876ab3a2ecSdanielk1977 }
7886ab3a2ecSdanielk1977 
7896ab3a2ecSdanielk1977 /*
7906ab3a2ecSdanielk1977 ** Return the number of bytes required to create a duplicate of the
7916ab3a2ecSdanielk1977 ** expression passed as the first argument. The second argument is a
7926ab3a2ecSdanielk1977 ** mask containing EXPRDUP_XXX flags.
7936ab3a2ecSdanielk1977 **
7946ab3a2ecSdanielk1977 ** The value returned includes space to create a copy of the Expr struct
79533e619fcSdrh ** itself and the buffer referred to by Expr.u.zToken, if any.
7966ab3a2ecSdanielk1977 **
7976ab3a2ecSdanielk1977 ** If the EXPRDUP_REDUCE flag is set, then the return value includes
7986ab3a2ecSdanielk1977 ** space to duplicate all Expr nodes in the tree formed by Expr.pLeft
7996ab3a2ecSdanielk1977 ** and Expr.pRight variables (but not for any structures pointed to or
8006ab3a2ecSdanielk1977 ** descended from the Expr.x.pList or Expr.x.pSelect variables).
8016ab3a2ecSdanielk1977 */
8026ab3a2ecSdanielk1977 static int dupedExprSize(Expr *p, int flags){
8036ab3a2ecSdanielk1977   int nByte = 0;
8046ab3a2ecSdanielk1977   if( p ){
8056ab3a2ecSdanielk1977     nByte = dupedExprNodeSize(p, flags);
8066ab3a2ecSdanielk1977     if( flags&EXPRDUP_REDUCE ){
807b7916a78Sdrh       nByte += dupedExprSize(p->pLeft, flags) + dupedExprSize(p->pRight, flags);
8086ab3a2ecSdanielk1977     }
8096ab3a2ecSdanielk1977   }
8106ab3a2ecSdanielk1977   return nByte;
8116ab3a2ecSdanielk1977 }
8126ab3a2ecSdanielk1977 
8136ab3a2ecSdanielk1977 /*
8146ab3a2ecSdanielk1977 ** This function is similar to sqlite3ExprDup(), except that if pzBuffer
8156ab3a2ecSdanielk1977 ** is not NULL then *pzBuffer is assumed to point to a buffer large enough
81633e619fcSdrh ** to store the copy of expression p, the copies of p->u.zToken
8176ab3a2ecSdanielk1977 ** (if applicable), and the copies of the p->pLeft and p->pRight expressions,
8186ab3a2ecSdanielk1977 ** if any. Before returning, *pzBuffer is set to the first byte passed the
8196ab3a2ecSdanielk1977 ** portion of the buffer copied into by this function.
8206ab3a2ecSdanielk1977 */
8216ab3a2ecSdanielk1977 static Expr *exprDup(sqlite3 *db, Expr *p, int flags, u8 **pzBuffer){
8226ab3a2ecSdanielk1977   Expr *pNew = 0;                      /* Value to return */
8236ab3a2ecSdanielk1977   if( p ){
8246ab3a2ecSdanielk1977     const int isReduced = (flags&EXPRDUP_REDUCE);
8256ab3a2ecSdanielk1977     u8 *zAlloc;
82633e619fcSdrh     u32 staticFlag = 0;
8276ab3a2ecSdanielk1977 
8286ab3a2ecSdanielk1977     assert( pzBuffer==0 || isReduced );
8296ab3a2ecSdanielk1977 
8306ab3a2ecSdanielk1977     /* Figure out where to write the new Expr structure. */
8316ab3a2ecSdanielk1977     if( pzBuffer ){
8326ab3a2ecSdanielk1977       zAlloc = *pzBuffer;
83333e619fcSdrh       staticFlag = EP_Static;
8346ab3a2ecSdanielk1977     }else{
8356ab3a2ecSdanielk1977       zAlloc = sqlite3DbMallocRaw(db, dupedExprSize(p, flags));
8366ab3a2ecSdanielk1977     }
8376ab3a2ecSdanielk1977     pNew = (Expr *)zAlloc;
8386ab3a2ecSdanielk1977 
8396ab3a2ecSdanielk1977     if( pNew ){
8406ab3a2ecSdanielk1977       /* Set nNewSize to the size allocated for the structure pointed to
8416ab3a2ecSdanielk1977       ** by pNew. This is either EXPR_FULLSIZE, EXPR_REDUCEDSIZE or
8426ab3a2ecSdanielk1977       ** EXPR_TOKENONLYSIZE. nToken is set to the number of bytes consumed
84333e619fcSdrh       ** by the copy of the p->u.zToken string (if any).
8446ab3a2ecSdanielk1977       */
84533e619fcSdrh       const unsigned nStructSize = dupedExprStructSize(p, flags);
84633e619fcSdrh       const int nNewSize = nStructSize & 0xfff;
84733e619fcSdrh       int nToken;
84833e619fcSdrh       if( !ExprHasProperty(p, EP_IntValue) && p->u.zToken ){
84933e619fcSdrh         nToken = sqlite3Strlen30(p->u.zToken) + 1;
85033e619fcSdrh       }else{
85133e619fcSdrh         nToken = 0;
85233e619fcSdrh       }
8536ab3a2ecSdanielk1977       if( isReduced ){
8546ab3a2ecSdanielk1977         assert( ExprHasProperty(p, EP_Reduced)==0 );
8556ab3a2ecSdanielk1977         memcpy(zAlloc, p, nNewSize);
8566ab3a2ecSdanielk1977       }else{
8576ab3a2ecSdanielk1977         int nSize = exprStructSize(p);
8586ab3a2ecSdanielk1977         memcpy(zAlloc, p, nSize);
8596ab3a2ecSdanielk1977         memset(&zAlloc[nSize], 0, EXPR_FULLSIZE-nSize);
8606ab3a2ecSdanielk1977       }
8616ab3a2ecSdanielk1977 
86233e619fcSdrh       /* Set the EP_Reduced, EP_TokenOnly, and EP_Static flags appropriately. */
863c5cd1249Sdrh       pNew->flags &= ~(EP_Reduced|EP_TokenOnly|EP_Static|EP_MemToken);
86433e619fcSdrh       pNew->flags |= nStructSize & (EP_Reduced|EP_TokenOnly);
86533e619fcSdrh       pNew->flags |= staticFlag;
8666ab3a2ecSdanielk1977 
86733e619fcSdrh       /* Copy the p->u.zToken string, if any. */
8686ab3a2ecSdanielk1977       if( nToken ){
86933e619fcSdrh         char *zToken = pNew->u.zToken = (char*)&zAlloc[nNewSize];
87033e619fcSdrh         memcpy(zToken, p->u.zToken, nToken);
8716ab3a2ecSdanielk1977       }
8726ab3a2ecSdanielk1977 
8736ab3a2ecSdanielk1977       if( 0==((p->flags|pNew->flags) & EP_TokenOnly) ){
8746ab3a2ecSdanielk1977         /* Fill in the pNew->x.pSelect or pNew->x.pList member. */
8756ab3a2ecSdanielk1977         if( ExprHasProperty(p, EP_xIsSelect) ){
8766ab3a2ecSdanielk1977           pNew->x.pSelect = sqlite3SelectDup(db, p->x.pSelect, isReduced);
8776ab3a2ecSdanielk1977         }else{
8786ab3a2ecSdanielk1977           pNew->x.pList = sqlite3ExprListDup(db, p->x.pList, isReduced);
8796ab3a2ecSdanielk1977         }
8806ab3a2ecSdanielk1977       }
8816ab3a2ecSdanielk1977 
8826ab3a2ecSdanielk1977       /* Fill in pNew->pLeft and pNew->pRight. */
883c5cd1249Sdrh       if( ExprHasProperty(pNew, EP_Reduced|EP_TokenOnly) ){
8846ab3a2ecSdanielk1977         zAlloc += dupedExprNodeSize(p, flags);
8856ab3a2ecSdanielk1977         if( ExprHasProperty(pNew, EP_Reduced) ){
8866ab3a2ecSdanielk1977           pNew->pLeft = exprDup(db, p->pLeft, EXPRDUP_REDUCE, &zAlloc);
8876ab3a2ecSdanielk1977           pNew->pRight = exprDup(db, p->pRight, EXPRDUP_REDUCE, &zAlloc);
8886ab3a2ecSdanielk1977         }
8896ab3a2ecSdanielk1977         if( pzBuffer ){
8906ab3a2ecSdanielk1977           *pzBuffer = zAlloc;
8916ab3a2ecSdanielk1977         }
892b7916a78Sdrh       }else{
893c5cd1249Sdrh         if( !ExprHasProperty(p, EP_TokenOnly) ){
8946ab3a2ecSdanielk1977           pNew->pLeft = sqlite3ExprDup(db, p->pLeft, 0);
8956ab3a2ecSdanielk1977           pNew->pRight = sqlite3ExprDup(db, p->pRight, 0);
8966ab3a2ecSdanielk1977         }
8976ab3a2ecSdanielk1977       }
898b7916a78Sdrh 
899b7916a78Sdrh     }
9006ab3a2ecSdanielk1977   }
9016ab3a2ecSdanielk1977   return pNew;
9026ab3a2ecSdanielk1977 }
9036ab3a2ecSdanielk1977 
904bfe31e7fSdan /*
905bfe31e7fSdan ** Create and return a deep copy of the object passed as the second
906bfe31e7fSdan ** argument. If an OOM condition is encountered, NULL is returned
907bfe31e7fSdan ** and the db->mallocFailed flag set.
908bfe31e7fSdan */
909eede6a53Sdan #ifndef SQLITE_OMIT_CTE
910bfe31e7fSdan static With *withDup(sqlite3 *db, With *p){
9114e9119d9Sdan   With *pRet = 0;
9124e9119d9Sdan   if( p ){
9134e9119d9Sdan     int nByte = sizeof(*p) + sizeof(p->a[0]) * (p->nCte-1);
9144e9119d9Sdan     pRet = sqlite3DbMallocZero(db, nByte);
9154e9119d9Sdan     if( pRet ){
9164e9119d9Sdan       int i;
9174e9119d9Sdan       pRet->nCte = p->nCte;
9184e9119d9Sdan       for(i=0; i<p->nCte; i++){
9194e9119d9Sdan         pRet->a[i].pSelect = sqlite3SelectDup(db, p->a[i].pSelect, 0);
9204e9119d9Sdan         pRet->a[i].pCols = sqlite3ExprListDup(db, p->a[i].pCols, 0);
9214e9119d9Sdan         pRet->a[i].zName = sqlite3DbStrDup(db, p->a[i].zName);
9224e9119d9Sdan       }
9234e9119d9Sdan     }
9244e9119d9Sdan   }
9254e9119d9Sdan   return pRet;
9264e9119d9Sdan }
927eede6a53Sdan #else
928eede6a53Sdan # define withDup(x,y) 0
929eede6a53Sdan #endif
9304e9119d9Sdan 
9316ab3a2ecSdanielk1977 /*
932ff78bd2fSdrh ** The following group of routines make deep copies of expressions,
933ff78bd2fSdrh ** expression lists, ID lists, and select statements.  The copies can
934ff78bd2fSdrh ** be deleted (by being passed to their respective ...Delete() routines)
935ff78bd2fSdrh ** without effecting the originals.
936ff78bd2fSdrh **
9374adee20fSdanielk1977 ** The expression list, ID, and source lists return by sqlite3ExprListDup(),
9384adee20fSdanielk1977 ** sqlite3IdListDup(), and sqlite3SrcListDup() can not be further expanded
939ad3cab52Sdrh ** by subsequent calls to sqlite*ListAppend() routines.
940ff78bd2fSdrh **
941ad3cab52Sdrh ** Any tables that the SrcList might point to are not duplicated.
9426ab3a2ecSdanielk1977 **
943b7916a78Sdrh ** The flags parameter contains a combination of the EXPRDUP_XXX flags.
9446ab3a2ecSdanielk1977 ** If the EXPRDUP_REDUCE flag is set, then the structure returned is a
9456ab3a2ecSdanielk1977 ** truncated version of the usual Expr structure that will be stored as
9466ab3a2ecSdanielk1977 ** part of the in-memory representation of the database schema.
947ff78bd2fSdrh */
9486ab3a2ecSdanielk1977 Expr *sqlite3ExprDup(sqlite3 *db, Expr *p, int flags){
9496ab3a2ecSdanielk1977   return exprDup(db, p, flags, 0);
950ff78bd2fSdrh }
9516ab3a2ecSdanielk1977 ExprList *sqlite3ExprListDup(sqlite3 *db, ExprList *p, int flags){
952ff78bd2fSdrh   ExprList *pNew;
953145716b3Sdrh   struct ExprList_item *pItem, *pOldItem;
954ff78bd2fSdrh   int i;
955ff78bd2fSdrh   if( p==0 ) return 0;
95617435752Sdrh   pNew = sqlite3DbMallocRaw(db, sizeof(*pNew) );
957ff78bd2fSdrh   if( pNew==0 ) return 0;
958d872bb18Sdrh   pNew->nExpr = i = p->nExpr;
959d872bb18Sdrh   if( (flags & EXPRDUP_REDUCE)==0 ) for(i=1; i<p->nExpr; i+=i){}
960d872bb18Sdrh   pNew->a = pItem = sqlite3DbMallocRaw(db,  i*sizeof(p->a[0]) );
961e0048400Sdanielk1977   if( pItem==0 ){
962633e6d57Sdrh     sqlite3DbFree(db, pNew);
963e0048400Sdanielk1977     return 0;
964e0048400Sdanielk1977   }
965145716b3Sdrh   pOldItem = p->a;
966145716b3Sdrh   for(i=0; i<p->nExpr; i++, pItem++, pOldItem++){
9676ab3a2ecSdanielk1977     Expr *pOldExpr = pOldItem->pExpr;
968b5526ea6Sdrh     pItem->pExpr = sqlite3ExprDup(db, pOldExpr, flags);
96917435752Sdrh     pItem->zName = sqlite3DbStrDup(db, pOldItem->zName);
970b7916a78Sdrh     pItem->zSpan = sqlite3DbStrDup(db, pOldItem->zSpan);
971145716b3Sdrh     pItem->sortOrder = pOldItem->sortOrder;
9723e7bc9caSdrh     pItem->done = 0;
9732c036cffSdrh     pItem->bSpanIsTab = pOldItem->bSpanIsTab;
974c2acc4e4Sdrh     pItem->u = pOldItem->u;
975ff78bd2fSdrh   }
976ff78bd2fSdrh   return pNew;
977ff78bd2fSdrh }
97893758c8dSdanielk1977 
97993758c8dSdanielk1977 /*
98093758c8dSdanielk1977 ** If cursors, triggers, views and subqueries are all omitted from
98193758c8dSdanielk1977 ** the build, then none of the following routines, except for
98293758c8dSdanielk1977 ** sqlite3SelectDup(), can be called. sqlite3SelectDup() is sometimes
98393758c8dSdanielk1977 ** called with a NULL argument.
98493758c8dSdanielk1977 */
9856a67fe8eSdanielk1977 #if !defined(SQLITE_OMIT_VIEW) || !defined(SQLITE_OMIT_TRIGGER) \
9866a67fe8eSdanielk1977  || !defined(SQLITE_OMIT_SUBQUERY)
9876ab3a2ecSdanielk1977 SrcList *sqlite3SrcListDup(sqlite3 *db, SrcList *p, int flags){
988ad3cab52Sdrh   SrcList *pNew;
989ad3cab52Sdrh   int i;
990113088ecSdrh   int nByte;
991ad3cab52Sdrh   if( p==0 ) return 0;
992113088ecSdrh   nByte = sizeof(*p) + (p->nSrc>0 ? sizeof(p->a[0]) * (p->nSrc-1) : 0);
99317435752Sdrh   pNew = sqlite3DbMallocRaw(db, nByte );
994ad3cab52Sdrh   if( pNew==0 ) return 0;
9954305d103Sdrh   pNew->nSrc = pNew->nAlloc = p->nSrc;
996ad3cab52Sdrh   for(i=0; i<p->nSrc; i++){
9974efc4754Sdrh     struct SrcList_item *pNewItem = &pNew->a[i];
9984efc4754Sdrh     struct SrcList_item *pOldItem = &p->a[i];
999ed8a3bb1Sdrh     Table *pTab;
100041fb5cd1Sdan     pNewItem->pSchema = pOldItem->pSchema;
100117435752Sdrh     pNewItem->zDatabase = sqlite3DbStrDup(db, pOldItem->zDatabase);
100217435752Sdrh     pNewItem->zName = sqlite3DbStrDup(db, pOldItem->zName);
100317435752Sdrh     pNewItem->zAlias = sqlite3DbStrDup(db, pOldItem->zAlias);
10044efc4754Sdrh     pNewItem->jointype = pOldItem->jointype;
10054efc4754Sdrh     pNewItem->iCursor = pOldItem->iCursor;
10065b6a9ed4Sdrh     pNewItem->addrFillSub = pOldItem->addrFillSub;
10075b6a9ed4Sdrh     pNewItem->regReturn = pOldItem->regReturn;
1008da79cf0cSdan     pNewItem->isCorrelated = pOldItem->isCorrelated;
100921172c4cSdrh     pNewItem->viaCoroutine = pOldItem->viaCoroutine;
1010f43fe6e9Sdan     pNewItem->isRecursive = pOldItem->isRecursive;
101185574e31Sdanielk1977     pNewItem->zIndex = sqlite3DbStrDup(db, pOldItem->zIndex);
101285574e31Sdanielk1977     pNewItem->notIndexed = pOldItem->notIndexed;
101385574e31Sdanielk1977     pNewItem->pIndex = pOldItem->pIndex;
1014ed8a3bb1Sdrh     pTab = pNewItem->pTab = pOldItem->pTab;
1015ed8a3bb1Sdrh     if( pTab ){
1016ed8a3bb1Sdrh       pTab->nRef++;
1017a1cb183dSdanielk1977     }
10186ab3a2ecSdanielk1977     pNewItem->pSelect = sqlite3SelectDup(db, pOldItem->pSelect, flags);
10196ab3a2ecSdanielk1977     pNewItem->pOn = sqlite3ExprDup(db, pOldItem->pOn, flags);
102017435752Sdrh     pNewItem->pUsing = sqlite3IdListDup(db, pOldItem->pUsing);
10216c18b6e0Sdanielk1977     pNewItem->colUsed = pOldItem->colUsed;
1022ad3cab52Sdrh   }
1023ad3cab52Sdrh   return pNew;
1024ad3cab52Sdrh }
102517435752Sdrh IdList *sqlite3IdListDup(sqlite3 *db, IdList *p){
1026ff78bd2fSdrh   IdList *pNew;
1027ff78bd2fSdrh   int i;
1028ff78bd2fSdrh   if( p==0 ) return 0;
102917435752Sdrh   pNew = sqlite3DbMallocRaw(db, sizeof(*pNew) );
1030ff78bd2fSdrh   if( pNew==0 ) return 0;
10316c535158Sdrh   pNew->nId = p->nId;
103217435752Sdrh   pNew->a = sqlite3DbMallocRaw(db, p->nId*sizeof(p->a[0]) );
1033d5d56523Sdanielk1977   if( pNew->a==0 ){
1034633e6d57Sdrh     sqlite3DbFree(db, pNew);
1035d5d56523Sdanielk1977     return 0;
1036d5d56523Sdanielk1977   }
10376c535158Sdrh   /* Note that because the size of the allocation for p->a[] is not
10386c535158Sdrh   ** necessarily a power of two, sqlite3IdListAppend() may not be called
10396c535158Sdrh   ** on the duplicate created by this function. */
1040ff78bd2fSdrh   for(i=0; i<p->nId; i++){
10414efc4754Sdrh     struct IdList_item *pNewItem = &pNew->a[i];
10424efc4754Sdrh     struct IdList_item *pOldItem = &p->a[i];
104317435752Sdrh     pNewItem->zName = sqlite3DbStrDup(db, pOldItem->zName);
10444efc4754Sdrh     pNewItem->idx = pOldItem->idx;
1045ff78bd2fSdrh   }
1046ff78bd2fSdrh   return pNew;
1047ff78bd2fSdrh }
10486ab3a2ecSdanielk1977 Select *sqlite3SelectDup(sqlite3 *db, Select *p, int flags){
104923b1b372Sdrh   Select *pNew, *pPrior;
1050ff78bd2fSdrh   if( p==0 ) return 0;
105117435752Sdrh   pNew = sqlite3DbMallocRaw(db, sizeof(*p) );
1052ff78bd2fSdrh   if( pNew==0 ) return 0;
1053b7916a78Sdrh   pNew->pEList = sqlite3ExprListDup(db, p->pEList, flags);
10546ab3a2ecSdanielk1977   pNew->pSrc = sqlite3SrcListDup(db, p->pSrc, flags);
10556ab3a2ecSdanielk1977   pNew->pWhere = sqlite3ExprDup(db, p->pWhere, flags);
10566ab3a2ecSdanielk1977   pNew->pGroupBy = sqlite3ExprListDup(db, p->pGroupBy, flags);
10576ab3a2ecSdanielk1977   pNew->pHaving = sqlite3ExprDup(db, p->pHaving, flags);
10586ab3a2ecSdanielk1977   pNew->pOrderBy = sqlite3ExprListDup(db, p->pOrderBy, flags);
1059ff78bd2fSdrh   pNew->op = p->op;
106023b1b372Sdrh   pNew->pPrior = pPrior = sqlite3SelectDup(db, p->pPrior, flags);
106123b1b372Sdrh   if( pPrior ) pPrior->pNext = pNew;
106223b1b372Sdrh   pNew->pNext = 0;
10636ab3a2ecSdanielk1977   pNew->pLimit = sqlite3ExprDup(db, p->pLimit, flags);
10646ab3a2ecSdanielk1977   pNew->pOffset = sqlite3ExprDup(db, p->pOffset, flags);
106592b01d53Sdrh   pNew->iLimit = 0;
106692b01d53Sdrh   pNew->iOffset = 0;
10677d10d5a6Sdrh   pNew->selFlags = p->selFlags & ~SF_UsesEphemeral;
1068b9bb7c18Sdrh   pNew->addrOpenEphm[0] = -1;
1069b9bb7c18Sdrh   pNew->addrOpenEphm[1] = -1;
1070ec2da854Sdrh   pNew->nSelectRow = p->nSelectRow;
10714e9119d9Sdan   pNew->pWith = withDup(db, p->pWith);
1072ff78bd2fSdrh   return pNew;
1073ff78bd2fSdrh }
107493758c8dSdanielk1977 #else
10756ab3a2ecSdanielk1977 Select *sqlite3SelectDup(sqlite3 *db, Select *p, int flags){
107693758c8dSdanielk1977   assert( p==0 );
107793758c8dSdanielk1977   return 0;
107893758c8dSdanielk1977 }
107993758c8dSdanielk1977 #endif
1080ff78bd2fSdrh 
1081ff78bd2fSdrh 
1082ff78bd2fSdrh /*
1083a76b5dfcSdrh ** Add a new element to the end of an expression list.  If pList is
1084a76b5dfcSdrh ** initially NULL, then create a new expression list.
1085b7916a78Sdrh **
1086b7916a78Sdrh ** If a memory allocation error occurs, the entire list is freed and
1087b7916a78Sdrh ** NULL is returned.  If non-NULL is returned, then it is guaranteed
1088b7916a78Sdrh ** that the new entry was successfully appended.
1089a76b5dfcSdrh */
109017435752Sdrh ExprList *sqlite3ExprListAppend(
109117435752Sdrh   Parse *pParse,          /* Parsing context */
109217435752Sdrh   ExprList *pList,        /* List to which to append. Might be NULL */
1093b7916a78Sdrh   Expr *pExpr             /* Expression to be appended. Might be NULL */
109417435752Sdrh ){
109517435752Sdrh   sqlite3 *db = pParse->db;
1096a76b5dfcSdrh   if( pList==0 ){
109717435752Sdrh     pList = sqlite3DbMallocZero(db, sizeof(ExprList) );
1098a76b5dfcSdrh     if( pList==0 ){
1099d5d56523Sdanielk1977       goto no_mem;
1100a76b5dfcSdrh     }
1101d872bb18Sdrh     pList->a = sqlite3DbMallocRaw(db, sizeof(pList->a[0]));
1102d872bb18Sdrh     if( pList->a==0 ) goto no_mem;
1103d872bb18Sdrh   }else if( (pList->nExpr & (pList->nExpr-1))==0 ){
1104d5d56523Sdanielk1977     struct ExprList_item *a;
1105d872bb18Sdrh     assert( pList->nExpr>0 );
1106d872bb18Sdrh     a = sqlite3DbRealloc(db, pList->a, pList->nExpr*2*sizeof(pList->a[0]));
1107d5d56523Sdanielk1977     if( a==0 ){
1108d5d56523Sdanielk1977       goto no_mem;
1109a76b5dfcSdrh     }
1110d5d56523Sdanielk1977     pList->a = a;
1111a76b5dfcSdrh   }
11124efc4754Sdrh   assert( pList->a!=0 );
1113b7916a78Sdrh   if( 1 ){
11144efc4754Sdrh     struct ExprList_item *pItem = &pList->a[pList->nExpr++];
11154efc4754Sdrh     memset(pItem, 0, sizeof(*pItem));
1116e94ddc9eSdanielk1977     pItem->pExpr = pExpr;
1117a76b5dfcSdrh   }
1118a76b5dfcSdrh   return pList;
1119d5d56523Sdanielk1977 
1120d5d56523Sdanielk1977 no_mem:
1121d5d56523Sdanielk1977   /* Avoid leaking memory if malloc has failed. */
1122633e6d57Sdrh   sqlite3ExprDelete(db, pExpr);
1123633e6d57Sdrh   sqlite3ExprListDelete(db, pList);
1124d5d56523Sdanielk1977   return 0;
1125a76b5dfcSdrh }
1126a76b5dfcSdrh 
1127a76b5dfcSdrh /*
1128b7916a78Sdrh ** Set the ExprList.a[].zName element of the most recently added item
1129b7916a78Sdrh ** on the expression list.
1130b7916a78Sdrh **
1131b7916a78Sdrh ** pList might be NULL following an OOM error.  But pName should never be
1132b7916a78Sdrh ** NULL.  If a memory allocation fails, the pParse->db->mallocFailed flag
1133b7916a78Sdrh ** is set.
1134b7916a78Sdrh */
1135b7916a78Sdrh void sqlite3ExprListSetName(
1136b7916a78Sdrh   Parse *pParse,          /* Parsing context */
1137b7916a78Sdrh   ExprList *pList,        /* List to which to add the span. */
1138b7916a78Sdrh   Token *pName,           /* Name to be added */
1139b7916a78Sdrh   int dequote             /* True to cause the name to be dequoted */
1140b7916a78Sdrh ){
1141b7916a78Sdrh   assert( pList!=0 || pParse->db->mallocFailed!=0 );
1142b7916a78Sdrh   if( pList ){
1143b7916a78Sdrh     struct ExprList_item *pItem;
1144b7916a78Sdrh     assert( pList->nExpr>0 );
1145b7916a78Sdrh     pItem = &pList->a[pList->nExpr-1];
1146b7916a78Sdrh     assert( pItem->zName==0 );
1147b7916a78Sdrh     pItem->zName = sqlite3DbStrNDup(pParse->db, pName->z, pName->n);
1148b7916a78Sdrh     if( dequote && pItem->zName ) sqlite3Dequote(pItem->zName);
1149b7916a78Sdrh   }
1150b7916a78Sdrh }
1151b7916a78Sdrh 
1152b7916a78Sdrh /*
1153b7916a78Sdrh ** Set the ExprList.a[].zSpan element of the most recently added item
1154b7916a78Sdrh ** on the expression list.
1155b7916a78Sdrh **
1156b7916a78Sdrh ** pList might be NULL following an OOM error.  But pSpan should never be
1157b7916a78Sdrh ** NULL.  If a memory allocation fails, the pParse->db->mallocFailed flag
1158b7916a78Sdrh ** is set.
1159b7916a78Sdrh */
1160b7916a78Sdrh void sqlite3ExprListSetSpan(
1161b7916a78Sdrh   Parse *pParse,          /* Parsing context */
1162b7916a78Sdrh   ExprList *pList,        /* List to which to add the span. */
1163b7916a78Sdrh   ExprSpan *pSpan         /* The span to be added */
1164b7916a78Sdrh ){
1165b7916a78Sdrh   sqlite3 *db = pParse->db;
1166b7916a78Sdrh   assert( pList!=0 || db->mallocFailed!=0 );
1167b7916a78Sdrh   if( pList ){
1168b7916a78Sdrh     struct ExprList_item *pItem = &pList->a[pList->nExpr-1];
1169b7916a78Sdrh     assert( pList->nExpr>0 );
1170b7916a78Sdrh     assert( db->mallocFailed || pItem->pExpr==pSpan->pExpr );
1171b7916a78Sdrh     sqlite3DbFree(db, pItem->zSpan);
1172b7916a78Sdrh     pItem->zSpan = sqlite3DbStrNDup(db, (char*)pSpan->zStart,
1173cf697396Sshane                                     (int)(pSpan->zEnd - pSpan->zStart));
1174b7916a78Sdrh   }
1175b7916a78Sdrh }
1176b7916a78Sdrh 
1177b7916a78Sdrh /*
11787a15a4beSdanielk1977 ** If the expression list pEList contains more than iLimit elements,
11797a15a4beSdanielk1977 ** leave an error message in pParse.
11807a15a4beSdanielk1977 */
11817a15a4beSdanielk1977 void sqlite3ExprListCheckLength(
11827a15a4beSdanielk1977   Parse *pParse,
11837a15a4beSdanielk1977   ExprList *pEList,
11847a15a4beSdanielk1977   const char *zObject
11857a15a4beSdanielk1977 ){
1186b1a6c3c1Sdrh   int mx = pParse->db->aLimit[SQLITE_LIMIT_COLUMN];
1187c5499befSdrh   testcase( pEList && pEList->nExpr==mx );
1188c5499befSdrh   testcase( pEList && pEList->nExpr==mx+1 );
1189b1a6c3c1Sdrh   if( pEList && pEList->nExpr>mx ){
11907a15a4beSdanielk1977     sqlite3ErrorMsg(pParse, "too many columns in %s", zObject);
11917a15a4beSdanielk1977   }
11927a15a4beSdanielk1977 }
11937a15a4beSdanielk1977 
11947a15a4beSdanielk1977 /*
1195a76b5dfcSdrh ** Delete an entire expression list.
1196a76b5dfcSdrh */
1197633e6d57Sdrh void sqlite3ExprListDelete(sqlite3 *db, ExprList *pList){
1198a76b5dfcSdrh   int i;
1199be5c89acSdrh   struct ExprList_item *pItem;
1200a76b5dfcSdrh   if( pList==0 ) return;
1201d872bb18Sdrh   assert( pList->a!=0 || pList->nExpr==0 );
1202be5c89acSdrh   for(pItem=pList->a, i=0; i<pList->nExpr; i++, pItem++){
1203633e6d57Sdrh     sqlite3ExprDelete(db, pItem->pExpr);
1204633e6d57Sdrh     sqlite3DbFree(db, pItem->zName);
1205b7916a78Sdrh     sqlite3DbFree(db, pItem->zSpan);
1206a76b5dfcSdrh   }
1207633e6d57Sdrh   sqlite3DbFree(db, pList->a);
1208633e6d57Sdrh   sqlite3DbFree(db, pList);
1209a76b5dfcSdrh }
1210a76b5dfcSdrh 
1211a76b5dfcSdrh /*
12127d10d5a6Sdrh ** These routines are Walker callbacks.  Walker.u.pi is a pointer
12137d10d5a6Sdrh ** to an integer.  These routines are checking an expression to see
12147d10d5a6Sdrh ** if it is a constant.  Set *Walker.u.pi to 0 if the expression is
12157d10d5a6Sdrh ** not constant.
121673b211abSdrh **
12177d10d5a6Sdrh ** These callback routines are used to implement the following:
1218626a879aSdrh **
12197d10d5a6Sdrh **     sqlite3ExprIsConstant()
12207d10d5a6Sdrh **     sqlite3ExprIsConstantNotJoin()
12217d10d5a6Sdrh **     sqlite3ExprIsConstantOrFunction()
122287abf5c0Sdrh **
1223626a879aSdrh */
12247d10d5a6Sdrh static int exprNodeIsConstant(Walker *pWalker, Expr *pExpr){
1225626a879aSdrh 
12267d10d5a6Sdrh   /* If pWalker->u.i is 3 then any term of the expression that comes from
12270a168377Sdrh   ** the ON or USING clauses of a join disqualifies the expression
12280a168377Sdrh   ** from being considered constant. */
1229c5cd1249Sdrh   if( pWalker->u.i==3 && ExprHasProperty(pExpr, EP_FromJoin) ){
12307d10d5a6Sdrh     pWalker->u.i = 0;
12317d10d5a6Sdrh     return WRC_Abort;
12320a168377Sdrh   }
12330a168377Sdrh 
1234626a879aSdrh   switch( pExpr->op ){
1235eb55bd2fSdrh     /* Consider functions to be constant if all their arguments are constant
1236b1fba286Sdrh     ** and either pWalker->u.i==2 or the function as the SQLITE_FUNC_CONST
1237b1fba286Sdrh     ** flag. */
1238eb55bd2fSdrh     case TK_FUNCTION:
1239b1fba286Sdrh       if( pWalker->u.i==2 || ExprHasProperty(pExpr,EP_Constant) ){
1240b1fba286Sdrh         return WRC_Continue;
1241b1fba286Sdrh       }
1242eb55bd2fSdrh       /* Fall through */
1243626a879aSdrh     case TK_ID:
1244626a879aSdrh     case TK_COLUMN:
1245626a879aSdrh     case TK_AGG_FUNCTION:
124613449892Sdrh     case TK_AGG_COLUMN:
1247c5499befSdrh       testcase( pExpr->op==TK_ID );
1248c5499befSdrh       testcase( pExpr->op==TK_COLUMN );
1249c5499befSdrh       testcase( pExpr->op==TK_AGG_FUNCTION );
1250c5499befSdrh       testcase( pExpr->op==TK_AGG_COLUMN );
12517d10d5a6Sdrh       pWalker->u.i = 0;
12527d10d5a6Sdrh       return WRC_Abort;
1253626a879aSdrh     default:
1254b74b1017Sdrh       testcase( pExpr->op==TK_SELECT ); /* selectNodeIsConstant will disallow */
1255b74b1017Sdrh       testcase( pExpr->op==TK_EXISTS ); /* selectNodeIsConstant will disallow */
12567d10d5a6Sdrh       return WRC_Continue;
1257626a879aSdrh   }
1258626a879aSdrh }
125962c14b34Sdanielk1977 static int selectNodeIsConstant(Walker *pWalker, Select *NotUsed){
126062c14b34Sdanielk1977   UNUSED_PARAMETER(NotUsed);
12617d10d5a6Sdrh   pWalker->u.i = 0;
12627d10d5a6Sdrh   return WRC_Abort;
12637d10d5a6Sdrh }
12647d10d5a6Sdrh static int exprIsConst(Expr *p, int initFlag){
12657d10d5a6Sdrh   Walker w;
1266aa87f9a6Sdrh   memset(&w, 0, sizeof(w));
12677d10d5a6Sdrh   w.u.i = initFlag;
12687d10d5a6Sdrh   w.xExprCallback = exprNodeIsConstant;
12697d10d5a6Sdrh   w.xSelectCallback = selectNodeIsConstant;
12707d10d5a6Sdrh   sqlite3WalkExpr(&w, p);
12717d10d5a6Sdrh   return w.u.i;
12727d10d5a6Sdrh }
1273626a879aSdrh 
1274626a879aSdrh /*
1275fef5208cSdrh ** Walk an expression tree.  Return 1 if the expression is constant
1276eb55bd2fSdrh ** and 0 if it involves variables or function calls.
12772398937bSdrh **
12782398937bSdrh ** For the purposes of this function, a double-quoted string (ex: "abc")
12792398937bSdrh ** is considered a variable but a single-quoted string (ex: 'abc') is
12802398937bSdrh ** a constant.
1281fef5208cSdrh */
12824adee20fSdanielk1977 int sqlite3ExprIsConstant(Expr *p){
12837d10d5a6Sdrh   return exprIsConst(p, 1);
1284fef5208cSdrh }
1285fef5208cSdrh 
1286fef5208cSdrh /*
1287eb55bd2fSdrh ** Walk an expression tree.  Return 1 if the expression is constant
12880a168377Sdrh ** that does no originate from the ON or USING clauses of a join.
12890a168377Sdrh ** Return 0 if it involves variables or function calls or terms from
12900a168377Sdrh ** an ON or USING clause.
12910a168377Sdrh */
12920a168377Sdrh int sqlite3ExprIsConstantNotJoin(Expr *p){
12937d10d5a6Sdrh   return exprIsConst(p, 3);
12940a168377Sdrh }
12950a168377Sdrh 
12960a168377Sdrh /*
12970a168377Sdrh ** Walk an expression tree.  Return 1 if the expression is constant
1298eb55bd2fSdrh ** or a function call with constant arguments.  Return and 0 if there
1299eb55bd2fSdrh ** are any variables.
1300eb55bd2fSdrh **
1301eb55bd2fSdrh ** For the purposes of this function, a double-quoted string (ex: "abc")
1302eb55bd2fSdrh ** is considered a variable but a single-quoted string (ex: 'abc') is
1303eb55bd2fSdrh ** a constant.
1304eb55bd2fSdrh */
1305eb55bd2fSdrh int sqlite3ExprIsConstantOrFunction(Expr *p){
13067d10d5a6Sdrh   return exprIsConst(p, 2);
1307eb55bd2fSdrh }
1308eb55bd2fSdrh 
1309eb55bd2fSdrh /*
131073b211abSdrh ** If the expression p codes a constant integer that is small enough
1311202b2df7Sdrh ** to fit in a 32-bit integer, return 1 and put the value of the integer
1312202b2df7Sdrh ** in *pValue.  If the expression is not an integer or if it is too big
1313202b2df7Sdrh ** to fit in a signed 32-bit integer, return 0 and leave *pValue unchanged.
1314e4de1febSdrh */
13154adee20fSdanielk1977 int sqlite3ExprIsInteger(Expr *p, int *pValue){
131692b01d53Sdrh   int rc = 0;
1317cd92e84dSdrh 
1318cd92e84dSdrh   /* If an expression is an integer literal that fits in a signed 32-bit
1319cd92e84dSdrh   ** integer, then the EP_IntValue flag will have already been set */
1320cd92e84dSdrh   assert( p->op!=TK_INTEGER || (p->flags & EP_IntValue)!=0
1321cd92e84dSdrh            || sqlite3GetInt32(p->u.zToken, &rc)==0 );
1322cd92e84dSdrh 
132392b01d53Sdrh   if( p->flags & EP_IntValue ){
132433e619fcSdrh     *pValue = p->u.iValue;
1325e4de1febSdrh     return 1;
1326e4de1febSdrh   }
132792b01d53Sdrh   switch( p->op ){
13284b59ab5eSdrh     case TK_UPLUS: {
132992b01d53Sdrh       rc = sqlite3ExprIsInteger(p->pLeft, pValue);
1330f6e369a1Sdrh       break;
13314b59ab5eSdrh     }
1332e4de1febSdrh     case TK_UMINUS: {
1333e4de1febSdrh       int v;
13344adee20fSdanielk1977       if( sqlite3ExprIsInteger(p->pLeft, &v) ){
1335f6418891Smistachkin         assert( v!=(-2147483647-1) );
1336e4de1febSdrh         *pValue = -v;
133792b01d53Sdrh         rc = 1;
1338e4de1febSdrh       }
1339e4de1febSdrh       break;
1340e4de1febSdrh     }
1341e4de1febSdrh     default: break;
1342e4de1febSdrh   }
134392b01d53Sdrh   return rc;
1344e4de1febSdrh }
1345e4de1febSdrh 
1346e4de1febSdrh /*
1347039fc32eSdrh ** Return FALSE if there is no chance that the expression can be NULL.
1348039fc32eSdrh **
1349039fc32eSdrh ** If the expression might be NULL or if the expression is too complex
1350039fc32eSdrh ** to tell return TRUE.
1351039fc32eSdrh **
1352039fc32eSdrh ** This routine is used as an optimization, to skip OP_IsNull opcodes
1353039fc32eSdrh ** when we know that a value cannot be NULL.  Hence, a false positive
1354039fc32eSdrh ** (returning TRUE when in fact the expression can never be NULL) might
1355039fc32eSdrh ** be a small performance hit but is otherwise harmless.  On the other
1356039fc32eSdrh ** hand, a false negative (returning FALSE when the result could be NULL)
1357039fc32eSdrh ** will likely result in an incorrect answer.  So when in doubt, return
1358039fc32eSdrh ** TRUE.
1359039fc32eSdrh */
1360039fc32eSdrh int sqlite3ExprCanBeNull(const Expr *p){
1361039fc32eSdrh   u8 op;
1362cd7f457eSdrh   while( p->op==TK_UPLUS || p->op==TK_UMINUS ){ p = p->pLeft; }
1363039fc32eSdrh   op = p->op;
1364039fc32eSdrh   if( op==TK_REGISTER ) op = p->op2;
1365039fc32eSdrh   switch( op ){
1366039fc32eSdrh     case TK_INTEGER:
1367039fc32eSdrh     case TK_STRING:
1368039fc32eSdrh     case TK_FLOAT:
1369039fc32eSdrh     case TK_BLOB:
1370039fc32eSdrh       return 0;
1371039fc32eSdrh     default:
1372039fc32eSdrh       return 1;
1373039fc32eSdrh   }
1374039fc32eSdrh }
1375039fc32eSdrh 
1376039fc32eSdrh /*
1377039fc32eSdrh ** Return TRUE if the given expression is a constant which would be
1378039fc32eSdrh ** unchanged by OP_Affinity with the affinity given in the second
1379039fc32eSdrh ** argument.
1380039fc32eSdrh **
1381039fc32eSdrh ** This routine is used to determine if the OP_Affinity operation
1382039fc32eSdrh ** can be omitted.  When in doubt return FALSE.  A false negative
1383039fc32eSdrh ** is harmless.  A false positive, however, can result in the wrong
1384039fc32eSdrh ** answer.
1385039fc32eSdrh */
1386039fc32eSdrh int sqlite3ExprNeedsNoAffinityChange(const Expr *p, char aff){
1387039fc32eSdrh   u8 op;
1388039fc32eSdrh   if( aff==SQLITE_AFF_NONE ) return 1;
1389cd7f457eSdrh   while( p->op==TK_UPLUS || p->op==TK_UMINUS ){ p = p->pLeft; }
1390039fc32eSdrh   op = p->op;
1391039fc32eSdrh   if( op==TK_REGISTER ) op = p->op2;
1392039fc32eSdrh   switch( op ){
1393039fc32eSdrh     case TK_INTEGER: {
1394039fc32eSdrh       return aff==SQLITE_AFF_INTEGER || aff==SQLITE_AFF_NUMERIC;
1395039fc32eSdrh     }
1396039fc32eSdrh     case TK_FLOAT: {
1397039fc32eSdrh       return aff==SQLITE_AFF_REAL || aff==SQLITE_AFF_NUMERIC;
1398039fc32eSdrh     }
1399039fc32eSdrh     case TK_STRING: {
1400039fc32eSdrh       return aff==SQLITE_AFF_TEXT;
1401039fc32eSdrh     }
1402039fc32eSdrh     case TK_BLOB: {
1403039fc32eSdrh       return 1;
1404039fc32eSdrh     }
14052f2855b6Sdrh     case TK_COLUMN: {
140688376ca7Sdrh       assert( p->iTable>=0 );  /* p cannot be part of a CHECK constraint */
140788376ca7Sdrh       return p->iColumn<0
14082f2855b6Sdrh           && (aff==SQLITE_AFF_INTEGER || aff==SQLITE_AFF_NUMERIC);
14092f2855b6Sdrh     }
1410039fc32eSdrh     default: {
1411039fc32eSdrh       return 0;
1412039fc32eSdrh     }
1413039fc32eSdrh   }
1414039fc32eSdrh }
1415039fc32eSdrh 
1416039fc32eSdrh /*
1417c4a3c779Sdrh ** Return TRUE if the given string is a row-id column name.
1418c4a3c779Sdrh */
14194adee20fSdanielk1977 int sqlite3IsRowid(const char *z){
14204adee20fSdanielk1977   if( sqlite3StrICmp(z, "_ROWID_")==0 ) return 1;
14214adee20fSdanielk1977   if( sqlite3StrICmp(z, "ROWID")==0 ) return 1;
14224adee20fSdanielk1977   if( sqlite3StrICmp(z, "OID")==0 ) return 1;
1423c4a3c779Sdrh   return 0;
1424c4a3c779Sdrh }
1425c4a3c779Sdrh 
14269a96b668Sdanielk1977 /*
1427b74b1017Sdrh ** Return true if we are able to the IN operator optimization on a
1428b74b1017Sdrh ** query of the form
1429b287f4b6Sdrh **
1430b74b1017Sdrh **       x IN (SELECT ...)
1431b287f4b6Sdrh **
1432b74b1017Sdrh ** Where the SELECT... clause is as specified by the parameter to this
1433b74b1017Sdrh ** routine.
1434b74b1017Sdrh **
1435b74b1017Sdrh ** The Select object passed in has already been preprocessed and no
1436b74b1017Sdrh ** errors have been found.
1437b287f4b6Sdrh */
1438b287f4b6Sdrh #ifndef SQLITE_OMIT_SUBQUERY
1439b287f4b6Sdrh static int isCandidateForInOpt(Select *p){
1440b287f4b6Sdrh   SrcList *pSrc;
1441b287f4b6Sdrh   ExprList *pEList;
1442b287f4b6Sdrh   Table *pTab;
1443b287f4b6Sdrh   if( p==0 ) return 0;                   /* right-hand side of IN is SELECT */
1444b287f4b6Sdrh   if( p->pPrior ) return 0;              /* Not a compound SELECT */
14457d10d5a6Sdrh   if( p->selFlags & (SF_Distinct|SF_Aggregate) ){
1446b74b1017Sdrh     testcase( (p->selFlags & (SF_Distinct|SF_Aggregate))==SF_Distinct );
1447b74b1017Sdrh     testcase( (p->selFlags & (SF_Distinct|SF_Aggregate))==SF_Aggregate );
14487d10d5a6Sdrh     return 0; /* No DISTINCT keyword and no aggregate functions */
14497d10d5a6Sdrh   }
1450b74b1017Sdrh   assert( p->pGroupBy==0 );              /* Has no GROUP BY clause */
1451b287f4b6Sdrh   if( p->pLimit ) return 0;              /* Has no LIMIT clause */
1452b74b1017Sdrh   assert( p->pOffset==0 );               /* No LIMIT means no OFFSET */
1453b287f4b6Sdrh   if( p->pWhere ) return 0;              /* Has no WHERE clause */
1454b287f4b6Sdrh   pSrc = p->pSrc;
1455d1fa7bcaSdrh   assert( pSrc!=0 );
1456d1fa7bcaSdrh   if( pSrc->nSrc!=1 ) return 0;          /* Single term in FROM clause */
1457b74b1017Sdrh   if( pSrc->a[0].pSelect ) return 0;     /* FROM is not a subquery or view */
1458b287f4b6Sdrh   pTab = pSrc->a[0].pTab;
1459b74b1017Sdrh   if( NEVER(pTab==0) ) return 0;
1460b74b1017Sdrh   assert( pTab->pSelect==0 );            /* FROM clause is not a view */
1461b287f4b6Sdrh   if( IsVirtual(pTab) ) return 0;        /* FROM clause not a virtual table */
1462b287f4b6Sdrh   pEList = p->pEList;
1463b287f4b6Sdrh   if( pEList->nExpr!=1 ) return 0;       /* One column in the result set */
1464b287f4b6Sdrh   if( pEList->a[0].pExpr->op!=TK_COLUMN ) return 0; /* Result is a column */
1465b287f4b6Sdrh   return 1;
1466b287f4b6Sdrh }
1467b287f4b6Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
1468b287f4b6Sdrh 
1469b287f4b6Sdrh /*
14701d8cb21fSdan ** Code an OP_Once instruction and allocate space for its flag. Return the
14711d8cb21fSdan ** address of the new instruction.
14721d8cb21fSdan */
14731d8cb21fSdan int sqlite3CodeOnce(Parse *pParse){
14741d8cb21fSdan   Vdbe *v = sqlite3GetVdbe(pParse);      /* Virtual machine being coded */
14757d176105Sdrh   return sqlite3VdbeAddOp1(v, OP_Once, pParse->nOnce++);
14761d8cb21fSdan }
14771d8cb21fSdan 
14781d8cb21fSdan /*
14794c259e9fSdrh ** Generate code that checks the left-most column of index table iCur to see if
14804c259e9fSdrh ** it contains any NULL entries.  Cause the register at regHasNull to be set
14816be515ebSdrh ** to a non-NULL value if iCur contains no NULLs.  Cause register regHasNull
14826be515ebSdrh ** to be set to NULL if iCur contains one or more NULL values.
14836be515ebSdrh */
14846be515ebSdrh static void sqlite3SetHasNullFlag(Vdbe *v, int iCur, int regHasNull){
14856be515ebSdrh   int j1;
14866be515ebSdrh   sqlite3VdbeAddOp2(v, OP_Integer, 0, regHasNull);
14876be515ebSdrh   j1 = sqlite3VdbeAddOp1(v, OP_Rewind, iCur); VdbeCoverage(v);
14886be515ebSdrh   sqlite3VdbeAddOp3(v, OP_Column, iCur, 0, regHasNull);
14896be515ebSdrh   sqlite3VdbeChangeP5(v, OPFLAG_TYPEOFARG);
14904c259e9fSdrh   VdbeComment((v, "first_entry_in(%d)", iCur));
14916be515ebSdrh   sqlite3VdbeJumpHere(v, j1);
14926be515ebSdrh }
14936be515ebSdrh 
1494*bb53ecb1Sdrh 
1495*bb53ecb1Sdrh #ifndef SQLITE_OMIT_SUBQUERY
1496*bb53ecb1Sdrh /*
1497*bb53ecb1Sdrh ** The argument is an IN operator with a list (not a subquery) on the
1498*bb53ecb1Sdrh ** right-hand side.  Return TRUE if that list is constant.
1499*bb53ecb1Sdrh */
1500*bb53ecb1Sdrh static int sqlite3InRhsIsConstant(Expr *pIn){
1501*bb53ecb1Sdrh   Expr *pLHS;
1502*bb53ecb1Sdrh   int res;
1503*bb53ecb1Sdrh   assert( !ExprHasProperty(pIn, EP_xIsSelect) );
1504*bb53ecb1Sdrh   pLHS = pIn->pLeft;
1505*bb53ecb1Sdrh   pIn->pLeft = 0;
1506*bb53ecb1Sdrh   res = sqlite3ExprIsConstant(pIn);
1507*bb53ecb1Sdrh   pIn->pLeft = pLHS;
1508*bb53ecb1Sdrh   return res;
1509*bb53ecb1Sdrh }
1510*bb53ecb1Sdrh #endif
1511*bb53ecb1Sdrh 
15126be515ebSdrh /*
15139a96b668Sdanielk1977 ** This function is used by the implementation of the IN (...) operator.
1514d4305ca6Sdrh ** The pX parameter is the expression on the RHS of the IN operator, which
1515d4305ca6Sdrh ** might be either a list of expressions or a subquery.
15169a96b668Sdanielk1977 **
1517d4305ca6Sdrh ** The job of this routine is to find or create a b-tree object that can
1518d4305ca6Sdrh ** be used either to test for membership in the RHS set or to iterate through
1519d4305ca6Sdrh ** all members of the RHS set, skipping duplicates.
1520d4305ca6Sdrh **
15213a85625dSdrh ** A cursor is opened on the b-tree object that is the RHS of the IN operator
1522d4305ca6Sdrh ** and pX->iTable is set to the index of that cursor.
1523d4305ca6Sdrh **
1524b74b1017Sdrh ** The returned value of this function indicates the b-tree type, as follows:
15259a96b668Sdanielk1977 **
15269a96b668Sdanielk1977 **   IN_INDEX_ROWID      - The cursor was opened on a database table.
15271ccce449Sdrh **   IN_INDEX_INDEX_ASC  - The cursor was opened on an ascending index.
15281ccce449Sdrh **   IN_INDEX_INDEX_DESC - The cursor was opened on a descending index.
15299a96b668Sdanielk1977 **   IN_INDEX_EPH        - The cursor was opened on a specially created and
15309a96b668Sdanielk1977 **                         populated epheremal table.
1531*bb53ecb1Sdrh **   IN_INDEX_NOOP       - No cursor was allocated.  The IN operator must be
1532*bb53ecb1Sdrh **                         implemented as a sequence of comparisons.
15339a96b668Sdanielk1977 **
1534d4305ca6Sdrh ** An existing b-tree might be used if the RHS expression pX is a simple
1535d4305ca6Sdrh ** subquery such as:
15369a96b668Sdanielk1977 **
15379a96b668Sdanielk1977 **     SELECT <column> FROM <table>
15389a96b668Sdanielk1977 **
1539d4305ca6Sdrh ** If the RHS of the IN operator is a list or a more complex subquery, then
1540d4305ca6Sdrh ** an ephemeral table might need to be generated from the RHS and then
1541d4305ca6Sdrh ** pX->iTable made to point to the ephermeral table instead of an
1542d4305ca6Sdrh ** existing table.
1543d4305ca6Sdrh **
15443a85625dSdrh ** The inFlags parameter must contain exactly one of the bits
15453a85625dSdrh ** IN_INDEX_MEMBERSHIP or IN_INDEX_LOOP.  If inFlags contains
15463a85625dSdrh ** IN_INDEX_MEMBERSHIP, then the generated table will be used for a
15473a85625dSdrh ** fast membership test.  When the IN_INDEX_LOOP bit is set, the
15483a85625dSdrh ** IN index will be used to loop over all values of the RHS of the
15493a85625dSdrh ** IN operator.
15503a85625dSdrh **
15513a85625dSdrh ** When IN_INDEX_LOOP is used (and the b-tree will be used to iterate
15523a85625dSdrh ** through the set members) then the b-tree must not contain duplicates.
15533a85625dSdrh ** An epheremal table must be used unless the selected <column> is guaranteed
15549a96b668Sdanielk1977 ** to be unique - either because it is an INTEGER PRIMARY KEY or it
1555b74b1017Sdrh ** has a UNIQUE constraint or UNIQUE index.
15560cdc022eSdanielk1977 **
15573a85625dSdrh ** When IN_INDEX_MEMBERSHIP is used (and the b-tree will be used
15583a85625dSdrh ** for fast set membership tests) then an epheremal table must
15590cdc022eSdanielk1977 ** be used unless <column> is an INTEGER PRIMARY KEY or an index can
15600cdc022eSdanielk1977 ** be found with <column> as its left-most column.
15610cdc022eSdanielk1977 **
1562*bb53ecb1Sdrh ** If the IN_INDEX_NOOP_OK and IN_INDEX_MEMBERSHIP are both set and
1563*bb53ecb1Sdrh ** if the RHS of the IN operator is a list (not a subquery) then this
1564*bb53ecb1Sdrh ** routine might decide that creating an ephemeral b-tree for membership
1565*bb53ecb1Sdrh ** testing is too expensive and return IN_INDEX_NOOP.  In that case, the
1566*bb53ecb1Sdrh ** calling routine should implement the IN operator using a sequence
1567*bb53ecb1Sdrh ** of Eq or Ne comparison operations.
1568*bb53ecb1Sdrh **
1569b74b1017Sdrh ** When the b-tree is being used for membership tests, the calling function
15703a85625dSdrh ** might need to know whether or not the RHS side of the IN operator
1571e21a6e1dSdrh ** contains a NULL.  If prRhsHasNull is not a NULL pointer and
15723a85625dSdrh ** if there is any chance that the (...) might contain a NULL value at
15730cdc022eSdanielk1977 ** runtime, then a register is allocated and the register number written
1574e21a6e1dSdrh ** to *prRhsHasNull. If there is no chance that the (...) contains a
1575e21a6e1dSdrh ** NULL value, then *prRhsHasNull is left unchanged.
15760cdc022eSdanielk1977 **
1577e21a6e1dSdrh ** If a register is allocated and its location stored in *prRhsHasNull, then
15786be515ebSdrh ** the value in that register will be NULL if the b-tree contains one or more
15796be515ebSdrh ** NULL values, and it will be some non-NULL value if the b-tree contains no
15806be515ebSdrh ** NULL values.
15819a96b668Sdanielk1977 */
1582284f4acaSdanielk1977 #ifndef SQLITE_OMIT_SUBQUERY
1583e21a6e1dSdrh int sqlite3FindInIndex(Parse *pParse, Expr *pX, u32 inFlags, int *prRhsHasNull){
1584b74b1017Sdrh   Select *p;                            /* SELECT to the right of IN operator */
1585b74b1017Sdrh   int eType = 0;                        /* Type of RHS table. IN_INDEX_* */
1586b74b1017Sdrh   int iTab = pParse->nTab++;            /* Cursor of the RHS table */
15873a85625dSdrh   int mustBeUnique;                     /* True if RHS must be unique */
1588b8475df8Sdrh   Vdbe *v = sqlite3GetVdbe(pParse);     /* Virtual machine being coded */
15899a96b668Sdanielk1977 
15901450bc6eSdrh   assert( pX->op==TK_IN );
15913a85625dSdrh   mustBeUnique = (inFlags & IN_INDEX_LOOP)!=0;
15921450bc6eSdrh 
1593b74b1017Sdrh   /* Check to see if an existing table or index can be used to
1594b74b1017Sdrh   ** satisfy the query.  This is preferable to generating a new
1595b74b1017Sdrh   ** ephemeral table.
15969a96b668Sdanielk1977   */
15976ab3a2ecSdanielk1977   p = (ExprHasProperty(pX, EP_xIsSelect) ? pX->x.pSelect : 0);
1598fd773cf9Sdrh   if( ALWAYS(pParse->nErr==0) && isCandidateForInOpt(p) ){
1599e1fb65a0Sdanielk1977     sqlite3 *db = pParse->db;              /* Database connection */
1600b07028f7Sdrh     Table *pTab;                           /* Table <table>. */
1601b07028f7Sdrh     Expr *pExpr;                           /* Expression <column> */
1602bbbdc83bSdrh     i16 iCol;                              /* Index of column <column> */
1603bbbdc83bSdrh     i16 iDb;                               /* Database idx for pTab */
1604e1fb65a0Sdanielk1977 
1605b07028f7Sdrh     assert( p );                        /* Because of isCandidateForInOpt(p) */
1606b07028f7Sdrh     assert( p->pEList!=0 );             /* Because of isCandidateForInOpt(p) */
1607b07028f7Sdrh     assert( p->pEList->a[0].pExpr!=0 ); /* Because of isCandidateForInOpt(p) */
1608b07028f7Sdrh     assert( p->pSrc!=0 );               /* Because of isCandidateForInOpt(p) */
1609b07028f7Sdrh     pTab = p->pSrc->a[0].pTab;
1610b07028f7Sdrh     pExpr = p->pEList->a[0].pExpr;
1611bbbdc83bSdrh     iCol = (i16)pExpr->iColumn;
1612b07028f7Sdrh 
1613b22f7c83Sdrh     /* Code an OP_Transaction and OP_TableLock for <table>. */
1614e1fb65a0Sdanielk1977     iDb = sqlite3SchemaToIndex(db, pTab->pSchema);
1615e1fb65a0Sdanielk1977     sqlite3CodeVerifySchema(pParse, iDb);
1616e1fb65a0Sdanielk1977     sqlite3TableLock(pParse, iDb, pTab->tnum, 0, pTab->zName);
16179a96b668Sdanielk1977 
16189a96b668Sdanielk1977     /* This function is only called from two places. In both cases the vdbe
16199a96b668Sdanielk1977     ** has already been allocated. So assume sqlite3GetVdbe() is always
16209a96b668Sdanielk1977     ** successful here.
16219a96b668Sdanielk1977     */
16229a96b668Sdanielk1977     assert(v);
16239a96b668Sdanielk1977     if( iCol<0 ){
16247d176105Sdrh       int iAddr = sqlite3CodeOnce(pParse);
16257d176105Sdrh       VdbeCoverage(v);
16269a96b668Sdanielk1977 
16279a96b668Sdanielk1977       sqlite3OpenTable(pParse, iTab, iDb, pTab, OP_OpenRead);
16289a96b668Sdanielk1977       eType = IN_INDEX_ROWID;
16299a96b668Sdanielk1977 
16309a96b668Sdanielk1977       sqlite3VdbeJumpHere(v, iAddr);
16319a96b668Sdanielk1977     }else{
1632e1fb65a0Sdanielk1977       Index *pIdx;                         /* Iterator variable */
1633e1fb65a0Sdanielk1977 
16349a96b668Sdanielk1977       /* The collation sequence used by the comparison. If an index is to
16359a96b668Sdanielk1977       ** be used in place of a temp-table, it must be ordered according
1636e1fb65a0Sdanielk1977       ** to this collation sequence.  */
16379a96b668Sdanielk1977       CollSeq *pReq = sqlite3BinaryCompareCollSeq(pParse, pX->pLeft, pExpr);
16389a96b668Sdanielk1977 
16399a96b668Sdanielk1977       /* Check that the affinity that will be used to perform the
16409a96b668Sdanielk1977       ** comparison is the same as the affinity of the column. If
16419a96b668Sdanielk1977       ** it is not, it is not possible to use any index.
16429a96b668Sdanielk1977       */
1643dbaee5e3Sdrh       int affinity_ok = sqlite3IndexAffinityOk(pX, pTab->aCol[iCol].affinity);
16449a96b668Sdanielk1977 
16459a96b668Sdanielk1977       for(pIdx=pTab->pIndex; pIdx && eType==0 && affinity_ok; pIdx=pIdx->pNext){
16469a96b668Sdanielk1977         if( (pIdx->aiColumn[0]==iCol)
1647b74b1017Sdrh          && sqlite3FindCollSeq(db, ENC(db), pIdx->azColl[0], 0)==pReq
16485f1d1d9cSdrh          && (!mustBeUnique || (pIdx->nKeyCol==1 && IsUniqueIndex(pIdx)))
16499a96b668Sdanielk1977         ){
16507d176105Sdrh           int iAddr = sqlite3CodeOnce(pParse); VdbeCoverage(v);
16512ec2fb22Sdrh           sqlite3VdbeAddOp3(v, OP_OpenRead, iTab, pIdx->tnum, iDb);
16522ec2fb22Sdrh           sqlite3VdbeSetP4KeyInfo(pParse, pIdx);
1653207872a4Sdanielk1977           VdbeComment((v, "%s", pIdx->zName));
16541ccce449Sdrh           assert( IN_INDEX_INDEX_DESC == IN_INDEX_INDEX_ASC+1 );
16551ccce449Sdrh           eType = IN_INDEX_INDEX_ASC + pIdx->aSortOrder[0];
16569a96b668Sdanielk1977 
1657e21a6e1dSdrh           if( prRhsHasNull && !pTab->aCol[iCol].notNull ){
1658e21a6e1dSdrh             *prRhsHasNull = ++pParse->nMem;
16596be515ebSdrh             sqlite3SetHasNullFlag(v, iTab, *prRhsHasNull);
16600cdc022eSdanielk1977           }
1661552fd454Sdrh           sqlite3VdbeJumpHere(v, iAddr);
16629a96b668Sdanielk1977         }
16639a96b668Sdanielk1977       }
16649a96b668Sdanielk1977     }
16659a96b668Sdanielk1977   }
16669a96b668Sdanielk1977 
1667*bb53ecb1Sdrh   /* If no preexisting index is available for the IN clause
1668*bb53ecb1Sdrh   ** and IN_INDEX_NOOP is an allowed reply
1669*bb53ecb1Sdrh   ** and the RHS of the IN operator is a list, not a subquery
1670*bb53ecb1Sdrh   ** and the RHS is not contant or has two or fewer terms,
1671*bb53ecb1Sdrh   ** then it is not worth creating an ephermeral table to evaluate
1672*bb53ecb1Sdrh   ** the IN operator so return IN_INDEX_NOOP.
1673*bb53ecb1Sdrh   */
1674*bb53ecb1Sdrh   if( eType==0
1675*bb53ecb1Sdrh    && (inFlags & IN_INDEX_NOOP_OK)
1676*bb53ecb1Sdrh    && !ExprHasProperty(pX, EP_xIsSelect)
1677*bb53ecb1Sdrh    && (!sqlite3InRhsIsConstant(pX) || pX->x.pList->nExpr<=2)
1678*bb53ecb1Sdrh   ){
1679*bb53ecb1Sdrh     eType = IN_INDEX_NOOP;
1680*bb53ecb1Sdrh   }
1681*bb53ecb1Sdrh 
1682*bb53ecb1Sdrh 
16839a96b668Sdanielk1977   if( eType==0 ){
16844387006cSdrh     /* Could not find an existing table or index to use as the RHS b-tree.
1685b74b1017Sdrh     ** We will have to generate an ephemeral table to do the job.
1686b74b1017Sdrh     */
16878e23daf3Sdrh     u32 savedNQueryLoop = pParse->nQueryLoop;
16880cdc022eSdanielk1977     int rMayHaveNull = 0;
168941a05b7bSdanielk1977     eType = IN_INDEX_EPH;
16903a85625dSdrh     if( inFlags & IN_INDEX_LOOP ){
16914a5acf8eSdrh       pParse->nQueryLoop = 0;
1692c5cd1249Sdrh       if( pX->pLeft->iColumn<0 && !ExprHasProperty(pX, EP_xIsSelect) ){
169341a05b7bSdanielk1977         eType = IN_INDEX_ROWID;
16940cdc022eSdanielk1977       }
1695e21a6e1dSdrh     }else if( prRhsHasNull ){
1696e21a6e1dSdrh       *prRhsHasNull = rMayHaveNull = ++pParse->nMem;
1697cf4d38aaSdrh     }
169841a05b7bSdanielk1977     sqlite3CodeSubselect(pParse, pX, rMayHaveNull, eType==IN_INDEX_ROWID);
1699cf4d38aaSdrh     pParse->nQueryLoop = savedNQueryLoop;
17009a96b668Sdanielk1977   }else{
17019a96b668Sdanielk1977     pX->iTable = iTab;
17029a96b668Sdanielk1977   }
17039a96b668Sdanielk1977   return eType;
17049a96b668Sdanielk1977 }
1705284f4acaSdanielk1977 #endif
1706626a879aSdrh 
1707626a879aSdrh /*
1708d4187c71Sdrh ** Generate code for scalar subqueries used as a subquery expression, EXISTS,
1709d4187c71Sdrh ** or IN operators.  Examples:
1710626a879aSdrh **
17119cbe6352Sdrh **     (SELECT a FROM b)          -- subquery
17129cbe6352Sdrh **     EXISTS (SELECT a FROM b)   -- EXISTS subquery
17139cbe6352Sdrh **     x IN (4,5,11)              -- IN operator with list on right-hand side
17149cbe6352Sdrh **     x IN (SELECT a FROM b)     -- IN operator with subquery on the right
1715fef5208cSdrh **
17169cbe6352Sdrh ** The pExpr parameter describes the expression that contains the IN
17179cbe6352Sdrh ** operator or subquery.
171841a05b7bSdanielk1977 **
171941a05b7bSdanielk1977 ** If parameter isRowid is non-zero, then expression pExpr is guaranteed
172041a05b7bSdanielk1977 ** to be of the form "<rowid> IN (?, ?, ?)", where <rowid> is a reference
172141a05b7bSdanielk1977 ** to some integer key column of a table B-Tree. In this case, use an
172241a05b7bSdanielk1977 ** intkey B-Tree to store the set of IN(...) values instead of the usual
172341a05b7bSdanielk1977 ** (slower) variable length keys B-Tree.
1724fd773cf9Sdrh **
1725fd773cf9Sdrh ** If rMayHaveNull is non-zero, that means that the operation is an IN
1726fd773cf9Sdrh ** (not a SELECT or EXISTS) and that the RHS might contains NULLs.
17273a85625dSdrh ** All this routine does is initialize the register given by rMayHaveNull
17283a85625dSdrh ** to NULL.  Calling routines will take care of changing this register
17293a85625dSdrh ** value to non-NULL if the RHS is NULL-free.
17301450bc6eSdrh **
17311450bc6eSdrh ** For a SELECT or EXISTS operator, return the register that holds the
17321450bc6eSdrh ** result.  For IN operators or if an error occurs, the return value is 0.
1733cce7d176Sdrh */
173451522cd3Sdrh #ifndef SQLITE_OMIT_SUBQUERY
17351450bc6eSdrh int sqlite3CodeSubselect(
1736fd773cf9Sdrh   Parse *pParse,          /* Parsing context */
1737fd773cf9Sdrh   Expr *pExpr,            /* The IN, SELECT, or EXISTS operator */
17386be515ebSdrh   int rHasNullFlag,       /* Register that records whether NULLs exist in RHS */
1739fd773cf9Sdrh   int isRowid             /* If true, LHS of IN operator is a rowid */
174041a05b7bSdanielk1977 ){
17416be515ebSdrh   int jmpIfDynamic = -1;                      /* One-time test address */
17421450bc6eSdrh   int rReg = 0;                           /* Register storing resulting */
1743b3bce662Sdanielk1977   Vdbe *v = sqlite3GetVdbe(pParse);
17441450bc6eSdrh   if( NEVER(v==0) ) return 0;
1745ceea3321Sdrh   sqlite3ExprCachePush(pParse);
1746fc976065Sdanielk1977 
174757dbd7b3Sdrh   /* This code must be run in its entirety every time it is encountered
174857dbd7b3Sdrh   ** if any of the following is true:
174957dbd7b3Sdrh   **
175057dbd7b3Sdrh   **    *  The right-hand side is a correlated subquery
175157dbd7b3Sdrh   **    *  The right-hand side is an expression list containing variables
175257dbd7b3Sdrh   **    *  We are inside a trigger
175357dbd7b3Sdrh   **
175457dbd7b3Sdrh   ** If all of the above are false, then we can run this code just once
175557dbd7b3Sdrh   ** save the results, and reuse the same result on subsequent invocations.
1756b3bce662Sdanielk1977   */
1757c5cd1249Sdrh   if( !ExprHasProperty(pExpr, EP_VarSelect) ){
17586be515ebSdrh     jmpIfDynamic = sqlite3CodeOnce(pParse); VdbeCoverage(v);
1759b3bce662Sdanielk1977   }
1760b3bce662Sdanielk1977 
17614a07e3dbSdan #ifndef SQLITE_OMIT_EXPLAIN
17624a07e3dbSdan   if( pParse->explain==2 ){
17634a07e3dbSdan     char *zMsg = sqlite3MPrintf(
17646be515ebSdrh         pParse->db, "EXECUTE %s%s SUBQUERY %d", jmpIfDynamic>=0?"":"CORRELATED ",
17654a07e3dbSdan         pExpr->op==TK_IN?"LIST":"SCALAR", pParse->iNextSelectId
17664a07e3dbSdan     );
17674a07e3dbSdan     sqlite3VdbeAddOp4(v, OP_Explain, pParse->iSelectId, 0, 0, zMsg, P4_DYNAMIC);
17684a07e3dbSdan   }
17694a07e3dbSdan #endif
17704a07e3dbSdan 
1771cce7d176Sdrh   switch( pExpr->op ){
1772fef5208cSdrh     case TK_IN: {
1773d4187c71Sdrh       char affinity;              /* Affinity of the LHS of the IN */
1774b9bb7c18Sdrh       int addr;                   /* Address of OP_OpenEphemeral instruction */
1775d4187c71Sdrh       Expr *pLeft = pExpr->pLeft; /* the LHS of the IN operator */
1776323df790Sdrh       KeyInfo *pKeyInfo = 0;      /* Key information */
1777d3d39e93Sdrh 
177841a05b7bSdanielk1977       affinity = sqlite3ExprAffinity(pLeft);
1779e014a838Sdanielk1977 
1780e014a838Sdanielk1977       /* Whether this is an 'x IN(SELECT...)' or an 'x IN(<exprlist>)'
17818cff69dfSdrh       ** expression it is handled the same way.  An ephemeral table is
1782e014a838Sdanielk1977       ** filled with single-field index keys representing the results
1783e014a838Sdanielk1977       ** from the SELECT or the <exprlist>.
1784fef5208cSdrh       **
1785e014a838Sdanielk1977       ** If the 'x' expression is a column value, or the SELECT...
1786e014a838Sdanielk1977       ** statement returns a column value, then the affinity of that
1787e014a838Sdanielk1977       ** column is used to build the index keys. If both 'x' and the
1788e014a838Sdanielk1977       ** SELECT... statement are columns, then numeric affinity is used
1789e014a838Sdanielk1977       ** if either column has NUMERIC or INTEGER affinity. If neither
1790e014a838Sdanielk1977       ** 'x' nor the SELECT... statement are columns, then numeric affinity
1791e014a838Sdanielk1977       ** is used.
1792fef5208cSdrh       */
1793832508b7Sdrh       pExpr->iTable = pParse->nTab++;
179441a05b7bSdanielk1977       addr = sqlite3VdbeAddOp2(v, OP_OpenEphemeral, pExpr->iTable, !isRowid);
1795ad124329Sdrh       pKeyInfo = isRowid ? 0 : sqlite3KeyInfoAlloc(pParse->db, 1, 1);
1796e014a838Sdanielk1977 
17976ab3a2ecSdanielk1977       if( ExprHasProperty(pExpr, EP_xIsSelect) ){
1798e014a838Sdanielk1977         /* Case 1:     expr IN (SELECT ...)
1799e014a838Sdanielk1977         **
1800e014a838Sdanielk1977         ** Generate code to write the results of the select into the temporary
1801e014a838Sdanielk1977         ** table allocated and opened above.
1802e014a838Sdanielk1977         */
18034387006cSdrh         Select *pSelect = pExpr->x.pSelect;
18041013c932Sdrh         SelectDest dest;
1805be5c89acSdrh         ExprList *pEList;
18061013c932Sdrh 
180741a05b7bSdanielk1977         assert( !isRowid );
18081013c932Sdrh         sqlite3SelectDestInit(&dest, SRT_Set, pExpr->iTable);
18092b596da8Sdrh         dest.affSdst = (u8)affinity;
1810e014a838Sdanielk1977         assert( (pExpr->iTable&0x0000FFFF)==pExpr->iTable );
18114387006cSdrh         pSelect->iLimit = 0;
18124387006cSdrh         testcase( pSelect->selFlags & SF_Distinct );
18134387006cSdrh         pSelect->selFlags &= ~SF_Distinct;
1814812ea833Sdrh         testcase( pKeyInfo==0 ); /* Caused by OOM in sqlite3KeyInfoAlloc() */
18154387006cSdrh         if( sqlite3Select(pParse, pSelect, &dest) ){
18162ec2fb22Sdrh           sqlite3KeyInfoUnref(pKeyInfo);
18171450bc6eSdrh           return 0;
181894ccde58Sdrh         }
18194387006cSdrh         pEList = pSelect->pEList;
1820812ea833Sdrh         assert( pKeyInfo!=0 ); /* OOM will cause exit after sqlite3Select() */
18213535ec3eSdrh         assert( pEList!=0 );
18223535ec3eSdrh         assert( pEList->nExpr>0 );
18232ec2fb22Sdrh         assert( sqlite3KeyInfoIsWriteable(pKeyInfo) );
1824323df790Sdrh         pKeyInfo->aColl[0] = sqlite3BinaryCompareCollSeq(pParse, pExpr->pLeft,
1825be5c89acSdrh                                                          pEList->a[0].pExpr);
1826a7d2db17Sdrh       }else if( ALWAYS(pExpr->x.pList!=0) ){
1827fef5208cSdrh         /* Case 2:     expr IN (exprlist)
1828fef5208cSdrh         **
1829e014a838Sdanielk1977         ** For each expression, build an index key from the evaluation and
1830e014a838Sdanielk1977         ** store it in the temporary table. If <expr> is a column, then use
1831e014a838Sdanielk1977         ** that columns affinity when building index keys. If <expr> is not
1832e014a838Sdanielk1977         ** a column, use numeric affinity.
1833fef5208cSdrh         */
1834e014a838Sdanielk1977         int i;
18356ab3a2ecSdanielk1977         ExprList *pList = pExpr->x.pList;
183657dbd7b3Sdrh         struct ExprList_item *pItem;
1837ecc31805Sdrh         int r1, r2, r3;
183857dbd7b3Sdrh 
1839e014a838Sdanielk1977         if( !affinity ){
18408159a35fSdrh           affinity = SQLITE_AFF_NONE;
1841e014a838Sdanielk1977         }
1842323df790Sdrh         if( pKeyInfo ){
18432ec2fb22Sdrh           assert( sqlite3KeyInfoIsWriteable(pKeyInfo) );
1844323df790Sdrh           pKeyInfo->aColl[0] = sqlite3ExprCollSeq(pParse, pExpr->pLeft);
1845323df790Sdrh         }
1846e014a838Sdanielk1977 
1847e014a838Sdanielk1977         /* Loop through each expression in <exprlist>. */
18482d401ab8Sdrh         r1 = sqlite3GetTempReg(pParse);
18492d401ab8Sdrh         r2 = sqlite3GetTempReg(pParse);
185037e08081Sdrh         if( isRowid ) sqlite3VdbeAddOp2(v, OP_Null, 0, r2);
185157dbd7b3Sdrh         for(i=pList->nExpr, pItem=pList->a; i>0; i--, pItem++){
185257dbd7b3Sdrh           Expr *pE2 = pItem->pExpr;
1853e05c929bSdrh           int iValToIns;
1854e014a838Sdanielk1977 
185557dbd7b3Sdrh           /* If the expression is not constant then we will need to
185657dbd7b3Sdrh           ** disable the test that was generated above that makes sure
185757dbd7b3Sdrh           ** this code only executes once.  Because for a non-constant
185857dbd7b3Sdrh           ** expression we need to rerun this code each time.
185957dbd7b3Sdrh           */
18606be515ebSdrh           if( jmpIfDynamic>=0 && !sqlite3ExprIsConstant(pE2) ){
18616be515ebSdrh             sqlite3VdbeChangeToNoop(v, jmpIfDynamic);
18626be515ebSdrh             jmpIfDynamic = -1;
18634794b980Sdrh           }
1864e014a838Sdanielk1977 
1865e014a838Sdanielk1977           /* Evaluate the expression and insert it into the temp table */
1866e05c929bSdrh           if( isRowid && sqlite3ExprIsInteger(pE2, &iValToIns) ){
1867e05c929bSdrh             sqlite3VdbeAddOp3(v, OP_InsertInt, pExpr->iTable, r2, iValToIns);
1868e05c929bSdrh           }else{
1869ecc31805Sdrh             r3 = sqlite3ExprCodeTarget(pParse, pE2, r1);
187041a05b7bSdanielk1977             if( isRowid ){
1871e05c929bSdrh               sqlite3VdbeAddOp2(v, OP_MustBeInt, r3,
1872e05c929bSdrh                                 sqlite3VdbeCurrentAddr(v)+2);
1873688852abSdrh               VdbeCoverage(v);
187441a05b7bSdanielk1977               sqlite3VdbeAddOp3(v, OP_Insert, pExpr->iTable, r2, r3);
187541a05b7bSdanielk1977             }else{
1876ecc31805Sdrh               sqlite3VdbeAddOp4(v, OP_MakeRecord, r3, 1, r2, &affinity, 1);
18773c31fc23Sdrh               sqlite3ExprCacheAffinityChange(pParse, r3, 1);
18782d401ab8Sdrh               sqlite3VdbeAddOp2(v, OP_IdxInsert, pExpr->iTable, r2);
1879fef5208cSdrh             }
188041a05b7bSdanielk1977           }
1881e05c929bSdrh         }
18822d401ab8Sdrh         sqlite3ReleaseTempReg(pParse, r1);
18832d401ab8Sdrh         sqlite3ReleaseTempReg(pParse, r2);
1884fef5208cSdrh       }
1885323df790Sdrh       if( pKeyInfo ){
18862ec2fb22Sdrh         sqlite3VdbeChangeP4(v, addr, (void *)pKeyInfo, P4_KEYINFO);
188741a05b7bSdanielk1977       }
1888b3bce662Sdanielk1977       break;
1889fef5208cSdrh     }
1890fef5208cSdrh 
189151522cd3Sdrh     case TK_EXISTS:
1892fd773cf9Sdrh     case TK_SELECT:
1893fd773cf9Sdrh     default: {
1894fd773cf9Sdrh       /* If this has to be a scalar SELECT.  Generate code to put the
1895fef5208cSdrh       ** value of this select in a memory cell and record the number
1896fd773cf9Sdrh       ** of the memory cell in iColumn.  If this is an EXISTS, write
1897fd773cf9Sdrh       ** an integer 0 (not exists) or 1 (exists) into a memory cell
1898fd773cf9Sdrh       ** and record that memory cell in iColumn.
1899fef5208cSdrh       */
1900fd773cf9Sdrh       Select *pSel;                         /* SELECT statement to encode */
1901fd773cf9Sdrh       SelectDest dest;                      /* How to deal with SELECt result */
19021398ad36Sdrh 
1903cf697396Sshane       testcase( pExpr->op==TK_EXISTS );
1904cf697396Sshane       testcase( pExpr->op==TK_SELECT );
1905cf697396Sshane       assert( pExpr->op==TK_EXISTS || pExpr->op==TK_SELECT );
1906cf697396Sshane 
19076ab3a2ecSdanielk1977       assert( ExprHasProperty(pExpr, EP_xIsSelect) );
19086ab3a2ecSdanielk1977       pSel = pExpr->x.pSelect;
19091013c932Sdrh       sqlite3SelectDestInit(&dest, 0, ++pParse->nMem);
191051522cd3Sdrh       if( pExpr->op==TK_SELECT ){
19116c8c8ce0Sdanielk1977         dest.eDest = SRT_Mem;
19122b596da8Sdrh         sqlite3VdbeAddOp2(v, OP_Null, 0, dest.iSDParm);
1913d4e70ebdSdrh         VdbeComment((v, "Init subquery result"));
191451522cd3Sdrh       }else{
19156c8c8ce0Sdanielk1977         dest.eDest = SRT_Exists;
19162b596da8Sdrh         sqlite3VdbeAddOp2(v, OP_Integer, 0, dest.iSDParm);
1917d4e70ebdSdrh         VdbeComment((v, "Init EXISTS result"));
191851522cd3Sdrh       }
1919633e6d57Sdrh       sqlite3ExprDelete(pParse->db, pSel->pLimit);
1920094430ebSdrh       pSel->pLimit = sqlite3PExpr(pParse, TK_INTEGER, 0, 0,
1921094430ebSdrh                                   &sqlite3IntTokens[1]);
192248b5b041Sdrh       pSel->iLimit = 0;
19237d10d5a6Sdrh       if( sqlite3Select(pParse, pSel, &dest) ){
19241450bc6eSdrh         return 0;
192594ccde58Sdrh       }
19262b596da8Sdrh       rReg = dest.iSDParm;
1927ebb6a65dSdrh       ExprSetVVAProperty(pExpr, EP_NoReduce);
1928b3bce662Sdanielk1977       break;
192919a775c2Sdrh     }
1930cce7d176Sdrh   }
1931b3bce662Sdanielk1977 
19326be515ebSdrh   if( rHasNullFlag ){
19336be515ebSdrh     sqlite3SetHasNullFlag(v, pExpr->iTable, rHasNullFlag);
19346be515ebSdrh   }
19356be515ebSdrh 
19366be515ebSdrh   if( jmpIfDynamic>=0 ){
19376be515ebSdrh     sqlite3VdbeJumpHere(v, jmpIfDynamic);
1938b3bce662Sdanielk1977   }
1939d2490904Sdrh   sqlite3ExprCachePop(pParse);
1940fc976065Sdanielk1977 
19411450bc6eSdrh   return rReg;
1942cce7d176Sdrh }
194351522cd3Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
1944cce7d176Sdrh 
1945e3365e6cSdrh #ifndef SQLITE_OMIT_SUBQUERY
1946e3365e6cSdrh /*
1947e3365e6cSdrh ** Generate code for an IN expression.
1948e3365e6cSdrh **
1949e3365e6cSdrh **      x IN (SELECT ...)
1950e3365e6cSdrh **      x IN (value, value, ...)
1951e3365e6cSdrh **
1952e3365e6cSdrh ** The left-hand side (LHS) is a scalar expression.  The right-hand side (RHS)
1953e3365e6cSdrh ** is an array of zero or more values.  The expression is true if the LHS is
1954e3365e6cSdrh ** contained within the RHS.  The value of the expression is unknown (NULL)
1955e3365e6cSdrh ** if the LHS is NULL or if the LHS is not contained within the RHS and the
1956e3365e6cSdrh ** RHS contains one or more NULL values.
1957e3365e6cSdrh **
19586be515ebSdrh ** This routine generates code that jumps to destIfFalse if the LHS is not
1959e3365e6cSdrh ** contained within the RHS.  If due to NULLs we cannot determine if the LHS
1960e3365e6cSdrh ** is contained in the RHS then jump to destIfNull.  If the LHS is contained
1961e3365e6cSdrh ** within the RHS then fall through.
1962e3365e6cSdrh */
1963e3365e6cSdrh static void sqlite3ExprCodeIN(
1964e3365e6cSdrh   Parse *pParse,        /* Parsing and code generating context */
1965e3365e6cSdrh   Expr *pExpr,          /* The IN expression */
1966e3365e6cSdrh   int destIfFalse,      /* Jump here if LHS is not contained in the RHS */
1967e3365e6cSdrh   int destIfNull        /* Jump here if the results are unknown due to NULLs */
1968e3365e6cSdrh ){
1969e3365e6cSdrh   int rRhsHasNull = 0;  /* Register that is true if RHS contains NULL values */
1970e3365e6cSdrh   char affinity;        /* Comparison affinity to use */
1971e3365e6cSdrh   int eType;            /* Type of the RHS */
1972e3365e6cSdrh   int r1;               /* Temporary use register */
1973e3365e6cSdrh   Vdbe *v;              /* Statement under construction */
1974e3365e6cSdrh 
1975e3365e6cSdrh   /* Compute the RHS.   After this step, the table with cursor
1976e3365e6cSdrh   ** pExpr->iTable will contains the values that make up the RHS.
1977e3365e6cSdrh   */
1978e3365e6cSdrh   v = pParse->pVdbe;
1979e3365e6cSdrh   assert( v!=0 );       /* OOM detected prior to this routine */
1980e3365e6cSdrh   VdbeNoopComment((v, "begin IN expr"));
1981*bb53ecb1Sdrh   eType = sqlite3FindInIndex(pParse, pExpr,
1982*bb53ecb1Sdrh                              IN_INDEX_MEMBERSHIP | IN_INDEX_NOOP_OK,
19833a85625dSdrh                              destIfFalse==destIfNull ? 0 : &rRhsHasNull);
1984e3365e6cSdrh 
1985e3365e6cSdrh   /* Figure out the affinity to use to create a key from the results
1986e3365e6cSdrh   ** of the expression. affinityStr stores a static string suitable for
1987e3365e6cSdrh   ** P4 of OP_MakeRecord.
1988e3365e6cSdrh   */
1989e3365e6cSdrh   affinity = comparisonAffinity(pExpr);
1990e3365e6cSdrh 
1991e3365e6cSdrh   /* Code the LHS, the <expr> from "<expr> IN (...)".
1992e3365e6cSdrh   */
1993e3365e6cSdrh   sqlite3ExprCachePush(pParse);
1994e3365e6cSdrh   r1 = sqlite3GetTempReg(pParse);
1995e3365e6cSdrh   sqlite3ExprCode(pParse, pExpr->pLeft, r1);
1996e3365e6cSdrh 
1997*bb53ecb1Sdrh   /* If sqlite3FindInIndex() did not find or create an index that is
1998*bb53ecb1Sdrh   ** suitable for evaluating the IN operator, then evaluate using a
1999*bb53ecb1Sdrh   ** sequence of comparisons.
2000*bb53ecb1Sdrh   */
2001*bb53ecb1Sdrh   if( eType==IN_INDEX_NOOP ){
2002*bb53ecb1Sdrh     ExprList *pList = pExpr->x.pList;
2003*bb53ecb1Sdrh     CollSeq *pColl = sqlite3ExprCollSeq(pParse, pExpr->pLeft);
2004*bb53ecb1Sdrh     int labelOk = sqlite3VdbeMakeLabel(v);
2005*bb53ecb1Sdrh     int r2, regToFree;
2006*bb53ecb1Sdrh     int regCkNull = 0;
2007*bb53ecb1Sdrh     int ii;
2008*bb53ecb1Sdrh     assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
2009*bb53ecb1Sdrh     sqlite3VdbeAddOp2(v, OP_IsNull, r1, destIfNull); VdbeCoverage(v);
2010*bb53ecb1Sdrh     if( destIfNull!=destIfFalse ){
2011*bb53ecb1Sdrh       regCkNull = sqlite3GetTempReg(pParse);
2012*bb53ecb1Sdrh       sqlite3VdbeAddOp2(v, OP_Integer, 0, regCkNull);
2013*bb53ecb1Sdrh     }
2014*bb53ecb1Sdrh     for(ii=0; ii<pList->nExpr; ii++){
2015*bb53ecb1Sdrh       r2 = sqlite3ExprCodeTemp(pParse, pList->a[ii].pExpr, &regToFree);
2016*bb53ecb1Sdrh       if( regCkNull ){
2017*bb53ecb1Sdrh         sqlite3VdbeAddOp3(v, OP_BitAnd, regCkNull, r2, regCkNull);
2018*bb53ecb1Sdrh       }
2019*bb53ecb1Sdrh       if( ii<pList->nExpr-1 || destIfNull!=destIfFalse ){
2020*bb53ecb1Sdrh         sqlite3VdbeAddOp4(v, OP_Eq, r1, labelOk, r2,
2021*bb53ecb1Sdrh                           (void*)pColl, P4_COLLSEQ); VdbeCoverage(v);
2022*bb53ecb1Sdrh         sqlite3VdbeChangeP5(v, affinity);
2023*bb53ecb1Sdrh       }else{
2024*bb53ecb1Sdrh         assert( destIfNull==destIfFalse );
2025*bb53ecb1Sdrh         sqlite3VdbeAddOp4(v, OP_Ne, r1, destIfFalse, r2,
2026*bb53ecb1Sdrh                           (void*)pColl, P4_COLLSEQ); VdbeCoverage(v);
2027*bb53ecb1Sdrh         sqlite3VdbeChangeP5(v, affinity | SQLITE_JUMPIFNULL);
2028*bb53ecb1Sdrh       }
2029*bb53ecb1Sdrh       sqlite3ReleaseTempReg(pParse, regToFree);
2030*bb53ecb1Sdrh     }
2031*bb53ecb1Sdrh     if( regCkNull ){
2032*bb53ecb1Sdrh       sqlite3VdbeAddOp2(v, OP_IsNull, regCkNull, destIfNull); VdbeCoverage(v);
2033*bb53ecb1Sdrh       sqlite3VdbeAddOp2(v, OP_Goto, 0, destIfFalse);
2034*bb53ecb1Sdrh     }
2035*bb53ecb1Sdrh     sqlite3VdbeResolveLabel(v, labelOk);
2036*bb53ecb1Sdrh     sqlite3ReleaseTempReg(pParse, regCkNull);
2037*bb53ecb1Sdrh   }else{
2038*bb53ecb1Sdrh 
2039094430ebSdrh     /* If the LHS is NULL, then the result is either false or NULL depending
2040094430ebSdrh     ** on whether the RHS is empty or not, respectively.
2041094430ebSdrh     */
2042094430ebSdrh     if( destIfNull==destIfFalse ){
2043094430ebSdrh       /* Shortcut for the common case where the false and NULL outcomes are
2044094430ebSdrh       ** the same. */
2045688852abSdrh       sqlite3VdbeAddOp2(v, OP_IsNull, r1, destIfNull); VdbeCoverage(v);
2046094430ebSdrh     }else{
2047688852abSdrh       int addr1 = sqlite3VdbeAddOp1(v, OP_NotNull, r1); VdbeCoverage(v);
2048094430ebSdrh       sqlite3VdbeAddOp2(v, OP_Rewind, pExpr->iTable, destIfFalse);
2049688852abSdrh       VdbeCoverage(v);
2050094430ebSdrh       sqlite3VdbeAddOp2(v, OP_Goto, 0, destIfNull);
2051094430ebSdrh       sqlite3VdbeJumpHere(v, addr1);
2052094430ebSdrh     }
2053e3365e6cSdrh 
2054e3365e6cSdrh     if( eType==IN_INDEX_ROWID ){
2055e3365e6cSdrh       /* In this case, the RHS is the ROWID of table b-tree
2056e3365e6cSdrh       */
2057688852abSdrh       sqlite3VdbeAddOp2(v, OP_MustBeInt, r1, destIfFalse); VdbeCoverage(v);
2058e3365e6cSdrh       sqlite3VdbeAddOp3(v, OP_NotExists, pExpr->iTable, destIfFalse, r1);
2059688852abSdrh       VdbeCoverage(v);
2060e3365e6cSdrh     }else{
2061e3365e6cSdrh       /* In this case, the RHS is an index b-tree.
2062e3365e6cSdrh       */
20638cff69dfSdrh       sqlite3VdbeAddOp4(v, OP_Affinity, r1, 1, 0, &affinity, 1);
2064e3365e6cSdrh 
2065e3365e6cSdrh       /* If the set membership test fails, then the result of the
2066e3365e6cSdrh       ** "x IN (...)" expression must be either 0 or NULL. If the set
2067e3365e6cSdrh       ** contains no NULL values, then the result is 0. If the set
2068e3365e6cSdrh       ** contains one or more NULL values, then the result of the
2069e3365e6cSdrh       ** expression is also NULL.
2070e3365e6cSdrh       */
2071e80c9b9aSdrh       assert( destIfFalse!=destIfNull || rRhsHasNull==0 );
2072e80c9b9aSdrh       if( rRhsHasNull==0 ){
2073e3365e6cSdrh         /* This branch runs if it is known at compile time that the RHS
2074e3365e6cSdrh         ** cannot contain NULL values. This happens as the result
2075e3365e6cSdrh         ** of a "NOT NULL" constraint in the database schema.
2076e3365e6cSdrh         **
2077e3365e6cSdrh         ** Also run this branch if NULL is equivalent to FALSE
2078e3365e6cSdrh         ** for this particular IN operator.
2079e3365e6cSdrh         */
20808cff69dfSdrh         sqlite3VdbeAddOp4Int(v, OP_NotFound, pExpr->iTable, destIfFalse, r1, 1);
2081688852abSdrh         VdbeCoverage(v);
2082e3365e6cSdrh       }else{
2083e3365e6cSdrh         /* In this branch, the RHS of the IN might contain a NULL and
2084e3365e6cSdrh         ** the presence of a NULL on the RHS makes a difference in the
2085e3365e6cSdrh         ** outcome.
2086e3365e6cSdrh         */
20876be515ebSdrh         int j1;
2088e3365e6cSdrh 
2089e3365e6cSdrh         /* First check to see if the LHS is contained in the RHS.  If so,
20906be515ebSdrh         ** then the answer is TRUE the presence of NULLs in the RHS does
20916be515ebSdrh         ** not matter.  If the LHS is not contained in the RHS, then the
20926be515ebSdrh         ** answer is NULL if the RHS contains NULLs and the answer is
20936be515ebSdrh         ** FALSE if the RHS is NULL-free.
2094e3365e6cSdrh         */
20958cff69dfSdrh         j1 = sqlite3VdbeAddOp4Int(v, OP_Found, pExpr->iTable, 0, r1, 1);
2096688852abSdrh         VdbeCoverage(v);
20976be515ebSdrh         sqlite3VdbeAddOp2(v, OP_IsNull, rRhsHasNull, destIfNull);
2098552fd454Sdrh         VdbeCoverage(v);
2099e3365e6cSdrh         sqlite3VdbeAddOp2(v, OP_Goto, 0, destIfFalse);
2100e3365e6cSdrh         sqlite3VdbeJumpHere(v, j1);
2101e3365e6cSdrh       }
2102e3365e6cSdrh     }
2103*bb53ecb1Sdrh   }
2104e3365e6cSdrh   sqlite3ReleaseTempReg(pParse, r1);
2105d2490904Sdrh   sqlite3ExprCachePop(pParse);
2106e3365e6cSdrh   VdbeComment((v, "end IN expr"));
2107e3365e6cSdrh }
2108e3365e6cSdrh #endif /* SQLITE_OMIT_SUBQUERY */
2109e3365e6cSdrh 
2110cce7d176Sdrh /*
2111598f1340Sdrh ** Duplicate an 8-byte value
2112598f1340Sdrh */
2113598f1340Sdrh static char *dup8bytes(Vdbe *v, const char *in){
2114598f1340Sdrh   char *out = sqlite3DbMallocRaw(sqlite3VdbeDb(v), 8);
2115598f1340Sdrh   if( out ){
2116598f1340Sdrh     memcpy(out, in, 8);
2117598f1340Sdrh   }
2118598f1340Sdrh   return out;
2119598f1340Sdrh }
2120598f1340Sdrh 
212113573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
2122598f1340Sdrh /*
2123598f1340Sdrh ** Generate an instruction that will put the floating point
21249cbf3425Sdrh ** value described by z[0..n-1] into register iMem.
21250cf19ed8Sdrh **
21260cf19ed8Sdrh ** The z[] string will probably not be zero-terminated.  But the
21270cf19ed8Sdrh ** z[n] character is guaranteed to be something that does not look
21280cf19ed8Sdrh ** like the continuation of the number.
2129598f1340Sdrh */
2130b7916a78Sdrh static void codeReal(Vdbe *v, const char *z, int negateFlag, int iMem){
2131fd773cf9Sdrh   if( ALWAYS(z!=0) ){
2132598f1340Sdrh     double value;
2133598f1340Sdrh     char *zV;
21349339da1fSdrh     sqlite3AtoF(z, &value, sqlite3Strlen30(z), SQLITE_UTF8);
2135d0015161Sdrh     assert( !sqlite3IsNaN(value) ); /* The new AtoF never returns NaN */
2136598f1340Sdrh     if( negateFlag ) value = -value;
2137598f1340Sdrh     zV = dup8bytes(v, (char*)&value);
21389de221dfSdrh     sqlite3VdbeAddOp4(v, OP_Real, 0, iMem, 0, zV, P4_REAL);
2139598f1340Sdrh   }
2140598f1340Sdrh }
214113573c71Sdrh #endif
2142598f1340Sdrh 
2143598f1340Sdrh 
2144598f1340Sdrh /*
2145fec19aadSdrh ** Generate an instruction that will put the integer describe by
21469cbf3425Sdrh ** text z[0..n-1] into register iMem.
21470cf19ed8Sdrh **
21485f1d6b61Sshaneh ** Expr.u.zToken is always UTF8 and zero-terminated.
2149fec19aadSdrh */
215013573c71Sdrh static void codeInteger(Parse *pParse, Expr *pExpr, int negFlag, int iMem){
215113573c71Sdrh   Vdbe *v = pParse->pVdbe;
215292b01d53Sdrh   if( pExpr->flags & EP_IntValue ){
215333e619fcSdrh     int i = pExpr->u.iValue;
2154d50ffc41Sdrh     assert( i>=0 );
215592b01d53Sdrh     if( negFlag ) i = -i;
215692b01d53Sdrh     sqlite3VdbeAddOp2(v, OP_Integer, i, iMem);
2157fd773cf9Sdrh   }else{
21585f1d6b61Sshaneh     int c;
21595f1d6b61Sshaneh     i64 value;
2160fd773cf9Sdrh     const char *z = pExpr->u.zToken;
2161fd773cf9Sdrh     assert( z!=0 );
21629296c18aSdrh     c = sqlite3DecOrHexToI64(z, &value);
21635f1d6b61Sshaneh     if( c==0 || (c==2 && negFlag) ){
2164598f1340Sdrh       char *zV;
2165158b9cb9Sdrh       if( negFlag ){ value = c==2 ? SMALLEST_INT64 : -value; }
2166598f1340Sdrh       zV = dup8bytes(v, (char*)&value);
21679de221dfSdrh       sqlite3VdbeAddOp4(v, OP_Int64, 0, iMem, 0, zV, P4_INT64);
2168fec19aadSdrh     }else{
216913573c71Sdrh #ifdef SQLITE_OMIT_FLOATING_POINT
217013573c71Sdrh       sqlite3ErrorMsg(pParse, "oversized integer: %s%s", negFlag ? "-" : "", z);
217113573c71Sdrh #else
21721b7ddc59Sdrh #ifndef SQLITE_OMIT_HEX_INTEGER
21739296c18aSdrh       if( sqlite3_strnicmp(z,"0x",2)==0 ){
21749296c18aSdrh         sqlite3ErrorMsg(pParse, "hex literal too big: %s", z);
21751b7ddc59Sdrh       }else
21761b7ddc59Sdrh #endif
21771b7ddc59Sdrh       {
2178b7916a78Sdrh         codeReal(v, z, negFlag, iMem);
21799296c18aSdrh       }
218013573c71Sdrh #endif
2181fec19aadSdrh     }
2182fec19aadSdrh   }
2183c9cf901dSdanielk1977 }
2184fec19aadSdrh 
2185ceea3321Sdrh /*
2186ceea3321Sdrh ** Clear a cache entry.
2187ceea3321Sdrh */
2188ceea3321Sdrh static void cacheEntryClear(Parse *pParse, struct yColCache *p){
2189ceea3321Sdrh   if( p->tempReg ){
2190ceea3321Sdrh     if( pParse->nTempReg<ArraySize(pParse->aTempReg) ){
2191ceea3321Sdrh       pParse->aTempReg[pParse->nTempReg++] = p->iReg;
2192ceea3321Sdrh     }
2193ceea3321Sdrh     p->tempReg = 0;
2194ceea3321Sdrh   }
2195ceea3321Sdrh }
2196ceea3321Sdrh 
2197ceea3321Sdrh 
2198ceea3321Sdrh /*
2199ceea3321Sdrh ** Record in the column cache that a particular column from a
2200ceea3321Sdrh ** particular table is stored in a particular register.
2201ceea3321Sdrh */
2202ceea3321Sdrh void sqlite3ExprCacheStore(Parse *pParse, int iTab, int iCol, int iReg){
2203ceea3321Sdrh   int i;
2204ceea3321Sdrh   int minLru;
2205ceea3321Sdrh   int idxLru;
2206ceea3321Sdrh   struct yColCache *p;
2207ceea3321Sdrh 
220820411ea7Sdrh   assert( iReg>0 );  /* Register numbers are always positive */
220920411ea7Sdrh   assert( iCol>=-1 && iCol<32768 );  /* Finite column numbers */
221020411ea7Sdrh 
2211b6da74ebSdrh   /* The SQLITE_ColumnCache flag disables the column cache.  This is used
2212b6da74ebSdrh   ** for testing only - to verify that SQLite always gets the same answer
2213b6da74ebSdrh   ** with and without the column cache.
2214b6da74ebSdrh   */
22157e5418e4Sdrh   if( OptimizationDisabled(pParse->db, SQLITE_ColumnCache) ) return;
2216b6da74ebSdrh 
221727ee406eSdrh   /* First replace any existing entry.
221827ee406eSdrh   **
221927ee406eSdrh   ** Actually, the way the column cache is currently used, we are guaranteed
222027ee406eSdrh   ** that the object will never already be in cache.  Verify this guarantee.
222127ee406eSdrh   */
222227ee406eSdrh #ifndef NDEBUG
2223ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
222427ee406eSdrh     assert( p->iReg==0 || p->iTable!=iTab || p->iColumn!=iCol );
2225ceea3321Sdrh   }
222627ee406eSdrh #endif
2227ceea3321Sdrh 
2228ceea3321Sdrh   /* Find an empty slot and replace it */
2229ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2230ceea3321Sdrh     if( p->iReg==0 ){
2231ceea3321Sdrh       p->iLevel = pParse->iCacheLevel;
2232ceea3321Sdrh       p->iTable = iTab;
2233ceea3321Sdrh       p->iColumn = iCol;
2234ceea3321Sdrh       p->iReg = iReg;
2235ceea3321Sdrh       p->tempReg = 0;
2236ceea3321Sdrh       p->lru = pParse->iCacheCnt++;
2237ceea3321Sdrh       return;
2238ceea3321Sdrh     }
2239ceea3321Sdrh   }
2240ceea3321Sdrh 
2241ceea3321Sdrh   /* Replace the last recently used */
2242ceea3321Sdrh   minLru = 0x7fffffff;
2243ceea3321Sdrh   idxLru = -1;
2244ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2245ceea3321Sdrh     if( p->lru<minLru ){
2246ceea3321Sdrh       idxLru = i;
2247ceea3321Sdrh       minLru = p->lru;
2248ceea3321Sdrh     }
2249ceea3321Sdrh   }
225020411ea7Sdrh   if( ALWAYS(idxLru>=0) ){
2251ceea3321Sdrh     p = &pParse->aColCache[idxLru];
2252ceea3321Sdrh     p->iLevel = pParse->iCacheLevel;
2253ceea3321Sdrh     p->iTable = iTab;
2254ceea3321Sdrh     p->iColumn = iCol;
2255ceea3321Sdrh     p->iReg = iReg;
2256ceea3321Sdrh     p->tempReg = 0;
2257ceea3321Sdrh     p->lru = pParse->iCacheCnt++;
2258ceea3321Sdrh     return;
2259ceea3321Sdrh   }
2260ceea3321Sdrh }
2261ceea3321Sdrh 
2262ceea3321Sdrh /*
2263f49f3523Sdrh ** Indicate that registers between iReg..iReg+nReg-1 are being overwritten.
2264f49f3523Sdrh ** Purge the range of registers from the column cache.
2265ceea3321Sdrh */
2266f49f3523Sdrh void sqlite3ExprCacheRemove(Parse *pParse, int iReg, int nReg){
2267ceea3321Sdrh   int i;
2268f49f3523Sdrh   int iLast = iReg + nReg - 1;
2269ceea3321Sdrh   struct yColCache *p;
2270ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2271f49f3523Sdrh     int r = p->iReg;
2272f49f3523Sdrh     if( r>=iReg && r<=iLast ){
2273ceea3321Sdrh       cacheEntryClear(pParse, p);
2274ceea3321Sdrh       p->iReg = 0;
2275ceea3321Sdrh     }
2276ceea3321Sdrh   }
2277ceea3321Sdrh }
2278ceea3321Sdrh 
2279ceea3321Sdrh /*
2280ceea3321Sdrh ** Remember the current column cache context.  Any new entries added
2281ceea3321Sdrh ** added to the column cache after this call are removed when the
2282ceea3321Sdrh ** corresponding pop occurs.
2283ceea3321Sdrh */
2284ceea3321Sdrh void sqlite3ExprCachePush(Parse *pParse){
2285ceea3321Sdrh   pParse->iCacheLevel++;
22869ac7962aSdrh #ifdef SQLITE_DEBUG
22879ac7962aSdrh   if( pParse->db->flags & SQLITE_VdbeAddopTrace ){
22889ac7962aSdrh     printf("PUSH to %d\n", pParse->iCacheLevel);
22899ac7962aSdrh   }
22909ac7962aSdrh #endif
2291ceea3321Sdrh }
2292ceea3321Sdrh 
2293ceea3321Sdrh /*
2294ceea3321Sdrh ** Remove from the column cache any entries that were added since the
2295d2490904Sdrh ** the previous sqlite3ExprCachePush operation.  In other words, restore
2296d2490904Sdrh ** the cache to the state it was in prior the most recent Push.
2297ceea3321Sdrh */
2298d2490904Sdrh void sqlite3ExprCachePop(Parse *pParse){
2299ceea3321Sdrh   int i;
2300ceea3321Sdrh   struct yColCache *p;
2301d2490904Sdrh   assert( pParse->iCacheLevel>=1 );
2302d2490904Sdrh   pParse->iCacheLevel--;
23039ac7962aSdrh #ifdef SQLITE_DEBUG
23049ac7962aSdrh   if( pParse->db->flags & SQLITE_VdbeAddopTrace ){
23059ac7962aSdrh     printf("POP  to %d\n", pParse->iCacheLevel);
23069ac7962aSdrh   }
23079ac7962aSdrh #endif
2308ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2309ceea3321Sdrh     if( p->iReg && p->iLevel>pParse->iCacheLevel ){
2310ceea3321Sdrh       cacheEntryClear(pParse, p);
2311ceea3321Sdrh       p->iReg = 0;
2312ceea3321Sdrh     }
2313ceea3321Sdrh   }
2314ceea3321Sdrh }
2315945498f3Sdrh 
2316945498f3Sdrh /*
23175cd79239Sdrh ** When a cached column is reused, make sure that its register is
23185cd79239Sdrh ** no longer available as a temp register.  ticket #3879:  that same
23195cd79239Sdrh ** register might be in the cache in multiple places, so be sure to
23205cd79239Sdrh ** get them all.
23215cd79239Sdrh */
23225cd79239Sdrh static void sqlite3ExprCachePinRegister(Parse *pParse, int iReg){
23235cd79239Sdrh   int i;
23245cd79239Sdrh   struct yColCache *p;
23255cd79239Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
23265cd79239Sdrh     if( p->iReg==iReg ){
23275cd79239Sdrh       p->tempReg = 0;
23285cd79239Sdrh     }
23295cd79239Sdrh   }
23305cd79239Sdrh }
23315cd79239Sdrh 
23325cd79239Sdrh /*
23335c092e8aSdrh ** Generate code to extract the value of the iCol-th column of a table.
23345c092e8aSdrh */
23355c092e8aSdrh void sqlite3ExprCodeGetColumnOfTable(
23365c092e8aSdrh   Vdbe *v,        /* The VDBE under construction */
23375c092e8aSdrh   Table *pTab,    /* The table containing the value */
2338313619f5Sdrh   int iTabCur,    /* The table cursor.  Or the PK cursor for WITHOUT ROWID */
23395c092e8aSdrh   int iCol,       /* Index of the column to extract */
2340313619f5Sdrh   int regOut      /* Extract the value into this register */
23415c092e8aSdrh ){
23425c092e8aSdrh   if( iCol<0 || iCol==pTab->iPKey ){
23435c092e8aSdrh     sqlite3VdbeAddOp2(v, OP_Rowid, iTabCur, regOut);
23445c092e8aSdrh   }else{
23455c092e8aSdrh     int op = IsVirtual(pTab) ? OP_VColumn : OP_Column;
2346ee0ec8e1Sdrh     int x = iCol;
2347ee0ec8e1Sdrh     if( !HasRowid(pTab) ){
2348ee0ec8e1Sdrh       x = sqlite3ColumnOfIndex(sqlite3PrimaryKeyIndex(pTab), iCol);
2349ee0ec8e1Sdrh     }
2350ee0ec8e1Sdrh     sqlite3VdbeAddOp3(v, op, iTabCur, x, regOut);
23515c092e8aSdrh   }
23525c092e8aSdrh   if( iCol>=0 ){
23535c092e8aSdrh     sqlite3ColumnDefault(v, pTab, iCol, regOut);
23545c092e8aSdrh   }
23555c092e8aSdrh }
23565c092e8aSdrh 
23575c092e8aSdrh /*
2358945498f3Sdrh ** Generate code that will extract the iColumn-th column from
2359e55cbd72Sdrh ** table pTab and store the column value in a register.  An effort
2360e55cbd72Sdrh ** is made to store the column value in register iReg, but this is
2361e55cbd72Sdrh ** not guaranteed.  The location of the column value is returned.
2362e55cbd72Sdrh **
2363e55cbd72Sdrh ** There must be an open cursor to pTab in iTable when this routine
2364e55cbd72Sdrh ** is called.  If iColumn<0 then code is generated that extracts the rowid.
2365945498f3Sdrh */
2366e55cbd72Sdrh int sqlite3ExprCodeGetColumn(
2367e55cbd72Sdrh   Parse *pParse,   /* Parsing and code generating context */
23682133d822Sdrh   Table *pTab,     /* Description of the table we are reading from */
23692133d822Sdrh   int iColumn,     /* Index of the table column */
23702133d822Sdrh   int iTable,      /* The cursor pointing to the table */
2371a748fdccSdrh   int iReg,        /* Store results here */
2372a748fdccSdrh   u8 p5            /* P5 value for OP_Column */
23732133d822Sdrh ){
2374e55cbd72Sdrh   Vdbe *v = pParse->pVdbe;
2375e55cbd72Sdrh   int i;
2376da250ea5Sdrh   struct yColCache *p;
2377e55cbd72Sdrh 
2378ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2379b6da74ebSdrh     if( p->iReg>0 && p->iTable==iTable && p->iColumn==iColumn ){
2380ceea3321Sdrh       p->lru = pParse->iCacheCnt++;
23815cd79239Sdrh       sqlite3ExprCachePinRegister(pParse, p->iReg);
2382da250ea5Sdrh       return p->iReg;
2383e55cbd72Sdrh     }
2384e55cbd72Sdrh   }
2385e55cbd72Sdrh   assert( v!=0 );
23865c092e8aSdrh   sqlite3ExprCodeGetColumnOfTable(v, pTab, iTable, iColumn, iReg);
2387a748fdccSdrh   if( p5 ){
2388a748fdccSdrh     sqlite3VdbeChangeP5(v, p5);
2389a748fdccSdrh   }else{
2390ceea3321Sdrh     sqlite3ExprCacheStore(pParse, iTable, iColumn, iReg);
2391a748fdccSdrh   }
2392e55cbd72Sdrh   return iReg;
2393e55cbd72Sdrh }
2394e55cbd72Sdrh 
2395e55cbd72Sdrh /*
2396ceea3321Sdrh ** Clear all column cache entries.
2397e55cbd72Sdrh */
2398ceea3321Sdrh void sqlite3ExprCacheClear(Parse *pParse){
2399e55cbd72Sdrh   int i;
2400ceea3321Sdrh   struct yColCache *p;
2401ceea3321Sdrh 
24029ac7962aSdrh #if SQLITE_DEBUG
24039ac7962aSdrh   if( pParse->db->flags & SQLITE_VdbeAddopTrace ){
24049ac7962aSdrh     printf("CLEAR\n");
24059ac7962aSdrh   }
24069ac7962aSdrh #endif
2407ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2408ceea3321Sdrh     if( p->iReg ){
2409ceea3321Sdrh       cacheEntryClear(pParse, p);
2410ceea3321Sdrh       p->iReg = 0;
2411e55cbd72Sdrh     }
2412da250ea5Sdrh   }
2413da250ea5Sdrh }
2414e55cbd72Sdrh 
2415e55cbd72Sdrh /*
2416da250ea5Sdrh ** Record the fact that an affinity change has occurred on iCount
2417da250ea5Sdrh ** registers starting with iStart.
2418e55cbd72Sdrh */
2419da250ea5Sdrh void sqlite3ExprCacheAffinityChange(Parse *pParse, int iStart, int iCount){
2420f49f3523Sdrh   sqlite3ExprCacheRemove(pParse, iStart, iCount);
2421e55cbd72Sdrh }
2422e55cbd72Sdrh 
2423e55cbd72Sdrh /*
2424b21e7c70Sdrh ** Generate code to move content from registers iFrom...iFrom+nReg-1
2425b21e7c70Sdrh ** over to iTo..iTo+nReg-1. Keep the column cache up-to-date.
2426e55cbd72Sdrh */
2427b21e7c70Sdrh void sqlite3ExprCodeMove(Parse *pParse, int iFrom, int iTo, int nReg){
2428e55cbd72Sdrh   int i;
2429ceea3321Sdrh   struct yColCache *p;
2430e8e4af76Sdrh   assert( iFrom>=iTo+nReg || iFrom+nReg<=iTo );
2431079a3072Sdrh   sqlite3VdbeAddOp3(pParse->pVdbe, OP_Move, iFrom, iTo, nReg);
2432ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2433ceea3321Sdrh     int x = p->iReg;
2434b21e7c70Sdrh     if( x>=iFrom && x<iFrom+nReg ){
2435ceea3321Sdrh       p->iReg += iTo-iFrom;
2436e55cbd72Sdrh     }
2437e55cbd72Sdrh   }
2438945498f3Sdrh }
2439945498f3Sdrh 
2440f49f3523Sdrh #if defined(SQLITE_DEBUG) || defined(SQLITE_COVERAGE_TEST)
244192b01d53Sdrh /*
2442652fbf55Sdrh ** Return true if any register in the range iFrom..iTo (inclusive)
2443652fbf55Sdrh ** is used as part of the column cache.
2444f49f3523Sdrh **
2445f49f3523Sdrh ** This routine is used within assert() and testcase() macros only
2446f49f3523Sdrh ** and does not appear in a normal build.
2447652fbf55Sdrh */
2448652fbf55Sdrh static int usedAsColumnCache(Parse *pParse, int iFrom, int iTo){
2449652fbf55Sdrh   int i;
2450ceea3321Sdrh   struct yColCache *p;
2451ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2452ceea3321Sdrh     int r = p->iReg;
2453f49f3523Sdrh     if( r>=iFrom && r<=iTo ) return 1;    /*NO_TEST*/
2454652fbf55Sdrh   }
2455652fbf55Sdrh   return 0;
2456652fbf55Sdrh }
2457f49f3523Sdrh #endif /* SQLITE_DEBUG || SQLITE_COVERAGE_TEST */
2458652fbf55Sdrh 
2459652fbf55Sdrh /*
2460a4c3c87eSdrh ** Convert an expression node to a TK_REGISTER
2461a4c3c87eSdrh */
2462a4c3c87eSdrh static void exprToRegister(Expr *p, int iReg){
2463a4c3c87eSdrh   p->op2 = p->op;
2464a4c3c87eSdrh   p->op = TK_REGISTER;
2465a4c3c87eSdrh   p->iTable = iReg;
2466a4c3c87eSdrh   ExprClearProperty(p, EP_Skip);
2467a4c3c87eSdrh }
2468a4c3c87eSdrh 
2469a4c3c87eSdrh /*
2470cce7d176Sdrh ** Generate code into the current Vdbe to evaluate the given
24712dcef11bSdrh ** expression.  Attempt to store the results in register "target".
24722dcef11bSdrh ** Return the register where results are stored.
2473389a1adbSdrh **
24748b213899Sdrh ** With this routine, there is no guarantee that results will
24752dcef11bSdrh ** be stored in target.  The result might be stored in some other
24762dcef11bSdrh ** register if it is convenient to do so.  The calling function
24772dcef11bSdrh ** must check the return code and move the results to the desired
24782dcef11bSdrh ** register.
2479cce7d176Sdrh */
2480678ccce8Sdrh int sqlite3ExprCodeTarget(Parse *pParse, Expr *pExpr, int target){
24812dcef11bSdrh   Vdbe *v = pParse->pVdbe;  /* The VM under construction */
24822dcef11bSdrh   int op;                   /* The opcode being coded */
24832dcef11bSdrh   int inReg = target;       /* Results stored in register inReg */
24842dcef11bSdrh   int regFree1 = 0;         /* If non-zero free this temporary register */
24852dcef11bSdrh   int regFree2 = 0;         /* If non-zero free this temporary register */
2486678ccce8Sdrh   int r1, r2, r3, r4;       /* Various register numbers */
248720411ea7Sdrh   sqlite3 *db = pParse->db; /* The database connection */
248810d1edf0Sdrh   Expr tempX;               /* Temporary expression node */
2489ffe07b2dSdrh 
24909cbf3425Sdrh   assert( target>0 && target<=pParse->nMem );
249120411ea7Sdrh   if( v==0 ){
249220411ea7Sdrh     assert( pParse->db->mallocFailed );
249320411ea7Sdrh     return 0;
249420411ea7Sdrh   }
2495389a1adbSdrh 
2496389a1adbSdrh   if( pExpr==0 ){
2497389a1adbSdrh     op = TK_NULL;
2498389a1adbSdrh   }else{
2499f2bc013cSdrh     op = pExpr->op;
2500389a1adbSdrh   }
2501f2bc013cSdrh   switch( op ){
250213449892Sdrh     case TK_AGG_COLUMN: {
250313449892Sdrh       AggInfo *pAggInfo = pExpr->pAggInfo;
250413449892Sdrh       struct AggInfo_col *pCol = &pAggInfo->aCol[pExpr->iAgg];
250513449892Sdrh       if( !pAggInfo->directMode ){
25069de221dfSdrh         assert( pCol->iMem>0 );
25079de221dfSdrh         inReg = pCol->iMem;
250813449892Sdrh         break;
250913449892Sdrh       }else if( pAggInfo->useSortingIdx ){
25105134d135Sdan         sqlite3VdbeAddOp3(v, OP_Column, pAggInfo->sortingIdxPTab,
2511389a1adbSdrh                               pCol->iSorterColumn, target);
251213449892Sdrh         break;
251313449892Sdrh       }
251413449892Sdrh       /* Otherwise, fall thru into the TK_COLUMN case */
251513449892Sdrh     }
2516967e8b73Sdrh     case TK_COLUMN: {
2517b2b9d3d7Sdrh       int iTab = pExpr->iTable;
2518b2b9d3d7Sdrh       if( iTab<0 ){
2519b2b9d3d7Sdrh         if( pParse->ckBase>0 ){
2520b2b9d3d7Sdrh           /* Generating CHECK constraints or inserting into partial index */
2521aa9b8963Sdrh           inReg = pExpr->iColumn + pParse->ckBase;
2522b2b9d3d7Sdrh           break;
2523c4a3c779Sdrh         }else{
2524b2b9d3d7Sdrh           /* Deleting from a partial index */
2525b2b9d3d7Sdrh           iTab = pParse->iPartIdxTab;
25262282792aSdrh         }
2527b2b9d3d7Sdrh       }
2528b2b9d3d7Sdrh       inReg = sqlite3ExprCodeGetColumn(pParse, pExpr->pTab,
2529b2b9d3d7Sdrh                                pExpr->iColumn, iTab, target,
2530b2b9d3d7Sdrh                                pExpr->op2);
2531cce7d176Sdrh       break;
2532cce7d176Sdrh     }
2533cce7d176Sdrh     case TK_INTEGER: {
253413573c71Sdrh       codeInteger(pParse, pExpr, 0, target);
2535fec19aadSdrh       break;
253651e9a445Sdrh     }
253713573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
2538598f1340Sdrh     case TK_FLOAT: {
253933e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
254033e619fcSdrh       codeReal(v, pExpr->u.zToken, 0, target);
2541598f1340Sdrh       break;
2542598f1340Sdrh     }
254313573c71Sdrh #endif
2544fec19aadSdrh     case TK_STRING: {
254533e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
254633e619fcSdrh       sqlite3VdbeAddOp4(v, OP_String8, 0, target, 0, pExpr->u.zToken, 0);
2547cce7d176Sdrh       break;
2548cce7d176Sdrh     }
2549f0863fe5Sdrh     case TK_NULL: {
25509de221dfSdrh       sqlite3VdbeAddOp2(v, OP_Null, 0, target);
2551f0863fe5Sdrh       break;
2552f0863fe5Sdrh     }
25535338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_BLOB_LITERAL
2554c572ef7fSdanielk1977     case TK_BLOB: {
25556c8c6cecSdrh       int n;
25566c8c6cecSdrh       const char *z;
2557ca48c90fSdrh       char *zBlob;
255833e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
255933e619fcSdrh       assert( pExpr->u.zToken[0]=='x' || pExpr->u.zToken[0]=='X' );
256033e619fcSdrh       assert( pExpr->u.zToken[1]=='\'' );
256133e619fcSdrh       z = &pExpr->u.zToken[2];
2562b7916a78Sdrh       n = sqlite3Strlen30(z) - 1;
2563b7916a78Sdrh       assert( z[n]=='\'' );
2564ca48c90fSdrh       zBlob = sqlite3HexToBlob(sqlite3VdbeDb(v), z, n);
2565ca48c90fSdrh       sqlite3VdbeAddOp4(v, OP_Blob, n/2, target, 0, zBlob, P4_DYNAMIC);
2566c572ef7fSdanielk1977       break;
2567c572ef7fSdanielk1977     }
25685338a5f7Sdanielk1977 #endif
256950457896Sdrh     case TK_VARIABLE: {
257033e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
257133e619fcSdrh       assert( pExpr->u.zToken!=0 );
257233e619fcSdrh       assert( pExpr->u.zToken[0]!=0 );
2573eaf52d88Sdrh       sqlite3VdbeAddOp2(v, OP_Variable, pExpr->iColumn, target);
257433e619fcSdrh       if( pExpr->u.zToken[1]!=0 ){
257504e9eeadSdrh         assert( pExpr->u.zToken[0]=='?'
257604e9eeadSdrh              || strcmp(pExpr->u.zToken, pParse->azVar[pExpr->iColumn-1])==0 );
257704e9eeadSdrh         sqlite3VdbeChangeP4(v, -1, pParse->azVar[pExpr->iColumn-1], P4_STATIC);
2578895d7472Sdrh       }
257950457896Sdrh       break;
258050457896Sdrh     }
25814e0cff60Sdrh     case TK_REGISTER: {
25829de221dfSdrh       inReg = pExpr->iTable;
25834e0cff60Sdrh       break;
25844e0cff60Sdrh     }
25858b213899Sdrh     case TK_AS: {
25867445ffe2Sdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
25878b213899Sdrh       break;
25888b213899Sdrh     }
2589487e262fSdrh #ifndef SQLITE_OMIT_CAST
2590487e262fSdrh     case TK_CAST: {
2591487e262fSdrh       /* Expressions of the form:   CAST(pLeft AS token) */
2592f0113000Sdanielk1977       int aff, to_op;
25932dcef11bSdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
259433e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
2595fdaac671Sdrh       aff = sqlite3AffinityType(pExpr->u.zToken, 0);
2596f0113000Sdanielk1977       to_op = aff - SQLITE_AFF_TEXT + OP_ToText;
2597f0113000Sdanielk1977       assert( to_op==OP_ToText    || aff!=SQLITE_AFF_TEXT    );
2598f0113000Sdanielk1977       assert( to_op==OP_ToBlob    || aff!=SQLITE_AFF_NONE    );
2599f0113000Sdanielk1977       assert( to_op==OP_ToNumeric || aff!=SQLITE_AFF_NUMERIC );
2600f0113000Sdanielk1977       assert( to_op==OP_ToInt     || aff!=SQLITE_AFF_INTEGER );
2601f0113000Sdanielk1977       assert( to_op==OP_ToReal    || aff!=SQLITE_AFF_REAL    );
2602c5499befSdrh       testcase( to_op==OP_ToText );
2603c5499befSdrh       testcase( to_op==OP_ToBlob );
2604c5499befSdrh       testcase( to_op==OP_ToNumeric );
2605c5499befSdrh       testcase( to_op==OP_ToInt );
2606c5499befSdrh       testcase( to_op==OP_ToReal );
26071735fa88Sdrh       if( inReg!=target ){
26081735fa88Sdrh         sqlite3VdbeAddOp2(v, OP_SCopy, inReg, target);
26091735fa88Sdrh         inReg = target;
26101735fa88Sdrh       }
26112dcef11bSdrh       sqlite3VdbeAddOp1(v, to_op, inReg);
2612c5499befSdrh       testcase( usedAsColumnCache(pParse, inReg, inReg) );
2613b3843a82Sdrh       sqlite3ExprCacheAffinityChange(pParse, inReg, 1);
2614487e262fSdrh       break;
2615487e262fSdrh     }
2616487e262fSdrh #endif /* SQLITE_OMIT_CAST */
2617c9b84a1fSdrh     case TK_LT:
2618c9b84a1fSdrh     case TK_LE:
2619c9b84a1fSdrh     case TK_GT:
2620c9b84a1fSdrh     case TK_GE:
2621c9b84a1fSdrh     case TK_NE:
2622c9b84a1fSdrh     case TK_EQ: {
2623b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2624b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
262535573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
26267d176105Sdrh                   r1, r2, inReg, SQLITE_STOREP2);
26277d176105Sdrh       assert(TK_LT==OP_Lt); testcase(op==OP_Lt); VdbeCoverageIf(v,op==OP_Lt);
26287d176105Sdrh       assert(TK_LE==OP_Le); testcase(op==OP_Le); VdbeCoverageIf(v,op==OP_Le);
26297d176105Sdrh       assert(TK_GT==OP_Gt); testcase(op==OP_Gt); VdbeCoverageIf(v,op==OP_Gt);
26307d176105Sdrh       assert(TK_GE==OP_Ge); testcase(op==OP_Ge); VdbeCoverageIf(v,op==OP_Ge);
26317d176105Sdrh       assert(TK_EQ==OP_Eq); testcase(op==OP_Eq); VdbeCoverageIf(v,op==OP_Eq);
26327d176105Sdrh       assert(TK_NE==OP_Ne); testcase(op==OP_Ne); VdbeCoverageIf(v,op==OP_Ne);
2633c5499befSdrh       testcase( regFree1==0 );
2634c5499befSdrh       testcase( regFree2==0 );
2635a37cdde0Sdanielk1977       break;
2636c9b84a1fSdrh     }
26376a2fe093Sdrh     case TK_IS:
26386a2fe093Sdrh     case TK_ISNOT: {
26396a2fe093Sdrh       testcase( op==TK_IS );
26406a2fe093Sdrh       testcase( op==TK_ISNOT );
2641b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2642b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
26436a2fe093Sdrh       op = (op==TK_IS) ? TK_EQ : TK_NE;
26446a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
26456a2fe093Sdrh                   r1, r2, inReg, SQLITE_STOREP2 | SQLITE_NULLEQ);
26467d176105Sdrh       VdbeCoverageIf(v, op==TK_EQ);
26477d176105Sdrh       VdbeCoverageIf(v, op==TK_NE);
26486a2fe093Sdrh       testcase( regFree1==0 );
26496a2fe093Sdrh       testcase( regFree2==0 );
26506a2fe093Sdrh       break;
26516a2fe093Sdrh     }
2652cce7d176Sdrh     case TK_AND:
2653cce7d176Sdrh     case TK_OR:
2654cce7d176Sdrh     case TK_PLUS:
2655cce7d176Sdrh     case TK_STAR:
2656cce7d176Sdrh     case TK_MINUS:
2657bf4133cbSdrh     case TK_REM:
2658bf4133cbSdrh     case TK_BITAND:
2659bf4133cbSdrh     case TK_BITOR:
266017c40294Sdrh     case TK_SLASH:
2661bf4133cbSdrh     case TK_LSHIFT:
2662855eb1cfSdrh     case TK_RSHIFT:
26630040077dSdrh     case TK_CONCAT: {
26647d176105Sdrh       assert( TK_AND==OP_And );            testcase( op==TK_AND );
26657d176105Sdrh       assert( TK_OR==OP_Or );              testcase( op==TK_OR );
26667d176105Sdrh       assert( TK_PLUS==OP_Add );           testcase( op==TK_PLUS );
26677d176105Sdrh       assert( TK_MINUS==OP_Subtract );     testcase( op==TK_MINUS );
26687d176105Sdrh       assert( TK_REM==OP_Remainder );      testcase( op==TK_REM );
26697d176105Sdrh       assert( TK_BITAND==OP_BitAnd );      testcase( op==TK_BITAND );
26707d176105Sdrh       assert( TK_BITOR==OP_BitOr );        testcase( op==TK_BITOR );
26717d176105Sdrh       assert( TK_SLASH==OP_Divide );       testcase( op==TK_SLASH );
26727d176105Sdrh       assert( TK_LSHIFT==OP_ShiftLeft );   testcase( op==TK_LSHIFT );
26737d176105Sdrh       assert( TK_RSHIFT==OP_ShiftRight );  testcase( op==TK_RSHIFT );
26747d176105Sdrh       assert( TK_CONCAT==OP_Concat );      testcase( op==TK_CONCAT );
26752dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
26762dcef11bSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
26775b6afba9Sdrh       sqlite3VdbeAddOp3(v, op, r2, r1, target);
2678c5499befSdrh       testcase( regFree1==0 );
2679c5499befSdrh       testcase( regFree2==0 );
26800040077dSdrh       break;
26810040077dSdrh     }
2682cce7d176Sdrh     case TK_UMINUS: {
2683fec19aadSdrh       Expr *pLeft = pExpr->pLeft;
2684fec19aadSdrh       assert( pLeft );
268513573c71Sdrh       if( pLeft->op==TK_INTEGER ){
268613573c71Sdrh         codeInteger(pParse, pLeft, 1, target);
268713573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
268813573c71Sdrh       }else if( pLeft->op==TK_FLOAT ){
268933e619fcSdrh         assert( !ExprHasProperty(pExpr, EP_IntValue) );
269033e619fcSdrh         codeReal(v, pLeft->u.zToken, 1, target);
269113573c71Sdrh #endif
26923c84ddffSdrh       }else{
269310d1edf0Sdrh         tempX.op = TK_INTEGER;
269410d1edf0Sdrh         tempX.flags = EP_IntValue|EP_TokenOnly;
269510d1edf0Sdrh         tempX.u.iValue = 0;
269610d1edf0Sdrh         r1 = sqlite3ExprCodeTemp(pParse, &tempX, &regFree1);
2697e55cbd72Sdrh         r2 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree2);
26982dcef11bSdrh         sqlite3VdbeAddOp3(v, OP_Subtract, r2, r1, target);
2699c5499befSdrh         testcase( regFree2==0 );
27003c84ddffSdrh       }
27019de221dfSdrh       inReg = target;
27026e142f54Sdrh       break;
27036e142f54Sdrh     }
2704bf4133cbSdrh     case TK_BITNOT:
27056e142f54Sdrh     case TK_NOT: {
27067d176105Sdrh       assert( TK_BITNOT==OP_BitNot );   testcase( op==TK_BITNOT );
27077d176105Sdrh       assert( TK_NOT==OP_Not );         testcase( op==TK_NOT );
2708e99fa2afSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2709e99fa2afSdrh       testcase( regFree1==0 );
2710e99fa2afSdrh       inReg = target;
2711e99fa2afSdrh       sqlite3VdbeAddOp2(v, op, r1, inReg);
2712cce7d176Sdrh       break;
2713cce7d176Sdrh     }
2714cce7d176Sdrh     case TK_ISNULL:
2715cce7d176Sdrh     case TK_NOTNULL: {
27166a288a33Sdrh       int addr;
27177d176105Sdrh       assert( TK_ISNULL==OP_IsNull );   testcase( op==TK_ISNULL );
27187d176105Sdrh       assert( TK_NOTNULL==OP_NotNull ); testcase( op==TK_NOTNULL );
27199de221dfSdrh       sqlite3VdbeAddOp2(v, OP_Integer, 1, target);
27202dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2721c5499befSdrh       testcase( regFree1==0 );
27227d176105Sdrh       addr = sqlite3VdbeAddOp1(v, op, r1);
27237d176105Sdrh       VdbeCoverageIf(v, op==TK_ISNULL);
27247d176105Sdrh       VdbeCoverageIf(v, op==TK_NOTNULL);
27259de221dfSdrh       sqlite3VdbeAddOp2(v, OP_AddImm, target, -1);
27266a288a33Sdrh       sqlite3VdbeJumpHere(v, addr);
2727a37cdde0Sdanielk1977       break;
2728f2bc013cSdrh     }
27292282792aSdrh     case TK_AGG_FUNCTION: {
273013449892Sdrh       AggInfo *pInfo = pExpr->pAggInfo;
27317e56e711Sdrh       if( pInfo==0 ){
273233e619fcSdrh         assert( !ExprHasProperty(pExpr, EP_IntValue) );
273333e619fcSdrh         sqlite3ErrorMsg(pParse, "misuse of aggregate: %s()", pExpr->u.zToken);
27347e56e711Sdrh       }else{
27359de221dfSdrh         inReg = pInfo->aFunc[pExpr->iAgg].iMem;
27367e56e711Sdrh       }
27372282792aSdrh       break;
27382282792aSdrh     }
2739cce7d176Sdrh     case TK_FUNCTION: {
274012ffee8cSdrh       ExprList *pFarg;       /* List of function arguments */
274112ffee8cSdrh       int nFarg;             /* Number of function arguments */
274212ffee8cSdrh       FuncDef *pDef;         /* The function definition object */
274312ffee8cSdrh       int nId;               /* Length of the function name in bytes */
274412ffee8cSdrh       const char *zId;       /* The function name */
2745693e6719Sdrh       u32 constMask = 0;     /* Mask of function arguments that are constant */
274612ffee8cSdrh       int i;                 /* Loop counter */
274712ffee8cSdrh       u8 enc = ENC(db);      /* The text encoding used by this database */
274812ffee8cSdrh       CollSeq *pColl = 0;    /* A collating sequence */
274917435752Sdrh 
27506ab3a2ecSdanielk1977       assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
2751c5cd1249Sdrh       if( ExprHasProperty(pExpr, EP_TokenOnly) ){
275212ffee8cSdrh         pFarg = 0;
275312ffee8cSdrh       }else{
275412ffee8cSdrh         pFarg = pExpr->x.pList;
275512ffee8cSdrh       }
275612ffee8cSdrh       nFarg = pFarg ? pFarg->nExpr : 0;
275733e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
275833e619fcSdrh       zId = pExpr->u.zToken;
2759b7916a78Sdrh       nId = sqlite3Strlen30(zId);
276012ffee8cSdrh       pDef = sqlite3FindFunction(db, zId, nId, nFarg, enc, 0);
2761feb306f5Sdrh       if( pDef==0 ){
2762feb306f5Sdrh         sqlite3ErrorMsg(pParse, "unknown function: %.*s()", nId, zId);
2763feb306f5Sdrh         break;
2764feb306f5Sdrh       }
2765ae6bb957Sdrh 
2766ae6bb957Sdrh       /* Attempt a direct implementation of the built-in COALESCE() and
2767ae6bb957Sdrh       ** IFNULL() functions.  This avoids unnecessary evalation of
2768ae6bb957Sdrh       ** arguments past the first non-NULL argument.
2769ae6bb957Sdrh       */
2770d36e1041Sdrh       if( pDef->funcFlags & SQLITE_FUNC_COALESCE ){
2771ae6bb957Sdrh         int endCoalesce = sqlite3VdbeMakeLabel(v);
2772ae6bb957Sdrh         assert( nFarg>=2 );
2773ae6bb957Sdrh         sqlite3ExprCode(pParse, pFarg->a[0].pExpr, target);
2774ae6bb957Sdrh         for(i=1; i<nFarg; i++){
2775ae6bb957Sdrh           sqlite3VdbeAddOp2(v, OP_NotNull, target, endCoalesce);
2776688852abSdrh           VdbeCoverage(v);
2777f49f3523Sdrh           sqlite3ExprCacheRemove(pParse, target, 1);
2778ae6bb957Sdrh           sqlite3ExprCachePush(pParse);
2779ae6bb957Sdrh           sqlite3ExprCode(pParse, pFarg->a[i].pExpr, target);
2780d2490904Sdrh           sqlite3ExprCachePop(pParse);
2781ae6bb957Sdrh         }
2782ae6bb957Sdrh         sqlite3VdbeResolveLabel(v, endCoalesce);
2783ae6bb957Sdrh         break;
2784ae6bb957Sdrh       }
2785ae6bb957Sdrh 
2786cca9f3d2Sdrh       /* The UNLIKELY() function is a no-op.  The result is the value
2787cca9f3d2Sdrh       ** of the first argument.
2788cca9f3d2Sdrh       */
2789cca9f3d2Sdrh       if( pDef->funcFlags & SQLITE_FUNC_UNLIKELY ){
2790cca9f3d2Sdrh         assert( nFarg>=1 );
2791cca9f3d2Sdrh         sqlite3ExprCode(pParse, pFarg->a[0].pExpr, target);
2792cca9f3d2Sdrh         break;
2793cca9f3d2Sdrh       }
2794ae6bb957Sdrh 
2795d1a01edaSdrh       for(i=0; i<nFarg; i++){
2796d1a01edaSdrh         if( i<32 && sqlite3ExprIsConstant(pFarg->a[i].pExpr) ){
2797693e6719Sdrh           testcase( i==31 );
2798693e6719Sdrh           constMask |= MASKBIT32(i);
2799d1a01edaSdrh         }
2800d1a01edaSdrh         if( (pDef->funcFlags & SQLITE_FUNC_NEEDCOLL)!=0 && !pColl ){
2801d1a01edaSdrh           pColl = sqlite3ExprCollSeq(pParse, pFarg->a[i].pExpr);
2802d1a01edaSdrh         }
2803d1a01edaSdrh       }
280412ffee8cSdrh       if( pFarg ){
2805d1a01edaSdrh         if( constMask ){
2806d1a01edaSdrh           r1 = pParse->nMem+1;
2807d1a01edaSdrh           pParse->nMem += nFarg;
2808d1a01edaSdrh         }else{
280912ffee8cSdrh           r1 = sqlite3GetTempRange(pParse, nFarg);
2810d1a01edaSdrh         }
2811a748fdccSdrh 
2812a748fdccSdrh         /* For length() and typeof() functions with a column argument,
2813a748fdccSdrh         ** set the P5 parameter to the OP_Column opcode to OPFLAG_LENGTHARG
2814a748fdccSdrh         ** or OPFLAG_TYPEOFARG respectively, to avoid unnecessary data
2815a748fdccSdrh         ** loading.
2816a748fdccSdrh         */
2817d36e1041Sdrh         if( (pDef->funcFlags & (SQLITE_FUNC_LENGTH|SQLITE_FUNC_TYPEOF))!=0 ){
28184e245a4cSdrh           u8 exprOp;
2819a748fdccSdrh           assert( nFarg==1 );
2820a748fdccSdrh           assert( pFarg->a[0].pExpr!=0 );
28214e245a4cSdrh           exprOp = pFarg->a[0].pExpr->op;
28224e245a4cSdrh           if( exprOp==TK_COLUMN || exprOp==TK_AGG_COLUMN ){
2823a748fdccSdrh             assert( SQLITE_FUNC_LENGTH==OPFLAG_LENGTHARG );
2824a748fdccSdrh             assert( SQLITE_FUNC_TYPEOF==OPFLAG_TYPEOFARG );
2825b1fba286Sdrh             testcase( pDef->funcFlags & OPFLAG_LENGTHARG );
2826b1fba286Sdrh             pFarg->a[0].pExpr->op2 =
2827b1fba286Sdrh                   pDef->funcFlags & (OPFLAG_LENGTHARG|OPFLAG_TYPEOFARG);
2828a748fdccSdrh           }
2829a748fdccSdrh         }
2830a748fdccSdrh 
2831d7d385ddSdrh         sqlite3ExprCachePush(pParse);     /* Ticket 2ea2425d34be */
2832d1a01edaSdrh         sqlite3ExprCodeExprList(pParse, pFarg, r1,
2833d1a01edaSdrh                                 SQLITE_ECEL_DUP|SQLITE_ECEL_FACTOR);
2834d2490904Sdrh         sqlite3ExprCachePop(pParse);      /* Ticket 2ea2425d34be */
2835892d3179Sdrh       }else{
283612ffee8cSdrh         r1 = 0;
2837892d3179Sdrh       }
2838b7f6f68fSdrh #ifndef SQLITE_OMIT_VIRTUALTABLE
2839a43fa227Sdrh       /* Possibly overload the function if the first argument is
2840a43fa227Sdrh       ** a virtual table column.
2841a43fa227Sdrh       **
2842a43fa227Sdrh       ** For infix functions (LIKE, GLOB, REGEXP, and MATCH) use the
2843a43fa227Sdrh       ** second argument, not the first, as the argument to test to
2844a43fa227Sdrh       ** see if it is a column in a virtual table.  This is done because
2845a43fa227Sdrh       ** the left operand of infix functions (the operand we want to
2846a43fa227Sdrh       ** control overloading) ends up as the second argument to the
2847a43fa227Sdrh       ** function.  The expression "A glob B" is equivalent to
2848a43fa227Sdrh       ** "glob(B,A).  We want to use the A in "A glob B" to test
2849a43fa227Sdrh       ** for function overloading.  But we use the B term in "glob(B,A)".
2850a43fa227Sdrh       */
285112ffee8cSdrh       if( nFarg>=2 && (pExpr->flags & EP_InfixFunc) ){
285212ffee8cSdrh         pDef = sqlite3VtabOverloadFunction(db, pDef, nFarg, pFarg->a[1].pExpr);
285312ffee8cSdrh       }else if( nFarg>0 ){
285412ffee8cSdrh         pDef = sqlite3VtabOverloadFunction(db, pDef, nFarg, pFarg->a[0].pExpr);
2855b7f6f68fSdrh       }
2856b7f6f68fSdrh #endif
2857d36e1041Sdrh       if( pDef->funcFlags & SQLITE_FUNC_NEEDCOLL ){
28588b213899Sdrh         if( !pColl ) pColl = db->pDfltColl;
285966a5167bSdrh         sqlite3VdbeAddOp4(v, OP_CollSeq, 0, 0, 0, (char *)pColl, P4_COLLSEQ);
2860682f68b0Sdanielk1977       }
28612dcef11bSdrh       sqlite3VdbeAddOp4(v, OP_Function, constMask, r1, target,
286266a5167bSdrh                         (char*)pDef, P4_FUNCDEF);
286312ffee8cSdrh       sqlite3VdbeChangeP5(v, (u8)nFarg);
2864d1a01edaSdrh       if( nFarg && constMask==0 ){
286512ffee8cSdrh         sqlite3ReleaseTempRange(pParse, r1, nFarg);
28662dcef11bSdrh       }
28676ec2733bSdrh       break;
28686ec2733bSdrh     }
2869fe2093d7Sdrh #ifndef SQLITE_OMIT_SUBQUERY
2870fe2093d7Sdrh     case TK_EXISTS:
287119a775c2Sdrh     case TK_SELECT: {
2872c5499befSdrh       testcase( op==TK_EXISTS );
2873c5499befSdrh       testcase( op==TK_SELECT );
28741450bc6eSdrh       inReg = sqlite3CodeSubselect(pParse, pExpr, 0, 0);
287519a775c2Sdrh       break;
287619a775c2Sdrh     }
2877fef5208cSdrh     case TK_IN: {
2878e3365e6cSdrh       int destIfFalse = sqlite3VdbeMakeLabel(v);
2879e3365e6cSdrh       int destIfNull = sqlite3VdbeMakeLabel(v);
2880e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Null, 0, target);
2881e3365e6cSdrh       sqlite3ExprCodeIN(pParse, pExpr, destIfFalse, destIfNull);
288266ba23ceSdrh       sqlite3VdbeAddOp2(v, OP_Integer, 1, target);
2883e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfFalse);
2884e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_AddImm, target, 0);
2885e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfNull);
2886fef5208cSdrh       break;
2887fef5208cSdrh     }
2888e3365e6cSdrh #endif /* SQLITE_OMIT_SUBQUERY */
2889e3365e6cSdrh 
2890e3365e6cSdrh 
28912dcef11bSdrh     /*
28922dcef11bSdrh     **    x BETWEEN y AND z
28932dcef11bSdrh     **
28942dcef11bSdrh     ** This is equivalent to
28952dcef11bSdrh     **
28962dcef11bSdrh     **    x>=y AND x<=z
28972dcef11bSdrh     **
28982dcef11bSdrh     ** X is stored in pExpr->pLeft.
28992dcef11bSdrh     ** Y is stored in pExpr->pList->a[0].pExpr.
29002dcef11bSdrh     ** Z is stored in pExpr->pList->a[1].pExpr.
29012dcef11bSdrh     */
2902fef5208cSdrh     case TK_BETWEEN: {
2903be5c89acSdrh       Expr *pLeft = pExpr->pLeft;
29046ab3a2ecSdanielk1977       struct ExprList_item *pLItem = pExpr->x.pList->a;
2905be5c89acSdrh       Expr *pRight = pLItem->pExpr;
290635573356Sdrh 
2907b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pLeft, &regFree1);
2908b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pRight, &regFree2);
2909c5499befSdrh       testcase( regFree1==0 );
2910c5499befSdrh       testcase( regFree2==0 );
29112dcef11bSdrh       r3 = sqlite3GetTempReg(pParse);
2912678ccce8Sdrh       r4 = sqlite3GetTempReg(pParse);
291335573356Sdrh       codeCompare(pParse, pLeft, pRight, OP_Ge,
29147d176105Sdrh                   r1, r2, r3, SQLITE_STOREP2);  VdbeCoverage(v);
2915be5c89acSdrh       pLItem++;
2916be5c89acSdrh       pRight = pLItem->pExpr;
29172dcef11bSdrh       sqlite3ReleaseTempReg(pParse, regFree2);
29182dcef11bSdrh       r2 = sqlite3ExprCodeTemp(pParse, pRight, &regFree2);
2919c5499befSdrh       testcase( regFree2==0 );
2920678ccce8Sdrh       codeCompare(pParse, pLeft, pRight, OP_Le, r1, r2, r4, SQLITE_STOREP2);
2921688852abSdrh       VdbeCoverage(v);
2922678ccce8Sdrh       sqlite3VdbeAddOp3(v, OP_And, r3, r4, target);
29232dcef11bSdrh       sqlite3ReleaseTempReg(pParse, r3);
2924678ccce8Sdrh       sqlite3ReleaseTempReg(pParse, r4);
2925fef5208cSdrh       break;
2926fef5208cSdrh     }
2927ae80ddeaSdrh     case TK_COLLATE:
29284f07e5fbSdrh     case TK_UPLUS: {
29292dcef11bSdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
2930a2e00042Sdrh       break;
2931a2e00042Sdrh     }
29322dcef11bSdrh 
2933165921a7Sdan     case TK_TRIGGER: {
293465a7cd16Sdan       /* If the opcode is TK_TRIGGER, then the expression is a reference
293565a7cd16Sdan       ** to a column in the new.* or old.* pseudo-tables available to
293665a7cd16Sdan       ** trigger programs. In this case Expr.iTable is set to 1 for the
293765a7cd16Sdan       ** new.* pseudo-table, or 0 for the old.* pseudo-table. Expr.iColumn
293865a7cd16Sdan       ** is set to the column of the pseudo-table to read, or to -1 to
293965a7cd16Sdan       ** read the rowid field.
294065a7cd16Sdan       **
294165a7cd16Sdan       ** The expression is implemented using an OP_Param opcode. The p1
294265a7cd16Sdan       ** parameter is set to 0 for an old.rowid reference, or to (i+1)
294365a7cd16Sdan       ** to reference another column of the old.* pseudo-table, where
294465a7cd16Sdan       ** i is the index of the column. For a new.rowid reference, p1 is
294565a7cd16Sdan       ** set to (n+1), where n is the number of columns in each pseudo-table.
294665a7cd16Sdan       ** For a reference to any other column in the new.* pseudo-table, p1
294765a7cd16Sdan       ** is set to (n+2+i), where n and i are as defined previously. For
294865a7cd16Sdan       ** example, if the table on which triggers are being fired is
294965a7cd16Sdan       ** declared as:
295065a7cd16Sdan       **
295165a7cd16Sdan       **   CREATE TABLE t1(a, b);
295265a7cd16Sdan       **
295365a7cd16Sdan       ** Then p1 is interpreted as follows:
295465a7cd16Sdan       **
295565a7cd16Sdan       **   p1==0   ->    old.rowid     p1==3   ->    new.rowid
295665a7cd16Sdan       **   p1==1   ->    old.a         p1==4   ->    new.a
295765a7cd16Sdan       **   p1==2   ->    old.b         p1==5   ->    new.b
295865a7cd16Sdan       */
29592832ad42Sdan       Table *pTab = pExpr->pTab;
296065a7cd16Sdan       int p1 = pExpr->iTable * (pTab->nCol+1) + 1 + pExpr->iColumn;
296165a7cd16Sdan 
296265a7cd16Sdan       assert( pExpr->iTable==0 || pExpr->iTable==1 );
296365a7cd16Sdan       assert( pExpr->iColumn>=-1 && pExpr->iColumn<pTab->nCol );
296465a7cd16Sdan       assert( pTab->iPKey<0 || pExpr->iColumn!=pTab->iPKey );
296565a7cd16Sdan       assert( p1>=0 && p1<(pTab->nCol*2+2) );
296665a7cd16Sdan 
296765a7cd16Sdan       sqlite3VdbeAddOp2(v, OP_Param, p1, target);
296876d462eeSdan       VdbeComment((v, "%s.%s -> $%d",
2969165921a7Sdan         (pExpr->iTable ? "new" : "old"),
297076d462eeSdan         (pExpr->iColumn<0 ? "rowid" : pExpr->pTab->aCol[pExpr->iColumn].zName),
297176d462eeSdan         target
2972165921a7Sdan       ));
297365a7cd16Sdan 
297444dbca83Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
297565a7cd16Sdan       /* If the column has REAL affinity, it may currently be stored as an
297665a7cd16Sdan       ** integer. Use OP_RealAffinity to make sure it is really real.  */
29772832ad42Sdan       if( pExpr->iColumn>=0
29782832ad42Sdan        && pTab->aCol[pExpr->iColumn].affinity==SQLITE_AFF_REAL
29792832ad42Sdan       ){
29802832ad42Sdan         sqlite3VdbeAddOp1(v, OP_RealAffinity, target);
29812832ad42Sdan       }
298244dbca83Sdrh #endif
2983165921a7Sdan       break;
2984165921a7Sdan     }
2985165921a7Sdan 
2986165921a7Sdan 
29872dcef11bSdrh     /*
29882dcef11bSdrh     ** Form A:
29892dcef11bSdrh     **   CASE x WHEN e1 THEN r1 WHEN e2 THEN r2 ... WHEN eN THEN rN ELSE y END
29902dcef11bSdrh     **
29912dcef11bSdrh     ** Form B:
29922dcef11bSdrh     **   CASE WHEN e1 THEN r1 WHEN e2 THEN r2 ... WHEN eN THEN rN ELSE y END
29932dcef11bSdrh     **
29942dcef11bSdrh     ** Form A is can be transformed into the equivalent form B as follows:
29952dcef11bSdrh     **   CASE WHEN x=e1 THEN r1 WHEN x=e2 THEN r2 ...
29962dcef11bSdrh     **        WHEN x=eN THEN rN ELSE y END
29972dcef11bSdrh     **
29982dcef11bSdrh     ** X (if it exists) is in pExpr->pLeft.
2999c5cd1249Sdrh     ** Y is in the last element of pExpr->x.pList if pExpr->x.pList->nExpr is
3000c5cd1249Sdrh     ** odd.  The Y is also optional.  If the number of elements in x.pList
3001c5cd1249Sdrh     ** is even, then Y is omitted and the "otherwise" result is NULL.
30022dcef11bSdrh     ** Ei is in pExpr->pList->a[i*2] and Ri is pExpr->pList->a[i*2+1].
30032dcef11bSdrh     **
30042dcef11bSdrh     ** The result of the expression is the Ri for the first matching Ei,
30052dcef11bSdrh     ** or if there is no matching Ei, the ELSE term Y, or if there is
30062dcef11bSdrh     ** no ELSE term, NULL.
30072dcef11bSdrh     */
300833cd4909Sdrh     default: assert( op==TK_CASE ); {
30092dcef11bSdrh       int endLabel;                     /* GOTO label for end of CASE stmt */
30102dcef11bSdrh       int nextCase;                     /* GOTO label for next WHEN clause */
30112dcef11bSdrh       int nExpr;                        /* 2x number of WHEN terms */
30122dcef11bSdrh       int i;                            /* Loop counter */
30132dcef11bSdrh       ExprList *pEList;                 /* List of WHEN terms */
30142dcef11bSdrh       struct ExprList_item *aListelem;  /* Array of WHEN terms */
30152dcef11bSdrh       Expr opCompare;                   /* The X==Ei expression */
30162dcef11bSdrh       Expr *pX;                         /* The X expression */
30171bd10f8aSdrh       Expr *pTest = 0;                  /* X==Ei (form A) or just Ei (form B) */
3018ceea3321Sdrh       VVA_ONLY( int iCacheLevel = pParse->iCacheLevel; )
301917a7f8ddSdrh 
30206ab3a2ecSdanielk1977       assert( !ExprHasProperty(pExpr, EP_xIsSelect) && pExpr->x.pList );
30216ab3a2ecSdanielk1977       assert(pExpr->x.pList->nExpr > 0);
30226ab3a2ecSdanielk1977       pEList = pExpr->x.pList;
3023be5c89acSdrh       aListelem = pEList->a;
3024be5c89acSdrh       nExpr = pEList->nExpr;
30252dcef11bSdrh       endLabel = sqlite3VdbeMakeLabel(v);
30262dcef11bSdrh       if( (pX = pExpr->pLeft)!=0 ){
302710d1edf0Sdrh         tempX = *pX;
302833cd4909Sdrh         testcase( pX->op==TK_COLUMN );
302910d1edf0Sdrh         exprToRegister(&tempX, sqlite3ExprCodeTemp(pParse, pX, &regFree1));
3030c5499befSdrh         testcase( regFree1==0 );
30312dcef11bSdrh         opCompare.op = TK_EQ;
303210d1edf0Sdrh         opCompare.pLeft = &tempX;
30332dcef11bSdrh         pTest = &opCompare;
30348b1db07fSdrh         /* Ticket b351d95f9cd5ef17e9d9dbae18f5ca8611190001:
30358b1db07fSdrh         ** The value in regFree1 might get SCopy-ed into the file result.
30368b1db07fSdrh         ** So make sure that the regFree1 register is not reused for other
30378b1db07fSdrh         ** purposes and possibly overwritten.  */
30388b1db07fSdrh         regFree1 = 0;
3039cce7d176Sdrh       }
3040c5cd1249Sdrh       for(i=0; i<nExpr-1; i=i+2){
3041ceea3321Sdrh         sqlite3ExprCachePush(pParse);
30422dcef11bSdrh         if( pX ){
30431bd10f8aSdrh           assert( pTest!=0 );
30442dcef11bSdrh           opCompare.pRight = aListelem[i].pExpr;
3045f5905aa7Sdrh         }else{
30462dcef11bSdrh           pTest = aListelem[i].pExpr;
304717a7f8ddSdrh         }
30482dcef11bSdrh         nextCase = sqlite3VdbeMakeLabel(v);
304933cd4909Sdrh         testcase( pTest->op==TK_COLUMN );
30502dcef11bSdrh         sqlite3ExprIfFalse(pParse, pTest, nextCase, SQLITE_JUMPIFNULL);
3051c5499befSdrh         testcase( aListelem[i+1].pExpr->op==TK_COLUMN );
30529de221dfSdrh         sqlite3ExprCode(pParse, aListelem[i+1].pExpr, target);
30532dcef11bSdrh         sqlite3VdbeAddOp2(v, OP_Goto, 0, endLabel);
3054d2490904Sdrh         sqlite3ExprCachePop(pParse);
30552dcef11bSdrh         sqlite3VdbeResolveLabel(v, nextCase);
3056f570f011Sdrh       }
3057c5cd1249Sdrh       if( (nExpr&1)!=0 ){
3058ceea3321Sdrh         sqlite3ExprCachePush(pParse);
3059c5cd1249Sdrh         sqlite3ExprCode(pParse, pEList->a[nExpr-1].pExpr, target);
3060d2490904Sdrh         sqlite3ExprCachePop(pParse);
306117a7f8ddSdrh       }else{
30629de221dfSdrh         sqlite3VdbeAddOp2(v, OP_Null, 0, target);
306317a7f8ddSdrh       }
3064c1f4a19bSdanielk1977       assert( db->mallocFailed || pParse->nErr>0
3065c1f4a19bSdanielk1977            || pParse->iCacheLevel==iCacheLevel );
30662dcef11bSdrh       sqlite3VdbeResolveLabel(v, endLabel);
30676f34903eSdanielk1977       break;
30686f34903eSdanielk1977     }
30695338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_TRIGGER
30706f34903eSdanielk1977     case TK_RAISE: {
3071165921a7Sdan       assert( pExpr->affinity==OE_Rollback
3072165921a7Sdan            || pExpr->affinity==OE_Abort
3073165921a7Sdan            || pExpr->affinity==OE_Fail
3074165921a7Sdan            || pExpr->affinity==OE_Ignore
3075165921a7Sdan       );
3076e0af83acSdan       if( !pParse->pTriggerTab ){
3077e0af83acSdan         sqlite3ErrorMsg(pParse,
3078e0af83acSdan                        "RAISE() may only be used within a trigger-program");
3079e0af83acSdan         return 0;
3080e0af83acSdan       }
3081e0af83acSdan       if( pExpr->affinity==OE_Abort ){
3082e0af83acSdan         sqlite3MayAbort(pParse);
3083e0af83acSdan       }
308433e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
3085e0af83acSdan       if( pExpr->affinity==OE_Ignore ){
3086e0af83acSdan         sqlite3VdbeAddOp4(
3087e0af83acSdan             v, OP_Halt, SQLITE_OK, OE_Ignore, 0, pExpr->u.zToken,0);
3088688852abSdrh         VdbeCoverage(v);
3089e0af83acSdan       }else{
3090433dccfbSdrh         sqlite3HaltConstraint(pParse, SQLITE_CONSTRAINT_TRIGGER,
3091f9c8ce3cSdrh                               pExpr->affinity, pExpr->u.zToken, 0, 0);
3092e0af83acSdan       }
3093e0af83acSdan 
3094ffe07b2dSdrh       break;
309517a7f8ddSdrh     }
30965338a5f7Sdanielk1977 #endif
3097ffe07b2dSdrh   }
30982dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
30992dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
31002dcef11bSdrh   return inReg;
31015b6afba9Sdrh }
31022dcef11bSdrh 
31032dcef11bSdrh /*
3104d1a01edaSdrh ** Factor out the code of the given expression to initialization time.
3105d1a01edaSdrh */
3106d673cddaSdrh void sqlite3ExprCodeAtInit(
3107d673cddaSdrh   Parse *pParse,    /* Parsing context */
3108d673cddaSdrh   Expr *pExpr,      /* The expression to code when the VDBE initializes */
3109d673cddaSdrh   int regDest,      /* Store the value in this register */
3110d673cddaSdrh   u8 reusable       /* True if this expression is reusable */
3111d673cddaSdrh ){
3112d1a01edaSdrh   ExprList *p;
3113d9f158e7Sdrh   assert( ConstFactorOk(pParse) );
3114d1a01edaSdrh   p = pParse->pConstExpr;
3115d1a01edaSdrh   pExpr = sqlite3ExprDup(pParse->db, pExpr, 0);
3116d1a01edaSdrh   p = sqlite3ExprListAppend(pParse, p, pExpr);
3117d673cddaSdrh   if( p ){
3118d673cddaSdrh      struct ExprList_item *pItem = &p->a[p->nExpr-1];
3119d673cddaSdrh      pItem->u.iConstExprReg = regDest;
3120d673cddaSdrh      pItem->reusable = reusable;
3121d673cddaSdrh   }
3122d1a01edaSdrh   pParse->pConstExpr = p;
3123d1a01edaSdrh }
3124d1a01edaSdrh 
3125d1a01edaSdrh /*
31262dcef11bSdrh ** Generate code to evaluate an expression and store the results
31272dcef11bSdrh ** into a register.  Return the register number where the results
31282dcef11bSdrh ** are stored.
31292dcef11bSdrh **
31302dcef11bSdrh ** If the register is a temporary register that can be deallocated,
3131678ccce8Sdrh ** then write its number into *pReg.  If the result register is not
31322dcef11bSdrh ** a temporary, then set *pReg to zero.
3133f30a969bSdrh **
3134f30a969bSdrh ** If pExpr is a constant, then this routine might generate this
3135f30a969bSdrh ** code to fill the register in the initialization section of the
3136f30a969bSdrh ** VDBE program, in order to factor it out of the evaluation loop.
31372dcef11bSdrh */
31382dcef11bSdrh int sqlite3ExprCodeTemp(Parse *pParse, Expr *pExpr, int *pReg){
3139f30a969bSdrh   int r2;
3140f30a969bSdrh   pExpr = sqlite3ExprSkipCollate(pExpr);
3141d9f158e7Sdrh   if( ConstFactorOk(pParse)
3142f30a969bSdrh    && pExpr->op!=TK_REGISTER
3143f30a969bSdrh    && sqlite3ExprIsConstantNotJoin(pExpr)
3144f30a969bSdrh   ){
3145f30a969bSdrh     ExprList *p = pParse->pConstExpr;
3146f30a969bSdrh     int i;
3147f30a969bSdrh     *pReg  = 0;
3148f30a969bSdrh     if( p ){
3149d673cddaSdrh       struct ExprList_item *pItem;
3150d673cddaSdrh       for(pItem=p->a, i=p->nExpr; i>0; pItem++, i--){
3151d673cddaSdrh         if( pItem->reusable && sqlite3ExprCompare(pItem->pExpr,pExpr,-1)==0 ){
3152d673cddaSdrh           return pItem->u.iConstExprReg;
3153f30a969bSdrh         }
3154f30a969bSdrh       }
3155f30a969bSdrh     }
3156f30a969bSdrh     r2 = ++pParse->nMem;
3157d673cddaSdrh     sqlite3ExprCodeAtInit(pParse, pExpr, r2, 1);
3158f30a969bSdrh   }else{
31592dcef11bSdrh     int r1 = sqlite3GetTempReg(pParse);
3160f30a969bSdrh     r2 = sqlite3ExprCodeTarget(pParse, pExpr, r1);
31612dcef11bSdrh     if( r2==r1 ){
31622dcef11bSdrh       *pReg = r1;
31632dcef11bSdrh     }else{
31642dcef11bSdrh       sqlite3ReleaseTempReg(pParse, r1);
31652dcef11bSdrh       *pReg = 0;
31662dcef11bSdrh     }
3167f30a969bSdrh   }
31682dcef11bSdrh   return r2;
31692dcef11bSdrh }
31702dcef11bSdrh 
31712dcef11bSdrh /*
31722dcef11bSdrh ** Generate code that will evaluate expression pExpr and store the
31732dcef11bSdrh ** results in register target.  The results are guaranteed to appear
31742dcef11bSdrh ** in register target.
31752dcef11bSdrh */
317605a86c5cSdrh void sqlite3ExprCode(Parse *pParse, Expr *pExpr, int target){
31779cbf3425Sdrh   int inReg;
31789cbf3425Sdrh 
31799cbf3425Sdrh   assert( target>0 && target<=pParse->nMem );
3180ebc16717Sdrh   if( pExpr && pExpr->op==TK_REGISTER ){
3181ebc16717Sdrh     sqlite3VdbeAddOp2(pParse->pVdbe, OP_Copy, pExpr->iTable, target);
3182ebc16717Sdrh   }else{
31839cbf3425Sdrh     inReg = sqlite3ExprCodeTarget(pParse, pExpr, target);
31840e359b30Sdrh     assert( pParse->pVdbe || pParse->db->mallocFailed );
31850e359b30Sdrh     if( inReg!=target && pParse->pVdbe ){
31869cbf3425Sdrh       sqlite3VdbeAddOp2(pParse->pVdbe, OP_SCopy, inReg, target);
318717a7f8ddSdrh     }
3188ebc16717Sdrh   }
318905a86c5cSdrh }
319005a86c5cSdrh 
319105a86c5cSdrh /*
319205a86c5cSdrh ** Generate code that will evaluate expression pExpr and store the
319305a86c5cSdrh ** results in register target.  The results are guaranteed to appear
319405a86c5cSdrh ** in register target.  If the expression is constant, then this routine
319505a86c5cSdrh ** might choose to code the expression at initialization time.
319605a86c5cSdrh */
319705a86c5cSdrh void sqlite3ExprCodeFactorable(Parse *pParse, Expr *pExpr, int target){
319805a86c5cSdrh   if( pParse->okConstFactor && sqlite3ExprIsConstant(pExpr) ){
319905a86c5cSdrh     sqlite3ExprCodeAtInit(pParse, pExpr, target, 0);
320005a86c5cSdrh   }else{
320105a86c5cSdrh     sqlite3ExprCode(pParse, pExpr, target);
320205a86c5cSdrh   }
3203cce7d176Sdrh }
3204cce7d176Sdrh 
3205cce7d176Sdrh /*
32062dcef11bSdrh ** Generate code that evalutes the given expression and puts the result
3207de4fcfddSdrh ** in register target.
320825303780Sdrh **
32092dcef11bSdrh ** Also make a copy of the expression results into another "cache" register
32102dcef11bSdrh ** and modify the expression so that the next time it is evaluated,
32112dcef11bSdrh ** the result is a copy of the cache register.
32122dcef11bSdrh **
32132dcef11bSdrh ** This routine is used for expressions that are used multiple
32142dcef11bSdrh ** times.  They are evaluated once and the results of the expression
32152dcef11bSdrh ** are reused.
321625303780Sdrh */
321705a86c5cSdrh void sqlite3ExprCodeAndCache(Parse *pParse, Expr *pExpr, int target){
321825303780Sdrh   Vdbe *v = pParse->pVdbe;
321925303780Sdrh   int iMem;
322005a86c5cSdrh 
322105a86c5cSdrh   assert( target>0 );
322205a86c5cSdrh   assert( pExpr->op!=TK_REGISTER );
322305a86c5cSdrh   sqlite3ExprCode(pParse, pExpr, target);
32242dcef11bSdrh   iMem = ++pParse->nMem;
322505a86c5cSdrh   sqlite3VdbeAddOp2(v, OP_Copy, target, iMem);
3226a4c3c87eSdrh   exprToRegister(pExpr, iMem);
322725303780Sdrh }
32282dcef11bSdrh 
3229678a9aa7Sdrh #if defined(SQLITE_ENABLE_TREE_EXPLAIN)
32307e02e5e6Sdrh /*
32317e02e5e6Sdrh ** Generate a human-readable explanation of an expression tree.
32327e02e5e6Sdrh */
3233a84203a0Sdrh void sqlite3ExplainExpr(Vdbe *pOut, Expr *pExpr){
3234a84203a0Sdrh   int op;                   /* The opcode being coded */
3235a84203a0Sdrh   const char *zBinOp = 0;   /* Binary operator */
3236a84203a0Sdrh   const char *zUniOp = 0;   /* Unary operator */
3237a84203a0Sdrh   if( pExpr==0 ){
3238a84203a0Sdrh     op = TK_NULL;
32397e02e5e6Sdrh   }else{
3240a84203a0Sdrh     op = pExpr->op;
32417e02e5e6Sdrh   }
3242a84203a0Sdrh   switch( op ){
3243a84203a0Sdrh     case TK_AGG_COLUMN: {
324404b8342bSdrh       sqlite3ExplainPrintf(pOut, "AGG{%d:%d}",
324504b8342bSdrh             pExpr->iTable, pExpr->iColumn);
3246a84203a0Sdrh       break;
32477e02e5e6Sdrh     }
3248a84203a0Sdrh     case TK_COLUMN: {
3249a84203a0Sdrh       if( pExpr->iTable<0 ){
3250a84203a0Sdrh         /* This only happens when coding check constraints */
3251a84203a0Sdrh         sqlite3ExplainPrintf(pOut, "COLUMN(%d)", pExpr->iColumn);
3252a84203a0Sdrh       }else{
325304b8342bSdrh         sqlite3ExplainPrintf(pOut, "{%d:%d}",
325404b8342bSdrh                              pExpr->iTable, pExpr->iColumn);
3255a84203a0Sdrh       }
3256a84203a0Sdrh       break;
3257a84203a0Sdrh     }
3258a84203a0Sdrh     case TK_INTEGER: {
3259a84203a0Sdrh       if( pExpr->flags & EP_IntValue ){
326004b8342bSdrh         sqlite3ExplainPrintf(pOut, "%d", pExpr->u.iValue);
3261a84203a0Sdrh       }else{
326204b8342bSdrh         sqlite3ExplainPrintf(pOut, "%s", pExpr->u.zToken);
3263a84203a0Sdrh       }
3264a84203a0Sdrh       break;
3265a84203a0Sdrh     }
3266a84203a0Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
3267a84203a0Sdrh     case TK_FLOAT: {
326804b8342bSdrh       sqlite3ExplainPrintf(pOut,"%s", pExpr->u.zToken);
3269a84203a0Sdrh       break;
3270a84203a0Sdrh     }
3271a84203a0Sdrh #endif
3272a84203a0Sdrh     case TK_STRING: {
327304b8342bSdrh       sqlite3ExplainPrintf(pOut,"%Q", pExpr->u.zToken);
3274a84203a0Sdrh       break;
3275a84203a0Sdrh     }
3276a84203a0Sdrh     case TK_NULL: {
3277a84203a0Sdrh       sqlite3ExplainPrintf(pOut,"NULL");
3278a84203a0Sdrh       break;
3279a84203a0Sdrh     }
3280a84203a0Sdrh #ifndef SQLITE_OMIT_BLOB_LITERAL
3281a84203a0Sdrh     case TK_BLOB: {
328204b8342bSdrh       sqlite3ExplainPrintf(pOut,"%s", pExpr->u.zToken);
3283a84203a0Sdrh       break;
3284a84203a0Sdrh     }
3285a84203a0Sdrh #endif
3286a84203a0Sdrh     case TK_VARIABLE: {
3287a84203a0Sdrh       sqlite3ExplainPrintf(pOut,"VARIABLE(%s,%d)",
3288a84203a0Sdrh                            pExpr->u.zToken, pExpr->iColumn);
3289a84203a0Sdrh       break;
3290a84203a0Sdrh     }
3291a84203a0Sdrh     case TK_REGISTER: {
3292a84203a0Sdrh       sqlite3ExplainPrintf(pOut,"REGISTER(%d)", pExpr->iTable);
3293a84203a0Sdrh       break;
3294a84203a0Sdrh     }
3295a84203a0Sdrh     case TK_AS: {
3296a84203a0Sdrh       sqlite3ExplainExpr(pOut, pExpr->pLeft);
3297a84203a0Sdrh       break;
3298a84203a0Sdrh     }
3299a84203a0Sdrh #ifndef SQLITE_OMIT_CAST
3300a84203a0Sdrh     case TK_CAST: {
3301a84203a0Sdrh       /* Expressions of the form:   CAST(pLeft AS token) */
3302a84203a0Sdrh       const char *zAff = "unk";
3303fdaac671Sdrh       switch( sqlite3AffinityType(pExpr->u.zToken, 0) ){
3304a84203a0Sdrh         case SQLITE_AFF_TEXT:    zAff = "TEXT";     break;
3305a84203a0Sdrh         case SQLITE_AFF_NONE:    zAff = "NONE";     break;
3306a84203a0Sdrh         case SQLITE_AFF_NUMERIC: zAff = "NUMERIC";  break;
3307a84203a0Sdrh         case SQLITE_AFF_INTEGER: zAff = "INTEGER";  break;
3308a84203a0Sdrh         case SQLITE_AFF_REAL:    zAff = "REAL";     break;
3309a84203a0Sdrh       }
3310a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "CAST-%s(", zAff);
3311a84203a0Sdrh       sqlite3ExplainExpr(pOut, pExpr->pLeft);
3312a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ")");
3313a84203a0Sdrh       break;
3314a84203a0Sdrh     }
3315a84203a0Sdrh #endif /* SQLITE_OMIT_CAST */
3316a84203a0Sdrh     case TK_LT:      zBinOp = "LT";     break;
3317a84203a0Sdrh     case TK_LE:      zBinOp = "LE";     break;
3318a84203a0Sdrh     case TK_GT:      zBinOp = "GT";     break;
3319a84203a0Sdrh     case TK_GE:      zBinOp = "GE";     break;
3320a84203a0Sdrh     case TK_NE:      zBinOp = "NE";     break;
3321a84203a0Sdrh     case TK_EQ:      zBinOp = "EQ";     break;
3322a84203a0Sdrh     case TK_IS:      zBinOp = "IS";     break;
3323a84203a0Sdrh     case TK_ISNOT:   zBinOp = "ISNOT";  break;
3324a84203a0Sdrh     case TK_AND:     zBinOp = "AND";    break;
3325a84203a0Sdrh     case TK_OR:      zBinOp = "OR";     break;
3326a84203a0Sdrh     case TK_PLUS:    zBinOp = "ADD";    break;
3327a84203a0Sdrh     case TK_STAR:    zBinOp = "MUL";    break;
3328a84203a0Sdrh     case TK_MINUS:   zBinOp = "SUB";    break;
3329a84203a0Sdrh     case TK_REM:     zBinOp = "REM";    break;
3330a84203a0Sdrh     case TK_BITAND:  zBinOp = "BITAND"; break;
3331a84203a0Sdrh     case TK_BITOR:   zBinOp = "BITOR";  break;
3332a84203a0Sdrh     case TK_SLASH:   zBinOp = "DIV";    break;
3333a84203a0Sdrh     case TK_LSHIFT:  zBinOp = "LSHIFT"; break;
3334a84203a0Sdrh     case TK_RSHIFT:  zBinOp = "RSHIFT"; break;
3335a84203a0Sdrh     case TK_CONCAT:  zBinOp = "CONCAT"; break;
3336a84203a0Sdrh 
3337a84203a0Sdrh     case TK_UMINUS:  zUniOp = "UMINUS"; break;
3338a84203a0Sdrh     case TK_UPLUS:   zUniOp = "UPLUS";  break;
3339a84203a0Sdrh     case TK_BITNOT:  zUniOp = "BITNOT"; break;
3340a84203a0Sdrh     case TK_NOT:     zUniOp = "NOT";    break;
3341a84203a0Sdrh     case TK_ISNULL:  zUniOp = "ISNULL"; break;
3342a84203a0Sdrh     case TK_NOTNULL: zUniOp = "NOTNULL"; break;
3343a84203a0Sdrh 
33447a66da13Sdrh     case TK_COLLATE: {
33457a66da13Sdrh       sqlite3ExplainExpr(pOut, pExpr->pLeft);
33467a66da13Sdrh       sqlite3ExplainPrintf(pOut,".COLLATE(%s)",pExpr->u.zToken);
33477a66da13Sdrh       break;
33487a66da13Sdrh     }
33497a66da13Sdrh 
3350a84203a0Sdrh     case TK_AGG_FUNCTION:
3351a84203a0Sdrh     case TK_FUNCTION: {
3352a84203a0Sdrh       ExprList *pFarg;       /* List of function arguments */
3353c5cd1249Sdrh       if( ExprHasProperty(pExpr, EP_TokenOnly) ){
3354a84203a0Sdrh         pFarg = 0;
3355a84203a0Sdrh       }else{
3356a84203a0Sdrh         pFarg = pExpr->x.pList;
3357a84203a0Sdrh       }
3358ed551b95Sdrh       if( op==TK_AGG_FUNCTION ){
3359ed551b95Sdrh         sqlite3ExplainPrintf(pOut, "AGG_FUNCTION%d:%s(",
3360ed551b95Sdrh                              pExpr->op2, pExpr->u.zToken);
3361ed551b95Sdrh       }else{
3362ed551b95Sdrh         sqlite3ExplainPrintf(pOut, "FUNCTION:%s(", pExpr->u.zToken);
3363ed551b95Sdrh       }
3364a84203a0Sdrh       if( pFarg ){
3365a84203a0Sdrh         sqlite3ExplainExprList(pOut, pFarg);
33667e02e5e6Sdrh       }
33677e02e5e6Sdrh       sqlite3ExplainPrintf(pOut, ")");
3368a84203a0Sdrh       break;
3369a84203a0Sdrh     }
3370a84203a0Sdrh #ifndef SQLITE_OMIT_SUBQUERY
3371a84203a0Sdrh     case TK_EXISTS: {
3372a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "EXISTS(");
3373a84203a0Sdrh       sqlite3ExplainSelect(pOut, pExpr->x.pSelect);
3374a84203a0Sdrh       sqlite3ExplainPrintf(pOut,")");
3375a84203a0Sdrh       break;
3376a84203a0Sdrh     }
3377a84203a0Sdrh     case TK_SELECT: {
3378a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "(");
3379a84203a0Sdrh       sqlite3ExplainSelect(pOut, pExpr->x.pSelect);
3380a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ")");
3381a84203a0Sdrh       break;
3382a84203a0Sdrh     }
3383a84203a0Sdrh     case TK_IN: {
3384a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "IN(");
3385a84203a0Sdrh       sqlite3ExplainExpr(pOut, pExpr->pLeft);
3386a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ",");
3387a84203a0Sdrh       if( ExprHasProperty(pExpr, EP_xIsSelect) ){
3388a84203a0Sdrh         sqlite3ExplainSelect(pOut, pExpr->x.pSelect);
3389a84203a0Sdrh       }else{
3390a84203a0Sdrh         sqlite3ExplainExprList(pOut, pExpr->x.pList);
3391a84203a0Sdrh       }
3392a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ")");
3393a84203a0Sdrh       break;
3394a84203a0Sdrh     }
3395a84203a0Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
3396a84203a0Sdrh 
3397a84203a0Sdrh     /*
3398a84203a0Sdrh     **    x BETWEEN y AND z
3399a84203a0Sdrh     **
3400a84203a0Sdrh     ** This is equivalent to
3401a84203a0Sdrh     **
3402a84203a0Sdrh     **    x>=y AND x<=z
3403a84203a0Sdrh     **
3404a84203a0Sdrh     ** X is stored in pExpr->pLeft.
3405a84203a0Sdrh     ** Y is stored in pExpr->pList->a[0].pExpr.
3406a84203a0Sdrh     ** Z is stored in pExpr->pList->a[1].pExpr.
3407a84203a0Sdrh     */
3408a84203a0Sdrh     case TK_BETWEEN: {
3409a84203a0Sdrh       Expr *pX = pExpr->pLeft;
3410a84203a0Sdrh       Expr *pY = pExpr->x.pList->a[0].pExpr;
3411a84203a0Sdrh       Expr *pZ = pExpr->x.pList->a[1].pExpr;
3412a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "BETWEEN(");
3413a84203a0Sdrh       sqlite3ExplainExpr(pOut, pX);
3414a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ",");
3415a84203a0Sdrh       sqlite3ExplainExpr(pOut, pY);
3416a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ",");
3417a84203a0Sdrh       sqlite3ExplainExpr(pOut, pZ);
3418a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ")");
3419a84203a0Sdrh       break;
3420a84203a0Sdrh     }
3421a84203a0Sdrh     case TK_TRIGGER: {
3422a84203a0Sdrh       /* If the opcode is TK_TRIGGER, then the expression is a reference
3423a84203a0Sdrh       ** to a column in the new.* or old.* pseudo-tables available to
3424a84203a0Sdrh       ** trigger programs. In this case Expr.iTable is set to 1 for the
3425a84203a0Sdrh       ** new.* pseudo-table, or 0 for the old.* pseudo-table. Expr.iColumn
3426a84203a0Sdrh       ** is set to the column of the pseudo-table to read, or to -1 to
3427a84203a0Sdrh       ** read the rowid field.
3428a84203a0Sdrh       */
3429a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "%s(%d)",
3430a84203a0Sdrh           pExpr->iTable ? "NEW" : "OLD", pExpr->iColumn);
3431a84203a0Sdrh       break;
3432a84203a0Sdrh     }
3433a84203a0Sdrh     case TK_CASE: {
3434a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "CASE(");
3435a84203a0Sdrh       sqlite3ExplainExpr(pOut, pExpr->pLeft);
3436a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ",");
3437a84203a0Sdrh       sqlite3ExplainExprList(pOut, pExpr->x.pList);
3438a84203a0Sdrh       break;
3439a84203a0Sdrh     }
3440a84203a0Sdrh #ifndef SQLITE_OMIT_TRIGGER
3441a84203a0Sdrh     case TK_RAISE: {
3442a84203a0Sdrh       const char *zType = "unk";
3443a84203a0Sdrh       switch( pExpr->affinity ){
3444a84203a0Sdrh         case OE_Rollback:   zType = "rollback";  break;
3445a84203a0Sdrh         case OE_Abort:      zType = "abort";     break;
3446a84203a0Sdrh         case OE_Fail:       zType = "fail";      break;
3447a84203a0Sdrh         case OE_Ignore:     zType = "ignore";    break;
3448a84203a0Sdrh       }
3449a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "RAISE-%s(%s)", zType, pExpr->u.zToken);
3450a84203a0Sdrh       break;
3451a84203a0Sdrh     }
3452a84203a0Sdrh #endif
3453a84203a0Sdrh   }
3454a84203a0Sdrh   if( zBinOp ){
3455a84203a0Sdrh     sqlite3ExplainPrintf(pOut,"%s(", zBinOp);
3456a84203a0Sdrh     sqlite3ExplainExpr(pOut, pExpr->pLeft);
3457a84203a0Sdrh     sqlite3ExplainPrintf(pOut,",");
3458a84203a0Sdrh     sqlite3ExplainExpr(pOut, pExpr->pRight);
3459a84203a0Sdrh     sqlite3ExplainPrintf(pOut,")");
3460a84203a0Sdrh   }else if( zUniOp ){
3461a84203a0Sdrh     sqlite3ExplainPrintf(pOut,"%s(", zUniOp);
3462a84203a0Sdrh     sqlite3ExplainExpr(pOut, pExpr->pLeft);
3463a84203a0Sdrh     sqlite3ExplainPrintf(pOut,")");
3464a84203a0Sdrh   }
34657e02e5e6Sdrh }
3466678a9aa7Sdrh #endif /* defined(SQLITE_ENABLE_TREE_EXPLAIN) */
34677e02e5e6Sdrh 
3468678a9aa7Sdrh #if defined(SQLITE_ENABLE_TREE_EXPLAIN)
34697e02e5e6Sdrh /*
34707e02e5e6Sdrh ** Generate a human-readable explanation of an expression list.
34717e02e5e6Sdrh */
34727e02e5e6Sdrh void sqlite3ExplainExprList(Vdbe *pOut, ExprList *pList){
34737e02e5e6Sdrh   int i;
3474a84203a0Sdrh   if( pList==0 || pList->nExpr==0 ){
34757e02e5e6Sdrh     sqlite3ExplainPrintf(pOut, "(empty-list)");
34767e02e5e6Sdrh     return;
3477a84203a0Sdrh   }else if( pList->nExpr==1 ){
3478a84203a0Sdrh     sqlite3ExplainExpr(pOut, pList->a[0].pExpr);
3479a84203a0Sdrh   }else{
34807e02e5e6Sdrh     sqlite3ExplainPush(pOut);
34817e02e5e6Sdrh     for(i=0; i<pList->nExpr; i++){
3482a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "item[%d] = ", i);
34837e02e5e6Sdrh       sqlite3ExplainPush(pOut);
34847e02e5e6Sdrh       sqlite3ExplainExpr(pOut, pList->a[i].pExpr);
3485b66e21fdSdrh       sqlite3ExplainPop(pOut);
34863e3f1a5bSdrh       if( pList->a[i].zName ){
34873e3f1a5bSdrh         sqlite3ExplainPrintf(pOut, " AS %s", pList->a[i].zName);
34883e3f1a5bSdrh       }
34893e3f1a5bSdrh       if( pList->a[i].bSpanIsTab ){
34903e3f1a5bSdrh         sqlite3ExplainPrintf(pOut, " (%s)", pList->a[i].zSpan);
34913e3f1a5bSdrh       }
34927e02e5e6Sdrh       if( i<pList->nExpr-1 ){
34937e02e5e6Sdrh         sqlite3ExplainNL(pOut);
34947e02e5e6Sdrh       }
34957e02e5e6Sdrh     }
34967e02e5e6Sdrh     sqlite3ExplainPop(pOut);
34977e02e5e6Sdrh   }
3498a84203a0Sdrh }
34997e02e5e6Sdrh #endif /* SQLITE_DEBUG */
35007e02e5e6Sdrh 
3501678ccce8Sdrh /*
3502268380caSdrh ** Generate code that pushes the value of every element of the given
35039cbf3425Sdrh ** expression list into a sequence of registers beginning at target.
3504268380caSdrh **
3505892d3179Sdrh ** Return the number of elements evaluated.
3506d1a01edaSdrh **
3507d1a01edaSdrh ** The SQLITE_ECEL_DUP flag prevents the arguments from being
3508d1a01edaSdrh ** filled using OP_SCopy.  OP_Copy must be used instead.
3509d1a01edaSdrh **
3510d1a01edaSdrh ** The SQLITE_ECEL_FACTOR argument allows constant arguments to be
3511d1a01edaSdrh ** factored out into initialization code.
3512268380caSdrh */
35134adee20fSdanielk1977 int sqlite3ExprCodeExprList(
3514268380caSdrh   Parse *pParse,     /* Parsing context */
3515389a1adbSdrh   ExprList *pList,   /* The expression list to be coded */
3516191b54cbSdrh   int target,        /* Where to write results */
3517d1a01edaSdrh   u8 flags           /* SQLITE_ECEL_* flags */
3518268380caSdrh ){
3519268380caSdrh   struct ExprList_item *pItem;
35209cbf3425Sdrh   int i, n;
3521d1a01edaSdrh   u8 copyOp = (flags & SQLITE_ECEL_DUP) ? OP_Copy : OP_SCopy;
35229d8b3072Sdrh   assert( pList!=0 );
35239cbf3425Sdrh   assert( target>0 );
3524d81a142bSdrh   assert( pParse->pVdbe!=0 );  /* Never gets this far otherwise */
3525268380caSdrh   n = pList->nExpr;
3526d9f158e7Sdrh   if( !ConstFactorOk(pParse) ) flags &= ~SQLITE_ECEL_FACTOR;
3527191b54cbSdrh   for(pItem=pList->a, i=0; i<n; i++, pItem++){
35287445ffe2Sdrh     Expr *pExpr = pItem->pExpr;
3529d1a01edaSdrh     if( (flags & SQLITE_ECEL_FACTOR)!=0 && sqlite3ExprIsConstant(pExpr) ){
3530d673cddaSdrh       sqlite3ExprCodeAtInit(pParse, pExpr, target+i, 0);
3531d1a01edaSdrh     }else{
35327445ffe2Sdrh       int inReg = sqlite3ExprCodeTarget(pParse, pExpr, target+i);
3533746fd9ccSdrh       if( inReg!=target+i ){
35344eded604Sdrh         VdbeOp *pOp;
35354eded604Sdrh         Vdbe *v = pParse->pVdbe;
35364eded604Sdrh         if( copyOp==OP_Copy
35374eded604Sdrh          && (pOp=sqlite3VdbeGetOp(v, -1))->opcode==OP_Copy
35384eded604Sdrh          && pOp->p1+pOp->p3+1==inReg
35394eded604Sdrh          && pOp->p2+pOp->p3+1==target+i
35404eded604Sdrh         ){
35414eded604Sdrh           pOp->p3++;
35424eded604Sdrh         }else{
35434eded604Sdrh           sqlite3VdbeAddOp2(v, copyOp, inReg, target+i);
35444eded604Sdrh         }
3545d1a01edaSdrh       }
3546d176611bSdrh     }
3547268380caSdrh   }
3548f9b596ebSdrh   return n;
3549268380caSdrh }
3550268380caSdrh 
3551268380caSdrh /*
355236c563a2Sdrh ** Generate code for a BETWEEN operator.
355336c563a2Sdrh **
355436c563a2Sdrh **    x BETWEEN y AND z
355536c563a2Sdrh **
355636c563a2Sdrh ** The above is equivalent to
355736c563a2Sdrh **
355836c563a2Sdrh **    x>=y AND x<=z
355936c563a2Sdrh **
356036c563a2Sdrh ** Code it as such, taking care to do the common subexpression
356136c563a2Sdrh ** elementation of x.
356236c563a2Sdrh */
356336c563a2Sdrh static void exprCodeBetween(
356436c563a2Sdrh   Parse *pParse,    /* Parsing and code generating context */
356536c563a2Sdrh   Expr *pExpr,      /* The BETWEEN expression */
356636c563a2Sdrh   int dest,         /* Jump here if the jump is taken */
356736c563a2Sdrh   int jumpIfTrue,   /* Take the jump if the BETWEEN is true */
356836c563a2Sdrh   int jumpIfNull    /* Take the jump if the BETWEEN is NULL */
356936c563a2Sdrh ){
357036c563a2Sdrh   Expr exprAnd;     /* The AND operator in  x>=y AND x<=z  */
357136c563a2Sdrh   Expr compLeft;    /* The  x>=y  term */
357236c563a2Sdrh   Expr compRight;   /* The  x<=z  term */
357336c563a2Sdrh   Expr exprX;       /* The  x  subexpression */
357436c563a2Sdrh   int regFree1 = 0; /* Temporary use register */
357536c563a2Sdrh 
357636c563a2Sdrh   assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
357736c563a2Sdrh   exprX = *pExpr->pLeft;
357836c563a2Sdrh   exprAnd.op = TK_AND;
357936c563a2Sdrh   exprAnd.pLeft = &compLeft;
358036c563a2Sdrh   exprAnd.pRight = &compRight;
358136c563a2Sdrh   compLeft.op = TK_GE;
358236c563a2Sdrh   compLeft.pLeft = &exprX;
358336c563a2Sdrh   compLeft.pRight = pExpr->x.pList->a[0].pExpr;
358436c563a2Sdrh   compRight.op = TK_LE;
358536c563a2Sdrh   compRight.pLeft = &exprX;
358636c563a2Sdrh   compRight.pRight = pExpr->x.pList->a[1].pExpr;
3587a4c3c87eSdrh   exprToRegister(&exprX, sqlite3ExprCodeTemp(pParse, &exprX, &regFree1));
358836c563a2Sdrh   if( jumpIfTrue ){
358936c563a2Sdrh     sqlite3ExprIfTrue(pParse, &exprAnd, dest, jumpIfNull);
359036c563a2Sdrh   }else{
359136c563a2Sdrh     sqlite3ExprIfFalse(pParse, &exprAnd, dest, jumpIfNull);
359236c563a2Sdrh   }
359336c563a2Sdrh   sqlite3ReleaseTempReg(pParse, regFree1);
359436c563a2Sdrh 
359536c563a2Sdrh   /* Ensure adequate test coverage */
359636c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull==0 && regFree1==0 );
359736c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull==0 && regFree1!=0 );
359836c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull!=0 && regFree1==0 );
359936c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull!=0 && regFree1!=0 );
360036c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull==0 && regFree1==0 );
360136c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull==0 && regFree1!=0 );
360236c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull!=0 && regFree1==0 );
360336c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull!=0 && regFree1!=0 );
360436c563a2Sdrh }
360536c563a2Sdrh 
360636c563a2Sdrh /*
3607cce7d176Sdrh ** Generate code for a boolean expression such that a jump is made
3608cce7d176Sdrh ** to the label "dest" if the expression is true but execution
3609cce7d176Sdrh ** continues straight thru if the expression is false.
3610f5905aa7Sdrh **
3611f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false), then
361235573356Sdrh ** take the jump if the jumpIfNull flag is SQLITE_JUMPIFNULL.
3613f2bc013cSdrh **
3614f2bc013cSdrh ** This code depends on the fact that certain token values (ex: TK_EQ)
3615f2bc013cSdrh ** are the same as opcode values (ex: OP_Eq) that implement the corresponding
3616f2bc013cSdrh ** operation.  Special comments in vdbe.c and the mkopcodeh.awk script in
3617f2bc013cSdrh ** the make process cause these values to align.  Assert()s in the code
3618f2bc013cSdrh ** below verify that the numbers are aligned correctly.
3619cce7d176Sdrh */
36204adee20fSdanielk1977 void sqlite3ExprIfTrue(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
3621cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
3622cce7d176Sdrh   int op = 0;
36232dcef11bSdrh   int regFree1 = 0;
36242dcef11bSdrh   int regFree2 = 0;
36252dcef11bSdrh   int r1, r2;
36262dcef11bSdrh 
362735573356Sdrh   assert( jumpIfNull==SQLITE_JUMPIFNULL || jumpIfNull==0 );
362848864df9Smistachkin   if( NEVER(v==0) )     return;  /* Existence of VDBE checked by caller */
362933cd4909Sdrh   if( NEVER(pExpr==0) ) return;  /* No way this can happen */
3630f2bc013cSdrh   op = pExpr->op;
3631f2bc013cSdrh   switch( op ){
3632cce7d176Sdrh     case TK_AND: {
36334adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
3634c5499befSdrh       testcase( jumpIfNull==0 );
363535573356Sdrh       sqlite3ExprIfFalse(pParse, pExpr->pLeft, d2,jumpIfNull^SQLITE_JUMPIFNULL);
363654e2adb5Sdrh       sqlite3ExprCachePush(pParse);
36374adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
36384adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
3639d2490904Sdrh       sqlite3ExprCachePop(pParse);
3640cce7d176Sdrh       break;
3641cce7d176Sdrh     }
3642cce7d176Sdrh     case TK_OR: {
3643c5499befSdrh       testcase( jumpIfNull==0 );
36444adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
364554e2adb5Sdrh       sqlite3ExprCachePush(pParse);
36464adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
3647d2490904Sdrh       sqlite3ExprCachePop(pParse);
3648cce7d176Sdrh       break;
3649cce7d176Sdrh     }
3650cce7d176Sdrh     case TK_NOT: {
3651c5499befSdrh       testcase( jumpIfNull==0 );
36524adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
3653cce7d176Sdrh       break;
3654cce7d176Sdrh     }
3655cce7d176Sdrh     case TK_LT:
3656cce7d176Sdrh     case TK_LE:
3657cce7d176Sdrh     case TK_GT:
3658cce7d176Sdrh     case TK_GE:
3659cce7d176Sdrh     case TK_NE:
36600ac65892Sdrh     case TK_EQ: {
3661c5499befSdrh       testcase( jumpIfNull==0 );
3662b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3663b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
366435573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
36657d176105Sdrh                   r1, r2, dest, jumpIfNull);
36667d176105Sdrh       assert(TK_LT==OP_Lt); testcase(op==OP_Lt); VdbeCoverageIf(v,op==OP_Lt);
36677d176105Sdrh       assert(TK_LE==OP_Le); testcase(op==OP_Le); VdbeCoverageIf(v,op==OP_Le);
36687d176105Sdrh       assert(TK_GT==OP_Gt); testcase(op==OP_Gt); VdbeCoverageIf(v,op==OP_Gt);
36697d176105Sdrh       assert(TK_GE==OP_Ge); testcase(op==OP_Ge); VdbeCoverageIf(v,op==OP_Ge);
36707d176105Sdrh       assert(TK_EQ==OP_Eq); testcase(op==OP_Eq); VdbeCoverageIf(v,op==OP_Eq);
36717d176105Sdrh       assert(TK_NE==OP_Ne); testcase(op==OP_Ne); VdbeCoverageIf(v,op==OP_Ne);
3672c5499befSdrh       testcase( regFree1==0 );
3673c5499befSdrh       testcase( regFree2==0 );
3674cce7d176Sdrh       break;
3675cce7d176Sdrh     }
36766a2fe093Sdrh     case TK_IS:
36776a2fe093Sdrh     case TK_ISNOT: {
36786a2fe093Sdrh       testcase( op==TK_IS );
36796a2fe093Sdrh       testcase( op==TK_ISNOT );
3680b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3681b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
36826a2fe093Sdrh       op = (op==TK_IS) ? TK_EQ : TK_NE;
36836a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
36847d176105Sdrh                   r1, r2, dest, SQLITE_NULLEQ);
36857d176105Sdrh       VdbeCoverageIf(v, op==TK_EQ);
36867d176105Sdrh       VdbeCoverageIf(v, op==TK_NE);
36876a2fe093Sdrh       testcase( regFree1==0 );
36886a2fe093Sdrh       testcase( regFree2==0 );
36896a2fe093Sdrh       break;
36906a2fe093Sdrh     }
3691cce7d176Sdrh     case TK_ISNULL:
3692cce7d176Sdrh     case TK_NOTNULL: {
36937d176105Sdrh       assert( TK_ISNULL==OP_IsNull );   testcase( op==TK_ISNULL );
36947d176105Sdrh       assert( TK_NOTNULL==OP_NotNull ); testcase( op==TK_NOTNULL );
36952dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
36967d176105Sdrh       sqlite3VdbeAddOp2(v, op, r1, dest);
36977d176105Sdrh       VdbeCoverageIf(v, op==TK_ISNULL);
36987d176105Sdrh       VdbeCoverageIf(v, op==TK_NOTNULL);
3699c5499befSdrh       testcase( regFree1==0 );
3700cce7d176Sdrh       break;
3701cce7d176Sdrh     }
3702fef5208cSdrh     case TK_BETWEEN: {
37035c03f30aSdrh       testcase( jumpIfNull==0 );
370436c563a2Sdrh       exprCodeBetween(pParse, pExpr, dest, 1, jumpIfNull);
3705fef5208cSdrh       break;
3706fef5208cSdrh     }
3707bb201344Sshaneh #ifndef SQLITE_OMIT_SUBQUERY
3708e3365e6cSdrh     case TK_IN: {
3709e3365e6cSdrh       int destIfFalse = sqlite3VdbeMakeLabel(v);
3710e3365e6cSdrh       int destIfNull = jumpIfNull ? dest : destIfFalse;
3711e3365e6cSdrh       sqlite3ExprCodeIN(pParse, pExpr, destIfFalse, destIfNull);
3712e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Goto, 0, dest);
3713e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfFalse);
3714e3365e6cSdrh       break;
3715e3365e6cSdrh     }
3716bb201344Sshaneh #endif
3717cce7d176Sdrh     default: {
3718991a1985Sdrh       if( exprAlwaysTrue(pExpr) ){
3719991a1985Sdrh         sqlite3VdbeAddOp2(v, OP_Goto, 0, dest);
3720991a1985Sdrh       }else if( exprAlwaysFalse(pExpr) ){
3721991a1985Sdrh         /* No-op */
3722991a1985Sdrh       }else{
37232dcef11bSdrh         r1 = sqlite3ExprCodeTemp(pParse, pExpr, &regFree1);
37242dcef11bSdrh         sqlite3VdbeAddOp3(v, OP_If, r1, dest, jumpIfNull!=0);
3725688852abSdrh         VdbeCoverage(v);
3726c5499befSdrh         testcase( regFree1==0 );
3727c5499befSdrh         testcase( jumpIfNull==0 );
3728991a1985Sdrh       }
3729cce7d176Sdrh       break;
3730cce7d176Sdrh     }
3731cce7d176Sdrh   }
37322dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
37332dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
3734cce7d176Sdrh }
3735cce7d176Sdrh 
3736cce7d176Sdrh /*
373766b89c8fSdrh ** Generate code for a boolean expression such that a jump is made
3738cce7d176Sdrh ** to the label "dest" if the expression is false but execution
3739cce7d176Sdrh ** continues straight thru if the expression is true.
3740f5905aa7Sdrh **
3741f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false) then
374235573356Sdrh ** jump if jumpIfNull is SQLITE_JUMPIFNULL or fall through if jumpIfNull
374335573356Sdrh ** is 0.
3744cce7d176Sdrh */
37454adee20fSdanielk1977 void sqlite3ExprIfFalse(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
3746cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
3747cce7d176Sdrh   int op = 0;
37482dcef11bSdrh   int regFree1 = 0;
37492dcef11bSdrh   int regFree2 = 0;
37502dcef11bSdrh   int r1, r2;
37512dcef11bSdrh 
375235573356Sdrh   assert( jumpIfNull==SQLITE_JUMPIFNULL || jumpIfNull==0 );
375348864df9Smistachkin   if( NEVER(v==0) ) return; /* Existence of VDBE checked by caller */
375433cd4909Sdrh   if( pExpr==0 )    return;
3755f2bc013cSdrh 
3756f2bc013cSdrh   /* The value of pExpr->op and op are related as follows:
3757f2bc013cSdrh   **
3758f2bc013cSdrh   **       pExpr->op            op
3759f2bc013cSdrh   **       ---------          ----------
3760f2bc013cSdrh   **       TK_ISNULL          OP_NotNull
3761f2bc013cSdrh   **       TK_NOTNULL         OP_IsNull
3762f2bc013cSdrh   **       TK_NE              OP_Eq
3763f2bc013cSdrh   **       TK_EQ              OP_Ne
3764f2bc013cSdrh   **       TK_GT              OP_Le
3765f2bc013cSdrh   **       TK_LE              OP_Gt
3766f2bc013cSdrh   **       TK_GE              OP_Lt
3767f2bc013cSdrh   **       TK_LT              OP_Ge
3768f2bc013cSdrh   **
3769f2bc013cSdrh   ** For other values of pExpr->op, op is undefined and unused.
3770f2bc013cSdrh   ** The value of TK_ and OP_ constants are arranged such that we
3771f2bc013cSdrh   ** can compute the mapping above using the following expression.
3772f2bc013cSdrh   ** Assert()s verify that the computation is correct.
3773f2bc013cSdrh   */
3774f2bc013cSdrh   op = ((pExpr->op+(TK_ISNULL&1))^1)-(TK_ISNULL&1);
3775f2bc013cSdrh 
3776f2bc013cSdrh   /* Verify correct alignment of TK_ and OP_ constants
3777f2bc013cSdrh   */
3778f2bc013cSdrh   assert( pExpr->op!=TK_ISNULL || op==OP_NotNull );
3779f2bc013cSdrh   assert( pExpr->op!=TK_NOTNULL || op==OP_IsNull );
3780f2bc013cSdrh   assert( pExpr->op!=TK_NE || op==OP_Eq );
3781f2bc013cSdrh   assert( pExpr->op!=TK_EQ || op==OP_Ne );
3782f2bc013cSdrh   assert( pExpr->op!=TK_LT || op==OP_Ge );
3783f2bc013cSdrh   assert( pExpr->op!=TK_LE || op==OP_Gt );
3784f2bc013cSdrh   assert( pExpr->op!=TK_GT || op==OP_Le );
3785f2bc013cSdrh   assert( pExpr->op!=TK_GE || op==OP_Lt );
3786f2bc013cSdrh 
3787cce7d176Sdrh   switch( pExpr->op ){
3788cce7d176Sdrh     case TK_AND: {
3789c5499befSdrh       testcase( jumpIfNull==0 );
37904adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
379154e2adb5Sdrh       sqlite3ExprCachePush(pParse);
37924adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
3793d2490904Sdrh       sqlite3ExprCachePop(pParse);
3794cce7d176Sdrh       break;
3795cce7d176Sdrh     }
3796cce7d176Sdrh     case TK_OR: {
37974adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
3798c5499befSdrh       testcase( jumpIfNull==0 );
379935573356Sdrh       sqlite3ExprIfTrue(pParse, pExpr->pLeft, d2, jumpIfNull^SQLITE_JUMPIFNULL);
380054e2adb5Sdrh       sqlite3ExprCachePush(pParse);
38014adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
38024adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
3803d2490904Sdrh       sqlite3ExprCachePop(pParse);
3804cce7d176Sdrh       break;
3805cce7d176Sdrh     }
3806cce7d176Sdrh     case TK_NOT: {
38075c03f30aSdrh       testcase( jumpIfNull==0 );
38084adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
3809cce7d176Sdrh       break;
3810cce7d176Sdrh     }
3811cce7d176Sdrh     case TK_LT:
3812cce7d176Sdrh     case TK_LE:
3813cce7d176Sdrh     case TK_GT:
3814cce7d176Sdrh     case TK_GE:
3815cce7d176Sdrh     case TK_NE:
3816cce7d176Sdrh     case TK_EQ: {
3817c5499befSdrh       testcase( jumpIfNull==0 );
3818b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3819b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
382035573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
38217d176105Sdrh                   r1, r2, dest, jumpIfNull);
38227d176105Sdrh       assert(TK_LT==OP_Lt); testcase(op==OP_Lt); VdbeCoverageIf(v,op==OP_Lt);
38237d176105Sdrh       assert(TK_LE==OP_Le); testcase(op==OP_Le); VdbeCoverageIf(v,op==OP_Le);
38247d176105Sdrh       assert(TK_GT==OP_Gt); testcase(op==OP_Gt); VdbeCoverageIf(v,op==OP_Gt);
38257d176105Sdrh       assert(TK_GE==OP_Ge); testcase(op==OP_Ge); VdbeCoverageIf(v,op==OP_Ge);
38267d176105Sdrh       assert(TK_EQ==OP_Eq); testcase(op==OP_Eq); VdbeCoverageIf(v,op==OP_Eq);
38277d176105Sdrh       assert(TK_NE==OP_Ne); testcase(op==OP_Ne); VdbeCoverageIf(v,op==OP_Ne);
3828c5499befSdrh       testcase( regFree1==0 );
3829c5499befSdrh       testcase( regFree2==0 );
3830cce7d176Sdrh       break;
3831cce7d176Sdrh     }
38326a2fe093Sdrh     case TK_IS:
38336a2fe093Sdrh     case TK_ISNOT: {
38346d4486aeSdrh       testcase( pExpr->op==TK_IS );
38356d4486aeSdrh       testcase( pExpr->op==TK_ISNOT );
3836b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3837b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
38386a2fe093Sdrh       op = (pExpr->op==TK_IS) ? TK_NE : TK_EQ;
38396a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
38407d176105Sdrh                   r1, r2, dest, SQLITE_NULLEQ);
38417d176105Sdrh       VdbeCoverageIf(v, op==TK_EQ);
38427d176105Sdrh       VdbeCoverageIf(v, op==TK_NE);
38436a2fe093Sdrh       testcase( regFree1==0 );
38446a2fe093Sdrh       testcase( regFree2==0 );
38456a2fe093Sdrh       break;
38466a2fe093Sdrh     }
3847cce7d176Sdrh     case TK_ISNULL:
3848cce7d176Sdrh     case TK_NOTNULL: {
38492dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
38507d176105Sdrh       sqlite3VdbeAddOp2(v, op, r1, dest);
38517d176105Sdrh       testcase( op==TK_ISNULL );   VdbeCoverageIf(v, op==TK_ISNULL);
38527d176105Sdrh       testcase( op==TK_NOTNULL );  VdbeCoverageIf(v, op==TK_NOTNULL);
3853c5499befSdrh       testcase( regFree1==0 );
3854cce7d176Sdrh       break;
3855cce7d176Sdrh     }
3856fef5208cSdrh     case TK_BETWEEN: {
38575c03f30aSdrh       testcase( jumpIfNull==0 );
385836c563a2Sdrh       exprCodeBetween(pParse, pExpr, dest, 0, jumpIfNull);
3859fef5208cSdrh       break;
3860fef5208cSdrh     }
3861bb201344Sshaneh #ifndef SQLITE_OMIT_SUBQUERY
3862e3365e6cSdrh     case TK_IN: {
3863e3365e6cSdrh       if( jumpIfNull ){
3864e3365e6cSdrh         sqlite3ExprCodeIN(pParse, pExpr, dest, dest);
3865e3365e6cSdrh       }else{
3866e3365e6cSdrh         int destIfNull = sqlite3VdbeMakeLabel(v);
3867e3365e6cSdrh         sqlite3ExprCodeIN(pParse, pExpr, dest, destIfNull);
3868e3365e6cSdrh         sqlite3VdbeResolveLabel(v, destIfNull);
3869e3365e6cSdrh       }
3870e3365e6cSdrh       break;
3871e3365e6cSdrh     }
3872bb201344Sshaneh #endif
3873cce7d176Sdrh     default: {
3874991a1985Sdrh       if( exprAlwaysFalse(pExpr) ){
3875991a1985Sdrh         sqlite3VdbeAddOp2(v, OP_Goto, 0, dest);
3876991a1985Sdrh       }else if( exprAlwaysTrue(pExpr) ){
3877991a1985Sdrh         /* no-op */
3878991a1985Sdrh       }else{
38792dcef11bSdrh         r1 = sqlite3ExprCodeTemp(pParse, pExpr, &regFree1);
38802dcef11bSdrh         sqlite3VdbeAddOp3(v, OP_IfNot, r1, dest, jumpIfNull!=0);
3881688852abSdrh         VdbeCoverage(v);
3882c5499befSdrh         testcase( regFree1==0 );
3883c5499befSdrh         testcase( jumpIfNull==0 );
3884991a1985Sdrh       }
3885cce7d176Sdrh       break;
3886cce7d176Sdrh     }
3887cce7d176Sdrh   }
38882dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
38892dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
3890cce7d176Sdrh }
38912282792aSdrh 
38922282792aSdrh /*
38931d9da70aSdrh ** Do a deep comparison of two expression trees.  Return 0 if the two
38941d9da70aSdrh ** expressions are completely identical.  Return 1 if they differ only
38951d9da70aSdrh ** by a COLLATE operator at the top level.  Return 2 if there are differences
38961d9da70aSdrh ** other than the top-level COLLATE operator.
3897d40aab0eSdrh **
3898619a1305Sdrh ** If any subelement of pB has Expr.iTable==(-1) then it is allowed
3899619a1305Sdrh ** to compare equal to an equivalent element in pA with Expr.iTable==iTab.
3900619a1305Sdrh **
390166518ca7Sdrh ** The pA side might be using TK_REGISTER.  If that is the case and pB is
390266518ca7Sdrh ** not using TK_REGISTER but is otherwise equivalent, then still return 0.
390366518ca7Sdrh **
39041d9da70aSdrh ** Sometimes this routine will return 2 even if the two expressions
3905d40aab0eSdrh ** really are equivalent.  If we cannot prove that the expressions are
39061d9da70aSdrh ** identical, we return 2 just to be safe.  So if this routine
39071d9da70aSdrh ** returns 2, then you do not really know for certain if the two
39081d9da70aSdrh ** expressions are the same.  But if you get a 0 or 1 return, then you
3909d40aab0eSdrh ** can be sure the expressions are the same.  In the places where
39101d9da70aSdrh ** this routine is used, it does not hurt to get an extra 2 - that
3911d40aab0eSdrh ** just might result in some slightly slower code.  But returning
39121d9da70aSdrh ** an incorrect 0 or 1 could lead to a malfunction.
39132282792aSdrh */
3914619a1305Sdrh int sqlite3ExprCompare(Expr *pA, Expr *pB, int iTab){
391510d1edf0Sdrh   u32 combinedFlags;
39164b202ae2Sdanielk1977   if( pA==0 || pB==0 ){
39171d9da70aSdrh     return pB==pA ? 0 : 2;
39182282792aSdrh   }
391910d1edf0Sdrh   combinedFlags = pA->flags | pB->flags;
392010d1edf0Sdrh   if( combinedFlags & EP_IntValue ){
392110d1edf0Sdrh     if( (pA->flags&pB->flags&EP_IntValue)!=0 && pA->u.iValue==pB->u.iValue ){
392210d1edf0Sdrh       return 0;
392310d1edf0Sdrh     }
39241d9da70aSdrh     return 2;
39256ab3a2ecSdanielk1977   }
3926c2acc4e4Sdrh   if( pA->op!=pB->op ){
3927619a1305Sdrh     if( pA->op==TK_COLLATE && sqlite3ExprCompare(pA->pLeft, pB, iTab)<2 ){
3928ae80ddeaSdrh       return 1;
3929ae80ddeaSdrh     }
3930619a1305Sdrh     if( pB->op==TK_COLLATE && sqlite3ExprCompare(pA, pB->pLeft, iTab)<2 ){
3931ae80ddeaSdrh       return 1;
3932ae80ddeaSdrh     }
3933ae80ddeaSdrh     return 2;
3934ae80ddeaSdrh   }
393510d1edf0Sdrh   if( pA->op!=TK_COLUMN && ALWAYS(pA->op!=TK_AGG_COLUMN) && pA->u.zToken ){
393610d1edf0Sdrh     if( strcmp(pA->u.zToken,pB->u.zToken)!=0 ){
393710d1edf0Sdrh       return pA->op==TK_COLLATE ? 1 : 2;
393810d1edf0Sdrh     }
393910d1edf0Sdrh   }
394010d1edf0Sdrh   if( (pA->flags & EP_Distinct)!=(pB->flags & EP_Distinct) ) return 2;
394185f8aa79Sdrh   if( ALWAYS((combinedFlags & EP_TokenOnly)==0) ){
394210d1edf0Sdrh     if( combinedFlags & EP_xIsSelect ) return 2;
3943619a1305Sdrh     if( sqlite3ExprCompare(pA->pLeft, pB->pLeft, iTab) ) return 2;
3944619a1305Sdrh     if( sqlite3ExprCompare(pA->pRight, pB->pRight, iTab) ) return 2;
3945619a1305Sdrh     if( sqlite3ExprListCompare(pA->x.pList, pB->x.pList, iTab) ) return 2;
394685f8aa79Sdrh     if( ALWAYS((combinedFlags & EP_Reduced)==0) ){
3947619a1305Sdrh       if( pA->iColumn!=pB->iColumn ) return 2;
394866518ca7Sdrh       if( pA->iTable!=pB->iTable
394985f8aa79Sdrh        && (pA->iTable!=iTab || NEVER(pB->iTable>=0)) ) return 2;
39501d9da70aSdrh     }
39511d9da70aSdrh   }
39522646da7eSdrh   return 0;
39532646da7eSdrh }
39542282792aSdrh 
39558c6f666bSdrh /*
39568c6f666bSdrh ** Compare two ExprList objects.  Return 0 if they are identical and
39578c6f666bSdrh ** non-zero if they differ in any way.
39588c6f666bSdrh **
3959619a1305Sdrh ** If any subelement of pB has Expr.iTable==(-1) then it is allowed
3960619a1305Sdrh ** to compare equal to an equivalent element in pA with Expr.iTable==iTab.
3961619a1305Sdrh **
39628c6f666bSdrh ** This routine might return non-zero for equivalent ExprLists.  The
39638c6f666bSdrh ** only consequence will be disabled optimizations.  But this routine
39648c6f666bSdrh ** must never return 0 if the two ExprList objects are different, or
39658c6f666bSdrh ** a malfunction will result.
39668c6f666bSdrh **
39678c6f666bSdrh ** Two NULL pointers are considered to be the same.  But a NULL pointer
39688c6f666bSdrh ** always differs from a non-NULL pointer.
39698c6f666bSdrh */
3970619a1305Sdrh int sqlite3ExprListCompare(ExprList *pA, ExprList *pB, int iTab){
39718c6f666bSdrh   int i;
39728c6f666bSdrh   if( pA==0 && pB==0 ) return 0;
39738c6f666bSdrh   if( pA==0 || pB==0 ) return 1;
39748c6f666bSdrh   if( pA->nExpr!=pB->nExpr ) return 1;
39758c6f666bSdrh   for(i=0; i<pA->nExpr; i++){
39768c6f666bSdrh     Expr *pExprA = pA->a[i].pExpr;
39778c6f666bSdrh     Expr *pExprB = pB->a[i].pExpr;
39788c6f666bSdrh     if( pA->a[i].sortOrder!=pB->a[i].sortOrder ) return 1;
3979619a1305Sdrh     if( sqlite3ExprCompare(pExprA, pExprB, iTab) ) return 1;
39808c6f666bSdrh   }
39818c6f666bSdrh   return 0;
39828c6f666bSdrh }
398313449892Sdrh 
39842282792aSdrh /*
39854bd5f73fSdrh ** Return true if we can prove the pE2 will always be true if pE1 is
39864bd5f73fSdrh ** true.  Return false if we cannot complete the proof or if pE2 might
39874bd5f73fSdrh ** be false.  Examples:
39884bd5f73fSdrh **
3989619a1305Sdrh **     pE1: x==5       pE2: x==5             Result: true
39904bd5f73fSdrh **     pE1: x>0        pE2: x==5             Result: false
3991619a1305Sdrh **     pE1: x=21       pE2: x=21 OR y=43     Result: true
39924bd5f73fSdrh **     pE1: x!=123     pE2: x IS NOT NULL    Result: true
3993619a1305Sdrh **     pE1: x!=?1      pE2: x IS NOT NULL    Result: true
3994619a1305Sdrh **     pE1: x IS NULL  pE2: x IS NOT NULL    Result: false
3995619a1305Sdrh **     pE1: x IS ?2    pE2: x IS NOT NULL    Reuslt: false
39964bd5f73fSdrh **
39974bd5f73fSdrh ** When comparing TK_COLUMN nodes between pE1 and pE2, if pE2 has
39984bd5f73fSdrh ** Expr.iTable<0 then assume a table number given by iTab.
39994bd5f73fSdrh **
40004bd5f73fSdrh ** When in doubt, return false.  Returning true might give a performance
40014bd5f73fSdrh ** improvement.  Returning false might cause a performance reduction, but
40024bd5f73fSdrh ** it will always give the correct answer and is hence always safe.
40034bd5f73fSdrh */
40044bd5f73fSdrh int sqlite3ExprImpliesExpr(Expr *pE1, Expr *pE2, int iTab){
4005619a1305Sdrh   if( sqlite3ExprCompare(pE1, pE2, iTab)==0 ){
4006619a1305Sdrh     return 1;
4007619a1305Sdrh   }
4008619a1305Sdrh   if( pE2->op==TK_OR
4009619a1305Sdrh    && (sqlite3ExprImpliesExpr(pE1, pE2->pLeft, iTab)
4010619a1305Sdrh              || sqlite3ExprImpliesExpr(pE1, pE2->pRight, iTab) )
4011619a1305Sdrh   ){
4012619a1305Sdrh     return 1;
4013619a1305Sdrh   }
4014619a1305Sdrh   if( pE2->op==TK_NOTNULL
4015619a1305Sdrh    && sqlite3ExprCompare(pE1->pLeft, pE2->pLeft, iTab)==0
4016619a1305Sdrh    && (pE1->op!=TK_ISNULL && pE1->op!=TK_IS)
4017619a1305Sdrh   ){
4018619a1305Sdrh     return 1;
4019619a1305Sdrh   }
4020619a1305Sdrh   return 0;
40214bd5f73fSdrh }
40224bd5f73fSdrh 
40234bd5f73fSdrh /*
4024030796dfSdrh ** An instance of the following structure is used by the tree walker
4025030796dfSdrh ** to count references to table columns in the arguments of an
4026ed551b95Sdrh ** aggregate function, in order to implement the
4027ed551b95Sdrh ** sqlite3FunctionThisSrc() routine.
4028374fdce4Sdrh */
4029030796dfSdrh struct SrcCount {
4030030796dfSdrh   SrcList *pSrc;   /* One particular FROM clause in a nested query */
4031030796dfSdrh   int nThis;       /* Number of references to columns in pSrcList */
4032030796dfSdrh   int nOther;      /* Number of references to columns in other FROM clauses */
4033030796dfSdrh };
4034030796dfSdrh 
4035030796dfSdrh /*
4036030796dfSdrh ** Count the number of references to columns.
4037030796dfSdrh */
4038030796dfSdrh static int exprSrcCount(Walker *pWalker, Expr *pExpr){
4039fb0a6081Sdrh   /* The NEVER() on the second term is because sqlite3FunctionUsesThisSrc()
4040fb0a6081Sdrh   ** is always called before sqlite3ExprAnalyzeAggregates() and so the
4041fb0a6081Sdrh   ** TK_COLUMNs have not yet been converted into TK_AGG_COLUMN.  If
4042fb0a6081Sdrh   ** sqlite3FunctionUsesThisSrc() is used differently in the future, the
4043fb0a6081Sdrh   ** NEVER() will need to be removed. */
4044fb0a6081Sdrh   if( pExpr->op==TK_COLUMN || NEVER(pExpr->op==TK_AGG_COLUMN) ){
4045374fdce4Sdrh     int i;
4046030796dfSdrh     struct SrcCount *p = pWalker->u.pSrcCount;
4047030796dfSdrh     SrcList *pSrc = p->pSrc;
4048374fdce4Sdrh     for(i=0; i<pSrc->nSrc; i++){
4049030796dfSdrh       if( pExpr->iTable==pSrc->a[i].iCursor ) break;
4050374fdce4Sdrh     }
4051030796dfSdrh     if( i<pSrc->nSrc ){
4052030796dfSdrh       p->nThis++;
4053374fdce4Sdrh     }else{
4054030796dfSdrh       p->nOther++;
4055374fdce4Sdrh     }
4056374fdce4Sdrh   }
4057030796dfSdrh   return WRC_Continue;
4058030796dfSdrh }
4059374fdce4Sdrh 
4060374fdce4Sdrh /*
4061030796dfSdrh ** Determine if any of the arguments to the pExpr Function reference
4062030796dfSdrh ** pSrcList.  Return true if they do.  Also return true if the function
4063030796dfSdrh ** has no arguments or has only constant arguments.  Return false if pExpr
4064030796dfSdrh ** references columns but not columns of tables found in pSrcList.
4065374fdce4Sdrh */
4066030796dfSdrh int sqlite3FunctionUsesThisSrc(Expr *pExpr, SrcList *pSrcList){
4067374fdce4Sdrh   Walker w;
4068030796dfSdrh   struct SrcCount cnt;
4069374fdce4Sdrh   assert( pExpr->op==TK_AGG_FUNCTION );
4070374fdce4Sdrh   memset(&w, 0, sizeof(w));
4071030796dfSdrh   w.xExprCallback = exprSrcCount;
4072030796dfSdrh   w.u.pSrcCount = &cnt;
4073030796dfSdrh   cnt.pSrc = pSrcList;
4074030796dfSdrh   cnt.nThis = 0;
4075030796dfSdrh   cnt.nOther = 0;
4076030796dfSdrh   sqlite3WalkExprList(&w, pExpr->x.pList);
4077030796dfSdrh   return cnt.nThis>0 || cnt.nOther==0;
4078374fdce4Sdrh }
4079374fdce4Sdrh 
4080374fdce4Sdrh /*
408113449892Sdrh ** Add a new element to the pAggInfo->aCol[] array.  Return the index of
408213449892Sdrh ** the new element.  Return a negative number if malloc fails.
40832282792aSdrh */
408417435752Sdrh static int addAggInfoColumn(sqlite3 *db, AggInfo *pInfo){
408513449892Sdrh   int i;
4086cf643729Sdrh   pInfo->aCol = sqlite3ArrayAllocate(
408717435752Sdrh        db,
4088cf643729Sdrh        pInfo->aCol,
4089cf643729Sdrh        sizeof(pInfo->aCol[0]),
4090cf643729Sdrh        &pInfo->nColumn,
4091cf643729Sdrh        &i
4092cf643729Sdrh   );
409313449892Sdrh   return i;
40942282792aSdrh }
409513449892Sdrh 
409613449892Sdrh /*
409713449892Sdrh ** Add a new element to the pAggInfo->aFunc[] array.  Return the index of
409813449892Sdrh ** the new element.  Return a negative number if malloc fails.
409913449892Sdrh */
410017435752Sdrh static int addAggInfoFunc(sqlite3 *db, AggInfo *pInfo){
410113449892Sdrh   int i;
4102cf643729Sdrh   pInfo->aFunc = sqlite3ArrayAllocate(
410317435752Sdrh        db,
4104cf643729Sdrh        pInfo->aFunc,
4105cf643729Sdrh        sizeof(pInfo->aFunc[0]),
4106cf643729Sdrh        &pInfo->nFunc,
4107cf643729Sdrh        &i
4108cf643729Sdrh   );
410913449892Sdrh   return i;
41102282792aSdrh }
41112282792aSdrh 
41122282792aSdrh /*
41137d10d5a6Sdrh ** This is the xExprCallback for a tree walker.  It is used to
41147d10d5a6Sdrh ** implement sqlite3ExprAnalyzeAggregates().  See sqlite3ExprAnalyzeAggregates
4115626a879aSdrh ** for additional information.
41162282792aSdrh */
41177d10d5a6Sdrh static int analyzeAggregate(Walker *pWalker, Expr *pExpr){
41182282792aSdrh   int i;
41197d10d5a6Sdrh   NameContext *pNC = pWalker->u.pNC;
4120a58fdfb1Sdanielk1977   Parse *pParse = pNC->pParse;
4121a58fdfb1Sdanielk1977   SrcList *pSrcList = pNC->pSrcList;
412213449892Sdrh   AggInfo *pAggInfo = pNC->pAggInfo;
412313449892Sdrh 
41242282792aSdrh   switch( pExpr->op ){
412589c69d00Sdrh     case TK_AGG_COLUMN:
4126967e8b73Sdrh     case TK_COLUMN: {
41278b213899Sdrh       testcase( pExpr->op==TK_AGG_COLUMN );
41288b213899Sdrh       testcase( pExpr->op==TK_COLUMN );
412913449892Sdrh       /* Check to see if the column is in one of the tables in the FROM
413013449892Sdrh       ** clause of the aggregate query */
413120bc393cSdrh       if( ALWAYS(pSrcList!=0) ){
413213449892Sdrh         struct SrcList_item *pItem = pSrcList->a;
413313449892Sdrh         for(i=0; i<pSrcList->nSrc; i++, pItem++){
413413449892Sdrh           struct AggInfo_col *pCol;
4135c5cd1249Sdrh           assert( !ExprHasProperty(pExpr, EP_TokenOnly|EP_Reduced) );
413613449892Sdrh           if( pExpr->iTable==pItem->iCursor ){
413713449892Sdrh             /* If we reach this point, it means that pExpr refers to a table
413813449892Sdrh             ** that is in the FROM clause of the aggregate query.
413913449892Sdrh             **
414013449892Sdrh             ** Make an entry for the column in pAggInfo->aCol[] if there
414113449892Sdrh             ** is not an entry there already.
414213449892Sdrh             */
41437f906d63Sdrh             int k;
414413449892Sdrh             pCol = pAggInfo->aCol;
41457f906d63Sdrh             for(k=0; k<pAggInfo->nColumn; k++, pCol++){
414613449892Sdrh               if( pCol->iTable==pExpr->iTable &&
414713449892Sdrh                   pCol->iColumn==pExpr->iColumn ){
41482282792aSdrh                 break;
41492282792aSdrh               }
41502282792aSdrh             }
41511e536953Sdanielk1977             if( (k>=pAggInfo->nColumn)
41521e536953Sdanielk1977              && (k = addAggInfoColumn(pParse->db, pAggInfo))>=0
41531e536953Sdanielk1977             ){
41547f906d63Sdrh               pCol = &pAggInfo->aCol[k];
41550817d0dfSdanielk1977               pCol->pTab = pExpr->pTab;
415613449892Sdrh               pCol->iTable = pExpr->iTable;
415713449892Sdrh               pCol->iColumn = pExpr->iColumn;
41580a07c107Sdrh               pCol->iMem = ++pParse->nMem;
415913449892Sdrh               pCol->iSorterColumn = -1;
41605774b806Sdrh               pCol->pExpr = pExpr;
416113449892Sdrh               if( pAggInfo->pGroupBy ){
416213449892Sdrh                 int j, n;
416313449892Sdrh                 ExprList *pGB = pAggInfo->pGroupBy;
416413449892Sdrh                 struct ExprList_item *pTerm = pGB->a;
416513449892Sdrh                 n = pGB->nExpr;
416613449892Sdrh                 for(j=0; j<n; j++, pTerm++){
416713449892Sdrh                   Expr *pE = pTerm->pExpr;
416813449892Sdrh                   if( pE->op==TK_COLUMN && pE->iTable==pExpr->iTable &&
416913449892Sdrh                       pE->iColumn==pExpr->iColumn ){
417013449892Sdrh                     pCol->iSorterColumn = j;
417113449892Sdrh                     break;
41722282792aSdrh                   }
417313449892Sdrh                 }
417413449892Sdrh               }
417513449892Sdrh               if( pCol->iSorterColumn<0 ){
417613449892Sdrh                 pCol->iSorterColumn = pAggInfo->nSortingColumn++;
417713449892Sdrh               }
417813449892Sdrh             }
417913449892Sdrh             /* There is now an entry for pExpr in pAggInfo->aCol[] (either
418013449892Sdrh             ** because it was there before or because we just created it).
418113449892Sdrh             ** Convert the pExpr to be a TK_AGG_COLUMN referring to that
418213449892Sdrh             ** pAggInfo->aCol[] entry.
418313449892Sdrh             */
4184ebb6a65dSdrh             ExprSetVVAProperty(pExpr, EP_NoReduce);
418513449892Sdrh             pExpr->pAggInfo = pAggInfo;
418613449892Sdrh             pExpr->op = TK_AGG_COLUMN;
4187cf697396Sshane             pExpr->iAgg = (i16)k;
418813449892Sdrh             break;
418913449892Sdrh           } /* endif pExpr->iTable==pItem->iCursor */
419013449892Sdrh         } /* end loop over pSrcList */
4191a58fdfb1Sdanielk1977       }
41927d10d5a6Sdrh       return WRC_Prune;
41932282792aSdrh     }
41942282792aSdrh     case TK_AGG_FUNCTION: {
41953a8c4be7Sdrh       if( (pNC->ncFlags & NC_InAggFunc)==0
4196ed551b95Sdrh        && pWalker->walkerDepth==pExpr->op2
41973a8c4be7Sdrh       ){
419813449892Sdrh         /* Check to see if pExpr is a duplicate of another aggregate
419913449892Sdrh         ** function that is already in the pAggInfo structure
420013449892Sdrh         */
420113449892Sdrh         struct AggInfo_func *pItem = pAggInfo->aFunc;
420213449892Sdrh         for(i=0; i<pAggInfo->nFunc; i++, pItem++){
4203619a1305Sdrh           if( sqlite3ExprCompare(pItem->pExpr, pExpr, -1)==0 ){
42042282792aSdrh             break;
42052282792aSdrh           }
42062282792aSdrh         }
420713449892Sdrh         if( i>=pAggInfo->nFunc ){
420813449892Sdrh           /* pExpr is original.  Make a new entry in pAggInfo->aFunc[]
420913449892Sdrh           */
421014db2665Sdanielk1977           u8 enc = ENC(pParse->db);
42111e536953Sdanielk1977           i = addAggInfoFunc(pParse->db, pAggInfo);
421213449892Sdrh           if( i>=0 ){
42136ab3a2ecSdanielk1977             assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
421413449892Sdrh             pItem = &pAggInfo->aFunc[i];
421513449892Sdrh             pItem->pExpr = pExpr;
42160a07c107Sdrh             pItem->iMem = ++pParse->nMem;
421733e619fcSdrh             assert( !ExprHasProperty(pExpr, EP_IntValue) );
421813449892Sdrh             pItem->pFunc = sqlite3FindFunction(pParse->db,
421933e619fcSdrh                    pExpr->u.zToken, sqlite3Strlen30(pExpr->u.zToken),
42206ab3a2ecSdanielk1977                    pExpr->x.pList ? pExpr->x.pList->nExpr : 0, enc, 0);
4221fd357974Sdrh             if( pExpr->flags & EP_Distinct ){
4222fd357974Sdrh               pItem->iDistinct = pParse->nTab++;
4223fd357974Sdrh             }else{
4224fd357974Sdrh               pItem->iDistinct = -1;
4225fd357974Sdrh             }
42262282792aSdrh           }
422713449892Sdrh         }
422813449892Sdrh         /* Make pExpr point to the appropriate pAggInfo->aFunc[] entry
422913449892Sdrh         */
4230c5cd1249Sdrh         assert( !ExprHasProperty(pExpr, EP_TokenOnly|EP_Reduced) );
4231ebb6a65dSdrh         ExprSetVVAProperty(pExpr, EP_NoReduce);
4232cf697396Sshane         pExpr->iAgg = (i16)i;
423313449892Sdrh         pExpr->pAggInfo = pAggInfo;
42343a8c4be7Sdrh         return WRC_Prune;
42356e83a57fSdrh       }else{
42366e83a57fSdrh         return WRC_Continue;
42376e83a57fSdrh       }
42382282792aSdrh     }
4239a58fdfb1Sdanielk1977   }
42407d10d5a6Sdrh   return WRC_Continue;
42417d10d5a6Sdrh }
42427d10d5a6Sdrh static int analyzeAggregatesInSelect(Walker *pWalker, Select *pSelect){
4243d5a336efSdrh   UNUSED_PARAMETER(pWalker);
4244d5a336efSdrh   UNUSED_PARAMETER(pSelect);
42457d10d5a6Sdrh   return WRC_Continue;
4246a58fdfb1Sdanielk1977 }
4247626a879aSdrh 
4248626a879aSdrh /*
4249e8abb4caSdrh ** Analyze the pExpr expression looking for aggregate functions and
4250e8abb4caSdrh ** for variables that need to be added to AggInfo object that pNC->pAggInfo
4251e8abb4caSdrh ** points to.  Additional entries are made on the AggInfo object as
4252e8abb4caSdrh ** necessary.
4253626a879aSdrh **
4254626a879aSdrh ** This routine should only be called after the expression has been
42557d10d5a6Sdrh ** analyzed by sqlite3ResolveExprNames().
4256626a879aSdrh */
4257d2b3e23bSdrh void sqlite3ExprAnalyzeAggregates(NameContext *pNC, Expr *pExpr){
42587d10d5a6Sdrh   Walker w;
4259374fdce4Sdrh   memset(&w, 0, sizeof(w));
42607d10d5a6Sdrh   w.xExprCallback = analyzeAggregate;
42617d10d5a6Sdrh   w.xSelectCallback = analyzeAggregatesInSelect;
42627d10d5a6Sdrh   w.u.pNC = pNC;
426320bc393cSdrh   assert( pNC->pSrcList!=0 );
42647d10d5a6Sdrh   sqlite3WalkExpr(&w, pExpr);
42652282792aSdrh }
42665d9a4af9Sdrh 
42675d9a4af9Sdrh /*
42685d9a4af9Sdrh ** Call sqlite3ExprAnalyzeAggregates() for every expression in an
42695d9a4af9Sdrh ** expression list.  Return the number of errors.
42705d9a4af9Sdrh **
42715d9a4af9Sdrh ** If an error is found, the analysis is cut short.
42725d9a4af9Sdrh */
4273d2b3e23bSdrh void sqlite3ExprAnalyzeAggList(NameContext *pNC, ExprList *pList){
42745d9a4af9Sdrh   struct ExprList_item *pItem;
42755d9a4af9Sdrh   int i;
42765d9a4af9Sdrh   if( pList ){
4277d2b3e23bSdrh     for(pItem=pList->a, i=0; i<pList->nExpr; i++, pItem++){
4278d2b3e23bSdrh       sqlite3ExprAnalyzeAggregates(pNC, pItem->pExpr);
42795d9a4af9Sdrh     }
42805d9a4af9Sdrh   }
42815d9a4af9Sdrh }
4282892d3179Sdrh 
4283892d3179Sdrh /*
4284ceea3321Sdrh ** Allocate a single new register for use to hold some intermediate result.
4285892d3179Sdrh */
4286892d3179Sdrh int sqlite3GetTempReg(Parse *pParse){
4287e55cbd72Sdrh   if( pParse->nTempReg==0 ){
4288892d3179Sdrh     return ++pParse->nMem;
4289892d3179Sdrh   }
42902f425f6bSdanielk1977   return pParse->aTempReg[--pParse->nTempReg];
4291892d3179Sdrh }
4292ceea3321Sdrh 
4293ceea3321Sdrh /*
4294ceea3321Sdrh ** Deallocate a register, making available for reuse for some other
4295ceea3321Sdrh ** purpose.
4296ceea3321Sdrh **
4297ceea3321Sdrh ** If a register is currently being used by the column cache, then
4298ceea3321Sdrh ** the dallocation is deferred until the column cache line that uses
4299ceea3321Sdrh ** the register becomes stale.
4300ceea3321Sdrh */
4301892d3179Sdrh void sqlite3ReleaseTempReg(Parse *pParse, int iReg){
43022dcef11bSdrh   if( iReg && pParse->nTempReg<ArraySize(pParse->aTempReg) ){
4303ceea3321Sdrh     int i;
4304ceea3321Sdrh     struct yColCache *p;
4305ceea3321Sdrh     for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
4306ceea3321Sdrh       if( p->iReg==iReg ){
4307ceea3321Sdrh         p->tempReg = 1;
4308ceea3321Sdrh         return;
4309ceea3321Sdrh       }
4310ceea3321Sdrh     }
4311892d3179Sdrh     pParse->aTempReg[pParse->nTempReg++] = iReg;
4312892d3179Sdrh   }
4313892d3179Sdrh }
4314892d3179Sdrh 
4315892d3179Sdrh /*
4316892d3179Sdrh ** Allocate or deallocate a block of nReg consecutive registers
4317892d3179Sdrh */
4318892d3179Sdrh int sqlite3GetTempRange(Parse *pParse, int nReg){
4319e55cbd72Sdrh   int i, n;
4320892d3179Sdrh   i = pParse->iRangeReg;
4321e55cbd72Sdrh   n = pParse->nRangeReg;
4322f49f3523Sdrh   if( nReg<=n ){
4323f49f3523Sdrh     assert( !usedAsColumnCache(pParse, i, i+n-1) );
4324892d3179Sdrh     pParse->iRangeReg += nReg;
4325892d3179Sdrh     pParse->nRangeReg -= nReg;
4326892d3179Sdrh   }else{
4327892d3179Sdrh     i = pParse->nMem+1;
4328892d3179Sdrh     pParse->nMem += nReg;
4329892d3179Sdrh   }
4330892d3179Sdrh   return i;
4331892d3179Sdrh }
4332892d3179Sdrh void sqlite3ReleaseTempRange(Parse *pParse, int iReg, int nReg){
4333f49f3523Sdrh   sqlite3ExprCacheRemove(pParse, iReg, nReg);
4334892d3179Sdrh   if( nReg>pParse->nRangeReg ){
4335892d3179Sdrh     pParse->nRangeReg = nReg;
4336892d3179Sdrh     pParse->iRangeReg = iReg;
4337892d3179Sdrh   }
4338892d3179Sdrh }
4339cdc69557Sdrh 
4340cdc69557Sdrh /*
4341cdc69557Sdrh ** Mark all temporary registers as being unavailable for reuse.
4342cdc69557Sdrh */
4343cdc69557Sdrh void sqlite3ClearTempRegCache(Parse *pParse){
4344cdc69557Sdrh   pParse->nTempReg = 0;
4345cdc69557Sdrh   pParse->nRangeReg = 0;
4346cdc69557Sdrh }
4347