/ Hex Artifact Content
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact f02baff03e2a9ed7bdc36b363b8e4024a94de919:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68  mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d  ******.** This m
0180: 6f 64 75 6c 65 20 63 6f 6e 74 61 69 6e 73 20 43  odule contains C
0190: 20 63 6f 64 65 20 74 68 61 74 20 67 65 6e 65 72   code that gener
01a0: 61 74 65 73 20 56 44 42 45 20 63 6f 64 65 20 75  ates VDBE code u
01b0: 73 65 64 20 74 6f 20 70 72 6f 63 65 73 73 0a 2a  sed to process.*
01c0: 2a 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 75  * the WHERE clau
01d0: 73 65 20 6f 66 20 53 51 4c 20 73 74 61 74 65 6d  se of SQL statem
01e0: 65 6e 74 73 2e 20 20 54 68 69 73 20 6d 6f 64 75  ents.  This modu
01f0: 6c 65 20 69 73 20 72 65 70 6f 6e 73 69 62 6c 65  le is reponsible
0200: 20 66 6f 72 0a 2a 2a 20 67 65 6e 65 72 61 74 69   for.** generati
0210: 6e 67 20 74 68 65 20 63 6f 64 65 20 74 68 61 74  ng the code that
0220: 20 6c 6f 6f 70 73 20 74 68 72 6f 75 67 68 20 61   loops through a
0230: 20 74 61 62 6c 65 20 6c 6f 6f 6b 69 6e 67 20 66   table looking f
0240: 6f 72 20 61 70 70 6c 69 63 61 62 6c 65 0a 2a 2a  or applicable.**
0250: 20 72 6f 77 73 2e 20 20 49 6e 64 69 63 65 73 20   rows.  Indices 
0260: 61 72 65 20 73 65 6c 65 63 74 65 64 20 61 6e 64  are selected and
0270: 20 75 73 65 64 20 74 6f 20 73 70 65 65 64 20 74   used to speed t
0280: 68 65 20 73 65 61 72 63 68 20 77 68 65 6e 20 64  he search when d
0290: 6f 69 6e 67 0a 2a 2a 20 73 6f 20 69 73 20 61 70  oing.** so is ap
02a0: 70 6c 69 63 61 62 6c 65 2e 20 20 42 65 63 61 75  plicable.  Becau
02b0: 73 65 20 74 68 69 73 20 6d 6f 64 75 6c 65 20 69  se this module i
02c0: 73 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f  s responsible fo
02d0: 72 20 73 65 6c 65 63 74 69 6e 67 0a 2a 2a 20 69  r selecting.** i
02e0: 6e 64 69 63 65 73 2c 20 79 6f 75 20 6d 69 67 68  ndices, you migh
02f0: 74 20 61 6c 73 6f 20 74 68 69 6e 6b 20 6f 66 20  t also think of 
0300: 74 68 69 73 20 6d 6f 64 75 6c 65 20 61 73 20 74  this module as t
0310: 68 65 20 22 71 75 65 72 79 20 6f 70 74 69 6d 69  he "query optimi
0320: 7a 65 72 22 2e 0a 2a 2a 0a 2a 2a 20 24 49 64 3a  zer"..**.** $Id:
0330: 20 77 68 65 72 65 2e 63 2c 76 20 31 2e 31 33 38   where.c,v 1.138
0340: 20 32 30 30 35 2f 30 35 2f 31 39 20 30 31 3a 32   2005/05/19 01:2
0350: 36 3a 31 34 20 64 72 68 20 45 78 70 20 24 0a 2a  6:14 drh Exp $.*
0360: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69  /.#include "sqli
0370: 74 65 49 6e 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20  teInt.h"../*.** 
0380: 54 68 65 20 71 75 65 72 79 20 67 65 6e 65 72 61  The query genera
0390: 74 6f 72 20 75 73 65 73 20 61 6e 20 61 72 72 61  tor uses an arra
03a0: 79 20 6f 66 20 69 6e 73 74 61 6e 63 65 73 20 6f  y of instances o
03b0: 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65  f this structure
03c0: 20 74 6f 0a 2a 2a 20 68 65 6c 70 20 69 74 20 61   to.** help it a
03d0: 6e 61 6c 79 7a 65 20 74 68 65 20 73 75 62 65 78  nalyze the subex
03e0: 70 72 65 73 73 69 6f 6e 73 20 6f 66 20 74 68 65  pressions of the
03f0: 20 57 48 45 52 45 20 63 6c 61 75 73 65 2e 20 20   WHERE clause.  
0400: 45 61 63 68 20 57 48 45 52 45 0a 2a 2a 20 63 6c  Each WHERE.** cl
0410: 61 75 73 65 20 73 75 62 65 78 70 72 65 73 73 69  ause subexpressi
0420: 6f 6e 20 69 73 20 73 65 70 61 72 61 74 65 64 20  on is separated 
0430: 66 72 6f 6d 20 74 68 65 20 6f 74 68 65 72 73 20  from the others 
0440: 62 79 20 61 6e 20 41 4e 44 20 6f 70 65 72 61 74  by an AND operat
0450: 6f 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69 64  or..**.** The id
0460: 78 4c 65 66 74 20 61 6e 64 20 69 64 78 52 69 67  xLeft and idxRig
0470: 68 74 20 66 69 65 6c 64 73 20 61 72 65 20 74 68  ht fields are th
0480: 65 20 56 44 42 45 20 63 75 72 73 6f 72 20 6e 75  e VDBE cursor nu
0490: 6d 62 65 72 73 20 66 6f 72 20 74 68 65 0a 2a 2a  mbers for the.**
04a0: 20 74 61 62 6c 65 20 74 68 61 74 20 63 6f 6e 74   table that cont
04b0: 61 69 6e 73 20 74 68 65 20 63 6f 6c 75 6d 6e 20  ains the column 
04c0: 74 68 61 74 20 61 70 70 65 61 72 73 20 6f 6e 20  that appears on 
04d0: 74 68 65 20 6c 65 66 74 2d 68 61 6e 64 20 61 6e  the left-hand an
04e0: 64 0a 2a 2a 20 72 69 67 68 74 2d 68 61 6e 64 20  d.** right-hand 
04f0: 73 69 64 65 20 6f 66 20 45 78 70 72 49 6e 66 6f  side of ExprInfo
0500: 2e 70 2e 20 20 49 66 20 65 69 74 68 65 72 20 73  .p.  If either s
0510: 69 64 65 20 6f 66 20 45 78 70 72 49 6e 66 6f 2e  ide of ExprInfo.
0520: 70 20 69 73 0a 2a 2a 20 73 6f 6d 65 74 68 69 6e  p is.** somethin
0530: 67 20 6f 74 68 65 72 20 74 68 61 6e 20 61 20 73  g other than a s
0540: 69 6d 70 6c 65 20 63 6f 6c 75 6d 6e 20 72 65 66  imple column ref
0550: 65 72 65 6e 63 65 2c 20 74 68 65 6e 20 69 64 78  erence, then idx
0560: 4c 65 66 74 20 6f 72 0a 2a 2a 20 69 64 78 52 69  Left or.** idxRi
0570: 67 68 74 20 61 72 65 20 2d 31 2e 20 20 0a 2a 2a  ght are -1.  .**
0580: 0a 2a 2a 20 49 74 20 69 73 20 74 68 65 20 56 44  .** It is the VD
0590: 42 45 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72  BE cursor number
05a0: 20 69 73 20 74 68 65 20 76 61 6c 75 65 20 73 74   is the value st
05b0: 6f 72 65 64 20 69 6e 20 45 78 70 72 2e 69 54 61  ored in Expr.iTa
05c0: 62 6c 65 0a 2a 2a 20 77 68 65 6e 20 45 78 70 72  ble.** when Expr
05d0: 2e 6f 70 3d 3d 54 4b 5f 43 4f 4c 55 4d 4e 20 61  .op==TK_COLUMN a
05e0: 6e 64 20 74 68 65 20 76 61 6c 75 65 20 73 74 6f  nd the value sto
05f0: 72 65 64 20 69 6e 20 53 72 63 4c 69 73 74 2e 61  red in SrcList.a
0600: 5b 5d 2e 69 43 75 72 73 6f 72 2e 0a 2a 2a 0a 2a  [].iCursor..**.*
0610: 2a 20 70 72 65 72 65 71 4c 65 66 74 2c 20 70 72  * prereqLeft, pr
0620: 65 72 65 71 52 69 67 68 74 2c 20 61 6e 64 20 70  ereqRight, and p
0630: 72 65 72 65 71 41 6c 6c 20 72 65 63 6f 72 64 20  rereqAll record 
0640: 73 65 74 73 20 6f 66 20 63 75 72 73 6f 72 20 6e  sets of cursor n
0650: 75 6d 62 65 72 73 2c 0a 2a 2a 20 62 75 74 20 74  umbers,.** but t
0660: 68 65 79 20 64 6f 20 73 6f 20 69 6e 64 69 72 65  hey do so indire
0670: 63 74 6c 79 2e 20 20 41 20 73 69 6e 67 6c 65 20  ctly.  A single 
0680: 45 78 70 72 4d 61 73 6b 53 65 74 20 73 74 72 75  ExprMaskSet stru
0690: 63 74 75 72 65 20 74 72 61 6e 73 6c 61 74 65 73  cture translates
06a0: 0a 2a 2a 20 63 75 72 73 6f 72 20 6e 75 6d 62 65  .** cursor numbe
06b0: 72 20 69 6e 74 6f 20 62 69 74 73 20 61 6e 64 20  r into bits and 
06c0: 74 68 65 20 74 72 61 6e 73 6c 61 74 65 64 20 62  the translated b
06d0: 69 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20  it is stored in 
06e0: 74 68 65 20 70 72 65 72 65 71 0a 2a 2a 20 66 69  the prereq.** fi
06f0: 65 6c 64 73 2e 20 20 54 68 65 20 74 72 61 6e 73  elds.  The trans
0700: 6c 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 69  lation is used i
0710: 6e 20 6f 72 64 65 72 20 74 6f 20 6d 61 78 69 6d  n order to maxim
0720: 69 7a 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  ize the number o
0730: 66 0a 2a 2a 20 62 69 74 73 20 74 68 61 74 20 77  f.** bits that w
0740: 69 6c 6c 20 66 69 74 20 69 6e 20 61 20 42 69 74  ill fit in a Bit
0750: 6d 61 73 6b 2e 20 20 54 68 65 20 56 44 42 45 20  mask.  The VDBE 
0760: 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 73 20 6d  cursor numbers m
0770: 69 67 68 74 20 62 65 0a 2a 2a 20 73 70 72 65 61  ight be.** sprea
0780: 64 20 6f 75 74 20 6f 76 65 72 20 74 68 65 20 6e  d out over the n
0790: 6f 6e 2d 6e 65 67 61 74 69 76 65 20 69 6e 74 65  on-negative inte
07a0: 67 65 72 73 2e 20 20 46 6f 72 20 65 78 61 6d 70  gers.  For examp
07b0: 6c 65 2c 20 74 68 65 20 63 75 72 73 6f 72 0a 2a  le, the cursor.*
07c0: 2a 20 6e 75 6d 62 65 72 73 20 6d 69 67 68 74 20  * numbers might 
07d0: 62 65 20 33 2c 20 38 2c 20 39 2c 20 31 30 2c 20  be 3, 8, 9, 10, 
07e0: 32 30 2c 20 32 33 2c 20 34 31 2c 20 61 6e 64 20  20, 23, 41, and 
07f0: 34 35 2e 20 20 54 68 65 20 45 78 70 72 4d 61 73  45.  The ExprMas
0800: 6b 53 65 74 0a 2a 2a 20 74 72 61 6e 73 6c 61 74  kSet.** translat
0810: 65 73 20 74 68 65 73 65 20 73 70 61 72 73 65 20  es these sparse 
0820: 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 73 20 69  cursor numbers i
0830: 6e 74 6f 20 63 6f 6e 73 65 63 75 74 69 76 65 20  nto consecutive 
0840: 69 6e 74 65 67 65 72 73 0a 2a 2a 20 62 65 67 69  integers.** begi
0850: 6e 6e 69 6e 67 20 77 69 74 68 20 30 20 69 6e 20  nning with 0 in 
0860: 6f 72 64 65 72 20 74 6f 20 6d 61 6b 65 20 74 68  order to make th
0870: 65 20 62 65 73 74 20 70 6f 73 73 69 62 6c 65 20  e best possible 
0880: 75 73 65 20 6f 66 20 74 68 65 20 61 76 61 69 6c  use of the avail
0890: 61 62 6c 65 0a 2a 2a 20 62 69 74 73 20 69 6e 20  able.** bits in 
08a0: 74 68 65 20 42 69 74 6d 61 73 6b 2e 20 20 53 6f  the Bitmask.  So
08b0: 2c 20 69 6e 20 74 68 65 20 65 78 61 6d 70 6c 65  , in the example
08c0: 20 61 62 6f 76 65 2c 20 74 68 65 20 63 75 72 73   above, the curs
08d0: 6f 72 20 6e 75 6d 62 65 72 73 0a 2a 2a 20 77 6f  or numbers.** wo
08e0: 75 6c 64 20 62 65 20 6d 61 70 70 65 64 20 69 6e  uld be mapped in
08f0: 74 6f 20 69 6e 74 65 67 65 72 73 20 30 20 74 68  to integers 0 th
0900: 72 6f 75 67 68 20 37 2e 0a 2a 2a 0a 2a 2a 20 70  rough 7..**.** p
0910: 72 65 72 65 71 4c 65 66 74 20 74 65 6c 6c 73 20  rereqLeft tells 
0920: 75 73 20 65 76 65 72 79 20 56 44 42 45 20 63 75  us every VDBE cu
0930: 72 73 6f 72 20 74 68 61 74 20 69 73 20 72 65 66  rsor that is ref
0940: 65 72 65 6e 63 65 64 20 6f 6e 20 74 68 65 0a 2a  erenced on the.*
0950: 2a 20 6c 65 66 74 2d 68 61 6e 64 20 73 69 64 65  * left-hand side
0960: 20 6f 66 20 45 78 70 72 49 6e 66 6f 2e 70 2e 20   of ExprInfo.p. 
0970: 20 70 72 65 72 65 71 52 69 67 68 74 20 64 6f 65   prereqRight doe
0980: 73 20 74 68 65 20 73 61 6d 65 20 66 6f 72 20 74  s the same for t
0990: 68 65 0a 2a 2a 20 72 69 67 68 74 2d 68 61 6e 64  he.** right-hand
09a0: 20 73 69 64 65 20 6f 66 20 74 68 65 20 65 78 70   side of the exp
09b0: 72 65 73 73 69 6f 6e 2e 20 20 54 68 65 20 66 6f  ression.  The fo
09c0: 6c 6c 6f 77 69 6e 67 20 69 64 65 6e 74 69 74 79  llowing identity
09d0: 20 61 6c 77 61 79 73 0a 2a 2a 20 68 6f 6c 64 73   always.** holds
09e0: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 70 72  :.**.**       pr
09f0: 65 72 65 71 41 6c 6c 20 3d 20 70 72 65 72 65 71  ereqAll = prereq
0a00: 4c 65 66 74 20 7c 20 70 72 65 72 65 71 52 69 67  Left | prereqRig
0a10: 68 74 0a 2a 2a 0a 2a 2a 20 54 68 65 20 45 78 70  ht.**.** The Exp
0a20: 72 49 6e 66 6f 2e 69 6e 64 65 78 61 62 6c 65 20  rInfo.indexable 
0a30: 66 69 65 6c 64 20 69 73 20 74 72 75 65 20 69 66  field is true if
0a40: 20 74 68 65 20 45 78 70 72 49 6e 66 6f 2e 70 20   the ExprInfo.p 
0a50: 65 78 70 72 65 73 73 69 6f 6e 0a 2a 2a 20 69 73  expression.** is
0a60: 20 6f 66 20 61 20 66 6f 72 6d 20 74 68 61 74 20   of a form that 
0a70: 6d 69 67 68 74 20 63 6f 6e 74 72 6f 6c 20 61 6e  might control an
0a80: 20 69 6e 64 65 78 2e 20 20 49 6e 64 65 78 61 62   index.  Indexab
0a90: 6c 65 20 65 78 70 72 65 73 73 69 6f 6e 73 0a 2a  le expressions.*
0aa0: 2a 20 6c 6f 6f 6b 20 6c 69 6b 65 20 74 68 69 73  * look like this
0ab0: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20  :.**.**         
0ac0: 20 20 20 20 20 3c 63 6f 6c 75 6d 6e 3e 20 3c 6f       <column> <o
0ad0: 70 3e 20 3c 65 78 70 72 3e 0a 2a 2a 0a 2a 2a 20  p> <expr>.**.** 
0ae0: 57 68 65 72 65 20 3c 63 6f 6c 75 6d 6e 3e 20 69  Where <column> i
0af0: 73 20 61 20 73 69 6d 70 6c 65 20 63 6f 6c 75 6d  s a simple colum
0b00: 6e 20 6e 61 6d 65 20 61 6e 64 20 3c 6f 70 3e 20  n name and <op> 
0b10: 69 73 20 6f 6e 20 6f 66 20 74 68 65 20 6f 70 65  is on of the ope
0b20: 72 61 74 6f 72 73 0a 2a 2a 20 74 68 61 74 20 61  rators.** that a
0b30: 6c 6c 6f 77 65 64 4f 70 28 29 20 72 65 63 6f 67  llowedOp() recog
0b40: 6e 69 7a 65 73 2e 20 20 0a 2a 2f 0a 74 79 70 65  nizes.  .*/.type
0b50: 64 65 66 20 73 74 72 75 63 74 20 45 78 70 72 49  def struct ExprI
0b60: 6e 66 6f 20 45 78 70 72 49 6e 66 6f 3b 0a 73 74  nfo ExprInfo;.st
0b70: 72 75 63 74 20 45 78 70 72 49 6e 66 6f 20 7b 0a  ruct ExprInfo {.
0b80: 20 20 45 78 70 72 20 2a 70 3b 20 20 20 20 20 20    Expr *p;      
0b90: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69            /* Poi
0ba0: 6e 74 65 72 20 74 6f 20 74 68 65 20 73 75 62 65  nter to the sube
0bb0: 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a 20 20 75  xpression */.  u
0bc0: 38 20 69 6e 64 65 78 61 62 6c 65 3b 20 20 20 20  8 indexable;    
0bd0: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69         /* True i
0be0: 66 20 74 68 69 73 20 73 75 62 65 78 70 72 73 73  f this subexprss
0bf0: 69 6f 6e 20 69 73 20 75 73 61 62 6c 65 20 62 79  ion is usable by
0c00: 20 61 6e 20 69 6e 64 65 78 20 2a 2f 0a 20 20 73   an index */.  s
0c10: 68 6f 72 74 20 69 6e 74 20 69 64 78 4c 65 66 74  hort int idxLeft
0c20: 3b 20 20 20 20 20 20 2f 2a 20 70 2d 3e 70 4c 65  ;      /* p->pLe
0c30: 66 74 20 69 73 20 61 20 63 6f 6c 75 6d 6e 20 69  ft is a column i
0c40: 6e 20 74 68 69 73 20 74 61 62 6c 65 20 6e 75 6d  n this table num
0c50: 62 65 72 2e 20 2d 31 20 69 66 0a 20 20 20 20 20  ber. -1 if.     
0c60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0c70: 20 20 20 20 20 2a 2a 20 70 2d 3e 70 4c 65 66 74       ** p->pLeft
0c80: 20 69 73 20 6e 6f 74 20 74 68 65 20 63 6f 6c 75   is not the colu
0c90: 6d 6e 20 6f 66 20 61 6e 79 20 74 61 62 6c 65 20  mn of any table 
0ca0: 2a 2f 0a 20 20 73 68 6f 72 74 20 69 6e 74 20 69  */.  short int i
0cb0: 64 78 52 69 67 68 74 3b 20 20 20 20 20 2f 2a 20  dxRight;     /* 
0cc0: 70 2d 3e 70 52 69 67 68 74 20 69 73 20 61 20 63  p->pRight is a c
0cd0: 6f 6c 75 6d 6e 20 69 6e 20 74 68 69 73 20 74 61  olumn in this ta
0ce0: 62 6c 65 20 6e 75 6d 62 65 72 2e 20 2d 31 20 69  ble number. -1 i
0cf0: 66 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  f.              
0d00: 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 70              ** p
0d10: 2d 3e 70 52 69 67 68 74 20 69 73 20 6e 6f 74 20  ->pRight is not 
0d20: 74 68 65 20 63 6f 6c 75 6d 6e 20 6f 66 20 61 6e  the column of an
0d30: 79 20 74 61 62 6c 65 20 2a 2f 0a 20 20 42 69 74  y table */.  Bit
0d40: 6d 61 73 6b 20 70 72 65 72 65 71 4c 65 66 74 3b  mask prereqLeft;
0d50: 20 20 20 20 20 2f 2a 20 42 69 74 6d 61 73 6b 20       /* Bitmask 
0d60: 6f 66 20 74 61 62 6c 65 73 20 72 65 66 65 72 65  of tables refere
0d70: 6e 63 65 64 20 62 79 20 70 2d 3e 70 4c 65 66 74  nced by p->pLeft
0d80: 20 2a 2f 0a 20 20 42 69 74 6d 61 73 6b 20 70 72   */.  Bitmask pr
0d90: 65 72 65 71 52 69 67 68 74 3b 20 20 20 20 2f 2a  ereqRight;    /*
0da0: 20 42 69 74 6d 61 73 6b 20 6f 66 20 74 61 62 6c   Bitmask of tabl
0db0: 65 73 20 72 65 66 65 72 65 6e 63 65 64 20 62 79  es referenced by
0dc0: 20 70 2d 3e 70 52 69 67 68 74 20 2a 2f 0a 20 20   p->pRight */.  
0dd0: 42 69 74 6d 61 73 6b 20 70 72 65 72 65 71 41 6c  Bitmask prereqAl
0de0: 6c 3b 20 20 20 20 20 20 2f 2a 20 42 69 74 6d 61  l;      /* Bitma
0df0: 73 6b 20 6f 66 20 74 61 62 6c 65 73 20 72 65 66  sk of tables ref
0e00: 65 72 65 6e 63 65 64 20 62 79 20 70 20 2a 2f 0a  erenced by p */.
0e10: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73  };../*.** An ins
0e20: 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c  tance of the fol
0e30: 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65  lowing structure
0e40: 20 6b 65 65 70 73 20 74 72 61 63 6b 20 6f 66 20   keeps track of 
0e50: 61 20 6d 61 70 70 69 6e 67 0a 2a 2a 20 62 65 74  a mapping.** bet
0e60: 77 65 65 6e 20 56 44 42 45 20 63 75 72 73 6f 72  ween VDBE cursor
0e70: 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 62 69 74   numbers and bit
0e80: 73 20 6f 66 20 74 68 65 20 62 69 74 6d 61 73 6b  s of the bitmask
0e90: 73 20 69 6e 20 45 78 70 72 49 6e 66 6f 2e 0a 2a  s in ExprInfo..*
0ea0: 2a 0a 2a 2a 20 54 68 65 20 56 44 42 45 20 63 75  *.** The VDBE cu
0eb0: 72 73 6f 72 20 6e 75 6d 62 65 72 73 20 61 72 65  rsor numbers are
0ec0: 20 73 6d 61 6c 6c 20 69 6e 74 65 67 65 72 73 20   small integers 
0ed0: 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 0a 2a 2a  contained in .**
0ee0: 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 2e 69 43   SrcList_item.iC
0ef0: 75 72 73 6f 72 20 61 6e 64 20 45 78 70 72 2e 69  ursor and Expr.i
0f00: 54 61 62 6c 65 20 66 69 65 6c 64 73 2e 20 20 46  Table fields.  F
0f10: 6f 72 20 61 6e 79 20 67 69 76 65 6e 20 57 48 45  or any given WHE
0f20: 52 45 20 0a 2a 2a 20 63 6c 61 75 73 65 2c 20 74  RE .** clause, t
0f30: 68 65 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72  he cursor number
0f40: 73 20 6d 69 67 68 74 20 6e 6f 74 20 62 65 67 69  s might not begi
0f50: 6e 20 77 69 74 68 20 30 20 61 6e 64 20 74 68 65  n with 0 and the
0f60: 79 20 6d 69 67 68 74 0a 2a 2a 20 63 6f 6e 74 61  y might.** conta
0f70: 69 6e 20 67 61 70 73 20 69 6e 20 74 68 65 20 6e  in gaps in the n
0f80: 75 6d 62 65 72 69 6e 67 20 73 65 71 75 65 6e 63  umbering sequenc
0f90: 65 2e 20 20 42 75 74 20 77 65 20 77 61 6e 74 20  e.  But we want 
0fa0: 74 6f 20 6d 61 6b 65 20 6d 61 78 69 6d 75 6d 0a  to make maximum.
0fb0: 2a 2a 20 75 73 65 20 6f 66 20 74 68 65 20 62 69  ** use of the bi
0fc0: 74 73 20 69 6e 20 6f 75 72 20 62 69 74 6d 61 73  ts in our bitmas
0fd0: 6b 73 2e 20 20 54 68 69 73 20 73 74 72 75 63 74  ks.  This struct
0fe0: 75 72 65 20 70 72 6f 76 69 64 65 73 20 61 20 6d  ure provides a m
0ff0: 61 70 70 69 6e 67 0a 2a 2a 20 66 72 6f 6d 20 74  apping.** from t
1000: 68 65 20 73 70 61 72 73 65 20 63 75 72 73 6f 72  he sparse cursor
1010: 20 6e 75 6d 62 65 72 73 20 69 6e 74 6f 20 63 6f   numbers into co
1020: 6e 73 65 63 75 74 69 76 65 20 69 6e 74 65 67 65  nsecutive intege
1030: 72 73 20 62 65 67 69 6e 6e 69 6e 67 0a 2a 2a 20  rs beginning.** 
1040: 77 69 74 68 20 30 2e 0a 2a 2a 0a 2a 2a 20 49 66  with 0..**.** If
1050: 20 45 78 70 72 4d 61 73 6b 53 65 74 2e 69 78 5b   ExprMaskSet.ix[
1060: 41 5d 3d 3d 42 20 69 74 20 6d 65 61 6e 73 20 74  A]==B it means t
1070: 68 61 74 20 54 68 65 20 41 2d 74 68 20 62 69 74  hat The A-th bit
1080: 20 6f 66 20 61 20 42 69 74 6d 61 73 6b 0a 2a 2a   of a Bitmask.**
1090: 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 56 44 42   corresponds VDB
10a0: 45 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 20  E cursor number 
10b0: 42 2e 20 20 54 68 65 20 41 2d 74 68 20 62 69 74  B.  The A-th bit
10c0: 20 6f 66 20 61 20 62 69 74 6d 61 73 6b 20 69 73   of a bitmask is
10d0: 20 31 3c 3c 41 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72   1<<A..**.** For
10e0: 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 74 68 65   example, if the
10f0: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 65 78   WHERE clause ex
1100: 70 72 65 73 73 69 6f 6e 20 75 73 65 64 20 74 68  pression used th
1110: 65 73 65 20 56 44 42 45 0a 2a 2a 20 63 75 72 73  ese VDBE.** curs
1120: 6f 72 73 3a 20 20 34 2c 20 35 2c 20 38 2c 20 32  ors:  4, 5, 8, 2
1130: 39 2c 20 35 37 2c 20 37 33 2e 20 20 54 68 65 6e  9, 57, 73.  Then
1140: 20 74 68 65 20 20 45 78 70 72 4d 61 73 6b 53 65   the  ExprMaskSe
1150: 74 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 77  t structure.** w
1160: 6f 75 6c 64 20 6d 61 70 20 74 68 6f 73 65 20 63  ould map those c
1170: 75 72 73 6f 72 20 6e 75 6d 62 65 72 73 20 69 6e  ursor numbers in
1180: 74 6f 20 62 69 74 73 20 30 20 74 68 72 6f 75 67  to bits 0 throug
1190: 68 20 35 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20  h 5..**.** Note 
11a0: 74 68 61 74 20 74 68 65 20 6d 61 70 70 69 6e 67  that the mapping
11b0: 20 69 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72   is not necessar
11c0: 69 6c 79 20 6f 72 64 65 72 65 64 2e 20 20 49 6e  ily ordered.  In
11d0: 20 74 68 65 20 65 78 61 6d 70 6c 65 0a 2a 2a 20   the example.** 
11e0: 61 62 6f 76 65 2c 20 74 68 65 20 6d 61 70 70 69  above, the mappi
11f0: 6e 67 20 6d 69 67 68 74 20 67 6f 20 6c 69 6b 65  ng might go like
1200: 20 74 68 69 73 3a 20 20 34 2d 3e 33 2c 20 35 2d   this:  4->3, 5-
1210: 3e 31 2c 20 38 2d 3e 32 2c 20 32 39 2d 3e 30 2c  >1, 8->2, 29->0,
1220: 0a 2a 2a 20 35 37 2d 3e 35 2c 20 37 33 2d 3e 34  .** 57->5, 73->4
1230: 2e 20 20 4f 72 20 6f 6e 65 20 6f 66 20 37 31 39  .  Or one of 719
1240: 20 6f 74 68 65 72 20 63 6f 6d 62 69 6e 61 74 69   other combinati
1250: 6f 6e 73 20 6d 69 67 68 74 20 62 65 20 75 73 65  ons might be use
1260: 64 2e 20 49 74 0a 2a 2a 20 64 6f 65 73 20 6e 6f  d. It.** does no
1270: 74 20 72 65 61 6c 6c 79 20 6d 61 74 74 65 72 2e  t really matter.
1280: 20 20 57 68 61 74 20 69 73 20 69 6d 70 6f 72 74    What is import
1290: 61 6e 74 20 69 73 20 74 68 61 74 20 73 70 61 72  ant is that spar
12a0: 73 65 20 63 75 72 73 6f 72 0a 2a 2a 20 6e 75 6d  se cursor.** num
12b0: 62 65 72 73 20 61 6c 6c 20 67 65 74 20 6d 61 70  bers all get map
12c0: 70 65 64 20 69 6e 74 6f 20 62 69 74 20 6e 75 6d  ped into bit num
12d0: 62 65 72 73 20 74 68 61 74 20 62 65 67 69 6e 20  bers that begin 
12e0: 77 69 74 68 20 30 20 61 6e 64 20 63 6f 6e 74 61  with 0 and conta
12f0: 69 6e 0a 2a 2a 20 6e 6f 20 67 61 70 73 2e 0a 2a  in.** no gaps..*
1300: 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  /.typedef struct
1310: 20 45 78 70 72 4d 61 73 6b 53 65 74 20 45 78 70   ExprMaskSet Exp
1320: 72 4d 61 73 6b 53 65 74 3b 0a 73 74 72 75 63 74  rMaskSet;.struct
1330: 20 45 78 70 72 4d 61 73 6b 53 65 74 20 7b 0a 20   ExprMaskSet {. 
1340: 20 69 6e 74 20 6e 3b 20 20 20 20 20 20 20 20 20   int n;         
1350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1360: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 73 73 69  * Number of assi
1370: 67 6e 65 64 20 63 75 72 73 6f 72 20 76 61 6c 75  gned cursor valu
1380: 65 73 20 2a 2f 0a 20 20 69 6e 74 20 69 78 5b 73  es */.  int ix[s
1390: 69 7a 65 6f 66 28 42 69 74 6d 61 73 6b 29 2a 38  izeof(Bitmask)*8
13a0: 5d 3b 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 20  ];    /* Cursor 
13b0: 61 73 73 69 67 6e 65 64 20 74 6f 20 65 61 63 68  assigned to each
13c0: 20 62 69 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a   bit */.};../*.*
13d0: 2a 20 44 65 74 65 72 6d 69 6e 65 20 74 68 65 20  * Determine the 
13e0: 6e 75 6d 62 65 72 20 6f 66 20 65 6c 65 6d 65 6e  number of elemen
13f0: 74 73 20 69 6e 20 61 6e 20 61 72 72 61 79 2e 0a  ts in an array..
1400: 2a 2f 0a 23 64 65 66 69 6e 65 20 41 52 52 41 59  */.#define ARRAY
1410: 53 49 5a 45 28 58 29 20 20 28 73 69 7a 65 6f 66  SIZE(X)  (sizeof
1420: 28 58 29 2f 73 69 7a 65 6f 66 28 58 5b 30 5d 29  (X)/sizeof(X[0])
1430: 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f  )../*.** This ro
1440: 75 74 69 6e 65 20 69 64 65 6e 74 69 66 69 65 73  utine identifies
1450: 20 73 75 62 65 78 70 72 65 73 73 69 6f 6e 73 20   subexpressions 
1460: 69 6e 20 74 68 65 20 57 48 45 52 45 20 63 6c 61  in the WHERE cla
1470: 75 73 65 20 77 68 65 72 65 0a 2a 2a 20 65 61 63  use where.** eac
1480: 68 20 73 75 62 65 78 70 72 65 73 73 69 6f 6e 20  h subexpression 
1490: 69 73 20 73 65 70 61 72 61 74 65 20 62 79 20 74  is separate by t
14a0: 68 65 20 41 4e 44 20 6f 70 65 72 61 74 6f 72 2e  he AND operator.
14b0: 20 20 61 53 6c 6f 74 20 69 73 20 0a 2a 2a 20 66    aSlot is .** f
14c0: 69 6c 6c 65 64 20 77 69 74 68 20 70 6f 69 6e 74  illed with point
14d0: 65 72 73 20 74 6f 20 74 68 65 20 73 75 62 65 78  ers to the subex
14e0: 70 72 65 73 73 69 6f 6e 73 2e 20 20 46 6f 72 20  pressions.  For 
14f0: 65 78 61 6d 70 6c 65 3a 0a 2a 2a 0a 2a 2a 20 20  example:.**.**  
1500: 20 20 57 48 45 52 45 20 20 61 3d 3d 27 68 65 6c    WHERE  a=='hel
1510: 6c 6f 27 20 41 4e 44 20 63 6f 61 6c 65 73 63 65  lo' AND coalesce
1520: 28 62 2c 31 31 29 3c 31 30 20 41 4e 44 20 28 63  (b,11)<10 AND (c
1530: 2b 31 32 21 3d 64 20 4f 52 20 63 3d 3d 32 32 29  +12!=d OR c==22)
1540: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 5c 5f  .**           \_
1550: 5f 5f 5f 5f 5f 5f 5f 2f 20 20 20 20 20 5c 5f 5f  _______/     \__
1560: 5f 5f 5f 5f 5f 5f 5f 5f 5f 5f 5f 5f 5f 2f 20 20  _____________/  
1570: 20 20 20 5c 5f 5f 5f 5f 5f 5f 5f 5f 5f 5f 5f 5f     \____________
1580: 5f 5f 5f 5f 2f 0a 2a 2a 20 20 20 20 20 20 20 20  ____/.**        
1590: 20 20 20 20 73 6c 6f 74 5b 30 5d 20 20 20 20 20      slot[0]     
15a0: 20 20 20 20 20 20 20 73 6c 6f 74 5b 31 5d 20 20         slot[1]  
15b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 6c 6f               slo
15c0: 74 5b 32 5d 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6f  t[2].**.** The o
15d0: 72 69 67 69 6e 61 6c 20 57 48 45 52 45 20 63 6c  riginal WHERE cl
15e0: 61 75 73 65 20 69 6e 20 70 45 78 70 72 20 69 73  ause in pExpr is
15f0: 20 75 6e 61 6c 74 65 72 65 64 2e 20 20 41 6c 6c   unaltered.  All
1600: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a   this routine.**
1610: 20 64 6f 65 73 20 69 73 20 6d 61 6b 65 20 61 53   does is make aS
1620: 6c 6f 74 5b 5d 20 65 6e 74 72 69 65 73 20 70 6f  lot[] entries po
1630: 69 6e 74 20 74 6f 20 73 75 62 73 74 72 75 63 74  int to substruct
1640: 75 72 65 20 77 69 74 68 69 6e 20 70 45 78 70 72  ure within pExpr
1650: 2e 0a 2a 2a 0a 2a 2a 20 61 53 6c 6f 74 5b 5d 20  ..**.** aSlot[] 
1660: 69 73 20 61 6e 20 61 72 72 61 79 20 6f 66 20 73  is an array of s
1670: 75 62 65 78 70 72 65 73 73 69 6f 6e 73 20 73 74  ubexpressions st
1680: 72 75 63 74 75 72 65 73 2e 20 20 54 68 65 72 65  ructures.  There
1690: 20 61 72 65 20 6e 53 6c 6f 74 0a 2a 2a 20 73 70   are nSlot.** sp
16a0: 61 63 65 73 20 6c 65 66 74 20 69 6e 20 74 68 69  aces left in thi
16b0: 73 20 61 72 72 61 79 2e 20 20 54 68 69 73 20 72  s array.  This r
16c0: 6f 75 74 69 6e 65 20 66 69 6e 64 73 20 61 73 20  outine finds as 
16d0: 6d 61 6e 79 20 41 4e 44 2d 73 65 70 61 72 61 74  many AND-separat
16e0: 65 64 0a 2a 2a 20 73 75 62 65 78 70 72 65 73 73  ed.** subexpress
16f0: 69 6f 6e 73 20 61 73 20 69 74 20 63 61 6e 20 61  ions as it can a
1700: 6e 64 20 70 75 74 73 20 70 6f 69 6e 74 65 72 73  nd puts pointers
1710: 20 74 6f 20 74 68 6f 73 65 20 73 75 62 65 78 70   to those subexp
1720: 72 65 73 73 69 6f 6e 73 0a 2a 2a 20 69 6e 74 6f  ressions.** into
1730: 20 61 53 6c 6f 74 5b 5d 20 65 6e 74 72 69 65 73   aSlot[] entries
1740: 2e 20 20 54 68 65 20 72 65 74 75 72 6e 20 76 61  .  The return va
1750: 6c 75 65 20 69 73 20 74 68 65 20 6e 75 6d 62 65  lue is the numbe
1760: 72 20 6f 66 20 73 6c 6f 74 73 20 66 69 6c 6c 65  r of slots fille
1770: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  d..*/.static int
1780: 20 65 78 70 72 53 70 6c 69 74 28 69 6e 74 20 6e   exprSplit(int n
1790: 53 6c 6f 74 2c 20 45 78 70 72 49 6e 66 6f 20 2a  Slot, ExprInfo *
17a0: 61 53 6c 6f 74 2c 20 45 78 70 72 20 2a 70 45 78  aSlot, Expr *pEx
17b0: 70 72 29 7b 0a 20 20 69 6e 74 20 63 6e 74 20 3d  pr){.  int cnt =
17c0: 20 30 3b 0a 20 20 69 66 28 20 70 45 78 70 72 3d   0;.  if( pExpr=
17d0: 3d 30 20 7c 7c 20 6e 53 6c 6f 74 3c 31 20 29 20  =0 || nSlot<1 ) 
17e0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 69 66 28 20  return 0;.  if( 
17f0: 6e 53 6c 6f 74 3d 3d 31 20 7c 7c 20 70 45 78 70  nSlot==1 || pExp
1800: 72 2d 3e 6f 70 21 3d 54 4b 5f 41 4e 44 20 29 7b  r->op!=TK_AND ){
1810: 0a 20 20 20 20 61 53 6c 6f 74 5b 30 5d 2e 70 20  .    aSlot[0].p 
1820: 3d 20 70 45 78 70 72 3b 0a 20 20 20 20 72 65 74  = pExpr;.    ret
1830: 75 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 69 66 28  urn 1;.  }.  if(
1840: 20 70 45 78 70 72 2d 3e 70 4c 65 66 74 2d 3e 6f   pExpr->pLeft->o
1850: 70 21 3d 54 4b 5f 41 4e 44 20 29 7b 0a 20 20 20  p!=TK_AND ){.   
1860: 20 61 53 6c 6f 74 5b 30 5d 2e 70 20 3d 20 70 45   aSlot[0].p = pE
1870: 78 70 72 2d 3e 70 4c 65 66 74 3b 0a 20 20 20 20  xpr->pLeft;.    
1880: 63 6e 74 20 3d 20 31 20 2b 20 65 78 70 72 53 70  cnt = 1 + exprSp
1890: 6c 69 74 28 6e 53 6c 6f 74 2d 31 2c 20 26 61 53  lit(nSlot-1, &aS
18a0: 6c 6f 74 5b 31 5d 2c 20 70 45 78 70 72 2d 3e 70  lot[1], pExpr->p
18b0: 52 69 67 68 74 29 3b 0a 20 20 7d 65 6c 73 65 7b  Right);.  }else{
18c0: 0a 20 20 20 20 63 6e 74 20 3d 20 65 78 70 72 53  .    cnt = exprS
18d0: 70 6c 69 74 28 6e 53 6c 6f 74 2c 20 61 53 6c 6f  plit(nSlot, aSlo
18e0: 74 2c 20 70 45 78 70 72 2d 3e 70 4c 65 66 74 29  t, pExpr->pLeft)
18f0: 3b 0a 20 20 20 20 63 6e 74 20 2b 3d 20 65 78 70  ;.    cnt += exp
1900: 72 53 70 6c 69 74 28 6e 53 6c 6f 74 2d 63 6e 74  rSplit(nSlot-cnt
1910: 2c 20 26 61 53 6c 6f 74 5b 63 6e 74 5d 2c 20 70  , &aSlot[cnt], p
1920: 45 78 70 72 2d 3e 70 52 69 67 68 74 29 3b 0a 20  Expr->pRight);. 
1930: 20 7d 0a 20 20 72 65 74 75 72 6e 20 63 6e 74 3b   }.  return cnt;
1940: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61  .}../*.** Initia
1950: 6c 69 7a 65 20 61 6e 20 65 78 70 72 65 73 73 69  lize an expressi
1960: 6f 6e 20 6d 61 73 6b 20 73 65 74 0a 2a 2f 0a 23  on mask set.*/.#
1970: 64 65 66 69 6e 65 20 69 6e 69 74 4d 61 73 6b 53  define initMaskS
1980: 65 74 28 50 29 20 20 6d 65 6d 73 65 74 28 50 2c  et(P)  memset(P,
1990: 20 30 2c 20 73 69 7a 65 6f 66 28 2a 50 29 29 0a   0, sizeof(*P)).
19a0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
19b0: 65 20 62 69 74 6d 61 73 6b 20 66 6f 72 20 74 68  e bitmask for th
19c0: 65 20 67 69 76 65 6e 20 63 75 72 73 6f 72 20 6e  e given cursor n
19d0: 75 6d 62 65 72 2e 20 20 52 65 74 75 72 6e 20 30  umber.  Return 0
19e0: 20 69 66 0a 2a 2a 20 69 43 75 72 73 6f 72 20 69   if.** iCursor i
19f0: 73 20 6e 6f 74 20 69 6e 20 74 68 65 20 73 65 74  s not in the set
1a00: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 42 69 74 6d  ..*/.static Bitm
1a10: 61 73 6b 20 67 65 74 4d 61 73 6b 28 45 78 70 72  ask getMask(Expr
1a20: 4d 61 73 6b 53 65 74 20 2a 70 4d 61 73 6b 53 65  MaskSet *pMaskSe
1a30: 74 2c 20 69 6e 74 20 69 43 75 72 73 6f 72 29 7b  t, int iCursor){
1a40: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28  .  int i;.  for(
1a50: 69 3d 30 3b 20 69 3c 70 4d 61 73 6b 53 65 74 2d  i=0; i<pMaskSet-
1a60: 3e 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66  >n; i++){.    if
1a70: 28 20 70 4d 61 73 6b 53 65 74 2d 3e 69 78 5b 69  ( pMaskSet->ix[i
1a80: 5d 3d 3d 69 43 75 72 73 6f 72 20 29 7b 0a 20 20  ]==iCursor ){.  
1a90: 20 20 20 20 72 65 74 75 72 6e 20 28 28 42 69 74      return ((Bit
1aa0: 6d 61 73 6b 29 31 29 3c 3c 69 3b 0a 20 20 20 20  mask)1)<<i;.    
1ab0: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30  }.  }.  return 0
1ac0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74  ;.}../*.** Creat
1ad0: 65 20 61 20 6e 65 77 20 6d 61 73 6b 20 66 6f 72  e a new mask for
1ae0: 20 63 75 72 73 6f 72 20 69 43 75 72 73 6f 72 2e   cursor iCursor.
1af0: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
1b00: 63 72 65 61 74 65 4d 61 73 6b 28 45 78 70 72 4d  createMask(ExprM
1b10: 61 73 6b 53 65 74 20 2a 70 4d 61 73 6b 53 65 74  askSet *pMaskSet
1b20: 2c 20 69 6e 74 20 69 43 75 72 73 6f 72 29 7b 0a  , int iCursor){.
1b30: 20 20 69 66 28 20 70 4d 61 73 6b 53 65 74 2d 3e    if( pMaskSet->
1b40: 6e 3c 41 52 52 41 59 53 49 5a 45 28 70 4d 61 73  n<ARRAYSIZE(pMas
1b50: 6b 53 65 74 2d 3e 69 78 29 20 29 7b 0a 20 20 20  kSet->ix) ){.   
1b60: 20 70 4d 61 73 6b 53 65 74 2d 3e 69 78 5b 70 4d   pMaskSet->ix[pM
1b70: 61 73 6b 53 65 74 2d 3e 6e 2b 2b 5d 20 3d 20 69  askSet->n++] = i
1b80: 43 75 72 73 6f 72 3b 0a 20 20 7d 0a 7d 0a 0a 2f  Cursor;.  }.}../
1b90: 2a 0a 2a 2a 20 44 65 73 74 72 6f 79 20 61 6e 20  *.** Destroy an 
1ba0: 65 78 70 72 65 73 73 69 6f 6e 20 6d 61 73 6b 20  expression mask 
1bb0: 73 65 74 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 66  set.*/.#define f
1bc0: 72 65 65 4d 61 73 6b 53 65 74 28 50 29 20 20 20  reeMaskSet(P)   
1bd0: 2f 2a 20 4e 4f 2d 4f 50 20 2a 2f 0a 0a 2f 2a 0a  /* NO-OP */../*.
1be0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
1bf0: 77 61 6c 6b 73 20 28 72 65 63 75 72 73 69 76 65  walks (recursive
1c00: 6c 79 29 20 61 6e 20 65 78 70 72 65 73 73 69 6f  ly) an expressio
1c10: 6e 20 74 72 65 65 20 61 6e 64 20 67 65 6e 65 72  n tree and gener
1c20: 61 74 65 73 0a 2a 2a 20 61 20 62 69 74 6d 61 73  ates.** a bitmas
1c30: 6b 20 69 6e 64 69 63 61 74 69 6e 67 20 77 68 69  k indicating whi
1c40: 63 68 20 74 61 62 6c 65 73 20 61 72 65 20 75 73  ch tables are us
1c50: 65 64 20 69 6e 20 74 68 61 74 20 65 78 70 72 65  ed in that expre
1c60: 73 73 69 6f 6e 0a 2a 2a 20 74 72 65 65 2e 0a 2a  ssion.** tree..*
1c70: 2a 0a 2a 2a 20 49 6e 20 6f 72 64 65 72 20 66 6f  *.** In order fo
1c80: 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74  r this routine t
1c90: 6f 20 77 6f 72 6b 2c 20 74 68 65 20 63 61 6c 6c  o work, the call
1ca0: 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 6d 75 73  ing function mus
1cb0: 74 20 68 61 76 65 0a 2a 2a 20 70 72 65 76 69 6f  t have.** previo
1cc0: 75 73 6c 79 20 69 6e 76 6f 6b 65 64 20 73 71 6c  usly invoked sql
1cd0: 69 74 65 33 45 78 70 72 52 65 73 6f 6c 76 65 4e  ite3ExprResolveN
1ce0: 61 6d 65 73 28 29 20 6f 6e 20 74 68 65 20 65 78  ames() on the ex
1cf0: 70 72 65 73 73 69 6f 6e 2e 20 20 53 65 65 0a 2a  pression.  See.*
1d00: 2a 20 74 68 65 20 68 65 61 64 65 72 20 63 6f 6d  * the header com
1d10: 6d 65 6e 74 20 6f 6e 20 74 68 61 74 20 72 6f 75  ment on that rou
1d20: 74 69 6e 65 20 66 6f 72 20 61 64 64 69 74 69 6f  tine for additio
1d30: 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e  nal information.
1d40: 0a 2a 2a 20 54 68 65 20 73 71 6c 69 74 65 33 45  .** The sqlite3E
1d50: 78 70 72 52 65 73 6f 6c 76 65 4e 61 6d 65 73 28  xprResolveNames(
1d60: 29 20 72 6f 75 74 69 6e 65 73 20 6c 6f 6f 6b 73  ) routines looks
1d70: 20 66 6f 72 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65   for column name
1d80: 73 20 61 6e 64 0a 2a 2a 20 73 65 74 73 20 74 68  s and.** sets th
1d90: 65 69 72 20 6f 70 63 6f 64 65 73 20 74 6f 20 54  eir opcodes to T
1da0: 4b 5f 43 4f 4c 55 4d 4e 20 61 6e 64 20 74 68 65  K_COLUMN and the
1db0: 69 72 20 45 78 70 72 2e 69 54 61 62 6c 65 20 66  ir Expr.iTable f
1dc0: 69 65 6c 64 73 20 74 6f 0a 2a 2a 20 74 68 65 20  ields to.** the 
1dd0: 56 44 42 45 20 63 75 72 73 6f 72 20 6e 75 6d 62  VDBE cursor numb
1de0: 65 72 20 6f 66 20 74 68 65 20 74 61 62 6c 65 2e  er of the table.
1df0: 0a 2a 2f 0a 73 74 61 74 69 63 20 42 69 74 6d 61  .*/.static Bitma
1e00: 73 6b 20 65 78 70 72 4c 69 73 74 54 61 62 6c 65  sk exprListTable
1e10: 55 73 61 67 65 28 45 78 70 72 4d 61 73 6b 53 65  Usage(ExprMaskSe
1e20: 74 20 2a 2c 20 45 78 70 72 4c 69 73 74 20 2a 29  t *, ExprList *)
1e30: 3b 0a 73 74 61 74 69 63 20 42 69 74 6d 61 73 6b  ;.static Bitmask
1e40: 20 65 78 70 72 54 61 62 6c 65 55 73 61 67 65 28   exprTableUsage(
1e50: 45 78 70 72 4d 61 73 6b 53 65 74 20 2a 70 4d 61  ExprMaskSet *pMa
1e60: 73 6b 53 65 74 2c 20 45 78 70 72 20 2a 70 29 7b  skSet, Expr *p){
1e70: 0a 20 20 42 69 74 6d 61 73 6b 20 6d 61 73 6b 20  .  Bitmask mask 
1e80: 3d 20 30 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20  = 0;.  if( p==0 
1e90: 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 69 66  ) return 0;.  if
1ea0: 28 20 70 2d 3e 6f 70 3d 3d 54 4b 5f 43 4f 4c 55  ( p->op==TK_COLU
1eb0: 4d 4e 20 29 7b 0a 20 20 20 20 6d 61 73 6b 20 3d  MN ){.    mask =
1ec0: 20 67 65 74 4d 61 73 6b 28 70 4d 61 73 6b 53 65   getMask(pMaskSe
1ed0: 74 2c 20 70 2d 3e 69 54 61 62 6c 65 29 3b 0a 20  t, p->iTable);. 
1ee0: 20 20 20 72 65 74 75 72 6e 20 6d 61 73 6b 3b 0a     return mask;.
1ef0: 20 20 7d 0a 20 20 6d 61 73 6b 20 3d 20 65 78 70    }.  mask = exp
1f00: 72 54 61 62 6c 65 55 73 61 67 65 28 70 4d 61 73  rTableUsage(pMas
1f10: 6b 53 65 74 2c 20 70 2d 3e 70 52 69 67 68 74 29  kSet, p->pRight)
1f20: 3b 0a 20 20 6d 61 73 6b 20 7c 3d 20 65 78 70 72  ;.  mask |= expr
1f30: 54 61 62 6c 65 55 73 61 67 65 28 70 4d 61 73 6b  TableUsage(pMask
1f40: 53 65 74 2c 20 70 2d 3e 70 4c 65 66 74 29 3b 0a  Set, p->pLeft);.
1f50: 20 20 6d 61 73 6b 20 7c 3d 20 65 78 70 72 4c 69    mask |= exprLi
1f60: 73 74 54 61 62 6c 65 55 73 61 67 65 28 70 4d 61  stTableUsage(pMa
1f70: 73 6b 53 65 74 2c 20 70 2d 3e 70 4c 69 73 74 29  skSet, p->pList)
1f80: 3b 0a 20 20 69 66 28 20 70 2d 3e 70 53 65 6c 65  ;.  if( p->pSele
1f90: 63 74 20 29 7b 0a 20 20 20 20 53 65 6c 65 63 74  ct ){.    Select
1fa0: 20 2a 70 53 20 3d 20 70 2d 3e 70 53 65 6c 65 63   *pS = p->pSelec
1fb0: 74 3b 0a 20 20 20 20 6d 61 73 6b 20 7c 3d 20 65  t;.    mask |= e
1fc0: 78 70 72 4c 69 73 74 54 61 62 6c 65 55 73 61 67  xprListTableUsag
1fd0: 65 28 70 4d 61 73 6b 53 65 74 2c 20 70 53 2d 3e  e(pMaskSet, pS->
1fe0: 70 45 4c 69 73 74 29 3b 0a 20 20 20 20 6d 61 73  pEList);.    mas
1ff0: 6b 20 7c 3d 20 65 78 70 72 4c 69 73 74 54 61 62  k |= exprListTab
2000: 6c 65 55 73 61 67 65 28 70 4d 61 73 6b 53 65 74  leUsage(pMaskSet
2010: 2c 20 70 53 2d 3e 70 47 72 6f 75 70 42 79 29 3b  , pS->pGroupBy);
2020: 0a 20 20 20 20 6d 61 73 6b 20 7c 3d 20 65 78 70  .    mask |= exp
2030: 72 4c 69 73 74 54 61 62 6c 65 55 73 61 67 65 28  rListTableUsage(
2040: 70 4d 61 73 6b 53 65 74 2c 20 70 53 2d 3e 70 4f  pMaskSet, pS->pO
2050: 72 64 65 72 42 79 29 3b 0a 20 20 20 20 6d 61 73  rderBy);.    mas
2060: 6b 20 7c 3d 20 65 78 70 72 54 61 62 6c 65 55 73  k |= exprTableUs
2070: 61 67 65 28 70 4d 61 73 6b 53 65 74 2c 20 70 53  age(pMaskSet, pS
2080: 2d 3e 70 57 68 65 72 65 29 3b 0a 20 20 20 20 6d  ->pWhere);.    m
2090: 61 73 6b 20 7c 3d 20 65 78 70 72 54 61 62 6c 65  ask |= exprTable
20a0: 55 73 61 67 65 28 70 4d 61 73 6b 53 65 74 2c 20  Usage(pMaskSet, 
20b0: 70 53 2d 3e 70 48 61 76 69 6e 67 29 3b 0a 20 20  pS->pHaving);.  
20c0: 7d 0a 20 20 72 65 74 75 72 6e 20 6d 61 73 6b 3b  }.  return mask;
20d0: 0a 7d 0a 73 74 61 74 69 63 20 42 69 74 6d 61 73  .}.static Bitmas
20e0: 6b 20 65 78 70 72 4c 69 73 74 54 61 62 6c 65 55  k exprListTableU
20f0: 73 61 67 65 28 45 78 70 72 4d 61 73 6b 53 65 74  sage(ExprMaskSet
2100: 20 2a 70 4d 61 73 6b 53 65 74 2c 20 45 78 70 72   *pMaskSet, Expr
2110: 4c 69 73 74 20 2a 70 4c 69 73 74 29 7b 0a 20 20  List *pList){.  
2120: 69 6e 74 20 69 3b 0a 20 20 42 69 74 6d 61 73 6b  int i;.  Bitmask
2130: 20 6d 61 73 6b 20 3d 20 30 3b 0a 20 20 69 66 28   mask = 0;.  if(
2140: 20 70 4c 69 73 74 20 29 7b 0a 20 20 20 20 66 6f   pList ){.    fo
2150: 72 28 69 3d 30 3b 20 69 3c 70 4c 69 73 74 2d 3e  r(i=0; i<pList->
2160: 6e 45 78 70 72 3b 20 69 2b 2b 29 7b 0a 20 20 20  nExpr; i++){.   
2170: 20 20 20 6d 61 73 6b 20 7c 3d 20 65 78 70 72 54     mask |= exprT
2180: 61 62 6c 65 55 73 61 67 65 28 70 4d 61 73 6b 53  ableUsage(pMaskS
2190: 65 74 2c 20 70 4c 69 73 74 2d 3e 61 5b 69 5d 2e  et, pList->a[i].
21a0: 70 45 78 70 72 29 3b 0a 20 20 20 20 7d 0a 20 20  pExpr);.    }.  
21b0: 7d 0a 20 20 72 65 74 75 72 6e 20 6d 61 73 6b 3b  }.  return mask;
21c0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
21d0: 20 54 52 55 45 20 69 66 20 74 68 65 20 67 69 76   TRUE if the giv
21e0: 65 6e 20 6f 70 65 72 61 74 6f 72 20 69 73 20 6f  en operator is o
21f0: 6e 65 20 6f 66 20 74 68 65 20 6f 70 65 72 61 74  ne of the operat
2200: 6f 72 73 20 74 68 61 74 20 69 73 0a 2a 2a 20 61  ors that is.** a
2210: 6c 6c 6f 77 65 64 20 66 6f 72 20 61 6e 20 69 6e  llowed for an in
2220: 64 65 78 61 62 6c 65 20 57 48 45 52 45 20 63 6c  dexable WHERE cl
2230: 61 75 73 65 20 74 65 72 6d 2e 20 20 54 68 65 20  ause term.  The 
2240: 61 6c 6c 6f 77 65 64 20 6f 70 65 72 61 74 6f 72  allowed operator
2250: 73 20 61 72 65 0a 2a 2a 20 22 3d 22 2c 20 22 3c  s are.** "=", "<
2260: 22 2c 20 22 3e 22 2c 20 22 3c 3d 22 2c 20 22 3e  ", ">", "<=", ">
2270: 3d 22 2c 20 61 6e 64 20 22 49 4e 22 2e 0a 2a 2f  =", and "IN"..*/
2280: 0a 73 74 61 74 69 63 20 69 6e 74 20 61 6c 6c 6f  .static int allo
2290: 77 65 64 4f 70 28 69 6e 74 20 6f 70 29 7b 0a 20  wedOp(int op){. 
22a0: 20 61 73 73 65 72 74 28 20 54 4b 5f 47 54 3d 3d   assert( TK_GT==
22b0: 54 4b 5f 4c 45 2d 31 20 26 26 20 54 4b 5f 4c 45  TK_LE-1 && TK_LE
22c0: 3d 3d 54 4b 5f 4c 54 2d 31 20 26 26 20 54 4b 5f  ==TK_LT-1 && TK_
22d0: 4c 54 3d 3d 54 4b 5f 47 45 2d 31 20 26 26 20 54  LT==TK_GE-1 && T
22e0: 4b 5f 45 51 3d 3d 54 4b 5f 47 54 2d 31 29 3b 0a  K_EQ==TK_GT-1);.
22f0: 20 20 72 65 74 75 72 6e 20 6f 70 3d 3d 54 4b 5f    return op==TK_
2300: 49 4e 20 7c 7c 20 28 6f 70 3e 3d 54 4b 5f 45 51  IN || (op>=TK_EQ
2310: 20 26 26 20 6f 70 3c 3d 54 4b 5f 47 45 29 3b 0a   && op<=TK_GE);.
2320: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 77 61 70 20 74 77  }../*.** Swap tw
2330: 6f 20 6f 62 6a 65 63 74 73 20 6f 66 20 74 79 70  o objects of typ
2340: 65 20 54 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20  e T..*/.#define 
2350: 53 57 41 50 28 54 59 50 45 2c 41 2c 42 29 20 7b  SWAP(TYPE,A,B) {
2360: 54 59 50 45 20 74 3d 41 3b 20 41 3d 42 3b 20 42  TYPE t=A; A=B; B
2370: 3d 74 3b 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  =t;}../*.** Retu
2380: 72 6e 20 74 68 65 20 69 6e 64 65 78 20 69 6e 20  rn the index in 
2390: 74 68 65 20 53 72 63 4c 69 73 74 20 74 68 61 74  the SrcList that
23a0: 20 75 73 65 73 20 63 75 72 73 6f 72 20 69 43 75   uses cursor iCu
23b0: 72 2e 20 20 49 66 20 69 43 75 72 20 69 73 0a 2a  r.  If iCur is.*
23c0: 2a 20 75 73 65 64 20 62 79 20 74 68 65 20 66 69  * used by the fi
23d0: 72 73 74 20 65 6e 74 72 79 20 69 6e 20 53 72 63  rst entry in Src
23e0: 4c 69 73 74 20 72 65 74 75 72 6e 20 30 2e 20 20  List return 0.  
23f0: 49 66 20 69 43 75 72 20 69 73 20 75 73 65 64 20  If iCur is used 
2400: 62 79 0a 2a 2a 20 74 68 65 20 73 65 63 6f 6e 64  by.** the second
2410: 20 65 6e 74 72 79 20 72 65 74 75 72 6e 20 31 2e   entry return 1.
2420: 20 20 41 6e 64 20 73 6f 20 66 6f 72 74 68 2e 0a    And so forth..
2430: 2a 2a 0a 2a 2a 20 53 72 63 4c 69 73 74 20 69 73  **.** SrcList is
2440: 20 74 68 65 20 73 65 74 20 6f 66 20 74 61 62 6c   the set of tabl
2450: 65 73 20 69 6e 20 74 68 65 20 46 52 4f 4d 20 63  es in the FROM c
2460: 6c 61 75 73 65 20 69 6e 20 74 68 65 20 6f 72 64  lause in the ord
2470: 65 72 20 74 68 61 74 0a 2a 2a 20 74 68 65 79 20  er that.** they 
2480: 77 69 6c 6c 20 62 65 20 70 72 6f 63 65 73 73 65  will be processe
2490: 64 2e 20 20 54 68 65 20 76 61 6c 75 65 20 72 65  d.  The value re
24a0: 74 75 72 6e 65 64 20 68 65 72 65 20 67 69 76 65  turned here give
24b0: 73 20 75 73 20 61 6e 20 69 6e 64 65 78 0a 2a 2a  s us an index.**
24c0: 20 6f 66 20 77 68 69 63 68 20 74 61 62 6c 65 73   of which tables
24d0: 20 77 69 6c 6c 20 62 65 20 70 72 6f 63 65 73 73   will be process
24e0: 65 64 20 66 69 72 73 74 2e 0a 2a 2f 0a 73 74 61  ed first..*/.sta
24f0: 74 69 63 20 69 6e 74 20 74 61 62 6c 65 4f 72 64  tic int tableOrd
2500: 65 72 28 53 72 63 4c 69 73 74 20 2a 70 4c 69 73  er(SrcList *pLis
2510: 74 2c 20 69 6e 74 20 69 43 75 72 29 7b 0a 20 20  t, int iCur){.  
2520: 69 6e 74 20 69 3b 0a 20 20 73 74 72 75 63 74 20  int i;.  struct 
2530: 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 2a 70 49  SrcList_item *pI
2540: 74 65 6d 3b 0a 20 20 66 6f 72 28 69 3d 30 2c 20  tem;.  for(i=0, 
2550: 70 49 74 65 6d 3d 70 4c 69 73 74 2d 3e 61 3b 20  pItem=pList->a; 
2560: 69 3c 70 4c 69 73 74 2d 3e 6e 53 72 63 3b 20 69  i<pList->nSrc; i
2570: 2b 2b 2c 20 70 49 74 65 6d 2b 2b 29 7b 0a 20 20  ++, pItem++){.  
2580: 20 20 69 66 28 20 70 49 74 65 6d 2d 3e 69 43 75    if( pItem->iCu
2590: 72 73 6f 72 3d 3d 69 43 75 72 20 29 20 72 65 74  rsor==iCur ) ret
25a0: 75 72 6e 20 69 3b 0a 20 20 7d 0a 20 20 72 65 74  urn i;.  }.  ret
25b0: 75 72 6e 20 2d 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn -1;.}../*.**
25c0: 20 54 68 65 20 69 6e 70 75 74 20 74 6f 20 74 68   The input to th
25d0: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 6e  is routine is an
25e0: 20 45 78 70 72 49 6e 66 6f 20 73 74 72 75 63 74   ExprInfo struct
25f0: 75 72 65 20 77 69 74 68 20 6f 6e 6c 79 20 74 68  ure with only th
2600: 65 0a 2a 2a 20 22 70 22 20 66 69 65 6c 64 20 66  e.** "p" field f
2610: 69 6c 6c 65 64 20 69 6e 2e 20 20 54 68 65 20 6a  illed in.  The j
2620: 6f 62 20 6f 66 20 74 68 69 73 20 72 6f 75 74 69  ob of this routi
2630: 6e 65 20 69 73 20 74 6f 20 61 6e 61 6c 79 7a 65  ne is to analyze
2640: 20 74 68 65 0a 2a 2a 20 73 75 62 65 78 70 72 65   the.** subexpre
2650: 73 73 69 6f 6e 20 61 6e 64 20 70 6f 70 75 6c 61  ssion and popula
2660: 74 65 20 61 6c 6c 20 74 68 65 20 6f 74 68 65 72  te all the other
2670: 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 20 45   fields of the E
2680: 78 70 72 49 6e 66 6f 0a 2a 2a 20 73 74 72 75 63  xprInfo.** struc
2690: 74 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ture..*/.static 
26a0: 76 6f 69 64 20 65 78 70 72 41 6e 61 6c 79 7a 65  void exprAnalyze
26b0: 28 53 72 63 4c 69 73 74 20 2a 70 53 72 63 2c 20  (SrcList *pSrc, 
26c0: 45 78 70 72 4d 61 73 6b 53 65 74 20 2a 70 4d 61  ExprMaskSet *pMa
26d0: 73 6b 53 65 74 2c 20 45 78 70 72 49 6e 66 6f 20  skSet, ExprInfo 
26e0: 2a 70 49 6e 66 6f 29 7b 0a 20 20 45 78 70 72 20  *pInfo){.  Expr 
26f0: 2a 70 45 78 70 72 20 3d 20 70 49 6e 66 6f 2d 3e  *pExpr = pInfo->
2700: 70 3b 0a 20 20 70 49 6e 66 6f 2d 3e 70 72 65 72  p;.  pInfo->prer
2710: 65 71 4c 65 66 74 20 3d 20 65 78 70 72 54 61 62  eqLeft = exprTab
2720: 6c 65 55 73 61 67 65 28 70 4d 61 73 6b 53 65 74  leUsage(pMaskSet
2730: 2c 20 70 45 78 70 72 2d 3e 70 4c 65 66 74 29 3b  , pExpr->pLeft);
2740: 0a 20 20 70 49 6e 66 6f 2d 3e 70 72 65 72 65 71  .  pInfo->prereq
2750: 52 69 67 68 74 20 3d 20 65 78 70 72 54 61 62 6c  Right = exprTabl
2760: 65 55 73 61 67 65 28 70 4d 61 73 6b 53 65 74 2c  eUsage(pMaskSet,
2770: 20 70 45 78 70 72 2d 3e 70 52 69 67 68 74 29 3b   pExpr->pRight);
2780: 0a 20 20 70 49 6e 66 6f 2d 3e 70 72 65 72 65 71  .  pInfo->prereq
2790: 41 6c 6c 20 3d 20 65 78 70 72 54 61 62 6c 65 55  All = exprTableU
27a0: 73 61 67 65 28 70 4d 61 73 6b 53 65 74 2c 20 70  sage(pMaskSet, p
27b0: 45 78 70 72 29 3b 0a 20 20 70 49 6e 66 6f 2d 3e  Expr);.  pInfo->
27c0: 69 6e 64 65 78 61 62 6c 65 20 3d 20 30 3b 0a 20  indexable = 0;. 
27d0: 20 70 49 6e 66 6f 2d 3e 69 64 78 4c 65 66 74 20   pInfo->idxLeft 
27e0: 3d 20 2d 31 3b 0a 20 20 70 49 6e 66 6f 2d 3e 69  = -1;.  pInfo->i
27f0: 64 78 52 69 67 68 74 20 3d 20 2d 31 3b 0a 20 20  dxRight = -1;.  
2800: 69 66 28 20 61 6c 6c 6f 77 65 64 4f 70 28 70 45  if( allowedOp(pE
2810: 78 70 72 2d 3e 6f 70 29 20 26 26 20 28 70 49 6e  xpr->op) && (pIn
2820: 66 6f 2d 3e 70 72 65 72 65 71 52 69 67 68 74 20  fo->prereqRight 
2830: 26 20 70 49 6e 66 6f 2d 3e 70 72 65 72 65 71 4c  & pInfo->prereqL
2840: 65 66 74 29 3d 3d 30 20 29 7b 0a 20 20 20 20 69  eft)==0 ){.    i
2850: 66 28 20 70 45 78 70 72 2d 3e 70 52 69 67 68 74  f( pExpr->pRight
2860: 20 26 26 20 70 45 78 70 72 2d 3e 70 52 69 67 68   && pExpr->pRigh
2870: 74 2d 3e 6f 70 3d 3d 54 4b 5f 43 4f 4c 55 4d 4e  t->op==TK_COLUMN
2880: 20 29 7b 0a 20 20 20 20 20 20 70 49 6e 66 6f 2d   ){.      pInfo-
2890: 3e 69 64 78 52 69 67 68 74 20 3d 20 70 45 78 70  >idxRight = pExp
28a0: 72 2d 3e 70 52 69 67 68 74 2d 3e 69 54 61 62 6c  r->pRight->iTabl
28b0: 65 3b 0a 20 20 20 20 20 20 70 49 6e 66 6f 2d 3e  e;.      pInfo->
28c0: 69 6e 64 65 78 61 62 6c 65 20 3d 20 31 3b 0a 20  indexable = 1;. 
28d0: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 45 78     }.    if( pEx
28e0: 70 72 2d 3e 70 4c 65 66 74 2d 3e 6f 70 3d 3d 54  pr->pLeft->op==T
28f0: 4b 5f 43 4f 4c 55 4d 4e 20 29 7b 0a 20 20 20 20  K_COLUMN ){.    
2900: 20 20 70 49 6e 66 6f 2d 3e 69 64 78 4c 65 66 74    pInfo->idxLeft
2910: 20 3d 20 70 45 78 70 72 2d 3e 70 4c 65 66 74 2d   = pExpr->pLeft-
2920: 3e 69 54 61 62 6c 65 3b 0a 20 20 20 20 20 20 70  >iTable;.      p
2930: 49 6e 66 6f 2d 3e 69 6e 64 65 78 61 62 6c 65 20  Info->indexable 
2940: 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20  = 1;.    }.  }. 
2950: 20 69 66 28 20 70 49 6e 66 6f 2d 3e 69 6e 64 65   if( pInfo->inde
2960: 78 61 62 6c 65 20 29 7b 0a 20 20 20 20 61 73 73  xable ){.    ass
2970: 65 72 74 28 20 70 49 6e 66 6f 2d 3e 69 64 78 4c  ert( pInfo->idxL
2980: 65 66 74 21 3d 70 49 6e 66 6f 2d 3e 69 64 78 52  eft!=pInfo->idxR
2990: 69 67 68 74 20 29 3b 0a 0a 20 20 20 20 2f 2a 20  ight );..    /* 
29a0: 57 65 20 77 61 6e 74 20 74 68 65 20 65 78 70 72  We want the expr
29b0: 65 73 73 69 6f 6e 20 74 6f 20 62 65 20 6f 66 20  ession to be of 
29c0: 74 68 65 20 66 6f 72 6d 20 22 58 20 3d 20 65 78  the form "X = ex
29d0: 70 72 22 2c 20 6e 6f 74 20 22 65 78 70 72 20 3d  pr", not "expr =
29e0: 20 58 22 2e 0a 20 20 20 20 2a 2a 20 53 6f 20 66   X"..    ** So f
29f0: 6c 69 70 20 69 74 20 6f 76 65 72 20 69 66 20 6e  lip it over if n
2a00: 65 63 65 73 73 61 72 79 2e 20 20 49 66 20 74 68  ecessary.  If th
2a10: 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20  e expression is 
2a20: 22 58 20 3d 20 59 22 2c 20 74 68 65 6e 0a 20 20  "X = Y", then.  
2a30: 20 20 2a 2a 20 77 65 20 77 61 6e 74 20 59 20 74    ** we want Y t
2a40: 6f 20 63 6f 6d 65 20 66 72 6f 6d 20 61 6e 20 65  o come from an e
2a50: 61 72 6c 69 65 72 20 74 61 62 6c 65 20 74 68 61  arlier table tha
2a60: 6e 20 58 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20  n X..    **.    
2a70: 2a 2a 20 54 68 65 20 63 6f 6c 6c 61 74 69 6e 67  ** The collating
2a80: 20 73 65 71 75 65 6e 63 65 20 72 75 6c 65 20 69   sequence rule i
2a90: 73 20 74 6f 20 61 6c 77 61 79 73 20 63 68 6f 6f  s to always choo
2aa0: 73 65 20 74 68 65 20 6c 65 66 74 20 65 78 70 72  se the left expr
2ab0: 65 73 73 69 6f 6e 2e 0a 20 20 20 20 2a 2a 20 53  ession..    ** S
2ac0: 6f 20 69 66 20 77 65 20 64 6f 20 61 20 66 6c 69  o if we do a fli
2ad0: 70 2c 20 77 65 20 61 6c 73 6f 20 68 61 76 65 20  p, we also have 
2ae0: 74 6f 20 6d 6f 76 65 20 74 68 65 20 63 6f 6c 6c  to move the coll
2af0: 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 2e 0a  ating sequence..
2b00: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 74      */.    if( t
2b10: 61 62 6c 65 4f 72 64 65 72 28 70 53 72 63 2c 70  ableOrder(pSrc,p
2b20: 49 6e 66 6f 2d 3e 69 64 78 4c 65 66 74 29 3c 74  Info->idxLeft)<t
2b30: 61 62 6c 65 4f 72 64 65 72 28 70 53 72 63 2c 70  ableOrder(pSrc,p
2b40: 49 6e 66 6f 2d 3e 69 64 78 52 69 67 68 74 29 20  Info->idxRight) 
2b50: 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  ){.      assert(
2b60: 20 70 45 78 70 72 2d 3e 6f 70 21 3d 54 4b 5f 49   pExpr->op!=TK_I
2b70: 4e 20 29 3b 0a 20 20 20 20 20 20 53 57 41 50 28  N );.      SWAP(
2b80: 43 6f 6c 6c 53 65 71 2a 2c 70 45 78 70 72 2d 3e  CollSeq*,pExpr->
2b90: 70 52 69 67 68 74 2d 3e 70 43 6f 6c 6c 2c 70 45  pRight->pColl,pE
2ba0: 78 70 72 2d 3e 70 4c 65 66 74 2d 3e 70 43 6f 6c  xpr->pLeft->pCol
2bb0: 6c 29 3b 0a 20 20 20 20 20 20 53 57 41 50 28 45  l);.      SWAP(E
2bc0: 78 70 72 2a 2c 70 45 78 70 72 2d 3e 70 52 69 67  xpr*,pExpr->pRig
2bd0: 68 74 2c 70 45 78 70 72 2d 3e 70 4c 65 66 74 29  ht,pExpr->pLeft)
2be0: 3b 0a 20 20 20 20 20 20 69 66 28 20 70 45 78 70  ;.      if( pExp
2bf0: 72 2d 3e 6f 70 3e 3d 54 4b 5f 47 54 20 29 7b 0a  r->op>=TK_GT ){.
2c00: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20          assert( 
2c10: 54 4b 5f 4c 54 3d 3d 54 4b 5f 47 54 2b 32 20 29  TK_LT==TK_GT+2 )
2c20: 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74  ;.        assert
2c30: 28 20 54 4b 5f 47 45 3d 3d 54 4b 5f 4c 45 2b 32  ( TK_GE==TK_LE+2
2c40: 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65   );.        asse
2c50: 72 74 28 20 54 4b 5f 47 54 3e 54 4b 5f 45 51 20  rt( TK_GT>TK_EQ 
2c60: 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72  );.        asser
2c70: 74 28 20 54 4b 5f 47 54 3c 54 4b 5f 4c 45 20 29  t( TK_GT<TK_LE )
2c80: 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74  ;.        assert
2c90: 28 20 70 45 78 70 72 2d 3e 6f 70 3e 3d 54 4b 5f  ( pExpr->op>=TK_
2ca0: 47 54 20 26 26 20 70 45 78 70 72 2d 3e 6f 70 3c  GT && pExpr->op<
2cb0: 3d 54 4b 5f 47 45 20 29 3b 0a 20 20 20 20 20 20  =TK_GE );.      
2cc0: 20 20 70 45 78 70 72 2d 3e 6f 70 20 3d 20 28 28    pExpr->op = ((
2cd0: 70 45 78 70 72 2d 3e 6f 70 2d 54 4b 5f 47 54 29  pExpr->op-TK_GT)
2ce0: 5e 32 29 2b 54 4b 5f 47 54 3b 0a 20 20 20 20 20  ^2)+TK_GT;.     
2cf0: 20 7d 0a 20 20 20 20 20 20 53 57 41 50 28 75 6e   }.      SWAP(un
2d00: 73 69 67 6e 65 64 2c 20 70 49 6e 66 6f 2d 3e 70  signed, pInfo->p
2d10: 72 65 72 65 71 4c 65 66 74 2c 20 70 49 6e 66 6f  rereqLeft, pInfo
2d20: 2d 3e 70 72 65 72 65 71 52 69 67 68 74 29 3b 0a  ->prereqRight);.
2d30: 20 20 20 20 20 20 53 57 41 50 28 73 68 6f 72 74        SWAP(short
2d40: 20 69 6e 74 2c 20 70 49 6e 66 6f 2d 3e 69 64 78   int, pInfo->idx
2d50: 4c 65 66 74 2c 20 70 49 6e 66 6f 2d 3e 69 64 78  Left, pInfo->idx
2d60: 52 69 67 68 74 29 3b 0a 20 20 20 20 7d 0a 20 20  Right);.    }.  
2d70: 7d 20 20 20 20 20 20 0a 0a 7d 0a 0a 2f 2a 0a 2a  }      ..}../*.*
2d80: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 64  * This routine d
2d90: 65 63 69 64 65 73 20 69 66 20 70 49 64 78 20 63  ecides if pIdx c
2da0: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 73 61  an be used to sa
2db0: 74 69 73 66 79 20 74 68 65 20 4f 52 44 45 52 20  tisfy the ORDER 
2dc0: 42 59 0a 2a 2a 20 63 6c 61 75 73 65 2e 20 20 49  BY.** clause.  I
2dd0: 66 20 69 74 20 63 61 6e 2c 20 69 74 20 72 65 74  f it can, it ret
2de0: 75 72 6e 73 20 31 2e 20 20 49 66 20 70 49 64 78  urns 1.  If pIdx
2df0: 20 63 61 6e 6e 6f 74 20 73 61 74 69 73 66 79 20   cannot satisfy 
2e00: 74 68 65 0a 2a 2a 20 4f 52 44 45 52 20 42 59 20  the.** ORDER BY 
2e10: 63 6c 61 75 73 65 2c 20 74 68 69 73 20 72 6f 75  clause, this rou
2e20: 74 69 6e 65 20 72 65 74 75 72 6e 73 20 30 2e 0a  tine returns 0..
2e30: 2a 2a 0a 2a 2a 20 70 4f 72 64 65 72 42 79 20 69  **.** pOrderBy i
2e40: 73 20 61 6e 20 4f 52 44 45 52 20 42 59 20 63 6c  s an ORDER BY cl
2e50: 61 75 73 65 20 66 72 6f 6d 20 61 20 53 45 4c 45  ause from a SELE
2e60: 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 70  CT statement.  p
2e70: 54 61 62 20 69 73 20 74 68 65 0a 2a 2a 20 6c 65  Tab is the.** le
2e80: 66 74 2d 6d 6f 73 74 20 74 61 62 6c 65 20 69 6e  ft-most table in
2e90: 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65   the FROM clause
2ea0: 20 6f 66 20 74 68 61 74 20 73 61 6d 65 20 53 45   of that same SE
2eb0: 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 20 61  LECT statement a
2ec0: 6e 64 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 20  nd.** the table 
2ed0: 68 61 73 20 61 20 63 75 72 73 6f 72 20 6e 75 6d  has a cursor num
2ee0: 62 65 72 20 6f 66 20 22 62 61 73 65 22 2e 20 20  ber of "base".  
2ef0: 70 49 64 78 20 69 73 20 61 6e 20 69 6e 64 65 78  pIdx is an index
2f00: 20 6f 6e 20 70 54 61 62 2e 0a 2a 2a 0a 2a 2a 20   on pTab..**.** 
2f10: 6e 45 71 43 6f 6c 20 69 73 20 74 68 65 20 6e 75  nEqCol is the nu
2f20: 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20  mber of columns 
2f30: 6f 66 20 70 49 64 78 20 74 68 61 74 20 61 72 65  of pIdx that are
2f40: 20 75 73 65 64 20 61 73 20 65 71 75 61 6c 69 74   used as equalit
2f50: 79 0a 2a 2a 20 63 6f 6e 73 74 72 61 69 6e 74 73  y.** constraints
2f60: 2e 20 20 41 6e 79 20 6f 66 20 74 68 65 73 65 20  .  Any of these 
2f70: 63 6f 6c 75 6d 6e 73 20 6d 61 79 20 62 65 20 6d  columns may be m
2f80: 69 73 73 69 6e 67 20 66 72 6f 6d 20 74 68 65 20  issing from the 
2f90: 4f 52 44 45 52 20 42 59 0a 2a 2a 20 63 6c 61 75  ORDER BY.** clau
2fa0: 73 65 20 61 6e 64 20 74 68 65 20 6d 61 74 63 68  se and the match
2fb0: 20 63 61 6e 20 73 74 69 6c 6c 20 62 65 20 61 20   can still be a 
2fc0: 73 75 63 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 49  success..**.** I
2fd0: 66 20 74 68 65 20 69 6e 64 65 78 20 69 73 20 55  f the index is U
2fe0: 4e 49 51 55 45 2c 20 74 68 65 6e 20 74 68 65 20  NIQUE, then the 
2ff0: 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 20  ORDER BY clause 
3000: 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f 20 68 61  is allowed to ha
3010: 76 65 0a 2a 2a 20 61 64 64 69 74 69 6f 6e 61 6c  ve.** additional
3020: 20 74 65 72 6d 73 20 70 61 73 74 20 74 68 65 20   terms past the 
3030: 65 6e 64 20 6f 66 20 74 68 65 20 69 6e 64 65 78  end of the index
3040: 20 61 6e 64 20 74 68 65 20 6d 61 74 63 68 20 77   and the match w
3050: 69 6c 6c 20 73 74 69 6c 6c 0a 2a 2a 20 62 65 20  ill still.** be 
3060: 61 20 73 75 63 63 65 73 73 2e 0a 2a 2a 0a 2a 2a  a success..**.**
3070: 20 41 6c 6c 20 74 65 72 6d 73 20 6f 66 20 74 68   All terms of th
3080: 65 20 4f 52 44 45 52 20 42 59 20 74 68 61 74 20  e ORDER BY that 
3090: 6d 61 74 63 68 20 61 67 61 69 6e 73 74 20 74 68  match against th
30a0: 65 20 69 6e 64 65 78 20 6d 75 73 74 20 62 65 20  e index must be 
30b0: 65 69 74 68 65 72 0a 2a 2a 20 41 53 43 20 6f 72  either.** ASC or
30c0: 20 44 45 53 43 2e 20 20 28 54 65 72 6d 73 20 6f   DESC.  (Terms o
30d0: 66 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 63  f the ORDER BY c
30e0: 6c 61 75 73 65 20 70 61 73 74 20 74 68 65 20 65  lause past the e
30f0: 6e 64 20 6f 66 20 61 20 55 4e 49 51 55 45 0a 2a  nd of a UNIQUE.*
3100: 2a 20 69 6e 64 65 78 20 64 6f 20 6e 6f 74 20 6e  * index do not n
3110: 65 65 64 20 74 6f 20 73 61 74 69 73 66 79 20 74  eed to satisfy t
3120: 68 69 73 20 63 6f 6e 73 74 72 61 69 6e 74 2e 29  his constraint.)
3130: 20 20 54 68 65 20 2a 70 62 52 65 76 20 76 61 6c    The *pbRev val
3140: 75 65 20 69 73 0a 2a 2a 20 73 65 74 20 74 6f 20  ue is.** set to 
3150: 31 20 69 66 20 74 68 65 20 4f 52 44 45 52 20 42  1 if the ORDER B
3160: 59 20 63 6c 61 75 73 65 20 69 73 20 61 6c 6c 20  Y clause is all 
3170: 44 45 53 43 20 61 6e 64 20 69 74 20 69 73 20 73  DESC and it is s
3180: 65 74 20 74 6f 20 30 20 69 66 0a 2a 2a 20 74 68  et to 0 if.** th
3190: 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73  e ORDER BY claus
31a0: 65 20 69 73 20 61 6c 6c 20 41 53 43 2e 0a 2a 2f  e is all ASC..*/
31b0: 0a 73 74 61 74 69 63 20 69 6e 74 20 69 73 53 6f  .static int isSo
31c0: 72 74 69 6e 67 49 6e 64 65 78 28 0a 20 20 50 61  rtingIndex(.  Pa
31d0: 72 73 65 20 2a 70 50 61 72 73 65 2c 20 20 20 20  rse *pParse,    
31e0: 20 20 20 20 20 20 2f 2a 20 50 61 72 73 69 6e 67        /* Parsing
31f0: 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 49 6e   context */.  In
3200: 64 65 78 20 2a 70 49 64 78 2c 20 20 20 20 20 20  dex *pIdx,      
3210: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 69 6e 64        /* The ind
3220: 65 78 20 77 65 20 61 72 65 20 74 65 73 74 69 6e  ex we are testin
3230: 67 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54  g */.  Table *pT
3240: 61 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f  ab,            /
3250: 2a 20 54 68 65 20 74 61 62 6c 65 20 74 6f 20 62  * The table to b
3260: 65 20 73 6f 72 74 65 64 20 2a 2f 0a 20 20 69 6e  e sorted */.  in
3270: 74 20 62 61 73 65 2c 20 20 20 20 20 20 20 20 20  t base,         
3280: 20 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 20        /* Cursor 
3290: 6e 75 6d 62 65 72 20 66 6f 72 20 70 54 61 62 20  number for pTab 
32a0: 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70  */.  ExprList *p
32b0: 4f 72 64 65 72 42 79 2c 20 20 20 20 20 2f 2a 20  OrderBy,     /* 
32c0: 54 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61  The ORDER BY cla
32d0: 75 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 71  use */.  int nEq
32e0: 43 6f 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20  Col,            
32f0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 69 6e   /* Number of in
3300: 64 65 78 20 63 6f 6c 75 6d 6e 73 20 77 69 74 68  dex columns with
3310: 20 3d 3d 20 63 6f 6e 73 74 72 61 69 6e 74 73 20   == constraints 
3320: 2a 2f 0a 20 20 69 6e 74 20 2a 70 62 52 65 76 20  */.  int *pbRev 
3330: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
3340: 53 65 74 20 74 6f 20 31 20 69 66 20 4f 52 44 45  Set to 1 if ORDE
3350: 52 20 42 59 20 69 73 20 44 45 53 43 20 2a 2f 0a  R BY is DESC */.
3360: 29 7b 0a 20 20 69 6e 74 20 69 2c 20 6a 3b 20 20  ){.  int i, j;  
3370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3380: 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65    /* Loop counte
3390: 72 73 20 2a 2f 0a 20 20 69 6e 74 20 73 6f 72 74  rs */.  int sort
33a0: 4f 72 64 65 72 3b 20 20 20 20 20 20 20 20 20 20  Order;          
33b0: 20 20 20 20 20 2f 2a 20 57 68 69 63 68 20 64 69       /* Which di
33c0: 72 65 63 74 69 6f 6e 20 77 65 20 61 72 65 20 73  rection we are s
33d0: 6f 72 74 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20  orting */.  int 
33e0: 6e 54 65 72 6d 3b 20 20 20 20 20 20 20 20 20 20  nTerm;          
33f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
3400: 65 72 20 6f 66 20 4f 52 44 45 52 20 42 59 20 74  er of ORDER BY t
3410: 65 72 6d 73 20 2a 2f 0a 20 20 73 74 72 75 63 74  erms */.  struct
3420: 20 45 78 70 72 4c 69 73 74 5f 69 74 65 6d 20 2a   ExprList_item *
3430: 70 54 65 72 6d 3b 20 2f 2a 20 41 20 74 65 72 6d  pTerm; /* A term
3440: 20 6f 66 20 74 68 65 20 4f 52 44 45 52 20 42 59   of the ORDER BY
3450: 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 73 71 6c   clause */.  sql
3460: 69 74 65 33 20 2a 64 62 20 3d 20 70 50 61 72 73  ite3 *db = pPars
3470: 65 2d 3e 64 62 3b 0a 0a 20 20 61 73 73 65 72 74  e->db;..  assert
3480: 28 20 70 4f 72 64 65 72 42 79 21 3d 30 20 29 3b  ( pOrderBy!=0 );
3490: 0a 20 20 6e 54 65 72 6d 20 3d 20 70 4f 72 64 65  .  nTerm = pOrde
34a0: 72 42 79 2d 3e 6e 45 78 70 72 3b 0a 20 20 61 73  rBy->nExpr;.  as
34b0: 73 65 72 74 28 20 6e 54 65 72 6d 3e 30 20 29 3b  sert( nTerm>0 );
34c0: 0a 0a 20 20 2f 2a 20 4d 61 74 63 68 20 74 65 72  ..  /* Match ter
34d0: 6d 73 20 6f 66 20 74 68 65 20 4f 52 44 45 52 20  ms of the ORDER 
34e0: 42 59 20 63 6c 61 75 73 65 20 61 67 61 69 6e 73  BY clause agains
34f0: 74 20 63 6f 6c 75 6d 6e 73 20 6f 66 0a 20 20 2a  t columns of.  *
3500: 2a 20 74 68 65 20 69 6e 64 65 78 2e 0a 20 20 2a  * the index..  *
3510: 2f 0a 20 20 66 6f 72 28 69 3d 6a 3d 30 2c 20 70  /.  for(i=j=0, p
3520: 54 65 72 6d 3d 70 4f 72 64 65 72 42 79 2d 3e 61  Term=pOrderBy->a
3530: 3b 20 6a 3c 6e 54 65 72 6d 20 26 26 20 69 3c 70  ; j<nTerm && i<p
3540: 49 64 78 2d 3e 6e 43 6f 6c 75 6d 6e 3b 20 69 2b  Idx->nColumn; i+
3550: 2b 29 7b 0a 20 20 20 20 45 78 70 72 20 2a 70 45  +){.    Expr *pE
3560: 78 70 72 3b 20 20 20 20 20 20 20 2f 2a 20 54 68  xpr;       /* Th
3570: 65 20 65 78 70 72 65 73 73 69 6f 6e 20 6f 66 20  e expression of 
3580: 74 68 65 20 4f 52 44 45 52 20 42 59 20 70 54 65  the ORDER BY pTe
3590: 72 6d 20 2a 2f 0a 20 20 20 20 43 6f 6c 6c 53 65  rm */.    CollSe
35a0: 71 20 2a 70 43 6f 6c 6c 3b 20 20 20 20 2f 2a 20  q *pColl;    /* 
35b0: 54 68 65 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65  The collating se
35c0: 71 75 65 6e 63 65 20 6f 66 20 70 45 78 70 72 20  quence of pExpr 
35d0: 2a 2f 0a 0a 20 20 20 20 70 45 78 70 72 20 3d 20  */..    pExpr = 
35e0: 70 54 65 72 6d 2d 3e 70 45 78 70 72 3b 0a 20 20  pTerm->pExpr;.  
35f0: 20 20 69 66 28 20 70 45 78 70 72 2d 3e 6f 70 21    if( pExpr->op!
3600: 3d 54 4b 5f 43 4f 4c 55 4d 4e 20 7c 7c 20 70 45  =TK_COLUMN || pE
3610: 78 70 72 2d 3e 69 54 61 62 6c 65 21 3d 62 61 73  xpr->iTable!=bas
3620: 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 43 61  e ){.      /* Ca
3630: 6e 20 6e 6f 74 20 75 73 65 20 61 6e 20 69 6e 64  n not use an ind
3640: 65 78 20 73 6f 72 74 20 6f 6e 20 61 6e 79 74 68  ex sort on anyth
3650: 69 6e 67 20 74 68 61 74 20 69 73 20 6e 6f 74 20  ing that is not 
3660: 61 20 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 0a  a column in the.
3670: 20 20 20 20 20 20 2a 2a 20 6c 65 66 74 2d 6d 6f        ** left-mo
3680: 73 74 20 74 61 62 6c 65 20 6f 66 20 74 68 65 20  st table of the 
3690: 46 52 4f 4d 20 63 6c 61 75 73 65 20 2a 2f 0a 20  FROM clause */. 
36a0: 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20       return 0;. 
36b0: 20 20 20 7d 0a 20 20 20 20 70 43 6f 6c 6c 20 3d     }.    pColl =
36c0: 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 6c 6c   sqlite3ExprColl
36d0: 53 65 71 28 70 50 61 72 73 65 2c 20 70 45 78 70  Seq(pParse, pExp
36e0: 72 29 3b 0a 20 20 20 20 69 66 28 20 21 70 43 6f  r);.    if( !pCo
36f0: 6c 6c 20 29 20 70 43 6f 6c 6c 20 3d 20 64 62 2d  ll ) pColl = db-
3700: 3e 70 44 66 6c 74 43 6f 6c 6c 3b 0a 20 20 20 20  >pDfltColl;.    
3710: 69 66 28 20 70 45 78 70 72 2d 3e 69 43 6f 6c 75  if( pExpr->iColu
3720: 6d 6e 21 3d 70 49 64 78 2d 3e 61 69 43 6f 6c 75  mn!=pIdx->aiColu
3730: 6d 6e 5b 69 5d 20 7c 7c 20 70 43 6f 6c 6c 21 3d  mn[i] || pColl!=
3740: 70 49 64 78 2d 3e 6b 65 79 49 6e 66 6f 2e 61 43  pIdx->keyInfo.aC
3750: 6f 6c 6c 5b 69 5d 20 29 7b 0a 20 20 20 20 20 20  oll[i] ){.      
3760: 2f 2a 20 54 65 72 6d 20 6a 20 6f 66 20 74 68 65  /* Term j of the
3770: 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65   ORDER BY clause
3780: 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 20   does not match 
3790: 63 6f 6c 75 6d 6e 20 69 20 6f 66 20 74 68 65 20  column i of the 
37a0: 69 6e 64 65 78 20 2a 2f 0a 20 20 20 20 20 20 69  index */.      i
37b0: 66 28 20 69 3c 6e 45 71 43 6f 6c 20 29 7b 0a 20  f( i<nEqCol ){. 
37c0: 20 20 20 20 20 20 20 2f 2a 20 49 66 20 61 6e 20         /* If an 
37d0: 69 6e 64 65 78 20 63 6f 6c 75 6d 6e 20 74 68 61  index column tha
37e0: 74 20 69 73 20 63 6f 6e 73 74 72 61 69 6e 65 64  t is constrained
37f0: 20 62 79 20 3d 3d 20 66 61 69 6c 73 20 74 6f 20   by == fails to 
3800: 6d 61 74 63 68 20 61 6e 0a 20 20 20 20 20 20 20  match an.       
3810: 20 2a 2a 20 4f 52 44 45 52 20 42 59 20 74 65 72   ** ORDER BY ter
3820: 6d 2c 20 74 68 61 74 20 69 73 20 4f 4b 2e 20 20  m, that is OK.  
3830: 4a 75 73 74 20 69 67 6e 6f 72 65 20 74 68 61 74  Just ignore that
3840: 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 69   column of the i
3850: 6e 64 65 78 0a 20 20 20 20 20 20 20 20 2a 2f 0a  ndex.        */.
3860: 20 20 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65          continue
3870: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ;.      }else{. 
3880: 20 20 20 20 20 20 20 2f 2a 20 49 66 20 61 6e 20         /* If an 
3890: 69 6e 64 65 78 20 63 6f 6c 75 6d 6e 20 66 61 69  index column fai
38a0: 6c 73 20 74 6f 20 6d 61 74 63 68 20 61 6e 64 20  ls to match and 
38b0: 69 73 20 6e 6f 74 20 63 6f 6e 73 74 72 61 69 6e  is not constrain
38c0: 65 64 20 62 79 20 3d 3d 0a 20 20 20 20 20 20 20  ed by ==.       
38d0: 20 2a 2a 20 74 68 65 6e 20 74 68 65 20 69 6e 64   ** then the ind
38e0: 65 78 20 63 61 6e 6e 6f 74 20 73 61 74 69 73 66  ex cannot satisf
38f0: 79 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 63  y the ORDER BY c
3900: 6f 6e 73 74 72 61 69 6e 74 2e 0a 20 20 20 20 20  onstraint..     
3910: 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 65     */.        re
3920: 74 75 72 6e 20 30 3b 0a 20 20 20 20 20 20 7d 0a  turn 0;.      }.
3930: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 69 3e      }.    if( i>
3940: 6e 45 71 43 6f 6c 20 29 7b 0a 20 20 20 20 20 20  nEqCol ){.      
3950: 69 66 28 20 70 54 65 72 6d 2d 3e 73 6f 72 74 4f  if( pTerm->sortO
3960: 72 64 65 72 21 3d 73 6f 72 74 4f 72 64 65 72 20  rder!=sortOrder 
3970: 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 6e  ){.        /* In
3980: 64 69 63 65 73 20 63 61 6e 20 6f 6e 6c 79 20 62  dices can only b
3990: 65 20 75 73 65 64 20 69 66 20 61 6c 6c 20 4f 52  e used if all OR
39a0: 44 45 52 20 42 59 20 74 65 72 6d 73 20 70 61 73  DER BY terms pas
39b0: 74 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a  t the.        **
39c0: 20 65 71 75 61 6c 69 74 79 20 63 6f 6e 73 74 72   equality constr
39d0: 61 69 6e 74 73 20 61 72 65 20 61 6c 6c 20 65 69  aints are all ei
39e0: 74 68 65 72 20 44 45 53 43 20 6f 72 20 41 53 43  ther DESC or ASC
39f0: 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 65 74  . */.        ret
3a00: 75 72 6e 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20  urn 0;.      }. 
3a10: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
3a20: 73 6f 72 74 4f 72 64 65 72 20 3d 20 70 54 65 72  sortOrder = pTer
3a30: 6d 2d 3e 73 6f 72 74 4f 72 64 65 72 3b 0a 20 20  m->sortOrder;.  
3a40: 20 20 7d 0a 20 20 20 20 6a 2b 2b 3b 0a 20 20 20    }.    j++;.   
3a50: 20 70 54 65 72 6d 2b 2b 3b 0a 20 20 7d 0a 0a 20   pTerm++;.  }.. 
3a60: 20 2f 2a 20 54 68 65 20 69 6e 64 65 78 20 63 61   /* The index ca
3a70: 6e 20 62 65 20 75 73 65 64 20 66 6f 72 20 73 6f  n be used for so
3a80: 72 74 69 6e 67 20 69 66 20 61 6c 6c 20 74 65 72  rting if all ter
3a90: 6d 73 20 6f 66 20 74 68 65 20 4f 52 44 45 52 20  ms of the ORDER 
3aa0: 42 59 20 63 6c 61 75 73 65 0a 20 20 2a 2a 20 6f  BY clause.  ** o
3ab0: 72 20 63 6f 76 65 72 65 64 20 6f 72 20 69 66 20  r covered or if 
3ac0: 77 65 20 72 61 6e 20 6f 75 74 20 6f 66 20 69 6e  we ran out of in
3ad0: 64 65 78 20 63 6f 6c 75 6d 6e 73 20 61 6e 64 20  dex columns and 
3ae0: 74 68 65 20 69 74 20 69 73 20 61 20 55 4e 49 51  the it is a UNIQ
3af0: 55 45 0a 20 20 2a 2a 20 69 6e 64 65 78 2e 0a 20  UE.  ** index.. 
3b00: 20 2a 2f 0a 20 20 69 66 28 20 6a 3e 3d 6e 54 65   */.  if( j>=nTe
3b10: 72 6d 20 7c 7c 20 28 69 3e 3d 70 49 64 78 2d 3e  rm || (i>=pIdx->
3b20: 6e 43 6f 6c 75 6d 6e 20 26 26 20 70 49 64 78 2d  nColumn && pIdx-
3b30: 3e 6f 6e 45 72 72 6f 72 21 3d 4f 45 5f 4e 6f 6e  >onError!=OE_Non
3b40: 65 29 20 29 7b 0a 20 20 20 20 2a 70 62 52 65 76  e) ){.    *pbRev
3b50: 20 3d 20 73 6f 72 74 4f 72 64 65 72 3d 3d 53 51   = sortOrder==SQ
3b60: 4c 49 54 45 5f 53 4f 5f 44 45 53 43 3b 0a 20 20  LITE_SO_DESC;.  
3b70: 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a    return 1;.  }.
3b80: 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f    return 0;.}../
3b90: 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 61 62 6c 65  *.** Check table
3ba0: 20 74 6f 20 73 65 65 20 69 66 20 74 68 65 20 4f   to see if the O
3bb0: 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 20 69  RDER BY clause i
3bc0: 6e 20 70 4f 72 64 65 72 42 79 20 63 61 6e 20 62  n pOrderBy can b
3bd0: 65 20 73 61 74 69 73 66 69 65 64 0a 2a 2a 20 62  e satisfied.** b
3be0: 79 20 73 6f 72 74 69 6e 67 20 69 6e 20 6f 72 64  y sorting in ord
3bf0: 65 72 20 6f 66 20 52 4f 57 49 44 2e 20 20 52 65  er of ROWID.  Re
3c00: 74 75 72 6e 20 74 72 75 65 20 69 66 20 73 6f 20  turn true if so 
3c10: 61 6e 64 20 73 65 74 20 2a 70 62 52 65 76 20 74  and set *pbRev t
3c20: 6f 20 62 65 0a 2a 2a 20 74 72 75 65 20 66 6f 72  o be.** true for
3c30: 20 72 65 76 65 72 73 65 20 52 4f 57 49 44 20 61   reverse ROWID a
3c40: 6e 64 20 66 61 6c 73 65 20 66 6f 72 20 66 6f 72  nd false for for
3c50: 77 61 72 64 20 52 4f 57 49 44 20 6f 72 64 65 72  ward ROWID order
3c60: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
3c70: 73 6f 72 74 61 62 6c 65 42 79 52 6f 77 69 64 28  sortableByRowid(
3c80: 0a 20 20 69 6e 74 20 62 61 73 65 2c 20 20 20 20  .  int base,    
3c90: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75             /* Cu
3ca0: 72 73 6f 72 20 6e 75 6d 62 65 72 20 66 6f 72 20  rsor number for 
3cb0: 74 61 62 6c 65 20 74 6f 20 62 65 20 73 6f 72 74  table to be sort
3cc0: 65 64 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74  ed */.  ExprList
3cd0: 20 2a 70 4f 72 64 65 72 42 79 2c 20 20 20 20 20   *pOrderBy,     
3ce0: 2f 2a 20 54 68 65 20 4f 52 44 45 52 20 42 59 20  /* The ORDER BY 
3cf0: 63 6c 61 75 73 65 20 2a 2f 0a 20 20 69 6e 74 20  clause */.  int 
3d00: 2a 70 62 52 65 76 20 20 20 20 20 20 20 20 20 20  *pbRev          
3d10: 20 20 20 20 2f 2a 20 53 65 74 20 74 6f 20 31 20      /* Set to 1 
3d20: 69 66 20 4f 52 44 45 52 20 42 59 20 69 73 20 44  if ORDER BY is D
3d30: 45 53 43 20 2a 2f 0a 29 7b 0a 20 20 45 78 70 72  ESC */.){.  Expr
3d40: 20 2a 70 3b 0a 0a 20 20 61 73 73 65 72 74 28 20   *p;..  assert( 
3d50: 70 4f 72 64 65 72 42 79 21 3d 30 20 29 3b 0a 20  pOrderBy!=0 );. 
3d60: 20 61 73 73 65 72 74 28 20 70 4f 72 64 65 72 42   assert( pOrderB
3d70: 79 2d 3e 6e 45 78 70 72 3e 30 20 29 3b 0a 20 20  y->nExpr>0 );.  
3d80: 70 20 3d 20 70 4f 72 64 65 72 42 79 2d 3e 61 5b  p = pOrderBy->a[
3d90: 30 5d 2e 70 45 78 70 72 3b 0a 20 20 69 66 28 20  0].pExpr;.  if( 
3da0: 70 2d 3e 6f 70 3d 3d 54 4b 5f 43 4f 4c 55 4d 4e  p->op==TK_COLUMN
3db0: 20 26 26 20 70 2d 3e 69 54 61 62 6c 65 3d 3d 62   && p->iTable==b
3dc0: 61 73 65 20 26 26 20 70 2d 3e 69 43 6f 6c 75 6d  ase && p->iColum
3dd0: 6e 3d 3d 2d 31 20 29 7b 0a 20 20 20 20 2a 70 62  n==-1 ){.    *pb
3de0: 52 65 76 20 3d 20 70 4f 72 64 65 72 42 79 2d 3e  Rev = pOrderBy->
3df0: 61 5b 30 5d 2e 73 6f 72 74 4f 72 64 65 72 3b 0a  a[0].sortOrder;.
3e00: 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20      return 1;.  
3e10: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  }.  return 0;.}.
3e20: 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 61 62 6c 65 20  ../*.** Disable 
3e30: 61 20 74 65 72 6d 20 69 6e 20 74 68 65 20 57 48  a term in the WH
3e40: 45 52 45 20 63 6c 61 75 73 65 2e 20 20 45 78 63  ERE clause.  Exc
3e50: 65 70 74 2c 20 64 6f 20 6e 6f 74 20 64 69 73 61  ept, do not disa
3e60: 62 6c 65 20 74 68 65 20 74 65 72 6d 0a 2a 2a 20  ble the term.** 
3e70: 69 66 20 69 74 20 63 6f 6e 74 72 6f 6c 73 20 61  if it controls a
3e80: 20 4c 45 46 54 20 4f 55 54 45 52 20 4a 4f 49 4e   LEFT OUTER JOIN
3e90: 20 61 6e 64 20 69 74 20 64 69 64 20 6e 6f 74 20   and it did not 
3ea0: 6f 72 69 67 69 6e 61 74 65 20 69 6e 20 74 68 65  originate in the
3eb0: 20 4f 4e 0a 2a 2a 20 6f 72 20 55 53 49 4e 47 20   ON.** or USING 
3ec0: 63 6c 61 75 73 65 20 6f 66 20 74 68 61 74 20 6a  clause of that j
3ed0: 6f 69 6e 2e 0a 2a 2a 0a 2a 2a 20 43 6f 6e 73 69  oin..**.** Consi
3ee0: 64 65 72 20 74 68 65 20 74 65 72 6d 20 74 32 2e  der the term t2.
3ef0: 7a 3d 27 6f 6b 27 20 69 6e 20 74 68 65 20 66 6f  z='ok' in the fo
3f00: 6c 6c 6f 77 69 6e 67 20 71 75 65 72 69 65 73 3a  llowing queries:
3f10: 0a 2a 2a 0a 2a 2a 20 20 20 28 31 29 20 20 53 45  .**.**   (1)  SE
3f20: 4c 45 43 54 20 2a 20 46 52 4f 4d 20 74 31 20 4c  LECT * FROM t1 L
3f30: 45 46 54 20 4a 4f 49 4e 20 74 32 20 4f 4e 20 74  EFT JOIN t2 ON t
3f40: 31 2e 61 3d 74 32 2e 78 20 57 48 45 52 45 20 74  1.a=t2.x WHERE t
3f50: 32 2e 7a 3d 27 6f 6b 27 0a 2a 2a 20 20 20 28 32  2.z='ok'.**   (2
3f60: 29 20 20 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d  )  SELECT * FROM
3f70: 20 74 31 20 4c 45 46 54 20 4a 4f 49 4e 20 74 32   t1 LEFT JOIN t2
3f80: 20 4f 4e 20 74 31 2e 61 3d 74 32 2e 78 20 41 4e   ON t1.a=t2.x AN
3f90: 44 20 74 32 2e 7a 3d 27 6f 6b 27 0a 2a 2a 20 20  D t2.z='ok'.**  
3fa0: 20 28 33 29 20 20 53 45 4c 45 43 54 20 2a 20 46   (3)  SELECT * F
3fb0: 52 4f 4d 20 74 31 2c 20 74 32 20 57 48 45 52 45  ROM t1, t2 WHERE
3fc0: 20 74 31 2e 61 3d 74 32 2e 78 20 41 4e 44 20 74   t1.a=t2.x AND t
3fd0: 32 2e 7a 3d 27 6f 6b 27 0a 2a 2a 0a 2a 2a 20 54  2.z='ok'.**.** T
3fe0: 68 65 20 74 32 2e 7a 3d 27 6f 6b 27 20 69 73 20  he t2.z='ok' is 
3ff0: 64 69 73 61 62 6c 65 64 20 69 6e 20 74 68 65 20  disabled in the 
4000: 69 6e 20 28 32 29 20 62 65 63 61 75 73 65 20 69  in (2) because i
4010: 74 20 6f 72 69 67 69 6e 61 74 65 73 0a 2a 2a 20  t originates.** 
4020: 69 6e 20 74 68 65 20 4f 4e 20 63 6c 61 75 73 65  in the ON clause
4030: 2e 20 20 54 68 65 20 74 65 72 6d 20 69 73 20 64  .  The term is d
4040: 69 73 61 62 6c 65 64 20 69 6e 20 28 33 29 20 62  isabled in (3) b
4050: 65 63 61 75 73 65 20 69 74 20 69 73 20 6e 6f 74  ecause it is not
4060: 20 70 61 72 74 0a 2a 2a 20 6f 66 20 61 20 4c 45   part.** of a LE
4070: 46 54 20 4f 55 54 45 52 20 4a 4f 49 4e 2e 20 20  FT OUTER JOIN.  
4080: 49 6e 20 28 31 29 2c 20 74 68 65 20 74 65 72 6d  In (1), the term
4090: 20 69 73 20 6e 6f 74 20 64 69 73 61 62 6c 65 64   is not disabled
40a0: 2e 0a 2a 2a 0a 2a 2a 20 44 69 73 61 62 6c 69 6e  ..**.** Disablin
40b0: 67 20 61 20 74 65 72 6d 20 63 61 75 73 65 73 20  g a term causes 
40c0: 74 68 61 74 20 74 65 72 6d 20 74 6f 20 6e 6f 74  that term to not
40d0: 20 62 65 20 74 65 73 74 65 64 20 69 6e 20 74 68   be tested in th
40e0: 65 20 69 6e 6e 65 72 20 6c 6f 6f 70 0a 2a 2a 20  e inner loop.** 
40f0: 6f 66 20 74 68 65 20 6a 6f 69 6e 2e 20 20 44 69  of the join.  Di
4100: 73 61 62 6c 69 6e 67 20 69 73 20 61 6e 20 6f 70  sabling is an op
4110: 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 20 57 65 20  timization.  We 
4120: 77 6f 75 6c 64 20 67 65 74 20 74 68 65 20 63 6f  would get the co
4130: 72 72 65 63 74 0a 2a 2a 20 72 65 73 75 6c 74 73  rrect.** results
4140: 20 69 66 20 6e 6f 74 68 69 6e 67 20 77 65 72 65   if nothing were
4150: 20 65 76 65 72 20 64 69 73 61 62 6c 65 64 2c 20   ever disabled, 
4160: 62 75 74 20 6a 6f 69 6e 73 20 6d 69 67 68 74 20  but joins might 
4170: 72 75 6e 20 61 20 6c 69 74 74 6c 65 0a 2a 2a 20  run a little.** 
4180: 73 6c 6f 77 65 72 2e 20 20 54 68 65 20 74 72 69  slower.  The tri
4190: 63 6b 20 69 73 20 74 6f 20 64 69 73 61 62 6c 65  ck is to disable
41a0: 20 61 73 20 6d 75 63 68 20 61 73 20 77 65 20 63   as much as we c
41b0: 61 6e 20 77 69 74 68 6f 75 74 20 64 69 73 61 62  an without disab
41c0: 6c 69 6e 67 0a 2a 2a 20 74 6f 6f 20 6d 75 63 68  ling.** too much
41d0: 2e 20 20 49 66 20 77 65 20 64 69 73 61 62 6c 65  .  If we disable
41e0: 64 20 69 6e 20 28 31 29 2c 20 77 65 27 64 20 67  d in (1), we'd g
41f0: 65 74 20 74 68 65 20 77 72 6f 6e 67 20 61 6e 73  et the wrong ans
4200: 77 65 72 2e 0a 2a 2a 20 53 65 65 20 74 69 63 6b  wer..** See tick
4210: 65 74 20 23 38 31 33 2e 0a 2a 2f 0a 73 74 61 74  et #813..*/.stat
4220: 69 63 20 76 6f 69 64 20 64 69 73 61 62 6c 65 54  ic void disableT
4230: 65 72 6d 28 57 68 65 72 65 4c 65 76 65 6c 20 2a  erm(WhereLevel *
4240: 70 4c 65 76 65 6c 2c 20 45 78 70 72 20 2a 2a 70  pLevel, Expr **p
4250: 70 45 78 70 72 29 7b 0a 20 20 45 78 70 72 20 2a  pExpr){.  Expr *
4260: 70 45 78 70 72 20 3d 20 2a 70 70 45 78 70 72 3b  pExpr = *ppExpr;
4270: 0a 20 20 69 66 28 20 70 4c 65 76 65 6c 2d 3e 69  .  if( pLevel->i
4280: 4c 65 66 74 4a 6f 69 6e 3d 3d 30 20 7c 7c 20 45  LeftJoin==0 || E
4290: 78 70 72 48 61 73 50 72 6f 70 65 72 74 79 28 70  xprHasProperty(p
42a0: 45 78 70 72 2c 20 45 50 5f 46 72 6f 6d 4a 6f 69  Expr, EP_FromJoi
42b0: 6e 29 20 29 7b 0a 20 20 20 20 2a 70 70 45 78 70  n) ){.    *ppExp
42c0: 72 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  r = 0;.  }.}../*
42d0: 0a 2a 2a 20 47 65 6e 65 72 61 74 65 20 63 6f 64  .** Generate cod
42e0: 65 20 74 68 61 74 20 62 75 69 6c 64 73 20 61 20  e that builds a 
42f0: 70 72 6f 62 65 20 66 6f 72 20 61 6e 20 69 6e 64  probe for an ind
4300: 65 78 2e 20 20 44 65 74 61 69 6c 73 3a 0a 2a 2a  ex.  Details:.**
4310: 0a 2a 2a 20 20 20 20 2a 20 20 43 68 65 63 6b 20  .**    *  Check 
4320: 74 68 65 20 74 6f 70 20 6e 43 6f 6c 75 6d 6e 20  the top nColumn 
4330: 65 6e 74 72 69 65 73 20 6f 6e 20 74 68 65 20 73  entries on the s
4340: 74 61 63 6b 2e 20 20 49 66 20 61 6e 79 0a 2a 2a  tack.  If any.**
4350: 20 20 20 20 20 20 20 6f 66 20 74 68 6f 73 65 20         of those 
4360: 65 6e 74 72 69 65 73 20 61 72 65 20 4e 55 4c 4c  entries are NULL
4370: 2c 20 6a 75 6d 70 20 69 6d 6d 65 64 69 61 74 65  , jump immediate
4380: 6c 79 20 74 6f 20 62 72 6b 2c 0a 2a 2a 20 20 20  ly to brk,.**   
4390: 20 20 20 20 77 68 69 63 68 20 69 73 20 74 68 65      which is the
43a0: 20 6c 6f 6f 70 20 65 78 69 74 2c 20 73 69 6e 63   loop exit, sinc
43b0: 65 20 6e 6f 20 69 6e 64 65 78 20 65 6e 74 72 79  e no index entry
43c0: 20 77 69 6c 6c 20 6d 61 74 63 68 0a 2a 2a 20 20   will match.**  
43d0: 20 20 20 20 20 69 66 20 61 6e 79 20 70 61 72 74       if any part
43e0: 20 6f 66 20 74 68 65 20 6b 65 79 20 69 73 20 4e   of the key is N
43f0: 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20  ULL..**.**    * 
4400: 20 43 6f 6e 73 74 72 75 63 74 20 61 20 70 72 6f   Construct a pro
4410: 62 65 20 65 6e 74 72 79 20 66 72 6f 6d 20 74 68  be entry from th
4420: 65 20 74 6f 70 20 6e 43 6f 6c 75 6d 6e 20 65 6e  e top nColumn en
4430: 74 72 69 65 73 20 69 6e 0a 2a 2a 20 20 20 20 20  tries in.**     
4440: 20 20 74 68 65 20 73 74 61 63 6b 20 77 69 74 68    the stack with
4450: 20 61 66 66 69 6e 69 74 69 65 73 20 61 70 70 72   affinities appr
4460: 6f 70 72 69 61 74 65 20 66 6f 72 20 69 6e 64 65  opriate for inde
4470: 78 20 70 49 64 78 2e 0a 2a 2f 0a 73 74 61 74 69  x pIdx..*/.stati
4480: 63 20 76 6f 69 64 20 62 75 69 6c 64 49 6e 64 65  c void buildInde
4490: 78 50 72 6f 62 65 28 56 64 62 65 20 2a 76 2c 20  xProbe(Vdbe *v, 
44a0: 69 6e 74 20 6e 43 6f 6c 75 6d 6e 2c 20 69 6e 74  int nColumn, int
44b0: 20 62 72 6b 2c 20 49 6e 64 65 78 20 2a 70 49 64   brk, Index *pId
44c0: 78 29 7b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  x){.  sqlite3Vdb
44d0: 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f 4e 6f 74  eAddOp(v, OP_Not
44e0: 4e 75 6c 6c 2c 20 2d 6e 43 6f 6c 75 6d 6e 2c 20  Null, -nColumn, 
44f0: 73 71 6c 69 74 65 33 56 64 62 65 43 75 72 72 65  sqlite3VdbeCurre
4500: 6e 74 41 64 64 72 28 76 29 2b 33 29 3b 0a 20 20  ntAddr(v)+3);.  
4510: 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70  sqlite3VdbeAddOp
4520: 28 76 2c 20 4f 50 5f 50 6f 70 2c 20 6e 43 6f 6c  (v, OP_Pop, nCol
4530: 75 6d 6e 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74  umn, 0);.  sqlit
4540: 65 33 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f  e3VdbeAddOp(v, O
4550: 50 5f 47 6f 74 6f 2c 20 30 2c 20 62 72 6b 29 3b  P_Goto, 0, brk);
4560: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64  .  sqlite3VdbeAd
4570: 64 4f 70 28 76 2c 20 4f 50 5f 4d 61 6b 65 52 65  dOp(v, OP_MakeRe
4580: 63 6f 72 64 2c 20 6e 43 6f 6c 75 6d 6e 2c 20 30  cord, nColumn, 0
4590: 29 3b 0a 20 20 73 71 6c 69 74 65 33 49 6e 64 65  );.  sqlite3Inde
45a0: 78 41 66 66 69 6e 69 74 79 53 74 72 28 76 2c 20  xAffinityStr(v, 
45b0: 70 49 64 78 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  pIdx);.}../*.** 
45c0: 47 65 6e 65 72 61 74 65 20 63 6f 64 65 20 66 6f  Generate code fo
45d0: 72 20 61 6e 20 65 71 75 61 6c 69 74 79 20 74 65  r an equality te
45e0: 72 6d 20 6f 66 20 74 68 65 20 57 48 45 52 45 20  rm of the WHERE 
45f0: 63 6c 61 75 73 65 2e 20 20 41 6e 20 65 71 75 61  clause.  An equa
4600: 6c 69 74 79 0a 2a 2a 20 74 65 72 6d 20 63 61 6e  lity.** term can
4610: 20 62 65 20 65 69 74 68 65 72 20 58 3d 65 78 70   be either X=exp
4620: 72 20 20 6f 72 20 58 20 49 4e 20 28 2e 2e 2e 29  r  or X IN (...)
4630: 2e 20 20 20 70 54 65 72 6d 20 69 73 20 74 68 65  .   pTerm is the
4640: 20 58 2e 20 20 0a 2a 2f 0a 73 74 61 74 69 63 20   X.  .*/.static 
4650: 76 6f 69 64 20 63 6f 64 65 45 71 75 61 6c 69 74  void codeEqualit
4660: 79 54 65 72 6d 28 0a 20 20 50 61 72 73 65 20 2a  yTerm(.  Parse *
4670: 70 50 61 72 73 65 2c 20 20 20 20 20 20 2f 2a 20  pParse,      /* 
4680: 54 68 65 20 70 61 72 73 69 6e 67 20 63 6f 6e 74  The parsing cont
4690: 65 78 74 20 2a 2f 0a 20 20 45 78 70 72 49 6e 66  ext */.  ExprInf
46a0: 6f 20 2a 70 54 65 72 6d 2c 20 20 20 20 2f 2a 20  o *pTerm,    /* 
46b0: 54 68 65 20 74 65 72 6d 20 6f 66 20 74 68 65 20  The term of the 
46c0: 57 48 45 52 45 20 63 6c 61 75 73 65 20 74 6f 20  WHERE clause to 
46d0: 62 65 20 63 6f 64 65 64 20 2a 2f 0a 20 20 69 6e  be coded */.  in
46e0: 74 20 62 72 6b 2c 20 20 20 20 20 20 20 20 20 20  t brk,          
46f0: 20 20 2f 2a 20 4a 75 6d 70 20 68 65 72 65 20 74    /* Jump here t
4700: 6f 20 61 62 61 6e 64 6f 6e 20 74 68 65 20 6c 6f  o abandon the lo
4710: 6f 70 20 2a 2f 0a 20 20 57 68 65 72 65 4c 65 76  op */.  WhereLev
4720: 65 6c 20 2a 70 4c 65 76 65 6c 20 20 2f 2a 20 57  el *pLevel  /* W
4730: 68 65 6e 20 6c 65 76 65 6c 20 6f 66 20 74 68 65  hen level of the
4740: 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 77 65 20   FROM clause we 
4750: 61 72 65 20 77 6f 72 6b 69 6e 67 20 6f 6e 20 2a  are working on *
4760: 2f 0a 29 7b 0a 20 20 45 78 70 72 20 2a 70 58 20  /.){.  Expr *pX 
4770: 3d 20 70 54 65 72 6d 2d 3e 70 3b 0a 20 20 69 66  = pTerm->p;.  if
4780: 28 20 70 58 2d 3e 6f 70 21 3d 54 4b 5f 49 4e 20  ( pX->op!=TK_IN 
4790: 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  ){.    assert( p
47a0: 58 2d 3e 6f 70 3d 3d 54 4b 5f 45 51 20 29 3b 0a  X->op==TK_EQ );.
47b0: 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 72 43      sqlite3ExprC
47c0: 6f 64 65 28 70 50 61 72 73 65 2c 20 70 58 2d 3e  ode(pParse, pX->
47d0: 70 52 69 67 68 74 29 3b 0a 23 69 66 6e 64 65 66  pRight);.#ifndef
47e0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 55 42   SQLITE_OMIT_SUB
47f0: 51 55 45 52 59 0a 20 20 7d 65 6c 73 65 7b 0a 20  QUERY.  }else{. 
4800: 20 20 20 69 6e 74 20 69 54 61 62 3b 0a 20 20 20     int iTab;.   
4810: 20 56 64 62 65 20 2a 76 20 3d 20 70 50 61 72 73   Vdbe *v = pPars
4820: 65 2d 3e 70 56 64 62 65 3b 0a 0a 20 20 20 20 73  e->pVdbe;..    s
4830: 71 6c 69 74 65 33 43 6f 64 65 53 75 62 73 65 6c  qlite3CodeSubsel
4840: 65 63 74 28 70 50 61 72 73 65 2c 20 70 58 29 3b  ect(pParse, pX);
4850: 0a 20 20 20 20 69 54 61 62 20 3d 20 70 58 2d 3e  .    iTab = pX->
4860: 69 54 61 62 6c 65 3b 0a 20 20 20 20 73 71 6c 69  iTable;.    sqli
4870: 74 65 33 56 64 62 65 41 64 64 4f 70 28 76 2c 20  te3VdbeAddOp(v, 
4880: 4f 50 5f 52 65 77 69 6e 64 2c 20 69 54 61 62 2c  OP_Rewind, iTab,
4890: 20 62 72 6b 29 3b 0a 20 20 20 20 73 71 6c 69 74   brk);.    sqlit
48a0: 65 33 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f  e3VdbeAddOp(v, O
48b0: 50 5f 4b 65 79 41 73 44 61 74 61 2c 20 69 54 61  P_KeyAsData, iTa
48c0: 62 2c 20 31 29 3b 0a 20 20 20 20 56 64 62 65 43  b, 1);.    VdbeC
48d0: 6f 6d 6d 65 6e 74 28 28 76 2c 20 22 23 20 25 2e  omment((v, "# %.
48e0: 2a 73 22 2c 20 70 58 2d 3e 73 70 61 6e 2e 6e 2c  *s", pX->span.n,
48f0: 20 70 58 2d 3e 73 70 61 6e 2e 7a 29 29 3b 0a 20   pX->span.z));. 
4900: 20 20 20 70 4c 65 76 65 6c 2d 3e 69 6e 50 32 20     pLevel->inP2 
4910: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64  = sqlite3VdbeAdd
4920: 4f 70 28 76 2c 20 4f 50 5f 43 6f 6c 75 6d 6e 2c  Op(v, OP_Column,
4930: 20 69 54 61 62 2c 20 30 29 3b 0a 20 20 20 20 70   iTab, 0);.    p
4940: 4c 65 76 65 6c 2d 3e 69 6e 4f 70 20 3d 20 4f 50  Level->inOp = OP
4950: 5f 4e 65 78 74 3b 0a 20 20 20 20 70 4c 65 76 65  _Next;.    pLeve
4960: 6c 2d 3e 69 6e 50 31 20 3d 20 69 54 61 62 3b 0a  l->inP1 = iTab;.
4970: 23 65 6e 64 69 66 0a 20 20 7d 0a 20 20 64 69 73  #endif.  }.  dis
4980: 61 62 6c 65 54 65 72 6d 28 70 4c 65 76 65 6c 2c  ableTerm(pLevel,
4990: 20 26 70 54 65 72 6d 2d 3e 70 29 3b 0a 7d 0a 0a   &pTerm->p);.}..
49a0: 2f 2a 0a 2a 2a 20 54 68 65 20 6e 75 6d 62 65 72  /*.** The number
49b0: 20 6f 66 20 62 69 74 73 20 69 6e 20 61 20 42 69   of bits in a Bi
49c0: 74 6d 61 73 6b 0a 2a 2f 0a 23 64 65 66 69 6e 65  tmask.*/.#define
49d0: 20 42 4d 53 20 20 28 73 69 7a 65 6f 66 28 42 69   BMS  (sizeof(Bi
49e0: 74 6d 61 73 6b 29 2a 38 2d 31 29 0a 0a 0a 2f 2a  tmask)*8-1).../*
49f0: 0a 2a 2a 20 47 65 6e 65 72 61 74 65 20 74 68 65  .** Generate the
4a00: 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68   beginning of th
4a10: 65 20 6c 6f 6f 70 20 75 73 65 64 20 66 6f 72 20  e loop used for 
4a20: 57 48 45 52 45 20 63 6c 61 75 73 65 20 70 72 6f  WHERE clause pro
4a30: 63 65 73 73 69 6e 67 2e 0a 2a 2a 20 54 68 65 20  cessing..** The 
4a40: 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20  return value is 
4a50: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20  a pointer to an 
4a60: 6f 70 61 71 75 65 20 73 74 72 75 63 74 75 72 65  opaque structure
4a70: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 0a 2a   that contains.*
4a80: 2a 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6e 65  * information ne
4a90: 65 64 65 64 20 74 6f 20 74 65 72 6d 69 6e 61 74  eded to terminat
4aa0: 65 20 74 68 65 20 6c 6f 6f 70 2e 20 20 4c 61 74  e the loop.  Lat
4ab0: 65 72 2c 20 74 68 65 20 63 61 6c 6c 69 6e 67 20  er, the calling 
4ac0: 72 6f 75 74 69 6e 65 0a 2a 2a 20 73 68 6f 75 6c  routine.** shoul
4ad0: 64 20 69 6e 76 6f 6b 65 20 73 71 6c 69 74 65 33  d invoke sqlite3
4ae0: 57 68 65 72 65 45 6e 64 28 29 20 77 69 74 68 20  WhereEnd() with 
4af0: 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65  the return value
4b00: 20 6f 66 20 74 68 69 73 20 66 75 6e 63 74 69 6f   of this functio
4b10: 6e 0a 2a 2a 20 69 6e 20 6f 72 64 65 72 20 74 6f  n.** in order to
4b20: 20 63 6f 6d 70 6c 65 74 65 20 74 68 65 20 57 48   complete the WH
4b30: 45 52 45 20 63 6c 61 75 73 65 20 70 72 6f 63 65  ERE clause proce
4b40: 73 73 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  ssing..**.** If 
4b50: 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c  an error occurs,
4b60: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65   this routine re
4b70: 74 75 72 6e 73 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a  turns NULL..**.*
4b80: 2a 20 54 68 65 20 62 61 73 69 63 20 69 64 65 61  * The basic idea
4b90: 20 69 73 20 74 6f 20 64 6f 20 61 20 6e 65 73 74   is to do a nest
4ba0: 65 64 20 6c 6f 6f 70 2c 20 6f 6e 65 20 6c 6f 6f  ed loop, one loo
4bb0: 70 20 66 6f 72 20 65 61 63 68 20 74 61 62 6c 65  p for each table
4bc0: 20 69 6e 0a 2a 2a 20 74 68 65 20 46 52 4f 4d 20   in.** the FROM 
4bd0: 63 6c 61 75 73 65 20 6f 66 20 61 20 73 65 6c 65  clause of a sele
4be0: 63 74 2e 20 20 28 49 4e 53 45 52 54 20 61 6e 64  ct.  (INSERT and
4bf0: 20 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e   UPDATE statemen
4c00: 74 73 20 61 72 65 20 74 68 65 0a 2a 2a 20 73 61  ts are the.** sa
4c10: 6d 65 20 61 73 20 61 20 53 45 4c 45 43 54 20 77  me as a SELECT w
4c20: 69 74 68 20 6f 6e 6c 79 20 61 20 73 69 6e 67 6c  ith only a singl
4c30: 65 20 74 61 62 6c 65 20 69 6e 20 74 68 65 20 46  e table in the F
4c40: 52 4f 4d 20 63 6c 61 75 73 65 2e 29 20 20 46 6f  ROM clause.)  Fo
4c50: 72 0a 2a 2a 20 65 78 61 6d 70 6c 65 2c 20 69 66  r.** example, if
4c60: 20 74 68 65 20 53 51 4c 20 69 73 20 74 68 69 73   the SQL is this
4c70: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 53 45  :.**.**       SE
4c80: 4c 45 43 54 20 2a 20 46 52 4f 4d 20 74 31 2c 20  LECT * FROM t1, 
4c90: 74 32 2c 20 74 33 20 57 48 45 52 45 20 2e 2e 2e  t2, t3 WHERE ...
4ca0: 3b 0a 2a 2a 0a 2a 2a 20 54 68 65 6e 20 74 68 65  ;.**.** Then the
4cb0: 20 63 6f 64 65 20 67 65 6e 65 72 61 74 65 64 20   code generated 
4cc0: 69 73 20 63 6f 6e 63 65 70 74 75 61 6c 6c 79 20  is conceptually 
4cd0: 6c 69 6b 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69  like the followi
4ce0: 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 66  ng:.**.**      f
4cf0: 6f 72 65 61 63 68 20 72 6f 77 31 20 69 6e 20 74  oreach row1 in t
4d00: 31 20 64 6f 20 20 20 20 20 20 20 5c 20 20 20 20  1 do       \    
4d10: 43 6f 64 65 20 67 65 6e 65 72 61 74 65 64 0a 2a  Code generated.*
4d20: 2a 20 20 20 20 20 20 20 20 66 6f 72 65 61 63 68  *        foreach
4d30: 20 72 6f 77 32 20 69 6e 20 74 32 20 64 6f 20 20   row2 in t2 do  
4d40: 20 20 20 20 7c 2d 2d 20 62 79 20 73 71 6c 69 74      |-- by sqlit
4d50: 65 33 57 68 65 72 65 42 65 67 69 6e 28 29 0a 2a  e3WhereBegin().*
4d60: 2a 20 20 20 20 20 20 20 20 20 20 66 6f 72 65 61  *          forea
4d70: 63 68 20 72 6f 77 33 20 69 6e 20 74 33 20 64 6f  ch row3 in t3 do
4d80: 20 20 20 2f 0a 2a 2a 20 20 20 20 20 20 20 20 20     /.**         
4d90: 20 20 20 2e 2e 2e 0a 2a 2a 20 20 20 20 20 20 20     ....**       
4da0: 20 20 20 65 6e 64 20 20 20 20 20 20 20 20 20 20     end          
4db0: 20 20 20 20 20 20 20 20 20 20 20 5c 20 20 20 20             \    
4dc0: 43 6f 64 65 20 67 65 6e 65 72 61 74 65 64 0a 2a  Code generated.*
4dd0: 2a 20 20 20 20 20 20 20 20 65 6e 64 20 20 20 20  *        end    
4de0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4df0: 20 20 20 20 7c 2d 2d 20 62 79 20 73 71 6c 69 74      |-- by sqlit
4e00: 65 33 57 68 65 72 65 45 6e 64 28 29 0a 2a 2a 20  e3WhereEnd().** 
4e10: 20 20 20 20 20 65 6e 64 20 20 20 20 20 20 20 20       end        
4e20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4e30: 20 2f 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 61   /.**.** There a
4e40: 72 65 20 42 74 72 65 65 20 63 75 72 73 6f 72 73  re Btree cursors
4e50: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
4e60: 20 65 61 63 68 20 74 61 62 6c 65 2e 20 20 74 31   each table.  t1
4e70: 20 75 73 65 73 20 63 75 72 73 6f 72 0a 2a 2a 20   uses cursor.** 
4e80: 6e 75 6d 62 65 72 20 70 54 61 62 4c 69 73 74 2d  number pTabList-
4e90: 3e 61 5b 30 5d 2e 69 43 75 72 73 6f 72 2e 20 20  >a[0].iCursor.  
4ea0: 74 32 20 75 73 65 73 20 74 68 65 20 63 75 72 73  t2 uses the curs
4eb0: 6f 72 20 70 54 61 62 4c 69 73 74 2d 3e 61 5b 31  or pTabList->a[1
4ec0: 5d 2e 69 43 75 72 73 6f 72 2e 0a 2a 2a 20 41 6e  ].iCursor..** An
4ed0: 64 20 73 6f 20 66 6f 72 74 68 2e 20 20 54 68 69  d so forth.  Thi
4ee0: 73 20 72 6f 75 74 69 6e 65 20 67 65 6e 65 72 61  s routine genera
4ef0: 74 65 73 20 63 6f 64 65 20 74 6f 20 6f 70 65 6e  tes code to open
4f00: 20 74 68 6f 73 65 20 56 44 42 45 20 63 75 72 73   those VDBE curs
4f10: 6f 72 73 0a 2a 2a 20 61 6e 64 20 73 71 6c 69 74  ors.** and sqlit
4f20: 65 33 57 68 65 72 65 45 6e 64 28 29 20 67 65 6e  e3WhereEnd() gen
4f30: 65 72 61 74 65 73 20 74 68 65 20 63 6f 64 65 20  erates the code 
4f40: 74 6f 20 63 6c 6f 73 65 20 74 68 65 6d 2e 0a 2a  to close them..*
4f50: 2a 0a 2a 2a 20 54 68 65 20 63 6f 64 65 20 74 68  *.** The code th
4f60: 61 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 42  at sqlite3WhereB
4f70: 65 67 69 6e 28 29 20 67 65 6e 65 72 61 74 65 73  egin() generates
4f80: 20 6c 65 61 76 65 73 20 74 68 65 20 63 75 72 73   leaves the curs
4f90: 6f 72 73 20 6e 61 6d 65 64 0a 2a 2a 20 69 6e 20  ors named.** in 
4fa0: 70 54 61 62 4c 69 73 74 20 70 6f 69 6e 74 69 6e  pTabList pointin
4fb0: 67 20 61 74 20 74 68 65 69 72 20 61 70 70 72 6f  g at their appro
4fc0: 70 72 69 61 74 65 20 65 6e 74 72 69 65 73 2e 20  priate entries. 
4fd0: 20 54 68 65 20 5b 2e 2e 2e 5d 20 63 6f 64 65 0a   The [...] code.
4fe0: 2a 2a 20 63 61 6e 20 75 73 65 20 4f 50 5f 43 6f  ** can use OP_Co
4ff0: 6c 75 6d 6e 20 61 6e 64 20 4f 50 5f 52 65 63 6e  lumn and OP_Recn
5000: 6f 20 6f 70 63 6f 64 65 73 20 6f 6e 20 74 68 65  o opcodes on the
5010: 73 65 20 63 75 72 73 6f 72 73 20 74 6f 20 65 78  se cursors to ex
5020: 74 72 61 63 74 0a 2a 2a 20 64 61 74 61 20 66 72  tract.** data fr
5030: 6f 6d 20 74 68 65 20 76 61 72 69 6f 75 73 20 74  om the various t
5040: 61 62 6c 65 73 20 6f 66 20 74 68 65 20 6c 6f 6f  ables of the loo
5050: 70 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20  p..**.** If the 
5060: 57 48 45 52 45 20 63 6c 61 75 73 65 20 69 73 20  WHERE clause is 
5070: 65 6d 70 74 79 2c 20 74 68 65 20 66 6f 72 65 61  empty, the forea
5080: 63 68 20 6c 6f 6f 70 73 20 6d 75 73 74 20 65 61  ch loops must ea
5090: 63 68 20 73 63 61 6e 20 74 68 65 69 72 0a 2a 2a  ch scan their.**
50a0: 20 65 6e 74 69 72 65 20 74 61 62 6c 65 73 2e 20   entire tables. 
50b0: 20 54 68 75 73 20 61 20 74 68 72 65 65 2d 77 61   Thus a three-wa
50c0: 79 20 6a 6f 69 6e 20 69 73 20 61 6e 20 4f 28 4e  y join is an O(N
50d0: 5e 33 29 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20  ^3) operation.  
50e0: 42 75 74 20 69 66 0a 2a 2a 20 74 68 65 20 74 61  But if.** the ta
50f0: 62 6c 65 73 20 68 61 76 65 20 69 6e 64 69 63 65  bles have indice
5100: 73 20 61 6e 64 20 74 68 65 72 65 20 61 72 65 20  s and there are 
5110: 74 65 72 6d 73 20 69 6e 20 74 68 65 20 57 48 45  terms in the WHE
5120: 52 45 20 63 6c 61 75 73 65 20 74 68 61 74 0a 2a  RE clause that.*
5130: 2a 20 72 65 66 65 72 20 74 6f 20 74 68 6f 73 65  * refer to those
5140: 20 69 6e 64 69 63 65 73 2c 20 61 20 63 6f 6d 70   indices, a comp
5150: 6c 65 74 65 20 74 61 62 6c 65 20 73 63 61 6e 20  lete table scan 
5160: 63 61 6e 20 62 65 20 61 76 6f 69 64 65 64 20 61  can be avoided a
5170: 6e 64 20 74 68 65 0a 2a 2a 20 63 6f 64 65 20 77  nd the.** code w
5180: 69 6c 6c 20 72 75 6e 20 6d 75 63 68 20 66 61 73  ill run much fas
5190: 74 65 72 2e 20 20 4d 6f 73 74 20 6f 66 20 74 68  ter.  Most of th
51a0: 65 20 77 6f 72 6b 20 6f 66 20 74 68 69 73 20 72  e work of this r
51b0: 6f 75 74 69 6e 65 20 69 73 20 63 68 65 63 6b 69  outine is checki
51c0: 6e 67 0a 2a 2a 20 74 6f 20 73 65 65 20 69 66 20  ng.** to see if 
51d0: 74 68 65 72 65 20 61 72 65 20 69 6e 64 69 63 65  there are indice
51e0: 73 20 74 68 61 74 20 63 61 6e 20 62 65 20 75 73  s that can be us
51f0: 65 64 20 74 6f 20 73 70 65 65 64 20 75 70 20 74  ed to speed up t
5200: 68 65 20 6c 6f 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54  he loop..**.** T
5210: 65 72 6d 73 20 6f 66 20 74 68 65 20 57 48 45 52  erms of the WHER
5220: 45 20 63 6c 61 75 73 65 20 61 72 65 20 61 6c 73  E clause are als
5230: 6f 20 75 73 65 64 20 74 6f 20 6c 69 6d 69 74 20  o used to limit 
5240: 77 68 69 63 68 20 72 6f 77 73 20 61 63 74 75 61  which rows actua
5250: 6c 6c 79 0a 2a 2a 20 6d 61 6b 65 20 69 74 20 74  lly.** make it t
5260: 6f 20 74 68 65 20 22 2e 2e 2e 22 20 69 6e 20 74  o the "..." in t
5270: 68 65 20 6d 69 64 64 6c 65 20 6f 66 20 74 68 65  he middle of the
5280: 20 6c 6f 6f 70 2e 20 20 41 66 74 65 72 20 65 61   loop.  After ea
5290: 63 68 20 22 66 6f 72 65 61 63 68 22 2c 0a 2a 2a  ch "foreach",.**
52a0: 20 74 65 72 6d 73 20 6f 66 20 74 68 65 20 57 48   terms of the WH
52b0: 45 52 45 20 63 6c 61 75 73 65 20 74 68 61 74 20  ERE clause that 
52c0: 75 73 65 20 6f 6e 6c 79 20 74 65 72 6d 73 20 69  use only terms i
52d0: 6e 20 74 68 61 74 20 6c 6f 6f 70 20 61 6e 64 20  n that loop and 
52e0: 6f 75 74 65 72 0a 2a 2a 20 6c 6f 6f 70 73 20 61  outer.** loops a
52f0: 72 65 20 65 76 61 6c 75 61 74 65 64 20 61 6e 64  re evaluated and
5300: 20 69 66 20 66 61 6c 73 65 20 61 20 6a 75 6d 70   if false a jump
5310: 20 69 73 20 6d 61 64 65 20 61 72 6f 75 6e 64 20   is made around 
5320: 61 6c 6c 20 73 75 62 73 65 71 75 65 6e 74 0a 2a  all subsequent.*
5330: 2a 20 69 6e 6e 65 72 20 6c 6f 6f 70 73 20 28 6f  * inner loops (o
5340: 72 20 61 72 6f 75 6e 64 20 74 68 65 20 22 2e 2e  r around the "..
5350: 2e 22 20 69 66 20 74 68 65 20 74 65 73 74 20 6f  ." if the test o
5360: 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 68 65  ccurs within the
5370: 20 69 6e 6e 65 72 2d 0a 2a 2a 20 6d 6f 73 74 20   inner-.** most 
5380: 6c 6f 6f 70 29 0a 2a 2a 0a 2a 2a 20 4f 55 54 45  loop).**.** OUTE
5390: 52 20 4a 4f 49 4e 53 0a 2a 2a 0a 2a 2a 20 41 6e  R JOINS.**.** An
53a0: 20 6f 75 74 65 72 20 6a 6f 69 6e 20 6f 66 20 74   outer join of t
53b0: 61 62 6c 65 73 20 74 31 20 61 6e 64 20 74 32 20  ables t1 and t2 
53c0: 69 73 20 63 6f 6e 63 65 70 74 61 6c 6c 79 20 63  is conceptally c
53d0: 6f 64 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a  oded as follows:
53e0: 0a 2a 2a 0a 2a 2a 20 20 20 20 66 6f 72 65 61 63  .**.**    foreac
53f0: 68 20 72 6f 77 31 20 69 6e 20 74 31 20 64 6f 0a  h row1 in t1 do.
5400: 2a 2a 20 20 20 20 20 20 66 6c 61 67 20 3d 20 30  **      flag = 0
5410: 0a 2a 2a 20 20 20 20 20 20 66 6f 72 65 61 63 68  .**      foreach
5420: 20 72 6f 77 32 20 69 6e 20 74 32 20 64 6f 0a 2a   row2 in t2 do.*
5430: 2a 20 20 20 20 20 20 20 20 73 74 61 72 74 3a 0a  *        start:.
5440: 2a 2a 20 20 20 20 20 20 20 20 20 20 2e 2e 2e 0a  **          ....
5450: 2a 2a 20 20 20 20 20 20 20 20 20 20 66 6c 61 67  **          flag
5460: 20 3d 20 31 0a 2a 2a 20 20 20 20 20 20 65 6e 64   = 1.**      end
5470: 0a 2a 2a 20 20 20 20 20 20 69 66 20 66 6c 61 67  .**      if flag
5480: 3d 3d 30 20 74 68 65 6e 0a 2a 2a 20 20 20 20 20  ==0 then.**     
5490: 20 20 20 6d 6f 76 65 20 74 68 65 20 72 6f 77 32     move the row2
54a0: 20 63 75 72 73 6f 72 20 74 6f 20 61 20 6e 75 6c   cursor to a nul
54b0: 6c 20 72 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20  l row.**        
54c0: 67 6f 74 6f 20 73 74 61 72 74 0a 2a 2a 20 20 20  goto start.**   
54d0: 20 20 20 66 69 0a 2a 2a 20 20 20 20 65 6e 64 0a     fi.**    end.
54e0: 2a 2a 0a 2a 2a 20 4f 52 44 45 52 20 42 59 20 43  **.** ORDER BY C
54f0: 4c 41 55 53 45 20 50 52 4f 43 45 53 53 49 4e 47  LAUSE PROCESSING
5500: 0a 2a 2a 0a 2a 2a 20 2a 70 70 4f 72 64 65 72 42  .**.** *ppOrderB
5510: 79 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74  y is a pointer t
5520: 6f 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 63  o the ORDER BY c
5530: 6c 61 75 73 65 20 6f 66 20 61 20 53 45 4c 45 43  lause of a SELEC
5540: 54 20 73 74 61 74 65 6d 65 6e 74 2c 0a 2a 2a 20  T statement,.** 
5550: 69 66 20 74 68 65 72 65 20 69 73 20 6f 6e 65 2e  if there is one.
5560: 20 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f    If there is no
5570: 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65   ORDER BY clause
5580: 20 6f 72 20 69 66 20 74 68 69 73 20 72 6f 75 74   or if this rout
5590: 69 6e 65 0a 2a 2a 20 69 73 20 63 61 6c 6c 65 64  ine.** is called
55a0: 20 66 72 6f 6d 20 61 6e 20 55 50 44 41 54 45 20   from an UPDATE 
55b0: 6f 72 20 44 45 4c 45 54 45 20 73 74 61 74 65 6d  or DELETE statem
55c0: 65 6e 74 2c 20 74 68 65 6e 20 70 70 4f 72 64 65  ent, then ppOrde
55d0: 72 42 79 20 69 73 20 4e 55 4c 4c 2e 0a 2a 2a 0a  rBy is NULL..**.
55e0: 2a 2a 20 49 66 20 61 6e 20 69 6e 64 65 78 20 63  ** If an index c
55f0: 61 6e 20 62 65 20 75 73 65 64 20 73 6f 20 74 68  an be used so th
5600: 61 74 20 74 68 65 20 6e 61 74 75 72 61 6c 20 6f  at the natural o
5610: 75 74 70 75 74 20 6f 72 64 65 72 20 6f 66 20 74  utput order of t
5620: 68 65 20 74 61 62 6c 65 0a 2a 2a 20 73 63 61 6e  he table.** scan
5630: 20 69 73 20 63 6f 72 72 65 63 74 20 66 6f 72 20   is correct for 
5640: 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61  the ORDER BY cla
5650: 75 73 65 2c 20 74 68 65 6e 20 74 68 61 74 20 69  use, then that i
5660: 6e 64 65 78 20 69 73 20 75 73 65 64 20 61 6e 64  ndex is used and
5670: 0a 2a 2a 20 2a 70 70 4f 72 64 65 72 42 79 20 69  .** *ppOrderBy i
5680: 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 2e 20 20  s set to NULL.  
5690: 54 68 69 73 20 69 73 20 61 6e 20 6f 70 74 69 6d  This is an optim
56a0: 69 7a 61 74 69 6f 6e 20 74 68 61 74 20 70 72 65  ization that pre
56b0: 76 65 6e 74 73 20 61 6e 0a 2a 2a 20 75 6e 6e 65  vents an.** unne
56c0: 63 65 73 73 61 72 79 20 73 6f 72 74 20 6f 66 20  cessary sort of 
56d0: 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 69  the result set i
56e0: 66 20 61 6e 20 69 6e 64 65 78 20 61 70 70 72 6f  f an index appro
56f0: 70 72 69 61 74 65 20 66 6f 72 20 74 68 65 0a 2a  priate for the.*
5700: 2a 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73  * ORDER BY claus
5710: 65 20 61 6c 72 65 61 64 79 20 65 78 69 73 74 73  e already exists
5720: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 77  ..**.** If the w
5730: 68 65 72 65 20 63 6c 61 75 73 65 20 6c 6f 6f 70  here clause loop
5740: 73 20 63 61 6e 6e 6f 74 20 62 65 20 61 72 72 61  s cannot be arra
5750: 6e 67 65 64 20 74 6f 20 70 72 6f 76 69 64 65 20  nged to provide 
5760: 74 68 65 20 63 6f 72 72 65 63 74 0a 2a 2a 20 6f  the correct.** o
5770: 75 74 70 75 74 20 6f 72 64 65 72 2c 20 74 68 65  utput order, the
5780: 6e 20 74 68 65 20 2a 70 70 4f 72 64 65 72 42 79  n the *ppOrderBy
5790: 20 69 73 20 75 6e 63 68 61 6e 67 65 64 2e 0a 2a   is unchanged..*
57a0: 2f 0a 57 68 65 72 65 49 6e 66 6f 20 2a 73 71 6c  /.WhereInfo *sql
57b0: 69 74 65 33 57 68 65 72 65 42 65 67 69 6e 28 0a  ite3WhereBegin(.
57c0: 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c    Parse *pParse,
57d0: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70          /* The p
57e0: 61 72 73 65 72 20 63 6f 6e 74 65 78 74 20 2a 2f  arser context */
57f0: 0a 20 20 53 72 63 4c 69 73 74 20 2a 70 54 61 62  .  SrcList *pTab
5800: 4c 69 73 74 2c 20 20 20 20 2f 2a 20 41 20 6c 69  List,    /* A li
5810: 73 74 20 6f 66 20 61 6c 6c 20 74 61 62 6c 65 73  st of all tables
5820: 20 74 6f 20 62 65 20 73 63 61 6e 6e 65 64 20 2a   to be scanned *
5830: 2f 0a 20 20 45 78 70 72 20 2a 70 57 68 65 72 65  /.  Expr *pWhere
5840: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65  ,         /* The
5850: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 2a 2f   WHERE clause */
5860: 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 2a 70 70  .  ExprList **pp
5870: 4f 72 64 65 72 42 79 20 20 2f 2a 20 41 6e 20 4f  OrderBy  /* An O
5880: 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 2c 20  RDER BY clause, 
5890: 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 29 7b 0a 20 20  or NULL */.){.  
58a0: 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 20  int i;          
58b0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f             /* Lo
58c0: 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20  op counter */.  
58d0: 57 68 65 72 65 49 6e 66 6f 20 2a 70 57 49 6e 66  WhereInfo *pWInf
58e0: 6f 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 57 69  o;         /* Wi
58f0: 6c 6c 20 62 65 63 6f 6d 65 20 74 68 65 20 72 65  ll become the re
5900: 74 75 72 6e 20 76 61 6c 75 65 20 6f 66 20 74 68  turn value of th
5910: 69 73 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20  is function */. 
5920: 20 56 64 62 65 20 2a 76 20 3d 20 70 50 61 72 73   Vdbe *v = pPars
5930: 65 2d 3e 70 56 64 62 65 3b 20 20 20 2f 2a 20 54  e->pVdbe;   /* T
5940: 68 65 20 76 69 72 74 75 61 6c 20 64 61 74 61 62  he virtual datab
5950: 61 73 65 20 65 6e 67 69 6e 65 20 2a 2f 0a 20 20  ase engine */.  
5960: 69 6e 74 20 62 72 6b 2c 20 63 6f 6e 74 20 3d 20  int brk, cont = 
5970: 30 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64  0;         /* Ad
5980: 64 72 65 73 73 65 73 20 75 73 65 64 20 64 75 72  dresses used dur
5990: 69 6e 67 20 63 6f 64 65 20 67 65 6e 65 72 61 74  ing code generat
59a0: 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 78  ion */.  int nEx
59b0: 70 72 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a  pr;           /*
59c0: 20 4e 75 6d 62 65 72 20 6f 66 20 73 75 62 65 78   Number of subex
59d0: 70 72 65 73 73 69 6f 6e 73 20 69 6e 20 74 68 65  pressions in the
59e0: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 2a 2f   WHERE clause */
59f0: 0a 20 20 42 69 74 6d 61 73 6b 20 6c 6f 6f 70 4d  .  Bitmask loopM
5a00: 61 73 6b 3b 20 20 20 20 2f 2a 20 4f 6e 65 20 62  ask;    /* One b
5a10: 69 74 20 73 65 74 20 66 6f 72 20 65 61 63 68 20  it set for each 
5a20: 6f 75 74 65 72 20 6c 6f 6f 70 20 2a 2f 0a 20 20  outer loop */.  
5a30: 45 78 70 72 49 6e 66 6f 20 2a 70 54 65 72 6d 3b  ExprInfo *pTerm;
5a40: 20 20 20 20 20 2f 2a 20 41 20 73 69 6e 67 6c 65       /* A single
5a50: 20 74 65 72 6d 20 69 6e 20 74 68 65 20 57 48 45   term in the WHE
5a60: 52 45 20 63 6c 61 75 73 65 3b 20 70 74 72 20 74  RE clause; ptr t
5a70: 6f 20 61 45 78 70 72 5b 5d 20 2a 2f 0a 20 20 45  o aExpr[] */.  E
5a80: 78 70 72 4d 61 73 6b 53 65 74 20 6d 61 73 6b 53  xprMaskSet maskS
5a90: 65 74 3b 20 2f 2a 20 54 68 65 20 65 78 70 72 65  et; /* The expre
5aa0: 73 73 69 6f 6e 20 6d 61 73 6b 20 73 65 74 20 2a  ssion mask set *
5ab0: 2f 0a 20 20 69 6e 74 20 69 44 69 72 65 63 74 45  /.  int iDirectE
5ac0: 71 5b 42 4d 53 5d 3b 20 20 2f 2a 20 54 65 72 6d  q[BMS];  /* Term
5ad0: 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 52 4f 57   of the form ROW
5ae0: 49 44 3d 3d 58 20 66 6f 72 20 74 68 65 20 4e 2d  ID==X for the N-
5af0: 74 68 20 74 61 62 6c 65 20 2a 2f 0a 20 20 69 6e  th table */.  in
5b00: 74 20 69 44 69 72 65 63 74 4c 74 5b 42 4d 53 5d  t iDirectLt[BMS]
5b10: 3b 20 20 2f 2a 20 54 65 72 6d 20 6f 66 20 74 68  ;  /* Term of th
5b20: 65 20 66 6f 72 6d 20 52 4f 57 49 44 3c 58 20 6f  e form ROWID<X o
5b30: 72 20 52 4f 57 49 44 3c 3d 58 20 2a 2f 0a 20 20  r ROWID<=X */.  
5b40: 69 6e 74 20 69 44 69 72 65 63 74 47 74 5b 42 4d  int iDirectGt[BM
5b50: 53 5d 3b 20 20 2f 2a 20 54 65 72 6d 20 6f 66 20  S];  /* Term of 
5b60: 74 68 65 20 66 6f 72 6d 20 52 4f 57 49 44 3e 58  the form ROWID>X
5b70: 20 6f 72 20 52 4f 57 49 44 3e 3d 58 20 2a 2f 0a   or ROWID>=X */.
5b80: 20 20 45 78 70 72 49 6e 66 6f 20 61 45 78 70 72    ExprInfo aExpr
5b90: 5b 31 30 31 5d 3b 20 2f 2a 20 54 68 65 20 57 48  [101]; /* The WH
5ba0: 45 52 45 20 63 6c 61 75 73 65 20 69 73 20 64 69  ERE clause is di
5bb0: 76 69 64 65 64 20 69 6e 74 6f 20 74 68 65 73 65  vided into these
5bc0: 20 74 65 72 6d 73 20 2a 2f 0a 20 20 73 74 72 75   terms */.  stru
5bd0: 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20  ct SrcList_item 
5be0: 2a 70 54 61 62 49 74 65 6d 3b 20 20 2f 2a 20 41  *pTabItem;  /* A
5bf0: 20 73 69 6e 67 6c 65 20 65 6e 74 72 79 20 66 72   single entry fr
5c00: 6f 6d 20 70 54 61 62 4c 69 73 74 20 2a 2f 0a 20  om pTabList */. 
5c10: 20 57 68 65 72 65 4c 65 76 65 6c 20 2a 70 4c 65   WhereLevel *pLe
5c20: 76 65 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20  vel;            
5c30: 20 2f 2a 20 41 20 73 69 6e 67 6c 65 20 6c 65 76   /* A single lev
5c40: 65 6c 20 69 6e 20 74 68 65 20 70 57 49 6e 66 6f  el in the pWInfo
5c50: 20 6c 69 73 74 20 2a 2f 0a 0a 20 20 2f 2a 20 54   list */..  /* T
5c60: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 65 72  he number of ter
5c70: 6d 73 20 69 6e 20 74 68 65 20 46 52 4f 4d 20 63  ms in the FROM c
5c80: 6c 61 75 73 65 20 69 73 20 6c 69 6d 69 74 65 64  lause is limited
5c90: 20 62 79 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   by the number o
5ca0: 66 0a 20 20 2a 2a 20 62 69 74 73 20 69 6e 20 61  f.  ** bits in a
5cb0: 20 42 69 74 6d 61 73 6b 20 0a 20 20 2a 2f 0a 20   Bitmask .  */. 
5cc0: 20 69 66 28 20 70 54 61 62 4c 69 73 74 2d 3e 6e   if( pTabList->n
5cd0: 53 72 63 3e 73 69 7a 65 6f 66 28 42 69 74 6d 61  Src>sizeof(Bitma
5ce0: 73 6b 29 2a 38 20 29 7b 0a 20 20 20 20 73 71 6c  sk)*8 ){.    sql
5cf0: 69 74 65 33 45 72 72 6f 72 4d 73 67 28 70 50 61  ite3ErrorMsg(pPa
5d00: 72 73 65 2c 20 22 61 74 20 6d 6f 73 74 20 25 64  rse, "at most %d
5d10: 20 74 61 62 6c 65 73 20 69 6e 20 61 20 6a 6f 69   tables in a joi
5d20: 6e 22 2c 0a 20 20 20 20 20 20 20 73 69 7a 65 6f  n",.       sizeo
5d30: 66 28 42 69 74 6d 61 73 6b 29 2a 38 29 3b 0a 20  f(Bitmask)*8);. 
5d40: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
5d50: 0a 0a 20 20 2f 2a 20 53 70 6c 69 74 20 74 68 65  ..  /* Split the
5d60: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 69 6e   WHERE clause in
5d70: 74 6f 20 73 65 70 61 72 61 74 65 20 73 75 62 65  to separate sube
5d80: 78 70 72 65 73 73 69 6f 6e 73 20 77 68 65 72 65  xpressions where
5d90: 20 65 61 63 68 0a 20 20 2a 2a 20 73 75 62 65 78   each.  ** subex
5da0: 70 72 65 73 73 69 6f 6e 20 69 73 20 73 65 70 61  pression is sepa
5db0: 72 61 74 65 64 20 62 79 20 61 6e 20 41 4e 44 20  rated by an AND 
5dc0: 6f 70 65 72 61 74 6f 72 2e 20 20 49 66 20 74 68  operator.  If th
5dd0: 65 20 61 45 78 70 72 5b 5d 0a 20 20 2a 2a 20 61  e aExpr[].  ** a
5de0: 72 72 61 79 20 66 69 6c 6c 73 20 75 70 2c 20 74  rray fills up, t
5df0: 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20 6d 69  he last entry mi
5e00: 67 68 74 20 70 6f 69 6e 74 20 74 6f 20 61 6e 20  ght point to an 
5e10: 65 78 70 72 65 73 73 69 6f 6e 20 77 68 69 63 68  expression which
5e20: 0a 20 20 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 61  .  ** contains a
5e30: 64 64 69 74 69 6f 6e 61 6c 20 75 6e 66 61 63 74  dditional unfact
5e40: 6f 72 65 64 20 41 4e 44 20 6f 70 65 72 61 74 6f  ored AND operato
5e50: 72 73 2e 0a 20 20 2a 2f 0a 20 20 69 6e 69 74 4d  rs..  */.  initM
5e60: 61 73 6b 53 65 74 28 26 6d 61 73 6b 53 65 74 29  askSet(&maskSet)
5e70: 3b 0a 20 20 6d 65 6d 73 65 74 28 61 45 78 70 72  ;.  memset(aExpr
5e80: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 61 45 78 70  , 0, sizeof(aExp
5e90: 72 29 29 3b 0a 20 20 6e 45 78 70 72 20 3d 20 65  r));.  nExpr = e
5ea0: 78 70 72 53 70 6c 69 74 28 41 52 52 41 59 53 49  xprSplit(ARRAYSI
5eb0: 5a 45 28 61 45 78 70 72 29 2c 20 61 45 78 70 72  ZE(aExpr), aExpr
5ec0: 2c 20 70 57 68 65 72 65 29 3b 0a 20 20 69 66 28  , pWhere);.  if(
5ed0: 20 6e 45 78 70 72 3d 3d 41 52 52 41 59 53 49 5a   nExpr==ARRAYSIZ
5ee0: 45 28 61 45 78 70 72 29 20 29 7b 0a 20 20 20 20  E(aExpr) ){.    
5ef0: 73 71 6c 69 74 65 33 45 72 72 6f 72 4d 73 67 28  sqlite3ErrorMsg(
5f00: 70 50 61 72 73 65 2c 20 22 57 48 45 52 45 20 63  pParse, "WHERE c
5f10: 6c 61 75 73 65 20 74 6f 6f 20 63 6f 6d 70 6c 65  lause too comple
5f20: 78 20 2d 20 6e 6f 20 6d 6f 72 65 20 22 0a 20 20  x - no more ".  
5f30: 20 20 20 20 20 22 74 68 61 6e 20 25 64 20 74 65       "than %d te
5f40: 72 6d 73 20 61 6c 6c 6f 77 65 64 22 2c 20 28 69  rms allowed", (i
5f50: 6e 74 29 41 52 52 41 59 53 49 5a 45 28 61 45 78  nt)ARRAYSIZE(aEx
5f60: 70 72 29 2d 31 29 3b 0a 20 20 20 20 72 65 74 75  pr)-1);.    retu
5f70: 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 20 20 0a 20  rn 0;.  }.    . 
5f80: 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 61 6e 64   /* Allocate and
5f90: 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20   initialize the 
5fa0: 57 68 65 72 65 49 6e 66 6f 20 73 74 72 75 63 74  WhereInfo struct
5fb0: 75 72 65 20 74 68 61 74 20 77 69 6c 6c 20 62 65  ure that will be
5fc0: 63 6f 6d 65 20 74 68 65 0a 20 20 2a 2a 20 72 65  come the.  ** re
5fd0: 74 75 72 6e 20 76 61 6c 75 65 2e 0a 20 20 2a 2f  turn value..  */
5fe0: 0a 20 20 70 57 49 6e 66 6f 20 3d 20 73 71 6c 69  .  pWInfo = sqli
5ff0: 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66  teMalloc( sizeof
6000: 28 57 68 65 72 65 49 6e 66 6f 29 20 2b 20 70 54  (WhereInfo) + pT
6010: 61 62 4c 69 73 74 2d 3e 6e 53 72 63 2a 73 69 7a  abList->nSrc*siz
6020: 65 6f 66 28 57 68 65 72 65 4c 65 76 65 6c 29 29  eof(WhereLevel))
6030: 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f  ;.  if( sqlite3_
6040: 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b  malloc_failed ){
6050: 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28  .    sqliteFree(
6060: 70 57 49 6e 66 6f 29 3b 20 2f 2a 20 41 76 6f 69  pWInfo); /* Avoi
6070: 64 20 6c 65 61 6b 69 6e 67 20 6d 65 6d 6f 72 79  d leaking memory
6080: 20 77 68 65 6e 20 6d 61 6c 6c 6f 63 20 66 61 69   when malloc fai
6090: 6c 73 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e  ls */.    return
60a0: 20 30 3b 0a 20 20 7d 0a 20 20 70 57 49 6e 66 6f   0;.  }.  pWInfo
60b0: 2d 3e 70 50 61 72 73 65 20 3d 20 70 50 61 72 73  ->pParse = pPars
60c0: 65 3b 0a 20 20 70 57 49 6e 66 6f 2d 3e 70 54 61  e;.  pWInfo->pTa
60d0: 62 4c 69 73 74 20 3d 20 70 54 61 62 4c 69 73 74  bList = pTabList
60e0: 3b 0a 20 20 70 57 49 6e 66 6f 2d 3e 69 42 72 65  ;.  pWInfo->iBre
60f0: 61 6b 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  ak = sqlite3Vdbe
6100: 4d 61 6b 65 4c 61 62 65 6c 28 76 29 3b 0a 0a 20  MakeLabel(v);.. 
6110: 20 2f 2a 20 53 70 65 63 69 61 6c 20 63 61 73 65   /* Special case
6120: 3a 20 61 20 57 48 45 52 45 20 63 6c 61 75 73 65  : a WHERE clause
6130: 20 74 68 61 74 20 69 73 20 63 6f 6e 73 74 61 6e   that is constan
6140: 74 2e 20 20 45 76 61 6c 75 61 74 65 20 74 68 65  t.  Evaluate the
6150: 0a 20 20 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e  .  ** expression
6160: 20 61 6e 64 20 65 69 74 68 65 72 20 6a 75 6d 70   and either jump
6170: 20 6f 76 65 72 20 61 6c 6c 20 6f 66 20 74 68 65   over all of the
6180: 20 63 6f 64 65 20 6f 72 20 66 61 6c 6c 20 74 68   code or fall th
6190: 72 75 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70  ru..  */.  if( p
61a0: 57 68 65 72 65 20 26 26 20 28 70 54 61 62 4c 69  Where && (pTabLi
61b0: 73 74 2d 3e 6e 53 72 63 3d 3d 30 20 7c 7c 20 73  st->nSrc==0 || s
61c0: 71 6c 69 74 65 33 45 78 70 72 49 73 43 6f 6e 73  qlite3ExprIsCons
61d0: 74 61 6e 74 28 70 57 68 65 72 65 29 29 20 29 7b  tant(pWhere)) ){
61e0: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 72  .    sqlite3Expr
61f0: 49 66 46 61 6c 73 65 28 70 50 61 72 73 65 2c 20  IfFalse(pParse, 
6200: 70 57 68 65 72 65 2c 20 70 57 49 6e 66 6f 2d 3e  pWhere, pWInfo->
6210: 69 42 72 65 61 6b 2c 20 31 29 3b 0a 20 20 20 20  iBreak, 1);.    
6220: 70 57 68 65 72 65 20 3d 20 30 3b 0a 20 20 7d 0a  pWhere = 0;.  }.
6230: 0a 20 20 2f 2a 20 41 6e 61 6c 79 7a 65 20 61 6c  .  /* Analyze al
6240: 6c 20 6f 66 20 74 68 65 20 73 75 62 65 78 70 72  l of the subexpr
6250: 65 73 73 69 6f 6e 73 2e 0a 20 20 2a 2f 0a 20 20  essions..  */.  
6260: 66 6f 72 28 69 3d 30 3b 20 69 3c 70 54 61 62 4c  for(i=0; i<pTabL
6270: 69 73 74 2d 3e 6e 53 72 63 3b 20 69 2b 2b 29 7b  ist->nSrc; i++){
6280: 0a 20 20 20 20 63 72 65 61 74 65 4d 61 73 6b 28  .    createMask(
6290: 26 6d 61 73 6b 53 65 74 2c 20 70 54 61 62 4c 69  &maskSet, pTabLi
62a0: 73 74 2d 3e 61 5b 69 5d 2e 69 43 75 72 73 6f 72  st->a[i].iCursor
62b0: 29 3b 0a 20 20 7d 0a 20 20 66 6f 72 28 70 54 65  );.  }.  for(pTe
62c0: 72 6d 3d 61 45 78 70 72 2c 20 69 3d 30 3b 20 69  rm=aExpr, i=0; i
62d0: 3c 6e 45 78 70 72 3b 20 69 2b 2b 2c 20 70 54 65  <nExpr; i++, pTe
62e0: 72 6d 2b 2b 29 7b 0a 20 20 20 20 65 78 70 72 41  rm++){.    exprA
62f0: 6e 61 6c 79 7a 65 28 70 54 61 62 4c 69 73 74 2c  nalyze(pTabList,
6300: 20 26 6d 61 73 6b 53 65 74 2c 20 70 54 65 72 6d   &maskSet, pTerm
6310: 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 67  );.  }..  /* Fig
6320: 75 72 65 20 6f 75 74 20 77 68 61 74 20 69 6e 64  ure out what ind
6330: 65 78 20 74 6f 20 75 73 65 20 28 69 66 20 61 6e  ex to use (if an
6340: 79 29 20 66 6f 72 20 65 61 63 68 20 6e 65 73 74  y) for each nest
6350: 65 64 20 6c 6f 6f 70 2e 0a 20 20 2a 2a 20 4d 61  ed loop..  ** Ma
6360: 6b 65 20 70 57 49 6e 66 6f 2d 3e 61 5b 69 5d 2e  ke pWInfo->a[i].
6370: 70 49 64 78 20 70 6f 69 6e 74 20 74 6f 20 74 68  pIdx point to th
6380: 65 20 69 6e 64 65 78 20 74 6f 20 75 73 65 20 66  e index to use f
6390: 6f 72 20 74 68 65 20 69 2d 74 68 20 6e 65 73 74  or the i-th nest
63a0: 65 64 0a 20 20 2a 2a 20 6c 6f 6f 70 20 77 68 65  ed.  ** loop whe
63b0: 72 65 20 69 3d 3d 30 20 69 73 20 74 68 65 20 6f  re i==0 is the o
63c0: 75 74 65 72 20 6c 6f 6f 70 20 61 6e 64 20 69 3d  uter loop and i=
63d0: 3d 70 54 61 62 4c 69 73 74 2d 3e 6e 53 72 63 2d  =pTabList->nSrc-
63e0: 31 20 69 73 20 74 68 65 20 69 6e 6e 65 72 0a 20  1 is the inner. 
63f0: 20 2a 2a 20 6c 6f 6f 70 2e 20 0a 20 20 2a 2a 0a   ** loop. .  **.
6400: 20 20 2a 2a 20 49 66 20 74 65 72 6d 73 20 65 78    ** If terms ex
6410: 69 73 74 20 74 68 61 74 20 75 73 65 20 74 68 65  ist that use the
6420: 20 52 4f 57 49 44 20 6f 66 20 61 6e 79 20 74 61   ROWID of any ta
6430: 62 6c 65 2c 20 74 68 65 6e 20 73 65 74 20 74 68  ble, then set th
6440: 65 0a 20 20 2a 2a 20 69 44 69 72 65 63 74 45 71  e.  ** iDirectEq
6450: 5b 5d 2c 20 69 44 69 72 65 63 74 4c 74 5b 5d 2c  [], iDirectLt[],
6460: 20 6f 72 20 69 44 69 72 65 63 74 47 74 5b 5d 20   or iDirectGt[] 
6470: 65 6c 65 6d 65 6e 74 73 20 66 6f 72 20 74 68 61  elements for tha
6480: 74 20 74 61 62 6c 65 0a 20 20 2a 2a 20 74 6f 20  t table.  ** to 
6490: 74 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68 65  the index of the
64a0: 20 74 65 72 6d 20 63 6f 6e 74 61 69 6e 69 6e 67   term containing
64b0: 20 74 68 65 20 52 4f 57 49 44 2e 20 20 57 65 20   the ROWID.  We 
64c0: 61 6c 77 61 79 73 20 70 72 65 66 65 72 0a 20 20  always prefer.  
64d0: 2a 2a 20 74 6f 20 75 73 65 20 61 20 52 4f 57 49  ** to use a ROWI
64e0: 44 20 77 68 69 63 68 20 63 61 6e 20 64 69 72 65  D which can dire
64f0: 63 74 6c 79 20 61 63 63 65 73 73 20 61 20 74 61  ctly access a ta
6500: 62 6c 65 20 72 61 74 68 65 72 20 74 68 61 6e 20  ble rather than 
6510: 61 6e 0a 20 20 2a 2a 20 69 6e 64 65 78 20 77 68  an.  ** index wh
6520: 69 63 68 20 72 65 71 75 69 72 65 73 20 72 65 61  ich requires rea
6530: 64 69 6e 67 20 61 6e 20 69 6e 64 65 78 20 66 69  ding an index fi
6540: 72 73 74 20 74 6f 20 67 65 74 20 74 68 65 20 72  rst to get the r
6550: 6f 77 69 64 20 74 68 65 6e 0a 20 20 2a 2a 20 64  owid then.  ** d
6560: 6f 69 6e 67 20 61 20 73 65 63 6f 6e 64 20 72 65  oing a second re
6570: 61 64 20 6f 66 20 74 68 65 20 61 63 74 75 61 6c  ad of the actual
6580: 20 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 2e   database table.
6590: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 63 74 75 61  .  **.  ** Actua
65a0: 6c 6c 79 2c 20 69 66 20 74 68 65 72 65 20 61 72  lly, if there ar
65b0: 65 20 6d 6f 72 65 20 74 68 61 6e 20 33 32 20 74  e more than 32 t
65c0: 61 62 6c 65 73 20 69 6e 20 74 68 65 20 6a 6f 69  ables in the joi
65d0: 6e 2c 20 6f 6e 6c 79 20 74 68 65 0a 20 20 2a 2a  n, only the.  **
65e0: 20 66 69 72 73 74 20 33 32 20 74 61 62 6c 65 73   first 32 tables
65f0: 20 61 72 65 20 63 61 6e 64 69 64 61 74 65 73 20   are candidates 
6600: 66 6f 72 20 69 6e 64 69 63 65 73 2e 20 20 54 68  for indices.  Th
6610: 69 73 20 69 73 20 28 61 67 61 69 6e 29 20 64 75  is is (again) du
6620: 65 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 6c 69  e.  ** to the li
6630: 6d 69 74 20 6f 66 20 33 32 20 62 69 74 73 20 69  mit of 32 bits i
6640: 6e 20 61 6e 20 69 6e 74 65 67 65 72 20 62 69 74  n an integer bit
6650: 6d 61 73 6b 2e 0a 20 20 2a 2f 0a 20 20 6c 6f 6f  mask..  */.  loo
6660: 70 4d 61 73 6b 20 3d 20 30 3b 0a 20 20 70 54 61  pMask = 0;.  pTa
6670: 62 49 74 65 6d 20 3d 20 70 54 61 62 4c 69 73 74  bItem = pTabList
6680: 2d 3e 61 3b 0a 20 20 70 4c 65 76 65 6c 20 3d 20  ->a;.  pLevel = 
6690: 70 57 49 6e 66 6f 2d 3e 61 3b 0a 20 20 66 6f 72  pWInfo->a;.  for
66a0: 28 69 3d 30 3b 20 69 3c 70 54 61 62 4c 69 73 74  (i=0; i<pTabList
66b0: 2d 3e 6e 53 72 63 20 26 26 20 69 3c 41 52 52 41  ->nSrc && i<ARRA
66c0: 59 53 49 5a 45 28 69 44 69 72 65 63 74 45 71 29  YSIZE(iDirectEq)
66d0: 3b 20 69 2b 2b 2c 70 54 61 62 49 74 65 6d 2b 2b  ; i++,pTabItem++
66e0: 2c 70 4c 65 76 65 6c 2b 2b 29 7b 0a 20 20 20 20  ,pLevel++){.    
66f0: 69 6e 74 20 6a 3b 0a 20 20 20 20 69 6e 74 20 69  int j;.    int i
6700: 43 75 72 20 3d 20 70 54 61 62 49 74 65 6d 2d 3e  Cur = pTabItem->
6710: 69 43 75 72 73 6f 72 3b 20 20 20 20 20 20 20 20  iCursor;        
6720: 20 20 20 20 2f 2a 20 54 68 65 20 63 75 72 73 6f      /* The curso
6730: 72 20 66 6f 72 20 74 68 69 73 20 74 61 62 6c 65  r for this table
6740: 20 2a 2f 0a 20 20 20 20 42 69 74 6d 61 73 6b 20   */.    Bitmask 
6750: 6d 61 73 6b 20 3d 20 67 65 74 4d 61 73 6b 28 26  mask = getMask(&
6760: 6d 61 73 6b 53 65 74 2c 20 69 43 75 72 29 3b 20  maskSet, iCur); 
6770: 20 2f 2a 20 43 75 72 73 6f 72 20 6d 61 73 6b 20   /* Cursor mask 
6780: 66 6f 72 20 74 68 69 73 20 74 61 62 6c 65 20 2a  for this table *
6790: 2f 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61  /.    Table *pTa
67a0: 62 20 3d 20 70 54 61 62 49 74 65 6d 2d 3e 70 54  b = pTabItem->pT
67b0: 61 62 3b 0a 20 20 20 20 49 6e 64 65 78 20 2a 70  ab;.    Index *p
67c0: 49 64 78 3b 0a 20 20 20 20 49 6e 64 65 78 20 2a  Idx;.    Index *
67d0: 70 42 65 73 74 49 64 78 20 3d 20 30 3b 0a 20 20  pBestIdx = 0;.  
67e0: 20 20 69 6e 74 20 62 65 73 74 53 63 6f 72 65 20    int bestScore 
67f0: 3d 20 30 3b 0a 20 20 20 20 69 6e 74 20 62 65 73  = 0;.    int bes
6800: 74 52 65 76 20 3d 20 30 3b 0a 0a 20 20 20 20 2f  tRev = 0;..    /
6810: 2a 20 43 68 65 63 6b 20 74 6f 20 73 65 65 20 69  * Check to see i
6820: 66 20 74 68 65 72 65 20 69 73 20 61 6e 20 65 78  f there is an ex
6830: 70 72 65 73 73 69 6f 6e 20 74 68 61 74 20 75 73  pression that us
6840: 65 73 20 6f 6e 6c 79 20 74 68 65 0a 20 20 20 20  es only the.    
6850: 2a 2a 20 52 4f 57 49 44 20 66 69 65 6c 64 20 6f  ** ROWID field o
6860: 66 20 74 68 69 73 20 74 61 62 6c 65 2e 20 20 46  f this table.  F
6870: 6f 72 20 74 65 72 6d 73 20 6f 66 20 74 68 65 20  or terms of the 
6880: 66 6f 72 6d 20 52 4f 57 49 44 3d 3d 65 78 70 72  form ROWID==expr
6890: 0a 20 20 20 20 2a 2a 20 73 65 74 20 69 44 69 72  .    ** set iDir
68a0: 65 63 74 45 71 5b 69 5d 20 74 6f 20 74 68 65 20  ectEq[i] to the 
68b0: 69 6e 64 65 78 20 6f 66 20 74 68 65 20 74 65 72  index of the ter
68c0: 6d 2e 20 20 46 6f 72 20 74 65 72 6d 73 20 6f 66  m.  For terms of
68d0: 20 74 68 65 0a 20 20 20 20 2a 2a 20 66 6f 72 6d   the.    ** form
68e0: 20 52 4f 57 49 44 3c 65 78 70 72 20 6f 72 20 52   ROWID<expr or R
68f0: 4f 57 49 44 3c 3d 65 78 70 72 20 73 65 74 20 69  OWID<=expr set i
6900: 44 69 72 65 63 74 4c 74 5b 69 5d 20 74 6f 20 74  DirectLt[i] to t
6910: 68 65 20 74 65 72 6d 20 69 6e 64 65 78 2e 0a 20  he term index.. 
6920: 20 20 20 2a 2a 20 46 6f 72 20 74 65 72 6d 73 20     ** For terms 
6930: 6c 69 6b 65 20 52 4f 57 49 44 3e 65 78 70 72 20  like ROWID>expr 
6940: 6f 72 20 52 4f 57 49 44 3e 3d 65 78 70 72 20 73  or ROWID>=expr s
6950: 65 74 20 69 44 69 72 65 63 74 47 74 5b 69 5d 2e  et iDirectGt[i].
6960: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 28  .    **.    ** (
6970: 41 64 64 65 64 3a 29 20 54 72 65 61 74 20 52 4f  Added:) Treat RO
6980: 57 49 44 20 49 4e 20 65 78 70 72 20 6c 69 6b 65  WID IN expr like
6990: 20 52 4f 57 49 44 3d 65 78 70 72 2e 0a 20 20 20   ROWID=expr..   
69a0: 20 2a 2f 0a 20 20 20 20 70 4c 65 76 65 6c 2d 3e   */.    pLevel->
69b0: 69 49 64 78 43 75 72 20 3d 20 2d 31 3b 0a 20 20  iIdxCur = -1;.  
69c0: 20 20 69 44 69 72 65 63 74 45 71 5b 69 5d 20 3d    iDirectEq[i] =
69d0: 20 2d 31 3b 0a 20 20 20 20 69 44 69 72 65 63 74   -1;.    iDirect
69e0: 4c 74 5b 69 5d 20 3d 20 2d 31 3b 0a 20 20 20 20  Lt[i] = -1;.    
69f0: 69 44 69 72 65 63 74 47 74 5b 69 5d 20 3d 20 2d  iDirectGt[i] = -
6a00: 31 3b 0a 20 20 20 20 66 6f 72 28 70 54 65 72 6d  1;.    for(pTerm
6a10: 3d 61 45 78 70 72 2c 20 6a 3d 30 3b 20 6a 3c 6e  =aExpr, j=0; j<n
6a20: 45 78 70 72 3b 20 6a 2b 2b 2c 20 70 54 65 72 6d  Expr; j++, pTerm
6a30: 2b 2b 29 7b 0a 20 20 20 20 20 20 45 78 70 72 20  ++){.      Expr 
6a40: 2a 70 58 20 3d 20 70 54 65 72 6d 2d 3e 70 3b 0a  *pX = pTerm->p;.
6a50: 20 20 20 20 20 20 69 66 28 20 70 54 65 72 6d 2d        if( pTerm-
6a60: 3e 69 64 78 4c 65 66 74 3d 3d 69 43 75 72 20 26  >idxLeft==iCur &
6a70: 26 20 70 58 2d 3e 70 4c 65 66 74 2d 3e 69 43 6f  & pX->pLeft->iCo
6a80: 6c 75 6d 6e 3c 30 0a 20 20 20 20 20 20 20 20 20  lumn<0.         
6a90: 20 20 20 26 26 20 28 70 54 65 72 6d 2d 3e 70 72     && (pTerm->pr
6aa0: 65 72 65 71 52 69 67 68 74 20 26 20 6c 6f 6f 70  ereqRight & loop
6ab0: 4d 61 73 6b 29 3d 3d 70 54 65 72 6d 2d 3e 70 72  Mask)==pTerm->pr
6ac0: 65 72 65 71 52 69 67 68 74 20 29 7b 0a 20 20 20  ereqRight ){.   
6ad0: 20 20 20 20 20 73 77 69 74 63 68 28 20 70 58 2d       switch( pX-
6ae0: 3e 6f 70 20 29 7b 0a 20 20 20 20 20 20 20 20 20  >op ){.         
6af0: 20 63 61 73 65 20 54 4b 5f 49 4e 3a 0a 20 20 20   case TK_IN:.   
6b00: 20 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f 45         case TK_E
6b10: 51 3a 20 69 44 69 72 65 63 74 45 71 5b 69 5d 20  Q: iDirectEq[i] 
6b20: 3d 20 6a 3b 20 62 72 65 61 6b 3b 0a 20 20 20 20  = j; break;.    
6b30: 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f 4c 45        case TK_LE
6b40: 3a 0a 20 20 20 20 20 20 20 20 20 20 63 61 73 65  :.          case
6b50: 20 54 4b 5f 4c 54 3a 20 69 44 69 72 65 63 74 4c   TK_LT: iDirectL
6b60: 74 5b 69 5d 20 3d 20 6a 3b 20 62 72 65 61 6b 3b  t[i] = j; break;
6b70: 0a 20 20 20 20 20 20 20 20 20 20 63 61 73 65 20  .          case 
6b80: 54 4b 5f 47 45 3a 0a 20 20 20 20 20 20 20 20 20  TK_GE:.         
6b90: 20 63 61 73 65 20 54 4b 5f 47 54 3a 20 69 44 69   case TK_GT: iDi
6ba0: 72 65 63 74 47 74 5b 69 5d 20 3d 20 6a 3b 20 20  rectGt[i] = j;  
6bb0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d  break;.        }
6bc0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a  .      }.    }..
6bd0: 20 20 20 20 2f 2a 20 49 66 20 77 65 20 66 6f 75      /* If we fou
6be0: 6e 64 20 61 20 74 65 72 6d 20 74 68 61 74 20 74  nd a term that t
6bf0: 65 73 74 73 20 52 4f 57 49 44 20 77 69 74 68 20  ests ROWID with 
6c00: 3d 3d 20 6f 72 20 49 4e 2c 20 74 68 61 74 20 74  == or IN, that t
6c10: 65 72 6d 0a 20 20 20 20 2a 2a 20 77 69 6c 6c 20  erm.    ** will 
6c20: 62 65 20 75 73 65 64 20 74 6f 20 6c 6f 63 61 74  be used to locat
6c30: 65 20 74 68 65 20 72 6f 77 73 20 69 6e 20 74 68  e the rows in th
6c40: 65 20 64 61 74 61 62 61 73 65 20 74 61 62 6c 65  e database table
6c50: 2e 20 20 54 68 65 72 65 0a 20 20 20 20 2a 2a 20  .  There.    ** 
6c60: 69 73 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 63  is not need to c
6c70: 6f 6e 74 69 6e 75 65 20 69 6e 74 6f 20 74 68 65  ontinue into the
6c80: 20 63 6f 64 65 20 62 65 6c 6f 77 20 74 68 61 74   code below that
6c90: 20 6c 6f 6f 6b 73 20 66 6f 72 0a 20 20 20 20 2a   looks for.    *
6ca0: 2a 20 61 6e 20 69 6e 64 65 78 2e 20 20 57 65 20  * an index.  We 
6cb0: 77 69 6c 6c 20 61 6c 77 61 79 73 20 75 73 65 20  will always use 
6cc0: 74 68 65 20 52 4f 57 49 44 20 6f 76 65 72 20 61  the ROWID over a
6cd0: 6e 20 69 6e 64 65 78 2e 0a 20 20 20 20 2a 2f 0a  n index..    */.
6ce0: 20 20 20 20 69 66 28 20 69 44 69 72 65 63 74 45      if( iDirectE
6cf0: 71 5b 69 5d 3e 3d 30 20 29 7b 0a 20 20 20 20 20  q[i]>=0 ){.     
6d00: 20 6c 6f 6f 70 4d 61 73 6b 20 7c 3d 20 6d 61 73   loopMask |= mas
6d10: 6b 3b 0a 20 20 20 20 20 20 70 4c 65 76 65 6c 2d  k;.      pLevel-
6d20: 3e 70 49 64 78 20 3d 20 30 3b 0a 20 20 20 20 20  >pIdx = 0;.     
6d30: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 7d   continue;.    }
6d40: 0a 0a 20 20 20 20 2f 2a 20 44 6f 20 61 20 73 65  ..    /* Do a se
6d50: 61 72 63 68 20 66 6f 72 20 75 73 61 62 6c 65 20  arch for usable 
6d60: 69 6e 64 69 63 65 73 2e 20 20 4c 65 61 76 65 20  indices.  Leave 
6d70: 70 42 65 73 74 49 64 78 20 70 6f 69 6e 74 69 6e  pBestIdx pointin
6d80: 67 20 74 6f 0a 20 20 20 20 2a 2a 20 74 68 65 20  g to.    ** the 
6d90: 22 62 65 73 74 22 20 69 6e 64 65 78 2e 20 20 70  "best" index.  p
6da0: 42 65 73 74 49 64 78 20 69 73 20 6c 65 66 74 20  BestIdx is left 
6db0: 73 65 74 20 74 6f 20 4e 55 4c 4c 20 69 66 20 6e  set to NULL if n
6dc0: 6f 20 69 6e 64 69 63 65 73 0a 20 20 20 20 2a 2a  o indices.    **
6dd0: 20 61 72 65 20 75 73 61 62 6c 65 2e 0a 20 20 20   are usable..   
6de0: 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 62   **.    ** The b
6df0: 65 73 74 20 69 6e 64 65 78 20 69 73 20 74 68 65  est index is the
6e00: 20 6f 6e 65 20 77 69 74 68 20 74 68 65 20 68 69   one with the hi
6e10: 67 68 65 73 74 20 73 63 6f 72 65 2e 20 20 54 68  ghest score.  Th
6e20: 65 20 73 63 6f 72 65 0a 20 20 20 20 2a 2a 20 66  e score.    ** f
6e30: 6f 72 20 74 68 65 20 69 6e 64 65 78 20 69 73 20  or the index is 
6e40: 64 65 74 65 72 6d 69 6e 65 64 20 61 73 20 66 6f  determined as fo
6e50: 6c 6c 6f 77 73 2e 20 20 46 6f 72 20 65 61 63 68  llows.  For each
6e60: 20 6f 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 6c   of the.    ** l
6e70: 65 66 74 2d 6d 6f 73 74 20 74 65 72 6d 73 20 74  eft-most terms t
6e80: 68 61 74 20 69 73 20 66 69 78 65 64 20 62 79 20  hat is fixed by 
6e90: 61 6e 20 65 71 75 61 6c 69 74 79 20 6f 70 65 72  an equality oper
6ea0: 61 74 6f 72 2c 20 61 64 64 0a 20 20 20 20 2a 2a  ator, add.    **
6eb0: 20 33 32 20 74 6f 20 74 68 65 20 73 63 6f 72 65   32 to the score
6ec0: 2e 20 20 54 68 65 20 72 69 67 68 74 2d 6d 6f 73  .  The right-mos
6ed0: 74 20 74 65 72 6d 20 6f 66 20 74 68 65 20 69 6e  t term of the in
6ee0: 64 65 78 20 6d 61 79 20 62 65 0a 20 20 20 20 2a  dex may be.    *
6ef0: 2a 20 63 6f 6e 73 74 72 61 69 6e 65 64 20 62 79  * constrained by
6f00: 20 61 6e 20 69 6e 65 71 75 61 6c 69 74 79 2e 20   an inequality. 
6f10: 20 41 64 64 20 34 20 69 66 20 66 6f 72 20 61 6e   Add 4 if for an
6f20: 20 22 78 3c 2e 2e 2e 22 20 63 6f 6e 73 74 72 61   "x<..." constra
6f30: 69 6e 74 0a 20 20 20 20 2a 2a 20 61 6e 64 20 61  int.    ** and a
6f40: 64 64 20 38 20 66 6f 72 20 61 6e 20 22 78 3e 2e  dd 8 for an "x>.
6f50: 2e 2e 22 20 63 6f 6e 73 74 72 61 69 6e 74 2e 20  .." constraint. 
6f60: 20 49 66 20 62 6f 74 68 20 63 6f 6e 73 74 72 61   If both constra
6f70: 69 6e 74 73 0a 20 20 20 20 2a 2a 20 61 72 65 20  ints.    ** are 
6f80: 70 72 65 73 65 6e 74 2c 20 61 64 64 20 31 32 2e  present, add 12.
6f90: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49  .    **.    ** I
6fa0: 66 20 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20  f the left-most 
6fb0: 74 65 72 6d 20 6f 66 20 74 68 65 20 69 6e 64 65  term of the inde
6fc0: 78 20 75 73 65 73 20 61 6e 20 49 4e 20 6f 70 65  x uses an IN ope
6fd0: 72 61 74 6f 72 0a 20 20 20 20 2a 2a 20 28 65 78  rator.    ** (ex
6fe0: 3a 20 20 22 78 20 49 4e 20 28 2e 2e 2e 29 22 29  :  "x IN (...)")
6ff0: 20 20 74 68 65 6e 20 61 64 64 20 31 36 20 74 6f    then add 16 to
7000: 20 74 68 65 20 73 63 6f 72 65 2e 0a 20 20 20 20   the score..    
7010: 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 61 6e 20  **.    ** If an 
7020: 69 6e 64 65 78 20 63 61 6e 20 62 65 20 75 73 65  index can be use
7030: 64 20 66 6f 72 20 73 6f 72 74 69 6e 67 2c 20 61  d for sorting, a
7040: 64 64 20 32 20 74 6f 20 74 68 65 20 73 63 6f 72  dd 2 to the scor
7050: 65 2e 0a 20 20 20 20 2a 2a 20 49 66 20 61 6e 20  e..    ** If an 
7060: 69 6e 64 65 78 20 63 6f 6e 74 61 69 6e 73 20 61  index contains a
7070: 6c 6c 20 74 68 65 20 74 65 72 6d 73 20 6f 66 20  ll the terms of 
7080: 61 20 74 61 62 6c 65 20 74 68 61 74 20 61 72 65  a table that are
7090: 20 65 76 65 72 0a 20 20 20 20 2a 2a 20 75 73 65   ever.    ** use
70a0: 64 20 62 79 20 61 6e 79 20 65 78 70 72 65 73 73  d by any express
70b0: 69 6f 6e 20 69 6e 20 74 68 65 20 53 51 4c 20 73  ion in the SQL s
70c0: 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 6e 20 61  tatement, then a
70d0: 64 64 20 31 20 74 6f 0a 20 20 20 20 2a 2a 20 74  dd 1 to.    ** t
70e0: 68 65 20 73 63 6f 72 65 2e 0a 20 20 20 20 2a 2a  he score..    **
70f0: 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 73 63 6f  .    ** This sco
7100: 72 69 6e 67 20 73 79 73 74 65 6d 20 69 73 20 64  ring system is d
7110: 65 73 69 67 6e 65 64 20 73 6f 20 74 68 61 74 20  esigned so that 
7120: 74 68 65 20 73 63 6f 72 65 20 63 61 6e 20 6c 61  the score can la
7130: 74 65 72 20 62 65 0a 20 20 20 20 2a 2a 20 75 73  ter be.    ** us
7140: 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20  ed to determine 
7150: 68 6f 77 20 74 68 65 20 69 6e 64 65 78 20 69 73  how the index is
7160: 20 75 73 65 64 2e 20 20 49 66 20 74 68 65 20 73   used.  If the s
7170: 63 6f 72 65 26 30 78 31 63 20 69 73 20 30 0a 20  core&0x1c is 0. 
7180: 20 20 20 2a 2a 20 74 68 65 6e 20 61 6c 6c 20 63     ** then all c
7190: 6f 6e 73 74 72 61 69 6e 74 73 20 61 72 65 20 65  onstraints are e
71a0: 71 75 61 6c 69 74 69 65 73 2e 20 20 49 66 20 73  qualities.  If s
71b0: 63 6f 72 65 26 30 78 34 20 69 73 20 6e 6f 74 20  core&0x4 is not 
71c0: 30 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 74 68  0 then.    ** th
71d0: 65 72 65 20 69 73 20 61 6e 20 69 6e 65 71 75 61  ere is an inequa
71e0: 6c 69 74 79 20 75 73 65 64 20 61 73 20 61 20 74  lity used as a t
71f0: 65 72 6d 69 6e 61 74 69 6f 6e 20 6b 65 79 2e 20  ermination key. 
7200: 20 28 65 78 3a 20 22 78 3c 2e 2e 2e 22 29 0a 20   (ex: "x<..."). 
7210: 20 20 20 2a 2a 20 49 66 20 73 63 6f 72 65 26 30     ** If score&0
7220: 78 38 20 69 73 20 6e 6f 74 20 30 20 74 68 65 6e  x8 is not 0 then
7230: 20 74 68 65 72 65 20 69 73 20 61 6e 20 69 6e 65   there is an ine
7240: 71 75 61 6c 69 74 79 20 75 73 65 64 20 61 73 20  quality used as 
7250: 74 68 65 0a 20 20 20 20 2a 2a 20 73 74 61 72 74  the.    ** start
7260: 20 6b 65 79 2e 20 20 28 65 78 3a 20 22 78 3e 2e   key.  (ex: "x>.
7270: 2e 2e 22 29 2e 20 20 41 20 73 63 6f 72 65 20 6f  ..").  A score o
7280: 72 20 30 78 31 30 20 69 73 20 74 68 65 20 73 70  r 0x10 is the sp
7290: 65 63 69 61 6c 20 63 61 73 65 0a 20 20 20 20 2a  ecial case.    *
72a0: 2a 20 6f 66 20 61 6e 20 49 4e 20 6f 70 65 72 61  * of an IN opera
72b0: 74 6f 72 20 63 6f 6e 73 74 72 61 69 6e 74 2e 20  tor constraint. 
72c0: 20 28 65 78 3a 20 20 22 78 20 49 4e 20 2e 2e 2e   (ex:  "x IN ...
72d0: 22 29 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a  ")..    **.    *
72e0: 2a 20 54 68 65 20 49 4e 20 6f 70 65 72 61 74 6f  * The IN operato
72f0: 72 20 28 61 73 20 69 6e 20 22 3c 65 78 70 72 3e  r (as in "<expr>
7300: 20 49 4e 20 28 2e 2e 2e 29 22 29 20 69 73 20 74   IN (...)") is t
7310: 72 65 61 74 65 64 20 74 68 65 20 73 61 6d 65 20  reated the same 
7320: 61 73 0a 20 20 20 20 2a 2a 20 61 6e 20 65 71 75  as.    ** an equ
7330: 61 6c 69 74 79 20 63 6f 6d 70 61 72 69 73 6f 6e  ality comparison
7340: 20 65 78 63 65 70 74 20 74 68 61 74 20 69 74 20   except that it 
7350: 63 61 6e 20 6f 6e 6c 79 20 62 65 20 75 73 65 64  can only be used
7360: 20 6f 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 6c   on the.    ** l
7370: 65 66 74 2d 6d 6f 73 74 20 63 6f 6c 75 6d 6e 20  eft-most column 
7380: 6f 66 20 61 6e 20 69 6e 64 65 78 20 61 6e 64 20  of an index and 
7390: 6f 74 68 65 72 20 74 65 72 6d 73 20 6f 66 20 74  other terms of t
73a0: 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 0a  he WHERE clause.
73b0: 20 20 20 20 2a 2a 20 63 61 6e 6e 6f 74 20 62 65      ** cannot be
73c0: 20 75 73 65 64 20 69 6e 20 63 6f 6e 6a 75 6e 63   used in conjunc
73d0: 74 69 6f 6e 20 77 69 74 68 20 74 68 65 20 49 4e  tion with the IN
73e0: 20 6f 70 65 72 61 74 6f 72 20 74 6f 20 68 65 6c   operator to hel
73f0: 70 20 73 61 74 69 73 66 79 0a 20 20 20 20 2a 2a  p satisfy.    **
7400: 20 6f 74 68 65 72 20 63 6f 6c 75 6d 6e 73 20 6f   other columns o
7410: 66 20 74 68 65 20 69 6e 64 65 78 2e 0a 20 20 20  f the index..   
7420: 20 2a 2f 0a 20 20 20 20 66 6f 72 28 70 49 64 78   */.    for(pIdx
7430: 3d 70 54 61 62 2d 3e 70 49 6e 64 65 78 3b 20 70  =pTab->pIndex; p
7440: 49 64 78 3b 20 70 49 64 78 3d 70 49 64 78 2d 3e  Idx; pIdx=pIdx->
7450: 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 42 69  pNext){.      Bi
7460: 74 6d 61 73 6b 20 65 71 4d 61 73 6b 20 3d 20 30  tmask eqMask = 0
7470: 3b 20 20 2f 2a 20 49 6e 64 65 78 20 63 6f 6c 75  ;  /* Index colu
7480: 6d 6e 73 20 63 6f 76 65 72 65 64 20 62 79 20 61  mns covered by a
7490: 6e 20 78 3d 2e 2e 2e 20 74 65 72 6d 20 2a 2f 0a  n x=... term */.
74a0: 20 20 20 20 20 20 42 69 74 6d 61 73 6b 20 6c 74        Bitmask lt
74b0: 4d 61 73 6b 20 3d 20 30 3b 20 20 2f 2a 20 49 6e  Mask = 0;  /* In
74c0: 64 65 78 20 63 6f 6c 75 6d 6e 73 20 63 6f 76 65  dex columns cove
74d0: 72 65 64 20 62 79 20 61 6e 20 78 3c 2e 2e 2e 20  red by an x<... 
74e0: 74 65 72 6d 20 2a 2f 0a 20 20 20 20 20 20 42 69  term */.      Bi
74f0: 74 6d 61 73 6b 20 67 74 4d 61 73 6b 20 3d 20 30  tmask gtMask = 0
7500: 3b 20 20 2f 2a 20 49 6e 64 65 78 20 63 6f 6c 75  ;  /* Index colu
7510: 6d 6e 73 20 63 6f 76 65 72 65 64 20 62 79 20 61  mns covered by a
7520: 6e 20 78 3e 2e 2e 2e 20 74 65 72 6d 20 2a 2f 0a  n x>... term */.
7530: 20 20 20 20 20 20 42 69 74 6d 61 73 6b 20 69 6e        Bitmask in
7540: 4d 61 73 6b 20 3d 20 30 3b 20 20 2f 2a 20 49 6e  Mask = 0;  /* In
7550: 64 65 78 20 63 6f 6c 75 6d 6e 73 20 63 6f 76 65  dex columns cove
7560: 72 65 64 20 62 79 20 61 6e 20 78 20 49 4e 20 2e  red by an x IN .
7570: 2e 20 74 65 72 6d 20 2a 2f 0a 20 20 20 20 20 20  . term */.      
7580: 42 69 74 6d 61 73 6b 20 6d 3b 0a 20 20 20 20 20  Bitmask m;.     
7590: 20 69 6e 74 20 6e 45 71 2c 20 73 63 6f 72 65 2c   int nEq, score,
75a0: 20 62 52 65 76 20 3d 20 30 3b 0a 0a 20 20 20 20   bRev = 0;..    
75b0: 20 20 69 66 28 20 70 49 64 78 2d 3e 6e 43 6f 6c    if( pIdx->nCol
75c0: 75 6d 6e 3e 73 69 7a 65 6f 66 28 65 71 4d 61 73  umn>sizeof(eqMas
75d0: 6b 29 2a 38 20 29 7b 0a 20 20 20 20 20 20 20 20  k)*8 ){.        
75e0: 63 6f 6e 74 69 6e 75 65 3b 20 20 2f 2a 20 49 67  continue;  /* Ig
75f0: 6e 6f 72 65 20 69 6e 64 69 63 65 73 20 77 69 74  nore indices wit
7600: 68 20 74 6f 6f 20 6d 61 6e 79 20 63 6f 6c 75 6d  h too many colum
7610: 6e 73 20 74 6f 20 61 6e 61 6c 79 7a 65 20 2a 2f  ns to analyze */
7620: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66  .      }.      f
7630: 6f 72 28 70 54 65 72 6d 3d 61 45 78 70 72 2c 20  or(pTerm=aExpr, 
7640: 6a 3d 30 3b 20 6a 3c 6e 45 78 70 72 3b 20 6a 2b  j=0; j<nExpr; j+
7650: 2b 2c 20 70 54 65 72 6d 2b 2b 29 7b 0a 20 20 20  +, pTerm++){.   
7660: 20 20 20 20 20 45 78 70 72 20 2a 70 58 20 3d 20       Expr *pX = 
7670: 70 54 65 72 6d 2d 3e 70 3b 0a 20 20 20 20 20 20  pTerm->p;.      
7680: 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c    CollSeq *pColl
7690: 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f   = sqlite3ExprCo
76a0: 6c 6c 53 65 71 28 70 50 61 72 73 65 2c 20 70 58  llSeq(pParse, pX
76b0: 2d 3e 70 4c 65 66 74 29 3b 0a 20 20 20 20 20 20  ->pLeft);.      
76c0: 20 20 69 66 28 20 21 70 43 6f 6c 6c 20 26 26 20    if( !pColl && 
76d0: 70 58 2d 3e 70 52 69 67 68 74 20 29 7b 0a 20 20  pX->pRight ){.  
76e0: 20 20 20 20 20 20 20 20 70 43 6f 6c 6c 20 3d 20          pColl = 
76f0: 73 71 6c 69 74 65 33 45 78 70 72 43 6f 6c 6c 53  sqlite3ExprCollS
7700: 65 71 28 70 50 61 72 73 65 2c 20 70 58 2d 3e 70  eq(pParse, pX->p
7710: 52 69 67 68 74 29 3b 0a 20 20 20 20 20 20 20 20  Right);.        
7720: 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 70  }.        if( !p
7730: 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 20 20 20 20  Coll ){.        
7740: 20 20 70 43 6f 6c 6c 20 3d 20 70 50 61 72 73 65    pColl = pParse
7750: 2d 3e 64 62 2d 3e 70 44 66 6c 74 43 6f 6c 6c 3b  ->db->pDfltColl;
7760: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
7770: 20 20 20 69 66 28 20 70 54 65 72 6d 2d 3e 69 64     if( pTerm->id
7780: 78 4c 65 66 74 3d 3d 69 43 75 72 20 0a 20 20 20  xLeft==iCur .   
7790: 20 20 20 20 20 20 20 20 20 20 26 26 20 28 70 54            && (pT
77a0: 65 72 6d 2d 3e 70 72 65 72 65 71 52 69 67 68 74  erm->prereqRight
77b0: 20 26 20 6c 6f 6f 70 4d 61 73 6b 29 3d 3d 70 54   & loopMask)==pT
77c0: 65 72 6d 2d 3e 70 72 65 72 65 71 52 69 67 68 74  erm->prereqRight
77d0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e   ){.          in
77e0: 74 20 69 43 6f 6c 75 6d 6e 20 3d 20 70 58 2d 3e  t iColumn = pX->
77f0: 70 4c 65 66 74 2d 3e 69 43 6f 6c 75 6d 6e 3b 0a  pLeft->iColumn;.
7800: 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 6b 3b            int k;
7810: 0a 20 20 20 20 20 20 20 20 20 20 63 68 61 72 20  .          char 
7820: 69 64 78 61 66 66 20 3d 20 69 43 6f 6c 75 6d 6e  idxaff = iColumn
7830: 3e 3d 30 20 3f 20 70 49 64 78 2d 3e 70 54 61 62  >=0 ? pIdx->pTab
7840: 6c 65 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 75 6d 6e  le->aCol[iColumn
7850: 5d 2e 61 66 66 69 6e 69 74 79 20 3a 20 30 3b 20  ].affinity : 0; 
7860: 0a 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 6b  .          for(k
7870: 3d 30 3b 20 6b 3c 70 49 64 78 2d 3e 6e 43 6f 6c  =0; k<pIdx->nCol
7880: 75 6d 6e 3b 20 6b 2b 2b 29 7b 0a 20 20 20 20 20  umn; k++){.     
7890: 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65         /* If the
78a0: 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65   collating seque
78b0: 6e 63 65 73 20 6f 72 20 61 66 66 69 6e 69 74 69  nces or affiniti
78c0: 65 73 20 64 6f 6e 27 74 20 6d 61 74 63 68 2c 20  es don't match, 
78d0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20  .            ** 
78e0: 69 67 6e 6f 72 65 20 74 68 69 73 20 69 6e 64 65  ignore this inde
78f0: 78 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20  x.  */.         
7900: 20 20 20 69 66 28 20 70 43 6f 6c 6c 21 3d 70 49     if( pColl!=pI
7910: 64 78 2d 3e 6b 65 79 49 6e 66 6f 2e 61 43 6f 6c  dx->keyInfo.aCol
7920: 6c 5b 6b 5d 20 29 20 63 6f 6e 74 69 6e 75 65 3b  l[k] ) continue;
7930: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28  .            if(
7940: 20 21 73 71 6c 69 74 65 33 49 6e 64 65 78 41 66   !sqlite3IndexAf
7950: 66 69 6e 69 74 79 4f 6b 28 70 58 2c 20 69 64 78  finityOk(pX, idx
7960: 61 66 66 29 20 29 20 63 6f 6e 74 69 6e 75 65 3b  aff) ) continue;
7970: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28  .            if(
7980: 20 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b   pIdx->aiColumn[
7990: 6b 5d 3d 3d 69 43 6f 6c 75 6d 6e 20 29 7b 0a 20  k]==iColumn ){. 
79a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 77 69               swi
79b0: 74 63 68 28 20 70 58 2d 3e 6f 70 20 29 7b 0a 20  tch( pX->op ){. 
79c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63                 c
79d0: 61 73 65 20 54 4b 5f 49 4e 3a 20 7b 0a 20 20 20  ase TK_IN: {.   
79e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69                 i
79f0: 66 28 20 6b 3d 3d 30 20 29 20 69 6e 4d 61 73 6b  f( k==0 ) inMask
7a00: 20 7c 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 20   |= 1;.         
7a10: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a           break;.
7a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7a30: 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  }.              
7a40: 20 20 63 61 73 65 20 54 4b 5f 45 51 3a 20 7b 0a    case TK_EQ: {.
7a50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7a60: 20 20 65 71 4d 61 73 6b 20 7c 3d 20 28 28 42 69    eqMask |= ((Bi
7a70: 74 6d 61 73 6b 29 31 29 3c 3c 6b 3b 0a 20 20 20  tmask)1)<<k;.   
7a80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62                 b
7a90: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20  reak;.          
7aa0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
7ab0: 20 20 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f          case TK_
7ac0: 4c 45 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20  LE:.            
7ad0: 20 20 20 20 63 61 73 65 20 54 4b 5f 4c 54 3a 20      case TK_LT: 
7ae0: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  {.              
7af0: 20 20 20 20 6c 74 4d 61 73 6b 20 7c 3d 20 28 28      ltMask |= ((
7b00: 42 69 74 6d 61 73 6b 29 31 29 3c 3c 6b 3b 0a 20  Bitmask)1)<<k;. 
7b10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7b20: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20   break;.        
7b30: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
7b40: 20 20 20 20 20 20 20 20 20 20 63 61 73 65 20 54            case T
7b50: 4b 5f 47 45 3a 0a 20 20 20 20 20 20 20 20 20 20  K_GE:.          
7b60: 20 20 20 20 20 20 63 61 73 65 20 54 4b 5f 47 54        case TK_GT
7b70: 3a 20 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20  : {.            
7b80: 20 20 20 20 20 20 67 74 4d 61 73 6b 20 7c 3d 20        gtMask |= 
7b90: 28 28 42 69 74 6d 61 73 6b 29 31 29 3c 3c 6b 3b  ((Bitmask)1)<<k;
7ba0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
7bb0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
7bc0: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20            }.    
7bd0: 20 20 20 20 20 20 20 20 20 20 20 20 64 65 66 61              defa
7be0: 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 20 20 20  ult: {.         
7bf0: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 41 4e 54           /* CANT
7c00: 5f 48 41 50 50 45 4e 20 2a 2f 0a 20 20 20 20 20  _HAPPEN */.     
7c10: 20 20 20 20 20 20 20 20 20 20 20 20 20 61 73 73               ass
7c20: 65 72 74 28 20 30 20 29 3b 0a 20 20 20 20 20 20  ert( 0 );.      
7c30: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61              brea
7c40: 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  k;.             
7c50: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20     }.           
7c60: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20     }.           
7c70: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
7c80: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
7c90: 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20    }.        }.  
7ca0: 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20      }..      /* 
7cb0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6c 6f  The following lo
7cc0: 6f 70 20 65 6e 64 73 20 77 69 74 68 20 6e 45 71  op ends with nEq
7cd0: 20 73 65 74 20 74 6f 20 74 68 65 20 6e 75 6d 62   set to the numb
7ce0: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 0a 20 20  er of columns.  
7cf0: 20 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 6c 65      ** on the le
7d00: 66 74 20 6f 66 20 74 68 65 20 69 6e 64 65 78 20  ft of the index 
7d10: 77 69 74 68 20 3d 3d 20 63 6f 6e 73 74 72 61 69  with == constrai
7d20: 6e 74 73 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  nts..      */.  
7d30: 20 20 20 20 66 6f 72 28 6e 45 71 3d 30 3b 20 6e      for(nEq=0; n
7d40: 45 71 3c 70 49 64 78 2d 3e 6e 43 6f 6c 75 6d 6e  Eq<pIdx->nColumn
7d50: 3b 20 6e 45 71 2b 2b 29 7b 0a 20 20 20 20 20 20  ; nEq++){.      
7d60: 20 20 6d 20 3d 20 28 28 28 42 69 74 6d 61 73 6b    m = (((Bitmask
7d70: 29 31 29 3c 3c 28 6e 45 71 2b 31 29 29 2d 31 3b  )1)<<(nEq+1))-1;
7d80: 0a 20 20 20 20 20 20 20 20 69 66 28 20 28 6d 20  .        if( (m 
7d90: 26 20 65 71 4d 61 73 6b 29 21 3d 6d 20 29 20 62  & eqMask)!=m ) b
7da0: 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 0a 20  reak;.      }.. 
7db0: 20 20 20 20 20 2f 2a 20 42 65 67 69 6e 20 61 73       /* Begin as
7dc0: 73 65 6d 62 6c 79 69 6e 67 20 74 68 65 20 73 63  semblying the sc
7dd0: 6f 72 65 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20  ore.      */.   
7de0: 20 20 20 73 63 6f 72 65 20 3d 20 6e 45 71 2a 33     score = nEq*3
7df0: 32 3b 20 20 20 2f 2a 20 42 61 73 65 20 73 63 6f  2;   /* Base sco
7e00: 72 65 20 69 73 20 33 32 20 74 69 6d 65 73 20 6e  re is 32 times n
7e10: 75 6d 62 65 72 20 6f 66 20 3d 3d 20 63 6f 6e 73  umber of == cons
7e20: 74 72 61 69 6e 74 73 20 2a 2f 0a 20 20 20 20 20  traints */.     
7e30: 20 6d 20 3d 20 28 28 42 69 74 6d 61 73 6b 29 31   m = ((Bitmask)1
7e40: 29 3c 3c 6e 45 71 3b 0a 20 20 20 20 20 20 69 66  )<<nEq;.      if
7e50: 28 20 6d 20 26 20 6c 74 4d 61 73 6b 20 29 20 73  ( m & ltMask ) s
7e60: 63 6f 72 65 2b 3d 34 3b 20 20 20 20 2f 2a 20 49  core+=4;    /* I
7e70: 6e 63 72 65 61 73 65 20 73 63 6f 72 65 20 66 6f  ncrease score fo
7e80: 72 20 61 20 3c 20 63 6f 6e 73 74 72 61 69 6e 74  r a < constraint
7e90: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 6d 20   */.      if( m 
7ea0: 26 20 67 74 4d 61 73 6b 20 29 20 73 63 6f 72 65  & gtMask ) score
7eb0: 2b 3d 38 3b 20 20 20 20 2f 2a 20 49 6e 63 72 65  +=8;    /* Incre
7ec0: 61 73 65 20 73 63 6f 72 65 20 66 6f 72 20 61 20  ase score for a 
7ed0: 3e 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a  > constraint */.
7ee0: 20 20 20 20 20 20 69 66 28 20 73 63 6f 72 65 3d        if( score=
7ef0: 3d 30 20 26 26 20 69 6e 4d 61 73 6b 20 29 20 73  =0 && inMask ) s
7f00: 63 6f 72 65 20 3d 20 31 36 3b 20 2f 2a 20 44 65  core = 16; /* De
7f10: 66 61 75 6c 74 20 73 63 6f 72 65 20 66 6f 72 20  fault score for 
7f20: 49 4e 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f  IN constraint */
7f30: 0a 0a 20 20 20 20 20 20 2f 2a 20 47 69 76 65 20  ..      /* Give 
7f40: 62 6f 6e 75 73 20 70 6f 69 6e 74 73 20 69 66 20  bonus points if 
7f50: 74 68 69 73 20 69 6e 64 65 78 20 63 61 6e 20 62  this index can b
7f60: 65 20 75 73 65 64 20 66 6f 72 20 73 6f 72 74 69  e used for sorti
7f70: 6e 67 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20  ng.      */.    
7f80: 20 20 69 66 28 20 69 3d 3d 30 20 26 26 20 73 63    if( i==0 && sc
7f90: 6f 72 65 21 3d 31 36 20 26 26 20 70 70 4f 72 64  ore!=16 && ppOrd
7fa0: 65 72 42 79 20 26 26 20 2a 70 70 4f 72 64 65 72  erBy && *ppOrder
7fb0: 42 79 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e  By ){.        in
7fc0: 74 20 62 61 73 65 20 3d 20 70 54 61 62 4c 69 73  t base = pTabLis
7fd0: 74 2d 3e 61 5b 30 5d 2e 69 43 75 72 73 6f 72 3b  t->a[0].iCursor;
7fe0: 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 73 53  .        if( isS
7ff0: 6f 72 74 69 6e 67 49 6e 64 65 78 28 70 50 61 72  ortingIndex(pPar
8000: 73 65 2c 20 70 49 64 78 2c 20 70 54 61 62 2c 20  se, pIdx, pTab, 
8010: 62 61 73 65 2c 20 2a 70 70 4f 72 64 65 72 42 79  base, *ppOrderBy
8020: 2c 20 6e 45 71 2c 20 26 62 52 65 76 29 20 29 7b  , nEq, &bRev) ){
8030: 0a 20 20 20 20 20 20 20 20 20 20 73 63 6f 72 65  .          score
8040: 20 2b 3d 20 32 3b 0a 20 20 20 20 20 20 20 20 7d   += 2;.        }
8050: 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20  .      }..      
8060: 2f 2a 20 43 68 65 63 6b 20 74 6f 20 73 65 65 20  /* Check to see 
8070: 69 66 20 77 65 20 63 61 6e 20 67 65 74 20 61 77  if we can get aw
8080: 61 79 20 77 69 74 68 20 75 73 69 6e 67 20 6a 75  ay with using ju
8090: 73 74 20 74 68 65 20 69 6e 64 65 78 20 77 69 74  st the index wit
80a0: 68 6f 75 74 0a 20 20 20 20 20 20 2a 2a 20 65 76  hout.      ** ev
80b0: 65 72 20 72 65 61 64 69 6e 67 20 74 68 65 20 74  er reading the t
80c0: 61 62 6c 65 2e 20 20 49 66 20 74 68 61 74 20 69  able.  If that i
80d0: 73 20 74 68 65 20 63 61 73 65 2c 20 74 68 65 6e  s the case, then
80e0: 20 61 64 64 20 6f 6e 65 20 62 6f 6e 75 73 0a 20   add one bonus. 
80f0: 20 20 20 20 20 2a 2a 20 70 6f 69 6e 74 20 74 6f       ** point to
8100: 20 74 68 65 20 73 63 6f 72 65 2e 0a 20 20 20 20   the score..    
8110: 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 73    */.      if( s
8120: 63 6f 72 65 20 26 26 20 70 54 61 62 49 74 65 6d  core && pTabItem
8130: 2d 3e 63 6f 6c 55 73 65 64 20 3c 20 28 28 28 42  ->colUsed < (((B
8140: 69 74 6d 61 73 6b 29 31 29 3c 3c 28 42 4d 53 2d  itmask)1)<<(BMS-
8150: 31 29 29 20 29 7b 0a 20 20 20 20 20 20 20 20 66  1)) ){.        f
8160: 6f 72 28 6d 3d 30 2c 20 6a 3d 30 3b 20 6a 3c 70  or(m=0, j=0; j<p
8170: 49 64 78 2d 3e 6e 43 6f 6c 75 6d 6e 3b 20 6a 2b  Idx->nColumn; j+
8180: 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e  +){.          in
8190: 74 20 78 20 3d 20 70 49 64 78 2d 3e 61 69 43 6f  t x = pIdx->aiCo
81a0: 6c 75 6d 6e 5b 6a 5d 3b 0a 20 20 20 20 20 20 20  lumn[j];.       
81b0: 20 20 20 69 66 28 20 78 3c 42 4d 53 2d 31 20 29     if( x<BMS-1 )
81c0: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 20  {.            m 
81d0: 7c 3d 20 28 28 42 69 74 6d 61 73 6b 29 31 29 3c  |= ((Bitmask)1)<
81e0: 3c 78 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a  <x;.          }.
81f0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
8200: 20 20 69 66 28 20 28 70 54 61 62 49 74 65 6d 2d    if( (pTabItem-
8210: 3e 63 6f 6c 55 73 65 64 20 26 20 6d 29 3d 3d 70  >colUsed & m)==p
8220: 54 61 62 49 74 65 6d 2d 3e 63 6f 6c 55 73 65 64  TabItem->colUsed
8230: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 63   ){.          sc
8240: 6f 72 65 2b 2b 3b 0a 20 20 20 20 20 20 20 20 7d  ore++;.        }
8250: 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20  .      }..      
8260: 2f 2a 20 49 66 20 74 68 65 20 73 63 6f 72 65 20  /* If the score 
8270: 66 6f 72 20 74 68 69 73 20 69 6e 64 65 78 20 69  for this index i
8280: 73 20 74 68 65 20 62 65 73 74 20 77 65 20 68 61  s the best we ha
8290: 76 65 20 73 65 65 6e 20 73 6f 20 66 61 72 2c 20  ve seen so far, 
82a0: 74 68 65 6e 0a 20 20 20 20 20 20 2a 2a 20 73 61  then.      ** sa
82b0: 76 65 20 69 74 0a 20 20 20 20 20 20 2a 2f 0a 20  ve it.      */. 
82c0: 20 20 20 20 20 69 66 28 20 73 63 6f 72 65 3e 62       if( score>b
82d0: 65 73 74 53 63 6f 72 65 20 29 7b 0a 20 20 20 20  estScore ){.    
82e0: 20 20 20 20 70 42 65 73 74 49 64 78 20 3d 20 70      pBestIdx = p
82f0: 49 64 78 3b 0a 20 20 20 20 20 20 20 20 62 65 73  Idx;.        bes
8300: 74 53 63 6f 72 65 20 3d 20 73 63 6f 72 65 3b 0a  tScore = score;.
8310: 20 20 20 20 20 20 20 20 62 65 73 74 52 65 76 20          bestRev 
8320: 3d 20 62 52 65 76 3b 0a 20 20 20 20 20 20 7d 0a  = bRev;.      }.
8330: 20 20 20 20 7d 0a 20 20 20 20 70 4c 65 76 65 6c      }.    pLevel
8340: 2d 3e 70 49 64 78 20 3d 20 70 42 65 73 74 49 64  ->pIdx = pBestId
8350: 78 3b 0a 20 20 20 20 70 4c 65 76 65 6c 2d 3e 73  x;.    pLevel->s
8360: 63 6f 72 65 20 3d 20 62 65 73 74 53 63 6f 72 65  core = bestScore
8370: 3b 0a 20 20 20 20 70 4c 65 76 65 6c 2d 3e 62 52  ;.    pLevel->bR
8380: 65 76 20 3d 20 62 65 73 74 52 65 76 3b 0a 20 20  ev = bestRev;.  
8390: 20 20 6c 6f 6f 70 4d 61 73 6b 20 7c 3d 20 6d 61    loopMask |= ma
83a0: 73 6b 3b 0a 20 20 20 20 69 66 28 20 70 42 65 73  sk;.    if( pBes
83b0: 74 49 64 78 20 29 7b 0a 20 20 20 20 20 20 70 4c  tIdx ){.      pL
83c0: 65 76 65 6c 2d 3e 69 49 64 78 43 75 72 20 3d 20  evel->iIdxCur = 
83d0: 70 50 61 72 73 65 2d 3e 6e 54 61 62 2b 2b 3b 0a  pParse->nTab++;.
83e0: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20      }.  }..  /* 
83f0: 43 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20  Check to see if 
8400: 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61  the ORDER BY cla
8410: 75 73 65 20 69 73 20 6f 72 20 63 61 6e 20 62 65  use is or can be
8420: 20 73 61 74 69 73 66 69 65 64 20 62 79 20 74 68   satisfied by th
8430: 65 0a 20 20 2a 2a 20 75 73 65 20 6f 66 20 61 6e  e.  ** use of an
8440: 20 69 6e 64 65 78 20 6f 6e 20 74 68 65 20 66 69   index on the fi
8450: 72 73 74 20 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a  rst table..  */.
8460: 20 20 69 66 28 20 70 70 4f 72 64 65 72 42 79 20    if( ppOrderBy 
8470: 26 26 20 2a 70 70 4f 72 64 65 72 42 79 20 26 26  && *ppOrderBy &&
8480: 20 70 54 61 62 4c 69 73 74 2d 3e 6e 53 72 63 3e   pTabList->nSrc>
8490: 30 20 29 7b 0a 20 20 20 20 49 6e 64 65 78 20 2a  0 ){.    Index *
84a0: 70 49 64 78 3b 20 20 20 20 20 20 20 20 20 20 20  pIdx;           
84b0: 20 20 2f 2a 20 49 6e 64 65 78 20 64 65 72 69 76    /* Index deriv
84c0: 65 64 20 66 72 6f 6d 20 74 68 65 20 57 48 45 52  ed from the WHER
84d0: 45 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20  E clause */.    
84e0: 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 20 20 20  Table *pTab;    
84f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 66 74           /* Left
8500: 2d 6d 6f 73 74 20 74 61 62 6c 65 20 69 6e 20 74  -most table in t
8510: 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 2a  he FROM clause *
8520: 2f 0a 20 20 20 20 69 6e 74 20 62 52 65 76 20 3d  /.    int bRev =
8530: 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f   0;            /
8540: 2a 20 54 72 75 65 20 74 6f 20 72 65 76 65 72 73  * True to revers
8550: 65 20 74 68 65 20 6f 75 74 70 75 74 20 6f 72 64  e the output ord
8560: 65 72 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 43  er */.    int iC
8570: 75 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ur;             
8580: 20 20 20 2f 2a 20 42 74 72 65 65 2d 63 75 72 73     /* Btree-curs
8590: 6f 72 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20  or that will be 
85a0: 75 73 65 64 20 62 79 20 70 54 61 62 20 2a 2f 0a  used by pTab */.
85b0: 20 20 20 20 57 68 65 72 65 4c 65 76 65 6c 20 2a      WhereLevel *
85c0: 70 4c 65 76 65 6c 30 20 3d 20 26 70 57 49 6e 66  pLevel0 = &pWInf
85d0: 6f 2d 3e 61 5b 30 5d 3b 0a 0a 20 20 20 20 70 54  o->a[0];..    pT
85e0: 61 62 20 3d 20 70 54 61 62 4c 69 73 74 2d 3e 61  ab = pTabList->a
85f0: 5b 30 5d 2e 70 54 61 62 3b 0a 20 20 20 20 70 49  [0].pTab;.    pI
8600: 64 78 20 3d 20 70 4c 65 76 65 6c 30 2d 3e 70 49  dx = pLevel0->pI
8610: 64 78 3b 0a 20 20 20 20 69 43 75 72 20 3d 20 70  dx;.    iCur = p
8620: 54 61 62 4c 69 73 74 2d 3e 61 5b 30 5d 2e 69 43  TabList->a[0].iC
8630: 75 72 73 6f 72 3b 0a 20 20 20 20 69 66 28 20 70  ursor;.    if( p
8640: 49 64 78 3d 3d 30 20 26 26 20 73 6f 72 74 61 62  Idx==0 && sortab
8650: 6c 65 42 79 52 6f 77 69 64 28 69 43 75 72 2c 20  leByRowid(iCur, 
8660: 2a 70 70 4f 72 64 65 72 42 79 2c 20 26 62 52 65  *ppOrderBy, &bRe
8670: 76 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54  v) ){.      /* T
8680: 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75  he ORDER BY clau
8690: 73 65 20 73 70 65 63 69 66 69 65 73 20 52 4f 57  se specifies ROW
86a0: 49 44 20 6f 72 64 65 72 2c 20 77 68 69 63 68 20  ID order, which 
86b0: 69 73 20 77 68 61 74 20 77 65 0a 20 20 20 20 20  is what we.     
86c0: 20 2a 2a 20 77 65 72 65 20 67 6f 69 6e 67 20 74   ** were going t
86d0: 6f 20 62 65 20 64 6f 69 6e 67 20 61 6e 79 77 61  o be doing anywa
86e0: 79 2e 2e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  y....      */.  
86f0: 20 20 20 20 2a 70 70 4f 72 64 65 72 42 79 20 3d      *ppOrderBy =
8700: 20 30 3b 0a 20 20 20 20 20 20 70 4c 65 76 65 6c   0;.      pLevel
8710: 30 2d 3e 62 52 65 76 20 3d 20 62 52 65 76 3b 0a  0->bRev = bRev;.
8720: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 4c      }else if( pL
8730: 65 76 65 6c 30 2d 3e 73 63 6f 72 65 3d 3d 31 36  evel0->score==16
8740: 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 20   ){.      /* If 
8750: 74 68 65 72 65 20 69 73 20 61 6c 72 65 61 64 79  there is already
8760: 20 61 6e 20 49 4e 20 69 6e 64 65 78 20 6f 6e 20   an IN index on 
8770: 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 74 61  the left-most ta
8780: 62 6c 65 2c 0a 20 20 20 20 20 20 2a 2a 20 69 74  ble,.      ** it
8790: 20 77 69 6c 6c 20 6e 6f 74 20 67 69 76 65 20 74   will not give t
87a0: 68 65 20 63 6f 72 72 65 63 74 20 73 6f 72 74 20  he correct sort 
87b0: 6f 72 64 65 72 2e 0a 20 20 20 20 20 20 2a 2a 20  order..      ** 
87c0: 53 6f 2c 20 70 72 65 74 65 6e 64 20 74 68 61 74  So, pretend that
87d0: 20 6e 6f 20 73 75 69 74 61 62 6c 65 20 69 6e 64   no suitable ind
87e0: 65 78 20 69 73 20 66 6f 75 6e 64 2e 0a 20 20 20  ex is found..   
87f0: 20 20 20 2a 2f 0a 20 20 20 20 7d 65 6c 73 65 20     */.    }else 
8800: 69 66 28 20 69 44 69 72 65 63 74 45 71 5b 30 5d  if( iDirectEq[0]
8810: 3e 3d 30 20 7c 7c 20 69 44 69 72 65 63 74 4c 74  >=0 || iDirectLt
8820: 5b 30 5d 3e 3d 30 20 7c 7c 20 69 44 69 72 65 63  [0]>=0 || iDirec
8830: 74 47 74 5b 30 5d 3e 3d 30 20 29 7b 0a 20 20 20  tGt[0]>=0 ){.   
8840: 20 20 20 2f 2a 20 49 66 20 74 68 65 20 6c 65 66     /* If the lef
8850: 74 2d 6d 6f 73 74 20 63 6f 6c 75 6d 6e 20 69 73  t-most column is
8860: 20 61 63 63 65 73 73 65 64 20 75 73 69 6e 67 20   accessed using 
8870: 69 74 73 20 52 4f 57 49 44 2c 20 74 68 65 6e 20  its ROWID, then 
8880: 64 6f 0a 20 20 20 20 20 20 2a 2a 20 6e 6f 74 20  do.      ** not 
8890: 74 72 79 20 74 6f 20 73 6f 72 74 20 62 79 20 69  try to sort by i
88a0: 6e 64 65 78 2e 20 20 42 75 74 20 64 6f 20 64 65  ndex.  But do de
88b0: 6c 65 74 65 20 74 68 65 20 4f 52 44 45 52 20 42  lete the ORDER B
88c0: 59 20 63 6c 61 75 73 65 0a 20 20 20 20 20 20 2a  Y clause.      *
88d0: 2a 20 69 66 20 69 74 20 69 73 20 72 65 64 75 6e  * if it is redun
88e0: 64 61 6e 74 2e 0a 20 20 20 20 20 20 2a 2f 0a 20  dant..      */. 
88f0: 20 20 20 7d 65 6c 73 65 20 69 66 28 20 28 70 4c     }else if( (pL
8900: 65 76 65 6c 30 2d 3e 73 63 6f 72 65 26 32 29 21  evel0->score&2)!
8910: 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54  =0 ){.      /* T
8920: 68 65 20 69 6e 64 65 78 20 74 68 61 74 20 77 61  he index that wa
8930: 73 20 73 65 6c 65 63 74 65 64 20 66 6f 72 20 73  s selected for s
8940: 65 61 72 63 68 69 6e 67 20 77 69 6c 6c 20 63 61  earching will ca
8950: 75 73 65 20 72 6f 77 73 20 74 6f 0a 20 20 20 20  use rows to.    
8960: 20 20 2a 2a 20 61 70 70 65 61 72 20 69 6e 20 73    ** appear in s
8970: 6f 72 74 65 64 20 6f 72 64 65 72 2e 0a 20 20 20  orted order..   
8980: 20 20 20 2a 2f 0a 20 20 20 20 20 20 2a 70 70 4f     */.      *ppO
8990: 72 64 65 72 42 79 20 3d 20 30 3b 0a 20 20 20 20  rderBy = 0;.    
89a0: 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4f 70 65 6e  }.  }..  /* Open
89b0: 20 61 6c 6c 20 74 61 62 6c 65 73 20 69 6e 20 74   all tables in t
89c0: 68 65 20 70 54 61 62 4c 69 73 74 20 61 6e 64 20  he pTabList and 
89d0: 61 6e 79 20 69 6e 64 69 63 65 73 20 73 65 6c 65  any indices sele
89e0: 63 74 65 64 20 66 6f 72 0a 20 20 2a 2a 20 73 65  cted for.  ** se
89f0: 61 72 63 68 69 6e 67 20 74 68 6f 73 65 20 74 61  arching those ta
8a00: 62 6c 65 73 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c  bles..  */.  sql
8a10: 69 74 65 33 43 6f 64 65 56 65 72 69 66 79 53 63  ite3CodeVerifySc
8a20: 68 65 6d 61 28 70 50 61 72 73 65 2c 20 2d 31 29  hema(pParse, -1)
8a30: 3b 20 2f 2a 20 49 6e 73 65 72 74 20 74 68 65 20  ; /* Insert the 
8a40: 63 6f 6f 6b 69 65 20 76 65 72 69 66 69 65 72 20  cookie verifier 
8a50: 47 6f 74 6f 20 2a 2f 0a 20 20 70 4c 65 76 65 6c  Goto */.  pLevel
8a60: 20 3d 20 70 57 49 6e 66 6f 2d 3e 61 3b 0a 20 20   = pWInfo->a;.  
8a70: 66 6f 72 28 69 3d 30 2c 20 70 54 61 62 49 74 65  for(i=0, pTabIte
8a80: 6d 3d 70 54 61 62 4c 69 73 74 2d 3e 61 3b 20 69  m=pTabList->a; i
8a90: 3c 70 54 61 62 4c 69 73 74 2d 3e 6e 53 72 63 3b  <pTabList->nSrc;
8aa0: 20 69 2b 2b 2c 20 70 54 61 62 49 74 65 6d 2b 2b   i++, pTabItem++
8ab0: 2c 20 70 4c 65 76 65 6c 2b 2b 29 7b 0a 20 20 20  , pLevel++){.   
8ac0: 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20   Table *pTab;.  
8ad0: 20 20 49 6e 64 65 78 20 2a 70 49 78 3b 0a 20 20    Index *pIx;.  
8ae0: 20 20 69 6e 74 20 69 49 64 78 43 75 72 20 3d 20    int iIdxCur = 
8af0: 70 4c 65 76 65 6c 2d 3e 69 49 64 78 43 75 72 3b  pLevel->iIdxCur;
8b00: 0a 0a 20 20 20 20 70 54 61 62 20 3d 20 70 54 61  ..    pTab = pTa
8b10: 62 49 74 65 6d 2d 3e 70 54 61 62 3b 0a 20 20 20  bItem->pTab;.   
8b20: 20 69 66 28 20 70 54 61 62 2d 3e 69 73 54 72 61   if( pTab->isTra
8b30: 6e 73 69 65 6e 74 20 7c 7c 20 70 54 61 62 2d 3e  nsient || pTab->
8b40: 70 53 65 6c 65 63 74 20 29 20 63 6f 6e 74 69 6e  pSelect ) contin
8b50: 75 65 3b 0a 20 20 20 20 69 66 28 20 28 70 4c 65  ue;.    if( (pLe
8b60: 76 65 6c 2d 3e 73 63 6f 72 65 20 26 20 31 29 3d  vel->score & 1)=
8b70: 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  =0 ){.      sqli
8b80: 74 65 33 4f 70 65 6e 54 61 62 6c 65 46 6f 72 52  te3OpenTableForR
8b90: 65 61 64 69 6e 67 28 76 2c 20 70 54 61 62 49 74  eading(v, pTabIt
8ba0: 65 6d 2d 3e 69 43 75 72 73 6f 72 2c 20 70 54 61  em->iCursor, pTa
8bb0: 62 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 4c  b);.    }.    pL
8bc0: 65 76 65 6c 2d 3e 69 54 61 62 43 75 72 20 3d 20  evel->iTabCur = 
8bd0: 70 54 61 62 49 74 65 6d 2d 3e 69 43 75 72 73 6f  pTabItem->iCurso
8be0: 72 3b 0a 20 20 20 20 69 66 28 20 28 70 49 78 20  r;.    if( (pIx 
8bf0: 3d 20 70 4c 65 76 65 6c 2d 3e 70 49 64 78 29 21  = pLevel->pIdx)!
8c00: 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  =0 ){.      sqli
8c10: 74 65 33 56 64 62 65 41 64 64 4f 70 28 76 2c 20  te3VdbeAddOp(v, 
8c20: 4f 50 5f 49 6e 74 65 67 65 72 2c 20 70 49 78 2d  OP_Integer, pIx-
8c30: 3e 69 44 62 2c 20 30 29 3b 0a 20 20 20 20 20 20  >iDb, 0);.      
8c40: 73 71 6c 69 74 65 33 56 64 62 65 4f 70 33 28 76  sqlite3VdbeOp3(v
8c50: 2c 20 4f 50 5f 4f 70 65 6e 52 65 61 64 2c 20 69  , OP_OpenRead, i
8c60: 49 64 78 43 75 72 2c 20 70 49 78 2d 3e 74 6e 75  IdxCur, pIx->tnu
8c70: 6d 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  m,.             
8c80: 20 20 20 20 20 20 20 20 28 63 68 61 72 2a 29 26          (char*)&
8c90: 70 49 78 2d 3e 6b 65 79 49 6e 66 6f 2c 20 50 33  pIx->keyInfo, P3
8ca0: 5f 4b 45 59 49 4e 46 4f 29 3b 0a 20 20 20 20 7d  _KEYINFO);.    }
8cb0: 0a 20 20 20 20 69 66 28 20 28 70 4c 65 76 65 6c  .    if( (pLevel
8cc0: 2d 3e 73 63 6f 72 65 20 26 20 31 29 21 3d 30 20  ->score & 1)!=0 
8cd0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
8ce0: 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f  VdbeAddOp(v, OP_
8cf0: 4b 65 79 41 73 44 61 74 61 2c 20 69 49 64 78 43  KeyAsData, iIdxC
8d00: 75 72 2c 20 31 29 3b 0a 20 20 20 20 20 20 73 71  ur, 1);.      sq
8d10: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28 76  lite3VdbeAddOp(v
8d20: 2c 20 4f 50 5f 53 65 74 4e 75 6d 43 6f 6c 75 6d  , OP_SetNumColum
8d30: 6e 73 2c 20 69 49 64 78 43 75 72 2c 20 70 49 78  ns, iIdxCur, pIx
8d40: 2d 3e 6e 43 6f 6c 75 6d 6e 2b 31 29 3b 0a 20 20  ->nColumn+1);.  
8d50: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 43    }.    sqlite3C
8d60: 6f 64 65 56 65 72 69 66 79 53 63 68 65 6d 61 28  odeVerifySchema(
8d70: 70 50 61 72 73 65 2c 20 70 54 61 62 2d 3e 69 44  pParse, pTab->iD
8d80: 62 29 3b 0a 20 20 7d 0a 20 20 70 57 49 6e 66 6f  b);.  }.  pWInfo
8d90: 2d 3e 69 54 6f 70 20 3d 20 73 71 6c 69 74 65 33  ->iTop = sqlite3
8da0: 56 64 62 65 43 75 72 72 65 6e 74 41 64 64 72 28  VdbeCurrentAddr(
8db0: 76 29 3b 0a 0a 20 20 2f 2a 20 47 65 6e 65 72 61  v);..  /* Genera
8dc0: 74 65 20 74 68 65 20 63 6f 64 65 20 74 6f 20 64  te the code to d
8dd0: 6f 20 74 68 65 20 73 65 61 72 63 68 0a 20 20 2a  o the search.  *
8de0: 2f 0a 20 20 6c 6f 6f 70 4d 61 73 6b 20 3d 20 30  /.  loopMask = 0
8df0: 3b 0a 20 20 70 4c 65 76 65 6c 20 3d 20 70 57 49  ;.  pLevel = pWI
8e00: 6e 66 6f 2d 3e 61 3b 0a 20 20 70 54 61 62 49 74  nfo->a;.  pTabIt
8e10: 65 6d 20 3d 20 70 54 61 62 4c 69 73 74 2d 3e 61  em = pTabList->a
8e20: 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70  ;.  for(i=0; i<p
8e30: 54 61 62 4c 69 73 74 2d 3e 6e 53 72 63 3b 20 69  TabList->nSrc; i
8e40: 2b 2b 2c 20 70 54 61 62 49 74 65 6d 2b 2b 2c 20  ++, pTabItem++, 
8e50: 70 4c 65 76 65 6c 2b 2b 29 7b 0a 20 20 20 20 69  pLevel++){.    i
8e60: 6e 74 20 6a 2c 20 6b 3b 0a 20 20 20 20 69 6e 74  nt j, k;.    int
8e70: 20 69 43 75 72 20 3d 20 70 54 61 62 49 74 65 6d   iCur = pTabItem
8e80: 2d 3e 69 43 75 72 73 6f 72 3b 20 20 2f 2a 20 54  ->iCursor;  /* T
8e90: 68 65 20 56 44 42 45 20 63 75 72 73 6f 72 20 66  he VDBE cursor f
8ea0: 6f 72 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a  or the table */.
8eb0: 20 20 20 20 49 6e 64 65 78 20 2a 70 49 64 78 3b      Index *pIdx;
8ec0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 69 6e         /* The in
8ed0: 64 65 78 20 77 65 20 77 69 6c 6c 20 62 65 20 75  dex we will be u
8ee0: 73 69 6e 67 20 2a 2f 0a 20 20 20 20 69 6e 74 20  sing */.    int 
8ef0: 69 49 64 78 43 75 72 3b 20 20 20 20 20 20 20 2f  iIdxCur;       /
8f00: 2a 20 54 68 65 20 56 44 42 45 20 63 75 72 73 6f  * The VDBE curso
8f10: 72 20 66 6f 72 20 74 68 65 20 69 6e 64 65 78 20  r for the index 
8f20: 2a 2f 0a 20 20 20 20 69 6e 74 20 6f 6d 69 74 54  */.    int omitT
8f30: 61 62 6c 65 3b 20 20 20 20 20 2f 2a 20 54 72 75  able;     /* Tru
8f40: 65 20 69 66 20 77 65 20 75 73 65 20 74 68 65 20  e if we use the 
8f50: 69 6e 64 65 78 20 6f 6e 6c 79 20 2a 2f 0a 0a 20  index only */.. 
8f60: 20 20 20 70 49 64 78 20 3d 20 70 4c 65 76 65 6c     pIdx = pLevel
8f70: 2d 3e 70 49 64 78 3b 0a 20 20 20 20 69 49 64 78  ->pIdx;.    iIdx
8f80: 43 75 72 20 3d 20 70 4c 65 76 65 6c 2d 3e 69 49  Cur = pLevel->iI
8f90: 64 78 43 75 72 3b 0a 20 20 20 20 70 4c 65 76 65  dxCur;.    pLeve
8fa0: 6c 2d 3e 69 6e 4f 70 20 3d 20 4f 50 5f 4e 6f 6f  l->inOp = OP_Noo
8fb0: 70 3b 0a 0a 20 20 20 20 2f 2a 20 43 68 65 63 6b  p;..    /* Check
8fc0: 20 74 6f 20 73 65 65 20 69 66 20 69 74 20 69 73   to see if it is
8fd0: 20 61 70 70 72 6f 70 72 69 61 74 65 20 74 6f 20   appropriate to 
8fe0: 6f 6d 69 74 20 74 68 65 20 75 73 65 20 6f 66 20  omit the use of 
8ff0: 74 68 65 20 74 61 62 6c 65 0a 20 20 20 20 2a 2a  the table.    **
9000: 20 68 65 72 65 20 61 6e 64 20 75 73 65 20 69 74   here and use it
9010: 73 20 69 6e 64 65 78 20 69 6e 73 74 65 61 64 2e  s index instead.
9020: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 6f 6d 69 74  .    */.    omit
9030: 54 61 62 6c 65 20 3d 20 28 70 4c 65 76 65 6c 2d  Table = (pLevel-
9040: 3e 73 63 6f 72 65 26 31 29 21 3d 30 3b 0a 0a 20  >score&1)!=0;.. 
9050: 20 20 20 2f 2a 20 49 66 20 74 68 69 73 20 69 73     /* If this is
9060: 20 74 68 65 20 72 69 67 68 74 20 74 61 62 6c 65   the right table
9070: 20 6f 66 20 61 20 4c 45 46 54 20 4f 55 54 45 52   of a LEFT OUTER
9080: 20 4a 4f 49 4e 2c 20 61 6c 6c 6f 63 61 74 65 20   JOIN, allocate 
9090: 61 6e 64 0a 20 20 20 20 2a 2a 20 69 6e 69 74 69  and.    ** initi
90a0: 61 6c 69 7a 65 20 61 20 6d 65 6d 6f 72 79 20 63  alize a memory c
90b0: 65 6c 6c 20 74 68 61 74 20 72 65 63 6f 72 64 73  ell that records
90c0: 20 69 66 20 74 68 69 73 20 74 61 62 6c 65 20 6d   if this table m
90d0: 61 74 63 68 65 73 20 61 6e 79 0a 20 20 20 20 2a  atches any.    *
90e0: 2a 20 72 6f 77 20 6f 66 20 74 68 65 20 6c 65 66  * row of the lef
90f0: 74 20 74 61 62 6c 65 20 6f 66 20 74 68 65 20 6a  t table of the j
9100: 6f 69 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20  oin..    */.    
9110: 69 66 28 20 69 3e 30 20 26 26 20 28 70 54 61 62  if( i>0 && (pTab
9120: 4c 69 73 74 2d 3e 61 5b 69 2d 31 5d 2e 6a 6f 69  List->a[i-1].joi
9130: 6e 74 79 70 65 20 26 20 4a 54 5f 4c 45 46 54 29  ntype & JT_LEFT)
9140: 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28  !=0 ){.      if(
9150: 20 21 70 50 61 72 73 65 2d 3e 6e 4d 65 6d 20 29   !pParse->nMem )
9160: 20 70 50 61 72 73 65 2d 3e 6e 4d 65 6d 2b 2b 3b   pParse->nMem++;
9170: 0a 20 20 20 20 20 20 70 4c 65 76 65 6c 2d 3e 69  .      pLevel->i
9180: 4c 65 66 74 4a 6f 69 6e 20 3d 20 70 50 61 72 73  LeftJoin = pPars
9190: 65 2d 3e 6e 4d 65 6d 2b 2b 3b 0a 20 20 20 20 20  e->nMem++;.     
91a0: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
91b0: 70 28 76 2c 20 4f 50 5f 53 74 72 69 6e 67 38 2c  p(v, OP_String8,
91c0: 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 73 71   0, 0);.      sq
91d0: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28 76  lite3VdbeAddOp(v
91e0: 2c 20 4f 50 5f 4d 65 6d 53 74 6f 72 65 2c 20 70  , OP_MemStore, p
91f0: 4c 65 76 65 6c 2d 3e 69 4c 65 66 74 4a 6f 69 6e  Level->iLeftJoin
9200: 2c 20 31 29 3b 0a 20 20 20 20 20 20 56 64 62 65  , 1);.      Vdbe
9210: 43 6f 6d 6d 65 6e 74 28 28 76 2c 20 22 23 20 69  Comment((v, "# i
9220: 6e 69 74 20 4c 45 46 54 20 4a 4f 49 4e 20 6e 6f  nit LEFT JOIN no
9230: 2d 6d 61 74 63 68 20 66 6c 61 67 22 29 29 3b 0a  -match flag"));.
9240: 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 69      }..    if( i
9250: 3c 41 52 52 41 59 53 49 5a 45 28 69 44 69 72 65  <ARRAYSIZE(iDire
9260: 63 74 45 71 29 20 26 26 20 28 6b 20 3d 20 69 44  ctEq) && (k = iD
9270: 69 72 65 63 74 45 71 5b 69 5d 29 3e 3d 30 20 29  irectEq[i])>=0 )
9280: 7b 0a 20 20 20 20 20 20 2f 2a 20 43 61 73 65 20  {.      /* Case 
9290: 31 3a 20 20 57 65 20 63 61 6e 20 64 69 72 65 63  1:  We can direc
92a0: 74 6c 79 20 72 65 66 65 72 65 6e 63 65 20 61 20  tly reference a 
92b0: 73 69 6e 67 6c 65 20 72 6f 77 20 75 73 69 6e 67  single row using
92c0: 20 61 6e 0a 20 20 20 20 20 20 2a 2a 20 20 20 20   an.      **    
92d0: 20 20 20 20 20 20 65 71 75 61 6c 69 74 79 20 63        equality c
92e0: 6f 6d 70 61 72 69 73 6f 6e 20 61 67 61 69 6e 73  omparison agains
92f0: 74 20 74 68 65 20 52 4f 57 49 44 20 66 69 65 6c  t the ROWID fiel
9300: 64 2e 20 20 4f 72 0a 20 20 20 20 20 20 2a 2a 20  d.  Or.      ** 
9310: 20 20 20 20 20 20 20 20 20 77 65 20 72 65 66 65           we refe
9320: 72 65 6e 63 65 20 6d 75 6c 74 69 70 6c 65 20 72  rence multiple r
9330: 6f 77 73 20 75 73 69 6e 67 20 61 20 22 72 6f 77  ows using a "row
9340: 69 64 20 49 4e 20 28 2e 2e 2e 29 22 0a 20 20 20  id IN (...)".   
9350: 20 20 20 2a 2a 20 20 20 20 20 20 20 20 20 20 63     **          c
9360: 6f 6e 73 74 72 75 63 74 2e 0a 20 20 20 20 20 20  onstruct..      
9370: 2a 2f 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  */.      assert(
9380: 20 6b 3c 6e 45 78 70 72 20 29 3b 0a 20 20 20 20   k<nExpr );.    
9390: 20 20 70 54 65 72 6d 20 3d 20 26 61 45 78 70 72    pTerm = &aExpr
93a0: 5b 6b 5d 3b 0a 20 20 20 20 20 20 61 73 73 65 72  [k];.      asser
93b0: 74 28 20 70 54 65 72 6d 2d 3e 70 21 3d 30 20 29  t( pTerm->p!=0 )
93c0: 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20  ;.      assert( 
93d0: 70 54 65 72 6d 2d 3e 69 64 78 4c 65 66 74 3d 3d  pTerm->idxLeft==
93e0: 69 43 75 72 20 29 3b 0a 20 20 20 20 20 20 61 73  iCur );.      as
93f0: 73 65 72 74 28 20 6f 6d 69 74 54 61 62 6c 65 3d  sert( omitTable=
9400: 3d 30 20 29 3b 0a 20 20 20 20 20 20 62 72 6b 20  =0 );.      brk 
9410: 3d 20 70 4c 65 76 65 6c 2d 3e 62 72 6b 20 3d 20  = pLevel->brk = 
9420: 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c  sqlite3VdbeMakeL
9430: 61 62 65 6c 28 76 29 3b 0a 20 20 20 20 20 20 63  abel(v);.      c
9440: 6f 64 65 45 71 75 61 6c 69 74 79 54 65 72 6d 28  odeEqualityTerm(
9450: 70 50 61 72 73 65 2c 20 70 54 65 72 6d 2c 20 62  pParse, pTerm, b
9460: 72 6b 2c 20 70 4c 65 76 65 6c 29 3b 0a 20 20 20  rk, pLevel);.   
9470: 20 20 20 63 6f 6e 74 20 3d 20 70 4c 65 76 65 6c     cont = pLevel
9480: 2d 3e 63 6f 6e 74 20 3d 20 73 71 6c 69 74 65 33  ->cont = sqlite3
9490: 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28 76 29  VdbeMakeLabel(v)
94a0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  ;.      sqlite3V
94b0: 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f 4d  dbeAddOp(v, OP_M
94c0: 75 73 74 42 65 49 6e 74 2c 20 31 2c 20 62 72 6b  ustBeInt, 1, brk
94d0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
94e0: 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f  VdbeAddOp(v, OP_
94f0: 4e 6f 74 45 78 69 73 74 73 2c 20 69 43 75 72 2c  NotExists, iCur,
9500: 20 62 72 6b 29 3b 0a 20 20 20 20 20 20 56 64 62   brk);.      Vdb
9510: 65 43 6f 6d 6d 65 6e 74 28 28 76 2c 20 22 70 6b  eComment((v, "pk
9520: 22 29 29 3b 0a 20 20 20 20 20 20 70 4c 65 76 65  "));.      pLeve
9530: 6c 2d 3e 6f 70 20 3d 20 4f 50 5f 4e 6f 6f 70 3b  l->op = OP_Noop;
9540: 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70  .    }else if( p
9550: 49 64 78 21 3d 30 20 26 26 20 70 4c 65 76 65 6c  Idx!=0 && pLevel
9560: 2d 3e 73 63 6f 72 65 3e 33 20 26 26 20 28 70 4c  ->score>3 && (pL
9570: 65 76 65 6c 2d 3e 73 63 6f 72 65 26 30 78 30 63  evel->score&0x0c
9580: 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a  )==0 ){.      /*
9590: 20 43 61 73 65 20 32 3a 20 20 54 68 65 72 65 20   Case 2:  There 
95a0: 69 73 20 61 6e 20 69 6e 64 65 78 20 61 6e 64 20  is an index and 
95b0: 61 6c 6c 20 74 65 72 6d 73 20 6f 66 20 74 68 65  all terms of the
95c0: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 74 68   WHERE clause th
95d0: 61 74 0a 20 20 20 20 20 20 2a 2a 20 20 20 20 20  at.      **     
95e0: 20 20 20 20 20 72 65 66 65 72 20 74 6f 20 74 68       refer to th
95f0: 65 20 69 6e 64 65 78 20 75 73 69 6e 67 20 74 68  e index using th
9600: 65 20 22 3d 3d 22 20 6f 72 20 22 49 4e 22 20 6f  e "==" or "IN" o
9610: 70 65 72 61 74 6f 72 73 2e 0a 20 20 20 20 20 20  perators..      
9620: 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 73 74 61  */.      int sta
9630: 72 74 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 43  rt;.      int nC
9640: 6f 6c 75 6d 6e 20 3d 20 28 70 4c 65 76 65 6c 2d  olumn = (pLevel-
9650: 3e 73 63 6f 72 65 2b 31 36 29 2f 33 32 3b 0a 20  >score+16)/32;. 
9660: 20 20 20 20 20 62 72 6b 20 3d 20 70 4c 65 76 65       brk = pLeve
9670: 6c 2d 3e 62 72 6b 20 3d 20 73 71 6c 69 74 65 33  l->brk = sqlite3
9680: 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28 76 29  VdbeMakeLabel(v)
9690: 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 46 6f 72 20  ;..      /* For 
96a0: 65 61 63 68 20 63 6f 6c 75 6d 6e 20 6f 66 20 74  each column of t
96b0: 68 65 20 69 6e 64 65 78 2c 20 66 69 6e 64 20 74  he index, find t
96c0: 68 65 20 74 65 72 6d 20 6f 66 20 74 68 65 20 57  he term of the W
96d0: 48 45 52 45 20 63 6c 61 75 73 65 20 74 68 61 74  HERE clause that
96e0: 0a 20 20 20 20 20 20 2a 2a 20 63 6f 6e 73 74 72  .      ** constr
96f0: 61 69 6e 74 73 20 74 68 61 74 20 63 6f 6c 75 6d  aints that colum
9700: 6e 2e 20 20 49 66 20 74 68 65 20 57 48 45 52 45  n.  If the WHERE
9710: 20 63 6c 61 75 73 65 20 74 65 72 6d 20 69 73 20   clause term is 
9720: 58 3d 65 78 70 72 2c 20 74 68 65 6e 0a 20 20 20  X=expr, then.   
9730: 20 20 20 2a 2a 20 65 76 61 6c 75 61 74 69 6f 6e     ** evaluation
9740: 20 65 78 70 72 20 61 6e 64 20 6c 65 61 76 65 20   expr and leave 
9750: 74 68 65 20 72 65 73 75 6c 74 20 6f 6e 20 74 68  the result on th
9760: 65 20 73 74 61 63 6b 20 2a 2f 0a 20 20 20 20 20  e stack */.     
9770: 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 6e 43 6f 6c   for(j=0; j<nCol
9780: 75 6d 6e 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20  umn; j++){.     
9790: 20 20 20 66 6f 72 28 70 54 65 72 6d 3d 61 45 78     for(pTerm=aEx
97a0: 70 72 2c 20 6b 3d 30 3b 20 6b 3c 6e 45 78 70 72  pr, k=0; k<nExpr
97b0: 3b 20 6b 2b 2b 2c 20 70 54 65 72 6d 2b 2b 29 7b  ; k++, pTerm++){
97c0: 0a 20 20 20 20 20 20 20 20 20 20 45 78 70 72 20  .          Expr 
97d0: 2a 70 58 20 3d 20 70 54 65 72 6d 2d 3e 70 3b 0a  *pX = pTerm->p;.
97e0: 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 58            if( pX
97f0: 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a  ==0 ) continue;.
9800: 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 54            if( pT
9810: 65 72 6d 2d 3e 69 64 78 4c 65 66 74 3d 3d 69 43  erm->idxLeft==iC
9820: 75 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  ur.             
9830: 26 26 20 28 70 54 65 72 6d 2d 3e 70 72 65 72 65  && (pTerm->prere
9840: 71 52 69 67 68 74 20 26 20 6c 6f 6f 70 4d 61 73  qRight & loopMas
9850: 6b 29 3d 3d 70 54 65 72 6d 2d 3e 70 72 65 72 65  k)==pTerm->prere
9860: 71 52 69 67 68 74 20 0a 20 20 20 20 20 20 20 20  qRight .        
9870: 20 20 20 20 20 26 26 20 70 58 2d 3e 70 4c 65 66       && pX->pLef
9880: 74 2d 3e 69 43 6f 6c 75 6d 6e 3d 3d 70 49 64 78  t->iColumn==pIdx
9890: 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 6a 5d 0a 20 20  ->aiColumn[j].  
98a0: 20 20 20 20 20 20 20 20 20 20 20 26 26 20 28 70             && (p
98b0: 58 2d 3e 6f 70 3d 3d 54 4b 5f 45 51 20 7c 7c 20  X->op==TK_EQ || 
98c0: 70 58 2d 3e 6f 70 3d 3d 54 4b 5f 49 4e 29 0a 20  pX->op==TK_IN). 
98d0: 20 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20           ){.    
98e0: 20 20 20 20 20 20 20 20 63 68 61 72 20 69 64 78          char idx
98f0: 61 66 66 20 3d 20 70 49 64 78 2d 3e 70 54 61 62  aff = pIdx->pTab
9900: 6c 65 2d 3e 61 43 6f 6c 5b 70 58 2d 3e 70 4c 65  le->aCol[pX->pLe
9910: 66 74 2d 3e 69 43 6f 6c 75 6d 6e 5d 2e 61 66 66  ft->iColumn].aff
9920: 69 6e 69 74 79 3b 0a 20 20 20 20 20 20 20 20 20  inity;.         
9930: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 49 6e     if( sqlite3In
9940: 64 65 78 41 66 66 69 6e 69 74 79 4f 6b 28 70 58  dexAffinityOk(pX
9950: 2c 20 69 64 78 61 66 66 29 20 29 7b 0a 20 20 20  , idxaff) ){.   
9960: 20 20 20 20 20 20 20 20 20 20 20 63 6f 64 65 45             codeE
9970: 71 75 61 6c 69 74 79 54 65 72 6d 28 70 50 61 72  qualityTerm(pPar
9980: 73 65 2c 20 70 54 65 72 6d 2c 20 62 72 6b 2c 20  se, pTerm, brk, 
9990: 70 4c 65 76 65 6c 29 3b 0a 20 20 20 20 20 20 20  pLevel);.       
99a0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
99b0: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20            }.    
99c0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
99d0: 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  }.      }.      
99e0: 70 4c 65 76 65 6c 2d 3e 69 4d 65 6d 20 3d 20 70  pLevel->iMem = p
99f0: 50 61 72 73 65 2d 3e 6e 4d 65 6d 2b 2b 3b 0a 20  Parse->nMem++;. 
9a00: 20 20 20 20 20 63 6f 6e 74 20 3d 20 70 4c 65 76       cont = pLev
9a10: 65 6c 2d 3e 63 6f 6e 74 20 3d 20 73 71 6c 69 74  el->cont = sqlit
9a20: 65 33 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28  e3VdbeMakeLabel(
9a30: 76 29 3b 0a 20 20 20 20 20 20 62 75 69 6c 64 49  v);.      buildI
9a40: 6e 64 65 78 50 72 6f 62 65 28 76 2c 20 6e 43 6f  ndexProbe(v, nCo
9a50: 6c 75 6d 6e 2c 20 62 72 6b 2c 20 70 49 64 78 29  lumn, brk, pIdx)
9a60: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  ;.      sqlite3V
9a70: 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f 4d  dbeAddOp(v, OP_M
9a80: 65 6d 53 74 6f 72 65 2c 20 70 4c 65 76 65 6c 2d  emStore, pLevel-
9a90: 3e 69 4d 65 6d 2c 20 30 29 3b 0a 0a 20 20 20 20  >iMem, 0);..    
9aa0: 20 20 2f 2a 20 47 65 6e 65 72 61 74 65 20 63 6f    /* Generate co
9ab0: 64 65 20 28 31 29 20 74 6f 20 6d 6f 76 65 20 74  de (1) to move t
9ac0: 6f 20 74 68 65 20 66 69 72 73 74 20 6d 61 74 63  o the first matc
9ad0: 68 69 6e 67 20 65 6c 65 6d 65 6e 74 20 6f 66 20  hing element of 
9ae0: 74 68 65 20 74 61 62 6c 65 2e 0a 20 20 20 20 20  the table..     
9af0: 20 2a 2a 20 54 68 65 6e 20 67 65 6e 65 72 61 74   ** Then generat
9b00: 65 20 63 6f 64 65 20 28 32 29 20 74 68 61 74 20  e code (2) that 
9b10: 6a 75 6d 70 73 20 74 6f 20 22 62 72 6b 22 20 61  jumps to "brk" a
9b20: 66 74 65 72 20 74 68 65 20 63 75 72 73 6f 72 20  fter the cursor 
9b30: 69 73 20 70 61 73 74 0a 20 20 20 20 20 20 2a 2a  is past.      **
9b40: 20 74 68 65 20 6c 61 73 74 20 6d 61 74 63 68 69   the last matchi
9b50: 6e 67 20 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68  ng element of th
9b60: 65 20 74 61 62 6c 65 2e 20 20 54 68 65 20 63 6f  e table.  The co
9b70: 64 65 20 28 31 29 20 69 73 20 65 78 65 63 75 74  de (1) is execut
9b80: 65 64 0a 20 20 20 20 20 20 2a 2a 20 6f 6e 63 65  ed.      ** once
9b90: 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74   to initialize t
9ba0: 68 65 20 73 65 61 72 63 68 2c 20 74 68 65 20 63  he search, the c
9bb0: 6f 64 65 20 28 32 29 20 69 73 20 65 78 65 63 75  ode (2) is execu
9bc0: 74 65 64 20 62 65 66 6f 72 65 20 65 61 63 68 0a  ted before each.
9bd0: 20 20 20 20 20 20 2a 2a 20 69 74 65 72 61 74 69        ** iterati
9be0: 6f 6e 20 6f 66 20 74 68 65 20 73 63 61 6e 20 74  on of the scan t
9bf0: 6f 20 73 65 65 20 69 66 20 74 68 65 20 73 63 61  o see if the sca
9c00: 6e 20 68 61 73 20 66 69 6e 69 73 68 65 64 2e 20  n has finished. 
9c10: 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 4c 65  */.      if( pLe
9c20: 76 65 6c 2d 3e 62 52 65 76 20 29 7b 0a 20 20 20  vel->bRev ){.   
9c30: 20 20 20 20 20 2f 2a 20 53 63 61 6e 20 69 6e 20       /* Scan in 
9c40: 72 65 76 65 72 73 65 20 6f 72 64 65 72 20 2a 2f  reverse order */
9c50: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
9c60: 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f  VdbeAddOp(v, OP_
9c70: 4d 6f 76 65 4c 65 2c 20 69 49 64 78 43 75 72 2c  MoveLe, iIdxCur,
9c80: 20 62 72 6b 29 3b 0a 20 20 20 20 20 20 20 20 73   brk);.        s
9c90: 74 61 72 74 20 3d 20 73 71 6c 69 74 65 33 56 64  tart = sqlite3Vd
9ca0: 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f 4d 65  beAddOp(v, OP_Me
9cb0: 6d 4c 6f 61 64 2c 20 70 4c 65 76 65 6c 2d 3e 69  mLoad, pLevel->i
9cc0: 4d 65 6d 2c 20 30 29 3b 0a 20 20 20 20 20 20 20  Mem, 0);.       
9cd0: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
9ce0: 70 28 76 2c 20 4f 50 5f 49 64 78 4c 54 2c 20 69  p(v, OP_IdxLT, i
9cf0: 49 64 78 43 75 72 2c 20 62 72 6b 29 3b 0a 20 20  IdxCur, brk);.  
9d00: 20 20 20 20 20 20 70 4c 65 76 65 6c 2d 3e 6f 70        pLevel->op
9d10: 20 3d 20 4f 50 5f 50 72 65 76 3b 0a 20 20 20 20   = OP_Prev;.    
9d20: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
9d30: 20 2f 2a 20 53 63 61 6e 20 69 6e 20 74 68 65 20   /* Scan in the 
9d40: 66 6f 72 77 61 72 64 20 6f 72 64 65 72 20 2a 2f  forward order */
9d50: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
9d60: 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f  VdbeAddOp(v, OP_
9d70: 4d 6f 76 65 47 65 2c 20 69 49 64 78 43 75 72 2c  MoveGe, iIdxCur,
9d80: 20 62 72 6b 29 3b 0a 20 20 20 20 20 20 20 20 73   brk);.        s
9d90: 74 61 72 74 20 3d 20 73 71 6c 69 74 65 33 56 64  tart = sqlite3Vd
9da0: 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f 4d 65  beAddOp(v, OP_Me
9db0: 6d 4c 6f 61 64 2c 20 70 4c 65 76 65 6c 2d 3e 69  mLoad, pLevel->i
9dc0: 4d 65 6d 2c 20 30 29 3b 0a 20 20 20 20 20 20 20  Mem, 0);.       
9dd0: 20 73 71 6c 69 74 65 33 56 64 62 65 4f 70 33 28   sqlite3VdbeOp3(
9de0: 76 2c 20 4f 50 5f 49 64 78 47 45 2c 20 69 49 64  v, OP_IdxGE, iId
9df0: 78 43 75 72 2c 20 62 72 6b 2c 20 22 2b 22 2c 20  xCur, brk, "+", 
9e00: 50 33 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20  P3_STATIC);.    
9e10: 20 20 20 20 70 4c 65 76 65 6c 2d 3e 6f 70 20 3d      pLevel->op =
9e20: 20 4f 50 5f 4e 65 78 74 3b 0a 20 20 20 20 20 20   OP_Next;.      
9e30: 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  }.      sqlite3V
9e40: 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f 52  dbeAddOp(v, OP_R
9e50: 6f 77 4b 65 79 2c 20 69 49 64 78 43 75 72 2c 20  owKey, iIdxCur, 
9e60: 30 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  0);.      sqlite
9e70: 33 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50  3VdbeAddOp(v, OP
9e80: 5f 49 64 78 49 73 4e 75 6c 6c 2c 20 6e 43 6f 6c  _IdxIsNull, nCol
9e90: 75 6d 6e 2c 20 63 6f 6e 74 29 3b 0a 20 20 20 20  umn, cont);.    
9ea0: 20 20 69 66 28 20 21 6f 6d 69 74 54 61 62 6c 65    if( !omitTable
9eb0: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69   ){.        sqli
9ec0: 74 65 33 56 64 62 65 41 64 64 4f 70 28 76 2c 20  te3VdbeAddOp(v, 
9ed0: 4f 50 5f 49 64 78 52 65 63 6e 6f 2c 20 69 49 64  OP_IdxRecno, iId
9ee0: 78 43 75 72 2c 20 30 29 3b 0a 20 20 20 20 20 20  xCur, 0);.      
9ef0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64    sqlite3VdbeAdd
9f00: 4f 70 28 76 2c 20 4f 50 5f 4d 6f 76 65 47 65 2c  Op(v, OP_MoveGe,
9f10: 20 69 43 75 72 2c 20 30 29 3b 0a 20 20 20 20 20   iCur, 0);.     
9f20: 20 7d 0a 20 20 20 20 20 20 70 4c 65 76 65 6c 2d   }.      pLevel-
9f30: 3e 70 31 20 3d 20 69 49 64 78 43 75 72 3b 0a 20  >p1 = iIdxCur;. 
9f40: 20 20 20 20 20 70 4c 65 76 65 6c 2d 3e 70 32 20       pLevel->p2 
9f50: 3d 20 73 74 61 72 74 3b 0a 20 20 20 20 7d 65 6c  = start;.    }el
9f60: 73 65 20 69 66 28 20 69 3c 41 52 52 41 59 53 49  se if( i<ARRAYSI
9f70: 5a 45 28 69 44 69 72 65 63 74 4c 74 29 20 26 26  ZE(iDirectLt) &&
9f80: 20 28 69 44 69 72 65 63 74 4c 74 5b 69 5d 3e 3d   (iDirectLt[i]>=
9f90: 30 20 7c 7c 20 69 44 69 72 65 63 74 47 74 5b 69  0 || iDirectGt[i
9fa0: 5d 3e 3d 30 29 20 29 7b 0a 20 20 20 20 20 20 2f  ]>=0) ){.      /
9fb0: 2a 20 43 61 73 65 20 33 3a 20 20 57 65 20 68 61  * Case 3:  We ha
9fc0: 76 65 20 61 6e 20 69 6e 65 71 75 61 6c 69 74 79  ve an inequality
9fd0: 20 63 6f 6d 70 61 72 69 73 6f 6e 20 61 67 61 69   comparison agai
9fe0: 6e 73 74 20 74 68 65 20 52 4f 57 49 44 20 66 69  nst the ROWID fi
9ff0: 65 6c 64 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  eld..      */.  
a000: 20 20 20 20 69 6e 74 20 74 65 73 74 4f 70 20 3d      int testOp =
a010: 20 4f 50 5f 4e 6f 6f 70 3b 0a 20 20 20 20 20 20   OP_Noop;.      
a020: 69 6e 74 20 73 74 61 72 74 3b 0a 20 20 20 20 20  int start;.     
a030: 20 69 6e 74 20 62 52 65 76 20 3d 20 70 4c 65 76   int bRev = pLev
a040: 65 6c 2d 3e 62 52 65 76 3b 0a 0a 20 20 20 20 20  el->bRev;..     
a050: 20 61 73 73 65 72 74 28 20 6f 6d 69 74 54 61 62   assert( omitTab
a060: 6c 65 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 62  le==0 );.      b
a070: 72 6b 20 3d 20 70 4c 65 76 65 6c 2d 3e 62 72 6b  rk = pLevel->brk
a080: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61   = sqlite3VdbeMa
a090: 6b 65 4c 61 62 65 6c 28 76 29 3b 0a 20 20 20 20  keLabel(v);.    
a0a0: 20 20 63 6f 6e 74 20 3d 20 70 4c 65 76 65 6c 2d    cont = pLevel-
a0b0: 3e 63 6f 6e 74 20 3d 20 73 71 6c 69 74 65 33 56  >cont = sqlite3V
a0c0: 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28 76 29 3b  dbeMakeLabel(v);
a0d0: 0a 20 20 20 20 20 20 69 66 28 20 62 52 65 76 20  .      if( bRev 
a0e0: 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 74  ){.        int t
a0f0: 20 3d 20 69 44 69 72 65 63 74 47 74 5b 69 5d 3b   = iDirectGt[i];
a100: 0a 20 20 20 20 20 20 20 20 69 44 69 72 65 63 74  .        iDirect
a110: 47 74 5b 69 5d 20 3d 20 69 44 69 72 65 63 74 4c  Gt[i] = iDirectL
a120: 74 5b 69 5d 3b 0a 20 20 20 20 20 20 20 20 69 44  t[i];.        iD
a130: 69 72 65 63 74 4c 74 5b 69 5d 20 3d 20 74 3b 0a  irectLt[i] = t;.
a140: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66        }.      if
a150: 28 20 69 44 69 72 65 63 74 47 74 5b 69 5d 3e 3d  ( iDirectGt[i]>=
a160: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 45 78 70  0 ){.        Exp
a170: 72 20 2a 70 58 3b 0a 20 20 20 20 20 20 20 20 6b  r *pX;.        k
a180: 20 3d 20 69 44 69 72 65 63 74 47 74 5b 69 5d 3b   = iDirectGt[i];
a190: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28  .        assert(
a1a0: 20 6b 3c 6e 45 78 70 72 20 29 3b 0a 20 20 20 20   k<nExpr );.    
a1b0: 20 20 20 20 70 54 65 72 6d 20 3d 20 26 61 45 78      pTerm = &aEx
a1c0: 70 72 5b 6b 5d 3b 0a 20 20 20 20 20 20 20 20 70  pr[k];.        p
a1d0: 58 20 3d 20 70 54 65 72 6d 2d 3e 70 3b 0a 20 20  X = pTerm->p;.  
a1e0: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 58        assert( pX
a1f0: 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 61  !=0 );.        a
a200: 73 73 65 72 74 28 20 70 54 65 72 6d 2d 3e 69 64  ssert( pTerm->id
a210: 78 4c 65 66 74 3d 3d 69 43 75 72 20 29 3b 0a 20  xLeft==iCur );. 
a220: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 78         sqlite3Ex
a230: 70 72 43 6f 64 65 28 70 50 61 72 73 65 2c 20 70  prCode(pParse, p
a240: 58 2d 3e 70 52 69 67 68 74 29 3b 0a 20 20 20 20  X->pRight);.    
a250: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41      sqlite3VdbeA
a260: 64 64 4f 70 28 76 2c 20 4f 50 5f 46 6f 72 63 65  ddOp(v, OP_Force
a270: 49 6e 74 2c 20 70 58 2d 3e 6f 70 3d 3d 54 4b 5f  Int, pX->op==TK_
a280: 4c 45 20 7c 7c 20 70 58 2d 3e 6f 70 3d 3d 54 4b  LE || pX->op==TK
a290: 5f 47 54 2c 20 62 72 6b 29 3b 0a 20 20 20 20 20  _GT, brk);.     
a2a0: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64     sqlite3VdbeAd
a2b0: 64 4f 70 28 76 2c 20 62 52 65 76 20 3f 20 4f 50  dOp(v, bRev ? OP
a2c0: 5f 4d 6f 76 65 4c 74 20 3a 20 4f 50 5f 4d 6f 76  _MoveLt : OP_Mov
a2d0: 65 47 65 2c 20 69 43 75 72 2c 20 62 72 6b 29 3b  eGe, iCur, brk);
a2e0: 0a 20 20 20 20 20 20 20 20 56 64 62 65 43 6f 6d  .        VdbeCom
a2f0: 6d 65 6e 74 28 28 76 2c 20 22 70 6b 22 29 29 3b  ment((v, "pk"));
a300: 0a 20 20 20 20 20 20 20 20 64 69 73 61 62 6c 65  .        disable
a310: 54 65 72 6d 28 70 4c 65 76 65 6c 2c 20 26 70 54  Term(pLevel, &pT
a320: 65 72 6d 2d 3e 70 29 3b 0a 20 20 20 20 20 20 7d  erm->p);.      }
a330: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 73 71  else{.        sq
a340: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28 76  lite3VdbeAddOp(v
a350: 2c 20 62 52 65 76 20 3f 20 4f 50 5f 4c 61 73 74  , bRev ? OP_Last
a360: 20 3a 20 4f 50 5f 52 65 77 69 6e 64 2c 20 69 43   : OP_Rewind, iC
a370: 75 72 2c 20 62 72 6b 29 3b 0a 20 20 20 20 20 20  ur, brk);.      
a380: 7d 0a 20 20 20 20 20 20 69 66 28 20 69 44 69 72  }.      if( iDir
a390: 65 63 74 4c 74 5b 69 5d 3e 3d 30 20 29 7b 0a 20  ectLt[i]>=0 ){. 
a3a0: 20 20 20 20 20 20 20 45 78 70 72 20 2a 70 58 3b         Expr *pX;
a3b0: 0a 20 20 20 20 20 20 20 20 6b 20 3d 20 69 44 69  .        k = iDi
a3c0: 72 65 63 74 4c 74 5b 69 5d 3b 0a 20 20 20 20 20  rectLt[i];.     
a3d0: 20 20 20 61 73 73 65 72 74 28 20 6b 3c 6e 45 78     assert( k<nEx
a3e0: 70 72 20 29 3b 0a 20 20 20 20 20 20 20 20 70 54  pr );.        pT
a3f0: 65 72 6d 20 3d 20 26 61 45 78 70 72 5b 6b 5d 3b  erm = &aExpr[k];
a400: 0a 20 20 20 20 20 20 20 20 70 58 20 3d 20 70 54  .        pX = pT
a410: 65 72 6d 2d 3e 70 3b 0a 20 20 20 20 20 20 20 20  erm->p;.        
a420: 61 73 73 65 72 74 28 20 70 58 21 3d 30 20 29 3b  assert( pX!=0 );
a430: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28  .        assert(
a440: 20 70 54 65 72 6d 2d 3e 69 64 78 4c 65 66 74 3d   pTerm->idxLeft=
a450: 3d 69 43 75 72 20 29 3b 0a 20 20 20 20 20 20 20  =iCur );.       
a460: 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65   sqlite3ExprCode
a470: 28 70 50 61 72 73 65 2c 20 70 58 2d 3e 70 52 69  (pParse, pX->pRi
a480: 67 68 74 29 3b 0a 20 20 20 20 20 20 20 20 70 4c  ght);.        pL
a490: 65 76 65 6c 2d 3e 69 4d 65 6d 20 3d 20 70 50 61  evel->iMem = pPa
a4a0: 72 73 65 2d 3e 6e 4d 65 6d 2b 2b 3b 0a 20 20 20  rse->nMem++;.   
a4b0: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
a4c0: 41 64 64 4f 70 28 76 2c 20 4f 50 5f 4d 65 6d 53  AddOp(v, OP_MemS
a4d0: 74 6f 72 65 2c 20 70 4c 65 76 65 6c 2d 3e 69 4d  tore, pLevel->iM
a4e0: 65 6d 2c 20 31 29 3b 0a 20 20 20 20 20 20 20 20  em, 1);.        
a4f0: 69 66 28 20 70 58 2d 3e 6f 70 3d 3d 54 4b 5f 4c  if( pX->op==TK_L
a500: 54 20 7c 7c 20 70 58 2d 3e 6f 70 3d 3d 54 4b 5f  T || pX->op==TK_
a510: 47 54 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  GT ){.          
a520: 74 65 73 74 4f 70 20 3d 20 62 52 65 76 20 3f 20  testOp = bRev ? 
a530: 4f 50 5f 4c 65 20 3a 20 4f 50 5f 47 65 3b 0a 20  OP_Le : OP_Ge;. 
a540: 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20         }else{.  
a550: 20 20 20 20 20 20 20 20 74 65 73 74 4f 70 20 3d          testOp =
a560: 20 62 52 65 76 20 3f 20 4f 50 5f 4c 74 20 3a 20   bRev ? OP_Lt : 
a570: 4f 50 5f 47 74 3b 0a 20 20 20 20 20 20 20 20 7d  OP_Gt;.        }
a580: 0a 20 20 20 20 20 20 20 20 64 69 73 61 62 6c 65  .        disable
a590: 54 65 72 6d 28 70 4c 65 76 65 6c 2c 20 26 70 54  Term(pLevel, &pT
a5a0: 65 72 6d 2d 3e 70 29 3b 0a 20 20 20 20 20 20 7d  erm->p);.      }
a5b0: 0a 20 20 20 20 20 20 73 74 61 72 74 20 3d 20 73  .      start = s
a5c0: 71 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 6e  qlite3VdbeCurren
a5d0: 74 41 64 64 72 28 76 29 3b 0a 20 20 20 20 20 20  tAddr(v);.      
a5e0: 70 4c 65 76 65 6c 2d 3e 6f 70 20 3d 20 62 52 65  pLevel->op = bRe
a5f0: 76 20 3f 20 4f 50 5f 50 72 65 76 20 3a 20 4f 50  v ? OP_Prev : OP
a600: 5f 4e 65 78 74 3b 0a 20 20 20 20 20 20 70 4c 65  _Next;.      pLe
a610: 76 65 6c 2d 3e 70 31 20 3d 20 69 43 75 72 3b 0a  vel->p1 = iCur;.
a620: 20 20 20 20 20 20 70 4c 65 76 65 6c 2d 3e 70 32        pLevel->p2
a630: 20 3d 20 73 74 61 72 74 3b 0a 20 20 20 20 20 20   = start;.      
a640: 69 66 28 20 74 65 73 74 4f 70 21 3d 4f 50 5f 4e  if( testOp!=OP_N
a650: 6f 6f 70 20 29 7b 0a 20 20 20 20 20 20 20 20 73  oop ){.        s
a660: 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28  qlite3VdbeAddOp(
a670: 76 2c 20 4f 50 5f 52 65 63 6e 6f 2c 20 69 43 75  v, OP_Recno, iCu
a680: 72 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 73  r, 0);.        s
a690: 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28  qlite3VdbeAddOp(
a6a0: 76 2c 20 4f 50 5f 4d 65 6d 4c 6f 61 64 2c 20 70  v, OP_MemLoad, p
a6b0: 4c 65 76 65 6c 2d 3e 69 4d 65 6d 2c 20 30 29 3b  Level->iMem, 0);
a6c0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
a6d0: 56 64 62 65 41 64 64 4f 70 28 76 2c 20 74 65 73  VdbeAddOp(v, tes
a6e0: 74 4f 70 2c 20 28 69 6e 74 29 28 28 27 6e 27 3c  tOp, (int)(('n'<
a6f0: 3c 38 29 26 30 78 30 30 30 30 46 46 30 30 29 2c  <8)&0x0000FF00),
a700: 20 62 72 6b 29 3b 0a 20 20 20 20 20 20 7d 0a 20   brk);.      }. 
a710: 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 49 64     }else if( pId
a720: 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a  x==0 ){.      /*
a730: 20 43 61 73 65 20 34 3a 20 20 54 68 65 72 65 20   Case 4:  There 
a740: 69 73 20 6e 6f 20 75 73 61 62 6c 65 20 69 6e 64  is no usable ind
a750: 65 78 2e 20 20 57 65 20 6d 75 73 74 20 64 6f 20  ex.  We must do 
a760: 61 20 63 6f 6d 70 6c 65 74 65 0a 20 20 20 20 20  a complete.     
a770: 20 2a 2a 20 20 20 20 20 20 20 20 20 20 73 63 61   **          sca
a780: 6e 20 6f 66 20 74 68 65 20 65 6e 74 69 72 65 20  n of the entire 
a790: 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 2e 0a  database table..
a7a0: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69        */.      i
a7b0: 6e 74 20 73 74 61 72 74 3b 0a 20 20 20 20 20 20  nt start;.      
a7c0: 69 6e 74 20 6f 70 52 65 77 69 6e 64 3b 0a 0a 20  int opRewind;.. 
a7d0: 20 20 20 20 20 61 73 73 65 72 74 28 20 6f 6d 69       assert( omi
a7e0: 74 54 61 62 6c 65 3d 3d 30 20 29 3b 0a 20 20 20  tTable==0 );.   
a7f0: 20 20 20 62 72 6b 20 3d 20 70 4c 65 76 65 6c 2d     brk = pLevel-
a800: 3e 62 72 6b 20 3d 20 73 71 6c 69 74 65 33 56 64  >brk = sqlite3Vd
a810: 62 65 4d 61 6b 65 4c 61 62 65 6c 28 76 29 3b 0a  beMakeLabel(v);.
a820: 20 20 20 20 20 20 63 6f 6e 74 20 3d 20 70 4c 65        cont = pLe
a830: 76 65 6c 2d 3e 63 6f 6e 74 20 3d 20 73 71 6c 69  vel->cont = sqli
a840: 74 65 33 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c  te3VdbeMakeLabel
a850: 28 76 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70  (v);.      if( p
a860: 4c 65 76 65 6c 2d 3e 62 52 65 76 20 29 7b 0a 20  Level->bRev ){. 
a870: 20 20 20 20 20 20 20 6f 70 52 65 77 69 6e 64 20         opRewind 
a880: 3d 20 4f 50 5f 4c 61 73 74 3b 0a 20 20 20 20 20  = OP_Last;.     
a890: 20 20 20 70 4c 65 76 65 6c 2d 3e 6f 70 20 3d 20     pLevel->op = 
a8a0: 4f 50 5f 50 72 65 76 3b 0a 20 20 20 20 20 20 7d  OP_Prev;.      }
a8b0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 6f 70  else{.        op
a8c0: 52 65 77 69 6e 64 20 3d 20 4f 50 5f 52 65 77 69  Rewind = OP_Rewi
a8d0: 6e 64 3b 0a 20 20 20 20 20 20 20 20 70 4c 65 76  nd;.        pLev
a8e0: 65 6c 2d 3e 6f 70 20 3d 20 4f 50 5f 4e 65 78 74  el->op = OP_Next
a8f0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
a900: 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70  sqlite3VdbeAddOp
a910: 28 76 2c 20 6f 70 52 65 77 69 6e 64 2c 20 69 43  (v, opRewind, iC
a920: 75 72 2c 20 62 72 6b 29 3b 0a 20 20 20 20 20 20  ur, brk);.      
a930: 73 74 61 72 74 20 3d 20 73 71 6c 69 74 65 33 56  start = sqlite3V
a940: 64 62 65 43 75 72 72 65 6e 74 41 64 64 72 28 76  dbeCurrentAddr(v
a950: 29 3b 0a 20 20 20 20 20 20 70 4c 65 76 65 6c 2d  );.      pLevel-
a960: 3e 70 31 20 3d 20 69 43 75 72 3b 0a 20 20 20 20  >p1 = iCur;.    
a970: 20 20 70 4c 65 76 65 6c 2d 3e 70 32 20 3d 20 73    pLevel->p2 = s
a980: 74 61 72 74 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  tart;.    }else{
a990: 0a 20 20 20 20 20 20 2f 2a 20 43 61 73 65 20 35  .      /* Case 5
a9a0: 3a 20 54 68 65 20 57 48 45 52 45 20 63 6c 61 75  : The WHERE clau
a9b0: 73 65 20 74 65 72 6d 20 74 68 61 74 20 72 65 66  se term that ref
a9c0: 65 72 73 20 74 6f 20 74 68 65 20 72 69 67 68 74  ers to the right
a9d0: 2d 6d 6f 73 74 0a 20 20 20 20 20 20 2a 2a 20 20  -most.      **  
a9e0: 20 20 20 20 20 20 20 63 6f 6c 75 6d 6e 20 6f 66         column of
a9f0: 20 74 68 65 20 69 6e 64 65 78 20 69 73 20 61 6e   the index is an
aa00: 20 69 6e 65 71 75 61 6c 69 74 79 2e 20 20 46 6f   inequality.  Fo
aa10: 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 0a 20 20  r example, if.  
aa20: 20 20 20 20 2a 2a 20 20 20 20 20 20 20 20 20 74      **         t
aa30: 68 65 20 69 6e 64 65 78 20 69 73 20 6f 6e 20 28  he index is on (
aa40: 78 2c 79 2c 7a 29 20 61 6e 64 20 74 68 65 20 57  x,y,z) and the W
aa50: 48 45 52 45 20 63 6c 61 75 73 65 20 69 73 20 6f  HERE clause is o
aa60: 66 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 20  f the.      **  
aa70: 20 20 20 20 20 20 20 66 6f 72 6d 20 22 78 3d 35         form "x=5
aa80: 20 41 4e 44 20 79 3c 31 30 22 20 74 68 65 6e 20   AND y<10" then 
aa90: 74 68 69 73 20 63 61 73 65 20 69 73 20 75 73 65  this case is use
aaa0: 64 2e 20 20 4f 6e 6c 79 20 74 68 65 0a 20 20 20  d.  Only the.   
aab0: 20 20 20 2a 2a 20 20 20 20 20 20 20 20 20 72 69     **         ri
aac0: 67 68 74 2d 6d 6f 73 74 20 63 6f 6c 75 6d 6e 20  ght-most column 
aad0: 63 61 6e 20 62 65 20 61 6e 20 69 6e 65 71 75 61  can be an inequa
aae0: 6c 69 74 79 20 2d 20 74 68 65 20 72 65 73 74 20  lity - the rest 
aaf0: 6d 75 73 74 0a 20 20 20 20 20 20 2a 2a 20 20 20  must.      **   
ab00: 20 20 20 20 20 20 75 73 65 20 74 68 65 20 22 3d        use the "=
ab10: 3d 22 20 6f 70 65 72 61 74 6f 72 2e 0a 20 20 20  =" operator..   
ab20: 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 20     **.      **  
ab30: 20 20 20 20 20 20 20 54 68 69 73 20 63 61 73 65         This case
ab40: 20 69 73 20 61 6c 73 6f 20 75 73 65 64 20 77 68   is also used wh
ab50: 65 6e 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20  en there are no 
ab60: 57 48 45 52 45 20 63 6c 61 75 73 65 0a 20 20 20  WHERE clause.   
ab70: 20 20 20 2a 2a 20 20 20 20 20 20 20 20 20 63 6f     **         co
ab80: 6e 73 74 72 61 69 6e 74 73 20 62 75 74 20 61 6e  nstraints but an
ab90: 20 69 6e 64 65 78 20 69 73 20 73 65 6c 65 63 74   index is select
aba0: 65 64 20 61 6e 79 77 61 79 2c 20 69 6e 20 6f 72  ed anyway, in or
abb0: 64 65 72 0a 20 20 20 20 20 20 2a 2a 20 20 20 20  der.      **    
abc0: 20 20 20 20 20 74 6f 20 66 6f 72 63 65 20 74 68       to force th
abd0: 65 20 6f 75 74 70 75 74 20 6f 72 64 65 72 20 74  e output order t
abe0: 6f 20 63 6f 6e 66 6f 72 6d 20 74 6f 20 61 6e 20  o conform to an 
abf0: 4f 52 44 45 52 20 42 59 2e 0a 20 20 20 20 20 20  ORDER BY..      
ac00: 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 73 63 6f  */.      int sco
ac10: 72 65 20 3d 20 70 4c 65 76 65 6c 2d 3e 73 63 6f  re = pLevel->sco
ac20: 72 65 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 45  re;.      int nE
ac30: 71 43 6f 6c 75 6d 6e 20 3d 20 73 63 6f 72 65 2f  qColumn = score/
ac40: 33 32 3b 0a 20 20 20 20 20 20 69 6e 74 20 73 74  32;.      int st
ac50: 61 72 74 3b 0a 20 20 20 20 20 20 69 6e 74 20 6c  art;.      int l
ac60: 65 46 6c 61 67 3d 30 2c 20 67 65 46 6c 61 67 3d  eFlag=0, geFlag=
ac70: 30 3b 0a 20 20 20 20 20 20 69 6e 74 20 74 65 73  0;.      int tes
ac80: 74 4f 70 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 45  tOp;..      /* E
ac90: 76 61 6c 75 61 74 65 20 74 68 65 20 65 71 75 61  valuate the equa
aca0: 6c 69 74 79 20 63 6f 6e 73 74 72 61 69 6e 74 73  lity constraints
acb0: 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20  .      */.      
acc0: 66 6f 72 28 6a 3d 30 3b 20 6a 3c 6e 45 71 43 6f  for(j=0; j<nEqCo
acd0: 6c 75 6d 6e 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20  lumn; j++){.    
ace0: 20 20 20 20 69 6e 74 20 69 49 64 78 43 6f 6c 20      int iIdxCol 
acf0: 3d 20 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e  = pIdx->aiColumn
ad00: 5b 6a 5d 3b 0a 20 20 20 20 20 20 20 20 66 6f 72  [j];.        for
ad10: 28 70 54 65 72 6d 3d 61 45 78 70 72 2c 20 6b 3d  (pTerm=aExpr, k=
ad20: 30 3b 20 6b 3c 6e 45 78 70 72 3b 20 6b 2b 2b 2c  0; k<nExpr; k++,
ad30: 20 70 54 65 72 6d 2b 2b 29 7b 0a 20 20 20 20 20   pTerm++){.     
ad40: 20 20 20 20 20 45 78 70 72 20 2a 70 58 20 3d 20       Expr *pX = 
ad50: 70 54 65 72 6d 2d 3e 70 3b 0a 20 20 20 20 20 20  pTerm->p;.      
ad60: 20 20 20 20 69 66 28 20 70 58 3d 3d 30 20 29 20      if( pX==0 ) 
ad70: 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20  continue;.      
ad80: 20 20 20 20 69 66 28 20 70 54 65 72 6d 2d 3e 69      if( pTerm->i
ad90: 64 78 4c 65 66 74 3d 3d 69 43 75 72 0a 20 20 20  dxLeft==iCur.   
ada0: 20 20 20 20 20 20 20 20 20 20 26 26 20 70 58 2d            && pX-
adb0: 3e 6f 70 3d 3d 54 4b 5f 45 51 0a 20 20 20 20 20  >op==TK_EQ.     
adc0: 20 20 20 20 20 20 20 20 26 26 20 28 70 54 65 72          && (pTer
add0: 6d 2d 3e 70 72 65 72 65 71 52 69 67 68 74 20 26  m->prereqRight &
ade0: 20 6c 6f 6f 70 4d 61 73 6b 29 3d 3d 70 54 65 72   loopMask)==pTer
adf0: 6d 2d 3e 70 72 65 72 65 71 52 69 67 68 74 20 0a  m->prereqRight .
ae00: 20 20 20 20 20 20 20 20 20 20 20 20 20 26 26 20               && 
ae10: 70 58 2d 3e 70 4c 65 66 74 2d 3e 69 43 6f 6c 75  pX->pLeft->iColu
ae20: 6d 6e 3d 3d 69 49 64 78 43 6f 6c 0a 20 20 20 20  mn==iIdxCol.    
ae30: 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20        ){.       
ae40: 20 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 72       sqlite3Expr
ae50: 43 6f 64 65 28 70 50 61 72 73 65 2c 20 70 58 2d  Code(pParse, pX-
ae60: 3e 70 52 69 67 68 74 29 3b 0a 20 20 20 20 20 20  >pRight);.      
ae70: 20 20 20 20 20 20 64 69 73 61 62 6c 65 54 65 72        disableTer
ae80: 6d 28 70 4c 65 76 65 6c 2c 20 26 70 54 65 72 6d  m(pLevel, &pTerm
ae90: 2d 3e 70 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ->p);.          
aea0: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20    break;.       
aeb0: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20     }.        }. 
aec0: 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a       }..      /*
aed0: 20 44 75 70 6c 69 63 61 74 65 20 74 68 65 20 65   Duplicate the e
aee0: 71 75 61 6c 69 74 79 20 74 65 72 6d 20 76 61 6c  quality term val
aef0: 75 65 73 20 62 65 63 61 75 73 65 20 74 68 65 79  ues because they
af00: 20 77 69 6c 6c 20 61 6c 6c 20 62 65 0a 20 20 20   will all be.   
af10: 20 20 20 2a 2a 20 75 73 65 64 20 74 77 69 63 65     ** used twice
af20: 3a 20 6f 6e 63 65 20 74 6f 20 6d 61 6b 65 20 74  : once to make t
af30: 68 65 20 74 65 72 6d 69 6e 61 74 69 6f 6e 20 6b  he termination k
af40: 65 79 20 61 6e 64 20 6f 6e 63 65 20 74 6f 20 6d  ey and once to m
af50: 61 6b 65 20 74 68 65 0a 20 20 20 20 20 20 2a 2a  ake the.      **
af60: 20 73 74 61 72 74 20 6b 65 79 2e 0a 20 20 20 20   start key..    
af70: 20 20 2a 2f 0a 20 20 20 20 20 20 66 6f 72 28 6a    */.      for(j
af80: 3d 30 3b 20 6a 3c 6e 45 71 43 6f 6c 75 6d 6e 3b  =0; j<nEqColumn;
af90: 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 73   j++){.        s
afa0: 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28  qlite3VdbeAddOp(
afb0: 76 2c 20 4f 50 5f 44 75 70 2c 20 6e 45 71 43 6f  v, OP_Dup, nEqCo
afc0: 6c 75 6d 6e 2d 31 2c 20 30 29 3b 0a 20 20 20 20  lumn-1, 0);.    
afd0: 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 4c 61    }..      /* La
afe0: 62 65 6c 73 20 66 6f 72 20 74 68 65 20 62 65 67  bels for the beg
aff0: 69 6e 6e 69 6e 67 20 61 6e 64 20 65 6e 64 20 6f  inning and end o
b000: 66 20 74 68 65 20 6c 6f 6f 70 0a 20 20 20 20 20  f the loop.     
b010: 20 2a 2f 0a 20 20 20 20 20 20 63 6f 6e 74 20 3d   */.      cont =
b020: 20 70 4c 65 76 65 6c 2d 3e 63 6f 6e 74 20 3d 20   pLevel->cont = 
b030: 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c  sqlite3VdbeMakeL
b040: 61 62 65 6c 28 76 29 3b 0a 20 20 20 20 20 20 62  abel(v);.      b
b050: 72 6b 20 3d 20 70 4c 65 76 65 6c 2d 3e 62 72 6b  rk = pLevel->brk
b060: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61   = sqlite3VdbeMa
b070: 6b 65 4c 61 62 65 6c 28 76 29 3b 0a 0a 20 20 20  keLabel(v);..   
b080: 20 20 20 2f 2a 20 47 65 6e 65 72 61 74 65 20 74     /* Generate t
b090: 68 65 20 74 65 72 6d 69 6e 61 74 69 6f 6e 20 6b  he termination k
b0a0: 65 79 2e 20 20 54 68 69 73 20 69 73 20 74 68 65  ey.  This is the
b0b0: 20 6b 65 79 20 76 61 6c 75 65 20 74 68 61 74 0a   key value that.
b0c0: 20 20 20 20 20 20 2a 2a 20 77 69 6c 6c 20 65 6e        ** will en
b0d0: 64 20 74 68 65 20 73 65 61 72 63 68 2e 20 20 54  d the search.  T
b0e0: 68 65 72 65 20 69 73 20 6e 6f 20 74 65 72 6d 69  here is no termi
b0f0: 6e 61 74 69 6f 6e 20 6b 65 79 20 69 66 20 74 68  nation key if th
b100: 65 72 65 0a 20 20 20 20 20 20 2a 2a 20 61 72 65  ere.      ** are
b110: 20 6e 6f 20 65 71 75 61 6c 69 74 79 20 74 65 72   no equality ter
b120: 6d 73 20 61 6e 64 20 6e 6f 20 22 58 3c 2e 2e 2e  ms and no "X<...
b130: 22 20 74 65 72 6d 2e 0a 20 20 20 20 20 20 2a 2a  " term..      **
b140: 0a 20 20 20 20 20 20 2a 2a 20 32 30 30 32 2d 44  .      ** 2002-D
b150: 65 63 2d 30 34 3a 20 4f 6e 20 61 20 72 65 76 65  ec-04: On a reve
b160: 72 73 65 2d 6f 72 64 65 72 20 73 63 61 6e 2c 20  rse-order scan, 
b170: 74 68 65 20 73 6f 2d 63 61 6c 6c 65 64 20 22 74  the so-called "t
b180: 65 72 6d 69 6e 61 74 69 6f 6e 22 0a 20 20 20 20  ermination".    
b190: 20 20 2a 2a 20 6b 65 79 20 63 6f 6d 70 75 74 65    ** key compute
b1a0: 64 20 68 65 72 65 20 72 65 61 6c 6c 79 20 65 6e  d here really en
b1b0: 64 73 20 75 70 20 62 65 69 6e 67 20 74 68 65 20  ds up being the 
b1c0: 73 74 61 72 74 20 6b 65 79 2e 0a 20 20 20 20 20  start key..     
b1d0: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 28 73   */.      if( (s
b1e0: 63 6f 72 65 20 26 20 34 29 21 3d 30 20 29 7b 0a  core & 4)!=0 ){.
b1f0: 20 20 20 20 20 20 20 20 66 6f 72 28 70 54 65 72          for(pTer
b200: 6d 3d 61 45 78 70 72 2c 20 6b 3d 30 3b 20 6b 3c  m=aExpr, k=0; k<
b210: 6e 45 78 70 72 3b 20 6b 2b 2b 2c 20 70 54 65 72  nExpr; k++, pTer
b220: 6d 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20  m++){.          
b230: 45 78 70 72 20 2a 70 58 20 3d 20 70 54 65 72 6d  Expr *pX = pTerm
b240: 2d 3e 70 3b 0a 20 20 20 20 20 20 20 20 20 20 69  ->p;.          i
b250: 66 28 20 70 58 3d 3d 30 20 29 20 63 6f 6e 74 69  f( pX==0 ) conti
b260: 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 20 20 69  nue;.          i
b270: 66 28 20 70 54 65 72 6d 2d 3e 69 64 78 4c 65 66  f( pTerm->idxLef
b280: 74 3d 3d 69 43 75 72 0a 20 20 20 20 20 20 20 20  t==iCur.        
b290: 20 20 20 20 20 26 26 20 28 70 58 2d 3e 6f 70 3d       && (pX->op=
b2a0: 3d 54 4b 5f 4c 54 20 7c 7c 20 70 58 2d 3e 6f 70  =TK_LT || pX->op
b2b0: 3d 3d 54 4b 5f 4c 45 29 0a 20 20 20 20 20 20 20  ==TK_LE).       
b2c0: 20 20 20 20 20 20 26 26 20 28 70 54 65 72 6d 2d        && (pTerm-
b2d0: 3e 70 72 65 72 65 71 52 69 67 68 74 20 26 20 6c  >prereqRight & l
b2e0: 6f 6f 70 4d 61 73 6b 29 3d 3d 70 54 65 72 6d 2d  oopMask)==pTerm-
b2f0: 3e 70 72 65 72 65 71 52 69 67 68 74 20 0a 20 20  >prereqRight .  
b300: 20 20 20 20 20 20 20 20 20 20 20 26 26 20 70 58             && pX
b310: 2d 3e 70 4c 65 66 74 2d 3e 69 43 6f 6c 75 6d 6e  ->pLeft->iColumn
b320: 3d 3d 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e  ==pIdx->aiColumn
b330: 5b 6a 5d 0a 20 20 20 20 20 20 20 20 20 20 29 7b  [j].          ){
b340: 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c  .            sql
b350: 69 74 65 33 45 78 70 72 43 6f 64 65 28 70 50 61  ite3ExprCode(pPa
b360: 72 73 65 2c 20 70 58 2d 3e 70 52 69 67 68 74 29  rse, pX->pRight)
b370: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 6c 65  ;.            le
b380: 46 6c 61 67 20 3d 20 70 58 2d 3e 6f 70 3d 3d 54  Flag = pX->op==T
b390: 4b 5f 4c 45 3b 0a 20 20 20 20 20 20 20 20 20 20  K_LE;.          
b3a0: 20 20 64 69 73 61 62 6c 65 54 65 72 6d 28 70 4c    disableTerm(pL
b3b0: 65 76 65 6c 2c 20 26 70 54 65 72 6d 2d 3e 70 29  evel, &pTerm->p)
b3c0: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 72  ;.            br
b3d0: 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d  eak;.          }
b3e0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
b3f0: 20 20 20 74 65 73 74 4f 70 20 3d 20 4f 50 5f 49     testOp = OP_I
b400: 64 78 47 45 3b 0a 20 20 20 20 20 20 7d 65 6c 73  dxGE;.      }els
b410: 65 7b 0a 20 20 20 20 20 20 20 20 74 65 73 74 4f  e{.        testO
b420: 70 20 3d 20 6e 45 71 43 6f 6c 75 6d 6e 3e 30 20  p = nEqColumn>0 
b430: 3f 20 4f 50 5f 49 64 78 47 45 20 3a 20 4f 50 5f  ? OP_IdxGE : OP_
b440: 4e 6f 6f 70 3b 0a 20 20 20 20 20 20 20 20 6c 65  Noop;.        le
b450: 46 6c 61 67 20 3d 20 31 3b 0a 20 20 20 20 20 20  Flag = 1;.      
b460: 7d 0a 20 20 20 20 20 20 69 66 28 20 74 65 73 74  }.      if( test
b470: 4f 70 21 3d 4f 50 5f 4e 6f 6f 70 20 29 7b 0a 20  Op!=OP_Noop ){. 
b480: 20 20 20 20 20 20 20 69 6e 74 20 6e 43 6f 6c 20         int nCol 
b490: 3d 20 6e 45 71 43 6f 6c 75 6d 6e 20 2b 20 28 28  = nEqColumn + ((
b4a0: 73 63 6f 72 65 20 26 20 34 29 21 3d 30 29 3b 0a  score & 4)!=0);.
b4b0: 20 20 20 20 20 20 20 20 70 4c 65 76 65 6c 2d 3e          pLevel->
b4c0: 69 4d 65 6d 20 3d 20 70 50 61 72 73 65 2d 3e 6e  iMem = pParse->n
b4d0: 4d 65 6d 2b 2b 3b 0a 20 20 20 20 20 20 20 20 62  Mem++;.        b
b4e0: 75 69 6c 64 49 6e 64 65 78 50 72 6f 62 65 28 76  uildIndexProbe(v
b4f0: 2c 20 6e 43 6f 6c 2c 20 62 72 6b 2c 20 70 49 64  , nCol, brk, pId
b500: 78 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20  x);.        if( 
b510: 70 4c 65 76 65 6c 2d 3e 62 52 65 76 20 29 7b 0a  pLevel->bRev ){.
b520: 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 6f 70            int op
b530: 20 3d 20 6c 65 46 6c 61 67 20 3f 20 4f 50 5f 4d   = leFlag ? OP_M
b540: 6f 76 65 4c 65 20 3a 20 4f 50 5f 4d 6f 76 65 4c  oveLe : OP_MoveL
b550: 74 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  t;.          sql
b560: 69 74 65 33 56 64 62 65 41 64 64 4f 70 28 76 2c  ite3VdbeAddOp(v,
b570: 20 6f 70 2c 20 69 49 64 78 43 75 72 2c 20 62 72   op, iIdxCur, br
b580: 6b 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73  k);.        }els
b590: 65 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  e{.          sql
b5a0: 69 74 65 33 56 64 62 65 41 64 64 4f 70 28 76 2c  ite3VdbeAddOp(v,
b5b0: 20 4f 50 5f 4d 65 6d 53 74 6f 72 65 2c 20 70 4c   OP_MemStore, pL
b5c0: 65 76 65 6c 2d 3e 69 4d 65 6d 2c 20 31 29 3b 0a  evel->iMem, 1);.
b5d0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
b5e0: 7d 65 6c 73 65 20 69 66 28 20 70 4c 65 76 65 6c  }else if( pLevel
b5f0: 2d 3e 62 52 65 76 20 29 7b 0a 20 20 20 20 20 20  ->bRev ){.      
b600: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64    sqlite3VdbeAdd
b610: 4f 70 28 76 2c 20 4f 50 5f 4c 61 73 74 2c 20 69  Op(v, OP_Last, i
b620: 49 64 78 43 75 72 2c 20 62 72 6b 29 3b 0a 20 20  IdxCur, brk);.  
b630: 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20      }..      /* 
b640: 47 65 6e 65 72 61 74 65 20 74 68 65 20 73 74 61  Generate the sta
b650: 72 74 20 6b 65 79 2e 20 20 54 68 69 73 20 69 73  rt key.  This is
b660: 20 74 68 65 20 6b 65 79 20 74 68 61 74 20 64 65   the key that de
b670: 66 69 6e 65 73 20 74 68 65 20 6c 6f 77 65 72 0a  fines the lower.
b680: 20 20 20 20 20 20 2a 2a 20 62 6f 75 6e 64 20 6f        ** bound o
b690: 6e 20 74 68 65 20 73 65 61 72 63 68 2e 20 20 54  n the search.  T
b6a0: 68 65 72 65 20 69 73 20 6e 6f 20 73 74 61 72 74  here is no start
b6b0: 20 6b 65 79 20 69 66 20 74 68 65 72 65 20 61 72   key if there ar
b6c0: 65 20 6e 6f 0a 20 20 20 20 20 20 2a 2a 20 65 71  e no.      ** eq
b6d0: 75 61 6c 69 74 79 20 74 65 72 6d 73 20 61 6e 64  uality terms and
b6e0: 20 69 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20   if there is no 
b6f0: 22 58 3e 2e 2e 2e 22 20 74 65 72 6d 2e 20 20 49  "X>..." term.  I
b700: 6e 0a 20 20 20 20 20 20 2a 2a 20 74 68 61 74 20  n.      ** that 
b710: 63 61 73 65 2c 20 67 65 6e 65 72 61 74 65 20 61  case, generate a
b720: 20 22 52 65 77 69 6e 64 22 20 69 6e 73 74 72 75   "Rewind" instru
b730: 63 74 69 6f 6e 20 69 6e 20 70 6c 61 63 65 20 6f  ction in place o
b740: 66 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 73  f the.      ** s
b750: 74 61 72 74 20 6b 65 79 20 73 65 61 72 63 68 2e  tart key search.
b760: 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20  .      **.      
b770: 2a 2a 20 32 30 30 32 2d 44 65 63 2d 30 34 3a 20  ** 2002-Dec-04: 
b780: 49 6e 20 74 68 65 20 63 61 73 65 20 6f 66 20 61  In the case of a
b790: 20 72 65 76 65 72 73 65 2d 6f 72 64 65 72 20 73   reverse-order s
b7a0: 65 61 72 63 68 2c 20 74 68 65 20 73 6f 2d 63 61  earch, the so-ca
b7b0: 6c 6c 65 64 0a 20 20 20 20 20 20 2a 2a 20 22 73  lled.      ** "s
b7c0: 74 61 72 74 22 20 6b 65 79 20 72 65 61 6c 6c 79  tart" key really
b7d0: 20 65 6e 64 73 20 75 70 20 62 65 69 6e 67 20 75   ends up being u
b7e0: 73 65 64 20 61 73 20 74 68 65 20 74 65 72 6d 69  sed as the termi
b7f0: 6e 61 74 69 6f 6e 20 6b 65 79 2e 0a 20 20 20 20  nation key..    
b800: 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 28    */.      if( (
b810: 73 63 6f 72 65 20 26 20 38 29 21 3d 30 20 29 7b  score & 8)!=0 ){
b820: 0a 20 20 20 20 20 20 20 20 66 6f 72 28 70 54 65  .        for(pTe
b830: 72 6d 3d 61 45 78 70 72 2c 20 6b 3d 30 3b 20 6b  rm=aExpr, k=0; k
b840: 3c 6e 45 78 70 72 3b 20 6b 2b 2b 2c 20 70 54 65  <nExpr; k++, pTe
b850: 72 6d 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20  rm++){.         
b860: 20 45 78 70 72 20 2a 70 58 20 3d 20 70 54 65 72   Expr *pX = pTer
b870: 6d 2d 3e 70 3b 0a 20 20 20 20 20 20 20 20 20 20  m->p;.          
b880: 69 66 28 20 70 58 3d 3d 30 20 29 20 63 6f 6e 74  if( pX==0 ) cont
b890: 69 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 20 20  inue;.          
b8a0: 69 66 28 20 70 54 65 72 6d 2d 3e 69 64 78 4c 65  if( pTerm->idxLe
b8b0: 66 74 3d 3d 69 43 75 72 0a 20 20 20 20 20 20 20  ft==iCur.       
b8c0: 20 20 20 20 20 20 26 26 20 28 70 58 2d 3e 6f 70        && (pX->op
b8d0: 3d 3d 54 4b 5f 47 54 20 7c 7c 20 70 58 2d 3e 6f  ==TK_GT || pX->o
b8e0: 70 3d 3d 54 4b 5f 47 45 29 0a 20 20 20 20 20 20  p==TK_GE).      
b8f0: 20 20 20 20 20 20 20 26 26 20 28 70 54 65 72 6d         && (pTerm
b900: 2d 3e 70 72 65 72 65 71 52 69 67 68 74 20 26 20  ->prereqRight & 
b910: 6c 6f 6f 70 4d 61 73 6b 29 3d 3d 70 54 65 72 6d  loopMask)==pTerm
b920: 2d 3e 70 72 65 72 65 71 52 69 67 68 74 20 0a 20  ->prereqRight . 
b930: 20 20 20 20 20 20 20 20 20 20 20 20 26 26 20 70              && p
b940: 58 2d 3e 70 4c 65 66 74 2d 3e 69 43 6f 6c 75 6d  X->pLeft->iColum
b950: 6e 3d 3d 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d  n==pIdx->aiColum
b960: 6e 5b 6a 5d 0a 20 20 20 20 20 20 20 20 20 20 29  n[j].          )
b970: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71  {.            sq
b980: 6c 69 74 65 33 45 78 70 72 43 6f 64 65 28 70 50  lite3ExprCode(pP
b990: 61 72 73 65 2c 20 70 58 2d 3e 70 52 69 67 68 74  arse, pX->pRight
b9a0: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 67  );.            g
b9b0: 65 46 6c 61 67 20 3d 20 70 58 2d 3e 6f 70 3d 3d  eFlag = pX->op==
b9c0: 54 4b 5f 47 45 3b 0a 20 20 20 20 20 20 20 20 20  TK_GE;.         
b9d0: 20 20 20 64 69 73 61 62 6c 65 54 65 72 6d 28 70     disableTerm(p
b9e0: 4c 65 76 65 6c 2c 20 26 70 54 65 72 6d 2d 3e 70  Level, &pTerm->p
b9f0: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 62  );.            b
ba00: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20  reak;.          
ba10: 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  }.        }.    
ba20: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
ba30: 20 67 65 46 6c 61 67 20 3d 20 31 3b 0a 20 20 20   geFlag = 1;.   
ba40: 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 6e     }.      if( n
ba50: 45 71 43 6f 6c 75 6d 6e 3e 30 20 7c 7c 20 28 73  EqColumn>0 || (s
ba60: 63 6f 72 65 26 38 29 21 3d 30 20 29 7b 0a 20 20  core&8)!=0 ){.  
ba70: 20 20 20 20 20 20 69 6e 74 20 6e 43 6f 6c 20 3d        int nCol =
ba80: 20 6e 45 71 43 6f 6c 75 6d 6e 20 2b 20 28 28 73   nEqColumn + ((s
ba90: 63 6f 72 65 26 38 29 21 3d 30 29 3b 0a 20 20 20  core&8)!=0);.   
baa0: 20 20 20 20 20 62 75 69 6c 64 49 6e 64 65 78 50       buildIndexP
bab0: 72 6f 62 65 28 76 2c 20 6e 43 6f 6c 2c 20 62 72  robe(v, nCol, br
bac0: 6b 2c 20 70 49 64 78 29 3b 0a 20 20 20 20 20 20  k, pIdx);.      
bad0: 20 20 69 66 28 20 70 4c 65 76 65 6c 2d 3e 62 52    if( pLevel->bR
bae0: 65 76 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  ev ){.          
baf0: 70 4c 65 76 65 6c 2d 3e 69 4d 65 6d 20 3d 20 70  pLevel->iMem = p
bb00: 50 61 72 73 65 2d 3e 6e 4d 65 6d 2b 2b 3b 0a 20  Parse->nMem++;. 
bb10: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
bb20: 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f  VdbeAddOp(v, OP_
bb30: 4d 65 6d 53 74 6f 72 65 2c 20 70 4c 65 76 65 6c  MemStore, pLevel
bb40: 2d 3e 69 4d 65 6d 2c 20 31 29 3b 0a 20 20 20 20  ->iMem, 1);.    
bb50: 20 20 20 20 20 20 74 65 73 74 4f 70 20 3d 20 4f        testOp = O
bb60: 50 5f 49 64 78 4c 54 3b 0a 20 20 20 20 20 20 20  P_IdxLT;.       
bb70: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
bb80: 20 20 69 6e 74 20 6f 70 20 3d 20 67 65 46 6c 61    int op = geFla
bb90: 67 20 3f 20 4f 50 5f 4d 6f 76 65 47 65 20 3a 20  g ? OP_MoveGe : 
bba0: 4f 50 5f 4d 6f 76 65 47 74 3b 0a 20 20 20 20 20  OP_MoveGt;.     
bbb0: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
bbc0: 41 64 64 4f 70 28 76 2c 20 6f 70 2c 20 69 49 64  AddOp(v, op, iId
bbd0: 78 43 75 72 2c 20 62 72 6b 29 3b 0a 20 20 20 20  xCur, brk);.    
bbe0: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73      }.      }els
bbf0: 65 20 69 66 28 20 70 4c 65 76 65 6c 2d 3e 62 52  e if( pLevel->bR
bc00: 65 76 20 29 7b 0a 20 20 20 20 20 20 20 20 74 65  ev ){.        te
bc10: 73 74 4f 70 20 3d 20 4f 50 5f 4e 6f 6f 70 3b 0a  stOp = OP_Noop;.
bc20: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
bc30: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
bc40: 41 64 64 4f 70 28 76 2c 20 4f 50 5f 52 65 77 69  AddOp(v, OP_Rewi
bc50: 6e 64 2c 20 69 49 64 78 43 75 72 2c 20 62 72 6b  nd, iIdxCur, brk
bc60: 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20  );.      }..    
bc70: 20 20 2f 2a 20 47 65 6e 65 72 61 74 65 20 74 68    /* Generate th
bc80: 65 20 74 68 65 20 74 6f 70 20 6f 66 20 74 68 65  e the top of the
bc90: 20 6c 6f 6f 70 2e 20 20 49 66 20 74 68 65 72 65   loop.  If there
bca0: 20 69 73 20 61 20 74 65 72 6d 69 6e 61 74 69 6f   is a terminatio
bcb0: 6e 0a 20 20 20 20 20 20 2a 2a 20 6b 65 79 20 77  n.      ** key w
bcc0: 65 20 68 61 76 65 20 74 6f 20 74 65 73 74 20 66  e have to test f
bcd0: 6f 72 20 74 68 61 74 20 6b 65 79 20 61 6e 64 20  or that key and 
bce0: 61 62 6f 72 74 20 61 74 20 74 68 65 20 74 6f 70  abort at the top
bcf0: 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 2a 2a   of the.      **
bd00: 20 6c 6f 6f 70 2e 0a 20 20 20 20 20 20 2a 2f 0a   loop..      */.
bd10: 20 20 20 20 20 20 73 74 61 72 74 20 3d 20 73 71        start = sq
bd20: 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 6e 74  lite3VdbeCurrent
bd30: 41 64 64 72 28 76 29 3b 0a 20 20 20 20 20 20 69  Addr(v);.      i
bd40: 66 28 20 74 65 73 74 4f 70 21 3d 4f 50 5f 4e 6f  f( testOp!=OP_No
bd50: 6f 70 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71  op ){.        sq
bd60: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28 76  lite3VdbeAddOp(v
bd70: 2c 20 4f 50 5f 4d 65 6d 4c 6f 61 64 2c 20 70 4c  , OP_MemLoad, pL
bd80: 65 76 65 6c 2d 3e 69 4d 65 6d 2c 20 30 29 3b 0a  evel->iMem, 0);.
bd90: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56          sqlite3V
bda0: 64 62 65 41 64 64 4f 70 28 76 2c 20 74 65 73 74  dbeAddOp(v, test
bdb0: 4f 70 2c 20 69 49 64 78 43 75 72 2c 20 62 72 6b  Op, iIdxCur, brk
bdc0: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 28  );.        if( (
bdd0: 6c 65 46 6c 61 67 20 26 26 20 21 70 4c 65 76 65  leFlag && !pLeve
bde0: 6c 2d 3e 62 52 65 76 29 20 7c 7c 20 28 21 67 65  l->bRev) || (!ge
bdf0: 46 6c 61 67 20 26 26 20 70 4c 65 76 65 6c 2d 3e  Flag && pLevel->
be00: 62 52 65 76 29 20 29 7b 0a 20 20 20 20 20 20 20  bRev) ){.       
be10: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 43 68     sqlite3VdbeCh
be20: 61 6e 67 65 50 33 28 76 2c 20 2d 31 2c 20 22 2b  angeP3(v, -1, "+
be30: 22 2c 20 50 33 5f 53 54 41 54 49 43 29 3b 0a 20  ", P3_STATIC);. 
be40: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d         }.      }
be50: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
be60: 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f 52 6f  beAddOp(v, OP_Ro
be70: 77 4b 65 79 2c 20 69 49 64 78 43 75 72 2c 20 30  wKey, iIdxCur, 0
be80: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
be90: 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f  VdbeAddOp(v, OP_
bea0: 49 64 78 49 73 4e 75 6c 6c 2c 20 6e 45 71 43 6f  IdxIsNull, nEqCo
beb0: 6c 75 6d 6e 20 2b 20 28 28 73 63 6f 72 65 26 34  lumn + ((score&4
bec0: 29 21 3d 30 29 2c 20 63 6f 6e 74 29 3b 0a 20 20  )!=0), cont);.  
bed0: 20 20 20 20 69 66 28 20 21 6f 6d 69 74 54 61 62      if( !omitTab
bee0: 6c 65 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71  le ){.        sq
bef0: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28 76  lite3VdbeAddOp(v
bf00: 2c 20 4f 50 5f 49 64 78 52 65 63 6e 6f 2c 20 69  , OP_IdxRecno, i
bf10: 49 64 78 43 75 72 2c 20 30 29 3b 0a 20 20 20 20  IdxCur, 0);.    
bf20: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41      sqlite3VdbeA
bf30: 64 64 4f 70 28 76 2c 20 4f 50 5f 4d 6f 76 65 47  ddOp(v, OP_MoveG
bf40: 65 2c 20 69 43 75 72 2c 20 30 29 3b 0a 20 20 20  e, iCur, 0);.   
bf50: 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 52     }..      /* R
bf60: 65 63 6f 72 64 20 74 68 65 20 69 6e 73 74 72 75  ecord the instru
bf70: 63 74 69 6f 6e 20 75 73 65 64 20 74 6f 20 74 65  ction used to te
bf80: 72 6d 69 6e 61 74 65 20 74 68 65 20 6c 6f 6f 70  rminate the loop
bf90: 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20  ..      */.     
bfa0: 20 70 4c 65 76 65 6c 2d 3e 6f 70 20 3d 20 70 4c   pLevel->op = pL
bfb0: 65 76 65 6c 2d 3e 62 52 65 76 20 3f 20 4f 50 5f  evel->bRev ? OP_
bfc0: 50 72 65 76 20 3a 20 4f 50 5f 4e 65 78 74 3b 0a  Prev : OP_Next;.
bfd0: 20 20 20 20 20 20 70 4c 65 76 65 6c 2d 3e 70 31        pLevel->p1
bfe0: 20 3d 20 69 49 64 78 43 75 72 3b 0a 20 20 20 20   = iIdxCur;.    
bff0: 20 20 70 4c 65 76 65 6c 2d 3e 70 32 20 3d 20 73    pLevel->p2 = s
c000: 74 61 72 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20  tart;.    }.    
c010: 6c 6f 6f 70 4d 61 73 6b 20 7c 3d 20 67 65 74 4d  loopMask |= getM
c020: 61 73 6b 28 26 6d 61 73 6b 53 65 74 2c 20 69 43  ask(&maskSet, iC
c030: 75 72 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 6e 73  ur);..    /* Ins
c040: 65 72 74 20 63 6f 64 65 20 74 6f 20 74 65 73 74  ert code to test
c050: 20 65 76 65 72 79 20 73 75 62 65 78 70 72 65 73   every subexpres
c060: 73 69 6f 6e 20 74 68 61 74 20 63 61 6e 20 62 65  sion that can be
c070: 20 63 6f 6d 70 6c 65 74 65 6c 79 0a 20 20 20 20   completely.    
c080: 2a 2a 20 63 6f 6d 70 75 74 65 64 20 75 73 69 6e  ** computed usin
c090: 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 65  g the current se
c0a0: 74 20 6f 66 20 74 61 62 6c 65 73 2e 0a 20 20 20  t of tables..   
c0b0: 20 2a 2f 0a 20 20 20 20 66 6f 72 28 70 54 65 72   */.    for(pTer
c0c0: 6d 3d 61 45 78 70 72 2c 20 6a 3d 30 3b 20 6a 3c  m=aExpr, j=0; j<
c0d0: 6e 45 78 70 72 3b 20 6a 2b 2b 2c 20 70 54 65 72  nExpr; j++, pTer
c0e0: 6d 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20  m++){.      if( 
c0f0: 70 54 65 72 6d 2d 3e 70 3d 3d 30 20 29 20 63 6f  pTerm->p==0 ) co
c100: 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 69 66  ntinue;.      if
c110: 28 20 28 70 54 65 72 6d 2d 3e 70 72 65 72 65 71  ( (pTerm->prereq
c120: 41 6c 6c 20 26 20 6c 6f 6f 70 4d 61 73 6b 29 21  All & loopMask)!
c130: 3d 70 54 65 72 6d 2d 3e 70 72 65 72 65 71 41 6c  =pTerm->prereqAl
c140: 6c 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20  l ) continue;.  
c150: 20 20 20 20 69 66 28 20 70 4c 65 76 65 6c 2d 3e      if( pLevel->
c160: 69 4c 65 66 74 4a 6f 69 6e 20 26 26 20 21 45 78  iLeftJoin && !Ex
c170: 70 72 48 61 73 50 72 6f 70 65 72 74 79 28 70 54  prHasProperty(pT
c180: 65 72 6d 2d 3e 70 2c 45 50 5f 46 72 6f 6d 4a 6f  erm->p,EP_FromJo
c190: 69 6e 29 20 29 7b 0a 20 20 20 20 20 20 20 20 63  in) ){.        c
c1a0: 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 7d  ontinue;.      }
c1b0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 78  .      sqlite3Ex
c1c0: 70 72 49 66 46 61 6c 73 65 28 70 50 61 72 73 65  prIfFalse(pParse
c1d0: 2c 20 70 54 65 72 6d 2d 3e 70 2c 20 63 6f 6e 74  , pTerm->p, cont
c1e0: 2c 20 31 29 3b 0a 20 20 20 20 20 20 70 54 65 72  , 1);.      pTer
c1f0: 6d 2d 3e 70 20 3d 20 30 3b 0a 20 20 20 20 7d 0a  m->p = 0;.    }.
c200: 20 20 20 20 62 72 6b 20 3d 20 63 6f 6e 74 3b 0a      brk = cont;.
c210: 0a 20 20 20 20 2f 2a 20 46 6f 72 20 61 20 4c 45  .    /* For a LE
c220: 46 54 20 4f 55 54 45 52 20 4a 4f 49 4e 2c 20 67  FT OUTER JOIN, g
c230: 65 6e 65 72 61 74 65 20 63 6f 64 65 20 74 68 61  enerate code tha
c240: 74 20 77 69 6c 6c 20 72 65 63 6f 72 64 20 74 68  t will record th
c250: 65 20 66 61 63 74 20 74 68 61 74 0a 20 20 20 20  e fact that.    
c260: 2a 2a 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 20  ** at least one 
c270: 72 6f 77 20 6f 66 20 74 68 65 20 72 69 67 68 74  row of the right
c280: 20 74 61 62 6c 65 20 68 61 73 20 6d 61 74 63 68   table has match
c290: 65 64 20 74 68 65 20 6c 65 66 74 20 74 61 62 6c  ed the left tabl
c2a0: 65 2e 20 20 0a 20 20 20 20 2a 2f 0a 20 20 20 20  e.  .    */.    
c2b0: 69 66 28 20 70 4c 65 76 65 6c 2d 3e 69 4c 65 66  if( pLevel->iLef
c2c0: 74 4a 6f 69 6e 20 29 7b 0a 20 20 20 20 20 20 70  tJoin ){.      p
c2d0: 4c 65 76 65 6c 2d 3e 74 6f 70 20 3d 20 73 71 6c  Level->top = sql
c2e0: 69 74 65 33 56 64 62 65 43 75 72 72 65 6e 74 41  ite3VdbeCurrentA
c2f0: 64 64 72 28 76 29 3b 0a 20 20 20 20 20 20 73 71  ddr(v);.      sq
c300: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28 76  lite3VdbeAddOp(v
c310: 2c 20 4f 50 5f 49 6e 74 65 67 65 72 2c 20 31 2c  , OP_Integer, 1,
c320: 20 30 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74   0);.      sqlit
c330: 65 33 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f  e3VdbeAddOp(v, O
c340: 50 5f 4d 65 6d 53 74 6f 72 65 2c 20 70 4c 65 76  P_MemStore, pLev
c350: 65 6c 2d 3e 69 4c 65 66 74 4a 6f 69 6e 2c 20 31  el->iLeftJoin, 1
c360: 29 3b 0a 20 20 20 20 20 20 56 64 62 65 43 6f 6d  );.      VdbeCom
c370: 6d 65 6e 74 28 28 76 2c 20 22 23 20 72 65 63 6f  ment((v, "# reco
c380: 72 64 20 4c 45 46 54 20 4a 4f 49 4e 20 68 69 74  rd LEFT JOIN hit
c390: 22 29 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 70  "));.      for(p
c3a0: 54 65 72 6d 3d 61 45 78 70 72 2c 20 6a 3d 30 3b  Term=aExpr, j=0;
c3b0: 20 6a 3c 6e 45 78 70 72 3b 20 6a 2b 2b 2c 20 70   j<nExpr; j++, p
c3c0: 54 65 72 6d 2b 2b 29 7b 0a 20 20 20 20 20 20 20  Term++){.       
c3d0: 20 69 66 28 20 70 54 65 72 6d 2d 3e 70 3d 3d 30   if( pTerm->p==0
c3e0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20   ) continue;.   
c3f0: 20 20 20 20 20 69 66 28 20 28 70 54 65 72 6d 2d       if( (pTerm-
c400: 3e 70 72 65 72 65 71 41 6c 6c 20 26 20 6c 6f 6f  >prereqAll & loo
c410: 70 4d 61 73 6b 29 21 3d 70 54 65 72 6d 2d 3e 70  pMask)!=pTerm->p
c420: 72 65 72 65 71 41 6c 6c 20 29 20 63 6f 6e 74 69  rereqAll ) conti
c430: 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 73 71 6c  nue;.        sql
c440: 69 74 65 33 45 78 70 72 49 66 46 61 6c 73 65 28  ite3ExprIfFalse(
c450: 70 50 61 72 73 65 2c 20 70 54 65 72 6d 2d 3e 70  pParse, pTerm->p
c460: 2c 20 63 6f 6e 74 2c 20 31 29 3b 0a 20 20 20 20  , cont, 1);.    
c470: 20 20 20 20 70 54 65 72 6d 2d 3e 70 20 3d 20 30      pTerm->p = 0
c480: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
c490: 20 20 7d 0a 20 20 70 57 49 6e 66 6f 2d 3e 69 43    }.  pWInfo->iC
c4a0: 6f 6e 74 69 6e 75 65 20 3d 20 63 6f 6e 74 3b 0a  ontinue = cont;.
c4b0: 20 20 66 72 65 65 4d 61 73 6b 53 65 74 28 26 6d    freeMaskSet(&m
c4c0: 61 73 6b 53 65 74 29 3b 0a 20 20 72 65 74 75 72  askSet);.  retur
c4d0: 6e 20 70 57 49 6e 66 6f 3b 0a 7d 0a 0a 2f 2a 0a  n pWInfo;.}../*.
c4e0: 2a 2a 20 47 65 6e 65 72 61 74 65 20 74 68 65 20  ** Generate the 
c4f0: 65 6e 64 20 6f 66 20 74 68 65 20 57 48 45 52 45  end of the WHERE
c500: 20 6c 6f 6f 70 2e 20 20 53 65 65 20 63 6f 6d 6d   loop.  See comm
c510: 65 6e 74 73 20 6f 6e 20 0a 2a 2a 20 73 71 6c 69  ents on .** sqli
c520: 74 65 33 57 68 65 72 65 42 65 67 69 6e 28 29 20  te3WhereBegin() 
c530: 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69  for additional i
c540: 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 76  nformation..*/.v
c550: 6f 69 64 20 73 71 6c 69 74 65 33 57 68 65 72 65  oid sqlite3Where
c560: 45 6e 64 28 57 68 65 72 65 49 6e 66 6f 20 2a 70  End(WhereInfo *p
c570: 57 49 6e 66 6f 29 7b 0a 20 20 56 64 62 65 20 2a  WInfo){.  Vdbe *
c580: 76 20 3d 20 70 57 49 6e 66 6f 2d 3e 70 50 61 72  v = pWInfo->pPar
c590: 73 65 2d 3e 70 56 64 62 65 3b 0a 20 20 69 6e 74  se->pVdbe;.  int
c5a0: 20 69 3b 0a 20 20 57 68 65 72 65 4c 65 76 65 6c   i;.  WhereLevel
c5b0: 20 2a 70 4c 65 76 65 6c 3b 0a 20 20 53 72 63 4c   *pLevel;.  SrcL
c5c0: 69 73 74 20 2a 70 54 61 62 4c 69 73 74 20 3d 20  ist *pTabList = 
c5d0: 70 57 49 6e 66 6f 2d 3e 70 54 61 62 4c 69 73 74  pWInfo->pTabList
c5e0: 3b 0a 20 20 73 74 72 75 63 74 20 53 72 63 4c 69  ;.  struct SrcLi
c5f0: 73 74 5f 69 74 65 6d 20 2a 70 54 61 62 49 74 65  st_item *pTabIte
c600: 6d 3b 0a 0a 20 20 2f 2a 20 47 65 6e 65 72 61 74  m;..  /* Generat
c610: 65 20 6c 6f 6f 70 20 74 65 72 6d 69 6e 61 74 69  e loop terminati
c620: 6f 6e 20 63 6f 64 65 2e 0a 20 20 2a 2f 0a 20 20  on code..  */.  
c630: 66 6f 72 28 69 3d 70 54 61 62 4c 69 73 74 2d 3e  for(i=pTabList->
c640: 6e 53 72 63 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d  nSrc-1; i>=0; i-
c650: 2d 29 7b 0a 20 20 20 20 70 4c 65 76 65 6c 20 3d  -){.    pLevel =
c660: 20 26 70 57 49 6e 66 6f 2d 3e 61 5b 69 5d 3b 0a   &pWInfo->a[i];.
c670: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 52      sqlite3VdbeR
c680: 65 73 6f 6c 76 65 4c 61 62 65 6c 28 76 2c 20 70  esolveLabel(v, p
c690: 4c 65 76 65 6c 2d 3e 63 6f 6e 74 29 3b 0a 20 20  Level->cont);.  
c6a0: 20 20 69 66 28 20 70 4c 65 76 65 6c 2d 3e 6f 70    if( pLevel->op
c6b0: 21 3d 4f 50 5f 4e 6f 6f 70 20 29 7b 0a 20 20 20  !=OP_Noop ){.   
c6c0: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64     sqlite3VdbeAd
c6d0: 64 4f 70 28 76 2c 20 70 4c 65 76 65 6c 2d 3e 6f  dOp(v, pLevel->o
c6e0: 70 2c 20 70 4c 65 76 65 6c 2d 3e 70 31 2c 20 70  p, pLevel->p1, p
c6f0: 4c 65 76 65 6c 2d 3e 70 32 29 3b 0a 20 20 20 20  Level->p2);.    
c700: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  }.    sqlite3Vdb
c710: 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c 28 76 2c  eResolveLabel(v,
c720: 20 70 4c 65 76 65 6c 2d 3e 62 72 6b 29 3b 0a 20   pLevel->brk);. 
c730: 20 20 20 69 66 28 20 70 4c 65 76 65 6c 2d 3e 69     if( pLevel->i
c740: 6e 4f 70 21 3d 4f 50 5f 4e 6f 6f 70 20 29 7b 0a  nOp!=OP_Noop ){.
c750: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
c760: 65 41 64 64 4f 70 28 76 2c 20 70 4c 65 76 65 6c  eAddOp(v, pLevel
c770: 2d 3e 69 6e 4f 70 2c 20 70 4c 65 76 65 6c 2d 3e  ->inOp, pLevel->
c780: 69 6e 50 31 2c 20 70 4c 65 76 65 6c 2d 3e 69 6e  inP1, pLevel->in
c790: 50 32 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69  P2);.    }.    i
c7a0: 66 28 20 70 4c 65 76 65 6c 2d 3e 69 4c 65 66 74  f( pLevel->iLeft
c7b0: 4a 6f 69 6e 20 29 7b 0a 20 20 20 20 20 20 69 6e  Join ){.      in
c7c0: 74 20 61 64 64 72 3b 0a 20 20 20 20 20 20 61 64  t addr;.      ad
c7d0: 64 72 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  dr = sqlite3Vdbe
c7e0: 41 64 64 4f 70 28 76 2c 20 4f 50 5f 4d 65 6d 4c  AddOp(v, OP_MemL
c7f0: 6f 61 64 2c 20 70 4c 65 76 65 6c 2d 3e 69 4c 65  oad, pLevel->iLe
c800: 66 74 4a 6f 69 6e 2c 20 30 29 3b 0a 20 20 20 20  ftJoin, 0);.    
c810: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64    sqlite3VdbeAdd
c820: 4f 70 28 76 2c 20 4f 50 5f 4e 6f 74 4e 75 6c 6c  Op(v, OP_NotNull
c830: 2c 20 31 2c 20 61 64 64 72 2b 34 20 2b 20 28 70  , 1, addr+4 + (p
c840: 4c 65 76 65 6c 2d 3e 69 49 64 78 43 75 72 3e 3d  Level->iIdxCur>=
c850: 30 29 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  0));.      sqlit
c860: 65 33 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f  e3VdbeAddOp(v, O
c870: 50 5f 4e 75 6c 6c 52 6f 77 2c 20 70 54 61 62 4c  P_NullRow, pTabL
c880: 69 73 74 2d 3e 61 5b 69 5d 2e 69 43 75 72 73 6f  ist->a[i].iCurso
c890: 72 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28  r, 0);.      if(
c8a0: 20 70 4c 65 76 65 6c 2d 3e 69 49 64 78 43 75 72   pLevel->iIdxCur
c8b0: 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 73  >=0 ){.        s
c8c0: 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28  qlite3VdbeAddOp(
c8d0: 76 2c 20 4f 50 5f 4e 75 6c 6c 52 6f 77 2c 20 70  v, OP_NullRow, p
c8e0: 4c 65 76 65 6c 2d 3e 69 49 64 78 43 75 72 2c 20  Level->iIdxCur, 
c8f0: 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  0);.      }.    
c900: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64    sqlite3VdbeAdd
c910: 4f 70 28 76 2c 20 4f 50 5f 47 6f 74 6f 2c 20 30  Op(v, OP_Goto, 0
c920: 2c 20 70 4c 65 76 65 6c 2d 3e 74 6f 70 29 3b 0a  , pLevel->top);.
c930: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20      }.  }..  /* 
c940: 54 68 65 20 22 62 72 65 61 6b 22 20 70 6f 69 6e  The "break" poin
c950: 74 20 69 73 20 68 65 72 65 2c 20 6a 75 73 74 20  t is here, just 
c960: 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20  past the end of 
c970: 74 68 65 20 6f 75 74 65 72 20 6c 6f 6f 70 2e 0a  the outer loop..
c980: 20 20 2a 2a 20 53 65 74 20 69 74 2e 0a 20 20 2a    ** Set it..  *
c990: 2f 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 52  /.  sqlite3VdbeR
c9a0: 65 73 6f 6c 76 65 4c 61 62 65 6c 28 76 2c 20 70  esolveLabel(v, p
c9b0: 57 49 6e 66 6f 2d 3e 69 42 72 65 61 6b 29 3b 0a  WInfo->iBreak);.
c9c0: 0a 20 20 2f 2a 20 43 6c 6f 73 65 20 61 6c 6c 20  .  /* Close all 
c9d0: 6f 66 20 74 68 65 20 63 75 72 73 6f 72 73 20 74  of the cursors t
c9e0: 68 61 74 20 77 65 72 65 20 6f 70 65 6e 64 20 62  hat were opend b
c9f0: 79 20 73 71 6c 69 74 65 33 57 68 65 72 65 42 65  y sqlite3WhereBe
ca00: 67 69 6e 2e 0a 20 20 2a 2f 0a 20 20 70 4c 65 76  gin..  */.  pLev
ca10: 65 6c 20 3d 20 70 57 49 6e 66 6f 2d 3e 61 3b 0a  el = pWInfo->a;.
ca20: 20 20 70 54 61 62 49 74 65 6d 20 3d 20 70 54 61    pTabItem = pTa
ca30: 62 4c 69 73 74 2d 3e 61 3b 0a 20 20 66 6f 72 28  bList->a;.  for(
ca40: 69 3d 30 3b 20 69 3c 70 54 61 62 4c 69 73 74 2d  i=0; i<pTabList-
ca50: 3e 6e 53 72 63 3b 20 69 2b 2b 2c 20 70 54 61 62  >nSrc; i++, pTab
ca60: 49 74 65 6d 2b 2b 2c 20 70 4c 65 76 65 6c 2b 2b  Item++, pLevel++
ca70: 29 7b 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54  ){.    Table *pT
ca80: 61 62 20 3d 20 70 54 61 62 49 74 65 6d 2d 3e 70  ab = pTabItem->p
ca90: 54 61 62 3b 0a 20 20 20 20 61 73 73 65 72 74 28  Tab;.    assert(
caa0: 20 70 54 61 62 21 3d 30 20 29 3b 0a 20 20 20 20   pTab!=0 );.    
cab0: 69 66 28 20 70 54 61 62 2d 3e 69 73 54 72 61 6e  if( pTab->isTran
cac0: 73 69 65 6e 74 20 7c 7c 20 70 54 61 62 2d 3e 70  sient || pTab->p
cad0: 53 65 6c 65 63 74 20 29 20 63 6f 6e 74 69 6e 75  Select ) continu
cae0: 65 3b 0a 20 20 20 20 69 66 28 20 28 70 4c 65 76  e;.    if( (pLev
caf0: 65 6c 2d 3e 73 63 6f 72 65 20 26 20 31 29 3d 3d  el->score & 1)==
cb00: 30 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  0 ){.      sqlit
cb10: 65 33 56 64 62 65 41 64 64 4f 70 28 76 2c 20 4f  e3VdbeAddOp(v, O
cb20: 50 5f 43 6c 6f 73 65 2c 20 70 54 61 62 49 74 65  P_Close, pTabIte
cb30: 6d 2d 3e 69 43 75 72 73 6f 72 2c 20 30 29 3b 0a  m->iCursor, 0);.
cb40: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 4c      }.    if( pL
cb50: 65 76 65 6c 2d 3e 70 49 64 78 21 3d 30 20 29 7b  evel->pIdx!=0 ){
cb60: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
cb70: 62 65 41 64 64 4f 70 28 76 2c 20 4f 50 5f 43 6c  beAddOp(v, OP_Cl
cb80: 6f 73 65 2c 20 70 4c 65 76 65 6c 2d 3e 69 49 64  ose, pLevel->iId
cb90: 78 43 75 72 2c 20 30 29 3b 0a 20 20 20 20 7d 0a  xCur, 0);.    }.
cba0: 0a 20 20 20 20 2f 2a 20 4d 61 6b 65 20 63 75 72  .    /* Make cur
cbb0: 73 6f 72 20 73 75 62 73 74 69 74 75 74 69 6f 6e  sor substitution
cbc0: 73 20 66 6f 72 20 63 61 73 65 73 20 77 68 65 72  s for cases wher
cbd0: 65 20 77 65 20 77 61 6e 74 20 74 6f 20 75 73 65  e we want to use
cbe0: 0a 20 20 20 20 2a 2a 20 6a 75 73 74 20 74 68 65  .    ** just the
cbf0: 20 69 6e 64 65 78 20 61 6e 64 20 6e 65 76 65 72   index and never
cc00: 20 72 65 66 65 72 65 6e 63 65 20 74 68 65 20 74   reference the t
cc10: 61 62 6c 65 2e 0a 20 20 20 20 2a 2a 20 0a 20 20  able..    ** .  
cc20: 20 20 2a 2a 20 43 61 6c 6c 73 20 74 6f 20 74 68    ** Calls to th
cc30: 65 20 63 6f 64 65 20 67 65 6e 65 72 61 74 6f 72  e code generator
cc40: 20 69 6e 20 62 65 74 77 65 65 6e 20 73 71 6c 69   in between sqli
cc50: 74 65 33 57 68 65 72 65 42 65 67 69 6e 20 61 6e  te3WhereBegin an
cc60: 64 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33  d.    ** sqlite3
cc70: 57 68 65 72 65 45 6e 64 20 77 69 6c 6c 20 68 61  WhereEnd will ha
cc80: 76 65 20 63 72 65 61 74 65 64 20 63 6f 64 65 20  ve created code 
cc90: 74 68 61 74 20 72 65 66 65 72 65 6e 63 65 73 20  that references 
cca0: 74 68 65 20 74 61 62 6c 65 0a 20 20 20 20 2a 2a  the table.    **
ccb0: 20 64 69 72 65 63 74 6c 79 2e 20 20 54 68 69 73   directly.  This
ccc0: 20 6c 6f 6f 70 20 73 63 61 6e 73 20 61 6c 6c 20   loop scans all 
ccd0: 74 68 61 74 20 63 6f 64 65 20 6c 6f 6f 6b 69 6e  that code lookin
cce0: 67 20 66 6f 72 20 6f 70 63 6f 64 65 73 0a 20 20  g for opcodes.  
ccf0: 20 20 2a 2a 20 74 68 61 74 20 72 65 66 65 72 65    ** that refere
cd00: 6e 63 65 20 74 68 65 20 74 61 62 6c 65 20 61 6e  nce the table an
cd10: 64 20 63 6f 6e 76 65 72 74 73 20 74 68 65 6d 20  d converts them 
cd20: 69 6e 74 6f 20 6f 70 63 6f 64 65 73 20 74 68 61  into opcodes tha
cd30: 74 0a 20 20 20 20 2a 2a 20 72 65 66 65 72 65 6e  t.    ** referen
cd40: 63 65 20 74 68 65 20 69 6e 64 65 78 2e 0a 20 20  ce the index..  
cd50: 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 4c 65    */.    if( pLe
cd60: 76 65 6c 2d 3e 73 63 6f 72 65 20 26 20 31 20 29  vel->score & 1 )
cd70: 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 2c 20 6a  {.      int i, j
cd80: 2c 20 6c 61 73 74 3b 0a 20 20 20 20 20 20 56 64  , last;.      Vd
cd90: 62 65 4f 70 20 2a 70 4f 70 3b 0a 20 20 20 20 20  beOp *pOp;.     
cda0: 20 49 6e 64 65 78 20 2a 70 49 64 78 20 3d 20 70   Index *pIdx = p
cdb0: 4c 65 76 65 6c 2d 3e 70 49 64 78 3b 0a 0a 20 20  Level->pIdx;..  
cdc0: 20 20 20 20 61 73 73 65 72 74 28 20 70 49 64 78      assert( pIdx
cdd0: 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 70 4f 70  !=0 );.      pOp
cde0: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 47 65   = sqlite3VdbeGe
cdf0: 74 4f 70 28 76 2c 20 70 57 49 6e 66 6f 2d 3e 69  tOp(v, pWInfo->i
ce00: 54 6f 70 29 3b 0a 20 20 20 20 20 20 6c 61 73 74  Top);.      last
ce10: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 43 75   = sqlite3VdbeCu
ce20: 72 72 65 6e 74 41 64 64 72 28 76 29 3b 0a 20 20  rrentAddr(v);.  
ce30: 20 20 20 20 66 6f 72 28 69 3d 70 57 49 6e 66 6f      for(i=pWInfo
ce40: 2d 3e 69 54 6f 70 3b 20 69 3c 6c 61 73 74 3b 20  ->iTop; i<last; 
ce50: 69 2b 2b 2c 20 70 4f 70 2b 2b 29 7b 0a 20 20 20  i++, pOp++){.   
ce60: 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 31       if( pOp->p1
ce70: 21 3d 70 4c 65 76 65 6c 2d 3e 69 54 61 62 43 75  !=pLevel->iTabCu
ce80: 72 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20  r ) continue;.  
ce90: 20 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 6f        if( pOp->o
cea0: 70 63 6f 64 65 3d 3d 4f 50 5f 43 6f 6c 75 6d 6e  pcode==OP_Column
ceb0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 70 4f   ){.          pO
cec0: 70 2d 3e 70 31 20 3d 20 70 4c 65 76 65 6c 2d 3e  p->p1 = pLevel->
ced0: 69 49 64 78 43 75 72 3b 0a 20 20 20 20 20 20 20  iIdxCur;.       
cee0: 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 70 49     for(j=0; j<pI
cef0: 64 78 2d 3e 6e 43 6f 6c 75 6d 6e 3b 20 6a 2b 2b  dx->nColumn; j++
cf00: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69  ){.            i
cf10: 66 28 20 70 4f 70 2d 3e 70 32 3d 3d 70 49 64 78  f( pOp->p2==pIdx
cf20: 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 6a 5d 20 29 7b  ->aiColumn[j] ){
cf30: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70  .              p
cf40: 4f 70 2d 3e 70 32 20 3d 20 6a 3b 0a 20 20 20 20  Op->p2 = j;.    
cf50: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
cf60: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20  .            }. 
cf70: 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20           }.     
cf80: 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 4f 70     }else if( pOp
cf90: 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 52 65 63  ->opcode==OP_Rec
cfa0: 6e 6f 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  no ){.          
cfb0: 70 4f 70 2d 3e 70 31 20 3d 20 70 4c 65 76 65 6c  pOp->p1 = pLevel
cfc0: 2d 3e 69 49 64 78 43 75 72 3b 0a 20 20 20 20 20  ->iIdxCur;.     
cfd0: 20 20 20 20 20 70 4f 70 2d 3e 6f 70 63 6f 64 65       pOp->opcode
cfe0: 20 3d 20 4f 50 5f 49 64 78 52 65 63 6e 6f 3b 0a   = OP_IdxRecno;.
cff0: 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66          }else if
d000: 28 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f  ( pOp->opcode==O
d010: 50 5f 4e 75 6c 6c 52 6f 77 20 29 7b 0a 20 20 20  P_NullRow ){.   
d020: 20 20 20 20 20 20 20 70 4f 70 2d 3e 6f 70 63 6f         pOp->opco
d030: 64 65 20 3d 20 4f 50 5f 4e 6f 6f 70 3b 0a 20 20  de = OP_Noop;.  
d040: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a        }.      }.
d050: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20      }.  }..  /* 
d060: 46 69 6e 61 6c 20 63 6c 65 61 6e 75 70 0a 20 20  Final cleanup.  
d070: 2a 2f 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  */.  sqliteFree(
d080: 70 57 49 6e 66 6f 29 3b 0a 20 20 72 65 74 75 72  pWInfo);.  retur
d090: 6e 3b 0a 7d 0a                                   n;.}.