xref: /sqlite-3.40.0/src/expr.c (revision dfd2d9f6)
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 /*
598342e49fSdrh ** Set the explicit collating sequence for an expression to the
608342e49fSdrh ** collating sequence supplied in the second argument.
618342e49fSdrh */
628342e49fSdrh Expr *sqlite3ExprSetColl(Expr *pExpr, CollSeq *pColl){
638342e49fSdrh   if( pExpr && pColl ){
648342e49fSdrh     pExpr->pColl = pColl;
658342e49fSdrh     pExpr->flags |= EP_ExpCollate;
668342e49fSdrh   }
678342e49fSdrh   return pExpr;
688342e49fSdrh }
698342e49fSdrh 
708342e49fSdrh /*
718b4c40d8Sdrh ** Set the collating sequence for expression pExpr to be the collating
728b4c40d8Sdrh ** sequence named by pToken.   Return a pointer to the revised expression.
73a34001c9Sdrh ** The collating sequence is marked as "explicit" using the EP_ExpCollate
74a34001c9Sdrh ** flag.  An explicit collating sequence will override implicit
75a34001c9Sdrh ** collating sequences.
768b4c40d8Sdrh */
778342e49fSdrh Expr *sqlite3ExprSetCollByToken(Parse *pParse, Expr *pExpr, Token *pCollName){
7839002505Sdanielk1977   char *zColl = 0;            /* Dequoted name of collation sequence */
798b4c40d8Sdrh   CollSeq *pColl;
80633e6d57Sdrh   sqlite3 *db = pParse->db;
817d10d5a6Sdrh   zColl = sqlite3NameFromToken(db, pCollName);
82c4a64facSdrh   pColl = sqlite3LocateCollSeq(pParse, zColl);
838342e49fSdrh   sqlite3ExprSetColl(pExpr, pColl);
84633e6d57Sdrh   sqlite3DbFree(db, zColl);
858b4c40d8Sdrh   return pExpr;
868b4c40d8Sdrh }
878b4c40d8Sdrh 
888b4c40d8Sdrh /*
890202b29eSdanielk1977 ** Return the default collation sequence for the expression pExpr. If
900202b29eSdanielk1977 ** there is no default collation type, return 0.
910202b29eSdanielk1977 */
927cedc8d4Sdanielk1977 CollSeq *sqlite3ExprCollSeq(Parse *pParse, Expr *pExpr){
937cedc8d4Sdanielk1977   CollSeq *pColl = 0;
947d10d5a6Sdrh   Expr *p = pExpr;
9584e30ca0Sdrh   while( p ){
967e09fe0bSdrh     int op;
977d10d5a6Sdrh     pColl = p->pColl;
987d10d5a6Sdrh     if( pColl ) break;
997d10d5a6Sdrh     op = p->op;
10076d462eeSdan     if( p->pTab!=0 && (
10176d462eeSdan         op==TK_AGG_COLUMN || op==TK_COLUMN || op==TK_REGISTER || op==TK_TRIGGER
10276d462eeSdan     )){
1037d10d5a6Sdrh       /* op==TK_REGISTER && p->pTab!=0 happens when pExpr was originally
1047d10d5a6Sdrh       ** a TK_COLUMN but was previously evaluated and cached in a register */
1057d10d5a6Sdrh       const char *zColl;
1067d10d5a6Sdrh       int j = p->iColumn;
1077d10d5a6Sdrh       if( j>=0 ){
1087d10d5a6Sdrh         sqlite3 *db = pParse->db;
1097d10d5a6Sdrh         zColl = p->pTab->aCol[j].zColl;
110c4a64facSdrh         pColl = sqlite3FindCollSeq(db, ENC(db), zColl, 0);
1117d10d5a6Sdrh         pExpr->pColl = pColl;
1120202b29eSdanielk1977       }
1137d10d5a6Sdrh       break;
1147d10d5a6Sdrh     }
1157d10d5a6Sdrh     if( op!=TK_CAST && op!=TK_UPLUS ){
1167d10d5a6Sdrh       break;
1177d10d5a6Sdrh     }
1187d10d5a6Sdrh     p = p->pLeft;
1190202b29eSdanielk1977   }
1207cedc8d4Sdanielk1977   if( sqlite3CheckCollSeq(pParse, pColl) ){
1217cedc8d4Sdanielk1977     pColl = 0;
1227cedc8d4Sdanielk1977   }
1237cedc8d4Sdanielk1977   return pColl;
1240202b29eSdanielk1977 }
1250202b29eSdanielk1977 
1260202b29eSdanielk1977 /*
127626a879aSdrh ** pExpr is an operand of a comparison operator.  aff2 is the
128626a879aSdrh ** type affinity of the other operand.  This routine returns the
12953db1458Sdrh ** type affinity that should be used for the comparison operator.
13053db1458Sdrh */
131e014a838Sdanielk1977 char sqlite3CompareAffinity(Expr *pExpr, char aff2){
132bf3b721fSdanielk1977   char aff1 = sqlite3ExprAffinity(pExpr);
133e014a838Sdanielk1977   if( aff1 && aff2 ){
1348df447f0Sdrh     /* Both sides of the comparison are columns. If one has numeric
1358df447f0Sdrh     ** affinity, use that. Otherwise use no affinity.
136e014a838Sdanielk1977     */
1378a51256cSdrh     if( sqlite3IsNumericAffinity(aff1) || sqlite3IsNumericAffinity(aff2) ){
138e014a838Sdanielk1977       return SQLITE_AFF_NUMERIC;
139e014a838Sdanielk1977     }else{
140e014a838Sdanielk1977       return SQLITE_AFF_NONE;
141e014a838Sdanielk1977     }
142e014a838Sdanielk1977   }else if( !aff1 && !aff2 ){
1435f6a87b3Sdrh     /* Neither side of the comparison is a column.  Compare the
1445f6a87b3Sdrh     ** results directly.
145e014a838Sdanielk1977     */
1465f6a87b3Sdrh     return SQLITE_AFF_NONE;
147e014a838Sdanielk1977   }else{
148e014a838Sdanielk1977     /* One side is a column, the other is not. Use the columns affinity. */
149fe05af87Sdrh     assert( aff1==0 || aff2==0 );
150e014a838Sdanielk1977     return (aff1 + aff2);
151e014a838Sdanielk1977   }
152e014a838Sdanielk1977 }
153e014a838Sdanielk1977 
15453db1458Sdrh /*
15553db1458Sdrh ** pExpr is a comparison operator.  Return the type affinity that should
15653db1458Sdrh ** be applied to both operands prior to doing the comparison.
15753db1458Sdrh */
158e014a838Sdanielk1977 static char comparisonAffinity(Expr *pExpr){
159e014a838Sdanielk1977   char aff;
160e014a838Sdanielk1977   assert( pExpr->op==TK_EQ || pExpr->op==TK_IN || pExpr->op==TK_LT ||
161e014a838Sdanielk1977           pExpr->op==TK_GT || pExpr->op==TK_GE || pExpr->op==TK_LE ||
1626a2fe093Sdrh           pExpr->op==TK_NE || pExpr->op==TK_IS || pExpr->op==TK_ISNOT );
163e014a838Sdanielk1977   assert( pExpr->pLeft );
164bf3b721fSdanielk1977   aff = sqlite3ExprAffinity(pExpr->pLeft);
165e014a838Sdanielk1977   if( pExpr->pRight ){
166e014a838Sdanielk1977     aff = sqlite3CompareAffinity(pExpr->pRight, aff);
1676ab3a2ecSdanielk1977   }else if( ExprHasProperty(pExpr, EP_xIsSelect) ){
1686ab3a2ecSdanielk1977     aff = sqlite3CompareAffinity(pExpr->x.pSelect->pEList->a[0].pExpr, aff);
1696ab3a2ecSdanielk1977   }else if( !aff ){
170de087bd5Sdrh     aff = SQLITE_AFF_NONE;
171e014a838Sdanielk1977   }
172e014a838Sdanielk1977   return aff;
173e014a838Sdanielk1977 }
174e014a838Sdanielk1977 
175e014a838Sdanielk1977 /*
176e014a838Sdanielk1977 ** pExpr is a comparison expression, eg. '=', '<', IN(...) etc.
177e014a838Sdanielk1977 ** idx_affinity is the affinity of an indexed column. Return true
178e014a838Sdanielk1977 ** if the index with affinity idx_affinity may be used to implement
179e014a838Sdanielk1977 ** the comparison in pExpr.
180e014a838Sdanielk1977 */
181e014a838Sdanielk1977 int sqlite3IndexAffinityOk(Expr *pExpr, char idx_affinity){
182e014a838Sdanielk1977   char aff = comparisonAffinity(pExpr);
1838a51256cSdrh   switch( aff ){
1848a51256cSdrh     case SQLITE_AFF_NONE:
1858a51256cSdrh       return 1;
1868a51256cSdrh     case SQLITE_AFF_TEXT:
1878a51256cSdrh       return idx_affinity==SQLITE_AFF_TEXT;
1888a51256cSdrh     default:
1898a51256cSdrh       return sqlite3IsNumericAffinity(idx_affinity);
1908a51256cSdrh   }
191e014a838Sdanielk1977 }
192e014a838Sdanielk1977 
193a37cdde0Sdanielk1977 /*
19435573356Sdrh ** Return the P5 value that should be used for a binary comparison
195a37cdde0Sdanielk1977 ** opcode (OP_Eq, OP_Ge etc.) used to compare pExpr1 and pExpr2.
196a37cdde0Sdanielk1977 */
19735573356Sdrh static u8 binaryCompareP5(Expr *pExpr1, Expr *pExpr2, int jumpIfNull){
19835573356Sdrh   u8 aff = (char)sqlite3ExprAffinity(pExpr2);
1991bd10f8aSdrh   aff = (u8)sqlite3CompareAffinity(pExpr1, aff) | (u8)jumpIfNull;
20035573356Sdrh   return aff;
201a37cdde0Sdanielk1977 }
202a37cdde0Sdanielk1977 
203a2e00042Sdrh /*
2040202b29eSdanielk1977 ** Return a pointer to the collation sequence that should be used by
2050202b29eSdanielk1977 ** a binary comparison operator comparing pLeft and pRight.
2060202b29eSdanielk1977 **
2070202b29eSdanielk1977 ** If the left hand expression has a collating sequence type, then it is
2080202b29eSdanielk1977 ** used. Otherwise the collation sequence for the right hand expression
2090202b29eSdanielk1977 ** is used, or the default (BINARY) if neither expression has a collating
2100202b29eSdanielk1977 ** type.
211bcbb04e5Sdanielk1977 **
212bcbb04e5Sdanielk1977 ** Argument pRight (but not pLeft) may be a null pointer. In this case,
213bcbb04e5Sdanielk1977 ** it is not considered.
2140202b29eSdanielk1977 */
215bcbb04e5Sdanielk1977 CollSeq *sqlite3BinaryCompareCollSeq(
216bcbb04e5Sdanielk1977   Parse *pParse,
217bcbb04e5Sdanielk1977   Expr *pLeft,
218bcbb04e5Sdanielk1977   Expr *pRight
219bcbb04e5Sdanielk1977 ){
220ec41ddacSdrh   CollSeq *pColl;
221ec41ddacSdrh   assert( pLeft );
222ec41ddacSdrh   if( pLeft->flags & EP_ExpCollate ){
223ec41ddacSdrh     assert( pLeft->pColl );
224ec41ddacSdrh     pColl = pLeft->pColl;
225bcbb04e5Sdanielk1977   }else if( pRight && pRight->flags & EP_ExpCollate ){
226ec41ddacSdrh     assert( pRight->pColl );
227ec41ddacSdrh     pColl = pRight->pColl;
228ec41ddacSdrh   }else{
229ec41ddacSdrh     pColl = sqlite3ExprCollSeq(pParse, pLeft);
2300202b29eSdanielk1977     if( !pColl ){
2317cedc8d4Sdanielk1977       pColl = sqlite3ExprCollSeq(pParse, pRight);
2320202b29eSdanielk1977     }
233ec41ddacSdrh   }
2340202b29eSdanielk1977   return pColl;
2350202b29eSdanielk1977 }
2360202b29eSdanielk1977 
2370202b29eSdanielk1977 /*
238be5c89acSdrh ** Generate code for a comparison operator.
239be5c89acSdrh */
240be5c89acSdrh static int codeCompare(
241be5c89acSdrh   Parse *pParse,    /* The parsing (and code generating) context */
242be5c89acSdrh   Expr *pLeft,      /* The left operand */
243be5c89acSdrh   Expr *pRight,     /* The right operand */
244be5c89acSdrh   int opcode,       /* The comparison opcode */
24535573356Sdrh   int in1, int in2, /* Register holding operands */
246be5c89acSdrh   int dest,         /* Jump here if true.  */
247be5c89acSdrh   int jumpIfNull    /* If true, jump if either operand is NULL */
248be5c89acSdrh ){
24935573356Sdrh   int p5;
25035573356Sdrh   int addr;
25135573356Sdrh   CollSeq *p4;
25235573356Sdrh 
25335573356Sdrh   p4 = sqlite3BinaryCompareCollSeq(pParse, pLeft, pRight);
25435573356Sdrh   p5 = binaryCompareP5(pLeft, pRight, jumpIfNull);
25535573356Sdrh   addr = sqlite3VdbeAddOp4(pParse->pVdbe, opcode, in2, dest, in1,
25635573356Sdrh                            (void*)p4, P4_COLLSEQ);
2571bd10f8aSdrh   sqlite3VdbeChangeP5(pParse->pVdbe, (u8)p5);
25835573356Sdrh   return addr;
259be5c89acSdrh }
260be5c89acSdrh 
2614b5255acSdanielk1977 #if SQLITE_MAX_EXPR_DEPTH>0
2624b5255acSdanielk1977 /*
2634b5255acSdanielk1977 ** Check that argument nHeight is less than or equal to the maximum
2644b5255acSdanielk1977 ** expression depth allowed. If it is not, leave an error message in
2654b5255acSdanielk1977 ** pParse.
2664b5255acSdanielk1977 */
2677d10d5a6Sdrh int sqlite3ExprCheckHeight(Parse *pParse, int nHeight){
2684b5255acSdanielk1977   int rc = SQLITE_OK;
2694b5255acSdanielk1977   int mxHeight = pParse->db->aLimit[SQLITE_LIMIT_EXPR_DEPTH];
2704b5255acSdanielk1977   if( nHeight>mxHeight ){
2714b5255acSdanielk1977     sqlite3ErrorMsg(pParse,
2724b5255acSdanielk1977        "Expression tree is too large (maximum depth %d)", mxHeight
2734b5255acSdanielk1977     );
2744b5255acSdanielk1977     rc = SQLITE_ERROR;
2754b5255acSdanielk1977   }
2764b5255acSdanielk1977   return rc;
2774b5255acSdanielk1977 }
2784b5255acSdanielk1977 
2794b5255acSdanielk1977 /* The following three functions, heightOfExpr(), heightOfExprList()
2804b5255acSdanielk1977 ** and heightOfSelect(), are used to determine the maximum height
2814b5255acSdanielk1977 ** of any expression tree referenced by the structure passed as the
2824b5255acSdanielk1977 ** first argument.
2834b5255acSdanielk1977 **
2844b5255acSdanielk1977 ** If this maximum height is greater than the current value pointed
2854b5255acSdanielk1977 ** to by pnHeight, the second parameter, then set *pnHeight to that
2864b5255acSdanielk1977 ** value.
2874b5255acSdanielk1977 */
2884b5255acSdanielk1977 static void heightOfExpr(Expr *p, int *pnHeight){
2894b5255acSdanielk1977   if( p ){
2904b5255acSdanielk1977     if( p->nHeight>*pnHeight ){
2914b5255acSdanielk1977       *pnHeight = p->nHeight;
2924b5255acSdanielk1977     }
2934b5255acSdanielk1977   }
2944b5255acSdanielk1977 }
2954b5255acSdanielk1977 static void heightOfExprList(ExprList *p, int *pnHeight){
2964b5255acSdanielk1977   if( p ){
2974b5255acSdanielk1977     int i;
2984b5255acSdanielk1977     for(i=0; i<p->nExpr; i++){
2994b5255acSdanielk1977       heightOfExpr(p->a[i].pExpr, pnHeight);
3004b5255acSdanielk1977     }
3014b5255acSdanielk1977   }
3024b5255acSdanielk1977 }
3034b5255acSdanielk1977 static void heightOfSelect(Select *p, int *pnHeight){
3044b5255acSdanielk1977   if( p ){
3054b5255acSdanielk1977     heightOfExpr(p->pWhere, pnHeight);
3064b5255acSdanielk1977     heightOfExpr(p->pHaving, pnHeight);
3074b5255acSdanielk1977     heightOfExpr(p->pLimit, pnHeight);
3084b5255acSdanielk1977     heightOfExpr(p->pOffset, pnHeight);
3094b5255acSdanielk1977     heightOfExprList(p->pEList, pnHeight);
3104b5255acSdanielk1977     heightOfExprList(p->pGroupBy, pnHeight);
3114b5255acSdanielk1977     heightOfExprList(p->pOrderBy, pnHeight);
3124b5255acSdanielk1977     heightOfSelect(p->pPrior, pnHeight);
3134b5255acSdanielk1977   }
3144b5255acSdanielk1977 }
3154b5255acSdanielk1977 
3164b5255acSdanielk1977 /*
3174b5255acSdanielk1977 ** Set the Expr.nHeight variable in the structure passed as an
3184b5255acSdanielk1977 ** argument. An expression with no children, Expr.pList or
3194b5255acSdanielk1977 ** Expr.pSelect member has a height of 1. Any other expression
3204b5255acSdanielk1977 ** has a height equal to the maximum height of any other
3214b5255acSdanielk1977 ** referenced Expr plus one.
3224b5255acSdanielk1977 */
3234b5255acSdanielk1977 static void exprSetHeight(Expr *p){
3244b5255acSdanielk1977   int nHeight = 0;
3254b5255acSdanielk1977   heightOfExpr(p->pLeft, &nHeight);
3264b5255acSdanielk1977   heightOfExpr(p->pRight, &nHeight);
3276ab3a2ecSdanielk1977   if( ExprHasProperty(p, EP_xIsSelect) ){
3286ab3a2ecSdanielk1977     heightOfSelect(p->x.pSelect, &nHeight);
3296ab3a2ecSdanielk1977   }else{
3306ab3a2ecSdanielk1977     heightOfExprList(p->x.pList, &nHeight);
3316ab3a2ecSdanielk1977   }
3324b5255acSdanielk1977   p->nHeight = nHeight + 1;
3334b5255acSdanielk1977 }
3344b5255acSdanielk1977 
3354b5255acSdanielk1977 /*
3364b5255acSdanielk1977 ** Set the Expr.nHeight variable using the exprSetHeight() function. If
3374b5255acSdanielk1977 ** the height is greater than the maximum allowed expression depth,
3384b5255acSdanielk1977 ** leave an error in pParse.
3394b5255acSdanielk1977 */
3404b5255acSdanielk1977 void sqlite3ExprSetHeight(Parse *pParse, Expr *p){
3414b5255acSdanielk1977   exprSetHeight(p);
3427d10d5a6Sdrh   sqlite3ExprCheckHeight(pParse, p->nHeight);
3434b5255acSdanielk1977 }
3444b5255acSdanielk1977 
3454b5255acSdanielk1977 /*
3464b5255acSdanielk1977 ** Return the maximum height of any expression tree referenced
3474b5255acSdanielk1977 ** by the select statement passed as an argument.
3484b5255acSdanielk1977 */
3494b5255acSdanielk1977 int sqlite3SelectExprHeight(Select *p){
3504b5255acSdanielk1977   int nHeight = 0;
3514b5255acSdanielk1977   heightOfSelect(p, &nHeight);
3524b5255acSdanielk1977   return nHeight;
3534b5255acSdanielk1977 }
3544b5255acSdanielk1977 #else
3554b5255acSdanielk1977   #define exprSetHeight(y)
3564b5255acSdanielk1977 #endif /* SQLITE_MAX_EXPR_DEPTH>0 */
3574b5255acSdanielk1977 
358be5c89acSdrh /*
359b7916a78Sdrh ** This routine is the core allocator for Expr nodes.
360b7916a78Sdrh **
361a76b5dfcSdrh ** Construct a new expression node and return a pointer to it.  Memory
362b7916a78Sdrh ** for this node and for the pToken argument is a single allocation
363b7916a78Sdrh ** obtained from sqlite3DbMalloc().  The calling function
364a76b5dfcSdrh ** is responsible for making sure the node eventually gets freed.
365b7916a78Sdrh **
366b7916a78Sdrh ** If dequote is true, then the token (if it exists) is dequoted.
367b7916a78Sdrh ** If dequote is false, no dequoting is performance.  The deQuote
368b7916a78Sdrh ** parameter is ignored if pToken is NULL or if the token does not
369b7916a78Sdrh ** appear to be quoted.  If the quotes were of the form "..." (double-quotes)
370b7916a78Sdrh ** then the EP_DblQuoted flag is set on the expression node.
37133e619fcSdrh **
37233e619fcSdrh ** Special case:  If op==TK_INTEGER and pToken points to a string that
37333e619fcSdrh ** can be translated into a 32-bit integer, then the token is not
37433e619fcSdrh ** stored in u.zToken.  Instead, the integer values is written
37533e619fcSdrh ** into u.iValue and the EP_IntValue flag is set.  No extra storage
37633e619fcSdrh ** is allocated to hold the integer text and the dequote flag is ignored.
377a76b5dfcSdrh */
378b7916a78Sdrh Expr *sqlite3ExprAlloc(
379a1644fd8Sdanielk1977   sqlite3 *db,            /* Handle for sqlite3DbMallocZero() (may be null) */
38017435752Sdrh   int op,                 /* Expression opcode */
381b7916a78Sdrh   const Token *pToken,    /* Token argument.  Might be NULL */
382b7916a78Sdrh   int dequote             /* True to dequote */
38317435752Sdrh ){
384a76b5dfcSdrh   Expr *pNew;
38533e619fcSdrh   int nExtra = 0;
386cf697396Sshane   int iValue = 0;
387b7916a78Sdrh 
388b7916a78Sdrh   if( pToken ){
38933e619fcSdrh     if( op!=TK_INTEGER || pToken->z==0
39033e619fcSdrh           || sqlite3GetInt32(pToken->z, &iValue)==0 ){
391b7916a78Sdrh       nExtra = pToken->n+1;
392d50ffc41Sdrh       assert( iValue>=0 );
39333e619fcSdrh     }
394a76b5dfcSdrh   }
395b7916a78Sdrh   pNew = sqlite3DbMallocZero(db, sizeof(Expr)+nExtra);
396b7916a78Sdrh   if( pNew ){
3971bd10f8aSdrh     pNew->op = (u8)op;
398a58fdfb1Sdanielk1977     pNew->iAgg = -1;
399a76b5dfcSdrh     if( pToken ){
40033e619fcSdrh       if( nExtra==0 ){
40133e619fcSdrh         pNew->flags |= EP_IntValue;
40233e619fcSdrh         pNew->u.iValue = iValue;
40333e619fcSdrh       }else{
404d9da78a2Sdrh         int c;
40533e619fcSdrh         pNew->u.zToken = (char*)&pNew[1];
40633e619fcSdrh         memcpy(pNew->u.zToken, pToken->z, pToken->n);
40733e619fcSdrh         pNew->u.zToken[pToken->n] = 0;
408b7916a78Sdrh         if( dequote && nExtra>=3
409d9da78a2Sdrh              && ((c = pToken->z[0])=='\'' || c=='"' || c=='[' || c=='`') ){
41033e619fcSdrh           sqlite3Dequote(pNew->u.zToken);
41124fb627aSdrh           if( c=='"' ) pNew->flags |= EP_DblQuoted;
412a34001c9Sdrh         }
413a34001c9Sdrh       }
41433e619fcSdrh     }
415b7916a78Sdrh #if SQLITE_MAX_EXPR_DEPTH>0
416b7916a78Sdrh     pNew->nHeight = 1;
417b7916a78Sdrh #endif
418a34001c9Sdrh   }
419a76b5dfcSdrh   return pNew;
420a76b5dfcSdrh }
421a76b5dfcSdrh 
422a76b5dfcSdrh /*
423b7916a78Sdrh ** Allocate a new expression node from a zero-terminated token that has
424b7916a78Sdrh ** already been dequoted.
425b7916a78Sdrh */
426b7916a78Sdrh Expr *sqlite3Expr(
427b7916a78Sdrh   sqlite3 *db,            /* Handle for sqlite3DbMallocZero() (may be null) */
428b7916a78Sdrh   int op,                 /* Expression opcode */
429b7916a78Sdrh   const char *zToken      /* Token argument.  Might be NULL */
430b7916a78Sdrh ){
431b7916a78Sdrh   Token x;
432b7916a78Sdrh   x.z = zToken;
433b7916a78Sdrh   x.n = zToken ? sqlite3Strlen30(zToken) : 0;
434b7916a78Sdrh   return sqlite3ExprAlloc(db, op, &x, 0);
435b7916a78Sdrh }
436b7916a78Sdrh 
437b7916a78Sdrh /*
438b7916a78Sdrh ** Attach subtrees pLeft and pRight to the Expr node pRoot.
439b7916a78Sdrh **
440b7916a78Sdrh ** If pRoot==NULL that means that a memory allocation error has occurred.
441b7916a78Sdrh ** In that case, delete the subtrees pLeft and pRight.
442b7916a78Sdrh */
443b7916a78Sdrh void sqlite3ExprAttachSubtrees(
444b7916a78Sdrh   sqlite3 *db,
445b7916a78Sdrh   Expr *pRoot,
446b7916a78Sdrh   Expr *pLeft,
447b7916a78Sdrh   Expr *pRight
448b7916a78Sdrh ){
449b7916a78Sdrh   if( pRoot==0 ){
450b7916a78Sdrh     assert( db->mallocFailed );
451b7916a78Sdrh     sqlite3ExprDelete(db, pLeft);
452b7916a78Sdrh     sqlite3ExprDelete(db, pRight);
453b7916a78Sdrh   }else{
454b7916a78Sdrh     if( pRight ){
455b7916a78Sdrh       pRoot->pRight = pRight;
456b7916a78Sdrh       if( pRight->flags & EP_ExpCollate ){
457b7916a78Sdrh         pRoot->flags |= EP_ExpCollate;
458b7916a78Sdrh         pRoot->pColl = pRight->pColl;
459b7916a78Sdrh       }
460b7916a78Sdrh     }
461b7916a78Sdrh     if( pLeft ){
462b7916a78Sdrh       pRoot->pLeft = pLeft;
463b7916a78Sdrh       if( pLeft->flags & EP_ExpCollate ){
464b7916a78Sdrh         pRoot->flags |= EP_ExpCollate;
465b7916a78Sdrh         pRoot->pColl = pLeft->pColl;
466b7916a78Sdrh       }
467b7916a78Sdrh     }
468b7916a78Sdrh     exprSetHeight(pRoot);
469b7916a78Sdrh   }
470b7916a78Sdrh }
471b7916a78Sdrh 
472b7916a78Sdrh /*
473bf664469Sdrh ** Allocate a Expr node which joins as many as two subtrees.
474b7916a78Sdrh **
475bf664469Sdrh ** One or both of the subtrees can be NULL.  Return a pointer to the new
476bf664469Sdrh ** Expr node.  Or, if an OOM error occurs, set pParse->db->mallocFailed,
477bf664469Sdrh ** free the subtrees and return NULL.
478206f3d96Sdrh */
47917435752Sdrh Expr *sqlite3PExpr(
48017435752Sdrh   Parse *pParse,          /* Parsing context */
48117435752Sdrh   int op,                 /* Expression opcode */
48217435752Sdrh   Expr *pLeft,            /* Left operand */
48317435752Sdrh   Expr *pRight,           /* Right operand */
48417435752Sdrh   const Token *pToken     /* Argument token */
48517435752Sdrh ){
486b7916a78Sdrh   Expr *p = sqlite3ExprAlloc(pParse->db, op, pToken, 1);
487b7916a78Sdrh   sqlite3ExprAttachSubtrees(pParse->db, p, pLeft, pRight);
4882b359bdbSdan   if( p ) {
4892b359bdbSdan     sqlite3ExprCheckHeight(pParse, p->nHeight);
4902b359bdbSdan   }
4914e0cff60Sdrh   return p;
4924e0cff60Sdrh }
4934e0cff60Sdrh 
4944e0cff60Sdrh /*
49591bb0eedSdrh ** Join two expressions using an AND operator.  If either expression is
49691bb0eedSdrh ** NULL, then just return the other expression.
49791bb0eedSdrh */
4981e536953Sdanielk1977 Expr *sqlite3ExprAnd(sqlite3 *db, Expr *pLeft, Expr *pRight){
49991bb0eedSdrh   if( pLeft==0 ){
50091bb0eedSdrh     return pRight;
50191bb0eedSdrh   }else if( pRight==0 ){
50291bb0eedSdrh     return pLeft;
50391bb0eedSdrh   }else{
504b7916a78Sdrh     Expr *pNew = sqlite3ExprAlloc(db, TK_AND, 0, 0);
505b7916a78Sdrh     sqlite3ExprAttachSubtrees(db, pNew, pLeft, pRight);
506b7916a78Sdrh     return pNew;
507a76b5dfcSdrh   }
508a76b5dfcSdrh }
509a76b5dfcSdrh 
510a76b5dfcSdrh /*
511a76b5dfcSdrh ** Construct a new expression node for a function with multiple
512a76b5dfcSdrh ** arguments.
513a76b5dfcSdrh */
51417435752Sdrh Expr *sqlite3ExprFunction(Parse *pParse, ExprList *pList, Token *pToken){
515a76b5dfcSdrh   Expr *pNew;
516633e6d57Sdrh   sqlite3 *db = pParse->db;
5174b202ae2Sdanielk1977   assert( pToken );
518b7916a78Sdrh   pNew = sqlite3ExprAlloc(db, TK_FUNCTION, pToken, 1);
519a76b5dfcSdrh   if( pNew==0 ){
520d9da78a2Sdrh     sqlite3ExprListDelete(db, pList); /* Avoid memory leak when malloc fails */
521a76b5dfcSdrh     return 0;
522a76b5dfcSdrh   }
5236ab3a2ecSdanielk1977   pNew->x.pList = pList;
5246ab3a2ecSdanielk1977   assert( !ExprHasProperty(pNew, EP_xIsSelect) );
5254b5255acSdanielk1977   sqlite3ExprSetHeight(pParse, pNew);
526a76b5dfcSdrh   return pNew;
527a76b5dfcSdrh }
528a76b5dfcSdrh 
529a76b5dfcSdrh /*
530fa6bc000Sdrh ** Assign a variable number to an expression that encodes a wildcard
531fa6bc000Sdrh ** in the original SQL statement.
532fa6bc000Sdrh **
533fa6bc000Sdrh ** Wildcards consisting of a single "?" are assigned the next sequential
534fa6bc000Sdrh ** variable number.
535fa6bc000Sdrh **
536fa6bc000Sdrh ** Wildcards of the form "?nnn" are assigned the number "nnn".  We make
537fa6bc000Sdrh ** sure "nnn" is not too be to avoid a denial of service attack when
538fa6bc000Sdrh ** the SQL statement comes from an external source.
539fa6bc000Sdrh **
54051f49f17Sdrh ** Wildcards of the form ":aaa", "@aaa", or "$aaa" are assigned the same number
541fa6bc000Sdrh ** as the previous instance of the same wildcard.  Or if this is the first
542fa6bc000Sdrh ** instance of the wildcard, the next sequenial variable number is
543fa6bc000Sdrh ** assigned.
544fa6bc000Sdrh */
545fa6bc000Sdrh void sqlite3ExprAssignVarNumber(Parse *pParse, Expr *pExpr){
54617435752Sdrh   sqlite3 *db = pParse->db;
547b7916a78Sdrh   const char *z;
54817435752Sdrh 
549fa6bc000Sdrh   if( pExpr==0 ) return;
55033e619fcSdrh   assert( !ExprHasAnyProperty(pExpr, EP_IntValue|EP_Reduced|EP_TokenOnly) );
55133e619fcSdrh   z = pExpr->u.zToken;
552b7916a78Sdrh   assert( z!=0 );
553b7916a78Sdrh   assert( z[0]!=0 );
554b7916a78Sdrh   if( z[1]==0 ){
555fa6bc000Sdrh     /* Wildcard of the form "?".  Assign the next variable number */
556b7916a78Sdrh     assert( z[0]=='?' );
5578677d308Sdrh     pExpr->iColumn = (ynVar)(++pParse->nVar);
558124c0b49Sdrh   }else{
559124c0b49Sdrh     ynVar x = 0;
560124c0b49Sdrh     u32 n = sqlite3Strlen30(z);
561124c0b49Sdrh     if( z[0]=='?' ){
562fa6bc000Sdrh       /* Wildcard of the form "?nnn".  Convert "nnn" to an integer and
563fa6bc000Sdrh       ** use it as the variable number */
564c8d735aeSdan       i64 i;
565124c0b49Sdrh       int bOk = 0==sqlite3Atoi64(&z[1], &i, n-1, SQLITE_UTF8);
566124c0b49Sdrh       pExpr->iColumn = x = (ynVar)i;
567c5499befSdrh       testcase( i==0 );
568c5499befSdrh       testcase( i==1 );
569c5499befSdrh       testcase( i==db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER]-1 );
570c5499befSdrh       testcase( i==db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER] );
571c8d735aeSdan       if( bOk==0 || i<1 || i>db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER] ){
572fa6bc000Sdrh         sqlite3ErrorMsg(pParse, "variable number must be between ?1 and ?%d",
573bb4957f8Sdrh             db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER]);
574124c0b49Sdrh         x = 0;
575fa6bc000Sdrh       }
576fa6bc000Sdrh       if( i>pParse->nVar ){
5771df2db7fSshaneh         pParse->nVar = (int)i;
578fa6bc000Sdrh       }
579fa6bc000Sdrh     }else{
58051f49f17Sdrh       /* Wildcards like ":aaa", "$aaa" or "@aaa".  Reuse the same variable
581fa6bc000Sdrh       ** number as the prior appearance of the same name, or if the name
582fa6bc000Sdrh       ** has never appeared before, reuse the same variable number
583fa6bc000Sdrh       */
584124c0b49Sdrh       ynVar i;
585124c0b49Sdrh       for(i=0; i<pParse->nzVar; i++){
586124c0b49Sdrh         if( pParse->azVar[i] && memcmp(pParse->azVar[i],z,n+1)==0 ){
587124c0b49Sdrh           pExpr->iColumn = x = (ynVar)i+1;
588fa6bc000Sdrh           break;
589fa6bc000Sdrh         }
590fa6bc000Sdrh       }
591124c0b49Sdrh       if( x==0 ) x = pExpr->iColumn = (ynVar)(++pParse->nVar);
592fa6bc000Sdrh     }
593124c0b49Sdrh     if( x>0 ){
594124c0b49Sdrh       if( x>pParse->nzVar ){
595124c0b49Sdrh         char **a;
596124c0b49Sdrh         a = sqlite3DbRealloc(db, pParse->azVar, x*sizeof(a[0]));
597124c0b49Sdrh         if( a==0 ) return;  /* Error reported through db->mallocFailed */
598124c0b49Sdrh         pParse->azVar = a;
599124c0b49Sdrh         memset(&a[pParse->nzVar], 0, (x-pParse->nzVar)*sizeof(a[0]));
600124c0b49Sdrh         pParse->nzVar = x;
601124c0b49Sdrh       }
602124c0b49Sdrh       if( z[0]!='?' || pParse->azVar[x-1]==0 ){
603124c0b49Sdrh         sqlite3DbFree(db, pParse->azVar[x-1]);
604124c0b49Sdrh         pParse->azVar[x-1] = sqlite3DbStrNDup(db, z, n);
605fa6bc000Sdrh       }
606fa6bc000Sdrh     }
607fa6bc000Sdrh   }
608bb4957f8Sdrh   if( !pParse->nErr && pParse->nVar>db->aLimit[SQLITE_LIMIT_VARIABLE_NUMBER] ){
609832b2664Sdanielk1977     sqlite3ErrorMsg(pParse, "too many SQL variables");
610832b2664Sdanielk1977   }
611fa6bc000Sdrh }
612fa6bc000Sdrh 
613fa6bc000Sdrh /*
614f6963f99Sdan ** Recursively delete an expression tree.
615a2e00042Sdrh */
616f6963f99Sdan void sqlite3ExprDelete(sqlite3 *db, Expr *p){
617f6963f99Sdan   if( p==0 ) return;
618d50ffc41Sdrh   /* Sanity check: Assert that the IntValue is non-negative if it exists */
619d50ffc41Sdrh   assert( !ExprHasProperty(p, EP_IntValue) || p->u.iValue>=0 );
620b7916a78Sdrh   if( !ExprHasAnyProperty(p, EP_TokenOnly) ){
621633e6d57Sdrh     sqlite3ExprDelete(db, p->pLeft);
622633e6d57Sdrh     sqlite3ExprDelete(db, p->pRight);
62333e619fcSdrh     if( !ExprHasProperty(p, EP_Reduced) && (p->flags2 & EP2_MallocedToken)!=0 ){
62433e619fcSdrh       sqlite3DbFree(db, p->u.zToken);
6256ab3a2ecSdanielk1977     }
6266ab3a2ecSdanielk1977     if( ExprHasProperty(p, EP_xIsSelect) ){
6276ab3a2ecSdanielk1977       sqlite3SelectDelete(db, p->x.pSelect);
6286ab3a2ecSdanielk1977     }else{
6296ab3a2ecSdanielk1977       sqlite3ExprListDelete(db, p->x.pList);
6306ab3a2ecSdanielk1977     }
6316ab3a2ecSdanielk1977   }
63233e619fcSdrh   if( !ExprHasProperty(p, EP_Static) ){
633633e6d57Sdrh     sqlite3DbFree(db, p);
634a2e00042Sdrh   }
63533e619fcSdrh }
636a2e00042Sdrh 
637d2687b77Sdrh /*
6386ab3a2ecSdanielk1977 ** Return the number of bytes allocated for the expression structure
6396ab3a2ecSdanielk1977 ** passed as the first argument. This is always one of EXPR_FULLSIZE,
6406ab3a2ecSdanielk1977 ** EXPR_REDUCEDSIZE or EXPR_TOKENONLYSIZE.
6416ab3a2ecSdanielk1977 */
6426ab3a2ecSdanielk1977 static int exprStructSize(Expr *p){
6436ab3a2ecSdanielk1977   if( ExprHasProperty(p, EP_TokenOnly) ) return EXPR_TOKENONLYSIZE;
6446ab3a2ecSdanielk1977   if( ExprHasProperty(p, EP_Reduced) ) return EXPR_REDUCEDSIZE;
6456ab3a2ecSdanielk1977   return EXPR_FULLSIZE;
6466ab3a2ecSdanielk1977 }
6476ab3a2ecSdanielk1977 
6486ab3a2ecSdanielk1977 /*
64933e619fcSdrh ** The dupedExpr*Size() routines each return the number of bytes required
65033e619fcSdrh ** to store a copy of an expression or expression tree.  They differ in
65133e619fcSdrh ** how much of the tree is measured.
65233e619fcSdrh **
65333e619fcSdrh **     dupedExprStructSize()     Size of only the Expr structure
65433e619fcSdrh **     dupedExprNodeSize()       Size of Expr + space for token
65533e619fcSdrh **     dupedExprSize()           Expr + token + subtree components
65633e619fcSdrh **
65733e619fcSdrh ***************************************************************************
65833e619fcSdrh **
65933e619fcSdrh ** The dupedExprStructSize() function returns two values OR-ed together:
66033e619fcSdrh ** (1) the space required for a copy of the Expr structure only and
66133e619fcSdrh ** (2) the EP_xxx flags that indicate what the structure size should be.
66233e619fcSdrh ** The return values is always one of:
66333e619fcSdrh **
66433e619fcSdrh **      EXPR_FULLSIZE
66533e619fcSdrh **      EXPR_REDUCEDSIZE   | EP_Reduced
66633e619fcSdrh **      EXPR_TOKENONLYSIZE | EP_TokenOnly
66733e619fcSdrh **
66833e619fcSdrh ** The size of the structure can be found by masking the return value
66933e619fcSdrh ** of this routine with 0xfff.  The flags can be found by masking the
67033e619fcSdrh ** return value with EP_Reduced|EP_TokenOnly.
67133e619fcSdrh **
67233e619fcSdrh ** Note that with flags==EXPRDUP_REDUCE, this routines works on full-size
67333e619fcSdrh ** (unreduced) Expr objects as they or originally constructed by the parser.
67433e619fcSdrh ** During expression analysis, extra information is computed and moved into
67533e619fcSdrh ** later parts of teh Expr object and that extra information might get chopped
67633e619fcSdrh ** off if the expression is reduced.  Note also that it does not work to
67733e619fcSdrh ** make a EXPRDUP_REDUCE copy of a reduced expression.  It is only legal
67833e619fcSdrh ** to reduce a pristine expression tree from the parser.  The implementation
67933e619fcSdrh ** of dupedExprStructSize() contain multiple assert() statements that attempt
68033e619fcSdrh ** to enforce this constraint.
6816ab3a2ecSdanielk1977 */
6826ab3a2ecSdanielk1977 static int dupedExprStructSize(Expr *p, int flags){
6836ab3a2ecSdanielk1977   int nSize;
68433e619fcSdrh   assert( flags==EXPRDUP_REDUCE || flags==0 ); /* Only one flag value allowed */
6856ab3a2ecSdanielk1977   if( 0==(flags&EXPRDUP_REDUCE) ){
6866ab3a2ecSdanielk1977     nSize = EXPR_FULLSIZE;
6876ab3a2ecSdanielk1977   }else{
68833e619fcSdrh     assert( !ExprHasAnyProperty(p, EP_TokenOnly|EP_Reduced) );
68933e619fcSdrh     assert( !ExprHasProperty(p, EP_FromJoin) );
69033e619fcSdrh     assert( (p->flags2 & EP2_MallocedToken)==0 );
69133e619fcSdrh     assert( (p->flags2 & EP2_Irreducible)==0 );
69233e619fcSdrh     if( p->pLeft || p->pRight || p->pColl || p->x.pList ){
69333e619fcSdrh       nSize = EXPR_REDUCEDSIZE | EP_Reduced;
69433e619fcSdrh     }else{
69533e619fcSdrh       nSize = EXPR_TOKENONLYSIZE | EP_TokenOnly;
69633e619fcSdrh     }
6976ab3a2ecSdanielk1977   }
6986ab3a2ecSdanielk1977   return nSize;
6996ab3a2ecSdanielk1977 }
7006ab3a2ecSdanielk1977 
7016ab3a2ecSdanielk1977 /*
70233e619fcSdrh ** This function returns the space in bytes required to store the copy
70333e619fcSdrh ** of the Expr structure and a copy of the Expr.u.zToken string (if that
70433e619fcSdrh ** string is defined.)
7056ab3a2ecSdanielk1977 */
7066ab3a2ecSdanielk1977 static int dupedExprNodeSize(Expr *p, int flags){
70733e619fcSdrh   int nByte = dupedExprStructSize(p, flags) & 0xfff;
70833e619fcSdrh   if( !ExprHasProperty(p, EP_IntValue) && p->u.zToken ){
70933e619fcSdrh     nByte += sqlite3Strlen30(p->u.zToken)+1;
7106ab3a2ecSdanielk1977   }
711bc73971dSdanielk1977   return ROUND8(nByte);
7126ab3a2ecSdanielk1977 }
7136ab3a2ecSdanielk1977 
7146ab3a2ecSdanielk1977 /*
7156ab3a2ecSdanielk1977 ** Return the number of bytes required to create a duplicate of the
7166ab3a2ecSdanielk1977 ** expression passed as the first argument. The second argument is a
7176ab3a2ecSdanielk1977 ** mask containing EXPRDUP_XXX flags.
7186ab3a2ecSdanielk1977 **
7196ab3a2ecSdanielk1977 ** The value returned includes space to create a copy of the Expr struct
72033e619fcSdrh ** itself and the buffer referred to by Expr.u.zToken, if any.
7216ab3a2ecSdanielk1977 **
7226ab3a2ecSdanielk1977 ** If the EXPRDUP_REDUCE flag is set, then the return value includes
7236ab3a2ecSdanielk1977 ** space to duplicate all Expr nodes in the tree formed by Expr.pLeft
7246ab3a2ecSdanielk1977 ** and Expr.pRight variables (but not for any structures pointed to or
7256ab3a2ecSdanielk1977 ** descended from the Expr.x.pList or Expr.x.pSelect variables).
7266ab3a2ecSdanielk1977 */
7276ab3a2ecSdanielk1977 static int dupedExprSize(Expr *p, int flags){
7286ab3a2ecSdanielk1977   int nByte = 0;
7296ab3a2ecSdanielk1977   if( p ){
7306ab3a2ecSdanielk1977     nByte = dupedExprNodeSize(p, flags);
7316ab3a2ecSdanielk1977     if( flags&EXPRDUP_REDUCE ){
732b7916a78Sdrh       nByte += dupedExprSize(p->pLeft, flags) + dupedExprSize(p->pRight, flags);
7336ab3a2ecSdanielk1977     }
7346ab3a2ecSdanielk1977   }
7356ab3a2ecSdanielk1977   return nByte;
7366ab3a2ecSdanielk1977 }
7376ab3a2ecSdanielk1977 
7386ab3a2ecSdanielk1977 /*
7396ab3a2ecSdanielk1977 ** This function is similar to sqlite3ExprDup(), except that if pzBuffer
7406ab3a2ecSdanielk1977 ** is not NULL then *pzBuffer is assumed to point to a buffer large enough
74133e619fcSdrh ** to store the copy of expression p, the copies of p->u.zToken
7426ab3a2ecSdanielk1977 ** (if applicable), and the copies of the p->pLeft and p->pRight expressions,
7436ab3a2ecSdanielk1977 ** if any. Before returning, *pzBuffer is set to the first byte passed the
7446ab3a2ecSdanielk1977 ** portion of the buffer copied into by this function.
7456ab3a2ecSdanielk1977 */
7466ab3a2ecSdanielk1977 static Expr *exprDup(sqlite3 *db, Expr *p, int flags, u8 **pzBuffer){
7476ab3a2ecSdanielk1977   Expr *pNew = 0;                      /* Value to return */
7486ab3a2ecSdanielk1977   if( p ){
7496ab3a2ecSdanielk1977     const int isReduced = (flags&EXPRDUP_REDUCE);
7506ab3a2ecSdanielk1977     u8 *zAlloc;
75133e619fcSdrh     u32 staticFlag = 0;
7526ab3a2ecSdanielk1977 
7536ab3a2ecSdanielk1977     assert( pzBuffer==0 || isReduced );
7546ab3a2ecSdanielk1977 
7556ab3a2ecSdanielk1977     /* Figure out where to write the new Expr structure. */
7566ab3a2ecSdanielk1977     if( pzBuffer ){
7576ab3a2ecSdanielk1977       zAlloc = *pzBuffer;
75833e619fcSdrh       staticFlag = EP_Static;
7596ab3a2ecSdanielk1977     }else{
7606ab3a2ecSdanielk1977       zAlloc = sqlite3DbMallocRaw(db, dupedExprSize(p, flags));
7616ab3a2ecSdanielk1977     }
7626ab3a2ecSdanielk1977     pNew = (Expr *)zAlloc;
7636ab3a2ecSdanielk1977 
7646ab3a2ecSdanielk1977     if( pNew ){
7656ab3a2ecSdanielk1977       /* Set nNewSize to the size allocated for the structure pointed to
7666ab3a2ecSdanielk1977       ** by pNew. This is either EXPR_FULLSIZE, EXPR_REDUCEDSIZE or
7676ab3a2ecSdanielk1977       ** EXPR_TOKENONLYSIZE. nToken is set to the number of bytes consumed
76833e619fcSdrh       ** by the copy of the p->u.zToken string (if any).
7696ab3a2ecSdanielk1977       */
77033e619fcSdrh       const unsigned nStructSize = dupedExprStructSize(p, flags);
77133e619fcSdrh       const int nNewSize = nStructSize & 0xfff;
77233e619fcSdrh       int nToken;
77333e619fcSdrh       if( !ExprHasProperty(p, EP_IntValue) && p->u.zToken ){
77433e619fcSdrh         nToken = sqlite3Strlen30(p->u.zToken) + 1;
77533e619fcSdrh       }else{
77633e619fcSdrh         nToken = 0;
77733e619fcSdrh       }
7786ab3a2ecSdanielk1977       if( isReduced ){
7796ab3a2ecSdanielk1977         assert( ExprHasProperty(p, EP_Reduced)==0 );
7806ab3a2ecSdanielk1977         memcpy(zAlloc, p, nNewSize);
7816ab3a2ecSdanielk1977       }else{
7826ab3a2ecSdanielk1977         int nSize = exprStructSize(p);
7836ab3a2ecSdanielk1977         memcpy(zAlloc, p, nSize);
7846ab3a2ecSdanielk1977         memset(&zAlloc[nSize], 0, EXPR_FULLSIZE-nSize);
7856ab3a2ecSdanielk1977       }
7866ab3a2ecSdanielk1977 
78733e619fcSdrh       /* Set the EP_Reduced, EP_TokenOnly, and EP_Static flags appropriately. */
78833e619fcSdrh       pNew->flags &= ~(EP_Reduced|EP_TokenOnly|EP_Static);
78933e619fcSdrh       pNew->flags |= nStructSize & (EP_Reduced|EP_TokenOnly);
79033e619fcSdrh       pNew->flags |= staticFlag;
7916ab3a2ecSdanielk1977 
79233e619fcSdrh       /* Copy the p->u.zToken string, if any. */
7936ab3a2ecSdanielk1977       if( nToken ){
79433e619fcSdrh         char *zToken = pNew->u.zToken = (char*)&zAlloc[nNewSize];
79533e619fcSdrh         memcpy(zToken, p->u.zToken, nToken);
7966ab3a2ecSdanielk1977       }
7976ab3a2ecSdanielk1977 
7986ab3a2ecSdanielk1977       if( 0==((p->flags|pNew->flags) & EP_TokenOnly) ){
7996ab3a2ecSdanielk1977         /* Fill in the pNew->x.pSelect or pNew->x.pList member. */
8006ab3a2ecSdanielk1977         if( ExprHasProperty(p, EP_xIsSelect) ){
8016ab3a2ecSdanielk1977           pNew->x.pSelect = sqlite3SelectDup(db, p->x.pSelect, isReduced);
8026ab3a2ecSdanielk1977         }else{
8036ab3a2ecSdanielk1977           pNew->x.pList = sqlite3ExprListDup(db, p->x.pList, isReduced);
8046ab3a2ecSdanielk1977         }
8056ab3a2ecSdanielk1977       }
8066ab3a2ecSdanielk1977 
8076ab3a2ecSdanielk1977       /* Fill in pNew->pLeft and pNew->pRight. */
808b7916a78Sdrh       if( ExprHasAnyProperty(pNew, EP_Reduced|EP_TokenOnly) ){
8096ab3a2ecSdanielk1977         zAlloc += dupedExprNodeSize(p, flags);
8106ab3a2ecSdanielk1977         if( ExprHasProperty(pNew, EP_Reduced) ){
8116ab3a2ecSdanielk1977           pNew->pLeft = exprDup(db, p->pLeft, EXPRDUP_REDUCE, &zAlloc);
8126ab3a2ecSdanielk1977           pNew->pRight = exprDup(db, p->pRight, EXPRDUP_REDUCE, &zAlloc);
8136ab3a2ecSdanielk1977         }
8146ab3a2ecSdanielk1977         if( pzBuffer ){
8156ab3a2ecSdanielk1977           *pzBuffer = zAlloc;
8166ab3a2ecSdanielk1977         }
817b7916a78Sdrh       }else{
818b7916a78Sdrh         pNew->flags2 = 0;
819b7916a78Sdrh         if( !ExprHasAnyProperty(p, EP_TokenOnly) ){
8206ab3a2ecSdanielk1977           pNew->pLeft = sqlite3ExprDup(db, p->pLeft, 0);
8216ab3a2ecSdanielk1977           pNew->pRight = sqlite3ExprDup(db, p->pRight, 0);
8226ab3a2ecSdanielk1977         }
8236ab3a2ecSdanielk1977       }
824b7916a78Sdrh 
825b7916a78Sdrh     }
8266ab3a2ecSdanielk1977   }
8276ab3a2ecSdanielk1977   return pNew;
8286ab3a2ecSdanielk1977 }
8296ab3a2ecSdanielk1977 
8306ab3a2ecSdanielk1977 /*
831ff78bd2fSdrh ** The following group of routines make deep copies of expressions,
832ff78bd2fSdrh ** expression lists, ID lists, and select statements.  The copies can
833ff78bd2fSdrh ** be deleted (by being passed to their respective ...Delete() routines)
834ff78bd2fSdrh ** without effecting the originals.
835ff78bd2fSdrh **
8364adee20fSdanielk1977 ** The expression list, ID, and source lists return by sqlite3ExprListDup(),
8374adee20fSdanielk1977 ** sqlite3IdListDup(), and sqlite3SrcListDup() can not be further expanded
838ad3cab52Sdrh ** by subsequent calls to sqlite*ListAppend() routines.
839ff78bd2fSdrh **
840ad3cab52Sdrh ** Any tables that the SrcList might point to are not duplicated.
8416ab3a2ecSdanielk1977 **
842b7916a78Sdrh ** The flags parameter contains a combination of the EXPRDUP_XXX flags.
8436ab3a2ecSdanielk1977 ** If the EXPRDUP_REDUCE flag is set, then the structure returned is a
8446ab3a2ecSdanielk1977 ** truncated version of the usual Expr structure that will be stored as
8456ab3a2ecSdanielk1977 ** part of the in-memory representation of the database schema.
846ff78bd2fSdrh */
8476ab3a2ecSdanielk1977 Expr *sqlite3ExprDup(sqlite3 *db, Expr *p, int flags){
8486ab3a2ecSdanielk1977   return exprDup(db, p, flags, 0);
849ff78bd2fSdrh }
8506ab3a2ecSdanielk1977 ExprList *sqlite3ExprListDup(sqlite3 *db, ExprList *p, int flags){
851ff78bd2fSdrh   ExprList *pNew;
852145716b3Sdrh   struct ExprList_item *pItem, *pOldItem;
853ff78bd2fSdrh   int i;
854ff78bd2fSdrh   if( p==0 ) return 0;
85517435752Sdrh   pNew = sqlite3DbMallocRaw(db, sizeof(*pNew) );
856ff78bd2fSdrh   if( pNew==0 ) return 0;
85731dad9daSdanielk1977   pNew->iECursor = 0;
8584305d103Sdrh   pNew->nExpr = pNew->nAlloc = p->nExpr;
85917435752Sdrh   pNew->a = pItem = sqlite3DbMallocRaw(db,  p->nExpr*sizeof(p->a[0]) );
860e0048400Sdanielk1977   if( pItem==0 ){
861633e6d57Sdrh     sqlite3DbFree(db, pNew);
862e0048400Sdanielk1977     return 0;
863e0048400Sdanielk1977   }
864145716b3Sdrh   pOldItem = p->a;
865145716b3Sdrh   for(i=0; i<p->nExpr; i++, pItem++, pOldItem++){
8666ab3a2ecSdanielk1977     Expr *pOldExpr = pOldItem->pExpr;
867b5526ea6Sdrh     pItem->pExpr = sqlite3ExprDup(db, pOldExpr, flags);
86817435752Sdrh     pItem->zName = sqlite3DbStrDup(db, pOldItem->zName);
869b7916a78Sdrh     pItem->zSpan = sqlite3DbStrDup(db, pOldItem->zSpan);
870145716b3Sdrh     pItem->sortOrder = pOldItem->sortOrder;
8713e7bc9caSdrh     pItem->done = 0;
8727d10d5a6Sdrh     pItem->iCol = pOldItem->iCol;
8738b213899Sdrh     pItem->iAlias = pOldItem->iAlias;
874ff78bd2fSdrh   }
875ff78bd2fSdrh   return pNew;
876ff78bd2fSdrh }
87793758c8dSdanielk1977 
87893758c8dSdanielk1977 /*
87993758c8dSdanielk1977 ** If cursors, triggers, views and subqueries are all omitted from
88093758c8dSdanielk1977 ** the build, then none of the following routines, except for
88193758c8dSdanielk1977 ** sqlite3SelectDup(), can be called. sqlite3SelectDup() is sometimes
88293758c8dSdanielk1977 ** called with a NULL argument.
88393758c8dSdanielk1977 */
8846a67fe8eSdanielk1977 #if !defined(SQLITE_OMIT_VIEW) || !defined(SQLITE_OMIT_TRIGGER) \
8856a67fe8eSdanielk1977  || !defined(SQLITE_OMIT_SUBQUERY)
8866ab3a2ecSdanielk1977 SrcList *sqlite3SrcListDup(sqlite3 *db, SrcList *p, int flags){
887ad3cab52Sdrh   SrcList *pNew;
888ad3cab52Sdrh   int i;
889113088ecSdrh   int nByte;
890ad3cab52Sdrh   if( p==0 ) return 0;
891113088ecSdrh   nByte = sizeof(*p) + (p->nSrc>0 ? sizeof(p->a[0]) * (p->nSrc-1) : 0);
89217435752Sdrh   pNew = sqlite3DbMallocRaw(db, nByte );
893ad3cab52Sdrh   if( pNew==0 ) return 0;
8944305d103Sdrh   pNew->nSrc = pNew->nAlloc = p->nSrc;
895ad3cab52Sdrh   for(i=0; i<p->nSrc; i++){
8964efc4754Sdrh     struct SrcList_item *pNewItem = &pNew->a[i];
8974efc4754Sdrh     struct SrcList_item *pOldItem = &p->a[i];
898ed8a3bb1Sdrh     Table *pTab;
89917435752Sdrh     pNewItem->zDatabase = sqlite3DbStrDup(db, pOldItem->zDatabase);
90017435752Sdrh     pNewItem->zName = sqlite3DbStrDup(db, pOldItem->zName);
90117435752Sdrh     pNewItem->zAlias = sqlite3DbStrDup(db, pOldItem->zAlias);
9024efc4754Sdrh     pNewItem->jointype = pOldItem->jointype;
9034efc4754Sdrh     pNewItem->iCursor = pOldItem->iCursor;
9045b6a9ed4Sdrh     pNewItem->addrFillSub = pOldItem->addrFillSub;
9055b6a9ed4Sdrh     pNewItem->regReturn = pOldItem->regReturn;
906da79cf0cSdan     pNewItem->isCorrelated = pOldItem->isCorrelated;
90785574e31Sdanielk1977     pNewItem->zIndex = sqlite3DbStrDup(db, pOldItem->zIndex);
90885574e31Sdanielk1977     pNewItem->notIndexed = pOldItem->notIndexed;
90985574e31Sdanielk1977     pNewItem->pIndex = pOldItem->pIndex;
910ed8a3bb1Sdrh     pTab = pNewItem->pTab = pOldItem->pTab;
911ed8a3bb1Sdrh     if( pTab ){
912ed8a3bb1Sdrh       pTab->nRef++;
913a1cb183dSdanielk1977     }
9146ab3a2ecSdanielk1977     pNewItem->pSelect = sqlite3SelectDup(db, pOldItem->pSelect, flags);
9156ab3a2ecSdanielk1977     pNewItem->pOn = sqlite3ExprDup(db, pOldItem->pOn, flags);
91617435752Sdrh     pNewItem->pUsing = sqlite3IdListDup(db, pOldItem->pUsing);
9176c18b6e0Sdanielk1977     pNewItem->colUsed = pOldItem->colUsed;
918ad3cab52Sdrh   }
919ad3cab52Sdrh   return pNew;
920ad3cab52Sdrh }
92117435752Sdrh IdList *sqlite3IdListDup(sqlite3 *db, IdList *p){
922ff78bd2fSdrh   IdList *pNew;
923ff78bd2fSdrh   int i;
924ff78bd2fSdrh   if( p==0 ) return 0;
92517435752Sdrh   pNew = sqlite3DbMallocRaw(db, sizeof(*pNew) );
926ff78bd2fSdrh   if( pNew==0 ) return 0;
9274305d103Sdrh   pNew->nId = pNew->nAlloc = p->nId;
92817435752Sdrh   pNew->a = sqlite3DbMallocRaw(db, p->nId*sizeof(p->a[0]) );
929d5d56523Sdanielk1977   if( pNew->a==0 ){
930633e6d57Sdrh     sqlite3DbFree(db, pNew);
931d5d56523Sdanielk1977     return 0;
932d5d56523Sdanielk1977   }
933ff78bd2fSdrh   for(i=0; i<p->nId; i++){
9344efc4754Sdrh     struct IdList_item *pNewItem = &pNew->a[i];
9354efc4754Sdrh     struct IdList_item *pOldItem = &p->a[i];
93617435752Sdrh     pNewItem->zName = sqlite3DbStrDup(db, pOldItem->zName);
9374efc4754Sdrh     pNewItem->idx = pOldItem->idx;
938ff78bd2fSdrh   }
939ff78bd2fSdrh   return pNew;
940ff78bd2fSdrh }
9416ab3a2ecSdanielk1977 Select *sqlite3SelectDup(sqlite3 *db, Select *p, int flags){
942ff78bd2fSdrh   Select *pNew;
943ff78bd2fSdrh   if( p==0 ) return 0;
94417435752Sdrh   pNew = sqlite3DbMallocRaw(db, sizeof(*p) );
945ff78bd2fSdrh   if( pNew==0 ) return 0;
946b7916a78Sdrh   pNew->pEList = sqlite3ExprListDup(db, p->pEList, flags);
9476ab3a2ecSdanielk1977   pNew->pSrc = sqlite3SrcListDup(db, p->pSrc, flags);
9486ab3a2ecSdanielk1977   pNew->pWhere = sqlite3ExprDup(db, p->pWhere, flags);
9496ab3a2ecSdanielk1977   pNew->pGroupBy = sqlite3ExprListDup(db, p->pGroupBy, flags);
9506ab3a2ecSdanielk1977   pNew->pHaving = sqlite3ExprDup(db, p->pHaving, flags);
9516ab3a2ecSdanielk1977   pNew->pOrderBy = sqlite3ExprListDup(db, p->pOrderBy, flags);
952ff78bd2fSdrh   pNew->op = p->op;
9536ab3a2ecSdanielk1977   pNew->pPrior = sqlite3SelectDup(db, p->pPrior, flags);
9546ab3a2ecSdanielk1977   pNew->pLimit = sqlite3ExprDup(db, p->pLimit, flags);
9556ab3a2ecSdanielk1977   pNew->pOffset = sqlite3ExprDup(db, p->pOffset, flags);
95692b01d53Sdrh   pNew->iLimit = 0;
95792b01d53Sdrh   pNew->iOffset = 0;
9587d10d5a6Sdrh   pNew->selFlags = p->selFlags & ~SF_UsesEphemeral;
9590342b1f5Sdrh   pNew->pRightmost = 0;
960b9bb7c18Sdrh   pNew->addrOpenEphm[0] = -1;
961b9bb7c18Sdrh   pNew->addrOpenEphm[1] = -1;
962b9bb7c18Sdrh   pNew->addrOpenEphm[2] = -1;
963ff78bd2fSdrh   return pNew;
964ff78bd2fSdrh }
96593758c8dSdanielk1977 #else
9666ab3a2ecSdanielk1977 Select *sqlite3SelectDup(sqlite3 *db, Select *p, int flags){
96793758c8dSdanielk1977   assert( p==0 );
96893758c8dSdanielk1977   return 0;
96993758c8dSdanielk1977 }
97093758c8dSdanielk1977 #endif
971ff78bd2fSdrh 
972ff78bd2fSdrh 
973ff78bd2fSdrh /*
974a76b5dfcSdrh ** Add a new element to the end of an expression list.  If pList is
975a76b5dfcSdrh ** initially NULL, then create a new expression list.
976b7916a78Sdrh **
977b7916a78Sdrh ** If a memory allocation error occurs, the entire list is freed and
978b7916a78Sdrh ** NULL is returned.  If non-NULL is returned, then it is guaranteed
979b7916a78Sdrh ** that the new entry was successfully appended.
980a76b5dfcSdrh */
98117435752Sdrh ExprList *sqlite3ExprListAppend(
98217435752Sdrh   Parse *pParse,          /* Parsing context */
98317435752Sdrh   ExprList *pList,        /* List to which to append. Might be NULL */
984b7916a78Sdrh   Expr *pExpr             /* Expression to be appended. Might be NULL */
98517435752Sdrh ){
98617435752Sdrh   sqlite3 *db = pParse->db;
987a76b5dfcSdrh   if( pList==0 ){
98817435752Sdrh     pList = sqlite3DbMallocZero(db, sizeof(ExprList) );
989a76b5dfcSdrh     if( pList==0 ){
990d5d56523Sdanielk1977       goto no_mem;
991a76b5dfcSdrh     }
9924efc4754Sdrh     assert( pList->nAlloc==0 );
993a76b5dfcSdrh   }
9944305d103Sdrh   if( pList->nAlloc<=pList->nExpr ){
995d5d56523Sdanielk1977     struct ExprList_item *a;
996d5d56523Sdanielk1977     int n = pList->nAlloc*2 + 4;
99726783a58Sdanielk1977     a = sqlite3DbRealloc(db, pList->a, n*sizeof(pList->a[0]));
998d5d56523Sdanielk1977     if( a==0 ){
999d5d56523Sdanielk1977       goto no_mem;
1000a76b5dfcSdrh     }
1001d5d56523Sdanielk1977     pList->a = a;
10026a1e071fSdrh     pList->nAlloc = sqlite3DbMallocSize(db, a)/sizeof(a[0]);
1003a76b5dfcSdrh   }
10044efc4754Sdrh   assert( pList->a!=0 );
1005b7916a78Sdrh   if( 1 ){
10064efc4754Sdrh     struct ExprList_item *pItem = &pList->a[pList->nExpr++];
10074efc4754Sdrh     memset(pItem, 0, sizeof(*pItem));
1008e94ddc9eSdanielk1977     pItem->pExpr = pExpr;
1009a76b5dfcSdrh   }
1010a76b5dfcSdrh   return pList;
1011d5d56523Sdanielk1977 
1012d5d56523Sdanielk1977 no_mem:
1013d5d56523Sdanielk1977   /* Avoid leaking memory if malloc has failed. */
1014633e6d57Sdrh   sqlite3ExprDelete(db, pExpr);
1015633e6d57Sdrh   sqlite3ExprListDelete(db, pList);
1016d5d56523Sdanielk1977   return 0;
1017a76b5dfcSdrh }
1018a76b5dfcSdrh 
1019a76b5dfcSdrh /*
1020b7916a78Sdrh ** Set the ExprList.a[].zName element of the most recently added item
1021b7916a78Sdrh ** on the expression list.
1022b7916a78Sdrh **
1023b7916a78Sdrh ** pList might be NULL following an OOM error.  But pName should never be
1024b7916a78Sdrh ** NULL.  If a memory allocation fails, the pParse->db->mallocFailed flag
1025b7916a78Sdrh ** is set.
1026b7916a78Sdrh */
1027b7916a78Sdrh void sqlite3ExprListSetName(
1028b7916a78Sdrh   Parse *pParse,          /* Parsing context */
1029b7916a78Sdrh   ExprList *pList,        /* List to which to add the span. */
1030b7916a78Sdrh   Token *pName,           /* Name to be added */
1031b7916a78Sdrh   int dequote             /* True to cause the name to be dequoted */
1032b7916a78Sdrh ){
1033b7916a78Sdrh   assert( pList!=0 || pParse->db->mallocFailed!=0 );
1034b7916a78Sdrh   if( pList ){
1035b7916a78Sdrh     struct ExprList_item *pItem;
1036b7916a78Sdrh     assert( pList->nExpr>0 );
1037b7916a78Sdrh     pItem = &pList->a[pList->nExpr-1];
1038b7916a78Sdrh     assert( pItem->zName==0 );
1039b7916a78Sdrh     pItem->zName = sqlite3DbStrNDup(pParse->db, pName->z, pName->n);
1040b7916a78Sdrh     if( dequote && pItem->zName ) sqlite3Dequote(pItem->zName);
1041b7916a78Sdrh   }
1042b7916a78Sdrh }
1043b7916a78Sdrh 
1044b7916a78Sdrh /*
1045b7916a78Sdrh ** Set the ExprList.a[].zSpan element of the most recently added item
1046b7916a78Sdrh ** on the expression list.
1047b7916a78Sdrh **
1048b7916a78Sdrh ** pList might be NULL following an OOM error.  But pSpan should never be
1049b7916a78Sdrh ** NULL.  If a memory allocation fails, the pParse->db->mallocFailed flag
1050b7916a78Sdrh ** is set.
1051b7916a78Sdrh */
1052b7916a78Sdrh void sqlite3ExprListSetSpan(
1053b7916a78Sdrh   Parse *pParse,          /* Parsing context */
1054b7916a78Sdrh   ExprList *pList,        /* List to which to add the span. */
1055b7916a78Sdrh   ExprSpan *pSpan         /* The span to be added */
1056b7916a78Sdrh ){
1057b7916a78Sdrh   sqlite3 *db = pParse->db;
1058b7916a78Sdrh   assert( pList!=0 || db->mallocFailed!=0 );
1059b7916a78Sdrh   if( pList ){
1060b7916a78Sdrh     struct ExprList_item *pItem = &pList->a[pList->nExpr-1];
1061b7916a78Sdrh     assert( pList->nExpr>0 );
1062b7916a78Sdrh     assert( db->mallocFailed || pItem->pExpr==pSpan->pExpr );
1063b7916a78Sdrh     sqlite3DbFree(db, pItem->zSpan);
1064b7916a78Sdrh     pItem->zSpan = sqlite3DbStrNDup(db, (char*)pSpan->zStart,
1065cf697396Sshane                                     (int)(pSpan->zEnd - pSpan->zStart));
1066b7916a78Sdrh   }
1067b7916a78Sdrh }
1068b7916a78Sdrh 
1069b7916a78Sdrh /*
10707a15a4beSdanielk1977 ** If the expression list pEList contains more than iLimit elements,
10717a15a4beSdanielk1977 ** leave an error message in pParse.
10727a15a4beSdanielk1977 */
10737a15a4beSdanielk1977 void sqlite3ExprListCheckLength(
10747a15a4beSdanielk1977   Parse *pParse,
10757a15a4beSdanielk1977   ExprList *pEList,
10767a15a4beSdanielk1977   const char *zObject
10777a15a4beSdanielk1977 ){
1078b1a6c3c1Sdrh   int mx = pParse->db->aLimit[SQLITE_LIMIT_COLUMN];
1079c5499befSdrh   testcase( pEList && pEList->nExpr==mx );
1080c5499befSdrh   testcase( pEList && pEList->nExpr==mx+1 );
1081b1a6c3c1Sdrh   if( pEList && pEList->nExpr>mx ){
10827a15a4beSdanielk1977     sqlite3ErrorMsg(pParse, "too many columns in %s", zObject);
10837a15a4beSdanielk1977   }
10847a15a4beSdanielk1977 }
10857a15a4beSdanielk1977 
10867a15a4beSdanielk1977 /*
1087a76b5dfcSdrh ** Delete an entire expression list.
1088a76b5dfcSdrh */
1089633e6d57Sdrh void sqlite3ExprListDelete(sqlite3 *db, ExprList *pList){
1090a76b5dfcSdrh   int i;
1091be5c89acSdrh   struct ExprList_item *pItem;
1092a76b5dfcSdrh   if( pList==0 ) return;
10931bdd9b57Sdrh   assert( pList->a!=0 || (pList->nExpr==0 && pList->nAlloc==0) );
10941bdd9b57Sdrh   assert( pList->nExpr<=pList->nAlloc );
1095be5c89acSdrh   for(pItem=pList->a, i=0; i<pList->nExpr; i++, pItem++){
1096633e6d57Sdrh     sqlite3ExprDelete(db, pItem->pExpr);
1097633e6d57Sdrh     sqlite3DbFree(db, pItem->zName);
1098b7916a78Sdrh     sqlite3DbFree(db, pItem->zSpan);
1099a76b5dfcSdrh   }
1100633e6d57Sdrh   sqlite3DbFree(db, pList->a);
1101633e6d57Sdrh   sqlite3DbFree(db, pList);
1102a76b5dfcSdrh }
1103a76b5dfcSdrh 
1104a76b5dfcSdrh /*
11057d10d5a6Sdrh ** These routines are Walker callbacks.  Walker.u.pi is a pointer
11067d10d5a6Sdrh ** to an integer.  These routines are checking an expression to see
11077d10d5a6Sdrh ** if it is a constant.  Set *Walker.u.pi to 0 if the expression is
11087d10d5a6Sdrh ** not constant.
110973b211abSdrh **
11107d10d5a6Sdrh ** These callback routines are used to implement the following:
1111626a879aSdrh **
11127d10d5a6Sdrh **     sqlite3ExprIsConstant()
11137d10d5a6Sdrh **     sqlite3ExprIsConstantNotJoin()
11147d10d5a6Sdrh **     sqlite3ExprIsConstantOrFunction()
111587abf5c0Sdrh **
1116626a879aSdrh */
11177d10d5a6Sdrh static int exprNodeIsConstant(Walker *pWalker, Expr *pExpr){
1118626a879aSdrh 
11197d10d5a6Sdrh   /* If pWalker->u.i is 3 then any term of the expression that comes from
11200a168377Sdrh   ** the ON or USING clauses of a join disqualifies the expression
11210a168377Sdrh   ** from being considered constant. */
11227d10d5a6Sdrh   if( pWalker->u.i==3 && ExprHasAnyProperty(pExpr, EP_FromJoin) ){
11237d10d5a6Sdrh     pWalker->u.i = 0;
11247d10d5a6Sdrh     return WRC_Abort;
11250a168377Sdrh   }
11260a168377Sdrh 
1127626a879aSdrh   switch( pExpr->op ){
1128eb55bd2fSdrh     /* Consider functions to be constant if all their arguments are constant
11297d10d5a6Sdrh     ** and pWalker->u.i==2 */
1130eb55bd2fSdrh     case TK_FUNCTION:
11317d10d5a6Sdrh       if( pWalker->u.i==2 ) return 0;
1132eb55bd2fSdrh       /* Fall through */
1133626a879aSdrh     case TK_ID:
1134626a879aSdrh     case TK_COLUMN:
1135626a879aSdrh     case TK_AGG_FUNCTION:
113613449892Sdrh     case TK_AGG_COLUMN:
1137c5499befSdrh       testcase( pExpr->op==TK_ID );
1138c5499befSdrh       testcase( pExpr->op==TK_COLUMN );
1139c5499befSdrh       testcase( pExpr->op==TK_AGG_FUNCTION );
1140c5499befSdrh       testcase( pExpr->op==TK_AGG_COLUMN );
11417d10d5a6Sdrh       pWalker->u.i = 0;
11427d10d5a6Sdrh       return WRC_Abort;
1143626a879aSdrh     default:
1144b74b1017Sdrh       testcase( pExpr->op==TK_SELECT ); /* selectNodeIsConstant will disallow */
1145b74b1017Sdrh       testcase( pExpr->op==TK_EXISTS ); /* selectNodeIsConstant will disallow */
11467d10d5a6Sdrh       return WRC_Continue;
1147626a879aSdrh   }
1148626a879aSdrh }
114962c14b34Sdanielk1977 static int selectNodeIsConstant(Walker *pWalker, Select *NotUsed){
115062c14b34Sdanielk1977   UNUSED_PARAMETER(NotUsed);
11517d10d5a6Sdrh   pWalker->u.i = 0;
11527d10d5a6Sdrh   return WRC_Abort;
11537d10d5a6Sdrh }
11547d10d5a6Sdrh static int exprIsConst(Expr *p, int initFlag){
11557d10d5a6Sdrh   Walker w;
11567d10d5a6Sdrh   w.u.i = initFlag;
11577d10d5a6Sdrh   w.xExprCallback = exprNodeIsConstant;
11587d10d5a6Sdrh   w.xSelectCallback = selectNodeIsConstant;
11597d10d5a6Sdrh   sqlite3WalkExpr(&w, p);
11607d10d5a6Sdrh   return w.u.i;
11617d10d5a6Sdrh }
1162626a879aSdrh 
1163626a879aSdrh /*
1164fef5208cSdrh ** Walk an expression tree.  Return 1 if the expression is constant
1165eb55bd2fSdrh ** and 0 if it involves variables or function calls.
11662398937bSdrh **
11672398937bSdrh ** For the purposes of this function, a double-quoted string (ex: "abc")
11682398937bSdrh ** is considered a variable but a single-quoted string (ex: 'abc') is
11692398937bSdrh ** a constant.
1170fef5208cSdrh */
11714adee20fSdanielk1977 int sqlite3ExprIsConstant(Expr *p){
11727d10d5a6Sdrh   return exprIsConst(p, 1);
1173fef5208cSdrh }
1174fef5208cSdrh 
1175fef5208cSdrh /*
1176eb55bd2fSdrh ** Walk an expression tree.  Return 1 if the expression is constant
11770a168377Sdrh ** that does no originate from the ON or USING clauses of a join.
11780a168377Sdrh ** Return 0 if it involves variables or function calls or terms from
11790a168377Sdrh ** an ON or USING clause.
11800a168377Sdrh */
11810a168377Sdrh int sqlite3ExprIsConstantNotJoin(Expr *p){
11827d10d5a6Sdrh   return exprIsConst(p, 3);
11830a168377Sdrh }
11840a168377Sdrh 
11850a168377Sdrh /*
11860a168377Sdrh ** Walk an expression tree.  Return 1 if the expression is constant
1187eb55bd2fSdrh ** or a function call with constant arguments.  Return and 0 if there
1188eb55bd2fSdrh ** are any variables.
1189eb55bd2fSdrh **
1190eb55bd2fSdrh ** For the purposes of this function, a double-quoted string (ex: "abc")
1191eb55bd2fSdrh ** is considered a variable but a single-quoted string (ex: 'abc') is
1192eb55bd2fSdrh ** a constant.
1193eb55bd2fSdrh */
1194eb55bd2fSdrh int sqlite3ExprIsConstantOrFunction(Expr *p){
11957d10d5a6Sdrh   return exprIsConst(p, 2);
1196eb55bd2fSdrh }
1197eb55bd2fSdrh 
1198eb55bd2fSdrh /*
119973b211abSdrh ** If the expression p codes a constant integer that is small enough
1200202b2df7Sdrh ** to fit in a 32-bit integer, return 1 and put the value of the integer
1201202b2df7Sdrh ** in *pValue.  If the expression is not an integer or if it is too big
1202202b2df7Sdrh ** to fit in a signed 32-bit integer, return 0 and leave *pValue unchanged.
1203e4de1febSdrh */
12044adee20fSdanielk1977 int sqlite3ExprIsInteger(Expr *p, int *pValue){
120592b01d53Sdrh   int rc = 0;
1206cd92e84dSdrh 
1207cd92e84dSdrh   /* If an expression is an integer literal that fits in a signed 32-bit
1208cd92e84dSdrh   ** integer, then the EP_IntValue flag will have already been set */
1209cd92e84dSdrh   assert( p->op!=TK_INTEGER || (p->flags & EP_IntValue)!=0
1210cd92e84dSdrh            || sqlite3GetInt32(p->u.zToken, &rc)==0 );
1211cd92e84dSdrh 
121292b01d53Sdrh   if( p->flags & EP_IntValue ){
121333e619fcSdrh     *pValue = p->u.iValue;
1214e4de1febSdrh     return 1;
1215e4de1febSdrh   }
121692b01d53Sdrh   switch( p->op ){
12174b59ab5eSdrh     case TK_UPLUS: {
121892b01d53Sdrh       rc = sqlite3ExprIsInteger(p->pLeft, pValue);
1219f6e369a1Sdrh       break;
12204b59ab5eSdrh     }
1221e4de1febSdrh     case TK_UMINUS: {
1222e4de1febSdrh       int v;
12234adee20fSdanielk1977       if( sqlite3ExprIsInteger(p->pLeft, &v) ){
1224e4de1febSdrh         *pValue = -v;
122592b01d53Sdrh         rc = 1;
1226e4de1febSdrh       }
1227e4de1febSdrh       break;
1228e4de1febSdrh     }
1229e4de1febSdrh     default: break;
1230e4de1febSdrh   }
123192b01d53Sdrh   return rc;
1232e4de1febSdrh }
1233e4de1febSdrh 
1234e4de1febSdrh /*
1235039fc32eSdrh ** Return FALSE if there is no chance that the expression can be NULL.
1236039fc32eSdrh **
1237039fc32eSdrh ** If the expression might be NULL or if the expression is too complex
1238039fc32eSdrh ** to tell return TRUE.
1239039fc32eSdrh **
1240039fc32eSdrh ** This routine is used as an optimization, to skip OP_IsNull opcodes
1241039fc32eSdrh ** when we know that a value cannot be NULL.  Hence, a false positive
1242039fc32eSdrh ** (returning TRUE when in fact the expression can never be NULL) might
1243039fc32eSdrh ** be a small performance hit but is otherwise harmless.  On the other
1244039fc32eSdrh ** hand, a false negative (returning FALSE when the result could be NULL)
1245039fc32eSdrh ** will likely result in an incorrect answer.  So when in doubt, return
1246039fc32eSdrh ** TRUE.
1247039fc32eSdrh */
1248039fc32eSdrh int sqlite3ExprCanBeNull(const Expr *p){
1249039fc32eSdrh   u8 op;
1250cd7f457eSdrh   while( p->op==TK_UPLUS || p->op==TK_UMINUS ){ p = p->pLeft; }
1251039fc32eSdrh   op = p->op;
1252039fc32eSdrh   if( op==TK_REGISTER ) op = p->op2;
1253039fc32eSdrh   switch( op ){
1254039fc32eSdrh     case TK_INTEGER:
1255039fc32eSdrh     case TK_STRING:
1256039fc32eSdrh     case TK_FLOAT:
1257039fc32eSdrh     case TK_BLOB:
1258039fc32eSdrh       return 0;
1259039fc32eSdrh     default:
1260039fc32eSdrh       return 1;
1261039fc32eSdrh   }
1262039fc32eSdrh }
1263039fc32eSdrh 
1264039fc32eSdrh /*
12652f2855b6Sdrh ** Generate an OP_IsNull instruction that tests register iReg and jumps
12662f2855b6Sdrh ** to location iDest if the value in iReg is NULL.  The value in iReg
12672f2855b6Sdrh ** was computed by pExpr.  If we can look at pExpr at compile-time and
12682f2855b6Sdrh ** determine that it can never generate a NULL, then the OP_IsNull operation
12692f2855b6Sdrh ** can be omitted.
12702f2855b6Sdrh */
12712f2855b6Sdrh void sqlite3ExprCodeIsNullJump(
12722f2855b6Sdrh   Vdbe *v,            /* The VDBE under construction */
12732f2855b6Sdrh   const Expr *pExpr,  /* Only generate OP_IsNull if this expr can be NULL */
12742f2855b6Sdrh   int iReg,           /* Test the value in this register for NULL */
12752f2855b6Sdrh   int iDest           /* Jump here if the value is null */
12762f2855b6Sdrh ){
12772f2855b6Sdrh   if( sqlite3ExprCanBeNull(pExpr) ){
12782f2855b6Sdrh     sqlite3VdbeAddOp2(v, OP_IsNull, iReg, iDest);
12792f2855b6Sdrh   }
12802f2855b6Sdrh }
12812f2855b6Sdrh 
12822f2855b6Sdrh /*
1283039fc32eSdrh ** Return TRUE if the given expression is a constant which would be
1284039fc32eSdrh ** unchanged by OP_Affinity with the affinity given in the second
1285039fc32eSdrh ** argument.
1286039fc32eSdrh **
1287039fc32eSdrh ** This routine is used to determine if the OP_Affinity operation
1288039fc32eSdrh ** can be omitted.  When in doubt return FALSE.  A false negative
1289039fc32eSdrh ** is harmless.  A false positive, however, can result in the wrong
1290039fc32eSdrh ** answer.
1291039fc32eSdrh */
1292039fc32eSdrh int sqlite3ExprNeedsNoAffinityChange(const Expr *p, char aff){
1293039fc32eSdrh   u8 op;
1294039fc32eSdrh   if( aff==SQLITE_AFF_NONE ) return 1;
1295cd7f457eSdrh   while( p->op==TK_UPLUS || p->op==TK_UMINUS ){ p = p->pLeft; }
1296039fc32eSdrh   op = p->op;
1297039fc32eSdrh   if( op==TK_REGISTER ) op = p->op2;
1298039fc32eSdrh   switch( op ){
1299039fc32eSdrh     case TK_INTEGER: {
1300039fc32eSdrh       return aff==SQLITE_AFF_INTEGER || aff==SQLITE_AFF_NUMERIC;
1301039fc32eSdrh     }
1302039fc32eSdrh     case TK_FLOAT: {
1303039fc32eSdrh       return aff==SQLITE_AFF_REAL || aff==SQLITE_AFF_NUMERIC;
1304039fc32eSdrh     }
1305039fc32eSdrh     case TK_STRING: {
1306039fc32eSdrh       return aff==SQLITE_AFF_TEXT;
1307039fc32eSdrh     }
1308039fc32eSdrh     case TK_BLOB: {
1309039fc32eSdrh       return 1;
1310039fc32eSdrh     }
13112f2855b6Sdrh     case TK_COLUMN: {
131288376ca7Sdrh       assert( p->iTable>=0 );  /* p cannot be part of a CHECK constraint */
131388376ca7Sdrh       return p->iColumn<0
13142f2855b6Sdrh           && (aff==SQLITE_AFF_INTEGER || aff==SQLITE_AFF_NUMERIC);
13152f2855b6Sdrh     }
1316039fc32eSdrh     default: {
1317039fc32eSdrh       return 0;
1318039fc32eSdrh     }
1319039fc32eSdrh   }
1320039fc32eSdrh }
1321039fc32eSdrh 
1322039fc32eSdrh /*
1323c4a3c779Sdrh ** Return TRUE if the given string is a row-id column name.
1324c4a3c779Sdrh */
13254adee20fSdanielk1977 int sqlite3IsRowid(const char *z){
13264adee20fSdanielk1977   if( sqlite3StrICmp(z, "_ROWID_")==0 ) return 1;
13274adee20fSdanielk1977   if( sqlite3StrICmp(z, "ROWID")==0 ) return 1;
13284adee20fSdanielk1977   if( sqlite3StrICmp(z, "OID")==0 ) return 1;
1329c4a3c779Sdrh   return 0;
1330c4a3c779Sdrh }
1331c4a3c779Sdrh 
13329a96b668Sdanielk1977 /*
1333b74b1017Sdrh ** Return true if we are able to the IN operator optimization on a
1334b74b1017Sdrh ** query of the form
1335b287f4b6Sdrh **
1336b74b1017Sdrh **       x IN (SELECT ...)
1337b287f4b6Sdrh **
1338b74b1017Sdrh ** Where the SELECT... clause is as specified by the parameter to this
1339b74b1017Sdrh ** routine.
1340b74b1017Sdrh **
1341b74b1017Sdrh ** The Select object passed in has already been preprocessed and no
1342b74b1017Sdrh ** errors have been found.
1343b287f4b6Sdrh */
1344b287f4b6Sdrh #ifndef SQLITE_OMIT_SUBQUERY
1345b287f4b6Sdrh static int isCandidateForInOpt(Select *p){
1346b287f4b6Sdrh   SrcList *pSrc;
1347b287f4b6Sdrh   ExprList *pEList;
1348b287f4b6Sdrh   Table *pTab;
1349b287f4b6Sdrh   if( p==0 ) return 0;                   /* right-hand side of IN is SELECT */
1350b287f4b6Sdrh   if( p->pPrior ) return 0;              /* Not a compound SELECT */
13517d10d5a6Sdrh   if( p->selFlags & (SF_Distinct|SF_Aggregate) ){
1352b74b1017Sdrh     testcase( (p->selFlags & (SF_Distinct|SF_Aggregate))==SF_Distinct );
1353b74b1017Sdrh     testcase( (p->selFlags & (SF_Distinct|SF_Aggregate))==SF_Aggregate );
13547d10d5a6Sdrh     return 0; /* No DISTINCT keyword and no aggregate functions */
13557d10d5a6Sdrh   }
1356b74b1017Sdrh   assert( p->pGroupBy==0 );              /* Has no GROUP BY clause */
1357b287f4b6Sdrh   if( p->pLimit ) return 0;              /* Has no LIMIT clause */
1358b74b1017Sdrh   assert( p->pOffset==0 );               /* No LIMIT means no OFFSET */
1359b287f4b6Sdrh   if( p->pWhere ) return 0;              /* Has no WHERE clause */
1360b287f4b6Sdrh   pSrc = p->pSrc;
1361d1fa7bcaSdrh   assert( pSrc!=0 );
1362d1fa7bcaSdrh   if( pSrc->nSrc!=1 ) return 0;          /* Single term in FROM clause */
1363b74b1017Sdrh   if( pSrc->a[0].pSelect ) return 0;     /* FROM is not a subquery or view */
1364b287f4b6Sdrh   pTab = pSrc->a[0].pTab;
1365b74b1017Sdrh   if( NEVER(pTab==0) ) return 0;
1366b74b1017Sdrh   assert( pTab->pSelect==0 );            /* FROM clause is not a view */
1367b287f4b6Sdrh   if( IsVirtual(pTab) ) return 0;        /* FROM clause not a virtual table */
1368b287f4b6Sdrh   pEList = p->pEList;
1369b287f4b6Sdrh   if( pEList->nExpr!=1 ) return 0;       /* One column in the result set */
1370b287f4b6Sdrh   if( pEList->a[0].pExpr->op!=TK_COLUMN ) return 0; /* Result is a column */
1371b287f4b6Sdrh   return 1;
1372b287f4b6Sdrh }
1373b287f4b6Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
1374b287f4b6Sdrh 
1375b287f4b6Sdrh /*
13769a96b668Sdanielk1977 ** This function is used by the implementation of the IN (...) operator.
13779a96b668Sdanielk1977 ** It's job is to find or create a b-tree structure that may be used
13789a96b668Sdanielk1977 ** either to test for membership of the (...) set or to iterate through
137985b623f2Sdrh ** its members, skipping duplicates.
13809a96b668Sdanielk1977 **
1381b74b1017Sdrh ** The index of the cursor opened on the b-tree (database table, database index
13829a96b668Sdanielk1977 ** or ephermal table) is stored in pX->iTable before this function returns.
1383b74b1017Sdrh ** The returned value of this function indicates the b-tree type, as follows:
13849a96b668Sdanielk1977 **
13859a96b668Sdanielk1977 **   IN_INDEX_ROWID - The cursor was opened on a database table.
13862d401ab8Sdrh **   IN_INDEX_INDEX - The cursor was opened on a database index.
13879a96b668Sdanielk1977 **   IN_INDEX_EPH -   The cursor was opened on a specially created and
13889a96b668Sdanielk1977 **                    populated epheremal table.
13899a96b668Sdanielk1977 **
1390b74b1017Sdrh ** An existing b-tree may only be used if the SELECT is of the simple
13919a96b668Sdanielk1977 ** form:
13929a96b668Sdanielk1977 **
13939a96b668Sdanielk1977 **     SELECT <column> FROM <table>
13949a96b668Sdanielk1977 **
1395b74b1017Sdrh ** If the prNotFound parameter is 0, then the b-tree will be used to iterate
13969a96b668Sdanielk1977 ** through the set members, skipping any duplicates. In this case an
13979a96b668Sdanielk1977 ** epheremal table must be used unless the selected <column> is guaranteed
13989a96b668Sdanielk1977 ** to be unique - either because it is an INTEGER PRIMARY KEY or it
1399b74b1017Sdrh ** has a UNIQUE constraint or UNIQUE index.
14000cdc022eSdanielk1977 **
1401b74b1017Sdrh ** If the prNotFound parameter is not 0, then the b-tree will be used
14020cdc022eSdanielk1977 ** for fast set membership tests. In this case an epheremal table must
14030cdc022eSdanielk1977 ** be used unless <column> is an INTEGER PRIMARY KEY or an index can
14040cdc022eSdanielk1977 ** be found with <column> as its left-most column.
14050cdc022eSdanielk1977 **
1406b74b1017Sdrh ** When the b-tree is being used for membership tests, the calling function
14070cdc022eSdanielk1977 ** needs to know whether or not the structure contains an SQL NULL
14080cdc022eSdanielk1977 ** value in order to correctly evaluate expressions like "X IN (Y, Z)".
1409e3365e6cSdrh ** If there is any chance that the (...) might contain a NULL value at
14100cdc022eSdanielk1977 ** runtime, then a register is allocated and the register number written
1411e3365e6cSdrh ** to *prNotFound. If there is no chance that the (...) contains a
14120cdc022eSdanielk1977 ** NULL value, then *prNotFound is left unchanged.
14130cdc022eSdanielk1977 **
14140cdc022eSdanielk1977 ** If a register is allocated and its location stored in *prNotFound, then
1415e3365e6cSdrh ** its initial value is NULL.  If the (...) does not remain constant
1416e3365e6cSdrh ** for the duration of the query (i.e. the SELECT within the (...)
1417b74b1017Sdrh ** is a correlated subquery) then the value of the allocated register is
1418e3365e6cSdrh ** reset to NULL each time the subquery is rerun. This allows the
1419b74b1017Sdrh ** caller to use vdbe code equivalent to the following:
14200cdc022eSdanielk1977 **
14210cdc022eSdanielk1977 **   if( register==NULL ){
14220cdc022eSdanielk1977 **     has_null = <test if data structure contains null>
14230cdc022eSdanielk1977 **     register = 1
14240cdc022eSdanielk1977 **   }
14250cdc022eSdanielk1977 **
14260cdc022eSdanielk1977 ** in order to avoid running the <test if data structure contains null>
14270cdc022eSdanielk1977 ** test more often than is necessary.
14289a96b668Sdanielk1977 */
1429284f4acaSdanielk1977 #ifndef SQLITE_OMIT_SUBQUERY
14300cdc022eSdanielk1977 int sqlite3FindInIndex(Parse *pParse, Expr *pX, int *prNotFound){
1431b74b1017Sdrh   Select *p;                            /* SELECT to the right of IN operator */
1432b74b1017Sdrh   int eType = 0;                        /* Type of RHS table. IN_INDEX_* */
1433b74b1017Sdrh   int iTab = pParse->nTab++;            /* Cursor of the RHS table */
1434b74b1017Sdrh   int mustBeUnique = (prNotFound==0);   /* True if RHS must be unique */
14359a96b668Sdanielk1977 
14361450bc6eSdrh   assert( pX->op==TK_IN );
14371450bc6eSdrh 
1438b74b1017Sdrh   /* Check to see if an existing table or index can be used to
1439b74b1017Sdrh   ** satisfy the query.  This is preferable to generating a new
1440b74b1017Sdrh   ** ephemeral table.
14419a96b668Sdanielk1977   */
14426ab3a2ecSdanielk1977   p = (ExprHasProperty(pX, EP_xIsSelect) ? pX->x.pSelect : 0);
1443fd773cf9Sdrh   if( ALWAYS(pParse->nErr==0) && isCandidateForInOpt(p) ){
1444e1fb65a0Sdanielk1977     sqlite3 *db = pParse->db;              /* Database connection */
1445e1fb65a0Sdanielk1977     Expr *pExpr = p->pEList->a[0].pExpr;   /* Expression <column> */
1446e1fb65a0Sdanielk1977     int iCol = pExpr->iColumn;             /* Index of column <column> */
1447e1fb65a0Sdanielk1977     Vdbe *v = sqlite3GetVdbe(pParse);      /* Virtual machine being coded */
1448e1fb65a0Sdanielk1977     Table *pTab = p->pSrc->a[0].pTab;      /* Table <table>. */
1449e1fb65a0Sdanielk1977     int iDb;                               /* Database idx for pTab */
1450e1fb65a0Sdanielk1977 
1451e1fb65a0Sdanielk1977     /* Code an OP_VerifyCookie and OP_TableLock for <table>. */
1452e1fb65a0Sdanielk1977     iDb = sqlite3SchemaToIndex(db, pTab->pSchema);
1453e1fb65a0Sdanielk1977     sqlite3CodeVerifySchema(pParse, iDb);
1454e1fb65a0Sdanielk1977     sqlite3TableLock(pParse, iDb, pTab->tnum, 0, pTab->zName);
14559a96b668Sdanielk1977 
14569a96b668Sdanielk1977     /* This function is only called from two places. In both cases the vdbe
14579a96b668Sdanielk1977     ** has already been allocated. So assume sqlite3GetVdbe() is always
14589a96b668Sdanielk1977     ** successful here.
14599a96b668Sdanielk1977     */
14609a96b668Sdanielk1977     assert(v);
14619a96b668Sdanielk1977     if( iCol<0 ){
14620a07c107Sdrh       int iMem = ++pParse->nMem;
14639a96b668Sdanielk1977       int iAddr;
14649a96b668Sdanielk1977 
146548f2d3b1Sdrh       iAddr = sqlite3VdbeAddOp1(v, OP_Once, iMem);
14669a96b668Sdanielk1977 
14679a96b668Sdanielk1977       sqlite3OpenTable(pParse, iTab, iDb, pTab, OP_OpenRead);
14689a96b668Sdanielk1977       eType = IN_INDEX_ROWID;
14699a96b668Sdanielk1977 
14709a96b668Sdanielk1977       sqlite3VdbeJumpHere(v, iAddr);
14719a96b668Sdanielk1977     }else{
1472e1fb65a0Sdanielk1977       Index *pIdx;                         /* Iterator variable */
1473e1fb65a0Sdanielk1977 
14749a96b668Sdanielk1977       /* The collation sequence used by the comparison. If an index is to
14759a96b668Sdanielk1977       ** be used in place of a temp-table, it must be ordered according
1476e1fb65a0Sdanielk1977       ** to this collation sequence.  */
14779a96b668Sdanielk1977       CollSeq *pReq = sqlite3BinaryCompareCollSeq(pParse, pX->pLeft, pExpr);
14789a96b668Sdanielk1977 
14799a96b668Sdanielk1977       /* Check that the affinity that will be used to perform the
14809a96b668Sdanielk1977       ** comparison is the same as the affinity of the column. If
14819a96b668Sdanielk1977       ** it is not, it is not possible to use any index.
14829a96b668Sdanielk1977       */
14839a96b668Sdanielk1977       char aff = comparisonAffinity(pX);
14849a96b668Sdanielk1977       int affinity_ok = (pTab->aCol[iCol].affinity==aff||aff==SQLITE_AFF_NONE);
14859a96b668Sdanielk1977 
14869a96b668Sdanielk1977       for(pIdx=pTab->pIndex; pIdx && eType==0 && affinity_ok; pIdx=pIdx->pNext){
14879a96b668Sdanielk1977         if( (pIdx->aiColumn[0]==iCol)
1488b74b1017Sdrh          && sqlite3FindCollSeq(db, ENC(db), pIdx->azColl[0], 0)==pReq
14899a96b668Sdanielk1977          && (!mustBeUnique || (pIdx->nColumn==1 && pIdx->onError!=OE_None))
14909a96b668Sdanielk1977         ){
14910a07c107Sdrh           int iMem = ++pParse->nMem;
14929a96b668Sdanielk1977           int iAddr;
14939a96b668Sdanielk1977           char *pKey;
14949a96b668Sdanielk1977 
14959a96b668Sdanielk1977           pKey = (char *)sqlite3IndexKeyinfo(pParse, pIdx);
149648f2d3b1Sdrh           iAddr = sqlite3VdbeAddOp1(v, OP_Once, iMem);
14979a96b668Sdanielk1977 
1498207872a4Sdanielk1977           sqlite3VdbeAddOp4(v, OP_OpenRead, iTab, pIdx->tnum, iDb,
149966a5167bSdrh                                pKey,P4_KEYINFO_HANDOFF);
1500207872a4Sdanielk1977           VdbeComment((v, "%s", pIdx->zName));
15019a96b668Sdanielk1977           eType = IN_INDEX_INDEX;
15029a96b668Sdanielk1977 
15039a96b668Sdanielk1977           sqlite3VdbeJumpHere(v, iAddr);
15040cdc022eSdanielk1977           if( prNotFound && !pTab->aCol[iCol].notNull ){
15050cdc022eSdanielk1977             *prNotFound = ++pParse->nMem;
15060cdc022eSdanielk1977           }
15079a96b668Sdanielk1977         }
15089a96b668Sdanielk1977       }
15099a96b668Sdanielk1977     }
15109a96b668Sdanielk1977   }
15119a96b668Sdanielk1977 
15129a96b668Sdanielk1977   if( eType==0 ){
15131450bc6eSdrh     /* Could not found an existing table or index to use as the RHS b-tree.
1514b74b1017Sdrh     ** We will have to generate an ephemeral table to do the job.
1515b74b1017Sdrh     */
1516cf4d38aaSdrh     double savedNQueryLoop = pParse->nQueryLoop;
15170cdc022eSdanielk1977     int rMayHaveNull = 0;
151841a05b7bSdanielk1977     eType = IN_INDEX_EPH;
15190cdc022eSdanielk1977     if( prNotFound ){
15200cdc022eSdanielk1977       *prNotFound = rMayHaveNull = ++pParse->nMem;
1521cf4d38aaSdrh     }else{
1522cf4d38aaSdrh       testcase( pParse->nQueryLoop>(double)1 );
1523cf4d38aaSdrh       pParse->nQueryLoop = (double)1;
1524cf4d38aaSdrh       if( pX->pLeft->iColumn<0 && !ExprHasAnyProperty(pX, EP_xIsSelect) ){
152541a05b7bSdanielk1977         eType = IN_INDEX_ROWID;
15260cdc022eSdanielk1977       }
1527cf4d38aaSdrh     }
152841a05b7bSdanielk1977     sqlite3CodeSubselect(pParse, pX, rMayHaveNull, eType==IN_INDEX_ROWID);
1529cf4d38aaSdrh     pParse->nQueryLoop = savedNQueryLoop;
15309a96b668Sdanielk1977   }else{
15319a96b668Sdanielk1977     pX->iTable = iTab;
15329a96b668Sdanielk1977   }
15339a96b668Sdanielk1977   return eType;
15349a96b668Sdanielk1977 }
1535284f4acaSdanielk1977 #endif
1536626a879aSdrh 
1537626a879aSdrh /*
1538d4187c71Sdrh ** Generate code for scalar subqueries used as a subquery expression, EXISTS,
1539d4187c71Sdrh ** or IN operators.  Examples:
1540626a879aSdrh **
15419cbe6352Sdrh **     (SELECT a FROM b)          -- subquery
15429cbe6352Sdrh **     EXISTS (SELECT a FROM b)   -- EXISTS subquery
15439cbe6352Sdrh **     x IN (4,5,11)              -- IN operator with list on right-hand side
15449cbe6352Sdrh **     x IN (SELECT a FROM b)     -- IN operator with subquery on the right
1545fef5208cSdrh **
15469cbe6352Sdrh ** The pExpr parameter describes the expression that contains the IN
15479cbe6352Sdrh ** operator or subquery.
154841a05b7bSdanielk1977 **
154941a05b7bSdanielk1977 ** If parameter isRowid is non-zero, then expression pExpr is guaranteed
155041a05b7bSdanielk1977 ** to be of the form "<rowid> IN (?, ?, ?)", where <rowid> is a reference
155141a05b7bSdanielk1977 ** to some integer key column of a table B-Tree. In this case, use an
155241a05b7bSdanielk1977 ** intkey B-Tree to store the set of IN(...) values instead of the usual
155341a05b7bSdanielk1977 ** (slower) variable length keys B-Tree.
1554fd773cf9Sdrh **
1555fd773cf9Sdrh ** If rMayHaveNull is non-zero, that means that the operation is an IN
1556fd773cf9Sdrh ** (not a SELECT or EXISTS) and that the RHS might contains NULLs.
1557fd773cf9Sdrh ** Furthermore, the IN is in a WHERE clause and that we really want
1558fd773cf9Sdrh ** to iterate over the RHS of the IN operator in order to quickly locate
1559fd773cf9Sdrh ** all corresponding LHS elements.  All this routine does is initialize
1560fd773cf9Sdrh ** the register given by rMayHaveNull to NULL.  Calling routines will take
1561fd773cf9Sdrh ** care of changing this register value to non-NULL if the RHS is NULL-free.
1562fd773cf9Sdrh **
1563fd773cf9Sdrh ** If rMayHaveNull is zero, that means that the subquery is being used
1564fd773cf9Sdrh ** for membership testing only.  There is no need to initialize any
1565fd773cf9Sdrh ** registers to indicate the presense or absence of NULLs on the RHS.
15661450bc6eSdrh **
15671450bc6eSdrh ** For a SELECT or EXISTS operator, return the register that holds the
15681450bc6eSdrh ** result.  For IN operators or if an error occurs, the return value is 0.
1569cce7d176Sdrh */
157051522cd3Sdrh #ifndef SQLITE_OMIT_SUBQUERY
15711450bc6eSdrh int sqlite3CodeSubselect(
1572fd773cf9Sdrh   Parse *pParse,          /* Parsing context */
1573fd773cf9Sdrh   Expr *pExpr,            /* The IN, SELECT, or EXISTS operator */
1574fd773cf9Sdrh   int rMayHaveNull,       /* Register that records whether NULLs exist in RHS */
1575fd773cf9Sdrh   int isRowid             /* If true, LHS of IN operator is a rowid */
157641a05b7bSdanielk1977 ){
1577*dfd2d9f6Sdrh   int testAddr = -1;                      /* One-time test address */
15781450bc6eSdrh   int rReg = 0;                           /* Register storing resulting */
1579b3bce662Sdanielk1977   Vdbe *v = sqlite3GetVdbe(pParse);
15801450bc6eSdrh   if( NEVER(v==0) ) return 0;
1581ceea3321Sdrh   sqlite3ExprCachePush(pParse);
1582fc976065Sdanielk1977 
158357dbd7b3Sdrh   /* This code must be run in its entirety every time it is encountered
158457dbd7b3Sdrh   ** if any of the following is true:
158557dbd7b3Sdrh   **
158657dbd7b3Sdrh   **    *  The right-hand side is a correlated subquery
158757dbd7b3Sdrh   **    *  The right-hand side is an expression list containing variables
158857dbd7b3Sdrh   **    *  We are inside a trigger
158957dbd7b3Sdrh   **
159057dbd7b3Sdrh   ** If all of the above are false, then we can run this code just once
159157dbd7b3Sdrh   ** save the results, and reuse the same result on subsequent invocations.
1592b3bce662Sdanielk1977   */
1593165921a7Sdan   if( !ExprHasAnyProperty(pExpr, EP_VarSelect) && !pParse->pTriggerTab ){
15940a07c107Sdrh     int mem = ++pParse->nMem;
159548f2d3b1Sdrh     testAddr = sqlite3VdbeAddOp1(v, OP_Once, mem);
1596b3bce662Sdanielk1977   }
1597b3bce662Sdanielk1977 
15984a07e3dbSdan #ifndef SQLITE_OMIT_EXPLAIN
15994a07e3dbSdan   if( pParse->explain==2 ){
16004a07e3dbSdan     char *zMsg = sqlite3MPrintf(
1601*dfd2d9f6Sdrh         pParse->db, "EXECUTE %s%s SUBQUERY %d", testAddr>=0?"":"CORRELATED ",
16024a07e3dbSdan         pExpr->op==TK_IN?"LIST":"SCALAR", pParse->iNextSelectId
16034a07e3dbSdan     );
16044a07e3dbSdan     sqlite3VdbeAddOp4(v, OP_Explain, pParse->iSelectId, 0, 0, zMsg, P4_DYNAMIC);
16054a07e3dbSdan   }
16064a07e3dbSdan #endif
16074a07e3dbSdan 
1608cce7d176Sdrh   switch( pExpr->op ){
1609fef5208cSdrh     case TK_IN: {
1610d4187c71Sdrh       char affinity;              /* Affinity of the LHS of the IN */
1611d4187c71Sdrh       KeyInfo keyInfo;            /* Keyinfo for the generated table */
1612b9bb7c18Sdrh       int addr;                   /* Address of OP_OpenEphemeral instruction */
1613d4187c71Sdrh       Expr *pLeft = pExpr->pLeft; /* the LHS of the IN operator */
1614d3d39e93Sdrh 
16150cdc022eSdanielk1977       if( rMayHaveNull ){
16160cdc022eSdanielk1977         sqlite3VdbeAddOp2(v, OP_Null, 0, rMayHaveNull);
16170cdc022eSdanielk1977       }
16180cdc022eSdanielk1977 
161941a05b7bSdanielk1977       affinity = sqlite3ExprAffinity(pLeft);
1620e014a838Sdanielk1977 
1621e014a838Sdanielk1977       /* Whether this is an 'x IN(SELECT...)' or an 'x IN(<exprlist>)'
16228cff69dfSdrh       ** expression it is handled the same way.  An ephemeral table is
1623e014a838Sdanielk1977       ** filled with single-field index keys representing the results
1624e014a838Sdanielk1977       ** from the SELECT or the <exprlist>.
1625fef5208cSdrh       **
1626e014a838Sdanielk1977       ** If the 'x' expression is a column value, or the SELECT...
1627e014a838Sdanielk1977       ** statement returns a column value, then the affinity of that
1628e014a838Sdanielk1977       ** column is used to build the index keys. If both 'x' and the
1629e014a838Sdanielk1977       ** SELECT... statement are columns, then numeric affinity is used
1630e014a838Sdanielk1977       ** if either column has NUMERIC or INTEGER affinity. If neither
1631e014a838Sdanielk1977       ** 'x' nor the SELECT... statement are columns, then numeric affinity
1632e014a838Sdanielk1977       ** is used.
1633fef5208cSdrh       */
1634832508b7Sdrh       pExpr->iTable = pParse->nTab++;
163541a05b7bSdanielk1977       addr = sqlite3VdbeAddOp2(v, OP_OpenEphemeral, pExpr->iTable, !isRowid);
1636d4187c71Sdrh       if( rMayHaveNull==0 ) sqlite3VdbeChangeP5(v, BTREE_UNORDERED);
1637d3d39e93Sdrh       memset(&keyInfo, 0, sizeof(keyInfo));
1638d3d39e93Sdrh       keyInfo.nField = 1;
1639e014a838Sdanielk1977 
16406ab3a2ecSdanielk1977       if( ExprHasProperty(pExpr, EP_xIsSelect) ){
1641e014a838Sdanielk1977         /* Case 1:     expr IN (SELECT ...)
1642e014a838Sdanielk1977         **
1643e014a838Sdanielk1977         ** Generate code to write the results of the select into the temporary
1644e014a838Sdanielk1977         ** table allocated and opened above.
1645e014a838Sdanielk1977         */
16461013c932Sdrh         SelectDest dest;
1647be5c89acSdrh         ExprList *pEList;
16481013c932Sdrh 
164941a05b7bSdanielk1977         assert( !isRowid );
16501013c932Sdrh         sqlite3SelectDestInit(&dest, SRT_Set, pExpr->iTable);
16511bd10f8aSdrh         dest.affinity = (u8)affinity;
1652e014a838Sdanielk1977         assert( (pExpr->iTable&0x0000FFFF)==pExpr->iTable );
165348b5b041Sdrh         pExpr->x.pSelect->iLimit = 0;
16546ab3a2ecSdanielk1977         if( sqlite3Select(pParse, pExpr->x.pSelect, &dest) ){
16551450bc6eSdrh           return 0;
165694ccde58Sdrh         }
16576ab3a2ecSdanielk1977         pEList = pExpr->x.pSelect->pEList;
1658fd773cf9Sdrh         if( ALWAYS(pEList!=0 && pEList->nExpr>0) ){
1659bcbb04e5Sdanielk1977           keyInfo.aColl[0] = sqlite3BinaryCompareCollSeq(pParse, pExpr->pLeft,
1660be5c89acSdrh               pEList->a[0].pExpr);
16610202b29eSdanielk1977         }
1662a7d2db17Sdrh       }else if( ALWAYS(pExpr->x.pList!=0) ){
1663fef5208cSdrh         /* Case 2:     expr IN (exprlist)
1664fef5208cSdrh         **
1665e014a838Sdanielk1977         ** For each expression, build an index key from the evaluation and
1666e014a838Sdanielk1977         ** store it in the temporary table. If <expr> is a column, then use
1667e014a838Sdanielk1977         ** that columns affinity when building index keys. If <expr> is not
1668e014a838Sdanielk1977         ** a column, use numeric affinity.
1669fef5208cSdrh         */
1670e014a838Sdanielk1977         int i;
16716ab3a2ecSdanielk1977         ExprList *pList = pExpr->x.pList;
167257dbd7b3Sdrh         struct ExprList_item *pItem;
1673ecc31805Sdrh         int r1, r2, r3;
167457dbd7b3Sdrh 
1675e014a838Sdanielk1977         if( !affinity ){
16768159a35fSdrh           affinity = SQLITE_AFF_NONE;
1677e014a838Sdanielk1977         }
16787d10d5a6Sdrh         keyInfo.aColl[0] = sqlite3ExprCollSeq(pParse, pExpr->pLeft);
1679e014a838Sdanielk1977 
1680e014a838Sdanielk1977         /* Loop through each expression in <exprlist>. */
16812d401ab8Sdrh         r1 = sqlite3GetTempReg(pParse);
16822d401ab8Sdrh         r2 = sqlite3GetTempReg(pParse);
16834e7f36a2Sdanielk1977         sqlite3VdbeAddOp2(v, OP_Null, 0, r2);
168457dbd7b3Sdrh         for(i=pList->nExpr, pItem=pList->a; i>0; i--, pItem++){
168557dbd7b3Sdrh           Expr *pE2 = pItem->pExpr;
1686e05c929bSdrh           int iValToIns;
1687e014a838Sdanielk1977 
168857dbd7b3Sdrh           /* If the expression is not constant then we will need to
168957dbd7b3Sdrh           ** disable the test that was generated above that makes sure
169057dbd7b3Sdrh           ** this code only executes once.  Because for a non-constant
169157dbd7b3Sdrh           ** expression we need to rerun this code each time.
169257dbd7b3Sdrh           */
1693*dfd2d9f6Sdrh           if( testAddr>=0 && !sqlite3ExprIsConstant(pE2) ){
169448f2d3b1Sdrh             sqlite3VdbeChangeToNoop(v, testAddr);
1695*dfd2d9f6Sdrh             testAddr = -1;
16964794b980Sdrh           }
1697e014a838Sdanielk1977 
1698e014a838Sdanielk1977           /* Evaluate the expression and insert it into the temp table */
1699e05c929bSdrh           if( isRowid && sqlite3ExprIsInteger(pE2, &iValToIns) ){
1700e05c929bSdrh             sqlite3VdbeAddOp3(v, OP_InsertInt, pExpr->iTable, r2, iValToIns);
1701e05c929bSdrh           }else{
1702ecc31805Sdrh             r3 = sqlite3ExprCodeTarget(pParse, pE2, r1);
170341a05b7bSdanielk1977             if( isRowid ){
1704e05c929bSdrh               sqlite3VdbeAddOp2(v, OP_MustBeInt, r3,
1705e05c929bSdrh                                 sqlite3VdbeCurrentAddr(v)+2);
170641a05b7bSdanielk1977               sqlite3VdbeAddOp3(v, OP_Insert, pExpr->iTable, r2, r3);
170741a05b7bSdanielk1977             }else{
1708ecc31805Sdrh               sqlite3VdbeAddOp4(v, OP_MakeRecord, r3, 1, r2, &affinity, 1);
17093c31fc23Sdrh               sqlite3ExprCacheAffinityChange(pParse, r3, 1);
17102d401ab8Sdrh               sqlite3VdbeAddOp2(v, OP_IdxInsert, pExpr->iTable, r2);
1711fef5208cSdrh             }
171241a05b7bSdanielk1977           }
1713e05c929bSdrh         }
17142d401ab8Sdrh         sqlite3ReleaseTempReg(pParse, r1);
17152d401ab8Sdrh         sqlite3ReleaseTempReg(pParse, r2);
1716fef5208cSdrh       }
171741a05b7bSdanielk1977       if( !isRowid ){
171866a5167bSdrh         sqlite3VdbeChangeP4(v, addr, (void *)&keyInfo, P4_KEYINFO);
171941a05b7bSdanielk1977       }
1720b3bce662Sdanielk1977       break;
1721fef5208cSdrh     }
1722fef5208cSdrh 
172351522cd3Sdrh     case TK_EXISTS:
1724fd773cf9Sdrh     case TK_SELECT:
1725fd773cf9Sdrh     default: {
1726fd773cf9Sdrh       /* If this has to be a scalar SELECT.  Generate code to put the
1727fef5208cSdrh       ** value of this select in a memory cell and record the number
1728fd773cf9Sdrh       ** of the memory cell in iColumn.  If this is an EXISTS, write
1729fd773cf9Sdrh       ** an integer 0 (not exists) or 1 (exists) into a memory cell
1730fd773cf9Sdrh       ** and record that memory cell in iColumn.
1731fef5208cSdrh       */
1732fd773cf9Sdrh       Select *pSel;                         /* SELECT statement to encode */
1733fd773cf9Sdrh       SelectDest dest;                      /* How to deal with SELECt result */
17341398ad36Sdrh 
1735cf697396Sshane       testcase( pExpr->op==TK_EXISTS );
1736cf697396Sshane       testcase( pExpr->op==TK_SELECT );
1737cf697396Sshane       assert( pExpr->op==TK_EXISTS || pExpr->op==TK_SELECT );
1738cf697396Sshane 
17396ab3a2ecSdanielk1977       assert( ExprHasProperty(pExpr, EP_xIsSelect) );
17406ab3a2ecSdanielk1977       pSel = pExpr->x.pSelect;
17411013c932Sdrh       sqlite3SelectDestInit(&dest, 0, ++pParse->nMem);
174251522cd3Sdrh       if( pExpr->op==TK_SELECT ){
17436c8c8ce0Sdanielk1977         dest.eDest = SRT_Mem;
17444c583128Sdrh         sqlite3VdbeAddOp2(v, OP_Null, 0, dest.iParm);
1745d4e70ebdSdrh         VdbeComment((v, "Init subquery result"));
174651522cd3Sdrh       }else{
17476c8c8ce0Sdanielk1977         dest.eDest = SRT_Exists;
17484c583128Sdrh         sqlite3VdbeAddOp2(v, OP_Integer, 0, dest.iParm);
1749d4e70ebdSdrh         VdbeComment((v, "Init EXISTS result"));
175051522cd3Sdrh       }
1751633e6d57Sdrh       sqlite3ExprDelete(pParse->db, pSel->pLimit);
1752094430ebSdrh       pSel->pLimit = sqlite3PExpr(pParse, TK_INTEGER, 0, 0,
1753094430ebSdrh                                   &sqlite3IntTokens[1]);
175448b5b041Sdrh       pSel->iLimit = 0;
17557d10d5a6Sdrh       if( sqlite3Select(pParse, pSel, &dest) ){
17561450bc6eSdrh         return 0;
175794ccde58Sdrh       }
17581450bc6eSdrh       rReg = dest.iParm;
175933e619fcSdrh       ExprSetIrreducible(pExpr);
1760b3bce662Sdanielk1977       break;
176119a775c2Sdrh     }
1762cce7d176Sdrh   }
1763b3bce662Sdanielk1977 
1764*dfd2d9f6Sdrh   if( testAddr>=0 ){
176548f2d3b1Sdrh     sqlite3VdbeJumpHere(v, testAddr);
1766b3bce662Sdanielk1977   }
1767ceea3321Sdrh   sqlite3ExprCachePop(pParse, 1);
1768fc976065Sdanielk1977 
17691450bc6eSdrh   return rReg;
1770cce7d176Sdrh }
177151522cd3Sdrh #endif /* SQLITE_OMIT_SUBQUERY */
1772cce7d176Sdrh 
1773e3365e6cSdrh #ifndef SQLITE_OMIT_SUBQUERY
1774e3365e6cSdrh /*
1775e3365e6cSdrh ** Generate code for an IN expression.
1776e3365e6cSdrh **
1777e3365e6cSdrh **      x IN (SELECT ...)
1778e3365e6cSdrh **      x IN (value, value, ...)
1779e3365e6cSdrh **
1780e3365e6cSdrh ** The left-hand side (LHS) is a scalar expression.  The right-hand side (RHS)
1781e3365e6cSdrh ** is an array of zero or more values.  The expression is true if the LHS is
1782e3365e6cSdrh ** contained within the RHS.  The value of the expression is unknown (NULL)
1783e3365e6cSdrh ** if the LHS is NULL or if the LHS is not contained within the RHS and the
1784e3365e6cSdrh ** RHS contains one or more NULL values.
1785e3365e6cSdrh **
1786e3365e6cSdrh ** This routine generates code will jump to destIfFalse if the LHS is not
1787e3365e6cSdrh ** contained within the RHS.  If due to NULLs we cannot determine if the LHS
1788e3365e6cSdrh ** is contained in the RHS then jump to destIfNull.  If the LHS is contained
1789e3365e6cSdrh ** within the RHS then fall through.
1790e3365e6cSdrh */
1791e3365e6cSdrh static void sqlite3ExprCodeIN(
1792e3365e6cSdrh   Parse *pParse,        /* Parsing and code generating context */
1793e3365e6cSdrh   Expr *pExpr,          /* The IN expression */
1794e3365e6cSdrh   int destIfFalse,      /* Jump here if LHS is not contained in the RHS */
1795e3365e6cSdrh   int destIfNull        /* Jump here if the results are unknown due to NULLs */
1796e3365e6cSdrh ){
1797e3365e6cSdrh   int rRhsHasNull = 0;  /* Register that is true if RHS contains NULL values */
1798e3365e6cSdrh   char affinity;        /* Comparison affinity to use */
1799e3365e6cSdrh   int eType;            /* Type of the RHS */
1800e3365e6cSdrh   int r1;               /* Temporary use register */
1801e3365e6cSdrh   Vdbe *v;              /* Statement under construction */
1802e3365e6cSdrh 
1803e3365e6cSdrh   /* Compute the RHS.   After this step, the table with cursor
1804e3365e6cSdrh   ** pExpr->iTable will contains the values that make up the RHS.
1805e3365e6cSdrh   */
1806e3365e6cSdrh   v = pParse->pVdbe;
1807e3365e6cSdrh   assert( v!=0 );       /* OOM detected prior to this routine */
1808e3365e6cSdrh   VdbeNoopComment((v, "begin IN expr"));
1809e3365e6cSdrh   eType = sqlite3FindInIndex(pParse, pExpr, &rRhsHasNull);
1810e3365e6cSdrh 
1811e3365e6cSdrh   /* Figure out the affinity to use to create a key from the results
1812e3365e6cSdrh   ** of the expression. affinityStr stores a static string suitable for
1813e3365e6cSdrh   ** P4 of OP_MakeRecord.
1814e3365e6cSdrh   */
1815e3365e6cSdrh   affinity = comparisonAffinity(pExpr);
1816e3365e6cSdrh 
1817e3365e6cSdrh   /* Code the LHS, the <expr> from "<expr> IN (...)".
1818e3365e6cSdrh   */
1819e3365e6cSdrh   sqlite3ExprCachePush(pParse);
1820e3365e6cSdrh   r1 = sqlite3GetTempReg(pParse);
1821e3365e6cSdrh   sqlite3ExprCode(pParse, pExpr->pLeft, r1);
1822e3365e6cSdrh 
1823094430ebSdrh   /* If the LHS is NULL, then the result is either false or NULL depending
1824094430ebSdrh   ** on whether the RHS is empty or not, respectively.
1825094430ebSdrh   */
1826094430ebSdrh   if( destIfNull==destIfFalse ){
1827094430ebSdrh     /* Shortcut for the common case where the false and NULL outcomes are
1828094430ebSdrh     ** the same. */
1829094430ebSdrh     sqlite3VdbeAddOp2(v, OP_IsNull, r1, destIfNull);
1830094430ebSdrh   }else{
1831094430ebSdrh     int addr1 = sqlite3VdbeAddOp1(v, OP_NotNull, r1);
1832094430ebSdrh     sqlite3VdbeAddOp2(v, OP_Rewind, pExpr->iTable, destIfFalse);
1833094430ebSdrh     sqlite3VdbeAddOp2(v, OP_Goto, 0, destIfNull);
1834094430ebSdrh     sqlite3VdbeJumpHere(v, addr1);
1835094430ebSdrh   }
1836e3365e6cSdrh 
1837e3365e6cSdrh   if( eType==IN_INDEX_ROWID ){
1838e3365e6cSdrh     /* In this case, the RHS is the ROWID of table b-tree
1839e3365e6cSdrh     */
1840e3365e6cSdrh     sqlite3VdbeAddOp2(v, OP_MustBeInt, r1, destIfFalse);
1841e3365e6cSdrh     sqlite3VdbeAddOp3(v, OP_NotExists, pExpr->iTable, destIfFalse, r1);
1842e3365e6cSdrh   }else{
1843e3365e6cSdrh     /* In this case, the RHS is an index b-tree.
1844e3365e6cSdrh     */
18458cff69dfSdrh     sqlite3VdbeAddOp4(v, OP_Affinity, r1, 1, 0, &affinity, 1);
1846e3365e6cSdrh 
1847e3365e6cSdrh     /* If the set membership test fails, then the result of the
1848e3365e6cSdrh     ** "x IN (...)" expression must be either 0 or NULL. If the set
1849e3365e6cSdrh     ** contains no NULL values, then the result is 0. If the set
1850e3365e6cSdrh     ** contains one or more NULL values, then the result of the
1851e3365e6cSdrh     ** expression is also NULL.
1852e3365e6cSdrh     */
1853e3365e6cSdrh     if( rRhsHasNull==0 || destIfFalse==destIfNull ){
1854e3365e6cSdrh       /* This branch runs if it is known at compile time that the RHS
1855e3365e6cSdrh       ** cannot contain NULL values. This happens as the result
1856e3365e6cSdrh       ** of a "NOT NULL" constraint in the database schema.
1857e3365e6cSdrh       **
1858e3365e6cSdrh       ** Also run this branch if NULL is equivalent to FALSE
1859e3365e6cSdrh       ** for this particular IN operator.
1860e3365e6cSdrh       */
18618cff69dfSdrh       sqlite3VdbeAddOp4Int(v, OP_NotFound, pExpr->iTable, destIfFalse, r1, 1);
1862e3365e6cSdrh 
1863e3365e6cSdrh     }else{
1864e3365e6cSdrh       /* In this branch, the RHS of the IN might contain a NULL and
1865e3365e6cSdrh       ** the presence of a NULL on the RHS makes a difference in the
1866e3365e6cSdrh       ** outcome.
1867e3365e6cSdrh       */
1868e3365e6cSdrh       int j1, j2, j3;
1869e3365e6cSdrh 
1870e3365e6cSdrh       /* First check to see if the LHS is contained in the RHS.  If so,
1871e3365e6cSdrh       ** then the presence of NULLs in the RHS does not matter, so jump
1872e3365e6cSdrh       ** over all of the code that follows.
1873e3365e6cSdrh       */
18748cff69dfSdrh       j1 = sqlite3VdbeAddOp4Int(v, OP_Found, pExpr->iTable, 0, r1, 1);
1875e3365e6cSdrh 
1876e3365e6cSdrh       /* Here we begin generating code that runs if the LHS is not
1877e3365e6cSdrh       ** contained within the RHS.  Generate additional code that
1878e3365e6cSdrh       ** tests the RHS for NULLs.  If the RHS contains a NULL then
1879e3365e6cSdrh       ** jump to destIfNull.  If there are no NULLs in the RHS then
1880e3365e6cSdrh       ** jump to destIfFalse.
1881e3365e6cSdrh       */
1882e3365e6cSdrh       j2 = sqlite3VdbeAddOp1(v, OP_NotNull, rRhsHasNull);
18838cff69dfSdrh       j3 = sqlite3VdbeAddOp4Int(v, OP_Found, pExpr->iTable, 0, rRhsHasNull, 1);
1884e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Integer, -1, rRhsHasNull);
1885e3365e6cSdrh       sqlite3VdbeJumpHere(v, j3);
1886e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_AddImm, rRhsHasNull, 1);
1887e3365e6cSdrh       sqlite3VdbeJumpHere(v, j2);
1888e3365e6cSdrh 
1889e3365e6cSdrh       /* Jump to the appropriate target depending on whether or not
1890e3365e6cSdrh       ** the RHS contains a NULL
1891e3365e6cSdrh       */
1892e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_If, rRhsHasNull, destIfNull);
1893e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Goto, 0, destIfFalse);
1894e3365e6cSdrh 
1895e3365e6cSdrh       /* The OP_Found at the top of this branch jumps here when true,
1896e3365e6cSdrh       ** causing the overall IN expression evaluation to fall through.
1897e3365e6cSdrh       */
1898e3365e6cSdrh       sqlite3VdbeJumpHere(v, j1);
1899e3365e6cSdrh     }
1900e3365e6cSdrh   }
1901e3365e6cSdrh   sqlite3ReleaseTempReg(pParse, r1);
1902e3365e6cSdrh   sqlite3ExprCachePop(pParse, 1);
1903e3365e6cSdrh   VdbeComment((v, "end IN expr"));
1904e3365e6cSdrh }
1905e3365e6cSdrh #endif /* SQLITE_OMIT_SUBQUERY */
1906e3365e6cSdrh 
1907cce7d176Sdrh /*
1908598f1340Sdrh ** Duplicate an 8-byte value
1909598f1340Sdrh */
1910598f1340Sdrh static char *dup8bytes(Vdbe *v, const char *in){
1911598f1340Sdrh   char *out = sqlite3DbMallocRaw(sqlite3VdbeDb(v), 8);
1912598f1340Sdrh   if( out ){
1913598f1340Sdrh     memcpy(out, in, 8);
1914598f1340Sdrh   }
1915598f1340Sdrh   return out;
1916598f1340Sdrh }
1917598f1340Sdrh 
191813573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
1919598f1340Sdrh /*
1920598f1340Sdrh ** Generate an instruction that will put the floating point
19219cbf3425Sdrh ** value described by z[0..n-1] into register iMem.
19220cf19ed8Sdrh **
19230cf19ed8Sdrh ** The z[] string will probably not be zero-terminated.  But the
19240cf19ed8Sdrh ** z[n] character is guaranteed to be something that does not look
19250cf19ed8Sdrh ** like the continuation of the number.
1926598f1340Sdrh */
1927b7916a78Sdrh static void codeReal(Vdbe *v, const char *z, int negateFlag, int iMem){
1928fd773cf9Sdrh   if( ALWAYS(z!=0) ){
1929598f1340Sdrh     double value;
1930598f1340Sdrh     char *zV;
19319339da1fSdrh     sqlite3AtoF(z, &value, sqlite3Strlen30(z), SQLITE_UTF8);
1932d0015161Sdrh     assert( !sqlite3IsNaN(value) ); /* The new AtoF never returns NaN */
1933598f1340Sdrh     if( negateFlag ) value = -value;
1934598f1340Sdrh     zV = dup8bytes(v, (char*)&value);
19359de221dfSdrh     sqlite3VdbeAddOp4(v, OP_Real, 0, iMem, 0, zV, P4_REAL);
1936598f1340Sdrh   }
1937598f1340Sdrh }
193813573c71Sdrh #endif
1939598f1340Sdrh 
1940598f1340Sdrh 
1941598f1340Sdrh /*
1942fec19aadSdrh ** Generate an instruction that will put the integer describe by
19439cbf3425Sdrh ** text z[0..n-1] into register iMem.
19440cf19ed8Sdrh **
19455f1d6b61Sshaneh ** Expr.u.zToken is always UTF8 and zero-terminated.
1946fec19aadSdrh */
194713573c71Sdrh static void codeInteger(Parse *pParse, Expr *pExpr, int negFlag, int iMem){
194813573c71Sdrh   Vdbe *v = pParse->pVdbe;
194992b01d53Sdrh   if( pExpr->flags & EP_IntValue ){
195033e619fcSdrh     int i = pExpr->u.iValue;
1951d50ffc41Sdrh     assert( i>=0 );
195292b01d53Sdrh     if( negFlag ) i = -i;
195392b01d53Sdrh     sqlite3VdbeAddOp2(v, OP_Integer, i, iMem);
1954fd773cf9Sdrh   }else{
19555f1d6b61Sshaneh     int c;
19565f1d6b61Sshaneh     i64 value;
1957fd773cf9Sdrh     const char *z = pExpr->u.zToken;
1958fd773cf9Sdrh     assert( z!=0 );
19595f1d6b61Sshaneh     c = sqlite3Atoi64(z, &value, sqlite3Strlen30(z), SQLITE_UTF8);
19605f1d6b61Sshaneh     if( c==0 || (c==2 && negFlag) ){
1961598f1340Sdrh       char *zV;
1962158b9cb9Sdrh       if( negFlag ){ value = c==2 ? SMALLEST_INT64 : -value; }
1963598f1340Sdrh       zV = dup8bytes(v, (char*)&value);
19649de221dfSdrh       sqlite3VdbeAddOp4(v, OP_Int64, 0, iMem, 0, zV, P4_INT64);
1965fec19aadSdrh     }else{
196613573c71Sdrh #ifdef SQLITE_OMIT_FLOATING_POINT
196713573c71Sdrh       sqlite3ErrorMsg(pParse, "oversized integer: %s%s", negFlag ? "-" : "", z);
196813573c71Sdrh #else
1969b7916a78Sdrh       codeReal(v, z, negFlag, iMem);
197013573c71Sdrh #endif
1971fec19aadSdrh     }
1972fec19aadSdrh   }
1973c9cf901dSdanielk1977 }
1974fec19aadSdrh 
1975ceea3321Sdrh /*
1976ceea3321Sdrh ** Clear a cache entry.
1977ceea3321Sdrh */
1978ceea3321Sdrh static void cacheEntryClear(Parse *pParse, struct yColCache *p){
1979ceea3321Sdrh   if( p->tempReg ){
1980ceea3321Sdrh     if( pParse->nTempReg<ArraySize(pParse->aTempReg) ){
1981ceea3321Sdrh       pParse->aTempReg[pParse->nTempReg++] = p->iReg;
1982ceea3321Sdrh     }
1983ceea3321Sdrh     p->tempReg = 0;
1984ceea3321Sdrh   }
1985ceea3321Sdrh }
1986ceea3321Sdrh 
1987ceea3321Sdrh 
1988ceea3321Sdrh /*
1989ceea3321Sdrh ** Record in the column cache that a particular column from a
1990ceea3321Sdrh ** particular table is stored in a particular register.
1991ceea3321Sdrh */
1992ceea3321Sdrh void sqlite3ExprCacheStore(Parse *pParse, int iTab, int iCol, int iReg){
1993ceea3321Sdrh   int i;
1994ceea3321Sdrh   int minLru;
1995ceea3321Sdrh   int idxLru;
1996ceea3321Sdrh   struct yColCache *p;
1997ceea3321Sdrh 
199820411ea7Sdrh   assert( iReg>0 );  /* Register numbers are always positive */
199920411ea7Sdrh   assert( iCol>=-1 && iCol<32768 );  /* Finite column numbers */
200020411ea7Sdrh 
2001b6da74ebSdrh   /* The SQLITE_ColumnCache flag disables the column cache.  This is used
2002b6da74ebSdrh   ** for testing only - to verify that SQLite always gets the same answer
2003b6da74ebSdrh   ** with and without the column cache.
2004b6da74ebSdrh   */
2005b6da74ebSdrh   if( pParse->db->flags & SQLITE_ColumnCache ) return;
2006b6da74ebSdrh 
200727ee406eSdrh   /* First replace any existing entry.
200827ee406eSdrh   **
200927ee406eSdrh   ** Actually, the way the column cache is currently used, we are guaranteed
201027ee406eSdrh   ** that the object will never already be in cache.  Verify this guarantee.
201127ee406eSdrh   */
201227ee406eSdrh #ifndef NDEBUG
2013ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
201427ee406eSdrh #if 0 /* This code wold remove the entry from the cache if it existed */
2015ceea3321Sdrh     if( p->iReg && p->iTable==iTab && p->iColumn==iCol ){
2016ceea3321Sdrh       cacheEntryClear(pParse, p);
2017ceea3321Sdrh       p->iLevel = pParse->iCacheLevel;
2018ceea3321Sdrh       p->iReg = iReg;
2019ceea3321Sdrh       p->lru = pParse->iCacheCnt++;
2020ceea3321Sdrh       return;
2021ceea3321Sdrh     }
202227ee406eSdrh #endif
202327ee406eSdrh     assert( p->iReg==0 || p->iTable!=iTab || p->iColumn!=iCol );
2024ceea3321Sdrh   }
202527ee406eSdrh #endif
2026ceea3321Sdrh 
2027ceea3321Sdrh   /* Find an empty slot and replace it */
2028ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2029ceea3321Sdrh     if( p->iReg==0 ){
2030ceea3321Sdrh       p->iLevel = pParse->iCacheLevel;
2031ceea3321Sdrh       p->iTable = iTab;
2032ceea3321Sdrh       p->iColumn = iCol;
2033ceea3321Sdrh       p->iReg = iReg;
2034ceea3321Sdrh       p->tempReg = 0;
2035ceea3321Sdrh       p->lru = pParse->iCacheCnt++;
2036ceea3321Sdrh       return;
2037ceea3321Sdrh     }
2038ceea3321Sdrh   }
2039ceea3321Sdrh 
2040ceea3321Sdrh   /* Replace the last recently used */
2041ceea3321Sdrh   minLru = 0x7fffffff;
2042ceea3321Sdrh   idxLru = -1;
2043ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2044ceea3321Sdrh     if( p->lru<minLru ){
2045ceea3321Sdrh       idxLru = i;
2046ceea3321Sdrh       minLru = p->lru;
2047ceea3321Sdrh     }
2048ceea3321Sdrh   }
204920411ea7Sdrh   if( ALWAYS(idxLru>=0) ){
2050ceea3321Sdrh     p = &pParse->aColCache[idxLru];
2051ceea3321Sdrh     p->iLevel = pParse->iCacheLevel;
2052ceea3321Sdrh     p->iTable = iTab;
2053ceea3321Sdrh     p->iColumn = iCol;
2054ceea3321Sdrh     p->iReg = iReg;
2055ceea3321Sdrh     p->tempReg = 0;
2056ceea3321Sdrh     p->lru = pParse->iCacheCnt++;
2057ceea3321Sdrh     return;
2058ceea3321Sdrh   }
2059ceea3321Sdrh }
2060ceea3321Sdrh 
2061ceea3321Sdrh /*
2062f49f3523Sdrh ** Indicate that registers between iReg..iReg+nReg-1 are being overwritten.
2063f49f3523Sdrh ** Purge the range of registers from the column cache.
2064ceea3321Sdrh */
2065f49f3523Sdrh void sqlite3ExprCacheRemove(Parse *pParse, int iReg, int nReg){
2066ceea3321Sdrh   int i;
2067f49f3523Sdrh   int iLast = iReg + nReg - 1;
2068ceea3321Sdrh   struct yColCache *p;
2069ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2070f49f3523Sdrh     int r = p->iReg;
2071f49f3523Sdrh     if( r>=iReg && r<=iLast ){
2072ceea3321Sdrh       cacheEntryClear(pParse, p);
2073ceea3321Sdrh       p->iReg = 0;
2074ceea3321Sdrh     }
2075ceea3321Sdrh   }
2076ceea3321Sdrh }
2077ceea3321Sdrh 
2078ceea3321Sdrh /*
2079ceea3321Sdrh ** Remember the current column cache context.  Any new entries added
2080ceea3321Sdrh ** added to the column cache after this call are removed when the
2081ceea3321Sdrh ** corresponding pop occurs.
2082ceea3321Sdrh */
2083ceea3321Sdrh void sqlite3ExprCachePush(Parse *pParse){
2084ceea3321Sdrh   pParse->iCacheLevel++;
2085ceea3321Sdrh }
2086ceea3321Sdrh 
2087ceea3321Sdrh /*
2088ceea3321Sdrh ** Remove from the column cache any entries that were added since the
2089ceea3321Sdrh ** the previous N Push operations.  In other words, restore the cache
2090ceea3321Sdrh ** to the state it was in N Pushes ago.
2091ceea3321Sdrh */
2092ceea3321Sdrh void sqlite3ExprCachePop(Parse *pParse, int N){
2093ceea3321Sdrh   int i;
2094ceea3321Sdrh   struct yColCache *p;
2095ceea3321Sdrh   assert( N>0 );
2096ceea3321Sdrh   assert( pParse->iCacheLevel>=N );
2097ceea3321Sdrh   pParse->iCacheLevel -= N;
2098ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2099ceea3321Sdrh     if( p->iReg && p->iLevel>pParse->iCacheLevel ){
2100ceea3321Sdrh       cacheEntryClear(pParse, p);
2101ceea3321Sdrh       p->iReg = 0;
2102ceea3321Sdrh     }
2103ceea3321Sdrh   }
2104ceea3321Sdrh }
2105945498f3Sdrh 
2106945498f3Sdrh /*
21075cd79239Sdrh ** When a cached column is reused, make sure that its register is
21085cd79239Sdrh ** no longer available as a temp register.  ticket #3879:  that same
21095cd79239Sdrh ** register might be in the cache in multiple places, so be sure to
21105cd79239Sdrh ** get them all.
21115cd79239Sdrh */
21125cd79239Sdrh static void sqlite3ExprCachePinRegister(Parse *pParse, int iReg){
21135cd79239Sdrh   int i;
21145cd79239Sdrh   struct yColCache *p;
21155cd79239Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
21165cd79239Sdrh     if( p->iReg==iReg ){
21175cd79239Sdrh       p->tempReg = 0;
21185cd79239Sdrh     }
21195cd79239Sdrh   }
21205cd79239Sdrh }
21215cd79239Sdrh 
21225cd79239Sdrh /*
21235c092e8aSdrh ** Generate code to extract the value of the iCol-th column of a table.
21245c092e8aSdrh */
21255c092e8aSdrh void sqlite3ExprCodeGetColumnOfTable(
21265c092e8aSdrh   Vdbe *v,        /* The VDBE under construction */
21275c092e8aSdrh   Table *pTab,    /* The table containing the value */
21285c092e8aSdrh   int iTabCur,    /* The cursor for this table */
21295c092e8aSdrh   int iCol,       /* Index of the column to extract */
21305c092e8aSdrh   int regOut      /* Extract the valud into this register */
21315c092e8aSdrh ){
21325c092e8aSdrh   if( iCol<0 || iCol==pTab->iPKey ){
21335c092e8aSdrh     sqlite3VdbeAddOp2(v, OP_Rowid, iTabCur, regOut);
21345c092e8aSdrh   }else{
21355c092e8aSdrh     int op = IsVirtual(pTab) ? OP_VColumn : OP_Column;
21365c092e8aSdrh     sqlite3VdbeAddOp3(v, op, iTabCur, iCol, regOut);
21375c092e8aSdrh   }
21385c092e8aSdrh   if( iCol>=0 ){
21395c092e8aSdrh     sqlite3ColumnDefault(v, pTab, iCol, regOut);
21405c092e8aSdrh   }
21415c092e8aSdrh }
21425c092e8aSdrh 
21435c092e8aSdrh /*
2144945498f3Sdrh ** Generate code that will extract the iColumn-th column from
2145e55cbd72Sdrh ** table pTab and store the column value in a register.  An effort
2146e55cbd72Sdrh ** is made to store the column value in register iReg, but this is
2147e55cbd72Sdrh ** not guaranteed.  The location of the column value is returned.
2148e55cbd72Sdrh **
2149e55cbd72Sdrh ** There must be an open cursor to pTab in iTable when this routine
2150e55cbd72Sdrh ** is called.  If iColumn<0 then code is generated that extracts the rowid.
2151945498f3Sdrh */
2152e55cbd72Sdrh int sqlite3ExprCodeGetColumn(
2153e55cbd72Sdrh   Parse *pParse,   /* Parsing and code generating context */
21542133d822Sdrh   Table *pTab,     /* Description of the table we are reading from */
21552133d822Sdrh   int iColumn,     /* Index of the table column */
21562133d822Sdrh   int iTable,      /* The cursor pointing to the table */
2157b6da74ebSdrh   int iReg         /* Store results here */
21582133d822Sdrh ){
2159e55cbd72Sdrh   Vdbe *v = pParse->pVdbe;
2160e55cbd72Sdrh   int i;
2161da250ea5Sdrh   struct yColCache *p;
2162e55cbd72Sdrh 
2163ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2164b6da74ebSdrh     if( p->iReg>0 && p->iTable==iTable && p->iColumn==iColumn ){
2165ceea3321Sdrh       p->lru = pParse->iCacheCnt++;
21665cd79239Sdrh       sqlite3ExprCachePinRegister(pParse, p->iReg);
2167da250ea5Sdrh       return p->iReg;
2168e55cbd72Sdrh     }
2169e55cbd72Sdrh   }
2170e55cbd72Sdrh   assert( v!=0 );
21715c092e8aSdrh   sqlite3ExprCodeGetColumnOfTable(v, pTab, iTable, iColumn, iReg);
2172ceea3321Sdrh   sqlite3ExprCacheStore(pParse, iTable, iColumn, iReg);
2173e55cbd72Sdrh   return iReg;
2174e55cbd72Sdrh }
2175e55cbd72Sdrh 
2176e55cbd72Sdrh /*
2177ceea3321Sdrh ** Clear all column cache entries.
2178e55cbd72Sdrh */
2179ceea3321Sdrh void sqlite3ExprCacheClear(Parse *pParse){
2180e55cbd72Sdrh   int i;
2181ceea3321Sdrh   struct yColCache *p;
2182ceea3321Sdrh 
2183ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2184ceea3321Sdrh     if( p->iReg ){
2185ceea3321Sdrh       cacheEntryClear(pParse, p);
2186ceea3321Sdrh       p->iReg = 0;
2187e55cbd72Sdrh     }
2188da250ea5Sdrh   }
2189da250ea5Sdrh }
2190e55cbd72Sdrh 
2191e55cbd72Sdrh /*
2192da250ea5Sdrh ** Record the fact that an affinity change has occurred on iCount
2193da250ea5Sdrh ** registers starting with iStart.
2194e55cbd72Sdrh */
2195da250ea5Sdrh void sqlite3ExprCacheAffinityChange(Parse *pParse, int iStart, int iCount){
2196f49f3523Sdrh   sqlite3ExprCacheRemove(pParse, iStart, iCount);
2197e55cbd72Sdrh }
2198e55cbd72Sdrh 
2199e55cbd72Sdrh /*
2200b21e7c70Sdrh ** Generate code to move content from registers iFrom...iFrom+nReg-1
2201b21e7c70Sdrh ** over to iTo..iTo+nReg-1. Keep the column cache up-to-date.
2202e55cbd72Sdrh */
2203b21e7c70Sdrh void sqlite3ExprCodeMove(Parse *pParse, int iFrom, int iTo, int nReg){
2204e55cbd72Sdrh   int i;
2205ceea3321Sdrh   struct yColCache *p;
220620411ea7Sdrh   if( NEVER(iFrom==iTo) ) return;
2207b21e7c70Sdrh   sqlite3VdbeAddOp3(pParse->pVdbe, OP_Move, iFrom, iTo, nReg);
2208ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2209ceea3321Sdrh     int x = p->iReg;
2210b21e7c70Sdrh     if( x>=iFrom && x<iFrom+nReg ){
2211ceea3321Sdrh       p->iReg += iTo-iFrom;
2212e55cbd72Sdrh     }
2213e55cbd72Sdrh   }
2214945498f3Sdrh }
2215945498f3Sdrh 
2216fec19aadSdrh /*
221792b01d53Sdrh ** Generate code to copy content from registers iFrom...iFrom+nReg-1
221892b01d53Sdrh ** over to iTo..iTo+nReg-1.
221992b01d53Sdrh */
222092b01d53Sdrh void sqlite3ExprCodeCopy(Parse *pParse, int iFrom, int iTo, int nReg){
222192b01d53Sdrh   int i;
222220411ea7Sdrh   if( NEVER(iFrom==iTo) ) return;
222392b01d53Sdrh   for(i=0; i<nReg; i++){
222492b01d53Sdrh     sqlite3VdbeAddOp2(pParse->pVdbe, OP_Copy, iFrom+i, iTo+i);
222592b01d53Sdrh   }
222692b01d53Sdrh }
222792b01d53Sdrh 
2228f49f3523Sdrh #if defined(SQLITE_DEBUG) || defined(SQLITE_COVERAGE_TEST)
222992b01d53Sdrh /*
2230652fbf55Sdrh ** Return true if any register in the range iFrom..iTo (inclusive)
2231652fbf55Sdrh ** is used as part of the column cache.
2232f49f3523Sdrh **
2233f49f3523Sdrh ** This routine is used within assert() and testcase() macros only
2234f49f3523Sdrh ** and does not appear in a normal build.
2235652fbf55Sdrh */
2236652fbf55Sdrh static int usedAsColumnCache(Parse *pParse, int iFrom, int iTo){
2237652fbf55Sdrh   int i;
2238ceea3321Sdrh   struct yColCache *p;
2239ceea3321Sdrh   for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
2240ceea3321Sdrh     int r = p->iReg;
2241f49f3523Sdrh     if( r>=iFrom && r<=iTo ) return 1;    /*NO_TEST*/
2242652fbf55Sdrh   }
2243652fbf55Sdrh   return 0;
2244652fbf55Sdrh }
2245f49f3523Sdrh #endif /* SQLITE_DEBUG || SQLITE_COVERAGE_TEST */
2246652fbf55Sdrh 
2247652fbf55Sdrh /*
2248cce7d176Sdrh ** Generate code into the current Vdbe to evaluate the given
22492dcef11bSdrh ** expression.  Attempt to store the results in register "target".
22502dcef11bSdrh ** Return the register where results are stored.
2251389a1adbSdrh **
22528b213899Sdrh ** With this routine, there is no guarantee that results will
22532dcef11bSdrh ** be stored in target.  The result might be stored in some other
22542dcef11bSdrh ** register if it is convenient to do so.  The calling function
22552dcef11bSdrh ** must check the return code and move the results to the desired
22562dcef11bSdrh ** register.
2257cce7d176Sdrh */
2258678ccce8Sdrh int sqlite3ExprCodeTarget(Parse *pParse, Expr *pExpr, int target){
22592dcef11bSdrh   Vdbe *v = pParse->pVdbe;  /* The VM under construction */
22602dcef11bSdrh   int op;                   /* The opcode being coded */
22612dcef11bSdrh   int inReg = target;       /* Results stored in register inReg */
22622dcef11bSdrh   int regFree1 = 0;         /* If non-zero free this temporary register */
22632dcef11bSdrh   int regFree2 = 0;         /* If non-zero free this temporary register */
2264678ccce8Sdrh   int r1, r2, r3, r4;       /* Various register numbers */
226520411ea7Sdrh   sqlite3 *db = pParse->db; /* The database connection */
2266ffe07b2dSdrh 
22679cbf3425Sdrh   assert( target>0 && target<=pParse->nMem );
226820411ea7Sdrh   if( v==0 ){
226920411ea7Sdrh     assert( pParse->db->mallocFailed );
227020411ea7Sdrh     return 0;
227120411ea7Sdrh   }
2272389a1adbSdrh 
2273389a1adbSdrh   if( pExpr==0 ){
2274389a1adbSdrh     op = TK_NULL;
2275389a1adbSdrh   }else{
2276f2bc013cSdrh     op = pExpr->op;
2277389a1adbSdrh   }
2278f2bc013cSdrh   switch( op ){
227913449892Sdrh     case TK_AGG_COLUMN: {
228013449892Sdrh       AggInfo *pAggInfo = pExpr->pAggInfo;
228113449892Sdrh       struct AggInfo_col *pCol = &pAggInfo->aCol[pExpr->iAgg];
228213449892Sdrh       if( !pAggInfo->directMode ){
22839de221dfSdrh         assert( pCol->iMem>0 );
22849de221dfSdrh         inReg = pCol->iMem;
228513449892Sdrh         break;
228613449892Sdrh       }else if( pAggInfo->useSortingIdx ){
22875134d135Sdan         sqlite3VdbeAddOp3(v, OP_Column, pAggInfo->sortingIdxPTab,
2288389a1adbSdrh                               pCol->iSorterColumn, target);
228913449892Sdrh         break;
229013449892Sdrh       }
229113449892Sdrh       /* Otherwise, fall thru into the TK_COLUMN case */
229213449892Sdrh     }
2293967e8b73Sdrh     case TK_COLUMN: {
2294ffe07b2dSdrh       if( pExpr->iTable<0 ){
2295ffe07b2dSdrh         /* This only happens when coding check constraints */
2296aa9b8963Sdrh         assert( pParse->ckBase>0 );
2297aa9b8963Sdrh         inReg = pExpr->iColumn + pParse->ckBase;
2298c4a3c779Sdrh       }else{
2299e55cbd72Sdrh         inReg = sqlite3ExprCodeGetColumn(pParse, pExpr->pTab,
2300b6da74ebSdrh                                  pExpr->iColumn, pExpr->iTable, target);
23012282792aSdrh       }
2302cce7d176Sdrh       break;
2303cce7d176Sdrh     }
2304cce7d176Sdrh     case TK_INTEGER: {
230513573c71Sdrh       codeInteger(pParse, pExpr, 0, target);
2306fec19aadSdrh       break;
230751e9a445Sdrh     }
230813573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
2309598f1340Sdrh     case TK_FLOAT: {
231033e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
231133e619fcSdrh       codeReal(v, pExpr->u.zToken, 0, target);
2312598f1340Sdrh       break;
2313598f1340Sdrh     }
231413573c71Sdrh #endif
2315fec19aadSdrh     case TK_STRING: {
231633e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
231733e619fcSdrh       sqlite3VdbeAddOp4(v, OP_String8, 0, target, 0, pExpr->u.zToken, 0);
2318cce7d176Sdrh       break;
2319cce7d176Sdrh     }
2320f0863fe5Sdrh     case TK_NULL: {
23219de221dfSdrh       sqlite3VdbeAddOp2(v, OP_Null, 0, target);
2322f0863fe5Sdrh       break;
2323f0863fe5Sdrh     }
23245338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_BLOB_LITERAL
2325c572ef7fSdanielk1977     case TK_BLOB: {
23266c8c6cecSdrh       int n;
23276c8c6cecSdrh       const char *z;
2328ca48c90fSdrh       char *zBlob;
232933e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
233033e619fcSdrh       assert( pExpr->u.zToken[0]=='x' || pExpr->u.zToken[0]=='X' );
233133e619fcSdrh       assert( pExpr->u.zToken[1]=='\'' );
233233e619fcSdrh       z = &pExpr->u.zToken[2];
2333b7916a78Sdrh       n = sqlite3Strlen30(z) - 1;
2334b7916a78Sdrh       assert( z[n]=='\'' );
2335ca48c90fSdrh       zBlob = sqlite3HexToBlob(sqlite3VdbeDb(v), z, n);
2336ca48c90fSdrh       sqlite3VdbeAddOp4(v, OP_Blob, n/2, target, 0, zBlob, P4_DYNAMIC);
2337c572ef7fSdanielk1977       break;
2338c572ef7fSdanielk1977     }
23395338a5f7Sdanielk1977 #endif
234050457896Sdrh     case TK_VARIABLE: {
234133e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
234233e619fcSdrh       assert( pExpr->u.zToken!=0 );
234333e619fcSdrh       assert( pExpr->u.zToken[0]!=0 );
2344eaf52d88Sdrh       sqlite3VdbeAddOp2(v, OP_Variable, pExpr->iColumn, target);
234533e619fcSdrh       if( pExpr->u.zToken[1]!=0 ){
234604e9eeadSdrh         assert( pExpr->u.zToken[0]=='?'
234704e9eeadSdrh              || strcmp(pExpr->u.zToken, pParse->azVar[pExpr->iColumn-1])==0 );
234804e9eeadSdrh         sqlite3VdbeChangeP4(v, -1, pParse->azVar[pExpr->iColumn-1], P4_STATIC);
2349895d7472Sdrh       }
235050457896Sdrh       break;
235150457896Sdrh     }
23524e0cff60Sdrh     case TK_REGISTER: {
23539de221dfSdrh       inReg = pExpr->iTable;
23544e0cff60Sdrh       break;
23554e0cff60Sdrh     }
23568b213899Sdrh     case TK_AS: {
23577445ffe2Sdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
23588b213899Sdrh       break;
23598b213899Sdrh     }
2360487e262fSdrh #ifndef SQLITE_OMIT_CAST
2361487e262fSdrh     case TK_CAST: {
2362487e262fSdrh       /* Expressions of the form:   CAST(pLeft AS token) */
2363f0113000Sdanielk1977       int aff, to_op;
23642dcef11bSdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
236533e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
236633e619fcSdrh       aff = sqlite3AffinityType(pExpr->u.zToken);
2367f0113000Sdanielk1977       to_op = aff - SQLITE_AFF_TEXT + OP_ToText;
2368f0113000Sdanielk1977       assert( to_op==OP_ToText    || aff!=SQLITE_AFF_TEXT    );
2369f0113000Sdanielk1977       assert( to_op==OP_ToBlob    || aff!=SQLITE_AFF_NONE    );
2370f0113000Sdanielk1977       assert( to_op==OP_ToNumeric || aff!=SQLITE_AFF_NUMERIC );
2371f0113000Sdanielk1977       assert( to_op==OP_ToInt     || aff!=SQLITE_AFF_INTEGER );
2372f0113000Sdanielk1977       assert( to_op==OP_ToReal    || aff!=SQLITE_AFF_REAL    );
2373c5499befSdrh       testcase( to_op==OP_ToText );
2374c5499befSdrh       testcase( to_op==OP_ToBlob );
2375c5499befSdrh       testcase( to_op==OP_ToNumeric );
2376c5499befSdrh       testcase( to_op==OP_ToInt );
2377c5499befSdrh       testcase( to_op==OP_ToReal );
23781735fa88Sdrh       if( inReg!=target ){
23791735fa88Sdrh         sqlite3VdbeAddOp2(v, OP_SCopy, inReg, target);
23801735fa88Sdrh         inReg = target;
23811735fa88Sdrh       }
23822dcef11bSdrh       sqlite3VdbeAddOp1(v, to_op, inReg);
2383c5499befSdrh       testcase( usedAsColumnCache(pParse, inReg, inReg) );
2384b3843a82Sdrh       sqlite3ExprCacheAffinityChange(pParse, inReg, 1);
2385487e262fSdrh       break;
2386487e262fSdrh     }
2387487e262fSdrh #endif /* SQLITE_OMIT_CAST */
2388c9b84a1fSdrh     case TK_LT:
2389c9b84a1fSdrh     case TK_LE:
2390c9b84a1fSdrh     case TK_GT:
2391c9b84a1fSdrh     case TK_GE:
2392c9b84a1fSdrh     case TK_NE:
2393c9b84a1fSdrh     case TK_EQ: {
2394f2bc013cSdrh       assert( TK_LT==OP_Lt );
2395f2bc013cSdrh       assert( TK_LE==OP_Le );
2396f2bc013cSdrh       assert( TK_GT==OP_Gt );
2397f2bc013cSdrh       assert( TK_GE==OP_Ge );
2398f2bc013cSdrh       assert( TK_EQ==OP_Eq );
2399f2bc013cSdrh       assert( TK_NE==OP_Ne );
2400c5499befSdrh       testcase( op==TK_LT );
2401c5499befSdrh       testcase( op==TK_LE );
2402c5499befSdrh       testcase( op==TK_GT );
2403c5499befSdrh       testcase( op==TK_GE );
2404c5499befSdrh       testcase( op==TK_EQ );
2405c5499befSdrh       testcase( op==TK_NE );
2406b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2407b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
240835573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
240935573356Sdrh                   r1, r2, inReg, SQLITE_STOREP2);
2410c5499befSdrh       testcase( regFree1==0 );
2411c5499befSdrh       testcase( regFree2==0 );
2412a37cdde0Sdanielk1977       break;
2413c9b84a1fSdrh     }
24146a2fe093Sdrh     case TK_IS:
24156a2fe093Sdrh     case TK_ISNOT: {
24166a2fe093Sdrh       testcase( op==TK_IS );
24176a2fe093Sdrh       testcase( op==TK_ISNOT );
2418b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2419b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
24206a2fe093Sdrh       op = (op==TK_IS) ? TK_EQ : TK_NE;
24216a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
24226a2fe093Sdrh                   r1, r2, inReg, SQLITE_STOREP2 | SQLITE_NULLEQ);
24236a2fe093Sdrh       testcase( regFree1==0 );
24246a2fe093Sdrh       testcase( regFree2==0 );
24256a2fe093Sdrh       break;
24266a2fe093Sdrh     }
2427cce7d176Sdrh     case TK_AND:
2428cce7d176Sdrh     case TK_OR:
2429cce7d176Sdrh     case TK_PLUS:
2430cce7d176Sdrh     case TK_STAR:
2431cce7d176Sdrh     case TK_MINUS:
2432bf4133cbSdrh     case TK_REM:
2433bf4133cbSdrh     case TK_BITAND:
2434bf4133cbSdrh     case TK_BITOR:
243517c40294Sdrh     case TK_SLASH:
2436bf4133cbSdrh     case TK_LSHIFT:
2437855eb1cfSdrh     case TK_RSHIFT:
24380040077dSdrh     case TK_CONCAT: {
2439f2bc013cSdrh       assert( TK_AND==OP_And );
2440f2bc013cSdrh       assert( TK_OR==OP_Or );
2441f2bc013cSdrh       assert( TK_PLUS==OP_Add );
2442f2bc013cSdrh       assert( TK_MINUS==OP_Subtract );
2443f2bc013cSdrh       assert( TK_REM==OP_Remainder );
2444f2bc013cSdrh       assert( TK_BITAND==OP_BitAnd );
2445f2bc013cSdrh       assert( TK_BITOR==OP_BitOr );
2446f2bc013cSdrh       assert( TK_SLASH==OP_Divide );
2447f2bc013cSdrh       assert( TK_LSHIFT==OP_ShiftLeft );
2448f2bc013cSdrh       assert( TK_RSHIFT==OP_ShiftRight );
2449f2bc013cSdrh       assert( TK_CONCAT==OP_Concat );
2450c5499befSdrh       testcase( op==TK_AND );
2451c5499befSdrh       testcase( op==TK_OR );
2452c5499befSdrh       testcase( op==TK_PLUS );
2453c5499befSdrh       testcase( op==TK_MINUS );
2454c5499befSdrh       testcase( op==TK_REM );
2455c5499befSdrh       testcase( op==TK_BITAND );
2456c5499befSdrh       testcase( op==TK_BITOR );
2457c5499befSdrh       testcase( op==TK_SLASH );
2458c5499befSdrh       testcase( op==TK_LSHIFT );
2459c5499befSdrh       testcase( op==TK_RSHIFT );
2460c5499befSdrh       testcase( op==TK_CONCAT );
24612dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
24622dcef11bSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
24635b6afba9Sdrh       sqlite3VdbeAddOp3(v, op, r2, r1, target);
2464c5499befSdrh       testcase( regFree1==0 );
2465c5499befSdrh       testcase( regFree2==0 );
24660040077dSdrh       break;
24670040077dSdrh     }
2468cce7d176Sdrh     case TK_UMINUS: {
2469fec19aadSdrh       Expr *pLeft = pExpr->pLeft;
2470fec19aadSdrh       assert( pLeft );
247113573c71Sdrh       if( pLeft->op==TK_INTEGER ){
247213573c71Sdrh         codeInteger(pParse, pLeft, 1, target);
247313573c71Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
247413573c71Sdrh       }else if( pLeft->op==TK_FLOAT ){
247533e619fcSdrh         assert( !ExprHasProperty(pExpr, EP_IntValue) );
247633e619fcSdrh         codeReal(v, pLeft->u.zToken, 1, target);
247713573c71Sdrh #endif
24783c84ddffSdrh       }else{
24792dcef11bSdrh         regFree1 = r1 = sqlite3GetTempReg(pParse);
24803c84ddffSdrh         sqlite3VdbeAddOp2(v, OP_Integer, 0, r1);
2481e55cbd72Sdrh         r2 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree2);
24822dcef11bSdrh         sqlite3VdbeAddOp3(v, OP_Subtract, r2, r1, target);
2483c5499befSdrh         testcase( regFree2==0 );
24843c84ddffSdrh       }
24859de221dfSdrh       inReg = target;
24866e142f54Sdrh       break;
24876e142f54Sdrh     }
2488bf4133cbSdrh     case TK_BITNOT:
24896e142f54Sdrh     case TK_NOT: {
2490f2bc013cSdrh       assert( TK_BITNOT==OP_BitNot );
2491f2bc013cSdrh       assert( TK_NOT==OP_Not );
2492c5499befSdrh       testcase( op==TK_BITNOT );
2493c5499befSdrh       testcase( op==TK_NOT );
2494e99fa2afSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2495e99fa2afSdrh       testcase( regFree1==0 );
2496e99fa2afSdrh       inReg = target;
2497e99fa2afSdrh       sqlite3VdbeAddOp2(v, op, r1, inReg);
2498cce7d176Sdrh       break;
2499cce7d176Sdrh     }
2500cce7d176Sdrh     case TK_ISNULL:
2501cce7d176Sdrh     case TK_NOTNULL: {
25026a288a33Sdrh       int addr;
2503f2bc013cSdrh       assert( TK_ISNULL==OP_IsNull );
2504f2bc013cSdrh       assert( TK_NOTNULL==OP_NotNull );
2505c5499befSdrh       testcase( op==TK_ISNULL );
2506c5499befSdrh       testcase( op==TK_NOTNULL );
25079de221dfSdrh       sqlite3VdbeAddOp2(v, OP_Integer, 1, target);
25082dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
2509c5499befSdrh       testcase( regFree1==0 );
25102dcef11bSdrh       addr = sqlite3VdbeAddOp1(v, op, r1);
25119de221dfSdrh       sqlite3VdbeAddOp2(v, OP_AddImm, target, -1);
25126a288a33Sdrh       sqlite3VdbeJumpHere(v, addr);
2513a37cdde0Sdanielk1977       break;
2514f2bc013cSdrh     }
25152282792aSdrh     case TK_AGG_FUNCTION: {
251613449892Sdrh       AggInfo *pInfo = pExpr->pAggInfo;
25177e56e711Sdrh       if( pInfo==0 ){
251833e619fcSdrh         assert( !ExprHasProperty(pExpr, EP_IntValue) );
251933e619fcSdrh         sqlite3ErrorMsg(pParse, "misuse of aggregate: %s()", pExpr->u.zToken);
25207e56e711Sdrh       }else{
25219de221dfSdrh         inReg = pInfo->aFunc[pExpr->iAgg].iMem;
25227e56e711Sdrh       }
25232282792aSdrh       break;
25242282792aSdrh     }
2525b71090fdSdrh     case TK_CONST_FUNC:
2526cce7d176Sdrh     case TK_FUNCTION: {
252712ffee8cSdrh       ExprList *pFarg;       /* List of function arguments */
252812ffee8cSdrh       int nFarg;             /* Number of function arguments */
252912ffee8cSdrh       FuncDef *pDef;         /* The function definition object */
253012ffee8cSdrh       int nId;               /* Length of the function name in bytes */
253112ffee8cSdrh       const char *zId;       /* The function name */
253212ffee8cSdrh       int constMask = 0;     /* Mask of function arguments that are constant */
253312ffee8cSdrh       int i;                 /* Loop counter */
253412ffee8cSdrh       u8 enc = ENC(db);      /* The text encoding used by this database */
253512ffee8cSdrh       CollSeq *pColl = 0;    /* A collating sequence */
253617435752Sdrh 
25376ab3a2ecSdanielk1977       assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
2538c5499befSdrh       testcase( op==TK_CONST_FUNC );
2539c5499befSdrh       testcase( op==TK_FUNCTION );
2540b7916a78Sdrh       if( ExprHasAnyProperty(pExpr, EP_TokenOnly) ){
254112ffee8cSdrh         pFarg = 0;
254212ffee8cSdrh       }else{
254312ffee8cSdrh         pFarg = pExpr->x.pList;
254412ffee8cSdrh       }
254512ffee8cSdrh       nFarg = pFarg ? pFarg->nExpr : 0;
254633e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
254733e619fcSdrh       zId = pExpr->u.zToken;
2548b7916a78Sdrh       nId = sqlite3Strlen30(zId);
254912ffee8cSdrh       pDef = sqlite3FindFunction(db, zId, nId, nFarg, enc, 0);
2550feb306f5Sdrh       if( pDef==0 ){
2551feb306f5Sdrh         sqlite3ErrorMsg(pParse, "unknown function: %.*s()", nId, zId);
2552feb306f5Sdrh         break;
2553feb306f5Sdrh       }
2554ae6bb957Sdrh 
2555ae6bb957Sdrh       /* Attempt a direct implementation of the built-in COALESCE() and
2556ae6bb957Sdrh       ** IFNULL() functions.  This avoids unnecessary evalation of
2557ae6bb957Sdrh       ** arguments past the first non-NULL argument.
2558ae6bb957Sdrh       */
2559ae6bb957Sdrh       if( pDef->flags & SQLITE_FUNC_COALESCE ){
2560ae6bb957Sdrh         int endCoalesce = sqlite3VdbeMakeLabel(v);
2561ae6bb957Sdrh         assert( nFarg>=2 );
2562ae6bb957Sdrh         sqlite3ExprCode(pParse, pFarg->a[0].pExpr, target);
2563ae6bb957Sdrh         for(i=1; i<nFarg; i++){
2564ae6bb957Sdrh           sqlite3VdbeAddOp2(v, OP_NotNull, target, endCoalesce);
2565f49f3523Sdrh           sqlite3ExprCacheRemove(pParse, target, 1);
2566ae6bb957Sdrh           sqlite3ExprCachePush(pParse);
2567ae6bb957Sdrh           sqlite3ExprCode(pParse, pFarg->a[i].pExpr, target);
2568ae6bb957Sdrh           sqlite3ExprCachePop(pParse, 1);
2569ae6bb957Sdrh         }
2570ae6bb957Sdrh         sqlite3VdbeResolveLabel(v, endCoalesce);
2571ae6bb957Sdrh         break;
2572ae6bb957Sdrh       }
2573ae6bb957Sdrh 
2574ae6bb957Sdrh 
257512ffee8cSdrh       if( pFarg ){
257612ffee8cSdrh         r1 = sqlite3GetTempRange(pParse, nFarg);
2577d7d385ddSdrh         sqlite3ExprCachePush(pParse);     /* Ticket 2ea2425d34be */
257812ffee8cSdrh         sqlite3ExprCodeExprList(pParse, pFarg, r1, 1);
2579d7d385ddSdrh         sqlite3ExprCachePop(pParse, 1);   /* Ticket 2ea2425d34be */
2580892d3179Sdrh       }else{
258112ffee8cSdrh         r1 = 0;
2582892d3179Sdrh       }
2583b7f6f68fSdrh #ifndef SQLITE_OMIT_VIRTUALTABLE
2584a43fa227Sdrh       /* Possibly overload the function if the first argument is
2585a43fa227Sdrh       ** a virtual table column.
2586a43fa227Sdrh       **
2587a43fa227Sdrh       ** For infix functions (LIKE, GLOB, REGEXP, and MATCH) use the
2588a43fa227Sdrh       ** second argument, not the first, as the argument to test to
2589a43fa227Sdrh       ** see if it is a column in a virtual table.  This is done because
2590a43fa227Sdrh       ** the left operand of infix functions (the operand we want to
2591a43fa227Sdrh       ** control overloading) ends up as the second argument to the
2592a43fa227Sdrh       ** function.  The expression "A glob B" is equivalent to
2593a43fa227Sdrh       ** "glob(B,A).  We want to use the A in "A glob B" to test
2594a43fa227Sdrh       ** for function overloading.  But we use the B term in "glob(B,A)".
2595a43fa227Sdrh       */
259612ffee8cSdrh       if( nFarg>=2 && (pExpr->flags & EP_InfixFunc) ){
259712ffee8cSdrh         pDef = sqlite3VtabOverloadFunction(db, pDef, nFarg, pFarg->a[1].pExpr);
259812ffee8cSdrh       }else if( nFarg>0 ){
259912ffee8cSdrh         pDef = sqlite3VtabOverloadFunction(db, pDef, nFarg, pFarg->a[0].pExpr);
2600b7f6f68fSdrh       }
2601b7f6f68fSdrh #endif
2602f7bca574Sdrh       for(i=0; i<nFarg; i++){
2603f7bca574Sdrh         if( i<32 && sqlite3ExprIsConstant(pFarg->a[i].pExpr) ){
260413449892Sdrh           constMask |= (1<<i);
2605d02eb1fdSdanielk1977         }
2606e82f5d04Sdrh         if( (pDef->flags & SQLITE_FUNC_NEEDCOLL)!=0 && !pColl ){
260712ffee8cSdrh           pColl = sqlite3ExprCollSeq(pParse, pFarg->a[i].pExpr);
2608dc1bdc4fSdanielk1977         }
2609dc1bdc4fSdanielk1977       }
2610e82f5d04Sdrh       if( pDef->flags & SQLITE_FUNC_NEEDCOLL ){
26118b213899Sdrh         if( !pColl ) pColl = db->pDfltColl;
261266a5167bSdrh         sqlite3VdbeAddOp4(v, OP_CollSeq, 0, 0, 0, (char *)pColl, P4_COLLSEQ);
2613682f68b0Sdanielk1977       }
26142dcef11bSdrh       sqlite3VdbeAddOp4(v, OP_Function, constMask, r1, target,
261566a5167bSdrh                         (char*)pDef, P4_FUNCDEF);
261612ffee8cSdrh       sqlite3VdbeChangeP5(v, (u8)nFarg);
261712ffee8cSdrh       if( nFarg ){
261812ffee8cSdrh         sqlite3ReleaseTempRange(pParse, r1, nFarg);
26192dcef11bSdrh       }
26206ec2733bSdrh       break;
26216ec2733bSdrh     }
2622fe2093d7Sdrh #ifndef SQLITE_OMIT_SUBQUERY
2623fe2093d7Sdrh     case TK_EXISTS:
262419a775c2Sdrh     case TK_SELECT: {
2625c5499befSdrh       testcase( op==TK_EXISTS );
2626c5499befSdrh       testcase( op==TK_SELECT );
26271450bc6eSdrh       inReg = sqlite3CodeSubselect(pParse, pExpr, 0, 0);
262819a775c2Sdrh       break;
262919a775c2Sdrh     }
2630fef5208cSdrh     case TK_IN: {
2631e3365e6cSdrh       int destIfFalse = sqlite3VdbeMakeLabel(v);
2632e3365e6cSdrh       int destIfNull = sqlite3VdbeMakeLabel(v);
2633e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Null, 0, target);
2634e3365e6cSdrh       sqlite3ExprCodeIN(pParse, pExpr, destIfFalse, destIfNull);
263566ba23ceSdrh       sqlite3VdbeAddOp2(v, OP_Integer, 1, target);
2636e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfFalse);
2637e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_AddImm, target, 0);
2638e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfNull);
2639fef5208cSdrh       break;
2640fef5208cSdrh     }
2641e3365e6cSdrh #endif /* SQLITE_OMIT_SUBQUERY */
2642e3365e6cSdrh 
2643e3365e6cSdrh 
26442dcef11bSdrh     /*
26452dcef11bSdrh     **    x BETWEEN y AND z
26462dcef11bSdrh     **
26472dcef11bSdrh     ** This is equivalent to
26482dcef11bSdrh     **
26492dcef11bSdrh     **    x>=y AND x<=z
26502dcef11bSdrh     **
26512dcef11bSdrh     ** X is stored in pExpr->pLeft.
26522dcef11bSdrh     ** Y is stored in pExpr->pList->a[0].pExpr.
26532dcef11bSdrh     ** Z is stored in pExpr->pList->a[1].pExpr.
26542dcef11bSdrh     */
2655fef5208cSdrh     case TK_BETWEEN: {
2656be5c89acSdrh       Expr *pLeft = pExpr->pLeft;
26576ab3a2ecSdanielk1977       struct ExprList_item *pLItem = pExpr->x.pList->a;
2658be5c89acSdrh       Expr *pRight = pLItem->pExpr;
265935573356Sdrh 
2660b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pLeft, &regFree1);
2661b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pRight, &regFree2);
2662c5499befSdrh       testcase( regFree1==0 );
2663c5499befSdrh       testcase( regFree2==0 );
26642dcef11bSdrh       r3 = sqlite3GetTempReg(pParse);
2665678ccce8Sdrh       r4 = sqlite3GetTempReg(pParse);
266635573356Sdrh       codeCompare(pParse, pLeft, pRight, OP_Ge,
266735573356Sdrh                   r1, r2, r3, SQLITE_STOREP2);
2668be5c89acSdrh       pLItem++;
2669be5c89acSdrh       pRight = pLItem->pExpr;
26702dcef11bSdrh       sqlite3ReleaseTempReg(pParse, regFree2);
26712dcef11bSdrh       r2 = sqlite3ExprCodeTemp(pParse, pRight, &regFree2);
2672c5499befSdrh       testcase( regFree2==0 );
2673678ccce8Sdrh       codeCompare(pParse, pLeft, pRight, OP_Le, r1, r2, r4, SQLITE_STOREP2);
2674678ccce8Sdrh       sqlite3VdbeAddOp3(v, OP_And, r3, r4, target);
26752dcef11bSdrh       sqlite3ReleaseTempReg(pParse, r3);
2676678ccce8Sdrh       sqlite3ReleaseTempReg(pParse, r4);
2677fef5208cSdrh       break;
2678fef5208cSdrh     }
26794f07e5fbSdrh     case TK_UPLUS: {
26802dcef11bSdrh       inReg = sqlite3ExprCodeTarget(pParse, pExpr->pLeft, target);
2681a2e00042Sdrh       break;
2682a2e00042Sdrh     }
26832dcef11bSdrh 
2684165921a7Sdan     case TK_TRIGGER: {
268565a7cd16Sdan       /* If the opcode is TK_TRIGGER, then the expression is a reference
268665a7cd16Sdan       ** to a column in the new.* or old.* pseudo-tables available to
268765a7cd16Sdan       ** trigger programs. In this case Expr.iTable is set to 1 for the
268865a7cd16Sdan       ** new.* pseudo-table, or 0 for the old.* pseudo-table. Expr.iColumn
268965a7cd16Sdan       ** is set to the column of the pseudo-table to read, or to -1 to
269065a7cd16Sdan       ** read the rowid field.
269165a7cd16Sdan       **
269265a7cd16Sdan       ** The expression is implemented using an OP_Param opcode. The p1
269365a7cd16Sdan       ** parameter is set to 0 for an old.rowid reference, or to (i+1)
269465a7cd16Sdan       ** to reference another column of the old.* pseudo-table, where
269565a7cd16Sdan       ** i is the index of the column. For a new.rowid reference, p1 is
269665a7cd16Sdan       ** set to (n+1), where n is the number of columns in each pseudo-table.
269765a7cd16Sdan       ** For a reference to any other column in the new.* pseudo-table, p1
269865a7cd16Sdan       ** is set to (n+2+i), where n and i are as defined previously. For
269965a7cd16Sdan       ** example, if the table on which triggers are being fired is
270065a7cd16Sdan       ** declared as:
270165a7cd16Sdan       **
270265a7cd16Sdan       **   CREATE TABLE t1(a, b);
270365a7cd16Sdan       **
270465a7cd16Sdan       ** Then p1 is interpreted as follows:
270565a7cd16Sdan       **
270665a7cd16Sdan       **   p1==0   ->    old.rowid     p1==3   ->    new.rowid
270765a7cd16Sdan       **   p1==1   ->    old.a         p1==4   ->    new.a
270865a7cd16Sdan       **   p1==2   ->    old.b         p1==5   ->    new.b
270965a7cd16Sdan       */
27102832ad42Sdan       Table *pTab = pExpr->pTab;
271165a7cd16Sdan       int p1 = pExpr->iTable * (pTab->nCol+1) + 1 + pExpr->iColumn;
271265a7cd16Sdan 
271365a7cd16Sdan       assert( pExpr->iTable==0 || pExpr->iTable==1 );
271465a7cd16Sdan       assert( pExpr->iColumn>=-1 && pExpr->iColumn<pTab->nCol );
271565a7cd16Sdan       assert( pTab->iPKey<0 || pExpr->iColumn!=pTab->iPKey );
271665a7cd16Sdan       assert( p1>=0 && p1<(pTab->nCol*2+2) );
271765a7cd16Sdan 
271865a7cd16Sdan       sqlite3VdbeAddOp2(v, OP_Param, p1, target);
271976d462eeSdan       VdbeComment((v, "%s.%s -> $%d",
2720165921a7Sdan         (pExpr->iTable ? "new" : "old"),
272176d462eeSdan         (pExpr->iColumn<0 ? "rowid" : pExpr->pTab->aCol[pExpr->iColumn].zName),
272276d462eeSdan         target
2723165921a7Sdan       ));
272465a7cd16Sdan 
272544dbca83Sdrh #ifndef SQLITE_OMIT_FLOATING_POINT
272665a7cd16Sdan       /* If the column has REAL affinity, it may currently be stored as an
272765a7cd16Sdan       ** integer. Use OP_RealAffinity to make sure it is really real.  */
27282832ad42Sdan       if( pExpr->iColumn>=0
27292832ad42Sdan        && pTab->aCol[pExpr->iColumn].affinity==SQLITE_AFF_REAL
27302832ad42Sdan       ){
27312832ad42Sdan         sqlite3VdbeAddOp1(v, OP_RealAffinity, target);
27322832ad42Sdan       }
273344dbca83Sdrh #endif
2734165921a7Sdan       break;
2735165921a7Sdan     }
2736165921a7Sdan 
2737165921a7Sdan 
27382dcef11bSdrh     /*
27392dcef11bSdrh     ** Form A:
27402dcef11bSdrh     **   CASE x WHEN e1 THEN r1 WHEN e2 THEN r2 ... WHEN eN THEN rN ELSE y END
27412dcef11bSdrh     **
27422dcef11bSdrh     ** Form B:
27432dcef11bSdrh     **   CASE WHEN e1 THEN r1 WHEN e2 THEN r2 ... WHEN eN THEN rN ELSE y END
27442dcef11bSdrh     **
27452dcef11bSdrh     ** Form A is can be transformed into the equivalent form B as follows:
27462dcef11bSdrh     **   CASE WHEN x=e1 THEN r1 WHEN x=e2 THEN r2 ...
27472dcef11bSdrh     **        WHEN x=eN THEN rN ELSE y END
27482dcef11bSdrh     **
27492dcef11bSdrh     ** X (if it exists) is in pExpr->pLeft.
27502dcef11bSdrh     ** Y is in pExpr->pRight.  The Y is also optional.  If there is no
27512dcef11bSdrh     ** ELSE clause and no other term matches, then the result of the
27522dcef11bSdrh     ** exprssion is NULL.
27532dcef11bSdrh     ** Ei is in pExpr->pList->a[i*2] and Ri is pExpr->pList->a[i*2+1].
27542dcef11bSdrh     **
27552dcef11bSdrh     ** The result of the expression is the Ri for the first matching Ei,
27562dcef11bSdrh     ** or if there is no matching Ei, the ELSE term Y, or if there is
27572dcef11bSdrh     ** no ELSE term, NULL.
27582dcef11bSdrh     */
275933cd4909Sdrh     default: assert( op==TK_CASE ); {
27602dcef11bSdrh       int endLabel;                     /* GOTO label for end of CASE stmt */
27612dcef11bSdrh       int nextCase;                     /* GOTO label for next WHEN clause */
27622dcef11bSdrh       int nExpr;                        /* 2x number of WHEN terms */
27632dcef11bSdrh       int i;                            /* Loop counter */
27642dcef11bSdrh       ExprList *pEList;                 /* List of WHEN terms */
27652dcef11bSdrh       struct ExprList_item *aListelem;  /* Array of WHEN terms */
27662dcef11bSdrh       Expr opCompare;                   /* The X==Ei expression */
27672dcef11bSdrh       Expr cacheX;                      /* Cached expression X */
27682dcef11bSdrh       Expr *pX;                         /* The X expression */
27691bd10f8aSdrh       Expr *pTest = 0;                  /* X==Ei (form A) or just Ei (form B) */
2770ceea3321Sdrh       VVA_ONLY( int iCacheLevel = pParse->iCacheLevel; )
277117a7f8ddSdrh 
27726ab3a2ecSdanielk1977       assert( !ExprHasProperty(pExpr, EP_xIsSelect) && pExpr->x.pList );
27736ab3a2ecSdanielk1977       assert((pExpr->x.pList->nExpr % 2) == 0);
27746ab3a2ecSdanielk1977       assert(pExpr->x.pList->nExpr > 0);
27756ab3a2ecSdanielk1977       pEList = pExpr->x.pList;
2776be5c89acSdrh       aListelem = pEList->a;
2777be5c89acSdrh       nExpr = pEList->nExpr;
27782dcef11bSdrh       endLabel = sqlite3VdbeMakeLabel(v);
27792dcef11bSdrh       if( (pX = pExpr->pLeft)!=0 ){
27802dcef11bSdrh         cacheX = *pX;
278133cd4909Sdrh         testcase( pX->op==TK_COLUMN );
278233cd4909Sdrh         testcase( pX->op==TK_REGISTER );
27832dcef11bSdrh         cacheX.iTable = sqlite3ExprCodeTemp(pParse, pX, &regFree1);
2784c5499befSdrh         testcase( regFree1==0 );
27852dcef11bSdrh         cacheX.op = TK_REGISTER;
27862dcef11bSdrh         opCompare.op = TK_EQ;
27872dcef11bSdrh         opCompare.pLeft = &cacheX;
27882dcef11bSdrh         pTest = &opCompare;
27898b1db07fSdrh         /* Ticket b351d95f9cd5ef17e9d9dbae18f5ca8611190001:
27908b1db07fSdrh         ** The value in regFree1 might get SCopy-ed into the file result.
27918b1db07fSdrh         ** So make sure that the regFree1 register is not reused for other
27928b1db07fSdrh         ** purposes and possibly overwritten.  */
27938b1db07fSdrh         regFree1 = 0;
2794cce7d176Sdrh       }
2795f5905aa7Sdrh       for(i=0; i<nExpr; i=i+2){
2796ceea3321Sdrh         sqlite3ExprCachePush(pParse);
27972dcef11bSdrh         if( pX ){
27981bd10f8aSdrh           assert( pTest!=0 );
27992dcef11bSdrh           opCompare.pRight = aListelem[i].pExpr;
2800f5905aa7Sdrh         }else{
28012dcef11bSdrh           pTest = aListelem[i].pExpr;
280217a7f8ddSdrh         }
28032dcef11bSdrh         nextCase = sqlite3VdbeMakeLabel(v);
280433cd4909Sdrh         testcase( pTest->op==TK_COLUMN );
28052dcef11bSdrh         sqlite3ExprIfFalse(pParse, pTest, nextCase, SQLITE_JUMPIFNULL);
2806c5499befSdrh         testcase( aListelem[i+1].pExpr->op==TK_COLUMN );
2807c5499befSdrh         testcase( aListelem[i+1].pExpr->op==TK_REGISTER );
28089de221dfSdrh         sqlite3ExprCode(pParse, aListelem[i+1].pExpr, target);
28092dcef11bSdrh         sqlite3VdbeAddOp2(v, OP_Goto, 0, endLabel);
2810ceea3321Sdrh         sqlite3ExprCachePop(pParse, 1);
28112dcef11bSdrh         sqlite3VdbeResolveLabel(v, nextCase);
2812f570f011Sdrh       }
281317a7f8ddSdrh       if( pExpr->pRight ){
2814ceea3321Sdrh         sqlite3ExprCachePush(pParse);
28159de221dfSdrh         sqlite3ExprCode(pParse, pExpr->pRight, target);
2816ceea3321Sdrh         sqlite3ExprCachePop(pParse, 1);
281717a7f8ddSdrh       }else{
28189de221dfSdrh         sqlite3VdbeAddOp2(v, OP_Null, 0, target);
281917a7f8ddSdrh       }
2820c1f4a19bSdanielk1977       assert( db->mallocFailed || pParse->nErr>0
2821c1f4a19bSdanielk1977            || pParse->iCacheLevel==iCacheLevel );
28222dcef11bSdrh       sqlite3VdbeResolveLabel(v, endLabel);
28236f34903eSdanielk1977       break;
28246f34903eSdanielk1977     }
28255338a5f7Sdanielk1977 #ifndef SQLITE_OMIT_TRIGGER
28266f34903eSdanielk1977     case TK_RAISE: {
2827165921a7Sdan       assert( pExpr->affinity==OE_Rollback
2828165921a7Sdan            || pExpr->affinity==OE_Abort
2829165921a7Sdan            || pExpr->affinity==OE_Fail
2830165921a7Sdan            || pExpr->affinity==OE_Ignore
2831165921a7Sdan       );
2832e0af83acSdan       if( !pParse->pTriggerTab ){
2833e0af83acSdan         sqlite3ErrorMsg(pParse,
2834e0af83acSdan                        "RAISE() may only be used within a trigger-program");
2835e0af83acSdan         return 0;
2836e0af83acSdan       }
2837e0af83acSdan       if( pExpr->affinity==OE_Abort ){
2838e0af83acSdan         sqlite3MayAbort(pParse);
2839e0af83acSdan       }
284033e619fcSdrh       assert( !ExprHasProperty(pExpr, EP_IntValue) );
2841e0af83acSdan       if( pExpr->affinity==OE_Ignore ){
2842e0af83acSdan         sqlite3VdbeAddOp4(
2843e0af83acSdan             v, OP_Halt, SQLITE_OK, OE_Ignore, 0, pExpr->u.zToken,0);
2844e0af83acSdan       }else{
2845e0af83acSdan         sqlite3HaltConstraint(pParse, pExpr->affinity, pExpr->u.zToken, 0);
2846e0af83acSdan       }
2847e0af83acSdan 
2848ffe07b2dSdrh       break;
284917a7f8ddSdrh     }
28505338a5f7Sdanielk1977 #endif
2851ffe07b2dSdrh   }
28522dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
28532dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
28542dcef11bSdrh   return inReg;
28555b6afba9Sdrh }
28562dcef11bSdrh 
28572dcef11bSdrh /*
28582dcef11bSdrh ** Generate code to evaluate an expression and store the results
28592dcef11bSdrh ** into a register.  Return the register number where the results
28602dcef11bSdrh ** are stored.
28612dcef11bSdrh **
28622dcef11bSdrh ** If the register is a temporary register that can be deallocated,
2863678ccce8Sdrh ** then write its number into *pReg.  If the result register is not
28642dcef11bSdrh ** a temporary, then set *pReg to zero.
28652dcef11bSdrh */
28662dcef11bSdrh int sqlite3ExprCodeTemp(Parse *pParse, Expr *pExpr, int *pReg){
28672dcef11bSdrh   int r1 = sqlite3GetTempReg(pParse);
28682dcef11bSdrh   int r2 = sqlite3ExprCodeTarget(pParse, pExpr, r1);
28692dcef11bSdrh   if( r2==r1 ){
28702dcef11bSdrh     *pReg = r1;
28712dcef11bSdrh   }else{
28722dcef11bSdrh     sqlite3ReleaseTempReg(pParse, r1);
28732dcef11bSdrh     *pReg = 0;
28742dcef11bSdrh   }
28752dcef11bSdrh   return r2;
28762dcef11bSdrh }
28772dcef11bSdrh 
28782dcef11bSdrh /*
28792dcef11bSdrh ** Generate code that will evaluate expression pExpr and store the
28802dcef11bSdrh ** results in register target.  The results are guaranteed to appear
28812dcef11bSdrh ** in register target.
28822dcef11bSdrh */
28832dcef11bSdrh int sqlite3ExprCode(Parse *pParse, Expr *pExpr, int target){
28849cbf3425Sdrh   int inReg;
28859cbf3425Sdrh 
28869cbf3425Sdrh   assert( target>0 && target<=pParse->nMem );
2887ebc16717Sdrh   if( pExpr && pExpr->op==TK_REGISTER ){
2888ebc16717Sdrh     sqlite3VdbeAddOp2(pParse->pVdbe, OP_Copy, pExpr->iTable, target);
2889ebc16717Sdrh   }else{
28909cbf3425Sdrh     inReg = sqlite3ExprCodeTarget(pParse, pExpr, target);
28910e359b30Sdrh     assert( pParse->pVdbe || pParse->db->mallocFailed );
28920e359b30Sdrh     if( inReg!=target && pParse->pVdbe ){
28939cbf3425Sdrh       sqlite3VdbeAddOp2(pParse->pVdbe, OP_SCopy, inReg, target);
289417a7f8ddSdrh     }
2895ebc16717Sdrh   }
2896389a1adbSdrh   return target;
2897cce7d176Sdrh }
2898cce7d176Sdrh 
2899cce7d176Sdrh /*
29002dcef11bSdrh ** Generate code that evalutes the given expression and puts the result
2901de4fcfddSdrh ** in register target.
290225303780Sdrh **
29032dcef11bSdrh ** Also make a copy of the expression results into another "cache" register
29042dcef11bSdrh ** and modify the expression so that the next time it is evaluated,
29052dcef11bSdrh ** the result is a copy of the cache register.
29062dcef11bSdrh **
29072dcef11bSdrh ** This routine is used for expressions that are used multiple
29082dcef11bSdrh ** times.  They are evaluated once and the results of the expression
29092dcef11bSdrh ** are reused.
291025303780Sdrh */
29112dcef11bSdrh int sqlite3ExprCodeAndCache(Parse *pParse, Expr *pExpr, int target){
291225303780Sdrh   Vdbe *v = pParse->pVdbe;
29132dcef11bSdrh   int inReg;
29142dcef11bSdrh   inReg = sqlite3ExprCode(pParse, pExpr, target);
2915de4fcfddSdrh   assert( target>0 );
291620bc393cSdrh   /* This routine is called for terms to INSERT or UPDATE.  And the only
291720bc393cSdrh   ** other place where expressions can be converted into TK_REGISTER is
291820bc393cSdrh   ** in WHERE clause processing.  So as currently implemented, there is
291920bc393cSdrh   ** no way for a TK_REGISTER to exist here.  But it seems prudent to
292020bc393cSdrh   ** keep the ALWAYS() in case the conditions above change with future
292120bc393cSdrh   ** modifications or enhancements. */
292220bc393cSdrh   if( ALWAYS(pExpr->op!=TK_REGISTER) ){
292325303780Sdrh     int iMem;
29242dcef11bSdrh     iMem = ++pParse->nMem;
29252dcef11bSdrh     sqlite3VdbeAddOp2(v, OP_Copy, inReg, iMem);
29262dcef11bSdrh     pExpr->iTable = iMem;
2927937d0deaSdan     pExpr->op2 = pExpr->op;
292825303780Sdrh     pExpr->op = TK_REGISTER;
292925303780Sdrh   }
29302dcef11bSdrh   return inReg;
293125303780Sdrh }
29322dcef11bSdrh 
2933678ccce8Sdrh /*
293447de955eSdrh ** Return TRUE if pExpr is an constant expression that is appropriate
293547de955eSdrh ** for factoring out of a loop.  Appropriate expressions are:
293647de955eSdrh **
293747de955eSdrh **    *  Any expression that evaluates to two or more opcodes.
293847de955eSdrh **
293947de955eSdrh **    *  Any OP_Integer, OP_Real, OP_String, OP_Blob, OP_Null,
294047de955eSdrh **       or OP_Variable that does not need to be placed in a
294147de955eSdrh **       specific register.
294247de955eSdrh **
294347de955eSdrh ** There is no point in factoring out single-instruction constant
294447de955eSdrh ** expressions that need to be placed in a particular register.
294547de955eSdrh ** We could factor them out, but then we would end up adding an
294647de955eSdrh ** OP_SCopy instruction to move the value into the correct register
294747de955eSdrh ** later.  We might as well just use the original instruction and
294847de955eSdrh ** avoid the OP_SCopy.
294947de955eSdrh */
295047de955eSdrh static int isAppropriateForFactoring(Expr *p){
295147de955eSdrh   if( !sqlite3ExprIsConstantNotJoin(p) ){
295247de955eSdrh     return 0;  /* Only constant expressions are appropriate for factoring */
295347de955eSdrh   }
295447de955eSdrh   if( (p->flags & EP_FixedDest)==0 ){
295547de955eSdrh     return 1;  /* Any constant without a fixed destination is appropriate */
295647de955eSdrh   }
295747de955eSdrh   while( p->op==TK_UPLUS ) p = p->pLeft;
295847de955eSdrh   switch( p->op ){
295947de955eSdrh #ifndef SQLITE_OMIT_BLOB_LITERAL
296047de955eSdrh     case TK_BLOB:
296147de955eSdrh #endif
296247de955eSdrh     case TK_VARIABLE:
296347de955eSdrh     case TK_INTEGER:
296447de955eSdrh     case TK_FLOAT:
296547de955eSdrh     case TK_NULL:
296647de955eSdrh     case TK_STRING: {
296747de955eSdrh       testcase( p->op==TK_BLOB );
296847de955eSdrh       testcase( p->op==TK_VARIABLE );
296947de955eSdrh       testcase( p->op==TK_INTEGER );
297047de955eSdrh       testcase( p->op==TK_FLOAT );
297147de955eSdrh       testcase( p->op==TK_NULL );
297247de955eSdrh       testcase( p->op==TK_STRING );
297347de955eSdrh       /* Single-instruction constants with a fixed destination are
297447de955eSdrh       ** better done in-line.  If we factor them, they will just end
297547de955eSdrh       ** up generating an OP_SCopy to move the value to the destination
297647de955eSdrh       ** register. */
297747de955eSdrh       return 0;
297847de955eSdrh     }
297947de955eSdrh     case TK_UMINUS: {
298047de955eSdrh       if( p->pLeft->op==TK_FLOAT || p->pLeft->op==TK_INTEGER ){
298147de955eSdrh         return 0;
298247de955eSdrh       }
298347de955eSdrh       break;
298447de955eSdrh     }
298547de955eSdrh     default: {
298647de955eSdrh       break;
298747de955eSdrh     }
298847de955eSdrh   }
298947de955eSdrh   return 1;
299047de955eSdrh }
299147de955eSdrh 
299247de955eSdrh /*
299347de955eSdrh ** If pExpr is a constant expression that is appropriate for
299447de955eSdrh ** factoring out of a loop, then evaluate the expression
2995678ccce8Sdrh ** into a register and convert the expression into a TK_REGISTER
2996678ccce8Sdrh ** expression.
2997678ccce8Sdrh */
29987d10d5a6Sdrh static int evalConstExpr(Walker *pWalker, Expr *pExpr){
29997d10d5a6Sdrh   Parse *pParse = pWalker->pParse;
300047de955eSdrh   switch( pExpr->op ){
3001e05c929bSdrh     case TK_IN:
300247de955eSdrh     case TK_REGISTER: {
300333cd4909Sdrh       return WRC_Prune;
3004678ccce8Sdrh     }
300547de955eSdrh     case TK_FUNCTION:
300647de955eSdrh     case TK_AGG_FUNCTION:
300747de955eSdrh     case TK_CONST_FUNC: {
300847de955eSdrh       /* The arguments to a function have a fixed destination.
300947de955eSdrh       ** Mark them this way to avoid generated unneeded OP_SCopy
301047de955eSdrh       ** instructions.
301147de955eSdrh       */
30126ab3a2ecSdanielk1977       ExprList *pList = pExpr->x.pList;
30136ab3a2ecSdanielk1977       assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
301447de955eSdrh       if( pList ){
301547de955eSdrh         int i = pList->nExpr;
301647de955eSdrh         struct ExprList_item *pItem = pList->a;
301747de955eSdrh         for(; i>0; i--, pItem++){
301833cd4909Sdrh           if( ALWAYS(pItem->pExpr) ) pItem->pExpr->flags |= EP_FixedDest;
301947de955eSdrh         }
302047de955eSdrh       }
302147de955eSdrh       break;
302247de955eSdrh     }
302347de955eSdrh   }
302447de955eSdrh   if( isAppropriateForFactoring(pExpr) ){
3025678ccce8Sdrh     int r1 = ++pParse->nMem;
3026678ccce8Sdrh     int r2;
3027678ccce8Sdrh     r2 = sqlite3ExprCodeTarget(pParse, pExpr, r1);
302833cd4909Sdrh     if( NEVER(r1!=r2) ) sqlite3ReleaseTempReg(pParse, r1);
3029fcd4a150Sdan     pExpr->op2 = pExpr->op;
3030678ccce8Sdrh     pExpr->op = TK_REGISTER;
3031678ccce8Sdrh     pExpr->iTable = r2;
30327d10d5a6Sdrh     return WRC_Prune;
3033678ccce8Sdrh   }
30347d10d5a6Sdrh   return WRC_Continue;
3035678ccce8Sdrh }
3036678ccce8Sdrh 
3037678ccce8Sdrh /*
3038678ccce8Sdrh ** Preevaluate constant subexpressions within pExpr and store the
3039678ccce8Sdrh ** results in registers.  Modify pExpr so that the constant subexpresions
3040678ccce8Sdrh ** are TK_REGISTER opcodes that refer to the precomputed values.
3041f58ee7f1Sdrh **
3042f58ee7f1Sdrh ** This routine is a no-op if the jump to the cookie-check code has
3043f58ee7f1Sdrh ** already occur.  Since the cookie-check jump is generated prior to
3044f58ee7f1Sdrh ** any other serious processing, this check ensures that there is no
3045f58ee7f1Sdrh ** way to accidently bypass the constant initializations.
3046f58ee7f1Sdrh **
3047f58ee7f1Sdrh ** This routine is also a no-op if the SQLITE_FactorOutConst optimization
3048f58ee7f1Sdrh ** is disabled via the sqlite3_test_control(SQLITE_TESTCTRL_OPTIMIZATIONS)
3049f58ee7f1Sdrh ** interface.  This allows test logic to verify that the same answer is
3050f58ee7f1Sdrh ** obtained for queries regardless of whether or not constants are
3051f58ee7f1Sdrh ** precomputed into registers or if they are inserted in-line.
3052678ccce8Sdrh */
3053678ccce8Sdrh void sqlite3ExprCodeConstants(Parse *pParse, Expr *pExpr){
30547d10d5a6Sdrh   Walker w;
305548b5b041Sdrh   if( pParse->cookieGoto ) return;
3056f58ee7f1Sdrh   if( (pParse->db->flags & SQLITE_FactorOutConst)!=0 ) return;
30577d10d5a6Sdrh   w.xExprCallback = evalConstExpr;
3058ef4c0598Sdrh   w.xSelectCallback = 0;
30597d10d5a6Sdrh   w.pParse = pParse;
30607d10d5a6Sdrh   sqlite3WalkExpr(&w, pExpr);
3061678ccce8Sdrh }
3062678ccce8Sdrh 
306325303780Sdrh 
306425303780Sdrh /*
3065268380caSdrh ** Generate code that pushes the value of every element of the given
30669cbf3425Sdrh ** expression list into a sequence of registers beginning at target.
3067268380caSdrh **
3068892d3179Sdrh ** Return the number of elements evaluated.
3069268380caSdrh */
30704adee20fSdanielk1977 int sqlite3ExprCodeExprList(
3071268380caSdrh   Parse *pParse,     /* Parsing context */
3072389a1adbSdrh   ExprList *pList,   /* The expression list to be coded */
3073191b54cbSdrh   int target,        /* Where to write results */
3074d176611bSdrh   int doHardCopy     /* Make a hard copy of every element */
3075268380caSdrh ){
3076268380caSdrh   struct ExprList_item *pItem;
30779cbf3425Sdrh   int i, n;
30789d8b3072Sdrh   assert( pList!=0 );
30799cbf3425Sdrh   assert( target>0 );
3080d81a142bSdrh   assert( pParse->pVdbe!=0 );  /* Never gets this far otherwise */
3081268380caSdrh   n = pList->nExpr;
3082191b54cbSdrh   for(pItem=pList->a, i=0; i<n; i++, pItem++){
30837445ffe2Sdrh     Expr *pExpr = pItem->pExpr;
30847445ffe2Sdrh     int inReg = sqlite3ExprCodeTarget(pParse, pExpr, target+i);
3085746fd9ccSdrh     if( inReg!=target+i ){
30867445ffe2Sdrh       sqlite3VdbeAddOp2(pParse->pVdbe, doHardCopy ? OP_Copy : OP_SCopy,
30877445ffe2Sdrh                         inReg, target+i);
3088d176611bSdrh     }
3089268380caSdrh   }
3090f9b596ebSdrh   return n;
3091268380caSdrh }
3092268380caSdrh 
3093268380caSdrh /*
309436c563a2Sdrh ** Generate code for a BETWEEN operator.
309536c563a2Sdrh **
309636c563a2Sdrh **    x BETWEEN y AND z
309736c563a2Sdrh **
309836c563a2Sdrh ** The above is equivalent to
309936c563a2Sdrh **
310036c563a2Sdrh **    x>=y AND x<=z
310136c563a2Sdrh **
310236c563a2Sdrh ** Code it as such, taking care to do the common subexpression
310336c563a2Sdrh ** elementation of x.
310436c563a2Sdrh */
310536c563a2Sdrh static void exprCodeBetween(
310636c563a2Sdrh   Parse *pParse,    /* Parsing and code generating context */
310736c563a2Sdrh   Expr *pExpr,      /* The BETWEEN expression */
310836c563a2Sdrh   int dest,         /* Jump here if the jump is taken */
310936c563a2Sdrh   int jumpIfTrue,   /* Take the jump if the BETWEEN is true */
311036c563a2Sdrh   int jumpIfNull    /* Take the jump if the BETWEEN is NULL */
311136c563a2Sdrh ){
311236c563a2Sdrh   Expr exprAnd;     /* The AND operator in  x>=y AND x<=z  */
311336c563a2Sdrh   Expr compLeft;    /* The  x>=y  term */
311436c563a2Sdrh   Expr compRight;   /* The  x<=z  term */
311536c563a2Sdrh   Expr exprX;       /* The  x  subexpression */
311636c563a2Sdrh   int regFree1 = 0; /* Temporary use register */
311736c563a2Sdrh 
311836c563a2Sdrh   assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
311936c563a2Sdrh   exprX = *pExpr->pLeft;
312036c563a2Sdrh   exprAnd.op = TK_AND;
312136c563a2Sdrh   exprAnd.pLeft = &compLeft;
312236c563a2Sdrh   exprAnd.pRight = &compRight;
312336c563a2Sdrh   compLeft.op = TK_GE;
312436c563a2Sdrh   compLeft.pLeft = &exprX;
312536c563a2Sdrh   compLeft.pRight = pExpr->x.pList->a[0].pExpr;
312636c563a2Sdrh   compRight.op = TK_LE;
312736c563a2Sdrh   compRight.pLeft = &exprX;
312836c563a2Sdrh   compRight.pRight = pExpr->x.pList->a[1].pExpr;
312936c563a2Sdrh   exprX.iTable = sqlite3ExprCodeTemp(pParse, &exprX, &regFree1);
313036c563a2Sdrh   exprX.op = TK_REGISTER;
313136c563a2Sdrh   if( jumpIfTrue ){
313236c563a2Sdrh     sqlite3ExprIfTrue(pParse, &exprAnd, dest, jumpIfNull);
313336c563a2Sdrh   }else{
313436c563a2Sdrh     sqlite3ExprIfFalse(pParse, &exprAnd, dest, jumpIfNull);
313536c563a2Sdrh   }
313636c563a2Sdrh   sqlite3ReleaseTempReg(pParse, regFree1);
313736c563a2Sdrh 
313836c563a2Sdrh   /* Ensure adequate test coverage */
313936c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull==0 && regFree1==0 );
314036c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull==0 && regFree1!=0 );
314136c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull!=0 && regFree1==0 );
314236c563a2Sdrh   testcase( jumpIfTrue==0 && jumpIfNull!=0 && regFree1!=0 );
314336c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull==0 && regFree1==0 );
314436c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull==0 && regFree1!=0 );
314536c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull!=0 && regFree1==0 );
314636c563a2Sdrh   testcase( jumpIfTrue!=0 && jumpIfNull!=0 && regFree1!=0 );
314736c563a2Sdrh }
314836c563a2Sdrh 
314936c563a2Sdrh /*
3150cce7d176Sdrh ** Generate code for a boolean expression such that a jump is made
3151cce7d176Sdrh ** to the label "dest" if the expression is true but execution
3152cce7d176Sdrh ** continues straight thru if the expression is false.
3153f5905aa7Sdrh **
3154f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false), then
315535573356Sdrh ** take the jump if the jumpIfNull flag is SQLITE_JUMPIFNULL.
3156f2bc013cSdrh **
3157f2bc013cSdrh ** This code depends on the fact that certain token values (ex: TK_EQ)
3158f2bc013cSdrh ** are the same as opcode values (ex: OP_Eq) that implement the corresponding
3159f2bc013cSdrh ** operation.  Special comments in vdbe.c and the mkopcodeh.awk script in
3160f2bc013cSdrh ** the make process cause these values to align.  Assert()s in the code
3161f2bc013cSdrh ** below verify that the numbers are aligned correctly.
3162cce7d176Sdrh */
31634adee20fSdanielk1977 void sqlite3ExprIfTrue(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
3164cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
3165cce7d176Sdrh   int op = 0;
31662dcef11bSdrh   int regFree1 = 0;
31672dcef11bSdrh   int regFree2 = 0;
31682dcef11bSdrh   int r1, r2;
31692dcef11bSdrh 
317035573356Sdrh   assert( jumpIfNull==SQLITE_JUMPIFNULL || jumpIfNull==0 );
317133cd4909Sdrh   if( NEVER(v==0) )     return;  /* Existance of VDBE checked by caller */
317233cd4909Sdrh   if( NEVER(pExpr==0) ) return;  /* No way this can happen */
3173f2bc013cSdrh   op = pExpr->op;
3174f2bc013cSdrh   switch( op ){
3175cce7d176Sdrh     case TK_AND: {
31764adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
3177c5499befSdrh       testcase( jumpIfNull==0 );
3178ceea3321Sdrh       sqlite3ExprCachePush(pParse);
317935573356Sdrh       sqlite3ExprIfFalse(pParse, pExpr->pLeft, d2,jumpIfNull^SQLITE_JUMPIFNULL);
31804adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
31814adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
3182ceea3321Sdrh       sqlite3ExprCachePop(pParse, 1);
3183cce7d176Sdrh       break;
3184cce7d176Sdrh     }
3185cce7d176Sdrh     case TK_OR: {
3186c5499befSdrh       testcase( jumpIfNull==0 );
31874adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
31884adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pRight, dest, jumpIfNull);
3189cce7d176Sdrh       break;
3190cce7d176Sdrh     }
3191cce7d176Sdrh     case TK_NOT: {
3192c5499befSdrh       testcase( jumpIfNull==0 );
31934adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
3194cce7d176Sdrh       break;
3195cce7d176Sdrh     }
3196cce7d176Sdrh     case TK_LT:
3197cce7d176Sdrh     case TK_LE:
3198cce7d176Sdrh     case TK_GT:
3199cce7d176Sdrh     case TK_GE:
3200cce7d176Sdrh     case TK_NE:
32010ac65892Sdrh     case TK_EQ: {
3202f2bc013cSdrh       assert( TK_LT==OP_Lt );
3203f2bc013cSdrh       assert( TK_LE==OP_Le );
3204f2bc013cSdrh       assert( TK_GT==OP_Gt );
3205f2bc013cSdrh       assert( TK_GE==OP_Ge );
3206f2bc013cSdrh       assert( TK_EQ==OP_Eq );
3207f2bc013cSdrh       assert( TK_NE==OP_Ne );
3208c5499befSdrh       testcase( op==TK_LT );
3209c5499befSdrh       testcase( op==TK_LE );
3210c5499befSdrh       testcase( op==TK_GT );
3211c5499befSdrh       testcase( op==TK_GE );
3212c5499befSdrh       testcase( op==TK_EQ );
3213c5499befSdrh       testcase( op==TK_NE );
3214c5499befSdrh       testcase( jumpIfNull==0 );
3215b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3216b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
321735573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
32182dcef11bSdrh                   r1, r2, dest, jumpIfNull);
3219c5499befSdrh       testcase( regFree1==0 );
3220c5499befSdrh       testcase( regFree2==0 );
3221cce7d176Sdrh       break;
3222cce7d176Sdrh     }
32236a2fe093Sdrh     case TK_IS:
32246a2fe093Sdrh     case TK_ISNOT: {
32256a2fe093Sdrh       testcase( op==TK_IS );
32266a2fe093Sdrh       testcase( op==TK_ISNOT );
3227b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3228b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
32296a2fe093Sdrh       op = (op==TK_IS) ? TK_EQ : TK_NE;
32306a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
32316a2fe093Sdrh                   r1, r2, dest, SQLITE_NULLEQ);
32326a2fe093Sdrh       testcase( regFree1==0 );
32336a2fe093Sdrh       testcase( regFree2==0 );
32346a2fe093Sdrh       break;
32356a2fe093Sdrh     }
3236cce7d176Sdrh     case TK_ISNULL:
3237cce7d176Sdrh     case TK_NOTNULL: {
3238f2bc013cSdrh       assert( TK_ISNULL==OP_IsNull );
3239f2bc013cSdrh       assert( TK_NOTNULL==OP_NotNull );
3240c5499befSdrh       testcase( op==TK_ISNULL );
3241c5499befSdrh       testcase( op==TK_NOTNULL );
32422dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
32432dcef11bSdrh       sqlite3VdbeAddOp2(v, op, r1, dest);
3244c5499befSdrh       testcase( regFree1==0 );
3245cce7d176Sdrh       break;
3246cce7d176Sdrh     }
3247fef5208cSdrh     case TK_BETWEEN: {
32485c03f30aSdrh       testcase( jumpIfNull==0 );
324936c563a2Sdrh       exprCodeBetween(pParse, pExpr, dest, 1, jumpIfNull);
3250fef5208cSdrh       break;
3251fef5208cSdrh     }
3252bb201344Sshaneh #ifndef SQLITE_OMIT_SUBQUERY
3253e3365e6cSdrh     case TK_IN: {
3254e3365e6cSdrh       int destIfFalse = sqlite3VdbeMakeLabel(v);
3255e3365e6cSdrh       int destIfNull = jumpIfNull ? dest : destIfFalse;
3256e3365e6cSdrh       sqlite3ExprCodeIN(pParse, pExpr, destIfFalse, destIfNull);
3257e3365e6cSdrh       sqlite3VdbeAddOp2(v, OP_Goto, 0, dest);
3258e3365e6cSdrh       sqlite3VdbeResolveLabel(v, destIfFalse);
3259e3365e6cSdrh       break;
3260e3365e6cSdrh     }
3261bb201344Sshaneh #endif
3262cce7d176Sdrh     default: {
32632dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr, &regFree1);
32642dcef11bSdrh       sqlite3VdbeAddOp3(v, OP_If, r1, dest, jumpIfNull!=0);
3265c5499befSdrh       testcase( regFree1==0 );
3266c5499befSdrh       testcase( jumpIfNull==0 );
3267cce7d176Sdrh       break;
3268cce7d176Sdrh     }
3269cce7d176Sdrh   }
32702dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
32712dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
3272cce7d176Sdrh }
3273cce7d176Sdrh 
3274cce7d176Sdrh /*
327566b89c8fSdrh ** Generate code for a boolean expression such that a jump is made
3276cce7d176Sdrh ** to the label "dest" if the expression is false but execution
3277cce7d176Sdrh ** continues straight thru if the expression is true.
3278f5905aa7Sdrh **
3279f5905aa7Sdrh ** If the expression evaluates to NULL (neither true nor false) then
328035573356Sdrh ** jump if jumpIfNull is SQLITE_JUMPIFNULL or fall through if jumpIfNull
328135573356Sdrh ** is 0.
3282cce7d176Sdrh */
32834adee20fSdanielk1977 void sqlite3ExprIfFalse(Parse *pParse, Expr *pExpr, int dest, int jumpIfNull){
3284cce7d176Sdrh   Vdbe *v = pParse->pVdbe;
3285cce7d176Sdrh   int op = 0;
32862dcef11bSdrh   int regFree1 = 0;
32872dcef11bSdrh   int regFree2 = 0;
32882dcef11bSdrh   int r1, r2;
32892dcef11bSdrh 
329035573356Sdrh   assert( jumpIfNull==SQLITE_JUMPIFNULL || jumpIfNull==0 );
329133cd4909Sdrh   if( NEVER(v==0) ) return; /* Existance of VDBE checked by caller */
329233cd4909Sdrh   if( pExpr==0 )    return;
3293f2bc013cSdrh 
3294f2bc013cSdrh   /* The value of pExpr->op and op are related as follows:
3295f2bc013cSdrh   **
3296f2bc013cSdrh   **       pExpr->op            op
3297f2bc013cSdrh   **       ---------          ----------
3298f2bc013cSdrh   **       TK_ISNULL          OP_NotNull
3299f2bc013cSdrh   **       TK_NOTNULL         OP_IsNull
3300f2bc013cSdrh   **       TK_NE              OP_Eq
3301f2bc013cSdrh   **       TK_EQ              OP_Ne
3302f2bc013cSdrh   **       TK_GT              OP_Le
3303f2bc013cSdrh   **       TK_LE              OP_Gt
3304f2bc013cSdrh   **       TK_GE              OP_Lt
3305f2bc013cSdrh   **       TK_LT              OP_Ge
3306f2bc013cSdrh   **
3307f2bc013cSdrh   ** For other values of pExpr->op, op is undefined and unused.
3308f2bc013cSdrh   ** The value of TK_ and OP_ constants are arranged such that we
3309f2bc013cSdrh   ** can compute the mapping above using the following expression.
3310f2bc013cSdrh   ** Assert()s verify that the computation is correct.
3311f2bc013cSdrh   */
3312f2bc013cSdrh   op = ((pExpr->op+(TK_ISNULL&1))^1)-(TK_ISNULL&1);
3313f2bc013cSdrh 
3314f2bc013cSdrh   /* Verify correct alignment of TK_ and OP_ constants
3315f2bc013cSdrh   */
3316f2bc013cSdrh   assert( pExpr->op!=TK_ISNULL || op==OP_NotNull );
3317f2bc013cSdrh   assert( pExpr->op!=TK_NOTNULL || op==OP_IsNull );
3318f2bc013cSdrh   assert( pExpr->op!=TK_NE || op==OP_Eq );
3319f2bc013cSdrh   assert( pExpr->op!=TK_EQ || op==OP_Ne );
3320f2bc013cSdrh   assert( pExpr->op!=TK_LT || op==OP_Ge );
3321f2bc013cSdrh   assert( pExpr->op!=TK_LE || op==OP_Gt );
3322f2bc013cSdrh   assert( pExpr->op!=TK_GT || op==OP_Le );
3323f2bc013cSdrh   assert( pExpr->op!=TK_GE || op==OP_Lt );
3324f2bc013cSdrh 
3325cce7d176Sdrh   switch( pExpr->op ){
3326cce7d176Sdrh     case TK_AND: {
3327c5499befSdrh       testcase( jumpIfNull==0 );
33284adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pLeft, dest, jumpIfNull);
33294adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
3330cce7d176Sdrh       break;
3331cce7d176Sdrh     }
3332cce7d176Sdrh     case TK_OR: {
33334adee20fSdanielk1977       int d2 = sqlite3VdbeMakeLabel(v);
3334c5499befSdrh       testcase( jumpIfNull==0 );
3335ceea3321Sdrh       sqlite3ExprCachePush(pParse);
333635573356Sdrh       sqlite3ExprIfTrue(pParse, pExpr->pLeft, d2, jumpIfNull^SQLITE_JUMPIFNULL);
33374adee20fSdanielk1977       sqlite3ExprIfFalse(pParse, pExpr->pRight, dest, jumpIfNull);
33384adee20fSdanielk1977       sqlite3VdbeResolveLabel(v, d2);
3339ceea3321Sdrh       sqlite3ExprCachePop(pParse, 1);
3340cce7d176Sdrh       break;
3341cce7d176Sdrh     }
3342cce7d176Sdrh     case TK_NOT: {
33435c03f30aSdrh       testcase( jumpIfNull==0 );
33444adee20fSdanielk1977       sqlite3ExprIfTrue(pParse, pExpr->pLeft, dest, jumpIfNull);
3345cce7d176Sdrh       break;
3346cce7d176Sdrh     }
3347cce7d176Sdrh     case TK_LT:
3348cce7d176Sdrh     case TK_LE:
3349cce7d176Sdrh     case TK_GT:
3350cce7d176Sdrh     case TK_GE:
3351cce7d176Sdrh     case TK_NE:
3352cce7d176Sdrh     case TK_EQ: {
3353c5499befSdrh       testcase( op==TK_LT );
3354c5499befSdrh       testcase( op==TK_LE );
3355c5499befSdrh       testcase( op==TK_GT );
3356c5499befSdrh       testcase( op==TK_GE );
3357c5499befSdrh       testcase( op==TK_EQ );
3358c5499befSdrh       testcase( op==TK_NE );
3359c5499befSdrh       testcase( jumpIfNull==0 );
3360b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3361b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
336235573356Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
33632dcef11bSdrh                   r1, r2, dest, jumpIfNull);
3364c5499befSdrh       testcase( regFree1==0 );
3365c5499befSdrh       testcase( regFree2==0 );
3366cce7d176Sdrh       break;
3367cce7d176Sdrh     }
33686a2fe093Sdrh     case TK_IS:
33696a2fe093Sdrh     case TK_ISNOT: {
33706d4486aeSdrh       testcase( pExpr->op==TK_IS );
33716d4486aeSdrh       testcase( pExpr->op==TK_ISNOT );
3372b6da74ebSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
3373b6da74ebSdrh       r2 = sqlite3ExprCodeTemp(pParse, pExpr->pRight, &regFree2);
33746a2fe093Sdrh       op = (pExpr->op==TK_IS) ? TK_NE : TK_EQ;
33756a2fe093Sdrh       codeCompare(pParse, pExpr->pLeft, pExpr->pRight, op,
33766a2fe093Sdrh                   r1, r2, dest, SQLITE_NULLEQ);
33776a2fe093Sdrh       testcase( regFree1==0 );
33786a2fe093Sdrh       testcase( regFree2==0 );
33796a2fe093Sdrh       break;
33806a2fe093Sdrh     }
3381cce7d176Sdrh     case TK_ISNULL:
3382cce7d176Sdrh     case TK_NOTNULL: {
3383c5499befSdrh       testcase( op==TK_ISNULL );
3384c5499befSdrh       testcase( op==TK_NOTNULL );
33852dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr->pLeft, &regFree1);
33862dcef11bSdrh       sqlite3VdbeAddOp2(v, op, r1, dest);
3387c5499befSdrh       testcase( regFree1==0 );
3388cce7d176Sdrh       break;
3389cce7d176Sdrh     }
3390fef5208cSdrh     case TK_BETWEEN: {
33915c03f30aSdrh       testcase( jumpIfNull==0 );
339236c563a2Sdrh       exprCodeBetween(pParse, pExpr, dest, 0, jumpIfNull);
3393fef5208cSdrh       break;
3394fef5208cSdrh     }
3395bb201344Sshaneh #ifndef SQLITE_OMIT_SUBQUERY
3396e3365e6cSdrh     case TK_IN: {
3397e3365e6cSdrh       if( jumpIfNull ){
3398e3365e6cSdrh         sqlite3ExprCodeIN(pParse, pExpr, dest, dest);
3399e3365e6cSdrh       }else{
3400e3365e6cSdrh         int destIfNull = sqlite3VdbeMakeLabel(v);
3401e3365e6cSdrh         sqlite3ExprCodeIN(pParse, pExpr, dest, destIfNull);
3402e3365e6cSdrh         sqlite3VdbeResolveLabel(v, destIfNull);
3403e3365e6cSdrh       }
3404e3365e6cSdrh       break;
3405e3365e6cSdrh     }
3406bb201344Sshaneh #endif
3407cce7d176Sdrh     default: {
34082dcef11bSdrh       r1 = sqlite3ExprCodeTemp(pParse, pExpr, &regFree1);
34092dcef11bSdrh       sqlite3VdbeAddOp3(v, OP_IfNot, r1, dest, jumpIfNull!=0);
3410c5499befSdrh       testcase( regFree1==0 );
3411c5499befSdrh       testcase( jumpIfNull==0 );
3412cce7d176Sdrh       break;
3413cce7d176Sdrh     }
3414cce7d176Sdrh   }
34152dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree1);
34162dcef11bSdrh   sqlite3ReleaseTempReg(pParse, regFree2);
3417cce7d176Sdrh }
34182282792aSdrh 
34192282792aSdrh /*
34201d9da70aSdrh ** Do a deep comparison of two expression trees.  Return 0 if the two
34211d9da70aSdrh ** expressions are completely identical.  Return 1 if they differ only
34221d9da70aSdrh ** by a COLLATE operator at the top level.  Return 2 if there are differences
34231d9da70aSdrh ** other than the top-level COLLATE operator.
3424d40aab0eSdrh **
34251d9da70aSdrh ** Sometimes this routine will return 2 even if the two expressions
3426d40aab0eSdrh ** really are equivalent.  If we cannot prove that the expressions are
34271d9da70aSdrh ** identical, we return 2 just to be safe.  So if this routine
34281d9da70aSdrh ** returns 2, then you do not really know for certain if the two
34291d9da70aSdrh ** expressions are the same.  But if you get a 0 or 1 return, then you
3430d40aab0eSdrh ** can be sure the expressions are the same.  In the places where
34311d9da70aSdrh ** this routine is used, it does not hurt to get an extra 2 - that
3432d40aab0eSdrh ** just might result in some slightly slower code.  But returning
34331d9da70aSdrh ** an incorrect 0 or 1 could lead to a malfunction.
34342282792aSdrh */
34354adee20fSdanielk1977 int sqlite3ExprCompare(Expr *pA, Expr *pB){
34364b202ae2Sdanielk1977   if( pA==0||pB==0 ){
34371d9da70aSdrh     return pB==pA ? 0 : 2;
34382282792aSdrh   }
343933e619fcSdrh   assert( !ExprHasAnyProperty(pA, EP_TokenOnly|EP_Reduced) );
344033e619fcSdrh   assert( !ExprHasAnyProperty(pB, EP_TokenOnly|EP_Reduced) );
34416ab3a2ecSdanielk1977   if( ExprHasProperty(pA, EP_xIsSelect) || ExprHasProperty(pB, EP_xIsSelect) ){
34421d9da70aSdrh     return 2;
34436ab3a2ecSdanielk1977   }
34441d9da70aSdrh   if( (pA->flags & EP_Distinct)!=(pB->flags & EP_Distinct) ) return 2;
34451d9da70aSdrh   if( pA->op!=pB->op ) return 2;
34461d9da70aSdrh   if( sqlite3ExprCompare(pA->pLeft, pB->pLeft) ) return 2;
34471d9da70aSdrh   if( sqlite3ExprCompare(pA->pRight, pB->pRight) ) return 2;
34488c6f666bSdrh   if( sqlite3ExprListCompare(pA->x.pList, pB->x.pList) ) return 2;
34491d9da70aSdrh   if( pA->iTable!=pB->iTable || pA->iColumn!=pB->iColumn ) return 2;
345033e619fcSdrh   if( ExprHasProperty(pA, EP_IntValue) ){
345133e619fcSdrh     if( !ExprHasProperty(pB, EP_IntValue) || pA->u.iValue!=pB->u.iValue ){
34521d9da70aSdrh       return 2;
345333e619fcSdrh     }
345433e619fcSdrh   }else if( pA->op!=TK_COLUMN && pA->u.zToken ){
34551d9da70aSdrh     if( ExprHasProperty(pB, EP_IntValue) || NEVER(pB->u.zToken==0) ) return 2;
345633e619fcSdrh     if( sqlite3StrICmp(pA->u.zToken,pB->u.zToken)!=0 ){
34571d9da70aSdrh       return 2;
34581d9da70aSdrh     }
34591d9da70aSdrh   }
34601d9da70aSdrh   if( (pA->flags & EP_ExpCollate)!=(pB->flags & EP_ExpCollate) ) return 1;
34611d9da70aSdrh   if( (pA->flags & EP_ExpCollate)!=0 && pA->pColl!=pB->pColl ) return 2;
34622646da7eSdrh   return 0;
34632646da7eSdrh }
34642282792aSdrh 
34658c6f666bSdrh /*
34668c6f666bSdrh ** Compare two ExprList objects.  Return 0 if they are identical and
34678c6f666bSdrh ** non-zero if they differ in any way.
34688c6f666bSdrh **
34698c6f666bSdrh ** This routine might return non-zero for equivalent ExprLists.  The
34708c6f666bSdrh ** only consequence will be disabled optimizations.  But this routine
34718c6f666bSdrh ** must never return 0 if the two ExprList objects are different, or
34728c6f666bSdrh ** a malfunction will result.
34738c6f666bSdrh **
34748c6f666bSdrh ** Two NULL pointers are considered to be the same.  But a NULL pointer
34758c6f666bSdrh ** always differs from a non-NULL pointer.
34768c6f666bSdrh */
34778c6f666bSdrh int sqlite3ExprListCompare(ExprList *pA, ExprList *pB){
34788c6f666bSdrh   int i;
34798c6f666bSdrh   if( pA==0 && pB==0 ) return 0;
34808c6f666bSdrh   if( pA==0 || pB==0 ) return 1;
34818c6f666bSdrh   if( pA->nExpr!=pB->nExpr ) return 1;
34828c6f666bSdrh   for(i=0; i<pA->nExpr; i++){
34838c6f666bSdrh     Expr *pExprA = pA->a[i].pExpr;
34848c6f666bSdrh     Expr *pExprB = pB->a[i].pExpr;
34858c6f666bSdrh     if( pA->a[i].sortOrder!=pB->a[i].sortOrder ) return 1;
34868c6f666bSdrh     if( sqlite3ExprCompare(pExprA, pExprB) ) return 1;
34878c6f666bSdrh   }
34888c6f666bSdrh   return 0;
34898c6f666bSdrh }
349013449892Sdrh 
34912282792aSdrh /*
349213449892Sdrh ** Add a new element to the pAggInfo->aCol[] array.  Return the index of
349313449892Sdrh ** the new element.  Return a negative number if malloc fails.
34942282792aSdrh */
349517435752Sdrh static int addAggInfoColumn(sqlite3 *db, AggInfo *pInfo){
349613449892Sdrh   int i;
3497cf643729Sdrh   pInfo->aCol = sqlite3ArrayAllocate(
349817435752Sdrh        db,
3499cf643729Sdrh        pInfo->aCol,
3500cf643729Sdrh        sizeof(pInfo->aCol[0]),
3501cf643729Sdrh        3,
3502cf643729Sdrh        &pInfo->nColumn,
3503cf643729Sdrh        &pInfo->nColumnAlloc,
3504cf643729Sdrh        &i
3505cf643729Sdrh   );
350613449892Sdrh   return i;
35072282792aSdrh }
350813449892Sdrh 
350913449892Sdrh /*
351013449892Sdrh ** Add a new element to the pAggInfo->aFunc[] array.  Return the index of
351113449892Sdrh ** the new element.  Return a negative number if malloc fails.
351213449892Sdrh */
351317435752Sdrh static int addAggInfoFunc(sqlite3 *db, AggInfo *pInfo){
351413449892Sdrh   int i;
3515cf643729Sdrh   pInfo->aFunc = sqlite3ArrayAllocate(
351617435752Sdrh        db,
3517cf643729Sdrh        pInfo->aFunc,
3518cf643729Sdrh        sizeof(pInfo->aFunc[0]),
3519cf643729Sdrh        3,
3520cf643729Sdrh        &pInfo->nFunc,
3521cf643729Sdrh        &pInfo->nFuncAlloc,
3522cf643729Sdrh        &i
3523cf643729Sdrh   );
352413449892Sdrh   return i;
35252282792aSdrh }
35262282792aSdrh 
35272282792aSdrh /*
35287d10d5a6Sdrh ** This is the xExprCallback for a tree walker.  It is used to
35297d10d5a6Sdrh ** implement sqlite3ExprAnalyzeAggregates().  See sqlite3ExprAnalyzeAggregates
3530626a879aSdrh ** for additional information.
35312282792aSdrh */
35327d10d5a6Sdrh static int analyzeAggregate(Walker *pWalker, Expr *pExpr){
35332282792aSdrh   int i;
35347d10d5a6Sdrh   NameContext *pNC = pWalker->u.pNC;
3535a58fdfb1Sdanielk1977   Parse *pParse = pNC->pParse;
3536a58fdfb1Sdanielk1977   SrcList *pSrcList = pNC->pSrcList;
353713449892Sdrh   AggInfo *pAggInfo = pNC->pAggInfo;
353813449892Sdrh 
35392282792aSdrh   switch( pExpr->op ){
354089c69d00Sdrh     case TK_AGG_COLUMN:
3541967e8b73Sdrh     case TK_COLUMN: {
35428b213899Sdrh       testcase( pExpr->op==TK_AGG_COLUMN );
35438b213899Sdrh       testcase( pExpr->op==TK_COLUMN );
354413449892Sdrh       /* Check to see if the column is in one of the tables in the FROM
354513449892Sdrh       ** clause of the aggregate query */
354620bc393cSdrh       if( ALWAYS(pSrcList!=0) ){
354713449892Sdrh         struct SrcList_item *pItem = pSrcList->a;
354813449892Sdrh         for(i=0; i<pSrcList->nSrc; i++, pItem++){
354913449892Sdrh           struct AggInfo_col *pCol;
355033e619fcSdrh           assert( !ExprHasAnyProperty(pExpr, EP_TokenOnly|EP_Reduced) );
355113449892Sdrh           if( pExpr->iTable==pItem->iCursor ){
355213449892Sdrh             /* If we reach this point, it means that pExpr refers to a table
355313449892Sdrh             ** that is in the FROM clause of the aggregate query.
355413449892Sdrh             **
355513449892Sdrh             ** Make an entry for the column in pAggInfo->aCol[] if there
355613449892Sdrh             ** is not an entry there already.
355713449892Sdrh             */
35587f906d63Sdrh             int k;
355913449892Sdrh             pCol = pAggInfo->aCol;
35607f906d63Sdrh             for(k=0; k<pAggInfo->nColumn; k++, pCol++){
356113449892Sdrh               if( pCol->iTable==pExpr->iTable &&
356213449892Sdrh                   pCol->iColumn==pExpr->iColumn ){
35632282792aSdrh                 break;
35642282792aSdrh               }
35652282792aSdrh             }
35661e536953Sdanielk1977             if( (k>=pAggInfo->nColumn)
35671e536953Sdanielk1977              && (k = addAggInfoColumn(pParse->db, pAggInfo))>=0
35681e536953Sdanielk1977             ){
35697f906d63Sdrh               pCol = &pAggInfo->aCol[k];
35700817d0dfSdanielk1977               pCol->pTab = pExpr->pTab;
357113449892Sdrh               pCol->iTable = pExpr->iTable;
357213449892Sdrh               pCol->iColumn = pExpr->iColumn;
35730a07c107Sdrh               pCol->iMem = ++pParse->nMem;
357413449892Sdrh               pCol->iSorterColumn = -1;
35755774b806Sdrh               pCol->pExpr = pExpr;
357613449892Sdrh               if( pAggInfo->pGroupBy ){
357713449892Sdrh                 int j, n;
357813449892Sdrh                 ExprList *pGB = pAggInfo->pGroupBy;
357913449892Sdrh                 struct ExprList_item *pTerm = pGB->a;
358013449892Sdrh                 n = pGB->nExpr;
358113449892Sdrh                 for(j=0; j<n; j++, pTerm++){
358213449892Sdrh                   Expr *pE = pTerm->pExpr;
358313449892Sdrh                   if( pE->op==TK_COLUMN && pE->iTable==pExpr->iTable &&
358413449892Sdrh                       pE->iColumn==pExpr->iColumn ){
358513449892Sdrh                     pCol->iSorterColumn = j;
358613449892Sdrh                     break;
35872282792aSdrh                   }
358813449892Sdrh                 }
358913449892Sdrh               }
359013449892Sdrh               if( pCol->iSorterColumn<0 ){
359113449892Sdrh                 pCol->iSorterColumn = pAggInfo->nSortingColumn++;
359213449892Sdrh               }
359313449892Sdrh             }
359413449892Sdrh             /* There is now an entry for pExpr in pAggInfo->aCol[] (either
359513449892Sdrh             ** because it was there before or because we just created it).
359613449892Sdrh             ** Convert the pExpr to be a TK_AGG_COLUMN referring to that
359713449892Sdrh             ** pAggInfo->aCol[] entry.
359813449892Sdrh             */
359933e619fcSdrh             ExprSetIrreducible(pExpr);
360013449892Sdrh             pExpr->pAggInfo = pAggInfo;
360113449892Sdrh             pExpr->op = TK_AGG_COLUMN;
3602cf697396Sshane             pExpr->iAgg = (i16)k;
360313449892Sdrh             break;
360413449892Sdrh           } /* endif pExpr->iTable==pItem->iCursor */
360513449892Sdrh         } /* end loop over pSrcList */
3606a58fdfb1Sdanielk1977       }
36077d10d5a6Sdrh       return WRC_Prune;
36082282792aSdrh     }
36092282792aSdrh     case TK_AGG_FUNCTION: {
361013449892Sdrh       /* The pNC->nDepth==0 test causes aggregate functions in subqueries
361113449892Sdrh       ** to be ignored */
3612a58fdfb1Sdanielk1977       if( pNC->nDepth==0 ){
361313449892Sdrh         /* Check to see if pExpr is a duplicate of another aggregate
361413449892Sdrh         ** function that is already in the pAggInfo structure
361513449892Sdrh         */
361613449892Sdrh         struct AggInfo_func *pItem = pAggInfo->aFunc;
361713449892Sdrh         for(i=0; i<pAggInfo->nFunc; i++, pItem++){
36181d9da70aSdrh           if( sqlite3ExprCompare(pItem->pExpr, pExpr)==0 ){
36192282792aSdrh             break;
36202282792aSdrh           }
36212282792aSdrh         }
362213449892Sdrh         if( i>=pAggInfo->nFunc ){
362313449892Sdrh           /* pExpr is original.  Make a new entry in pAggInfo->aFunc[]
362413449892Sdrh           */
362514db2665Sdanielk1977           u8 enc = ENC(pParse->db);
36261e536953Sdanielk1977           i = addAggInfoFunc(pParse->db, pAggInfo);
362713449892Sdrh           if( i>=0 ){
36286ab3a2ecSdanielk1977             assert( !ExprHasProperty(pExpr, EP_xIsSelect) );
362913449892Sdrh             pItem = &pAggInfo->aFunc[i];
363013449892Sdrh             pItem->pExpr = pExpr;
36310a07c107Sdrh             pItem->iMem = ++pParse->nMem;
363233e619fcSdrh             assert( !ExprHasProperty(pExpr, EP_IntValue) );
363313449892Sdrh             pItem->pFunc = sqlite3FindFunction(pParse->db,
363433e619fcSdrh                    pExpr->u.zToken, sqlite3Strlen30(pExpr->u.zToken),
36356ab3a2ecSdanielk1977                    pExpr->x.pList ? pExpr->x.pList->nExpr : 0, enc, 0);
3636fd357974Sdrh             if( pExpr->flags & EP_Distinct ){
3637fd357974Sdrh               pItem->iDistinct = pParse->nTab++;
3638fd357974Sdrh             }else{
3639fd357974Sdrh               pItem->iDistinct = -1;
3640fd357974Sdrh             }
36412282792aSdrh           }
364213449892Sdrh         }
364313449892Sdrh         /* Make pExpr point to the appropriate pAggInfo->aFunc[] entry
364413449892Sdrh         */
364533e619fcSdrh         assert( !ExprHasAnyProperty(pExpr, EP_TokenOnly|EP_Reduced) );
364633e619fcSdrh         ExprSetIrreducible(pExpr);
3647cf697396Sshane         pExpr->iAgg = (i16)i;
364813449892Sdrh         pExpr->pAggInfo = pAggInfo;
36497d10d5a6Sdrh         return WRC_Prune;
36502282792aSdrh       }
36512282792aSdrh     }
3652a58fdfb1Sdanielk1977   }
36537d10d5a6Sdrh   return WRC_Continue;
36547d10d5a6Sdrh }
36557d10d5a6Sdrh static int analyzeAggregatesInSelect(Walker *pWalker, Select *pSelect){
36567d10d5a6Sdrh   NameContext *pNC = pWalker->u.pNC;
36577d10d5a6Sdrh   if( pNC->nDepth==0 ){
3658a58fdfb1Sdanielk1977     pNC->nDepth++;
36597d10d5a6Sdrh     sqlite3WalkSelect(pWalker, pSelect);
3660a58fdfb1Sdanielk1977     pNC->nDepth--;
36617d10d5a6Sdrh     return WRC_Prune;
36627d10d5a6Sdrh   }else{
36637d10d5a6Sdrh     return WRC_Continue;
3664a58fdfb1Sdanielk1977   }
36652282792aSdrh }
3666626a879aSdrh 
3667626a879aSdrh /*
3668626a879aSdrh ** Analyze the given expression looking for aggregate functions and
3669626a879aSdrh ** for variables that need to be added to the pParse->aAgg[] array.
3670626a879aSdrh ** Make additional entries to the pParse->aAgg[] array as necessary.
3671626a879aSdrh **
3672626a879aSdrh ** This routine should only be called after the expression has been
36737d10d5a6Sdrh ** analyzed by sqlite3ResolveExprNames().
3674626a879aSdrh */
3675d2b3e23bSdrh void sqlite3ExprAnalyzeAggregates(NameContext *pNC, Expr *pExpr){
36767d10d5a6Sdrh   Walker w;
36777d10d5a6Sdrh   w.xExprCallback = analyzeAggregate;
36787d10d5a6Sdrh   w.xSelectCallback = analyzeAggregatesInSelect;
36797d10d5a6Sdrh   w.u.pNC = pNC;
368020bc393cSdrh   assert( pNC->pSrcList!=0 );
36817d10d5a6Sdrh   sqlite3WalkExpr(&w, pExpr);
36822282792aSdrh }
36835d9a4af9Sdrh 
36845d9a4af9Sdrh /*
36855d9a4af9Sdrh ** Call sqlite3ExprAnalyzeAggregates() for every expression in an
36865d9a4af9Sdrh ** expression list.  Return the number of errors.
36875d9a4af9Sdrh **
36885d9a4af9Sdrh ** If an error is found, the analysis is cut short.
36895d9a4af9Sdrh */
3690d2b3e23bSdrh void sqlite3ExprAnalyzeAggList(NameContext *pNC, ExprList *pList){
36915d9a4af9Sdrh   struct ExprList_item *pItem;
36925d9a4af9Sdrh   int i;
36935d9a4af9Sdrh   if( pList ){
3694d2b3e23bSdrh     for(pItem=pList->a, i=0; i<pList->nExpr; i++, pItem++){
3695d2b3e23bSdrh       sqlite3ExprAnalyzeAggregates(pNC, pItem->pExpr);
36965d9a4af9Sdrh     }
36975d9a4af9Sdrh   }
36985d9a4af9Sdrh }
3699892d3179Sdrh 
3700892d3179Sdrh /*
3701ceea3321Sdrh ** Allocate a single new register for use to hold some intermediate result.
3702892d3179Sdrh */
3703892d3179Sdrh int sqlite3GetTempReg(Parse *pParse){
3704e55cbd72Sdrh   if( pParse->nTempReg==0 ){
3705892d3179Sdrh     return ++pParse->nMem;
3706892d3179Sdrh   }
37072f425f6bSdanielk1977   return pParse->aTempReg[--pParse->nTempReg];
3708892d3179Sdrh }
3709ceea3321Sdrh 
3710ceea3321Sdrh /*
3711ceea3321Sdrh ** Deallocate a register, making available for reuse for some other
3712ceea3321Sdrh ** purpose.
3713ceea3321Sdrh **
3714ceea3321Sdrh ** If a register is currently being used by the column cache, then
3715ceea3321Sdrh ** the dallocation is deferred until the column cache line that uses
3716ceea3321Sdrh ** the register becomes stale.
3717ceea3321Sdrh */
3718892d3179Sdrh void sqlite3ReleaseTempReg(Parse *pParse, int iReg){
37192dcef11bSdrh   if( iReg && pParse->nTempReg<ArraySize(pParse->aTempReg) ){
3720ceea3321Sdrh     int i;
3721ceea3321Sdrh     struct yColCache *p;
3722ceea3321Sdrh     for(i=0, p=pParse->aColCache; i<SQLITE_N_COLCACHE; i++, p++){
3723ceea3321Sdrh       if( p->iReg==iReg ){
3724ceea3321Sdrh         p->tempReg = 1;
3725ceea3321Sdrh         return;
3726ceea3321Sdrh       }
3727ceea3321Sdrh     }
3728892d3179Sdrh     pParse->aTempReg[pParse->nTempReg++] = iReg;
3729892d3179Sdrh   }
3730892d3179Sdrh }
3731892d3179Sdrh 
3732892d3179Sdrh /*
3733892d3179Sdrh ** Allocate or deallocate a block of nReg consecutive registers
3734892d3179Sdrh */
3735892d3179Sdrh int sqlite3GetTempRange(Parse *pParse, int nReg){
3736e55cbd72Sdrh   int i, n;
3737892d3179Sdrh   i = pParse->iRangeReg;
3738e55cbd72Sdrh   n = pParse->nRangeReg;
3739f49f3523Sdrh   if( nReg<=n ){
3740f49f3523Sdrh     assert( !usedAsColumnCache(pParse, i, i+n-1) );
3741892d3179Sdrh     pParse->iRangeReg += nReg;
3742892d3179Sdrh     pParse->nRangeReg -= nReg;
3743892d3179Sdrh   }else{
3744892d3179Sdrh     i = pParse->nMem+1;
3745892d3179Sdrh     pParse->nMem += nReg;
3746892d3179Sdrh   }
3747892d3179Sdrh   return i;
3748892d3179Sdrh }
3749892d3179Sdrh void sqlite3ReleaseTempRange(Parse *pParse, int iReg, int nReg){
3750f49f3523Sdrh   sqlite3ExprCacheRemove(pParse, iReg, nReg);
3751892d3179Sdrh   if( nReg>pParse->nRangeReg ){
3752892d3179Sdrh     pParse->nRangeReg = nReg;
3753892d3179Sdrh     pParse->iRangeReg = iReg;
3754892d3179Sdrh   }
3755892d3179Sdrh }
3756