/ Hex Artifact Content
Login

Artifact 4abb7c0f8f19b7d7d82f4558d5da1a30fdf9ea38:


0000: 2f 2a 0a 2a 2a 20 32 30 31 31 20 4a 75 6c 79 20  /*.** 2011 July 
0010: 39 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  9.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
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: 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63 6f  .** This file co
0180: 6e 74 61 69 6e 73 20 63 6f 64 65 20 66 6f 72 20  ntains code for 
0190: 74 68 65 20 56 64 62 65 53 6f 72 74 65 72 20 6f  the VdbeSorter o
01a0: 62 6a 65 63 74 2c 20 75 73 65 64 20 69 6e 20 63  bject, used in c
01b0: 6f 6e 63 65 72 74 20 77 69 74 68 0a 2a 2a 20 61  oncert with.** a
01c0: 20 56 64 62 65 43 75 72 73 6f 72 20 74 6f 20 73   VdbeCursor to s
01d0: 6f 72 74 20 6c 61 72 67 65 20 6e 75 6d 62 65 72  ort large number
01e0: 73 20 6f 66 20 6b 65 79 73 20 28 61 73 20 6d 61  s of keys (as ma
01f0: 79 20 62 65 20 72 65 71 75 69 72 65 64 2c 20 66  y be required, f
0200: 6f 72 0a 2a 2a 20 65 78 61 6d 70 6c 65 2c 20 62  or.** example, b
0210: 79 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 73  y CREATE INDEX s
0220: 74 61 74 65 6d 65 6e 74 73 20 6f 6e 20 74 61 62  tatements on tab
0230: 6c 65 73 20 74 6f 6f 20 6c 61 72 67 65 20 74 6f  les too large to
0240: 20 66 69 74 20 69 6e 20 6d 61 69 6e 0a 2a 2a 20   fit in main.** 
0250: 6d 65 6d 6f 72 79 29 2e 0a 2a 2f 0a 0a 23 69 6e  memory)..*/..#in
0260: 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e 74  clude "sqliteInt
0270: 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 76 64  .h".#include "vd
0280: 62 65 49 6e 74 2e 68 22 0a 0a 0a 74 79 70 65 64  beInt.h"...typed
0290: 65 66 20 73 74 72 75 63 74 20 56 64 62 65 53 6f  ef struct VdbeSo
02a0: 72 74 65 72 49 74 65 72 20 56 64 62 65 53 6f 72  rterIter VdbeSor
02b0: 74 65 72 49 74 65 72 3b 0a 74 79 70 65 64 65 66  terIter;.typedef
02c0: 20 73 74 72 75 63 74 20 53 6f 72 74 65 72 52 65   struct SorterRe
02d0: 63 6f 72 64 20 53 6f 72 74 65 72 52 65 63 6f 72  cord SorterRecor
02e0: 64 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63  d;.typedef struc
02f0: 74 20 46 69 6c 65 57 72 69 74 65 72 20 46 69 6c  t FileWriter Fil
0300: 65 57 72 69 74 65 72 3b 0a 0a 2f 2a 0a 2a 2a 20  eWriter;../*.** 
0310: 4e 4f 54 45 53 20 4f 4e 20 44 41 54 41 20 53 54  NOTES ON DATA ST
0320: 52 55 43 54 55 52 45 20 55 53 45 44 20 46 4f 52  RUCTURE USED FOR
0330: 20 4e 2d 57 41 59 20 4d 45 52 47 45 53 3a 0a 2a   N-WAY MERGES:.*
0340: 2a 0a 2a 2a 20 41 73 20 6b 65 79 73 20 61 72 65  *.** As keys are
0350: 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 73 6f   added to the so
0360: 72 74 65 72 2c 20 74 68 65 79 20 61 72 65 20 77  rter, they are w
0370: 72 69 74 74 65 6e 20 74 6f 20 64 69 73 6b 20 69  ritten to disk i
0380: 6e 20 61 20 73 65 72 69 65 73 0a 2a 2a 20 6f 66  n a series.** of
0390: 20 73 6f 72 74 65 64 20 70 61 63 6b 65 64 2d 6d   sorted packed-m
03a0: 65 6d 6f 72 79 2d 61 72 72 61 79 73 20 28 50 4d  emory-arrays (PM
03b0: 41 73 29 2e 20 54 68 65 20 73 69 7a 65 20 6f 66  As). The size of
03c0: 20 65 61 63 68 20 50 4d 41 20 69 73 20 72 6f 75   each PMA is rou
03d0: 67 68 6c 79 0a 2a 2a 20 74 68 65 20 73 61 6d 65  ghly.** the same
03e0: 20 61 73 20 74 68 65 20 63 61 63 68 65 2d 73 69   as the cache-si
03f0: 7a 65 20 61 6c 6c 6f 77 65 64 20 66 6f 72 20 74  ze allowed for t
0400: 65 6d 70 6f 72 61 72 79 20 64 61 74 61 62 61 73  emporary databas
0410: 65 73 2e 20 49 6e 20 6f 72 64 65 72 0a 2a 2a 20  es. In order.** 
0420: 74 6f 20 61 6c 6c 6f 77 20 74 68 65 20 63 61 6c  to allow the cal
0430: 6c 65 72 20 74 6f 20 65 78 74 72 61 63 74 20 6b  ler to extract k
0440: 65 79 73 20 66 72 6f 6d 20 74 68 65 20 73 6f 72  eys from the sor
0450: 74 65 72 20 69 6e 20 73 6f 72 74 65 64 20 6f 72  ter in sorted or
0460: 64 65 72 2c 0a 2a 2a 20 61 6c 6c 20 50 4d 41 73  der,.** all PMAs
0470: 20 63 75 72 72 65 6e 74 6c 79 20 73 74 6f 72 65   currently store
0480: 64 20 6f 6e 20 64 69 73 6b 20 6d 75 73 74 20 62  d on disk must b
0490: 65 20 6d 65 72 67 65 64 20 74 6f 67 65 74 68 65  e merged togethe
04a0: 72 2e 20 54 68 69 73 20 63 6f 6d 6d 65 6e 74 0a  r. This comment.
04b0: 2a 2a 20 64 65 73 63 72 69 62 65 73 20 74 68 65  ** describes the
04c0: 20 64 61 74 61 20 73 74 72 75 63 74 75 72 65 20   data structure 
04d0: 75 73 65 64 20 74 6f 20 64 6f 20 73 6f 2e 20 54  used to do so. T
04e0: 68 65 20 73 74 72 75 63 74 75 72 65 20 73 75 70  he structure sup
04f0: 70 6f 72 74 73 20 0a 2a 2a 20 6d 65 72 67 69 6e  ports .** mergin
0500: 67 20 61 6e 79 20 6e 75 6d 62 65 72 20 6f 66 20  g any number of 
0510: 61 72 72 61 79 73 20 69 6e 20 61 20 73 69 6e 67  arrays in a sing
0520: 6c 65 20 70 61 73 73 20 77 69 74 68 20 6e 6f 20  le pass with no 
0530: 72 65 64 75 6e 64 61 6e 74 20 63 6f 6d 70 61 72  redundant compar
0540: 69 73 6f 6e 20 0a 2a 2a 20 6f 70 65 72 61 74 69  ison .** operati
0550: 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61  ons..**.** The a
0560: 49 74 65 72 5b 5d 20 61 72 72 61 79 20 63 6f 6e  Iter[] array con
0570: 74 61 69 6e 73 20 61 6e 20 69 74 65 72 61 74 6f  tains an iterato
0580: 72 20 66 6f 72 20 65 61 63 68 20 6f 66 20 74 68  r for each of th
0590: 65 20 50 4d 41 73 20 62 65 69 6e 67 20 6d 65 72  e PMAs being mer
05a0: 67 65 64 2e 0a 2a 2a 20 41 6e 20 61 49 74 65 72  ged..** An aIter
05b0: 5b 5d 20 69 74 65 72 61 74 6f 72 20 65 69 74 68  [] iterator eith
05c0: 65 72 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 76  er points to a v
05d0: 61 6c 69 64 20 6b 65 79 20 6f 72 20 65 6c 73 65  alid key or else
05e0: 20 69 73 20 61 74 20 45 4f 46 2e 20 46 6f 72 20   is at EOF. For 
05f0: 0a 2a 2a 20 74 68 65 20 70 75 72 70 6f 73 65 73  .** the purposes
0600: 20 6f 66 20 74 68 65 20 70 61 72 61 67 72 61 70   of the paragrap
0610: 68 73 20 62 65 6c 6f 77 2c 20 77 65 20 61 73 73  hs below, we ass
0620: 75 6d 65 20 74 68 61 74 20 74 68 65 20 61 72 72  ume that the arr
0630: 61 79 20 69 73 20 61 63 74 75 61 6c 6c 79 20 0a  ay is actually .
0640: 2a 2a 20 4e 20 65 6c 65 6d 65 6e 74 73 20 69 6e  ** N elements in
0650: 20 73 69 7a 65 2c 20 77 68 65 72 65 20 4e 20 69   size, where N i
0660: 73 20 74 68 65 20 73 6d 61 6c 6c 65 73 74 20 70  s the smallest p
0670: 6f 77 65 72 20 6f 66 20 32 20 67 72 65 61 74 65  ower of 2 greate
0680: 72 20 74 6f 20 6f 72 20 65 71 75 61 6c 20 0a 2a  r to or equal .*
0690: 2a 20 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20  * to the number 
06a0: 6f 66 20 69 74 65 72 61 74 6f 72 73 20 62 65 69  of iterators bei
06b0: 6e 67 20 6d 65 72 67 65 64 2e 20 54 68 65 20 65  ng merged. The e
06c0: 78 74 72 61 20 61 49 74 65 72 5b 5d 20 65 6c 65  xtra aIter[] ele
06d0: 6d 65 6e 74 73 20 61 72 65 20 0a 2a 2a 20 74 72  ments are .** tr
06e0: 65 61 74 65 64 20 61 73 20 69 66 20 74 68 65 79  eated as if they
06f0: 20 61 72 65 20 65 6d 70 74 79 20 28 61 6c 77 61   are empty (alwa
0700: 79 73 20 61 74 20 45 4f 46 29 2e 0a 2a 2a 0a 2a  ys at EOF)..**.*
0710: 2a 20 54 68 65 20 61 54 72 65 65 5b 5d 20 61 72  * The aTree[] ar
0720: 72 61 79 20 69 73 20 61 6c 73 6f 20 4e 20 65 6c  ray is also N el
0730: 65 6d 65 6e 74 73 20 69 6e 20 73 69 7a 65 2e 20  ements in size. 
0740: 54 68 65 20 76 61 6c 75 65 20 6f 66 20 4e 20 69  The value of N i
0750: 73 20 73 74 6f 72 65 64 20 69 6e 0a 2a 2a 20 74  s stored in.** t
0760: 68 65 20 56 64 62 65 53 6f 72 74 65 72 2e 6e 54  he VdbeSorter.nT
0770: 72 65 65 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2a  ree variable..**
0780: 0a 2a 2a 20 54 68 65 20 66 69 6e 61 6c 20 28 4e  .** The final (N
0790: 2f 32 29 20 65 6c 65 6d 65 6e 74 73 20 6f 66 20  /2) elements of 
07a0: 61 54 72 65 65 5b 5d 20 63 6f 6e 74 61 69 6e 20  aTree[] contain 
07b0: 74 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 63  the results of c
07c0: 6f 6d 70 61 72 69 6e 67 0a 2a 2a 20 70 61 69 72  omparing.** pair
07d0: 73 20 6f 66 20 69 74 65 72 61 74 6f 72 20 6b 65  s of iterator ke
07e0: 79 73 20 74 6f 67 65 74 68 65 72 2e 20 45 6c 65  ys together. Ele
07f0: 6d 65 6e 74 20 69 20 63 6f 6e 74 61 69 6e 73 20  ment i contains 
0800: 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 0a 2a  the result of .*
0810: 2a 20 63 6f 6d 70 61 72 69 6e 67 20 61 49 74 65  * comparing aIte
0820: 72 5b 32 2a 69 2d 4e 5d 20 61 6e 64 20 61 49 74  r[2*i-N] and aIt
0830: 65 72 5b 32 2a 69 2d 4e 2b 31 5d 2e 20 57 68 69  er[2*i-N+1]. Whi
0840: 63 68 65 76 65 72 20 6b 65 79 20 69 73 20 73 6d  chever key is sm
0850: 61 6c 6c 65 72 2c 20 74 68 65 0a 2a 2a 20 61 54  aller, the.** aT
0860: 72 65 65 20 65 6c 65 6d 65 6e 74 20 69 73 20 73  ree element is s
0870: 65 74 20 74 6f 20 74 68 65 20 69 6e 64 65 78 20  et to the index 
0880: 6f 66 20 69 74 2e 20 0a 2a 2a 0a 2a 2a 20 46 6f  of it. .**.** Fo
0890: 72 20 74 68 65 20 70 75 72 70 6f 73 65 73 20 6f  r the purposes o
08a0: 66 20 74 68 69 73 20 63 6f 6d 70 61 72 69 73 6f  f this compariso
08b0: 6e 2c 20 45 4f 46 20 69 73 20 63 6f 6e 73 69 64  n, EOF is consid
08c0: 65 72 65 64 20 67 72 65 61 74 65 72 20 74 68 61  ered greater tha
08d0: 6e 20 61 6e 79 0a 2a 2a 20 6f 74 68 65 72 20 6b  n any.** other k
08e0: 65 79 20 76 61 6c 75 65 2e 20 49 66 20 74 68 65  ey value. If the
08f0: 20 6b 65 79 73 20 61 72 65 20 65 71 75 61 6c 20   keys are equal 
0900: 28 6f 6e 6c 79 20 70 6f 73 73 69 62 6c 65 20 77  (only possible w
0910: 69 74 68 20 74 77 6f 20 45 4f 46 0a 2a 2a 20 76  ith two EOF.** v
0920: 61 6c 75 65 73 29 2c 20 69 74 20 64 6f 65 73 6e  alues), it doesn
0930: 27 74 20 6d 61 74 74 65 72 20 77 68 69 63 68 20  't matter which 
0940: 69 6e 64 65 78 20 69 73 20 73 74 6f 72 65 64 2e  index is stored.
0950: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 28 4e 2f 34 29  .**.** The (N/4)
0960: 20 65 6c 65 6d 65 6e 74 73 20 6f 66 20 61 54 72   elements of aTr
0970: 65 65 5b 5d 20 74 68 61 74 20 70 72 65 63 65 64  ee[] that preced
0980: 65 20 74 68 65 20 66 69 6e 61 6c 20 28 4e 2f 32  e the final (N/2
0990: 29 20 64 65 73 63 72 69 62 65 64 20 0a 2a 2a 20  ) described .** 
09a0: 61 62 6f 76 65 20 63 6f 6e 74 61 69 6e 73 20 74  above contains t
09b0: 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68 65 20  he index of the 
09c0: 73 6d 61 6c 6c 65 73 74 20 6f 66 20 65 61 63 68  smallest of each
09d0: 20 62 6c 6f 63 6b 20 6f 66 20 34 20 69 74 65 72   block of 4 iter
09e0: 61 74 6f 72 73 2e 0a 2a 2a 20 41 6e 64 20 73 6f  ators..** And so
09f0: 20 6f 6e 2e 20 53 6f 20 74 68 61 74 20 61 54 72   on. So that aTr
0a00: 65 65 5b 31 5d 20 63 6f 6e 74 61 69 6e 73 20 74  ee[1] contains t
0a10: 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68 65 20  he index of the 
0a20: 69 74 65 72 61 74 6f 72 20 74 68 61 74 20 0a 2a  iterator that .*
0a30: 2a 20 63 75 72 72 65 6e 74 6c 79 20 70 6f 69 6e  * currently poin
0a40: 74 73 20 74 6f 20 74 68 65 20 73 6d 61 6c 6c 65  ts to the smalle
0a50: 73 74 20 6b 65 79 20 76 61 6c 75 65 2e 20 61 54  st key value. aT
0a60: 72 65 65 5b 30 5d 20 69 73 20 75 6e 75 73 65 64  ree[0] is unused
0a70: 2e 0a 2a 2a 0a 2a 2a 20 45 78 61 6d 70 6c 65 3a  ..**.** Example:
0a80: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 49 74 65 72  .**.**     aIter
0a90: 5b 30 5d 20 2d 3e 20 42 61 6e 61 6e 61 0a 2a 2a  [0] -> Banana.**
0aa0: 20 20 20 20 20 61 49 74 65 72 5b 31 5d 20 2d 3e       aIter[1] ->
0ab0: 20 46 65 69 6a 6f 61 0a 2a 2a 20 20 20 20 20 61   Feijoa.**     a
0ac0: 49 74 65 72 5b 32 5d 20 2d 3e 20 45 6c 64 65 72  Iter[2] -> Elder
0ad0: 62 65 72 72 79 0a 2a 2a 20 20 20 20 20 61 49 74  berry.**     aIt
0ae0: 65 72 5b 33 5d 20 2d 3e 20 43 75 72 72 61 6e 74  er[3] -> Currant
0af0: 0a 2a 2a 20 20 20 20 20 61 49 74 65 72 5b 34 5d  .**     aIter[4]
0b00: 20 2d 3e 20 47 72 61 70 65 66 72 75 69 74 0a 2a   -> Grapefruit.*
0b10: 2a 20 20 20 20 20 61 49 74 65 72 5b 35 5d 20 2d  *     aIter[5] -
0b20: 3e 20 41 70 70 6c 65 0a 2a 2a 20 20 20 20 20 61  > Apple.**     a
0b30: 49 74 65 72 5b 36 5d 20 2d 3e 20 44 75 72 69 61  Iter[6] -> Duria
0b40: 6e 0a 2a 2a 20 20 20 20 20 61 49 74 65 72 5b 37  n.**     aIter[7
0b50: 5d 20 2d 3e 20 45 4f 46 0a 2a 2a 0a 2a 2a 20 20  ] -> EOF.**.**  
0b60: 20 20 20 61 54 72 65 65 5b 5d 20 3d 20 7b 20 58     aTree[] = { X
0b70: 2c 20 35 20 20 20 30 2c 20 35 20 20 20 20 30 2c  , 5   0, 5    0,
0b80: 20 33 2c 20 35 2c 20 36 20 7d 0a 2a 2a 0a 2a 2a   3, 5, 6 }.**.**
0b90: 20 54 68 65 20 63 75 72 72 65 6e 74 20 65 6c 65   The current ele
0ba0: 6d 65 6e 74 20 69 73 20 22 41 70 70 6c 65 22 20  ment is "Apple" 
0bb0: 28 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68  (the value of th
0bc0: 65 20 6b 65 79 20 69 6e 64 69 63 61 74 65 64 20  e key indicated 
0bd0: 62 79 20 0a 2a 2a 20 69 74 65 72 61 74 6f 72 20  by .** iterator 
0be0: 35 29 2e 20 57 68 65 6e 20 74 68 65 20 4e 65 78  5). When the Nex
0bf0: 74 28 29 20 6f 70 65 72 61 74 69 6f 6e 20 69 73  t() operation is
0c00: 20 69 6e 76 6f 6b 65 64 2c 20 69 74 65 72 61 74   invoked, iterat
0c10: 6f 72 20 35 20 77 69 6c 6c 0a 2a 2a 20 62 65 20  or 5 will.** be 
0c20: 61 64 76 61 6e 63 65 64 20 74 6f 20 74 68 65 20  advanced to the 
0c30: 6e 65 78 74 20 6b 65 79 20 69 6e 20 69 74 73 20  next key in its 
0c40: 73 65 67 6d 65 6e 74 2e 20 53 61 79 20 74 68 65  segment. Say the
0c50: 20 6e 65 78 74 20 6b 65 79 20 69 73 0a 2a 2a 20   next key is.** 
0c60: 22 45 67 67 70 6c 61 6e 74 22 3a 0a 2a 2a 0a 2a  "Eggplant":.**.*
0c70: 2a 20 20 20 20 20 61 49 74 65 72 5b 35 5d 20 2d  *     aIter[5] -
0c80: 3e 20 45 67 67 70 6c 61 6e 74 0a 2a 2a 0a 2a 2a  > Eggplant.**.**
0c90: 20 54 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66   The contents of
0ca0: 20 61 54 72 65 65 5b 5d 20 61 72 65 20 75 70 64   aTree[] are upd
0cb0: 61 74 65 64 20 66 69 72 73 74 20 62 79 20 63 6f  ated first by co
0cc0: 6d 70 61 72 69 6e 67 20 74 68 65 20 6e 65 77 20  mparing the new 
0cd0: 69 74 65 72 61 74 6f 72 0a 2a 2a 20 35 20 6b 65  iterator.** 5 ke
0ce0: 79 20 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74  y to the current
0cf0: 20 6b 65 79 20 6f 66 20 69 74 65 72 61 74 6f 72   key of iterator
0d00: 20 34 20 28 73 74 69 6c 6c 20 22 47 72 61 70 65   4 (still "Grape
0d10: 66 72 75 69 74 22 29 2e 20 54 68 65 20 69 74 65  fruit"). The ite
0d20: 72 61 74 6f 72 0a 2a 2a 20 35 20 76 61 6c 75 65  rator.** 5 value
0d30: 20 69 73 20 73 74 69 6c 6c 20 73 6d 61 6c 6c 65   is still smalle
0d40: 72 2c 20 73 6f 20 61 54 72 65 65 5b 36 5d 20 69  r, so aTree[6] i
0d50: 73 20 73 65 74 20 74 6f 20 35 2e 20 41 6e 64 20  s set to 5. And 
0d60: 73 6f 20 6f 6e 20 75 70 20 74 68 65 20 74 72 65  so on up the tre
0d70: 65 2e 0a 2a 2a 20 54 68 65 20 76 61 6c 75 65 20  e..** The value 
0d80: 6f 66 20 69 74 65 72 61 74 6f 72 20 36 20 2d 20  of iterator 6 - 
0d90: 22 44 75 72 69 61 6e 22 20 2d 20 69 73 20 6e 6f  "Durian" - is no
0da0: 77 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e 20 74  w smaller than t
0db0: 68 61 74 20 6f 66 20 69 74 65 72 61 74 6f 72 0a  hat of iterator.
0dc0: 2a 2a 20 35 2c 20 73 6f 20 61 54 72 65 65 5b 33  ** 5, so aTree[3
0dd0: 5d 20 69 73 20 73 65 74 20 74 6f 20 36 2e 20 4b  ] is set to 6. K
0de0: 65 79 20 30 20 69 73 20 73 6d 61 6c 6c 65 72 20  ey 0 is smaller 
0df0: 74 68 61 6e 20 6b 65 79 20 36 20 28 42 61 6e 61  than key 6 (Bana
0e00: 6e 61 3c 44 75 72 69 61 6e 29 2c 0a 2a 2a 20 73  na<Durian),.** s
0e10: 6f 20 74 68 65 20 76 61 6c 75 65 20 77 72 69 74  o the value writ
0e20: 74 65 6e 20 69 6e 74 6f 20 65 6c 65 6d 65 6e 74  ten into element
0e30: 20 31 20 6f 66 20 74 68 65 20 61 72 72 61 79 20   1 of the array 
0e40: 69 73 20 30 2e 20 41 73 20 66 6f 6c 6c 6f 77 73  is 0. As follows
0e50: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 54 72 65  :.**.**     aTre
0e60: 65 5b 5d 20 3d 20 7b 20 58 2c 20 30 20 20 20 30  e[] = { X, 0   0
0e70: 2c 20 36 20 20 20 20 30 2c 20 33 2c 20 35 2c 20  , 6    0, 3, 5, 
0e80: 36 20 7d 0a 2a 2a 0a 2a 2a 20 49 6e 20 6f 74 68  6 }.**.** In oth
0e90: 65 72 20 77 6f 72 64 73 2c 20 65 61 63 68 20 74  er words, each t
0ea0: 69 6d 65 20 77 65 20 61 64 76 61 6e 63 65 20 74  ime we advance t
0eb0: 6f 20 74 68 65 20 6e 65 78 74 20 73 6f 72 74 65  o the next sorte
0ec0: 72 20 65 6c 65 6d 65 6e 74 2c 20 6c 6f 67 32 28  r element, log2(
0ed0: 4e 29 0a 2a 2a 20 6b 65 79 20 63 6f 6d 70 61 72  N).** key compar
0ee0: 69 73 6f 6e 20 6f 70 65 72 61 74 69 6f 6e 73 20  ison operations 
0ef0: 61 72 65 20 72 65 71 75 69 72 65 64 2c 20 77 68  are required, wh
0f00: 65 72 65 20 4e 20 69 73 20 74 68 65 20 6e 75 6d  ere N is the num
0f10: 62 65 72 20 6f 66 20 73 65 67 6d 65 6e 74 73 0a  ber of segments.
0f20: 2a 2a 20 62 65 69 6e 67 20 6d 65 72 67 65 64 20  ** being merged 
0f30: 28 72 6f 75 6e 64 65 64 20 75 70 20 74 6f 20 74  (rounded up to t
0f40: 68 65 20 6e 65 78 74 20 70 6f 77 65 72 20 6f 66  he next power of
0f50: 20 32 29 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 56   2)..*/.struct V
0f60: 64 62 65 53 6f 72 74 65 72 20 7b 0a 20 20 69 36  dbeSorter {.  i6
0f70: 34 20 69 57 72 69 74 65 4f 66 66 3b 20 20 20 20  4 iWriteOff;    
0f80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
0f90: 20 43 75 72 72 65 6e 74 20 77 72 69 74 65 20 6f   Current write o
0fa0: 66 66 73 65 74 20 77 69 74 68 69 6e 20 66 69 6c  ffset within fil
0fb0: 65 20 70 54 65 6d 70 31 20 2a 2f 0a 20 20 69 36  e pTemp1 */.  i6
0fc0: 34 20 69 52 65 61 64 4f 66 66 3b 20 20 20 20 20  4 iReadOff;     
0fd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
0fe0: 20 43 75 72 72 65 6e 74 20 72 65 61 64 20 6f 66   Current read of
0ff0: 66 73 65 74 20 77 69 74 68 69 6e 20 66 69 6c 65  fset within file
1000: 20 70 54 65 6d 70 31 20 2a 2f 0a 20 20 69 6e 74   pTemp1 */.  int
1010: 20 6e 49 6e 4d 65 6d 6f 72 79 3b 20 20 20 20 20   nInMemory;     
1020: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1030: 43 75 72 72 65 6e 74 20 73 69 7a 65 20 6f 66 20  Current size of 
1040: 70 52 65 63 6f 72 64 20 6c 69 73 74 20 61 73 20  pRecord list as 
1050: 50 4d 41 20 2a 2f 0a 20 20 69 6e 74 20 6e 54 72  PMA */.  int nTr
1060: 65 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ee;             
1070: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 64           /* Used
1080: 20 73 69 7a 65 20 6f 66 20 61 54 72 65 65 2f 61   size of aTree/a
1090: 49 74 65 72 20 28 70 6f 77 65 72 20 6f 66 20 32  Iter (power of 2
10a0: 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 4d 41 3b  ) */.  int nPMA;
10b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
10c0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
10d0: 20 6f 66 20 50 4d 41 73 20 73 74 6f 72 65 64 20   of PMAs stored 
10e0: 69 6e 20 70 54 65 6d 70 31 20 2a 2f 0a 20 20 69  in pTemp1 */.  i
10f0: 6e 74 20 6d 6e 50 6d 61 53 69 7a 65 3b 20 20 20  nt mnPmaSize;   
1100: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1110: 2a 20 4d 69 6e 69 6d 75 6d 20 50 4d 41 20 73 69  * Minimum PMA si
1120: 7a 65 2c 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a  ze, in bytes */.
1130: 20 20 69 6e 74 20 6d 78 50 6d 61 53 69 7a 65 3b    int mxPmaSize;
1140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1150: 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 50 4d 41    /* Maximum PMA
1160: 20 73 69 7a 65 2c 20 69 6e 20 62 79 74 65 73 2e   size, in bytes.
1170: 20 20 30 3d 3d 6e 6f 20 6c 69 6d 69 74 20 2a 2f    0==no limit */
1180: 0a 20 20 56 64 62 65 53 6f 72 74 65 72 49 74 65  .  VdbeSorterIte
1190: 72 20 2a 61 49 74 65 72 3b 20 20 20 20 20 20 20  r *aIter;       
11a0: 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 69     /* Array of i
11b0: 74 65 72 61 74 6f 72 73 20 74 6f 20 6d 65 72 67  terators to merg
11c0: 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 61 54 72 65  e */.  int *aTre
11d0: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
11e0: 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e         /* Curren
11f0: 74 20 73 74 61 74 65 20 6f 66 20 69 6e 63 72 65  t state of incre
1200: 6d 65 6e 74 61 6c 20 6d 65 72 67 65 20 2a 2f 0a  mental merge */.
1210: 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a    sqlite3_file *
1220: 70 54 65 6d 70 31 3b 20 20 20 20 20 20 20 20 20  pTemp1;         
1230: 20 20 2f 2a 20 50 4d 41 20 66 69 6c 65 20 31 20    /* PMA file 1 
1240: 2a 2f 0a 20 20 53 6f 72 74 65 72 52 65 63 6f 72  */.  SorterRecor
1250: 64 20 2a 70 52 65 63 6f 72 64 3b 20 20 20 20 20  d *pRecord;     
1260: 20 20 20 20 20 2f 2a 20 48 65 61 64 20 6f 66 20       /* Head of 
1270: 69 6e 2d 6d 65 6d 6f 72 79 20 72 65 63 6f 72 64  in-memory record
1280: 20 6c 69 73 74 20 2a 2f 0a 20 20 55 6e 70 61 63   list */.  Unpac
1290: 6b 65 64 52 65 63 6f 72 64 20 2a 70 55 6e 70 61  kedRecord *pUnpa
12a0: 63 6b 65 64 3b 20 20 20 20 20 20 2f 2a 20 55 73  cked;      /* Us
12b0: 65 64 20 74 6f 20 75 6e 70 61 63 6b 20 6b 65 79  ed to unpack key
12c0: 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54  s */.};../*.** T
12d0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 79 70  he following typ
12e0: 65 20 69 73 20 61 6e 20 69 74 65 72 61 74 6f 72  e is an iterator
12f0: 20 66 6f 72 20 61 20 50 4d 41 2e 20 49 74 20 63   for a PMA. It c
1300: 61 63 68 65 73 20 74 68 65 20 63 75 72 72 65 6e  aches the curren
1310: 74 20 6b 65 79 20 69 6e 20 0a 2a 2a 20 76 61 72  t key in .** var
1320: 69 61 62 6c 65 73 20 6e 4b 65 79 2f 61 4b 65 79  iables nKey/aKey
1330: 2e 20 49 66 20 74 68 65 20 69 74 65 72 61 74 6f  . If the iterato
1340: 72 20 69 73 20 61 74 20 45 4f 46 2c 20 70 46 69  r is at EOF, pFi
1350: 6c 65 3d 3d 30 2e 0a 2a 2f 0a 73 74 72 75 63 74  le==0..*/.struct
1360: 20 56 64 62 65 53 6f 72 74 65 72 49 74 65 72 20   VdbeSorterIter 
1370: 7b 0a 20 20 69 36 34 20 69 52 65 61 64 4f 66 66  {.  i64 iReadOff
1380: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1390: 20 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 72      /* Current r
13a0: 65 61 64 20 6f 66 66 73 65 74 20 2a 2f 0a 20 20  ead offset */.  
13b0: 69 36 34 20 69 45 6f 66 3b 20 20 20 20 20 20 20  i64 iEof;       
13c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
13d0: 2f 2a 20 31 20 62 79 74 65 20 70 61 73 74 20 45  /* 1 byte past E
13e0: 4f 46 20 66 6f 72 20 74 68 69 73 20 69 74 65 72  OF for this iter
13f0: 61 74 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 6e 41  ator */.  int nA
1400: 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 20 20 20  lloc;           
1410: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79 74            /* Byt
1420: 65 73 20 6f 66 20 73 70 61 63 65 20 61 74 20 61  es of space at a
1430: 41 6c 6c 6f 63 20 2a 2f 0a 20 20 69 6e 74 20 6e  Alloc */.  int n
1440: 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 20 20  Key;            
1450: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
1460: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e  mber of bytes in
1470: 20 6b 65 79 20 2a 2f 0a 20 20 73 71 6c 69 74 65   key */.  sqlite
1480: 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 3b 20 20  3_file *pFile;  
1490: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c            /* Fil
14a0: 65 20 69 74 65 72 61 74 6f 72 20 69 73 20 72 65  e iterator is re
14b0: 61 64 69 6e 67 20 66 72 6f 6d 20 2a 2f 0a 20 20  ading from */.  
14c0: 75 38 20 2a 61 41 6c 6c 6f 63 3b 20 20 20 20 20  u8 *aAlloc;     
14d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
14e0: 2f 2a 20 41 6c 6c 6f 63 61 74 65 64 20 73 70 61  /* Allocated spa
14f0: 63 65 20 2a 2f 0a 20 20 75 38 20 2a 61 4b 65 79  ce */.  u8 *aKey
1500: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1510: 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74          /* Point
1520: 65 72 20 74 6f 20 63 75 72 72 65 6e 74 20 6b 65  er to current ke
1530: 79 20 2a 2f 0a 20 20 75 38 20 2a 61 42 75 66 66  y */.  u8 *aBuff
1540: 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  er;             
1550: 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e         /* Curren
1560: 74 20 72 65 61 64 20 62 75 66 66 65 72 20 2a 2f  t read buffer */
1570: 0a 20 20 69 6e 74 20 6e 42 75 66 66 65 72 3b 20  .  int nBuffer; 
1580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1590: 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 72 65     /* Size of re
15a0: 61 64 20 62 75 66 66 65 72 20 69 6e 20 62 79 74  ad buffer in byt
15b0: 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20  es */.};../*.** 
15c0: 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  An instance of t
15d0: 68 69 73 20 73 74 72 75 63 74 75 72 65 20 69 73  his structure is
15e0: 20 75 73 65 64 20 74 6f 20 6f 72 67 61 6e 69 7a   used to organiz
15f0: 65 20 74 68 65 20 73 74 72 65 61 6d 20 6f 66 20  e the stream of 
1600: 72 65 63 6f 72 64 73 0a 2a 2a 20 62 65 69 6e 67  records.** being
1610: 20 77 72 69 74 74 65 6e 20 74 6f 20 66 69 6c 65   written to file
1620: 73 20 62 79 20 74 68 65 20 6d 65 72 67 65 2d 73  s by the merge-s
1630: 6f 72 74 20 63 6f 64 65 20 69 6e 74 6f 20 61 6c  ort code into al
1640: 69 67 6e 65 64 2c 20 70 61 67 65 2d 73 69 7a 65  igned, page-size
1650: 64 0a 2a 2a 20 62 6c 6f 63 6b 73 2e 20 20 44 6f  d.** blocks.  Do
1660: 69 6e 67 20 61 6c 6c 20 49 2f 4f 20 69 6e 20 61  ing all I/O in a
1670: 6c 69 67 6e 65 64 20 70 61 67 65 2d 73 69 7a 65  ligned page-size
1680: 64 20 62 6c 6f 63 6b 73 20 68 65 6c 70 73 20 49  d blocks helps I
1690: 2f 4f 20 74 6f 20 67 6f 0a 2a 2a 20 66 61 73 74  /O to go.** fast
16a0: 65 72 20 6f 6e 20 6d 61 6e 79 20 6f 70 65 72 61  er on many opera
16b0: 74 69 6e 67 20 73 79 73 74 65 6d 73 2e 0a 2a 2f  ting systems..*/
16c0: 0a 73 74 72 75 63 74 20 46 69 6c 65 57 72 69 74  .struct FileWrit
16d0: 65 72 20 7b 0a 20 20 69 6e 74 20 65 46 57 45 72  er {.  int eFWEr
16e0: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  r;              
16f0: 20 20 20 20 20 20 20 2f 2a 20 4e 6f 6e 2d 7a 65         /* Non-ze
1700: 72 6f 20 69 66 20 69 6e 20 61 6e 20 65 72 72 6f  ro if in an erro
1710: 72 20 73 74 61 74 65 20 2a 2f 0a 20 20 75 38 20  r state */.  u8 
1720: 2a 61 42 75 66 66 65 72 3b 20 20 20 20 20 20 20  *aBuffer;       
1730: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1740: 50 6f 69 6e 74 65 72 20 74 6f 20 77 72 69 74 65  Pointer to write
1750: 20 62 75 66 66 65 72 20 2a 2f 0a 20 20 69 6e 74   buffer */.  int
1760: 20 6e 42 75 66 66 65 72 3b 20 20 20 20 20 20 20   nBuffer;       
1770: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1780: 53 69 7a 65 20 6f 66 20 77 72 69 74 65 20 62 75  Size of write bu
1790: 66 66 65 72 20 69 6e 20 62 79 74 65 73 20 2a 2f  ffer in bytes */
17a0: 0a 20 20 69 6e 74 20 69 42 75 66 53 74 61 72 74  .  int iBufStart
17b0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
17c0: 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65     /* First byte
17d0: 20 6f 66 20 62 75 66 66 65 72 20 74 6f 20 77 72   of buffer to wr
17e0: 69 74 65 20 2a 2f 0a 20 20 69 6e 74 20 69 42 75  ite */.  int iBu
17f0: 66 45 6e 64 3b 20 20 20 20 20 20 20 20 20 20 20  fEnd;           
1800: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 74           /* Last
1810: 20 62 79 74 65 20 6f 66 20 62 75 66 66 65 72 20   byte of buffer 
1820: 74 6f 20 77 72 69 74 65 20 2a 2f 0a 20 20 69 36  to write */.  i6
1830: 34 20 69 57 72 69 74 65 4f 66 66 3b 20 20 20 20  4 iWriteOff;    
1840: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1850: 20 4f 66 66 73 65 74 20 6f 66 20 73 74 61 72 74   Offset of start
1860: 20 6f 66 20 62 75 66 66 65 72 20 69 6e 20 66 69   of buffer in fi
1870: 6c 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  le */.  sqlite3_
1880: 66 69 6c 65 20 2a 70 46 69 6c 65 3b 20 20 20 20  file *pFile;    
1890: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 20          /* File 
18a0: 74 6f 20 77 72 69 74 65 20 74 6f 20 2a 2f 0a 7d  to write to */.}
18b0: 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 73 74 72 75 63  ;../*.** A struc
18c0: 74 75 72 65 20 74 6f 20 73 74 6f 72 65 20 61 20  ture to store a 
18d0: 73 69 6e 67 6c 65 20 72 65 63 6f 72 64 2e 20 41  single record. A
18e0: 6c 6c 20 69 6e 2d 6d 65 6d 6f 72 79 20 72 65 63  ll in-memory rec
18f0: 6f 72 64 73 20 61 72 65 20 63 6f 6e 6e 65 63 74  ords are connect
1900: 65 64 0a 2a 2a 20 74 6f 67 65 74 68 65 72 20 69  ed.** together i
1910: 6e 74 6f 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73  nto a linked lis
1920: 74 20 68 65 61 64 65 64 20 61 74 20 56 64 62 65  t headed at Vdbe
1930: 53 6f 72 74 65 72 2e 70 52 65 63 6f 72 64 20 75  Sorter.pRecord u
1940: 73 69 6e 67 20 74 68 65 20 0a 2a 2a 20 53 6f 72  sing the .** Sor
1950: 74 65 72 52 65 63 6f 72 64 2e 70 4e 65 78 74 20  terRecord.pNext 
1960: 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 73 74 72 75  pointer..*/.stru
1970: 63 74 20 53 6f 72 74 65 72 52 65 63 6f 72 64 20  ct SorterRecord 
1980: 7b 0a 20 20 76 6f 69 64 20 2a 70 56 61 6c 3b 0a  {.  void *pVal;.
1990: 20 20 69 6e 74 20 6e 56 61 6c 3b 0a 20 20 53 6f    int nVal;.  So
19a0: 72 74 65 72 52 65 63 6f 72 64 20 2a 70 4e 65 78  rterRecord *pNex
19b0: 74 3b 0a 7d 3b 0a 0a 2f 2a 20 4d 69 6e 69 6d 75  t;.};../* Minimu
19c0: 6d 20 61 6c 6c 6f 77 61 62 6c 65 20 76 61 6c 75  m allowable valu
19d0: 65 20 66 6f 72 20 74 68 65 20 56 64 62 65 53 6f  e for the VdbeSo
19e0: 72 74 65 72 2e 6e 57 6f 72 6b 69 6e 67 20 76 61  rter.nWorking va
19f0: 72 69 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e  riable */.#defin
1a00: 65 20 53 4f 52 54 45 52 5f 4d 49 4e 5f 57 4f 52  e SORTER_MIN_WOR
1a10: 4b 49 4e 47 20 31 30 0a 0a 2f 2a 20 4d 61 78 69  KING 10../* Maxi
1a20: 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 73 65  mum number of se
1a30: 67 6d 65 6e 74 73 20 74 6f 20 6d 65 72 67 65 20  gments to merge 
1a40: 69 6e 20 61 20 73 69 6e 67 6c 65 20 70 61 73 73  in a single pass
1a50: 2e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 4f 52  . */.#define SOR
1a60: 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f 43 4f  TER_MAX_MERGE_CO
1a70: 55 4e 54 20 31 36 0a 0a 2f 2a 0a 2a 2a 20 46 72  UNT 16../*.** Fr
1a80: 65 65 20 61 6c 6c 20 6d 65 6d 6f 72 79 20 62 65  ee all memory be
1a90: 6c 6f 6e 67 69 6e 67 20 74 6f 20 74 68 65 20 56  longing to the V
1aa0: 64 62 65 53 6f 72 74 65 72 49 74 65 72 20 6f 62  dbeSorterIter ob
1ab0: 6a 65 63 74 20 70 61 73 73 65 64 20 61 73 20 74  ject passed as t
1ac0: 68 65 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 67  he second.** arg
1ad0: 75 6d 65 6e 74 2e 20 41 6c 6c 20 73 74 72 75 63  ument. All struc
1ae0: 74 75 72 65 20 66 69 65 6c 64 73 20 61 72 65 20  ture fields are 
1af0: 73 65 74 20 74 6f 20 7a 65 72 6f 20 62 65 66 6f  set to zero befo
1b00: 72 65 20 72 65 74 75 72 6e 69 6e 67 2e 0a 2a 2f  re returning..*/
1b10: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 76 64 62  .static void vdb
1b20: 65 53 6f 72 74 65 72 49 74 65 72 5a 65 72 6f 28  eSorterIterZero(
1b30: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 56 64 62  sqlite3 *db, Vdb
1b40: 65 53 6f 72 74 65 72 49 74 65 72 20 2a 70 49 74  eSorterIter *pIt
1b50: 65 72 29 7b 0a 20 20 73 71 6c 69 74 65 33 44 62  er){.  sqlite3Db
1b60: 46 72 65 65 28 64 62 2c 20 70 49 74 65 72 2d 3e  Free(db, pIter->
1b70: 61 41 6c 6c 6f 63 29 3b 0a 20 20 73 71 6c 69 74  aAlloc);.  sqlit
1b80: 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 49 74  e3DbFree(db, pIt
1b90: 65 72 2d 3e 61 42 75 66 66 65 72 29 3b 0a 20 20  er->aBuffer);.  
1ba0: 6d 65 6d 73 65 74 28 70 49 74 65 72 2c 20 30 2c  memset(pIter, 0,
1bb0: 20 73 69 7a 65 6f 66 28 56 64 62 65 53 6f 72 74   sizeof(VdbeSort
1bc0: 65 72 49 74 65 72 29 29 3b 0a 7d 0a 0a 2f 2a 0a  erIter));.}../*.
1bd0: 2a 2a 20 52 65 61 64 20 6e 42 79 74 65 20 62 79  ** Read nByte by
1be0: 74 65 73 20 6f 66 20 64 61 74 61 20 66 72 6f 6d  tes of data from
1bf0: 20 74 68 65 20 73 74 72 65 61 6d 20 6f 66 20 64   the stream of d
1c00: 61 74 61 20 69 74 65 72 61 74 65 64 20 62 79 20  ata iterated by 
1c10: 6f 62 6a 65 63 74 20 70 2e 0a 2a 2a 20 49 66 20  object p..** If 
1c20: 73 75 63 63 65 73 73 66 75 6c 2c 20 73 65 74 20  successful, set 
1c30: 2a 70 70 4f 75 74 20 74 6f 20 70 6f 69 6e 74 20  *ppOut to point 
1c40: 74 6f 20 61 20 62 75 66 66 65 72 20 63 6f 6e 74  to a buffer cont
1c50: 61 69 6e 69 6e 67 20 74 68 65 20 64 61 74 61 0a  aining the data.
1c60: 2a 2a 20 61 6e 64 20 72 65 74 75 72 6e 20 53 51  ** and return SQ
1c70: 4c 49 54 45 5f 4f 4b 2e 20 4f 74 68 65 72 77 69  LITE_OK. Otherwi
1c80: 73 65 2c 20 69 66 20 61 6e 20 65 72 72 6f 72 20  se, if an error 
1c90: 6f 63 63 75 72 73 2c 20 72 65 74 75 72 6e 20 61  occurs, return a
1ca0: 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 65 72 72 6f  n SQLite.** erro
1cb0: 72 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 54 68  r code..**.** Th
1cc0: 65 20 62 75 66 66 65 72 20 69 6e 64 69 63 61 74  e buffer indicat
1cd0: 65 64 20 62 79 20 2a 70 70 4f 75 74 20 6d 61 79  ed by *ppOut may
1ce0: 20 6f 6e 6c 79 20 62 65 20 63 6f 6e 73 69 64 65   only be conside
1cf0: 72 65 64 20 76 61 6c 69 64 20 75 6e 74 69 6c 20  red valid until 
1d00: 74 68 65 0a 2a 2a 20 6e 65 78 74 20 63 61 6c 6c  the.** next call
1d10: 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f   to this functio
1d20: 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  n..*/.static int
1d30: 20 76 64 62 65 53 6f 72 74 65 72 49 74 65 72 52   vdbeSorterIterR
1d40: 65 61 64 28 0a 20 20 73 71 6c 69 74 65 33 20 2a  ead(.  sqlite3 *
1d50: 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  db,             
1d60: 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61         /* Databa
1d70: 73 65 20 68 61 6e 64 6c 65 20 28 66 6f 72 20 6d  se handle (for m
1d80: 61 6c 6c 6f 63 29 20 2a 2f 0a 20 20 56 64 62 65  alloc) */.  Vdbe
1d90: 53 6f 72 74 65 72 49 74 65 72 20 2a 70 2c 20 20  SorterIter *p,  
1da0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49              /* I
1db0: 74 65 72 61 74 6f 72 20 2a 2f 0a 20 20 69 6e 74  terator */.  int
1dc0: 20 6e 42 79 74 65 2c 20 20 20 20 20 20 20 20 20   nByte,         
1dd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1de0: 42 79 74 65 73 20 6f 66 20 64 61 74 61 20 74 6f  Bytes of data to
1df0: 20 72 65 61 64 20 2a 2f 0a 20 20 75 38 20 2a 2a   read */.  u8 **
1e00: 70 70 4f 75 74 20 20 20 20 20 20 20 20 20 20 20  ppOut           
1e10: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55             /* OU
1e20: 54 3a 20 50 6f 69 6e 74 65 72 20 74 6f 20 62 75  T: Pointer to bu
1e30: 66 66 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20  ffer containing 
1e40: 64 61 74 61 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74  data */.){.  int
1e50: 20 69 42 75 66 3b 20 20 20 20 20 20 20 20 20 20   iBuf;          
1e60: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1e70: 4f 66 66 73 65 74 20 77 69 74 68 69 6e 20 62 75  Offset within bu
1e80: 66 66 65 72 20 74 6f 20 72 65 61 64 20 66 72 6f  ffer to read fro
1e90: 6d 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 76 61 69  m */.  int nAvai
1ea0: 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  l;              
1eb0: 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20         /* Bytes 
1ec0: 6f 66 20 64 61 74 61 20 61 76 61 69 6c 61 62 6c  of data availabl
1ed0: 65 20 69 6e 20 62 75 66 66 65 72 20 2a 2f 0a 20  e in buffer */. 
1ee0: 20 61 73 73 65 72 74 28 20 70 2d 3e 61 42 75 66   assert( p->aBuf
1ef0: 66 65 72 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20  fer );..  /* If 
1f00: 74 68 65 72 65 20 69 73 20 6e 6f 20 6d 6f 72 65  there is no more
1f10: 20 64 61 74 61 20 74 6f 20 62 65 20 72 65 61 64   data to be read
1f20: 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72   from the buffer
1f30: 2c 20 72 65 61 64 20 74 68 65 20 6e 65 78 74 20  , read the next 
1f40: 0a 20 20 2a 2a 20 70 2d 3e 6e 42 75 66 66 65 72  .  ** p->nBuffer
1f50: 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 66   bytes of data f
1f60: 72 6f 6d 20 74 68 65 20 66 69 6c 65 20 69 6e 74  rom the file int
1f70: 6f 20 69 74 2e 20 4f 72 2c 20 69 66 20 74 68 65  o it. Or, if the
1f80: 72 65 20 61 72 65 20 6c 65 73 73 0a 20 20 2a 2a  re are less.  **
1f90: 20 74 68 61 6e 20 70 2d 3e 6e 42 75 66 66 65 72   than p->nBuffer
1fa0: 20 62 79 74 65 73 20 72 65 6d 61 69 6e 69 6e 67   bytes remaining
1fb0: 20 69 6e 20 74 68 65 20 50 4d 41 2c 20 72 65 61   in the PMA, rea
1fc0: 64 20 61 6c 6c 20 72 65 6d 61 69 6e 69 6e 67 20  d all remaining 
1fd0: 64 61 74 61 2e 20 20 2a 2f 0a 20 20 69 42 75 66  data.  */.  iBuf
1fe0: 20 3d 20 70 2d 3e 69 52 65 61 64 4f 66 66 20 25   = p->iReadOff %
1ff0: 20 70 2d 3e 6e 42 75 66 66 65 72 3b 0a 20 20 69   p->nBuffer;.  i
2000: 66 28 20 69 42 75 66 3d 3d 30 20 29 7b 0a 20 20  f( iBuf==0 ){.  
2010: 20 20 69 6e 74 20 6e 52 65 61 64 3b 20 20 20 20    int nRead;    
2020: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2030: 2f 2a 20 42 79 74 65 73 20 74 6f 20 72 65 61 64  /* Bytes to read
2040: 20 66 72 6f 6d 20 64 69 73 6b 20 2a 2f 0a 20 20   from disk */.  
2050: 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20    int rc;       
2060: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2070: 2f 2a 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64  /* sqlite3OsRead
2080: 28 29 20 72 65 74 75 72 6e 20 63 6f 64 65 20 2a  () return code *
2090: 2f 0a 0a 20 20 20 20 2f 2a 20 44 65 74 65 72 6d  /..    /* Determ
20a0: 69 6e 65 20 68 6f 77 20 6d 61 6e 79 20 62 79 74  ine how many byt
20b0: 65 73 20 6f 66 20 64 61 74 61 20 74 6f 20 72 65  es of data to re
20c0: 61 64 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 28  ad. */.    if( (
20d0: 70 2d 3e 69 45 6f 66 20 2d 20 70 2d 3e 69 52 65  p->iEof - p->iRe
20e0: 61 64 4f 66 66 29 20 3e 20 28 69 36 34 29 70 2d  adOff) > (i64)p-
20f0: 3e 6e 42 75 66 66 65 72 20 29 7b 0a 20 20 20 20  >nBuffer ){.    
2100: 20 20 6e 52 65 61 64 20 3d 20 70 2d 3e 6e 42 75    nRead = p->nBu
2110: 66 66 65 72 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  ffer;.    }else{
2120: 0a 20 20 20 20 20 20 6e 52 65 61 64 20 3d 20 28  .      nRead = (
2130: 69 6e 74 29 28 70 2d 3e 69 45 6f 66 20 2d 20 70  int)(p->iEof - p
2140: 2d 3e 69 52 65 61 64 4f 66 66 29 3b 0a 20 20 20  ->iReadOff);.   
2150: 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e   }.    assert( n
2160: 52 65 61 64 3e 30 20 29 3b 0a 0a 20 20 20 20 2f  Read>0 );..    /
2170: 2a 20 52 65 61 64 20 64 61 74 61 20 66 72 6f 6d  * Read data from
2180: 20 74 68 65 20 66 69 6c 65 2e 20 52 65 74 75 72   the file. Retur
2190: 6e 20 65 61 72 6c 79 20 69 66 20 61 6e 20 65 72  n early if an er
21a0: 72 6f 72 20 6f 63 63 75 72 73 2e 20 2a 2f 0a 20  ror occurs. */. 
21b0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f     rc = sqlite3O
21c0: 73 52 65 61 64 28 70 2d 3e 70 46 69 6c 65 2c 20  sRead(p->pFile, 
21d0: 70 2d 3e 61 42 75 66 66 65 72 2c 20 6e 52 65 61  p->aBuffer, nRea
21e0: 64 2c 20 70 2d 3e 69 52 65 61 64 4f 66 66 29 3b  d, p->iReadOff);
21f0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 21  .    assert( rc!
2200: 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48  =SQLITE_IOERR_SH
2210: 4f 52 54 5f 52 45 41 44 20 29 3b 0a 20 20 20 20  ORT_READ );.    
2220: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
2230: 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20  K ) return rc;. 
2240: 20 7d 0a 20 20 6e 41 76 61 69 6c 20 3d 20 70 2d   }.  nAvail = p-
2250: 3e 6e 42 75 66 66 65 72 20 2d 20 69 42 75 66 3b  >nBuffer - iBuf;
2260: 20 0a 0a 20 20 69 66 28 20 6e 42 79 74 65 3c 3d   ..  if( nByte<=
2270: 6e 41 76 61 69 6c 20 29 7b 0a 20 20 20 20 2f 2a  nAvail ){.    /*
2280: 20 54 68 65 20 72 65 71 75 65 73 74 65 64 20 64   The requested d
2290: 61 74 61 20 69 73 20 61 76 61 69 6c 61 62 6c 65  ata is available
22a0: 20 69 6e 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72   in the in-memor
22b0: 79 20 62 75 66 66 65 72 2e 20 49 6e 20 74 68 69  y buffer. In thi
22c0: 73 0a 20 20 20 20 2a 2a 20 63 61 73 65 20 74 68  s.    ** case th
22d0: 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64 20 74  ere is no need t
22e0: 6f 20 6d 61 6b 65 20 61 20 63 6f 70 79 20 6f 66  o make a copy of
22f0: 20 74 68 65 20 64 61 74 61 2c 20 6a 75 73 74 20   the data, just 
2300: 72 65 74 75 72 6e 20 61 20 0a 20 20 20 20 2a 2a  return a .    **
2310: 20 70 6f 69 6e 74 65 72 20 69 6e 74 6f 20 74 68   pointer into th
2320: 65 20 62 75 66 66 65 72 20 74 6f 20 74 68 65 20  e buffer to the 
2330: 63 61 6c 6c 65 72 2e 20 20 2a 2f 0a 20 20 20 20  caller.  */.    
2340: 2a 70 70 4f 75 74 20 3d 20 26 70 2d 3e 61 42 75  *ppOut = &p->aBu
2350: 66 66 65 72 5b 69 42 75 66 5d 3b 0a 20 20 20 20  ffer[iBuf];.    
2360: 70 2d 3e 69 52 65 61 64 4f 66 66 20 2b 3d 20 6e  p->iReadOff += n
2370: 42 79 74 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  Byte;.  }else{. 
2380: 20 20 20 2f 2a 20 54 68 65 20 72 65 71 75 65 73     /* The reques
2390: 74 65 64 20 64 61 74 61 20 69 73 20 6e 6f 74 20  ted data is not 
23a0: 61 6c 6c 20 61 76 61 69 6c 61 62 6c 65 20 69 6e  all available in
23b0: 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 62   the in-memory b
23c0: 75 66 66 65 72 2e 0a 20 20 20 20 2a 2a 20 49 6e  uffer..    ** In
23d0: 20 74 68 69 73 20 63 61 73 65 2c 20 61 6c 6c 6f   this case, allo
23e0: 63 61 74 65 20 73 70 61 63 65 20 61 74 20 70 2d  cate space at p-
23f0: 3e 61 41 6c 6c 6f 63 5b 5d 20 74 6f 20 63 6f 70  >aAlloc[] to cop
2400: 79 20 74 68 65 20 72 65 71 75 65 73 74 65 64 0a  y the requested.
2410: 20 20 20 20 2a 2a 20 72 61 6e 67 65 20 69 6e 74      ** range int
2420: 6f 2e 20 54 68 65 6e 20 72 65 74 75 72 6e 20 61  o. Then return a
2430: 20 63 6f 70 79 20 6f 66 20 70 6f 69 6e 74 65 72   copy of pointer
2440: 20 70 2d 3e 61 41 6c 6c 6f 63 20 74 6f 20 74 68   p->aAlloc to th
2450: 65 20 63 61 6c 6c 65 72 2e 20 20 2a 2f 0a 20 20  e caller.  */.  
2460: 20 20 69 6e 74 20 6e 52 65 6d 3b 20 20 20 20 20    int nRem;     
2470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2480: 2f 2a 20 42 79 74 65 73 20 72 65 6d 61 69 6e 69  /* Bytes remaini
2490: 6e 67 20 74 6f 20 63 6f 70 79 20 2a 2f 0a 0a 20  ng to copy */.. 
24a0: 20 20 20 2f 2a 20 45 78 74 65 6e 64 20 74 68 65     /* Extend the
24b0: 20 70 2d 3e 61 41 6c 6c 6f 63 5b 5d 20 61 6c 6c   p->aAlloc[] all
24c0: 6f 63 61 74 69 6f 6e 20 69 66 20 72 65 71 75 69  ocation if requi
24d0: 72 65 64 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20  red. */.    if( 
24e0: 70 2d 3e 6e 41 6c 6c 6f 63 3c 6e 42 79 74 65 20  p->nAlloc<nByte 
24f0: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 4e 65  ){.      int nNe
2500: 77 20 3d 20 70 2d 3e 6e 41 6c 6c 6f 63 2a 32 3b  w = p->nAlloc*2;
2510: 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 6e 42  .      while( nB
2520: 79 74 65 3e 6e 4e 65 77 20 29 20 6e 4e 65 77 20  yte>nNew ) nNew 
2530: 3d 20 6e 4e 65 77 2a 32 3b 0a 20 20 20 20 20 20  = nNew*2;.      
2540: 70 2d 3e 61 41 6c 6c 6f 63 20 3d 20 73 71 6c 69  p->aAlloc = sqli
2550: 74 65 33 44 62 52 65 61 6c 6c 6f 63 4f 72 46 72  te3DbReallocOrFr
2560: 65 65 28 64 62 2c 20 70 2d 3e 61 41 6c 6c 6f 63  ee(db, p->aAlloc
2570: 2c 20 6e 4e 65 77 29 3b 0a 20 20 20 20 20 20 69  , nNew);.      i
2580: 66 28 20 21 70 2d 3e 61 41 6c 6c 6f 63 20 29 20  f( !p->aAlloc ) 
2590: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f  return SQLITE_NO
25a0: 4d 45 4d 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 41  MEM;.      p->nA
25b0: 6c 6c 6f 63 20 3d 20 6e 4e 65 77 3b 0a 20 20 20  lloc = nNew;.   
25c0: 20 7d 0a 0a 20 20 20 20 2f 2a 20 43 6f 70 79 20   }..    /* Copy 
25d0: 61 73 20 6d 75 63 68 20 64 61 74 61 20 61 73 20  as much data as 
25e0: 69 73 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20  is available in 
25f0: 74 68 65 20 62 75 66 66 65 72 20 69 6e 74 6f 20  the buffer into 
2600: 74 68 65 20 73 74 61 72 74 20 6f 66 0a 20 20 20  the start of.   
2610: 20 2a 2a 20 70 2d 3e 61 41 6c 6c 6f 63 5b 5d 2e   ** p->aAlloc[].
2620: 20 20 2a 2f 0a 20 20 20 20 6d 65 6d 63 70 79 28    */.    memcpy(
2630: 70 2d 3e 61 41 6c 6c 6f 63 2c 20 26 70 2d 3e 61  p->aAlloc, &p->a
2640: 42 75 66 66 65 72 5b 69 42 75 66 5d 2c 20 6e 41  Buffer[iBuf], nA
2650: 76 61 69 6c 29 3b 0a 20 20 20 20 70 2d 3e 69 52  vail);.    p->iR
2660: 65 61 64 4f 66 66 20 2b 3d 20 6e 41 76 61 69 6c  eadOff += nAvail
2670: 3b 0a 20 20 20 20 6e 52 65 6d 20 3d 20 6e 42 79  ;.    nRem = nBy
2680: 74 65 20 2d 20 6e 41 76 61 69 6c 3b 0a 0a 20 20  te - nAvail;..  
2690: 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69    /* The followi
26a0: 6e 67 20 6c 6f 6f 70 20 63 6f 70 69 65 73 20 75  ng loop copies u
26b0: 70 20 74 6f 20 70 2d 3e 6e 42 75 66 66 65 72 20  p to p->nBuffer 
26c0: 62 79 74 65 73 20 70 65 72 20 69 74 65 72 61 74  bytes per iterat
26d0: 69 6f 6e 20 69 6e 74 6f 0a 20 20 20 20 2a 2a 20  ion into.    ** 
26e0: 74 68 65 20 70 2d 3e 61 41 6c 6c 6f 63 5b 5d 20  the p->aAlloc[] 
26f0: 62 75 66 66 65 72 2e 20 20 2a 2f 0a 20 20 20 20  buffer.  */.    
2700: 77 68 69 6c 65 28 20 6e 52 65 6d 3e 30 20 29 7b  while( nRem>0 ){
2710: 0a 20 20 20 20 20 20 69 6e 74 20 72 63 3b 20 20  .      int rc;  
2720: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2730: 20 20 20 2f 2a 20 76 64 62 65 53 6f 72 74 65 72     /* vdbeSorter
2740: 49 74 65 72 52 65 61 64 28 29 20 72 65 74 75 72  IterRead() retur
2750: 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 20 20 20 20  n code */.      
2760: 69 6e 74 20 6e 43 6f 70 79 3b 20 20 20 20 20 20  int nCopy;      
2770: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
2780: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 74  umber of bytes t
2790: 6f 20 63 6f 70 79 20 2a 2f 0a 20 20 20 20 20 20  o copy */.      
27a0: 75 38 20 2a 61 4e 65 78 74 3b 20 20 20 20 20 20  u8 *aNext;      
27b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50              /* P
27c0: 6f 69 6e 74 65 72 20 74 6f 20 62 75 66 66 65 72  ointer to buffer
27d0: 20 74 6f 20 63 6f 70 79 20 64 61 74 61 20 66 72   to copy data fr
27e0: 6f 6d 20 2a 2f 0a 0a 20 20 20 20 20 20 6e 43 6f  om */..      nCo
27f0: 70 79 20 3d 20 6e 52 65 6d 3b 0a 20 20 20 20 20  py = nRem;.     
2800: 20 69 66 28 20 6e 52 65 6d 3e 70 2d 3e 6e 42 75   if( nRem>p->nBu
2810: 66 66 65 72 20 29 20 6e 43 6f 70 79 20 3d 20 70  ffer ) nCopy = p
2820: 2d 3e 6e 42 75 66 66 65 72 3b 0a 20 20 20 20 20  ->nBuffer;.     
2830: 20 72 63 20 3d 20 76 64 62 65 53 6f 72 74 65 72   rc = vdbeSorter
2840: 49 74 65 72 52 65 61 64 28 64 62 2c 20 70 2c 20  IterRead(db, p, 
2850: 6e 43 6f 70 79 2c 20 26 61 4e 65 78 74 29 3b 0a  nCopy, &aNext);.
2860: 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51        if( rc!=SQ
2870: 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e  LITE_OK ) return
2880: 20 72 63 3b 0a 20 20 20 20 20 20 61 73 73 65 72   rc;.      asser
2890: 74 28 20 61 4e 65 78 74 21 3d 70 2d 3e 61 41 6c  t( aNext!=p->aAl
28a0: 6c 6f 63 20 29 3b 0a 20 20 20 20 20 20 6d 65 6d  loc );.      mem
28b0: 63 70 79 28 26 70 2d 3e 61 41 6c 6c 6f 63 5b 6e  cpy(&p->aAlloc[n
28c0: 42 79 74 65 20 2d 20 6e 52 65 6d 5d 2c 20 61 4e  Byte - nRem], aN
28d0: 65 78 74 2c 20 6e 43 6f 70 79 29 3b 0a 20 20 20  ext, nCopy);.   
28e0: 20 20 20 6e 52 65 6d 20 2d 3d 20 6e 43 6f 70 79     nRem -= nCopy
28f0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2a 70 70  ;.    }..    *pp
2900: 4f 75 74 20 3d 20 70 2d 3e 61 41 6c 6c 6f 63 3b  Out = p->aAlloc;
2910: 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 53  .  }..  return S
2920: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
2930: 2a 2a 20 52 65 61 64 20 61 20 76 61 72 69 6e 74  ** Read a varint
2940: 20 66 72 6f 6d 20 74 68 65 20 73 74 72 65 61 6d   from the stream
2950: 20 6f 66 20 64 61 74 61 20 61 63 63 65 73 73 65   of data accesse
2960: 64 20 62 79 20 70 2e 20 53 65 74 20 2a 70 6e 4f  d by p. Set *pnO
2970: 75 74 20 74 6f 0a 2a 2a 20 74 68 65 20 76 61 6c  ut to.** the val
2980: 75 65 20 72 65 61 64 2e 0a 2a 2f 0a 73 74 61 74  ue read..*/.stat
2990: 69 63 20 69 6e 74 20 76 64 62 65 53 6f 72 74 65  ic int vdbeSorte
29a0: 72 49 74 65 72 56 61 72 69 6e 74 28 73 71 6c 69  rIterVarint(sqli
29b0: 74 65 33 20 2a 64 62 2c 20 56 64 62 65 53 6f 72  te3 *db, VdbeSor
29c0: 74 65 72 49 74 65 72 20 2a 70 2c 20 75 36 34 20  terIter *p, u64 
29d0: 2a 70 6e 4f 75 74 29 7b 0a 20 20 69 6e 74 20 69  *pnOut){.  int i
29e0: 42 75 66 3b 0a 0a 20 20 69 42 75 66 20 3d 20 70  Buf;..  iBuf = p
29f0: 2d 3e 69 52 65 61 64 4f 66 66 20 25 20 70 2d 3e  ->iReadOff % p->
2a00: 6e 42 75 66 66 65 72 3b 0a 20 20 69 66 28 20 69  nBuffer;.  if( i
2a10: 42 75 66 20 26 26 20 28 70 2d 3e 6e 42 75 66 66  Buf && (p->nBuff
2a20: 65 72 2d 69 42 75 66 29 3e 3d 39 20 29 7b 0a 20  er-iBuf)>=9 ){. 
2a30: 20 20 20 70 2d 3e 69 52 65 61 64 4f 66 66 20 2b     p->iReadOff +
2a40: 3d 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69  = sqlite3GetVari
2a50: 6e 74 28 26 70 2d 3e 61 42 75 66 66 65 72 5b 69  nt(&p->aBuffer[i
2a60: 42 75 66 5d 2c 20 70 6e 4f 75 74 29 3b 0a 20 20  Buf], pnOut);.  
2a70: 7d 65 6c 73 65 7b 0a 20 20 20 20 75 38 20 61 56  }else{.    u8 aV
2a80: 61 72 69 6e 74 5b 31 36 5d 2c 20 2a 61 3b 0a 20  arint[16], *a;. 
2a90: 20 20 20 69 6e 74 20 69 20 3d 20 30 2c 20 72 63     int i = 0, rc
2aa0: 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20  ;.    do{.      
2ab0: 72 63 20 3d 20 76 64 62 65 53 6f 72 74 65 72 49  rc = vdbeSorterI
2ac0: 74 65 72 52 65 61 64 28 64 62 2c 20 70 2c 20 31  terRead(db, p, 1
2ad0: 2c 20 26 61 29 3b 0a 20 20 20 20 20 20 69 66 28  , &a);.      if(
2ae0: 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b   rc ) return rc;
2af0: 0a 20 20 20 20 20 20 61 56 61 72 69 6e 74 5b 28  .      aVarint[(
2b00: 69 2b 2b 29 26 30 78 66 5d 20 3d 20 61 5b 30 5d  i++)&0xf] = a[0]
2b10: 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 28 61  ;.    }while( (a
2b20: 5b 30 5d 26 30 78 38 30 29 21 3d 30 20 29 3b 0a  [0]&0x80)!=0 );.
2b30: 20 20 20 20 73 71 6c 69 74 65 33 47 65 74 56 61      sqlite3GetVa
2b40: 72 69 6e 74 28 61 56 61 72 69 6e 74 2c 20 70 6e  rint(aVarint, pn
2b50: 4f 75 74 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74  Out);.  }..  ret
2b60: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
2b70: 0a 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 61 6e 63 65  .../*.** Advance
2b80: 20 69 74 65 72 61 74 6f 72 20 70 49 74 65 72 20   iterator pIter 
2b90: 74 6f 20 74 68 65 20 6e 65 78 74 20 6b 65 79 20  to the next key 
2ba0: 69 6e 20 69 74 73 20 50 4d 41 2e 20 52 65 74 75  in its PMA. Retu
2bb0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 0a  rn SQLITE_OK if.
2bc0: 2a 2a 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75  ** no error occu
2bd0: 72 73 2c 20 6f 72 20 61 6e 20 53 51 4c 69 74 65  rs, or an SQLite
2be0: 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 6f   error code if o
2bf0: 6e 65 20 64 6f 65 73 2e 0a 2a 2f 0a 73 74 61 74  ne does..*/.stat
2c00: 69 63 20 69 6e 74 20 76 64 62 65 53 6f 72 74 65  ic int vdbeSorte
2c10: 72 49 74 65 72 4e 65 78 74 28 0a 20 20 73 71 6c  rIterNext(.  sql
2c20: 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20  ite3 *db,       
2c30: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2c40: 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20  Database handle 
2c50: 28 66 6f 72 20 73 71 6c 69 74 65 33 44 62 4d 61  (for sqlite3DbMa
2c60: 6c 6c 6f 63 28 29 20 29 20 2a 2f 0a 20 20 56 64  lloc() ) */.  Vd
2c70: 62 65 53 6f 72 74 65 72 49 74 65 72 20 2a 70 49  beSorterIter *pI
2c80: 74 65 72 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ter           /*
2c90: 20 49 74 65 72 61 74 6f 72 20 74 6f 20 61 64 76   Iterator to adv
2ca0: 61 6e 63 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74  ance */.){.  int
2cb0: 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20   rc;            
2cc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2cd0: 52 65 74 75 72 6e 20 43 6f 64 65 20 2a 2f 0a 20  Return Code */. 
2ce0: 20 75 36 34 20 6e 52 65 63 20 3d 20 30 3b 20 20   u64 nRec = 0;  
2cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2d00: 20 2f 2a 20 53 69 7a 65 20 6f 66 20 72 65 63 6f   /* Size of reco
2d10: 72 64 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a 0a  rd in bytes */..
2d20: 20 20 69 66 28 20 70 49 74 65 72 2d 3e 69 52 65    if( pIter->iRe
2d30: 61 64 4f 66 66 3e 3d 70 49 74 65 72 2d 3e 69 45  adOff>=pIter->iE
2d40: 6f 66 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 69  of ){.    /* Thi
2d50: 73 20 69 73 20 61 6e 20 45 4f 46 20 63 6f 6e 64  s is an EOF cond
2d60: 69 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 76 64 62  ition */.    vdb
2d70: 65 53 6f 72 74 65 72 49 74 65 72 5a 65 72 6f 28  eSorterIterZero(
2d80: 64 62 2c 20 70 49 74 65 72 29 3b 0a 20 20 20 20  db, pIter);.    
2d90: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
2da0: 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 76 64  ;.  }..  rc = vd
2db0: 62 65 53 6f 72 74 65 72 49 74 65 72 56 61 72 69  beSorterIterVari
2dc0: 6e 74 28 64 62 2c 20 70 49 74 65 72 2c 20 26 6e  nt(db, pIter, &n
2dd0: 52 65 63 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d  Rec);.  if( rc==
2de0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
2df0: 20 70 49 74 65 72 2d 3e 6e 4b 65 79 20 3d 20 28   pIter->nKey = (
2e00: 69 6e 74 29 6e 52 65 63 3b 0a 20 20 20 20 72 63  int)nRec;.    rc
2e10: 20 3d 20 76 64 62 65 53 6f 72 74 65 72 49 74 65   = vdbeSorterIte
2e20: 72 52 65 61 64 28 64 62 2c 20 70 49 74 65 72 2c  rRead(db, pIter,
2e30: 20 28 69 6e 74 29 6e 52 65 63 2c 20 26 70 49 74   (int)nRec, &pIt
2e40: 65 72 2d 3e 61 4b 65 79 29 3b 0a 20 20 7d 0a 0a  er->aKey);.  }..
2e50: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
2e60: 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65  /*.** Initialize
2e70: 20 69 74 65 72 61 74 6f 72 20 70 49 74 65 72 20   iterator pIter 
2e80: 74 6f 20 73 63 61 6e 20 74 68 72 6f 75 67 68 20  to scan through 
2e90: 74 68 65 20 50 4d 41 20 73 74 6f 72 65 64 20 69  the PMA stored i
2ea0: 6e 20 66 69 6c 65 20 70 46 69 6c 65 0a 2a 2a 20  n file pFile.** 
2eb0: 73 74 61 72 74 69 6e 67 20 61 74 20 6f 66 66 73  starting at offs
2ec0: 65 74 20 69 53 74 61 72 74 20 61 6e 64 20 65 6e  et iStart and en
2ed0: 64 69 6e 67 20 61 74 20 6f 66 66 73 65 74 20 69  ding at offset i
2ee0: 45 6f 66 2d 31 2e 20 54 68 69 73 20 66 75 6e 63  Eof-1. This func
2ef0: 74 69 6f 6e 20 0a 2a 2a 20 6c 65 61 76 65 73 20  tion .** leaves 
2f00: 74 68 65 20 69 74 65 72 61 74 6f 72 20 70 6f 69  the iterator poi
2f10: 6e 74 69 6e 67 20 74 6f 20 74 68 65 20 66 69 72  nting to the fir
2f20: 73 74 20 6b 65 79 20 69 6e 20 74 68 65 20 50 4d  st key in the PM
2f30: 41 20 28 6f 72 20 45 4f 46 20 69 66 20 74 68 65  A (or EOF if the
2f40: 20 0a 2a 2a 20 50 4d 41 20 69 73 20 65 6d 70 74   .** PMA is empt
2f50: 79 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  y)..*/.static in
2f60: 74 20 76 64 62 65 53 6f 72 74 65 72 49 74 65 72  t vdbeSorterIter
2f70: 49 6e 69 74 28 0a 20 20 73 71 6c 69 74 65 33 20  Init(.  sqlite3 
2f80: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20  *db,            
2f90: 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62          /* Datab
2fa0: 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20  ase handle */.  
2fb0: 63 6f 6e 73 74 20 56 64 62 65 53 6f 72 74 65 72  const VdbeSorter
2fc0: 20 2a 70 53 6f 72 74 65 72 2c 20 20 20 20 20 20   *pSorter,      
2fd0: 2f 2a 20 53 6f 72 74 65 72 20 6f 62 6a 65 63 74  /* Sorter object
2fe0: 20 2a 2f 0a 20 20 69 36 34 20 69 53 74 61 72 74   */.  i64 iStart
2ff0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
3000: 20 20 20 20 20 20 2f 2a 20 53 74 61 72 74 20 6f        /* Start o
3010: 66 66 73 65 74 20 69 6e 20 70 46 69 6c 65 20 2a  ffset in pFile *
3020: 2f 0a 20 20 56 64 62 65 53 6f 72 74 65 72 49 74  /.  VdbeSorterIt
3030: 65 72 20 2a 70 49 74 65 72 2c 20 20 20 20 20 20  er *pIter,      
3040: 20 20 20 20 2f 2a 20 49 74 65 72 61 74 6f 72 20      /* Iterator 
3050: 74 6f 20 70 6f 70 75 6c 61 74 65 20 2a 2f 0a 20  to populate */. 
3060: 20 69 36 34 20 2a 70 6e 42 79 74 65 20 20 20 20   i64 *pnByte    
3070: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3080: 20 2f 2a 20 49 4e 2f 4f 55 54 3a 20 49 6e 63 72   /* IN/OUT: Incr
3090: 65 6d 65 6e 74 20 74 68 69 73 20 76 61 6c 75 65  ement this value
30a0: 20 62 79 20 50 4d 41 20 73 69 7a 65 20 2a 2f 0a   by PMA size */.
30b0: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  ){.  int rc = SQ
30c0: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 6e  LITE_OK;.  int n
30d0: 42 75 66 3b 0a 0a 20 20 6e 42 75 66 20 3d 20 73  Buf;..  nBuf = s
30e0: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 50 61  qlite3BtreeGetPa
30f0: 67 65 53 69 7a 65 28 64 62 2d 3e 61 44 62 5b 30  geSize(db->aDb[0
3100: 5d 2e 70 42 74 29 3b 0a 0a 20 20 61 73 73 65 72  ].pBt);..  asser
3110: 74 28 20 70 53 6f 72 74 65 72 2d 3e 69 57 72 69  t( pSorter->iWri
3120: 74 65 4f 66 66 3e 69 53 74 61 72 74 20 29 3b 0a  teOff>iStart );.
3130: 20 20 61 73 73 65 72 74 28 20 70 49 74 65 72 2d    assert( pIter-
3140: 3e 61 41 6c 6c 6f 63 3d 3d 30 20 29 3b 0a 20 20  >aAlloc==0 );.  
3150: 61 73 73 65 72 74 28 20 70 49 74 65 72 2d 3e 61  assert( pIter->a
3160: 42 75 66 66 65 72 3d 3d 30 20 29 3b 0a 20 20 70  Buffer==0 );.  p
3170: 49 74 65 72 2d 3e 70 46 69 6c 65 20 3d 20 70 53  Iter->pFile = pS
3180: 6f 72 74 65 72 2d 3e 70 54 65 6d 70 31 3b 0a 20  orter->pTemp1;. 
3190: 20 70 49 74 65 72 2d 3e 69 52 65 61 64 4f 66 66   pIter->iReadOff
31a0: 20 3d 20 69 53 74 61 72 74 3b 0a 20 20 70 49 74   = iStart;.  pIt
31b0: 65 72 2d 3e 6e 41 6c 6c 6f 63 20 3d 20 31 32 38  er->nAlloc = 128
31c0: 3b 0a 20 20 70 49 74 65 72 2d 3e 61 41 6c 6c 6f  ;.  pIter->aAllo
31d0: 63 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 65  c = (u8 *)sqlite
31e0: 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62 2c  3DbMallocRaw(db,
31f0: 20 70 49 74 65 72 2d 3e 6e 41 6c 6c 6f 63 29 3b   pIter->nAlloc);
3200: 0a 20 20 70 49 74 65 72 2d 3e 6e 42 75 66 66 65  .  pIter->nBuffe
3210: 72 20 3d 20 6e 42 75 66 3b 0a 20 20 70 49 74 65  r = nBuf;.  pIte
3220: 72 2d 3e 61 42 75 66 66 65 72 20 3d 20 28 75 38  r->aBuffer = (u8
3230: 20 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c   *)sqlite3DbMall
3240: 6f 63 52 61 77 28 64 62 2c 20 6e 42 75 66 29 3b  ocRaw(db, nBuf);
3250: 0a 0a 20 20 69 66 28 20 21 70 49 74 65 72 2d 3e  ..  if( !pIter->
3260: 61 42 75 66 66 65 72 20 29 7b 0a 20 20 20 20 72  aBuffer ){.    r
3270: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
3280: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69  ;.  }else{.    i
3290: 6e 74 20 69 42 75 66 3b 0a 0a 20 20 20 20 69 42  nt iBuf;..    iB
32a0: 75 66 20 3d 20 69 53 74 61 72 74 20 25 20 6e 42  uf = iStart % nB
32b0: 75 66 3b 0a 20 20 20 20 69 66 28 20 69 42 75 66  uf;.    if( iBuf
32c0: 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 52   ){.      int nR
32d0: 65 61 64 20 3d 20 6e 42 75 66 20 2d 20 69 42 75  ead = nBuf - iBu
32e0: 66 3b 0a 20 20 20 20 20 20 69 66 28 20 28 69 53  f;.      if( (iS
32f0: 74 61 72 74 20 2b 20 6e 52 65 61 64 29 20 3e 20  tart + nRead) > 
3300: 70 53 6f 72 74 65 72 2d 3e 69 57 72 69 74 65 4f  pSorter->iWriteO
3310: 66 66 20 29 7b 0a 20 20 20 20 20 20 20 20 6e 52  ff ){.        nR
3320: 65 61 64 20 3d 20 28 69 6e 74 29 28 70 53 6f 72  ead = (int)(pSor
3330: 74 65 72 2d 3e 69 57 72 69 74 65 4f 66 66 20 2d  ter->iWriteOff -
3340: 20 69 53 74 61 72 74 29 3b 0a 20 20 20 20 20 20   iStart);.      
3350: 7d 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  }.      rc = sql
3360: 69 74 65 33 4f 73 52 65 61 64 28 0a 20 20 20 20  ite3OsRead(.    
3370: 20 20 20 20 20 20 70 53 6f 72 74 65 72 2d 3e 70        pSorter->p
3380: 54 65 6d 70 31 2c 20 26 70 49 74 65 72 2d 3e 61  Temp1, &pIter->a
3390: 42 75 66 66 65 72 5b 69 42 75 66 5d 2c 20 6e 52  Buffer[iBuf], nR
33a0: 65 61 64 2c 20 69 53 74 61 72 74 0a 20 20 20 20  ead, iStart.    
33b0: 20 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72    );.      asser
33c0: 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 49 4f  t( rc!=SQLITE_IO
33d0: 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 29  ERR_SHORT_READ )
33e0: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28  ;.    }..    if(
33f0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
3400: 7b 0a 20 20 20 20 20 20 75 36 34 20 6e 42 79 74  {.      u64 nByt
3410: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e;              
3420: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65           /* Size
3430: 20 6f 66 20 50 4d 41 20 69 6e 20 62 79 74 65 73   of PMA in bytes
3440: 20 2a 2f 0a 20 20 20 20 20 20 70 49 74 65 72 2d   */.      pIter-
3450: 3e 69 45 6f 66 20 3d 20 70 53 6f 72 74 65 72 2d  >iEof = pSorter-
3460: 3e 69 57 72 69 74 65 4f 66 66 3b 0a 20 20 20 20  >iWriteOff;.    
3470: 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72 74 65    rc = vdbeSorte
3480: 72 49 74 65 72 56 61 72 69 6e 74 28 64 62 2c 20  rIterVarint(db, 
3490: 70 49 74 65 72 2c 20 26 6e 42 79 74 65 29 3b 0a  pIter, &nByte);.
34a0: 20 20 20 20 20 20 70 49 74 65 72 2d 3e 69 45 6f        pIter->iEo
34b0: 66 20 3d 20 70 49 74 65 72 2d 3e 69 52 65 61 64  f = pIter->iRead
34c0: 4f 66 66 20 2b 20 6e 42 79 74 65 3b 0a 20 20 20  Off + nByte;.   
34d0: 20 20 20 2a 70 6e 42 79 74 65 20 2b 3d 20 6e 42     *pnByte += nB
34e0: 79 74 65 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  yte;.    }.  }..
34f0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
3500: 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  _OK ){.    rc = 
3510: 76 64 62 65 53 6f 72 74 65 72 49 74 65 72 4e 65  vdbeSorterIterNe
3520: 78 74 28 64 62 2c 20 70 49 74 65 72 29 3b 0a 20  xt(db, pIter);. 
3530: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a   }.  return rc;.
3540: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72  }.../*.** Compar
3550: 65 20 6b 65 79 31 20 28 62 75 66 66 65 72 20 70  e key1 (buffer p
3560: 4b 65 79 31 2c 20 73 69 7a 65 20 6e 4b 65 79 31  Key1, size nKey1
3570: 20 62 79 74 65 73 29 20 77 69 74 68 20 6b 65 79   bytes) with key
3580: 32 20 28 62 75 66 66 65 72 20 70 4b 65 79 32 2c  2 (buffer pKey2,
3590: 20 0a 2a 2a 20 73 69 7a 65 20 6e 4b 65 79 32 20   .** size nKey2 
35a0: 62 79 74 65 73 29 2e 20 20 41 72 67 75 6d 65 6e  bytes).  Argumen
35b0: 74 20 70 4b 65 79 49 6e 66 6f 20 73 75 70 70 6c  t pKeyInfo suppl
35c0: 69 65 73 20 74 68 65 20 63 6f 6c 6c 61 74 69 6f  ies the collatio
35d0: 6e 20 66 75 6e 63 74 69 6f 6e 73 0a 2a 2a 20 75  n functions.** u
35e0: 73 65 64 20 62 79 20 74 68 65 20 63 6f 6d 70 61  sed by the compa
35f0: 72 69 73 6f 6e 2e 20 49 66 20 61 6e 20 65 72 72  rison. If an err
3600: 6f 72 20 6f 63 63 75 72 73 2c 20 72 65 74 75 72  or occurs, retur
3610: 6e 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f  n an SQLite erro
3620: 72 20 63 6f 64 65 2e 0a 2a 2a 20 4f 74 68 65 72  r code..** Other
3630: 77 69 73 65 2c 20 72 65 74 75 72 6e 20 53 51 4c  wise, return SQL
3640: 49 54 45 5f 4f 4b 20 61 6e 64 20 73 65 74 20 2a  ITE_OK and set *
3650: 70 52 65 73 20 74 6f 20 61 20 6e 65 67 61 74 69  pRes to a negati
3660: 76 65 2c 20 7a 65 72 6f 20 6f 72 20 70 6f 73 69  ve, zero or posi
3670: 74 69 76 65 0a 2a 2a 20 76 61 6c 75 65 2c 20 64  tive.** value, d
3680: 65 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 74  epending on whet
3690: 68 65 72 20 6b 65 79 31 20 69 73 20 73 6d 61 6c  her key1 is smal
36a0: 6c 65 72 2c 20 65 71 75 61 6c 20 74 6f 20 6f 72  ler, equal to or
36b0: 20 6c 61 72 67 65 72 20 74 68 61 6e 20 6b 65 79   larger than key
36c0: 32 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20  2..**.** If the 
36d0: 62 4f 6d 69 74 52 6f 77 69 64 20 61 72 67 75 6d  bOmitRowid argum
36e0: 65 6e 74 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c  ent is non-zero,
36f0: 20 61 73 73 75 6d 65 20 62 6f 74 68 20 6b 65 79   assume both key
3700: 73 20 65 6e 64 20 69 6e 20 61 20 72 6f 77 69 64  s end in a rowid
3710: 0a 2a 2a 20 66 69 65 6c 64 2e 20 46 6f 72 20 74  .** field. For t
3720: 68 65 20 70 75 72 70 6f 73 65 73 20 6f 66 20 74  he purposes of t
3730: 68 65 20 63 6f 6d 70 61 72 69 73 6f 6e 2c 20 69  he comparison, i
3740: 67 6e 6f 72 65 20 69 74 2e 20 41 6c 73 6f 2c 20  gnore it. Also, 
3750: 69 66 20 62 4f 6d 69 74 52 6f 77 69 64 0a 2a 2a  if bOmitRowid.**
3760: 20 69 73 20 74 72 75 65 20 61 6e 64 20 6b 65 79   is true and key
3770: 31 20 63 6f 6e 74 61 69 6e 73 20 65 76 65 6e 20  1 contains even 
3780: 61 20 73 69 6e 67 6c 65 20 4e 55 4c 4c 20 76 61  a single NULL va
3790: 6c 75 65 2c 20 69 74 20 69 73 20 63 6f 6e 73 69  lue, it is consi
37a0: 64 65 72 65 64 20 74 6f 0a 2a 2a 20 62 65 20 6c  dered to.** be l
37b0: 65 73 73 20 74 68 61 6e 20 6b 65 79 32 2e 20 45  ess than key2. E
37c0: 76 65 6e 20 69 66 20 6b 65 79 32 20 61 6c 73 6f  ven if key2 also
37d0: 20 63 6f 6e 74 61 69 6e 73 20 4e 55 4c 4c 20 76   contains NULL v
37e0: 61 6c 75 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  alues..**.** If 
37f0: 70 4b 65 79 32 20 69 73 20 70 61 73 73 65 64 20  pKey2 is passed 
3800: 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 2c 20  a NULL pointer, 
3810: 74 68 65 6e 20 69 74 20 69 73 20 61 73 73 75 6d  then it is assum
3820: 65 64 20 74 68 61 74 20 74 68 65 20 70 43 73 72  ed that the pCsr
3830: 2d 3e 61 53 70 61 63 65 0a 2a 2a 20 68 61 73 20  ->aSpace.** has 
3840: 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 20 61  been allocated a
3850: 6e 64 20 63 6f 6e 74 61 69 6e 73 20 61 6e 20 75  nd contains an u
3860: 6e 70 61 63 6b 65 64 20 72 65 63 6f 72 64 20 74  npacked record t
3870: 68 61 74 20 69 73 20 75 73 65 64 20 61 73 20 6b  hat is used as k
3880: 65 79 32 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ey2..*/.static v
3890: 6f 69 64 20 76 64 62 65 53 6f 72 74 65 72 43 6f  oid vdbeSorterCo
38a0: 6d 70 61 72 65 28 0a 20 20 63 6f 6e 73 74 20 56  mpare(.  const V
38b0: 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 2c  dbeCursor *pCsr,
38c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 73           /* Curs
38d0: 6f 72 20 6f 62 6a 65 63 74 20 28 66 6f 72 20 70  or object (for p
38e0: 4b 65 79 49 6e 66 6f 29 20 2a 2f 0a 20 20 69 6e  KeyInfo) */.  in
38f0: 74 20 6e 49 67 6e 6f 72 65 2c 20 20 20 20 20 20  t nIgnore,      
3900: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
3910: 20 49 67 6e 6f 72 65 20 74 68 65 20 6c 61 73 74   Ignore the last
3920: 20 6e 49 67 6e 6f 72 65 20 66 69 65 6c 64 73 20   nIgnore fields 
3930: 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  */.  const void 
3940: 2a 70 4b 65 79 31 2c 20 69 6e 74 20 6e 4b 65 79  *pKey1, int nKey
3950: 31 2c 20 20 20 2f 2a 20 4c 65 66 74 20 73 69 64  1,   /* Left sid
3960: 65 20 6f 66 20 63 6f 6d 70 61 72 69 73 6f 6e 20  e of comparison 
3970: 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  */.  const void 
3980: 2a 70 4b 65 79 32 2c 20 69 6e 74 20 6e 4b 65 79  *pKey2, int nKey
3990: 32 2c 20 20 20 2f 2a 20 52 69 67 68 74 20 73 69  2,   /* Right si
39a0: 64 65 20 6f 66 20 63 6f 6d 70 61 72 69 73 6f 6e  de of comparison
39b0: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 65 73 20   */.  int *pRes 
39c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
39d0: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 52 65        /* OUT: Re
39e0: 73 75 6c 74 20 6f 66 20 63 6f 6d 70 61 72 69 73  sult of comparis
39f0: 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 4b 65 79 49 6e  on */.){.  KeyIn
3a00: 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 20 3d 20 70  fo *pKeyInfo = p
3a10: 43 73 72 2d 3e 70 4b 65 79 49 6e 66 6f 3b 0a 20  Csr->pKeyInfo;. 
3a20: 20 56 64 62 65 53 6f 72 74 65 72 20 2a 70 53 6f   VdbeSorter *pSo
3a30: 72 74 65 72 20 3d 20 70 43 73 72 2d 3e 70 53 6f  rter = pCsr->pSo
3a40: 72 74 65 72 3b 0a 20 20 55 6e 70 61 63 6b 65 64  rter;.  Unpacked
3a50: 52 65 63 6f 72 64 20 2a 72 32 20 3d 20 70 53 6f  Record *r2 = pSo
3a60: 72 74 65 72 2d 3e 70 55 6e 70 61 63 6b 65 64 3b  rter->pUnpacked;
3a70: 0a 20 20 69 6e 74 20 69 3b 0a 0a 20 20 69 66 28  .  int i;..  if(
3a80: 20 70 4b 65 79 32 20 29 7b 0a 20 20 20 20 73 71   pKey2 ){.    sq
3a90: 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 55  lite3VdbeRecordU
3aa0: 6e 70 61 63 6b 28 70 4b 65 79 49 6e 66 6f 2c 20  npack(pKeyInfo, 
3ab0: 6e 4b 65 79 32 2c 20 70 4b 65 79 32 2c 20 72 32  nKey2, pKey2, r2
3ac0: 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 6e 49  );.  }..  if( nI
3ad0: 67 6e 6f 72 65 20 29 7b 0a 20 20 20 20 72 32 2d  gnore ){.    r2-
3ae0: 3e 6e 46 69 65 6c 64 20 3d 20 70 4b 65 79 49 6e  >nField = pKeyIn
3af0: 66 6f 2d 3e 6e 46 69 65 6c 64 20 2d 20 6e 49 67  fo->nField - nIg
3b00: 6e 6f 72 65 3b 0a 20 20 20 20 61 73 73 65 72 74  nore;.    assert
3b10: 28 20 72 32 2d 3e 6e 46 69 65 6c 64 3e 30 20 29  ( r2->nField>0 )
3b20: 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  ;.    for(i=0; i
3b30: 3c 72 32 2d 3e 6e 46 69 65 6c 64 3b 20 69 2b 2b  <r2->nField; i++
3b40: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 72 32 2d  ){.      if( r2-
3b50: 3e 61 4d 65 6d 5b 69 5d 2e 66 6c 61 67 73 20 26  >aMem[i].flags &
3b60: 20 4d 45 4d 5f 4e 75 6c 6c 20 29 7b 0a 20 20 20   MEM_Null ){.   
3b70: 20 20 20 20 20 2a 70 52 65 73 20 3d 20 2d 31 3b       *pRes = -1;
3b80: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 3b  .        return;
3b90: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
3ba0: 20 20 20 61 73 73 65 72 74 28 20 72 32 2d 3e 64     assert( r2->d
3bb0: 65 66 61 75 6c 74 5f 72 63 3d 3d 30 20 29 3b 0a  efault_rc==0 );.
3bc0: 20 20 7d 0a 0a 20 20 2a 70 52 65 73 20 3d 20 73    }..  *pRes = s
3bd0: 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64  qlite3VdbeRecord
3be0: 43 6f 6d 70 61 72 65 28 6e 4b 65 79 31 2c 20 70  Compare(nKey1, p
3bf0: 4b 65 79 31 2c 20 72 32 2c 20 30 29 3b 0a 7d 0a  Key1, r2, 0);.}.
3c00: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
3c10: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74  tion is called t
3c20: 6f 20 63 6f 6d 70 61 72 65 20 74 77 6f 20 69 74  o compare two it
3c30: 65 72 61 74 6f 72 20 6b 65 79 73 20 77 68 65 6e  erator keys when
3c40: 20 6d 65 72 67 69 6e 67 20 0a 2a 2a 20 6d 75 6c   merging .** mul
3c50: 74 69 70 6c 65 20 62 2d 74 72 65 65 20 73 65 67  tiple b-tree seg
3c60: 6d 65 6e 74 73 2e 20 50 61 72 61 6d 65 74 65 72  ments. Parameter
3c70: 20 69 4f 75 74 20 69 73 20 74 68 65 20 69 6e 64   iOut is the ind
3c80: 65 78 20 6f 66 20 74 68 65 20 61 54 72 65 65 5b  ex of the aTree[
3c90: 5d 20 0a 2a 2a 20 76 61 6c 75 65 20 74 6f 20 72  ] .** value to r
3ca0: 65 63 61 6c 63 75 6c 61 74 65 2e 0a 2a 2f 0a 73  ecalculate..*/.s
3cb0: 74 61 74 69 63 20 69 6e 74 20 76 64 62 65 53 6f  tatic int vdbeSo
3cc0: 72 74 65 72 44 6f 43 6f 6d 70 61 72 65 28 63 6f  rterDoCompare(co
3cd0: 6e 73 74 20 56 64 62 65 43 75 72 73 6f 72 20 2a  nst VdbeCursor *
3ce0: 70 43 73 72 2c 20 69 6e 74 20 69 4f 75 74 29 7b  pCsr, int iOut){
3cf0: 0a 20 20 56 64 62 65 53 6f 72 74 65 72 20 2a 70  .  VdbeSorter *p
3d00: 53 6f 72 74 65 72 20 3d 20 70 43 73 72 2d 3e 70  Sorter = pCsr->p
3d10: 53 6f 72 74 65 72 3b 0a 20 20 69 6e 74 20 69 31  Sorter;.  int i1
3d20: 3b 0a 20 20 69 6e 74 20 69 32 3b 0a 20 20 69 6e  ;.  int i2;.  in
3d30: 74 20 69 52 65 73 3b 0a 20 20 56 64 62 65 53 6f  t iRes;.  VdbeSo
3d40: 72 74 65 72 49 74 65 72 20 2a 70 31 3b 0a 20 20  rterIter *p1;.  
3d50: 56 64 62 65 53 6f 72 74 65 72 49 74 65 72 20 2a  VdbeSorterIter *
3d60: 70 32 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 69  p2;..  assert( i
3d70: 4f 75 74 3c 70 53 6f 72 74 65 72 2d 3e 6e 54 72  Out<pSorter->nTr
3d80: 65 65 20 26 26 20 69 4f 75 74 3e 30 20 29 3b 0a  ee && iOut>0 );.
3d90: 0a 20 20 69 66 28 20 69 4f 75 74 3e 3d 28 70 53  .  if( iOut>=(pS
3da0: 6f 72 74 65 72 2d 3e 6e 54 72 65 65 2f 32 29 20  orter->nTree/2) 
3db0: 29 7b 0a 20 20 20 20 69 31 20 3d 20 28 69 4f 75  ){.    i1 = (iOu
3dc0: 74 20 2d 20 70 53 6f 72 74 65 72 2d 3e 6e 54 72  t - pSorter->nTr
3dd0: 65 65 2f 32 29 20 2a 20 32 3b 0a 20 20 20 20 69  ee/2) * 2;.    i
3de0: 32 20 3d 20 69 31 20 2b 20 31 3b 0a 20 20 7d 65  2 = i1 + 1;.  }e
3df0: 6c 73 65 7b 0a 20 20 20 20 69 31 20 3d 20 70 53  lse{.    i1 = pS
3e00: 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 69 4f 75  orter->aTree[iOu
3e10: 74 2a 32 5d 3b 0a 20 20 20 20 69 32 20 3d 20 70  t*2];.    i2 = p
3e20: 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 69 4f  Sorter->aTree[iO
3e30: 75 74 2a 32 2b 31 5d 3b 0a 20 20 7d 0a 0a 20 20  ut*2+1];.  }..  
3e40: 70 31 20 3d 20 26 70 53 6f 72 74 65 72 2d 3e 61  p1 = &pSorter->a
3e50: 49 74 65 72 5b 69 31 5d 3b 0a 20 20 70 32 20 3d  Iter[i1];.  p2 =
3e60: 20 26 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72   &pSorter->aIter
3e70: 5b 69 32 5d 3b 0a 0a 20 20 69 66 28 20 70 31 2d  [i2];..  if( p1-
3e80: 3e 70 46 69 6c 65 3d 3d 30 20 29 7b 0a 20 20 20  >pFile==0 ){.   
3e90: 20 69 52 65 73 20 3d 20 69 32 3b 0a 20 20 7d 65   iRes = i2;.  }e
3ea0: 6c 73 65 20 69 66 28 20 70 32 2d 3e 70 46 69 6c  lse if( p2->pFil
3eb0: 65 3d 3d 30 20 29 7b 0a 20 20 20 20 69 52 65 73  e==0 ){.    iRes
3ec0: 20 3d 20 69 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a   = i1;.  }else{.
3ed0: 20 20 20 20 69 6e 74 20 72 65 73 3b 0a 20 20 20      int res;.   
3ee0: 20 61 73 73 65 72 74 28 20 70 43 73 72 2d 3e 70   assert( pCsr->p
3ef0: 53 6f 72 74 65 72 2d 3e 70 55 6e 70 61 63 6b 65  Sorter->pUnpacke
3f00: 64 21 3d 30 20 29 3b 20 20 2f 2a 20 61 6c 6c 6f  d!=0 );  /* allo
3f10: 63 61 74 65 64 20 69 6e 20 76 64 62 65 53 6f 72  cated in vdbeSor
3f20: 74 65 72 4d 65 72 67 65 28 29 20 2a 2f 0a 20 20  terMerge() */.  
3f30: 20 20 76 64 62 65 53 6f 72 74 65 72 43 6f 6d 70    vdbeSorterComp
3f40: 61 72 65 28 0a 20 20 20 20 20 20 20 20 70 43 73  are(.        pCs
3f50: 72 2c 20 30 2c 20 70 31 2d 3e 61 4b 65 79 2c 20  r, 0, p1->aKey, 
3f60: 70 31 2d 3e 6e 4b 65 79 2c 20 70 32 2d 3e 61 4b  p1->nKey, p2->aK
3f70: 65 79 2c 20 70 32 2d 3e 6e 4b 65 79 2c 20 26 72  ey, p2->nKey, &r
3f80: 65 73 0a 20 20 20 20 29 3b 0a 20 20 20 20 69 66  es.    );.    if
3f90: 28 20 72 65 73 3c 3d 30 20 29 7b 0a 20 20 20 20  ( res<=0 ){.    
3fa0: 20 20 69 52 65 73 20 3d 20 69 31 3b 0a 20 20 20    iRes = i1;.   
3fb0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 69 52   }else{.      iR
3fc0: 65 73 20 3d 20 69 32 3b 0a 20 20 20 20 7d 0a 20  es = i2;.    }. 
3fd0: 20 7d 0a 0a 20 20 70 53 6f 72 74 65 72 2d 3e 61   }..  pSorter->a
3fe0: 54 72 65 65 5b 69 4f 75 74 5d 20 3d 20 69 52 65  Tree[iOut] = iRe
3ff0: 73 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  s;.  return SQLI
4000: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  TE_OK;.}../*.** 
4010: 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 74  Initialize the t
4020: 65 6d 70 6f 72 61 72 79 20 69 6e 64 65 78 20 63  emporary index c
4030: 75 72 73 6f 72 20 6a 75 73 74 20 6f 70 65 6e 65  ursor just opene
4040: 64 20 61 73 20 61 20 73 6f 72 74 65 72 20 63 75  d as a sorter cu
4050: 72 73 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  rsor..*/.int sql
4060: 69 74 65 33 56 64 62 65 53 6f 72 74 65 72 49 6e  ite3VdbeSorterIn
4070: 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  it(sqlite3 *db, 
4080: 56 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72  VdbeCursor *pCsr
4090: 29 7b 0a 20 20 69 6e 74 20 70 67 73 7a 3b 20 20  ){.  int pgsz;  
40a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
40b0: 20 20 20 20 20 2f 2a 20 50 61 67 65 20 73 69 7a       /* Page siz
40c0: 65 20 6f 66 20 6d 61 69 6e 20 64 61 74 61 62 61  e of main databa
40d0: 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 43 61  se */.  int mxCa
40e0: 63 68 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  che;            
40f0: 20 20 20 20 20 20 20 20 2f 2a 20 43 61 63 68 65          /* Cache
4100: 20 73 69 7a 65 20 2a 2f 0a 20 20 56 64 62 65 53   size */.  VdbeS
4110: 6f 72 74 65 72 20 2a 70 53 6f 72 74 65 72 3b 20  orter *pSorter; 
4120: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
4130: 65 20 6e 65 77 20 73 6f 72 74 65 72 20 2a 2f 0a  e new sorter */.
4140: 20 20 63 68 61 72 20 2a 64 3b 20 20 20 20 20 20    char *d;      
4150: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4160: 20 20 2f 2a 20 44 75 6d 6d 79 20 2a 2f 0a 0a 20    /* Dummy */.. 
4170: 20 61 73 73 65 72 74 28 20 70 43 73 72 2d 3e 70   assert( pCsr->p
4180: 4b 65 79 49 6e 66 6f 20 26 26 20 70 43 73 72 2d  KeyInfo && pCsr-
4190: 3e 70 42 74 3d 3d 30 20 29 3b 0a 20 20 70 43 73  >pBt==0 );.  pCs
41a0: 72 2d 3e 70 53 6f 72 74 65 72 20 3d 20 70 53 6f  r->pSorter = pSo
41b0: 72 74 65 72 20 3d 20 73 71 6c 69 74 65 33 44 62  rter = sqlite3Db
41c0: 4d 61 6c 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 73  MallocZero(db, s
41d0: 69 7a 65 6f 66 28 56 64 62 65 53 6f 72 74 65 72  izeof(VdbeSorter
41e0: 29 29 3b 0a 20 20 69 66 28 20 70 53 6f 72 74 65  ));.  if( pSorte
41f0: 72 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  r==0 ){.    retu
4200: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b  rn SQLITE_NOMEM;
4210: 0a 20 20 7d 0a 20 20 0a 20 20 70 53 6f 72 74 65  .  }.  .  pSorte
4220: 72 2d 3e 70 55 6e 70 61 63 6b 65 64 20 3d 20 73  r->pUnpacked = s
4230: 71 6c 69 74 65 33 56 64 62 65 41 6c 6c 6f 63 55  qlite3VdbeAllocU
4240: 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 28 70 43  npackedRecord(pC
4250: 73 72 2d 3e 70 4b 65 79 49 6e 66 6f 2c 20 30 2c  sr->pKeyInfo, 0,
4260: 20 30 2c 20 26 64 29 3b 0a 20 20 69 66 28 20 70   0, &d);.  if( p
4270: 53 6f 72 74 65 72 2d 3e 70 55 6e 70 61 63 6b 65  Sorter->pUnpacke
4280: 64 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51  d==0 ) return SQ
4290: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 61 73  LITE_NOMEM;.  as
42a0: 73 65 72 74 28 20 70 53 6f 72 74 65 72 2d 3e 70  sert( pSorter->p
42b0: 55 6e 70 61 63 6b 65 64 3d 3d 28 55 6e 70 61 63  Unpacked==(Unpac
42c0: 6b 65 64 52 65 63 6f 72 64 20 2a 29 64 20 29 3b  kedRecord *)d );
42d0: 0a 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33  ..  if( !sqlite3
42e0: 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 28 64 62 29  TempInMemory(db)
42f0: 20 29 7b 0a 20 20 20 20 70 67 73 7a 20 3d 20 73   ){.    pgsz = s
4300: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 50 61  qlite3BtreeGetPa
4310: 67 65 53 69 7a 65 28 64 62 2d 3e 61 44 62 5b 30  geSize(db->aDb[0
4320: 5d 2e 70 42 74 29 3b 0a 20 20 20 20 70 53 6f 72  ].pBt);.    pSor
4330: 74 65 72 2d 3e 6d 6e 50 6d 61 53 69 7a 65 20 3d  ter->mnPmaSize =
4340: 20 53 4f 52 54 45 52 5f 4d 49 4e 5f 57 4f 52 4b   SORTER_MIN_WORK
4350: 49 4e 47 20 2a 20 70 67 73 7a 3b 0a 20 20 20 20  ING * pgsz;.    
4360: 6d 78 43 61 63 68 65 20 3d 20 64 62 2d 3e 61 44  mxCache = db->aD
4370: 62 5b 30 5d 2e 70 53 63 68 65 6d 61 2d 3e 63 61  b[0].pSchema->ca
4380: 63 68 65 5f 73 69 7a 65 3b 0a 20 20 20 20 69 66  che_size;.    if
4390: 28 20 6d 78 43 61 63 68 65 3c 53 4f 52 54 45 52  ( mxCache<SORTER
43a0: 5f 4d 49 4e 5f 57 4f 52 4b 49 4e 47 20 29 20 6d  _MIN_WORKING ) m
43b0: 78 43 61 63 68 65 20 3d 20 53 4f 52 54 45 52 5f  xCache = SORTER_
43c0: 4d 49 4e 5f 57 4f 52 4b 49 4e 47 3b 0a 20 20 20  MIN_WORKING;.   
43d0: 20 70 53 6f 72 74 65 72 2d 3e 6d 78 50 6d 61 53   pSorter->mxPmaS
43e0: 69 7a 65 20 3d 20 6d 78 43 61 63 68 65 20 2a 20  ize = mxCache * 
43f0: 70 67 73 7a 3b 0a 20 20 7d 0a 0a 20 20 72 65 74  pgsz;.  }..  ret
4400: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
4410: 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 74 68 65  ../*.** Free the
4420: 20 6c 69 73 74 20 6f 66 20 73 6f 72 74 65 64 20   list of sorted 
4430: 72 65 63 6f 72 64 73 20 73 74 61 72 74 69 6e 67  records starting
4440: 20 61 74 20 70 52 65 63 6f 72 64 2e 0a 2a 2f 0a   at pRecord..*/.
4450: 73 74 61 74 69 63 20 76 6f 69 64 20 76 64 62 65  static void vdbe
4460: 53 6f 72 74 65 72 52 65 63 6f 72 64 46 72 65 65  SorterRecordFree
4470: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 53 6f  (sqlite3 *db, So
4480: 72 74 65 72 52 65 63 6f 72 64 20 2a 70 52 65 63  rterRecord *pRec
4490: 6f 72 64 29 7b 0a 20 20 53 6f 72 74 65 72 52 65  ord){.  SorterRe
44a0: 63 6f 72 64 20 2a 70 3b 0a 20 20 53 6f 72 74 65  cord *p;.  Sorte
44b0: 72 52 65 63 6f 72 64 20 2a 70 4e 65 78 74 3b 0a  rRecord *pNext;.
44c0: 20 20 66 6f 72 28 70 3d 70 52 65 63 6f 72 64 3b    for(p=pRecord;
44d0: 20 70 3b 20 70 3d 70 4e 65 78 74 29 7b 0a 20 20   p; p=pNext){.  
44e0: 20 20 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e 65    pNext = p->pNe
44f0: 78 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44  xt;.    sqlite3D
4500: 62 46 72 65 65 28 64 62 2c 20 70 29 3b 0a 20 20  bFree(db, p);.  
4510: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 73 65 74  }.}../*.** Reset
4520: 20 61 20 73 6f 72 74 69 6e 67 20 63 75 72 73 6f   a sorting curso
4530: 72 20 62 61 63 6b 20 74 6f 20 69 74 73 20 6f 72  r back to its or
4540: 69 67 69 6e 61 6c 20 65 6d 70 74 79 20 73 74 61  iginal empty sta
4550: 74 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  te..*/.void sqli
4560: 74 65 33 56 64 62 65 53 6f 72 74 65 72 52 65 73  te3VdbeSorterRes
4570: 65 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  et(sqlite3 *db, 
4580: 56 64 62 65 53 6f 72 74 65 72 20 2a 70 53 6f 72  VdbeSorter *pSor
4590: 74 65 72 29 7b 0a 20 20 69 66 28 20 70 53 6f 72  ter){.  if( pSor
45a0: 74 65 72 2d 3e 61 49 74 65 72 20 29 7b 0a 20 20  ter->aIter ){.  
45b0: 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72    int i;.    for
45c0: 28 69 3d 30 3b 20 69 3c 70 53 6f 72 74 65 72 2d  (i=0; i<pSorter-
45d0: 3e 6e 54 72 65 65 3b 20 69 2b 2b 29 7b 0a 20 20  >nTree; i++){.  
45e0: 20 20 20 20 76 64 62 65 53 6f 72 74 65 72 49 74      vdbeSorterIt
45f0: 65 72 5a 65 72 6f 28 64 62 2c 20 26 70 53 6f 72  erZero(db, &pSor
4600: 74 65 72 2d 3e 61 49 74 65 72 5b 69 5d 29 3b 0a  ter->aIter[i]);.
4610: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
4620: 33 44 62 46 72 65 65 28 64 62 2c 20 70 53 6f 72  3DbFree(db, pSor
4630: 74 65 72 2d 3e 61 49 74 65 72 29 3b 0a 20 20 20  ter->aIter);.   
4640: 20 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 20   pSorter->aIter 
4650: 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70  = 0;.  }.  if( p
4660: 53 6f 72 74 65 72 2d 3e 70 54 65 6d 70 31 20 29  Sorter->pTemp1 )
4670: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43  {.    sqlite3OsC
4680: 6c 6f 73 65 46 72 65 65 28 70 53 6f 72 74 65 72  loseFree(pSorter
4690: 2d 3e 70 54 65 6d 70 31 29 3b 0a 20 20 20 20 70  ->pTemp1);.    p
46a0: 53 6f 72 74 65 72 2d 3e 70 54 65 6d 70 31 20 3d  Sorter->pTemp1 =
46b0: 20 30 3b 0a 20 20 7d 0a 20 20 76 64 62 65 53 6f   0;.  }.  vdbeSo
46c0: 72 74 65 72 52 65 63 6f 72 64 46 72 65 65 28 64  rterRecordFree(d
46d0: 62 2c 20 70 53 6f 72 74 65 72 2d 3e 70 52 65 63  b, pSorter->pRec
46e0: 6f 72 64 29 3b 0a 20 20 70 53 6f 72 74 65 72 2d  ord);.  pSorter-
46f0: 3e 70 52 65 63 6f 72 64 20 3d 20 30 3b 0a 20 20  >pRecord = 0;.  
4700: 70 53 6f 72 74 65 72 2d 3e 69 57 72 69 74 65 4f  pSorter->iWriteO
4710: 66 66 20 3d 20 30 3b 0a 20 20 70 53 6f 72 74 65  ff = 0;.  pSorte
4720: 72 2d 3e 69 52 65 61 64 4f 66 66 20 3d 20 30 3b  r->iReadOff = 0;
4730: 0a 20 20 70 53 6f 72 74 65 72 2d 3e 6e 49 6e 4d  .  pSorter->nInM
4740: 65 6d 6f 72 79 20 3d 20 30 3b 0a 20 20 70 53 6f  emory = 0;.  pSo
4750: 72 74 65 72 2d 3e 6e 54 72 65 65 20 3d 20 30 3b  rter->nTree = 0;
4760: 0a 20 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d 41  .  pSorter->nPMA
4770: 20 3d 20 30 3b 0a 20 20 70 53 6f 72 74 65 72 2d   = 0;.  pSorter-
4780: 3e 61 54 72 65 65 20 3d 20 30 3b 0a 7d 0a 0a 0a  >aTree = 0;.}...
4790: 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 79 20 63  /*.** Free any c
47a0: 75 72 73 6f 72 20 63 6f 6d 70 6f 6e 65 6e 74 73  ursor components
47b0: 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 73 71   allocated by sq
47c0: 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65 72 58  lite3VdbeSorterX
47d0: 58 58 20 72 6f 75 74 69 6e 65 73 2e 0a 2a 2f 0a  XX routines..*/.
47e0: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
47f0: 53 6f 72 74 65 72 43 6c 6f 73 65 28 73 71 6c 69  SorterClose(sqli
4800: 74 65 33 20 2a 64 62 2c 20 56 64 62 65 43 75 72  te3 *db, VdbeCur
4810: 73 6f 72 20 2a 70 43 73 72 29 7b 0a 20 20 56 64  sor *pCsr){.  Vd
4820: 62 65 53 6f 72 74 65 72 20 2a 70 53 6f 72 74 65  beSorter *pSorte
4830: 72 20 3d 20 70 43 73 72 2d 3e 70 53 6f 72 74 65  r = pCsr->pSorte
4840: 72 3b 0a 20 20 69 66 28 20 70 53 6f 72 74 65 72  r;.  if( pSorter
4850: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56   ){.    sqlite3V
4860: 64 62 65 53 6f 72 74 65 72 52 65 73 65 74 28 64  dbeSorterReset(d
4870: 62 2c 20 70 53 6f 72 74 65 72 29 3b 0a 20 20 20  b, pSorter);.   
4880: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64   sqlite3DbFree(d
4890: 62 2c 20 70 53 6f 72 74 65 72 2d 3e 70 55 6e 70  b, pSorter->pUnp
48a0: 61 63 6b 65 64 29 3b 0a 20 20 20 20 73 71 6c 69  acked);.    sqli
48b0: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 53  te3DbFree(db, pS
48c0: 6f 72 74 65 72 29 3b 0a 20 20 20 20 70 43 73 72  orter);.    pCsr
48d0: 2d 3e 70 53 6f 72 74 65 72 20 3d 20 30 3b 0a 20  ->pSorter = 0;. 
48e0: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f   }.}../*.** Allo
48f0: 63 61 74 65 20 73 70 61 63 65 20 66 6f 72 20 61  cate space for a
4900: 20 66 69 6c 65 2d 68 61 6e 64 6c 65 20 61 6e 64   file-handle and
4910: 20 6f 70 65 6e 20 61 20 74 65 6d 70 6f 72 61 72   open a temporar
4920: 79 20 66 69 6c 65 2e 20 49 66 20 73 75 63 63 65  y file. If succe
4930: 73 73 66 75 6c 2c 0a 2a 2a 20 73 65 74 20 2a 70  ssful,.** set *p
4940: 70 46 69 6c 65 20 74 6f 20 70 6f 69 6e 74 20 74  pFile to point t
4950: 6f 20 74 68 65 20 6d 61 6c 6c 6f 63 27 64 20 66  o the malloc'd f
4960: 69 6c 65 2d 68 61 6e 64 6c 65 20 61 6e 64 20 72  ile-handle and r
4970: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e  eturn SQLITE_OK.
4980: 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 73  .** Otherwise, s
4990: 65 74 20 2a 70 70 46 69 6c 65 20 74 6f 20 30 20  et *ppFile to 0 
49a0: 61 6e 64 20 72 65 74 75 72 6e 20 61 6e 20 53 51  and return an SQ
49b0: 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 2e  Lite error code.
49c0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76  .*/.static int v
49d0: 64 62 65 53 6f 72 74 65 72 4f 70 65 6e 54 65 6d  dbeSorterOpenTem
49e0: 70 46 69 6c 65 28 73 71 6c 69 74 65 33 20 2a 64  pFile(sqlite3 *d
49f0: 62 2c 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20  b, sqlite3_file 
4a00: 2a 2a 70 70 46 69 6c 65 29 7b 0a 20 20 69 6e 74  **ppFile){.  int
4a10: 20 64 75 6d 6d 79 3b 0a 20 20 72 65 74 75 72 6e   dummy;.  return
4a20: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 4d 61   sqlite3OsOpenMa
4a30: 6c 6c 6f 63 28 64 62 2d 3e 70 56 66 73 2c 20 30  lloc(db->pVfs, 0
4a40: 2c 20 70 70 46 69 6c 65 2c 0a 20 20 20 20 20 20  , ppFile,.      
4a50: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50  SQLITE_OPEN_TEMP
4a60: 5f 4a 4f 55 52 4e 41 4c 20 7c 0a 20 20 20 20 20  _JOURNAL |.     
4a70: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41   SQLITE_OPEN_REA
4a80: 44 57 52 49 54 45 20 20 20 20 7c 20 53 51 4c 49  DWRITE    | SQLI
4a90: 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20 7c  TE_OPEN_CREATE |
4aa0: 0a 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50  .      SQLITE_OP
4ab0: 45 4e 5f 45 58 43 4c 55 53 49 56 45 20 20 20 20  EN_EXCLUSIVE    
4ac0: 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45  | SQLITE_OPEN_DE
4ad0: 4c 45 54 45 4f 4e 43 4c 4f 53 45 2c 20 26 64 75  LETEONCLOSE, &du
4ae0: 6d 6d 79 0a 20 20 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  mmy.  );.}../*.*
4af0: 2a 20 4d 65 72 67 65 20 74 68 65 20 74 77 6f 20  * Merge the two 
4b00: 73 6f 72 74 65 64 20 6c 69 73 74 73 20 70 31 20  sorted lists p1 
4b10: 61 6e 64 20 70 32 20 69 6e 74 6f 20 61 20 73 69  and p2 into a si
4b20: 6e 67 6c 65 20 6c 69 73 74 2e 0a 2a 2a 20 53 65  ngle list..** Se
4b30: 74 20 2a 70 70 4f 75 74 20 74 6f 20 74 68 65 20  t *ppOut to the 
4b40: 68 65 61 64 20 6f 66 20 74 68 65 20 6e 65 77 20  head of the new 
4b50: 6c 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  list..*/.static 
4b60: 76 6f 69 64 20 76 64 62 65 53 6f 72 74 65 72 4d  void vdbeSorterM
4b70: 65 72 67 65 28 0a 20 20 63 6f 6e 73 74 20 56 64  erge(.  const Vd
4b80: 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 2c 20  beCursor *pCsr, 
4b90: 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 70          /* For p
4ba0: 4b 65 79 49 6e 66 6f 20 2a 2f 0a 20 20 53 6f 72  KeyInfo */.  Sor
4bb0: 74 65 72 52 65 63 6f 72 64 20 2a 70 31 2c 20 20  terRecord *p1,  
4bc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4bd0: 46 69 72 73 74 20 6c 69 73 74 20 74 6f 20 6d 65  First list to me
4be0: 72 67 65 20 2a 2f 0a 20 20 53 6f 72 74 65 72 52  rge */.  SorterR
4bf0: 65 63 6f 72 64 20 2a 70 32 2c 20 20 20 20 20 20  ecord *p2,      
4c00: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 65 63 6f           /* Seco
4c10: 6e 64 20 6c 69 73 74 20 74 6f 20 6d 65 72 67 65  nd list to merge
4c20: 20 2a 2f 0a 20 20 53 6f 72 74 65 72 52 65 63 6f   */.  SorterReco
4c30: 72 64 20 2a 2a 70 70 4f 75 74 20 20 20 20 20 20  rd **ppOut      
4c40: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 48 65        /* OUT: He
4c50: 61 64 20 6f 66 20 6d 65 72 67 65 64 20 6c 69 73  ad of merged lis
4c60: 74 20 2a 2f 0a 29 7b 0a 20 20 53 6f 72 74 65 72  t */.){.  Sorter
4c70: 52 65 63 6f 72 64 20 2a 70 46 69 6e 61 6c 20 3d  Record *pFinal =
4c80: 20 30 3b 0a 20 20 53 6f 72 74 65 72 52 65 63 6f   0;.  SorterReco
4c90: 72 64 20 2a 2a 70 70 20 3d 20 26 70 46 69 6e 61  rd **pp = &pFina
4ca0: 6c 3b 0a 20 20 76 6f 69 64 20 2a 70 56 61 6c 32  l;.  void *pVal2
4cb0: 20 3d 20 70 32 20 3f 20 70 32 2d 3e 70 56 61 6c   = p2 ? p2->pVal
4cc0: 20 3a 20 30 3b 0a 0a 20 20 77 68 69 6c 65 28 20   : 0;..  while( 
4cd0: 70 31 20 26 26 20 70 32 20 29 7b 0a 20 20 20 20  p1 && p2 ){.    
4ce0: 69 6e 74 20 72 65 73 3b 0a 20 20 20 20 76 64 62  int res;.    vdb
4cf0: 65 53 6f 72 74 65 72 43 6f 6d 70 61 72 65 28 70  eSorterCompare(p
4d00: 43 73 72 2c 20 30 2c 20 70 31 2d 3e 70 56 61 6c  Csr, 0, p1->pVal
4d10: 2c 20 70 31 2d 3e 6e 56 61 6c 2c 20 70 56 61 6c  , p1->nVal, pVal
4d20: 32 2c 20 70 32 2d 3e 6e 56 61 6c 2c 20 26 72 65  2, p2->nVal, &re
4d30: 73 29 3b 0a 20 20 20 20 69 66 28 20 72 65 73 3c  s);.    if( res<
4d40: 3d 30 20 29 7b 0a 20 20 20 20 20 20 2a 70 70 20  =0 ){.      *pp 
4d50: 3d 20 70 31 3b 0a 20 20 20 20 20 20 70 70 20 3d  = p1;.      pp =
4d60: 20 26 70 31 2d 3e 70 4e 65 78 74 3b 0a 20 20 20   &p1->pNext;.   
4d70: 20 20 20 70 31 20 3d 20 70 31 2d 3e 70 4e 65 78     p1 = p1->pNex
4d80: 74 3b 0a 20 20 20 20 20 20 70 56 61 6c 32 20 3d  t;.      pVal2 =
4d90: 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20   0;.    }else{. 
4da0: 20 20 20 20 20 2a 70 70 20 3d 20 70 32 3b 0a 20       *pp = p2;. 
4db0: 20 20 20 20 20 20 70 70 20 3d 20 26 70 32 2d 3e        pp = &p2->
4dc0: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 70 32 20  pNext;.      p2 
4dd0: 3d 20 70 32 2d 3e 70 4e 65 78 74 3b 0a 20 20 20  = p2->pNext;.   
4de0: 20 20 20 69 66 28 20 70 32 3d 3d 30 20 29 20 62     if( p2==0 ) b
4df0: 72 65 61 6b 3b 0a 20 20 20 20 20 20 70 56 61 6c  reak;.      pVal
4e00: 32 20 3d 20 70 32 2d 3e 70 56 61 6c 3b 0a 20 20  2 = p2->pVal;.  
4e10: 20 20 7d 0a 20 20 7d 0a 20 20 2a 70 70 20 3d 20    }.  }.  *pp = 
4e20: 70 31 20 3f 20 70 31 20 3a 20 70 32 3b 0a 20 20  p1 ? p1 : p2;.  
4e30: 2a 70 70 4f 75 74 20 3d 20 70 46 69 6e 61 6c 3b  *ppOut = pFinal;
4e40: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6f 72 74 20 74  .}../*.** Sort t
4e50: 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 6f  he linked list o
4e60: 66 20 72 65 63 6f 72 64 73 20 68 65 61 64 65 64  f records headed
4e70: 20 61 74 20 70 43 73 72 2d 3e 70 52 65 63 6f 72   at pCsr->pRecor
4e80: 64 2e 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45  d. Return SQLITE
4e90: 5f 4f 4b 0a 2a 2a 20 69 66 20 73 75 63 63 65 73  _OK.** if succes
4ea0: 73 66 75 6c 2c 20 6f 72 20 61 6e 20 53 51 4c 69  sful, or an SQLi
4eb0: 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 28 69  te error code (i
4ec0: 2e 65 2e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  .e. SQLITE_NOMEM
4ed0: 29 20 69 66 20 61 6e 20 65 72 72 6f 72 0a 2a 2a  ) if an error.**
4ee0: 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 73 74 61 74   occurs..*/.stat
4ef0: 69 63 20 69 6e 74 20 76 64 62 65 53 6f 72 74 65  ic int vdbeSorte
4f00: 72 53 6f 72 74 28 63 6f 6e 73 74 20 56 64 62 65  rSort(const Vdbe
4f10: 43 75 72 73 6f 72 20 2a 70 43 73 72 29 7b 0a 20  Cursor *pCsr){. 
4f20: 20 69 6e 74 20 69 3b 0a 20 20 53 6f 72 74 65 72   int i;.  Sorter
4f30: 52 65 63 6f 72 64 20 2a 2a 61 53 6c 6f 74 3b 0a  Record **aSlot;.
4f40: 20 20 53 6f 72 74 65 72 52 65 63 6f 72 64 20 2a    SorterRecord *
4f50: 70 3b 0a 20 20 56 64 62 65 53 6f 72 74 65 72 20  p;.  VdbeSorter 
4f60: 2a 70 53 6f 72 74 65 72 20 3d 20 70 43 73 72 2d  *pSorter = pCsr-
4f70: 3e 70 53 6f 72 74 65 72 3b 0a 0a 20 20 61 53 6c  >pSorter;..  aSl
4f80: 6f 74 20 3d 20 28 53 6f 72 74 65 72 52 65 63 6f  ot = (SorterReco
4f90: 72 64 20 2a 2a 29 73 71 6c 69 74 65 33 4d 61 6c  rd **)sqlite3Mal
4fa0: 6c 6f 63 5a 65 72 6f 28 36 34 20 2a 20 73 69 7a  locZero(64 * siz
4fb0: 65 6f 66 28 53 6f 72 74 65 72 52 65 63 6f 72 64  eof(SorterRecord
4fc0: 20 2a 29 29 3b 0a 20 20 69 66 28 20 21 61 53 6c   *));.  if( !aSl
4fd0: 6f 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ot ){.    return
4fe0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
4ff0: 20 7d 0a 0a 20 20 70 20 3d 20 70 53 6f 72 74 65   }..  p = pSorte
5000: 72 2d 3e 70 52 65 63 6f 72 64 3b 0a 20 20 77 68  r->pRecord;.  wh
5010: 69 6c 65 28 20 70 20 29 7b 0a 20 20 20 20 53 6f  ile( p ){.    So
5020: 72 74 65 72 52 65 63 6f 72 64 20 2a 70 4e 65 78  rterRecord *pNex
5030: 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20  t = p->pNext;.  
5040: 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 30 3b 0a    p->pNext = 0;.
5050: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 61 53 6c      for(i=0; aSl
5060: 6f 74 5b 69 5d 3b 20 69 2b 2b 29 7b 0a 20 20 20  ot[i]; i++){.   
5070: 20 20 20 76 64 62 65 53 6f 72 74 65 72 4d 65 72     vdbeSorterMer
5080: 67 65 28 70 43 73 72 2c 20 70 2c 20 61 53 6c 6f  ge(pCsr, p, aSlo
5090: 74 5b 69 5d 2c 20 26 70 29 3b 0a 20 20 20 20 20  t[i], &p);.     
50a0: 20 61 53 6c 6f 74 5b 69 5d 20 3d 20 30 3b 0a 20   aSlot[i] = 0;. 
50b0: 20 20 20 7d 0a 20 20 20 20 61 53 6c 6f 74 5b 69     }.    aSlot[i
50c0: 5d 20 3d 20 70 3b 0a 20 20 20 20 70 20 3d 20 70  ] = p;.    p = p
50d0: 4e 65 78 74 3b 0a 20 20 7d 0a 0a 20 20 70 20 3d  Next;.  }..  p =
50e0: 20 30 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69   0;.  for(i=0; i
50f0: 3c 36 34 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 76  <64; i++){.    v
5100: 64 62 65 53 6f 72 74 65 72 4d 65 72 67 65 28 70  dbeSorterMerge(p
5110: 43 73 72 2c 20 70 2c 20 61 53 6c 6f 74 5b 69 5d  Csr, p, aSlot[i]
5120: 2c 20 26 70 29 3b 0a 20 20 7d 0a 20 20 70 53 6f  , &p);.  }.  pSo
5130: 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 20 3d 20  rter->pRecord = 
5140: 70 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 66 72  p;..  sqlite3_fr
5150: 65 65 28 61 53 6c 6f 74 29 3b 0a 20 20 72 65 74  ee(aSlot);.  ret
5160: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
5170: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69  ../*.** Initiali
5180: 7a 65 20 61 20 66 69 6c 65 2d 77 72 69 74 65 72  ze a file-writer
5190: 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 73 74 61 74   object..*/.stat
51a0: 69 63 20 76 6f 69 64 20 66 69 6c 65 57 72 69 74  ic void fileWrit
51b0: 65 72 49 6e 69 74 28 0a 20 20 73 71 6c 69 74 65  erInit(.  sqlite
51c0: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  3 *db,          
51d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74            /* Dat
51e0: 61 62 61 73 65 20 28 66 6f 72 20 6d 61 6c 6c 6f  abase (for mallo
51f0: 63 29 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  c) */.  sqlite3_
5200: 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 20 20 20  file *pFile,    
5210: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 20          /* File 
5220: 74 6f 20 77 72 69 74 65 20 74 6f 20 2a 2f 0a 20  to write to */. 
5230: 20 46 69 6c 65 57 72 69 74 65 72 20 2a 70 2c 20   FileWriter *p, 
5240: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5250: 20 2f 2a 20 4f 62 6a 65 63 74 20 74 6f 20 70 6f   /* Object to po
5260: 70 75 6c 61 74 65 20 2a 2f 0a 20 20 69 36 34 20  pulate */.  i64 
5270: 69 53 74 61 72 74 20 20 20 20 20 20 20 20 20 20  iStart          
5280: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f              /* O
5290: 66 66 73 65 74 20 6f 66 20 70 46 69 6c 65 20 74  ffset of pFile t
52a0: 6f 20 62 65 67 69 6e 20 77 72 69 74 69 6e 67 20  o begin writing 
52b0: 61 74 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e  at */.){.  int n
52c0: 42 75 66 20 3d 20 73 71 6c 69 74 65 33 42 74 72  Buf = sqlite3Btr
52d0: 65 65 47 65 74 50 61 67 65 53 69 7a 65 28 64 62  eeGetPageSize(db
52e0: 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 0a  ->aDb[0].pBt);..
52f0: 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20 73    memset(p, 0, s
5300: 69 7a 65 6f 66 28 46 69 6c 65 57 72 69 74 65 72  izeof(FileWriter
5310: 29 29 3b 0a 20 20 70 2d 3e 61 42 75 66 66 65 72  ));.  p->aBuffer
5320: 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 65 33   = (u8 *)sqlite3
5330: 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62 2c 20  DbMallocRaw(db, 
5340: 6e 42 75 66 29 3b 0a 20 20 69 66 28 20 21 70 2d  nBuf);.  if( !p-
5350: 3e 61 42 75 66 66 65 72 20 29 7b 0a 20 20 20 20  >aBuffer ){.    
5360: 70 2d 3e 65 46 57 45 72 72 20 3d 20 53 51 4c 49  p->eFWErr = SQLI
5370: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 65 6c 73  TE_NOMEM;.  }els
5380: 65 7b 0a 20 20 20 20 70 2d 3e 69 42 75 66 45 6e  e{.    p->iBufEn
5390: 64 20 3d 20 70 2d 3e 69 42 75 66 53 74 61 72 74  d = p->iBufStart
53a0: 20 3d 20 28 69 53 74 61 72 74 20 25 20 6e 42 75   = (iStart % nBu
53b0: 66 29 3b 0a 20 20 20 20 70 2d 3e 69 57 72 69 74  f);.    p->iWrit
53c0: 65 4f 66 66 20 3d 20 69 53 74 61 72 74 20 2d 20  eOff = iStart - 
53d0: 70 2d 3e 69 42 75 66 53 74 61 72 74 3b 0a 20 20  p->iBufStart;.  
53e0: 20 20 70 2d 3e 6e 42 75 66 66 65 72 20 3d 20 6e    p->nBuffer = n
53f0: 42 75 66 3b 0a 20 20 20 20 70 2d 3e 70 46 69 6c  Buf;.    p->pFil
5400: 65 20 3d 20 70 46 69 6c 65 3b 0a 20 20 7d 0a 7d  e = pFile;.  }.}
5410: 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 6e 44  ../*.** Write nD
5420: 61 74 61 20 62 79 74 65 73 20 6f 66 20 64 61 74  ata bytes of dat
5430: 61 20 74 6f 20 74 68 65 20 66 69 6c 65 2d 77 72  a to the file-wr
5440: 69 74 65 20 6f 62 6a 65 63 74 2e 20 52 65 74 75  ite object. Retu
5450: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20  rn SQLITE_OK.** 
5460: 69 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 6f  if successful, o
5470: 72 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f  r an SQLite erro
5480: 72 20 63 6f 64 65 20 69 66 20 61 6e 20 65 72 72  r code if an err
5490: 6f 72 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 73 74  or occurs..*/.st
54a0: 61 74 69 63 20 76 6f 69 64 20 66 69 6c 65 57 72  atic void fileWr
54b0: 69 74 65 72 57 72 69 74 65 28 46 69 6c 65 57 72  iterWrite(FileWr
54c0: 69 74 65 72 20 2a 70 2c 20 75 38 20 2a 70 44 61  iter *p, u8 *pDa
54d0: 74 61 2c 20 69 6e 74 20 6e 44 61 74 61 29 7b 0a  ta, int nData){.
54e0: 20 20 69 6e 74 20 6e 52 65 6d 20 3d 20 6e 44 61    int nRem = nDa
54f0: 74 61 3b 0a 20 20 77 68 69 6c 65 28 20 6e 52 65  ta;.  while( nRe
5500: 6d 3e 30 20 26 26 20 70 2d 3e 65 46 57 45 72 72  m>0 && p->eFWErr
5510: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e  ==0 ){.    int n
5520: 43 6f 70 79 20 3d 20 6e 52 65 6d 3b 0a 20 20 20  Copy = nRem;.   
5530: 20 69 66 28 20 6e 43 6f 70 79 3e 28 70 2d 3e 6e   if( nCopy>(p->n
5540: 42 75 66 66 65 72 20 2d 20 70 2d 3e 69 42 75 66  Buffer - p->iBuf
5550: 45 6e 64 29 20 29 7b 0a 20 20 20 20 20 20 6e 43  End) ){.      nC
5560: 6f 70 79 20 3d 20 70 2d 3e 6e 42 75 66 66 65 72  opy = p->nBuffer
5570: 20 2d 20 70 2d 3e 69 42 75 66 45 6e 64 3b 0a 20   - p->iBufEnd;. 
5580: 20 20 20 7d 0a 0a 20 20 20 20 6d 65 6d 63 70 79     }..    memcpy
5590: 28 26 70 2d 3e 61 42 75 66 66 65 72 5b 70 2d 3e  (&p->aBuffer[p->
55a0: 69 42 75 66 45 6e 64 5d 2c 20 26 70 44 61 74 61  iBufEnd], &pData
55b0: 5b 6e 44 61 74 61 2d 6e 52 65 6d 5d 2c 20 6e 43  [nData-nRem], nC
55c0: 6f 70 79 29 3b 0a 20 20 20 20 70 2d 3e 69 42 75  opy);.    p->iBu
55d0: 66 45 6e 64 20 2b 3d 20 6e 43 6f 70 79 3b 0a 20  fEnd += nCopy;. 
55e0: 20 20 20 69 66 28 20 70 2d 3e 69 42 75 66 45 6e     if( p->iBufEn
55f0: 64 3d 3d 70 2d 3e 6e 42 75 66 66 65 72 20 29 7b  d==p->nBuffer ){
5600: 0a 20 20 20 20 20 20 70 2d 3e 65 46 57 45 72 72  .      p->eFWErr
5610: 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74   = sqlite3OsWrit
5620: 65 28 70 2d 3e 70 46 69 6c 65 2c 20 0a 20 20 20  e(p->pFile, .   
5630: 20 20 20 20 20 20 20 26 70 2d 3e 61 42 75 66 66         &p->aBuff
5640: 65 72 5b 70 2d 3e 69 42 75 66 53 74 61 72 74 5d  er[p->iBufStart]
5650: 2c 20 70 2d 3e 69 42 75 66 45 6e 64 20 2d 20 70  , p->iBufEnd - p
5660: 2d 3e 69 42 75 66 53 74 61 72 74 2c 20 0a 20 20  ->iBufStart, .  
5670: 20 20 20 20 20 20 20 20 70 2d 3e 69 57 72 69 74          p->iWrit
5680: 65 4f 66 66 20 2b 20 70 2d 3e 69 42 75 66 53 74  eOff + p->iBufSt
5690: 61 72 74 0a 20 20 20 20 20 20 29 3b 0a 20 20 20  art.      );.   
56a0: 20 20 20 70 2d 3e 69 42 75 66 53 74 61 72 74 20     p->iBufStart 
56b0: 3d 20 70 2d 3e 69 42 75 66 45 6e 64 20 3d 20 30  = p->iBufEnd = 0
56c0: 3b 0a 20 20 20 20 20 20 70 2d 3e 69 57 72 69 74  ;.      p->iWrit
56d0: 65 4f 66 66 20 2b 3d 20 70 2d 3e 6e 42 75 66 66  eOff += p->nBuff
56e0: 65 72 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73  er;.    }.    as
56f0: 73 65 72 74 28 20 70 2d 3e 69 42 75 66 45 6e 64  sert( p->iBufEnd
5700: 3c 70 2d 3e 6e 42 75 66 66 65 72 20 29 3b 0a 0a  <p->nBuffer );..
5710: 20 20 20 20 6e 52 65 6d 20 2d 3d 20 6e 43 6f 70      nRem -= nCop
5720: 79 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  y;.  }.}../*.** 
5730: 46 6c 75 73 68 20 61 6e 79 20 62 75 66 66 65 72  Flush any buffer
5740: 65 64 20 64 61 74 61 20 74 6f 20 64 69 73 6b 20  ed data to disk 
5750: 61 6e 64 20 63 6c 65 61 6e 20 75 70 20 74 68 65  and clean up the
5760: 20 66 69 6c 65 2d 77 72 69 74 65 72 20 6f 62 6a   file-writer obj
5770: 65 63 74 2e 0a 2a 2a 20 54 68 65 20 72 65 73 75  ect..** The resu
5780: 6c 74 73 20 6f 66 20 75 73 69 6e 67 20 74 68 65  lts of using the
5790: 20 66 69 6c 65 2d 77 72 69 74 65 72 20 61 66 74   file-writer aft
57a0: 65 72 20 74 68 69 73 20 63 61 6c 6c 20 61 72 65  er this call are
57b0: 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2a 20 52   undefined..** R
57c0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20  eturn SQLITE_OK 
57d0: 69 66 20 66 6c 75 73 68 69 6e 67 20 74 68 65 20  if flushing the 
57e0: 62 75 66 66 65 72 65 64 20 64 61 74 61 20 73 75  buffered data su
57f0: 63 63 65 65 64 73 20 6f 72 20 69 73 20 6e 6f 74  cceeds or is not
5800: 20 0a 2a 2a 20 72 65 71 75 69 72 65 64 2e 20 4f   .** required. O
5810: 74 68 65 72 77 69 73 65 2c 20 72 65 74 75 72 6e  therwise, return
5820: 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72   an SQLite error
5830: 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 42 65 66   code..**.** Bef
5840: 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2c 20 73  ore returning, s
5850: 65 74 20 2a 70 69 45 6f 66 20 74 6f 20 74 68 65  et *piEof to the
5860: 20 6f 66 66 73 65 74 20 69 6d 6d 65 64 69 61 74   offset immediat
5870: 65 6c 79 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68  ely following th
5880: 65 0a 2a 2a 20 6c 61 73 74 20 62 79 74 65 20 77  e.** last byte w
5890: 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 66 69  ritten to the fi
58a0: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  le..*/.static in
58b0: 74 20 66 69 6c 65 57 72 69 74 65 72 46 69 6e 69  t fileWriterFini
58c0: 73 68 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  sh(sqlite3 *db, 
58d0: 46 69 6c 65 57 72 69 74 65 72 20 2a 70 2c 20 69  FileWriter *p, i
58e0: 36 34 20 2a 70 69 45 6f 66 29 7b 0a 20 20 69 6e  64 *piEof){.  in
58f0: 74 20 72 63 3b 0a 20 20 69 66 28 20 70 2d 3e 65  t rc;.  if( p->e
5900: 46 57 45 72 72 3d 3d 30 20 26 26 20 41 4c 57 41  FWErr==0 && ALWA
5910: 59 53 28 70 2d 3e 61 42 75 66 66 65 72 29 20 26  YS(p->aBuffer) &
5920: 26 20 70 2d 3e 69 42 75 66 45 6e 64 3e 70 2d 3e  & p->iBufEnd>p->
5930: 69 42 75 66 53 74 61 72 74 20 29 7b 0a 20 20 20  iBufStart ){.   
5940: 20 70 2d 3e 65 46 57 45 72 72 20 3d 20 73 71 6c   p->eFWErr = sql
5950: 69 74 65 33 4f 73 57 72 69 74 65 28 70 2d 3e 70  ite3OsWrite(p->p
5960: 46 69 6c 65 2c 20 0a 20 20 20 20 20 20 20 20 26  File, .        &
5970: 70 2d 3e 61 42 75 66 66 65 72 5b 70 2d 3e 69 42  p->aBuffer[p->iB
5980: 75 66 53 74 61 72 74 5d 2c 20 70 2d 3e 69 42 75  ufStart], p->iBu
5990: 66 45 6e 64 20 2d 20 70 2d 3e 69 42 75 66 53 74  fEnd - p->iBufSt
59a0: 61 72 74 2c 20 0a 20 20 20 20 20 20 20 20 70 2d  art, .        p-
59b0: 3e 69 57 72 69 74 65 4f 66 66 20 2b 20 70 2d 3e  >iWriteOff + p->
59c0: 69 42 75 66 53 74 61 72 74 0a 20 20 20 20 29 3b  iBufStart.    );
59d0: 0a 20 20 7d 0a 20 20 2a 70 69 45 6f 66 20 3d 20  .  }.  *piEof = 
59e0: 28 70 2d 3e 69 57 72 69 74 65 4f 66 66 20 2b 20  (p->iWriteOff + 
59f0: 70 2d 3e 69 42 75 66 45 6e 64 29 3b 0a 20 20 73  p->iBufEnd);.  s
5a00: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c  qlite3DbFree(db,
5a10: 20 70 2d 3e 61 42 75 66 66 65 72 29 3b 0a 20 20   p->aBuffer);.  
5a20: 72 63 20 3d 20 70 2d 3e 65 46 57 45 72 72 3b 0a  rc = p->eFWErr;.
5a30: 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20 73    memset(p, 0, s
5a40: 69 7a 65 6f 66 28 46 69 6c 65 57 72 69 74 65 72  izeof(FileWriter
5a50: 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  ));.  return rc;
5a60: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20  .}../*.** Write 
5a70: 76 61 6c 75 65 20 69 56 61 6c 20 65 6e 63 6f 64  value iVal encod
5a80: 65 64 20 61 73 20 61 20 76 61 72 69 6e 74 20 74  ed as a varint t
5a90: 6f 20 74 68 65 20 66 69 6c 65 2d 77 72 69 74 65  o the file-write
5aa0: 20 6f 62 6a 65 63 74 2e 20 52 65 74 75 72 6e 20   object. Return 
5ab0: 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66  .** SQLITE_OK if
5ac0: 20 73 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 20   successful, or 
5ad0: 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20  an SQLite error 
5ae0: 63 6f 64 65 20 69 66 20 61 6e 20 65 72 72 6f 72  code if an error
5af0: 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 73 74 61 74   occurs..*/.stat
5b00: 69 63 20 76 6f 69 64 20 66 69 6c 65 57 72 69 74  ic void fileWrit
5b10: 65 72 57 72 69 74 65 56 61 72 69 6e 74 28 46 69  erWriteVarint(Fi
5b20: 6c 65 57 72 69 74 65 72 20 2a 70 2c 20 75 36 34  leWriter *p, u64
5b30: 20 69 56 61 6c 29 7b 0a 20 20 69 6e 74 20 6e 42   iVal){.  int nB
5b40: 79 74 65 3b 20 0a 20 20 75 38 20 61 42 79 74 65  yte; .  u8 aByte
5b50: 5b 31 30 5d 3b 0a 20 20 6e 42 79 74 65 20 3d 20  [10];.  nByte = 
5b60: 73 71 6c 69 74 65 33 50 75 74 56 61 72 69 6e 74  sqlite3PutVarint
5b70: 28 61 42 79 74 65 2c 20 69 56 61 6c 29 3b 0a 20  (aByte, iVal);. 
5b80: 20 66 69 6c 65 57 72 69 74 65 72 57 72 69 74 65   fileWriterWrite
5b90: 28 70 2c 20 61 42 79 74 65 2c 20 6e 42 79 74 65  (p, aByte, nByte
5ba0: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74  );.}../*.** Writ
5bb0: 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f  e the current co
5bc0: 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 69 6e  ntents of the in
5bd0: 2d 6d 65 6d 6f 72 79 20 6c 69 6e 6b 65 64 2d 6c  -memory linked-l
5be0: 69 73 74 20 74 6f 20 61 20 50 4d 41 2e 20 52 65  ist to a PMA. Re
5bf0: 74 75 72 6e 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f  turn.** SQLITE_O
5c00: 4b 20 69 66 20 73 75 63 63 65 73 73 66 75 6c 2c  K if successful,
5c10: 20 6f 72 20 61 6e 20 53 51 4c 69 74 65 20 65 72   or an SQLite er
5c20: 72 6f 72 20 63 6f 64 65 20 6f 74 68 65 72 77 69  ror code otherwi
5c30: 73 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f  se..**.** The fo
5c40: 72 6d 61 74 20 6f 66 20 61 20 50 4d 41 20 69 73  rmat of a PMA is
5c50: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 2a 20 41 20  :.**.**     * A 
5c60: 76 61 72 69 6e 74 2e 20 54 68 69 73 20 76 61 72  varint. This var
5c70: 69 6e 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65  int contains the
5c80: 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66   total number of
5c90: 20 62 79 74 65 73 20 6f 66 20 63 6f 6e 74 65 6e   bytes of conten
5ca0: 74 0a 2a 2a 20 20 20 20 20 20 20 69 6e 20 74 68  t.**       in th
5cb0: 65 20 50 4d 41 20 28 6e 6f 74 20 69 6e 63 6c 75  e PMA (not inclu
5cc0: 64 69 6e 67 20 74 68 65 20 76 61 72 69 6e 74 20  ding the varint 
5cd0: 69 74 73 65 6c 66 29 2e 0a 2a 2a 0a 2a 2a 20 20  itself)..**.**  
5ce0: 20 20 20 2a 20 4f 6e 65 20 6f 72 20 6d 6f 72 65     * One or more
5cf0: 20 72 65 63 6f 72 64 73 20 70 61 63 6b 65 64 20   records packed 
5d00: 65 6e 64 2d 74 6f 2d 65 6e 64 20 69 6e 20 6f 72  end-to-end in or
5d10: 64 65 72 20 6f 66 20 61 73 63 65 6e 64 69 6e 67  der of ascending
5d20: 20 6b 65 79 73 2e 20 0a 2a 2a 20 20 20 20 20 20   keys. .**      
5d30: 20 45 61 63 68 20 72 65 63 6f 72 64 20 63 6f 6e   Each record con
5d40: 73 69 73 74 73 20 6f 66 20 61 20 76 61 72 69 6e  sists of a varin
5d50: 74 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20  t followed by a 
5d60: 62 6c 6f 62 20 6f 66 20 64 61 74 61 20 28 74 68  blob of data (th
5d70: 65 20 0a 2a 2a 20 20 20 20 20 20 20 6b 65 79 29  e .**       key)
5d80: 2e 20 54 68 65 20 76 61 72 69 6e 74 20 69 73 20  . The varint is 
5d90: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79  the number of by
5da0: 74 65 73 20 69 6e 20 74 68 65 20 62 6c 6f 62 20  tes in the blob 
5db0: 6f 66 20 64 61 74 61 2e 0a 2a 2f 0a 73 74 61 74  of data..*/.stat
5dc0: 69 63 20 69 6e 74 20 76 64 62 65 53 6f 72 74 65  ic int vdbeSorte
5dd0: 72 4c 69 73 74 54 6f 50 4d 41 28 73 71 6c 69 74  rListToPMA(sqlit
5de0: 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 56 64  e3 *db, const Vd
5df0: 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 29 7b  beCursor *pCsr){
5e00: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49  .  int rc = SQLI
5e10: 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20  TE_OK;          
5e20: 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64     /* Return cod
5e30: 65 20 2a 2f 0a 20 20 56 64 62 65 53 6f 72 74 65  e */.  VdbeSorte
5e40: 72 20 2a 70 53 6f 72 74 65 72 20 3d 20 70 43 73  r *pSorter = pCs
5e50: 72 2d 3e 70 53 6f 72 74 65 72 3b 0a 20 20 46 69  r->pSorter;.  Fi
5e60: 6c 65 57 72 69 74 65 72 20 77 72 69 74 65 72 3b  leWriter writer;
5e70: 0a 0a 20 20 6d 65 6d 73 65 74 28 26 77 72 69 74  ..  memset(&writ
5e80: 65 72 2c 20 30 2c 20 73 69 7a 65 6f 66 28 46 69  er, 0, sizeof(Fi
5e90: 6c 65 57 72 69 74 65 72 29 29 3b 0a 0a 20 20 69  leWriter));..  i
5ea0: 66 28 20 70 53 6f 72 74 65 72 2d 3e 6e 49 6e 4d  f( pSorter->nInM
5eb0: 65 6d 6f 72 79 3d 3d 30 20 29 7b 0a 20 20 20 20  emory==0 ){.    
5ec0: 61 73 73 65 72 74 28 20 70 53 6f 72 74 65 72 2d  assert( pSorter-
5ed0: 3e 70 52 65 63 6f 72 64 3d 3d 30 20 29 3b 0a 20  >pRecord==0 );. 
5ee0: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
5ef0: 7d 0a 0a 20 20 72 63 20 3d 20 76 64 62 65 53 6f  }..  rc = vdbeSo
5f00: 72 74 65 72 53 6f 72 74 28 70 43 73 72 29 3b 0a  rterSort(pCsr);.
5f10: 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 66 69 72  .  /* If the fir
5f20: 73 74 20 74 65 6d 70 6f 72 61 72 79 20 50 4d 41  st temporary PMA
5f30: 20 66 69 6c 65 20 68 61 73 20 6e 6f 74 20 62 65   file has not be
5f40: 65 6e 20 6f 70 65 6e 65 64 2c 20 6f 70 65 6e 20  en opened, open 
5f50: 69 74 20 6e 6f 77 2e 20 2a 2f 0a 20 20 69 66 28  it now. */.  if(
5f60: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
5f70: 26 20 70 53 6f 72 74 65 72 2d 3e 70 54 65 6d 70  & pSorter->pTemp
5f80: 31 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 20 3d  1==0 ){.    rc =
5f90: 20 76 64 62 65 53 6f 72 74 65 72 4f 70 65 6e 54   vdbeSorterOpenT
5fa0: 65 6d 70 46 69 6c 65 28 64 62 2c 20 26 70 53 6f  empFile(db, &pSo
5fb0: 72 74 65 72 2d 3e 70 54 65 6d 70 31 29 3b 0a 20  rter->pTemp1);. 
5fc0: 20 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53     assert( rc!=S
5fd0: 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 53 6f 72  QLITE_OK || pSor
5fe0: 74 65 72 2d 3e 70 54 65 6d 70 31 20 29 3b 0a 20  ter->pTemp1 );. 
5ff0: 20 20 20 61 73 73 65 72 74 28 20 70 53 6f 72 74     assert( pSort
6000: 65 72 2d 3e 69 57 72 69 74 65 4f 66 66 3d 3d 30  er->iWriteOff==0
6010: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20   );.    assert( 
6020: 70 53 6f 72 74 65 72 2d 3e 6e 50 4d 41 3d 3d 30  pSorter->nPMA==0
6030: 20 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72   );.  }..  if( r
6040: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
6050: 20 20 20 20 53 6f 72 74 65 72 52 65 63 6f 72 64      SorterRecord
6060: 20 2a 70 3b 0a 20 20 20 20 53 6f 72 74 65 72 52   *p;.    SorterR
6070: 65 63 6f 72 64 20 2a 70 4e 65 78 74 20 3d 20 30  ecord *pNext = 0
6080: 3b 0a 0a 20 20 20 20 66 69 6c 65 57 72 69 74 65  ;..    fileWrite
6090: 72 49 6e 69 74 28 64 62 2c 20 70 53 6f 72 74 65  rInit(db, pSorte
60a0: 72 2d 3e 70 54 65 6d 70 31 2c 20 26 77 72 69 74  r->pTemp1, &writ
60b0: 65 72 2c 20 70 53 6f 72 74 65 72 2d 3e 69 57 72  er, pSorter->iWr
60c0: 69 74 65 4f 66 66 29 3b 0a 20 20 20 20 70 53 6f  iteOff);.    pSo
60d0: 72 74 65 72 2d 3e 6e 50 4d 41 2b 2b 3b 0a 20 20  rter->nPMA++;.  
60e0: 20 20 66 69 6c 65 57 72 69 74 65 72 57 72 69 74    fileWriterWrit
60f0: 65 56 61 72 69 6e 74 28 26 77 72 69 74 65 72 2c  eVarint(&writer,
6100: 20 70 53 6f 72 74 65 72 2d 3e 6e 49 6e 4d 65 6d   pSorter->nInMem
6110: 6f 72 79 29 3b 0a 20 20 20 20 66 6f 72 28 70 3d  ory);.    for(p=
6120: 70 53 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72 64  pSorter->pRecord
6130: 3b 20 70 3b 20 70 3d 70 4e 65 78 74 29 7b 0a 20  ; p; p=pNext){. 
6140: 20 20 20 20 20 70 4e 65 78 74 20 3d 20 70 2d 3e       pNext = p->
6150: 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 66 69 6c  pNext;.      fil
6160: 65 57 72 69 74 65 72 57 72 69 74 65 56 61 72 69  eWriterWriteVari
6170: 6e 74 28 26 77 72 69 74 65 72 2c 20 70 2d 3e 6e  nt(&writer, p->n
6180: 56 61 6c 29 3b 0a 20 20 20 20 20 20 66 69 6c 65  Val);.      file
6190: 57 72 69 74 65 72 57 72 69 74 65 28 26 77 72 69  WriterWrite(&wri
61a0: 74 65 72 2c 20 70 2d 3e 70 56 61 6c 2c 20 70 2d  ter, p->pVal, p-
61b0: 3e 6e 56 61 6c 29 3b 0a 20 20 20 20 20 20 73 71  >nVal);.      sq
61c0: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20  lite3DbFree(db, 
61d0: 70 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 53  p);.    }.    pS
61e0: 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 20 3d  orter->pRecord =
61f0: 20 70 3b 0a 20 20 20 20 72 63 20 3d 20 66 69 6c   p;.    rc = fil
6200: 65 57 72 69 74 65 72 46 69 6e 69 73 68 28 64 62  eWriterFinish(db
6210: 2c 20 26 77 72 69 74 65 72 2c 20 26 70 53 6f 72  , &writer, &pSor
6220: 74 65 72 2d 3e 69 57 72 69 74 65 4f 66 66 29 3b  ter->iWriteOff);
6230: 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72  .  }..  return r
6240: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20  c;.}../*.** Add 
6250: 61 20 72 65 63 6f 72 64 20 74 6f 20 74 68 65 20  a record to the 
6260: 73 6f 72 74 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73  sorter..*/.int s
6270: 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65 72  qlite3VdbeSorter
6280: 57 72 69 74 65 28 0a 20 20 73 71 6c 69 74 65 33  Write(.  sqlite3
6290: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20   *db,           
62a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61           /* Data
62b0: 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20  base handle */. 
62c0: 20 63 6f 6e 73 74 20 56 64 62 65 43 75 72 73 6f   const VdbeCurso
62d0: 72 20 2a 70 43 73 72 2c 20 20 20 20 20 20 20 20  r *pCsr,        
62e0: 20 20 20 20 20 20 20 2f 2a 20 53 6f 72 74 65 72         /* Sorter
62f0: 20 63 75 72 73 6f 72 20 2a 2f 0a 20 20 4d 65 6d   cursor */.  Mem
6300: 20 2a 70 56 61 6c 20 20 20 20 20 20 20 20 20 20   *pVal          
6310: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
6320: 4d 65 6d 6f 72 79 20 63 65 6c 6c 20 63 6f 6e 74  Memory cell cont
6330: 61 69 6e 69 6e 67 20 72 65 63 6f 72 64 20 2a 2f  aining record */
6340: 0a 29 7b 0a 20 20 56 64 62 65 53 6f 72 74 65 72  .){.  VdbeSorter
6350: 20 2a 70 53 6f 72 74 65 72 20 3d 20 70 43 73 72   *pSorter = pCsr
6360: 2d 3e 70 53 6f 72 74 65 72 3b 0a 20 20 69 6e 74  ->pSorter;.  int
6370: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
6380: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
6390: 52 65 74 75 72 6e 20 43 6f 64 65 20 2a 2f 0a 20  Return Code */. 
63a0: 20 53 6f 72 74 65 72 52 65 63 6f 72 64 20 2a 70   SorterRecord *p
63b0: 4e 65 77 3b 20 20 20 20 20 20 20 20 20 20 20 20  New;            
63c0: 20 2f 2a 20 4e 65 77 20 6c 69 73 74 20 65 6c 65   /* New list ele
63d0: 6d 65 6e 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72  ment */..  asser
63e0: 74 28 20 70 53 6f 72 74 65 72 20 29 3b 0a 20 20  t( pSorter );.  
63f0: 70 53 6f 72 74 65 72 2d 3e 6e 49 6e 4d 65 6d 6f  pSorter->nInMemo
6400: 72 79 20 2b 3d 20 73 71 6c 69 74 65 33 56 61 72  ry += sqlite3Var
6410: 69 6e 74 4c 65 6e 28 70 56 61 6c 2d 3e 6e 29 20  intLen(pVal->n) 
6420: 2b 20 70 56 61 6c 2d 3e 6e 3b 0a 0a 20 20 70 4e  + pVal->n;..  pN
6430: 65 77 20 3d 20 28 53 6f 72 74 65 72 52 65 63 6f  ew = (SorterReco
6440: 72 64 20 2a 29 73 71 6c 69 74 65 33 44 62 4d 61  rd *)sqlite3DbMa
6450: 6c 6c 6f 63 52 61 77 28 64 62 2c 20 70 56 61 6c  llocRaw(db, pVal
6460: 2d 3e 6e 20 2b 20 73 69 7a 65 6f 66 28 53 6f 72  ->n + sizeof(Sor
6470: 74 65 72 52 65 63 6f 72 64 29 29 3b 0a 20 20 69  terRecord));.  i
6480: 66 28 20 70 4e 65 77 3d 3d 30 20 29 7b 0a 20 20  f( pNew==0 ){.  
6490: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f    rc = SQLITE_NO
64a0: 4d 45 4d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  MEM;.  }else{.  
64b0: 20 20 70 4e 65 77 2d 3e 70 56 61 6c 20 3d 20 28    pNew->pVal = (
64c0: 76 6f 69 64 20 2a 29 26 70 4e 65 77 5b 31 5d 3b  void *)&pNew[1];
64d0: 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 4e 65 77  .    memcpy(pNew
64e0: 2d 3e 70 56 61 6c 2c 20 70 56 61 6c 2d 3e 7a 2c  ->pVal, pVal->z,
64f0: 20 70 56 61 6c 2d 3e 6e 29 3b 0a 20 20 20 20 70   pVal->n);.    p
6500: 4e 65 77 2d 3e 6e 56 61 6c 20 3d 20 70 56 61 6c  New->nVal = pVal
6510: 2d 3e 6e 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 70  ->n;.    pNew->p
6520: 4e 65 78 74 20 3d 20 70 53 6f 72 74 65 72 2d 3e  Next = pSorter->
6530: 70 52 65 63 6f 72 64 3b 0a 20 20 20 20 70 53 6f  pRecord;.    pSo
6540: 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 20 3d 20  rter->pRecord = 
6550: 70 4e 65 77 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  pNew;.  }..  /* 
6560: 53 65 65 20 69 66 20 74 68 65 20 63 6f 6e 74 65  See if the conte
6570: 6e 74 73 20 6f 66 20 74 68 65 20 73 6f 72 74 65  nts of the sorte
6580: 72 20 73 68 6f 75 6c 64 20 6e 6f 77 20 62 65 20  r should now be 
6590: 77 72 69 74 74 65 6e 20 6f 75 74 2e 20 54 68 65  written out. The
65a0: 79 0a 20 20 2a 2a 20 61 72 65 20 77 72 69 74 74  y.  ** are writt
65b0: 65 6e 20 6f 75 74 20 77 68 65 6e 20 65 69 74 68  en out when eith
65c0: 65 72 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77  er of the follow
65d0: 69 6e 67 20 61 72 65 20 74 72 75 65 3a 0a 20 20  ing are true:.  
65e0: 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 54 68 65 20  **.  **   * The 
65f0: 74 6f 74 61 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c  total memory all
6600: 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 20 69  ocated for the i
6610: 6e 2d 6d 65 6d 6f 72 79 20 6c 69 73 74 20 69 73  n-memory list is
6620: 20 67 72 65 61 74 65 72 20 0a 20 20 2a 2a 20 20   greater .  **  
6630: 20 20 20 74 68 61 6e 20 28 70 61 67 65 2d 73 69     than (page-si
6640: 7a 65 20 2a 20 63 61 63 68 65 2d 73 69 7a 65 29  ze * cache-size)
6650: 2c 20 6f 72 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20  , or.  **.  **  
6660: 20 2a 20 54 68 65 20 74 6f 74 61 6c 20 6d 65 6d   * The total mem
6670: 6f 72 79 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f  ory allocated fo
6680: 72 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20  r the in-memory 
6690: 6c 69 73 74 20 69 73 20 67 72 65 61 74 65 72 20  list is greater 
66a0: 0a 20 20 2a 2a 20 20 20 20 20 74 68 61 6e 20 28  .  **     than (
66b0: 70 61 67 65 2d 73 69 7a 65 20 2a 20 31 30 29 20  page-size * 10) 
66c0: 61 6e 64 20 73 71 6c 69 74 65 33 48 65 61 70 4e  and sqlite3HeapN
66d0: 65 61 72 6c 79 46 75 6c 6c 28 29 20 72 65 74 75  earlyFull() retu
66e0: 72 6e 73 20 74 72 75 65 2e 0a 20 20 2a 2f 0a 20  rns true..  */. 
66f0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
6700: 4f 4b 20 26 26 20 70 53 6f 72 74 65 72 2d 3e 6d  OK && pSorter->m
6710: 78 50 6d 61 53 69 7a 65 3e 30 20 26 26 20 28 0a  xPmaSize>0 && (.
6720: 20 20 20 20 20 20 20 20 28 70 53 6f 72 74 65 72          (pSorter
6730: 2d 3e 6e 49 6e 4d 65 6d 6f 72 79 3e 70 53 6f 72  ->nInMemory>pSor
6740: 74 65 72 2d 3e 6d 78 50 6d 61 53 69 7a 65 29 0a  ter->mxPmaSize).
6750: 20 20 20 20 20 7c 7c 20 28 70 53 6f 72 74 65 72       || (pSorter
6760: 2d 3e 6e 49 6e 4d 65 6d 6f 72 79 3e 70 53 6f 72  ->nInMemory>pSor
6770: 74 65 72 2d 3e 6d 6e 50 6d 61 53 69 7a 65 20 26  ter->mnPmaSize &
6780: 26 20 73 71 6c 69 74 65 33 48 65 61 70 4e 65 61  & sqlite3HeapNea
6790: 72 6c 79 46 75 6c 6c 28 29 29 0a 20 20 29 29 7b  rlyFull()).  )){
67a0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44  .#ifdef SQLITE_D
67b0: 45 42 55 47 0a 20 20 20 20 69 36 34 20 6e 45 78  EBUG.    i64 nEx
67c0: 70 65 63 74 20 3d 20 70 53 6f 72 74 65 72 2d 3e  pect = pSorter->
67d0: 69 57 72 69 74 65 4f 66 66 0a 20 20 20 20 20 20  iWriteOff.      
67e0: 20 20 20 20 20 20 20 20 20 20 2b 20 73 71 6c 69            + sqli
67f0: 74 65 33 56 61 72 69 6e 74 4c 65 6e 28 70 53 6f  te3VarintLen(pSo
6800: 72 74 65 72 2d 3e 6e 49 6e 4d 65 6d 6f 72 79 29  rter->nInMemory)
6810: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
6820: 20 2b 20 70 53 6f 72 74 65 72 2d 3e 6e 49 6e 4d   + pSorter->nInM
6830: 65 6d 6f 72 79 3b 0a 23 65 6e 64 69 66 0a 20 20  emory;.#endif.  
6840: 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72 74 65    rc = vdbeSorte
6850: 72 4c 69 73 74 54 6f 50 4d 41 28 64 62 2c 20 70  rListToPMA(db, p
6860: 43 73 72 29 3b 0a 20 20 20 20 70 53 6f 72 74 65  Csr);.    pSorte
6870: 72 2d 3e 6e 49 6e 4d 65 6d 6f 72 79 20 3d 20 30  r->nInMemory = 0
6880: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63  ;.    assert( rc
6890: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28  !=SQLITE_OK || (
68a0: 6e 45 78 70 65 63 74 3d 3d 70 53 6f 72 74 65 72  nExpect==pSorter
68b0: 2d 3e 69 57 72 69 74 65 4f 66 66 29 20 29 3b 0a  ->iWriteOff) );.
68c0: 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63    }..  return rc
68d0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 48 65 6c 70 65  ;.}../*.** Helpe
68e0: 72 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20 73  r function for s
68f0: 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65 72  qlite3VdbeSorter
6900: 52 65 77 69 6e 64 28 29 2e 20 0a 2a 2f 0a 73 74  Rewind(). .*/.st
6910: 61 74 69 63 20 69 6e 74 20 76 64 62 65 53 6f 72  atic int vdbeSor
6920: 74 65 72 49 6e 69 74 4d 65 72 67 65 28 0a 20 20  terInitMerge(.  
6930: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
6940: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6950: 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64  /* Database hand
6960: 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 56 64  le */.  const Vd
6970: 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 2c 20  beCursor *pCsr, 
6980: 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 73 6f          /* Curso
6990: 72 20 68 61 6e 64 6c 65 20 66 6f 72 20 74 68 69  r handle for thi
69a0: 73 20 73 6f 72 74 65 72 20 2a 2f 0a 20 20 69 36  s sorter */.  i6
69b0: 34 20 2a 70 6e 42 79 74 65 20 20 20 20 20 20 20  4 *pnByte       
69c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
69d0: 20 53 75 6d 20 6f 66 20 62 79 74 65 73 20 69 6e   Sum of bytes in
69e0: 20 61 6c 6c 20 6f 70 65 6e 65 64 20 50 4d 41 73   all opened PMAs
69f0: 20 2a 2f 0a 29 7b 0a 20 20 56 64 62 65 53 6f 72   */.){.  VdbeSor
6a00: 74 65 72 20 2a 70 53 6f 72 74 65 72 20 3d 20 70  ter *pSorter = p
6a10: 43 73 72 2d 3e 70 53 6f 72 74 65 72 3b 0a 20 20  Csr->pSorter;.  
6a20: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
6a30: 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  OK;             
6a40: 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a  /* Return code *
6a50: 2f 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20  /.  int i;      
6a60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6a70: 20 20 20 20 2f 2a 20 55 73 65 64 20 74 6f 20 69      /* Used to i
6a80: 74 65 72 61 74 6f 72 20 74 68 72 6f 75 67 68 20  terator through 
6a90: 61 49 74 65 72 5b 5d 20 2a 2f 0a 20 20 69 36 34  aIter[] */.  i64
6aa0: 20 6e 42 79 74 65 20 3d 20 30 3b 20 20 20 20 20   nByte = 0;     
6ab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
6ac0: 54 6f 74 61 6c 20 62 79 74 65 73 20 69 6e 20 61  Total bytes in a
6ad0: 6c 6c 20 6f 70 65 6e 65 64 20 50 4d 41 73 20 2a  ll opened PMAs *
6ae0: 2f 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c 69  /..  /* Initiali
6af0: 7a 65 20 74 68 65 20 69 74 65 72 61 74 6f 72 73  ze the iterators
6b00: 2e 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20  . */.  for(i=0; 
6b10: 69 3c 53 4f 52 54 45 52 5f 4d 41 58 5f 4d 45 52  i<SORTER_MAX_MER
6b20: 47 45 5f 43 4f 55 4e 54 3b 20 69 2b 2b 29 7b 0a  GE_COUNT; i++){.
6b30: 20 20 20 20 56 64 62 65 53 6f 72 74 65 72 49 74      VdbeSorterIt
6b40: 65 72 20 2a 70 49 74 65 72 20 3d 20 26 70 53 6f  er *pIter = &pSo
6b50: 72 74 65 72 2d 3e 61 49 74 65 72 5b 69 5d 3b 0a  rter->aIter[i];.
6b60: 20 20 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72      rc = vdbeSor
6b70: 74 65 72 49 74 65 72 49 6e 69 74 28 64 62 2c 20  terIterInit(db, 
6b80: 70 53 6f 72 74 65 72 2c 20 70 53 6f 72 74 65 72  pSorter, pSorter
6b90: 2d 3e 69 52 65 61 64 4f 66 66 2c 20 70 49 74 65  ->iReadOff, pIte
6ba0: 72 2c 20 26 6e 42 79 74 65 29 3b 0a 20 20 20 20  r, &nByte);.    
6bb0: 70 53 6f 72 74 65 72 2d 3e 69 52 65 61 64 4f 66  pSorter->iReadOf
6bc0: 66 20 3d 20 70 49 74 65 72 2d 3e 69 45 6f 66 3b  f = pIter->iEof;
6bd0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 21  .    assert( rc!
6be0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 53  =SQLITE_OK || pS
6bf0: 6f 72 74 65 72 2d 3e 69 52 65 61 64 4f 66 66 3c  orter->iReadOff<
6c00: 3d 70 53 6f 72 74 65 72 2d 3e 69 57 72 69 74 65  =pSorter->iWrite
6c10: 4f 66 66 20 29 3b 0a 20 20 20 20 69 66 28 20 72  Off );.    if( r
6c20: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20  c!=SQLITE_OK || 
6c30: 70 53 6f 72 74 65 72 2d 3e 69 52 65 61 64 4f 66  pSorter->iReadOf
6c40: 66 3e 3d 70 53 6f 72 74 65 72 2d 3e 69 57 72 69  f>=pSorter->iWri
6c50: 74 65 4f 66 66 20 29 20 62 72 65 61 6b 3b 0a 20  teOff ) break;. 
6c60: 20 7d 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c   }..  /* Initial
6c70: 69 7a 65 20 74 68 65 20 61 54 72 65 65 5b 5d 20  ize the aTree[] 
6c80: 61 72 72 61 79 2e 20 2a 2f 0a 20 20 66 6f 72 28  array. */.  for(
6c90: 69 3d 70 53 6f 72 74 65 72 2d 3e 6e 54 72 65 65  i=pSorter->nTree
6ca0: 2d 31 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  -1; rc==SQLITE_O
6cb0: 4b 20 26 26 20 69 3e 30 3b 20 69 2d 2d 29 7b 0a  K && i>0; i--){.
6cc0: 20 20 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72      rc = vdbeSor
6cd0: 74 65 72 44 6f 43 6f 6d 70 61 72 65 28 70 43 73  terDoCompare(pCs
6ce0: 72 2c 20 69 29 3b 0a 20 20 7d 0a 0a 20 20 2a 70  r, i);.  }..  *p
6cf0: 6e 42 79 74 65 20 3d 20 6e 42 79 74 65 3b 0a 20  nByte = nByte;. 
6d00: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
6d10: 2a 0a 2a 2a 20 4f 6e 63 65 20 74 68 65 20 73 6f  *.** Once the so
6d20: 72 74 65 72 20 68 61 73 20 62 65 65 6e 20 70 6f  rter has been po
6d30: 70 75 6c 61 74 65 64 2c 20 74 68 69 73 20 66 75  pulated, this fu
6d40: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64  nction is called
6d50: 20 74 6f 20 70 72 65 70 61 72 65 0a 2a 2a 20 66   to prepare.** f
6d60: 6f 72 20 69 74 65 72 61 74 69 6e 67 20 74 68 72  or iterating thr
6d70: 6f 75 67 68 20 69 74 73 20 63 6f 6e 74 65 6e 74  ough its content
6d80: 73 20 69 6e 20 73 6f 72 74 65 64 20 6f 72 64 65  s in sorted orde
6d90: 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  r..*/.int sqlite
6da0: 33 56 64 62 65 53 6f 72 74 65 72 52 65 77 69 6e  3VdbeSorterRewin
6db0: 64 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63  d(sqlite3 *db, c
6dc0: 6f 6e 73 74 20 56 64 62 65 43 75 72 73 6f 72 20  onst VdbeCursor 
6dd0: 2a 70 43 73 72 2c 20 69 6e 74 20 2a 70 62 45 6f  *pCsr, int *pbEo
6de0: 66 29 7b 0a 20 20 56 64 62 65 53 6f 72 74 65 72  f){.  VdbeSorter
6df0: 20 2a 70 53 6f 72 74 65 72 20 3d 20 70 43 73 72   *pSorter = pCsr
6e00: 2d 3e 70 53 6f 72 74 65 72 3b 0a 20 20 69 6e 74  ->pSorter;.  int
6e10: 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20   rc;            
6e20: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
6e30: 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20  Return code */. 
6e40: 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70   sqlite3_file *p
6e50: 54 65 6d 70 32 20 3d 20 30 3b 20 20 20 20 20 20  Temp2 = 0;      
6e60: 20 2f 2a 20 53 65 63 6f 6e 64 20 74 65 6d 70 20   /* Second temp 
6e70: 66 69 6c 65 20 74 6f 20 75 73 65 20 2a 2f 0a 20  file to use */. 
6e80: 20 69 36 34 20 69 57 72 69 74 65 32 20 3d 20 30   i64 iWrite2 = 0
6e90: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
6ea0: 20 2f 2a 20 57 72 69 74 65 20 6f 66 66 73 65 74   /* Write offset
6eb0: 20 66 6f 72 20 70 54 65 6d 70 32 20 2a 2f 0a 20   for pTemp2 */. 
6ec0: 20 69 6e 74 20 6e 49 74 65 72 3b 20 20 20 20 20   int nIter;     
6ed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6ee0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 69 74   /* Number of it
6ef0: 65 72 61 74 6f 72 73 20 75 73 65 64 20 2a 2f 0a  erators used */.
6f00: 20 20 69 6e 74 20 6e 42 79 74 65 3b 20 20 20 20    int nByte;    
6f10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6f20: 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 73 70    /* Bytes of sp
6f30: 61 63 65 20 72 65 71 75 69 72 65 64 20 66 6f 72  ace required for
6f40: 20 61 49 74 65 72 2f 61 54 72 65 65 20 2a 2f 0a   aIter/aTree */.
6f50: 20 20 69 6e 74 20 4e 20 3d 20 32 3b 20 20 20 20    int N = 2;    
6f60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6f70: 20 20 2f 2a 20 50 6f 77 65 72 20 6f 66 20 32 20    /* Power of 2 
6f80: 3e 3d 20 6e 49 74 65 72 20 2a 2f 0a 0a 20 20 61  >= nIter */..  a
6f90: 73 73 65 72 74 28 20 70 53 6f 72 74 65 72 20 29  ssert( pSorter )
6fa0: 3b 0a 0a 20 20 2f 2a 20 49 66 20 6e 6f 20 64 61  ;..  /* If no da
6fb0: 74 61 20 68 61 73 20 62 65 65 6e 20 77 72 69 74  ta has been writ
6fc0: 74 65 6e 20 74 6f 20 64 69 73 6b 2c 20 74 68 65  ten to disk, the
6fd0: 6e 20 64 6f 20 6e 6f 74 20 64 6f 20 73 6f 20 6e  n do not do so n
6fe0: 6f 77 2e 20 49 6e 73 74 65 61 64 2c 0a 20 20 2a  ow. Instead,.  *
6ff0: 2a 20 73 6f 72 74 20 74 68 65 20 56 64 62 65 53  * sort the VdbeS
7000: 6f 72 74 65 72 2e 70 52 65 63 6f 72 64 20 6c 69  orter.pRecord li
7010: 73 74 2e 20 54 68 65 20 76 64 62 65 20 6c 61 79  st. The vdbe lay
7020: 65 72 20 77 69 6c 6c 20 72 65 61 64 20 64 61 74  er will read dat
7030: 61 20 64 69 72 65 63 74 6c 79 0a 20 20 2a 2a 20  a directly.  ** 
7040: 66 72 6f 6d 20 74 68 65 20 69 6e 2d 6d 65 6d 6f  from the in-memo
7050: 72 79 20 6c 69 73 74 2e 20 20 2a 2f 0a 20 20 69  ry list.  */.  i
7060: 66 28 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d 41  f( pSorter->nPMA
7070: 3d 3d 30 20 29 7b 0a 20 20 20 20 2a 70 62 45 6f  ==0 ){.    *pbEo
7080: 66 20 3d 20 21 70 53 6f 72 74 65 72 2d 3e 70 52  f = !pSorter->pR
7090: 65 63 6f 72 64 3b 0a 20 20 20 20 61 73 73 65 72  ecord;.    asser
70a0: 74 28 20 70 53 6f 72 74 65 72 2d 3e 61 54 72 65  t( pSorter->aTre
70b0: 65 3d 3d 30 20 29 3b 0a 20 20 20 20 72 65 74 75  e==0 );.    retu
70c0: 72 6e 20 76 64 62 65 53 6f 72 74 65 72 53 6f 72  rn vdbeSorterSor
70d0: 74 28 70 43 73 72 29 3b 0a 20 20 7d 0a 0a 20 20  t(pCsr);.  }..  
70e0: 2f 2a 20 57 72 69 74 65 20 74 68 65 20 63 75 72  /* Write the cur
70f0: 72 65 6e 74 20 69 6e 2d 6d 65 6d 6f 72 79 20 6c  rent in-memory l
7100: 69 73 74 20 74 6f 20 61 20 50 4d 41 2e 20 2a 2f  ist to a PMA. */
7110: 0a 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72 74  .  rc = vdbeSort
7120: 65 72 4c 69 73 74 54 6f 50 4d 41 28 64 62 2c 20  erListToPMA(db, 
7130: 70 43 73 72 29 3b 0a 20 20 69 66 28 20 72 63 21  pCsr);.  if( rc!
7140: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74  =SQLITE_OK ) ret
7150: 75 72 6e 20 72 63 3b 0a 0a 20 20 2f 2a 20 41 6c  urn rc;..  /* Al
7160: 6c 6f 63 61 74 65 20 73 70 61 63 65 20 66 6f 72  locate space for
7170: 20 61 49 74 65 72 5b 5d 20 61 6e 64 20 61 54 72   aIter[] and aTr
7180: 65 65 5b 5d 2e 20 2a 2f 0a 20 20 6e 49 74 65 72  ee[]. */.  nIter
7190: 20 3d 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d 41   = pSorter->nPMA
71a0: 3b 0a 20 20 69 66 28 20 6e 49 74 65 72 3e 53 4f  ;.  if( nIter>SO
71b0: 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f 43  RTER_MAX_MERGE_C
71c0: 4f 55 4e 54 20 29 20 6e 49 74 65 72 20 3d 20 53  OUNT ) nIter = S
71d0: 4f 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f  ORTER_MAX_MERGE_
71e0: 43 4f 55 4e 54 3b 0a 20 20 61 73 73 65 72 74 28  COUNT;.  assert(
71f0: 20 6e 49 74 65 72 3e 30 20 29 3b 0a 20 20 77 68   nIter>0 );.  wh
7200: 69 6c 65 28 20 4e 3c 6e 49 74 65 72 20 29 20 4e  ile( N<nIter ) N
7210: 20 2b 3d 20 4e 3b 0a 20 20 6e 42 79 74 65 20 3d   += N;.  nByte =
7220: 20 4e 20 2a 20 28 73 69 7a 65 6f 66 28 69 6e 74   N * (sizeof(int
7230: 29 20 2b 20 73 69 7a 65 6f 66 28 56 64 62 65 53  ) + sizeof(VdbeS
7240: 6f 72 74 65 72 49 74 65 72 29 29 3b 0a 20 20 70  orterIter));.  p
7250: 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 20 3d 20  Sorter->aIter = 
7260: 28 56 64 62 65 53 6f 72 74 65 72 49 74 65 72 20  (VdbeSorterIter 
7270: 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f  *)sqlite3DbMallo
7280: 63 5a 65 72 6f 28 64 62 2c 20 6e 42 79 74 65 29  cZero(db, nByte)
7290: 3b 0a 20 20 69 66 28 20 21 70 53 6f 72 74 65 72  ;.  if( !pSorter
72a0: 2d 3e 61 49 74 65 72 20 29 20 72 65 74 75 72 6e  ->aIter ) return
72b0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
72c0: 20 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 20   pSorter->aTree 
72d0: 3d 20 28 69 6e 74 20 2a 29 26 70 53 6f 72 74 65  = (int *)&pSorte
72e0: 72 2d 3e 61 49 74 65 72 5b 4e 5d 3b 0a 20 20 70  r->aIter[N];.  p
72f0: 53 6f 72 74 65 72 2d 3e 6e 54 72 65 65 20 3d 20  Sorter->nTree = 
7300: 4e 3b 0a 0a 20 20 64 6f 20 7b 0a 20 20 20 20 69  N;..  do {.    i
7310: 6e 74 20 69 4e 65 77 3b 20 20 20 20 20 20 20 20  nt iNew;        
7320: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
7330: 49 6e 64 65 78 20 6f 66 20 6e 65 77 2c 20 6d 65  Index of new, me
7340: 72 67 65 64 2c 20 50 4d 41 20 2a 2f 0a 0a 20 20  rged, PMA */..  
7350: 20 20 66 6f 72 28 69 4e 65 77 3d 30 3b 20 0a 20    for(iNew=0; . 
7360: 20 20 20 20 20 20 20 72 63 3d 3d 53 51 4c 49 54         rc==SQLIT
7370: 45 5f 4f 4b 20 26 26 20 69 4e 65 77 2a 53 4f 52  E_OK && iNew*SOR
7380: 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f 43 4f  TER_MAX_MERGE_CO
7390: 55 4e 54 3c 70 53 6f 72 74 65 72 2d 3e 6e 50 4d  UNT<pSorter->nPM
73a0: 41 3b 20 0a 20 20 20 20 20 20 20 20 69 4e 65 77  A; .        iNew
73b0: 2b 2b 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20  ++.    ){.      
73c0: 69 6e 74 20 72 63 32 3b 20 20 20 20 20 20 20 20  int rc2;        
73d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52              /* R
73e0: 65 74 75 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20  eturn code from 
73f0: 66 69 6c 65 57 72 69 74 65 72 46 69 6e 69 73 68  fileWriterFinish
7400: 28 29 20 2a 2f 0a 20 20 20 20 20 20 46 69 6c 65  () */.      File
7410: 57 72 69 74 65 72 20 77 72 69 74 65 72 3b 20 20  Writer writer;  
7420: 20 20 20 20 20 20 20 20 2f 2a 20 4f 62 6a 65 63          /* Objec
7430: 74 20 75 73 65 64 20 74 6f 20 77 72 69 74 65 20  t used to write 
7440: 74 6f 20 64 69 73 6b 20 2a 2f 0a 20 20 20 20 20  to disk */.     
7450: 20 69 36 34 20 6e 57 72 69 74 65 3b 20 20 20 20   i64 nWrite;    
7460: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
7470: 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20  Number of bytes 
7480: 69 6e 20 6e 65 77 20 50 4d 41 20 2a 2f 0a 0a 20  in new PMA */.. 
7490: 20 20 20 20 20 6d 65 6d 73 65 74 28 26 77 72 69       memset(&wri
74a0: 74 65 72 2c 20 30 2c 20 73 69 7a 65 6f 66 28 46  ter, 0, sizeof(F
74b0: 69 6c 65 57 72 69 74 65 72 29 29 3b 0a 0a 20 20  ileWriter));..  
74c0: 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20      /* If there 
74d0: 61 72 65 20 53 4f 52 54 45 52 5f 4d 41 58 5f 4d  are SORTER_MAX_M
74e0: 45 52 47 45 5f 43 4f 55 4e 54 20 6f 72 20 6c 65  ERGE_COUNT or le
74f0: 73 73 20 50 4d 41 73 20 69 6e 20 66 69 6c 65 20  ss PMAs in file 
7500: 70 54 65 6d 70 31 2c 0a 20 20 20 20 20 20 2a 2a  pTemp1,.      **
7510: 20 69 6e 69 74 69 61 6c 69 7a 65 20 61 6e 20 69   initialize an i
7520: 74 65 72 61 74 6f 72 20 66 6f 72 20 65 61 63 68  terator for each
7530: 20 6f 66 20 74 68 65 6d 20 61 6e 64 20 62 72 65   of them and bre
7540: 61 6b 20 6f 75 74 20 6f 66 20 74 68 65 20 6c 6f  ak out of the lo
7550: 6f 70 2e 0a 20 20 20 20 20 20 2a 2a 20 54 68 65  op..      ** The
7560: 73 65 20 69 74 65 72 61 74 6f 72 73 20 77 69 6c  se iterators wil
7570: 6c 20 62 65 20 69 6e 63 72 65 6d 65 6e 74 61 6c  l be incremental
7580: 6c 79 20 6d 65 72 67 65 64 20 61 73 20 74 68 65  ly merged as the
7590: 20 56 44 42 45 20 6c 61 79 65 72 20 63 61 6c 6c   VDBE layer call
75a0: 73 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74  s.      ** sqlit
75b0: 65 33 56 64 62 65 53 6f 72 74 65 72 4e 65 78 74  e3VdbeSorterNext
75c0: 28 29 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20  ()..      **.   
75d0: 20 20 20 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c     ** Otherwise,
75e0: 20 69 66 20 70 54 65 6d 70 31 20 63 6f 6e 74 61   if pTemp1 conta
75f0: 69 6e 73 20 6d 6f 72 65 20 74 68 61 6e 20 53 4f  ins more than SO
7600: 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f 43  RTER_MAX_MERGE_C
7610: 4f 55 4e 54 20 50 4d 41 73 2c 0a 20 20 20 20 20  OUNT PMAs,.     
7620: 20 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 65 20 69   ** initialize i
7630: 6e 74 65 72 61 74 6f 72 73 20 66 6f 72 20 53 4f  nterators for SO
7640: 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f 43  RTER_MAX_MERGE_C
7650: 4f 55 4e 54 20 6f 66 20 74 68 65 6d 2e 20 54 68  OUNT of them. Th
7660: 65 73 65 20 50 4d 41 73 0a 20 20 20 20 20 20 2a  ese PMAs.      *
7670: 2a 20 61 72 65 20 6d 65 72 67 65 64 20 69 6e 74  * are merged int
7680: 6f 20 61 20 73 69 6e 67 6c 65 20 50 4d 41 20 74  o a single PMA t
7690: 68 61 74 20 69 73 20 77 72 69 74 74 65 6e 20 74  hat is written t
76a0: 6f 20 66 69 6c 65 20 70 54 65 6d 70 32 2e 0a 20  o file pTemp2.. 
76b0: 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 63       */.      rc
76c0: 20 3d 20 76 64 62 65 53 6f 72 74 65 72 49 6e 69   = vdbeSorterIni
76d0: 74 4d 65 72 67 65 28 64 62 2c 20 70 43 73 72 2c  tMerge(db, pCsr,
76e0: 20 26 6e 57 72 69 74 65 29 3b 0a 20 20 20 20 20   &nWrite);.     
76f0: 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c   assert( rc!=SQL
7700: 49 54 45 5f 4f 4b 20 7c 7c 20 70 53 6f 72 74 65  ITE_OK || pSorte
7710: 72 2d 3e 61 49 74 65 72 5b 20 70 53 6f 72 74 65  r->aIter[ pSorte
7720: 72 2d 3e 61 54 72 65 65 5b 31 5d 20 5d 2e 70 46  r->aTree[1] ].pF
7730: 69 6c 65 20 29 3b 0a 20 20 20 20 20 20 69 66 28  ile );.      if(
7740: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c   rc!=SQLITE_OK |
7750: 7c 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d 41 3c  | pSorter->nPMA<
7760: 3d 53 4f 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47  =SORTER_MAX_MERG
7770: 45 5f 43 4f 55 4e 54 20 29 7b 0a 20 20 20 20 20  E_COUNT ){.     
7780: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20     break;.      
7790: 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 4f 70 65 6e  }..      /* Open
77a0: 20 74 68 65 20 73 65 63 6f 6e 64 20 74 65 6d 70   the second temp
77b0: 20 66 69 6c 65 2c 20 69 66 20 69 74 20 69 73 20   file, if it is 
77c0: 6e 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 65 6e  not already open
77d0: 2e 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70  . */.      if( p
77e0: 54 65 6d 70 32 3d 3d 30 20 29 7b 0a 20 20 20 20  Temp2==0 ){.    
77f0: 20 20 20 20 61 73 73 65 72 74 28 20 69 57 72 69      assert( iWri
7800: 74 65 32 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20  te2==0 );.      
7810: 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72 74 65    rc = vdbeSorte
7820: 72 4f 70 65 6e 54 65 6d 70 46 69 6c 65 28 64 62  rOpenTempFile(db
7830: 2c 20 26 70 54 65 6d 70 32 29 3b 0a 20 20 20 20  , &pTemp2);.    
7840: 20 20 7d 0a 0a 20 20 20 20 20 20 69 66 28 20 72    }..      if( r
7850: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
7860: 20 20 20 20 20 20 20 20 69 6e 74 20 62 45 6f 66          int bEof
7870: 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 66 69   = 0;.        fi
7880: 6c 65 57 72 69 74 65 72 49 6e 69 74 28 64 62 2c  leWriterInit(db,
7890: 20 70 54 65 6d 70 32 2c 20 26 77 72 69 74 65 72   pTemp2, &writer
78a0: 2c 20 69 57 72 69 74 65 32 29 3b 0a 20 20 20 20  , iWrite2);.    
78b0: 20 20 20 20 66 69 6c 65 57 72 69 74 65 72 57 72      fileWriterWr
78c0: 69 74 65 56 61 72 69 6e 74 28 26 77 72 69 74 65  iteVarint(&write
78d0: 72 2c 20 6e 57 72 69 74 65 29 3b 0a 20 20 20 20  r, nWrite);.    
78e0: 20 20 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53      while( rc==S
78f0: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 62 45 6f 66  QLITE_OK && bEof
7900: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20  ==0 ){.         
7910: 20 56 64 62 65 53 6f 72 74 65 72 49 74 65 72 20   VdbeSorterIter 
7920: 2a 70 49 74 65 72 20 3d 20 26 70 53 6f 72 74 65  *pIter = &pSorte
7930: 72 2d 3e 61 49 74 65 72 5b 20 70 53 6f 72 74 65  r->aIter[ pSorte
7940: 72 2d 3e 61 54 72 65 65 5b 31 5d 20 5d 3b 0a 20  r->aTree[1] ];. 
7950: 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28           assert(
7960: 20 70 49 74 65 72 2d 3e 70 46 69 6c 65 20 29 3b   pIter->pFile );
7970: 0a 0a 20 20 20 20 20 20 20 20 20 20 66 69 6c 65  ..          file
7980: 57 72 69 74 65 72 57 72 69 74 65 56 61 72 69 6e  WriterWriteVarin
7990: 74 28 26 77 72 69 74 65 72 2c 20 70 49 74 65 72  t(&writer, pIter
79a0: 2d 3e 6e 4b 65 79 29 3b 0a 20 20 20 20 20 20 20  ->nKey);.       
79b0: 20 20 20 66 69 6c 65 57 72 69 74 65 72 57 72 69     fileWriterWri
79c0: 74 65 28 26 77 72 69 74 65 72 2c 20 70 49 74 65  te(&writer, pIte
79d0: 72 2d 3e 61 4b 65 79 2c 20 70 49 74 65 72 2d 3e  r->aKey, pIter->
79e0: 6e 4b 65 79 29 3b 0a 20 20 20 20 20 20 20 20 20  nKey);.         
79f0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62   rc = sqlite3Vdb
7a00: 65 53 6f 72 74 65 72 4e 65 78 74 28 64 62 2c 20  eSorterNext(db, 
7a10: 70 43 73 72 2c 20 26 62 45 6f 66 29 3b 0a 20 20  pCsr, &bEof);.  
7a20: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
7a30: 72 63 32 20 3d 20 66 69 6c 65 57 72 69 74 65 72  rc2 = fileWriter
7a40: 46 69 6e 69 73 68 28 64 62 2c 20 26 77 72 69 74  Finish(db, &writ
7a50: 65 72 2c 20 26 69 57 72 69 74 65 32 29 3b 0a 20  er, &iWrite2);. 
7a60: 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53         if( rc==S
7a70: 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20 3d 20  QLITE_OK ) rc = 
7a80: 72 63 32 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  rc2;.      }.   
7a90: 20 7d 0a 0a 20 20 20 20 69 66 28 20 70 53 6f 72   }..    if( pSor
7aa0: 74 65 72 2d 3e 6e 50 4d 41 3c 3d 53 4f 52 54 45  ter->nPMA<=SORTE
7ab0: 52 5f 4d 41 58 5f 4d 45 52 47 45 5f 43 4f 55 4e  R_MAX_MERGE_COUN
7ac0: 54 20 29 7b 0a 20 20 20 20 20 20 62 72 65 61 6b  T ){.      break
7ad0: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
7ae0: 20 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20     sqlite3_file 
7af0: 2a 70 54 6d 70 20 3d 20 70 53 6f 72 74 65 72 2d  *pTmp = pSorter-
7b00: 3e 70 54 65 6d 70 31 3b 0a 20 20 20 20 20 20 70  >pTemp1;.      p
7b10: 53 6f 72 74 65 72 2d 3e 6e 50 4d 41 20 3d 20 69  Sorter->nPMA = i
7b20: 4e 65 77 3b 0a 20 20 20 20 20 20 70 53 6f 72 74  New;.      pSort
7b30: 65 72 2d 3e 70 54 65 6d 70 31 20 3d 20 70 54 65  er->pTemp1 = pTe
7b40: 6d 70 32 3b 0a 20 20 20 20 20 20 70 54 65 6d 70  mp2;.      pTemp
7b50: 32 20 3d 20 70 54 6d 70 3b 0a 20 20 20 20 20 20  2 = pTmp;.      
7b60: 70 53 6f 72 74 65 72 2d 3e 69 57 72 69 74 65 4f  pSorter->iWriteO
7b70: 66 66 20 3d 20 69 57 72 69 74 65 32 3b 0a 20 20  ff = iWrite2;.  
7b80: 20 20 20 20 70 53 6f 72 74 65 72 2d 3e 69 52 65      pSorter->iRe
7b90: 61 64 4f 66 66 20 3d 20 30 3b 0a 20 20 20 20 20  adOff = 0;.     
7ba0: 20 69 57 72 69 74 65 32 20 3d 20 30 3b 0a 20 20   iWrite2 = 0;.  
7bb0: 20 20 7d 0a 20 20 7d 77 68 69 6c 65 28 20 72 63    }.  }while( rc
7bc0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 0a  ==SQLITE_OK );..
7bd0: 20 20 69 66 28 20 70 54 65 6d 70 32 20 29 7b 0a    if( pTemp2 ){.
7be0: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f      sqlite3OsClo
7bf0: 73 65 46 72 65 65 28 70 54 65 6d 70 32 29 3b 0a  seFree(pTemp2);.
7c00: 20 20 7d 0a 20 20 2a 70 62 45 6f 66 20 3d 20 28    }.  *pbEof = (
7c10: 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b 70  pSorter->aIter[p
7c20: 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 31 5d  Sorter->aTree[1]
7c30: 5d 2e 70 46 69 6c 65 3d 3d 30 29 3b 0a 20 20 72  ].pFile==0);.  r
7c40: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
7c50: 2a 2a 20 41 64 76 61 6e 63 65 20 74 6f 20 74 68  ** Advance to th
7c60: 65 20 6e 65 78 74 20 65 6c 65 6d 65 6e 74 20 69  e next element i
7c70: 6e 20 74 68 65 20 73 6f 72 74 65 72 2e 0a 2a 2f  n the sorter..*/
7c80: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
7c90: 53 6f 72 74 65 72 4e 65 78 74 28 73 71 6c 69 74  SorterNext(sqlit
7ca0: 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 56 64  e3 *db, const Vd
7cb0: 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 2c 20  beCursor *pCsr, 
7cc0: 69 6e 74 20 2a 70 62 45 6f 66 29 7b 0a 20 20 56  int *pbEof){.  V
7cd0: 64 62 65 53 6f 72 74 65 72 20 2a 70 53 6f 72 74  dbeSorter *pSort
7ce0: 65 72 20 3d 20 70 43 73 72 2d 3e 70 53 6f 72 74  er = pCsr->pSort
7cf0: 65 72 3b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20  er;.  int rc;   
7d00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7d10: 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20        /* Return 
7d20: 63 6f 64 65 20 2a 2f 0a 0a 20 20 69 66 28 20 70  code */..  if( p
7d30: 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 20 29 7b  Sorter->aTree ){
7d40: 0a 20 20 20 20 69 6e 74 20 69 50 72 65 76 20 3d  .    int iPrev =
7d50: 20 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b   pSorter->aTree[
7d60: 31 5d 3b 2f 2a 20 49 6e 64 65 78 20 6f 66 20 69  1];/* Index of i
7d70: 74 65 72 61 74 6f 72 20 74 6f 20 61 64 76 61 6e  terator to advan
7d80: 63 65 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 76  ce */.    rc = v
7d90: 64 62 65 53 6f 72 74 65 72 49 74 65 72 4e 65 78  dbeSorterIterNex
7da0: 74 28 64 62 2c 20 26 70 53 6f 72 74 65 72 2d 3e  t(db, &pSorter->
7db0: 61 49 74 65 72 5b 69 50 72 65 76 5d 29 3b 0a 20  aIter[iPrev]);. 
7dc0: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
7dd0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 6e  E_OK ){.      in
7de0: 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20  t i;            
7df0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64            /* Ind
7e00: 65 78 20 6f 66 20 61 54 72 65 65 5b 5d 20 74 6f  ex of aTree[] to
7e10: 20 72 65 63 61 6c 63 75 6c 61 74 65 20 2a 2f 0a   recalculate */.
7e20: 20 20 20 20 20 20 56 64 62 65 53 6f 72 74 65 72        VdbeSorter
7e30: 49 74 65 72 20 2a 70 49 74 65 72 31 3b 20 20 20  Iter *pIter1;   
7e40: 20 20 2f 2a 20 46 69 72 73 74 20 69 74 65 72 61    /* First itera
7e50: 74 6f 72 20 74 6f 20 63 6f 6d 70 61 72 65 20 2a  tor to compare *
7e60: 2f 0a 20 20 20 20 20 20 56 64 62 65 53 6f 72 74  /.      VdbeSort
7e70: 65 72 49 74 65 72 20 2a 70 49 74 65 72 32 3b 20  erIter *pIter2; 
7e80: 20 20 20 20 2f 2a 20 53 65 63 6f 6e 64 20 69 74      /* Second it
7e90: 65 72 61 74 6f 72 20 74 6f 20 63 6f 6d 70 61 72  erator to compar
7ea0: 65 20 2a 2f 0a 20 20 20 20 20 20 75 38 20 2a 70  e */.      u8 *p
7eb0: 4b 65 79 32 3b 20 20 20 20 20 20 20 20 20 20 20  Key2;           
7ec0: 20 20 20 20 20 20 20 2f 2a 20 54 6f 20 70 49 74         /* To pIt
7ed0: 65 72 32 2d 3e 61 4b 65 79 2c 20 6f 72 20 30 20  er2->aKey, or 0 
7ee0: 69 66 20 72 65 63 6f 72 64 20 63 61 63 68 65 64  if record cached
7ef0: 20 2a 2f 0a 0a 20 20 20 20 20 20 2f 2a 20 46 69   */..      /* Fi
7f00: 6e 64 20 74 68 65 20 66 69 72 73 74 20 74 77 6f  nd the first two
7f10: 20 69 74 65 72 61 74 6f 72 73 20 74 6f 20 63 6f   iterators to co
7f20: 6d 70 61 72 65 2e 20 54 68 65 20 6f 6e 65 20 74  mpare. The one t
7f30: 68 61 74 20 77 61 73 20 6a 75 73 74 0a 20 20 20  hat was just.   
7f40: 20 20 20 2a 2a 20 61 64 76 61 6e 63 65 64 20 28     ** advanced (
7f50: 69 50 72 65 76 29 20 61 6e 64 20 74 68 65 20 6f  iPrev) and the o
7f60: 6e 65 20 6e 65 78 74 20 74 6f 20 69 74 20 69 6e  ne next to it in
7f70: 20 74 68 65 20 61 72 72 61 79 2e 20 20 2a 2f 0a   the array.  */.
7f80: 20 20 20 20 20 20 70 49 74 65 72 31 20 3d 20 26        pIter1 = &
7f90: 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b 28  pSorter->aIter[(
7fa0: 69 50 72 65 76 20 26 20 30 78 46 46 46 45 29 5d  iPrev & 0xFFFE)]
7fb0: 3b 0a 20 20 20 20 20 20 70 49 74 65 72 32 20 3d  ;.      pIter2 =
7fc0: 20 26 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72   &pSorter->aIter
7fd0: 5b 28 69 50 72 65 76 20 7c 20 30 78 30 30 30 31  [(iPrev | 0x0001
7fe0: 29 5d 3b 0a 20 20 20 20 20 20 70 4b 65 79 32 20  )];.      pKey2 
7ff0: 3d 20 70 49 74 65 72 32 2d 3e 61 4b 65 79 3b 0a  = pIter2->aKey;.
8000: 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 28 70 53  .      for(i=(pS
8010: 6f 72 74 65 72 2d 3e 6e 54 72 65 65 2b 69 50 72  orter->nTree+iPr
8020: 65 76 29 2f 32 3b 20 69 3e 30 3b 20 69 3d 69 2f  ev)/2; i>0; i=i/
8030: 32 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 43  2){.        /* C
8040: 6f 6d 70 61 72 65 20 70 49 74 65 72 31 20 61 6e  ompare pIter1 an
8050: 64 20 70 49 74 65 72 32 2e 20 53 74 6f 72 65 20  d pIter2. Store 
8060: 74 68 65 20 72 65 73 75 6c 74 20 69 6e 20 76 61  the result in va
8070: 72 69 61 62 6c 65 20 69 52 65 73 2e 20 2a 2f 0a  riable iRes. */.
8080: 20 20 20 20 20 20 20 20 69 6e 74 20 69 52 65 73          int iRes
8090: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 49  ;.        if( pI
80a0: 74 65 72 31 2d 3e 70 46 69 6c 65 3d 3d 30 20 29  ter1->pFile==0 )
80b0: 7b 0a 20 20 20 20 20 20 20 20 20 20 69 52 65 73  {.          iRes
80c0: 20 3d 20 2b 31 3b 0a 20 20 20 20 20 20 20 20 7d   = +1;.        }
80d0: 65 6c 73 65 20 69 66 28 20 70 49 74 65 72 32 2d  else if( pIter2-
80e0: 3e 70 46 69 6c 65 3d 3d 30 20 29 7b 0a 20 20 20  >pFile==0 ){.   
80f0: 20 20 20 20 20 20 20 69 52 65 73 20 3d 20 2d 31         iRes = -1
8100: 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b  ;.        }else{
8110: 0a 20 20 20 20 20 20 20 20 20 20 76 64 62 65 53  .          vdbeS
8120: 6f 72 74 65 72 43 6f 6d 70 61 72 65 28 70 43 73  orterCompare(pCs
8130: 72 2c 20 30 2c 20 0a 20 20 20 20 20 20 20 20 20  r, 0, .         
8140: 20 20 20 20 20 70 49 74 65 72 31 2d 3e 61 4b 65       pIter1->aKe
8150: 79 2c 20 70 49 74 65 72 31 2d 3e 6e 4b 65 79 2c  y, pIter1->nKey,
8160: 20 70 4b 65 79 32 2c 20 70 49 74 65 72 32 2d 3e   pKey2, pIter2->
8170: 6e 4b 65 79 2c 20 26 69 52 65 73 0a 20 20 20 20  nKey, &iRes.    
8180: 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20        );.       
8190: 20 7d 0a 0a 20 20 20 20 20 20 20 20 2f 2a 20 49   }..        /* I
81a0: 66 20 70 49 74 65 72 31 20 63 6f 6e 74 61 69 6e  f pIter1 contain
81b0: 65 64 20 74 68 65 20 73 6d 61 6c 6c 65 72 20 76  ed the smaller v
81c0: 61 6c 75 65 2c 20 73 65 74 20 61 54 72 65 65 5b  alue, set aTree[
81d0: 69 5d 20 74 6f 20 69 74 73 20 69 6e 64 65 78 2e  i] to its index.
81e0: 0a 20 20 20 20 20 20 20 20 2a 2a 20 54 68 65 6e  .        ** Then
81f0: 20 73 65 74 20 70 49 74 65 72 32 20 74 6f 20 74   set pIter2 to t
8200: 68 65 20 6e 65 78 74 20 69 74 65 72 61 74 6f 72  he next iterator
8210: 20 74 6f 20 63 6f 6d 70 61 72 65 20 74 6f 20 70   to compare to p
8220: 49 74 65 72 31 2e 20 49 6e 20 74 68 69 73 0a 20  Iter1. In this. 
8230: 20 20 20 20 20 20 20 2a 2a 20 63 61 73 65 20 74         ** case t
8240: 68 65 72 65 20 69 73 20 6e 6f 20 63 61 63 68 65  here is no cache
8250: 20 6f 66 20 70 49 74 65 72 32 20 69 6e 20 70 53   of pIter2 in pS
8260: 6f 72 74 65 72 2d 3e 70 55 6e 70 61 63 6b 65 64  orter->pUnpacked
8270: 2c 20 73 6f 20 73 65 74 0a 20 20 20 20 20 20 20  , so set.       
8280: 20 2a 2a 20 70 4b 65 79 32 20 74 6f 20 70 6f 69   ** pKey2 to poi
8290: 6e 74 20 74 6f 20 74 68 65 20 72 65 63 6f 72 64  nt to the record
82a0: 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 70 49   belonging to pI
82b0: 74 65 72 32 2e 0a 20 20 20 20 20 20 20 20 2a 2a  ter2..        **
82c0: 0a 20 20 20 20 20 20 20 20 2a 2a 20 41 6c 74 65  .        ** Alte
82d0: 72 6e 61 74 69 76 65 6c 79 2c 20 69 66 20 70 49  rnatively, if pI
82e0: 74 65 72 32 20 63 6f 6e 74 61 69 6e 73 20 74 68  ter2 contains th
82f0: 65 20 73 6d 61 6c 6c 65 72 20 6f 66 20 74 68 65  e smaller of the
8300: 20 74 77 6f 20 76 61 6c 75 65 73 2c 0a 20 20 20   two values,.   
8310: 20 20 20 20 20 2a 2a 20 73 65 74 20 61 54 72 65       ** set aTre
8320: 65 5b 69 5d 20 74 6f 20 69 74 73 20 69 6e 64 65  e[i] to its inde
8330: 78 20 61 6e 64 20 75 70 64 61 74 65 20 70 49 74  x and update pIt
8340: 65 72 31 2e 20 49 66 20 76 64 62 65 53 6f 72 74  er1. If vdbeSort
8350: 65 72 43 6f 6d 70 61 72 65 28 29 0a 20 20 20 20  erCompare().    
8360: 20 20 20 20 2a 2a 20 77 61 73 20 61 63 74 75 61      ** was actua
8370: 6c 6c 79 20 63 61 6c 6c 65 64 20 61 62 6f 76 65  lly called above
8380: 2c 20 74 68 65 6e 20 70 53 6f 72 74 65 72 2d 3e  , then pSorter->
8390: 70 55 6e 70 61 63 6b 65 64 20 6e 6f 77 20 63 6f  pUnpacked now co
83a0: 6e 74 61 69 6e 73 0a 20 20 20 20 20 20 20 20 2a  ntains.        *
83b0: 2a 20 61 20 76 61 6c 75 65 20 65 71 75 69 76 61  * a value equiva
83c0: 6c 65 6e 74 20 74 6f 20 70 49 74 65 72 32 2e 20  lent to pIter2. 
83d0: 53 6f 20 73 65 74 20 70 4b 65 79 32 20 74 6f 20  So set pKey2 to 
83e0: 4e 55 4c 4c 20 74 6f 20 70 72 65 76 65 6e 74 0a  NULL to prevent.
83f0: 20 20 20 20 20 20 20 20 2a 2a 20 76 64 62 65 53          ** vdbeS
8400: 6f 72 74 65 72 43 6f 6d 70 61 72 65 28 29 20 66  orterCompare() f
8410: 72 6f 6d 20 64 65 63 6f 64 69 6e 67 20 70 49 74  rom decoding pIt
8420: 65 72 32 20 61 67 61 69 6e 2e 20 20 2a 2f 0a 20  er2 again.  */. 
8430: 20 20 20 20 20 20 20 69 66 28 20 69 52 65 73 3c         if( iRes<
8440: 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  =0 ){.          
8450: 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 69  pSorter->aTree[i
8460: 5d 20 3d 20 28 69 6e 74 29 28 70 49 74 65 72 31  ] = (int)(pIter1
8470: 20 2d 20 70 53 6f 72 74 65 72 2d 3e 61 49 74 65   - pSorter->aIte
8480: 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70 49  r);.          pI
8490: 74 65 72 32 20 3d 20 26 70 53 6f 72 74 65 72 2d  ter2 = &pSorter-
84a0: 3e 61 49 74 65 72 5b 20 70 53 6f 72 74 65 72 2d  >aIter[ pSorter-
84b0: 3e 61 54 72 65 65 5b 69 20 5e 20 30 78 30 30 30  >aTree[i ^ 0x000
84c0: 31 5d 20 5d 3b 0a 20 20 20 20 20 20 20 20 20 20  1] ];.          
84d0: 70 4b 65 79 32 20 3d 20 70 49 74 65 72 32 2d 3e  pKey2 = pIter2->
84e0: 61 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 7d 65  aKey;.        }e
84f0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 69  lse{.          i
8500: 66 28 20 70 49 74 65 72 31 2d 3e 70 46 69 6c 65  f( pIter1->pFile
8510: 20 29 20 70 4b 65 79 32 20 3d 20 30 3b 0a 20 20   ) pKey2 = 0;.  
8520: 20 20 20 20 20 20 20 20 70 53 6f 72 74 65 72 2d          pSorter-
8530: 3e 61 54 72 65 65 5b 69 5d 20 3d 20 28 69 6e 74  >aTree[i] = (int
8540: 29 28 70 49 74 65 72 32 20 2d 20 70 53 6f 72 74  )(pIter2 - pSort
8550: 65 72 2d 3e 61 49 74 65 72 29 3b 0a 20 20 20 20  er->aIter);.    
8560: 20 20 20 20 20 20 70 49 74 65 72 31 20 3d 20 26        pIter1 = &
8570: 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b 20  pSorter->aIter[ 
8580: 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 69  pSorter->aTree[i
8590: 20 5e 20 30 78 30 30 30 31 5d 20 5d 3b 0a 20 20   ^ 0x0001] ];.  
85a0: 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 7d        }..      }
85b0: 0a 20 20 20 20 20 20 2a 70 62 45 6f 66 20 3d 20  .      *pbEof = 
85c0: 28 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b  (pSorter->aIter[
85d0: 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 31  pSorter->aTree[1
85e0: 5d 5d 2e 70 46 69 6c 65 3d 3d 30 29 3b 0a 20 20  ]].pFile==0);.  
85f0: 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20    }.  }else{.   
8600: 20 53 6f 72 74 65 72 52 65 63 6f 72 64 20 2a 70   SorterRecord *p
8610: 46 72 65 65 20 3d 20 70 53 6f 72 74 65 72 2d 3e  Free = pSorter->
8620: 70 52 65 63 6f 72 64 3b 0a 20 20 20 20 70 53 6f  pRecord;.    pSo
8630: 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 20 3d 20  rter->pRecord = 
8640: 70 46 72 65 65 2d 3e 70 4e 65 78 74 3b 0a 20 20  pFree->pNext;.  
8650: 20 20 70 46 72 65 65 2d 3e 70 4e 65 78 74 20 3d    pFree->pNext =
8660: 20 30 3b 0a 20 20 20 20 76 64 62 65 53 6f 72 74   0;.    vdbeSort
8670: 65 72 52 65 63 6f 72 64 46 72 65 65 28 64 62 2c  erRecordFree(db,
8680: 20 70 46 72 65 65 29 3b 0a 20 20 20 20 2a 70 62   pFree);.    *pb
8690: 45 6f 66 20 3d 20 21 70 53 6f 72 74 65 72 2d 3e  Eof = !pSorter->
86a0: 70 52 65 63 6f 72 64 3b 0a 20 20 20 20 72 63 20  pRecord;.    rc 
86b0: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d  = SQLITE_OK;.  }
86c0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
86d0: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20  ./*.** Return a 
86e0: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 62 75 66  pointer to a buf
86f0: 66 65 72 20 6f 77 6e 65 64 20 62 79 20 74 68 65  fer owned by the
8700: 20 73 6f 72 74 65 72 20 74 68 61 74 20 63 6f 6e   sorter that con
8710: 74 61 69 6e 73 20 74 68 65 20 0a 2a 2a 20 63 75  tains the .** cu
8720: 72 72 65 6e 74 20 6b 65 79 2e 0a 2a 2f 0a 73 74  rrent key..*/.st
8730: 61 74 69 63 20 76 6f 69 64 20 2a 76 64 62 65 53  atic void *vdbeS
8740: 6f 72 74 65 72 52 6f 77 6b 65 79 28 0a 20 20 63  orterRowkey(.  c
8750: 6f 6e 73 74 20 56 64 62 65 53 6f 72 74 65 72 20  onst VdbeSorter 
8760: 2a 70 53 6f 72 74 65 72 2c 20 20 20 20 20 20 2f  *pSorter,      /
8770: 2a 20 53 6f 72 74 65 72 20 6f 62 6a 65 63 74 20  * Sorter object 
8780: 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4b 65 79 20  */.  int *pnKey 
8790: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
87a0: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53 69 7a       /* OUT: Siz
87b0: 65 20 6f 66 20 63 75 72 72 65 6e 74 20 6b 65 79  e of current key
87c0: 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a 29 7b 0a   in bytes */.){.
87d0: 20 20 76 6f 69 64 20 2a 70 4b 65 79 3b 0a 20 20    void *pKey;.  
87e0: 69 66 28 20 70 53 6f 72 74 65 72 2d 3e 61 54 72  if( pSorter->aTr
87f0: 65 65 20 29 7b 0a 20 20 20 20 56 64 62 65 53 6f  ee ){.    VdbeSo
8800: 72 74 65 72 49 74 65 72 20 2a 70 49 74 65 72 3b  rterIter *pIter;
8810: 0a 20 20 20 20 70 49 74 65 72 20 3d 20 26 70 53  .    pIter = &pS
8820: 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b 20 70 53  orter->aIter[ pS
8830: 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 31 5d 20  orter->aTree[1] 
8840: 5d 3b 0a 20 20 20 20 2a 70 6e 4b 65 79 20 3d 20  ];.    *pnKey = 
8850: 70 49 74 65 72 2d 3e 6e 4b 65 79 3b 0a 20 20 20  pIter->nKey;.   
8860: 20 70 4b 65 79 20 3d 20 70 49 74 65 72 2d 3e 61   pKey = pIter->a
8870: 4b 65 79 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  Key;.  }else{.  
8880: 20 20 2a 70 6e 4b 65 79 20 3d 20 70 53 6f 72 74    *pnKey = pSort
8890: 65 72 2d 3e 70 52 65 63 6f 72 64 2d 3e 6e 56 61  er->pRecord->nVa
88a0: 6c 3b 0a 20 20 20 20 70 4b 65 79 20 3d 20 70 53  l;.    pKey = pS
88b0: 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 2d 3e  orter->pRecord->
88c0: 70 56 61 6c 3b 0a 20 20 7d 0a 20 20 72 65 74 75  pVal;.  }.  retu
88d0: 72 6e 20 70 4b 65 79 3b 0a 7d 0a 0a 2f 2a 0a 2a  rn pKey;.}../*.*
88e0: 2a 20 43 6f 70 79 20 74 68 65 20 63 75 72 72 65  * Copy the curre
88f0: 6e 74 20 73 6f 72 74 65 72 20 6b 65 79 20 69 6e  nt sorter key in
8900: 74 6f 20 74 68 65 20 6d 65 6d 6f 72 79 20 63 65  to the memory ce
8910: 6c 6c 20 70 4f 75 74 2e 0a 2a 2f 0a 69 6e 74 20  ll pOut..*/.int 
8920: 73 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65  sqlite3VdbeSorte
8930: 72 52 6f 77 6b 65 79 28 63 6f 6e 73 74 20 56 64  rRowkey(const Vd
8940: 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 2c 20  beCursor *pCsr, 
8950: 4d 65 6d 20 2a 70 4f 75 74 29 7b 0a 20 20 56 64  Mem *pOut){.  Vd
8960: 62 65 53 6f 72 74 65 72 20 2a 70 53 6f 72 74 65  beSorter *pSorte
8970: 72 20 3d 20 70 43 73 72 2d 3e 70 53 6f 72 74 65  r = pCsr->pSorte
8980: 72 3b 0a 20 20 76 6f 69 64 20 2a 70 4b 65 79 3b  r;.  void *pKey;
8990: 20 69 6e 74 20 6e 4b 65 79 3b 20 20 20 20 20 20   int nKey;      
89a0: 20 20 20 20 20 2f 2a 20 53 6f 72 74 65 72 20 6b       /* Sorter k
89b0: 65 79 20 74 6f 20 63 6f 70 79 20 69 6e 74 6f 20  ey to copy into 
89c0: 70 4f 75 74 20 2a 2f 0a 0a 20 20 70 4b 65 79 20  pOut */..  pKey 
89d0: 3d 20 76 64 62 65 53 6f 72 74 65 72 52 6f 77 6b  = vdbeSorterRowk
89e0: 65 79 28 70 53 6f 72 74 65 72 2c 20 26 6e 4b 65  ey(pSorter, &nKe
89f0: 79 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65  y);.  if( sqlite
8a00: 33 56 64 62 65 4d 65 6d 47 72 6f 77 28 70 4f 75  3VdbeMemGrow(pOu
8a10: 74 2c 20 6e 4b 65 79 2c 20 30 29 20 29 7b 0a 20  t, nKey, 0) ){. 
8a20: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
8a30: 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 70 4f  _NOMEM;.  }.  pO
8a40: 75 74 2d 3e 6e 20 3d 20 6e 4b 65 79 3b 0a 20 20  ut->n = nKey;.  
8a50: 4d 65 6d 53 65 74 54 79 70 65 46 6c 61 67 28 70  MemSetTypeFlag(p
8a60: 4f 75 74 2c 20 4d 45 4d 5f 42 6c 6f 62 29 3b 0a  Out, MEM_Blob);.
8a70: 20 20 6d 65 6d 63 70 79 28 70 4f 75 74 2d 3e 7a    memcpy(pOut->z
8a80: 2c 20 70 4b 65 79 2c 20 6e 4b 65 79 29 3b 0a 0a  , pKey, nKey);..
8a90: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
8aa0: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d  OK;.}../*.** Com
8ab0: 70 61 72 65 20 74 68 65 20 6b 65 79 20 69 6e 20  pare the key in 
8ac0: 6d 65 6d 6f 72 79 20 63 65 6c 6c 20 70 56 61 6c  memory cell pVal
8ad0: 20 77 69 74 68 20 74 68 65 20 6b 65 79 20 74 68   with the key th
8ae0: 61 74 20 74 68 65 20 73 6f 72 74 65 72 20 63 75  at the sorter cu
8af0: 72 73 6f 72 0a 2a 2a 20 70 61 73 73 65 64 20 61  rsor.** passed a
8b00: 73 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75  s the first argu
8b10: 6d 65 6e 74 20 63 75 72 72 65 6e 74 6c 79 20 70  ment currently p
8b20: 6f 69 6e 74 73 20 74 6f 2e 20 46 6f 72 20 74 68  oints to. For th
8b30: 65 20 70 75 72 70 6f 73 65 73 20 6f 66 0a 2a 2a  e purposes of.**
8b40: 20 74 68 65 20 63 6f 6d 70 61 72 69 73 6f 6e 2c   the comparison,
8b50: 20 69 67 6e 6f 72 65 20 74 68 65 20 72 6f 77 69   ignore the rowi
8b60: 64 20 66 69 65 6c 64 20 61 74 20 74 68 65 20 65  d field at the e
8b70: 6e 64 20 6f 66 20 65 61 63 68 20 72 65 63 6f 72  nd of each recor
8b80: 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65  d..**.** If an e
8b90: 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 72 65 74  rror occurs, ret
8ba0: 75 72 6e 20 61 6e 20 53 51 4c 69 74 65 20 65 72  urn an SQLite er
8bb0: 72 6f 72 20 63 6f 64 65 20 28 69 2e 65 2e 20 53  ror code (i.e. S
8bc0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 2e 0a 2a 2a  QLITE_NOMEM)..**
8bd0: 20 4f 74 68 65 72 77 69 73 65 2c 20 73 65 74 20   Otherwise, set 
8be0: 2a 70 52 65 73 20 74 6f 20 61 20 6e 65 67 61 74  *pRes to a negat
8bf0: 69 76 65 2c 20 7a 65 72 6f 20 6f 72 20 70 6f 73  ive, zero or pos
8c00: 69 74 69 76 65 20 76 61 6c 75 65 20 69 66 20 74  itive value if t
8c10: 68 65 0a 2a 2a 20 6b 65 79 20 69 6e 20 70 56 61  he.** key in pVa
8c20: 6c 20 69 73 20 73 6d 61 6c 6c 65 72 20 74 68 61  l is smaller tha
8c30: 6e 2c 20 65 71 75 61 6c 20 74 6f 20 6f 72 20 6c  n, equal to or l
8c40: 61 72 67 65 72 20 74 68 61 6e 20 74 68 65 20 63  arger than the c
8c50: 75 72 72 65 6e 74 20 73 6f 72 74 65 72 0a 2a 2a  urrent sorter.**
8c60: 20 6b 65 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c   key..*/.int sql
8c70: 69 74 65 33 56 64 62 65 53 6f 72 74 65 72 43 6f  ite3VdbeSorterCo
8c80: 6d 70 61 72 65 28 0a 20 20 63 6f 6e 73 74 20 56  mpare(.  const V
8c90: 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 2c  dbeCursor *pCsr,
8ca0: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 6f 72 74           /* Sort
8cb0: 65 72 20 63 75 72 73 6f 72 20 2a 2f 0a 20 20 4d  er cursor */.  M
8cc0: 65 6d 20 2a 70 56 61 6c 2c 20 20 20 20 20 20 20  em *pVal,       
8cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
8ce0: 2a 20 56 61 6c 75 65 20 74 6f 20 63 6f 6d 70 61  * Value to compa
8cf0: 72 65 20 74 6f 20 63 75 72 72 65 6e 74 20 73 6f  re to current so
8d00: 72 74 65 72 20 6b 65 79 20 2a 2f 0a 20 20 69 6e  rter key */.  in
8d10: 74 20 6e 49 67 6e 6f 72 65 2c 20 20 20 20 20 20  t nIgnore,      
8d20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
8d30: 20 49 67 6e 6f 72 65 20 74 68 69 73 20 6d 61 6e   Ignore this man
8d40: 79 20 66 69 65 6c 64 73 20 61 74 20 74 68 65 20  y fields at the 
8d50: 65 6e 64 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52  end */.  int *pR
8d60: 65 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20  es              
8d70: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
8d80: 20 52 65 73 75 6c 74 20 6f 66 20 63 6f 6d 70 61   Result of compa
8d90: 72 69 73 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 56 64  rison */.){.  Vd
8da0: 62 65 53 6f 72 74 65 72 20 2a 70 53 6f 72 74 65  beSorter *pSorte
8db0: 72 20 3d 20 70 43 73 72 2d 3e 70 53 6f 72 74 65  r = pCsr->pSorte
8dc0: 72 3b 0a 20 20 76 6f 69 64 20 2a 70 4b 65 79 3b  r;.  void *pKey;
8dd0: 20 69 6e 74 20 6e 4b 65 79 3b 20 20 20 20 20 20   int nKey;      
8de0: 20 20 20 20 20 2f 2a 20 53 6f 72 74 65 72 20 6b       /* Sorter k
8df0: 65 79 20 74 6f 20 63 6f 6d 70 61 72 65 20 70 56  ey to compare pV
8e00: 61 6c 20 77 69 74 68 20 2a 2f 0a 0a 20 20 70 4b  al with */..  pK
8e10: 65 79 20 3d 20 76 64 62 65 53 6f 72 74 65 72 52  ey = vdbeSorterR
8e20: 6f 77 6b 65 79 28 70 53 6f 72 74 65 72 2c 20 26  owkey(pSorter, &
8e30: 6e 4b 65 79 29 3b 0a 20 20 76 64 62 65 53 6f 72  nKey);.  vdbeSor
8e40: 74 65 72 43 6f 6d 70 61 72 65 28 70 43 73 72 2c  terCompare(pCsr,
8e50: 20 6e 49 67 6e 6f 72 65 2c 20 70 56 61 6c 2d 3e   nIgnore, pVal->
8e60: 7a 2c 20 70 56 61 6c 2d 3e 6e 2c 20 70 4b 65 79  z, pVal->n, pKey
8e70: 2c 20 6e 4b 65 79 2c 20 70 52 65 73 29 3b 0a 20  , nKey, pRes);. 
8e80: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
8e90: 4b 3b 0a 7d 0a                                   K;.}.