/ Hex Artifact Content
Login

Artifact 9d83601f9d6243fe70dd0169a2820c5ddfd48147:


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 72 32 2d 3e 66 6c 61 67 73 20 7c 3d 20     r2->flags |= 
3bb0: 55 4e 50 41 43 4b 45 44 5f 50 52 45 46 49 58 5f  UNPACKED_PREFIX_
3bc0: 4d 41 54 43 48 3b 0a 20 20 7d 0a 0a 20 20 2a 70  MATCH;.  }..  *p
3bd0: 52 65 73 20 3d 20 73 71 6c 69 74 65 33 56 64 62  Res = sqlite3Vdb
3be0: 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e  eRecordCompare(n
3bf0: 4b 65 79 31 2c 20 70 4b 65 79 31 2c 20 72 32 29  Key1, pKey1, r2)
3c00: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
3c10: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
3c20: 65 64 20 74 6f 20 63 6f 6d 70 61 72 65 20 74 77  ed to compare tw
3c30: 6f 20 69 74 65 72 61 74 6f 72 20 6b 65 79 73 20  o iterator keys 
3c40: 77 68 65 6e 20 6d 65 72 67 69 6e 67 20 0a 2a 2a  when merging .**
3c50: 20 6d 75 6c 74 69 70 6c 65 20 62 2d 74 72 65 65   multiple b-tree
3c60: 20 73 65 67 6d 65 6e 74 73 2e 20 50 61 72 61 6d   segments. Param
3c70: 65 74 65 72 20 69 4f 75 74 20 69 73 20 74 68 65  eter iOut is the
3c80: 20 69 6e 64 65 78 20 6f 66 20 74 68 65 20 61 54   index of the aT
3c90: 72 65 65 5b 5d 20 0a 2a 2a 20 76 61 6c 75 65 20  ree[] .** value 
3ca0: 74 6f 20 72 65 63 61 6c 63 75 6c 61 74 65 2e 0a  to recalculate..
3cb0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64  */.static int vd
3cc0: 62 65 53 6f 72 74 65 72 44 6f 43 6f 6d 70 61 72  beSorterDoCompar
3cd0: 65 28 63 6f 6e 73 74 20 56 64 62 65 43 75 72 73  e(const VdbeCurs
3ce0: 6f 72 20 2a 70 43 73 72 2c 20 69 6e 74 20 69 4f  or *pCsr, int iO
3cf0: 75 74 29 7b 0a 20 20 56 64 62 65 53 6f 72 74 65  ut){.  VdbeSorte
3d00: 72 20 2a 70 53 6f 72 74 65 72 20 3d 20 70 43 73  r *pSorter = pCs
3d10: 72 2d 3e 70 53 6f 72 74 65 72 3b 0a 20 20 69 6e  r->pSorter;.  in
3d20: 74 20 69 31 3b 0a 20 20 69 6e 74 20 69 32 3b 0a  t i1;.  int i2;.
3d30: 20 20 69 6e 74 20 69 52 65 73 3b 0a 20 20 56 64    int iRes;.  Vd
3d40: 62 65 53 6f 72 74 65 72 49 74 65 72 20 2a 70 31  beSorterIter *p1
3d50: 3b 0a 20 20 56 64 62 65 53 6f 72 74 65 72 49 74  ;.  VdbeSorterIt
3d60: 65 72 20 2a 70 32 3b 0a 0a 20 20 61 73 73 65 72  er *p2;..  asser
3d70: 74 28 20 69 4f 75 74 3c 70 53 6f 72 74 65 72 2d  t( iOut<pSorter-
3d80: 3e 6e 54 72 65 65 20 26 26 20 69 4f 75 74 3e 30  >nTree && iOut>0
3d90: 20 29 3b 0a 0a 20 20 69 66 28 20 69 4f 75 74 3e   );..  if( iOut>
3da0: 3d 28 70 53 6f 72 74 65 72 2d 3e 6e 54 72 65 65  =(pSorter->nTree
3db0: 2f 32 29 20 29 7b 0a 20 20 20 20 69 31 20 3d 20  /2) ){.    i1 = 
3dc0: 28 69 4f 75 74 20 2d 20 70 53 6f 72 74 65 72 2d  (iOut - pSorter-
3dd0: 3e 6e 54 72 65 65 2f 32 29 20 2a 20 32 3b 0a 20  >nTree/2) * 2;. 
3de0: 20 20 20 69 32 20 3d 20 69 31 20 2b 20 31 3b 0a     i2 = i1 + 1;.
3df0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 31 20    }else{.    i1 
3e00: 3d 20 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65  = pSorter->aTree
3e10: 5b 69 4f 75 74 2a 32 5d 3b 0a 20 20 20 20 69 32  [iOut*2];.    i2
3e20: 20 3d 20 70 53 6f 72 74 65 72 2d 3e 61 54 72 65   = pSorter->aTre
3e30: 65 5b 69 4f 75 74 2a 32 2b 31 5d 3b 0a 20 20 7d  e[iOut*2+1];.  }
3e40: 0a 0a 20 20 70 31 20 3d 20 26 70 53 6f 72 74 65  ..  p1 = &pSorte
3e50: 72 2d 3e 61 49 74 65 72 5b 69 31 5d 3b 0a 20 20  r->aIter[i1];.  
3e60: 70 32 20 3d 20 26 70 53 6f 72 74 65 72 2d 3e 61  p2 = &pSorter->a
3e70: 49 74 65 72 5b 69 32 5d 3b 0a 0a 20 20 69 66 28  Iter[i2];..  if(
3e80: 20 70 31 2d 3e 70 46 69 6c 65 3d 3d 30 20 29 7b   p1->pFile==0 ){
3e90: 0a 20 20 20 20 69 52 65 73 20 3d 20 69 32 3b 0a  .    iRes = i2;.
3ea0: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 32 2d 3e    }else if( p2->
3eb0: 70 46 69 6c 65 3d 3d 30 20 29 7b 0a 20 20 20 20  pFile==0 ){.    
3ec0: 69 52 65 73 20 3d 20 69 31 3b 0a 20 20 7d 65 6c  iRes = i1;.  }el
3ed0: 73 65 7b 0a 20 20 20 20 69 6e 74 20 72 65 73 3b  se{.    int res;
3ee0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 73  .    assert( pCs
3ef0: 72 2d 3e 70 53 6f 72 74 65 72 2d 3e 70 55 6e 70  r->pSorter->pUnp
3f00: 61 63 6b 65 64 21 3d 30 20 29 3b 20 20 2f 2a 20  acked!=0 );  /* 
3f10: 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 76 64 62  allocated in vdb
3f20: 65 53 6f 72 74 65 72 4d 65 72 67 65 28 29 20 2a  eSorterMerge() *
3f30: 2f 0a 20 20 20 20 76 64 62 65 53 6f 72 74 65 72  /.    vdbeSorter
3f40: 43 6f 6d 70 61 72 65 28 0a 20 20 20 20 20 20 20  Compare(.       
3f50: 20 70 43 73 72 2c 20 30 2c 20 70 31 2d 3e 61 4b   pCsr, 0, p1->aK
3f60: 65 79 2c 20 70 31 2d 3e 6e 4b 65 79 2c 20 70 32  ey, p1->nKey, p2
3f70: 2d 3e 61 4b 65 79 2c 20 70 32 2d 3e 6e 4b 65 79  ->aKey, p2->nKey
3f80: 2c 20 26 72 65 73 0a 20 20 20 20 29 3b 0a 20 20  , &res.    );.  
3f90: 20 20 69 66 28 20 72 65 73 3c 3d 30 20 29 7b 0a    if( res<=0 ){.
3fa0: 20 20 20 20 20 20 69 52 65 73 20 3d 20 69 31 3b        iRes = i1;
3fb0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
3fc0: 20 20 69 52 65 73 20 3d 20 69 32 3b 0a 20 20 20    iRes = i2;.   
3fd0: 20 7d 0a 20 20 7d 0a 0a 20 20 70 53 6f 72 74 65   }.  }..  pSorte
3fe0: 72 2d 3e 61 54 72 65 65 5b 69 4f 75 74 5d 20 3d  r->aTree[iOut] =
3ff0: 20 69 52 65 73 3b 0a 20 20 72 65 74 75 72 6e 20   iRes;.  return 
4000: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a  SQLITE_OK;.}../*
4010: 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 74  .** Initialize t
4020: 68 65 20 74 65 6d 70 6f 72 61 72 79 20 69 6e 64  he temporary ind
4030: 65 78 20 63 75 72 73 6f 72 20 6a 75 73 74 20 6f  ex cursor just o
4040: 70 65 6e 65 64 20 61 73 20 61 20 73 6f 72 74 65  pened as a sorte
4050: 72 20 63 75 72 73 6f 72 2e 0a 2a 2f 0a 69 6e 74  r cursor..*/.int
4060: 20 73 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74   sqlite3VdbeSort
4070: 65 72 49 6e 69 74 28 73 71 6c 69 74 65 33 20 2a  erInit(sqlite3 *
4080: 64 62 2c 20 56 64 62 65 43 75 72 73 6f 72 20 2a  db, VdbeCursor *
4090: 70 43 73 72 29 7b 0a 20 20 69 6e 74 20 70 67 73  pCsr){.  int pgs
40a0: 7a 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  z;              
40b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65           /* Page
40c0: 20 73 69 7a 65 20 6f 66 20 6d 61 69 6e 20 64 61   size of main da
40d0: 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20  tabase */.  int 
40e0: 6d 78 43 61 63 68 65 3b 20 20 20 20 20 20 20 20  mxCache;        
40f0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43              /* C
4100: 61 63 68 65 20 73 69 7a 65 20 2a 2f 0a 20 20 56  ache size */.  V
4110: 64 62 65 53 6f 72 74 65 72 20 2a 70 53 6f 72 74  dbeSorter *pSort
4120: 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f  er;            /
4130: 2a 20 54 68 65 20 6e 65 77 20 73 6f 72 74 65 72  * The new sorter
4140: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 64 3b 20 20   */.  char *d;  
4150: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4160: 20 20 20 20 20 20 2f 2a 20 44 75 6d 6d 79 20 2a        /* Dummy *
4170: 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 43 73  /..  assert( pCs
4180: 72 2d 3e 70 4b 65 79 49 6e 66 6f 20 26 26 20 70  r->pKeyInfo && p
4190: 43 73 72 2d 3e 70 42 74 3d 3d 30 20 29 3b 0a 20  Csr->pBt==0 );. 
41a0: 20 70 43 73 72 2d 3e 70 53 6f 72 74 65 72 20 3d   pCsr->pSorter =
41b0: 20 70 53 6f 72 74 65 72 20 3d 20 73 71 6c 69 74   pSorter = sqlit
41c0: 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 64  e3DbMallocZero(d
41d0: 62 2c 20 73 69 7a 65 6f 66 28 56 64 62 65 53 6f  b, sizeof(VdbeSo
41e0: 72 74 65 72 29 29 3b 0a 20 20 69 66 28 20 70 53  rter));.  if( pS
41f0: 6f 72 74 65 72 3d 3d 30 20 29 7b 0a 20 20 20 20  orter==0 ){.    
4200: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f  return SQLITE_NO
4210: 4d 45 4d 3b 0a 20 20 7d 0a 20 20 0a 20 20 70 53  MEM;.  }.  .  pS
4220: 6f 72 74 65 72 2d 3e 70 55 6e 70 61 63 6b 65 64  orter->pUnpacked
4230: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 41 6c   = sqlite3VdbeAl
4240: 6c 6f 63 55 6e 70 61 63 6b 65 64 52 65 63 6f 72  locUnpackedRecor
4250: 64 28 70 43 73 72 2d 3e 70 4b 65 79 49 6e 66 6f  d(pCsr->pKeyInfo
4260: 2c 20 30 2c 20 30 2c 20 26 64 29 3b 0a 20 20 69  , 0, 0, &d);.  i
4270: 66 28 20 70 53 6f 72 74 65 72 2d 3e 70 55 6e 70  f( pSorter->pUnp
4280: 61 63 6b 65 64 3d 3d 30 20 29 20 72 65 74 75 72  acked==0 ) retur
4290: 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  n SQLITE_NOMEM;.
42a0: 20 20 61 73 73 65 72 74 28 20 70 53 6f 72 74 65    assert( pSorte
42b0: 72 2d 3e 70 55 6e 70 61 63 6b 65 64 3d 3d 28 55  r->pUnpacked==(U
42c0: 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 20 2a 29  npackedRecord *)
42d0: 64 20 29 3b 0a 0a 20 20 69 66 28 20 21 73 71 6c  d );..  if( !sql
42e0: 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 79  ite3TempInMemory
42f0: 28 64 62 29 20 29 7b 0a 20 20 20 20 70 67 73 7a  (db) ){.    pgsz
4300: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 47   = sqlite3BtreeG
4310: 65 74 50 61 67 65 53 69 7a 65 28 64 62 2d 3e 61  etPageSize(db->a
4320: 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 20 20  Db[0].pBt);.    
4330: 70 53 6f 72 74 65 72 2d 3e 6d 6e 50 6d 61 53 69  pSorter->mnPmaSi
4340: 7a 65 20 3d 20 53 4f 52 54 45 52 5f 4d 49 4e 5f  ze = SORTER_MIN_
4350: 57 4f 52 4b 49 4e 47 20 2a 20 70 67 73 7a 3b 0a  WORKING * pgsz;.
4360: 20 20 20 20 6d 78 43 61 63 68 65 20 3d 20 64 62      mxCache = db
4370: 2d 3e 61 44 62 5b 30 5d 2e 70 53 63 68 65 6d 61  ->aDb[0].pSchema
4380: 2d 3e 63 61 63 68 65 5f 73 69 7a 65 3b 0a 20 20  ->cache_size;.  
4390: 20 20 69 66 28 20 6d 78 43 61 63 68 65 3c 53 4f    if( mxCache<SO
43a0: 52 54 45 52 5f 4d 49 4e 5f 57 4f 52 4b 49 4e 47  RTER_MIN_WORKING
43b0: 20 29 20 6d 78 43 61 63 68 65 20 3d 20 53 4f 52   ) mxCache = SOR
43c0: 54 45 52 5f 4d 49 4e 5f 57 4f 52 4b 49 4e 47 3b  TER_MIN_WORKING;
43d0: 0a 20 20 20 20 70 53 6f 72 74 65 72 2d 3e 6d 78  .    pSorter->mx
43e0: 50 6d 61 53 69 7a 65 20 3d 20 6d 78 43 61 63 68  PmaSize = mxCach
43f0: 65 20 2a 20 70 67 73 7a 3b 0a 20 20 7d 0a 0a 20  e * pgsz;.  }.. 
4400: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
4410: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65  K;.}../*.** Free
4420: 20 74 68 65 20 6c 69 73 74 20 6f 66 20 73 6f 72   the list of sor
4430: 74 65 64 20 72 65 63 6f 72 64 73 20 73 74 61 72  ted records star
4440: 74 69 6e 67 20 61 74 20 70 52 65 63 6f 72 64 2e  ting at pRecord.
4450: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
4460: 76 64 62 65 53 6f 72 74 65 72 52 65 63 6f 72 64  vdbeSorterRecord
4470: 46 72 65 65 28 73 71 6c 69 74 65 33 20 2a 64 62  Free(sqlite3 *db
4480: 2c 20 53 6f 72 74 65 72 52 65 63 6f 72 64 20 2a  , SorterRecord *
4490: 70 52 65 63 6f 72 64 29 7b 0a 20 20 53 6f 72 74  pRecord){.  Sort
44a0: 65 72 52 65 63 6f 72 64 20 2a 70 3b 0a 20 20 53  erRecord *p;.  S
44b0: 6f 72 74 65 72 52 65 63 6f 72 64 20 2a 70 4e 65  orterRecord *pNe
44c0: 78 74 3b 0a 20 20 66 6f 72 28 70 3d 70 52 65 63  xt;.  for(p=pRec
44d0: 6f 72 64 3b 20 70 3b 20 70 3d 70 4e 65 78 74 29  ord; p; p=pNext)
44e0: 7b 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 70 2d  {.    pNext = p-
44f0: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 73 71 6c 69  >pNext;.    sqli
4500: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 29  te3DbFree(db, p)
4510: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46  ;.  }.}../*.** F
4520: 72 65 65 20 61 6e 79 20 63 75 72 73 6f 72 20 63  ree any cursor c
4530: 6f 6d 70 6f 6e 65 6e 74 73 20 61 6c 6c 6f 63 61  omponents alloca
4540: 74 65 64 20 62 79 20 73 71 6c 69 74 65 33 56 64  ted by sqlite3Vd
4550: 62 65 53 6f 72 74 65 72 58 58 58 20 72 6f 75 74  beSorterXXX rout
4560: 69 6e 65 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  ines..*/.void sq
4570: 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65 72 43  lite3VdbeSorterC
4580: 6c 6f 73 65 28 73 71 6c 69 74 65 33 20 2a 64 62  lose(sqlite3 *db
4590: 2c 20 56 64 62 65 43 75 72 73 6f 72 20 2a 70 43  , VdbeCursor *pC
45a0: 73 72 29 7b 0a 20 20 56 64 62 65 53 6f 72 74 65  sr){.  VdbeSorte
45b0: 72 20 2a 70 53 6f 72 74 65 72 20 3d 20 70 43 73  r *pSorter = pCs
45c0: 72 2d 3e 70 53 6f 72 74 65 72 3b 0a 20 20 69 66  r->pSorter;.  if
45d0: 28 20 70 53 6f 72 74 65 72 20 29 7b 0a 20 20 20  ( pSorter ){.   
45e0: 20 69 66 28 20 70 53 6f 72 74 65 72 2d 3e 61 49   if( pSorter->aI
45f0: 74 65 72 20 29 7b 0a 20 20 20 20 20 20 69 6e 74  ter ){.      int
4600: 20 69 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d   i;.      for(i=
4610: 30 3b 20 69 3c 70 53 6f 72 74 65 72 2d 3e 6e 54  0; i<pSorter->nT
4620: 72 65 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  ree; i++){.     
4630: 20 20 20 76 64 62 65 53 6f 72 74 65 72 49 74 65     vdbeSorterIte
4640: 72 5a 65 72 6f 28 64 62 2c 20 26 70 53 6f 72 74  rZero(db, &pSort
4650: 65 72 2d 3e 61 49 74 65 72 5b 69 5d 29 3b 0a 20  er->aIter[i]);. 
4660: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c       }.      sql
4670: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70  ite3DbFree(db, p
4680: 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 29 3b 0a  Sorter->aIter);.
4690: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 53      }.    if( pS
46a0: 6f 72 74 65 72 2d 3e 70 54 65 6d 70 31 20 29 7b  orter->pTemp1 ){
46b0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73  .      sqlite3Os
46c0: 43 6c 6f 73 65 46 72 65 65 28 70 53 6f 72 74 65  CloseFree(pSorte
46d0: 72 2d 3e 70 54 65 6d 70 31 29 3b 0a 20 20 20 20  r->pTemp1);.    
46e0: 7d 0a 20 20 20 20 76 64 62 65 53 6f 72 74 65 72  }.    vdbeSorter
46f0: 52 65 63 6f 72 64 46 72 65 65 28 64 62 2c 20 70  RecordFree(db, p
4700: 53 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 29  Sorter->pRecord)
4710: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46  ;.    sqlite3DbF
4720: 72 65 65 28 64 62 2c 20 70 53 6f 72 74 65 72 2d  ree(db, pSorter-
4730: 3e 70 55 6e 70 61 63 6b 65 64 29 3b 0a 20 20 20  >pUnpacked);.   
4740: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64   sqlite3DbFree(d
4750: 62 2c 20 70 53 6f 72 74 65 72 29 3b 0a 20 20 20  b, pSorter);.   
4760: 20 70 43 73 72 2d 3e 70 53 6f 72 74 65 72 20 3d   pCsr->pSorter =
4770: 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a   0;.  }.}../*.**
4780: 20 41 6c 6c 6f 63 61 74 65 20 73 70 61 63 65 20   Allocate space 
4790: 66 6f 72 20 61 20 66 69 6c 65 2d 68 61 6e 64 6c  for a file-handl
47a0: 65 20 61 6e 64 20 6f 70 65 6e 20 61 20 74 65 6d  e and open a tem
47b0: 70 6f 72 61 72 79 20 66 69 6c 65 2e 20 49 66 20  porary file. If 
47c0: 73 75 63 63 65 73 73 66 75 6c 2c 0a 2a 2a 20 73  successful,.** s
47d0: 65 74 20 2a 70 70 46 69 6c 65 20 74 6f 20 70 6f  et *ppFile to po
47e0: 69 6e 74 20 74 6f 20 74 68 65 20 6d 61 6c 6c 6f  int to the mallo
47f0: 63 27 64 20 66 69 6c 65 2d 68 61 6e 64 6c 65 20  c'd file-handle 
4800: 61 6e 64 20 72 65 74 75 72 6e 20 53 51 4c 49 54  and return SQLIT
4810: 45 5f 4f 4b 2e 0a 2a 2a 20 4f 74 68 65 72 77 69  E_OK..** Otherwi
4820: 73 65 2c 20 73 65 74 20 2a 70 70 46 69 6c 65 20  se, set *ppFile 
4830: 74 6f 20 30 20 61 6e 64 20 72 65 74 75 72 6e 20  to 0 and return 
4840: 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20  an SQLite error 
4850: 63 6f 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  code..*/.static 
4860: 69 6e 74 20 76 64 62 65 53 6f 72 74 65 72 4f 70  int vdbeSorterOp
4870: 65 6e 54 65 6d 70 46 69 6c 65 28 73 71 6c 69 74  enTempFile(sqlit
4880: 65 33 20 2a 64 62 2c 20 73 71 6c 69 74 65 33 5f  e3 *db, sqlite3_
4890: 66 69 6c 65 20 2a 2a 70 70 46 69 6c 65 29 7b 0a  file **ppFile){.
48a0: 20 20 69 6e 74 20 64 75 6d 6d 79 3b 0a 20 20 72    int dummy;.  r
48b0: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 4f 73 4f  eturn sqlite3OsO
48c0: 70 65 6e 4d 61 6c 6c 6f 63 28 64 62 2d 3e 70 56  penMalloc(db->pV
48d0: 66 73 2c 20 30 2c 20 70 70 46 69 6c 65 2c 0a 20  fs, 0, ppFile,. 
48e0: 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e       SQLITE_OPEN
48f0: 5f 54 45 4d 50 5f 4a 4f 55 52 4e 41 4c 20 7c 0a  _TEMP_JOURNAL |.
4900: 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45        SQLITE_OPE
4910: 4e 5f 52 45 41 44 57 52 49 54 45 20 20 20 20 7c  N_READWRITE    |
4920: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 52 45   SQLITE_OPEN_CRE
4930: 41 54 45 20 7c 0a 20 20 20 20 20 20 53 51 4c 49  ATE |.      SQLI
4940: 54 45 5f 4f 50 45 4e 5f 45 58 43 4c 55 53 49 56  TE_OPEN_EXCLUSIV
4950: 45 20 20 20 20 7c 20 53 51 4c 49 54 45 5f 4f 50  E    | SQLITE_OP
4960: 45 4e 5f 44 45 4c 45 54 45 4f 4e 43 4c 4f 53 45  EN_DELETEONCLOSE
4970: 2c 20 26 64 75 6d 6d 79 0a 20 20 29 3b 0a 7d 0a  , &dummy.  );.}.
4980: 0a 2f 2a 0a 2a 2a 20 4d 65 72 67 65 20 74 68 65  ./*.** Merge the
4990: 20 74 77 6f 20 73 6f 72 74 65 64 20 6c 69 73 74   two sorted list
49a0: 73 20 70 31 20 61 6e 64 20 70 32 20 69 6e 74 6f  s p1 and p2 into
49b0: 20 61 20 73 69 6e 67 6c 65 20 6c 69 73 74 2e 0a   a single list..
49c0: 2a 2a 20 53 65 74 20 2a 70 70 4f 75 74 20 74 6f  ** Set *ppOut to
49d0: 20 74 68 65 20 68 65 61 64 20 6f 66 20 74 68 65   the head of the
49e0: 20 6e 65 77 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74   new list..*/.st
49f0: 61 74 69 63 20 76 6f 69 64 20 76 64 62 65 53 6f  atic void vdbeSo
4a00: 72 74 65 72 4d 65 72 67 65 28 0a 20 20 63 6f 6e  rterMerge(.  con
4a10: 73 74 20 56 64 62 65 43 75 72 73 6f 72 20 2a 70  st VdbeCursor *p
4a20: 43 73 72 2c 20 20 20 20 20 20 20 20 20 2f 2a 20  Csr,         /* 
4a30: 46 6f 72 20 70 4b 65 79 49 6e 66 6f 20 2a 2f 0a  For pKeyInfo */.
4a40: 20 20 53 6f 72 74 65 72 52 65 63 6f 72 64 20 2a    SorterRecord *
4a50: 70 31 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  p1,             
4a60: 20 20 2f 2a 20 46 69 72 73 74 20 6c 69 73 74 20    /* First list 
4a70: 74 6f 20 6d 65 72 67 65 20 2a 2f 0a 20 20 53 6f  to merge */.  So
4a80: 72 74 65 72 52 65 63 6f 72 64 20 2a 70 32 2c 20  rterRecord *p2, 
4a90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4aa0: 20 53 65 63 6f 6e 64 20 6c 69 73 74 20 74 6f 20   Second list to 
4ab0: 6d 65 72 67 65 20 2a 2f 0a 20 20 53 6f 72 74 65  merge */.  Sorte
4ac0: 72 52 65 63 6f 72 64 20 2a 2a 70 70 4f 75 74 20  rRecord **ppOut 
4ad0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55             /* OU
4ae0: 54 3a 20 48 65 61 64 20 6f 66 20 6d 65 72 67 65  T: Head of merge
4af0: 64 20 6c 69 73 74 20 2a 2f 0a 29 7b 0a 20 20 53  d list */.){.  S
4b00: 6f 72 74 65 72 52 65 63 6f 72 64 20 2a 70 46 69  orterRecord *pFi
4b10: 6e 61 6c 20 3d 20 30 3b 0a 20 20 53 6f 72 74 65  nal = 0;.  Sorte
4b20: 72 52 65 63 6f 72 64 20 2a 2a 70 70 20 3d 20 26  rRecord **pp = &
4b30: 70 46 69 6e 61 6c 3b 0a 20 20 76 6f 69 64 20 2a  pFinal;.  void *
4b40: 70 56 61 6c 32 20 3d 20 70 32 20 3f 20 70 32 2d  pVal2 = p2 ? p2-
4b50: 3e 70 56 61 6c 20 3a 20 30 3b 0a 0a 20 20 77 68  >pVal : 0;..  wh
4b60: 69 6c 65 28 20 70 31 20 26 26 20 70 32 20 29 7b  ile( p1 && p2 ){
4b70: 0a 20 20 20 20 69 6e 74 20 72 65 73 3b 0a 20 20  .    int res;.  
4b80: 20 20 76 64 62 65 53 6f 72 74 65 72 43 6f 6d 70    vdbeSorterComp
4b90: 61 72 65 28 70 43 73 72 2c 20 30 2c 20 70 31 2d  are(pCsr, 0, p1-
4ba0: 3e 70 56 61 6c 2c 20 70 31 2d 3e 6e 56 61 6c 2c  >pVal, p1->nVal,
4bb0: 20 70 56 61 6c 32 2c 20 70 32 2d 3e 6e 56 61 6c   pVal2, p2->nVal
4bc0: 2c 20 26 72 65 73 29 3b 0a 20 20 20 20 69 66 28  , &res);.    if(
4bd0: 20 72 65 73 3c 3d 30 20 29 7b 0a 20 20 20 20 20   res<=0 ){.     
4be0: 20 2a 70 70 20 3d 20 70 31 3b 0a 20 20 20 20 20   *pp = p1;.     
4bf0: 20 70 70 20 3d 20 26 70 31 2d 3e 70 4e 65 78 74   pp = &p1->pNext
4c00: 3b 0a 20 20 20 20 20 20 70 31 20 3d 20 70 31 2d  ;.      p1 = p1-
4c10: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 70 56  >pNext;.      pV
4c20: 61 6c 32 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c  al2 = 0;.    }el
4c30: 73 65 7b 0a 20 20 20 20 20 20 2a 70 70 20 3d 20  se{.      *pp = 
4c40: 70 32 3b 0a 20 20 20 20 20 20 20 70 70 20 3d 20  p2;.       pp = 
4c50: 26 70 32 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  &p2->pNext;.    
4c60: 20 20 70 32 20 3d 20 70 32 2d 3e 70 4e 65 78 74    p2 = p2->pNext
4c70: 3b 0a 20 20 20 20 20 20 69 66 28 20 70 32 3d 3d  ;.      if( p2==
4c80: 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20  0 ) break;.     
4c90: 20 70 56 61 6c 32 20 3d 20 70 32 2d 3e 70 56 61   pVal2 = p2->pVa
4ca0: 6c 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 2a  l;.    }.  }.  *
4cb0: 70 70 20 3d 20 70 31 20 3f 20 70 31 20 3a 20 70  pp = p1 ? p1 : p
4cc0: 32 3b 0a 20 20 2a 70 70 4f 75 74 20 3d 20 70 46  2;.  *ppOut = pF
4cd0: 69 6e 61 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53  inal;.}../*.** S
4ce0: 6f 72 74 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c  ort the linked l
4cf0: 69 73 74 20 6f 66 20 72 65 63 6f 72 64 73 20 68  ist of records h
4d00: 65 61 64 65 64 20 61 74 20 70 43 73 72 2d 3e 70  eaded at pCsr->p
4d10: 52 65 63 6f 72 64 2e 20 52 65 74 75 72 6e 20 53  Record. Return S
4d20: 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 69 66 20 73  QLITE_OK.** if s
4d30: 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 20 61 6e  uccessful, or an
4d40: 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f   SQLite error co
4d50: 64 65 20 28 69 2e 65 2e 20 53 51 4c 49 54 45 5f  de (i.e. SQLITE_
4d60: 4e 4f 4d 45 4d 29 20 69 66 20 61 6e 20 65 72 72  NOMEM) if an err
4d70: 6f 72 0a 2a 2a 20 6f 63 63 75 72 73 2e 0a 2a 2f  or.** occurs..*/
4d80: 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64 62 65  .static int vdbe
4d90: 53 6f 72 74 65 72 53 6f 72 74 28 63 6f 6e 73 74  SorterSort(const
4da0: 20 56 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73   VdbeCursor *pCs
4db0: 72 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 53  r){.  int i;.  S
4dc0: 6f 72 74 65 72 52 65 63 6f 72 64 20 2a 2a 61 53  orterRecord **aS
4dd0: 6c 6f 74 3b 0a 20 20 53 6f 72 74 65 72 52 65 63  lot;.  SorterRec
4de0: 6f 72 64 20 2a 70 3b 0a 20 20 56 64 62 65 53 6f  ord *p;.  VdbeSo
4df0: 72 74 65 72 20 2a 70 53 6f 72 74 65 72 20 3d 20  rter *pSorter = 
4e00: 70 43 73 72 2d 3e 70 53 6f 72 74 65 72 3b 0a 0a  pCsr->pSorter;..
4e10: 20 20 61 53 6c 6f 74 20 3d 20 28 53 6f 72 74 65    aSlot = (Sorte
4e20: 72 52 65 63 6f 72 64 20 2a 2a 29 73 71 6c 69 74  rRecord **)sqlit
4e30: 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 36 34 20  e3MallocZero(64 
4e40: 2a 20 73 69 7a 65 6f 66 28 53 6f 72 74 65 72 52  * sizeof(SorterR
4e50: 65 63 6f 72 64 20 2a 29 29 3b 0a 20 20 69 66 28  ecord *));.  if(
4e60: 20 21 61 53 6c 6f 74 20 29 7b 0a 20 20 20 20 72   !aSlot ){.    r
4e70: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d  eturn SQLITE_NOM
4e80: 45 4d 3b 0a 20 20 7d 0a 0a 20 20 70 20 3d 20 70  EM;.  }..  p = p
4e90: 53 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 3b  Sorter->pRecord;
4ea0: 0a 20 20 77 68 69 6c 65 28 20 70 20 29 7b 0a 20  .  while( p ){. 
4eb0: 20 20 20 53 6f 72 74 65 72 52 65 63 6f 72 64 20     SorterRecord 
4ec0: 2a 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78  *pNext = p->pNex
4ed0: 74 3b 0a 20 20 20 20 70 2d 3e 70 4e 65 78 74 20  t;.    p->pNext 
4ee0: 3d 20 30 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30  = 0;.    for(i=0
4ef0: 3b 20 61 53 6c 6f 74 5b 69 5d 3b 20 69 2b 2b 29  ; aSlot[i]; i++)
4f00: 7b 0a 20 20 20 20 20 20 76 64 62 65 53 6f 72 74  {.      vdbeSort
4f10: 65 72 4d 65 72 67 65 28 70 43 73 72 2c 20 70 2c  erMerge(pCsr, p,
4f20: 20 61 53 6c 6f 74 5b 69 5d 2c 20 26 70 29 3b 0a   aSlot[i], &p);.
4f30: 20 20 20 20 20 20 61 53 6c 6f 74 5b 69 5d 20 3d        aSlot[i] =
4f40: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 53   0;.    }.    aS
4f50: 6c 6f 74 5b 69 5d 20 3d 20 70 3b 0a 20 20 20 20  lot[i] = p;.    
4f60: 70 20 3d 20 70 4e 65 78 74 3b 0a 20 20 7d 0a 0a  p = pNext;.  }..
4f70: 20 20 70 20 3d 20 30 3b 0a 20 20 66 6f 72 28 69    p = 0;.  for(i
4f80: 3d 30 3b 20 69 3c 36 34 3b 20 69 2b 2b 29 7b 0a  =0; i<64; i++){.
4f90: 20 20 20 20 76 64 62 65 53 6f 72 74 65 72 4d 65      vdbeSorterMe
4fa0: 72 67 65 28 70 43 73 72 2c 20 70 2c 20 61 53 6c  rge(pCsr, p, aSl
4fb0: 6f 74 5b 69 5d 2c 20 26 70 29 3b 0a 20 20 7d 0a  ot[i], &p);.  }.
4fc0: 20 20 70 53 6f 72 74 65 72 2d 3e 70 52 65 63 6f    pSorter->pReco
4fd0: 72 64 20 3d 20 70 3b 0a 0a 20 20 73 71 6c 69 74  rd = p;..  sqlit
4fe0: 65 33 5f 66 72 65 65 28 61 53 6c 6f 74 29 3b 0a  e3_free(aSlot);.
4ff0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
5000: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69  OK;.}../*.** Ini
5010: 74 69 61 6c 69 7a 65 20 61 20 66 69 6c 65 2d 77  tialize a file-w
5020: 72 69 74 65 72 20 6f 62 6a 65 63 74 2e 0a 2a 2f  riter object..*/
5030: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 69 6c  .static void fil
5040: 65 57 72 69 74 65 72 49 6e 69 74 28 0a 20 20 73  eWriterInit(.  s
5050: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20  qlite3 *db,     
5060: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5070: 2a 20 44 61 74 61 62 61 73 65 20 28 66 6f 72 20  * Database (for 
5080: 6d 61 6c 6c 6f 63 29 20 2a 2f 0a 20 20 73 71 6c  malloc) */.  sql
5090: 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65  ite3_file *pFile
50a0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ,            /* 
50b0: 46 69 6c 65 20 74 6f 20 77 72 69 74 65 20 74 6f  File to write to
50c0: 20 2a 2f 0a 20 20 46 69 6c 65 57 72 69 74 65 72   */.  FileWriter
50d0: 20 2a 70 2c 20 20 20 20 20 20 20 20 20 20 20 20   *p,            
50e0: 20 20 20 20 20 20 2f 2a 20 4f 62 6a 65 63 74 20        /* Object 
50f0: 74 6f 20 70 6f 70 75 6c 61 74 65 20 2a 2f 0a 20  to populate */. 
5100: 20 69 36 34 20 69 53 74 61 72 74 20 20 20 20 20   i64 iStart     
5110: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5120: 20 2f 2a 20 4f 66 66 73 65 74 20 6f 66 20 70 46   /* Offset of pF
5130: 69 6c 65 20 74 6f 20 62 65 67 69 6e 20 77 72 69  ile to begin wri
5140: 74 69 6e 67 20 61 74 20 2a 2f 0a 29 7b 0a 20 20  ting at */.){.  
5150: 69 6e 74 20 6e 42 75 66 20 3d 20 73 71 6c 69 74  int nBuf = sqlit
5160: 65 33 42 74 72 65 65 47 65 74 50 61 67 65 53 69  e3BtreeGetPageSi
5170: 7a 65 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42  ze(db->aDb[0].pB
5180: 74 29 3b 0a 0a 20 20 6d 65 6d 73 65 74 28 70 2c  t);..  memset(p,
5190: 20 30 2c 20 73 69 7a 65 6f 66 28 46 69 6c 65 57   0, sizeof(FileW
51a0: 72 69 74 65 72 29 29 3b 0a 20 20 70 2d 3e 61 42  riter));.  p->aB
51b0: 75 66 66 65 72 20 3d 20 28 75 38 20 2a 29 73 71  uffer = (u8 *)sq
51c0: 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77  lite3DbMallocRaw
51d0: 28 64 62 2c 20 6e 42 75 66 29 3b 0a 20 20 69 66  (db, nBuf);.  if
51e0: 28 20 21 70 2d 3e 61 42 75 66 66 65 72 20 29 7b  ( !p->aBuffer ){
51f0: 0a 20 20 20 20 70 2d 3e 65 46 57 45 72 72 20 3d  .    p->eFWErr =
5200: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
5210: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 2d 3e 69   }else{.    p->i
5220: 42 75 66 45 6e 64 20 3d 20 70 2d 3e 69 42 75 66  BufEnd = p->iBuf
5230: 53 74 61 72 74 20 3d 20 28 69 53 74 61 72 74 20  Start = (iStart 
5240: 25 20 6e 42 75 66 29 3b 0a 20 20 20 20 70 2d 3e  % nBuf);.    p->
5250: 69 57 72 69 74 65 4f 66 66 20 3d 20 69 53 74 61  iWriteOff = iSta
5260: 72 74 20 2d 20 70 2d 3e 69 42 75 66 53 74 61 72  rt - p->iBufStar
5270: 74 3b 0a 20 20 20 20 70 2d 3e 6e 42 75 66 66 65  t;.    p->nBuffe
5280: 72 20 3d 20 6e 42 75 66 3b 0a 20 20 20 20 70 2d  r = nBuf;.    p-
5290: 3e 70 46 69 6c 65 20 3d 20 70 46 69 6c 65 3b 0a  >pFile = pFile;.
52a0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69    }.}../*.** Wri
52b0: 74 65 20 6e 44 61 74 61 20 62 79 74 65 73 20 6f  te nData bytes o
52c0: 66 20 64 61 74 61 20 74 6f 20 74 68 65 20 66 69  f data to the fi
52d0: 6c 65 2d 77 72 69 74 65 20 6f 62 6a 65 63 74 2e  le-write object.
52e0: 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   Return SQLITE_O
52f0: 4b 0a 2a 2a 20 69 66 20 73 75 63 63 65 73 73 66  K.** if successf
5300: 75 6c 2c 20 6f 72 20 61 6e 20 53 51 4c 69 74 65  ul, or an SQLite
5310: 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 61   error code if a
5320: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a  n error occurs..
5330: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66  */.static void f
5340: 69 6c 65 57 72 69 74 65 72 57 72 69 74 65 28 46  ileWriterWrite(F
5350: 69 6c 65 57 72 69 74 65 72 20 2a 70 2c 20 75 38  ileWriter *p, u8
5360: 20 2a 70 44 61 74 61 2c 20 69 6e 74 20 6e 44 61   *pData, int nDa
5370: 74 61 29 7b 0a 20 20 69 6e 74 20 6e 52 65 6d 20  ta){.  int nRem 
5380: 3d 20 6e 44 61 74 61 3b 0a 20 20 77 68 69 6c 65  = nData;.  while
5390: 28 20 6e 52 65 6d 3e 30 20 26 26 20 70 2d 3e 65  ( nRem>0 && p->e
53a0: 46 57 45 72 72 3d 3d 30 20 29 7b 0a 20 20 20 20  FWErr==0 ){.    
53b0: 69 6e 74 20 6e 43 6f 70 79 20 3d 20 6e 52 65 6d  int nCopy = nRem
53c0: 3b 0a 20 20 20 20 69 66 28 20 6e 43 6f 70 79 3e  ;.    if( nCopy>
53d0: 28 70 2d 3e 6e 42 75 66 66 65 72 20 2d 20 70 2d  (p->nBuffer - p-
53e0: 3e 69 42 75 66 45 6e 64 29 20 29 7b 0a 20 20 20  >iBufEnd) ){.   
53f0: 20 20 20 6e 43 6f 70 79 20 3d 20 70 2d 3e 6e 42     nCopy = p->nB
5400: 75 66 66 65 72 20 2d 20 70 2d 3e 69 42 75 66 45  uffer - p->iBufE
5410: 6e 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 6d  nd;.    }..    m
5420: 65 6d 63 70 79 28 26 70 2d 3e 61 42 75 66 66 65  emcpy(&p->aBuffe
5430: 72 5b 70 2d 3e 69 42 75 66 45 6e 64 5d 2c 20 26  r[p->iBufEnd], &
5440: 70 44 61 74 61 5b 6e 44 61 74 61 2d 6e 52 65 6d  pData[nData-nRem
5450: 5d 2c 20 6e 43 6f 70 79 29 3b 0a 20 20 20 20 70  ], nCopy);.    p
5460: 2d 3e 69 42 75 66 45 6e 64 20 2b 3d 20 6e 43 6f  ->iBufEnd += nCo
5470: 70 79 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 69  py;.    if( p->i
5480: 42 75 66 45 6e 64 3d 3d 70 2d 3e 6e 42 75 66 66  BufEnd==p->nBuff
5490: 65 72 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 65  er ){.      p->e
54a0: 46 57 45 72 72 20 3d 20 73 71 6c 69 74 65 33 4f  FWErr = sqlite3O
54b0: 73 57 72 69 74 65 28 70 2d 3e 70 46 69 6c 65 2c  sWrite(p->pFile,
54c0: 20 0a 20 20 20 20 20 20 20 20 20 20 26 70 2d 3e   .          &p->
54d0: 61 42 75 66 66 65 72 5b 70 2d 3e 69 42 75 66 53  aBuffer[p->iBufS
54e0: 74 61 72 74 5d 2c 20 70 2d 3e 69 42 75 66 45 6e  tart], p->iBufEn
54f0: 64 20 2d 20 70 2d 3e 69 42 75 66 53 74 61 72 74  d - p->iBufStart
5500: 2c 20 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e  , .          p->
5510: 69 57 72 69 74 65 4f 66 66 20 2b 20 70 2d 3e 69  iWriteOff + p->i
5520: 42 75 66 53 74 61 72 74 0a 20 20 20 20 20 20 29  BufStart.      )
5530: 3b 0a 20 20 20 20 20 20 70 2d 3e 69 42 75 66 53  ;.      p->iBufS
5540: 74 61 72 74 20 3d 20 70 2d 3e 69 42 75 66 45 6e  tart = p->iBufEn
5550: 64 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d 3e  d = 0;.      p->
5560: 69 57 72 69 74 65 4f 66 66 20 2b 3d 20 70 2d 3e  iWriteOff += p->
5570: 6e 42 75 66 66 65 72 3b 0a 20 20 20 20 7d 0a 20  nBuffer;.    }. 
5580: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 42     assert( p->iB
5590: 75 66 45 6e 64 3c 70 2d 3e 6e 42 75 66 66 65 72  ufEnd<p->nBuffer
55a0: 20 29 3b 0a 0a 20 20 20 20 6e 52 65 6d 20 2d 3d   );..    nRem -=
55b0: 20 6e 43 6f 70 79 3b 0a 20 20 7d 0a 7d 0a 0a 2f   nCopy;.  }.}../
55c0: 2a 0a 2a 2a 20 46 6c 75 73 68 20 61 6e 79 20 62  *.** Flush any b
55d0: 75 66 66 65 72 65 64 20 64 61 74 61 20 74 6f 20  uffered data to 
55e0: 64 69 73 6b 20 61 6e 64 20 63 6c 65 61 6e 20 75  disk and clean u
55f0: 70 20 74 68 65 20 66 69 6c 65 2d 77 72 69 74 65  p the file-write
5600: 72 20 6f 62 6a 65 63 74 2e 0a 2a 2a 20 54 68 65  r object..** The
5610: 20 72 65 73 75 6c 74 73 20 6f 66 20 75 73 69 6e   results of usin
5620: 67 20 74 68 65 20 66 69 6c 65 2d 77 72 69 74 65  g the file-write
5630: 72 20 61 66 74 65 72 20 74 68 69 73 20 63 61 6c  r after this cal
5640: 6c 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 2e  l are undefined.
5650: 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54  .** Return SQLIT
5660: 45 5f 4f 4b 20 69 66 20 66 6c 75 73 68 69 6e 67  E_OK if flushing
5670: 20 74 68 65 20 62 75 66 66 65 72 65 64 20 64 61   the buffered da
5680: 74 61 20 73 75 63 63 65 65 64 73 20 6f 72 20 69  ta succeeds or i
5690: 73 20 6e 6f 74 20 0a 2a 2a 20 72 65 71 75 69 72  s not .** requir
56a0: 65 64 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 72  ed. Otherwise, r
56b0: 65 74 75 72 6e 20 61 6e 20 53 51 4c 69 74 65 20  eturn an SQLite 
56c0: 65 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2a 0a 2a  error code..**.*
56d0: 2a 20 42 65 66 6f 72 65 20 72 65 74 75 72 6e 69  * Before returni
56e0: 6e 67 2c 20 73 65 74 20 2a 70 69 45 6f 66 20 74  ng, set *piEof t
56f0: 6f 20 74 68 65 20 6f 66 66 73 65 74 20 69 6d 6d  o the offset imm
5700: 65 64 69 61 74 65 6c 79 20 66 6f 6c 6c 6f 77 69  ediately followi
5710: 6e 67 20 74 68 65 0a 2a 2a 20 6c 61 73 74 20 62  ng the.** last b
5720: 79 74 65 20 77 72 69 74 74 65 6e 20 74 6f 20 74  yte written to t
5730: 68 65 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74  he file..*/.stat
5740: 69 63 20 69 6e 74 20 66 69 6c 65 57 72 69 74 65  ic int fileWrite
5750: 72 46 69 6e 69 73 68 28 73 71 6c 69 74 65 33 20  rFinish(sqlite3 
5760: 2a 64 62 2c 20 46 69 6c 65 57 72 69 74 65 72 20  *db, FileWriter 
5770: 2a 70 2c 20 69 36 34 20 2a 70 69 45 6f 66 29 7b  *p, i64 *piEof){
5780: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 66 28  .  int rc;.  if(
5790: 20 70 2d 3e 65 46 57 45 72 72 3d 3d 30 20 26 26   p->eFWErr==0 &&
57a0: 20 41 4c 57 41 59 53 28 70 2d 3e 61 42 75 66 66   ALWAYS(p->aBuff
57b0: 65 72 29 20 26 26 20 70 2d 3e 69 42 75 66 45 6e  er) && p->iBufEn
57c0: 64 3e 70 2d 3e 69 42 75 66 53 74 61 72 74 20 29  d>p->iBufStart )
57d0: 7b 0a 20 20 20 20 70 2d 3e 65 46 57 45 72 72 20  {.    p->eFWErr 
57e0: 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65  = sqlite3OsWrite
57f0: 28 70 2d 3e 70 46 69 6c 65 2c 20 0a 20 20 20 20  (p->pFile, .    
5800: 20 20 20 20 26 70 2d 3e 61 42 75 66 66 65 72 5b      &p->aBuffer[
5810: 70 2d 3e 69 42 75 66 53 74 61 72 74 5d 2c 20 70  p->iBufStart], p
5820: 2d 3e 69 42 75 66 45 6e 64 20 2d 20 70 2d 3e 69  ->iBufEnd - p->i
5830: 42 75 66 53 74 61 72 74 2c 20 0a 20 20 20 20 20  BufStart, .     
5840: 20 20 20 70 2d 3e 69 57 72 69 74 65 4f 66 66 20     p->iWriteOff 
5850: 2b 20 70 2d 3e 69 42 75 66 53 74 61 72 74 0a 20  + p->iBufStart. 
5860: 20 20 20 29 3b 0a 20 20 7d 0a 20 20 2a 70 69 45     );.  }.  *piE
5870: 6f 66 20 3d 20 28 70 2d 3e 69 57 72 69 74 65 4f  of = (p->iWriteO
5880: 66 66 20 2b 20 70 2d 3e 69 42 75 66 45 6e 64 29  ff + p->iBufEnd)
5890: 3b 0a 20 20 73 71 6c 69 74 65 33 44 62 46 72 65  ;.  sqlite3DbFre
58a0: 65 28 64 62 2c 20 70 2d 3e 61 42 75 66 66 65 72  e(db, p->aBuffer
58b0: 29 3b 0a 20 20 72 63 20 3d 20 70 2d 3e 65 46 57  );.  rc = p->eFW
58c0: 45 72 72 3b 0a 20 20 6d 65 6d 73 65 74 28 70 2c  Err;.  memset(p,
58d0: 20 30 2c 20 73 69 7a 65 6f 66 28 46 69 6c 65 57   0, sizeof(FileW
58e0: 72 69 74 65 72 29 29 3b 0a 20 20 72 65 74 75 72  riter));.  retur
58f0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57  n rc;.}../*.** W
5900: 72 69 74 65 20 76 61 6c 75 65 20 69 56 61 6c 20  rite value iVal 
5910: 65 6e 63 6f 64 65 64 20 61 73 20 61 20 76 61 72  encoded as a var
5920: 69 6e 74 20 74 6f 20 74 68 65 20 66 69 6c 65 2d  int to the file-
5930: 77 72 69 74 65 20 6f 62 6a 65 63 74 2e 20 52 65  write object. Re
5940: 74 75 72 6e 20 0a 2a 2a 20 53 51 4c 49 54 45 5f  turn .** SQLITE_
5950: 4f 4b 20 69 66 20 73 75 63 63 65 73 73 66 75 6c  OK if successful
5960: 2c 20 6f 72 20 61 6e 20 53 51 4c 69 74 65 20 65  , or an SQLite e
5970: 72 72 6f 72 20 63 6f 64 65 20 69 66 20 61 6e 20  rror code if an 
5980: 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a 2a 2f  error occurs..*/
5990: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 69 6c  .static void fil
59a0: 65 57 72 69 74 65 72 57 72 69 74 65 56 61 72 69  eWriterWriteVari
59b0: 6e 74 28 46 69 6c 65 57 72 69 74 65 72 20 2a 70  nt(FileWriter *p
59c0: 2c 20 75 36 34 20 69 56 61 6c 29 7b 0a 20 20 69  , u64 iVal){.  i
59d0: 6e 74 20 6e 42 79 74 65 3b 20 0a 20 20 75 38 20  nt nByte; .  u8 
59e0: 61 42 79 74 65 5b 31 30 5d 3b 0a 20 20 6e 42 79  aByte[10];.  nBy
59f0: 74 65 20 3d 20 73 71 6c 69 74 65 33 50 75 74 56  te = sqlite3PutV
5a00: 61 72 69 6e 74 28 61 42 79 74 65 2c 20 69 56 61  arint(aByte, iVa
5a10: 6c 29 3b 0a 20 20 66 69 6c 65 57 72 69 74 65 72  l);.  fileWriter
5a20: 57 72 69 74 65 28 70 2c 20 61 42 79 74 65 2c 20  Write(p, aByte, 
5a30: 6e 42 79 74 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  nByte);.}../*.**
5a40: 20 57 72 69 74 65 20 74 68 65 20 63 75 72 72 65   Write the curre
5a50: 6e 74 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74  nt contents of t
5a60: 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 6c 69 6e  he in-memory lin
5a70: 6b 65 64 2d 6c 69 73 74 20 74 6f 20 61 20 50 4d  ked-list to a PM
5a80: 41 2e 20 52 65 74 75 72 6e 0a 2a 2a 20 53 51 4c  A. Return.** SQL
5a90: 49 54 45 5f 4f 4b 20 69 66 20 73 75 63 63 65 73  ITE_OK if succes
5aa0: 73 66 75 6c 2c 20 6f 72 20 61 6e 20 53 51 4c 69  sful, or an SQLi
5ab0: 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 6f 74  te error code ot
5ac0: 68 65 72 77 69 73 65 2e 0a 2a 2a 0a 2a 2a 20 54  herwise..**.** T
5ad0: 68 65 20 66 6f 72 6d 61 74 20 6f 66 20 61 20 50  he format of a P
5ae0: 4d 41 20 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20  MA is:.**.**    
5af0: 20 2a 20 41 20 76 61 72 69 6e 74 2e 20 54 68 69   * A varint. Thi
5b00: 73 20 76 61 72 69 6e 74 20 63 6f 6e 74 61 69 6e  s varint contain
5b10: 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62  s the total numb
5b20: 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 63  er of bytes of c
5b30: 6f 6e 74 65 6e 74 0a 2a 2a 20 20 20 20 20 20 20  ontent.**       
5b40: 69 6e 20 74 68 65 20 50 4d 41 20 28 6e 6f 74 20  in the PMA (not 
5b50: 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 76 61  including the va
5b60: 72 69 6e 74 20 69 74 73 65 6c 66 29 2e 0a 2a 2a  rint itself)..**
5b70: 0a 2a 2a 20 20 20 20 20 2a 20 4f 6e 65 20 6f 72  .**     * One or
5b80: 20 6d 6f 72 65 20 72 65 63 6f 72 64 73 20 70 61   more records pa
5b90: 63 6b 65 64 20 65 6e 64 2d 74 6f 2d 65 6e 64 20  cked end-to-end 
5ba0: 69 6e 20 6f 72 64 65 72 20 6f 66 20 61 73 63 65  in order of asce
5bb0: 6e 64 69 6e 67 20 6b 65 79 73 2e 20 0a 2a 2a 20  nding keys. .** 
5bc0: 20 20 20 20 20 20 45 61 63 68 20 72 65 63 6f 72        Each recor
5bd0: 64 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20  d consists of a 
5be0: 76 61 72 69 6e 74 20 66 6f 6c 6c 6f 77 65 64 20  varint followed 
5bf0: 62 79 20 61 20 62 6c 6f 62 20 6f 66 20 64 61 74  by a blob of dat
5c00: 61 20 28 74 68 65 20 0a 2a 2a 20 20 20 20 20 20  a (the .**      
5c10: 20 6b 65 79 29 2e 20 54 68 65 20 76 61 72 69 6e   key). The varin
5c20: 74 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20  t is the number 
5c30: 6f 66 20 62 79 74 65 73 20 69 6e 20 74 68 65 20  of bytes in the 
5c40: 62 6c 6f 62 20 6f 66 20 64 61 74 61 2e 0a 2a 2f  blob of data..*/
5c50: 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64 62 65  .static int vdbe
5c60: 53 6f 72 74 65 72 4c 69 73 74 54 6f 50 4d 41 28  SorterListToPMA(
5c70: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e  sqlite3 *db, con
5c80: 73 74 20 56 64 62 65 43 75 72 73 6f 72 20 2a 70  st VdbeCursor *p
5c90: 43 73 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d  Csr){.  int rc =
5ca0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20   SQLITE_OK;     
5cb0: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72          /* Retur
5cc0: 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 56 64 62 65  n code */.  Vdbe
5cd0: 53 6f 72 74 65 72 20 2a 70 53 6f 72 74 65 72 20  Sorter *pSorter 
5ce0: 3d 20 70 43 73 72 2d 3e 70 53 6f 72 74 65 72 3b  = pCsr->pSorter;
5cf0: 0a 20 20 46 69 6c 65 57 72 69 74 65 72 20 77 72  .  FileWriter wr
5d00: 69 74 65 72 3b 0a 0a 20 20 6d 65 6d 73 65 74 28  iter;..  memset(
5d10: 26 77 72 69 74 65 72 2c 20 30 2c 20 73 69 7a 65  &writer, 0, size
5d20: 6f 66 28 46 69 6c 65 57 72 69 74 65 72 29 29 3b  of(FileWriter));
5d30: 0a 0a 20 20 69 66 28 20 70 53 6f 72 74 65 72 2d  ..  if( pSorter-
5d40: 3e 6e 49 6e 4d 65 6d 6f 72 79 3d 3d 30 20 29 7b  >nInMemory==0 ){
5d50: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 53 6f  .    assert( pSo
5d60: 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 3d 3d 30  rter->pRecord==0
5d70: 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72   );.    return r
5d80: 63 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 76  c;.  }..  rc = v
5d90: 64 62 65 53 6f 72 74 65 72 53 6f 72 74 28 70 43  dbeSorterSort(pC
5da0: 73 72 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68  sr);..  /* If th
5db0: 65 20 66 69 72 73 74 20 74 65 6d 70 6f 72 61 72  e first temporar
5dc0: 79 20 50 4d 41 20 66 69 6c 65 20 68 61 73 20 6e  y PMA file has n
5dd0: 6f 74 20 62 65 65 6e 20 6f 70 65 6e 65 64 2c 20  ot been opened, 
5de0: 6f 70 65 6e 20 69 74 20 6e 6f 77 2e 20 2a 2f 0a  open it now. */.
5df0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
5e00: 5f 4f 4b 20 26 26 20 70 53 6f 72 74 65 72 2d 3e  _OK && pSorter->
5e10: 70 54 65 6d 70 31 3d 3d 30 20 29 7b 0a 20 20 20  pTemp1==0 ){.   
5e20: 20 72 63 20 3d 20 76 64 62 65 53 6f 72 74 65 72   rc = vdbeSorter
5e30: 4f 70 65 6e 54 65 6d 70 46 69 6c 65 28 64 62 2c  OpenTempFile(db,
5e40: 20 26 70 53 6f 72 74 65 72 2d 3e 70 54 65 6d 70   &pSorter->pTemp
5e50: 31 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20  1);.    assert( 
5e60: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c  rc!=SQLITE_OK ||
5e70: 20 70 53 6f 72 74 65 72 2d 3e 70 54 65 6d 70 31   pSorter->pTemp1
5e80: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20   );.    assert( 
5e90: 70 53 6f 72 74 65 72 2d 3e 69 57 72 69 74 65 4f  pSorter->iWriteO
5ea0: 66 66 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73  ff==0 );.    ass
5eb0: 65 72 74 28 20 70 53 6f 72 74 65 72 2d 3e 6e 50  ert( pSorter->nP
5ec0: 4d 41 3d 3d 30 20 29 3b 0a 20 20 7d 0a 0a 20 20  MA==0 );.  }..  
5ed0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
5ee0: 4b 20 29 7b 0a 20 20 20 20 53 6f 72 74 65 72 52  K ){.    SorterR
5ef0: 65 63 6f 72 64 20 2a 70 3b 0a 20 20 20 20 53 6f  ecord *p;.    So
5f00: 72 74 65 72 52 65 63 6f 72 64 20 2a 70 4e 65 78  rterRecord *pNex
5f10: 74 20 3d 20 30 3b 0a 0a 20 20 20 20 66 69 6c 65  t = 0;..    file
5f20: 57 72 69 74 65 72 49 6e 69 74 28 64 62 2c 20 70  WriterInit(db, p
5f30: 53 6f 72 74 65 72 2d 3e 70 54 65 6d 70 31 2c 20  Sorter->pTemp1, 
5f40: 26 77 72 69 74 65 72 2c 20 70 53 6f 72 74 65 72  &writer, pSorter
5f50: 2d 3e 69 57 72 69 74 65 4f 66 66 29 3b 0a 20 20  ->iWriteOff);.  
5f60: 20 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d 41 2b    pSorter->nPMA+
5f70: 2b 3b 0a 20 20 20 20 66 69 6c 65 57 72 69 74 65  +;.    fileWrite
5f80: 72 57 72 69 74 65 56 61 72 69 6e 74 28 26 77 72  rWriteVarint(&wr
5f90: 69 74 65 72 2c 20 70 53 6f 72 74 65 72 2d 3e 6e  iter, pSorter->n
5fa0: 49 6e 4d 65 6d 6f 72 79 29 3b 0a 20 20 20 20 66  InMemory);.    f
5fb0: 6f 72 28 70 3d 70 53 6f 72 74 65 72 2d 3e 70 52  or(p=pSorter->pR
5fc0: 65 63 6f 72 64 3b 20 70 3b 20 70 3d 70 4e 65 78  ecord; p; p=pNex
5fd0: 74 29 7b 0a 20 20 20 20 20 20 70 4e 65 78 74 20  t){.      pNext 
5fe0: 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20  = p->pNext;.    
5ff0: 20 20 66 69 6c 65 57 72 69 74 65 72 57 72 69 74    fileWriterWrit
6000: 65 56 61 72 69 6e 74 28 26 77 72 69 74 65 72 2c  eVarint(&writer,
6010: 20 70 2d 3e 6e 56 61 6c 29 3b 0a 20 20 20 20 20   p->nVal);.     
6020: 20 66 69 6c 65 57 72 69 74 65 72 57 72 69 74 65   fileWriterWrite
6030: 28 26 77 72 69 74 65 72 2c 20 70 2d 3e 70 56 61  (&writer, p->pVa
6040: 6c 2c 20 70 2d 3e 6e 56 61 6c 29 3b 0a 20 20 20  l, p->nVal);.   
6050: 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65     sqlite3DbFree
6060: 28 64 62 2c 20 70 29 3b 0a 20 20 20 20 7d 0a 20  (db, p);.    }. 
6070: 20 20 20 70 53 6f 72 74 65 72 2d 3e 70 52 65 63     pSorter->pRec
6080: 6f 72 64 20 3d 20 70 3b 0a 20 20 20 20 72 63 20  ord = p;.    rc 
6090: 3d 20 66 69 6c 65 57 72 69 74 65 72 46 69 6e 69  = fileWriterFini
60a0: 73 68 28 64 62 2c 20 26 77 72 69 74 65 72 2c 20  sh(db, &writer, 
60b0: 26 70 53 6f 72 74 65 72 2d 3e 69 57 72 69 74 65  &pSorter->iWrite
60c0: 4f 66 66 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74  Off);.  }..  ret
60d0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
60e0: 20 41 64 64 20 61 20 72 65 63 6f 72 64 20 74 6f   Add a record to
60f0: 20 74 68 65 20 73 6f 72 74 65 72 2e 0a 2a 2f 0a   the sorter..*/.
6100: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 53  int sqlite3VdbeS
6110: 6f 72 74 65 72 57 72 69 74 65 28 0a 20 20 73 71  orterWrite(.  sq
6120: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20  lite3 *db,      
6130: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
6140: 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   Database handle
6150: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 56 64 62 65   */.  const Vdbe
6160: 43 75 72 73 6f 72 20 2a 70 43 73 72 2c 20 20 20  Cursor *pCsr,   
6170: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53              /* S
6180: 6f 72 74 65 72 20 63 75 72 73 6f 72 20 2a 2f 0a  orter cursor */.
6190: 20 20 4d 65 6d 20 2a 70 56 61 6c 20 20 20 20 20    Mem *pVal     
61a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
61b0: 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 63 65 6c 6c    /* Memory cell
61c0: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 72 65 63 6f   containing reco
61d0: 72 64 20 2a 2f 0a 29 7b 0a 20 20 56 64 62 65 53  rd */.){.  VdbeS
61e0: 6f 72 74 65 72 20 2a 70 53 6f 72 74 65 72 20 3d  orter *pSorter =
61f0: 20 70 43 73 72 2d 3e 70 53 6f 72 74 65 72 3b 0a   pCsr->pSorter;.
6200: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
6210: 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20  E_OK;           
6220: 20 20 2f 2a 20 52 65 74 75 72 6e 20 43 6f 64 65    /* Return Code
6230: 20 2a 2f 0a 20 20 53 6f 72 74 65 72 52 65 63 6f   */.  SorterReco
6240: 72 64 20 2a 70 4e 65 77 3b 20 20 20 20 20 20 20  rd *pNew;       
6250: 20 20 20 20 20 20 2f 2a 20 4e 65 77 20 6c 69 73        /* New lis
6260: 74 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 0a 20 20  t element */..  
6270: 61 73 73 65 72 74 28 20 70 53 6f 72 74 65 72 20  assert( pSorter 
6280: 29 3b 0a 20 20 70 53 6f 72 74 65 72 2d 3e 6e 49  );.  pSorter->nI
6290: 6e 4d 65 6d 6f 72 79 20 2b 3d 20 73 71 6c 69 74  nMemory += sqlit
62a0: 65 33 56 61 72 69 6e 74 4c 65 6e 28 70 56 61 6c  e3VarintLen(pVal
62b0: 2d 3e 6e 29 20 2b 20 70 56 61 6c 2d 3e 6e 3b 0a  ->n) + pVal->n;.
62c0: 0a 20 20 70 4e 65 77 20 3d 20 28 53 6f 72 74 65  .  pNew = (Sorte
62d0: 72 52 65 63 6f 72 64 20 2a 29 73 71 6c 69 74 65  rRecord *)sqlite
62e0: 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62 2c  3DbMallocRaw(db,
62f0: 20 70 56 61 6c 2d 3e 6e 20 2b 20 73 69 7a 65 6f   pVal->n + sizeo
6300: 66 28 53 6f 72 74 65 72 52 65 63 6f 72 64 29 29  f(SorterRecord))
6310: 3b 0a 20 20 69 66 28 20 70 4e 65 77 3d 3d 30 20  ;.  if( pNew==0 
6320: 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  ){.    rc = SQLI
6330: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 65 6c 73  TE_NOMEM;.  }els
6340: 65 7b 0a 20 20 20 20 70 4e 65 77 2d 3e 70 56 61  e{.    pNew->pVa
6350: 6c 20 3d 20 28 76 6f 69 64 20 2a 29 26 70 4e 65  l = (void *)&pNe
6360: 77 5b 31 5d 3b 0a 20 20 20 20 6d 65 6d 63 70 79  w[1];.    memcpy
6370: 28 70 4e 65 77 2d 3e 70 56 61 6c 2c 20 70 56 61  (pNew->pVal, pVa
6380: 6c 2d 3e 7a 2c 20 70 56 61 6c 2d 3e 6e 29 3b 0a  l->z, pVal->n);.
6390: 20 20 20 20 70 4e 65 77 2d 3e 6e 56 61 6c 20 3d      pNew->nVal =
63a0: 20 70 56 61 6c 2d 3e 6e 3b 0a 20 20 20 20 70 4e   pVal->n;.    pN
63b0: 65 77 2d 3e 70 4e 65 78 74 20 3d 20 70 53 6f 72  ew->pNext = pSor
63c0: 74 65 72 2d 3e 70 52 65 63 6f 72 64 3b 0a 20 20  ter->pRecord;.  
63d0: 20 20 70 53 6f 72 74 65 72 2d 3e 70 52 65 63 6f    pSorter->pReco
63e0: 72 64 20 3d 20 70 4e 65 77 3b 0a 20 20 7d 0a 0a  rd = pNew;.  }..
63f0: 20 20 2f 2a 20 53 65 65 20 69 66 20 74 68 65 20    /* See if the 
6400: 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20  contents of the 
6410: 73 6f 72 74 65 72 20 73 68 6f 75 6c 64 20 6e 6f  sorter should no
6420: 77 20 62 65 20 77 72 69 74 74 65 6e 20 6f 75 74  w be written out
6430: 2e 20 54 68 65 79 0a 20 20 2a 2a 20 61 72 65 20  . They.  ** are 
6440: 77 72 69 74 74 65 6e 20 6f 75 74 20 77 68 65 6e  written out when
6450: 20 65 69 74 68 65 72 20 6f 66 20 74 68 65 20 66   either of the f
6460: 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 74 72 75  ollowing are tru
6470: 65 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a  e:.  **.  **   *
6480: 20 54 68 65 20 74 6f 74 61 6c 20 6d 65 6d 6f 72   The total memor
6490: 79 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20  y allocated for 
64a0: 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 6c 69  the in-memory li
64b0: 73 74 20 69 73 20 67 72 65 61 74 65 72 20 0a 20  st is greater . 
64c0: 20 2a 2a 20 20 20 20 20 74 68 61 6e 20 28 70 61   **     than (pa
64d0: 67 65 2d 73 69 7a 65 20 2a 20 63 61 63 68 65 2d  ge-size * cache-
64e0: 73 69 7a 65 29 2c 20 6f 72 0a 20 20 2a 2a 0a 20  size), or.  **. 
64f0: 20 2a 2a 20 20 20 2a 20 54 68 65 20 74 6f 74 61   **   * The tota
6500: 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74  l memory allocat
6510: 65 64 20 66 6f 72 20 74 68 65 20 69 6e 2d 6d 65  ed for the in-me
6520: 6d 6f 72 79 20 6c 69 73 74 20 69 73 20 67 72 65  mory list is gre
6530: 61 74 65 72 20 0a 20 20 2a 2a 20 20 20 20 20 74  ater .  **     t
6540: 68 61 6e 20 28 70 61 67 65 2d 73 69 7a 65 20 2a  han (page-size *
6550: 20 31 30 29 20 61 6e 64 20 73 71 6c 69 74 65 33   10) and sqlite3
6560: 48 65 61 70 4e 65 61 72 6c 79 46 75 6c 6c 28 29  HeapNearlyFull()
6570: 20 72 65 74 75 72 6e 73 20 74 72 75 65 2e 0a 20   returns true.. 
6580: 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d 3d 53 51   */.  if( rc==SQ
6590: 4c 49 54 45 5f 4f 4b 20 26 26 20 70 53 6f 72 74  LITE_OK && pSort
65a0: 65 72 2d 3e 6d 78 50 6d 61 53 69 7a 65 3e 30 20  er->mxPmaSize>0 
65b0: 26 26 20 28 0a 20 20 20 20 20 20 20 20 28 70 53  && (.        (pS
65c0: 6f 72 74 65 72 2d 3e 6e 49 6e 4d 65 6d 6f 72 79  orter->nInMemory
65d0: 3e 70 53 6f 72 74 65 72 2d 3e 6d 78 50 6d 61 53  >pSorter->mxPmaS
65e0: 69 7a 65 29 0a 20 20 20 20 20 7c 7c 20 28 70 53  ize).     || (pS
65f0: 6f 72 74 65 72 2d 3e 6e 49 6e 4d 65 6d 6f 72 79  orter->nInMemory
6600: 3e 70 53 6f 72 74 65 72 2d 3e 6d 6e 50 6d 61 53  >pSorter->mnPmaS
6610: 69 7a 65 20 26 26 20 73 71 6c 69 74 65 33 48 65  ize && sqlite3He
6620: 61 70 4e 65 61 72 6c 79 46 75 6c 6c 28 29 29 0a  apNearlyFull()).
6630: 20 20 29 29 7b 0a 23 69 66 64 65 66 20 53 51 4c    )){.#ifdef SQL
6640: 49 54 45 5f 44 45 42 55 47 0a 20 20 20 20 69 36  ITE_DEBUG.    i6
6650: 34 20 6e 45 78 70 65 63 74 20 3d 20 70 53 6f 72  4 nExpect = pSor
6660: 74 65 72 2d 3e 69 57 72 69 74 65 4f 66 66 0a 20  ter->iWriteOff. 
6670: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2b                 +
6680: 20 73 71 6c 69 74 65 33 56 61 72 69 6e 74 4c 65   sqlite3VarintLe
6690: 6e 28 70 53 6f 72 74 65 72 2d 3e 6e 49 6e 4d 65  n(pSorter->nInMe
66a0: 6d 6f 72 79 29 0a 20 20 20 20 20 20 20 20 20 20  mory).          
66b0: 20 20 20 20 20 20 2b 20 70 53 6f 72 74 65 72 2d        + pSorter-
66c0: 3e 6e 49 6e 4d 65 6d 6f 72 79 3b 0a 23 65 6e 64  >nInMemory;.#end
66d0: 69 66 0a 20 20 20 20 72 63 20 3d 20 76 64 62 65  if.    rc = vdbe
66e0: 53 6f 72 74 65 72 4c 69 73 74 54 6f 50 4d 41 28  SorterListToPMA(
66f0: 64 62 2c 20 70 43 73 72 29 3b 0a 20 20 20 20 70  db, pCsr);.    p
6700: 53 6f 72 74 65 72 2d 3e 6e 49 6e 4d 65 6d 6f 72  Sorter->nInMemor
6710: 79 20 3d 20 30 3b 0a 20 20 20 20 61 73 73 65 72  y = 0;.    asser
6720: 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  t( rc!=SQLITE_OK
6730: 20 7c 7c 20 28 6e 45 78 70 65 63 74 3d 3d 70 53   || (nExpect==pS
6740: 6f 72 74 65 72 2d 3e 69 57 72 69 74 65 4f 66 66  orter->iWriteOff
6750: 29 20 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75  ) );.  }..  retu
6760: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
6770: 48 65 6c 70 65 72 20 66 75 6e 63 74 69 6f 6e 20  Helper function 
6780: 66 6f 72 20 73 71 6c 69 74 65 33 56 64 62 65 53  for sqlite3VdbeS
6790: 6f 72 74 65 72 52 65 77 69 6e 64 28 29 2e 20 0a  orterRewind(). .
67a0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64  */.static int vd
67b0: 62 65 53 6f 72 74 65 72 49 6e 69 74 4d 65 72 67  beSorterInitMerg
67c0: 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  e(.  sqlite3 *db
67d0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
67e0: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
67f0: 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 6f 6e   handle */.  con
6800: 73 74 20 56 64 62 65 43 75 72 73 6f 72 20 2a 70  st VdbeCursor *p
6810: 43 73 72 2c 20 20 20 20 20 20 20 20 20 2f 2a 20  Csr,         /* 
6820: 43 75 72 73 6f 72 20 68 61 6e 64 6c 65 20 66 6f  Cursor handle fo
6830: 72 20 74 68 69 73 20 73 6f 72 74 65 72 20 2a 2f  r this sorter */
6840: 0a 20 20 69 36 34 20 2a 70 6e 42 79 74 65 20 20  .  i64 *pnByte  
6850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6860: 20 20 20 2f 2a 20 53 75 6d 20 6f 66 20 62 79 74     /* Sum of byt
6870: 65 73 20 69 6e 20 61 6c 6c 20 6f 70 65 6e 65 64  es in all opened
6880: 20 50 4d 41 73 20 2a 2f 0a 29 7b 0a 20 20 56 64   PMAs */.){.  Vd
6890: 62 65 53 6f 72 74 65 72 20 2a 70 53 6f 72 74 65  beSorter *pSorte
68a0: 72 20 3d 20 70 43 73 72 2d 3e 70 53 6f 72 74 65  r = pCsr->pSorte
68b0: 72 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  r;.  int rc = SQ
68c0: 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20  LITE_OK;        
68d0: 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63       /* Return c
68e0: 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 69 3b 20  ode */.  int i; 
68f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6900: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 64           /* Used
6910: 20 74 6f 20 69 74 65 72 61 74 6f 72 20 74 68 72   to iterator thr
6920: 6f 75 67 68 20 61 49 74 65 72 5b 5d 20 2a 2f 0a  ough aIter[] */.
6930: 20 20 69 36 34 20 6e 42 79 74 65 20 3d 20 30 3b    i64 nByte = 0;
6940: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6950: 20 20 2f 2a 20 54 6f 74 61 6c 20 62 79 74 65 73    /* Total bytes
6960: 20 69 6e 20 61 6c 6c 20 6f 70 65 6e 65 64 20 50   in all opened P
6970: 4d 41 73 20 2a 2f 0a 0a 20 20 2f 2a 20 49 6e 69  MAs */..  /* Ini
6980: 74 69 61 6c 69 7a 65 20 74 68 65 20 69 74 65 72  tialize the iter
6990: 61 74 6f 72 73 2e 20 2a 2f 0a 20 20 66 6f 72 28  ators. */.  for(
69a0: 69 3d 30 3b 20 69 3c 53 4f 52 54 45 52 5f 4d 41  i=0; i<SORTER_MA
69b0: 58 5f 4d 45 52 47 45 5f 43 4f 55 4e 54 3b 20 69  X_MERGE_COUNT; i
69c0: 2b 2b 29 7b 0a 20 20 20 20 56 64 62 65 53 6f 72  ++){.    VdbeSor
69d0: 74 65 72 49 74 65 72 20 2a 70 49 74 65 72 20 3d  terIter *pIter =
69e0: 20 26 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72   &pSorter->aIter
69f0: 5b 69 5d 3b 0a 20 20 20 20 72 63 20 3d 20 76 64  [i];.    rc = vd
6a00: 62 65 53 6f 72 74 65 72 49 74 65 72 49 6e 69 74  beSorterIterInit
6a10: 28 64 62 2c 20 70 53 6f 72 74 65 72 2c 20 70 53  (db, pSorter, pS
6a20: 6f 72 74 65 72 2d 3e 69 52 65 61 64 4f 66 66 2c  orter->iReadOff,
6a30: 20 70 49 74 65 72 2c 20 26 6e 42 79 74 65 29 3b   pIter, &nByte);
6a40: 0a 20 20 20 20 70 53 6f 72 74 65 72 2d 3e 69 52  .    pSorter->iR
6a50: 65 61 64 4f 66 66 20 3d 20 70 49 74 65 72 2d 3e  eadOff = pIter->
6a60: 69 45 6f 66 3b 0a 20 20 20 20 61 73 73 65 72 74  iEof;.    assert
6a70: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
6a80: 7c 7c 20 70 53 6f 72 74 65 72 2d 3e 69 52 65 61  || pSorter->iRea
6a90: 64 4f 66 66 3c 3d 70 53 6f 72 74 65 72 2d 3e 69  dOff<=pSorter->i
6aa0: 57 72 69 74 65 4f 66 66 20 29 3b 0a 20 20 20 20  WriteOff );.    
6ab0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
6ac0: 4b 20 7c 7c 20 70 53 6f 72 74 65 72 2d 3e 69 52  K || pSorter->iR
6ad0: 65 61 64 4f 66 66 3e 3d 70 53 6f 72 74 65 72 2d  eadOff>=pSorter-
6ae0: 3e 69 57 72 69 74 65 4f 66 66 20 29 20 62 72 65  >iWriteOff ) bre
6af0: 61 6b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 6e  ak;.  }..  /* In
6b00: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 61 54 72  itialize the aTr
6b10: 65 65 5b 5d 20 61 72 72 61 79 2e 20 2a 2f 0a 20  ee[] array. */. 
6b20: 20 66 6f 72 28 69 3d 70 53 6f 72 74 65 72 2d 3e   for(i=pSorter->
6b30: 6e 54 72 65 65 2d 31 3b 20 72 63 3d 3d 53 51 4c  nTree-1; rc==SQL
6b40: 49 54 45 5f 4f 4b 20 26 26 20 69 3e 30 3b 20 69  ITE_OK && i>0; i
6b50: 2d 2d 29 7b 0a 20 20 20 20 72 63 20 3d 20 76 64  --){.    rc = vd
6b60: 62 65 53 6f 72 74 65 72 44 6f 43 6f 6d 70 61 72  beSorterDoCompar
6b70: 65 28 70 43 73 72 2c 20 69 29 3b 0a 20 20 7d 0a  e(pCsr, i);.  }.
6b80: 0a 20 20 2a 70 6e 42 79 74 65 20 3d 20 6e 42 79  .  *pnByte = nBy
6b90: 74 65 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b  te;.  return rc;
6ba0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 6e 63 65 20 74  .}../*.** Once t
6bb0: 68 65 20 73 6f 72 74 65 72 20 68 61 73 20 62 65  he sorter has be
6bc0: 65 6e 20 70 6f 70 75 6c 61 74 65 64 2c 20 74 68  en populated, th
6bd0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63  is function is c
6be0: 61 6c 6c 65 64 20 74 6f 20 70 72 65 70 61 72 65  alled to prepare
6bf0: 0a 2a 2a 20 66 6f 72 20 69 74 65 72 61 74 69 6e  .** for iteratin
6c00: 67 20 74 68 72 6f 75 67 68 20 69 74 73 20 63 6f  g through its co
6c10: 6e 74 65 6e 74 73 20 69 6e 20 73 6f 72 74 65 64  ntents in sorted
6c20: 20 6f 72 64 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73   order..*/.int s
6c30: 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65 72  qlite3VdbeSorter
6c40: 52 65 77 69 6e 64 28 73 71 6c 69 74 65 33 20 2a  Rewind(sqlite3 *
6c50: 64 62 2c 20 63 6f 6e 73 74 20 56 64 62 65 43 75  db, const VdbeCu
6c60: 72 73 6f 72 20 2a 70 43 73 72 2c 20 69 6e 74 20  rsor *pCsr, int 
6c70: 2a 70 62 45 6f 66 29 7b 0a 20 20 56 64 62 65 53  *pbEof){.  VdbeS
6c80: 6f 72 74 65 72 20 2a 70 53 6f 72 74 65 72 20 3d  orter *pSorter =
6c90: 20 70 43 73 72 2d 3e 70 53 6f 72 74 65 72 3b 0a   pCsr->pSorter;.
6ca0: 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20    int rc;       
6cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6cc0: 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65    /* Return code
6cd0: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 66 69   */.  sqlite3_fi
6ce0: 6c 65 20 2a 70 54 65 6d 70 32 20 3d 20 30 3b 20  le *pTemp2 = 0; 
6cf0: 20 20 20 20 20 20 2f 2a 20 53 65 63 6f 6e 64 20        /* Second 
6d00: 74 65 6d 70 20 66 69 6c 65 20 74 6f 20 75 73 65  temp file to use
6d10: 20 2a 2f 0a 20 20 69 36 34 20 69 57 72 69 74 65   */.  i64 iWrite
6d20: 32 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20  2 = 0;          
6d30: 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 6f        /* Write o
6d40: 66 66 73 65 74 20 66 6f 72 20 70 54 65 6d 70 32  ffset for pTemp2
6d50: 20 2a 2f 0a 20 20 69 6e 74 20 6e 49 74 65 72 3b   */.  int nIter;
6d60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6d70: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
6d80: 6f 66 20 69 74 65 72 61 74 6f 72 73 20 75 73 65  of iterators use
6d90: 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65  d */.  int nByte
6da0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
6db0: 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20         /* Bytes 
6dc0: 6f 66 20 73 70 61 63 65 20 72 65 71 75 69 72 65  of space require
6dd0: 64 20 66 6f 72 20 61 49 74 65 72 2f 61 54 72 65  d for aIter/aTre
6de0: 65 20 2a 2f 0a 20 20 69 6e 74 20 4e 20 3d 20 32  e */.  int N = 2
6df0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
6e00: 20 20 20 20 20 20 20 2f 2a 20 50 6f 77 65 72 20         /* Power 
6e10: 6f 66 20 32 20 3e 3d 20 6e 49 74 65 72 20 2a 2f  of 2 >= nIter */
6e20: 0a 0a 20 20 61 73 73 65 72 74 28 20 70 53 6f 72  ..  assert( pSor
6e30: 74 65 72 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20  ter );..  /* If 
6e40: 6e 6f 20 64 61 74 61 20 68 61 73 20 62 65 65 6e  no data has been
6e50: 20 77 72 69 74 74 65 6e 20 74 6f 20 64 69 73 6b   written to disk
6e60: 2c 20 74 68 65 6e 20 64 6f 20 6e 6f 74 20 64 6f  , then do not do
6e70: 20 73 6f 20 6e 6f 77 2e 20 49 6e 73 74 65 61 64   so now. Instead
6e80: 2c 0a 20 20 2a 2a 20 73 6f 72 74 20 74 68 65 20  ,.  ** sort the 
6e90: 56 64 62 65 53 6f 72 74 65 72 2e 70 52 65 63 6f  VdbeSorter.pReco
6ea0: 72 64 20 6c 69 73 74 2e 20 54 68 65 20 76 64 62  rd list. The vdb
6eb0: 65 20 6c 61 79 65 72 20 77 69 6c 6c 20 72 65 61  e layer will rea
6ec0: 64 20 64 61 74 61 20 64 69 72 65 63 74 6c 79 0a  d data directly.
6ed0: 20 20 2a 2a 20 66 72 6f 6d 20 74 68 65 20 69 6e    ** from the in
6ee0: 2d 6d 65 6d 6f 72 79 20 6c 69 73 74 2e 20 20 2a  -memory list.  *
6ef0: 2f 0a 20 20 69 66 28 20 70 53 6f 72 74 65 72 2d  /.  if( pSorter-
6f00: 3e 6e 50 4d 41 3d 3d 30 20 29 7b 0a 20 20 20 20  >nPMA==0 ){.    
6f10: 2a 70 62 45 6f 66 20 3d 20 21 70 53 6f 72 74 65  *pbEof = !pSorte
6f20: 72 2d 3e 70 52 65 63 6f 72 64 3b 0a 20 20 20 20  r->pRecord;.    
6f30: 61 73 73 65 72 74 28 20 70 53 6f 72 74 65 72 2d  assert( pSorter-
6f40: 3e 61 54 72 65 65 3d 3d 30 20 29 3b 0a 20 20 20  >aTree==0 );.   
6f50: 20 72 65 74 75 72 6e 20 76 64 62 65 53 6f 72 74   return vdbeSort
6f60: 65 72 53 6f 72 74 28 70 43 73 72 29 3b 0a 20 20  erSort(pCsr);.  
6f70: 7d 0a 0a 20 20 2f 2a 20 57 72 69 74 65 20 74 68  }..  /* Write th
6f80: 65 20 63 75 72 72 65 6e 74 20 69 6e 2d 6d 65 6d  e current in-mem
6f90: 6f 72 79 20 6c 69 73 74 20 74 6f 20 61 20 50 4d  ory list to a PM
6fa0: 41 2e 20 2a 2f 0a 20 20 72 63 20 3d 20 76 64 62  A. */.  rc = vdb
6fb0: 65 53 6f 72 74 65 72 4c 69 73 74 54 6f 50 4d 41  eSorterListToPMA
6fc0: 28 64 62 2c 20 70 43 73 72 29 3b 0a 20 20 69 66  (db, pCsr);.  if
6fd0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
6fe0: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20  ) return rc;..  
6ff0: 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 73 70 61 63  /* Allocate spac
7000: 65 20 66 6f 72 20 61 49 74 65 72 5b 5d 20 61 6e  e for aIter[] an
7010: 64 20 61 54 72 65 65 5b 5d 2e 20 2a 2f 0a 20 20  d aTree[]. */.  
7020: 6e 49 74 65 72 20 3d 20 70 53 6f 72 74 65 72 2d  nIter = pSorter-
7030: 3e 6e 50 4d 41 3b 0a 20 20 69 66 28 20 6e 49 74  >nPMA;.  if( nIt
7040: 65 72 3e 53 4f 52 54 45 52 5f 4d 41 58 5f 4d 45  er>SORTER_MAX_ME
7050: 52 47 45 5f 43 4f 55 4e 54 20 29 20 6e 49 74 65  RGE_COUNT ) nIte
7060: 72 20 3d 20 53 4f 52 54 45 52 5f 4d 41 58 5f 4d  r = SORTER_MAX_M
7070: 45 52 47 45 5f 43 4f 55 4e 54 3b 0a 20 20 61 73  ERGE_COUNT;.  as
7080: 73 65 72 74 28 20 6e 49 74 65 72 3e 30 20 29 3b  sert( nIter>0 );
7090: 0a 20 20 77 68 69 6c 65 28 20 4e 3c 6e 49 74 65  .  while( N<nIte
70a0: 72 20 29 20 4e 20 2b 3d 20 4e 3b 0a 20 20 6e 42  r ) N += N;.  nB
70b0: 79 74 65 20 3d 20 4e 20 2a 20 28 73 69 7a 65 6f  yte = N * (sizeo
70c0: 66 28 69 6e 74 29 20 2b 20 73 69 7a 65 6f 66 28  f(int) + sizeof(
70d0: 56 64 62 65 53 6f 72 74 65 72 49 74 65 72 29 29  VdbeSorterIter))
70e0: 3b 0a 20 20 70 53 6f 72 74 65 72 2d 3e 61 49 74  ;.  pSorter->aIt
70f0: 65 72 20 3d 20 28 56 64 62 65 53 6f 72 74 65 72  er = (VdbeSorter
7100: 49 74 65 72 20 2a 29 73 71 6c 69 74 65 33 44 62  Iter *)sqlite3Db
7110: 4d 61 6c 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 6e  MallocZero(db, n
7120: 42 79 74 65 29 3b 0a 20 20 69 66 28 20 21 70 53  Byte);.  if( !pS
7130: 6f 72 74 65 72 2d 3e 61 49 74 65 72 20 29 20 72  orter->aIter ) r
7140: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d  eturn SQLITE_NOM
7150: 45 4d 3b 0a 20 20 70 53 6f 72 74 65 72 2d 3e 61  EM;.  pSorter->a
7160: 54 72 65 65 20 3d 20 28 69 6e 74 20 2a 29 26 70  Tree = (int *)&p
7170: 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b 4e 5d  Sorter->aIter[N]
7180: 3b 0a 20 20 70 53 6f 72 74 65 72 2d 3e 6e 54 72  ;.  pSorter->nTr
7190: 65 65 20 3d 20 4e 3b 0a 0a 20 20 64 6f 20 7b 0a  ee = N;..  do {.
71a0: 20 20 20 20 69 6e 74 20 69 4e 65 77 3b 20 20 20      int iNew;   
71b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
71c0: 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 6e 65    /* Index of ne
71d0: 77 2c 20 6d 65 72 67 65 64 2c 20 50 4d 41 20 2a  w, merged, PMA *
71e0: 2f 0a 0a 20 20 20 20 66 6f 72 28 69 4e 65 77 3d  /..    for(iNew=
71f0: 30 3b 20 0a 20 20 20 20 20 20 20 20 72 63 3d 3d  0; .        rc==
7200: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 4e 65  SQLITE_OK && iNe
7210: 77 2a 53 4f 52 54 45 52 5f 4d 41 58 5f 4d 45 52  w*SORTER_MAX_MER
7220: 47 45 5f 43 4f 55 4e 54 3c 70 53 6f 72 74 65 72  GE_COUNT<pSorter
7230: 2d 3e 6e 50 4d 41 3b 20 0a 20 20 20 20 20 20 20  ->nPMA; .       
7240: 20 69 4e 65 77 2b 2b 0a 20 20 20 20 29 7b 0a 20   iNew++.    ){. 
7250: 20 20 20 20 20 69 6e 74 20 72 63 32 3b 20 20 20       int rc2;   
7260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7270: 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20   /* Return code 
7280: 66 72 6f 6d 20 66 69 6c 65 57 72 69 74 65 72 46  from fileWriterF
7290: 69 6e 69 73 68 28 29 20 2a 2f 0a 20 20 20 20 20  inish() */.     
72a0: 20 46 69 6c 65 57 72 69 74 65 72 20 77 72 69 74   FileWriter writ
72b0: 65 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  er;          /* 
72c0: 4f 62 6a 65 63 74 20 75 73 65 64 20 74 6f 20 77  Object used to w
72d0: 72 69 74 65 20 74 6f 20 64 69 73 6b 20 2a 2f 0a  rite to disk */.
72e0: 20 20 20 20 20 20 69 36 34 20 6e 57 72 69 74 65        i64 nWrite
72f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
7300: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62    /* Number of b
7310: 79 74 65 73 20 69 6e 20 6e 65 77 20 50 4d 41 20  ytes in new PMA 
7320: 2a 2f 0a 0a 20 20 20 20 20 20 6d 65 6d 73 65 74  */..      memset
7330: 28 26 77 72 69 74 65 72 2c 20 30 2c 20 73 69 7a  (&writer, 0, siz
7340: 65 6f 66 28 46 69 6c 65 57 72 69 74 65 72 29 29  eof(FileWriter))
7350: 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74  ;..      /* If t
7360: 68 65 72 65 20 61 72 65 20 53 4f 52 54 45 52 5f  here are SORTER_
7370: 4d 41 58 5f 4d 45 52 47 45 5f 43 4f 55 4e 54 20  MAX_MERGE_COUNT 
7380: 6f 72 20 6c 65 73 73 20 50 4d 41 73 20 69 6e 20  or less PMAs in 
7390: 66 69 6c 65 20 70 54 65 6d 70 31 2c 0a 20 20 20  file pTemp1,.   
73a0: 20 20 20 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 65     ** initialize
73b0: 20 61 6e 20 69 74 65 72 61 74 6f 72 20 66 6f 72   an iterator for
73c0: 20 65 61 63 68 20 6f 66 20 74 68 65 6d 20 61 6e   each of them an
73d0: 64 20 62 72 65 61 6b 20 6f 75 74 20 6f 66 20 74  d break out of t
73e0: 68 65 20 6c 6f 6f 70 2e 0a 20 20 20 20 20 20 2a  he loop..      *
73f0: 2a 20 54 68 65 73 65 20 69 74 65 72 61 74 6f 72  * These iterator
7400: 73 20 77 69 6c 6c 20 62 65 20 69 6e 63 72 65 6d  s will be increm
7410: 65 6e 74 61 6c 6c 79 20 6d 65 72 67 65 64 20 61  entally merged a
7420: 73 20 74 68 65 20 56 44 42 45 20 6c 61 79 65 72  s the VDBE layer
7430: 20 63 61 6c 6c 73 0a 20 20 20 20 20 20 2a 2a 20   calls.      ** 
7440: 73 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65  sqlite3VdbeSorte
7450: 72 4e 65 78 74 28 29 2e 0a 20 20 20 20 20 20 2a  rNext()..      *
7460: 2a 0a 20 20 20 20 20 20 2a 2a 20 4f 74 68 65 72  *.      ** Other
7470: 77 69 73 65 2c 20 69 66 20 70 54 65 6d 70 31 20  wise, if pTemp1 
7480: 63 6f 6e 74 61 69 6e 73 20 6d 6f 72 65 20 74 68  contains more th
7490: 61 6e 20 53 4f 52 54 45 52 5f 4d 41 58 5f 4d 45  an SORTER_MAX_ME
74a0: 52 47 45 5f 43 4f 55 4e 54 20 50 4d 41 73 2c 0a  RGE_COUNT PMAs,.
74b0: 20 20 20 20 20 20 2a 2a 20 69 6e 69 74 69 61 6c        ** initial
74c0: 69 7a 65 20 69 6e 74 65 72 61 74 6f 72 73 20 66  ize interators f
74d0: 6f 72 20 53 4f 52 54 45 52 5f 4d 41 58 5f 4d 45  or SORTER_MAX_ME
74e0: 52 47 45 5f 43 4f 55 4e 54 20 6f 66 20 74 68 65  RGE_COUNT of the
74f0: 6d 2e 20 54 68 65 73 65 20 50 4d 41 73 0a 20 20  m. These PMAs.  
7500: 20 20 20 20 2a 2a 20 61 72 65 20 6d 65 72 67 65      ** are merge
7510: 64 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20  d into a single 
7520: 50 4d 41 20 74 68 61 74 20 69 73 20 77 72 69 74  PMA that is writ
7530: 74 65 6e 20 74 6f 20 66 69 6c 65 20 70 54 65 6d  ten to file pTem
7540: 70 32 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20  p2..      */.   
7550: 20 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72 74     rc = vdbeSort
7560: 65 72 49 6e 69 74 4d 65 72 67 65 28 64 62 2c 20  erInitMerge(db, 
7570: 70 43 73 72 2c 20 26 6e 57 72 69 74 65 29 3b 0a  pCsr, &nWrite);.
7580: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 72 63        assert( rc
7590: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70  !=SQLITE_OK || p
75a0: 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b 20 70  Sorter->aIter[ p
75b0: 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 31 5d  Sorter->aTree[1]
75c0: 20 5d 2e 70 46 69 6c 65 20 29 3b 0a 20 20 20 20   ].pFile );.    
75d0: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
75e0: 5f 4f 4b 20 7c 7c 20 70 53 6f 72 74 65 72 2d 3e  _OK || pSorter->
75f0: 6e 50 4d 41 3c 3d 53 4f 52 54 45 52 5f 4d 41 58  nPMA<=SORTER_MAX
7600: 5f 4d 45 52 47 45 5f 43 4f 55 4e 54 20 29 7b 0a  _MERGE_COUNT ){.
7610: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
7620: 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a       }..      /*
7630: 20 4f 70 65 6e 20 74 68 65 20 73 65 63 6f 6e 64   Open the second
7640: 20 74 65 6d 70 20 66 69 6c 65 2c 20 69 66 20 69   temp file, if i
7650: 74 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79  t is not already
7660: 20 6f 70 65 6e 2e 20 2a 2f 0a 20 20 20 20 20 20   open. */.      
7670: 69 66 28 20 70 54 65 6d 70 32 3d 3d 30 20 29 7b  if( pTemp2==0 ){
7680: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28  .        assert(
7690: 20 69 57 72 69 74 65 32 3d 3d 30 20 29 3b 0a 20   iWrite2==0 );. 
76a0: 20 20 20 20 20 20 20 72 63 20 3d 20 76 64 62 65         rc = vdbe
76b0: 53 6f 72 74 65 72 4f 70 65 6e 54 65 6d 70 46 69  SorterOpenTempFi
76c0: 6c 65 28 64 62 2c 20 26 70 54 65 6d 70 32 29 3b  le(db, &pTemp2);
76d0: 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20  .      }..      
76e0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
76f0: 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74  K ){.        int
7700: 20 62 45 6f 66 20 3d 20 30 3b 0a 20 20 20 20 20   bEof = 0;.     
7710: 20 20 20 66 69 6c 65 57 72 69 74 65 72 49 6e 69     fileWriterIni
7720: 74 28 64 62 2c 20 70 54 65 6d 70 32 2c 20 26 77  t(db, pTemp2, &w
7730: 72 69 74 65 72 2c 20 69 57 72 69 74 65 32 29 3b  riter, iWrite2);
7740: 0a 20 20 20 20 20 20 20 20 66 69 6c 65 57 72 69  .        fileWri
7750: 74 65 72 57 72 69 74 65 56 61 72 69 6e 74 28 26  terWriteVarint(&
7760: 77 72 69 74 65 72 2c 20 6e 57 72 69 74 65 29 3b  writer, nWrite);
7770: 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65 28 20  .        while( 
7780: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc==SQLITE_OK &&
7790: 20 62 45 6f 66 3d 3d 30 20 29 7b 0a 20 20 20 20   bEof==0 ){.    
77a0: 20 20 20 20 20 20 56 64 62 65 53 6f 72 74 65 72        VdbeSorter
77b0: 49 74 65 72 20 2a 70 49 74 65 72 20 3d 20 26 70  Iter *pIter = &p
77c0: 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b 20 70  Sorter->aIter[ p
77d0: 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 31 5d  Sorter->aTree[1]
77e0: 20 5d 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73   ];.          as
77f0: 73 65 72 74 28 20 70 49 74 65 72 2d 3e 70 46 69  sert( pIter->pFi
7800: 6c 65 20 29 3b 0a 0a 20 20 20 20 20 20 20 20 20  le );..         
7810: 20 66 69 6c 65 57 72 69 74 65 72 57 72 69 74 65   fileWriterWrite
7820: 56 61 72 69 6e 74 28 26 77 72 69 74 65 72 2c 20  Varint(&writer, 
7830: 70 49 74 65 72 2d 3e 6e 4b 65 79 29 3b 0a 20 20  pIter->nKey);.  
7840: 20 20 20 20 20 20 20 20 66 69 6c 65 57 72 69 74          fileWrit
7850: 65 72 57 72 69 74 65 28 26 77 72 69 74 65 72 2c  erWrite(&writer,
7860: 20 70 49 74 65 72 2d 3e 61 4b 65 79 2c 20 70 49   pIter->aKey, pI
7870: 74 65 72 2d 3e 6e 4b 65 79 29 3b 0a 20 20 20 20  ter->nKey);.    
7880: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74        rc = sqlit
7890: 65 33 56 64 62 65 53 6f 72 74 65 72 4e 65 78 74  e3VdbeSorterNext
78a0: 28 64 62 2c 20 70 43 73 72 2c 20 26 62 45 6f 66  (db, pCsr, &bEof
78b0: 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  );.        }.   
78c0: 20 20 20 20 20 72 63 32 20 3d 20 66 69 6c 65 57       rc2 = fileW
78d0: 72 69 74 65 72 46 69 6e 69 73 68 28 64 62 2c 20  riterFinish(db, 
78e0: 26 77 72 69 74 65 72 2c 20 26 69 57 72 69 74 65  &writer, &iWrite
78f0: 32 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20  2);.        if( 
7900: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc==SQLITE_OK ) 
7910: 72 63 20 3d 20 72 63 32 3b 0a 20 20 20 20 20 20  rc = rc2;.      
7920: 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28  }.    }..    if(
7930: 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d 41 3c 3d   pSorter->nPMA<=
7940: 53 4f 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45  SORTER_MAX_MERGE
7950: 5f 43 4f 55 4e 54 20 29 7b 0a 20 20 20 20 20 20  _COUNT ){.      
7960: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 65 6c 73 65  break;.    }else
7970: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  {.      sqlite3_
7980: 66 69 6c 65 20 2a 70 54 6d 70 20 3d 20 70 53 6f  file *pTmp = pSo
7990: 72 74 65 72 2d 3e 70 54 65 6d 70 31 3b 0a 20 20  rter->pTemp1;.  
79a0: 20 20 20 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d      pSorter->nPM
79b0: 41 20 3d 20 69 4e 65 77 3b 0a 20 20 20 20 20 20  A = iNew;.      
79c0: 70 53 6f 72 74 65 72 2d 3e 70 54 65 6d 70 31 20  pSorter->pTemp1 
79d0: 3d 20 70 54 65 6d 70 32 3b 0a 20 20 20 20 20 20  = pTemp2;.      
79e0: 70 54 65 6d 70 32 20 3d 20 70 54 6d 70 3b 0a 20  pTemp2 = pTmp;. 
79f0: 20 20 20 20 20 70 53 6f 72 74 65 72 2d 3e 69 57       pSorter->iW
7a00: 72 69 74 65 4f 66 66 20 3d 20 69 57 72 69 74 65  riteOff = iWrite
7a10: 32 3b 0a 20 20 20 20 20 20 70 53 6f 72 74 65 72  2;.      pSorter
7a20: 2d 3e 69 52 65 61 64 4f 66 66 20 3d 20 30 3b 0a  ->iReadOff = 0;.
7a30: 20 20 20 20 20 20 69 57 72 69 74 65 32 20 3d 20        iWrite2 = 
7a40: 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 77 68 69 6c  0;.    }.  }whil
7a50: 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  e( rc==SQLITE_OK
7a60: 20 29 3b 0a 0a 20 20 69 66 28 20 70 54 65 6d 70   );..  if( pTemp
7a70: 32 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  2 ){.    sqlite3
7a80: 4f 73 43 6c 6f 73 65 46 72 65 65 28 70 54 65 6d  OsCloseFree(pTem
7a90: 70 32 29 3b 0a 20 20 7d 0a 20 20 2a 70 62 45 6f  p2);.  }.  *pbEo
7aa0: 66 20 3d 20 28 70 53 6f 72 74 65 72 2d 3e 61 49  f = (pSorter->aI
7ab0: 74 65 72 5b 70 53 6f 72 74 65 72 2d 3e 61 54 72  ter[pSorter->aTr
7ac0: 65 65 5b 31 5d 5d 2e 70 46 69 6c 65 3d 3d 30 29  ee[1]].pFile==0)
7ad0: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
7ae0: 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 61 6e 63 65 20  ../*.** Advance 
7af0: 74 6f 20 74 68 65 20 6e 65 78 74 20 65 6c 65 6d  to the next elem
7b00: 65 6e 74 20 69 6e 20 74 68 65 20 73 6f 72 74 65  ent in the sorte
7b10: 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  r..*/.int sqlite
7b20: 33 56 64 62 65 53 6f 72 74 65 72 4e 65 78 74 28  3VdbeSorterNext(
7b30: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 6f 6e  sqlite3 *db, con
7b40: 73 74 20 56 64 62 65 43 75 72 73 6f 72 20 2a 70  st VdbeCursor *p
7b50: 43 73 72 2c 20 69 6e 74 20 2a 70 62 45 6f 66 29  Csr, int *pbEof)
7b60: 7b 0a 20 20 56 64 62 65 53 6f 72 74 65 72 20 2a  {.  VdbeSorter *
7b70: 70 53 6f 72 74 65 72 20 3d 20 70 43 73 72 2d 3e  pSorter = pCsr->
7b80: 70 53 6f 72 74 65 72 3b 0a 20 20 69 6e 74 20 72  pSorter;.  int r
7b90: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  c;              
7ba0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65             /* Re
7bb0: 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a 20 20  turn code */..  
7bc0: 69 66 28 20 70 53 6f 72 74 65 72 2d 3e 61 54 72  if( pSorter->aTr
7bd0: 65 65 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 50  ee ){.    int iP
7be0: 72 65 76 20 3d 20 70 53 6f 72 74 65 72 2d 3e 61  rev = pSorter->a
7bf0: 54 72 65 65 5b 31 5d 3b 2f 2a 20 49 6e 64 65 78  Tree[1];/* Index
7c00: 20 6f 66 20 69 74 65 72 61 74 6f 72 20 74 6f 20   of iterator to 
7c10: 61 64 76 61 6e 63 65 20 2a 2f 0a 20 20 20 20 69  advance */.    i
7c20: 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20  nt i;           
7c30: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
7c40: 49 6e 64 65 78 20 6f 66 20 61 54 72 65 65 5b 5d  Index of aTree[]
7c50: 20 74 6f 20 72 65 63 61 6c 63 75 6c 61 74 65 20   to recalculate 
7c60: 2a 2f 0a 0a 20 20 20 20 72 63 20 3d 20 76 64 62  */..    rc = vdb
7c70: 65 53 6f 72 74 65 72 49 74 65 72 4e 65 78 74 28  eSorterIterNext(
7c80: 64 62 2c 20 26 70 53 6f 72 74 65 72 2d 3e 61 49  db, &pSorter->aI
7c90: 74 65 72 5b 69 50 72 65 76 5d 29 3b 0a 20 20 20  ter[iPrev]);.   
7ca0: 20 66 6f 72 28 69 3d 28 70 53 6f 72 74 65 72 2d   for(i=(pSorter-
7cb0: 3e 6e 54 72 65 65 2b 69 50 72 65 76 29 2f 32 3b  >nTree+iPrev)/2;
7cc0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
7cd0: 26 20 69 3e 30 3b 20 69 3d 69 2f 32 29 7b 0a 20  & i>0; i=i/2){. 
7ce0: 20 20 20 20 20 72 63 20 3d 20 76 64 62 65 53 6f       rc = vdbeSo
7cf0: 72 74 65 72 44 6f 43 6f 6d 70 61 72 65 28 70 43  rterDoCompare(pC
7d00: 73 72 2c 20 69 29 3b 0a 20 20 20 20 7d 0a 0a 20  sr, i);.    }.. 
7d10: 20 20 20 2a 70 62 45 6f 66 20 3d 20 28 70 53 6f     *pbEof = (pSo
7d20: 72 74 65 72 2d 3e 61 49 74 65 72 5b 70 53 6f 72  rter->aIter[pSor
7d30: 74 65 72 2d 3e 61 54 72 65 65 5b 31 5d 5d 2e 70  ter->aTree[1]].p
7d40: 46 69 6c 65 3d 3d 30 29 3b 0a 20 20 7d 65 6c 73  File==0);.  }els
7d50: 65 7b 0a 20 20 20 20 53 6f 72 74 65 72 52 65 63  e{.    SorterRec
7d60: 6f 72 64 20 2a 70 46 72 65 65 20 3d 20 70 53 6f  ord *pFree = pSo
7d70: 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 3b 0a 20  rter->pRecord;. 
7d80: 20 20 20 70 53 6f 72 74 65 72 2d 3e 70 52 65 63     pSorter->pRec
7d90: 6f 72 64 20 3d 20 70 46 72 65 65 2d 3e 70 4e 65  ord = pFree->pNe
7da0: 78 74 3b 0a 20 20 20 20 70 46 72 65 65 2d 3e 70  xt;.    pFree->p
7db0: 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 76 64  Next = 0;.    vd
7dc0: 62 65 53 6f 72 74 65 72 52 65 63 6f 72 64 46 72  beSorterRecordFr
7dd0: 65 65 28 64 62 2c 20 70 46 72 65 65 29 3b 0a 20  ee(db, pFree);. 
7de0: 20 20 20 2a 70 62 45 6f 66 20 3d 20 21 70 53 6f     *pbEof = !pSo
7df0: 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 3b 0a 20  rter->pRecord;. 
7e00: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f     rc = SQLITE_O
7e10: 4b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  K;.  }.  return 
7e20: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  rc;.}../*.** Ret
7e30: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f  urn a pointer to
7e40: 20 61 20 62 75 66 66 65 72 20 6f 77 6e 65 64 20   a buffer owned 
7e50: 62 79 20 74 68 65 20 73 6f 72 74 65 72 20 74 68  by the sorter th
7e60: 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20  at contains the 
7e70: 0a 2a 2a 20 63 75 72 72 65 6e 74 20 6b 65 79 2e  .** current key.
7e80: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
7e90: 2a 76 64 62 65 53 6f 72 74 65 72 52 6f 77 6b 65  *vdbeSorterRowke
7ea0: 79 28 0a 20 20 63 6f 6e 73 74 20 56 64 62 65 53  y(.  const VdbeS
7eb0: 6f 72 74 65 72 20 2a 70 53 6f 72 74 65 72 2c 20  orter *pSorter, 
7ec0: 20 20 20 20 20 2f 2a 20 53 6f 72 74 65 72 20 6f       /* Sorter o
7ed0: 62 6a 65 63 74 20 2a 2f 0a 20 20 69 6e 74 20 2a  bject */.  int *
7ee0: 70 6e 4b 65 79 20 20 20 20 20 20 20 20 20 20 20  pnKey           
7ef0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55             /* OU
7f00: 54 3a 20 53 69 7a 65 20 6f 66 20 63 75 72 72 65  T: Size of curre
7f10: 6e 74 20 6b 65 79 20 69 6e 20 62 79 74 65 73 20  nt key in bytes 
7f20: 2a 2f 0a 29 7b 0a 20 20 76 6f 69 64 20 2a 70 4b  */.){.  void *pK
7f30: 65 79 3b 0a 20 20 69 66 28 20 70 53 6f 72 74 65  ey;.  if( pSorte
7f40: 72 2d 3e 61 54 72 65 65 20 29 7b 0a 20 20 20 20  r->aTree ){.    
7f50: 56 64 62 65 53 6f 72 74 65 72 49 74 65 72 20 2a  VdbeSorterIter *
7f60: 70 49 74 65 72 3b 0a 20 20 20 20 70 49 74 65 72  pIter;.    pIter
7f70: 20 3d 20 26 70 53 6f 72 74 65 72 2d 3e 61 49 74   = &pSorter->aIt
7f80: 65 72 5b 20 70 53 6f 72 74 65 72 2d 3e 61 54 72  er[ pSorter->aTr
7f90: 65 65 5b 31 5d 20 5d 3b 0a 20 20 20 20 2a 70 6e  ee[1] ];.    *pn
7fa0: 4b 65 79 20 3d 20 70 49 74 65 72 2d 3e 6e 4b 65  Key = pIter->nKe
7fb0: 79 3b 0a 20 20 20 20 70 4b 65 79 20 3d 20 70 49  y;.    pKey = pI
7fc0: 74 65 72 2d 3e 61 4b 65 79 3b 0a 20 20 7d 65 6c  ter->aKey;.  }el
7fd0: 73 65 7b 0a 20 20 20 20 2a 70 6e 4b 65 79 20 3d  se{.    *pnKey =
7fe0: 20 70 53 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72   pSorter->pRecor
7ff0: 64 2d 3e 6e 56 61 6c 3b 0a 20 20 20 20 70 4b 65  d->nVal;.    pKe
8000: 79 20 3d 20 70 53 6f 72 74 65 72 2d 3e 70 52 65  y = pSorter->pRe
8010: 63 6f 72 64 2d 3e 70 56 61 6c 3b 0a 20 20 7d 0a  cord->pVal;.  }.
8020: 20 20 72 65 74 75 72 6e 20 70 4b 65 79 3b 0a 7d    return pKey;.}
8030: 0a 0a 2f 2a 0a 2a 2a 20 43 6f 70 79 20 74 68 65  ../*.** Copy the
8040: 20 63 75 72 72 65 6e 74 20 73 6f 72 74 65 72 20   current sorter 
8050: 6b 65 79 20 69 6e 74 6f 20 74 68 65 20 6d 65 6d  key into the mem
8060: 6f 72 79 20 63 65 6c 6c 20 70 4f 75 74 2e 0a 2a  ory cell pOut..*
8070: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
8080: 65 53 6f 72 74 65 72 52 6f 77 6b 65 79 28 63 6f  eSorterRowkey(co
8090: 6e 73 74 20 56 64 62 65 43 75 72 73 6f 72 20 2a  nst VdbeCursor *
80a0: 70 43 73 72 2c 20 4d 65 6d 20 2a 70 4f 75 74 29  pCsr, Mem *pOut)
80b0: 7b 0a 20 20 56 64 62 65 53 6f 72 74 65 72 20 2a  {.  VdbeSorter *
80c0: 70 53 6f 72 74 65 72 20 3d 20 70 43 73 72 2d 3e  pSorter = pCsr->
80d0: 70 53 6f 72 74 65 72 3b 0a 20 20 76 6f 69 64 20  pSorter;.  void 
80e0: 2a 70 4b 65 79 3b 20 69 6e 74 20 6e 4b 65 79 3b  *pKey; int nKey;
80f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 6f             /* So
8100: 72 74 65 72 20 6b 65 79 20 74 6f 20 63 6f 70 79  rter key to copy
8110: 20 69 6e 74 6f 20 70 4f 75 74 20 2a 2f 0a 0a 20   into pOut */.. 
8120: 20 70 4b 65 79 20 3d 20 76 64 62 65 53 6f 72 74   pKey = vdbeSort
8130: 65 72 52 6f 77 6b 65 79 28 70 53 6f 72 74 65 72  erRowkey(pSorter
8140: 2c 20 26 6e 4b 65 79 29 3b 0a 20 20 69 66 28 20  , &nKey);.  if( 
8150: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 47 72  sqlite3VdbeMemGr
8160: 6f 77 28 70 4f 75 74 2c 20 6e 4b 65 79 2c 20 30  ow(pOut, nKey, 0
8170: 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  ) ){.    return 
8180: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20  SQLITE_NOMEM;.  
8190: 7d 0a 20 20 70 4f 75 74 2d 3e 6e 20 3d 20 6e 4b  }.  pOut->n = nK
81a0: 65 79 3b 0a 20 20 4d 65 6d 53 65 74 54 79 70 65  ey;.  MemSetType
81b0: 46 6c 61 67 28 70 4f 75 74 2c 20 4d 45 4d 5f 42  Flag(pOut, MEM_B
81c0: 6c 6f 62 29 3b 0a 20 20 6d 65 6d 63 70 79 28 70  lob);.  memcpy(p
81d0: 4f 75 74 2d 3e 7a 2c 20 70 4b 65 79 2c 20 6e 4b  Out->z, pKey, nK
81e0: 65 79 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 53  ey);..  return S
81f0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
8200: 2a 2a 20 43 6f 6d 70 61 72 65 20 74 68 65 20 6b  ** Compare the k
8210: 65 79 20 69 6e 20 6d 65 6d 6f 72 79 20 63 65 6c  ey in memory cel
8220: 6c 20 70 56 61 6c 20 77 69 74 68 20 74 68 65 20  l pVal with the 
8230: 6b 65 79 20 74 68 61 74 20 74 68 65 20 73 6f 72  key that the sor
8240: 74 65 72 20 63 75 72 73 6f 72 0a 2a 2a 20 70 61  ter cursor.** pa
8250: 73 73 65 64 20 61 73 20 74 68 65 20 66 69 72 73  ssed as the firs
8260: 74 20 61 72 67 75 6d 65 6e 74 20 63 75 72 72 65  t argument curre
8270: 6e 74 6c 79 20 70 6f 69 6e 74 73 20 74 6f 2e 20  ntly points to. 
8280: 46 6f 72 20 74 68 65 20 70 75 72 70 6f 73 65 73  For the purposes
8290: 20 6f 66 0a 2a 2a 20 74 68 65 20 63 6f 6d 70 61   of.** the compa
82a0: 72 69 73 6f 6e 2c 20 69 67 6e 6f 72 65 20 74 68  rison, ignore th
82b0: 65 20 72 6f 77 69 64 20 66 69 65 6c 64 20 61 74  e rowid field at
82c0: 20 74 68 65 20 65 6e 64 20 6f 66 20 65 61 63 68   the end of each
82d0: 20 72 65 63 6f 72 64 2e 0a 2a 2a 0a 2a 2a 20 49   record..**.** I
82e0: 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72  f an error occur
82f0: 73 2c 20 72 65 74 75 72 6e 20 61 6e 20 53 51 4c  s, return an SQL
8300: 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 28  ite error code (
8310: 69 2e 65 2e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  i.e. SQLITE_NOME
8320: 4d 29 2e 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65  M)..** Otherwise
8330: 2c 20 73 65 74 20 2a 70 52 65 73 20 74 6f 20 61  , set *pRes to a
8340: 20 6e 65 67 61 74 69 76 65 2c 20 7a 65 72 6f 20   negative, zero 
8350: 6f 72 20 70 6f 73 69 74 69 76 65 20 76 61 6c 75  or positive valu
8360: 65 20 69 66 20 74 68 65 0a 2a 2a 20 6b 65 79 20  e if the.** key 
8370: 69 6e 20 70 56 61 6c 20 69 73 20 73 6d 61 6c 6c  in pVal is small
8380: 65 72 20 74 68 61 6e 2c 20 65 71 75 61 6c 20 74  er than, equal t
8390: 6f 20 6f 72 20 6c 61 72 67 65 72 20 74 68 61 6e  o or larger than
83a0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 6f 72   the current sor
83b0: 74 65 72 0a 2a 2a 20 6b 65 79 2e 0a 2a 2f 0a 69  ter.** key..*/.i
83c0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 53 6f  nt sqlite3VdbeSo
83d0: 72 74 65 72 43 6f 6d 70 61 72 65 28 0a 20 20 63  rterCompare(.  c
83e0: 6f 6e 73 74 20 56 64 62 65 43 75 72 73 6f 72 20  onst VdbeCursor 
83f0: 2a 70 43 73 72 2c 20 20 20 20 20 20 20 20 20 2f  *pCsr,         /
8400: 2a 20 53 6f 72 74 65 72 20 63 75 72 73 6f 72 20  * Sorter cursor 
8410: 2a 2f 0a 20 20 4d 65 6d 20 2a 70 56 61 6c 2c 20  */.  Mem *pVal, 
8420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8430: 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f       /* Value to
8440: 20 63 6f 6d 70 61 72 65 20 74 6f 20 63 75 72 72   compare to curr
8450: 65 6e 74 20 73 6f 72 74 65 72 20 6b 65 79 20 2a  ent sorter key *
8460: 2f 0a 20 20 69 6e 74 20 6e 49 67 6e 6f 72 65 2c  /.  int nIgnore,
8470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8480: 20 20 20 20 2f 2a 20 49 67 6e 6f 72 65 20 74 68      /* Ignore th
8490: 69 73 20 6d 61 6e 79 20 66 69 65 6c 64 73 20 61  is many fields a
84a0: 74 20 74 68 65 20 65 6e 64 20 2a 2f 0a 20 20 69  t the end */.  i
84b0: 6e 74 20 2a 70 52 65 73 20 20 20 20 20 20 20 20  nt *pRes        
84c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
84d0: 2a 20 4f 55 54 3a 20 52 65 73 75 6c 74 20 6f 66  * OUT: Result of
84e0: 20 63 6f 6d 70 61 72 69 73 6f 6e 20 2a 2f 0a 29   comparison */.)
84f0: 7b 0a 20 20 56 64 62 65 53 6f 72 74 65 72 20 2a  {.  VdbeSorter *
8500: 70 53 6f 72 74 65 72 20 3d 20 70 43 73 72 2d 3e  pSorter = pCsr->
8510: 70 53 6f 72 74 65 72 3b 0a 20 20 76 6f 69 64 20  pSorter;.  void 
8520: 2a 70 4b 65 79 3b 20 69 6e 74 20 6e 4b 65 79 3b  *pKey; int nKey;
8530: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 6f             /* So
8540: 72 74 65 72 20 6b 65 79 20 74 6f 20 63 6f 6d 70  rter key to comp
8550: 61 72 65 20 70 56 61 6c 20 77 69 74 68 20 2a 2f  are pVal with */
8560: 0a 0a 20 20 70 4b 65 79 20 3d 20 76 64 62 65 53  ..  pKey = vdbeS
8570: 6f 72 74 65 72 52 6f 77 6b 65 79 28 70 53 6f 72  orterRowkey(pSor
8580: 74 65 72 2c 20 26 6e 4b 65 79 29 3b 0a 20 20 76  ter, &nKey);.  v
8590: 64 62 65 53 6f 72 74 65 72 43 6f 6d 70 61 72 65  dbeSorterCompare
85a0: 28 70 43 73 72 2c 20 6e 49 67 6e 6f 72 65 2c 20  (pCsr, nIgnore, 
85b0: 70 56 61 6c 2d 3e 7a 2c 20 70 56 61 6c 2d 3e 6e  pVal->z, pVal->n
85c0: 2c 20 70 4b 65 79 2c 20 6e 4b 65 79 2c 20 70 52  , pKey, nKey, pR
85d0: 65 73 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  es);.  return SQ
85e0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a                 LITE_OK;.}.