xref: /sqlite-3.40.0/src/expr.c (revision 094430eb)
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){
34487e262fSdrh   int op = pExpr->op;
35487e262fSdrh   if( op==TK_SELECT ){
366ab3a2ecSdanielk1977     assert( pExpr->flags&EP_xIsSelect );
376ab3a2ecSdanielk1977     return sqlite3ExprAffinity(pExpr->x.pSelect->pEList->a[0].pExpr);
38a37cdde0Sdanielk1977   }
39487e262fSdrh #ifndef SQLITE_OMIT_CAST
40487e262fSdrh   if( op==TK_CAST ){
4133e619fcSdrh     assert( !ExprHasProperty(pExpr, EP_IntValue) );
4233e619fcSdrh     return sqlite3AffinityType(pExpr->u.zToken);
43487e262fSdrh   }
44487e262fSdrh #endif
45259a455fSdanielk1977   if( (op==TK_AGG_COLUMN || op==TK_COLUMN || op==TK_REGISTER)
46259a455fSdanielk1977    && pExpr->pTab!=0
47259a455fSdanielk1977   ){
487d10d5a6Sdrh     /* op==TK_REGISTER && pExpr->pTab!=0 happens when pExpr was originally
497d10d5a6Sdrh     ** a TK_COLUMN but was previously evaluated and cached in a register */
507d10d5a6Sdrh     int j = pExpr->iColumn;
517d10d5a6Sdrh     if( j<0 ) return SQLITE_AFF_INTEGER;
527d10d5a6Sdrh     assert( pExpr->pTab && j<pExpr->pTab->nCol );
537d10d5a6Sdrh     return pExpr->pTab->aCol[j].affinity;
547d10d5a6Sdrh   }
55a37cdde0Sdanielk1977   return pExpr->affinity;
56a37cdde0Sdanielk1977 }
57a37cdde0Sdanielk1977 
5853db1458Sdrh /*
598b4c40d8Sdrh ** Set the collating sequence for expression pExpr to be the collating
608b4c40d8Sdrh ** sequence named by pToken.   Return a pointer to the revised expression.
61a34001c9Sdrh ** The collating sequence is marked as "explicit" using the EP_ExpCollate
62a34001c9Sdrh ** flag.  An explicit collating sequence will override implicit
63a34001c9Sdrh ** collating sequences.
648b4c40d8Sdrh */
657d10d5a6Sdrh Expr *sqlite3ExprSetColl(Parse *pParse, Expr *pExpr, Token *pCollName){
6639002505Sdanielk1977   char *zColl = 0;            /* Dequoted name of collation sequence */
678b4c40d8Sdrh   CollSeq *pColl;
68633e6d57Sdrh   sqlite3 *db = pParse->db;
697d10d5a6Sdrh   zColl = sqlite3NameFromToken(db, pCollName);
7039002505Sdanielk1977   if( pExpr && zColl ){
71c4a64facSdrh     pColl = sqlite3LocateCollSeq(pParse, zColl);
728b4c40d8Sdrh     if( pColl ){
738b4c40d8Sdrh       pExpr->pColl = pColl;
748b4c40d8Sdrh       pExpr->flags |= EP_ExpCollate;
758b4c40d8Sdrh     }
7639002505Sdanielk1977   }
77633e6d57Sdrh   sqlite3DbFree(db, zColl);
788b4c40d8Sdrh   return pExpr;
798b4c40d8Sdrh }
808b4c40d8Sdrh 
818b4c40d8Sdrh /*
820202b29eSdanielk1977 ** Return the default collation sequence for the expression pExpr. If
830202b29eSdanielk1977 ** there is no default collation type, return 0.
840202b29eSdanielk1977 */
857cedc8d4Sdanielk1977 CollSeq *sqlite3ExprCollSeq(Parse *pParse, Expr *pExpr){
867cedc8d4Sdanielk1977   CollSeq *pColl = 0;
877d10d5a6Sdrh   Expr *p = pExpr;
8851f49f17Sdrh   while( ALWAYS(p) ){
897e09fe0bSdrh     int op;
907d10d5a6Sdrh     pColl = p->pColl;
917d10d5a6Sdrh     if( pColl ) break;
927d10d5a6Sdrh     op = p->op;
9376d462eeSdan     if( p->pTab!=0 && (
9476d462eeSdan         op==TK_AGG_COLUMN || op==TK_COLUMN || op==TK_REGISTER || op==TK_TRIGGER
9576d462eeSdan     )){
967d10d5a6Sdrh       /* op==TK_REGISTER && p->pTab!=0 happens when pExpr was originally
977d10d5a6Sdrh       ** a TK_COLUMN but was previously evaluated and cached in a register */
987d10d5a6Sdrh       const char *zColl;
997d10d5a6Sdrh       int j = p->iColumn;
1007d10d5a6Sdrh       if( j>=0 ){
1017d10d5a6Sdrh         sqlite3 *db = pParse->db;
1027d10d5a6Sdrh         zColl = p->pTab->aCol[j].zColl;
103c4a64facSdrh         pColl = sqlite3FindCollSeq(db, ENC(db), zColl, 0);
1047d10d5a6Sdrh         pExpr->pColl = pColl;
1050202b29eSdanielk1977       }
1067d10d5a6Sdrh       break;
1077d10d5a6Sdrh     }
1087d10d5a6Sdrh     if( op!=TK_CAST && op!=TK_UPLUS ){
1097d10d5a6Sdrh       break;
1107d10d5a6Sdrh     }
1117d10d5a6Sdrh     p = p->pLeft;
1120202b29eSdanielk1977   }
1137cedc8d4Sdanielk1977   if( sqlite3CheckCollSeq(pParse, pColl) ){
1147cedc8d4Sdanielk1977     pColl = 0;
1157cedc8d4Sdanielk1977   }
1167cedc8d4Sdanielk1977   return pColl;
1170202b29eSdanielk1977 }
1180202b29eSdanielk1977 
1190202b29eSdanielk1977 /*
120626a879aSdrh ** pExpr is an operand of a comparison operator.  aff2 is the
121626a879aSdrh ** type affinity of the other operand.  This routine returns the
12253db1458Sdrh ** type affinity that should be used for the comparison operator.
12353db1458Sdrh */
124e014a838Sdanielk1977 char sqlite3CompareAffinity(Expr *pExpr, char aff2){
125bf3b721fSdanielk1977   char aff1 = sqlite3ExprAffinity(pExpr);
126e014a838Sdanielk1977   if( aff1 && aff2 ){
1278df447f0Sdrh     /* Both sides of the comparison are columns. If one has numeric
1288df447f0Sdrh     ** affinity, use that. Otherwise use no affinity.
129e014a838Sdanielk1977     */
1308a51256cSdrh     if( sqlite3IsNumericAffinity(aff1) || sqlite3IsNumericAffinity(aff2) ){
131e014a838Sdanielk1977       return SQLITE_AFF_NUMERIC;
132e014a838Sdanielk1977     }else{
133e014a838Sdanielk1977       return SQLITE_AFF_NONE;
134e014a838Sdanielk1977     }
135e014a838Sdanielk1977   }else if( !aff1 && !aff2 ){
1365f6a87b3Sdrh     /* Neither side of the comparison is a column.  Compare the
1375f6a87b3Sdrh     ** results directly.
138e014a838Sdanielk1977     */
1395f6a87b3Sdrh     return SQLITE_AFF_NONE;
140e014a838Sdanielk1977   }else{
141e014a838Sdanielk1977     /* One side is a column, the other is not. Use the columns affinity. */
142fe05af87Sdrh     assert( aff1==0 || aff2==0 );
143e014a838Sdanielk1977     return (aff1 + aff2);
144e014a838Sdanielk1977   }
145e014a838Sdanielk1977 }
146e014a838Sdanielk1977 
14753db1458Sdrh /*
14853db1458Sdrh ** pExpr is a comparison operator.  Return the type affinity that should
14953db1458Sdrh ** be applied to both operands prior to doing the comparison.
15053db1458Sdrh */
151e014a838Sdanielk1977 static char comparisonAffinity(Expr *pExpr){
152e014a838Sdanielk1977   char aff;
153e014a838Sdanielk1977   assert( pExpr->op==TK_EQ || pExpr->op==TK_IN || pExpr->op==TK_LT ||
154e014a838Sdanielk1977           pExpr->op==TK_GT || pExpr->op==TK_GE || pExpr->op==TK_LE ||
1556a2fe093Sdrh           pExpr->op==TK_NE || pExpr->op==TK_IS || pExpr->op==TK_ISNOT );
156e014a838Sdanielk1977   assert( pExpr->pLeft );
157bf3b721fSdanielk1977   aff = sqlite3ExprAffinity(pExpr->pLeft);
158e014a838Sdanielk1977   if( pExpr->pRight ){
159e014a838Sdanielk1977     aff = sqlite3CompareAffinity(pExpr->pRight, aff);
1606ab3a2ecSdanielk1977   }else if( ExprHasProperty(pExpr, EP_xIsSelect) ){
1616ab3a2ecSdanielk1977     aff = sqlite3CompareAffinity(pExpr->x.pSelect->pEList->a[0].pExpr, aff);
1626ab3a2ecSdanielk1977   }else if( !aff ){
163de087bd5Sdrh     aff = SQLITE_AFF_NONE;
164e014a838Sdanielk1977   }
165e014a838Sdanielk1977   return aff;
166e014a838Sdanielk1977 }
167e014a838Sdanielk1977 
168e014a838Sdanielk1977 /*
169e014a838Sdanielk1977 ** pExpr is a comparison expression, eg. '=', '<', IN(...) etc.
170e014a838Sdanielk1977 ** idx_affinity is the affinity of an indexed column. Return true
171e014a838Sdanielk1977 ** if the index with affinity idx_affinity may be used to implement
172e014a838Sdanielk1977 ** the comparison in pExpr.
173e014a838Sdanielk1977 */
174e014a838Sdanielk1977 int sqlite3IndexAffinityOk(Expr *pExpr, char idx_affinity){
175e014a838Sdanielk1977   char aff = comparisonAffinity(pExpr);
1768a51256cSdrh   switch( aff ){
1778a51256cSdrh     case SQLITE_AFF_NONE:
1788a51256cSdrh       return 1;
1798a51256cSdrh     case SQLITE_AFF_TEXT:
1808a51256cSdrh       return idx_affinity==SQLITE_AFF_TEXT;
1818a51256cSdrh     default:
1828a51256cSdrh       return sqlite3IsNumericAffinity(idx_affinity);
1838a51256cSdrh   }
184e014a838Sdanielk1977 }
185e014a838Sdanielk1977 
186a37cdde0Sdanielk1977 /*
18735573356Sdrh ** Return the P5 value that should be used for a binary comparison
188a37cdde0Sdanielk1977 ** opcode (OP_Eq, OP_Ge etc.) used to compare pExpr1 and pExpr2.
189a37cdde0Sdanielk1977 */
19035573356Sdrh static u8 binaryCompareP5(Expr *pExpr1, Expr *pExpr2, int jumpIfNull){
19135573356Sdrh   u8 aff = (char)sqlite3ExprAffinity(pExpr2);
1921bd10f8aSdrh   aff = (u8)sqlite3CompareAffinity(pExpr1, aff) | (u8)jumpIfNull;
19335573356Sdrh   return aff;
194a37cdde0Sdanielk1977 }
195a37cdde0Sdanielk1977 
196a2e00042Sdrh /*
1970202b29eSdanielk1977 ** Return a pointer to the collation sequence that should be used by
1980202b29eSdanielk1977 ** a binary comparison operator comparing pLeft and pRight.
1990202b29eSdanielk1977 **
2000202b29eSdanielk1977 ** If the left hand expression has a collating sequence type, then it is
2010202b29eSdanielk1977 ** used. Otherwise the collation sequence for the right hand expression
2020202b29eSdanielk1977 ** is used, or the default (BINARY) if neither expression has a collating
2030202b29eSdanielk1977 ** type.
204bcbb04e5Sdanielk1977 **
205bcbb04e5Sdanielk1977 ** Argument pRight (but not pLeft) may be a null pointer. In this case,
206bcbb04e5Sdanielk1977 ** it is not considered.
2070202b29eSdanielk1977 */
208bcbb04e5Sdanielk1977 CollSeq *sqlite3BinaryCompareCollSeq(
209bcbb04e5Sdanielk1977   Parse *pParse,
210bcbb04e5Sdanielk1977   Expr *pLeft,
211bcbb04e5Sdanielk1977   Expr *pRight
212bcbb04e5Sdanielk1977 ){
213ec41ddacSdrh   CollSeq *pColl;
214ec41ddacSdrh   assert( pLeft );
215ec41ddacSdrh   if( pLeft->flags & EP_ExpCollate ){
216ec41ddacSdrh     assert( pLeft->pColl );
217ec41ddacSdrh     pColl = pLeft->pColl;
218bcbb04e5Sdanielk1977   }else if( pRight && pRight->flags & EP_ExpCollate ){
219ec41ddacSdrh     assert( pRight->pColl );
220ec41ddacSdrh     pColl = pRight->pColl;
221ec41ddacSdrh   }else{
222ec41ddacSdrh     pColl = sqlite3ExprCollSeq(pParse, pLeft);
2230202b29eSdanielk1977     if( !pColl ){
2247cedc8d4Sdanielk1977       pColl = sqlite3ExprCollSeq(pParse, pRight);
2250202b29eSdanielk1977     }
226ec41ddacSdrh   }
2270202b29eSdanielk1977   return pColl;
2280202b29eSdanielk1977 }
2290202b29eSdanielk1977 
2300202b29eSdanielk1977 /*
231be5c89acSdrh ** Generate code for a comparison operator.
232be5c89acSdrh */
233be5c89acSdrh static int codeCompare(
234be5c89acSdrh   Parse *pParse,    /* The parsing (and code generating) context */
235be5c89acSdrh   Expr *pLeft,      /* The left operand */
236be5c89acSdrh   Expr *pRight,     /* The right operand */
237be5c89acSdrh   int opcode,       /* The comparison opcode */
23835573356Sdrh   int in1, int in2, /* Register holding operands */
239be5c89acSdrh   int dest,         /* Jump here if true.  */
240be5c89acSdrh   int jumpIfNull    /* If true, jump if either operand is NULL */
241be5c89acSdrh ){
24235573356Sdrh   int p5;
24335573356Sdrh   int addr;
24435573356Sdrh   CollSeq *p4;
24535573356Sdrh 
24635573356Sdrh   p4 = sqlite3BinaryCompareCollSeq(pParse, pLeft, pRight);
24735573356Sdrh   p5 = binaryCompareP5(pLeft, pRight, jumpIfNull);
24835573356Sdrh   addr = sqlite3VdbeAddOp4(pParse->pVdbe, opcode, in2, dest, in1,
24935573356Sdrh                            (void*)p4, P4_COLLSEQ);
2501bd10f8aSdrh   sqlite3VdbeChangeP5(pParse->pVdbe, (u8)p5);
25135573356Sdrh   return addr;
252be5c89acSdrh }
253be5c89acSdrh 
2544b5255acSdanielk1977 #if SQLITE_MAX_EXPR_DEPTH>0
2554b5255acSdanielk1977 /*
2564b5255acSdanielk1977 ** Check that argument nHeight is less than or equal to the maximum
2574b5255acSdanielk1977 ** expression depth allowed. If it is not, leave an error message in
2584b5255acSdanielk1977 ** pParse.
2594b5255acSdanielk1977 */
2607d10d5a6Sdrh int sqlite3ExprCheckHeight(Parse *pParse, int nHeight){
2614b5255acSdanielk1977   int rc = SQLITE_OK;
2624b5255acSdanielk1977   int mxHeight = pParse->db->aLimit[SQLITE_LIMIT_EXPR_DEPTH];
2634b5255acSdanielk1977   if( nHeight>mxHeight ){
2644b5255acSdanielk1977     sqlite3ErrorMsg(pParse,
2654b5255acSdanielk1977        "Expression tree is too large (maximum depth %d)", mxHeight
2664b5255acSdanielk1977     );
2674b5255acSdanielk1977     rc = SQLITE_ERROR;
2684b5255acSdanielk1977   }
2694b5255acSdanielk1977   return rc;
2704b5255acSdanielk1977 }
2714b5255acSdanielk1977 
2724b5255acSdanielk1977 /* The following three functions, heightOfExpr(), heightOfExprList()
2734b5255acSdanielk1977 ** and heightOfSelect(), are used to determine the maximum height
2744b5255acSdanielk1977 ** of any expression tree referenced by the structure passed as the
2754b5255acSdanielk1977 ** first argument.
2764b5255acSdanielk1977 **
2774b5255acSdanielk1977 ** If this maximum height is greater than the current value pointed
2784b5255acSdanielk1977 ** to by pnHeight, the second parameter, then set *pnHeight to that
2794b5255acSdanielk1977 ** value.
2804b5255acSdanielk1977 */
2814b5255acSdanielk1977 static void heightOfExpr(Expr *p, int *pnHeight){
2824b5255acSdanielk1977   if( p ){
2834b5255acSdanielk1977     if( p->nHeight>*pnHeight ){
2844b5255acSdanielk1977       *pnHeight = p->nHeight;
2854b5255acSdanielk1977     }
2864b5255acSdanielk1977   }
2874b5255acSdanielk1977 }
2884b5255acSdanielk1977 static void heightOfExprList(ExprList *p, int *pnHeight){
2894b5255acSdanielk1977   if( p ){
2904b5255acSdanielk1977     int i;
2914b5255acSdanielk1977     for(i=0; i<p->nExpr; i++){
2924b5255acSdanielk1977       heightOfExpr(p->a[i].pExpr, pnHeight);
2934b5255acSdanielk1977     }
2944b5255acSdanielk1977   }
2954b5255acSdanielk1977 }
2964b5255acSdanielk1977 static void heightOfSelect(Select *p, int *pnHeight){
2974b5255acSdanielk1977   if( p ){
2984b5255acSdanielk1977     heightOfExpr(p->pWhere, pnHeight);
2994b5255acSdanielk1977     heightOfExpr(p->pHaving, pnHeight);
3004b5255acSdanielk1977     heightOfExpr(p->pLimit, pnHeight);
3014b5255acSdanielk1977     heightOfExpr(p->pOffset, pnHeight);
3024b5255acSdanielk1977     heightOfExprList(p->pEList, pnHeight);
3034b5255acSdanielk1977     heightOfExprList(p->pGroupBy, pnHeight);
3044b5255acSdanielk1977     heightOfExprList(p->pOrderBy, pnHeight);
3054b5255acSdanielk1977     heightOfSelect(p->pPrior, pnHeight);
3064b5255acSdanielk1977   }
3074b5255acSdanielk1977 }
3084b5255acSdanielk1977 
3094b5255acSdanielk1977 /*
3104b5255acSdanielk1977 ** Set the Expr.nHeight variable in the structure passed as an
3114b5255acSdanielk1977 ** argument. An expression with no children, Expr.pList or
3124b5255acSdanielk1977 ** Expr.pSelect member has a height of 1. Any other expression
3134b5255acSdanielk1977 ** has a height equal to the maximum height of any other
3144b5255acSdanielk1977 ** referenced Expr plus one.
3154b5255acSdanielk1977 */
3164b5255acSdanielk1977 static void exprSetHeight(Expr *p){
3174b5255acSdanielk1977   int nHeight = 0;
3184b5255acSdanielk1977   heightOfExpr(p->pLeft, &nHeight);
3194b5255acSdanielk1977   heightOfExpr(p->pRight, &nHeight);
3206ab3a2ecSdanielk1977   if( ExprHasProperty(p, EP_xIsSelect) ){
3216ab3a2ecSdanielk1977     heightOfSelect(p->x.pSelect, &nHeight);
3226ab3a2ecSdanielk1977   }else{
3236ab3a2ecSdanielk1977     heightOfExprList(p->x.pList, &nHeight);
3246ab3a2ecSdanielk1977   }
3254b5255acSdanielk1977   p->nHeight = nHeight + 1;
3264b5255acSdanielk1977 }
3274b5255acSdanielk1977 
3284b5255acSdanielk1977 /*
3294b5255acSdanielk1977 ** Set the Expr.nHeight variable using the exprSetHeight() function. If
3304b5255acSdanielk1977 ** the height is greater than the maximum allowed expression depth,
3314b5255acSdanielk1977 ** leave an error in pParse.
3324b5255acSdanielk1977 */
3334b5255acSdanielk1977 void sqlite3ExprSetHeight(Parse *pParse, Expr *p){
3344b5255acSdanielk1977   exprSetHeight(p);
3357d10d5a6Sdrh   sqlite3ExprCheckHeight(pParse, p->nHeight);
3364b5255acSdanielk1977 }
3374b5255acSdanielk1977 
3384b5255acSdanielk1977 /*
3394b5255acSdanielk1977 ** Return the maximum height of any expression tree referenced
3404b5255acSdanielk1977 ** by the select statement passed as an argument.
3414b5255acSdanielk1977 */
3424b5255acSdanielk1977 int sqlite3SelectExprHeight(Select *p){
3434b5255acSdanielk1977   int nHeight = 0;
3444b5255acSdanielk1977   heightOfSelect(p, &nHeight);
3454b5255acSdanielk1977   return nHeight;
3464b5255acSdanielk1977 }
3474b5255acSdanielk1977 #else
3484b5255acSdanielk1977   #define exprSetHeight(y)
3494b5255acSdanielk1977 #endif /* SQLITE_MAX_EXPR_DEPTH>0 */
3504b5255acSdanielk1977 
351be5c89acSdrh /*
352b7916a78Sdrh ** This routine is the core allocator for Expr nodes.
353b7916a78Sdrh **
354a76b5dfcSdrh ** Construct a new expression node and return a pointer to it.  Memory
355b7916a78Sdrh ** for this node and for the pToken argument is a single allocation
356b7916a78Sdrh ** obtained from sqlite3DbMalloc().  The calling function
357a76b5dfcSdrh ** is responsible for making sure the node eventually gets freed.
358b7916a78Sdrh **
359b7916a78Sdrh ** If dequote is true, then the token (if it exists) is dequoted.
360b7916a78Sdrh ** If dequote is false, no dequoting is performance.  The deQuote
361b7916a78Sdrh ** parameter is ignored if pToken is NULL or if the token does not
362b7916a78Sdrh ** appear to be quoted.  If the quotes were of the form "..." (double-quotes)
363b7916a78Sdrh ** then the EP_DblQuoted flag is set on the expression node.
36433e619fcSdrh **
36533e619fcSdrh ** Special case:  If op==TK_INTEGER and pToken points to a string that
36633e619fcSdrh ** can be translated into a 32-bit integer, then the token is not
36733e619fcSdrh ** stored in u.zToken.  Instead, the integer values is written
36833e619fcSdrh ** into u.iValue and the EP_IntValue flag is set.  No extra storage
36933e619fcSdrh ** is allocated to hold the integer text and the dequote flag is ignored.
370a76b5dfcSdrh */
371b7916a78Sdrh Expr *sqlite3ExprAlloc(
372a1644fd8Sdanielk1977   sqlite3 *db,            /* Handle for sqlite3DbMallocZero() (may be null) */
37317435752Sdrh   int op,                 /* Expression opcode */
374b7916a78Sdrh   const Token *pToken,    /* Token argument.  Might be NULL */
375b7916a78Sdrh   int dequote             /* True to dequote */
37617435752Sdrh ){
377a76b5dfcSdrh   Expr *pNew;
37833e619fcSdrh   int nExtra = 0;
379cf697396Sshane   int iValue = 0;
380b7916a78Sdrh 
381b7916a78Sdrh   if( pToken ){
38233e619fcSdrh     if( op!=TK_INTEGER || pToken->z==0
38333e619fcSdrh           || sqlite3GetInt32(pToken->z, &iValue)==0 ){
384b7916a78Sdrh       nExtra = pToken->n+1;
38533e619fcSdrh     }
386a76b5dfcSdrh   }
387b7916a78Sdrh   pNew = sqlite3DbMallocZero(db, sizeof(Expr)+nExtra);
388b7916a78Sdrh   if( pNew ){
3891bd10f8aSdrh     pNew->op = (u8)op;
390a58fdfb1Sdanielk1977     pNew->iAgg = -1;
391a76b5dfcSdrh     if( pToken ){
39233e619fcSdrh       if( nExtra==0 ){
39333e619fcSdrh         pNew->flags |= EP_IntValue;
39433e619fcSdrh         pNew->u.iValue = iValue;
39533e619fcSdrh       }else{
396d9da78a2Sdrh         int c;
39733e619fcSdrh         pNew->u.zToken = (char*)&pNew[1];
39833e619fcSdrh         memcpy(pNew->u.zToken, pToken->z, pToken->n);
39933e619fcSdrh         pNew->u.zToken[pToken->n] = 0;
400b7916a78Sdrh         if( dequote && nExtra>=3
401d9da78a2Sdrh              && ((c = pToken->z[0])=='\'' || c=='"' || c=='[' || c=='`') ){
40233e619fcSdrh           sqlite3Dequote(pNew->u.zToken);
40324fb627aSdrh           if( c=='"' ) pNew->flags |= EP_DblQuoted;
404a34001c9Sdrh         }
405a34001c9Sdrh       }
40633e619fcSdrh     }
407b7916a78Sdrh #if SQLITE_MAX_EXPR_DEPTH>0
408b7916a78Sdrh     pNew->nHeight = 1;
409b7916a78Sdrh #endif
410a34001c9Sdrh   }
411a76b5dfcSdrh   return pNew;
412a76b5dfcSdrh }
413a76b5dfcSdrh 
414a76b5dfcSdrh /*
415b7916a78Sdrh ** Allocate a new expression node from a zero-terminated token that has
416b7916a78Sdrh ** already been dequoted.
417b7916a78Sdrh */
418b7916a78Sdrh Expr *sqlite3Expr(
419b7916a78Sdrh   sqlite3 *db,            /* Handle for sqlite3DbMallocZero() (may be null) */
420b7916a78Sdrh   int op,                 /* Expression opcode */
421b7916a78Sdrh   const char *zToken      /* Token argument.  Might be NULL */
422b7916a78Sdrh ){
423b7916a78Sdrh   Token x;
424b7916a78Sdrh   x.z = zToken;
425b7916a78Sdrh   x.n = zToken ? sqlite3Strlen30(zToken) : 0;
426b7916a78Sdrh   return sqlite3ExprAlloc(db, op, &x, 0);
427b7916a78Sdrh }
428b7916a78Sdrh 
429b7916a78Sdrh /*
430b7916a78Sdrh ** Attach subtrees pLeft and pRight to the Expr node pRoot.
431b7916a78Sdrh **
432b7916a78Sdrh ** If pRoot==NULL that means that a memory allocation error has occurred.
433b7916a78Sdrh ** In that case, delete the subtrees pLeft and pRight.
434b7916a78Sdrh */
435b7916a78Sdrh void sqlite3ExprAttachSubtrees(
436b7916a78Sdrh   sqlite3 *db,
437b7916a78Sdrh   Expr *pRoot,
438b7916a78Sdrh   Expr *pLeft,
439b7916a78Sdrh   Expr *pRight
440b7916a78Sdrh ){
441b7916a78Sdrh   if( pRoot==0 ){
442b7916a78Sdrh     assert( db->mallocFailed );
443b7916a78Sdrh     sqlite3ExprDelete(db, pLeft);
444b7916a78Sdrh     sqlite3ExprDelete(db, pRight);
445b7916a78Sdrh   }else{
446b7916a78Sdrh     if( pRight ){
447b7916a78Sdrh       pRoot->pRight = pRight;
448b7916a78Sdrh       if( pRight->flags & EP_ExpCollate ){
449b7916a78Sdrh         pRoot->flags |= EP_ExpCollate;
450b7916a78Sdrh         pRoot->pColl = pRight->pColl;
451b7916a78Sdrh       }
452b7916a78Sdrh     }
453b7916a78Sdrh     if( pLeft ){
454b7916a78Sdrh       pRoot->pLeft = pLeft;
455b7916a78Sdrh       if( pLeft->flags & EP_ExpCollate ){
456b7916a78Sdrh         pRoot->flags |= EP_ExpCollate;
457b7916a78Sdrh         pRoot->pColl = pLeft->pColl;
458b7916a78Sdrh       }
459b7916a78Sdrh     }
460b7916a78Sdrh     exprSetHeight(pRoot);
461b7916a78Sdrh   }
462b7916a78Sdrh }
463b7916a78Sdrh 
464b7916a78Sdrh /*
465bf664469Sdrh ** Allocate a Expr node which joins as many as two subtrees.
466b7916a78Sdrh **
467bf664469Sdrh ** One or both of the subtrees can be NULL.  Return a pointer to the new
468bf664469Sdrh ** Expr node.  Or, if an OOM error occurs, set pParse->db->mallocFailed,
469bf664469Sdrh ** free the subtrees and return NULL.
470206f3d96Sdrh */
47117435752Sdrh Expr *sqlite3PExpr(
47217435752Sdrh   Parse *pParse,          /* Parsing context */
47317435752Sdrh   int op,                 /* Expression opcode */
47417435752Sdrh   Expr *pLeft,            /* Left operand */
47517435752Sdrh   Expr *pRight,           /* Right operand */
47617435752Sdrh   const Token *pToken     /* Argument token */
47717435752Sdrh ){
478b7916a78Sdrh   Expr *p = sqlite3ExprAlloc(pParse->db, op, pToken, 1);
479b7916a78Sdrh   sqlite3ExprAttachSubtrees(pParse->db, p, pLeft, pRight);
4804e0cff60Sdrh   return p;
4814e0cff60Sdrh }
4824e0cff60Sdrh 
4834e0cff60Sdrh /*
48491bb0eedSdrh ** Join two expressions using an AND operator.  If either expression is
48591bb0eedSdrh ** NULL, then just return the other expression.
48691bb0eedSdrh */
4871e536953Sdanielk1977 Expr *sqlite3ExprAnd(sqlite3 *db, Expr *pLeft, Expr *pRight){
48891bb0eedSdrh   if( pLeft==0 ){
48991bb0eedSdrh     return pRight;
49091bb0eedSdrh   }else if( pRight==0 ){
49191bb0eedSdrh     return pLeft;
49291bb0eedSdrh   }else{
493b7916a78Sdrh     Expr *pNew = sqlite3ExprAlloc(db, TK_AND, 0, 0);
494b7916a78Sdrh     sqlite3ExprAttachSubtrees(db, pNew, pLeft, pRight);
495b7916a78Sdrh     return pNew;
496a76b5dfcSdrh   }
497a76b5dfcSdrh }
498a76b5dfcSdrh 
499a76b5dfcSdrh /*
500a76b5dfcSdrh ** Construct a new expression node for a function with multiple
501a76b5dfcSdrh ** arguments.
502a76b5dfcSdrh */
50317435752Sdrh Expr *sqlite3ExprFunction(Parse *pParse, ExprList *pList, Token *pToken){
504a76b5dfcSdrh   Expr *pNew;
505633e6d57Sdrh   sqlite3 *db = pParse->db;
5064b202ae2Sdanielk1977   assert( pToken );
507b7916a78Sdrh   pNew = sqlite3ExprAlloc(db, TK_FUNCTION, pToken, 1);
508a76b5dfcSdrh   if( pNew==0 ){
509d9da78a2Sdrh     sqlite3ExprListDelete(db, pList); /* Avoid memory leak when malloc fails */
510a76b5dfcSdrh     return 0;
511a76b5dfcSdrh   }
5126ab3a2ecSdanielk1977   pNew->x.pList = pList;
5136ab3a2ecSdanielk1977   assert( !ExprHasProperty(pNew, EP_xIsSelect) );
5144b5255acSdanielk1977   sqlite3ExprSetHeight(pParse, pNew);
515a76b5dfcSdrh   return pNew;
516a76b5dfcSdrh }
517a76b5dfcSdrh 
518a76b5dfcSdrh /*
519fa6bc000Sdrh ** Assign a variable number to an expression that encodes a wildcard
520fa6bc000Sdrh ** in the original SQL statement.
521fa6bc000Sdrh **
522fa6bc000Sdrh ** Wildcards consisting of a single "?" are assigned the next sequential
523fa6bc000Sdrh ** variable number.
524fa6bc000Sdrh **
525fa6bc000Sdrh ** Wildcards of the form "?nnn" are assigned the number "nnn".  We make
526fa6bc000Sdrh ** sure "nnn" is not too be to avoid a denial of service attack when
527fa6bc000Sdrh ** the SQL statement comes from an external source.
528fa6bc000Sdrh **
52951f49f17Sdrh ** Wildcards of the form ":aaa", "@aaa", or "$aaa" are assigned the same number
530fa6bc000Sdrh ** as the previous instance of the same wildcard.  Or if this is the first
531fa6bc000Sdrh ** instance of the wildcard, the next sequenial variable number is
532fa6bc000Sdrh ** assigned.
533fa6bc000Sdrh */
534fa6bc000Sdrh void sqlite3ExprAssignVarNumber(Parse *pParse, Expr *pExpr){
53517435752Sdrh   sqlite3 *db = pParse->db;
536b7916a78Sdrh   const char *z;
53717435752Sdrh 
538fa6bc000Sdrh   if( pExpr==0 ) return;
53933e619fcSdrh   assert( !ExprHasAnyProperty(pExpr, EP_IntValue|EP_Reduced|EP_TokenOnly) );
54033e619fcSdrh   z = pExpr->u.zToken;
541b7916a78Sdrh   assert( z!=0 );
542b7916a78Sdrh   assert( z[0]!=0 );
543b7916a78Sdrh   if( z[1]==0 ){
544fa6bc000Sdrh     /* Wildcard of the form "?".  Assign the next variable number */
545b7916a78Sdrh     assert( z[0]=='?' );
5468677d308Sdrh     pExpr->iColumn = (ynVar)(++pParse->nVar);
547b7916a78Sdrh   }else if( z[0]=='?' ){
548fa6bc000Sdrh     /* Wildcard of the form "?nnn".  Convert "nnn" to an integer and
549fa6bc000Sdrh     ** use it as the variable number */
550f639c40fSshane     int i = atoi((char*)&z[1]);
5518677d308Sdrh     pExpr->iColumn = (ynVar)i;
552c5499befSdrh     testcase( i==0 );
553c5499befSdrh     testcase( i==1 );
554c5499befSdrh     testcase( i==db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER]-1 );
555c5499befSdrh     testcase( i==db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER] );
556bb4957f8Sdrh     if( i<1 || i>db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER] ){
557fa6bc000Sdrh       sqlite3ErrorMsg(pParse, "variable number must be between ?1 and ?%d",
558bb4957f8Sdrh           db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER]);
559fa6bc000Sdrh     }
560fa6bc000Sdrh     if( i>pParse->nVar ){
561fa6bc000Sdrh       pParse->nVar = i;
562fa6bc000Sdrh     }
563fa6bc000Sdrh   }else{
56451f49f17Sdrh     /* Wildcards like ":aaa", "$aaa" or "@aaa".  Reuse the same variable
565fa6bc000Sdrh     ** number as the prior appearance of the same name, or if the name
566fa6bc000Sdrh     ** has never appeared before, reuse the same variable number
567fa6bc000Sdrh     */
5681bd10f8aSdrh     int i;
5691bd10f8aSdrh     u32 n;
570b7916a78Sdrh     n = sqlite3Strlen30(z);
571fa6bc000Sdrh     for(i=0; i<pParse->nVarExpr; i++){
57251f49f17Sdrh       Expr *pE = pParse->apVarExpr[i];
57351f49f17Sdrh       assert( pE!=0 );
57433e619fcSdrh       if( memcmp(pE->u.zToken, z, n)==0 && pE->u.zToken[n]==0 ){
575937d0deaSdan         pExpr->iColumn = pE->iColumn;
576fa6bc000Sdrh         break;
577fa6bc000Sdrh       }
578fa6bc000Sdrh     }
579fa6bc000Sdrh     if( i>=pParse->nVarExpr ){
5808677d308Sdrh       pExpr->iColumn = (ynVar)(++pParse->nVar);
581fa6bc000Sdrh       if( pParse->nVarExpr>=pParse->nVarExprAlloc-1 ){
582fa6bc000Sdrh         pParse->nVarExprAlloc += pParse->nVarExprAlloc + 10;
58317435752Sdrh         pParse->apVarExpr =
58417435752Sdrh             sqlite3DbReallocOrFree(
58517435752Sdrh               db,
58617435752Sdrh               pParse->apVarExpr,
58717435752Sdrh               pParse->nVarExprAlloc*sizeof(pParse->apVarExpr[0])
58817435752Sdrh             );
589fa6bc000Sdrh       }
59017435752Sdrh       if( !db->mallocFailed ){
591fa6bc000Sdrh         assert( pParse->apVarExpr!=0 );
592fa6bc000Sdrh         pParse->apVarExpr[pParse->nVarExpr++] = pExpr;
593fa6bc000Sdrh       }
594fa6bc000Sdrh     }
595fa6bc000Sdrh   }
596bb4957f8Sdrh   if( !pParse->nErr && pParse->nVar>db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER] ){
597832b2664Sdanielk1977     sqlite3ErrorMsg(pParse, "too many SQL variables");
598832b2664Sdanielk1977   }
599fa6bc000Sdrh }
600fa6bc000Sdrh 
601fa6bc000Sdrh /*
602f6963f99Sdan ** Recursively delete an expression tree.
603a2e00042Sdrh */
604f6963f99Sdan void sqlite3ExprDelete(sqlite3 *db, Expr *p){
605f6963f99Sdan   if( p==0 ) return;
606b7916a78Sdrh   if( !ExprHasAnyProperty(p, EP_TokenOnly) ){
607633e6d57Sdrh     sqlite3ExprDelete(db, p->pLeft);
608633e6d57Sdrh     sqlite3ExprDelete(db, p->pRight);
60933e619fcSdrh     if( !ExprHasProperty(p, EP_Reduced) && (p->flags2 & EP2_MallocedToken)!=0 ){
61033e619fcSdrh       sqlite3DbFree(db, p->u.zToken);
6116ab3a2ecSdanielk1977     }
6126ab3a2ecSdanielk1977     if( ExprHasProperty(p, EP_xIsSelect) ){
6136ab3a2ecSdanielk1977       sqlite3SelectDelete(db, p->x.pSelect);
6146ab3a2ecSdanielk1977     }else{
6156ab3a2ecSdanielk1977       sqlite3ExprListDelete(db, p->x.pList);
6166ab3a2ecSdanielk1977     }
6176ab3a2ecSdanielk1977   }
61833e619fcSdrh   if( !ExprHasProperty(p, EP_Static) ){
619633e6d57Sdrh     sqlite3DbFree(db, p);
620a2e00042Sdrh   }
62133e619fcSdrh }
622a2e00042Sdrh 
623d2687b77Sdrh /*
6246ab3a2ecSdanielk1977 ** Return the number of bytes allocated for the expression structure
6256ab3a2ecSdanielk1977 ** passed as the first argument. This is always one of EXPR_FULLSIZE,
6266ab3a2ecSdanielk1977 ** EXPR_REDUCEDSIZE or EXPR_TOKENONLYSIZE.
6276ab3a2ecSdanielk1977 */
6286ab3a2ecSdanielk1977 static int exprStructSize(Expr *p){
6296ab3a2ecSdanielk1977   if( ExprHasProperty(p, EP_TokenOnly) ) return EXPR_TOKENONLYSIZE;
6306ab3a2ecSdanielk1977   if( ExprHasProperty(p, EP_Reduced) ) return EXPR_REDUCEDSIZE;
6316ab3a2ecSdanielk1977   return EXPR_FULLSIZE;
6326ab3a2ecSdanielk1977 }
6336ab3a2ecSdanielk1977 
6346ab3a2ecSdanielk1977 /*
63533e619fcSdrh ** The dupedExpr*Size() routines each return the number of bytes required
63633e619fcSdrh ** to store a copy of an expression or expression tree.  They differ in
63733e619fcSdrh ** how much of the tree is measured.
63833e619fcSdrh **
63933e619fcSdrh **     dupedExprStructSize()     Size of only the Expr structure
64033e619fcSdrh **     dupedExprNodeSize()       Size of Expr + space for token
64133e619fcSdrh **     dupedExprSize()           Expr + token + subtree components
64233e619fcSdrh **
64333e619fcSdrh ***************************************************************************
64433e619fcSdrh **
64533e619fcSdrh ** The dupedExprStructSize() function returns two values OR-ed together:
64633e619fcSdrh ** (1) the space required for a copy of the Expr structure only and
64733e619fcSdrh ** (2) the EP_xxx flags that indicate what the structure size should be.
64833e619fcSdrh ** The return values is always one of:
64933e619fcSdrh **
65033e619fcSdrh **      EXPR_FULLSIZE
65133e619fcSdrh **      EXPR_REDUCEDSIZE   | EP_Reduced
65233e619fcSdrh **      EXPR_TOKENONLYSIZE | EP_TokenOnly
65333e619fcSdrh **
65433e619fcSdrh ** The size of the structure can be found by masking the return value
65533e619fcSdrh ** of this routine with 0xfff.  The flags can be found by masking the
65633e619fcSdrh ** return value with EP_Reduced|EP_TokenOnly.
65733e619fcSdrh **
65833e619fcSdrh ** Note that with flags==EXPRDUP_REDUCE, this routines works on full-size
65933e619fcSdrh ** (unreduced) Expr objects as they or originally constructed by the parser.
66033e619fcSdrh ** During expression analysis, extra information is computed and moved into
66133e619fcSdrh ** later parts of teh Expr object and that extra information might get chopped
66233e619fcSdrh ** off if the expression is reduced.  Note also that it does not work to
66333e619fcSdrh ** make a EXPRDUP_REDUCE copy of a reduced expression.  It is only legal
66433e619fcSdrh ** to reduce a pristine expression tree from the parser.  The implementation
66533e619fcSdrh ** of dupedExprStructSize() contain multiple assert() statements that attempt
66633e619fcSdrh ** to enforce this constraint.
6676ab3a2ecSdanielk1977 */
6686ab3a2ecSdanielk1977 static int dupedExprStructSize(Expr *p, int flags){
6696ab3a2ecSdanielk1977   int nSize;
67033e619fcSdrh   assert( flags==EXPRDUP_REDUCE || flags==0 ); /* Only one flag value allowed */
6716ab3a2ecSdanielk1977   if( 0==(flags&EXPRDUP_REDUCE) ){
6726ab3a2ecSdanielk1977     nSize = EXPR_FULLSIZE;
6736ab3a2ecSdanielk1977   }else{
67433e619fcSdrh     assert( !ExprHasAnyProperty(p, EP_TokenOnly|EP_Reduced) );
67533e619fcSdrh     assert( !ExprHasProperty(p, EP_FromJoin) );
67633e619fcSdrh     assert( (p->flags2 & EP2_MallocedToken)==0 );
67733e619fcSdrh     assert( (p->flags2 & EP2_Irreducible)==0 );
67833e619fcSdrh     if( p->pLeft || p->pRight || p->pColl || p->x.pList ){
67933e619fcSdrh       nSize = EXPR_REDUCEDSIZE | EP_Reduced;
68033e619fcSdrh     }else{
68133e619fcSdrh       nSize = EXPR_TOKENONLYSIZE | EP_TokenOnly;
68233e619fcSdrh     }
6836ab3a2ecSdanielk1977   }
6846ab3a2ecSdanielk1977   return nSize;
6856ab3a2ecSdanielk1977 }
6866ab3a2ecSdanielk1977 
6876ab3a2ecSdanielk1977 /*
68833e619fcSdrh ** This function returns the space in bytes required to store the copy
68933e619fcSdrh ** of the Expr structure and a copy of the Expr.u.zToken string (if that
69033e619fcSdrh ** string is defined.)
6916ab3a2ecSdanielk1977 */
6926ab3a2ecSdanielk1977 static int dupedExprNodeSize(Expr *p, int flags){
69333e619fcSdrh   int nByte = dupedExprStructSize(p, flags) & 0xfff;
69433e619fcSdrh   if( !ExprHasProperty(p, EP_IntValue) && p->u.zToken ){
69533e619fcSdrh     nByte += sqlite3Strlen30(p->u.zToken)+1;
6966ab3a2ecSdanielk1977   }
697bc73971dSdanielk1977   return ROUND8(nByte);
6986ab3a2ecSdanielk1977 }
6996ab3a2ecSdanielk1977 
7006ab3a2ecSdanielk1977 /*
7016ab3a2ecSdanielk1977 ** Return the number of bytes required to create a duplicate of the
7026ab3a2ecSdanielk1977 ** expression passed as the first argument. The second argument is a
7036ab3a2ecSdanielk1977 ** mask containing EXPRDUP_XXX flags.
7046ab3a2ecSdanielk1977 **
7056ab3a2ecSdanielk1977 ** The value returned includes space to create a copy of the Expr struct
70633e619fcSdrh ** itself and the buffer referred to by Expr.u.zToken, if any.
7076ab3a2ecSdanielk1977 **
7086ab3a2ecSdanielk1977 ** If the EXPRDUP_REDUCE flag is set, then the return value includes
7096ab3a2ecSdanielk1977 ** space to duplicate all Expr nodes in the tree formed by Expr.pLeft
7106ab3a2ecSdanielk1977 ** and Expr.pRight variables (but not for any structures pointed to or
7116ab3a2ecSdanielk1977 ** descended from the Expr.x.pList or Expr.x.pSelect variables).
7126ab3a2ecSdanielk1977 */
7136ab3a2ecSdanielk1977 static int dupedExprSize(Expr *p, int flags){
7146ab3a2ecSdanielk1977   int nByte = 0;
7156ab3a2ecSdanielk1977   if( p ){
7166ab3a2ecSdanielk1977     nByte = dupedExprNodeSize(p, flags);
7176ab3a2ecSdanielk1977     if( flags&EXPRDUP_REDUCE ){
718b7916a78Sdrh       nByte += dupedExprSize(p->pLeft, flags) + dupedExprSize(p->pRight, flags);
7196ab3a2ecSdanielk1977     }
7206ab3a2ecSdanielk1977   }
7216ab3a2ecSdanielk1977   return nByte;
7226ab3a2ecSdanielk1977 }
7236ab3a2ecSdanielk1977 
7246ab3a2ecSdanielk1977 /*
7256ab3a2ecSdanielk1977 ** This function is similar to sqlite3ExprDup(), except that if pzBuffer
7266ab3a2ecSdanielk1977 ** is not NULL then *pzBuffer is assumed to point to a buffer large enough
72733e619fcSdrh ** to store the copy of expression p, the copies of p->u.zToken
7286ab3a2ecSdanielk1977 ** (if applicable), and the copies of the p->pLeft and p->pRight expressions,
7296ab3a2ecSdanielk1977 ** if any. Before returning, *pzBuffer is set to the first byte passed the
7306ab3a2ecSdanielk1977 ** portion of the buffer copied into by this function.
7316ab3a2ecSdanielk1977 */
7326ab3a2ecSdanielk1977 static Expr *exprDup(sqlite3 *db, Expr *p, int flags, u8 **pzBuffer){
7336ab3a2ecSdanielk1977   Expr *pNew = 0;                      /* Value to return */
7346ab3a2ecSdanielk1977   if( p ){
7356ab3a2ecSdanielk1977     const int isReduced = (flags&EXPRDUP_REDUCE);
7366ab3a2ecSdanielk1977     u8 *zAlloc;
73733e619fcSdrh     u32 staticFlag = 0;
7386ab3a2ecSdanielk1977 
7396ab3a2ecSdanielk1977     assert( pzBuffer==0 || isReduced );
7406ab3a2ecSdanielk1977 
7416ab3a2ecSdanielk1977     /* Figure out where to write the new Expr structure. */
7426ab3a2ecSdanielk1977     if( pzBuffer ){
7436ab3a2ecSdanielk1977       zAlloc = *pzBuffer;
74433e619fcSdrh       staticFlag = EP_Static;
7456ab3a2ecSdanielk1977     }else{
7466ab3a2ecSdanielk1977       zAlloc = sqlite3DbMallocRaw(db, dupedExprSize(p, flags));
7476ab3a2ecSdanielk1977     }
7486ab3a2ecSdanielk1977     pNew = (Expr *)zAlloc;
7496ab3a2ecSdanielk1977 
7506ab3a2ecSdanielk1977     if( pNew ){
7516ab3a2ecSdanielk1977       /* Set nNewSize to the size allocated for the structure pointed to
7526ab3a2ecSdanielk1977       ** by pNew. This is either EXPR_FULLSIZE, EXPR_REDUCEDSIZE or
7536ab3a2ecSdanielk1977       ** EXPR_TOKENONLYSIZE. nToken is set to the number of bytes consumed
75433e619fcSdrh       ** by the copy of the p->u.zToken string (if any).
7556ab3a2ecSdanielk1977       */
75633e619fcSdrh       const unsigned nStructSize = dupedExprStructSize(p, flags);
75733e619fcSdrh       const int nNewSize = nStructSize & 0xfff;
75833e619fcSdrh       int nToken;
75933e619fcSdrh       if( !ExprHasProperty(p, EP_IntValue) && p->u.zToken ){
76033e619fcSdrh         nToken = sqlite3Strlen30(p->u.zToken) + 1;
76133e619fcSdrh       }else{
76233e619fcSdrh         nToken = 0;
76333e619fcSdrh       }
7646ab3a2ecSdanielk1977       if( isReduced ){
7656ab3a2ecSdanielk1977         assert( ExprHasProperty(p, EP_Reduced)==0 );
7666ab3a2ecSdanielk1977         memcpy(zAlloc, p, nNewSize);
7676ab3a2ecSdanielk1977       }else{
7686ab3a2ecSdanielk1977         int nSize = exprStructSize(p);
7696ab3a2ecSdanielk1977         memcpy(zAlloc, p, nSize);
7706ab3a2ecSdanielk1977         memset(&zAlloc[nSize], 0, EXPR_FULLSIZE-nSize);
7716ab3a2ecSdanielk1977       }
7726ab3a2ecSdanielk1977 
77333e619fcSdrh       /* Set the EP_Reduced, EP_TokenOnly, and EP_Static flags appropriately. */
77433e619fcSdrh       pNew->flags &= ~(EP_Reduced|EP_TokenOnly|EP_Static);
77533e619fcSdrh       pNew->flags |= nStructSize & (EP_Reduced|EP_TokenOnly);
77633e619fcSdrh       pNew->flags |= staticFlag;
7776ab3a2ecSdanielk1977 
77833e619fcSdrh       /* Copy the p->u.zToken string, if any. */
7796ab3a2ecSdanielk1977       if( nToken ){
78033e619fcSdrh         char *zToken = pNew->u.zToken = (char*)&zAlloc[nNewSize];
78133e619fcSdrh         memcpy(zToken, p->u.zToken, nToken);
7826ab3a2ecSdanielk1977       }
7836ab3a2ecSdanielk1977 
7846ab3a2ecSdanielk1977       if( 0==((p->flags|pNew->flags) & EP_TokenOnly) ){
7856ab3a2ecSdanielk1977         /* Fill in the pNew->x.pSelect or pNew->x.pList member. */
7866ab3a2ecSdanielk1977         if( ExprHasProperty(p, EP_xIsSelect) ){
7876ab3a2ecSdanielk1977           pNew->x.pSelect = sqlite3SelectDup(db, p->x.pSelect, isReduced);
7886ab3a2ecSdanielk1977         }else{
7896ab3a2ecSdanielk1977           pNew->x.pList = sqlite3ExprListDup(db, p->x.pList, isReduced);
7906ab3a2ecSdanielk1977         }
7916ab3a2ecSdanielk1977       }
7926ab3a2ecSdanielk1977 
7936ab3a2ecSdanielk1977       /* Fill in pNew->pLeft and pNew->pRight. */
794b7916a78Sdrh       if( ExprHasAnyProperty(pNew, EP_Reduced|EP_TokenOnly) ){
7956ab3a2ecSdanielk1977         zAlloc += dupedExprNodeSize(p, flags);
7966ab3a2ecSdanielk1977         if( ExprHasProperty(pNew, EP_Reduced) ){
7976ab3a2ecSdanielk1977           pNew->pLeft = exprDup(db, p->pLeft, EXPRDUP_REDUCE, &zAlloc);
7986ab3a2ecSdanielk1977           pNew->pRight = exprDup(db, p->pRight, EXPRDUP_REDUCE, &zAlloc);
7996ab3a2ecSdanielk1977         }
8006ab3a2ecSdanielk1977         if( pzBuffer ){
8016ab3a2ecSdanielk1977           *pzBuffer = zAlloc;
8026ab3a2ecSdanielk1977         }
803b7916a78Sdrh       }else{
804b7916a78Sdrh         pNew->flags2 = 0;
805b7916a78Sdrh         if( !ExprHasAnyProperty(p, EP_TokenOnly) ){
8066ab3a2ecSdanielk1977           pNew->pLeft = sqlite3ExprDup(db, p->pLeft, 0);
8076ab3a2ecSdanielk1977           pNew->pRight = sqlite3ExprDup(db, p->pRight, 0);
8086ab3a2ecSdanielk1977         }
8096ab3a2ecSdanielk1977       }
810b7916a78Sdrh 
811b7916a78Sdrh     }
8126ab3a2ecSdanielk1977   }
8136ab3a2ecSdanielk1977   return pNew;
8146ab3a2ecSdanielk1977 }
8156ab3a2ecSdanielk1977 
8166ab3a2ecSdanielk1977 /*
817ff78bd2fSdrh ** The following group of routines make deep copies of expressions,
818ff78bd2fSdrh ** expression lists, ID lists, and select statements.  The copies can
819ff78bd2fSdrh ** be deleted (by being passed to their respective ...Delete() routines)
820ff78bd2fSdrh ** without effecting the originals.
821ff78bd2fSdrh **
8224adee20fSdanielk1977 ** The expression list, ID, and source lists return by sqlite3ExprListDup(),
8234adee20fSdanielk1977 ** sqlite3IdListDup(), and sqlite3SrcListDup() can not be further expanded
824ad3cab52Sdrh ** by subsequent calls to sqlite*ListAppend() routines.
825ff78bd2fSdrh **
826ad3cab52Sdrh ** Any tables that the SrcList might point to are not duplicated.
8276ab3a2ecSdanielk1977 **
828b7916a78Sdrh ** The flags parameter contains a combination of the EXPRDUP_XXX flags.
8296ab3a2ecSdanielk1977 ** If the EXPRDUP_REDUCE flag is set, then the structure returned is a
8306ab3a2ecSdanielk1977 ** truncated version of the usual Expr structure that will be stored as
8316ab3a2ecSdanielk1977 ** part of the in-memory representation of the database schema.
832ff78bd2fSdrh */
8336ab3a2ecSdanielk1977 Expr *sqlite3ExprDup(sqlite3 *db, Expr *p, int flags){
8346ab3a2ecSdanielk1977   return exprDup(db, p, flags, 0);
835ff78bd2fSdrh }
8366ab3a2ecSdanielk1977 ExprList *sqlite3ExprListDup(sqlite3 *db, ExprList *p, int flags){
837ff78bd2fSdrh   ExprList *pNew;
838145716b3Sdrh   struct ExprList_item *pItem, *pOldItem;
839ff78bd2fSdrh   int i;
840ff78bd2fSdrh   if( p==0 ) return 0;
84117435752Sdrh   pNew = sqlite3DbMallocRaw(db, sizeof(*pNew) );
842ff78bd2fSdrh   if( pNew==0 ) return 0;
84331dad9daSdanielk1977   pNew->iECursor = 0;
8444305d103Sdrh   pNew->nExpr = pNew->nAlloc = p->nExpr;
84517435752Sdrh   pNew->a = pItem = sqlite3DbMallocRaw(db,  p->nExpr*sizeof(p->a[0]) );
846e0048400Sdanielk1977   if( pItem==0 ){
847633e6d57Sdrh     sqlite3DbFree(db, pNew);
848e0048400Sdanielk1977     return 0;
849e0048400Sdanielk1977   }
850145716b3Sdrh   pOldItem = p->a;
851145716b3Sdrh   for(i=0; i<p->nExpr; i++, pItem++, pOldItem++){
8526ab3a2ecSdanielk1977     Expr *pOldExpr = pOldItem->pExpr;
853b5526ea6Sdrh     pItem->pExpr = sqlite3ExprDup(db, pOldExpr, flags);
85417435752Sdrh     pItem->zName = sqlite3DbStrDup(db, pOldItem->zName);
855b7916a78Sdrh     pItem->zSpan = sqlite3DbStrDup(db, pOldItem->zSpan);
856145716b3Sdrh     pItem->sortOrder = pOldItem->sortOrder;
8573e7bc9caSdrh     pItem->done = 0;
8587d10d5a6Sdrh     pItem->iCol = pOldItem->iCol;
8598b213899Sdrh     pItem->iAlias = pOldItem->iAlias;
860ff78bd2fSdrh   }
861ff78bd2fSdrh   return pNew;
862ff78bd2fSdrh }
86393758c8dSdanielk1977 
86493758c8dSdanielk1977 /*
86593758c8dSdanielk1977 ** If cursors, triggers, views and subqueries are all omitted from
86693758c8dSdanielk1977 ** the build, then none of the following routines, except for
86793758c8dSdanielk1977 ** sqlite3SelectDup(), can be called. sqlite3SelectDup() is sometimes
86893758c8dSdanielk1977 ** called with a NULL argument.
86993758c8dSdanielk1977 */
8706a67fe8eSdanielk1977 #if !defined(SQLITE_OMIT_VIEW) || !defined(SQLITE_OMIT_TRIGGER) \
8716a67fe8eSdanielk1977  || !defined(SQLITE_OMIT_SUBQUERY)
8726ab3a2ecSdanielk1977 SrcList *sqlite3SrcListDup(sqlite3 *db, SrcList *p, int flags){
873ad3cab52Sdrh   SrcList *pNew;
874ad3cab52Sdrh   int i;
875113088ecSdrh   int nByte;
876ad3cab52Sdrh   if( p==0 ) return 0;
877113088ecSdrh   nByte = sizeof(*p) + (p->nSrc>0 ? sizeof(p->a[0]) * (p->nSrc-1) : 0);
87817435752Sdrh   pNew = sqlite3DbMallocRaw(db, nByte );
879ad3cab52Sdrh   if( pNew==0 ) return 0;
8804305d103Sdrh   pNew->nSrc = pNew->nAlloc = p->nSrc;
881ad3cab52Sdrh   for(i=0; i<p->nSrc; i++){
8824efc4754Sdrh     struct SrcList_item *pNewItem = &pNew->a[i];
8834efc4754Sdrh     struct SrcList_item *pOldItem = &p->a[i];
884ed8a3bb1Sdrh     Table *pTab;
88517435752Sdrh     pNewItem->zDatabase = sqlite3DbStrDup(db, pOldItem->zDatabase);
88617435752Sdrh     pNewItem->zName = sqlite3DbStrDup(db, pOldItem->zName);
88717435752Sdrh     pNewItem->zAlias = sqlite3DbStrDup(db, pOldItem->zAlias);
8884efc4754Sdrh     pNewItem->jointype = pOldItem->jointype;
8894efc4754Sdrh     pNewItem->iCursor = pOldItem->iCursor;
8901787ccabSdanielk1977     pNewItem->isPopulated = pOldItem->isPopulated;
89185574e31Sdanielk1977     pNewItem->zIndex = sqlite3DbStrDup(db, pOldItem->zIndex);
89285574e31Sdanielk1977     pNewItem->notIndexed = pOldItem->notIndexed;
89385574e31Sdanielk1977     pNewItem->pIndex = pOldItem->pIndex;
894ed8a3bb1Sdrh     pTab = pNewItem->pTab = pOldItem->pTab;
895ed8a3bb1Sdrh     if( pTab ){
896ed8a3bb1Sdrh       pTab->nRef++;
897a1cb183dSdanielk1977     }
8986ab3a2ecSdanielk1977     pNewItem->pSelect = sqlite3SelectDup(db, pOldItem->pSelect, flags);
8996ab3a2ecSdanielk1977     pNewItem->pOn = sqlite3ExprDup(db, pOldItem->pOn, flags);
90017435752Sdrh     pNewItem->pUsing = sqlite3IdListDup(db, pOldItem->pUsing);
9016c18b6e0Sdanielk1977     pNewItem->colUsed = pOldItem->colUsed;
902ad3cab52Sdrh   }
903ad3cab52Sdrh   return pNew;
904ad3cab52Sdrh }
90517435752Sdrh IdList *sqlite3IdListDup(sqlite3 *db, IdList *p){
906ff78bd2fSdrh   IdList *pNew;
907ff78bd2fSdrh   int i;
908ff78bd2fSdrh   if( p==0 ) return 0;
90917435752Sdrh   pNew = sqlite3DbMallocRaw(db, sizeof(*pNew) );
910ff78bd2fSdrh   if( pNew==0 ) return 0;
9114305d103Sdrh   pNew->nId = pNew->nAlloc = p->nId;
91217435752Sdrh   pNew->a = sqlite3DbMallocRaw(db, p->nId*sizeof(p->a[0]) );
913d5d56523Sdanielk1977   if( pNew->a==0 ){
914633e6d57Sdrh     sqlite3DbFree(db, pNew);
915d5d56523Sdanielk1977     return 0;
916d5d56523Sdanielk1977   }
917ff78bd2fSdrh   for(i=0; i<p->nId; i++){
9184efc4754Sdrh     struct IdList_item *pNewItem = &pNew->a[i];
9194efc4754Sdrh     struct IdList_item *pOldItem = &p->a[i];
92017435752Sdrh     pNewItem->zName = sqlite3DbStrDup(db, pOldItem->zName);
9214efc4754Sdrh     pNewItem->idx = pOldItem->idx;
922ff78bd2fSdrh   }
923ff78bd2fSdrh   return pNew;
924ff78bd2fSdrh }
9256ab3a2ecSdanielk1977 Select *sqlite3SelectDup(sqlite3 *db, Select *p, int flags){
926ff78bd2fSdrh   Select *pNew;
927ff78bd2fSdrh   if( p==0 ) return 0;
92817435752Sdrh   pNew = sqlite3DbMallocRaw(db, sizeof(*p) );
929ff78bd2fSdrh   if( pNew==0 ) return 0;
930b7916a78Sdrh   pNew->pEList = sqlite3ExprListDup(db, p->pEList, flags);
9316ab3a2ecSdanielk1977   pNew->pSrc = sqlite3SrcListDup(db, p->pSrc, flags);
9326ab3a2ecSdanielk1977   pNew->pWhere = sqlite3ExprDup(db, p->pWhere, flags);
9336ab3a2ecSdanielk1977   pNew->pGroupBy = sqlite3ExprListDup(db, p->pGroupBy, flags);
9346ab3a2ecSdanielk1977   pNew->pHaving = sqlite3ExprDup(db, p->pHaving, flags);
9356ab3a2ecSdanielk1977   pNew->pOrderBy = sqlite3ExprListDup(db, p->pOrderBy, flags);
936ff78bd2fSdrh   pNew->op = p->op;
9376ab3a2ecSdanielk1977   pNew->pPrior = sqlite3SelectDup(db, p->pPrior, flags);
9386ab3a2ecSdanielk1977   pNew->pLimit = sqlite3ExprDup(db, p->pLimit, flags);
9396ab3a2ecSdanielk1977   pNew->pOffset = sqlite3ExprDup(db, p->pOffset, flags);
94092b01d53Sdrh   pNew->iLimit = 0;
94192b01d53Sdrh   pNew->iOffset = 0;
9427d10d5a6Sdrh   pNew->selFlags = p->selFlags & ~SF_UsesEphemeral;
9430342b1f5Sdrh   pNew->pRightmost = 0;
944b9bb7c18Sdrh   pNew->addrOpenEphm[0] = -1;
945b9bb7c18Sdrh   pNew->addrOpenEphm[1] = -1;
946b9bb7c18Sdrh   pNew->addrOpenEphm[2] = -1;
947ff78bd2fSdrh   return pNew;
948ff78bd2fSdrh }
94993758c8dSdanielk1977 #else
9506ab3a2ecSdanielk1977 Select *sqlite3SelectDup(sqlite3 *db, Select *p, int flags){
95193758c8dSdanielk1977   assert( p==0 );
95293758c8dSdanielk1977   return 0;
95393758c8dSdanielk1977 }
95493758c8dSdanielk1977 #endif
955ff78bd2fSdrh 
956ff78bd2fSdrh 
957ff78bd2fSdrh /*
958a76b5dfcSdrh ** Add a new element to the end of an expression list.  If pList is
959a76b5dfcSdrh ** initially NULL, then create a new expression list.
960b7916a78Sdrh **
961b7916a78Sdrh ** If a memory allocation error occurs, the entire list is freed and
962b7916a78Sdrh ** NULL is returned.  If non-NULL is returned, then it is guaranteed
963b7916a78Sdrh ** that the new entry was successfully appended.
964a76b5dfcSdrh */
96517435752Sdrh ExprList *sqlite3ExprListAppend(
96617435752Sdrh   Parse *pParse,          /* Parsing context */
96717435752Sdrh   ExprList *pList,        /* List to which to append. Might be NULL */
968b7916a78Sdrh   Expr *pExpr             /* Expression to be appended. Might be NULL */
96917435752Sdrh ){
97017435752Sdrh   sqlite3 *db = pParse->db;
971a76b5dfcSdrh   if( pList==0 ){
97217435752Sdrh     pList = sqlite3DbMallocZero(db, sizeof(ExprList) );
973a76b5dfcSdrh     if( pList==0 ){
974d5d56523Sdanielk1977       goto no_mem;
975a76b5dfcSdrh     }
9764efc4754Sdrh     assert( pList->nAlloc==0 );
977a76b5dfcSdrh   }
9784305d103Sdrh   if( pList->nAlloc<=pList->nExpr ){
979d5d56523Sdanielk1977     struct ExprList_item *a;
980d5d56523Sdanielk1977     int n = pList->nAlloc*2 + 4;
98126783a58Sdanielk1977     a = sqlite3DbRealloc(db, pList->a, n*sizeof(pList->a[0]));
982d5d56523Sdanielk1977     if( a==0 ){
983d5d56523Sdanielk1977       goto no_mem;
984a76b5dfcSdrh     }
985d5d56523Sdanielk1977     pList->a = a;
9866a1e071fSdrh     pList->nAlloc = sqlite3DbMallocSize(db, a)/sizeof(a[0]);
987a76b5dfcSdrh   }
9884efc4754Sdrh   assert( pList->a!=0 );
989b7916a78Sdrh   if( 1 ){
9904efc4754Sdrh     struct ExprList_item *pItem = &pList->a[pList->nExpr++];
9914efc4754Sdrh     memset(pItem, 0, sizeof(*pItem));
992e94ddc9eSdanielk1977     pItem->pExpr = pExpr;
993a76b5dfcSdrh   }
994a76b5dfcSdrh   return pList;
995d5d56523Sdanielk1977 
996d5d56523Sdanielk1977 no_mem:
997d5d56523Sdanielk1977   /* Avoid leaking memory if malloc has failed. */
998633e6d57Sdrh   sqlite3ExprDelete(db, pExpr);
999633e6d57Sdrh   sqlite3ExprListDelete(db, pList);
1000d5d56523Sdanielk1977   return 0;
1001a76b5dfcSdrh }
1002a76b5dfcSdrh 
1003a76b5dfcSdrh /*
1004b7916a78Sdrh ** Set the ExprList.a[].zName element of the most recently added item
1005b7916a78Sdrh ** on the expression list.
1006b7916a78Sdrh **
1007b7916a78Sdrh ** pList might be NULL following an OOM error.  But pName should never be
1008b7916a78Sdrh ** NULL.  If a memory allocation fails, the pParse->db->mallocFailed flag
1009b7916a78Sdrh ** is set.
1010b7916a78Sdrh */
1011b7916a78Sdrh void sqlite3ExprListSetName(
1012b7916a78Sdrh   Parse *pParse,          /* Parsing context */
1013b7916a78Sdrh   ExprList *pList,        /* List to which to add the span. */
1014b7916a78Sdrh   Token *pName,           /* Name to be added */
1015b7916a78Sdrh   int dequote             /* True to cause the name to be dequoted */
1016b7916a78Sdrh ){
1017b7916a78Sdrh   assert( pList!=0 || pParse->db->mallocFailed!=0 );
1018b7916a78Sdrh   if( pList ){
1019b7916a78Sdrh     struct ExprList_item *pItem;
1020b7916a78Sdrh     assert( pList->nExpr>0 );
1021b7916a78Sdrh     pItem = &pList->a[pList->nExpr-1];
1022b7916a78Sdrh     assert( pItem->zName==0 );
1023b7916a78Sdrh     pItem->zName = sqlite3DbStrNDup(pParse->db, pName->z, pName->n);
1024b7916a78Sdrh     if( dequote && pItem->zName ) sqlite3Dequote(pItem->zName);
1025b7916a78Sdrh   }
1026b7916a78Sdrh }
1027b7916a78Sdrh 
1028b7916a78Sdrh /*
1029b7916a78Sdrh ** Set the ExprList.a[].zSpan element of the most recently added item
1030b7916a78Sdrh ** on the expression list.
1031b7916a78Sdrh **
1032b7916a78Sdrh ** pList might be NULL following an OOM error.  But pSpan should never be
1033b7916a78Sdrh ** NULL.  If a memory allocation fails, the pParse->db->mallocFailed flag
1034b7916a78Sdrh ** is set.
1035b7916a78Sdrh */
1036b7916a78Sdrh void sqlite3ExprListSetSpan(
1037b7916a78Sdrh   Parse *pParse,          /* Parsing context */
1038b7916a78Sdrh   ExprList *pList,        /* List to which to add the span. */
1039b7916a78Sdrh   ExprSpan *pSpan         /* The span to be added */
1040b7916a78Sdrh ){
1041b7916a78Sdrh   sqlite3 *db = pParse->db;
1042b7916a78Sdrh   assert( pList!=0 || db->mallocFailed!=0 );
1043b7916a78Sdrh   if( pList ){
1044b7916a78Sdrh     struct ExprList_item *pItem = &pList->a[pList->nExpr-1];
1045b7916a78Sdrh     assert( pList->nExpr>0 );
1046b7916a78Sdrh     assert( db->mallocFailed || pItem->pExpr==pSpan->pExpr );
1047b7916a78Sdrh     sqlite3DbFree(db, pItem->zSpan);
1048b7916a78Sdrh     pItem->zSpan = sqlite3DbStrNDup(db, (char*)pSpan->zStart,
1049cf697396Sshane                                     (int)(pSpan->zEnd - pSpan->zStart));
1050b7916a78Sdrh   }
1051b7916a78Sdrh }
1052b7916a78Sdrh 
1053b7916a78Sdrh /*
10547a15a4beSdanielk1977 ** If the expression list pEList contains more than iLimit elements,
10557a15a4beSdanielk1977 ** leave an error message in pParse.
10567a15a4beSdanielk1977 */
10577a15a4beSdanielk1977 void sqlite3ExprListCheckLength(
10587a15a4beSdanielk1977   Parse *pParse,
10597a15a4beSdanielk1977   ExprList *pEList,
10607a15a4beSdanielk1977   const char *zObject
10617a15a4beSdanielk1977 ){
1062b1a6c3c1Sdrh   int mx = pParse->db->aLimit[SQLITE_LIMIT_COLUMN];
1063c5499befSdrh   testcase( pEList && pEList->nExpr==mx );
1064c5499befSdrh   testcase( pEList && pEList->nExpr==mx+1 );
1065b1a6c3c1Sdrh   if( pEList && pEList->nExpr>mx ){
10667a15a4beSdanielk1977     sqlite3ErrorMsg(pParse, "too many columns in %s", zObject);
10677a15a4beSdanielk1977   }
10687a15a4beSdanielk1977 }
10697a15a4beSdanielk1977 
10707a15a4beSdanielk1977 /*
1071a76b5dfcSdrh ** Delete an entire expression list.
1072a76b5dfcSdrh */
1073633e6d57Sdrh void sqlite3ExprListDelete(sqlite3 *db, ExprList *pList){
1074a76b5dfcSdrh   int i;
1075be5c89acSdrh   struct ExprList_item *pItem;
1076a76b5dfcSdrh   if( pList==0 ) return;
10771bdd9b57Sdrh   assert( pList->a!=0 || (pList->nExpr==0 && pList->nAlloc==0) );
10781bdd9b57Sdrh   assert( pList->nExpr<=pList->nAlloc );
1079be5c89acSdrh   for(pItem=pList->a, i=0; i<pList->nExpr; i++, pItem++){
1080633e6d57Sdrh     sqlite3ExprDelete(db, pItem->pExpr);
1081633e6d57Sdrh     sqlite3DbFree(db, pItem->zName);
1082b7916a78Sdrh     sqlite3DbFree(db, pItem->zSpan);
1083a76b5dfcSdrh   }
1084633e6d57Sdrh   sqlite3DbFree(db, pList->a);
1085633e6d57Sdrh   sqlite3DbFree(db, pList);
1086a76b5dfcSdrh }
1087a76b5dfcSdrh 
1088a76b5dfcSdrh /*
10897d10d5a6Sdrh ** These routines are Walker callbacks.  Walker.u.pi is a pointer
10907d10d5a6Sdrh ** to an integer.  These routines are checking an expression to see
10917d10d5a6Sdrh ** if it is a constant.  Set *Walker.u.pi to 0 if the expression is
10927d10d5a6Sdrh ** not constant.
109373b211abSdrh **
10947d10d5a6Sdrh ** These callback routines are used to implement the following:
1095626a879aSdrh **
10967d10d5a6Sdrh **     sqlite3ExprIsConstant()
10977d10d5a6Sdrh **     sqlite3ExprIsConstantNotJoin()
10987d10d5a6Sdrh **     sqlite3ExprIsConstantOrFunction()
109987abf5c0Sdrh **
1100626a879aSdrh */
11017d10d5a6Sdrh static int exprNodeIsConstant(Walker *pWalker, Expr *pExpr){
1102626a879aSdrh 
11037d10d5a6Sdrh   /* If pWalker->u.i is 3 then any term of the expression that comes from
11040a168377Sdrh   ** the ON or USING clauses of a join disqualifies the expression
11050a168377Sdrh   ** from being considered constant. */
11067d10d5a6Sdrh   if( pWalker->u.i==3 && ExprHasAnyProperty(pExpr, EP_FromJoin) ){
11077d10d5a6Sdrh     pWalker->u.i = 0;
11087d10d5a6Sdrh     return WRC_Abort;
11090a168377Sdrh   }
11100a168377Sdrh 
1111626a879aSdrh   switch( pExpr->op ){
1112eb55bd2fSdrh     /* Consider functions to be constant if all their arguments are constant
11137d10d5a6Sdrh     ** and pWalker->u.i==2 */
1114eb55bd2fSdrh     case TK_FUNCTION:
11157d10d5a6Sdrh       if( pWalker->u.i==2 ) return 0;
1116eb55bd2fSdrh       /* Fall through */
1117626a879aSdrh     case TK_ID:
1118626a879aSdrh     case TK_COLUMN:
1119626a879aSdrh     case TK_AGG_FUNCTION:
112013449892Sdrh     case TK_AGG_COLUMN:
1121c5499befSdrh       testcase( pExpr->op==TK_ID );
1122c5499befSdrh       testcase( pExpr->op==TK_COLUMN );
1123c5499befSdrh       testcase( pExpr->op==TK_AGG_FUNCTION );
1124c5499befSdrh       testcase( pExpr->op==TK_AGG_COLUMN );
11257d10d5a6Sdrh       pWalker->u.i = 0;
11267d10d5a6Sdrh       return WRC_Abort;
1127626a879aSdrh     default:
1128b74b1017Sdrh       testcase( pExpr->op==TK_SELECT ); /* selectNodeIsConstant will disallow */
1129b74b1017Sdrh       testcase( pExpr->op==TK_EXISTS ); /* selectNodeIsConstant will disallow */
11307d10d5a6Sdrh       return WRC_Continue;
1131626a879aSdrh   }
1132626a879aSdrh }
113362c14b34Sdanielk1977 static int selectNodeIsConstant(Walker *pWalker, Select *NotUsed){
113462c14b34Sdanielk1977   UNUSED_PARAMETER(NotUsed);
11357d10d5a6Sdrh   pWalker->u.i = 0;
11367d10d5a6Sdrh   return WRC_Abort;
11377d10d5a6Sdrh }
11387d10d5a6Sdrh static int exprIsConst(Expr *p, int initFlag){
11397d10d5a6Sdrh   Walker w;
11407d10d5a6Sdrh   w.u.i = initFlag;
11417d10d5a6Sdrh   w.xExprCallback = exprNodeIsConstant;
11427d10d5a6Sdrh   w.xSelectCallback = selectNodeIsConstant;
11437d10d5a6Sdrh   sqlite3WalkExpr(&w, p);
11447d10d5a6Sdrh   return w.u.i;
11457d10d5a6Sdrh }
1146626a879aSdrh 
1147626a879aSdrh /*
1148fef5208cSdrh ** Walk an expression tree.  Return 1 if the expression is constant
1149eb55bd2fSdrh ** and 0 if it involves variables or function calls.
11502398937bSdrh **
11512398937bSdrh ** For the purposes of this function, a double-quoted string (ex: "abc")
11522398937bSdrh ** is considered a variable but a single-quoted string (ex: 'abc') is
11532398937bSdrh ** a constant.
1154fef5208cSdrh */
11554adee20fSdanielk1977 int sqlite3ExprIsConstant(Expr *p){
11567d10d5a6Sdrh   return exprIsConst(p, 1);
1157fef5208cSdrh }
1158fef5208cSdrh 
1159fef5208cSdrh /*
1160eb55bd2fSdrh ** Walk an expression tree.  Return 1 if the expression is constant
11610a168377Sdrh ** that does no originate from the ON or USING clauses of a join.
11620a168377Sdrh ** Return 0 if it involves variables or function calls or terms from
11630a168377Sdrh ** an ON or USING clause.
11640a168377Sdrh */
11650a168377Sdrh int sqlite3ExprIsConstantNotJoin(Expr *p){
11667d10d5a6Sdrh   return exprIsConst(p, 3);
11670a168377Sdrh }
11680a168377Sdrh 
11690a168377Sdrh /*
11700a168377Sdrh ** Walk an expression tree.  Return 1 if the expression is constant
1171eb55bd2fSdrh ** or a function call with constant arguments.  Return and 0 if there
1172eb55bd2fSdrh ** are any variables.
1173eb55bd2fSdrh **
1174eb55bd2fSdrh ** For the purposes of this function, a double-quoted string (ex: "abc")
1175eb55bd2fSdrh ** is considered a variable but a single-quoted string (ex: 'abc') is
1176eb55bd2fSdrh ** a constant.
1177eb55bd2fSdrh */
1178eb55bd2fSdrh int sqlite3ExprIsConstantOrFunction(Expr *p){
11797d10d5a6Sdrh   return exprIsConst(p, 2);
1180eb55bd2fSdrh }
1181eb55bd2fSdrh 
1182eb55bd2fSdrh /*
118373b211abSdrh ** If the expression p codes a constant integer that is small enough
1184202b2df7Sdrh ** to fit in a 32-bit integer, return 1 and put the value of the integer
1185202b2df7Sdrh ** in *pValue.  If the expression is not an integer or if it is too big
1186202b2df7Sdrh ** to fit in a signed 32-bit integer, return 0 and leave *pValue unchanged.
1187e4de1febSdrh */
11884adee20fSdanielk1977 int sqlite3ExprIsInteger(Expr *p, int *pValue){
118992b01d53Sdrh   int rc = 0;
119092b01d53Sdrh   if( p->flags & EP_IntValue ){
119133e619fcSdrh     *pValue = p->u.iValue;
1192e4de1febSdrh     return 1;
1193e4de1febSdrh   }
119492b01d53Sdrh   switch( p->op ){
119592b01d53Sdrh     case TK_INTEGER: {
119633e619fcSdrh       rc = sqlite3GetInt32(p->u.zToken, pValue);
119733e619fcSdrh       assert( rc==0 );
1198202b2df7Sdrh       break;
1199202b2df7Sdrh     }
12004b59ab5eSdrh     case TK_UPLUS: {
120192b01d53Sdrh       rc = sqlite3ExprIsInteger(p->pLeft, pValue);
1202f6e369a1Sdrh       break;
12034b59ab5eSdrh     }
1204e4de1febSdrh     case TK_UMINUS: {
1205e4de1febSdrh       int v;
12064adee20fSdanielk1977       if( sqlite3ExprIsInteger(p->pLeft, &v) ){
1207e4de1febSdrh         *pValue = -v;
120892b01d53Sdrh         rc = 1;
1209e4de1febSdrh       }
1210e4de1febSdrh       break;
1211e4de1febSdrh     }
1212e4de1febSdrh     default: break;
1213e4de1febSdrh   }
121492b01d53Sdrh   if( rc ){
121533e619fcSdrh     assert( ExprHasAnyProperty(p, EP_Reduced|EP_TokenOnly)
121633e619fcSdrh                || (p->flags2 & EP2_MallocedToken)==0 );
121792b01d53Sdrh     p->op = TK_INTEGER;
121892b01d53Sdrh     p->flags |= EP_IntValue;
121933e619fcSdrh     p->u.iValue = *pValue;
122092b01d53Sdrh   }
122192b01d53Sdrh   return rc;
1222e4de1febSdrh }
1223e4de1febSdrh 
1224e4de1febSdrh /*
1225039fc32eSdrh ** Return FALSE if there is no chance that the expression can be NULL.
1226039fc32eSdrh **
1227039fc32eSdrh ** If the expression might be NULL or if the expression is too complex
1228039fc32eSdrh ** to tell return TRUE.
1229039fc32eSdrh **
1230039fc32eSdrh ** This routine is used as an optimization, to skip OP_IsNull opcodes
1231039fc32eSdrh ** when we know that a value cannot be NULL.  Hence, a false positive
1232039fc32eSdrh ** (returning TRUE when in fact the expression can never be NULL) might
1233039fc32eSdrh ** be a small performance hit but is otherwise harmless.  On the other
1234039fc32eSdrh ** hand, a false negative (returning FALSE when the result could be NULL)
1235039fc32eSdrh ** will likely result in an incorrect answer.  So when in doubt, return
1236039fc32eSdrh ** TRUE.
1237039fc32eSdrh */
1238039fc32eSdrh int sqlite3ExprCanBeNull(const Expr *p){
1239039fc32eSdrh   u8 op;
1240cd7f457eSdrh   while( p->op==TK_UPLUS || p->op==TK_UMINUS ){ p = p->pLeft; }
1241039fc32eSdrh   op = p->op;
1242039fc32eSdrh   if( op==TK_REGISTER ) op = p->op2;
1243039fc32eSdrh   switch( op ){
1244039fc32eSdrh     case TK_INTEGER:
1245039fc32eSdrh     case TK_STRING:
1246039fc32eSdrh     case TK_FLOAT:
1247039fc32eSdrh     case TK_BLOB:
1248039fc32eSdrh       return 0;
1249039fc32eSdrh     default:
1250039fc32eSdrh       return 1;
1251039fc32eSdrh   }
1252039fc32eSdrh }
1253039fc32eSdrh 
1254039fc32eSdrh /*
12552f2855b6Sdrh ** Generate an OP_IsNull instruction that tests register iReg and jumps
12562f2855b6Sdrh ** to location iDest if the value in iReg is NULL.  The value in iReg
12572f2855b6Sdrh ** was computed by pExpr.  If we can look at pExpr at compile-time and
12582f2855b6Sdrh ** determine that it can never generate a NULL, then the OP_IsNull operation
12592f2855b6Sdrh ** can be omitted.
12602f2855b6Sdrh */
12612f2855b6Sdrh void sqlite3ExprCodeIsNullJump(
12622f2855b6Sdrh   Vdbe *v,            /* The VDBE under construction */
12632f2855b6Sdrh   const Expr *pExpr,  /* Only generate OP_IsNull if this expr can be NULL */
12642f2855b6Sdrh   int iReg,           /* Test the value in this register for NULL */
12652f2855b6Sdrh   int iDest           /* Jump here if the value is null */
12662f2855b6Sdrh ){
12672f2855b6Sdrh   if( sqlite3ExprCanBeNull(pExpr) ){
12682f2855b6Sdrh     sqlite3VdbeAddOp2(v, OP_IsNull, iReg, iDest);
12692f2855b6Sdrh   }
12702f2855b6Sdrh }
12712f2855b6Sdrh 
12722f2855b6Sdrh /*
1273039fc32eSdrh ** Return TRUE if the given expression is a constant which would be
1274039fc32eSdrh ** unchanged by OP_Affinity with the affinity given in the second
1275039fc32eSdrh ** argument.
1276039fc32eSdrh **
1277039fc32eSdrh ** This routine is used to determine if the OP_Affinity operation
1278039fc32eSdrh ** can be omitted.  When in doubt return FALSE.  A false negative
1279039fc32eSdrh ** is harmless.  A false positive, however, can result in the wrong
1280039fc32eSdrh ** answer.
1281039fc32eSdrh */
1282039fc32eSdrh int sqlite3ExprNeedsNoAffinityChange(const Expr *p, char aff){
1283039fc32eSdrh   u8 op;
1284039fc32eSdrh   if( aff==SQLITE_AFF_NONE ) return 1;
1285cd7f457eSdrh   while( p->op==TK_UPLUS || p->op==TK_UMINUS ){ p = p->pLeft; }
1286039fc32eSdrh   op = p->op;
1287039fc32eSdrh   if( op==TK_REGISTER ) op = p->op2;
1288039fc32eSdrh   switch( op ){
1289039fc32eSdrh     case TK_INTEGER: {
1290039fc32eSdrh       return aff==SQLITE_AFF_INTEGER || aff==SQLITE_AFF_NUMERIC;
1291039fc32eSdrh     }
1292039fc32eSdrh     case TK_FLOAT: {
1293039fc32eSdrh       return aff==SQLITE_AFF_REAL || aff==SQLITE_AFF_NUMERIC;
1294039fc32eSdrh     }
1295039fc32eSdrh     case TK_STRING: {
1296039fc32eSdrh       return aff==SQLITE_AFF_TEXT;
1297039fc32eSdrh     }
1298039fc32eSdrh     case TK_BLOB: {
1299039fc32eSdrh       return 1;
1300039fc32eSdrh     }
13012f2855b6Sdrh     case TK_COLUMN: {
130288376ca7Sdrh       assert( p->iTable>=0 );  /* p cannot be part of a CHECK constraint */
130388376ca7Sdrh       return p->iColumn<0
13042f2855b6Sdrh           && (aff==SQLITE_AFF_INTEGER || aff==SQLITE_AFF_NUMERIC);
13052f2855b6Sdrh     }
1306039fc32eSdrh     default: {
1307039fc32eSdrh       return 0;
1308039fc32eSdrh     }
1309039fc32eSdrh   }
1310039fc32eSdrh }
1311039fc32eSdrh 
1312039fc32eSdrh /*
1313c4a3c779Sdrh ** Return TRUE if the given string is a row-id column name.
1314c4a3c779Sdrh */
13154adee20fSdanielk1977 int sqlite3IsRowid(const char *z){
13164adee20fSdanielk1977   if( sqlite3StrICmp(z, "_ROWID_")==0 ) return 1;
13174adee20fSdanielk1977   if( sqlite3StrICmp(z, "ROWID")==0 ) return 1;
13184adee20fSdanielk1977   if( sqlite3StrICmp(z, "OID")==0 ) return 1;
1319c4a3c779Sdrh   return 0;
1320c4a3c779Sdrh }
1321c4a3c779Sdrh 
13229a96b668Sdanielk1977 /*
1323b74b1017Sdrh ** Return true if we are able to the IN operator optimization on a
1324b74b1017Sdrh ** query of the form
1325b287f4b6Sdrh **
1326b74b1017Sdrh **       x IN (SELECT ...)
1327b287f4b6Sdrh **
1328b74b1017Sdrh ** Where the SELECT... clause is as specified by the parameter to this
1329b74b1017Sdrh ** routine.
1330b74b1017Sdrh **
1331b74b1017Sdrh ** The Select object passed in has already been preprocessed and no
1332b74b1017Sdrh ** errors have been found.
1333b287f4b6Sdrh */
1334b287f4b6Sdrh #ifndef SQLITE_OMIT_SUBQUERY
1335b287f4b6Sdrh static int isCandidateForInOpt(Select *p){
1336b287f4b6Sdrh   SrcList *pSrc;
1337b287f4b6Sdrh   ExprList *pEList;
1338b287f4b6Sdrh   Table *pTab;
1339b287f4b6Sdrh   if( p==0 ) return 0;                   /* right-hand side of IN is SELECT */
1340b287f4b6Sdrh   if( p->pPrior ) return 0;              /* Not a compound SELECT */
13417d10d5a6Sdrh   if( p->selFlags & (SF_Distinct|SF_Aggregate) ){
1342b74b1017Sdrh     testcase( (p->selFlags & (SF_Distinct|SF_Aggregate))==SF_Distinct );
1343b74b1017Sdrh     testcase( (p->selFlags & (SF_Distinct|SF_Aggregate))==SF_Aggregate );
13447d10d5a6Sdrh     return 0; /* No DISTINCT keyword and no aggregate functions */
13457d10d5a6Sdrh   }
1346b74b1017Sdrh   assert( p->pGroupBy==0 );              /* Has no GROUP BY clause */
1347b287f4b6Sdrh   if( p->pLimit ) return 0;              /* Has no LIMIT clause */
1348b74b1017Sdrh   assert( p->pOffset==0 );               /* No LIMIT means no OFFSET */
1349b287f4b6Sdrh   if( p->pWhere ) return 0;              /* Has no WHERE clause */
1350b287f4b6Sdrh   pSrc = p->pSrc;
1351d1fa7bcaSdrh   assert( pSrc!=0 );
1352d1fa7bcaSdrh   if( pSrc->nSrc!=1 ) return 0;          /* Single term in FROM clause */
1353b74b1017Sdrh   if( pSrc->a[0].pSelect ) return 0;     /* FROM is not a subquery or view */
1354b287f4b6Sdrh   pTab = pSrc->a[0].pTab;
1355b74b1017Sdrh   if( NEVER(pTab==0) ) return 0;
1356b74b1017Sdrh   assert( pTab->pSelect==0 );            /* FROM clause is not a view */
1357b287f4b6Sdrh   if( IsVirtual(pTab) ) return 0;        /* FROM clause not a virtual table */
1358b287f4b6Sdrh   pEList = p->pEList;
1359b287f4b6Sdrh   if( pEList->nExpr!=1 ) return 0;       /* One column in the result set */
1360b287f4b6Sdrh   if( pEList->a[0].pExpr->op!=TK_COLUMN ) return 0; /* Result is a column */
1361b287f4b6Sdrh   return 1;
1362b287f4b6Sdrh }
1363b287f4b6Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
1364b287f4b6Sdrh 
1365b287f4b6Sdrh /*
13669a96b668Sdanielk1977 ** This function is used by the implementation of the IN (...) operator.
13679a96b668Sdanielk1977 ** It's job is to find or create a b-tree structure that may be used
13689a96b668Sdanielk1977 ** either to test for membership of the (...) set or to iterate through
136985b623f2Sdrh ** its members, skipping duplicates.
13709a96b668Sdanielk1977 **
1371b74b1017Sdrh ** The index of the cursor opened on the b-tree (database table, database index
13729a96b668Sdanielk1977 ** or ephermal table) is stored in pX->iTable before this function returns.
1373b74b1017Sdrh ** The returned value of this function indicates the b-tree type, as follows:
13749a96b668Sdanielk1977 **
13759a96b668Sdanielk1977 **   IN_INDEX_ROWID - The cursor was opened on a database table.
13762d401ab8Sdrh **   IN_INDEX_INDEX - The cursor was opened on a database index.
13779a96b668Sdanielk1977 **   IN_INDEX_EPH -   The cursor was opened on a specially created and
13789a96b668Sdanielk1977 **                    populated epheremal table.
13799a96b668Sdanielk1977 **
1380b74b1017Sdrh ** An existing b-tree may only be used if the SELECT is of the simple
13819a96b668Sdanielk1977 ** form:
13829a96b668Sdanielk1977 **
13839a96b668Sdanielk1977 **     SELECT <column> FROM <table>
13849a96b668Sdanielk1977 **
1385b74b1017Sdrh ** If the prNotFound parameter is 0, then the b-tree will be used to iterate
13869a96b668Sdanielk1977 ** through the set members, skipping any duplicates. In this case an
13879a96b668Sdanielk1977 ** epheremal table must be used unless the selected <column> is guaranteed
13889a96b668Sdanielk1977 ** to be unique - either because it is an INTEGER PRIMARY KEY or it
1389b74b1017Sdrh ** has a UNIQUE constraint or UNIQUE index.
13900cdc022eSdanielk1977 **
1391b74b1017Sdrh ** If the prNotFound parameter is not 0, then the b-tree will be used
13920cdc022eSdanielk1977 ** for fast set membership tests. In this case an epheremal table must
13930cdc022eSdanielk1977 ** be used unless <column> is an INTEGER PRIMARY KEY or an index can
13940cdc022eSdanielk1977 ** be found with <column> as its left-most column.
13950cdc022eSdanielk1977 **
1396b74b1017Sdrh ** When the b-tree is being used for membership tests, the calling function
13970cdc022eSdanielk1977 ** needs to know whether or not the structure contains an SQL NULL
13980cdc022eSdanielk1977 ** value in order to correctly evaluate expressions like "X IN (Y, Z)".
1399e3365e6cSdrh ** If there is any chance that the (...) might contain a NULL value at
14000cdc022eSdanielk1977 ** runtime, then a register is allocated and the register number written
1401e3365e6cSdrh ** to *prNotFound. If there is no chance that the (...) contains a
14020cdc022eSdanielk1977 ** NULL value, then *prNotFound is left unchanged.
14030cdc022eSdanielk1977 **
14040cdc022eSdanielk1977 ** If a register is allocated and its location stored in *prNotFound, then
1405e3365e6cSdrh ** its initial value is NULL.  If the (...) does not remain constant
1406e3365e6cSdrh ** for the duration of the query (i.e. the SELECT within the (...)
1407b74b1017Sdrh ** is a correlated subquery) then the value of the allocated register is
1408e3365e6cSdrh ** reset to NULL each time the subquery is rerun. This allows the
1409b74b1017Sdrh ** caller to use vdbe code equivalent to the following:
14100cdc022eSdanielk1977 **
14110cdc022eSdanielk1977 **   if( register==NULL ){
14120cdc022eSdanielk1977 **     has_null = <test if data structure contains null>
14130cdc022eSdanielk1977 **     register = 1
14140cdc022eSdanielk1977 **   }
14150cdc022eSdanielk1977 **
14160cdc022eSdanielk1977 ** in order to avoid running the <test if data structure contains null>
14170cdc022eSdanielk1977 ** test more often than is necessary.
14189a96b668Sdanielk1977 */
1419284f4acaSdanielk1977 #ifndef SQLITE_OMIT_SUBQUERY
14200cdc022eSdanielk1977 int sqlite3FindInIndex(Parse *pParse, Expr *pX, int *prNotFound){
1421b74b1017Sdrh   Select *p;                            /* SELECT to the right of IN operator */
1422b74b1017Sdrh   int eType = 0;                        /* Type of RHS table. IN_INDEX_* */
1423b74b1017Sdrh   int iTab = pParse->nTab++;            /* Cursor of the RHS table */
1424b74b1017Sdrh   int mustBeUnique = (prNotFound==0);   /* True if RHS must be unique */
14259a96b668Sdanielk1977 
14261450bc6eSdrh   assert( pX->op==TK_IN );
14271450bc6eSdrh 
1428b74b1017Sdrh   /* Check to see if an existing table or index can be used to
1429b74b1017Sdrh   ** satisfy the query.  This is preferable to generating a new
1430b74b1017Sdrh   ** ephemeral table.
14319a96b668Sdanielk1977   */
14326ab3a2ecSdanielk1977   p = (ExprHasProperty(pX, EP_xIsSelect) ? pX->x.pSelect : 0);
1433fd773cf9Sdrh   if( ALWAYS(pParse->nErr==0) && isCandidateForInOpt(p) ){
1434e1fb65a0Sdanielk1977     sqlite3 *db = pParse->db;              /* Database connection */
1435e1fb65a0Sdanielk1977     Expr *pExpr = p->pEList->a[0].pExpr;   /* Expression <column> */
1436e1fb65a0Sdanielk1977     int iCol = pExpr->iColumn;             /* Index of column <column> */
1437e1fb65a0Sdanielk1977     Vdbe *v = sqlite3GetVdbe(pParse);      /* Virtual machine being coded */
1438e1fb65a0Sdanielk1977     Table *pTab = p->pSrc->a[0].pTab;      /* Table <table>. */
1439e1fb65a0Sdanielk1977     int iDb;                               /* Database idx for pTab */
1440e1fb65a0Sdanielk1977 
1441e1fb65a0Sdanielk1977     /* Code an OP_VerifyCookie and OP_TableLock for <table>. */
1442e1fb65a0Sdanielk1977     iDb = sqlite3SchemaToIndex(db, pTab->pSchema);
1443e1fb65a0Sdanielk1977     sqlite3CodeVerifySchema(pParse, iDb);
1444e1fb65a0Sdanielk1977     sqlite3TableLock(pParse, iDb, pTab->tnum, 0, pTab->zName);
14459a96b668Sdanielk1977 
14469a96b668Sdanielk1977     /* This function is only called from two places. In both cases the vdbe
14479a96b668Sdanielk1977     ** has already been allocated. So assume sqlite3GetVdbe() is always
14489a96b668Sdanielk1977     ** successful here.
14499a96b668Sdanielk1977     */
14509a96b668Sdanielk1977     assert(v);
14519a96b668Sdanielk1977     if( iCol<0 ){
14520a07c107Sdrh       int iMem = ++pParse->nMem;
14539a96b668Sdanielk1977       int iAddr;
14549a96b668Sdanielk1977 
1455892d3179Sdrh       iAddr = sqlite3VdbeAddOp1(v, OP_If, iMem);
14564c583128Sdrh       sqlite3VdbeAddOp2(v, OP_Integer, 1, iMem);
14579a96b668Sdanielk1977 
14589a96b668Sdanielk1977       sqlite3OpenTable(pParse, iTab, iDb, pTab, OP_OpenRead);
14599a96b668Sdanielk1977       eType = IN_INDEX_ROWID;
14609a96b668Sdanielk1977 
14619a96b668Sdanielk1977       sqlite3VdbeJumpHere(v, iAddr);
14629a96b668Sdanielk1977     }else{
1463e1fb65a0Sdanielk1977       Index *pIdx;                         /* Iterator variable */
1464e1fb65a0Sdanielk1977 
14659a96b668Sdanielk1977       /* The collation sequence used by the comparison. If an index is to
14669a96b668Sdanielk1977       ** be used in place of a temp-table, it must be ordered according
1467e1fb65a0Sdanielk1977       ** to this collation sequence.  */
14689a96b668Sdanielk1977       CollSeq *pReq = sqlite3BinaryCompareCollSeq(pParse, pX->pLeft, pExpr);
14699a96b668Sdanielk1977 
14709a96b668Sdanielk1977       /* Check that the affinity that will be used to perform the
14719a96b668Sdanielk1977       ** comparison is the same as the affinity of the column. If
14729a96b668Sdanielk1977       ** it is not, it is not possible to use any index.
14739a96b668Sdanielk1977       */
14749a96b668Sdanielk1977       char aff = comparisonAffinity(pX);
14759a96b668Sdanielk1977       int affinity_ok = (pTab->aCol[iCol].affinity==aff||aff==SQLITE_AFF_NONE);
14769a96b668Sdanielk1977 
14779a96b668Sdanielk1977       for(pIdx=pTab->pIndex; pIdx && eType==0 && affinity_ok; pIdx=pIdx->pNext){
14789a96b668Sdanielk1977         if( (pIdx->aiColumn[0]==iCol)
1479b74b1017Sdrh          && sqlite3FindCollSeq(db, ENC(db), pIdx->azColl[0], 0)==pReq
14809a96b668Sdanielk1977          && (!mustBeUnique || (pIdx->nColumn==1 && pIdx->onError!=OE_None))
14819a96b668Sdanielk1977         ){
14820a07c107Sdrh           int iMem = ++pParse->nMem;
14839a96b668Sdanielk1977           int iAddr;
14849a96b668Sdanielk1977           char *pKey;
14859a96b668Sdanielk1977 
14869a96b668Sdanielk1977           pKey = (char *)sqlite3IndexKeyinfo(pParse, pIdx);
1487892d3179Sdrh           iAddr = sqlite3VdbeAddOp1(v, OP_If, iMem);
14884c583128Sdrh           sqlite3VdbeAddOp2(v, OP_Integer, 1, iMem);
14899a96b668Sdanielk1977 
1490207872a4Sdanielk1977           sqlite3VdbeAddOp4(v, OP_OpenRead, iTab, pIdx->tnum, iDb,
149166a5167bSdrh                                pKey,P4_KEYINFO_HANDOFF);
1492207872a4Sdanielk1977           VdbeComment((v, "%s", pIdx->zName));
14939a96b668Sdanielk1977           eType = IN_INDEX_INDEX;
14949a96b668Sdanielk1977 
14959a96b668Sdanielk1977           sqlite3VdbeJumpHere(v, iAddr);
14960cdc022eSdanielk1977           if( prNotFound && !pTab->aCol[iCol].notNull ){
14970cdc022eSdanielk1977             *prNotFound = ++pParse->nMem;
14980cdc022eSdanielk1977           }
14999a96b668Sdanielk1977         }
15009a96b668Sdanielk1977       }
15019a96b668Sdanielk1977     }
15029a96b668Sdanielk1977   }
15039a96b668Sdanielk1977 
15049a96b668Sdanielk1977   if( eType==0 ){
15051450bc6eSdrh     /* Could not found an existing table or index to use as the RHS b-tree.
1506b74b1017Sdrh     ** We will have to generate an ephemeral table to do the job.
1507b74b1017Sdrh     */
15080cdc022eSdanielk1977     int rMayHaveNull = 0;
150941a05b7bSdanielk1977     eType = IN_INDEX_EPH;
15100cdc022eSdanielk1977     if( prNotFound ){
15110cdc022eSdanielk1977       *prNotFound = rMayHaveNull = ++pParse->nMem;
15126ab3a2ecSdanielk1977     }else if( pX->pLeft->iColumn<0 && !ExprHasAnyProperty(pX, EP_xIsSelect) ){
151341a05b7bSdanielk1977       eType = IN_INDEX_ROWID;
15140cdc022eSdanielk1977     }
151541a05b7bSdanielk1977     sqlite3CodeSubselect(pParse, pX, rMayHaveNull, eType==IN_INDEX_ROWID);
15169a96b668Sdanielk1977   }else{
15179a96b668Sdanielk1977     pX->iTable = iTab;
15189a96b668Sdanielk1977   }
15199a96b668Sdanielk1977   return eType;
15209a96b668Sdanielk1977 }
1521284f4acaSdanielk1977 #endif
1522626a879aSdrh 
1523626a879aSdrh /*
15249cbe6352Sdrh ** Generate code for scalar subqueries used as an expression
15259cbe6352Sdrh ** and IN operators.  Examples:
1526626a879aSdrh **
15279cbe6352Sdrh **     (SELECT a FROM b)          -- subquery
15289cbe6352Sdrh **     EXISTS (SELECT a FROM b)   -- EXISTS subquery
15299cbe6352Sdrh **     x IN (4,5,11)              -- IN operator with list on right-hand side
15309cbe6352Sdrh **     x IN (SELECT a FROM b)     -- IN operator with subquery on the right
1531fef5208cSdrh **
15329cbe6352Sdrh ** The pExpr parameter describes the expression that contains the IN
15339cbe6352Sdrh ** operator or subquery.
153441a05b7bSdanielk1977 **
153541a05b7bSdanielk1977 ** If parameter isRowid is non-zero, then expression pExpr is guaranteed
153641a05b7bSdanielk1977 ** to be of the form "<rowid> IN (?, ?, ?)", where <rowid> is a reference
153741a05b7bSdanielk1977 ** to some integer key column of a table B-Tree. In this case, use an
153841a05b7bSdanielk1977 ** intkey B-Tree to store the set of IN(...) values instead of the usual
153941a05b7bSdanielk1977 ** (slower) variable length keys B-Tree.
1540fd773cf9Sdrh **
1541fd773cf9Sdrh ** If rMayHaveNull is non-zero, that means that the operation is an IN
1542fd773cf9Sdrh ** (not a SELECT or EXISTS) and that the RHS might contains NULLs.
1543fd773cf9Sdrh ** Furthermore, the IN is in a WHERE clause and that we really want
1544fd773cf9Sdrh ** to iterate over the RHS of the IN operator in order to quickly locate
1545fd773cf9Sdrh ** all corresponding LHS elements.  All this routine does is initialize
1546fd773cf9Sdrh ** the register given by rMayHaveNull to NULL.  Calling routines will take
1547fd773cf9Sdrh ** care of changing this register value to non-NULL if the RHS is NULL-free.
1548fd773cf9Sdrh **
1549fd773cf9Sdrh ** If rMayHaveNull is zero, that means that the subquery is being used
1550fd773cf9Sdrh ** for membership testing only.  There is no need to initialize any
1551fd773cf9Sdrh ** registers to indicate the presense or absence of NULLs on the RHS.
15521450bc6eSdrh **
15531450bc6eSdrh ** For a SELECT or EXISTS operator, return the register that holds the
15541450bc6eSdrh ** result.  For IN operators or if an error occurs, the return value is 0.
1555cce7d176Sdrh */
155651522cd3Sdrh #ifndef SQLITE_OMIT_SUBQUERY
15571450bc6eSdrh int sqlite3CodeSubselect(
1558fd773cf9Sdrh   Parse *pParse,          /* Parsing context */
1559fd773cf9Sdrh   Expr *pExpr,            /* The IN, SELECT, or EXISTS operator */
1560fd773cf9Sdrh   int rMayHaveNull,       /* Register that records whether NULLs exist in RHS */
1561fd773cf9Sdrh   int isRowid             /* If true, LHS of IN operator is a rowid */
156241a05b7bSdanielk1977 ){
156357dbd7b3Sdrh   int testAddr = 0;                       /* One-time test address */
15641450bc6eSdrh   int rReg = 0;                           /* Register storing resulting */
1565b3bce662Sdanielk1977   Vdbe *v = sqlite3GetVdbe(pParse);
15661450bc6eSdrh   if( NEVER(v==0) ) return 0;
1567ceea3321Sdrh   sqlite3ExprCachePush(pParse);
1568fc976065Sdanielk1977 
156957dbd7b3Sdrh   /* This code must be run in its entirety every time it is encountered
157057dbd7b3Sdrh   ** if any of the following is true:
157157dbd7b3Sdrh   **
157257dbd7b3Sdrh   **    *  The right-hand side is a correlated subquery
157357dbd7b3Sdrh   **    *  The right-hand side is an expression list containing variables
157457dbd7b3Sdrh   **    *  We are inside a trigger
157557dbd7b3Sdrh   **
157657dbd7b3Sdrh   ** If all of the above are false, then we can run this code just once
157757dbd7b3Sdrh   ** save the results, and reuse the same result on subsequent invocations.
1578b3bce662Sdanielk1977   */
1579165921a7Sdan   if( !ExprHasAnyProperty(pExpr, EP_VarSelect) && !pParse->pTriggerTab ){
15800a07c107Sdrh     int mem = ++pParse->nMem;
1581892d3179Sdrh     sqlite3VdbeAddOp1(v, OP_If, mem);
1582892d3179Sdrh     testAddr = sqlite3VdbeAddOp2(v, OP_Integer, 1, mem);
158317435752Sdrh     assert( testAddr>0 || pParse->db->mallocFailed );
1584b3bce662Sdanielk1977   }
1585b3bce662Sdanielk1977 
1586cce7d176Sdrh   switch( pExpr->op ){
1587fef5208cSdrh     case TK_IN: {
1588e014a838Sdanielk1977       char affinity;
1589d3d39e93Sdrh       KeyInfo keyInfo;
1590b9bb7c18Sdrh       int addr;        /* Address of OP_OpenEphemeral instruction */
159141a05b7bSdanielk1977       Expr *pLeft = pExpr->pLeft;
1592d3d39e93Sdrh 
15930cdc022eSdanielk1977       if( rMayHaveNull ){
15940cdc022eSdanielk1977         sqlite3VdbeAddOp2(v, OP_Null, 0, rMayHaveNull);
15950cdc022eSdanielk1977       }
15960cdc022eSdanielk1977 
159741a05b7bSdanielk1977       affinity = sqlite3ExprAffinity(pLeft);
1598e014a838Sdanielk1977 
1599e014a838Sdanielk1977       /* Whether this is an 'x IN(SELECT...)' or an 'x IN(<exprlist>)'
16008cff69dfSdrh       ** expression it is handled the same way.  An ephemeral table is
1601e014a838Sdanielk1977       ** filled with single-field index keys representing the results
1602e014a838Sdanielk1977       ** from the SELECT or the <exprlist>.
1603fef5208cSdrh       **
1604e014a838Sdanielk1977       ** If the 'x' expression is a column value, or the SELECT...
1605e014a838Sdanielk1977       ** statement returns a column value, then the affinity of that
1606e014a838Sdanielk1977       ** column is used to build the index keys. If both 'x' and the
1607e014a838Sdanielk1977       ** SELECT... statement are columns, then numeric affinity is used
1608e014a838Sdanielk1977       ** if either column has NUMERIC or INTEGER affinity. If neither
1609e014a838Sdanielk1977       ** 'x' nor the SELECT... statement are columns, then numeric affinity
1610e014a838Sdanielk1977       ** is used.
1611fef5208cSdrh       */
1612832508b7Sdrh       pExpr->iTable = pParse->nTab++;
161341a05b7bSdanielk1977       addr = sqlite3VdbeAddOp2(v, OP_OpenEphemeral, pExpr->iTable, !isRowid);
1614d3d39e93Sdrh       memset(&keyInfo, 0, sizeof(keyInfo));
1615d3d39e93Sdrh       keyInfo.nField = 1;
1616e014a838Sdanielk1977 
16176ab3a2ecSdanielk1977       if( ExprHasProperty(pExpr, EP_xIsSelect) ){
1618e014a838Sdanielk1977         /* Case 1:     expr IN (SELECT ...)
1619e014a838Sdanielk1977         **
1620e014a838Sdanielk1977         ** Generate code to write the results of the select into the temporary
1621e014a838Sdanielk1977         ** table allocated and opened above.
1622e014a838Sdanielk1977         */
16231013c932Sdrh         SelectDest dest;
1624be5c89acSdrh         ExprList *pEList;
16251013c932Sdrh 
162641a05b7bSdanielk1977         assert( !isRowid );
16271013c932Sdrh         sqlite3SelectDestInit(&dest, SRT_Set, pExpr->iTable);
16281bd10f8aSdrh         dest.affinity = (u8)affinity;
1629e014a838Sdanielk1977         assert( (pExpr->iTable&0x0000FFFF)==pExpr->iTable );
16306ab3a2ecSdanielk1977         if( sqlite3Select(pParse, pExpr->x.pSelect, &dest) ){
16311450bc6eSdrh           return 0;
163294ccde58Sdrh         }
16336ab3a2ecSdanielk1977         pEList = pExpr->x.pSelect->pEList;
1634fd773cf9Sdrh         if( ALWAYS(pEList!=0 && pEList->nExpr>0) ){
1635bcbb04e5Sdanielk1977           keyInfo.aColl[0] = sqlite3BinaryCompareCollSeq(pParse, pExpr->pLeft,
1636be5c89acSdrh               pEList->a[0].pExpr);
16370202b29eSdanielk1977         }
1638fd773cf9Sdrh       }else if( pExpr->x.pList!=0 ){
1639fef5208cSdrh         /* Case 2:     expr IN (exprlist)
1640fef5208cSdrh         **
1641e014a838Sdanielk1977         ** For each expression, build an index key from the evaluation and
1642e014a838Sdanielk1977         ** store it in the temporary table. If <expr> is a column, then use
1643e014a838Sdanielk1977         ** that columns affinity when building index keys. If <expr> is not
1644e014a838Sdanielk1977         ** a column, use numeric affinity.
1645fef5208cSdrh         */
1646e014a838Sdanielk1977         int i;
16476ab3a2ecSdanielk1977         ExprList *pList = pExpr->x.pList;
164857dbd7b3Sdrh         struct ExprList_item *pItem;
1649ecc31805Sdrh         int r1, r2, r3;
165057dbd7b3Sdrh 
1651e014a838Sdanielk1977         if( !affinity ){
16528159a35fSdrh           affinity = SQLITE_AFF_NONE;
1653e014a838Sdanielk1977         }
16547d10d5a6Sdrh         keyInfo.aColl[0] = sqlite3ExprCollSeq(pParse, pExpr->pLeft);
1655e014a838Sdanielk1977 
1656e014a838Sdanielk1977         /* Loop through each expression in <exprlist>. */
16572d401ab8Sdrh         r1 = sqlite3GetTempReg(pParse);
16582d401ab8Sdrh         r2 = sqlite3GetTempReg(pParse);
16594e7f36a2Sdanielk1977         sqlite3VdbeAddOp2(v, OP_Null, 0, r2);
166057dbd7b3Sdrh         for(i=pList->nExpr, pItem=pList->a; i>0; i--, pItem++){
166157dbd7b3Sdrh           Expr *pE2 = pItem->pExpr;
1662e05c929bSdrh           int iValToIns;
1663e014a838Sdanielk1977 
166457dbd7b3Sdrh           /* If the expression is not constant then we will need to
166557dbd7b3Sdrh           ** disable the test that was generated above that makes sure
166657dbd7b3Sdrh           ** this code only executes once.  Because for a non-constant
166757dbd7b3Sdrh           ** expression we need to rerun this code each time.
166857dbd7b3Sdrh           */
1669892d3179Sdrh           if( testAddr && !sqlite3ExprIsConstant(pE2) ){
1670892d3179Sdrh             sqlite3VdbeChangeToNoop(v, testAddr-1, 2);
167157dbd7b3Sdrh             testAddr = 0;
16724794b980Sdrh           }
1673e014a838Sdanielk1977 
1674e014a838Sdanielk1977           /* Evaluate the expression and insert it into the temp table */
1675e05c929bSdrh           if( isRowid && sqlite3ExprIsInteger(pE2, &iValToIns) ){
1676e05c929bSdrh             sqlite3VdbeAddOp3(v, OP_InsertInt, pExpr->iTable, r2, iValToIns);
1677e05c929bSdrh           }else{
1678ecc31805Sdrh             r3 = sqlite3ExprCodeTarget(pParse, pE2, r1);
167941a05b7bSdanielk1977             if( isRowid ){
1680e05c929bSdrh               sqlite3VdbeAddOp2(v, OP_MustBeInt, r3,
1681e05c929bSdrh                                 sqlite3VdbeCurrentAddr(v)+2);
168241a05b7bSdanielk1977               sqlite3VdbeAddOp3(v, OP_Insert, pExpr->iTable, r2, r3);
168341a05b7bSdanielk1977             }else{
1684ecc31805Sdrh               sqlite3VdbeAddOp4(v, OP_MakeRecord, r3, 1, r2, &affinity, 1);
16853c31fc23Sdrh               sqlite3ExprCacheAffinityChange(pParse, r3, 1);
16862d401ab8Sdrh               sqlite3VdbeAddOp2(v, OP_IdxInsert, pExpr->iTable, r2);
1687fef5208cSdrh             }
168841a05b7bSdanielk1977           }
1689e05c929bSdrh         }
16902d401ab8Sdrh         sqlite3ReleaseTempReg(pParse, r1);
16912d401ab8Sdrh         sqlite3ReleaseTempReg(pParse, r2);
1692fef5208cSdrh       }
169341a05b7bSdanielk1977       if( !isRowid ){
169466a5167bSdrh         sqlite3VdbeChangeP4(v, addr, (void *)&keyInfo, P4_KEYINFO);
169541a05b7bSdanielk1977       }
1696b3bce662Sdanielk1977       break;
1697fef5208cSdrh     }
1698fef5208cSdrh 
169951522cd3Sdrh     case TK_EXISTS:
1700fd773cf9Sdrh     case TK_SELECT:
1701fd773cf9Sdrh     default: {
1702fd773cf9Sdrh       /* If this has to be a scalar SELECT.  Generate code to put the
1703fef5208cSdrh       ** value of this select in a memory cell and record the number
1704fd773cf9Sdrh       ** of the memory cell in iColumn.  If this is an EXISTS, write
1705fd773cf9Sdrh       ** an integer 0 (not exists) or 1 (exists) into a memory cell
1706fd773cf9Sdrh       ** and record that memory cell in iColumn.
1707fef5208cSdrh       */
1708fd773cf9Sdrh       Select *pSel;                         /* SELECT statement to encode */
1709fd773cf9Sdrh       SelectDest dest;                      /* How to deal with SELECt result */
17101398ad36Sdrh 
1711cf697396Sshane       testcase( pExpr->op==TK_EXISTS );
1712cf697396Sshane       testcase( pExpr->op==TK_SELECT );
1713cf697396Sshane       assert( pExpr->op==TK_EXISTS || pExpr->op==TK_SELECT );
1714cf697396Sshane 
17156ab3a2ecSdanielk1977       assert( ExprHasProperty(pExpr, EP_xIsSelect) );
17166ab3a2ecSdanielk1977       pSel = pExpr->x.pSelect;
17171013c932Sdrh       sqlite3SelectDestInit(&dest, 0, ++pParse->nMem);
171851522cd3Sdrh       if( pExpr->op==TK_SELECT ){
17196c8c8ce0Sdanielk1977         dest.eDest = SRT_Mem;
17204c583128Sdrh         sqlite3VdbeAddOp2(v, OP_Null, 0, dest.iParm);
1721d4e70ebdSdrh         VdbeComment((v, "Init subquery result"));
172251522cd3Sdrh       }else{
17236c8c8ce0Sdanielk1977         dest.eDest = SRT_Exists;
17244c583128Sdrh         sqlite3VdbeAddOp2(v, OP_Integer, 0, dest.iParm);
1725d4e70ebdSdrh         VdbeComment((v, "Init EXISTS result"));
172651522cd3Sdrh       }
1727633e6d57Sdrh       sqlite3ExprDelete(pParse->db, pSel->pLimit);
1728*094430ebSdrh       pSel->pLimit = sqlite3PExpr(pParse, TK_INTEGER, 0, 0,
1729*094430ebSdrh                                   &sqlite3IntTokens[1]);
17307d10d5a6Sdrh       if( sqlite3Select(pParse, pSel, &dest) ){
17311450bc6eSdrh         return 0;
173294ccde58Sdrh       }
17331450bc6eSdrh       rReg = dest.iParm;
173433e619fcSdrh       ExprSetIrreducible(pExpr);
1735b3bce662Sdanielk1977       break;
173619a775c2Sdrh     }
1737cce7d176Sdrh   }
1738b3bce662Sdanielk1977 
173957dbd7b3Sdrh   if( testAddr ){
1740892d3179Sdrh     sqlite3VdbeJumpHere(v, testAddr-1);
1741b3bce662Sdanielk1977   }
1742ceea3321Sdrh   sqlite3ExprCachePop(pParse, 1);
1743fc976065Sdanielk1977 
17441450bc6eSdrh   return rReg;
1745cce7d176Sdrh }
174651522cd3Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
1747cce7d176Sdrh 
1748e3365e6cSdrh #ifndef SQLITE_OMIT_SUBQUERY
1749e3365e6cSdrh /*
1750e3365e6cSdrh ** Generate code for an IN expression.
1751e3365e6cSdrh **
1752e3365e6cSdrh **      x IN (SELECT ...)
1753e3365e6cSdrh **      x IN (value, value, ...)
1754e3365e6cSdrh **
1755e3365e6cSdrh ** The left-hand side (LHS) is a scalar expression.  The right-hand side (RHS)
1756e3365e6cSdrh ** is an array of zero or more values.  The expression is true if the LHS is
1757e3365e6cSdrh ** contained within the RHS.  The value of the expression is unknown (NULL)
1758e3365e6cSdrh ** if the LHS is NULL or if the LHS is not contained within the RHS and the
1759e3365e6cSdrh ** RHS contains one or more NULL values.
1760e3365e6cSdrh **
1761e3365e6cSdrh ** This routine generates code will jump to destIfFalse if the LHS is not
1762e3365e6cSdrh ** contained within the RHS.  If due to NULLs we cannot determine if the LHS
1763e3365e6cSdrh ** is contained in the RHS then jump to destIfNull.  If the LHS is contained
1764e3365e6cSdrh ** within the RHS then fall through.
1765e3365e6cSdrh */
1766e3365e6cSdrh static void sqlite3ExprCodeIN(
1767e3365e6cSdrh   Parse *pParse,        /* Parsing and code generating context */
1768e3365e6cSdrh   Expr *pExpr,          /* The IN expression */
1769e3365e6cSdrh   int destIfFalse,      /* Jump here if LHS is not contained in the RHS */
1770e3365e6cSdrh   int destIfNull        /* Jump here if the results are unknown due to NULLs */
1771e3365e6cSdrh ){
1772e3365e6cSdrh   int rRhsHasNull = 0;  /* Register that is true if RHS contains NULL values */
1773e3365e6cSdrh   char affinity;        /* Comparison affinity to use */
1774e3365e6cSdrh   int eType;            /* Type of the RHS */
1775e3365e6cSdrh   int r1;               /* Temporary use register */
1776e3365e6cSdrh   Vdbe *v;              /* Statement under construction */
1777e3365e6cSdrh 
1778e3365e6cSdrh   /* Compute the RHS.   After this step, the table with cursor
1779e3365e6cSdrh   ** pExpr->iTable will contains the values that make up the RHS.
1780e3365e6cSdrh   */
1781e3365e6cSdrh   v = pParse->pVdbe;
1782e3365e6cSdrh   assert( v!=0 );       /* OOM detected prior to this routine */
1783e3365e6cSdrh   VdbeNoopComment((v, "begin IN expr"));
1784e3365e6cSdrh   eType = sqlite3FindInIndex(pParse, pExpr, &rRhsHasNull);
1785e3365e6cSdrh 
1786e3365e6cSdrh   /* Figure out the affinity to use to create a key from the results
1787e3365e6cSdrh   ** of the expression. affinityStr stores a static string suitable for
1788e3365e6cSdrh   ** P4 of OP_MakeRecord.
1789e3365e6cSdrh   */
1790e3365e6cSdrh   affinity = comparisonAffinity(pExpr);
1791e3365e6cSdrh 
1792e3365e6cSdrh   /* Code the LHS, the <expr> from "<expr> IN (...)".
1793e3365e6cSdrh   */
1794e3365e6cSdrh   sqlite3ExprCachePush(pParse);
1795e3365e6cSdrh   r1 = sqlite3GetTempReg(pParse);
1796e3365e6cSdrh   sqlite3ExprCode(pParse, pExpr->pLeft, r1);
1797e3365e6cSdrh 
1798*094430ebSdrh   /* If the LHS is NULL, then the result is either false or NULL depending
1799*094430ebSdrh   ** on whether the RHS is empty or not, respectively.
1800*094430ebSdrh   */
1801*094430ebSdrh   if( destIfNull==destIfFalse ){
1802*094430ebSdrh     /* Shortcut for the common case where the false and NULL outcomes are
1803*094430ebSdrh     ** the same. */
1804*094430ebSdrh     sqlite3VdbeAddOp2(v, OP_IsNull, r1, destIfNull);
1805*094430ebSdrh   }else{
1806*094430ebSdrh     int addr1 = sqlite3VdbeAddOp1(v, OP_NotNull, r1);
1807*094430ebSdrh     sqlite3VdbeAddOp2(v, OP_Rewind, pExpr->iTable, destIfFalse);
1808*094430ebSdrh     sqlite3VdbeAddOp2(v, OP_Goto, 0, destIfNull);
1809*094430ebSdrh     sqlite3VdbeJumpHere(v, addr1);
1810*094430ebSdrh   }
1811e3365e6cSdrh 
1812e3365e6cSdrh   if( eType==IN_INDEX_ROWID ){
1813e3365e6cSdrh     /* In this case, the RHS is the ROWID of table b-tree
1814e3365e6cSdrh     */
1815e3365e6cSdrh     sqlite3VdbeAddOp2(v, OP_MustBeInt, r1, destIfFalse);
1816e3365e6cSdrh     sqlite3VdbeAddOp3(v, OP_NotExists, pExpr->iTable, destIfFalse, r1);
1817e3365e6cSdrh   }else{
1818e3365e6cSdrh     /* In this case, the RHS is an index b-tree.
1819e3365e6cSdrh     */
18208cff69dfSdrh     sqlite3VdbeAddOp4(v, OP_Affinity, r1, 1, 0, &affinity, 1);
1821e3365e6cSdrh 
1822e3365e6cSdrh     /* If the set membership test fails, then the result of the
1823e3365e6cSdrh     ** "x IN (...)" expression must be either 0 or NULL. If the set
1824e3365e6cSdrh     ** contains no NULL values, then the result is 0. If the set
1825e3365e6cSdrh     ** contains one or more NULL values, then the result of the
1826e3365e6cSdrh     ** expression is also NULL.
1827e3365e6cSdrh     */
1828e3365e6cSdrh     if( rRhsHasNull==0 || destIfFalse==destIfNull ){
1829e3365e6cSdrh       /* This branch runs if it is known at compile time that the RHS
1830e3365e6cSdrh       ** cannot contain NULL values. This happens as the result
1831e3365e6cSdrh       ** of a "NOT NULL" constraint in the database schema.
1832e3365e6cSdrh       **
1833e3365e6cSdrh       ** Also run this branch if NULL is equivalent to FALSE
1834e3365e6cSdrh       ** for this particular IN operator.
1835e3365e6cSdrh       */
18368cff69dfSdrh       sqlite3VdbeAddOp4Int(v, OP_NotFound, pExpr->iTable, destIfFalse, r1, 1);
1837e3365e6cSdrh 
1838e3365e6cSdrh     }else{
1839e3365e6cSdrh       /* In this branch, the RHS of the IN might contain a NULL and
1840e3365e6cSdrh       ** the presence of a NULL on the RHS makes a difference in the
1841e3365e6cSdrh       ** outcome.
1842e3365e6cSdrh       */
1843e3365e6cSdrh       int j1, j2, j3;
1844e3365e6cSdrh 
1845e3365e6cSdrh       /* First check to see if the LHS is contained in the RHS.  If so,
1846e3365e6cSdrh       ** then the presence of NULLs in the RHS does not matter, so jump
1847e3365e6cSdrh       ** over all of the code that follows.
1848e3365e6cSdrh       */
18498cff69dfSdrh       j1 = sqlite3VdbeAddOp4Int(v, OP_Found, pExpr->iTable, 0, r1, 1);
1850e3365e6cSdrh 
1851e3365e6cSdrh       /* Here we begin generating code that runs if the LHS is not
1852e3365e6cSdrh       ** contained within the RHS.  Generate additional code that
1853e3365e6cSdrh       ** tests the RHS for NULLs.  If the RHS contains a NULL then
1854e3365e6cSdrh       ** jump to destIfNull.  If there are no NULLs in the RHS then
1855e3365e6cSdrh       ** jump to destIfFalse.
1856e3365e6cSdrh       */
1857e3365e6cSdrh       j2 = sqlite3VdbeAddOp1(v, OP_NotNull, rRhsHasNull);
18588cff69dfSdrh       j3 = sqlite3VdbeAddOp4Int(v, OP_Found, pExpr->iTable, 0, rRhsHasNull, 1);
1859e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Integer, -1, rRhsHasNull);
1860e3365e6cSdrh       sqlite3VdbeJumpHere(v, j3);
1861e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_AddImm, rRhsHasNull, 1);
1862e3365e6cSdrh       sqlite3VdbeJumpHere(v, j2);
1863e3365e6cSdrh 
1864e3365e6cSdrh       /* Jump to the appropriate target depending on whether or not
1865e3365e6cSdrh       ** the RHS contains a NULL
1866e3365e6cSdrh       */
1867e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_If, rRhsHasNull, destIfNull);
1868e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Goto, 0, destIfFalse);
1869e3365e6cSdrh 
1870e3365e6cSdrh       /* The OP_Found at the top of this branch jumps here when true,
1871e3365e6cSdrh       ** causing the overall IN expression evaluation to fall through.
1872e3365e6cSdrh       */
1873e3365e6cSdrh       sqlite3VdbeJumpHere(v, j1);
1874e3365e6cSdrh     }
1875e3365e6cSdrh   }
1876e3365e6cSdrh   sqlite3ReleaseTempReg(pParse, r1);
1877e3365e6cSdrh   sqlite3ExprCachePop(pParse, 1);
1878e3365e6cSdrh   VdbeComment((v, "end IN expr"));
1879e3365e6cSdrh }
1880e3365e6cSdrh #endif /* SQLITE_OMIT_SUBQUERY */
1881e3365e6cSdrh 
1882cce7d176Sdrh /*
1883598f1340Sdrh ** Duplicate an 8-byte value
1884598f1340Sdrh */
1885598f1340Sdrh static char *dup8bytes(Vdbe *v, const char *in){
1886598f1340Sdrh   char *out = sqlite3DbMallocRaw(sqlite3VdbeDb(v), 8);
1887598f1340Sdrh   if( out ){
1888598f1340Sdrh     memcpy(out, in, 8);
1889598f1340Sdrh   }
1890598f1340Sdrh   return out;
1891598f1340Sdrh }
1892598f1340Sdrh 
189313573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
1894598f1340Sdrh /*
1895598f1340Sdrh ** Generate an instruction that will put the floating point
18969cbf3425Sdrh ** value described by z[0..n-1] into register iMem.
18970cf19ed8Sdrh **
18980cf19ed8Sdrh ** The z[] string will probably not be zero-terminated.  But the
18990cf19ed8Sdrh ** z[n] character is guaranteed to be something that does not look
19000cf19ed8Sdrh ** like the continuation of the number.
1901598f1340Sdrh */
1902b7916a78Sdrh static void codeReal(Vdbe *v, const char *z, int negateFlag, int iMem){
1903fd773cf9Sdrh   if( ALWAYS(z!=0) ){
1904598f1340Sdrh     double value;
1905598f1340Sdrh     char *zV;
1906598f1340Sdrh     sqlite3AtoF(z, &value);
1907d0015161Sdrh     assert( !sqlite3IsNaN(value) ); /* The new AtoF never returns NaN */
1908598f1340Sdrh     if( negateFlag ) value = -value;
1909598f1340Sdrh     zV = dup8bytes(v, (char*)&value);
19109de221dfSdrh     sqlite3VdbeAddOp4(v, OP_Real, 0, iMem, 0, zV, P4_REAL);
1911598f1340Sdrh   }
1912598f1340Sdrh }
191313573c71Sdrh #endif
1914598f1340Sdrh 
1915598f1340Sdrh 
1916598f1340Sdrh /*
1917fec19aadSdrh ** Generate an instruction that will put the integer describe by
19189cbf3425Sdrh ** text z[0..n-1] into register iMem.
19190cf19ed8Sdrh **
19200cf19ed8Sdrh ** The z[] string will probably not be zero-terminated.  But the
19210cf19ed8Sdrh ** z[n] character is guaranteed to be something that does not look
19220cf19ed8Sdrh ** like the continuation of the number.
1923fec19aadSdrh */
192413573c71Sdrh static void codeInteger(Parse *pParse, Expr *pExpr, int negFlag, int iMem){
192513573c71Sdrh   Vdbe *v = pParse->pVdbe;
192692b01d53Sdrh   if( pExpr->flags & EP_IntValue ){
192733e619fcSdrh     int i = pExpr->u.iValue;
192892b01d53Sdrh     if( negFlag ) i = -i;
192992b01d53Sdrh     sqlite3VdbeAddOp2(v, OP_Integer, i, iMem);
1930fd773cf9Sdrh   }else{
1931fd773cf9Sdrh     const char *z = pExpr->u.zToken;
1932fd773cf9Sdrh     assert( z!=0 );
1933fd773cf9Sdrh     if( sqlite3FitsIn64Bits(z, negFlag) ){
1934598f1340Sdrh       i64 value;
1935598f1340Sdrh       char *zV;
1936598f1340Sdrh       sqlite3Atoi64(z, &value);
19379de221dfSdrh       if( negFlag ) value = -value;
1938598f1340Sdrh       zV = dup8bytes(v, (char*)&value);
19399de221dfSdrh       sqlite3VdbeAddOp4(v, OP_Int64, 0, iMem, 0, zV, P4_INT64);
1940fec19aadSdrh     }else{
194113573c71Sdrh #ifdef SQLITE_OMIT_FLOATING_POINT
194213573c71Sdrh       sqlite3ErrorMsg(pParse, "oversized integer: %s%s", negFlag ? "-" : "", z);
194313573c71Sdrh #else
1944b7916a78Sdrh       codeReal(v, z, negFlag, iMem);
194513573c71Sdrh #endif
1946fec19aadSdrh     }
1947fec19aadSdrh   }
1948c9cf901dSdanielk1977 }
1949fec19aadSdrh 
1950ceea3321Sdrh /*
1951ceea3321Sdrh ** Clear a cache entry.
1952ceea3321Sdrh */
1953ceea3321Sdrh static void cacheEntryClear(Parse *pParse, struct yColCache *p){
1954ceea3321Sdrh   if( p->tempReg ){
1955ceea3321Sdrh     if( pParse->nTempReg<ArraySize(pParse->aTempReg) ){
1956ceea3321Sdrh       pParse->aTempReg[pParse->nTempReg++] = p->iReg;
1957ceea3321Sdrh     }
1958ceea3321Sdrh     p->tempReg = 0;
1959ceea3321Sdrh   }
1960ceea3321Sdrh }
1961ceea3321Sdrh 
1962ceea3321Sdrh 
1963ceea3321Sdrh /*
1964ceea3321Sdrh ** Record in the column cache that a particular column from a
1965ceea3321Sdrh ** particular table is stored in a particular register.
1966ceea3321Sdrh */
1967ceea3321Sdrh void sqlite3ExprCacheStore(Parse *pParse, int iTab, int iCol, int iReg){
1968ceea3321Sdrh   int i;
1969ceea3321Sdrh   int minLru;
1970ceea3321Sdrh   int idxLru;
1971ceea3321Sdrh   struct yColCache *p;
1972ceea3321Sdrh 
197320411ea7Sdrh   assert( iReg>0 );  /* Register numbers are always positive */
197420411ea7Sdrh   assert( iCol>=-1 && iCol<32768 );  /* Finite column numbers */
197520411ea7Sdrh 
1976b6da74ebSdrh   /* The SQLITE_ColumnCache flag disables the column cache.  This is used
1977b6da74ebSdrh   ** for testing only - to verify that SQLite always gets the same answer
1978b6da74ebSdrh   ** with and without the column cache.
1979b6da74ebSdrh   */
1980b6da74ebSdrh   if( pParse->db->flags & SQLITE_ColumnCache ) return;
1981b6da74ebSdrh 
198227ee406eSdrh   /* First replace any existing entry.
198327ee406eSdrh   **
198427ee406eSdrh   ** Actually, the way the column cache is currently used, we are guaranteed
198527ee406eSdrh   ** that the object will never already be in cache.  Verify this guarantee.
198627ee406eSdrh   */
198727ee406eSdrh #ifndef NDEBUG
1988ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
198927ee406eSdrh #if 0 /* This code wold remove the entry from the cache if it existed */
1990ceea3321Sdrh     if( p->iReg && p->iTable==iTab && p->iColumn==iCol ){
1991ceea3321Sdrh       cacheEntryClear(pParse, p);
1992ceea3321Sdrh       p->iLevel = pParse->iCacheLevel;
1993ceea3321Sdrh       p->iReg = iReg;
1994ceea3321Sdrh       p->lru = pParse->iCacheCnt++;
1995ceea3321Sdrh       return;
1996ceea3321Sdrh     }
199727ee406eSdrh #endif
199827ee406eSdrh     assert( p->iReg==0 || p->iTable!=iTab || p->iColumn!=iCol );
1999ceea3321Sdrh   }
200027ee406eSdrh #endif
2001ceea3321Sdrh 
2002ceea3321Sdrh   /* Find an empty slot and replace it */
2003ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2004ceea3321Sdrh     if( p->iReg==0 ){
2005ceea3321Sdrh       p->iLevel = pParse->iCacheLevel;
2006ceea3321Sdrh       p->iTable = iTab;
2007ceea3321Sdrh       p->iColumn = iCol;
2008ceea3321Sdrh       p->iReg = iReg;
2009ceea3321Sdrh       p->tempReg = 0;
2010ceea3321Sdrh       p->lru = pParse->iCacheCnt++;
2011ceea3321Sdrh       return;
2012ceea3321Sdrh     }
2013ceea3321Sdrh   }
2014ceea3321Sdrh 
2015ceea3321Sdrh   /* Replace the last recently used */
2016ceea3321Sdrh   minLru = 0x7fffffff;
2017ceea3321Sdrh   idxLru = -1;
2018ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2019ceea3321Sdrh     if( p->lru<minLru ){
2020ceea3321Sdrh       idxLru = i;
2021ceea3321Sdrh       minLru = p->lru;
2022ceea3321Sdrh     }
2023ceea3321Sdrh   }
202420411ea7Sdrh   if( ALWAYS(idxLru>=0) ){
2025ceea3321Sdrh     p = &pParse->aColCache[idxLru];
2026ceea3321Sdrh     p->iLevel = pParse->iCacheLevel;
2027ceea3321Sdrh     p->iTable = iTab;
2028ceea3321Sdrh     p->iColumn = iCol;
2029ceea3321Sdrh     p->iReg = iReg;
2030ceea3321Sdrh     p->tempReg = 0;
2031ceea3321Sdrh     p->lru = pParse->iCacheCnt++;
2032ceea3321Sdrh     return;
2033ceea3321Sdrh   }
2034ceea3321Sdrh }
2035ceea3321Sdrh 
2036ceea3321Sdrh /*
2037f49f3523Sdrh ** Indicate that registers between iReg..iReg+nReg-1 are being overwritten.
2038f49f3523Sdrh ** Purge the range of registers from the column cache.
2039ceea3321Sdrh */
2040f49f3523Sdrh void sqlite3ExprCacheRemove(Parse *pParse, int iReg, int nReg){
2041ceea3321Sdrh   int i;
2042f49f3523Sdrh   int iLast = iReg + nReg - 1;
2043ceea3321Sdrh   struct yColCache *p;
2044ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2045f49f3523Sdrh     int r = p->iReg;
2046f49f3523Sdrh     if( r>=iReg && r<=iLast ){
2047ceea3321Sdrh       cacheEntryClear(pParse, p);
2048ceea3321Sdrh       p->iReg = 0;
2049ceea3321Sdrh     }
2050ceea3321Sdrh   }
2051ceea3321Sdrh }
2052ceea3321Sdrh 
2053ceea3321Sdrh /*
2054ceea3321Sdrh ** Remember the current column cache context.  Any new entries added
2055ceea3321Sdrh ** added to the column cache after this call are removed when the
2056ceea3321Sdrh ** corresponding pop occurs.
2057ceea3321Sdrh */
2058ceea3321Sdrh void sqlite3ExprCachePush(Parse *pParse){
2059ceea3321Sdrh   pParse->iCacheLevel++;
2060ceea3321Sdrh }
2061ceea3321Sdrh 
2062ceea3321Sdrh /*
2063ceea3321Sdrh ** Remove from the column cache any entries that were added since the
2064ceea3321Sdrh ** the previous N Push operations.  In other words, restore the cache
2065ceea3321Sdrh ** to the state it was in N Pushes ago.
2066ceea3321Sdrh */
2067ceea3321Sdrh void sqlite3ExprCachePop(Parse *pParse, int N){
2068ceea3321Sdrh   int i;
2069ceea3321Sdrh   struct yColCache *p;
2070ceea3321Sdrh   assert( N>0 );
2071ceea3321Sdrh   assert( pParse->iCacheLevel>=N );
2072ceea3321Sdrh   pParse->iCacheLevel -= N;
2073ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2074ceea3321Sdrh     if( p->iReg && p->iLevel>pParse->iCacheLevel ){
2075ceea3321Sdrh       cacheEntryClear(pParse, p);
2076ceea3321Sdrh       p->iReg = 0;
2077ceea3321Sdrh     }
2078ceea3321Sdrh   }
2079ceea3321Sdrh }
2080945498f3Sdrh 
2081945498f3Sdrh /*
20825cd79239Sdrh ** When a cached column is reused, make sure that its register is
20835cd79239Sdrh ** no longer available as a temp register.  ticket #3879:  that same
20845cd79239Sdrh ** register might be in the cache in multiple places, so be sure to
20855cd79239Sdrh ** get them all.
20865cd79239Sdrh */
20875cd79239Sdrh static void sqlite3ExprCachePinRegister(Parse *pParse, int iReg){
20885cd79239Sdrh   int i;
20895cd79239Sdrh   struct yColCache *p;
20905cd79239Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
20915cd79239Sdrh     if( p->iReg==iReg ){
20925cd79239Sdrh       p->tempReg = 0;
20935cd79239Sdrh     }
20945cd79239Sdrh   }
20955cd79239Sdrh }
20965cd79239Sdrh 
20975cd79239Sdrh /*
20985c092e8aSdrh ** Generate code to extract the value of the iCol-th column of a table.
20995c092e8aSdrh */
21005c092e8aSdrh void sqlite3ExprCodeGetColumnOfTable(
21015c092e8aSdrh   Vdbe *v,        /* The VDBE under construction */
21025c092e8aSdrh   Table *pTab,    /* The table containing the value */
21035c092e8aSdrh   int iTabCur,    /* The cursor for this table */
21045c092e8aSdrh   int iCol,       /* Index of the column to extract */
21055c092e8aSdrh   int regOut      /* Extract the valud into this register */
21065c092e8aSdrh ){
21075c092e8aSdrh   if( iCol<0 || iCol==pTab->iPKey ){
21085c092e8aSdrh     sqlite3VdbeAddOp2(v, OP_Rowid, iTabCur, regOut);
21095c092e8aSdrh   }else{
21105c092e8aSdrh     int op = IsVirtual(pTab) ? OP_VColumn : OP_Column;
21115c092e8aSdrh     sqlite3VdbeAddOp3(v, op, iTabCur, iCol, regOut);
21125c092e8aSdrh   }
21135c092e8aSdrh   if( iCol>=0 ){
21145c092e8aSdrh     sqlite3ColumnDefault(v, pTab, iCol, regOut);
21155c092e8aSdrh   }
21165c092e8aSdrh }
21175c092e8aSdrh 
21185c092e8aSdrh /*
2119945498f3Sdrh ** Generate code that will extract the iColumn-th column from
2120e55cbd72Sdrh ** table pTab and store the column value in a register.  An effort
2121e55cbd72Sdrh ** is made to store the column value in register iReg, but this is
2122e55cbd72Sdrh ** not guaranteed.  The location of the column value is returned.
2123e55cbd72Sdrh **
2124e55cbd72Sdrh ** There must be an open cursor to pTab in iTable when this routine
2125e55cbd72Sdrh ** is called.  If iColumn<0 then code is generated that extracts the rowid.
2126945498f3Sdrh */
2127e55cbd72Sdrh int sqlite3ExprCodeGetColumn(
2128e55cbd72Sdrh   Parse *pParse,   /* Parsing and code generating context */
21292133d822Sdrh   Table *pTab,     /* Description of the table we are reading from */
21302133d822Sdrh   int iColumn,     /* Index of the table column */
21312133d822Sdrh   int iTable,      /* The cursor pointing to the table */
2132b6da74ebSdrh   int iReg         /* Store results here */
21332133d822Sdrh ){
2134e55cbd72Sdrh   Vdbe *v = pParse->pVdbe;
2135e55cbd72Sdrh   int i;
2136da250ea5Sdrh   struct yColCache *p;
2137e55cbd72Sdrh 
2138ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2139b6da74ebSdrh     if( p->iReg>0 && p->iTable==iTable && p->iColumn==iColumn ){
2140ceea3321Sdrh       p->lru = pParse->iCacheCnt++;
21415cd79239Sdrh       sqlite3ExprCachePinRegister(pParse, p->iReg);
2142da250ea5Sdrh       return p->iReg;
2143e55cbd72Sdrh     }
2144e55cbd72Sdrh   }
2145e55cbd72Sdrh   assert( v!=0 );
21465c092e8aSdrh   sqlite3ExprCodeGetColumnOfTable(v, pTab, iTable, iColumn, iReg);
2147ceea3321Sdrh   sqlite3ExprCacheStore(pParse, iTable, iColumn, iReg);
2148e55cbd72Sdrh   return iReg;
2149e55cbd72Sdrh }
2150e55cbd72Sdrh 
2151e55cbd72Sdrh /*
2152ceea3321Sdrh ** Clear all column cache entries.
2153e55cbd72Sdrh */
2154ceea3321Sdrh void sqlite3ExprCacheClear(Parse *pParse){
2155e55cbd72Sdrh   int i;
2156ceea3321Sdrh   struct yColCache *p;
2157ceea3321Sdrh 
2158ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2159ceea3321Sdrh     if( p->iReg ){
2160ceea3321Sdrh       cacheEntryClear(pParse, p);
2161ceea3321Sdrh       p->iReg = 0;
2162e55cbd72Sdrh     }
2163da250ea5Sdrh   }
2164da250ea5Sdrh }
2165e55cbd72Sdrh 
2166e55cbd72Sdrh /*
2167da250ea5Sdrh ** Record the fact that an affinity change has occurred on iCount
2168da250ea5Sdrh ** registers starting with iStart.
2169e55cbd72Sdrh */
2170da250ea5Sdrh void sqlite3ExprCacheAffinityChange(Parse *pParse, int iStart, int iCount){
2171f49f3523Sdrh   sqlite3ExprCacheRemove(pParse, iStart, iCount);
2172e55cbd72Sdrh }
2173e55cbd72Sdrh 
2174e55cbd72Sdrh /*
2175b21e7c70Sdrh ** Generate code to move content from registers iFrom...iFrom+nReg-1
2176b21e7c70Sdrh ** over to iTo..iTo+nReg-1. Keep the column cache up-to-date.
2177e55cbd72Sdrh */
2178b21e7c70Sdrh void sqlite3ExprCodeMove(Parse *pParse, int iFrom, int iTo, int nReg){
2179e55cbd72Sdrh   int i;
2180ceea3321Sdrh   struct yColCache *p;
218120411ea7Sdrh   if( NEVER(iFrom==iTo) ) return;
2182b21e7c70Sdrh   sqlite3VdbeAddOp3(pParse->pVdbe, OP_Move, iFrom, iTo, nReg);
2183ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2184ceea3321Sdrh     int x = p->iReg;
2185b21e7c70Sdrh     if( x>=iFrom && x<iFrom+nReg ){
2186ceea3321Sdrh       p->iReg += iTo-iFrom;
2187e55cbd72Sdrh     }
2188e55cbd72Sdrh   }
2189945498f3Sdrh }
2190945498f3Sdrh 
2191fec19aadSdrh /*
219292b01d53Sdrh ** Generate code to copy content from registers iFrom...iFrom+nReg-1
219392b01d53Sdrh ** over to iTo..iTo+nReg-1.
219492b01d53Sdrh */
219592b01d53Sdrh void sqlite3ExprCodeCopy(Parse *pParse, int iFrom, int iTo, int nReg){
219692b01d53Sdrh   int i;
219720411ea7Sdrh   if( NEVER(iFrom==iTo) ) return;
219892b01d53Sdrh   for(i=0; i<nReg; i++){
219992b01d53Sdrh     sqlite3VdbeAddOp2(pParse->pVdbe, OP_Copy, iFrom+i, iTo+i);
220092b01d53Sdrh   }
220192b01d53Sdrh }
220292b01d53Sdrh 
2203f49f3523Sdrh #if defined(SQLITE_DEBUG) || defined(SQLITE_COVERAGE_TEST)
220492b01d53Sdrh /*
2205652fbf55Sdrh ** Return true if any register in the range iFrom..iTo (inclusive)
2206652fbf55Sdrh ** is used as part of the column cache.
2207f49f3523Sdrh **
2208f49f3523Sdrh ** This routine is used within assert() and testcase() macros only
2209f49f3523Sdrh ** and does not appear in a normal build.
2210652fbf55Sdrh */
2211652fbf55Sdrh static int usedAsColumnCache(Parse *pParse, int iFrom, int iTo){
2212652fbf55Sdrh   int i;
2213ceea3321Sdrh   struct yColCache *p;
2214ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2215ceea3321Sdrh     int r = p->iReg;
2216f49f3523Sdrh     if( r>=iFrom && r<=iTo ) return 1;    /*NO_TEST*/
2217652fbf55Sdrh   }
2218652fbf55Sdrh   return 0;
2219652fbf55Sdrh }
2220f49f3523Sdrh #endif /* SQLITE_DEBUG || SQLITE_COVERAGE_TEST */
2221652fbf55Sdrh 
2222652fbf55Sdrh /*
2223191b54cbSdrh ** If the last instruction coded is an ephemeral copy of any of
2224191b54cbSdrh ** the registers in the nReg registers beginning with iReg, then
2225191b54cbSdrh ** convert the last instruction from OP_SCopy to OP_Copy.
2226191b54cbSdrh */
2227191b54cbSdrh void sqlite3ExprHardCopy(Parse *pParse, int iReg, int nReg){
2228191b54cbSdrh   VdbeOp *pOp;
2229191b54cbSdrh   Vdbe *v;
2230191b54cbSdrh 
223120411ea7Sdrh   assert( pParse->db->mallocFailed==0 );
2232191b54cbSdrh   v = pParse->pVdbe;
223320411ea7Sdrh   assert( v!=0 );
223420411ea7Sdrh   pOp = sqlite3VdbeGetOp(v, -1);
223520411ea7Sdrh   assert( pOp!=0 );
223620411ea7Sdrh   if( pOp->opcode==OP_SCopy && pOp->p1>=iReg && pOp->p1<iReg+nReg ){
2237191b54cbSdrh     pOp->opcode = OP_Copy;
2238191b54cbSdrh   }
2239191b54cbSdrh }
2240191b54cbSdrh 
2241191b54cbSdrh /*
22428b213899Sdrh ** Generate code to store the value of the iAlias-th alias in register
22438b213899Sdrh ** target.  The first time this is called, pExpr is evaluated to compute
22448b213899Sdrh ** the value of the alias.  The value is stored in an auxiliary register
22458b213899Sdrh ** and the number of that register is returned.  On subsequent calls,
22468b213899Sdrh ** the register number is returned without generating any code.
22478b213899Sdrh **
22488b213899Sdrh ** Note that in order for this to work, code must be generated in the
22498b213899Sdrh ** same order that it is executed.
22508b213899Sdrh **
22518b213899Sdrh ** Aliases are numbered starting with 1.  So iAlias is in the range
22528b213899Sdrh ** of 1 to pParse->nAlias inclusive.
22538b213899Sdrh **
22548b213899Sdrh ** pParse->aAlias[iAlias-1] records the register number where the value
22558b213899Sdrh ** of the iAlias-th alias is stored.  If zero, that means that the
22568b213899Sdrh ** alias has not yet been computed.
22578b213899Sdrh */
225831daa63fSdrh static int codeAlias(Parse *pParse, int iAlias, Expr *pExpr, int target){
2259ceea3321Sdrh #if 0
22608b213899Sdrh   sqlite3 *db = pParse->db;
22618b213899Sdrh   int iReg;
2262555f8de7Sdrh   if( pParse->nAliasAlloc<pParse->nAlias ){
2263555f8de7Sdrh     pParse->aAlias = sqlite3DbReallocOrFree(db, pParse->aAlias,
22648b213899Sdrh                                  sizeof(pParse->aAlias[0])*pParse->nAlias );
2265555f8de7Sdrh     testcase( db->mallocFailed && pParse->nAliasAlloc>0 );
22668b213899Sdrh     if( db->mallocFailed ) return 0;
2267555f8de7Sdrh     memset(&pParse->aAlias[pParse->nAliasAlloc], 0,
2268555f8de7Sdrh            (pParse->nAlias-pParse->nAliasAlloc)*sizeof(pParse->aAlias[0]));
2269555f8de7Sdrh     pParse->nAliasAlloc = pParse->nAlias;
22708b213899Sdrh   }
22718b213899Sdrh   assert( iAlias>0 && iAlias<=pParse->nAlias );
22728b213899Sdrh   iReg = pParse->aAlias[iAlias-1];
22738b213899Sdrh   if( iReg==0 ){
2274ceea3321Sdrh     if( pParse->iCacheLevel>0 ){
227531daa63fSdrh       iReg = sqlite3ExprCodeTarget(pParse, pExpr, target);
227631daa63fSdrh     }else{
22778b213899Sdrh       iReg = ++pParse->nMem;
22788b213899Sdrh       sqlite3ExprCode(pParse, pExpr, iReg);
22798b213899Sdrh       pParse->aAlias[iAlias-1] = iReg;
22808b213899Sdrh     }
228131daa63fSdrh   }
22828b213899Sdrh   return iReg;
2283ceea3321Sdrh #else
228460a4b538Sshane   UNUSED_PARAMETER(iAlias);
2285ceea3321Sdrh   return sqlite3ExprCodeTarget(pParse, pExpr, target);
2286ceea3321Sdrh #endif
22878b213899Sdrh }
22888b213899Sdrh 
22898b213899Sdrh /*
2290cce7d176Sdrh ** Generate code into the current Vdbe to evaluate the given
22912dcef11bSdrh ** expression.  Attempt to store the results in register "target".
22922dcef11bSdrh ** Return the register where results are stored.
2293389a1adbSdrh **
22948b213899Sdrh ** With this routine, there is no guarantee that results will
22952dcef11bSdrh ** be stored in target.  The result might be stored in some other
22962dcef11bSdrh ** register if it is convenient to do so.  The calling function
22972dcef11bSdrh ** must check the return code and move the results to the desired
22982dcef11bSdrh ** register.
2299cce7d176Sdrh */
2300678ccce8Sdrh int sqlite3ExprCodeTarget(Parse *pParse, Expr *pExpr, int target){
23012dcef11bSdrh   Vdbe *v = pParse->pVdbe;  /* The VM under construction */
23022dcef11bSdrh   int op;                   /* The opcode being coded */
23032dcef11bSdrh   int inReg = target;       /* Results stored in register inReg */
23042dcef11bSdrh   int regFree1 = 0;         /* If non-zero free this temporary register */
23052dcef11bSdrh   int regFree2 = 0;         /* If non-zero free this temporary register */
2306678ccce8Sdrh   int r1, r2, r3, r4;       /* Various register numbers */
230720411ea7Sdrh   sqlite3 *db = pParse->db; /* The database connection */
2308ffe07b2dSdrh 
23099cbf3425Sdrh   assert( target>0 && target<=pParse->nMem );
231020411ea7Sdrh   if( v==0 ){
231120411ea7Sdrh     assert( pParse->db->mallocFailed );
231220411ea7Sdrh     return 0;
231320411ea7Sdrh   }
2314389a1adbSdrh 
2315389a1adbSdrh   if( pExpr==0 ){
2316389a1adbSdrh     op = TK_NULL;
2317389a1adbSdrh   }else{
2318f2bc013cSdrh     op = pExpr->op;
2319389a1adbSdrh   }
2320f2bc013cSdrh   switch( op ){
232113449892Sdrh     case TK_AGG_COLUMN: {
232213449892Sdrh       AggInfo *pAggInfo = pExpr->pAggInfo;
232313449892Sdrh       struct AggInfo_col *pCol = &pAggInfo->aCol[pExpr->iAgg];
232413449892Sdrh       if( !pAggInfo->directMode ){
23259de221dfSdrh         assert( pCol->iMem>0 );
23269de221dfSdrh         inReg = pCol->iMem;
232713449892Sdrh         break;
232813449892Sdrh       }else if( pAggInfo->useSortingIdx ){
2329389a1adbSdrh         sqlite3VdbeAddOp3(v, OP_Column, pAggInfo->sortingIdx,
2330389a1adbSdrh                               pCol->iSorterColumn, target);
233113449892Sdrh         break;
233213449892Sdrh       }
233313449892Sdrh       /* Otherwise, fall thru into the TK_COLUMN case */
233413449892Sdrh     }
2335967e8b73Sdrh     case TK_COLUMN: {
2336ffe07b2dSdrh       if( pExpr->iTable<0 ){
2337ffe07b2dSdrh         /* This only happens when coding check constraints */
2338aa9b8963Sdrh         assert( pParse->ckBase>0 );
2339aa9b8963Sdrh         inReg = pExpr->iColumn + pParse->ckBase;
2340c4a3c779Sdrh       }else{
2341e55cbd72Sdrh         inReg = sqlite3ExprCodeGetColumn(pParse, pExpr->pTab,
2342b6da74ebSdrh                                  pExpr->iColumn, pExpr->iTable, target);
23432282792aSdrh       }
2344cce7d176Sdrh       break;
2345cce7d176Sdrh     }
2346cce7d176Sdrh     case TK_INTEGER: {
234713573c71Sdrh       codeInteger(pParse, pExpr, 0, target);
2348fec19aadSdrh       break;
234951e9a445Sdrh     }
235013573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
2351598f1340Sdrh     case TK_FLOAT: {
235233e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
235333e619fcSdrh       codeReal(v, pExpr->u.zToken, 0, target);
2354598f1340Sdrh       break;
2355598f1340Sdrh     }
235613573c71Sdrh #endif
2357fec19aadSdrh     case TK_STRING: {
235833e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
235933e619fcSdrh       sqlite3VdbeAddOp4(v, OP_String8, 0, target, 0, pExpr->u.zToken, 0);
2360cce7d176Sdrh       break;
2361cce7d176Sdrh     }
2362f0863fe5Sdrh     case TK_NULL: {
23639de221dfSdrh       sqlite3VdbeAddOp2(v, OP_Null, 0, target);
2364f0863fe5Sdrh       break;
2365f0863fe5Sdrh     }
23665338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_BLOB_LITERAL
2367c572ef7fSdanielk1977     case TK_BLOB: {
23686c8c6cecSdrh       int n;
23696c8c6cecSdrh       const char *z;
2370ca48c90fSdrh       char *zBlob;
237133e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
237233e619fcSdrh       assert( pExpr->u.zToken[0]=='x' || pExpr->u.zToken[0]=='X' );
237333e619fcSdrh       assert( pExpr->u.zToken[1]=='\'' );
237433e619fcSdrh       z = &pExpr->u.zToken[2];
2375b7916a78Sdrh       n = sqlite3Strlen30(z) - 1;
2376b7916a78Sdrh       assert( z[n]=='\'' );
2377ca48c90fSdrh       zBlob = sqlite3HexToBlob(sqlite3VdbeDb(v), z, n);
2378ca48c90fSdrh       sqlite3VdbeAddOp4(v, OP_Blob, n/2, target, 0, zBlob, P4_DYNAMIC);
2379c572ef7fSdanielk1977       break;
2380c572ef7fSdanielk1977     }
23815338a5f7Sdanielk1977 #endif
238250457896Sdrh     case TK_VARIABLE: {
238333e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
238433e619fcSdrh       assert( pExpr->u.zToken!=0 );
238533e619fcSdrh       assert( pExpr->u.zToken[0]!=0 );
2386eaf52d88Sdrh       sqlite3VdbeAddOp2(v, OP_Variable, pExpr->iColumn, target);
238733e619fcSdrh       if( pExpr->u.zToken[1]!=0 ){
238833e619fcSdrh         sqlite3VdbeChangeP4(v, -1, pExpr->u.zToken, 0);
2389895d7472Sdrh       }
239050457896Sdrh       break;
239150457896Sdrh     }
23924e0cff60Sdrh     case TK_REGISTER: {
23939de221dfSdrh       inReg = pExpr->iTable;
23944e0cff60Sdrh       break;
23954e0cff60Sdrh     }
23968b213899Sdrh     case TK_AS: {
239731daa63fSdrh       inReg = codeAlias(pParse, pExpr->iTable, pExpr->pLeft, target);
23988b213899Sdrh       break;
23998b213899Sdrh     }
2400487e262fSdrh #ifndef SQLITE_OMIT_CAST
2401487e262fSdrh     case TK_CAST: {
2402487e262fSdrh       /* Expressions of the form:   CAST(pLeft AS token) */
2403f0113000Sdanielk1977       int aff, to_op;
24042dcef11bSdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
240533e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
240633e619fcSdrh       aff = sqlite3AffinityType(pExpr->u.zToken);
2407f0113000Sdanielk1977       to_op = aff - SQLITE_AFF_TEXT + OP_ToText;
2408f0113000Sdanielk1977       assert( to_op==OP_ToText    || aff!=SQLITE_AFF_TEXT    );
2409f0113000Sdanielk1977       assert( to_op==OP_ToBlob    || aff!=SQLITE_AFF_NONE    );
2410f0113000Sdanielk1977       assert( to_op==OP_ToNumeric || aff!=SQLITE_AFF_NUMERIC );
2411f0113000Sdanielk1977       assert( to_op==OP_ToInt     || aff!=SQLITE_AFF_INTEGER );
2412f0113000Sdanielk1977       assert( to_op==OP_ToReal    || aff!=SQLITE_AFF_REAL    );
2413c5499befSdrh       testcase( to_op==OP_ToText );
2414c5499befSdrh       testcase( to_op==OP_ToBlob );
2415c5499befSdrh       testcase( to_op==OP_ToNumeric );
2416c5499befSdrh       testcase( to_op==OP_ToInt );
2417c5499befSdrh       testcase( to_op==OP_ToReal );
24181735fa88Sdrh       if( inReg!=target ){
24191735fa88Sdrh         sqlite3VdbeAddOp2(v, OP_SCopy, inReg, target);
24201735fa88Sdrh         inReg = target;
24211735fa88Sdrh       }
24222dcef11bSdrh       sqlite3VdbeAddOp1(v, to_op, inReg);
2423c5499befSdrh       testcase( usedAsColumnCache(pParse, inReg, inReg) );
2424b3843a82Sdrh       sqlite3ExprCacheAffinityChange(pParse, inReg, 1);
2425487e262fSdrh       break;
2426487e262fSdrh     }
2427487e262fSdrh #endif /* SQLITE_OMIT_CAST */
2428c9b84a1fSdrh     case TK_LT:
2429c9b84a1fSdrh     case TK_LE:
2430c9b84a1fSdrh     case TK_GT:
2431c9b84a1fSdrh     case TK_GE:
2432c9b84a1fSdrh     case TK_NE:
2433c9b84a1fSdrh     case TK_EQ: {
2434f2bc013cSdrh       assert( TK_LT==OP_Lt );
2435f2bc013cSdrh       assert( TK_LE==OP_Le );
2436f2bc013cSdrh       assert( TK_GT==OP_Gt );
2437f2bc013cSdrh       assert( TK_GE==OP_Ge );
2438f2bc013cSdrh       assert( TK_EQ==OP_Eq );
2439f2bc013cSdrh       assert( TK_NE==OP_Ne );
2440c5499befSdrh       testcase( op==TK_LT );
2441c5499befSdrh       testcase( op==TK_LE );
2442c5499befSdrh       testcase( op==TK_GT );
2443c5499befSdrh       testcase( op==TK_GE );
2444c5499befSdrh       testcase( op==TK_EQ );
2445c5499befSdrh       testcase( op==TK_NE );
2446b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2447b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
244835573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
244935573356Sdrh                   r1, r2, inReg, SQLITE_STOREP2);
2450c5499befSdrh       testcase( regFree1==0 );
2451c5499befSdrh       testcase( regFree2==0 );
2452a37cdde0Sdanielk1977       break;
2453c9b84a1fSdrh     }
24546a2fe093Sdrh     case TK_IS:
24556a2fe093Sdrh     case TK_ISNOT: {
24566a2fe093Sdrh       testcase( op==TK_IS );
24576a2fe093Sdrh       testcase( op==TK_ISNOT );
2458b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2459b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
24606a2fe093Sdrh       op = (op==TK_IS) ? TK_EQ : TK_NE;
24616a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
24626a2fe093Sdrh                   r1, r2, inReg, SQLITE_STOREP2 | SQLITE_NULLEQ);
24636a2fe093Sdrh       testcase( regFree1==0 );
24646a2fe093Sdrh       testcase( regFree2==0 );
24656a2fe093Sdrh       break;
24666a2fe093Sdrh     }
2467cce7d176Sdrh     case TK_AND:
2468cce7d176Sdrh     case TK_OR:
2469cce7d176Sdrh     case TK_PLUS:
2470cce7d176Sdrh     case TK_STAR:
2471cce7d176Sdrh     case TK_MINUS:
2472bf4133cbSdrh     case TK_REM:
2473bf4133cbSdrh     case TK_BITAND:
2474bf4133cbSdrh     case TK_BITOR:
247517c40294Sdrh     case TK_SLASH:
2476bf4133cbSdrh     case TK_LSHIFT:
2477855eb1cfSdrh     case TK_RSHIFT:
24780040077dSdrh     case TK_CONCAT: {
2479f2bc013cSdrh       assert( TK_AND==OP_And );
2480f2bc013cSdrh       assert( TK_OR==OP_Or );
2481f2bc013cSdrh       assert( TK_PLUS==OP_Add );
2482f2bc013cSdrh       assert( TK_MINUS==OP_Subtract );
2483f2bc013cSdrh       assert( TK_REM==OP_Remainder );
2484f2bc013cSdrh       assert( TK_BITAND==OP_BitAnd );
2485f2bc013cSdrh       assert( TK_BITOR==OP_BitOr );
2486f2bc013cSdrh       assert( TK_SLASH==OP_Divide );
2487f2bc013cSdrh       assert( TK_LSHIFT==OP_ShiftLeft );
2488f2bc013cSdrh       assert( TK_RSHIFT==OP_ShiftRight );
2489f2bc013cSdrh       assert( TK_CONCAT==OP_Concat );
2490c5499befSdrh       testcase( op==TK_AND );
2491c5499befSdrh       testcase( op==TK_OR );
2492c5499befSdrh       testcase( op==TK_PLUS );
2493c5499befSdrh       testcase( op==TK_MINUS );
2494c5499befSdrh       testcase( op==TK_REM );
2495c5499befSdrh       testcase( op==TK_BITAND );
2496c5499befSdrh       testcase( op==TK_BITOR );
2497c5499befSdrh       testcase( op==TK_SLASH );
2498c5499befSdrh       testcase( op==TK_LSHIFT );
2499c5499befSdrh       testcase( op==TK_RSHIFT );
2500c5499befSdrh       testcase( op==TK_CONCAT );
25012dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
25022dcef11bSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
25035b6afba9Sdrh       sqlite3VdbeAddOp3(v, op, r2, r1, target);
2504c5499befSdrh       testcase( regFree1==0 );
2505c5499befSdrh       testcase( regFree2==0 );
25060040077dSdrh       break;
25070040077dSdrh     }
2508cce7d176Sdrh     case TK_UMINUS: {
2509fec19aadSdrh       Expr *pLeft = pExpr->pLeft;
2510fec19aadSdrh       assert( pLeft );
251113573c71Sdrh       if( pLeft->op==TK_INTEGER ){
251213573c71Sdrh         codeInteger(pParse, pLeft, 1, target);
251313573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
251413573c71Sdrh       }else if( pLeft->op==TK_FLOAT ){
251533e619fcSdrh         assert( !ExprHasProperty(pExpr, EP_IntValue) );
251633e619fcSdrh         codeReal(v, pLeft->u.zToken, 1, target);
251713573c71Sdrh #endif
25183c84ddffSdrh       }else{
25192dcef11bSdrh         regFree1 = r1 = sqlite3GetTempReg(pParse);
25203c84ddffSdrh         sqlite3VdbeAddOp2(v, OP_Integer, 0, r1);
2521e55cbd72Sdrh         r2 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree2);
25222dcef11bSdrh         sqlite3VdbeAddOp3(v, OP_Subtract, r2, r1, target);
2523c5499befSdrh         testcase( regFree2==0 );
25243c84ddffSdrh       }
25259de221dfSdrh       inReg = target;
25266e142f54Sdrh       break;
25276e142f54Sdrh     }
2528bf4133cbSdrh     case TK_BITNOT:
25296e142f54Sdrh     case TK_NOT: {
2530f2bc013cSdrh       assert( TK_BITNOT==OP_BitNot );
2531f2bc013cSdrh       assert( TK_NOT==OP_Not );
2532c5499befSdrh       testcase( op==TK_BITNOT );
2533c5499befSdrh       testcase( op==TK_NOT );
2534e99fa2afSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2535e99fa2afSdrh       testcase( regFree1==0 );
2536e99fa2afSdrh       inReg = target;
2537e99fa2afSdrh       sqlite3VdbeAddOp2(v, op, r1, inReg);
2538cce7d176Sdrh       break;
2539cce7d176Sdrh     }
2540cce7d176Sdrh     case TK_ISNULL:
2541cce7d176Sdrh     case TK_NOTNULL: {
25426a288a33Sdrh       int addr;
2543f2bc013cSdrh       assert( TK_ISNULL==OP_IsNull );
2544f2bc013cSdrh       assert( TK_NOTNULL==OP_NotNull );
2545c5499befSdrh       testcase( op==TK_ISNULL );
2546c5499befSdrh       testcase( op==TK_NOTNULL );
25479de221dfSdrh       sqlite3VdbeAddOp2(v, OP_Integer, 1, target);
25482dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2549c5499befSdrh       testcase( regFree1==0 );
25502dcef11bSdrh       addr = sqlite3VdbeAddOp1(v, op, r1);
25519de221dfSdrh       sqlite3VdbeAddOp2(v, OP_AddImm, target, -1);
25526a288a33Sdrh       sqlite3VdbeJumpHere(v, addr);
2553a37cdde0Sdanielk1977       break;
2554f2bc013cSdrh     }
25552282792aSdrh     case TK_AGG_FUNCTION: {
255613449892Sdrh       AggInfo *pInfo = pExpr->pAggInfo;
25577e56e711Sdrh       if( pInfo==0 ){
255833e619fcSdrh         assert( !ExprHasProperty(pExpr, EP_IntValue) );
255933e619fcSdrh         sqlite3ErrorMsg(pParse, "misuse of aggregate: %s()", pExpr->u.zToken);
25607e56e711Sdrh       }else{
25619de221dfSdrh         inReg = pInfo->aFunc[pExpr->iAgg].iMem;
25627e56e711Sdrh       }
25632282792aSdrh       break;
25642282792aSdrh     }
2565b71090fdSdrh     case TK_CONST_FUNC:
2566cce7d176Sdrh     case TK_FUNCTION: {
256712ffee8cSdrh       ExprList *pFarg;       /* List of function arguments */
256812ffee8cSdrh       int nFarg;             /* Number of function arguments */
256912ffee8cSdrh       FuncDef *pDef;         /* The function definition object */
257012ffee8cSdrh       int nId;               /* Length of the function name in bytes */
257112ffee8cSdrh       const char *zId;       /* The function name */
257212ffee8cSdrh       int constMask = 0;     /* Mask of function arguments that are constant */
257312ffee8cSdrh       int i;                 /* Loop counter */
257412ffee8cSdrh       u8 enc = ENC(db);      /* The text encoding used by this database */
257512ffee8cSdrh       CollSeq *pColl = 0;    /* A collating sequence */
257617435752Sdrh 
25776ab3a2ecSdanielk1977       assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
2578c5499befSdrh       testcase( op==TK_CONST_FUNC );
2579c5499befSdrh       testcase( op==TK_FUNCTION );
2580b7916a78Sdrh       if( ExprHasAnyProperty(pExpr, EP_TokenOnly) ){
258112ffee8cSdrh         pFarg = 0;
258212ffee8cSdrh       }else{
258312ffee8cSdrh         pFarg = pExpr->x.pList;
258412ffee8cSdrh       }
258512ffee8cSdrh       nFarg = pFarg ? pFarg->nExpr : 0;
258633e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
258733e619fcSdrh       zId = pExpr->u.zToken;
2588b7916a78Sdrh       nId = sqlite3Strlen30(zId);
258912ffee8cSdrh       pDef = sqlite3FindFunction(db, zId, nId, nFarg, enc, 0);
2590feb306f5Sdrh       if( pDef==0 ){
2591feb306f5Sdrh         sqlite3ErrorMsg(pParse, "unknown function: %.*s()", nId, zId);
2592feb306f5Sdrh         break;
2593feb306f5Sdrh       }
2594ae6bb957Sdrh 
2595ae6bb957Sdrh       /* Attempt a direct implementation of the built-in COALESCE() and
2596ae6bb957Sdrh       ** IFNULL() functions.  This avoids unnecessary evalation of
2597ae6bb957Sdrh       ** arguments past the first non-NULL argument.
2598ae6bb957Sdrh       */
2599ae6bb957Sdrh       if( pDef->flags & SQLITE_FUNC_COALESCE ){
2600ae6bb957Sdrh         int endCoalesce = sqlite3VdbeMakeLabel(v);
2601ae6bb957Sdrh         assert( nFarg>=2 );
2602ae6bb957Sdrh         sqlite3ExprCode(pParse, pFarg->a[0].pExpr, target);
2603ae6bb957Sdrh         for(i=1; i<nFarg; i++){
2604ae6bb957Sdrh           sqlite3VdbeAddOp2(v, OP_NotNull, target, endCoalesce);
2605f49f3523Sdrh           sqlite3ExprCacheRemove(pParse, target, 1);
2606ae6bb957Sdrh           sqlite3ExprCachePush(pParse);
2607ae6bb957Sdrh           sqlite3ExprCode(pParse, pFarg->a[i].pExpr, target);
2608ae6bb957Sdrh           sqlite3ExprCachePop(pParse, 1);
2609ae6bb957Sdrh         }
2610ae6bb957Sdrh         sqlite3VdbeResolveLabel(v, endCoalesce);
2611ae6bb957Sdrh         break;
2612ae6bb957Sdrh       }
2613ae6bb957Sdrh 
2614ae6bb957Sdrh 
261512ffee8cSdrh       if( pFarg ){
261612ffee8cSdrh         r1 = sqlite3GetTempRange(pParse, nFarg);
2617d7d385ddSdrh         sqlite3ExprCachePush(pParse);     /* Ticket 2ea2425d34be */
261812ffee8cSdrh         sqlite3ExprCodeExprList(pParse, pFarg, r1, 1);
2619d7d385ddSdrh         sqlite3ExprCachePop(pParse, 1);   /* Ticket 2ea2425d34be */
2620892d3179Sdrh       }else{
262112ffee8cSdrh         r1 = 0;
2622892d3179Sdrh       }
2623b7f6f68fSdrh #ifndef SQLITE_OMIT_VIRTUALTABLE
2624a43fa227Sdrh       /* Possibly overload the function if the first argument is
2625a43fa227Sdrh       ** a virtual table column.
2626a43fa227Sdrh       **
2627a43fa227Sdrh       ** For infix functions (LIKE, GLOB, REGEXP, and MATCH) use the
2628a43fa227Sdrh       ** second argument, not the first, as the argument to test to
2629a43fa227Sdrh       ** see if it is a column in a virtual table.  This is done because
2630a43fa227Sdrh       ** the left operand of infix functions (the operand we want to
2631a43fa227Sdrh       ** control overloading) ends up as the second argument to the
2632a43fa227Sdrh       ** function.  The expression "A glob B" is equivalent to
2633a43fa227Sdrh       ** "glob(B,A).  We want to use the A in "A glob B" to test
2634a43fa227Sdrh       ** for function overloading.  But we use the B term in "glob(B,A)".
2635a43fa227Sdrh       */
263612ffee8cSdrh       if( nFarg>=2 && (pExpr->flags & EP_InfixFunc) ){
263712ffee8cSdrh         pDef = sqlite3VtabOverloadFunction(db, pDef, nFarg, pFarg->a[1].pExpr);
263812ffee8cSdrh       }else if( nFarg>0 ){
263912ffee8cSdrh         pDef = sqlite3VtabOverloadFunction(db, pDef, nFarg, pFarg->a[0].pExpr);
2640b7f6f68fSdrh       }
2641b7f6f68fSdrh #endif
2642f7bca574Sdrh       for(i=0; i<nFarg; i++){
2643f7bca574Sdrh         if( i<32 && sqlite3ExprIsConstant(pFarg->a[i].pExpr) ){
264413449892Sdrh           constMask |= (1<<i);
2645d02eb1fdSdanielk1977         }
2646e82f5d04Sdrh         if( (pDef->flags & SQLITE_FUNC_NEEDCOLL)!=0 && !pColl ){
264712ffee8cSdrh           pColl = sqlite3ExprCollSeq(pParse, pFarg->a[i].pExpr);
2648dc1bdc4fSdanielk1977         }
2649dc1bdc4fSdanielk1977       }
2650e82f5d04Sdrh       if( pDef->flags & SQLITE_FUNC_NEEDCOLL ){
26518b213899Sdrh         if( !pColl ) pColl = db->pDfltColl;
265266a5167bSdrh         sqlite3VdbeAddOp4(v, OP_CollSeq, 0, 0, 0, (char *)pColl, P4_COLLSEQ);
2653682f68b0Sdanielk1977       }
26542dcef11bSdrh       sqlite3VdbeAddOp4(v, OP_Function, constMask, r1, target,
265566a5167bSdrh                         (char*)pDef, P4_FUNCDEF);
265612ffee8cSdrh       sqlite3VdbeChangeP5(v, (u8)nFarg);
265712ffee8cSdrh       if( nFarg ){
265812ffee8cSdrh         sqlite3ReleaseTempRange(pParse, r1, nFarg);
26592dcef11bSdrh       }
26606ec2733bSdrh       break;
26616ec2733bSdrh     }
2662fe2093d7Sdrh #ifndef SQLITE_OMIT_SUBQUERY
2663fe2093d7Sdrh     case TK_EXISTS:
266419a775c2Sdrh     case TK_SELECT: {
2665c5499befSdrh       testcase( op==TK_EXISTS );
2666c5499befSdrh       testcase( op==TK_SELECT );
26671450bc6eSdrh       inReg = sqlite3CodeSubselect(pParse, pExpr, 0, 0);
266819a775c2Sdrh       break;
266919a775c2Sdrh     }
2670fef5208cSdrh     case TK_IN: {
2671e3365e6cSdrh       int destIfFalse = sqlite3VdbeMakeLabel(v);
2672e3365e6cSdrh       int destIfNull = sqlite3VdbeMakeLabel(v);
2673e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Null, 0, target);
2674e3365e6cSdrh       sqlite3ExprCodeIN(pParse, pExpr, destIfFalse, destIfNull);
267566ba23ceSdrh       sqlite3VdbeAddOp2(v, OP_Integer, 1, target);
2676e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfFalse);
2677e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_AddImm, target, 0);
2678e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfNull);
2679fef5208cSdrh       break;
2680fef5208cSdrh     }
2681e3365e6cSdrh #endif /* SQLITE_OMIT_SUBQUERY */
2682e3365e6cSdrh 
2683e3365e6cSdrh 
26842dcef11bSdrh     /*
26852dcef11bSdrh     **    x BETWEEN y AND z
26862dcef11bSdrh     **
26872dcef11bSdrh     ** This is equivalent to
26882dcef11bSdrh     **
26892dcef11bSdrh     **    x>=y AND x<=z
26902dcef11bSdrh     **
26912dcef11bSdrh     ** X is stored in pExpr->pLeft.
26922dcef11bSdrh     ** Y is stored in pExpr->pList->a[0].pExpr.
26932dcef11bSdrh     ** Z is stored in pExpr->pList->a[1].pExpr.
26942dcef11bSdrh     */
2695fef5208cSdrh     case TK_BETWEEN: {
2696be5c89acSdrh       Expr *pLeft = pExpr->pLeft;
26976ab3a2ecSdanielk1977       struct ExprList_item *pLItem = pExpr->x.pList->a;
2698be5c89acSdrh       Expr *pRight = pLItem->pExpr;
269935573356Sdrh 
2700b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pLeft, &regFree1);
2701b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pRight, &regFree2);
2702c5499befSdrh       testcase( regFree1==0 );
2703c5499befSdrh       testcase( regFree2==0 );
27042dcef11bSdrh       r3 = sqlite3GetTempReg(pParse);
2705678ccce8Sdrh       r4 = sqlite3GetTempReg(pParse);
270635573356Sdrh       codeCompare(pParse, pLeft, pRight, OP_Ge,
270735573356Sdrh                   r1, r2, r3, SQLITE_STOREP2);
2708be5c89acSdrh       pLItem++;
2709be5c89acSdrh       pRight = pLItem->pExpr;
27102dcef11bSdrh       sqlite3ReleaseTempReg(pParse, regFree2);
27112dcef11bSdrh       r2 = sqlite3ExprCodeTemp(pParse, pRight, &regFree2);
2712c5499befSdrh       testcase( regFree2==0 );
2713678ccce8Sdrh       codeCompare(pParse, pLeft, pRight, OP_Le, r1, r2, r4, SQLITE_STOREP2);
2714678ccce8Sdrh       sqlite3VdbeAddOp3(v, OP_And, r3, r4, target);
27152dcef11bSdrh       sqlite3ReleaseTempReg(pParse, r3);
2716678ccce8Sdrh       sqlite3ReleaseTempReg(pParse, r4);
2717fef5208cSdrh       break;
2718fef5208cSdrh     }
27194f07e5fbSdrh     case TK_UPLUS: {
27202dcef11bSdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
2721a2e00042Sdrh       break;
2722a2e00042Sdrh     }
27232dcef11bSdrh 
2724165921a7Sdan     case TK_TRIGGER: {
272565a7cd16Sdan       /* If the opcode is TK_TRIGGER, then the expression is a reference
272665a7cd16Sdan       ** to a column in the new.* or old.* pseudo-tables available to
272765a7cd16Sdan       ** trigger programs. In this case Expr.iTable is set to 1 for the
272865a7cd16Sdan       ** new.* pseudo-table, or 0 for the old.* pseudo-table. Expr.iColumn
272965a7cd16Sdan       ** is set to the column of the pseudo-table to read, or to -1 to
273065a7cd16Sdan       ** read the rowid field.
273165a7cd16Sdan       **
273265a7cd16Sdan       ** The expression is implemented using an OP_Param opcode. The p1
273365a7cd16Sdan       ** parameter is set to 0 for an old.rowid reference, or to (i+1)
273465a7cd16Sdan       ** to reference another column of the old.* pseudo-table, where
273565a7cd16Sdan       ** i is the index of the column. For a new.rowid reference, p1 is
273665a7cd16Sdan       ** set to (n+1), where n is the number of columns in each pseudo-table.
273765a7cd16Sdan       ** For a reference to any other column in the new.* pseudo-table, p1
273865a7cd16Sdan       ** is set to (n+2+i), where n and i are as defined previously. For
273965a7cd16Sdan       ** example, if the table on which triggers are being fired is
274065a7cd16Sdan       ** declared as:
274165a7cd16Sdan       **
274265a7cd16Sdan       **   CREATE TABLE t1(a, b);
274365a7cd16Sdan       **
274465a7cd16Sdan       ** Then p1 is interpreted as follows:
274565a7cd16Sdan       **
274665a7cd16Sdan       **   p1==0   ->    old.rowid     p1==3   ->    new.rowid
274765a7cd16Sdan       **   p1==1   ->    old.a         p1==4   ->    new.a
274865a7cd16Sdan       **   p1==2   ->    old.b         p1==5   ->    new.b
274965a7cd16Sdan       */
27502832ad42Sdan       Table *pTab = pExpr->pTab;
275165a7cd16Sdan       int p1 = pExpr->iTable * (pTab->nCol+1) + 1 + pExpr->iColumn;
275265a7cd16Sdan 
275365a7cd16Sdan       assert( pExpr->iTable==0 || pExpr->iTable==1 );
275465a7cd16Sdan       assert( pExpr->iColumn>=-1 && pExpr->iColumn<pTab->nCol );
275565a7cd16Sdan       assert( pTab->iPKey<0 || pExpr->iColumn!=pTab->iPKey );
275665a7cd16Sdan       assert( p1>=0 && p1<(pTab->nCol*2+2) );
275765a7cd16Sdan 
275865a7cd16Sdan       sqlite3VdbeAddOp2(v, OP_Param, p1, target);
275976d462eeSdan       VdbeComment((v, "%s.%s -> $%d",
2760165921a7Sdan         (pExpr->iTable ? "new" : "old"),
276176d462eeSdan         (pExpr->iColumn<0 ? "rowid" : pExpr->pTab->aCol[pExpr->iColumn].zName),
276276d462eeSdan         target
2763165921a7Sdan       ));
276465a7cd16Sdan 
276544dbca83Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
276665a7cd16Sdan       /* If the column has REAL affinity, it may currently be stored as an
276765a7cd16Sdan       ** integer. Use OP_RealAffinity to make sure it is really real.  */
27682832ad42Sdan       if( pExpr->iColumn>=0
27692832ad42Sdan        && pTab->aCol[pExpr->iColumn].affinity==SQLITE_AFF_REAL
27702832ad42Sdan       ){
27712832ad42Sdan         sqlite3VdbeAddOp1(v, OP_RealAffinity, target);
27722832ad42Sdan       }
277344dbca83Sdrh #endif
2774165921a7Sdan       break;
2775165921a7Sdan     }
2776165921a7Sdan 
2777165921a7Sdan 
27782dcef11bSdrh     /*
27792dcef11bSdrh     ** Form A:
27802dcef11bSdrh     **   CASE x WHEN e1 THEN r1 WHEN e2 THEN r2 ... WHEN eN THEN rN ELSE y END
27812dcef11bSdrh     **
27822dcef11bSdrh     ** Form B:
27832dcef11bSdrh     **   CASE WHEN e1 THEN r1 WHEN e2 THEN r2 ... WHEN eN THEN rN ELSE y END
27842dcef11bSdrh     **
27852dcef11bSdrh     ** Form A is can be transformed into the equivalent form B as follows:
27862dcef11bSdrh     **   CASE WHEN x=e1 THEN r1 WHEN x=e2 THEN r2 ...
27872dcef11bSdrh     **        WHEN x=eN THEN rN ELSE y END
27882dcef11bSdrh     **
27892dcef11bSdrh     ** X (if it exists) is in pExpr->pLeft.
27902dcef11bSdrh     ** Y is in pExpr->pRight.  The Y is also optional.  If there is no
27912dcef11bSdrh     ** ELSE clause and no other term matches, then the result of the
27922dcef11bSdrh     ** exprssion is NULL.
27932dcef11bSdrh     ** Ei is in pExpr->pList->a[i*2] and Ri is pExpr->pList->a[i*2+1].
27942dcef11bSdrh     **
27952dcef11bSdrh     ** The result of the expression is the Ri for the first matching Ei,
27962dcef11bSdrh     ** or if there is no matching Ei, the ELSE term Y, or if there is
27972dcef11bSdrh     ** no ELSE term, NULL.
27982dcef11bSdrh     */
279933cd4909Sdrh     default: assert( op==TK_CASE ); {
28002dcef11bSdrh       int endLabel;                     /* GOTO label for end of CASE stmt */
28012dcef11bSdrh       int nextCase;                     /* GOTO label for next WHEN clause */
28022dcef11bSdrh       int nExpr;                        /* 2x number of WHEN terms */
28032dcef11bSdrh       int i;                            /* Loop counter */
28042dcef11bSdrh       ExprList *pEList;                 /* List of WHEN terms */
28052dcef11bSdrh       struct ExprList_item *aListelem;  /* Array of WHEN terms */
28062dcef11bSdrh       Expr opCompare;                   /* The X==Ei expression */
28072dcef11bSdrh       Expr cacheX;                      /* Cached expression X */
28082dcef11bSdrh       Expr *pX;                         /* The X expression */
28091bd10f8aSdrh       Expr *pTest = 0;                  /* X==Ei (form A) or just Ei (form B) */
2810ceea3321Sdrh       VVA_ONLY( int iCacheLevel = pParse->iCacheLevel; )
281117a7f8ddSdrh 
28126ab3a2ecSdanielk1977       assert( !ExprHasProperty(pExpr, EP_xIsSelect) && pExpr->x.pList );
28136ab3a2ecSdanielk1977       assert((pExpr->x.pList->nExpr % 2) == 0);
28146ab3a2ecSdanielk1977       assert(pExpr->x.pList->nExpr > 0);
28156ab3a2ecSdanielk1977       pEList = pExpr->x.pList;
2816be5c89acSdrh       aListelem = pEList->a;
2817be5c89acSdrh       nExpr = pEList->nExpr;
28182dcef11bSdrh       endLabel = sqlite3VdbeMakeLabel(v);
28192dcef11bSdrh       if( (pX = pExpr->pLeft)!=0 ){
28202dcef11bSdrh         cacheX = *pX;
282133cd4909Sdrh         testcase( pX->op==TK_COLUMN );
282233cd4909Sdrh         testcase( pX->op==TK_REGISTER );
28232dcef11bSdrh         cacheX.iTable = sqlite3ExprCodeTemp(pParse, pX, &regFree1);
2824c5499befSdrh         testcase( regFree1==0 );
28252dcef11bSdrh         cacheX.op = TK_REGISTER;
28262dcef11bSdrh         opCompare.op = TK_EQ;
28272dcef11bSdrh         opCompare.pLeft = &cacheX;
28282dcef11bSdrh         pTest = &opCompare;
2829cce7d176Sdrh       }
2830f5905aa7Sdrh       for(i=0; i<nExpr; i=i+2){
2831ceea3321Sdrh         sqlite3ExprCachePush(pParse);
28322dcef11bSdrh         if( pX ){
28331bd10f8aSdrh           assert( pTest!=0 );
28342dcef11bSdrh           opCompare.pRight = aListelem[i].pExpr;
2835f5905aa7Sdrh         }else{
28362dcef11bSdrh           pTest = aListelem[i].pExpr;
283717a7f8ddSdrh         }
28382dcef11bSdrh         nextCase = sqlite3VdbeMakeLabel(v);
283933cd4909Sdrh         testcase( pTest->op==TK_COLUMN );
28402dcef11bSdrh         sqlite3ExprIfFalse(pParse, pTest, nextCase, SQLITE_JUMPIFNULL);
2841c5499befSdrh         testcase( aListelem[i+1].pExpr->op==TK_COLUMN );
2842c5499befSdrh         testcase( aListelem[i+1].pExpr->op==TK_REGISTER );
28439de221dfSdrh         sqlite3ExprCode(pParse, aListelem[i+1].pExpr, target);
28442dcef11bSdrh         sqlite3VdbeAddOp2(v, OP_Goto, 0, endLabel);
2845ceea3321Sdrh         sqlite3ExprCachePop(pParse, 1);
28462dcef11bSdrh         sqlite3VdbeResolveLabel(v, nextCase);
2847f570f011Sdrh       }
284817a7f8ddSdrh       if( pExpr->pRight ){
2849ceea3321Sdrh         sqlite3ExprCachePush(pParse);
28509de221dfSdrh         sqlite3ExprCode(pParse, pExpr->pRight, target);
2851ceea3321Sdrh         sqlite3ExprCachePop(pParse, 1);
285217a7f8ddSdrh       }else{
28539de221dfSdrh         sqlite3VdbeAddOp2(v, OP_Null, 0, target);
285417a7f8ddSdrh       }
2855c1f4a19bSdanielk1977       assert( db->mallocFailed || pParse->nErr>0
2856c1f4a19bSdanielk1977            || pParse->iCacheLevel==iCacheLevel );
28572dcef11bSdrh       sqlite3VdbeResolveLabel(v, endLabel);
28586f34903eSdanielk1977       break;
28596f34903eSdanielk1977     }
28605338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_TRIGGER
28616f34903eSdanielk1977     case TK_RAISE: {
2862165921a7Sdan       assert( pExpr->affinity==OE_Rollback
2863165921a7Sdan            || pExpr->affinity==OE_Abort
2864165921a7Sdan            || pExpr->affinity==OE_Fail
2865165921a7Sdan            || pExpr->affinity==OE_Ignore
2866165921a7Sdan       );
2867e0af83acSdan       if( !pParse->pTriggerTab ){
2868e0af83acSdan         sqlite3ErrorMsg(pParse,
2869e0af83acSdan                        "RAISE() may only be used within a trigger-program");
2870e0af83acSdan         return 0;
2871e0af83acSdan       }
2872e0af83acSdan       if( pExpr->affinity==OE_Abort ){
2873e0af83acSdan         sqlite3MayAbort(pParse);
2874e0af83acSdan       }
287533e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
2876e0af83acSdan       if( pExpr->affinity==OE_Ignore ){
2877e0af83acSdan         sqlite3VdbeAddOp4(
2878e0af83acSdan             v, OP_Halt, SQLITE_OK, OE_Ignore, 0, pExpr->u.zToken,0);
2879e0af83acSdan       }else{
2880e0af83acSdan         sqlite3HaltConstraint(pParse, pExpr->affinity, pExpr->u.zToken, 0);
2881e0af83acSdan       }
2882e0af83acSdan 
2883ffe07b2dSdrh       break;
288417a7f8ddSdrh     }
28855338a5f7Sdanielk1977 #endif
2886ffe07b2dSdrh   }
28872dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
28882dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
28892dcef11bSdrh   return inReg;
28905b6afba9Sdrh }
28912dcef11bSdrh 
28922dcef11bSdrh /*
28932dcef11bSdrh ** Generate code to evaluate an expression and store the results
28942dcef11bSdrh ** into a register.  Return the register number where the results
28952dcef11bSdrh ** are stored.
28962dcef11bSdrh **
28972dcef11bSdrh ** If the register is a temporary register that can be deallocated,
2898678ccce8Sdrh ** then write its number into *pReg.  If the result register is not
28992dcef11bSdrh ** a temporary, then set *pReg to zero.
29002dcef11bSdrh */
29012dcef11bSdrh int sqlite3ExprCodeTemp(Parse *pParse, Expr *pExpr, int *pReg){
29022dcef11bSdrh   int r1 = sqlite3GetTempReg(pParse);
29032dcef11bSdrh   int r2 = sqlite3ExprCodeTarget(pParse, pExpr, r1);
29042dcef11bSdrh   if( r2==r1 ){
29052dcef11bSdrh     *pReg = r1;
29062dcef11bSdrh   }else{
29072dcef11bSdrh     sqlite3ReleaseTempReg(pParse, r1);
29082dcef11bSdrh     *pReg = 0;
29092dcef11bSdrh   }
29102dcef11bSdrh   return r2;
29112dcef11bSdrh }
29122dcef11bSdrh 
29132dcef11bSdrh /*
29142dcef11bSdrh ** Generate code that will evaluate expression pExpr and store the
29152dcef11bSdrh ** results in register target.  The results are guaranteed to appear
29162dcef11bSdrh ** in register target.
29172dcef11bSdrh */
29182dcef11bSdrh int sqlite3ExprCode(Parse *pParse, Expr *pExpr, int target){
29199cbf3425Sdrh   int inReg;
29209cbf3425Sdrh 
29219cbf3425Sdrh   assert( target>0 && target<=pParse->nMem );
29229cbf3425Sdrh   inReg = sqlite3ExprCodeTarget(pParse, pExpr, target);
29230e359b30Sdrh   assert( pParse->pVdbe || pParse->db->mallocFailed );
29240e359b30Sdrh   if( inReg!=target && pParse->pVdbe ){
29259cbf3425Sdrh     sqlite3VdbeAddOp2(pParse->pVdbe, OP_SCopy, inReg, target);
292617a7f8ddSdrh   }
2927389a1adbSdrh   return target;
2928cce7d176Sdrh }
2929cce7d176Sdrh 
2930cce7d176Sdrh /*
29312dcef11bSdrh ** Generate code that evalutes the given expression and puts the result
2932de4fcfddSdrh ** in register target.
293325303780Sdrh **
29342dcef11bSdrh ** Also make a copy of the expression results into another "cache" register
29352dcef11bSdrh ** and modify the expression so that the next time it is evaluated,
29362dcef11bSdrh ** the result is a copy of the cache register.
29372dcef11bSdrh **
29382dcef11bSdrh ** This routine is used for expressions that are used multiple
29392dcef11bSdrh ** times.  They are evaluated once and the results of the expression
29402dcef11bSdrh ** are reused.
294125303780Sdrh */
29422dcef11bSdrh int sqlite3ExprCodeAndCache(Parse *pParse, Expr *pExpr, int target){
294325303780Sdrh   Vdbe *v = pParse->pVdbe;
29442dcef11bSdrh   int inReg;
29452dcef11bSdrh   inReg = sqlite3ExprCode(pParse, pExpr, target);
2946de4fcfddSdrh   assert( target>0 );
294720bc393cSdrh   /* This routine is called for terms to INSERT or UPDATE.  And the only
294820bc393cSdrh   ** other place where expressions can be converted into TK_REGISTER is
294920bc393cSdrh   ** in WHERE clause processing.  So as currently implemented, there is
295020bc393cSdrh   ** no way for a TK_REGISTER to exist here.  But it seems prudent to
295120bc393cSdrh   ** keep the ALWAYS() in case the conditions above change with future
295220bc393cSdrh   ** modifications or enhancements. */
295320bc393cSdrh   if( ALWAYS(pExpr->op!=TK_REGISTER) ){
295425303780Sdrh     int iMem;
29552dcef11bSdrh     iMem = ++pParse->nMem;
29562dcef11bSdrh     sqlite3VdbeAddOp2(v, OP_Copy, inReg, iMem);
29572dcef11bSdrh     pExpr->iTable = iMem;
2958937d0deaSdan     pExpr->op2 = pExpr->op;
295925303780Sdrh     pExpr->op = TK_REGISTER;
296025303780Sdrh   }
29612dcef11bSdrh   return inReg;
296225303780Sdrh }
29632dcef11bSdrh 
2964678ccce8Sdrh /*
296547de955eSdrh ** Return TRUE if pExpr is an constant expression that is appropriate
296647de955eSdrh ** for factoring out of a loop.  Appropriate expressions are:
296747de955eSdrh **
296847de955eSdrh **    *  Any expression that evaluates to two or more opcodes.
296947de955eSdrh **
297047de955eSdrh **    *  Any OP_Integer, OP_Real, OP_String, OP_Blob, OP_Null,
297147de955eSdrh **       or OP_Variable that does not need to be placed in a
297247de955eSdrh **       specific register.
297347de955eSdrh **
297447de955eSdrh ** There is no point in factoring out single-instruction constant
297547de955eSdrh ** expressions that need to be placed in a particular register.
297647de955eSdrh ** We could factor them out, but then we would end up adding an
297747de955eSdrh ** OP_SCopy instruction to move the value into the correct register
297847de955eSdrh ** later.  We might as well just use the original instruction and
297947de955eSdrh ** avoid the OP_SCopy.
298047de955eSdrh */
298147de955eSdrh static int isAppropriateForFactoring(Expr *p){
298247de955eSdrh   if( !sqlite3ExprIsConstantNotJoin(p) ){
298347de955eSdrh     return 0;  /* Only constant expressions are appropriate for factoring */
298447de955eSdrh   }
298547de955eSdrh   if( (p->flags & EP_FixedDest)==0 ){
298647de955eSdrh     return 1;  /* Any constant without a fixed destination is appropriate */
298747de955eSdrh   }
298847de955eSdrh   while( p->op==TK_UPLUS ) p = p->pLeft;
298947de955eSdrh   switch( p->op ){
299047de955eSdrh #ifndef SQLITE_OMIT_BLOB_LITERAL
299147de955eSdrh     case TK_BLOB:
299247de955eSdrh #endif
299347de955eSdrh     case TK_VARIABLE:
299447de955eSdrh     case TK_INTEGER:
299547de955eSdrh     case TK_FLOAT:
299647de955eSdrh     case TK_NULL:
299747de955eSdrh     case TK_STRING: {
299847de955eSdrh       testcase( p->op==TK_BLOB );
299947de955eSdrh       testcase( p->op==TK_VARIABLE );
300047de955eSdrh       testcase( p->op==TK_INTEGER );
300147de955eSdrh       testcase( p->op==TK_FLOAT );
300247de955eSdrh       testcase( p->op==TK_NULL );
300347de955eSdrh       testcase( p->op==TK_STRING );
300447de955eSdrh       /* Single-instruction constants with a fixed destination are
300547de955eSdrh       ** better done in-line.  If we factor them, they will just end
300647de955eSdrh       ** up generating an OP_SCopy to move the value to the destination
300747de955eSdrh       ** register. */
300847de955eSdrh       return 0;
300947de955eSdrh     }
301047de955eSdrh     case TK_UMINUS: {
301147de955eSdrh       if( p->pLeft->op==TK_FLOAT || p->pLeft->op==TK_INTEGER ){
301247de955eSdrh         return 0;
301347de955eSdrh       }
301447de955eSdrh       break;
301547de955eSdrh     }
301647de955eSdrh     default: {
301747de955eSdrh       break;
301847de955eSdrh     }
301947de955eSdrh   }
302047de955eSdrh   return 1;
302147de955eSdrh }
302247de955eSdrh 
302347de955eSdrh /*
302447de955eSdrh ** If pExpr is a constant expression that is appropriate for
302547de955eSdrh ** factoring out of a loop, then evaluate the expression
3026678ccce8Sdrh ** into a register and convert the expression into a TK_REGISTER
3027678ccce8Sdrh ** expression.
3028678ccce8Sdrh */
30297d10d5a6Sdrh static int evalConstExpr(Walker *pWalker, Expr *pExpr){
30307d10d5a6Sdrh   Parse *pParse = pWalker->pParse;
303147de955eSdrh   switch( pExpr->op ){
3032e05c929bSdrh     case TK_IN:
303347de955eSdrh     case TK_REGISTER: {
303433cd4909Sdrh       return WRC_Prune;
3035678ccce8Sdrh     }
303647de955eSdrh     case TK_FUNCTION:
303747de955eSdrh     case TK_AGG_FUNCTION:
303847de955eSdrh     case TK_CONST_FUNC: {
303947de955eSdrh       /* The arguments to a function have a fixed destination.
304047de955eSdrh       ** Mark them this way to avoid generated unneeded OP_SCopy
304147de955eSdrh       ** instructions.
304247de955eSdrh       */
30436ab3a2ecSdanielk1977       ExprList *pList = pExpr->x.pList;
30446ab3a2ecSdanielk1977       assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
304547de955eSdrh       if( pList ){
304647de955eSdrh         int i = pList->nExpr;
304747de955eSdrh         struct ExprList_item *pItem = pList->a;
304847de955eSdrh         for(; i>0; i--, pItem++){
304933cd4909Sdrh           if( ALWAYS(pItem->pExpr) ) pItem->pExpr->flags |= EP_FixedDest;
305047de955eSdrh         }
305147de955eSdrh       }
305247de955eSdrh       break;
305347de955eSdrh     }
305447de955eSdrh   }
305547de955eSdrh   if( isAppropriateForFactoring(pExpr) ){
3056678ccce8Sdrh     int r1 = ++pParse->nMem;
3057678ccce8Sdrh     int r2;
3058678ccce8Sdrh     r2 = sqlite3ExprCodeTarget(pParse, pExpr, r1);
305933cd4909Sdrh     if( NEVER(r1!=r2) ) sqlite3ReleaseTempReg(pParse, r1);
3060fcd4a150Sdan     pExpr->op2 = pExpr->op;
3061678ccce8Sdrh     pExpr->op = TK_REGISTER;
3062678ccce8Sdrh     pExpr->iTable = r2;
30637d10d5a6Sdrh     return WRC_Prune;
3064678ccce8Sdrh   }
30657d10d5a6Sdrh   return WRC_Continue;
3066678ccce8Sdrh }
3067678ccce8Sdrh 
3068678ccce8Sdrh /*
3069678ccce8Sdrh ** Preevaluate constant subexpressions within pExpr and store the
3070678ccce8Sdrh ** results in registers.  Modify pExpr so that the constant subexpresions
3071678ccce8Sdrh ** are TK_REGISTER opcodes that refer to the precomputed values.
3072678ccce8Sdrh */
3073678ccce8Sdrh void sqlite3ExprCodeConstants(Parse *pParse, Expr *pExpr){
30747d10d5a6Sdrh   Walker w;
30757d10d5a6Sdrh   w.xExprCallback = evalConstExpr;
30767d10d5a6Sdrh   w.xSelectCallback = 0;
30777d10d5a6Sdrh   w.pParse = pParse;
30787d10d5a6Sdrh   sqlite3WalkExpr(&w, pExpr);
3079678ccce8Sdrh }
3080678ccce8Sdrh 
308125303780Sdrh 
308225303780Sdrh /*
3083268380caSdrh ** Generate code that pushes the value of every element of the given
30849cbf3425Sdrh ** expression list into a sequence of registers beginning at target.
3085268380caSdrh **
3086892d3179Sdrh ** Return the number of elements evaluated.
3087268380caSdrh */
30884adee20fSdanielk1977 int sqlite3ExprCodeExprList(
3089268380caSdrh   Parse *pParse,     /* Parsing context */
3090389a1adbSdrh   ExprList *pList,   /* The expression list to be coded */
3091191b54cbSdrh   int target,        /* Where to write results */
3092d176611bSdrh   int doHardCopy     /* Make a hard copy of every element */
3093268380caSdrh ){
3094268380caSdrh   struct ExprList_item *pItem;
30959cbf3425Sdrh   int i, n;
30969d8b3072Sdrh   assert( pList!=0 );
30979cbf3425Sdrh   assert( target>0 );
3098268380caSdrh   n = pList->nExpr;
3099191b54cbSdrh   for(pItem=pList->a, i=0; i<n; i++, pItem++){
31008b213899Sdrh     if( pItem->iAlias ){
310131daa63fSdrh       int iReg = codeAlias(pParse, pItem->iAlias, pItem->pExpr, target+i);
31028b213899Sdrh       Vdbe *v = sqlite3GetVdbe(pParse);
310331daa63fSdrh       if( iReg!=target+i ){
31048b213899Sdrh         sqlite3VdbeAddOp2(v, OP_SCopy, iReg, target+i);
310531daa63fSdrh       }
3106d176611bSdrh     }else{
3107191b54cbSdrh       sqlite3ExprCode(pParse, pItem->pExpr, target+i);
31088b213899Sdrh     }
310920411ea7Sdrh     if( doHardCopy && !pParse->db->mallocFailed ){
3110d176611bSdrh       sqlite3ExprHardCopy(pParse, target, n);
3111d176611bSdrh     }
3112268380caSdrh   }
3113f9b596ebSdrh   return n;
3114268380caSdrh }
3115268380caSdrh 
3116268380caSdrh /*
311736c563a2Sdrh ** Generate code for a BETWEEN operator.
311836c563a2Sdrh **
311936c563a2Sdrh **    x BETWEEN y AND z
312036c563a2Sdrh **
312136c563a2Sdrh ** The above is equivalent to
312236c563a2Sdrh **
312336c563a2Sdrh **    x>=y AND x<=z
312436c563a2Sdrh **
312536c563a2Sdrh ** Code it as such, taking care to do the common subexpression
312636c563a2Sdrh ** elementation of x.
312736c563a2Sdrh */
312836c563a2Sdrh static void exprCodeBetween(
312936c563a2Sdrh   Parse *pParse,    /* Parsing and code generating context */
313036c563a2Sdrh   Expr *pExpr,      /* The BETWEEN expression */
313136c563a2Sdrh   int dest,         /* Jump here if the jump is taken */
313236c563a2Sdrh   int jumpIfTrue,   /* Take the jump if the BETWEEN is true */
313336c563a2Sdrh   int jumpIfNull    /* Take the jump if the BETWEEN is NULL */
313436c563a2Sdrh ){
313536c563a2Sdrh   Expr exprAnd;     /* The AND operator in  x>=y AND x<=z  */
313636c563a2Sdrh   Expr compLeft;    /* The  x>=y  term */
313736c563a2Sdrh   Expr compRight;   /* The  x<=z  term */
313836c563a2Sdrh   Expr exprX;       /* The  x  subexpression */
313936c563a2Sdrh   int regFree1 = 0; /* Temporary use register */
314036c563a2Sdrh 
314136c563a2Sdrh   assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
314236c563a2Sdrh   exprX = *pExpr->pLeft;
314336c563a2Sdrh   exprAnd.op = TK_AND;
314436c563a2Sdrh   exprAnd.pLeft = &compLeft;
314536c563a2Sdrh   exprAnd.pRight = &compRight;
314636c563a2Sdrh   compLeft.op = TK_GE;
314736c563a2Sdrh   compLeft.pLeft = &exprX;
314836c563a2Sdrh   compLeft.pRight = pExpr->x.pList->a[0].pExpr;
314936c563a2Sdrh   compRight.op = TK_LE;
315036c563a2Sdrh   compRight.pLeft = &exprX;
315136c563a2Sdrh   compRight.pRight = pExpr->x.pList->a[1].pExpr;
315236c563a2Sdrh   exprX.iTable = sqlite3ExprCodeTemp(pParse, &exprX, &regFree1);
315336c563a2Sdrh   exprX.op = TK_REGISTER;
315436c563a2Sdrh   if( jumpIfTrue ){
315536c563a2Sdrh     sqlite3ExprIfTrue(pParse, &exprAnd, dest, jumpIfNull);
315636c563a2Sdrh   }else{
315736c563a2Sdrh     sqlite3ExprIfFalse(pParse, &exprAnd, dest, jumpIfNull);
315836c563a2Sdrh   }
315936c563a2Sdrh   sqlite3ReleaseTempReg(pParse, regFree1);
316036c563a2Sdrh 
316136c563a2Sdrh   /* Ensure adequate test coverage */
316236c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull==0 && regFree1==0 );
316336c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull==0 && regFree1!=0 );
316436c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull!=0 && regFree1==0 );
316536c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull!=0 && regFree1!=0 );
316636c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull==0 && regFree1==0 );
316736c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull==0 && regFree1!=0 );
316836c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull!=0 && regFree1==0 );
316936c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull!=0 && regFree1!=0 );
317036c563a2Sdrh }
317136c563a2Sdrh 
317236c563a2Sdrh /*
3173cce7d176Sdrh ** Generate code for a boolean expression such that a jump is made
3174cce7d176Sdrh ** to the label "dest" if the expression is true but execution
3175cce7d176Sdrh ** continues straight thru if the expression is false.
3176f5905aa7Sdrh **
3177f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false), then
317835573356Sdrh ** take the jump if the jumpIfNull flag is SQLITE_JUMPIFNULL.
3179f2bc013cSdrh **
3180f2bc013cSdrh ** This code depends on the fact that certain token values (ex: TK_EQ)
3181f2bc013cSdrh ** are the same as opcode values (ex: OP_Eq) that implement the corresponding
3182f2bc013cSdrh ** operation.  Special comments in vdbe.c and the mkopcodeh.awk script in
3183f2bc013cSdrh ** the make process cause these values to align.  Assert()s in the code
3184f2bc013cSdrh ** below verify that the numbers are aligned correctly.
3185cce7d176Sdrh */
31864adee20fSdanielk1977 void sqlite3ExprIfTrue(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
3187cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
3188cce7d176Sdrh   int op = 0;
31892dcef11bSdrh   int regFree1 = 0;
31902dcef11bSdrh   int regFree2 = 0;
31912dcef11bSdrh   int r1, r2;
31922dcef11bSdrh 
319335573356Sdrh   assert( jumpIfNull==SQLITE_JUMPIFNULL || jumpIfNull==0 );
319433cd4909Sdrh   if( NEVER(v==0) )     return;  /* Existance of VDBE checked by caller */
319533cd4909Sdrh   if( NEVER(pExpr==0) ) return;  /* No way this can happen */
3196f2bc013cSdrh   op = pExpr->op;
3197f2bc013cSdrh   switch( op ){
3198cce7d176Sdrh     case TK_AND: {
31994adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
3200c5499befSdrh       testcase( jumpIfNull==0 );
3201ceea3321Sdrh       sqlite3ExprCachePush(pParse);
320235573356Sdrh       sqlite3ExprIfFalse(pParse, pExpr->pLeft, d2,jumpIfNull^SQLITE_JUMPIFNULL);
32034adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
32044adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
3205ceea3321Sdrh       sqlite3ExprCachePop(pParse, 1);
3206cce7d176Sdrh       break;
3207cce7d176Sdrh     }
3208cce7d176Sdrh     case TK_OR: {
3209c5499befSdrh       testcase( jumpIfNull==0 );
32104adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
32114adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
3212cce7d176Sdrh       break;
3213cce7d176Sdrh     }
3214cce7d176Sdrh     case TK_NOT: {
3215c5499befSdrh       testcase( jumpIfNull==0 );
32164adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
3217cce7d176Sdrh       break;
3218cce7d176Sdrh     }
3219cce7d176Sdrh     case TK_LT:
3220cce7d176Sdrh     case TK_LE:
3221cce7d176Sdrh     case TK_GT:
3222cce7d176Sdrh     case TK_GE:
3223cce7d176Sdrh     case TK_NE:
32240ac65892Sdrh     case TK_EQ: {
3225f2bc013cSdrh       assert( TK_LT==OP_Lt );
3226f2bc013cSdrh       assert( TK_LE==OP_Le );
3227f2bc013cSdrh       assert( TK_GT==OP_Gt );
3228f2bc013cSdrh       assert( TK_GE==OP_Ge );
3229f2bc013cSdrh       assert( TK_EQ==OP_Eq );
3230f2bc013cSdrh       assert( TK_NE==OP_Ne );
3231c5499befSdrh       testcase( op==TK_LT );
3232c5499befSdrh       testcase( op==TK_LE );
3233c5499befSdrh       testcase( op==TK_GT );
3234c5499befSdrh       testcase( op==TK_GE );
3235c5499befSdrh       testcase( op==TK_EQ );
3236c5499befSdrh       testcase( op==TK_NE );
3237c5499befSdrh       testcase( jumpIfNull==0 );
3238b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3239b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
324035573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
32412dcef11bSdrh                   r1, r2, dest, jumpIfNull);
3242c5499befSdrh       testcase( regFree1==0 );
3243c5499befSdrh       testcase( regFree2==0 );
3244cce7d176Sdrh       break;
3245cce7d176Sdrh     }
32466a2fe093Sdrh     case TK_IS:
32476a2fe093Sdrh     case TK_ISNOT: {
32486a2fe093Sdrh       testcase( op==TK_IS );
32496a2fe093Sdrh       testcase( op==TK_ISNOT );
3250b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3251b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
32526a2fe093Sdrh       op = (op==TK_IS) ? TK_EQ : TK_NE;
32536a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
32546a2fe093Sdrh                   r1, r2, dest, SQLITE_NULLEQ);
32556a2fe093Sdrh       testcase( regFree1==0 );
32566a2fe093Sdrh       testcase( regFree2==0 );
32576a2fe093Sdrh       break;
32586a2fe093Sdrh     }
3259cce7d176Sdrh     case TK_ISNULL:
3260cce7d176Sdrh     case TK_NOTNULL: {
3261f2bc013cSdrh       assert( TK_ISNULL==OP_IsNull );
3262f2bc013cSdrh       assert( TK_NOTNULL==OP_NotNull );
3263c5499befSdrh       testcase( op==TK_ISNULL );
3264c5499befSdrh       testcase( op==TK_NOTNULL );
32652dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
32662dcef11bSdrh       sqlite3VdbeAddOp2(v, op, r1, dest);
3267c5499befSdrh       testcase( regFree1==0 );
3268cce7d176Sdrh       break;
3269cce7d176Sdrh     }
3270fef5208cSdrh     case TK_BETWEEN: {
32715c03f30aSdrh       testcase( jumpIfNull==0 );
327236c563a2Sdrh       exprCodeBetween(pParse, pExpr, dest, 1, jumpIfNull);
3273fef5208cSdrh       break;
3274fef5208cSdrh     }
3275e3365e6cSdrh     case TK_IN: {
3276e3365e6cSdrh       int destIfFalse = sqlite3VdbeMakeLabel(v);
3277e3365e6cSdrh       int destIfNull = jumpIfNull ? dest : destIfFalse;
3278e3365e6cSdrh       sqlite3ExprCodeIN(pParse, pExpr, destIfFalse, destIfNull);
3279e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Goto, 0, dest);
3280e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfFalse);
3281e3365e6cSdrh       break;
3282e3365e6cSdrh     }
3283cce7d176Sdrh     default: {
32842dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr, &regFree1);
32852dcef11bSdrh       sqlite3VdbeAddOp3(v, OP_If, r1, dest, jumpIfNull!=0);
3286c5499befSdrh       testcase( regFree1==0 );
3287c5499befSdrh       testcase( jumpIfNull==0 );
3288cce7d176Sdrh       break;
3289cce7d176Sdrh     }
3290cce7d176Sdrh   }
32912dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
32922dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
3293cce7d176Sdrh }
3294cce7d176Sdrh 
3295cce7d176Sdrh /*
329666b89c8fSdrh ** Generate code for a boolean expression such that a jump is made
3297cce7d176Sdrh ** to the label "dest" if the expression is false but execution
3298cce7d176Sdrh ** continues straight thru if the expression is true.
3299f5905aa7Sdrh **
3300f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false) then
330135573356Sdrh ** jump if jumpIfNull is SQLITE_JUMPIFNULL or fall through if jumpIfNull
330235573356Sdrh ** is 0.
3303cce7d176Sdrh */
33044adee20fSdanielk1977 void sqlite3ExprIfFalse(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
3305cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
3306cce7d176Sdrh   int op = 0;
33072dcef11bSdrh   int regFree1 = 0;
33082dcef11bSdrh   int regFree2 = 0;
33092dcef11bSdrh   int r1, r2;
33102dcef11bSdrh 
331135573356Sdrh   assert( jumpIfNull==SQLITE_JUMPIFNULL || jumpIfNull==0 );
331233cd4909Sdrh   if( NEVER(v==0) ) return; /* Existance of VDBE checked by caller */
331333cd4909Sdrh   if( pExpr==0 )    return;
3314f2bc013cSdrh 
3315f2bc013cSdrh   /* The value of pExpr->op and op are related as follows:
3316f2bc013cSdrh   **
3317f2bc013cSdrh   **       pExpr->op            op
3318f2bc013cSdrh   **       ---------          ----------
3319f2bc013cSdrh   **       TK_ISNULL          OP_NotNull
3320f2bc013cSdrh   **       TK_NOTNULL         OP_IsNull
3321f2bc013cSdrh   **       TK_NE              OP_Eq
3322f2bc013cSdrh   **       TK_EQ              OP_Ne
3323f2bc013cSdrh   **       TK_GT              OP_Le
3324f2bc013cSdrh   **       TK_LE              OP_Gt
3325f2bc013cSdrh   **       TK_GE              OP_Lt
3326f2bc013cSdrh   **       TK_LT              OP_Ge
3327f2bc013cSdrh   **
3328f2bc013cSdrh   ** For other values of pExpr->op, op is undefined and unused.
3329f2bc013cSdrh   ** The value of TK_ and OP_ constants are arranged such that we
3330f2bc013cSdrh   ** can compute the mapping above using the following expression.
3331f2bc013cSdrh   ** Assert()s verify that the computation is correct.
3332f2bc013cSdrh   */
3333f2bc013cSdrh   op = ((pExpr->op+(TK_ISNULL&1))^1)-(TK_ISNULL&1);
3334f2bc013cSdrh 
3335f2bc013cSdrh   /* Verify correct alignment of TK_ and OP_ constants
3336f2bc013cSdrh   */
3337f2bc013cSdrh   assert( pExpr->op!=TK_ISNULL || op==OP_NotNull );
3338f2bc013cSdrh   assert( pExpr->op!=TK_NOTNULL || op==OP_IsNull );
3339f2bc013cSdrh   assert( pExpr->op!=TK_NE || op==OP_Eq );
3340f2bc013cSdrh   assert( pExpr->op!=TK_EQ || op==OP_Ne );
3341f2bc013cSdrh   assert( pExpr->op!=TK_LT || op==OP_Ge );
3342f2bc013cSdrh   assert( pExpr->op!=TK_LE || op==OP_Gt );
3343f2bc013cSdrh   assert( pExpr->op!=TK_GT || op==OP_Le );
3344f2bc013cSdrh   assert( pExpr->op!=TK_GE || op==OP_Lt );
3345f2bc013cSdrh 
3346cce7d176Sdrh   switch( pExpr->op ){
3347cce7d176Sdrh     case TK_AND: {
3348c5499befSdrh       testcase( jumpIfNull==0 );
33494adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
33504adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
3351cce7d176Sdrh       break;
3352cce7d176Sdrh     }
3353cce7d176Sdrh     case TK_OR: {
33544adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
3355c5499befSdrh       testcase( jumpIfNull==0 );
3356ceea3321Sdrh       sqlite3ExprCachePush(pParse);
335735573356Sdrh       sqlite3ExprIfTrue(pParse, pExpr->pLeft, d2, jumpIfNull^SQLITE_JUMPIFNULL);
33584adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
33594adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
3360ceea3321Sdrh       sqlite3ExprCachePop(pParse, 1);
3361cce7d176Sdrh       break;
3362cce7d176Sdrh     }
3363cce7d176Sdrh     case TK_NOT: {
33645c03f30aSdrh       testcase( jumpIfNull==0 );
33654adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
3366cce7d176Sdrh       break;
3367cce7d176Sdrh     }
3368cce7d176Sdrh     case TK_LT:
3369cce7d176Sdrh     case TK_LE:
3370cce7d176Sdrh     case TK_GT:
3371cce7d176Sdrh     case TK_GE:
3372cce7d176Sdrh     case TK_NE:
3373cce7d176Sdrh     case TK_EQ: {
3374c5499befSdrh       testcase( op==TK_LT );
3375c5499befSdrh       testcase( op==TK_LE );
3376c5499befSdrh       testcase( op==TK_GT );
3377c5499befSdrh       testcase( op==TK_GE );
3378c5499befSdrh       testcase( op==TK_EQ );
3379c5499befSdrh       testcase( op==TK_NE );
3380c5499befSdrh       testcase( jumpIfNull==0 );
3381b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3382b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
338335573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
33842dcef11bSdrh                   r1, r2, dest, jumpIfNull);
3385c5499befSdrh       testcase( regFree1==0 );
3386c5499befSdrh       testcase( regFree2==0 );
3387cce7d176Sdrh       break;
3388cce7d176Sdrh     }
33896a2fe093Sdrh     case TK_IS:
33906a2fe093Sdrh     case TK_ISNOT: {
33916d4486aeSdrh       testcase( pExpr->op==TK_IS );
33926d4486aeSdrh       testcase( pExpr->op==TK_ISNOT );
3393b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3394b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
33956a2fe093Sdrh       op = (pExpr->op==TK_IS) ? TK_NE : TK_EQ;
33966a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
33976a2fe093Sdrh                   r1, r2, dest, SQLITE_NULLEQ);
33986a2fe093Sdrh       testcase( regFree1==0 );
33996a2fe093Sdrh       testcase( regFree2==0 );
34006a2fe093Sdrh       break;
34016a2fe093Sdrh     }
3402cce7d176Sdrh     case TK_ISNULL:
3403cce7d176Sdrh     case TK_NOTNULL: {
3404c5499befSdrh       testcase( op==TK_ISNULL );
3405c5499befSdrh       testcase( op==TK_NOTNULL );
34062dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
34072dcef11bSdrh       sqlite3VdbeAddOp2(v, op, r1, dest);
3408c5499befSdrh       testcase( regFree1==0 );
3409cce7d176Sdrh       break;
3410cce7d176Sdrh     }
3411fef5208cSdrh     case TK_BETWEEN: {
34125c03f30aSdrh       testcase( jumpIfNull==0 );
341336c563a2Sdrh       exprCodeBetween(pParse, pExpr, dest, 0, jumpIfNull);
3414fef5208cSdrh       break;
3415fef5208cSdrh     }
3416e3365e6cSdrh     case TK_IN: {
3417e3365e6cSdrh       if( jumpIfNull ){
3418e3365e6cSdrh         sqlite3ExprCodeIN(pParse, pExpr, dest, dest);
3419e3365e6cSdrh       }else{
3420e3365e6cSdrh         int destIfNull = sqlite3VdbeMakeLabel(v);
3421e3365e6cSdrh         sqlite3ExprCodeIN(pParse, pExpr, dest, destIfNull);
3422e3365e6cSdrh         sqlite3VdbeResolveLabel(v, destIfNull);
3423e3365e6cSdrh       }
3424e3365e6cSdrh       break;
3425e3365e6cSdrh     }
3426cce7d176Sdrh     default: {
34272dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr, &regFree1);
34282dcef11bSdrh       sqlite3VdbeAddOp3(v, OP_IfNot, r1, dest, jumpIfNull!=0);
3429c5499befSdrh       testcase( regFree1==0 );
3430c5499befSdrh       testcase( jumpIfNull==0 );
3431cce7d176Sdrh       break;
3432cce7d176Sdrh     }
3433cce7d176Sdrh   }
34342dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
34352dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
3436cce7d176Sdrh }
34372282792aSdrh 
34382282792aSdrh /*
34391d9da70aSdrh ** Do a deep comparison of two expression trees.  Return 0 if the two
34401d9da70aSdrh ** expressions are completely identical.  Return 1 if they differ only
34411d9da70aSdrh ** by a COLLATE operator at the top level.  Return 2 if there are differences
34421d9da70aSdrh ** other than the top-level COLLATE operator.
3443d40aab0eSdrh **
34441d9da70aSdrh ** Sometimes this routine will return 2 even if the two expressions
3445d40aab0eSdrh ** really are equivalent.  If we cannot prove that the expressions are
34461d9da70aSdrh ** identical, we return 2 just to be safe.  So if this routine
34471d9da70aSdrh ** returns 2, then you do not really know for certain if the two
34481d9da70aSdrh ** expressions are the same.  But if you get a 0 or 1 return, then you
3449d40aab0eSdrh ** can be sure the expressions are the same.  In the places where
34501d9da70aSdrh ** this routine is used, it does not hurt to get an extra 2 - that
3451d40aab0eSdrh ** just might result in some slightly slower code.  But returning
34521d9da70aSdrh ** an incorrect 0 or 1 could lead to a malfunction.
34532282792aSdrh */
34544adee20fSdanielk1977 int sqlite3ExprCompare(Expr *pA, Expr *pB){
34554b202ae2Sdanielk1977   if( pA==0||pB==0 ){
34561d9da70aSdrh     return pB==pA ? 0 : 2;
34572282792aSdrh   }
345833e619fcSdrh   assert( !ExprHasAnyProperty(pA, EP_TokenOnly|EP_Reduced) );
345933e619fcSdrh   assert( !ExprHasAnyProperty(pB, EP_TokenOnly|EP_Reduced) );
34606ab3a2ecSdanielk1977   if( ExprHasProperty(pA, EP_xIsSelect) || ExprHasProperty(pB, EP_xIsSelect) ){
34611d9da70aSdrh     return 2;
34626ab3a2ecSdanielk1977   }
34631d9da70aSdrh   if( (pA->flags & EP_Distinct)!=(pB->flags & EP_Distinct) ) return 2;
34641d9da70aSdrh   if( pA->op!=pB->op ) return 2;
34651d9da70aSdrh   if( sqlite3ExprCompare(pA->pLeft, pB->pLeft) ) return 2;
34661d9da70aSdrh   if( sqlite3ExprCompare(pA->pRight, pB->pRight) ) return 2;
34678c6f666bSdrh   if( sqlite3ExprListCompare(pA->x.pList, pB->x.pList) ) return 2;
34681d9da70aSdrh   if( pA->iTable!=pB->iTable || pA->iColumn!=pB->iColumn ) return 2;
346933e619fcSdrh   if( ExprHasProperty(pA, EP_IntValue) ){
347033e619fcSdrh     if( !ExprHasProperty(pB, EP_IntValue) || pA->u.iValue!=pB->u.iValue ){
34711d9da70aSdrh       return 2;
347233e619fcSdrh     }
347333e619fcSdrh   }else if( pA->op!=TK_COLUMN && pA->u.zToken ){
34741d9da70aSdrh     if( ExprHasProperty(pB, EP_IntValue) || NEVER(pB->u.zToken==0) ) return 2;
347533e619fcSdrh     if( sqlite3StrICmp(pA->u.zToken,pB->u.zToken)!=0 ){
34761d9da70aSdrh       return 2;
34771d9da70aSdrh     }
34781d9da70aSdrh   }
34791d9da70aSdrh   if( (pA->flags & EP_ExpCollate)!=(pB->flags & EP_ExpCollate) ) return 1;
34801d9da70aSdrh   if( (pA->flags & EP_ExpCollate)!=0 && pA->pColl!=pB->pColl ) return 2;
34812646da7eSdrh   return 0;
34822646da7eSdrh }
34832282792aSdrh 
34848c6f666bSdrh /*
34858c6f666bSdrh ** Compare two ExprList objects.  Return 0 if they are identical and
34868c6f666bSdrh ** non-zero if they differ in any way.
34878c6f666bSdrh **
34888c6f666bSdrh ** This routine might return non-zero for equivalent ExprLists.  The
34898c6f666bSdrh ** only consequence will be disabled optimizations.  But this routine
34908c6f666bSdrh ** must never return 0 if the two ExprList objects are different, or
34918c6f666bSdrh ** a malfunction will result.
34928c6f666bSdrh **
34938c6f666bSdrh ** Two NULL pointers are considered to be the same.  But a NULL pointer
34948c6f666bSdrh ** always differs from a non-NULL pointer.
34958c6f666bSdrh */
34968c6f666bSdrh int sqlite3ExprListCompare(ExprList *pA, ExprList *pB){
34978c6f666bSdrh   int i;
34988c6f666bSdrh   if( pA==0 && pB==0 ) return 0;
34998c6f666bSdrh   if( pA==0 || pB==0 ) return 1;
35008c6f666bSdrh   if( pA->nExpr!=pB->nExpr ) return 1;
35018c6f666bSdrh   for(i=0; i<pA->nExpr; i++){
35028c6f666bSdrh     Expr *pExprA = pA->a[i].pExpr;
35038c6f666bSdrh     Expr *pExprB = pB->a[i].pExpr;
35048c6f666bSdrh     if( pA->a[i].sortOrder!=pB->a[i].sortOrder ) return 1;
35058c6f666bSdrh     if( sqlite3ExprCompare(pExprA, pExprB) ) return 1;
35068c6f666bSdrh   }
35078c6f666bSdrh   return 0;
35088c6f666bSdrh }
350913449892Sdrh 
35102282792aSdrh /*
351113449892Sdrh ** Add a new element to the pAggInfo->aCol[] array.  Return the index of
351213449892Sdrh ** the new element.  Return a negative number if malloc fails.
35132282792aSdrh */
351417435752Sdrh static int addAggInfoColumn(sqlite3 *db, AggInfo *pInfo){
351513449892Sdrh   int i;
3516cf643729Sdrh   pInfo->aCol = sqlite3ArrayAllocate(
351717435752Sdrh        db,
3518cf643729Sdrh        pInfo->aCol,
3519cf643729Sdrh        sizeof(pInfo->aCol[0]),
3520cf643729Sdrh        3,
3521cf643729Sdrh        &pInfo->nColumn,
3522cf643729Sdrh        &pInfo->nColumnAlloc,
3523cf643729Sdrh        &i
3524cf643729Sdrh   );
352513449892Sdrh   return i;
35262282792aSdrh }
352713449892Sdrh 
352813449892Sdrh /*
352913449892Sdrh ** Add a new element to the pAggInfo->aFunc[] array.  Return the index of
353013449892Sdrh ** the new element.  Return a negative number if malloc fails.
353113449892Sdrh */
353217435752Sdrh static int addAggInfoFunc(sqlite3 *db, AggInfo *pInfo){
353313449892Sdrh   int i;
3534cf643729Sdrh   pInfo->aFunc = sqlite3ArrayAllocate(
353517435752Sdrh        db,
3536cf643729Sdrh        pInfo->aFunc,
3537cf643729Sdrh        sizeof(pInfo->aFunc[0]),
3538cf643729Sdrh        3,
3539cf643729Sdrh        &pInfo->nFunc,
3540cf643729Sdrh        &pInfo->nFuncAlloc,
3541cf643729Sdrh        &i
3542cf643729Sdrh   );
354313449892Sdrh   return i;
35442282792aSdrh }
35452282792aSdrh 
35462282792aSdrh /*
35477d10d5a6Sdrh ** This is the xExprCallback for a tree walker.  It is used to
35487d10d5a6Sdrh ** implement sqlite3ExprAnalyzeAggregates().  See sqlite3ExprAnalyzeAggregates
3549626a879aSdrh ** for additional information.
35502282792aSdrh */
35517d10d5a6Sdrh static int analyzeAggregate(Walker *pWalker, Expr *pExpr){
35522282792aSdrh   int i;
35537d10d5a6Sdrh   NameContext *pNC = pWalker->u.pNC;
3554a58fdfb1Sdanielk1977   Parse *pParse = pNC->pParse;
3555a58fdfb1Sdanielk1977   SrcList *pSrcList = pNC->pSrcList;
355613449892Sdrh   AggInfo *pAggInfo = pNC->pAggInfo;
355713449892Sdrh 
35582282792aSdrh   switch( pExpr->op ){
355989c69d00Sdrh     case TK_AGG_COLUMN:
3560967e8b73Sdrh     case TK_COLUMN: {
35618b213899Sdrh       testcase( pExpr->op==TK_AGG_COLUMN );
35628b213899Sdrh       testcase( pExpr->op==TK_COLUMN );
356313449892Sdrh       /* Check to see if the column is in one of the tables in the FROM
356413449892Sdrh       ** clause of the aggregate query */
356520bc393cSdrh       if( ALWAYS(pSrcList!=0) ){
356613449892Sdrh         struct SrcList_item *pItem = pSrcList->a;
356713449892Sdrh         for(i=0; i<pSrcList->nSrc; i++, pItem++){
356813449892Sdrh           struct AggInfo_col *pCol;
356933e619fcSdrh           assert( !ExprHasAnyProperty(pExpr, EP_TokenOnly|EP_Reduced) );
357013449892Sdrh           if( pExpr->iTable==pItem->iCursor ){
357113449892Sdrh             /* If we reach this point, it means that pExpr refers to a table
357213449892Sdrh             ** that is in the FROM clause of the aggregate query.
357313449892Sdrh             **
357413449892Sdrh             ** Make an entry for the column in pAggInfo->aCol[] if there
357513449892Sdrh             ** is not an entry there already.
357613449892Sdrh             */
35777f906d63Sdrh             int k;
357813449892Sdrh             pCol = pAggInfo->aCol;
35797f906d63Sdrh             for(k=0; k<pAggInfo->nColumn; k++, pCol++){
358013449892Sdrh               if( pCol->iTable==pExpr->iTable &&
358113449892Sdrh                   pCol->iColumn==pExpr->iColumn ){
35822282792aSdrh                 break;
35832282792aSdrh               }
35842282792aSdrh             }
35851e536953Sdanielk1977             if( (k>=pAggInfo->nColumn)
35861e536953Sdanielk1977              && (k = addAggInfoColumn(pParse->db, pAggInfo))>=0
35871e536953Sdanielk1977             ){
35887f906d63Sdrh               pCol = &pAggInfo->aCol[k];
35890817d0dfSdanielk1977               pCol->pTab = pExpr->pTab;
359013449892Sdrh               pCol->iTable = pExpr->iTable;
359113449892Sdrh               pCol->iColumn = pExpr->iColumn;
35920a07c107Sdrh               pCol->iMem = ++pParse->nMem;
359313449892Sdrh               pCol->iSorterColumn = -1;
35945774b806Sdrh               pCol->pExpr = pExpr;
359513449892Sdrh               if( pAggInfo->pGroupBy ){
359613449892Sdrh                 int j, n;
359713449892Sdrh                 ExprList *pGB = pAggInfo->pGroupBy;
359813449892Sdrh                 struct ExprList_item *pTerm = pGB->a;
359913449892Sdrh                 n = pGB->nExpr;
360013449892Sdrh                 for(j=0; j<n; j++, pTerm++){
360113449892Sdrh                   Expr *pE = pTerm->pExpr;
360213449892Sdrh                   if( pE->op==TK_COLUMN && pE->iTable==pExpr->iTable &&
360313449892Sdrh                       pE->iColumn==pExpr->iColumn ){
360413449892Sdrh                     pCol->iSorterColumn = j;
360513449892Sdrh                     break;
36062282792aSdrh                   }
360713449892Sdrh                 }
360813449892Sdrh               }
360913449892Sdrh               if( pCol->iSorterColumn<0 ){
361013449892Sdrh                 pCol->iSorterColumn = pAggInfo->nSortingColumn++;
361113449892Sdrh               }
361213449892Sdrh             }
361313449892Sdrh             /* There is now an entry for pExpr in pAggInfo->aCol[] (either
361413449892Sdrh             ** because it was there before or because we just created it).
361513449892Sdrh             ** Convert the pExpr to be a TK_AGG_COLUMN referring to that
361613449892Sdrh             ** pAggInfo->aCol[] entry.
361713449892Sdrh             */
361833e619fcSdrh             ExprSetIrreducible(pExpr);
361913449892Sdrh             pExpr->pAggInfo = pAggInfo;
362013449892Sdrh             pExpr->op = TK_AGG_COLUMN;
3621cf697396Sshane             pExpr->iAgg = (i16)k;
362213449892Sdrh             break;
362313449892Sdrh           } /* endif pExpr->iTable==pItem->iCursor */
362413449892Sdrh         } /* end loop over pSrcList */
3625a58fdfb1Sdanielk1977       }
36267d10d5a6Sdrh       return WRC_Prune;
36272282792aSdrh     }
36282282792aSdrh     case TK_AGG_FUNCTION: {
362913449892Sdrh       /* The pNC->nDepth==0 test causes aggregate functions in subqueries
363013449892Sdrh       ** to be ignored */
3631a58fdfb1Sdanielk1977       if( pNC->nDepth==0 ){
363213449892Sdrh         /* Check to see if pExpr is a duplicate of another aggregate
363313449892Sdrh         ** function that is already in the pAggInfo structure
363413449892Sdrh         */
363513449892Sdrh         struct AggInfo_func *pItem = pAggInfo->aFunc;
363613449892Sdrh         for(i=0; i<pAggInfo->nFunc; i++, pItem++){
36371d9da70aSdrh           if( sqlite3ExprCompare(pItem->pExpr, pExpr)==0 ){
36382282792aSdrh             break;
36392282792aSdrh           }
36402282792aSdrh         }
364113449892Sdrh         if( i>=pAggInfo->nFunc ){
364213449892Sdrh           /* pExpr is original.  Make a new entry in pAggInfo->aFunc[]
364313449892Sdrh           */
364414db2665Sdanielk1977           u8 enc = ENC(pParse->db);
36451e536953Sdanielk1977           i = addAggInfoFunc(pParse->db, pAggInfo);
364613449892Sdrh           if( i>=0 ){
36476ab3a2ecSdanielk1977             assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
364813449892Sdrh             pItem = &pAggInfo->aFunc[i];
364913449892Sdrh             pItem->pExpr = pExpr;
36500a07c107Sdrh             pItem->iMem = ++pParse->nMem;
365133e619fcSdrh             assert( !ExprHasProperty(pExpr, EP_IntValue) );
365213449892Sdrh             pItem->pFunc = sqlite3FindFunction(pParse->db,
365333e619fcSdrh                    pExpr->u.zToken, sqlite3Strlen30(pExpr->u.zToken),
36546ab3a2ecSdanielk1977                    pExpr->x.pList ? pExpr->x.pList->nExpr : 0, enc, 0);
3655fd357974Sdrh             if( pExpr->flags & EP_Distinct ){
3656fd357974Sdrh               pItem->iDistinct = pParse->nTab++;
3657fd357974Sdrh             }else{
3658fd357974Sdrh               pItem->iDistinct = -1;
3659fd357974Sdrh             }
36602282792aSdrh           }
366113449892Sdrh         }
366213449892Sdrh         /* Make pExpr point to the appropriate pAggInfo->aFunc[] entry
366313449892Sdrh         */
366433e619fcSdrh         assert( !ExprHasAnyProperty(pExpr, EP_TokenOnly|EP_Reduced) );
366533e619fcSdrh         ExprSetIrreducible(pExpr);
3666cf697396Sshane         pExpr->iAgg = (i16)i;
366713449892Sdrh         pExpr->pAggInfo = pAggInfo;
36687d10d5a6Sdrh         return WRC_Prune;
36692282792aSdrh       }
36702282792aSdrh     }
3671a58fdfb1Sdanielk1977   }
36727d10d5a6Sdrh   return WRC_Continue;
36737d10d5a6Sdrh }
36747d10d5a6Sdrh static int analyzeAggregatesInSelect(Walker *pWalker, Select *pSelect){
36757d10d5a6Sdrh   NameContext *pNC = pWalker->u.pNC;
36767d10d5a6Sdrh   if( pNC->nDepth==0 ){
3677a58fdfb1Sdanielk1977     pNC->nDepth++;
36787d10d5a6Sdrh     sqlite3WalkSelect(pWalker, pSelect);
3679a58fdfb1Sdanielk1977     pNC->nDepth--;
36807d10d5a6Sdrh     return WRC_Prune;
36817d10d5a6Sdrh   }else{
36827d10d5a6Sdrh     return WRC_Continue;
3683a58fdfb1Sdanielk1977   }
36842282792aSdrh }
3685626a879aSdrh 
3686626a879aSdrh /*
3687626a879aSdrh ** Analyze the given expression looking for aggregate functions and
3688626a879aSdrh ** for variables that need to be added to the pParse->aAgg[] array.
3689626a879aSdrh ** Make additional entries to the pParse->aAgg[] array as necessary.
3690626a879aSdrh **
3691626a879aSdrh ** This routine should only be called after the expression has been
36927d10d5a6Sdrh ** analyzed by sqlite3ResolveExprNames().
3693626a879aSdrh */
3694d2b3e23bSdrh void sqlite3ExprAnalyzeAggregates(NameContext *pNC, Expr *pExpr){
36957d10d5a6Sdrh   Walker w;
36967d10d5a6Sdrh   w.xExprCallback = analyzeAggregate;
36977d10d5a6Sdrh   w.xSelectCallback = analyzeAggregatesInSelect;
36987d10d5a6Sdrh   w.u.pNC = pNC;
369920bc393cSdrh   assert( pNC->pSrcList!=0 );
37007d10d5a6Sdrh   sqlite3WalkExpr(&w, pExpr);
37012282792aSdrh }
37025d9a4af9Sdrh 
37035d9a4af9Sdrh /*
37045d9a4af9Sdrh ** Call sqlite3ExprAnalyzeAggregates() for every expression in an
37055d9a4af9Sdrh ** expression list.  Return the number of errors.
37065d9a4af9Sdrh **
37075d9a4af9Sdrh ** If an error is found, the analysis is cut short.
37085d9a4af9Sdrh */
3709d2b3e23bSdrh void sqlite3ExprAnalyzeAggList(NameContext *pNC, ExprList *pList){
37105d9a4af9Sdrh   struct ExprList_item *pItem;
37115d9a4af9Sdrh   int i;
37125d9a4af9Sdrh   if( pList ){
3713d2b3e23bSdrh     for(pItem=pList->a, i=0; i<pList->nExpr; i++, pItem++){
3714d2b3e23bSdrh       sqlite3ExprAnalyzeAggregates(pNC, pItem->pExpr);
37155d9a4af9Sdrh     }
37165d9a4af9Sdrh   }
37175d9a4af9Sdrh }
3718892d3179Sdrh 
3719892d3179Sdrh /*
3720ceea3321Sdrh ** Allocate a single new register for use to hold some intermediate result.
3721892d3179Sdrh */
3722892d3179Sdrh int sqlite3GetTempReg(Parse *pParse){
3723e55cbd72Sdrh   if( pParse->nTempReg==0 ){
3724892d3179Sdrh     return ++pParse->nMem;
3725892d3179Sdrh   }
37262f425f6bSdanielk1977   return pParse->aTempReg[--pParse->nTempReg];
3727892d3179Sdrh }
3728ceea3321Sdrh 
3729ceea3321Sdrh /*
3730ceea3321Sdrh ** Deallocate a register, making available for reuse for some other
3731ceea3321Sdrh ** purpose.
3732ceea3321Sdrh **
3733ceea3321Sdrh ** If a register is currently being used by the column cache, then
3734ceea3321Sdrh ** the dallocation is deferred until the column cache line that uses
3735ceea3321Sdrh ** the register becomes stale.
3736ceea3321Sdrh */
3737892d3179Sdrh void sqlite3ReleaseTempReg(Parse *pParse, int iReg){
37382dcef11bSdrh   if( iReg && pParse->nTempReg<ArraySize(pParse->aTempReg) ){
3739ceea3321Sdrh     int i;
3740ceea3321Sdrh     struct yColCache *p;
3741ceea3321Sdrh     for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
3742ceea3321Sdrh       if( p->iReg==iReg ){
3743ceea3321Sdrh         p->tempReg = 1;
3744ceea3321Sdrh         return;
3745ceea3321Sdrh       }
3746ceea3321Sdrh     }
3747892d3179Sdrh     pParse->aTempReg[pParse->nTempReg++] = iReg;
3748892d3179Sdrh   }
3749892d3179Sdrh }
3750892d3179Sdrh 
3751892d3179Sdrh /*
3752892d3179Sdrh ** Allocate or deallocate a block of nReg consecutive registers
3753892d3179Sdrh */
3754892d3179Sdrh int sqlite3GetTempRange(Parse *pParse, int nReg){
3755e55cbd72Sdrh   int i, n;
3756892d3179Sdrh   i = pParse->iRangeReg;
3757e55cbd72Sdrh   n = pParse->nRangeReg;
3758f49f3523Sdrh   if( nReg<=n ){
3759f49f3523Sdrh     assert( !usedAsColumnCache(pParse, i, i+n-1) );
3760892d3179Sdrh     pParse->iRangeReg += nReg;
3761892d3179Sdrh     pParse->nRangeReg -= nReg;
3762892d3179Sdrh   }else{
3763892d3179Sdrh     i = pParse->nMem+1;
3764892d3179Sdrh     pParse->nMem += nReg;
3765892d3179Sdrh   }
3766892d3179Sdrh   return i;
3767892d3179Sdrh }
3768892d3179Sdrh void sqlite3ReleaseTempRange(Parse *pParse, int iReg, int nReg){
3769f49f3523Sdrh   sqlite3ExprCacheRemove(pParse, iReg, nReg);
3770892d3179Sdrh   if( nReg>pParse->nRangeReg ){
3771892d3179Sdrh     pParse->nRangeReg = nReg;
3772892d3179Sdrh     pParse->iRangeReg = iReg;
3773892d3179Sdrh   }
3774892d3179Sdrh }
3775