xref: /sqlite-3.40.0/src/expr.c (revision 9bec6fb3)
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);
36*9bec6fb3Smistachkin   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 /*
14799a96b668Sdanielk1977 ** This function is used by the implementation of the IN (...) operator.
1480d4305ca6Sdrh ** The pX parameter is the expression on the RHS of the IN operator, which
1481d4305ca6Sdrh ** might be either a list of expressions or a subquery.
14829a96b668Sdanielk1977 **
1483d4305ca6Sdrh ** The job of this routine is to find or create a b-tree object that can
1484d4305ca6Sdrh ** be used either to test for membership in the RHS set or to iterate through
1485d4305ca6Sdrh ** all members of the RHS set, skipping duplicates.
1486d4305ca6Sdrh **
1487d4305ca6Sdrh ** A cursor is opened on the b-tree object that the RHS of the IN operator
1488d4305ca6Sdrh ** and pX->iTable is set to the index of that cursor.
1489d4305ca6Sdrh **
1490b74b1017Sdrh ** The returned value of this function indicates the b-tree type, as follows:
14919a96b668Sdanielk1977 **
14929a96b668Sdanielk1977 **   IN_INDEX_ROWID      - The cursor was opened on a database table.
14931ccce449Sdrh **   IN_INDEX_INDEX_ASC  - The cursor was opened on an ascending index.
14941ccce449Sdrh **   IN_INDEX_INDEX_DESC - The cursor was opened on a descending index.
14959a96b668Sdanielk1977 **   IN_INDEX_EPH        - The cursor was opened on a specially created and
14969a96b668Sdanielk1977 **                         populated epheremal table.
14979a96b668Sdanielk1977 **
1498d4305ca6Sdrh ** An existing b-tree might be used if the RHS expression pX is a simple
1499d4305ca6Sdrh ** subquery such as:
15009a96b668Sdanielk1977 **
15019a96b668Sdanielk1977 **     SELECT <column> FROM <table>
15029a96b668Sdanielk1977 **
1503d4305ca6Sdrh ** If the RHS of the IN operator is a list or a more complex subquery, then
1504d4305ca6Sdrh ** an ephemeral table might need to be generated from the RHS and then
1505d4305ca6Sdrh ** pX->iTable made to point to the ephermeral table instead of an
1506d4305ca6Sdrh ** existing table.
1507d4305ca6Sdrh **
1508b74b1017Sdrh ** If the prNotFound parameter is 0, then the b-tree will be used to iterate
15099a96b668Sdanielk1977 ** through the set members, skipping any duplicates. In this case an
15109a96b668Sdanielk1977 ** epheremal table must be used unless the selected <column> is guaranteed
15119a96b668Sdanielk1977 ** to be unique - either because it is an INTEGER PRIMARY KEY or it
1512b74b1017Sdrh ** has a UNIQUE constraint or UNIQUE index.
15130cdc022eSdanielk1977 **
1514b74b1017Sdrh ** If the prNotFound parameter is not 0, then the b-tree will be used
15150cdc022eSdanielk1977 ** for fast set membership tests. In this case an epheremal table must
15160cdc022eSdanielk1977 ** be used unless <column> is an INTEGER PRIMARY KEY or an index can
15170cdc022eSdanielk1977 ** be found with <column> as its left-most column.
15180cdc022eSdanielk1977 **
1519b74b1017Sdrh ** When the b-tree is being used for membership tests, the calling function
15200cdc022eSdanielk1977 ** needs to know whether or not the structure contains an SQL NULL
15210cdc022eSdanielk1977 ** value in order to correctly evaluate expressions like "X IN (Y, Z)".
1522e3365e6cSdrh ** If there is any chance that the (...) might contain a NULL value at
15230cdc022eSdanielk1977 ** runtime, then a register is allocated and the register number written
1524e3365e6cSdrh ** to *prNotFound. If there is no chance that the (...) contains a
15250cdc022eSdanielk1977 ** NULL value, then *prNotFound is left unchanged.
15260cdc022eSdanielk1977 **
15270cdc022eSdanielk1977 ** If a register is allocated and its location stored in *prNotFound, then
1528e3365e6cSdrh ** its initial value is NULL.  If the (...) does not remain constant
1529e3365e6cSdrh ** for the duration of the query (i.e. the SELECT within the (...)
1530b74b1017Sdrh ** is a correlated subquery) then the value of the allocated register is
1531e3365e6cSdrh ** reset to NULL each time the subquery is rerun. This allows the
1532b74b1017Sdrh ** caller to use vdbe code equivalent to the following:
15330cdc022eSdanielk1977 **
15340cdc022eSdanielk1977 **   if( register==NULL ){
15350cdc022eSdanielk1977 **     has_null = <test if data structure contains null>
15360cdc022eSdanielk1977 **     register = 1
15370cdc022eSdanielk1977 **   }
15380cdc022eSdanielk1977 **
15390cdc022eSdanielk1977 ** in order to avoid running the <test if data structure contains null>
15400cdc022eSdanielk1977 ** test more often than is necessary.
15419a96b668Sdanielk1977 */
1542284f4acaSdanielk1977 #ifndef SQLITE_OMIT_SUBQUERY
15430cdc022eSdanielk1977 int sqlite3FindInIndex(Parse *pParse, Expr *pX, int *prNotFound){
1544b74b1017Sdrh   Select *p;                            /* SELECT to the right of IN operator */
1545b74b1017Sdrh   int eType = 0;                        /* Type of RHS table. IN_INDEX_* */
1546b74b1017Sdrh   int iTab = pParse->nTab++;            /* Cursor of the RHS table */
1547b74b1017Sdrh   int mustBeUnique = (prNotFound==0);   /* True if RHS must be unique */
1548b8475df8Sdrh   Vdbe *v = sqlite3GetVdbe(pParse);     /* Virtual machine being coded */
15499a96b668Sdanielk1977 
15501450bc6eSdrh   assert( pX->op==TK_IN );
15511450bc6eSdrh 
1552b74b1017Sdrh   /* Check to see if an existing table or index can be used to
1553b74b1017Sdrh   ** satisfy the query.  This is preferable to generating a new
1554b74b1017Sdrh   ** ephemeral table.
15559a96b668Sdanielk1977   */
15566ab3a2ecSdanielk1977   p = (ExprHasProperty(pX, EP_xIsSelect) ? pX->x.pSelect : 0);
1557fd773cf9Sdrh   if( ALWAYS(pParse->nErr==0) && isCandidateForInOpt(p) ){
1558e1fb65a0Sdanielk1977     sqlite3 *db = pParse->db;              /* Database connection */
1559b07028f7Sdrh     Table *pTab;                           /* Table <table>. */
1560b07028f7Sdrh     Expr *pExpr;                           /* Expression <column> */
1561bbbdc83bSdrh     i16 iCol;                              /* Index of column <column> */
1562bbbdc83bSdrh     i16 iDb;                               /* Database idx for pTab */
1563e1fb65a0Sdanielk1977 
1564b07028f7Sdrh     assert( p );                        /* Because of isCandidateForInOpt(p) */
1565b07028f7Sdrh     assert( p->pEList!=0 );             /* Because of isCandidateForInOpt(p) */
1566b07028f7Sdrh     assert( p->pEList->a[0].pExpr!=0 ); /* Because of isCandidateForInOpt(p) */
1567b07028f7Sdrh     assert( p->pSrc!=0 );               /* Because of isCandidateForInOpt(p) */
1568b07028f7Sdrh     pTab = p->pSrc->a[0].pTab;
1569b07028f7Sdrh     pExpr = p->pEList->a[0].pExpr;
1570bbbdc83bSdrh     iCol = (i16)pExpr->iColumn;
1571b07028f7Sdrh 
1572b22f7c83Sdrh     /* Code an OP_Transaction and OP_TableLock for <table>. */
1573e1fb65a0Sdanielk1977     iDb = sqlite3SchemaToIndex(db, pTab->pSchema);
1574e1fb65a0Sdanielk1977     sqlite3CodeVerifySchema(pParse, iDb);
1575e1fb65a0Sdanielk1977     sqlite3TableLock(pParse, iDb, pTab->tnum, 0, pTab->zName);
15769a96b668Sdanielk1977 
15779a96b668Sdanielk1977     /* This function is only called from two places. In both cases the vdbe
15789a96b668Sdanielk1977     ** has already been allocated. So assume sqlite3GetVdbe() is always
15799a96b668Sdanielk1977     ** successful here.
15809a96b668Sdanielk1977     */
15819a96b668Sdanielk1977     assert(v);
15829a96b668Sdanielk1977     if( iCol<0 ){
15837d176105Sdrh       int iAddr = sqlite3CodeOnce(pParse);
15847d176105Sdrh       VdbeCoverage(v);
15859a96b668Sdanielk1977 
15869a96b668Sdanielk1977       sqlite3OpenTable(pParse, iTab, iDb, pTab, OP_OpenRead);
15879a96b668Sdanielk1977       eType = IN_INDEX_ROWID;
15889a96b668Sdanielk1977 
15899a96b668Sdanielk1977       sqlite3VdbeJumpHere(v, iAddr);
15909a96b668Sdanielk1977     }else{
1591e1fb65a0Sdanielk1977       Index *pIdx;                         /* Iterator variable */
1592e1fb65a0Sdanielk1977 
15939a96b668Sdanielk1977       /* The collation sequence used by the comparison. If an index is to
15949a96b668Sdanielk1977       ** be used in place of a temp-table, it must be ordered according
1595e1fb65a0Sdanielk1977       ** to this collation sequence.  */
15969a96b668Sdanielk1977       CollSeq *pReq = sqlite3BinaryCompareCollSeq(pParse, pX->pLeft, pExpr);
15979a96b668Sdanielk1977 
15989a96b668Sdanielk1977       /* Check that the affinity that will be used to perform the
15999a96b668Sdanielk1977       ** comparison is the same as the affinity of the column. If
16009a96b668Sdanielk1977       ** it is not, it is not possible to use any index.
16019a96b668Sdanielk1977       */
1602dbaee5e3Sdrh       int affinity_ok = sqlite3IndexAffinityOk(pX, pTab->aCol[iCol].affinity);
16039a96b668Sdanielk1977 
16049a96b668Sdanielk1977       for(pIdx=pTab->pIndex; pIdx && eType==0 && affinity_ok; pIdx=pIdx->pNext){
16059a96b668Sdanielk1977         if( (pIdx->aiColumn[0]==iCol)
1606b74b1017Sdrh          && sqlite3FindCollSeq(db, ENC(db), pIdx->azColl[0], 0)==pReq
1607bbbdc83bSdrh          && (!mustBeUnique || (pIdx->nKeyCol==1 && pIdx->onError!=OE_None))
16089a96b668Sdanielk1977         ){
16097d176105Sdrh           int iAddr = sqlite3CodeOnce(pParse); VdbeCoverage(v);
16102ec2fb22Sdrh           sqlite3VdbeAddOp3(v, OP_OpenRead, iTab, pIdx->tnum, iDb);
16112ec2fb22Sdrh           sqlite3VdbeSetP4KeyInfo(pParse, pIdx);
1612207872a4Sdanielk1977           VdbeComment((v, "%s", pIdx->zName));
16131ccce449Sdrh           assert( IN_INDEX_INDEX_DESC == IN_INDEX_INDEX_ASC+1 );
16141ccce449Sdrh           eType = IN_INDEX_INDEX_ASC + pIdx->aSortOrder[0];
16159a96b668Sdanielk1977 
16160cdc022eSdanielk1977           if( prNotFound && !pTab->aCol[iCol].notNull ){
16170cdc022eSdanielk1977             *prNotFound = ++pParse->nMem;
1618b8475df8Sdrh             sqlite3VdbeAddOp2(v, OP_Null, 0, *prNotFound);
16190cdc022eSdanielk1977           }
1620552fd454Sdrh           sqlite3VdbeJumpHere(v, iAddr);
16219a96b668Sdanielk1977         }
16229a96b668Sdanielk1977       }
16239a96b668Sdanielk1977     }
16249a96b668Sdanielk1977   }
16259a96b668Sdanielk1977 
16269a96b668Sdanielk1977   if( eType==0 ){
16271450bc6eSdrh     /* Could not found an existing table or index to use as the RHS b-tree.
1628b74b1017Sdrh     ** We will have to generate an ephemeral table to do the job.
1629b74b1017Sdrh     */
16308e23daf3Sdrh     u32 savedNQueryLoop = pParse->nQueryLoop;
16310cdc022eSdanielk1977     int rMayHaveNull = 0;
163241a05b7bSdanielk1977     eType = IN_INDEX_EPH;
16330cdc022eSdanielk1977     if( prNotFound ){
16340cdc022eSdanielk1977       *prNotFound = rMayHaveNull = ++pParse->nMem;
1635b8475df8Sdrh       sqlite3VdbeAddOp2(v, OP_Null, 0, *prNotFound);
1636cf4d38aaSdrh     }else{
16374a5acf8eSdrh       pParse->nQueryLoop = 0;
1638c5cd1249Sdrh       if( pX->pLeft->iColumn<0 && !ExprHasProperty(pX, EP_xIsSelect) ){
163941a05b7bSdanielk1977         eType = IN_INDEX_ROWID;
16400cdc022eSdanielk1977       }
1641cf4d38aaSdrh     }
164241a05b7bSdanielk1977     sqlite3CodeSubselect(pParse, pX, rMayHaveNull, eType==IN_INDEX_ROWID);
1643cf4d38aaSdrh     pParse->nQueryLoop = savedNQueryLoop;
16449a96b668Sdanielk1977   }else{
16459a96b668Sdanielk1977     pX->iTable = iTab;
16469a96b668Sdanielk1977   }
16479a96b668Sdanielk1977   return eType;
16489a96b668Sdanielk1977 }
1649284f4acaSdanielk1977 #endif
1650626a879aSdrh 
1651626a879aSdrh /*
1652d4187c71Sdrh ** Generate code for scalar subqueries used as a subquery expression, EXISTS,
1653d4187c71Sdrh ** or IN operators.  Examples:
1654626a879aSdrh **
16559cbe6352Sdrh **     (SELECT a FROM b)          -- subquery
16569cbe6352Sdrh **     EXISTS (SELECT a FROM b)   -- EXISTS subquery
16579cbe6352Sdrh **     x IN (4,5,11)              -- IN operator with list on right-hand side
16589cbe6352Sdrh **     x IN (SELECT a FROM b)     -- IN operator with subquery on the right
1659fef5208cSdrh **
16609cbe6352Sdrh ** The pExpr parameter describes the expression that contains the IN
16619cbe6352Sdrh ** operator or subquery.
166241a05b7bSdanielk1977 **
166341a05b7bSdanielk1977 ** If parameter isRowid is non-zero, then expression pExpr is guaranteed
166441a05b7bSdanielk1977 ** to be of the form "<rowid> IN (?, ?, ?)", where <rowid> is a reference
166541a05b7bSdanielk1977 ** to some integer key column of a table B-Tree. In this case, use an
166641a05b7bSdanielk1977 ** intkey B-Tree to store the set of IN(...) values instead of the usual
166741a05b7bSdanielk1977 ** (slower) variable length keys B-Tree.
1668fd773cf9Sdrh **
1669fd773cf9Sdrh ** If rMayHaveNull is non-zero, that means that the operation is an IN
1670fd773cf9Sdrh ** (not a SELECT or EXISTS) and that the RHS might contains NULLs.
1671fd773cf9Sdrh ** Furthermore, the IN is in a WHERE clause and that we really want
1672fd773cf9Sdrh ** to iterate over the RHS of the IN operator in order to quickly locate
1673fd773cf9Sdrh ** all corresponding LHS elements.  All this routine does is initialize
1674fd773cf9Sdrh ** the register given by rMayHaveNull to NULL.  Calling routines will take
1675fd773cf9Sdrh ** care of changing this register value to non-NULL if the RHS is NULL-free.
1676fd773cf9Sdrh **
1677fd773cf9Sdrh ** If rMayHaveNull is zero, that means that the subquery is being used
1678fd773cf9Sdrh ** for membership testing only.  There is no need to initialize any
1679f7b5496eSdrh ** registers to indicate the presence or absence of NULLs on the RHS.
16801450bc6eSdrh **
16811450bc6eSdrh ** For a SELECT or EXISTS operator, return the register that holds the
16821450bc6eSdrh ** result.  For IN operators or if an error occurs, the return value is 0.
1683cce7d176Sdrh */
168451522cd3Sdrh #ifndef SQLITE_OMIT_SUBQUERY
16851450bc6eSdrh int sqlite3CodeSubselect(
1686fd773cf9Sdrh   Parse *pParse,          /* Parsing context */
1687fd773cf9Sdrh   Expr *pExpr,            /* The IN, SELECT, or EXISTS operator */
1688fd773cf9Sdrh   int rMayHaveNull,       /* Register that records whether NULLs exist in RHS */
1689fd773cf9Sdrh   int isRowid             /* If true, LHS of IN operator is a rowid */
169041a05b7bSdanielk1977 ){
1691dfd2d9f6Sdrh   int testAddr = -1;                      /* One-time test address */
16921450bc6eSdrh   int rReg = 0;                           /* Register storing resulting */
1693b3bce662Sdanielk1977   Vdbe *v = sqlite3GetVdbe(pParse);
16941450bc6eSdrh   if( NEVER(v==0) ) return 0;
1695ceea3321Sdrh   sqlite3ExprCachePush(pParse);
1696fc976065Sdanielk1977 
169757dbd7b3Sdrh   /* This code must be run in its entirety every time it is encountered
169857dbd7b3Sdrh   ** if any of the following is true:
169957dbd7b3Sdrh   **
170057dbd7b3Sdrh   **    *  The right-hand side is a correlated subquery
170157dbd7b3Sdrh   **    *  The right-hand side is an expression list containing variables
170257dbd7b3Sdrh   **    *  We are inside a trigger
170357dbd7b3Sdrh   **
170457dbd7b3Sdrh   ** If all of the above are false, then we can run this code just once
170557dbd7b3Sdrh   ** save the results, and reuse the same result on subsequent invocations.
1706b3bce662Sdanielk1977   */
1707c5cd1249Sdrh   if( !ExprHasProperty(pExpr, EP_VarSelect) ){
17087d176105Sdrh     testAddr = sqlite3CodeOnce(pParse); VdbeCoverage(v);
1709b3bce662Sdanielk1977   }
1710b3bce662Sdanielk1977 
17114a07e3dbSdan #ifndef SQLITE_OMIT_EXPLAIN
17124a07e3dbSdan   if( pParse->explain==2 ){
17134a07e3dbSdan     char *zMsg = sqlite3MPrintf(
1714dfd2d9f6Sdrh         pParse->db, "EXECUTE %s%s SUBQUERY %d", testAddr>=0?"":"CORRELATED ",
17154a07e3dbSdan         pExpr->op==TK_IN?"LIST":"SCALAR", pParse->iNextSelectId
17164a07e3dbSdan     );
17174a07e3dbSdan     sqlite3VdbeAddOp4(v, OP_Explain, pParse->iSelectId, 0, 0, zMsg, P4_DYNAMIC);
17184a07e3dbSdan   }
17194a07e3dbSdan #endif
17204a07e3dbSdan 
1721cce7d176Sdrh   switch( pExpr->op ){
1722fef5208cSdrh     case TK_IN: {
1723d4187c71Sdrh       char affinity;              /* Affinity of the LHS of the IN */
1724b9bb7c18Sdrh       int addr;                   /* Address of OP_OpenEphemeral instruction */
1725d4187c71Sdrh       Expr *pLeft = pExpr->pLeft; /* the LHS of the IN operator */
1726323df790Sdrh       KeyInfo *pKeyInfo = 0;      /* Key information */
1727d3d39e93Sdrh 
17280cdc022eSdanielk1977       if( rMayHaveNull ){
17290cdc022eSdanielk1977         sqlite3VdbeAddOp2(v, OP_Null, 0, rMayHaveNull);
17300cdc022eSdanielk1977       }
17310cdc022eSdanielk1977 
173241a05b7bSdanielk1977       affinity = sqlite3ExprAffinity(pLeft);
1733e014a838Sdanielk1977 
1734e014a838Sdanielk1977       /* Whether this is an 'x IN(SELECT...)' or an 'x IN(<exprlist>)'
17358cff69dfSdrh       ** expression it is handled the same way.  An ephemeral table is
1736e014a838Sdanielk1977       ** filled with single-field index keys representing the results
1737e014a838Sdanielk1977       ** from the SELECT or the <exprlist>.
1738fef5208cSdrh       **
1739e014a838Sdanielk1977       ** If the 'x' expression is a column value, or the SELECT...
1740e014a838Sdanielk1977       ** statement returns a column value, then the affinity of that
1741e014a838Sdanielk1977       ** column is used to build the index keys. If both 'x' and the
1742e014a838Sdanielk1977       ** SELECT... statement are columns, then numeric affinity is used
1743e014a838Sdanielk1977       ** if either column has NUMERIC or INTEGER affinity. If neither
1744e014a838Sdanielk1977       ** 'x' nor the SELECT... statement are columns, then numeric affinity
1745e014a838Sdanielk1977       ** is used.
1746fef5208cSdrh       */
1747832508b7Sdrh       pExpr->iTable = pParse->nTab++;
174841a05b7bSdanielk1977       addr = sqlite3VdbeAddOp2(v, OP_OpenEphemeral, pExpr->iTable, !isRowid);
1749ad124329Sdrh       pKeyInfo = isRowid ? 0 : sqlite3KeyInfoAlloc(pParse->db, 1, 1);
1750e014a838Sdanielk1977 
17516ab3a2ecSdanielk1977       if( ExprHasProperty(pExpr, EP_xIsSelect) ){
1752e014a838Sdanielk1977         /* Case 1:     expr IN (SELECT ...)
1753e014a838Sdanielk1977         **
1754e014a838Sdanielk1977         ** Generate code to write the results of the select into the temporary
1755e014a838Sdanielk1977         ** table allocated and opened above.
1756e014a838Sdanielk1977         */
17571013c932Sdrh         SelectDest dest;
1758be5c89acSdrh         ExprList *pEList;
17591013c932Sdrh 
176041a05b7bSdanielk1977         assert( !isRowid );
17611013c932Sdrh         sqlite3SelectDestInit(&dest, SRT_Set, pExpr->iTable);
17622b596da8Sdrh         dest.affSdst = (u8)affinity;
1763e014a838Sdanielk1977         assert( (pExpr->iTable&0x0000FFFF)==pExpr->iTable );
176448b5b041Sdrh         pExpr->x.pSelect->iLimit = 0;
1765812ea833Sdrh         testcase( pKeyInfo==0 ); /* Caused by OOM in sqlite3KeyInfoAlloc() */
17666ab3a2ecSdanielk1977         if( sqlite3Select(pParse, pExpr->x.pSelect, &dest) ){
17672ec2fb22Sdrh           sqlite3KeyInfoUnref(pKeyInfo);
17681450bc6eSdrh           return 0;
176994ccde58Sdrh         }
17706ab3a2ecSdanielk1977         pEList = pExpr->x.pSelect->pEList;
1771812ea833Sdrh         assert( pKeyInfo!=0 ); /* OOM will cause exit after sqlite3Select() */
17723535ec3eSdrh         assert( pEList!=0 );
17733535ec3eSdrh         assert( pEList->nExpr>0 );
17742ec2fb22Sdrh         assert( sqlite3KeyInfoIsWriteable(pKeyInfo) );
1775323df790Sdrh         pKeyInfo->aColl[0] = sqlite3BinaryCompareCollSeq(pParse, pExpr->pLeft,
1776be5c89acSdrh                                                          pEList->a[0].pExpr);
1777a7d2db17Sdrh       }else if( ALWAYS(pExpr->x.pList!=0) ){
1778fef5208cSdrh         /* Case 2:     expr IN (exprlist)
1779fef5208cSdrh         **
1780e014a838Sdanielk1977         ** For each expression, build an index key from the evaluation and
1781e014a838Sdanielk1977         ** store it in the temporary table. If <expr> is a column, then use
1782e014a838Sdanielk1977         ** that columns affinity when building index keys. If <expr> is not
1783e014a838Sdanielk1977         ** a column, use numeric affinity.
1784fef5208cSdrh         */
1785e014a838Sdanielk1977         int i;
17866ab3a2ecSdanielk1977         ExprList *pList = pExpr->x.pList;
178757dbd7b3Sdrh         struct ExprList_item *pItem;
1788ecc31805Sdrh         int r1, r2, r3;
178957dbd7b3Sdrh 
1790e014a838Sdanielk1977         if( !affinity ){
17918159a35fSdrh           affinity = SQLITE_AFF_NONE;
1792e014a838Sdanielk1977         }
1793323df790Sdrh         if( pKeyInfo ){
17942ec2fb22Sdrh           assert( sqlite3KeyInfoIsWriteable(pKeyInfo) );
1795323df790Sdrh           pKeyInfo->aColl[0] = sqlite3ExprCollSeq(pParse, pExpr->pLeft);
1796323df790Sdrh         }
1797e014a838Sdanielk1977 
1798e014a838Sdanielk1977         /* Loop through each expression in <exprlist>. */
17992d401ab8Sdrh         r1 = sqlite3GetTempReg(pParse);
18002d401ab8Sdrh         r2 = sqlite3GetTempReg(pParse);
18014e7f36a2Sdanielk1977         sqlite3VdbeAddOp2(v, OP_Null, 0, r2);
180257dbd7b3Sdrh         for(i=pList->nExpr, pItem=pList->a; i>0; i--, pItem++){
180357dbd7b3Sdrh           Expr *pE2 = pItem->pExpr;
1804e05c929bSdrh           int iValToIns;
1805e014a838Sdanielk1977 
180657dbd7b3Sdrh           /* If the expression is not constant then we will need to
180757dbd7b3Sdrh           ** disable the test that was generated above that makes sure
180857dbd7b3Sdrh           ** this code only executes once.  Because for a non-constant
180957dbd7b3Sdrh           ** expression we need to rerun this code each time.
181057dbd7b3Sdrh           */
1811dfd2d9f6Sdrh           if( testAddr>=0 && !sqlite3ExprIsConstant(pE2) ){
181248f2d3b1Sdrh             sqlite3VdbeChangeToNoop(v, testAddr);
1813dfd2d9f6Sdrh             testAddr = -1;
18144794b980Sdrh           }
1815e014a838Sdanielk1977 
1816e014a838Sdanielk1977           /* Evaluate the expression and insert it into the temp table */
1817e05c929bSdrh           if( isRowid && sqlite3ExprIsInteger(pE2, &iValToIns) ){
1818e05c929bSdrh             sqlite3VdbeAddOp3(v, OP_InsertInt, pExpr->iTable, r2, iValToIns);
1819e05c929bSdrh           }else{
1820ecc31805Sdrh             r3 = sqlite3ExprCodeTarget(pParse, pE2, r1);
182141a05b7bSdanielk1977             if( isRowid ){
1822e05c929bSdrh               sqlite3VdbeAddOp2(v, OP_MustBeInt, r3,
1823e05c929bSdrh                                 sqlite3VdbeCurrentAddr(v)+2);
1824688852abSdrh               VdbeCoverage(v);
182541a05b7bSdanielk1977               sqlite3VdbeAddOp3(v, OP_Insert, pExpr->iTable, r2, r3);
182641a05b7bSdanielk1977             }else{
1827ecc31805Sdrh               sqlite3VdbeAddOp4(v, OP_MakeRecord, r3, 1, r2, &affinity, 1);
18283c31fc23Sdrh               sqlite3ExprCacheAffinityChange(pParse, r3, 1);
18292d401ab8Sdrh               sqlite3VdbeAddOp2(v, OP_IdxInsert, pExpr->iTable, r2);
1830fef5208cSdrh             }
183141a05b7bSdanielk1977           }
1832e05c929bSdrh         }
18332d401ab8Sdrh         sqlite3ReleaseTempReg(pParse, r1);
18342d401ab8Sdrh         sqlite3ReleaseTempReg(pParse, r2);
1835fef5208cSdrh       }
1836323df790Sdrh       if( pKeyInfo ){
18372ec2fb22Sdrh         sqlite3VdbeChangeP4(v, addr, (void *)pKeyInfo, P4_KEYINFO);
183841a05b7bSdanielk1977       }
1839b3bce662Sdanielk1977       break;
1840fef5208cSdrh     }
1841fef5208cSdrh 
184251522cd3Sdrh     case TK_EXISTS:
1843fd773cf9Sdrh     case TK_SELECT:
1844fd773cf9Sdrh     default: {
1845fd773cf9Sdrh       /* If this has to be a scalar SELECT.  Generate code to put the
1846fef5208cSdrh       ** value of this select in a memory cell and record the number
1847fd773cf9Sdrh       ** of the memory cell in iColumn.  If this is an EXISTS, write
1848fd773cf9Sdrh       ** an integer 0 (not exists) or 1 (exists) into a memory cell
1849fd773cf9Sdrh       ** and record that memory cell in iColumn.
1850fef5208cSdrh       */
1851fd773cf9Sdrh       Select *pSel;                         /* SELECT statement to encode */
1852fd773cf9Sdrh       SelectDest dest;                      /* How to deal with SELECt result */
18531398ad36Sdrh 
1854cf697396Sshane       testcase( pExpr->op==TK_EXISTS );
1855cf697396Sshane       testcase( pExpr->op==TK_SELECT );
1856cf697396Sshane       assert( pExpr->op==TK_EXISTS || pExpr->op==TK_SELECT );
1857cf697396Sshane 
18586ab3a2ecSdanielk1977       assert( ExprHasProperty(pExpr, EP_xIsSelect) );
18596ab3a2ecSdanielk1977       pSel = pExpr->x.pSelect;
18601013c932Sdrh       sqlite3SelectDestInit(&dest, 0, ++pParse->nMem);
186151522cd3Sdrh       if( pExpr->op==TK_SELECT ){
18626c8c8ce0Sdanielk1977         dest.eDest = SRT_Mem;
18632b596da8Sdrh         sqlite3VdbeAddOp2(v, OP_Null, 0, dest.iSDParm);
1864d4e70ebdSdrh         VdbeComment((v, "Init subquery result"));
186551522cd3Sdrh       }else{
18666c8c8ce0Sdanielk1977         dest.eDest = SRT_Exists;
18672b596da8Sdrh         sqlite3VdbeAddOp2(v, OP_Integer, 0, dest.iSDParm);
1868d4e70ebdSdrh         VdbeComment((v, "Init EXISTS result"));
186951522cd3Sdrh       }
1870633e6d57Sdrh       sqlite3ExprDelete(pParse->db, pSel->pLimit);
1871094430ebSdrh       pSel->pLimit = sqlite3PExpr(pParse, TK_INTEGER, 0, 0,
1872094430ebSdrh                                   &sqlite3IntTokens[1]);
187348b5b041Sdrh       pSel->iLimit = 0;
18747d10d5a6Sdrh       if( sqlite3Select(pParse, pSel, &dest) ){
18751450bc6eSdrh         return 0;
187694ccde58Sdrh       }
18772b596da8Sdrh       rReg = dest.iSDParm;
1878ebb6a65dSdrh       ExprSetVVAProperty(pExpr, EP_NoReduce);
1879b3bce662Sdanielk1977       break;
188019a775c2Sdrh     }
1881cce7d176Sdrh   }
1882b3bce662Sdanielk1977 
1883dfd2d9f6Sdrh   if( testAddr>=0 ){
188448f2d3b1Sdrh     sqlite3VdbeJumpHere(v, testAddr);
1885b3bce662Sdanielk1977   }
1886d2490904Sdrh   sqlite3ExprCachePop(pParse);
1887fc976065Sdanielk1977 
18881450bc6eSdrh   return rReg;
1889cce7d176Sdrh }
189051522cd3Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
1891cce7d176Sdrh 
1892e3365e6cSdrh #ifndef SQLITE_OMIT_SUBQUERY
1893e3365e6cSdrh /*
1894e3365e6cSdrh ** Generate code for an IN expression.
1895e3365e6cSdrh **
1896e3365e6cSdrh **      x IN (SELECT ...)
1897e3365e6cSdrh **      x IN (value, value, ...)
1898e3365e6cSdrh **
1899e3365e6cSdrh ** The left-hand side (LHS) is a scalar expression.  The right-hand side (RHS)
1900e3365e6cSdrh ** is an array of zero or more values.  The expression is true if the LHS is
1901e3365e6cSdrh ** contained within the RHS.  The value of the expression is unknown (NULL)
1902e3365e6cSdrh ** if the LHS is NULL or if the LHS is not contained within the RHS and the
1903e3365e6cSdrh ** RHS contains one or more NULL values.
1904e3365e6cSdrh **
1905e3365e6cSdrh ** This routine generates code will jump to destIfFalse if the LHS is not
1906e3365e6cSdrh ** contained within the RHS.  If due to NULLs we cannot determine if the LHS
1907e3365e6cSdrh ** is contained in the RHS then jump to destIfNull.  If the LHS is contained
1908e3365e6cSdrh ** within the RHS then fall through.
1909e3365e6cSdrh */
1910e3365e6cSdrh static void sqlite3ExprCodeIN(
1911e3365e6cSdrh   Parse *pParse,        /* Parsing and code generating context */
1912e3365e6cSdrh   Expr *pExpr,          /* The IN expression */
1913e3365e6cSdrh   int destIfFalse,      /* Jump here if LHS is not contained in the RHS */
1914e3365e6cSdrh   int destIfNull        /* Jump here if the results are unknown due to NULLs */
1915e3365e6cSdrh ){
1916e3365e6cSdrh   int rRhsHasNull = 0;  /* Register that is true if RHS contains NULL values */
1917e3365e6cSdrh   char affinity;        /* Comparison affinity to use */
1918e3365e6cSdrh   int eType;            /* Type of the RHS */
1919e3365e6cSdrh   int r1;               /* Temporary use register */
1920e3365e6cSdrh   Vdbe *v;              /* Statement under construction */
1921e3365e6cSdrh 
1922e3365e6cSdrh   /* Compute the RHS.   After this step, the table with cursor
1923e3365e6cSdrh   ** pExpr->iTable will contains the values that make up the RHS.
1924e3365e6cSdrh   */
1925e3365e6cSdrh   v = pParse->pVdbe;
1926e3365e6cSdrh   assert( v!=0 );       /* OOM detected prior to this routine */
1927e3365e6cSdrh   VdbeNoopComment((v, "begin IN expr"));
1928e3365e6cSdrh   eType = sqlite3FindInIndex(pParse, pExpr, &rRhsHasNull);
1929e3365e6cSdrh 
1930e3365e6cSdrh   /* Figure out the affinity to use to create a key from the results
1931e3365e6cSdrh   ** of the expression. affinityStr stores a static string suitable for
1932e3365e6cSdrh   ** P4 of OP_MakeRecord.
1933e3365e6cSdrh   */
1934e3365e6cSdrh   affinity = comparisonAffinity(pExpr);
1935e3365e6cSdrh 
1936e3365e6cSdrh   /* Code the LHS, the <expr> from "<expr> IN (...)".
1937e3365e6cSdrh   */
1938e3365e6cSdrh   sqlite3ExprCachePush(pParse);
1939e3365e6cSdrh   r1 = sqlite3GetTempReg(pParse);
1940e3365e6cSdrh   sqlite3ExprCode(pParse, pExpr->pLeft, r1);
1941e3365e6cSdrh 
1942094430ebSdrh   /* If the LHS is NULL, then the result is either false or NULL depending
1943094430ebSdrh   ** on whether the RHS is empty or not, respectively.
1944094430ebSdrh   */
1945094430ebSdrh   if( destIfNull==destIfFalse ){
1946094430ebSdrh     /* Shortcut for the common case where the false and NULL outcomes are
1947094430ebSdrh     ** the same. */
1948688852abSdrh     sqlite3VdbeAddOp2(v, OP_IsNull, r1, destIfNull); VdbeCoverage(v);
1949094430ebSdrh   }else{
1950688852abSdrh     int addr1 = sqlite3VdbeAddOp1(v, OP_NotNull, r1); VdbeCoverage(v);
1951094430ebSdrh     sqlite3VdbeAddOp2(v, OP_Rewind, pExpr->iTable, destIfFalse);
1952688852abSdrh     VdbeCoverage(v);
1953094430ebSdrh     sqlite3VdbeAddOp2(v, OP_Goto, 0, destIfNull);
1954094430ebSdrh     sqlite3VdbeJumpHere(v, addr1);
1955094430ebSdrh   }
1956e3365e6cSdrh 
1957e3365e6cSdrh   if( eType==IN_INDEX_ROWID ){
1958e3365e6cSdrh     /* In this case, the RHS is the ROWID of table b-tree
1959e3365e6cSdrh     */
1960688852abSdrh     sqlite3VdbeAddOp2(v, OP_MustBeInt, r1, destIfFalse); VdbeCoverage(v);
1961e3365e6cSdrh     sqlite3VdbeAddOp3(v, OP_NotExists, pExpr->iTable, destIfFalse, r1);
1962688852abSdrh     VdbeCoverage(v);
1963e3365e6cSdrh   }else{
1964e3365e6cSdrh     /* In this case, the RHS is an index b-tree.
1965e3365e6cSdrh     */
19668cff69dfSdrh     sqlite3VdbeAddOp4(v, OP_Affinity, r1, 1, 0, &affinity, 1);
1967e3365e6cSdrh 
1968e3365e6cSdrh     /* If the set membership test fails, then the result of the
1969e3365e6cSdrh     ** "x IN (...)" expression must be either 0 or NULL. If the set
1970e3365e6cSdrh     ** contains no NULL values, then the result is 0. If the set
1971e3365e6cSdrh     ** contains one or more NULL values, then the result of the
1972e3365e6cSdrh     ** expression is also NULL.
1973e3365e6cSdrh     */
1974e3365e6cSdrh     if( rRhsHasNull==0 || destIfFalse==destIfNull ){
1975e3365e6cSdrh       /* This branch runs if it is known at compile time that the RHS
1976e3365e6cSdrh       ** cannot contain NULL values. This happens as the result
1977e3365e6cSdrh       ** of a "NOT NULL" constraint in the database schema.
1978e3365e6cSdrh       **
1979e3365e6cSdrh       ** Also run this branch if NULL is equivalent to FALSE
1980e3365e6cSdrh       ** for this particular IN operator.
1981e3365e6cSdrh       */
19828cff69dfSdrh       sqlite3VdbeAddOp4Int(v, OP_NotFound, pExpr->iTable, destIfFalse, r1, 1);
1983688852abSdrh       VdbeCoverage(v);
1984e3365e6cSdrh     }else{
1985e3365e6cSdrh       /* In this branch, the RHS of the IN might contain a NULL and
1986e3365e6cSdrh       ** the presence of a NULL on the RHS makes a difference in the
1987e3365e6cSdrh       ** outcome.
1988e3365e6cSdrh       */
1989552fd454Sdrh       int j1, j2;
1990e3365e6cSdrh 
1991e3365e6cSdrh       /* First check to see if the LHS is contained in the RHS.  If so,
1992e3365e6cSdrh       ** then the presence of NULLs in the RHS does not matter, so jump
1993e3365e6cSdrh       ** over all of the code that follows.
1994e3365e6cSdrh       */
19958cff69dfSdrh       j1 = sqlite3VdbeAddOp4Int(v, OP_Found, pExpr->iTable, 0, r1, 1);
1996688852abSdrh       VdbeCoverage(v);
1997e3365e6cSdrh 
1998e3365e6cSdrh       /* Here we begin generating code that runs if the LHS is not
1999e3365e6cSdrh       ** contained within the RHS.  Generate additional code that
2000e3365e6cSdrh       ** tests the RHS for NULLs.  If the RHS contains a NULL then
2001e3365e6cSdrh       ** jump to destIfNull.  If there are no NULLs in the RHS then
2002e3365e6cSdrh       ** jump to destIfFalse.
2003e3365e6cSdrh       */
2004688852abSdrh       sqlite3VdbeAddOp2(v, OP_If, rRhsHasNull, destIfNull); VdbeCoverage(v);
2005552fd454Sdrh       sqlite3VdbeAddOp2(v, OP_IfNot, rRhsHasNull, destIfFalse); VdbeCoverage(v);
2006552fd454Sdrh       j2 = sqlite3VdbeAddOp4Int(v, OP_Found, pExpr->iTable, 0, rRhsHasNull, 1);
2007552fd454Sdrh       VdbeCoverage(v);
2008552fd454Sdrh       sqlite3VdbeAddOp2(v, OP_Integer, 0, rRhsHasNull);
2009e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Goto, 0, destIfFalse);
2010552fd454Sdrh       sqlite3VdbeJumpHere(v, j2);
2011552fd454Sdrh       sqlite3VdbeAddOp2(v, OP_Integer, 1, rRhsHasNull);
2012552fd454Sdrh       sqlite3VdbeAddOp2(v, OP_Goto, 0, destIfNull);
2013e3365e6cSdrh 
2014e3365e6cSdrh       /* The OP_Found at the top of this branch jumps here when true,
2015e3365e6cSdrh       ** causing the overall IN expression evaluation to fall through.
2016e3365e6cSdrh       */
2017e3365e6cSdrh       sqlite3VdbeJumpHere(v, j1);
2018e3365e6cSdrh     }
2019e3365e6cSdrh   }
2020e3365e6cSdrh   sqlite3ReleaseTempReg(pParse, r1);
2021d2490904Sdrh   sqlite3ExprCachePop(pParse);
2022e3365e6cSdrh   VdbeComment((v, "end IN expr"));
2023e3365e6cSdrh }
2024e3365e6cSdrh #endif /* SQLITE_OMIT_SUBQUERY */
2025e3365e6cSdrh 
2026cce7d176Sdrh /*
2027598f1340Sdrh ** Duplicate an 8-byte value
2028598f1340Sdrh */
2029598f1340Sdrh static char *dup8bytes(Vdbe *v, const char *in){
2030598f1340Sdrh   char *out = sqlite3DbMallocRaw(sqlite3VdbeDb(v), 8);
2031598f1340Sdrh   if( out ){
2032598f1340Sdrh     memcpy(out, in, 8);
2033598f1340Sdrh   }
2034598f1340Sdrh   return out;
2035598f1340Sdrh }
2036598f1340Sdrh 
203713573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
2038598f1340Sdrh /*
2039598f1340Sdrh ** Generate an instruction that will put the floating point
20409cbf3425Sdrh ** value described by z[0..n-1] into register iMem.
20410cf19ed8Sdrh **
20420cf19ed8Sdrh ** The z[] string will probably not be zero-terminated.  But the
20430cf19ed8Sdrh ** z[n] character is guaranteed to be something that does not look
20440cf19ed8Sdrh ** like the continuation of the number.
2045598f1340Sdrh */
2046b7916a78Sdrh static void codeReal(Vdbe *v, const char *z, int negateFlag, int iMem){
2047fd773cf9Sdrh   if( ALWAYS(z!=0) ){
2048598f1340Sdrh     double value;
2049598f1340Sdrh     char *zV;
20509339da1fSdrh     sqlite3AtoF(z, &value, sqlite3Strlen30(z), SQLITE_UTF8);
2051d0015161Sdrh     assert( !sqlite3IsNaN(value) ); /* The new AtoF never returns NaN */
2052598f1340Sdrh     if( negateFlag ) value = -value;
2053598f1340Sdrh     zV = dup8bytes(v, (char*)&value);
20549de221dfSdrh     sqlite3VdbeAddOp4(v, OP_Real, 0, iMem, 0, zV, P4_REAL);
2055598f1340Sdrh   }
2056598f1340Sdrh }
205713573c71Sdrh #endif
2058598f1340Sdrh 
2059598f1340Sdrh 
2060598f1340Sdrh /*
2061fec19aadSdrh ** Generate an instruction that will put the integer describe by
20629cbf3425Sdrh ** text z[0..n-1] into register iMem.
20630cf19ed8Sdrh **
20645f1d6b61Sshaneh ** Expr.u.zToken is always UTF8 and zero-terminated.
2065fec19aadSdrh */
206613573c71Sdrh static void codeInteger(Parse *pParse, Expr *pExpr, int negFlag, int iMem){
206713573c71Sdrh   Vdbe *v = pParse->pVdbe;
206892b01d53Sdrh   if( pExpr->flags & EP_IntValue ){
206933e619fcSdrh     int i = pExpr->u.iValue;
2070d50ffc41Sdrh     assert( i>=0 );
207192b01d53Sdrh     if( negFlag ) i = -i;
207292b01d53Sdrh     sqlite3VdbeAddOp2(v, OP_Integer, i, iMem);
2073fd773cf9Sdrh   }else{
20745f1d6b61Sshaneh     int c;
20755f1d6b61Sshaneh     i64 value;
2076fd773cf9Sdrh     const char *z = pExpr->u.zToken;
2077fd773cf9Sdrh     assert( z!=0 );
20785f1d6b61Sshaneh     c = sqlite3Atoi64(z, &value, sqlite3Strlen30(z), SQLITE_UTF8);
20795f1d6b61Sshaneh     if( c==0 || (c==2 && negFlag) ){
2080598f1340Sdrh       char *zV;
2081158b9cb9Sdrh       if( negFlag ){ value = c==2 ? SMALLEST_INT64 : -value; }
2082598f1340Sdrh       zV = dup8bytes(v, (char*)&value);
20839de221dfSdrh       sqlite3VdbeAddOp4(v, OP_Int64, 0, iMem, 0, zV, P4_INT64);
2084fec19aadSdrh     }else{
208513573c71Sdrh #ifdef SQLITE_OMIT_FLOATING_POINT
208613573c71Sdrh       sqlite3ErrorMsg(pParse, "oversized integer: %s%s", negFlag ? "-" : "", z);
208713573c71Sdrh #else
2088b7916a78Sdrh       codeReal(v, z, negFlag, iMem);
208913573c71Sdrh #endif
2090fec19aadSdrh     }
2091fec19aadSdrh   }
2092c9cf901dSdanielk1977 }
2093fec19aadSdrh 
2094ceea3321Sdrh /*
2095ceea3321Sdrh ** Clear a cache entry.
2096ceea3321Sdrh */
2097ceea3321Sdrh static void cacheEntryClear(Parse *pParse, struct yColCache *p){
2098ceea3321Sdrh   if( p->tempReg ){
2099ceea3321Sdrh     if( pParse->nTempReg<ArraySize(pParse->aTempReg) ){
2100ceea3321Sdrh       pParse->aTempReg[pParse->nTempReg++] = p->iReg;
2101ceea3321Sdrh     }
2102ceea3321Sdrh     p->tempReg = 0;
2103ceea3321Sdrh   }
2104ceea3321Sdrh }
2105ceea3321Sdrh 
2106ceea3321Sdrh 
2107ceea3321Sdrh /*
2108ceea3321Sdrh ** Record in the column cache that a particular column from a
2109ceea3321Sdrh ** particular table is stored in a particular register.
2110ceea3321Sdrh */
2111ceea3321Sdrh void sqlite3ExprCacheStore(Parse *pParse, int iTab, int iCol, int iReg){
2112ceea3321Sdrh   int i;
2113ceea3321Sdrh   int minLru;
2114ceea3321Sdrh   int idxLru;
2115ceea3321Sdrh   struct yColCache *p;
2116ceea3321Sdrh 
211720411ea7Sdrh   assert( iReg>0 );  /* Register numbers are always positive */
211820411ea7Sdrh   assert( iCol>=-1 && iCol<32768 );  /* Finite column numbers */
211920411ea7Sdrh 
2120b6da74ebSdrh   /* The SQLITE_ColumnCache flag disables the column cache.  This is used
2121b6da74ebSdrh   ** for testing only - to verify that SQLite always gets the same answer
2122b6da74ebSdrh   ** with and without the column cache.
2123b6da74ebSdrh   */
21247e5418e4Sdrh   if( OptimizationDisabled(pParse->db, SQLITE_ColumnCache) ) return;
2125b6da74ebSdrh 
212627ee406eSdrh   /* First replace any existing entry.
212727ee406eSdrh   **
212827ee406eSdrh   ** Actually, the way the column cache is currently used, we are guaranteed
212927ee406eSdrh   ** that the object will never already be in cache.  Verify this guarantee.
213027ee406eSdrh   */
213127ee406eSdrh #ifndef NDEBUG
2132ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
213327ee406eSdrh     assert( p->iReg==0 || p->iTable!=iTab || p->iColumn!=iCol );
2134ceea3321Sdrh   }
213527ee406eSdrh #endif
2136ceea3321Sdrh 
2137ceea3321Sdrh   /* Find an empty slot and replace it */
2138ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2139ceea3321Sdrh     if( p->iReg==0 ){
2140ceea3321Sdrh       p->iLevel = pParse->iCacheLevel;
2141ceea3321Sdrh       p->iTable = iTab;
2142ceea3321Sdrh       p->iColumn = iCol;
2143ceea3321Sdrh       p->iReg = iReg;
2144ceea3321Sdrh       p->tempReg = 0;
2145ceea3321Sdrh       p->lru = pParse->iCacheCnt++;
2146ceea3321Sdrh       return;
2147ceea3321Sdrh     }
2148ceea3321Sdrh   }
2149ceea3321Sdrh 
2150ceea3321Sdrh   /* Replace the last recently used */
2151ceea3321Sdrh   minLru = 0x7fffffff;
2152ceea3321Sdrh   idxLru = -1;
2153ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2154ceea3321Sdrh     if( p->lru<minLru ){
2155ceea3321Sdrh       idxLru = i;
2156ceea3321Sdrh       minLru = p->lru;
2157ceea3321Sdrh     }
2158ceea3321Sdrh   }
215920411ea7Sdrh   if( ALWAYS(idxLru>=0) ){
2160ceea3321Sdrh     p = &pParse->aColCache[idxLru];
2161ceea3321Sdrh     p->iLevel = pParse->iCacheLevel;
2162ceea3321Sdrh     p->iTable = iTab;
2163ceea3321Sdrh     p->iColumn = iCol;
2164ceea3321Sdrh     p->iReg = iReg;
2165ceea3321Sdrh     p->tempReg = 0;
2166ceea3321Sdrh     p->lru = pParse->iCacheCnt++;
2167ceea3321Sdrh     return;
2168ceea3321Sdrh   }
2169ceea3321Sdrh }
2170ceea3321Sdrh 
2171ceea3321Sdrh /*
2172f49f3523Sdrh ** Indicate that registers between iReg..iReg+nReg-1 are being overwritten.
2173f49f3523Sdrh ** Purge the range of registers from the column cache.
2174ceea3321Sdrh */
2175f49f3523Sdrh void sqlite3ExprCacheRemove(Parse *pParse, int iReg, int nReg){
2176ceea3321Sdrh   int i;
2177f49f3523Sdrh   int iLast = iReg + nReg - 1;
2178ceea3321Sdrh   struct yColCache *p;
2179ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2180f49f3523Sdrh     int r = p->iReg;
2181f49f3523Sdrh     if( r>=iReg && r<=iLast ){
2182ceea3321Sdrh       cacheEntryClear(pParse, p);
2183ceea3321Sdrh       p->iReg = 0;
2184ceea3321Sdrh     }
2185ceea3321Sdrh   }
2186ceea3321Sdrh }
2187ceea3321Sdrh 
2188ceea3321Sdrh /*
2189ceea3321Sdrh ** Remember the current column cache context.  Any new entries added
2190ceea3321Sdrh ** added to the column cache after this call are removed when the
2191ceea3321Sdrh ** corresponding pop occurs.
2192ceea3321Sdrh */
2193ceea3321Sdrh void sqlite3ExprCachePush(Parse *pParse){
2194ceea3321Sdrh   pParse->iCacheLevel++;
21959ac7962aSdrh #ifdef SQLITE_DEBUG
21969ac7962aSdrh   if( pParse->db->flags & SQLITE_VdbeAddopTrace ){
21979ac7962aSdrh     printf("PUSH to %d\n", pParse->iCacheLevel);
21989ac7962aSdrh   }
21999ac7962aSdrh #endif
2200ceea3321Sdrh }
2201ceea3321Sdrh 
2202ceea3321Sdrh /*
2203ceea3321Sdrh ** Remove from the column cache any entries that were added since the
2204d2490904Sdrh ** the previous sqlite3ExprCachePush operation.  In other words, restore
2205d2490904Sdrh ** the cache to the state it was in prior the most recent Push.
2206ceea3321Sdrh */
2207d2490904Sdrh void sqlite3ExprCachePop(Parse *pParse){
2208ceea3321Sdrh   int i;
2209ceea3321Sdrh   struct yColCache *p;
2210d2490904Sdrh   assert( pParse->iCacheLevel>=1 );
2211d2490904Sdrh   pParse->iCacheLevel--;
22129ac7962aSdrh #ifdef SQLITE_DEBUG
22139ac7962aSdrh   if( pParse->db->flags & SQLITE_VdbeAddopTrace ){
22149ac7962aSdrh     printf("POP  to %d\n", pParse->iCacheLevel);
22159ac7962aSdrh   }
22169ac7962aSdrh #endif
2217ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2218ceea3321Sdrh     if( p->iReg && p->iLevel>pParse->iCacheLevel ){
2219ceea3321Sdrh       cacheEntryClear(pParse, p);
2220ceea3321Sdrh       p->iReg = 0;
2221ceea3321Sdrh     }
2222ceea3321Sdrh   }
2223ceea3321Sdrh }
2224945498f3Sdrh 
2225945498f3Sdrh /*
22265cd79239Sdrh ** When a cached column is reused, make sure that its register is
22275cd79239Sdrh ** no longer available as a temp register.  ticket #3879:  that same
22285cd79239Sdrh ** register might be in the cache in multiple places, so be sure to
22295cd79239Sdrh ** get them all.
22305cd79239Sdrh */
22315cd79239Sdrh static void sqlite3ExprCachePinRegister(Parse *pParse, int iReg){
22325cd79239Sdrh   int i;
22335cd79239Sdrh   struct yColCache *p;
22345cd79239Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
22355cd79239Sdrh     if( p->iReg==iReg ){
22365cd79239Sdrh       p->tempReg = 0;
22375cd79239Sdrh     }
22385cd79239Sdrh   }
22395cd79239Sdrh }
22405cd79239Sdrh 
22415cd79239Sdrh /*
22425c092e8aSdrh ** Generate code to extract the value of the iCol-th column of a table.
22435c092e8aSdrh */
22445c092e8aSdrh void sqlite3ExprCodeGetColumnOfTable(
22455c092e8aSdrh   Vdbe *v,        /* The VDBE under construction */
22465c092e8aSdrh   Table *pTab,    /* The table containing the value */
2247313619f5Sdrh   int iTabCur,    /* The table cursor.  Or the PK cursor for WITHOUT ROWID */
22485c092e8aSdrh   int iCol,       /* Index of the column to extract */
2249313619f5Sdrh   int regOut      /* Extract the value into this register */
22505c092e8aSdrh ){
22515c092e8aSdrh   if( iCol<0 || iCol==pTab->iPKey ){
22525c092e8aSdrh     sqlite3VdbeAddOp2(v, OP_Rowid, iTabCur, regOut);
22535c092e8aSdrh   }else{
22545c092e8aSdrh     int op = IsVirtual(pTab) ? OP_VColumn : OP_Column;
2255ee0ec8e1Sdrh     int x = iCol;
2256ee0ec8e1Sdrh     if( !HasRowid(pTab) ){
2257ee0ec8e1Sdrh       x = sqlite3ColumnOfIndex(sqlite3PrimaryKeyIndex(pTab), iCol);
2258ee0ec8e1Sdrh     }
2259ee0ec8e1Sdrh     sqlite3VdbeAddOp3(v, op, iTabCur, x, regOut);
22605c092e8aSdrh   }
22615c092e8aSdrh   if( iCol>=0 ){
22625c092e8aSdrh     sqlite3ColumnDefault(v, pTab, iCol, regOut);
22635c092e8aSdrh   }
22645c092e8aSdrh }
22655c092e8aSdrh 
22665c092e8aSdrh /*
2267945498f3Sdrh ** Generate code that will extract the iColumn-th column from
2268e55cbd72Sdrh ** table pTab and store the column value in a register.  An effort
2269e55cbd72Sdrh ** is made to store the column value in register iReg, but this is
2270e55cbd72Sdrh ** not guaranteed.  The location of the column value is returned.
2271e55cbd72Sdrh **
2272e55cbd72Sdrh ** There must be an open cursor to pTab in iTable when this routine
2273e55cbd72Sdrh ** is called.  If iColumn<0 then code is generated that extracts the rowid.
2274945498f3Sdrh */
2275e55cbd72Sdrh int sqlite3ExprCodeGetColumn(
2276e55cbd72Sdrh   Parse *pParse,   /* Parsing and code generating context */
22772133d822Sdrh   Table *pTab,     /* Description of the table we are reading from */
22782133d822Sdrh   int iColumn,     /* Index of the table column */
22792133d822Sdrh   int iTable,      /* The cursor pointing to the table */
2280a748fdccSdrh   int iReg,        /* Store results here */
2281a748fdccSdrh   u8 p5            /* P5 value for OP_Column */
22822133d822Sdrh ){
2283e55cbd72Sdrh   Vdbe *v = pParse->pVdbe;
2284e55cbd72Sdrh   int i;
2285da250ea5Sdrh   struct yColCache *p;
2286e55cbd72Sdrh 
2287ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2288b6da74ebSdrh     if( p->iReg>0 && p->iTable==iTable && p->iColumn==iColumn ){
2289ceea3321Sdrh       p->lru = pParse->iCacheCnt++;
22905cd79239Sdrh       sqlite3ExprCachePinRegister(pParse, p->iReg);
2291da250ea5Sdrh       return p->iReg;
2292e55cbd72Sdrh     }
2293e55cbd72Sdrh   }
2294e55cbd72Sdrh   assert( v!=0 );
22955c092e8aSdrh   sqlite3ExprCodeGetColumnOfTable(v, pTab, iTable, iColumn, iReg);
2296a748fdccSdrh   if( p5 ){
2297a748fdccSdrh     sqlite3VdbeChangeP5(v, p5);
2298a748fdccSdrh   }else{
2299ceea3321Sdrh     sqlite3ExprCacheStore(pParse, iTable, iColumn, iReg);
2300a748fdccSdrh   }
2301e55cbd72Sdrh   return iReg;
2302e55cbd72Sdrh }
2303e55cbd72Sdrh 
2304e55cbd72Sdrh /*
2305ceea3321Sdrh ** Clear all column cache entries.
2306e55cbd72Sdrh */
2307ceea3321Sdrh void sqlite3ExprCacheClear(Parse *pParse){
2308e55cbd72Sdrh   int i;
2309ceea3321Sdrh   struct yColCache *p;
2310ceea3321Sdrh 
23119ac7962aSdrh #if SQLITE_DEBUG
23129ac7962aSdrh   if( pParse->db->flags & SQLITE_VdbeAddopTrace ){
23139ac7962aSdrh     printf("CLEAR\n");
23149ac7962aSdrh   }
23159ac7962aSdrh #endif
2316ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2317ceea3321Sdrh     if( p->iReg ){
2318ceea3321Sdrh       cacheEntryClear(pParse, p);
2319ceea3321Sdrh       p->iReg = 0;
2320e55cbd72Sdrh     }
2321da250ea5Sdrh   }
2322da250ea5Sdrh }
2323e55cbd72Sdrh 
2324e55cbd72Sdrh /*
2325da250ea5Sdrh ** Record the fact that an affinity change has occurred on iCount
2326da250ea5Sdrh ** registers starting with iStart.
2327e55cbd72Sdrh */
2328da250ea5Sdrh void sqlite3ExprCacheAffinityChange(Parse *pParse, int iStart, int iCount){
2329f49f3523Sdrh   sqlite3ExprCacheRemove(pParse, iStart, iCount);
2330e55cbd72Sdrh }
2331e55cbd72Sdrh 
2332e55cbd72Sdrh /*
2333b21e7c70Sdrh ** Generate code to move content from registers iFrom...iFrom+nReg-1
2334b21e7c70Sdrh ** over to iTo..iTo+nReg-1. Keep the column cache up-to-date.
2335e55cbd72Sdrh */
2336b21e7c70Sdrh void sqlite3ExprCodeMove(Parse *pParse, int iFrom, int iTo, int nReg){
2337e55cbd72Sdrh   int i;
2338ceea3321Sdrh   struct yColCache *p;
2339e8e4af76Sdrh   assert( iFrom>=iTo+nReg || iFrom+nReg<=iTo );
2340079a3072Sdrh   sqlite3VdbeAddOp3(pParse->pVdbe, OP_Move, iFrom, iTo, nReg);
2341ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2342ceea3321Sdrh     int x = p->iReg;
2343b21e7c70Sdrh     if( x>=iFrom && x<iFrom+nReg ){
2344ceea3321Sdrh       p->iReg += iTo-iFrom;
2345e55cbd72Sdrh     }
2346e55cbd72Sdrh   }
2347945498f3Sdrh }
2348945498f3Sdrh 
2349f49f3523Sdrh #if defined(SQLITE_DEBUG) || defined(SQLITE_COVERAGE_TEST)
235092b01d53Sdrh /*
2351652fbf55Sdrh ** Return true if any register in the range iFrom..iTo (inclusive)
2352652fbf55Sdrh ** is used as part of the column cache.
2353f49f3523Sdrh **
2354f49f3523Sdrh ** This routine is used within assert() and testcase() macros only
2355f49f3523Sdrh ** and does not appear in a normal build.
2356652fbf55Sdrh */
2357652fbf55Sdrh static int usedAsColumnCache(Parse *pParse, int iFrom, int iTo){
2358652fbf55Sdrh   int i;
2359ceea3321Sdrh   struct yColCache *p;
2360ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2361ceea3321Sdrh     int r = p->iReg;
2362f49f3523Sdrh     if( r>=iFrom && r<=iTo ) return 1;    /*NO_TEST*/
2363652fbf55Sdrh   }
2364652fbf55Sdrh   return 0;
2365652fbf55Sdrh }
2366f49f3523Sdrh #endif /* SQLITE_DEBUG || SQLITE_COVERAGE_TEST */
2367652fbf55Sdrh 
2368652fbf55Sdrh /*
2369a4c3c87eSdrh ** Convert an expression node to a TK_REGISTER
2370a4c3c87eSdrh */
2371a4c3c87eSdrh static void exprToRegister(Expr *p, int iReg){
2372a4c3c87eSdrh   p->op2 = p->op;
2373a4c3c87eSdrh   p->op = TK_REGISTER;
2374a4c3c87eSdrh   p->iTable = iReg;
2375a4c3c87eSdrh   ExprClearProperty(p, EP_Skip);
2376a4c3c87eSdrh }
2377a4c3c87eSdrh 
2378a4c3c87eSdrh /*
2379cce7d176Sdrh ** Generate code into the current Vdbe to evaluate the given
23802dcef11bSdrh ** expression.  Attempt to store the results in register "target".
23812dcef11bSdrh ** Return the register where results are stored.
2382389a1adbSdrh **
23838b213899Sdrh ** With this routine, there is no guarantee that results will
23842dcef11bSdrh ** be stored in target.  The result might be stored in some other
23852dcef11bSdrh ** register if it is convenient to do so.  The calling function
23862dcef11bSdrh ** must check the return code and move the results to the desired
23872dcef11bSdrh ** register.
2388cce7d176Sdrh */
2389678ccce8Sdrh int sqlite3ExprCodeTarget(Parse *pParse, Expr *pExpr, int target){
23902dcef11bSdrh   Vdbe *v = pParse->pVdbe;  /* The VM under construction */
23912dcef11bSdrh   int op;                   /* The opcode being coded */
23922dcef11bSdrh   int inReg = target;       /* Results stored in register inReg */
23932dcef11bSdrh   int regFree1 = 0;         /* If non-zero free this temporary register */
23942dcef11bSdrh   int regFree2 = 0;         /* If non-zero free this temporary register */
2395678ccce8Sdrh   int r1, r2, r3, r4;       /* Various register numbers */
239620411ea7Sdrh   sqlite3 *db = pParse->db; /* The database connection */
239710d1edf0Sdrh   Expr tempX;               /* Temporary expression node */
2398ffe07b2dSdrh 
23999cbf3425Sdrh   assert( target>0 && target<=pParse->nMem );
240020411ea7Sdrh   if( v==0 ){
240120411ea7Sdrh     assert( pParse->db->mallocFailed );
240220411ea7Sdrh     return 0;
240320411ea7Sdrh   }
2404389a1adbSdrh 
2405389a1adbSdrh   if( pExpr==0 ){
2406389a1adbSdrh     op = TK_NULL;
2407389a1adbSdrh   }else{
2408f2bc013cSdrh     op = pExpr->op;
2409389a1adbSdrh   }
2410f2bc013cSdrh   switch( op ){
241113449892Sdrh     case TK_AGG_COLUMN: {
241213449892Sdrh       AggInfo *pAggInfo = pExpr->pAggInfo;
241313449892Sdrh       struct AggInfo_col *pCol = &pAggInfo->aCol[pExpr->iAgg];
241413449892Sdrh       if( !pAggInfo->directMode ){
24159de221dfSdrh         assert( pCol->iMem>0 );
24169de221dfSdrh         inReg = pCol->iMem;
241713449892Sdrh         break;
241813449892Sdrh       }else if( pAggInfo->useSortingIdx ){
24195134d135Sdan         sqlite3VdbeAddOp3(v, OP_Column, pAggInfo->sortingIdxPTab,
2420389a1adbSdrh                               pCol->iSorterColumn, target);
242113449892Sdrh         break;
242213449892Sdrh       }
242313449892Sdrh       /* Otherwise, fall thru into the TK_COLUMN case */
242413449892Sdrh     }
2425967e8b73Sdrh     case TK_COLUMN: {
2426b2b9d3d7Sdrh       int iTab = pExpr->iTable;
2427b2b9d3d7Sdrh       if( iTab<0 ){
2428b2b9d3d7Sdrh         if( pParse->ckBase>0 ){
2429b2b9d3d7Sdrh           /* Generating CHECK constraints or inserting into partial index */
2430aa9b8963Sdrh           inReg = pExpr->iColumn + pParse->ckBase;
2431b2b9d3d7Sdrh           break;
2432c4a3c779Sdrh         }else{
2433b2b9d3d7Sdrh           /* Deleting from a partial index */
2434b2b9d3d7Sdrh           iTab = pParse->iPartIdxTab;
24352282792aSdrh         }
2436b2b9d3d7Sdrh       }
2437b2b9d3d7Sdrh       inReg = sqlite3ExprCodeGetColumn(pParse, pExpr->pTab,
2438b2b9d3d7Sdrh                                pExpr->iColumn, iTab, target,
2439b2b9d3d7Sdrh                                pExpr->op2);
2440cce7d176Sdrh       break;
2441cce7d176Sdrh     }
2442cce7d176Sdrh     case TK_INTEGER: {
244313573c71Sdrh       codeInteger(pParse, pExpr, 0, target);
2444fec19aadSdrh       break;
244551e9a445Sdrh     }
244613573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
2447598f1340Sdrh     case TK_FLOAT: {
244833e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
244933e619fcSdrh       codeReal(v, pExpr->u.zToken, 0, target);
2450598f1340Sdrh       break;
2451598f1340Sdrh     }
245213573c71Sdrh #endif
2453fec19aadSdrh     case TK_STRING: {
245433e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
245533e619fcSdrh       sqlite3VdbeAddOp4(v, OP_String8, 0, target, 0, pExpr->u.zToken, 0);
2456cce7d176Sdrh       break;
2457cce7d176Sdrh     }
2458f0863fe5Sdrh     case TK_NULL: {
24599de221dfSdrh       sqlite3VdbeAddOp2(v, OP_Null, 0, target);
2460f0863fe5Sdrh       break;
2461f0863fe5Sdrh     }
24625338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_BLOB_LITERAL
2463c572ef7fSdanielk1977     case TK_BLOB: {
24646c8c6cecSdrh       int n;
24656c8c6cecSdrh       const char *z;
2466ca48c90fSdrh       char *zBlob;
246733e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
246833e619fcSdrh       assert( pExpr->u.zToken[0]=='x' || pExpr->u.zToken[0]=='X' );
246933e619fcSdrh       assert( pExpr->u.zToken[1]=='\'' );
247033e619fcSdrh       z = &pExpr->u.zToken[2];
2471b7916a78Sdrh       n = sqlite3Strlen30(z) - 1;
2472b7916a78Sdrh       assert( z[n]=='\'' );
2473ca48c90fSdrh       zBlob = sqlite3HexToBlob(sqlite3VdbeDb(v), z, n);
2474ca48c90fSdrh       sqlite3VdbeAddOp4(v, OP_Blob, n/2, target, 0, zBlob, P4_DYNAMIC);
2475c572ef7fSdanielk1977       break;
2476c572ef7fSdanielk1977     }
24775338a5f7Sdanielk1977 #endif
247850457896Sdrh     case TK_VARIABLE: {
247933e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
248033e619fcSdrh       assert( pExpr->u.zToken!=0 );
248133e619fcSdrh       assert( pExpr->u.zToken[0]!=0 );
2482eaf52d88Sdrh       sqlite3VdbeAddOp2(v, OP_Variable, pExpr->iColumn, target);
248333e619fcSdrh       if( pExpr->u.zToken[1]!=0 ){
248404e9eeadSdrh         assert( pExpr->u.zToken[0]=='?'
248504e9eeadSdrh              || strcmp(pExpr->u.zToken, pParse->azVar[pExpr->iColumn-1])==0 );
248604e9eeadSdrh         sqlite3VdbeChangeP4(v, -1, pParse->azVar[pExpr->iColumn-1], P4_STATIC);
2487895d7472Sdrh       }
248850457896Sdrh       break;
248950457896Sdrh     }
24904e0cff60Sdrh     case TK_REGISTER: {
24919de221dfSdrh       inReg = pExpr->iTable;
24924e0cff60Sdrh       break;
24934e0cff60Sdrh     }
24948b213899Sdrh     case TK_AS: {
24957445ffe2Sdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
24968b213899Sdrh       break;
24978b213899Sdrh     }
2498487e262fSdrh #ifndef SQLITE_OMIT_CAST
2499487e262fSdrh     case TK_CAST: {
2500487e262fSdrh       /* Expressions of the form:   CAST(pLeft AS token) */
2501f0113000Sdanielk1977       int aff, to_op;
25022dcef11bSdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
250333e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
2504fdaac671Sdrh       aff = sqlite3AffinityType(pExpr->u.zToken, 0);
2505f0113000Sdanielk1977       to_op = aff - SQLITE_AFF_TEXT + OP_ToText;
2506f0113000Sdanielk1977       assert( to_op==OP_ToText    || aff!=SQLITE_AFF_TEXT    );
2507f0113000Sdanielk1977       assert( to_op==OP_ToBlob    || aff!=SQLITE_AFF_NONE    );
2508f0113000Sdanielk1977       assert( to_op==OP_ToNumeric || aff!=SQLITE_AFF_NUMERIC );
2509f0113000Sdanielk1977       assert( to_op==OP_ToInt     || aff!=SQLITE_AFF_INTEGER );
2510f0113000Sdanielk1977       assert( to_op==OP_ToReal    || aff!=SQLITE_AFF_REAL    );
2511c5499befSdrh       testcase( to_op==OP_ToText );
2512c5499befSdrh       testcase( to_op==OP_ToBlob );
2513c5499befSdrh       testcase( to_op==OP_ToNumeric );
2514c5499befSdrh       testcase( to_op==OP_ToInt );
2515c5499befSdrh       testcase( to_op==OP_ToReal );
25161735fa88Sdrh       if( inReg!=target ){
25171735fa88Sdrh         sqlite3VdbeAddOp2(v, OP_SCopy, inReg, target);
25181735fa88Sdrh         inReg = target;
25191735fa88Sdrh       }
25202dcef11bSdrh       sqlite3VdbeAddOp1(v, to_op, inReg);
2521c5499befSdrh       testcase( usedAsColumnCache(pParse, inReg, inReg) );
2522b3843a82Sdrh       sqlite3ExprCacheAffinityChange(pParse, inReg, 1);
2523487e262fSdrh       break;
2524487e262fSdrh     }
2525487e262fSdrh #endif /* SQLITE_OMIT_CAST */
2526c9b84a1fSdrh     case TK_LT:
2527c9b84a1fSdrh     case TK_LE:
2528c9b84a1fSdrh     case TK_GT:
2529c9b84a1fSdrh     case TK_GE:
2530c9b84a1fSdrh     case TK_NE:
2531c9b84a1fSdrh     case TK_EQ: {
2532b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2533b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
253435573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
25357d176105Sdrh                   r1, r2, inReg, SQLITE_STOREP2);
25367d176105Sdrh       assert(TK_LT==OP_Lt); testcase(op==OP_Lt); VdbeCoverageIf(v,op==OP_Lt);
25377d176105Sdrh       assert(TK_LE==OP_Le); testcase(op==OP_Le); VdbeCoverageIf(v,op==OP_Le);
25387d176105Sdrh       assert(TK_GT==OP_Gt); testcase(op==OP_Gt); VdbeCoverageIf(v,op==OP_Gt);
25397d176105Sdrh       assert(TK_GE==OP_Ge); testcase(op==OP_Ge); VdbeCoverageIf(v,op==OP_Ge);
25407d176105Sdrh       assert(TK_EQ==OP_Eq); testcase(op==OP_Eq); VdbeCoverageIf(v,op==OP_Eq);
25417d176105Sdrh       assert(TK_NE==OP_Ne); testcase(op==OP_Ne); VdbeCoverageIf(v,op==OP_Ne);
2542c5499befSdrh       testcase( regFree1==0 );
2543c5499befSdrh       testcase( regFree2==0 );
2544a37cdde0Sdanielk1977       break;
2545c9b84a1fSdrh     }
25466a2fe093Sdrh     case TK_IS:
25476a2fe093Sdrh     case TK_ISNOT: {
25486a2fe093Sdrh       testcase( op==TK_IS );
25496a2fe093Sdrh       testcase( op==TK_ISNOT );
2550b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2551b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
25526a2fe093Sdrh       op = (op==TK_IS) ? TK_EQ : TK_NE;
25536a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
25546a2fe093Sdrh                   r1, r2, inReg, SQLITE_STOREP2 | SQLITE_NULLEQ);
25557d176105Sdrh       VdbeCoverageIf(v, op==TK_EQ);
25567d176105Sdrh       VdbeCoverageIf(v, op==TK_NE);
25576a2fe093Sdrh       testcase( regFree1==0 );
25586a2fe093Sdrh       testcase( regFree2==0 );
25596a2fe093Sdrh       break;
25606a2fe093Sdrh     }
2561cce7d176Sdrh     case TK_AND:
2562cce7d176Sdrh     case TK_OR:
2563cce7d176Sdrh     case TK_PLUS:
2564cce7d176Sdrh     case TK_STAR:
2565cce7d176Sdrh     case TK_MINUS:
2566bf4133cbSdrh     case TK_REM:
2567bf4133cbSdrh     case TK_BITAND:
2568bf4133cbSdrh     case TK_BITOR:
256917c40294Sdrh     case TK_SLASH:
2570bf4133cbSdrh     case TK_LSHIFT:
2571855eb1cfSdrh     case TK_RSHIFT:
25720040077dSdrh     case TK_CONCAT: {
25737d176105Sdrh       assert( TK_AND==OP_And );            testcase( op==TK_AND );
25747d176105Sdrh       assert( TK_OR==OP_Or );              testcase( op==TK_OR );
25757d176105Sdrh       assert( TK_PLUS==OP_Add );           testcase( op==TK_PLUS );
25767d176105Sdrh       assert( TK_MINUS==OP_Subtract );     testcase( op==TK_MINUS );
25777d176105Sdrh       assert( TK_REM==OP_Remainder );      testcase( op==TK_REM );
25787d176105Sdrh       assert( TK_BITAND==OP_BitAnd );      testcase( op==TK_BITAND );
25797d176105Sdrh       assert( TK_BITOR==OP_BitOr );        testcase( op==TK_BITOR );
25807d176105Sdrh       assert( TK_SLASH==OP_Divide );       testcase( op==TK_SLASH );
25817d176105Sdrh       assert( TK_LSHIFT==OP_ShiftLeft );   testcase( op==TK_LSHIFT );
25827d176105Sdrh       assert( TK_RSHIFT==OP_ShiftRight );  testcase( op==TK_RSHIFT );
25837d176105Sdrh       assert( TK_CONCAT==OP_Concat );      testcase( op==TK_CONCAT );
25842dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
25852dcef11bSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
25865b6afba9Sdrh       sqlite3VdbeAddOp3(v, op, r2, r1, target);
2587c5499befSdrh       testcase( regFree1==0 );
2588c5499befSdrh       testcase( regFree2==0 );
25890040077dSdrh       break;
25900040077dSdrh     }
2591cce7d176Sdrh     case TK_UMINUS: {
2592fec19aadSdrh       Expr *pLeft = pExpr->pLeft;
2593fec19aadSdrh       assert( pLeft );
259413573c71Sdrh       if( pLeft->op==TK_INTEGER ){
259513573c71Sdrh         codeInteger(pParse, pLeft, 1, target);
259613573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
259713573c71Sdrh       }else if( pLeft->op==TK_FLOAT ){
259833e619fcSdrh         assert( !ExprHasProperty(pExpr, EP_IntValue) );
259933e619fcSdrh         codeReal(v, pLeft->u.zToken, 1, target);
260013573c71Sdrh #endif
26013c84ddffSdrh       }else{
260210d1edf0Sdrh         tempX.op = TK_INTEGER;
260310d1edf0Sdrh         tempX.flags = EP_IntValue|EP_TokenOnly;
260410d1edf0Sdrh         tempX.u.iValue = 0;
260510d1edf0Sdrh         r1 = sqlite3ExprCodeTemp(pParse, &tempX, &regFree1);
2606e55cbd72Sdrh         r2 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree2);
26072dcef11bSdrh         sqlite3VdbeAddOp3(v, OP_Subtract, r2, r1, target);
2608c5499befSdrh         testcase( regFree2==0 );
26093c84ddffSdrh       }
26109de221dfSdrh       inReg = target;
26116e142f54Sdrh       break;
26126e142f54Sdrh     }
2613bf4133cbSdrh     case TK_BITNOT:
26146e142f54Sdrh     case TK_NOT: {
26157d176105Sdrh       assert( TK_BITNOT==OP_BitNot );   testcase( op==TK_BITNOT );
26167d176105Sdrh       assert( TK_NOT==OP_Not );         testcase( op==TK_NOT );
2617e99fa2afSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2618e99fa2afSdrh       testcase( regFree1==0 );
2619e99fa2afSdrh       inReg = target;
2620e99fa2afSdrh       sqlite3VdbeAddOp2(v, op, r1, inReg);
2621cce7d176Sdrh       break;
2622cce7d176Sdrh     }
2623cce7d176Sdrh     case TK_ISNULL:
2624cce7d176Sdrh     case TK_NOTNULL: {
26256a288a33Sdrh       int addr;
26267d176105Sdrh       assert( TK_ISNULL==OP_IsNull );   testcase( op==TK_ISNULL );
26277d176105Sdrh       assert( TK_NOTNULL==OP_NotNull ); testcase( op==TK_NOTNULL );
26289de221dfSdrh       sqlite3VdbeAddOp2(v, OP_Integer, 1, target);
26292dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2630c5499befSdrh       testcase( regFree1==0 );
26317d176105Sdrh       addr = sqlite3VdbeAddOp1(v, op, r1);
26327d176105Sdrh       VdbeCoverageIf(v, op==TK_ISNULL);
26337d176105Sdrh       VdbeCoverageIf(v, op==TK_NOTNULL);
26349de221dfSdrh       sqlite3VdbeAddOp2(v, OP_AddImm, target, -1);
26356a288a33Sdrh       sqlite3VdbeJumpHere(v, addr);
2636a37cdde0Sdanielk1977       break;
2637f2bc013cSdrh     }
26382282792aSdrh     case TK_AGG_FUNCTION: {
263913449892Sdrh       AggInfo *pInfo = pExpr->pAggInfo;
26407e56e711Sdrh       if( pInfo==0 ){
264133e619fcSdrh         assert( !ExprHasProperty(pExpr, EP_IntValue) );
264233e619fcSdrh         sqlite3ErrorMsg(pParse, "misuse of aggregate: %s()", pExpr->u.zToken);
26437e56e711Sdrh       }else{
26449de221dfSdrh         inReg = pInfo->aFunc[pExpr->iAgg].iMem;
26457e56e711Sdrh       }
26462282792aSdrh       break;
26472282792aSdrh     }
2648cce7d176Sdrh     case TK_FUNCTION: {
264912ffee8cSdrh       ExprList *pFarg;       /* List of function arguments */
265012ffee8cSdrh       int nFarg;             /* Number of function arguments */
265112ffee8cSdrh       FuncDef *pDef;         /* The function definition object */
265212ffee8cSdrh       int nId;               /* Length of the function name in bytes */
265312ffee8cSdrh       const char *zId;       /* The function name */
2654693e6719Sdrh       u32 constMask = 0;     /* Mask of function arguments that are constant */
265512ffee8cSdrh       int i;                 /* Loop counter */
265612ffee8cSdrh       u8 enc = ENC(db);      /* The text encoding used by this database */
265712ffee8cSdrh       CollSeq *pColl = 0;    /* A collating sequence */
265817435752Sdrh 
26596ab3a2ecSdanielk1977       assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
2660c5cd1249Sdrh       if( ExprHasProperty(pExpr, EP_TokenOnly) ){
266112ffee8cSdrh         pFarg = 0;
266212ffee8cSdrh       }else{
266312ffee8cSdrh         pFarg = pExpr->x.pList;
266412ffee8cSdrh       }
266512ffee8cSdrh       nFarg = pFarg ? pFarg->nExpr : 0;
266633e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
266733e619fcSdrh       zId = pExpr->u.zToken;
2668b7916a78Sdrh       nId = sqlite3Strlen30(zId);
266912ffee8cSdrh       pDef = sqlite3FindFunction(db, zId, nId, nFarg, enc, 0);
2670feb306f5Sdrh       if( pDef==0 ){
2671feb306f5Sdrh         sqlite3ErrorMsg(pParse, "unknown function: %.*s()", nId, zId);
2672feb306f5Sdrh         break;
2673feb306f5Sdrh       }
2674ae6bb957Sdrh 
2675ae6bb957Sdrh       /* Attempt a direct implementation of the built-in COALESCE() and
2676ae6bb957Sdrh       ** IFNULL() functions.  This avoids unnecessary evalation of
2677ae6bb957Sdrh       ** arguments past the first non-NULL argument.
2678ae6bb957Sdrh       */
2679d36e1041Sdrh       if( pDef->funcFlags & SQLITE_FUNC_COALESCE ){
2680ae6bb957Sdrh         int endCoalesce = sqlite3VdbeMakeLabel(v);
2681ae6bb957Sdrh         assert( nFarg>=2 );
2682ae6bb957Sdrh         sqlite3ExprCode(pParse, pFarg->a[0].pExpr, target);
2683ae6bb957Sdrh         for(i=1; i<nFarg; i++){
2684ae6bb957Sdrh           sqlite3VdbeAddOp2(v, OP_NotNull, target, endCoalesce);
2685688852abSdrh           VdbeCoverage(v);
2686f49f3523Sdrh           sqlite3ExprCacheRemove(pParse, target, 1);
2687ae6bb957Sdrh           sqlite3ExprCachePush(pParse);
2688ae6bb957Sdrh           sqlite3ExprCode(pParse, pFarg->a[i].pExpr, target);
2689d2490904Sdrh           sqlite3ExprCachePop(pParse);
2690ae6bb957Sdrh         }
2691ae6bb957Sdrh         sqlite3VdbeResolveLabel(v, endCoalesce);
2692ae6bb957Sdrh         break;
2693ae6bb957Sdrh       }
2694ae6bb957Sdrh 
2695cca9f3d2Sdrh       /* The UNLIKELY() function is a no-op.  The result is the value
2696cca9f3d2Sdrh       ** of the first argument.
2697cca9f3d2Sdrh       */
2698cca9f3d2Sdrh       if( pDef->funcFlags & SQLITE_FUNC_UNLIKELY ){
2699cca9f3d2Sdrh         assert( nFarg>=1 );
2700cca9f3d2Sdrh         sqlite3ExprCode(pParse, pFarg->a[0].pExpr, target);
2701cca9f3d2Sdrh         break;
2702cca9f3d2Sdrh       }
2703ae6bb957Sdrh 
2704d1a01edaSdrh       for(i=0; i<nFarg; i++){
2705d1a01edaSdrh         if( i<32 && sqlite3ExprIsConstant(pFarg->a[i].pExpr) ){
2706693e6719Sdrh           testcase( i==31 );
2707693e6719Sdrh           constMask |= MASKBIT32(i);
2708d1a01edaSdrh         }
2709d1a01edaSdrh         if( (pDef->funcFlags & SQLITE_FUNC_NEEDCOLL)!=0 && !pColl ){
2710d1a01edaSdrh           pColl = sqlite3ExprCollSeq(pParse, pFarg->a[i].pExpr);
2711d1a01edaSdrh         }
2712d1a01edaSdrh       }
271312ffee8cSdrh       if( pFarg ){
2714d1a01edaSdrh         if( constMask ){
2715d1a01edaSdrh           r1 = pParse->nMem+1;
2716d1a01edaSdrh           pParse->nMem += nFarg;
2717d1a01edaSdrh         }else{
271812ffee8cSdrh           r1 = sqlite3GetTempRange(pParse, nFarg);
2719d1a01edaSdrh         }
2720a748fdccSdrh 
2721a748fdccSdrh         /* For length() and typeof() functions with a column argument,
2722a748fdccSdrh         ** set the P5 parameter to the OP_Column opcode to OPFLAG_LENGTHARG
2723a748fdccSdrh         ** or OPFLAG_TYPEOFARG respectively, to avoid unnecessary data
2724a748fdccSdrh         ** loading.
2725a748fdccSdrh         */
2726d36e1041Sdrh         if( (pDef->funcFlags & (SQLITE_FUNC_LENGTH|SQLITE_FUNC_TYPEOF))!=0 ){
27274e245a4cSdrh           u8 exprOp;
2728a748fdccSdrh           assert( nFarg==1 );
2729a748fdccSdrh           assert( pFarg->a[0].pExpr!=0 );
27304e245a4cSdrh           exprOp = pFarg->a[0].pExpr->op;
27314e245a4cSdrh           if( exprOp==TK_COLUMN || exprOp==TK_AGG_COLUMN ){
2732a748fdccSdrh             assert( SQLITE_FUNC_LENGTH==OPFLAG_LENGTHARG );
2733a748fdccSdrh             assert( SQLITE_FUNC_TYPEOF==OPFLAG_TYPEOFARG );
2734b1fba286Sdrh             testcase( pDef->funcFlags & OPFLAG_LENGTHARG );
2735b1fba286Sdrh             pFarg->a[0].pExpr->op2 =
2736b1fba286Sdrh                   pDef->funcFlags & (OPFLAG_LENGTHARG|OPFLAG_TYPEOFARG);
2737a748fdccSdrh           }
2738a748fdccSdrh         }
2739a748fdccSdrh 
2740d7d385ddSdrh         sqlite3ExprCachePush(pParse);     /* Ticket 2ea2425d34be */
2741d1a01edaSdrh         sqlite3ExprCodeExprList(pParse, pFarg, r1,
2742d1a01edaSdrh                                 SQLITE_ECEL_DUP|SQLITE_ECEL_FACTOR);
2743d2490904Sdrh         sqlite3ExprCachePop(pParse);      /* Ticket 2ea2425d34be */
2744892d3179Sdrh       }else{
274512ffee8cSdrh         r1 = 0;
2746892d3179Sdrh       }
2747b7f6f68fSdrh #ifndef SQLITE_OMIT_VIRTUALTABLE
2748a43fa227Sdrh       /* Possibly overload the function if the first argument is
2749a43fa227Sdrh       ** a virtual table column.
2750a43fa227Sdrh       **
2751a43fa227Sdrh       ** For infix functions (LIKE, GLOB, REGEXP, and MATCH) use the
2752a43fa227Sdrh       ** second argument, not the first, as the argument to test to
2753a43fa227Sdrh       ** see if it is a column in a virtual table.  This is done because
2754a43fa227Sdrh       ** the left operand of infix functions (the operand we want to
2755a43fa227Sdrh       ** control overloading) ends up as the second argument to the
2756a43fa227Sdrh       ** function.  The expression "A glob B" is equivalent to
2757a43fa227Sdrh       ** "glob(B,A).  We want to use the A in "A glob B" to test
2758a43fa227Sdrh       ** for function overloading.  But we use the B term in "glob(B,A)".
2759a43fa227Sdrh       */
276012ffee8cSdrh       if( nFarg>=2 && (pExpr->flags & EP_InfixFunc) ){
276112ffee8cSdrh         pDef = sqlite3VtabOverloadFunction(db, pDef, nFarg, pFarg->a[1].pExpr);
276212ffee8cSdrh       }else if( nFarg>0 ){
276312ffee8cSdrh         pDef = sqlite3VtabOverloadFunction(db, pDef, nFarg, pFarg->a[0].pExpr);
2764b7f6f68fSdrh       }
2765b7f6f68fSdrh #endif
2766d36e1041Sdrh       if( pDef->funcFlags & SQLITE_FUNC_NEEDCOLL ){
27678b213899Sdrh         if( !pColl ) pColl = db->pDfltColl;
276866a5167bSdrh         sqlite3VdbeAddOp4(v, OP_CollSeq, 0, 0, 0, (char *)pColl, P4_COLLSEQ);
2769682f68b0Sdanielk1977       }
27702dcef11bSdrh       sqlite3VdbeAddOp4(v, OP_Function, constMask, r1, target,
277166a5167bSdrh                         (char*)pDef, P4_FUNCDEF);
277212ffee8cSdrh       sqlite3VdbeChangeP5(v, (u8)nFarg);
2773d1a01edaSdrh       if( nFarg && constMask==0 ){
277412ffee8cSdrh         sqlite3ReleaseTempRange(pParse, r1, nFarg);
27752dcef11bSdrh       }
27766ec2733bSdrh       break;
27776ec2733bSdrh     }
2778fe2093d7Sdrh #ifndef SQLITE_OMIT_SUBQUERY
2779fe2093d7Sdrh     case TK_EXISTS:
278019a775c2Sdrh     case TK_SELECT: {
2781c5499befSdrh       testcase( op==TK_EXISTS );
2782c5499befSdrh       testcase( op==TK_SELECT );
27831450bc6eSdrh       inReg = sqlite3CodeSubselect(pParse, pExpr, 0, 0);
278419a775c2Sdrh       break;
278519a775c2Sdrh     }
2786fef5208cSdrh     case TK_IN: {
2787e3365e6cSdrh       int destIfFalse = sqlite3VdbeMakeLabel(v);
2788e3365e6cSdrh       int destIfNull = sqlite3VdbeMakeLabel(v);
2789e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Null, 0, target);
2790e3365e6cSdrh       sqlite3ExprCodeIN(pParse, pExpr, destIfFalse, destIfNull);
279166ba23ceSdrh       sqlite3VdbeAddOp2(v, OP_Integer, 1, target);
2792e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfFalse);
2793e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_AddImm, target, 0);
2794e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfNull);
2795fef5208cSdrh       break;
2796fef5208cSdrh     }
2797e3365e6cSdrh #endif /* SQLITE_OMIT_SUBQUERY */
2798e3365e6cSdrh 
2799e3365e6cSdrh 
28002dcef11bSdrh     /*
28012dcef11bSdrh     **    x BETWEEN y AND z
28022dcef11bSdrh     **
28032dcef11bSdrh     ** This is equivalent to
28042dcef11bSdrh     **
28052dcef11bSdrh     **    x>=y AND x<=z
28062dcef11bSdrh     **
28072dcef11bSdrh     ** X is stored in pExpr->pLeft.
28082dcef11bSdrh     ** Y is stored in pExpr->pList->a[0].pExpr.
28092dcef11bSdrh     ** Z is stored in pExpr->pList->a[1].pExpr.
28102dcef11bSdrh     */
2811fef5208cSdrh     case TK_BETWEEN: {
2812be5c89acSdrh       Expr *pLeft = pExpr->pLeft;
28136ab3a2ecSdanielk1977       struct ExprList_item *pLItem = pExpr->x.pList->a;
2814be5c89acSdrh       Expr *pRight = pLItem->pExpr;
281535573356Sdrh 
2816b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pLeft, &regFree1);
2817b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pRight, &regFree2);
2818c5499befSdrh       testcase( regFree1==0 );
2819c5499befSdrh       testcase( regFree2==0 );
28202dcef11bSdrh       r3 = sqlite3GetTempReg(pParse);
2821678ccce8Sdrh       r4 = sqlite3GetTempReg(pParse);
282235573356Sdrh       codeCompare(pParse, pLeft, pRight, OP_Ge,
28237d176105Sdrh                   r1, r2, r3, SQLITE_STOREP2);  VdbeCoverage(v);
2824be5c89acSdrh       pLItem++;
2825be5c89acSdrh       pRight = pLItem->pExpr;
28262dcef11bSdrh       sqlite3ReleaseTempReg(pParse, regFree2);
28272dcef11bSdrh       r2 = sqlite3ExprCodeTemp(pParse, pRight, &regFree2);
2828c5499befSdrh       testcase( regFree2==0 );
2829678ccce8Sdrh       codeCompare(pParse, pLeft, pRight, OP_Le, r1, r2, r4, SQLITE_STOREP2);
2830688852abSdrh       VdbeCoverage(v);
2831678ccce8Sdrh       sqlite3VdbeAddOp3(v, OP_And, r3, r4, target);
28322dcef11bSdrh       sqlite3ReleaseTempReg(pParse, r3);
2833678ccce8Sdrh       sqlite3ReleaseTempReg(pParse, r4);
2834fef5208cSdrh       break;
2835fef5208cSdrh     }
2836ae80ddeaSdrh     case TK_COLLATE:
28374f07e5fbSdrh     case TK_UPLUS: {
28382dcef11bSdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
2839a2e00042Sdrh       break;
2840a2e00042Sdrh     }
28412dcef11bSdrh 
2842165921a7Sdan     case TK_TRIGGER: {
284365a7cd16Sdan       /* If the opcode is TK_TRIGGER, then the expression is a reference
284465a7cd16Sdan       ** to a column in the new.* or old.* pseudo-tables available to
284565a7cd16Sdan       ** trigger programs. In this case Expr.iTable is set to 1 for the
284665a7cd16Sdan       ** new.* pseudo-table, or 0 for the old.* pseudo-table. Expr.iColumn
284765a7cd16Sdan       ** is set to the column of the pseudo-table to read, or to -1 to
284865a7cd16Sdan       ** read the rowid field.
284965a7cd16Sdan       **
285065a7cd16Sdan       ** The expression is implemented using an OP_Param opcode. The p1
285165a7cd16Sdan       ** parameter is set to 0 for an old.rowid reference, or to (i+1)
285265a7cd16Sdan       ** to reference another column of the old.* pseudo-table, where
285365a7cd16Sdan       ** i is the index of the column. For a new.rowid reference, p1 is
285465a7cd16Sdan       ** set to (n+1), where n is the number of columns in each pseudo-table.
285565a7cd16Sdan       ** For a reference to any other column in the new.* pseudo-table, p1
285665a7cd16Sdan       ** is set to (n+2+i), where n and i are as defined previously. For
285765a7cd16Sdan       ** example, if the table on which triggers are being fired is
285865a7cd16Sdan       ** declared as:
285965a7cd16Sdan       **
286065a7cd16Sdan       **   CREATE TABLE t1(a, b);
286165a7cd16Sdan       **
286265a7cd16Sdan       ** Then p1 is interpreted as follows:
286365a7cd16Sdan       **
286465a7cd16Sdan       **   p1==0   ->    old.rowid     p1==3   ->    new.rowid
286565a7cd16Sdan       **   p1==1   ->    old.a         p1==4   ->    new.a
286665a7cd16Sdan       **   p1==2   ->    old.b         p1==5   ->    new.b
286765a7cd16Sdan       */
28682832ad42Sdan       Table *pTab = pExpr->pTab;
286965a7cd16Sdan       int p1 = pExpr->iTable * (pTab->nCol+1) + 1 + pExpr->iColumn;
287065a7cd16Sdan 
287165a7cd16Sdan       assert( pExpr->iTable==0 || pExpr->iTable==1 );
287265a7cd16Sdan       assert( pExpr->iColumn>=-1 && pExpr->iColumn<pTab->nCol );
287365a7cd16Sdan       assert( pTab->iPKey<0 || pExpr->iColumn!=pTab->iPKey );
287465a7cd16Sdan       assert( p1>=0 && p1<(pTab->nCol*2+2) );
287565a7cd16Sdan 
287665a7cd16Sdan       sqlite3VdbeAddOp2(v, OP_Param, p1, target);
287776d462eeSdan       VdbeComment((v, "%s.%s -> $%d",
2878165921a7Sdan         (pExpr->iTable ? "new" : "old"),
287976d462eeSdan         (pExpr->iColumn<0 ? "rowid" : pExpr->pTab->aCol[pExpr->iColumn].zName),
288076d462eeSdan         target
2881165921a7Sdan       ));
288265a7cd16Sdan 
288344dbca83Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
288465a7cd16Sdan       /* If the column has REAL affinity, it may currently be stored as an
288565a7cd16Sdan       ** integer. Use OP_RealAffinity to make sure it is really real.  */
28862832ad42Sdan       if( pExpr->iColumn>=0
28872832ad42Sdan        && pTab->aCol[pExpr->iColumn].affinity==SQLITE_AFF_REAL
28882832ad42Sdan       ){
28892832ad42Sdan         sqlite3VdbeAddOp1(v, OP_RealAffinity, target);
28902832ad42Sdan       }
289144dbca83Sdrh #endif
2892165921a7Sdan       break;
2893165921a7Sdan     }
2894165921a7Sdan 
2895165921a7Sdan 
28962dcef11bSdrh     /*
28972dcef11bSdrh     ** Form A:
28982dcef11bSdrh     **   CASE x WHEN e1 THEN r1 WHEN e2 THEN r2 ... WHEN eN THEN rN ELSE y END
28992dcef11bSdrh     **
29002dcef11bSdrh     ** Form B:
29012dcef11bSdrh     **   CASE WHEN e1 THEN r1 WHEN e2 THEN r2 ... WHEN eN THEN rN ELSE y END
29022dcef11bSdrh     **
29032dcef11bSdrh     ** Form A is can be transformed into the equivalent form B as follows:
29042dcef11bSdrh     **   CASE WHEN x=e1 THEN r1 WHEN x=e2 THEN r2 ...
29052dcef11bSdrh     **        WHEN x=eN THEN rN ELSE y END
29062dcef11bSdrh     **
29072dcef11bSdrh     ** X (if it exists) is in pExpr->pLeft.
2908c5cd1249Sdrh     ** Y is in the last element of pExpr->x.pList if pExpr->x.pList->nExpr is
2909c5cd1249Sdrh     ** odd.  The Y is also optional.  If the number of elements in x.pList
2910c5cd1249Sdrh     ** is even, then Y is omitted and the "otherwise" result is NULL.
29112dcef11bSdrh     ** Ei is in pExpr->pList->a[i*2] and Ri is pExpr->pList->a[i*2+1].
29122dcef11bSdrh     **
29132dcef11bSdrh     ** The result of the expression is the Ri for the first matching Ei,
29142dcef11bSdrh     ** or if there is no matching Ei, the ELSE term Y, or if there is
29152dcef11bSdrh     ** no ELSE term, NULL.
29162dcef11bSdrh     */
291733cd4909Sdrh     default: assert( op==TK_CASE ); {
29182dcef11bSdrh       int endLabel;                     /* GOTO label for end of CASE stmt */
29192dcef11bSdrh       int nextCase;                     /* GOTO label for next WHEN clause */
29202dcef11bSdrh       int nExpr;                        /* 2x number of WHEN terms */
29212dcef11bSdrh       int i;                            /* Loop counter */
29222dcef11bSdrh       ExprList *pEList;                 /* List of WHEN terms */
29232dcef11bSdrh       struct ExprList_item *aListelem;  /* Array of WHEN terms */
29242dcef11bSdrh       Expr opCompare;                   /* The X==Ei expression */
29252dcef11bSdrh       Expr *pX;                         /* The X expression */
29261bd10f8aSdrh       Expr *pTest = 0;                  /* X==Ei (form A) or just Ei (form B) */
2927ceea3321Sdrh       VVA_ONLY( int iCacheLevel = pParse->iCacheLevel; )
292817a7f8ddSdrh 
29296ab3a2ecSdanielk1977       assert( !ExprHasProperty(pExpr, EP_xIsSelect) && pExpr->x.pList );
29306ab3a2ecSdanielk1977       assert(pExpr->x.pList->nExpr > 0);
29316ab3a2ecSdanielk1977       pEList = pExpr->x.pList;
2932be5c89acSdrh       aListelem = pEList->a;
2933be5c89acSdrh       nExpr = pEList->nExpr;
29342dcef11bSdrh       endLabel = sqlite3VdbeMakeLabel(v);
29352dcef11bSdrh       if( (pX = pExpr->pLeft)!=0 ){
293610d1edf0Sdrh         tempX = *pX;
293733cd4909Sdrh         testcase( pX->op==TK_COLUMN );
293810d1edf0Sdrh         exprToRegister(&tempX, sqlite3ExprCodeTemp(pParse, pX, &regFree1));
2939c5499befSdrh         testcase( regFree1==0 );
29402dcef11bSdrh         opCompare.op = TK_EQ;
294110d1edf0Sdrh         opCompare.pLeft = &tempX;
29422dcef11bSdrh         pTest = &opCompare;
29438b1db07fSdrh         /* Ticket b351d95f9cd5ef17e9d9dbae18f5ca8611190001:
29448b1db07fSdrh         ** The value in regFree1 might get SCopy-ed into the file result.
29458b1db07fSdrh         ** So make sure that the regFree1 register is not reused for other
29468b1db07fSdrh         ** purposes and possibly overwritten.  */
29478b1db07fSdrh         regFree1 = 0;
2948cce7d176Sdrh       }
2949c5cd1249Sdrh       for(i=0; i<nExpr-1; i=i+2){
2950ceea3321Sdrh         sqlite3ExprCachePush(pParse);
29512dcef11bSdrh         if( pX ){
29521bd10f8aSdrh           assert( pTest!=0 );
29532dcef11bSdrh           opCompare.pRight = aListelem[i].pExpr;
2954f5905aa7Sdrh         }else{
29552dcef11bSdrh           pTest = aListelem[i].pExpr;
295617a7f8ddSdrh         }
29572dcef11bSdrh         nextCase = sqlite3VdbeMakeLabel(v);
295833cd4909Sdrh         testcase( pTest->op==TK_COLUMN );
29592dcef11bSdrh         sqlite3ExprIfFalse(pParse, pTest, nextCase, SQLITE_JUMPIFNULL);
2960c5499befSdrh         testcase( aListelem[i+1].pExpr->op==TK_COLUMN );
29619de221dfSdrh         sqlite3ExprCode(pParse, aListelem[i+1].pExpr, target);
29622dcef11bSdrh         sqlite3VdbeAddOp2(v, OP_Goto, 0, endLabel);
2963d2490904Sdrh         sqlite3ExprCachePop(pParse);
29642dcef11bSdrh         sqlite3VdbeResolveLabel(v, nextCase);
2965f570f011Sdrh       }
2966c5cd1249Sdrh       if( (nExpr&1)!=0 ){
2967ceea3321Sdrh         sqlite3ExprCachePush(pParse);
2968c5cd1249Sdrh         sqlite3ExprCode(pParse, pEList->a[nExpr-1].pExpr, target);
2969d2490904Sdrh         sqlite3ExprCachePop(pParse);
297017a7f8ddSdrh       }else{
29719de221dfSdrh         sqlite3VdbeAddOp2(v, OP_Null, 0, target);
297217a7f8ddSdrh       }
2973c1f4a19bSdanielk1977       assert( db->mallocFailed || pParse->nErr>0
2974c1f4a19bSdanielk1977            || pParse->iCacheLevel==iCacheLevel );
29752dcef11bSdrh       sqlite3VdbeResolveLabel(v, endLabel);
29766f34903eSdanielk1977       break;
29776f34903eSdanielk1977     }
29785338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_TRIGGER
29796f34903eSdanielk1977     case TK_RAISE: {
2980165921a7Sdan       assert( pExpr->affinity==OE_Rollback
2981165921a7Sdan            || pExpr->affinity==OE_Abort
2982165921a7Sdan            || pExpr->affinity==OE_Fail
2983165921a7Sdan            || pExpr->affinity==OE_Ignore
2984165921a7Sdan       );
2985e0af83acSdan       if( !pParse->pTriggerTab ){
2986e0af83acSdan         sqlite3ErrorMsg(pParse,
2987e0af83acSdan                        "RAISE() may only be used within a trigger-program");
2988e0af83acSdan         return 0;
2989e0af83acSdan       }
2990e0af83acSdan       if( pExpr->affinity==OE_Abort ){
2991e0af83acSdan         sqlite3MayAbort(pParse);
2992e0af83acSdan       }
299333e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
2994e0af83acSdan       if( pExpr->affinity==OE_Ignore ){
2995e0af83acSdan         sqlite3VdbeAddOp4(
2996e0af83acSdan             v, OP_Halt, SQLITE_OK, OE_Ignore, 0, pExpr->u.zToken,0);
2997688852abSdrh         VdbeCoverage(v);
2998e0af83acSdan       }else{
2999433dccfbSdrh         sqlite3HaltConstraint(pParse, SQLITE_CONSTRAINT_TRIGGER,
3000f9c8ce3cSdrh                               pExpr->affinity, pExpr->u.zToken, 0, 0);
3001e0af83acSdan       }
3002e0af83acSdan 
3003ffe07b2dSdrh       break;
300417a7f8ddSdrh     }
30055338a5f7Sdanielk1977 #endif
3006ffe07b2dSdrh   }
30072dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
30082dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
30092dcef11bSdrh   return inReg;
30105b6afba9Sdrh }
30112dcef11bSdrh 
30122dcef11bSdrh /*
3013d1a01edaSdrh ** Factor out the code of the given expression to initialization time.
3014d1a01edaSdrh */
3015d673cddaSdrh void sqlite3ExprCodeAtInit(
3016d673cddaSdrh   Parse *pParse,    /* Parsing context */
3017d673cddaSdrh   Expr *pExpr,      /* The expression to code when the VDBE initializes */
3018d673cddaSdrh   int regDest,      /* Store the value in this register */
3019d673cddaSdrh   u8 reusable       /* True if this expression is reusable */
3020d673cddaSdrh ){
3021d1a01edaSdrh   ExprList *p;
3022d9f158e7Sdrh   assert( ConstFactorOk(pParse) );
3023d1a01edaSdrh   p = pParse->pConstExpr;
3024d1a01edaSdrh   pExpr = sqlite3ExprDup(pParse->db, pExpr, 0);
3025d1a01edaSdrh   p = sqlite3ExprListAppend(pParse, p, pExpr);
3026d673cddaSdrh   if( p ){
3027d673cddaSdrh      struct ExprList_item *pItem = &p->a[p->nExpr-1];
3028d673cddaSdrh      pItem->u.iConstExprReg = regDest;
3029d673cddaSdrh      pItem->reusable = reusable;
3030d673cddaSdrh   }
3031d1a01edaSdrh   pParse->pConstExpr = p;
3032d1a01edaSdrh }
3033d1a01edaSdrh 
3034d1a01edaSdrh /*
30352dcef11bSdrh ** Generate code to evaluate an expression and store the results
30362dcef11bSdrh ** into a register.  Return the register number where the results
30372dcef11bSdrh ** are stored.
30382dcef11bSdrh **
30392dcef11bSdrh ** If the register is a temporary register that can be deallocated,
3040678ccce8Sdrh ** then write its number into *pReg.  If the result register is not
30412dcef11bSdrh ** a temporary, then set *pReg to zero.
3042f30a969bSdrh **
3043f30a969bSdrh ** If pExpr is a constant, then this routine might generate this
3044f30a969bSdrh ** code to fill the register in the initialization section of the
3045f30a969bSdrh ** VDBE program, in order to factor it out of the evaluation loop.
30462dcef11bSdrh */
30472dcef11bSdrh int sqlite3ExprCodeTemp(Parse *pParse, Expr *pExpr, int *pReg){
3048f30a969bSdrh   int r2;
3049f30a969bSdrh   pExpr = sqlite3ExprSkipCollate(pExpr);
3050d9f158e7Sdrh   if( ConstFactorOk(pParse)
3051f30a969bSdrh    && pExpr->op!=TK_REGISTER
3052f30a969bSdrh    && sqlite3ExprIsConstantNotJoin(pExpr)
3053f30a969bSdrh   ){
3054f30a969bSdrh     ExprList *p = pParse->pConstExpr;
3055f30a969bSdrh     int i;
3056f30a969bSdrh     *pReg  = 0;
3057f30a969bSdrh     if( p ){
3058d673cddaSdrh       struct ExprList_item *pItem;
3059d673cddaSdrh       for(pItem=p->a, i=p->nExpr; i>0; pItem++, i--){
3060d673cddaSdrh         if( pItem->reusable && sqlite3ExprCompare(pItem->pExpr,pExpr,-1)==0 ){
3061d673cddaSdrh           return pItem->u.iConstExprReg;
3062f30a969bSdrh         }
3063f30a969bSdrh       }
3064f30a969bSdrh     }
3065f30a969bSdrh     r2 = ++pParse->nMem;
3066d673cddaSdrh     sqlite3ExprCodeAtInit(pParse, pExpr, r2, 1);
3067f30a969bSdrh   }else{
30682dcef11bSdrh     int r1 = sqlite3GetTempReg(pParse);
3069f30a969bSdrh     r2 = sqlite3ExprCodeTarget(pParse, pExpr, r1);
30702dcef11bSdrh     if( r2==r1 ){
30712dcef11bSdrh       *pReg = r1;
30722dcef11bSdrh     }else{
30732dcef11bSdrh       sqlite3ReleaseTempReg(pParse, r1);
30742dcef11bSdrh       *pReg = 0;
30752dcef11bSdrh     }
3076f30a969bSdrh   }
30772dcef11bSdrh   return r2;
30782dcef11bSdrh }
30792dcef11bSdrh 
30802dcef11bSdrh /*
30812dcef11bSdrh ** Generate code that will evaluate expression pExpr and store the
30822dcef11bSdrh ** results in register target.  The results are guaranteed to appear
30832dcef11bSdrh ** in register target.
30842dcef11bSdrh */
308505a86c5cSdrh void sqlite3ExprCode(Parse *pParse, Expr *pExpr, int target){
30869cbf3425Sdrh   int inReg;
30879cbf3425Sdrh 
30889cbf3425Sdrh   assert( target>0 && target<=pParse->nMem );
3089ebc16717Sdrh   if( pExpr && pExpr->op==TK_REGISTER ){
3090ebc16717Sdrh     sqlite3VdbeAddOp2(pParse->pVdbe, OP_Copy, pExpr->iTable, target);
3091ebc16717Sdrh   }else{
30929cbf3425Sdrh     inReg = sqlite3ExprCodeTarget(pParse, pExpr, target);
30930e359b30Sdrh     assert( pParse->pVdbe || pParse->db->mallocFailed );
30940e359b30Sdrh     if( inReg!=target && pParse->pVdbe ){
30959cbf3425Sdrh       sqlite3VdbeAddOp2(pParse->pVdbe, OP_SCopy, inReg, target);
309617a7f8ddSdrh     }
3097ebc16717Sdrh   }
309805a86c5cSdrh }
309905a86c5cSdrh 
310005a86c5cSdrh /*
310105a86c5cSdrh ** Generate code that will evaluate expression pExpr and store the
310205a86c5cSdrh ** results in register target.  The results are guaranteed to appear
310305a86c5cSdrh ** in register target.  If the expression is constant, then this routine
310405a86c5cSdrh ** might choose to code the expression at initialization time.
310505a86c5cSdrh */
310605a86c5cSdrh void sqlite3ExprCodeFactorable(Parse *pParse, Expr *pExpr, int target){
310705a86c5cSdrh   if( pParse->okConstFactor && sqlite3ExprIsConstant(pExpr) ){
310805a86c5cSdrh     sqlite3ExprCodeAtInit(pParse, pExpr, target, 0);
310905a86c5cSdrh   }else{
311005a86c5cSdrh     sqlite3ExprCode(pParse, pExpr, target);
311105a86c5cSdrh   }
3112cce7d176Sdrh }
3113cce7d176Sdrh 
3114cce7d176Sdrh /*
31152dcef11bSdrh ** Generate code that evalutes the given expression and puts the result
3116de4fcfddSdrh ** in register target.
311725303780Sdrh **
31182dcef11bSdrh ** Also make a copy of the expression results into another "cache" register
31192dcef11bSdrh ** and modify the expression so that the next time it is evaluated,
31202dcef11bSdrh ** the result is a copy of the cache register.
31212dcef11bSdrh **
31222dcef11bSdrh ** This routine is used for expressions that are used multiple
31232dcef11bSdrh ** times.  They are evaluated once and the results of the expression
31242dcef11bSdrh ** are reused.
312525303780Sdrh */
312605a86c5cSdrh void sqlite3ExprCodeAndCache(Parse *pParse, Expr *pExpr, int target){
312725303780Sdrh   Vdbe *v = pParse->pVdbe;
312825303780Sdrh   int iMem;
312905a86c5cSdrh 
313005a86c5cSdrh   assert( target>0 );
313105a86c5cSdrh   assert( pExpr->op!=TK_REGISTER );
313205a86c5cSdrh   sqlite3ExprCode(pParse, pExpr, target);
31332dcef11bSdrh   iMem = ++pParse->nMem;
313405a86c5cSdrh   sqlite3VdbeAddOp2(v, OP_Copy, target, iMem);
3135a4c3c87eSdrh   exprToRegister(pExpr, iMem);
313625303780Sdrh }
31372dcef11bSdrh 
3138678a9aa7Sdrh #if defined(SQLITE_ENABLE_TREE_EXPLAIN)
31397e02e5e6Sdrh /*
31407e02e5e6Sdrh ** Generate a human-readable explanation of an expression tree.
31417e02e5e6Sdrh */
3142a84203a0Sdrh void sqlite3ExplainExpr(Vdbe *pOut, Expr *pExpr){
3143a84203a0Sdrh   int op;                   /* The opcode being coded */
3144a84203a0Sdrh   const char *zBinOp = 0;   /* Binary operator */
3145a84203a0Sdrh   const char *zUniOp = 0;   /* Unary operator */
3146a84203a0Sdrh   if( pExpr==0 ){
3147a84203a0Sdrh     op = TK_NULL;
31487e02e5e6Sdrh   }else{
3149a84203a0Sdrh     op = pExpr->op;
31507e02e5e6Sdrh   }
3151a84203a0Sdrh   switch( op ){
3152a84203a0Sdrh     case TK_AGG_COLUMN: {
315304b8342bSdrh       sqlite3ExplainPrintf(pOut, "AGG{%d:%d}",
315404b8342bSdrh             pExpr->iTable, pExpr->iColumn);
3155a84203a0Sdrh       break;
31567e02e5e6Sdrh     }
3157a84203a0Sdrh     case TK_COLUMN: {
3158a84203a0Sdrh       if( pExpr->iTable<0 ){
3159a84203a0Sdrh         /* This only happens when coding check constraints */
3160a84203a0Sdrh         sqlite3ExplainPrintf(pOut, "COLUMN(%d)", pExpr->iColumn);
3161a84203a0Sdrh       }else{
316204b8342bSdrh         sqlite3ExplainPrintf(pOut, "{%d:%d}",
316304b8342bSdrh                              pExpr->iTable, pExpr->iColumn);
3164a84203a0Sdrh       }
3165a84203a0Sdrh       break;
3166a84203a0Sdrh     }
3167a84203a0Sdrh     case TK_INTEGER: {
3168a84203a0Sdrh       if( pExpr->flags & EP_IntValue ){
316904b8342bSdrh         sqlite3ExplainPrintf(pOut, "%d", pExpr->u.iValue);
3170a84203a0Sdrh       }else{
317104b8342bSdrh         sqlite3ExplainPrintf(pOut, "%s", pExpr->u.zToken);
3172a84203a0Sdrh       }
3173a84203a0Sdrh       break;
3174a84203a0Sdrh     }
3175a84203a0Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
3176a84203a0Sdrh     case TK_FLOAT: {
317704b8342bSdrh       sqlite3ExplainPrintf(pOut,"%s", pExpr->u.zToken);
3178a84203a0Sdrh       break;
3179a84203a0Sdrh     }
3180a84203a0Sdrh #endif
3181a84203a0Sdrh     case TK_STRING: {
318204b8342bSdrh       sqlite3ExplainPrintf(pOut,"%Q", pExpr->u.zToken);
3183a84203a0Sdrh       break;
3184a84203a0Sdrh     }
3185a84203a0Sdrh     case TK_NULL: {
3186a84203a0Sdrh       sqlite3ExplainPrintf(pOut,"NULL");
3187a84203a0Sdrh       break;
3188a84203a0Sdrh     }
3189a84203a0Sdrh #ifndef SQLITE_OMIT_BLOB_LITERAL
3190a84203a0Sdrh     case TK_BLOB: {
319104b8342bSdrh       sqlite3ExplainPrintf(pOut,"%s", pExpr->u.zToken);
3192a84203a0Sdrh       break;
3193a84203a0Sdrh     }
3194a84203a0Sdrh #endif
3195a84203a0Sdrh     case TK_VARIABLE: {
3196a84203a0Sdrh       sqlite3ExplainPrintf(pOut,"VARIABLE(%s,%d)",
3197a84203a0Sdrh                            pExpr->u.zToken, pExpr->iColumn);
3198a84203a0Sdrh       break;
3199a84203a0Sdrh     }
3200a84203a0Sdrh     case TK_REGISTER: {
3201a84203a0Sdrh       sqlite3ExplainPrintf(pOut,"REGISTER(%d)", pExpr->iTable);
3202a84203a0Sdrh       break;
3203a84203a0Sdrh     }
3204a84203a0Sdrh     case TK_AS: {
3205a84203a0Sdrh       sqlite3ExplainExpr(pOut, pExpr->pLeft);
3206a84203a0Sdrh       break;
3207a84203a0Sdrh     }
3208a84203a0Sdrh #ifndef SQLITE_OMIT_CAST
3209a84203a0Sdrh     case TK_CAST: {
3210a84203a0Sdrh       /* Expressions of the form:   CAST(pLeft AS token) */
3211a84203a0Sdrh       const char *zAff = "unk";
3212fdaac671Sdrh       switch( sqlite3AffinityType(pExpr->u.zToken, 0) ){
3213a84203a0Sdrh         case SQLITE_AFF_TEXT:    zAff = "TEXT";     break;
3214a84203a0Sdrh         case SQLITE_AFF_NONE:    zAff = "NONE";     break;
3215a84203a0Sdrh         case SQLITE_AFF_NUMERIC: zAff = "NUMERIC";  break;
3216a84203a0Sdrh         case SQLITE_AFF_INTEGER: zAff = "INTEGER";  break;
3217a84203a0Sdrh         case SQLITE_AFF_REAL:    zAff = "REAL";     break;
3218a84203a0Sdrh       }
3219a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "CAST-%s(", zAff);
3220a84203a0Sdrh       sqlite3ExplainExpr(pOut, pExpr->pLeft);
3221a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ")");
3222a84203a0Sdrh       break;
3223a84203a0Sdrh     }
3224a84203a0Sdrh #endif /* SQLITE_OMIT_CAST */
3225a84203a0Sdrh     case TK_LT:      zBinOp = "LT";     break;
3226a84203a0Sdrh     case TK_LE:      zBinOp = "LE";     break;
3227a84203a0Sdrh     case TK_GT:      zBinOp = "GT";     break;
3228a84203a0Sdrh     case TK_GE:      zBinOp = "GE";     break;
3229a84203a0Sdrh     case TK_NE:      zBinOp = "NE";     break;
3230a84203a0Sdrh     case TK_EQ:      zBinOp = "EQ";     break;
3231a84203a0Sdrh     case TK_IS:      zBinOp = "IS";     break;
3232a84203a0Sdrh     case TK_ISNOT:   zBinOp = "ISNOT";  break;
3233a84203a0Sdrh     case TK_AND:     zBinOp = "AND";    break;
3234a84203a0Sdrh     case TK_OR:      zBinOp = "OR";     break;
3235a84203a0Sdrh     case TK_PLUS:    zBinOp = "ADD";    break;
3236a84203a0Sdrh     case TK_STAR:    zBinOp = "MUL";    break;
3237a84203a0Sdrh     case TK_MINUS:   zBinOp = "SUB";    break;
3238a84203a0Sdrh     case TK_REM:     zBinOp = "REM";    break;
3239a84203a0Sdrh     case TK_BITAND:  zBinOp = "BITAND"; break;
3240a84203a0Sdrh     case TK_BITOR:   zBinOp = "BITOR";  break;
3241a84203a0Sdrh     case TK_SLASH:   zBinOp = "DIV";    break;
3242a84203a0Sdrh     case TK_LSHIFT:  zBinOp = "LSHIFT"; break;
3243a84203a0Sdrh     case TK_RSHIFT:  zBinOp = "RSHIFT"; break;
3244a84203a0Sdrh     case TK_CONCAT:  zBinOp = "CONCAT"; break;
3245a84203a0Sdrh 
3246a84203a0Sdrh     case TK_UMINUS:  zUniOp = "UMINUS"; break;
3247a84203a0Sdrh     case TK_UPLUS:   zUniOp = "UPLUS";  break;
3248a84203a0Sdrh     case TK_BITNOT:  zUniOp = "BITNOT"; break;
3249a84203a0Sdrh     case TK_NOT:     zUniOp = "NOT";    break;
3250a84203a0Sdrh     case TK_ISNULL:  zUniOp = "ISNULL"; break;
3251a84203a0Sdrh     case TK_NOTNULL: zUniOp = "NOTNULL"; break;
3252a84203a0Sdrh 
32537a66da13Sdrh     case TK_COLLATE: {
32547a66da13Sdrh       sqlite3ExplainExpr(pOut, pExpr->pLeft);
32557a66da13Sdrh       sqlite3ExplainPrintf(pOut,".COLLATE(%s)",pExpr->u.zToken);
32567a66da13Sdrh       break;
32577a66da13Sdrh     }
32587a66da13Sdrh 
3259a84203a0Sdrh     case TK_AGG_FUNCTION:
3260a84203a0Sdrh     case TK_FUNCTION: {
3261a84203a0Sdrh       ExprList *pFarg;       /* List of function arguments */
3262c5cd1249Sdrh       if( ExprHasProperty(pExpr, EP_TokenOnly) ){
3263a84203a0Sdrh         pFarg = 0;
3264a84203a0Sdrh       }else{
3265a84203a0Sdrh         pFarg = pExpr->x.pList;
3266a84203a0Sdrh       }
3267ed551b95Sdrh       if( op==TK_AGG_FUNCTION ){
3268ed551b95Sdrh         sqlite3ExplainPrintf(pOut, "AGG_FUNCTION%d:%s(",
3269ed551b95Sdrh                              pExpr->op2, pExpr->u.zToken);
3270ed551b95Sdrh       }else{
3271ed551b95Sdrh         sqlite3ExplainPrintf(pOut, "FUNCTION:%s(", pExpr->u.zToken);
3272ed551b95Sdrh       }
3273a84203a0Sdrh       if( pFarg ){
3274a84203a0Sdrh         sqlite3ExplainExprList(pOut, pFarg);
32757e02e5e6Sdrh       }
32767e02e5e6Sdrh       sqlite3ExplainPrintf(pOut, ")");
3277a84203a0Sdrh       break;
3278a84203a0Sdrh     }
3279a84203a0Sdrh #ifndef SQLITE_OMIT_SUBQUERY
3280a84203a0Sdrh     case TK_EXISTS: {
3281a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "EXISTS(");
3282a84203a0Sdrh       sqlite3ExplainSelect(pOut, pExpr->x.pSelect);
3283a84203a0Sdrh       sqlite3ExplainPrintf(pOut,")");
3284a84203a0Sdrh       break;
3285a84203a0Sdrh     }
3286a84203a0Sdrh     case TK_SELECT: {
3287a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "(");
3288a84203a0Sdrh       sqlite3ExplainSelect(pOut, pExpr->x.pSelect);
3289a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ")");
3290a84203a0Sdrh       break;
3291a84203a0Sdrh     }
3292a84203a0Sdrh     case TK_IN: {
3293a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "IN(");
3294a84203a0Sdrh       sqlite3ExplainExpr(pOut, pExpr->pLeft);
3295a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ",");
3296a84203a0Sdrh       if( ExprHasProperty(pExpr, EP_xIsSelect) ){
3297a84203a0Sdrh         sqlite3ExplainSelect(pOut, pExpr->x.pSelect);
3298a84203a0Sdrh       }else{
3299a84203a0Sdrh         sqlite3ExplainExprList(pOut, pExpr->x.pList);
3300a84203a0Sdrh       }
3301a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ")");
3302a84203a0Sdrh       break;
3303a84203a0Sdrh     }
3304a84203a0Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
3305a84203a0Sdrh 
3306a84203a0Sdrh     /*
3307a84203a0Sdrh     **    x BETWEEN y AND z
3308a84203a0Sdrh     **
3309a84203a0Sdrh     ** This is equivalent to
3310a84203a0Sdrh     **
3311a84203a0Sdrh     **    x>=y AND x<=z
3312a84203a0Sdrh     **
3313a84203a0Sdrh     ** X is stored in pExpr->pLeft.
3314a84203a0Sdrh     ** Y is stored in pExpr->pList->a[0].pExpr.
3315a84203a0Sdrh     ** Z is stored in pExpr->pList->a[1].pExpr.
3316a84203a0Sdrh     */
3317a84203a0Sdrh     case TK_BETWEEN: {
3318a84203a0Sdrh       Expr *pX = pExpr->pLeft;
3319a84203a0Sdrh       Expr *pY = pExpr->x.pList->a[0].pExpr;
3320a84203a0Sdrh       Expr *pZ = pExpr->x.pList->a[1].pExpr;
3321a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "BETWEEN(");
3322a84203a0Sdrh       sqlite3ExplainExpr(pOut, pX);
3323a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ",");
3324a84203a0Sdrh       sqlite3ExplainExpr(pOut, pY);
3325a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ",");
3326a84203a0Sdrh       sqlite3ExplainExpr(pOut, pZ);
3327a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ")");
3328a84203a0Sdrh       break;
3329a84203a0Sdrh     }
3330a84203a0Sdrh     case TK_TRIGGER: {
3331a84203a0Sdrh       /* If the opcode is TK_TRIGGER, then the expression is a reference
3332a84203a0Sdrh       ** to a column in the new.* or old.* pseudo-tables available to
3333a84203a0Sdrh       ** trigger programs. In this case Expr.iTable is set to 1 for the
3334a84203a0Sdrh       ** new.* pseudo-table, or 0 for the old.* pseudo-table. Expr.iColumn
3335a84203a0Sdrh       ** is set to the column of the pseudo-table to read, or to -1 to
3336a84203a0Sdrh       ** read the rowid field.
3337a84203a0Sdrh       */
3338a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "%s(%d)",
3339a84203a0Sdrh           pExpr->iTable ? "NEW" : "OLD", pExpr->iColumn);
3340a84203a0Sdrh       break;
3341a84203a0Sdrh     }
3342a84203a0Sdrh     case TK_CASE: {
3343a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "CASE(");
3344a84203a0Sdrh       sqlite3ExplainExpr(pOut, pExpr->pLeft);
3345a84203a0Sdrh       sqlite3ExplainPrintf(pOut, ",");
3346a84203a0Sdrh       sqlite3ExplainExprList(pOut, pExpr->x.pList);
3347a84203a0Sdrh       break;
3348a84203a0Sdrh     }
3349a84203a0Sdrh #ifndef SQLITE_OMIT_TRIGGER
3350a84203a0Sdrh     case TK_RAISE: {
3351a84203a0Sdrh       const char *zType = "unk";
3352a84203a0Sdrh       switch( pExpr->affinity ){
3353a84203a0Sdrh         case OE_Rollback:   zType = "rollback";  break;
3354a84203a0Sdrh         case OE_Abort:      zType = "abort";     break;
3355a84203a0Sdrh         case OE_Fail:       zType = "fail";      break;
3356a84203a0Sdrh         case OE_Ignore:     zType = "ignore";    break;
3357a84203a0Sdrh       }
3358a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "RAISE-%s(%s)", zType, pExpr->u.zToken);
3359a84203a0Sdrh       break;
3360a84203a0Sdrh     }
3361a84203a0Sdrh #endif
3362a84203a0Sdrh   }
3363a84203a0Sdrh   if( zBinOp ){
3364a84203a0Sdrh     sqlite3ExplainPrintf(pOut,"%s(", zBinOp);
3365a84203a0Sdrh     sqlite3ExplainExpr(pOut, pExpr->pLeft);
3366a84203a0Sdrh     sqlite3ExplainPrintf(pOut,",");
3367a84203a0Sdrh     sqlite3ExplainExpr(pOut, pExpr->pRight);
3368a84203a0Sdrh     sqlite3ExplainPrintf(pOut,")");
3369a84203a0Sdrh   }else if( zUniOp ){
3370a84203a0Sdrh     sqlite3ExplainPrintf(pOut,"%s(", zUniOp);
3371a84203a0Sdrh     sqlite3ExplainExpr(pOut, pExpr->pLeft);
3372a84203a0Sdrh     sqlite3ExplainPrintf(pOut,")");
3373a84203a0Sdrh   }
33747e02e5e6Sdrh }
3375678a9aa7Sdrh #endif /* defined(SQLITE_ENABLE_TREE_EXPLAIN) */
33767e02e5e6Sdrh 
3377678a9aa7Sdrh #if defined(SQLITE_ENABLE_TREE_EXPLAIN)
33787e02e5e6Sdrh /*
33797e02e5e6Sdrh ** Generate a human-readable explanation of an expression list.
33807e02e5e6Sdrh */
33817e02e5e6Sdrh void sqlite3ExplainExprList(Vdbe *pOut, ExprList *pList){
33827e02e5e6Sdrh   int i;
3383a84203a0Sdrh   if( pList==0 || pList->nExpr==0 ){
33847e02e5e6Sdrh     sqlite3ExplainPrintf(pOut, "(empty-list)");
33857e02e5e6Sdrh     return;
3386a84203a0Sdrh   }else if( pList->nExpr==1 ){
3387a84203a0Sdrh     sqlite3ExplainExpr(pOut, pList->a[0].pExpr);
3388a84203a0Sdrh   }else{
33897e02e5e6Sdrh     sqlite3ExplainPush(pOut);
33907e02e5e6Sdrh     for(i=0; i<pList->nExpr; i++){
3391a84203a0Sdrh       sqlite3ExplainPrintf(pOut, "item[%d] = ", i);
33927e02e5e6Sdrh       sqlite3ExplainPush(pOut);
33937e02e5e6Sdrh       sqlite3ExplainExpr(pOut, pList->a[i].pExpr);
3394b66e21fdSdrh       sqlite3ExplainPop(pOut);
33953e3f1a5bSdrh       if( pList->a[i].zName ){
33963e3f1a5bSdrh         sqlite3ExplainPrintf(pOut, " AS %s", pList->a[i].zName);
33973e3f1a5bSdrh       }
33983e3f1a5bSdrh       if( pList->a[i].bSpanIsTab ){
33993e3f1a5bSdrh         sqlite3ExplainPrintf(pOut, " (%s)", pList->a[i].zSpan);
34003e3f1a5bSdrh       }
34017e02e5e6Sdrh       if( i<pList->nExpr-1 ){
34027e02e5e6Sdrh         sqlite3ExplainNL(pOut);
34037e02e5e6Sdrh       }
34047e02e5e6Sdrh     }
34057e02e5e6Sdrh     sqlite3ExplainPop(pOut);
34067e02e5e6Sdrh   }
3407a84203a0Sdrh }
34087e02e5e6Sdrh #endif /* SQLITE_DEBUG */
34097e02e5e6Sdrh 
3410678ccce8Sdrh /*
3411268380caSdrh ** Generate code that pushes the value of every element of the given
34129cbf3425Sdrh ** expression list into a sequence of registers beginning at target.
3413268380caSdrh **
3414892d3179Sdrh ** Return the number of elements evaluated.
3415d1a01edaSdrh **
3416d1a01edaSdrh ** The SQLITE_ECEL_DUP flag prevents the arguments from being
3417d1a01edaSdrh ** filled using OP_SCopy.  OP_Copy must be used instead.
3418d1a01edaSdrh **
3419d1a01edaSdrh ** The SQLITE_ECEL_FACTOR argument allows constant arguments to be
3420d1a01edaSdrh ** factored out into initialization code.
3421268380caSdrh */
34224adee20fSdanielk1977 int sqlite3ExprCodeExprList(
3423268380caSdrh   Parse *pParse,     /* Parsing context */
3424389a1adbSdrh   ExprList *pList,   /* The expression list to be coded */
3425191b54cbSdrh   int target,        /* Where to write results */
3426d1a01edaSdrh   u8 flags           /* SQLITE_ECEL_* flags */
3427268380caSdrh ){
3428268380caSdrh   struct ExprList_item *pItem;
34299cbf3425Sdrh   int i, n;
3430d1a01edaSdrh   u8 copyOp = (flags & SQLITE_ECEL_DUP) ? OP_Copy : OP_SCopy;
34319d8b3072Sdrh   assert( pList!=0 );
34329cbf3425Sdrh   assert( target>0 );
3433d81a142bSdrh   assert( pParse->pVdbe!=0 );  /* Never gets this far otherwise */
3434268380caSdrh   n = pList->nExpr;
3435d9f158e7Sdrh   if( !ConstFactorOk(pParse) ) flags &= ~SQLITE_ECEL_FACTOR;
3436191b54cbSdrh   for(pItem=pList->a, i=0; i<n; i++, pItem++){
34377445ffe2Sdrh     Expr *pExpr = pItem->pExpr;
3438d1a01edaSdrh     if( (flags & SQLITE_ECEL_FACTOR)!=0 && sqlite3ExprIsConstant(pExpr) ){
3439d673cddaSdrh       sqlite3ExprCodeAtInit(pParse, pExpr, target+i, 0);
3440d1a01edaSdrh     }else{
34417445ffe2Sdrh       int inReg = sqlite3ExprCodeTarget(pParse, pExpr, target+i);
3442746fd9ccSdrh       if( inReg!=target+i ){
34434eded604Sdrh         VdbeOp *pOp;
34444eded604Sdrh         Vdbe *v = pParse->pVdbe;
34454eded604Sdrh         if( copyOp==OP_Copy
34464eded604Sdrh          && (pOp=sqlite3VdbeGetOp(v, -1))->opcode==OP_Copy
34474eded604Sdrh          && pOp->p1+pOp->p3+1==inReg
34484eded604Sdrh          && pOp->p2+pOp->p3+1==target+i
34494eded604Sdrh         ){
34504eded604Sdrh           pOp->p3++;
34514eded604Sdrh         }else{
34524eded604Sdrh           sqlite3VdbeAddOp2(v, copyOp, inReg, target+i);
34534eded604Sdrh         }
3454d1a01edaSdrh       }
3455d176611bSdrh     }
3456268380caSdrh   }
3457f9b596ebSdrh   return n;
3458268380caSdrh }
3459268380caSdrh 
3460268380caSdrh /*
346136c563a2Sdrh ** Generate code for a BETWEEN operator.
346236c563a2Sdrh **
346336c563a2Sdrh **    x BETWEEN y AND z
346436c563a2Sdrh **
346536c563a2Sdrh ** The above is equivalent to
346636c563a2Sdrh **
346736c563a2Sdrh **    x>=y AND x<=z
346836c563a2Sdrh **
346936c563a2Sdrh ** Code it as such, taking care to do the common subexpression
347036c563a2Sdrh ** elementation of x.
347136c563a2Sdrh */
347236c563a2Sdrh static void exprCodeBetween(
347336c563a2Sdrh   Parse *pParse,    /* Parsing and code generating context */
347436c563a2Sdrh   Expr *pExpr,      /* The BETWEEN expression */
347536c563a2Sdrh   int dest,         /* Jump here if the jump is taken */
347636c563a2Sdrh   int jumpIfTrue,   /* Take the jump if the BETWEEN is true */
347736c563a2Sdrh   int jumpIfNull    /* Take the jump if the BETWEEN is NULL */
347836c563a2Sdrh ){
347936c563a2Sdrh   Expr exprAnd;     /* The AND operator in  x>=y AND x<=z  */
348036c563a2Sdrh   Expr compLeft;    /* The  x>=y  term */
348136c563a2Sdrh   Expr compRight;   /* The  x<=z  term */
348236c563a2Sdrh   Expr exprX;       /* The  x  subexpression */
348336c563a2Sdrh   int regFree1 = 0; /* Temporary use register */
348436c563a2Sdrh 
348536c563a2Sdrh   assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
348636c563a2Sdrh   exprX = *pExpr->pLeft;
348736c563a2Sdrh   exprAnd.op = TK_AND;
348836c563a2Sdrh   exprAnd.pLeft = &compLeft;
348936c563a2Sdrh   exprAnd.pRight = &compRight;
349036c563a2Sdrh   compLeft.op = TK_GE;
349136c563a2Sdrh   compLeft.pLeft = &exprX;
349236c563a2Sdrh   compLeft.pRight = pExpr->x.pList->a[0].pExpr;
349336c563a2Sdrh   compRight.op = TK_LE;
349436c563a2Sdrh   compRight.pLeft = &exprX;
349536c563a2Sdrh   compRight.pRight = pExpr->x.pList->a[1].pExpr;
3496a4c3c87eSdrh   exprToRegister(&exprX, sqlite3ExprCodeTemp(pParse, &exprX, &regFree1));
349736c563a2Sdrh   if( jumpIfTrue ){
349836c563a2Sdrh     sqlite3ExprIfTrue(pParse, &exprAnd, dest, jumpIfNull);
349936c563a2Sdrh   }else{
350036c563a2Sdrh     sqlite3ExprIfFalse(pParse, &exprAnd, dest, jumpIfNull);
350136c563a2Sdrh   }
350236c563a2Sdrh   sqlite3ReleaseTempReg(pParse, regFree1);
350336c563a2Sdrh 
350436c563a2Sdrh   /* Ensure adequate test coverage */
350536c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull==0 && regFree1==0 );
350636c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull==0 && regFree1!=0 );
350736c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull!=0 && regFree1==0 );
350836c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull!=0 && regFree1!=0 );
350936c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull==0 && regFree1==0 );
351036c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull==0 && regFree1!=0 );
351136c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull!=0 && regFree1==0 );
351236c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull!=0 && regFree1!=0 );
351336c563a2Sdrh }
351436c563a2Sdrh 
351536c563a2Sdrh /*
3516cce7d176Sdrh ** Generate code for a boolean expression such that a jump is made
3517cce7d176Sdrh ** to the label "dest" if the expression is true but execution
3518cce7d176Sdrh ** continues straight thru if the expression is false.
3519f5905aa7Sdrh **
3520f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false), then
352135573356Sdrh ** take the jump if the jumpIfNull flag is SQLITE_JUMPIFNULL.
3522f2bc013cSdrh **
3523f2bc013cSdrh ** This code depends on the fact that certain token values (ex: TK_EQ)
3524f2bc013cSdrh ** are the same as opcode values (ex: OP_Eq) that implement the corresponding
3525f2bc013cSdrh ** operation.  Special comments in vdbe.c and the mkopcodeh.awk script in
3526f2bc013cSdrh ** the make process cause these values to align.  Assert()s in the code
3527f2bc013cSdrh ** below verify that the numbers are aligned correctly.
3528cce7d176Sdrh */
35294adee20fSdanielk1977 void sqlite3ExprIfTrue(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
3530cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
3531cce7d176Sdrh   int op = 0;
35322dcef11bSdrh   int regFree1 = 0;
35332dcef11bSdrh   int regFree2 = 0;
35342dcef11bSdrh   int r1, r2;
35352dcef11bSdrh 
353635573356Sdrh   assert( jumpIfNull==SQLITE_JUMPIFNULL || jumpIfNull==0 );
353748864df9Smistachkin   if( NEVER(v==0) )     return;  /* Existence of VDBE checked by caller */
353833cd4909Sdrh   if( NEVER(pExpr==0) ) return;  /* No way this can happen */
3539f2bc013cSdrh   op = pExpr->op;
3540f2bc013cSdrh   switch( op ){
3541cce7d176Sdrh     case TK_AND: {
35424adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
3543c5499befSdrh       testcase( jumpIfNull==0 );
354435573356Sdrh       sqlite3ExprIfFalse(pParse, pExpr->pLeft, d2,jumpIfNull^SQLITE_JUMPIFNULL);
354554e2adb5Sdrh       sqlite3ExprCachePush(pParse);
35464adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
35474adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
3548d2490904Sdrh       sqlite3ExprCachePop(pParse);
3549cce7d176Sdrh       break;
3550cce7d176Sdrh     }
3551cce7d176Sdrh     case TK_OR: {
3552c5499befSdrh       testcase( jumpIfNull==0 );
35534adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
355454e2adb5Sdrh       sqlite3ExprCachePush(pParse);
35554adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
3556d2490904Sdrh       sqlite3ExprCachePop(pParse);
3557cce7d176Sdrh       break;
3558cce7d176Sdrh     }
3559cce7d176Sdrh     case TK_NOT: {
3560c5499befSdrh       testcase( jumpIfNull==0 );
35614adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
3562cce7d176Sdrh       break;
3563cce7d176Sdrh     }
3564cce7d176Sdrh     case TK_LT:
3565cce7d176Sdrh     case TK_LE:
3566cce7d176Sdrh     case TK_GT:
3567cce7d176Sdrh     case TK_GE:
3568cce7d176Sdrh     case TK_NE:
35690ac65892Sdrh     case TK_EQ: {
3570c5499befSdrh       testcase( jumpIfNull==0 );
3571b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3572b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
357335573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
35747d176105Sdrh                   r1, r2, dest, jumpIfNull);
35757d176105Sdrh       assert(TK_LT==OP_Lt); testcase(op==OP_Lt); VdbeCoverageIf(v,op==OP_Lt);
35767d176105Sdrh       assert(TK_LE==OP_Le); testcase(op==OP_Le); VdbeCoverageIf(v,op==OP_Le);
35777d176105Sdrh       assert(TK_GT==OP_Gt); testcase(op==OP_Gt); VdbeCoverageIf(v,op==OP_Gt);
35787d176105Sdrh       assert(TK_GE==OP_Ge); testcase(op==OP_Ge); VdbeCoverageIf(v,op==OP_Ge);
35797d176105Sdrh       assert(TK_EQ==OP_Eq); testcase(op==OP_Eq); VdbeCoverageIf(v,op==OP_Eq);
35807d176105Sdrh       assert(TK_NE==OP_Ne); testcase(op==OP_Ne); VdbeCoverageIf(v,op==OP_Ne);
3581c5499befSdrh       testcase( regFree1==0 );
3582c5499befSdrh       testcase( regFree2==0 );
3583cce7d176Sdrh       break;
3584cce7d176Sdrh     }
35856a2fe093Sdrh     case TK_IS:
35866a2fe093Sdrh     case TK_ISNOT: {
35876a2fe093Sdrh       testcase( op==TK_IS );
35886a2fe093Sdrh       testcase( op==TK_ISNOT );
3589b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3590b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
35916a2fe093Sdrh       op = (op==TK_IS) ? TK_EQ : TK_NE;
35926a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
35937d176105Sdrh                   r1, r2, dest, SQLITE_NULLEQ);
35947d176105Sdrh       VdbeCoverageIf(v, op==TK_EQ);
35957d176105Sdrh       VdbeCoverageIf(v, op==TK_NE);
35966a2fe093Sdrh       testcase( regFree1==0 );
35976a2fe093Sdrh       testcase( regFree2==0 );
35986a2fe093Sdrh       break;
35996a2fe093Sdrh     }
3600cce7d176Sdrh     case TK_ISNULL:
3601cce7d176Sdrh     case TK_NOTNULL: {
36027d176105Sdrh       assert( TK_ISNULL==OP_IsNull );   testcase( op==TK_ISNULL );
36037d176105Sdrh       assert( TK_NOTNULL==OP_NotNull ); testcase( op==TK_NOTNULL );
36042dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
36057d176105Sdrh       sqlite3VdbeAddOp2(v, op, r1, dest);
36067d176105Sdrh       VdbeCoverageIf(v, op==TK_ISNULL);
36077d176105Sdrh       VdbeCoverageIf(v, op==TK_NOTNULL);
3608c5499befSdrh       testcase( regFree1==0 );
3609cce7d176Sdrh       break;
3610cce7d176Sdrh     }
3611fef5208cSdrh     case TK_BETWEEN: {
36125c03f30aSdrh       testcase( jumpIfNull==0 );
361336c563a2Sdrh       exprCodeBetween(pParse, pExpr, dest, 1, jumpIfNull);
3614fef5208cSdrh       break;
3615fef5208cSdrh     }
3616bb201344Sshaneh #ifndef SQLITE_OMIT_SUBQUERY
3617e3365e6cSdrh     case TK_IN: {
3618e3365e6cSdrh       int destIfFalse = sqlite3VdbeMakeLabel(v);
3619e3365e6cSdrh       int destIfNull = jumpIfNull ? dest : destIfFalse;
3620e3365e6cSdrh       sqlite3ExprCodeIN(pParse, pExpr, destIfFalse, destIfNull);
3621e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Goto, 0, dest);
3622e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfFalse);
3623e3365e6cSdrh       break;
3624e3365e6cSdrh     }
3625bb201344Sshaneh #endif
3626cce7d176Sdrh     default: {
3627991a1985Sdrh       if( exprAlwaysTrue(pExpr) ){
3628991a1985Sdrh         sqlite3VdbeAddOp2(v, OP_Goto, 0, dest);
3629991a1985Sdrh       }else if( exprAlwaysFalse(pExpr) ){
3630991a1985Sdrh         /* No-op */
3631991a1985Sdrh       }else{
36322dcef11bSdrh         r1 = sqlite3ExprCodeTemp(pParse, pExpr, &regFree1);
36332dcef11bSdrh         sqlite3VdbeAddOp3(v, OP_If, r1, dest, jumpIfNull!=0);
3634688852abSdrh         VdbeCoverage(v);
3635c5499befSdrh         testcase( regFree1==0 );
3636c5499befSdrh         testcase( jumpIfNull==0 );
3637991a1985Sdrh       }
3638cce7d176Sdrh       break;
3639cce7d176Sdrh     }
3640cce7d176Sdrh   }
36412dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
36422dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
3643cce7d176Sdrh }
3644cce7d176Sdrh 
3645cce7d176Sdrh /*
364666b89c8fSdrh ** Generate code for a boolean expression such that a jump is made
3647cce7d176Sdrh ** to the label "dest" if the expression is false but execution
3648cce7d176Sdrh ** continues straight thru if the expression is true.
3649f5905aa7Sdrh **
3650f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false) then
365135573356Sdrh ** jump if jumpIfNull is SQLITE_JUMPIFNULL or fall through if jumpIfNull
365235573356Sdrh ** is 0.
3653cce7d176Sdrh */
36544adee20fSdanielk1977 void sqlite3ExprIfFalse(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
3655cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
3656cce7d176Sdrh   int op = 0;
36572dcef11bSdrh   int regFree1 = 0;
36582dcef11bSdrh   int regFree2 = 0;
36592dcef11bSdrh   int r1, r2;
36602dcef11bSdrh 
366135573356Sdrh   assert( jumpIfNull==SQLITE_JUMPIFNULL || jumpIfNull==0 );
366248864df9Smistachkin   if( NEVER(v==0) ) return; /* Existence of VDBE checked by caller */
366333cd4909Sdrh   if( pExpr==0 )    return;
3664f2bc013cSdrh 
3665f2bc013cSdrh   /* The value of pExpr->op and op are related as follows:
3666f2bc013cSdrh   **
3667f2bc013cSdrh   **       pExpr->op            op
3668f2bc013cSdrh   **       ---------          ----------
3669f2bc013cSdrh   **       TK_ISNULL          OP_NotNull
3670f2bc013cSdrh   **       TK_NOTNULL         OP_IsNull
3671f2bc013cSdrh   **       TK_NE              OP_Eq
3672f2bc013cSdrh   **       TK_EQ              OP_Ne
3673f2bc013cSdrh   **       TK_GT              OP_Le
3674f2bc013cSdrh   **       TK_LE              OP_Gt
3675f2bc013cSdrh   **       TK_GE              OP_Lt
3676f2bc013cSdrh   **       TK_LT              OP_Ge
3677f2bc013cSdrh   **
3678f2bc013cSdrh   ** For other values of pExpr->op, op is undefined and unused.
3679f2bc013cSdrh   ** The value of TK_ and OP_ constants are arranged such that we
3680f2bc013cSdrh   ** can compute the mapping above using the following expression.
3681f2bc013cSdrh   ** Assert()s verify that the computation is correct.
3682f2bc013cSdrh   */
3683f2bc013cSdrh   op = ((pExpr->op+(TK_ISNULL&1))^1)-(TK_ISNULL&1);
3684f2bc013cSdrh 
3685f2bc013cSdrh   /* Verify correct alignment of TK_ and OP_ constants
3686f2bc013cSdrh   */
3687f2bc013cSdrh   assert( pExpr->op!=TK_ISNULL || op==OP_NotNull );
3688f2bc013cSdrh   assert( pExpr->op!=TK_NOTNULL || op==OP_IsNull );
3689f2bc013cSdrh   assert( pExpr->op!=TK_NE || op==OP_Eq );
3690f2bc013cSdrh   assert( pExpr->op!=TK_EQ || op==OP_Ne );
3691f2bc013cSdrh   assert( pExpr->op!=TK_LT || op==OP_Ge );
3692f2bc013cSdrh   assert( pExpr->op!=TK_LE || op==OP_Gt );
3693f2bc013cSdrh   assert( pExpr->op!=TK_GT || op==OP_Le );
3694f2bc013cSdrh   assert( pExpr->op!=TK_GE || op==OP_Lt );
3695f2bc013cSdrh 
3696cce7d176Sdrh   switch( pExpr->op ){
3697cce7d176Sdrh     case TK_AND: {
3698c5499befSdrh       testcase( jumpIfNull==0 );
36994adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
370054e2adb5Sdrh       sqlite3ExprCachePush(pParse);
37014adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
3702d2490904Sdrh       sqlite3ExprCachePop(pParse);
3703cce7d176Sdrh       break;
3704cce7d176Sdrh     }
3705cce7d176Sdrh     case TK_OR: {
37064adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
3707c5499befSdrh       testcase( jumpIfNull==0 );
370835573356Sdrh       sqlite3ExprIfTrue(pParse, pExpr->pLeft, d2, jumpIfNull^SQLITE_JUMPIFNULL);
370954e2adb5Sdrh       sqlite3ExprCachePush(pParse);
37104adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
37114adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
3712d2490904Sdrh       sqlite3ExprCachePop(pParse);
3713cce7d176Sdrh       break;
3714cce7d176Sdrh     }
3715cce7d176Sdrh     case TK_NOT: {
37165c03f30aSdrh       testcase( jumpIfNull==0 );
37174adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
3718cce7d176Sdrh       break;
3719cce7d176Sdrh     }
3720cce7d176Sdrh     case TK_LT:
3721cce7d176Sdrh     case TK_LE:
3722cce7d176Sdrh     case TK_GT:
3723cce7d176Sdrh     case TK_GE:
3724cce7d176Sdrh     case TK_NE:
3725cce7d176Sdrh     case TK_EQ: {
3726c5499befSdrh       testcase( jumpIfNull==0 );
3727b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3728b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
372935573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
37307d176105Sdrh                   r1, r2, dest, jumpIfNull);
37317d176105Sdrh       assert(TK_LT==OP_Lt); testcase(op==OP_Lt); VdbeCoverageIf(v,op==OP_Lt);
37327d176105Sdrh       assert(TK_LE==OP_Le); testcase(op==OP_Le); VdbeCoverageIf(v,op==OP_Le);
37337d176105Sdrh       assert(TK_GT==OP_Gt); testcase(op==OP_Gt); VdbeCoverageIf(v,op==OP_Gt);
37347d176105Sdrh       assert(TK_GE==OP_Ge); testcase(op==OP_Ge); VdbeCoverageIf(v,op==OP_Ge);
37357d176105Sdrh       assert(TK_EQ==OP_Eq); testcase(op==OP_Eq); VdbeCoverageIf(v,op==OP_Eq);
37367d176105Sdrh       assert(TK_NE==OP_Ne); testcase(op==OP_Ne); VdbeCoverageIf(v,op==OP_Ne);
3737c5499befSdrh       testcase( regFree1==0 );
3738c5499befSdrh       testcase( regFree2==0 );
3739cce7d176Sdrh       break;
3740cce7d176Sdrh     }
37416a2fe093Sdrh     case TK_IS:
37426a2fe093Sdrh     case TK_ISNOT: {
37436d4486aeSdrh       testcase( pExpr->op==TK_IS );
37446d4486aeSdrh       testcase( pExpr->op==TK_ISNOT );
3745b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3746b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
37476a2fe093Sdrh       op = (pExpr->op==TK_IS) ? TK_NE : TK_EQ;
37486a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
37497d176105Sdrh                   r1, r2, dest, SQLITE_NULLEQ);
37507d176105Sdrh       VdbeCoverageIf(v, op==TK_EQ);
37517d176105Sdrh       VdbeCoverageIf(v, op==TK_NE);
37526a2fe093Sdrh       testcase( regFree1==0 );
37536a2fe093Sdrh       testcase( regFree2==0 );
37546a2fe093Sdrh       break;
37556a2fe093Sdrh     }
3756cce7d176Sdrh     case TK_ISNULL:
3757cce7d176Sdrh     case TK_NOTNULL: {
37582dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
37597d176105Sdrh       sqlite3VdbeAddOp2(v, op, r1, dest);
37607d176105Sdrh       testcase( op==TK_ISNULL );   VdbeCoverageIf(v, op==TK_ISNULL);
37617d176105Sdrh       testcase( op==TK_NOTNULL );  VdbeCoverageIf(v, op==TK_NOTNULL);
3762c5499befSdrh       testcase( regFree1==0 );
3763cce7d176Sdrh       break;
3764cce7d176Sdrh     }
3765fef5208cSdrh     case TK_BETWEEN: {
37665c03f30aSdrh       testcase( jumpIfNull==0 );
376736c563a2Sdrh       exprCodeBetween(pParse, pExpr, dest, 0, jumpIfNull);
3768fef5208cSdrh       break;
3769fef5208cSdrh     }
3770bb201344Sshaneh #ifndef SQLITE_OMIT_SUBQUERY
3771e3365e6cSdrh     case TK_IN: {
3772e3365e6cSdrh       if( jumpIfNull ){
3773e3365e6cSdrh         sqlite3ExprCodeIN(pParse, pExpr, dest, dest);
3774e3365e6cSdrh       }else{
3775e3365e6cSdrh         int destIfNull = sqlite3VdbeMakeLabel(v);
3776e3365e6cSdrh         sqlite3ExprCodeIN(pParse, pExpr, dest, destIfNull);
3777e3365e6cSdrh         sqlite3VdbeResolveLabel(v, destIfNull);
3778e3365e6cSdrh       }
3779e3365e6cSdrh       break;
3780e3365e6cSdrh     }
3781bb201344Sshaneh #endif
3782cce7d176Sdrh     default: {
3783991a1985Sdrh       if( exprAlwaysFalse(pExpr) ){
3784991a1985Sdrh         sqlite3VdbeAddOp2(v, OP_Goto, 0, dest);
3785991a1985Sdrh       }else if( exprAlwaysTrue(pExpr) ){
3786991a1985Sdrh         /* no-op */
3787991a1985Sdrh       }else{
37882dcef11bSdrh         r1 = sqlite3ExprCodeTemp(pParse, pExpr, &regFree1);
37892dcef11bSdrh         sqlite3VdbeAddOp3(v, OP_IfNot, r1, dest, jumpIfNull!=0);
3790688852abSdrh         VdbeCoverage(v);
3791c5499befSdrh         testcase( regFree1==0 );
3792c5499befSdrh         testcase( jumpIfNull==0 );
3793991a1985Sdrh       }
3794cce7d176Sdrh       break;
3795cce7d176Sdrh     }
3796cce7d176Sdrh   }
37972dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
37982dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
3799cce7d176Sdrh }
38002282792aSdrh 
38012282792aSdrh /*
38021d9da70aSdrh ** Do a deep comparison of two expression trees.  Return 0 if the two
38031d9da70aSdrh ** expressions are completely identical.  Return 1 if they differ only
38041d9da70aSdrh ** by a COLLATE operator at the top level.  Return 2 if there are differences
38051d9da70aSdrh ** other than the top-level COLLATE operator.
3806d40aab0eSdrh **
3807619a1305Sdrh ** If any subelement of pB has Expr.iTable==(-1) then it is allowed
3808619a1305Sdrh ** to compare equal to an equivalent element in pA with Expr.iTable==iTab.
3809619a1305Sdrh **
381066518ca7Sdrh ** The pA side might be using TK_REGISTER.  If that is the case and pB is
381166518ca7Sdrh ** not using TK_REGISTER but is otherwise equivalent, then still return 0.
381266518ca7Sdrh **
38131d9da70aSdrh ** Sometimes this routine will return 2 even if the two expressions
3814d40aab0eSdrh ** really are equivalent.  If we cannot prove that the expressions are
38151d9da70aSdrh ** identical, we return 2 just to be safe.  So if this routine
38161d9da70aSdrh ** returns 2, then you do not really know for certain if the two
38171d9da70aSdrh ** expressions are the same.  But if you get a 0 or 1 return, then you
3818d40aab0eSdrh ** can be sure the expressions are the same.  In the places where
38191d9da70aSdrh ** this routine is used, it does not hurt to get an extra 2 - that
3820d40aab0eSdrh ** just might result in some slightly slower code.  But returning
38211d9da70aSdrh ** an incorrect 0 or 1 could lead to a malfunction.
38222282792aSdrh */
3823619a1305Sdrh int sqlite3ExprCompare(Expr *pA, Expr *pB, int iTab){
382410d1edf0Sdrh   u32 combinedFlags;
38254b202ae2Sdanielk1977   if( pA==0 || pB==0 ){
38261d9da70aSdrh     return pB==pA ? 0 : 2;
38272282792aSdrh   }
382810d1edf0Sdrh   combinedFlags = pA->flags | pB->flags;
382910d1edf0Sdrh   if( combinedFlags & EP_IntValue ){
383010d1edf0Sdrh     if( (pA->flags&pB->flags&EP_IntValue)!=0 && pA->u.iValue==pB->u.iValue ){
383110d1edf0Sdrh       return 0;
383210d1edf0Sdrh     }
38331d9da70aSdrh     return 2;
38346ab3a2ecSdanielk1977   }
3835c2acc4e4Sdrh   if( pA->op!=pB->op ){
3836619a1305Sdrh     if( pA->op==TK_COLLATE && sqlite3ExprCompare(pA->pLeft, pB, iTab)<2 ){
3837ae80ddeaSdrh       return 1;
3838ae80ddeaSdrh     }
3839619a1305Sdrh     if( pB->op==TK_COLLATE && sqlite3ExprCompare(pA, pB->pLeft, iTab)<2 ){
3840ae80ddeaSdrh       return 1;
3841ae80ddeaSdrh     }
3842ae80ddeaSdrh     return 2;
3843ae80ddeaSdrh   }
384410d1edf0Sdrh   if( pA->op!=TK_COLUMN && ALWAYS(pA->op!=TK_AGG_COLUMN) && pA->u.zToken ){
384510d1edf0Sdrh     if( strcmp(pA->u.zToken,pB->u.zToken)!=0 ){
384610d1edf0Sdrh       return pA->op==TK_COLLATE ? 1 : 2;
384710d1edf0Sdrh     }
384810d1edf0Sdrh   }
384910d1edf0Sdrh   if( (pA->flags & EP_Distinct)!=(pB->flags & EP_Distinct) ) return 2;
385085f8aa79Sdrh   if( ALWAYS((combinedFlags & EP_TokenOnly)==0) ){
385110d1edf0Sdrh     if( combinedFlags & EP_xIsSelect ) return 2;
3852619a1305Sdrh     if( sqlite3ExprCompare(pA->pLeft, pB->pLeft, iTab) ) return 2;
3853619a1305Sdrh     if( sqlite3ExprCompare(pA->pRight, pB->pRight, iTab) ) return 2;
3854619a1305Sdrh     if( sqlite3ExprListCompare(pA->x.pList, pB->x.pList, iTab) ) return 2;
385585f8aa79Sdrh     if( ALWAYS((combinedFlags & EP_Reduced)==0) ){
3856619a1305Sdrh       if( pA->iColumn!=pB->iColumn ) return 2;
385766518ca7Sdrh       if( pA->iTable!=pB->iTable
385885f8aa79Sdrh        && (pA->iTable!=iTab || NEVER(pB->iTable>=0)) ) return 2;
38591d9da70aSdrh     }
38601d9da70aSdrh   }
38612646da7eSdrh   return 0;
38622646da7eSdrh }
38632282792aSdrh 
38648c6f666bSdrh /*
38658c6f666bSdrh ** Compare two ExprList objects.  Return 0 if they are identical and
38668c6f666bSdrh ** non-zero if they differ in any way.
38678c6f666bSdrh **
3868619a1305Sdrh ** If any subelement of pB has Expr.iTable==(-1) then it is allowed
3869619a1305Sdrh ** to compare equal to an equivalent element in pA with Expr.iTable==iTab.
3870619a1305Sdrh **
38718c6f666bSdrh ** This routine might return non-zero for equivalent ExprLists.  The
38728c6f666bSdrh ** only consequence will be disabled optimizations.  But this routine
38738c6f666bSdrh ** must never return 0 if the two ExprList objects are different, or
38748c6f666bSdrh ** a malfunction will result.
38758c6f666bSdrh **
38768c6f666bSdrh ** Two NULL pointers are considered to be the same.  But a NULL pointer
38778c6f666bSdrh ** always differs from a non-NULL pointer.
38788c6f666bSdrh */
3879619a1305Sdrh int sqlite3ExprListCompare(ExprList *pA, ExprList *pB, int iTab){
38808c6f666bSdrh   int i;
38818c6f666bSdrh   if( pA==0 && pB==0 ) return 0;
38828c6f666bSdrh   if( pA==0 || pB==0 ) return 1;
38838c6f666bSdrh   if( pA->nExpr!=pB->nExpr ) return 1;
38848c6f666bSdrh   for(i=0; i<pA->nExpr; i++){
38858c6f666bSdrh     Expr *pExprA = pA->a[i].pExpr;
38868c6f666bSdrh     Expr *pExprB = pB->a[i].pExpr;
38878c6f666bSdrh     if( pA->a[i].sortOrder!=pB->a[i].sortOrder ) return 1;
3888619a1305Sdrh     if( sqlite3ExprCompare(pExprA, pExprB, iTab) ) return 1;
38898c6f666bSdrh   }
38908c6f666bSdrh   return 0;
38918c6f666bSdrh }
389213449892Sdrh 
38932282792aSdrh /*
38944bd5f73fSdrh ** Return true if we can prove the pE2 will always be true if pE1 is
38954bd5f73fSdrh ** true.  Return false if we cannot complete the proof or if pE2 might
38964bd5f73fSdrh ** be false.  Examples:
38974bd5f73fSdrh **
3898619a1305Sdrh **     pE1: x==5       pE2: x==5             Result: true
38994bd5f73fSdrh **     pE1: x>0        pE2: x==5             Result: false
3900619a1305Sdrh **     pE1: x=21       pE2: x=21 OR y=43     Result: true
39014bd5f73fSdrh **     pE1: x!=123     pE2: x IS NOT NULL    Result: true
3902619a1305Sdrh **     pE1: x!=?1      pE2: x IS NOT NULL    Result: true
3903619a1305Sdrh **     pE1: x IS NULL  pE2: x IS NOT NULL    Result: false
3904619a1305Sdrh **     pE1: x IS ?2    pE2: x IS NOT NULL    Reuslt: false
39054bd5f73fSdrh **
39064bd5f73fSdrh ** When comparing TK_COLUMN nodes between pE1 and pE2, if pE2 has
39074bd5f73fSdrh ** Expr.iTable<0 then assume a table number given by iTab.
39084bd5f73fSdrh **
39094bd5f73fSdrh ** When in doubt, return false.  Returning true might give a performance
39104bd5f73fSdrh ** improvement.  Returning false might cause a performance reduction, but
39114bd5f73fSdrh ** it will always give the correct answer and is hence always safe.
39124bd5f73fSdrh */
39134bd5f73fSdrh int sqlite3ExprImpliesExpr(Expr *pE1, Expr *pE2, int iTab){
3914619a1305Sdrh   if( sqlite3ExprCompare(pE1, pE2, iTab)==0 ){
3915619a1305Sdrh     return 1;
3916619a1305Sdrh   }
3917619a1305Sdrh   if( pE2->op==TK_OR
3918619a1305Sdrh    && (sqlite3ExprImpliesExpr(pE1, pE2->pLeft, iTab)
3919619a1305Sdrh              || sqlite3ExprImpliesExpr(pE1, pE2->pRight, iTab) )
3920619a1305Sdrh   ){
3921619a1305Sdrh     return 1;
3922619a1305Sdrh   }
3923619a1305Sdrh   if( pE2->op==TK_NOTNULL
3924619a1305Sdrh    && sqlite3ExprCompare(pE1->pLeft, pE2->pLeft, iTab)==0
3925619a1305Sdrh    && (pE1->op!=TK_ISNULL && pE1->op!=TK_IS)
3926619a1305Sdrh   ){
3927619a1305Sdrh     return 1;
3928619a1305Sdrh   }
3929619a1305Sdrh   return 0;
39304bd5f73fSdrh }
39314bd5f73fSdrh 
39324bd5f73fSdrh /*
3933030796dfSdrh ** An instance of the following structure is used by the tree walker
3934030796dfSdrh ** to count references to table columns in the arguments of an
3935ed551b95Sdrh ** aggregate function, in order to implement the
3936ed551b95Sdrh ** sqlite3FunctionThisSrc() routine.
3937374fdce4Sdrh */
3938030796dfSdrh struct SrcCount {
3939030796dfSdrh   SrcList *pSrc;   /* One particular FROM clause in a nested query */
3940030796dfSdrh   int nThis;       /* Number of references to columns in pSrcList */
3941030796dfSdrh   int nOther;      /* Number of references to columns in other FROM clauses */
3942030796dfSdrh };
3943030796dfSdrh 
3944030796dfSdrh /*
3945030796dfSdrh ** Count the number of references to columns.
3946030796dfSdrh */
3947030796dfSdrh static int exprSrcCount(Walker *pWalker, Expr *pExpr){
3948fb0a6081Sdrh   /* The NEVER() on the second term is because sqlite3FunctionUsesThisSrc()
3949fb0a6081Sdrh   ** is always called before sqlite3ExprAnalyzeAggregates() and so the
3950fb0a6081Sdrh   ** TK_COLUMNs have not yet been converted into TK_AGG_COLUMN.  If
3951fb0a6081Sdrh   ** sqlite3FunctionUsesThisSrc() is used differently in the future, the
3952fb0a6081Sdrh   ** NEVER() will need to be removed. */
3953fb0a6081Sdrh   if( pExpr->op==TK_COLUMN || NEVER(pExpr->op==TK_AGG_COLUMN) ){
3954374fdce4Sdrh     int i;
3955030796dfSdrh     struct SrcCount *p = pWalker->u.pSrcCount;
3956030796dfSdrh     SrcList *pSrc = p->pSrc;
3957374fdce4Sdrh     for(i=0; i<pSrc->nSrc; i++){
3958030796dfSdrh       if( pExpr->iTable==pSrc->a[i].iCursor ) break;
3959374fdce4Sdrh     }
3960030796dfSdrh     if( i<pSrc->nSrc ){
3961030796dfSdrh       p->nThis++;
3962374fdce4Sdrh     }else{
3963030796dfSdrh       p->nOther++;
3964374fdce4Sdrh     }
3965374fdce4Sdrh   }
3966030796dfSdrh   return WRC_Continue;
3967030796dfSdrh }
3968374fdce4Sdrh 
3969374fdce4Sdrh /*
3970030796dfSdrh ** Determine if any of the arguments to the pExpr Function reference
3971030796dfSdrh ** pSrcList.  Return true if they do.  Also return true if the function
3972030796dfSdrh ** has no arguments or has only constant arguments.  Return false if pExpr
3973030796dfSdrh ** references columns but not columns of tables found in pSrcList.
3974374fdce4Sdrh */
3975030796dfSdrh int sqlite3FunctionUsesThisSrc(Expr *pExpr, SrcList *pSrcList){
3976374fdce4Sdrh   Walker w;
3977030796dfSdrh   struct SrcCount cnt;
3978374fdce4Sdrh   assert( pExpr->op==TK_AGG_FUNCTION );
3979374fdce4Sdrh   memset(&w, 0, sizeof(w));
3980030796dfSdrh   w.xExprCallback = exprSrcCount;
3981030796dfSdrh   w.u.pSrcCount = &cnt;
3982030796dfSdrh   cnt.pSrc = pSrcList;
3983030796dfSdrh   cnt.nThis = 0;
3984030796dfSdrh   cnt.nOther = 0;
3985030796dfSdrh   sqlite3WalkExprList(&w, pExpr->x.pList);
3986030796dfSdrh   return cnt.nThis>0 || cnt.nOther==0;
3987374fdce4Sdrh }
3988374fdce4Sdrh 
3989374fdce4Sdrh /*
399013449892Sdrh ** Add a new element to the pAggInfo->aCol[] array.  Return the index of
399113449892Sdrh ** the new element.  Return a negative number if malloc fails.
39922282792aSdrh */
399317435752Sdrh static int addAggInfoColumn(sqlite3 *db, AggInfo *pInfo){
399413449892Sdrh   int i;
3995cf643729Sdrh   pInfo->aCol = sqlite3ArrayAllocate(
399617435752Sdrh        db,
3997cf643729Sdrh        pInfo->aCol,
3998cf643729Sdrh        sizeof(pInfo->aCol[0]),
3999cf643729Sdrh        &pInfo->nColumn,
4000cf643729Sdrh        &i
4001cf643729Sdrh   );
400213449892Sdrh   return i;
40032282792aSdrh }
400413449892Sdrh 
400513449892Sdrh /*
400613449892Sdrh ** Add a new element to the pAggInfo->aFunc[] array.  Return the index of
400713449892Sdrh ** the new element.  Return a negative number if malloc fails.
400813449892Sdrh */
400917435752Sdrh static int addAggInfoFunc(sqlite3 *db, AggInfo *pInfo){
401013449892Sdrh   int i;
4011cf643729Sdrh   pInfo->aFunc = sqlite3ArrayAllocate(
401217435752Sdrh        db,
4013cf643729Sdrh        pInfo->aFunc,
4014cf643729Sdrh        sizeof(pInfo->aFunc[0]),
4015cf643729Sdrh        &pInfo->nFunc,
4016cf643729Sdrh        &i
4017cf643729Sdrh   );
401813449892Sdrh   return i;
40192282792aSdrh }
40202282792aSdrh 
40212282792aSdrh /*
40227d10d5a6Sdrh ** This is the xExprCallback for a tree walker.  It is used to
40237d10d5a6Sdrh ** implement sqlite3ExprAnalyzeAggregates().  See sqlite3ExprAnalyzeAggregates
4024626a879aSdrh ** for additional information.
40252282792aSdrh */
40267d10d5a6Sdrh static int analyzeAggregate(Walker *pWalker, Expr *pExpr){
40272282792aSdrh   int i;
40287d10d5a6Sdrh   NameContext *pNC = pWalker->u.pNC;
4029a58fdfb1Sdanielk1977   Parse *pParse = pNC->pParse;
4030a58fdfb1Sdanielk1977   SrcList *pSrcList = pNC->pSrcList;
403113449892Sdrh   AggInfo *pAggInfo = pNC->pAggInfo;
403213449892Sdrh 
40332282792aSdrh   switch( pExpr->op ){
403489c69d00Sdrh     case TK_AGG_COLUMN:
4035967e8b73Sdrh     case TK_COLUMN: {
40368b213899Sdrh       testcase( pExpr->op==TK_AGG_COLUMN );
40378b213899Sdrh       testcase( pExpr->op==TK_COLUMN );
403813449892Sdrh       /* Check to see if the column is in one of the tables in the FROM
403913449892Sdrh       ** clause of the aggregate query */
404020bc393cSdrh       if( ALWAYS(pSrcList!=0) ){
404113449892Sdrh         struct SrcList_item *pItem = pSrcList->a;
404213449892Sdrh         for(i=0; i<pSrcList->nSrc; i++, pItem++){
404313449892Sdrh           struct AggInfo_col *pCol;
4044c5cd1249Sdrh           assert( !ExprHasProperty(pExpr, EP_TokenOnly|EP_Reduced) );
404513449892Sdrh           if( pExpr->iTable==pItem->iCursor ){
404613449892Sdrh             /* If we reach this point, it means that pExpr refers to a table
404713449892Sdrh             ** that is in the FROM clause of the aggregate query.
404813449892Sdrh             **
404913449892Sdrh             ** Make an entry for the column in pAggInfo->aCol[] if there
405013449892Sdrh             ** is not an entry there already.
405113449892Sdrh             */
40527f906d63Sdrh             int k;
405313449892Sdrh             pCol = pAggInfo->aCol;
40547f906d63Sdrh             for(k=0; k<pAggInfo->nColumn; k++, pCol++){
405513449892Sdrh               if( pCol->iTable==pExpr->iTable &&
405613449892Sdrh                   pCol->iColumn==pExpr->iColumn ){
40572282792aSdrh                 break;
40582282792aSdrh               }
40592282792aSdrh             }
40601e536953Sdanielk1977             if( (k>=pAggInfo->nColumn)
40611e536953Sdanielk1977              && (k = addAggInfoColumn(pParse->db, pAggInfo))>=0
40621e536953Sdanielk1977             ){
40637f906d63Sdrh               pCol = &pAggInfo->aCol[k];
40640817d0dfSdanielk1977               pCol->pTab = pExpr->pTab;
406513449892Sdrh               pCol->iTable = pExpr->iTable;
406613449892Sdrh               pCol->iColumn = pExpr->iColumn;
40670a07c107Sdrh               pCol->iMem = ++pParse->nMem;
406813449892Sdrh               pCol->iSorterColumn = -1;
40695774b806Sdrh               pCol->pExpr = pExpr;
407013449892Sdrh               if( pAggInfo->pGroupBy ){
407113449892Sdrh                 int j, n;
407213449892Sdrh                 ExprList *pGB = pAggInfo->pGroupBy;
407313449892Sdrh                 struct ExprList_item *pTerm = pGB->a;
407413449892Sdrh                 n = pGB->nExpr;
407513449892Sdrh                 for(j=0; j<n; j++, pTerm++){
407613449892Sdrh                   Expr *pE = pTerm->pExpr;
407713449892Sdrh                   if( pE->op==TK_COLUMN && pE->iTable==pExpr->iTable &&
407813449892Sdrh                       pE->iColumn==pExpr->iColumn ){
407913449892Sdrh                     pCol->iSorterColumn = j;
408013449892Sdrh                     break;
40812282792aSdrh                   }
408213449892Sdrh                 }
408313449892Sdrh               }
408413449892Sdrh               if( pCol->iSorterColumn<0 ){
408513449892Sdrh                 pCol->iSorterColumn = pAggInfo->nSortingColumn++;
408613449892Sdrh               }
408713449892Sdrh             }
408813449892Sdrh             /* There is now an entry for pExpr in pAggInfo->aCol[] (either
408913449892Sdrh             ** because it was there before or because we just created it).
409013449892Sdrh             ** Convert the pExpr to be a TK_AGG_COLUMN referring to that
409113449892Sdrh             ** pAggInfo->aCol[] entry.
409213449892Sdrh             */
4093ebb6a65dSdrh             ExprSetVVAProperty(pExpr, EP_NoReduce);
409413449892Sdrh             pExpr->pAggInfo = pAggInfo;
409513449892Sdrh             pExpr->op = TK_AGG_COLUMN;
4096cf697396Sshane             pExpr->iAgg = (i16)k;
409713449892Sdrh             break;
409813449892Sdrh           } /* endif pExpr->iTable==pItem->iCursor */
409913449892Sdrh         } /* end loop over pSrcList */
4100a58fdfb1Sdanielk1977       }
41017d10d5a6Sdrh       return WRC_Prune;
41022282792aSdrh     }
41032282792aSdrh     case TK_AGG_FUNCTION: {
41043a8c4be7Sdrh       if( (pNC->ncFlags & NC_InAggFunc)==0
4105ed551b95Sdrh        && pWalker->walkerDepth==pExpr->op2
41063a8c4be7Sdrh       ){
410713449892Sdrh         /* Check to see if pExpr is a duplicate of another aggregate
410813449892Sdrh         ** function that is already in the pAggInfo structure
410913449892Sdrh         */
411013449892Sdrh         struct AggInfo_func *pItem = pAggInfo->aFunc;
411113449892Sdrh         for(i=0; i<pAggInfo->nFunc; i++, pItem++){
4112619a1305Sdrh           if( sqlite3ExprCompare(pItem->pExpr, pExpr, -1)==0 ){
41132282792aSdrh             break;
41142282792aSdrh           }
41152282792aSdrh         }
411613449892Sdrh         if( i>=pAggInfo->nFunc ){
411713449892Sdrh           /* pExpr is original.  Make a new entry in pAggInfo->aFunc[]
411813449892Sdrh           */
411914db2665Sdanielk1977           u8 enc = ENC(pParse->db);
41201e536953Sdanielk1977           i = addAggInfoFunc(pParse->db, pAggInfo);
412113449892Sdrh           if( i>=0 ){
41226ab3a2ecSdanielk1977             assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
412313449892Sdrh             pItem = &pAggInfo->aFunc[i];
412413449892Sdrh             pItem->pExpr = pExpr;
41250a07c107Sdrh             pItem->iMem = ++pParse->nMem;
412633e619fcSdrh             assert( !ExprHasProperty(pExpr, EP_IntValue) );
412713449892Sdrh             pItem->pFunc = sqlite3FindFunction(pParse->db,
412833e619fcSdrh                    pExpr->u.zToken, sqlite3Strlen30(pExpr->u.zToken),
41296ab3a2ecSdanielk1977                    pExpr->x.pList ? pExpr->x.pList->nExpr : 0, enc, 0);
4130fd357974Sdrh             if( pExpr->flags & EP_Distinct ){
4131fd357974Sdrh               pItem->iDistinct = pParse->nTab++;
4132fd357974Sdrh             }else{
4133fd357974Sdrh               pItem->iDistinct = -1;
4134fd357974Sdrh             }
41352282792aSdrh           }
413613449892Sdrh         }
413713449892Sdrh         /* Make pExpr point to the appropriate pAggInfo->aFunc[] entry
413813449892Sdrh         */
4139c5cd1249Sdrh         assert( !ExprHasProperty(pExpr, EP_TokenOnly|EP_Reduced) );
4140ebb6a65dSdrh         ExprSetVVAProperty(pExpr, EP_NoReduce);
4141cf697396Sshane         pExpr->iAgg = (i16)i;
414213449892Sdrh         pExpr->pAggInfo = pAggInfo;
41433a8c4be7Sdrh         return WRC_Prune;
41446e83a57fSdrh       }else{
41456e83a57fSdrh         return WRC_Continue;
41466e83a57fSdrh       }
41472282792aSdrh     }
4148a58fdfb1Sdanielk1977   }
41497d10d5a6Sdrh   return WRC_Continue;
41507d10d5a6Sdrh }
41517d10d5a6Sdrh static int analyzeAggregatesInSelect(Walker *pWalker, Select *pSelect){
4152d5a336efSdrh   UNUSED_PARAMETER(pWalker);
4153d5a336efSdrh   UNUSED_PARAMETER(pSelect);
41547d10d5a6Sdrh   return WRC_Continue;
4155a58fdfb1Sdanielk1977 }
4156626a879aSdrh 
4157626a879aSdrh /*
4158e8abb4caSdrh ** Analyze the pExpr expression looking for aggregate functions and
4159e8abb4caSdrh ** for variables that need to be added to AggInfo object that pNC->pAggInfo
4160e8abb4caSdrh ** points to.  Additional entries are made on the AggInfo object as
4161e8abb4caSdrh ** necessary.
4162626a879aSdrh **
4163626a879aSdrh ** This routine should only be called after the expression has been
41647d10d5a6Sdrh ** analyzed by sqlite3ResolveExprNames().
4165626a879aSdrh */
4166d2b3e23bSdrh void sqlite3ExprAnalyzeAggregates(NameContext *pNC, Expr *pExpr){
41677d10d5a6Sdrh   Walker w;
4168374fdce4Sdrh   memset(&w, 0, sizeof(w));
41697d10d5a6Sdrh   w.xExprCallback = analyzeAggregate;
41707d10d5a6Sdrh   w.xSelectCallback = analyzeAggregatesInSelect;
41717d10d5a6Sdrh   w.u.pNC = pNC;
417220bc393cSdrh   assert( pNC->pSrcList!=0 );
41737d10d5a6Sdrh   sqlite3WalkExpr(&w, pExpr);
41742282792aSdrh }
41755d9a4af9Sdrh 
41765d9a4af9Sdrh /*
41775d9a4af9Sdrh ** Call sqlite3ExprAnalyzeAggregates() for every expression in an
41785d9a4af9Sdrh ** expression list.  Return the number of errors.
41795d9a4af9Sdrh **
41805d9a4af9Sdrh ** If an error is found, the analysis is cut short.
41815d9a4af9Sdrh */
4182d2b3e23bSdrh void sqlite3ExprAnalyzeAggList(NameContext *pNC, ExprList *pList){
41835d9a4af9Sdrh   struct ExprList_item *pItem;
41845d9a4af9Sdrh   int i;
41855d9a4af9Sdrh   if( pList ){
4186d2b3e23bSdrh     for(pItem=pList->a, i=0; i<pList->nExpr; i++, pItem++){
4187d2b3e23bSdrh       sqlite3ExprAnalyzeAggregates(pNC, pItem->pExpr);
41885d9a4af9Sdrh     }
41895d9a4af9Sdrh   }
41905d9a4af9Sdrh }
4191892d3179Sdrh 
4192892d3179Sdrh /*
4193ceea3321Sdrh ** Allocate a single new register for use to hold some intermediate result.
4194892d3179Sdrh */
4195892d3179Sdrh int sqlite3GetTempReg(Parse *pParse){
4196e55cbd72Sdrh   if( pParse->nTempReg==0 ){
4197892d3179Sdrh     return ++pParse->nMem;
4198892d3179Sdrh   }
41992f425f6bSdanielk1977   return pParse->aTempReg[--pParse->nTempReg];
4200892d3179Sdrh }
4201ceea3321Sdrh 
4202ceea3321Sdrh /*
4203ceea3321Sdrh ** Deallocate a register, making available for reuse for some other
4204ceea3321Sdrh ** purpose.
4205ceea3321Sdrh **
4206ceea3321Sdrh ** If a register is currently being used by the column cache, then
4207ceea3321Sdrh ** the dallocation is deferred until the column cache line that uses
4208ceea3321Sdrh ** the register becomes stale.
4209ceea3321Sdrh */
4210892d3179Sdrh void sqlite3ReleaseTempReg(Parse *pParse, int iReg){
42112dcef11bSdrh   if( iReg && pParse->nTempReg<ArraySize(pParse->aTempReg) ){
4212ceea3321Sdrh     int i;
4213ceea3321Sdrh     struct yColCache *p;
4214ceea3321Sdrh     for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
4215ceea3321Sdrh       if( p->iReg==iReg ){
4216ceea3321Sdrh         p->tempReg = 1;
4217ceea3321Sdrh         return;
4218ceea3321Sdrh       }
4219ceea3321Sdrh     }
4220892d3179Sdrh     pParse->aTempReg[pParse->nTempReg++] = iReg;
4221892d3179Sdrh   }
4222892d3179Sdrh }
4223892d3179Sdrh 
4224892d3179Sdrh /*
4225892d3179Sdrh ** Allocate or deallocate a block of nReg consecutive registers
4226892d3179Sdrh */
4227892d3179Sdrh int sqlite3GetTempRange(Parse *pParse, int nReg){
4228e55cbd72Sdrh   int i, n;
4229892d3179Sdrh   i = pParse->iRangeReg;
4230e55cbd72Sdrh   n = pParse->nRangeReg;
4231f49f3523Sdrh   if( nReg<=n ){
4232f49f3523Sdrh     assert( !usedAsColumnCache(pParse, i, i+n-1) );
4233892d3179Sdrh     pParse->iRangeReg += nReg;
4234892d3179Sdrh     pParse->nRangeReg -= nReg;
4235892d3179Sdrh   }else{
4236892d3179Sdrh     i = pParse->nMem+1;
4237892d3179Sdrh     pParse->nMem += nReg;
4238892d3179Sdrh   }
4239892d3179Sdrh   return i;
4240892d3179Sdrh }
4241892d3179Sdrh void sqlite3ReleaseTempRange(Parse *pParse, int iReg, int nReg){
4242f49f3523Sdrh   sqlite3ExprCacheRemove(pParse, iReg, nReg);
4243892d3179Sdrh   if( nReg>pParse->nRangeReg ){
4244892d3179Sdrh     pParse->nRangeReg = nReg;
4245892d3179Sdrh     pParse->iRangeReg = iReg;
4246892d3179Sdrh   }
4247892d3179Sdrh }
4248cdc69557Sdrh 
4249cdc69557Sdrh /*
4250cdc69557Sdrh ** Mark all temporary registers as being unavailable for reuse.
4251cdc69557Sdrh */
4252cdc69557Sdrh void sqlite3ClearTempRegCache(Parse *pParse){
4253cdc69557Sdrh   pParse->nTempReg = 0;
4254cdc69557Sdrh   pParse->nRangeReg = 0;
4255cdc69557Sdrh }
4256