/ Hex Artifact Content
Login

Artifact 3937e06b2a0e354500e17dc206ef4c35770a5017:


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 62 4f 6d 69 74 52 6f 77 69 64 2c 20 20 20  t bOmitRowid,   
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 72 6f 77 69 64 20 66 69   Ignore rowid fi
3920: 65 6c 64 20 61 74 20 65 6e 64 20 6f 66 20 6b 65  eld at end of ke
3930: 79 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f  ys */.  const vo
3940: 69 64 20 2a 70 4b 65 79 31 2c 20 69 6e 74 20 6e  id *pKey1, int n
3950: 4b 65 79 31 2c 20 20 20 2f 2a 20 4c 65 66 74 20  Key1,   /* Left 
3960: 73 69 64 65 20 6f 66 20 63 6f 6d 70 61 72 69 73  side of comparis
3970: 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f  on */.  const vo
3980: 69 64 20 2a 70 4b 65 79 32 2c 20 69 6e 74 20 6e  id *pKey2, int n
3990: 4b 65 79 32 2c 20 20 20 2f 2a 20 52 69 67 68 74  Key2,   /* Right
39a0: 20 73 69 64 65 20 6f 66 20 63 6f 6d 70 61 72 69   side of compari
39b0: 73 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52  son */.  int *pR
39c0: 65 73 20 20 20 20 20 20 20 20 20 20 20 20 20 20  es              
39d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
39e0: 20 52 65 73 75 6c 74 20 6f 66 20 63 6f 6d 70 61   Result of compa
39f0: 72 69 73 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 4b 65  rison */.){.  Ke
3a00: 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 20  yInfo *pKeyInfo 
3a10: 3d 20 70 43 73 72 2d 3e 70 4b 65 79 49 6e 66 6f  = pCsr->pKeyInfo
3a20: 3b 0a 20 20 56 64 62 65 53 6f 72 74 65 72 20 2a  ;.  VdbeSorter *
3a30: 70 53 6f 72 74 65 72 20 3d 20 70 43 73 72 2d 3e  pSorter = pCsr->
3a40: 70 53 6f 72 74 65 72 3b 0a 20 20 55 6e 70 61 63  pSorter;.  Unpac
3a50: 6b 65 64 52 65 63 6f 72 64 20 2a 72 32 20 3d 20  kedRecord *r2 = 
3a60: 70 53 6f 72 74 65 72 2d 3e 70 55 6e 70 61 63 6b  pSorter->pUnpack
3a70: 65 64 3b 0a 20 20 69 6e 74 20 69 3b 0a 0a 20 20  ed;.  int i;..  
3a80: 69 66 28 20 70 4b 65 79 32 20 29 7b 0a 20 20 20  if( pKey2 ){.   
3a90: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f   sqlite3VdbeReco
3aa0: 72 64 55 6e 70 61 63 6b 28 70 4b 65 79 49 6e 66  rdUnpack(pKeyInf
3ab0: 6f 2c 20 6e 4b 65 79 32 2c 20 70 4b 65 79 32 2c  o, nKey2, pKey2,
3ac0: 20 72 32 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28   r2);.  }..  if(
3ad0: 20 62 4f 6d 69 74 52 6f 77 69 64 20 29 7b 0a 20   bOmitRowid ){. 
3ae0: 20 20 20 72 32 2d 3e 6e 46 69 65 6c 64 20 3d 20     r2->nField = 
3af0: 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64  pKeyInfo->nField
3b00: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 32  ;.    assert( r2
3b10: 2d 3e 6e 46 69 65 6c 64 3e 30 20 29 3b 0a 20 20  ->nField>0 );.  
3b20: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 72 32 2d    for(i=0; i<r2-
3b30: 3e 6e 46 69 65 6c 64 3b 20 69 2b 2b 29 7b 0a 20  >nField; i++){. 
3b40: 20 20 20 20 20 69 66 28 20 72 32 2d 3e 61 4d 65       if( r2->aMe
3b50: 6d 5b 69 5d 2e 66 6c 61 67 73 20 26 20 4d 45 4d  m[i].flags & MEM
3b60: 5f 4e 75 6c 6c 20 29 7b 0a 20 20 20 20 20 20 20  _Null ){.       
3b70: 20 2a 70 52 65 73 20 3d 20 2d 31 3b 0a 20 20 20   *pRes = -1;.   
3b80: 20 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 20       return;.   
3b90: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 72     }.    }.    r
3ba0: 32 2d 3e 66 6c 61 67 73 20 7c 3d 20 55 4e 50 41  2->flags |= UNPA
3bb0: 43 4b 45 44 5f 50 52 45 46 49 58 5f 4d 41 54 43  CKED_PREFIX_MATC
3bc0: 48 3b 0a 20 20 7d 0a 0a 20 20 2a 70 52 65 73 20  H;.  }..  *pRes 
3bd0: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63  = sqlite3VdbeRec
3be0: 6f 72 64 43 6f 6d 70 61 72 65 28 6e 4b 65 79 31  ordCompare(nKey1
3bf0: 2c 20 70 4b 65 79 31 2c 20 72 32 29 3b 0a 7d 0a  , pKey1, r2);.}.
3c00: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
3c10: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74  tion is called t
3c20: 6f 20 63 6f 6d 70 61 72 65 20 74 77 6f 20 69 74  o compare two it
3c30: 65 72 61 74 6f 72 20 6b 65 79 73 20 77 68 65 6e  erator keys when
3c40: 20 6d 65 72 67 69 6e 67 20 0a 2a 2a 20 6d 75 6c   merging .** mul
3c50: 74 69 70 6c 65 20 62 2d 74 72 65 65 20 73 65 67  tiple b-tree seg
3c60: 6d 65 6e 74 73 2e 20 50 61 72 61 6d 65 74 65 72  ments. Parameter
3c70: 20 69 4f 75 74 20 69 73 20 74 68 65 20 69 6e 64   iOut is the ind
3c80: 65 78 20 6f 66 20 74 68 65 20 61 54 72 65 65 5b  ex of the aTree[
3c90: 5d 20 0a 2a 2a 20 76 61 6c 75 65 20 74 6f 20 72  ] .** value to r
3ca0: 65 63 61 6c 63 75 6c 61 74 65 2e 0a 2a 2f 0a 73  ecalculate..*/.s
3cb0: 74 61 74 69 63 20 69 6e 74 20 76 64 62 65 53 6f  tatic int vdbeSo
3cc0: 72 74 65 72 44 6f 43 6f 6d 70 61 72 65 28 63 6f  rterDoCompare(co
3cd0: 6e 73 74 20 56 64 62 65 43 75 72 73 6f 72 20 2a  nst VdbeCursor *
3ce0: 70 43 73 72 2c 20 69 6e 74 20 69 4f 75 74 29 7b  pCsr, int iOut){
3cf0: 0a 20 20 56 64 62 65 53 6f 72 74 65 72 20 2a 70  .  VdbeSorter *p
3d00: 53 6f 72 74 65 72 20 3d 20 70 43 73 72 2d 3e 70  Sorter = pCsr->p
3d10: 53 6f 72 74 65 72 3b 0a 20 20 69 6e 74 20 69 31  Sorter;.  int i1
3d20: 3b 0a 20 20 69 6e 74 20 69 32 3b 0a 20 20 69 6e  ;.  int i2;.  in
3d30: 74 20 69 52 65 73 3b 0a 20 20 56 64 62 65 53 6f  t iRes;.  VdbeSo
3d40: 72 74 65 72 49 74 65 72 20 2a 70 31 3b 0a 20 20  rterIter *p1;.  
3d50: 56 64 62 65 53 6f 72 74 65 72 49 74 65 72 20 2a  VdbeSorterIter *
3d60: 70 32 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 69  p2;..  assert( i
3d70: 4f 75 74 3c 70 53 6f 72 74 65 72 2d 3e 6e 54 72  Out<pSorter->nTr
3d80: 65 65 20 26 26 20 69 4f 75 74 3e 30 20 29 3b 0a  ee && iOut>0 );.
3d90: 0a 20 20 69 66 28 20 69 4f 75 74 3e 3d 28 70 53  .  if( iOut>=(pS
3da0: 6f 72 74 65 72 2d 3e 6e 54 72 65 65 2f 32 29 20  orter->nTree/2) 
3db0: 29 7b 0a 20 20 20 20 69 31 20 3d 20 28 69 4f 75  ){.    i1 = (iOu
3dc0: 74 20 2d 20 70 53 6f 72 74 65 72 2d 3e 6e 54 72  t - pSorter->nTr
3dd0: 65 65 2f 32 29 20 2a 20 32 3b 0a 20 20 20 20 69  ee/2) * 2;.    i
3de0: 32 20 3d 20 69 31 20 2b 20 31 3b 0a 20 20 7d 65  2 = i1 + 1;.  }e
3df0: 6c 73 65 7b 0a 20 20 20 20 69 31 20 3d 20 70 53  lse{.    i1 = pS
3e00: 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 69 4f 75  orter->aTree[iOu
3e10: 74 2a 32 5d 3b 0a 20 20 20 20 69 32 20 3d 20 70  t*2];.    i2 = p
3e20: 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 69 4f  Sorter->aTree[iO
3e30: 75 74 2a 32 2b 31 5d 3b 0a 20 20 7d 0a 0a 20 20  ut*2+1];.  }..  
3e40: 70 31 20 3d 20 26 70 53 6f 72 74 65 72 2d 3e 61  p1 = &pSorter->a
3e50: 49 74 65 72 5b 69 31 5d 3b 0a 20 20 70 32 20 3d  Iter[i1];.  p2 =
3e60: 20 26 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72   &pSorter->aIter
3e70: 5b 69 32 5d 3b 0a 0a 20 20 69 66 28 20 70 31 2d  [i2];..  if( p1-
3e80: 3e 70 46 69 6c 65 3d 3d 30 20 29 7b 0a 20 20 20  >pFile==0 ){.   
3e90: 20 69 52 65 73 20 3d 20 69 32 3b 0a 20 20 7d 65   iRes = i2;.  }e
3ea0: 6c 73 65 20 69 66 28 20 70 32 2d 3e 70 46 69 6c  lse if( p2->pFil
3eb0: 65 3d 3d 30 20 29 7b 0a 20 20 20 20 69 52 65 73  e==0 ){.    iRes
3ec0: 20 3d 20 69 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a   = i1;.  }else{.
3ed0: 20 20 20 20 69 6e 74 20 72 65 73 3b 0a 20 20 20      int res;.   
3ee0: 20 61 73 73 65 72 74 28 20 70 43 73 72 2d 3e 70   assert( pCsr->p
3ef0: 53 6f 72 74 65 72 2d 3e 70 55 6e 70 61 63 6b 65  Sorter->pUnpacke
3f00: 64 21 3d 30 20 29 3b 20 20 2f 2a 20 61 6c 6c 6f  d!=0 );  /* allo
3f10: 63 61 74 65 64 20 69 6e 20 76 64 62 65 53 6f 72  cated in vdbeSor
3f20: 74 65 72 4d 65 72 67 65 28 29 20 2a 2f 0a 20 20  terMerge() */.  
3f30: 20 20 76 64 62 65 53 6f 72 74 65 72 43 6f 6d 70    vdbeSorterComp
3f40: 61 72 65 28 0a 20 20 20 20 20 20 20 20 70 43 73  are(.        pCs
3f50: 72 2c 20 30 2c 20 70 31 2d 3e 61 4b 65 79 2c 20  r, 0, p1->aKey, 
3f60: 70 31 2d 3e 6e 4b 65 79 2c 20 70 32 2d 3e 61 4b  p1->nKey, p2->aK
3f70: 65 79 2c 20 70 32 2d 3e 6e 4b 65 79 2c 20 26 72  ey, p2->nKey, &r
3f80: 65 73 0a 20 20 20 20 29 3b 0a 20 20 20 20 69 66  es.    );.    if
3f90: 28 20 72 65 73 3c 3d 30 20 29 7b 0a 20 20 20 20  ( res<=0 ){.    
3fa0: 20 20 69 52 65 73 20 3d 20 69 31 3b 0a 20 20 20    iRes = i1;.   
3fb0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 69 52   }else{.      iR
3fc0: 65 73 20 3d 20 69 32 3b 0a 20 20 20 20 7d 0a 20  es = i2;.    }. 
3fd0: 20 7d 0a 0a 20 20 70 53 6f 72 74 65 72 2d 3e 61   }..  pSorter->a
3fe0: 54 72 65 65 5b 69 4f 75 74 5d 20 3d 20 69 52 65  Tree[iOut] = iRe
3ff0: 73 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  s;.  return SQLI
4000: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  TE_OK;.}../*.** 
4010: 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 74  Initialize the t
4020: 65 6d 70 6f 72 61 72 79 20 69 6e 64 65 78 20 63  emporary index c
4030: 75 72 73 6f 72 20 6a 75 73 74 20 6f 70 65 6e 65  ursor just opene
4040: 64 20 61 73 20 61 20 73 6f 72 74 65 72 20 63 75  d as a sorter cu
4050: 72 73 6f 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  rsor..*/.int sql
4060: 69 74 65 33 56 64 62 65 53 6f 72 74 65 72 49 6e  ite3VdbeSorterIn
4070: 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  it(sqlite3 *db, 
4080: 56 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72  VdbeCursor *pCsr
4090: 29 7b 0a 20 20 69 6e 74 20 70 67 73 7a 3b 20 20  ){.  int pgsz;  
40a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
40b0: 20 20 20 20 20 2f 2a 20 50 61 67 65 20 73 69 7a       /* Page siz
40c0: 65 20 6f 66 20 6d 61 69 6e 20 64 61 74 61 62 61  e of main databa
40d0: 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 43 61  se */.  int mxCa
40e0: 63 68 65 3b 20 20 20 20 20 20 20 20 20 20 20 20  che;            
40f0: 20 20 20 20 20 20 20 20 2f 2a 20 43 61 63 68 65          /* Cache
4100: 20 73 69 7a 65 20 2a 2f 0a 20 20 56 64 62 65 53   size */.  VdbeS
4110: 6f 72 74 65 72 20 2a 70 53 6f 72 74 65 72 3b 20  orter *pSorter; 
4120: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
4130: 65 20 6e 65 77 20 73 6f 72 74 65 72 20 2a 2f 0a  e new sorter */.
4140: 20 20 63 68 61 72 20 2a 64 3b 20 20 20 20 20 20    char *d;      
4150: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4160: 20 20 2f 2a 20 44 75 6d 6d 79 20 2a 2f 0a 0a 20    /* Dummy */.. 
4170: 20 61 73 73 65 72 74 28 20 70 43 73 72 2d 3e 70   assert( pCsr->p
4180: 4b 65 79 49 6e 66 6f 20 26 26 20 70 43 73 72 2d  KeyInfo && pCsr-
4190: 3e 70 42 74 3d 3d 30 20 29 3b 0a 20 20 70 43 73  >pBt==0 );.  pCs
41a0: 72 2d 3e 70 53 6f 72 74 65 72 20 3d 20 70 53 6f  r->pSorter = pSo
41b0: 72 74 65 72 20 3d 20 73 71 6c 69 74 65 33 44 62  rter = sqlite3Db
41c0: 4d 61 6c 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 73  MallocZero(db, s
41d0: 69 7a 65 6f 66 28 56 64 62 65 53 6f 72 74 65 72  izeof(VdbeSorter
41e0: 29 29 3b 0a 20 20 69 66 28 20 70 53 6f 72 74 65  ));.  if( pSorte
41f0: 72 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75  r==0 ){.    retu
4200: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b  rn SQLITE_NOMEM;
4210: 0a 20 20 7d 0a 20 20 0a 20 20 70 53 6f 72 74 65  .  }.  .  pSorte
4220: 72 2d 3e 70 55 6e 70 61 63 6b 65 64 20 3d 20 73  r->pUnpacked = s
4230: 71 6c 69 74 65 33 56 64 62 65 41 6c 6c 6f 63 55  qlite3VdbeAllocU
4240: 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 28 70 43  npackedRecord(pC
4250: 73 72 2d 3e 70 4b 65 79 49 6e 66 6f 2c 20 30 2c  sr->pKeyInfo, 0,
4260: 20 30 2c 20 26 64 29 3b 0a 20 20 69 66 28 20 70   0, &d);.  if( p
4270: 53 6f 72 74 65 72 2d 3e 70 55 6e 70 61 63 6b 65  Sorter->pUnpacke
4280: 64 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51  d==0 ) return SQ
4290: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 61 73  LITE_NOMEM;.  as
42a0: 73 65 72 74 28 20 70 53 6f 72 74 65 72 2d 3e 70  sert( pSorter->p
42b0: 55 6e 70 61 63 6b 65 64 3d 3d 28 55 6e 70 61 63  Unpacked==(Unpac
42c0: 6b 65 64 52 65 63 6f 72 64 20 2a 29 64 20 29 3b  kedRecord *)d );
42d0: 0a 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33  ..  if( !sqlite3
42e0: 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 28 64 62 29  TempInMemory(db)
42f0: 20 29 7b 0a 20 20 20 20 70 67 73 7a 20 3d 20 73   ){.    pgsz = s
4300: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 50 61  qlite3BtreeGetPa
4310: 67 65 53 69 7a 65 28 64 62 2d 3e 61 44 62 5b 30  geSize(db->aDb[0
4320: 5d 2e 70 42 74 29 3b 0a 20 20 20 20 70 53 6f 72  ].pBt);.    pSor
4330: 74 65 72 2d 3e 6d 6e 50 6d 61 53 69 7a 65 20 3d  ter->mnPmaSize =
4340: 20 53 4f 52 54 45 52 5f 4d 49 4e 5f 57 4f 52 4b   SORTER_MIN_WORK
4350: 49 4e 47 20 2a 20 70 67 73 7a 3b 0a 20 20 20 20  ING * pgsz;.    
4360: 6d 78 43 61 63 68 65 20 3d 20 64 62 2d 3e 61 44  mxCache = db->aD
4370: 62 5b 30 5d 2e 70 53 63 68 65 6d 61 2d 3e 63 61  b[0].pSchema->ca
4380: 63 68 65 5f 73 69 7a 65 3b 0a 20 20 20 20 69 66  che_size;.    if
4390: 28 20 6d 78 43 61 63 68 65 3c 53 4f 52 54 45 52  ( mxCache<SORTER
43a0: 5f 4d 49 4e 5f 57 4f 52 4b 49 4e 47 20 29 20 6d  _MIN_WORKING ) m
43b0: 78 43 61 63 68 65 20 3d 20 53 4f 52 54 45 52 5f  xCache = SORTER_
43c0: 4d 49 4e 5f 57 4f 52 4b 49 4e 47 3b 0a 20 20 20  MIN_WORKING;.   
43d0: 20 70 53 6f 72 74 65 72 2d 3e 6d 78 50 6d 61 53   pSorter->mxPmaS
43e0: 69 7a 65 20 3d 20 6d 78 43 61 63 68 65 20 2a 20  ize = mxCache * 
43f0: 70 67 73 7a 3b 0a 20 20 7d 0a 0a 20 20 72 65 74  pgsz;.  }..  ret
4400: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d  urn SQLITE_OK;.}
4410: 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 74 68 65  ../*.** Free the
4420: 20 6c 69 73 74 20 6f 66 20 73 6f 72 74 65 64 20   list of sorted 
4430: 72 65 63 6f 72 64 73 20 73 74 61 72 74 69 6e 67  records starting
4440: 20 61 74 20 70 52 65 63 6f 72 64 2e 0a 2a 2f 0a   at pRecord..*/.
4450: 73 74 61 74 69 63 20 76 6f 69 64 20 76 64 62 65  static void vdbe
4460: 53 6f 72 74 65 72 52 65 63 6f 72 64 46 72 65 65  SorterRecordFree
4470: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 53 6f  (sqlite3 *db, So
4480: 72 74 65 72 52 65 63 6f 72 64 20 2a 70 52 65 63  rterRecord *pRec
4490: 6f 72 64 29 7b 0a 20 20 53 6f 72 74 65 72 52 65  ord){.  SorterRe
44a0: 63 6f 72 64 20 2a 70 3b 0a 20 20 53 6f 72 74 65  cord *p;.  Sorte
44b0: 72 52 65 63 6f 72 64 20 2a 70 4e 65 78 74 3b 0a  rRecord *pNext;.
44c0: 20 20 66 6f 72 28 70 3d 70 52 65 63 6f 72 64 3b    for(p=pRecord;
44d0: 20 70 3b 20 70 3d 70 4e 65 78 74 29 7b 0a 20 20   p; p=pNext){.  
44e0: 20 20 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e 65    pNext = p->pNe
44f0: 78 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44  xt;.    sqlite3D
4500: 62 46 72 65 65 28 64 62 2c 20 70 29 3b 0a 20 20  bFree(db, p);.  
4510: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20  }.}../*.** Free 
4520: 61 6e 79 20 63 75 72 73 6f 72 20 63 6f 6d 70 6f  any cursor compo
4530: 6e 65 6e 74 73 20 61 6c 6c 6f 63 61 74 65 64 20  nents allocated 
4540: 62 79 20 73 71 6c 69 74 65 33 56 64 62 65 53 6f  by sqlite3VdbeSo
4550: 72 74 65 72 58 58 58 20 72 6f 75 74 69 6e 65 73  rterXXX routines
4560: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
4570: 33 56 64 62 65 53 6f 72 74 65 72 43 6c 6f 73 65  3VdbeSorterClose
4580: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 56 64  (sqlite3 *db, Vd
4590: 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 29 7b  beCursor *pCsr){
45a0: 0a 20 20 56 64 62 65 53 6f 72 74 65 72 20 2a 70  .  VdbeSorter *p
45b0: 53 6f 72 74 65 72 20 3d 20 70 43 73 72 2d 3e 70  Sorter = pCsr->p
45c0: 53 6f 72 74 65 72 3b 0a 20 20 69 66 28 20 70 53  Sorter;.  if( pS
45d0: 6f 72 74 65 72 20 29 7b 0a 20 20 20 20 69 66 28  orter ){.    if(
45e0: 20 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 20   pSorter->aIter 
45f0: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 0a  ){.      int i;.
4600: 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69        for(i=0; i
4610: 3c 70 53 6f 72 74 65 72 2d 3e 6e 54 72 65 65 3b  <pSorter->nTree;
4620: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 76   i++){.        v
4630: 64 62 65 53 6f 72 74 65 72 49 74 65 72 5a 65 72  dbeSorterIterZer
4640: 6f 28 64 62 2c 20 26 70 53 6f 72 74 65 72 2d 3e  o(db, &pSorter->
4650: 61 49 74 65 72 5b 69 5d 29 3b 0a 20 20 20 20 20  aIter[i]);.     
4660: 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33   }.      sqlite3
4670: 44 62 46 72 65 65 28 64 62 2c 20 70 53 6f 72 74  DbFree(db, pSort
4680: 65 72 2d 3e 61 49 74 65 72 29 3b 0a 20 20 20 20  er->aIter);.    
4690: 7d 0a 20 20 20 20 69 66 28 20 70 53 6f 72 74 65  }.    if( pSorte
46a0: 72 2d 3e 70 54 65 6d 70 31 20 29 7b 0a 20 20 20  r->pTemp1 ){.   
46b0: 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73     sqlite3OsClos
46c0: 65 46 72 65 65 28 70 53 6f 72 74 65 72 2d 3e 70  eFree(pSorter->p
46d0: 54 65 6d 70 31 29 3b 0a 20 20 20 20 7d 0a 20 20  Temp1);.    }.  
46e0: 20 20 76 64 62 65 53 6f 72 74 65 72 52 65 63 6f    vdbeSorterReco
46f0: 72 64 46 72 65 65 28 64 62 2c 20 70 53 6f 72 74  rdFree(db, pSort
4700: 65 72 2d 3e 70 52 65 63 6f 72 64 29 3b 0a 20 20  er->pRecord);.  
4710: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28    sqlite3DbFree(
4720: 64 62 2c 20 70 53 6f 72 74 65 72 2d 3e 70 55 6e  db, pSorter->pUn
4730: 70 61 63 6b 65 64 29 3b 0a 20 20 20 20 73 71 6c  packed);.    sql
4740: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70  ite3DbFree(db, p
4750: 53 6f 72 74 65 72 29 3b 0a 20 20 20 20 70 43 73  Sorter);.    pCs
4760: 72 2d 3e 70 53 6f 72 74 65 72 20 3d 20 30 3b 0a  r->pSorter = 0;.
4770: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c    }.}../*.** All
4780: 6f 63 61 74 65 20 73 70 61 63 65 20 66 6f 72 20  ocate space for 
4790: 61 20 66 69 6c 65 2d 68 61 6e 64 6c 65 20 61 6e  a file-handle an
47a0: 64 20 6f 70 65 6e 20 61 20 74 65 6d 70 6f 72 61  d open a tempora
47b0: 72 79 20 66 69 6c 65 2e 20 49 66 20 73 75 63 63  ry file. If succ
47c0: 65 73 73 66 75 6c 2c 0a 2a 2a 20 73 65 74 20 2a  essful,.** set *
47d0: 70 70 46 69 6c 65 20 74 6f 20 70 6f 69 6e 74 20  ppFile to point 
47e0: 74 6f 20 74 68 65 20 6d 61 6c 6c 6f 63 27 64 20  to the malloc'd 
47f0: 66 69 6c 65 2d 68 61 6e 64 6c 65 20 61 6e 64 20  file-handle and 
4800: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
4810: 2e 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20  ..** Otherwise, 
4820: 73 65 74 20 2a 70 70 46 69 6c 65 20 74 6f 20 30  set *ppFile to 0
4830: 20 61 6e 64 20 72 65 74 75 72 6e 20 61 6e 20 53   and return an S
4840: 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65  QLite error code
4850: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
4860: 76 64 62 65 53 6f 72 74 65 72 4f 70 65 6e 54 65  vdbeSorterOpenTe
4870: 6d 70 46 69 6c 65 28 73 71 6c 69 74 65 33 20 2a  mpFile(sqlite3 *
4880: 64 62 2c 20 73 71 6c 69 74 65 33 5f 66 69 6c 65  db, sqlite3_file
4890: 20 2a 2a 70 70 46 69 6c 65 29 7b 0a 20 20 69 6e   **ppFile){.  in
48a0: 74 20 64 75 6d 6d 79 3b 0a 20 20 72 65 74 75 72  t dummy;.  retur
48b0: 6e 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 4d  n sqlite3OsOpenM
48c0: 61 6c 6c 6f 63 28 64 62 2d 3e 70 56 66 73 2c 20  alloc(db->pVfs, 
48d0: 30 2c 20 70 70 46 69 6c 65 2c 0a 20 20 20 20 20  0, ppFile,.     
48e0: 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d   SQLITE_OPEN_TEM
48f0: 50 5f 4a 4f 55 52 4e 41 4c 20 7c 0a 20 20 20 20  P_JOURNAL |.    
4900: 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45    SQLITE_OPEN_RE
4910: 41 44 57 52 49 54 45 20 20 20 20 7c 20 53 51 4c  ADWRITE    | SQL
4920: 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20  ITE_OPEN_CREATE 
4930: 7c 0a 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f  |.      SQLITE_O
4940: 50 45 4e 5f 45 58 43 4c 55 53 49 56 45 20 20 20  PEN_EXCLUSIVE   
4950: 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44   | SQLITE_OPEN_D
4960: 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 2c 20 26 64  ELETEONCLOSE, &d
4970: 75 6d 6d 79 0a 20 20 29 3b 0a 7d 0a 0a 2f 2a 0a  ummy.  );.}../*.
4980: 2a 2a 20 4d 65 72 67 65 20 74 68 65 20 74 77 6f  ** Merge the two
4990: 20 73 6f 72 74 65 64 20 6c 69 73 74 73 20 70 31   sorted lists p1
49a0: 20 61 6e 64 20 70 32 20 69 6e 74 6f 20 61 20 73   and p2 into a s
49b0: 69 6e 67 6c 65 20 6c 69 73 74 2e 0a 2a 2a 20 53  ingle list..** S
49c0: 65 74 20 2a 70 70 4f 75 74 20 74 6f 20 74 68 65  et *ppOut to the
49d0: 20 68 65 61 64 20 6f 66 20 74 68 65 20 6e 65 77   head of the new
49e0: 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63   list..*/.static
49f0: 20 76 6f 69 64 20 76 64 62 65 53 6f 72 74 65 72   void vdbeSorter
4a00: 4d 65 72 67 65 28 0a 20 20 63 6f 6e 73 74 20 56  Merge(.  const V
4a10: 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 2c  dbeCursor *pCsr,
4a20: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 20           /* For 
4a30: 70 4b 65 79 49 6e 66 6f 20 2a 2f 0a 20 20 53 6f  pKeyInfo */.  So
4a40: 72 74 65 72 52 65 63 6f 72 64 20 2a 70 31 2c 20  rterRecord *p1, 
4a50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4a60: 20 46 69 72 73 74 20 6c 69 73 74 20 74 6f 20 6d   First list to m
4a70: 65 72 67 65 20 2a 2f 0a 20 20 53 6f 72 74 65 72  erge */.  Sorter
4a80: 52 65 63 6f 72 64 20 2a 70 32 2c 20 20 20 20 20  Record *p2,     
4a90: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 65 63            /* Sec
4aa0: 6f 6e 64 20 6c 69 73 74 20 74 6f 20 6d 65 72 67  ond list to merg
4ab0: 65 20 2a 2f 0a 20 20 53 6f 72 74 65 72 52 65 63  e */.  SorterRec
4ac0: 6f 72 64 20 2a 2a 70 70 4f 75 74 20 20 20 20 20  ord **ppOut     
4ad0: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 48         /* OUT: H
4ae0: 65 61 64 20 6f 66 20 6d 65 72 67 65 64 20 6c 69  ead of merged li
4af0: 73 74 20 2a 2f 0a 29 7b 0a 20 20 53 6f 72 74 65  st */.){.  Sorte
4b00: 72 52 65 63 6f 72 64 20 2a 70 46 69 6e 61 6c 20  rRecord *pFinal 
4b10: 3d 20 30 3b 0a 20 20 53 6f 72 74 65 72 52 65 63  = 0;.  SorterRec
4b20: 6f 72 64 20 2a 2a 70 70 20 3d 20 26 70 46 69 6e  ord **pp = &pFin
4b30: 61 6c 3b 0a 20 20 76 6f 69 64 20 2a 70 56 61 6c  al;.  void *pVal
4b40: 32 20 3d 20 70 32 20 3f 20 70 32 2d 3e 70 56 61  2 = p2 ? p2->pVa
4b50: 6c 20 3a 20 30 3b 0a 0a 20 20 77 68 69 6c 65 28  l : 0;..  while(
4b60: 20 70 31 20 26 26 20 70 32 20 29 7b 0a 20 20 20   p1 && p2 ){.   
4b70: 20 69 6e 74 20 72 65 73 3b 0a 20 20 20 20 76 64   int res;.    vd
4b80: 62 65 53 6f 72 74 65 72 43 6f 6d 70 61 72 65 28  beSorterCompare(
4b90: 70 43 73 72 2c 20 30 2c 20 70 31 2d 3e 70 56 61  pCsr, 0, p1->pVa
4ba0: 6c 2c 20 70 31 2d 3e 6e 56 61 6c 2c 20 70 56 61  l, p1->nVal, pVa
4bb0: 6c 32 2c 20 70 32 2d 3e 6e 56 61 6c 2c 20 26 72  l2, p2->nVal, &r
4bc0: 65 73 29 3b 0a 20 20 20 20 69 66 28 20 72 65 73  es);.    if( res
4bd0: 3c 3d 30 20 29 7b 0a 20 20 20 20 20 20 2a 70 70  <=0 ){.      *pp
4be0: 20 3d 20 70 31 3b 0a 20 20 20 20 20 20 70 70 20   = p1;.      pp 
4bf0: 3d 20 26 70 31 2d 3e 70 4e 65 78 74 3b 0a 20 20  = &p1->pNext;.  
4c00: 20 20 20 20 70 31 20 3d 20 70 31 2d 3e 70 4e 65      p1 = p1->pNe
4c10: 78 74 3b 0a 20 20 20 20 20 20 70 56 61 6c 32 20  xt;.      pVal2 
4c20: 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  = 0;.    }else{.
4c30: 20 20 20 20 20 20 2a 70 70 20 3d 20 70 32 3b 0a        *pp = p2;.
4c40: 20 20 20 20 20 20 20 70 70 20 3d 20 26 70 32 2d         pp = &p2-
4c50: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 70 32  >pNext;.      p2
4c60: 20 3d 20 70 32 2d 3e 70 4e 65 78 74 3b 0a 20 20   = p2->pNext;.  
4c70: 20 20 20 20 69 66 28 20 70 32 3d 3d 30 20 29 20      if( p2==0 ) 
4c80: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 70 56 61  break;.      pVa
4c90: 6c 32 20 3d 20 70 32 2d 3e 70 56 61 6c 3b 0a 20  l2 = p2->pVal;. 
4ca0: 20 20 20 7d 0a 20 20 7d 0a 20 20 2a 70 70 20 3d     }.  }.  *pp =
4cb0: 20 70 31 20 3f 20 70 31 20 3a 20 70 32 3b 0a 20   p1 ? p1 : p2;. 
4cc0: 20 2a 70 70 4f 75 74 20 3d 20 70 46 69 6e 61 6c   *ppOut = pFinal
4cd0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6f 72 74 20  ;.}../*.** Sort 
4ce0: 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20  the linked list 
4cf0: 6f 66 20 72 65 63 6f 72 64 73 20 68 65 61 64 65  of records heade
4d00: 64 20 61 74 20 70 43 73 72 2d 3e 70 52 65 63 6f  d at pCsr->pReco
4d10: 72 64 2e 20 52 65 74 75 72 6e 20 53 51 4c 49 54  rd. Return SQLIT
4d20: 45 5f 4f 4b 0a 2a 2a 20 69 66 20 73 75 63 63 65  E_OK.** if succe
4d30: 73 73 66 75 6c 2c 20 6f 72 20 61 6e 20 53 51 4c  ssful, or an SQL
4d40: 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 20 28  ite error code (
4d50: 69 2e 65 2e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  i.e. SQLITE_NOME
4d60: 4d 29 20 69 66 20 61 6e 20 65 72 72 6f 72 0a 2a  M) if an error.*
4d70: 2a 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 73 74 61  * occurs..*/.sta
4d80: 74 69 63 20 69 6e 74 20 76 64 62 65 53 6f 72 74  tic int vdbeSort
4d90: 65 72 53 6f 72 74 28 63 6f 6e 73 74 20 56 64 62  erSort(const Vdb
4da0: 65 43 75 72 73 6f 72 20 2a 70 43 73 72 29 7b 0a  eCursor *pCsr){.
4db0: 20 20 69 6e 74 20 69 3b 0a 20 20 53 6f 72 74 65    int i;.  Sorte
4dc0: 72 52 65 63 6f 72 64 20 2a 2a 61 53 6c 6f 74 3b  rRecord **aSlot;
4dd0: 0a 20 20 53 6f 72 74 65 72 52 65 63 6f 72 64 20  .  SorterRecord 
4de0: 2a 70 3b 0a 20 20 56 64 62 65 53 6f 72 74 65 72  *p;.  VdbeSorter
4df0: 20 2a 70 53 6f 72 74 65 72 20 3d 20 70 43 73 72   *pSorter = pCsr
4e00: 2d 3e 70 53 6f 72 74 65 72 3b 0a 0a 20 20 61 53  ->pSorter;..  aS
4e10: 6c 6f 74 20 3d 20 28 53 6f 72 74 65 72 52 65 63  lot = (SorterRec
4e20: 6f 72 64 20 2a 2a 29 73 71 6c 69 74 65 33 4d 61  ord **)sqlite3Ma
4e30: 6c 6c 6f 63 5a 65 72 6f 28 36 34 20 2a 20 73 69  llocZero(64 * si
4e40: 7a 65 6f 66 28 53 6f 72 74 65 72 52 65 63 6f 72  zeof(SorterRecor
4e50: 64 20 2a 29 29 3b 0a 20 20 69 66 28 20 21 61 53  d *));.  if( !aS
4e60: 6c 6f 74 20 29 7b 0a 20 20 20 20 72 65 74 75 72  lot ){.    retur
4e70: 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  n SQLITE_NOMEM;.
4e80: 20 20 7d 0a 0a 20 20 70 20 3d 20 70 53 6f 72 74    }..  p = pSort
4e90: 65 72 2d 3e 70 52 65 63 6f 72 64 3b 0a 20 20 77  er->pRecord;.  w
4ea0: 68 69 6c 65 28 20 70 20 29 7b 0a 20 20 20 20 53  hile( p ){.    S
4eb0: 6f 72 74 65 72 52 65 63 6f 72 64 20 2a 70 4e 65  orterRecord *pNe
4ec0: 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20  xt = p->pNext;. 
4ed0: 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 30 3b     p->pNext = 0;
4ee0: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 61 53  .    for(i=0; aS
4ef0: 6c 6f 74 5b 69 5d 3b 20 69 2b 2b 29 7b 0a 20 20  lot[i]; i++){.  
4f00: 20 20 20 20 76 64 62 65 53 6f 72 74 65 72 4d 65      vdbeSorterMe
4f10: 72 67 65 28 70 43 73 72 2c 20 70 2c 20 61 53 6c  rge(pCsr, p, aSl
4f20: 6f 74 5b 69 5d 2c 20 26 70 29 3b 0a 20 20 20 20  ot[i], &p);.    
4f30: 20 20 61 53 6c 6f 74 5b 69 5d 20 3d 20 30 3b 0a    aSlot[i] = 0;.
4f40: 20 20 20 20 7d 0a 20 20 20 20 61 53 6c 6f 74 5b      }.    aSlot[
4f50: 69 5d 20 3d 20 70 3b 0a 20 20 20 20 70 20 3d 20  i] = p;.    p = 
4f60: 70 4e 65 78 74 3b 0a 20 20 7d 0a 0a 20 20 70 20  pNext;.  }..  p 
4f70: 3d 20 30 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20  = 0;.  for(i=0; 
4f80: 69 3c 36 34 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  i<64; i++){.    
4f90: 76 64 62 65 53 6f 72 74 65 72 4d 65 72 67 65 28  vdbeSorterMerge(
4fa0: 70 43 73 72 2c 20 70 2c 20 61 53 6c 6f 74 5b 69  pCsr, p, aSlot[i
4fb0: 5d 2c 20 26 70 29 3b 0a 20 20 7d 0a 20 20 70 53  ], &p);.  }.  pS
4fc0: 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 20 3d  orter->pRecord =
4fd0: 20 70 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 66   p;..  sqlite3_f
4fe0: 72 65 65 28 61 53 6c 6f 74 29 3b 0a 20 20 72 65  ree(aSlot);.  re
4ff0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
5000: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c  }../*.** Initial
5010: 69 7a 65 20 61 20 66 69 6c 65 2d 77 72 69 74 65  ize a file-write
5020: 72 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 73 74 61  r object..*/.sta
5030: 74 69 63 20 76 6f 69 64 20 66 69 6c 65 57 72 69  tic void fileWri
5040: 74 65 72 49 6e 69 74 28 0a 20 20 73 71 6c 69 74  terInit(.  sqlit
5050: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  e3 *db,         
5060: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61             /* Da
5070: 74 61 62 61 73 65 20 28 66 6f 72 20 6d 61 6c 6c  tabase (for mall
5080: 6f 63 29 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  oc) */.  sqlite3
5090: 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 20 20  _file *pFile,   
50a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65           /* File
50b0: 20 74 6f 20 77 72 69 74 65 20 74 6f 20 2a 2f 0a   to write to */.
50c0: 20 20 46 69 6c 65 57 72 69 74 65 72 20 2a 70 2c    FileWriter *p,
50d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
50e0: 20 20 2f 2a 20 4f 62 6a 65 63 74 20 74 6f 20 70    /* Object to p
50f0: 6f 70 75 6c 61 74 65 20 2a 2f 0a 20 20 69 36 34  opulate */.  i64
5100: 20 69 53 74 61 72 74 20 20 20 20 20 20 20 20 20   iStart         
5110: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5120: 4f 66 66 73 65 74 20 6f 66 20 70 46 69 6c 65 20  Offset of pFile 
5130: 74 6f 20 62 65 67 69 6e 20 77 72 69 74 69 6e 67  to begin writing
5140: 20 61 74 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20   at */.){.  int 
5150: 6e 42 75 66 20 3d 20 73 71 6c 69 74 65 33 42 74  nBuf = sqlite3Bt
5160: 72 65 65 47 65 74 50 61 67 65 53 69 7a 65 28 64  reeGetPageSize(d
5170: 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a  b->aDb[0].pBt);.
5180: 0a 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20  .  memset(p, 0, 
5190: 73 69 7a 65 6f 66 28 46 69 6c 65 57 72 69 74 65  sizeof(FileWrite
51a0: 72 29 29 3b 0a 20 20 70 2d 3e 61 42 75 66 66 65  r));.  p->aBuffe
51b0: 72 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 65  r = (u8 *)sqlite
51c0: 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62 2c  3DbMallocRaw(db,
51d0: 20 6e 42 75 66 29 3b 0a 20 20 69 66 28 20 21 70   nBuf);.  if( !p
51e0: 2d 3e 61 42 75 66 66 65 72 20 29 7b 0a 20 20 20  ->aBuffer ){.   
51f0: 20 70 2d 3e 65 46 57 45 72 72 20 3d 20 53 51 4c   p->eFWErr = SQL
5200: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 65 6c  ITE_NOMEM;.  }el
5210: 73 65 7b 0a 20 20 20 20 70 2d 3e 69 42 75 66 45  se{.    p->iBufE
5220: 6e 64 20 3d 20 70 2d 3e 69 42 75 66 53 74 61 72  nd = p->iBufStar
5230: 74 20 3d 20 28 69 53 74 61 72 74 20 25 20 6e 42  t = (iStart % nB
5240: 75 66 29 3b 0a 20 20 20 20 70 2d 3e 69 57 72 69  uf);.    p->iWri
5250: 74 65 4f 66 66 20 3d 20 69 53 74 61 72 74 20 2d  teOff = iStart -
5260: 20 70 2d 3e 69 42 75 66 53 74 61 72 74 3b 0a 20   p->iBufStart;. 
5270: 20 20 20 70 2d 3e 6e 42 75 66 66 65 72 20 3d 20     p->nBuffer = 
5280: 6e 42 75 66 3b 0a 20 20 20 20 70 2d 3e 70 46 69  nBuf;.    p->pFi
5290: 6c 65 20 3d 20 70 46 69 6c 65 3b 0a 20 20 7d 0a  le = pFile;.  }.
52a0: 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 6e  }../*.** Write n
52b0: 44 61 74 61 20 62 79 74 65 73 20 6f 66 20 64 61  Data bytes of da
52c0: 74 61 20 74 6f 20 74 68 65 20 66 69 6c 65 2d 77  ta to the file-w
52d0: 72 69 74 65 20 6f 62 6a 65 63 74 2e 20 52 65 74  rite object. Ret
52e0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a  urn SQLITE_OK.**
52f0: 20 69 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20   if successful, 
5300: 6f 72 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72  or an SQLite err
5310: 6f 72 20 63 6f 64 65 20 69 66 20 61 6e 20 65 72  or code if an er
5320: 72 6f 72 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 73  ror occurs..*/.s
5330: 74 61 74 69 63 20 76 6f 69 64 20 66 69 6c 65 57  tatic void fileW
5340: 72 69 74 65 72 57 72 69 74 65 28 46 69 6c 65 57  riterWrite(FileW
5350: 72 69 74 65 72 20 2a 70 2c 20 75 38 20 2a 70 44  riter *p, u8 *pD
5360: 61 74 61 2c 20 69 6e 74 20 6e 44 61 74 61 29 7b  ata, int nData){
5370: 0a 20 20 69 6e 74 20 6e 52 65 6d 20 3d 20 6e 44  .  int nRem = nD
5380: 61 74 61 3b 0a 20 20 77 68 69 6c 65 28 20 6e 52  ata;.  while( nR
5390: 65 6d 3e 30 20 26 26 20 70 2d 3e 65 46 57 45 72  em>0 && p->eFWEr
53a0: 72 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20  r==0 ){.    int 
53b0: 6e 43 6f 70 79 20 3d 20 6e 52 65 6d 3b 0a 20 20  nCopy = nRem;.  
53c0: 20 20 69 66 28 20 6e 43 6f 70 79 3e 28 70 2d 3e    if( nCopy>(p->
53d0: 6e 42 75 66 66 65 72 20 2d 20 70 2d 3e 69 42 75  nBuffer - p->iBu
53e0: 66 45 6e 64 29 20 29 7b 0a 20 20 20 20 20 20 6e  fEnd) ){.      n
53f0: 43 6f 70 79 20 3d 20 70 2d 3e 6e 42 75 66 66 65  Copy = p->nBuffe
5400: 72 20 2d 20 70 2d 3e 69 42 75 66 45 6e 64 3b 0a  r - p->iBufEnd;.
5410: 20 20 20 20 7d 0a 0a 20 20 20 20 6d 65 6d 63 70      }..    memcp
5420: 79 28 26 70 2d 3e 61 42 75 66 66 65 72 5b 70 2d  y(&p->aBuffer[p-
5430: 3e 69 42 75 66 45 6e 64 5d 2c 20 26 70 44 61 74  >iBufEnd], &pDat
5440: 61 5b 6e 44 61 74 61 2d 6e 52 65 6d 5d 2c 20 6e  a[nData-nRem], n
5450: 43 6f 70 79 29 3b 0a 20 20 20 20 70 2d 3e 69 42  Copy);.    p->iB
5460: 75 66 45 6e 64 20 2b 3d 20 6e 43 6f 70 79 3b 0a  ufEnd += nCopy;.
5470: 20 20 20 20 69 66 28 20 70 2d 3e 69 42 75 66 45      if( p->iBufE
5480: 6e 64 3d 3d 70 2d 3e 6e 42 75 66 66 65 72 20 29  nd==p->nBuffer )
5490: 7b 0a 20 20 20 20 20 20 70 2d 3e 65 46 57 45 72  {.      p->eFWEr
54a0: 72 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69  r = sqlite3OsWri
54b0: 74 65 28 70 2d 3e 70 46 69 6c 65 2c 20 0a 20 20  te(p->pFile, .  
54c0: 20 20 20 20 20 20 20 20 26 70 2d 3e 61 42 75 66          &p->aBuf
54d0: 66 65 72 5b 70 2d 3e 69 42 75 66 53 74 61 72 74  fer[p->iBufStart
54e0: 5d 2c 20 70 2d 3e 69 42 75 66 45 6e 64 20 2d 20  ], p->iBufEnd - 
54f0: 70 2d 3e 69 42 75 66 53 74 61 72 74 2c 20 0a 20  p->iBufStart, . 
5500: 20 20 20 20 20 20 20 20 20 70 2d 3e 69 57 72 69           p->iWri
5510: 74 65 4f 66 66 20 2b 20 70 2d 3e 69 42 75 66 53  teOff + p->iBufS
5520: 74 61 72 74 0a 20 20 20 20 20 20 29 3b 0a 20 20  tart.      );.  
5530: 20 20 20 20 70 2d 3e 69 42 75 66 53 74 61 72 74      p->iBufStart
5540: 20 3d 20 70 2d 3e 69 42 75 66 45 6e 64 20 3d 20   = p->iBufEnd = 
5550: 30 3b 0a 20 20 20 20 20 20 70 2d 3e 69 57 72 69  0;.      p->iWri
5560: 74 65 4f 66 66 20 2b 3d 20 70 2d 3e 6e 42 75 66  teOff += p->nBuf
5570: 66 65 72 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61  fer;.    }.    a
5580: 73 73 65 72 74 28 20 70 2d 3e 69 42 75 66 45 6e  ssert( p->iBufEn
5590: 64 3c 70 2d 3e 6e 42 75 66 66 65 72 20 29 3b 0a  d<p->nBuffer );.
55a0: 0a 20 20 20 20 6e 52 65 6d 20 2d 3d 20 6e 43 6f  .    nRem -= nCo
55b0: 70 79 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a  py;.  }.}../*.**
55c0: 20 46 6c 75 73 68 20 61 6e 79 20 62 75 66 66 65   Flush any buffe
55d0: 72 65 64 20 64 61 74 61 20 74 6f 20 64 69 73 6b  red data to disk
55e0: 20 61 6e 64 20 63 6c 65 61 6e 20 75 70 20 74 68   and clean up th
55f0: 65 20 66 69 6c 65 2d 77 72 69 74 65 72 20 6f 62  e file-writer ob
5600: 6a 65 63 74 2e 0a 2a 2a 20 54 68 65 20 72 65 73  ject..** The res
5610: 75 6c 74 73 20 6f 66 20 75 73 69 6e 67 20 74 68  ults of using th
5620: 65 20 66 69 6c 65 2d 77 72 69 74 65 72 20 61 66  e file-writer af
5630: 74 65 72 20 74 68 69 73 20 63 61 6c 6c 20 61 72  ter this call ar
5640: 65 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2a 20  e undefined..** 
5650: 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  Return SQLITE_OK
5660: 20 69 66 20 66 6c 75 73 68 69 6e 67 20 74 68 65   if flushing the
5670: 20 62 75 66 66 65 72 65 64 20 64 61 74 61 20 73   buffered data s
5680: 75 63 63 65 65 64 73 20 6f 72 20 69 73 20 6e 6f  ucceeds or is no
5690: 74 20 0a 2a 2a 20 72 65 71 75 69 72 65 64 2e 20  t .** required. 
56a0: 4f 74 68 65 72 77 69 73 65 2c 20 72 65 74 75 72  Otherwise, retur
56b0: 6e 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f  n an SQLite erro
56c0: 72 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 42 65  r code..**.** Be
56d0: 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2c 20  fore returning, 
56e0: 73 65 74 20 2a 70 69 45 6f 66 20 74 6f 20 74 68  set *piEof to th
56f0: 65 20 6f 66 66 73 65 74 20 69 6d 6d 65 64 69 61  e offset immedia
5700: 74 65 6c 79 20 66 6f 6c 6c 6f 77 69 6e 67 20 74  tely following t
5710: 68 65 0a 2a 2a 20 6c 61 73 74 20 62 79 74 65 20  he.** last byte 
5720: 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 66  written to the f
5730: 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ile..*/.static i
5740: 6e 74 20 66 69 6c 65 57 72 69 74 65 72 46 69 6e  nt fileWriterFin
5750: 69 73 68 28 73 71 6c 69 74 65 33 20 2a 64 62 2c  ish(sqlite3 *db,
5760: 20 46 69 6c 65 57 72 69 74 65 72 20 2a 70 2c 20   FileWriter *p, 
5770: 69 36 34 20 2a 70 69 45 6f 66 29 7b 0a 20 20 69  i64 *piEof){.  i
5780: 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 70 2d 3e  nt rc;.  if( p->
5790: 65 46 57 45 72 72 3d 3d 30 20 26 26 20 41 4c 57  eFWErr==0 && ALW
57a0: 41 59 53 28 70 2d 3e 61 42 75 66 66 65 72 29 20  AYS(p->aBuffer) 
57b0: 26 26 20 70 2d 3e 69 42 75 66 45 6e 64 3e 70 2d  && p->iBufEnd>p-
57c0: 3e 69 42 75 66 53 74 61 72 74 20 29 7b 0a 20 20  >iBufStart ){.  
57d0: 20 20 70 2d 3e 65 46 57 45 72 72 20 3d 20 73 71    p->eFWErr = sq
57e0: 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 2d 3e  lite3OsWrite(p->
57f0: 70 46 69 6c 65 2c 20 0a 20 20 20 20 20 20 20 20  pFile, .        
5800: 26 70 2d 3e 61 42 75 66 66 65 72 5b 70 2d 3e 69  &p->aBuffer[p->i
5810: 42 75 66 53 74 61 72 74 5d 2c 20 70 2d 3e 69 42  BufStart], p->iB
5820: 75 66 45 6e 64 20 2d 20 70 2d 3e 69 42 75 66 53  ufEnd - p->iBufS
5830: 74 61 72 74 2c 20 0a 20 20 20 20 20 20 20 20 70  tart, .        p
5840: 2d 3e 69 57 72 69 74 65 4f 66 66 20 2b 20 70 2d  ->iWriteOff + p-
5850: 3e 69 42 75 66 53 74 61 72 74 0a 20 20 20 20 29  >iBufStart.    )
5860: 3b 0a 20 20 7d 0a 20 20 2a 70 69 45 6f 66 20 3d  ;.  }.  *piEof =
5870: 20 28 70 2d 3e 69 57 72 69 74 65 4f 66 66 20 2b   (p->iWriteOff +
5880: 20 70 2d 3e 69 42 75 66 45 6e 64 29 3b 0a 20 20   p->iBufEnd);.  
5890: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62  sqlite3DbFree(db
58a0: 2c 20 70 2d 3e 61 42 75 66 66 65 72 29 3b 0a 20  , p->aBuffer);. 
58b0: 20 72 63 20 3d 20 70 2d 3e 65 46 57 45 72 72 3b   rc = p->eFWErr;
58c0: 0a 20 20 6d 65 6d 73 65 74 28 70 2c 20 30 2c 20  .  memset(p, 0, 
58d0: 73 69 7a 65 6f 66 28 46 69 6c 65 57 72 69 74 65  sizeof(FileWrite
58e0: 72 29 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63  r));.  return rc
58f0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65  ;.}../*.** Write
5900: 20 76 61 6c 75 65 20 69 56 61 6c 20 65 6e 63 6f   value iVal enco
5910: 64 65 64 20 61 73 20 61 20 76 61 72 69 6e 74 20  ded as a varint 
5920: 74 6f 20 74 68 65 20 66 69 6c 65 2d 77 72 69 74  to the file-writ
5930: 65 20 6f 62 6a 65 63 74 2e 20 52 65 74 75 72 6e  e object. Return
5940: 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69   .** SQLITE_OK i
5950: 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 6f 72  f successful, or
5960: 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72   an SQLite error
5970: 20 63 6f 64 65 20 69 66 20 61 6e 20 65 72 72 6f   code if an erro
5980: 72 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 73 74 61  r occurs..*/.sta
5990: 74 69 63 20 76 6f 69 64 20 66 69 6c 65 57 72 69  tic void fileWri
59a0: 74 65 72 57 72 69 74 65 56 61 72 69 6e 74 28 46  terWriteVarint(F
59b0: 69 6c 65 57 72 69 74 65 72 20 2a 70 2c 20 75 36  ileWriter *p, u6
59c0: 34 20 69 56 61 6c 29 7b 0a 20 20 69 6e 74 20 6e  4 iVal){.  int n
59d0: 42 79 74 65 3b 20 0a 20 20 75 38 20 61 42 79 74  Byte; .  u8 aByt
59e0: 65 5b 31 30 5d 3b 0a 20 20 6e 42 79 74 65 20 3d  e[10];.  nByte =
59f0: 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 69 6e   sqlite3PutVarin
5a00: 74 28 61 42 79 74 65 2c 20 69 56 61 6c 29 3b 0a  t(aByte, iVal);.
5a10: 20 20 66 69 6c 65 57 72 69 74 65 72 57 72 69 74    fileWriterWrit
5a20: 65 28 70 2c 20 61 42 79 74 65 2c 20 6e 42 79 74  e(p, aByte, nByt
5a30: 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72 69  e);.}../*.** Wri
5a40: 74 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 63  te the current c
5a50: 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 69  ontents of the i
5a60: 6e 2d 6d 65 6d 6f 72 79 20 6c 69 6e 6b 65 64 2d  n-memory linked-
5a70: 6c 69 73 74 20 74 6f 20 61 20 50 4d 41 2e 20 52  list to a PMA. R
5a80: 65 74 75 72 6e 0a 2a 2a 20 53 51 4c 49 54 45 5f  eturn.** SQLITE_
5a90: 4f 4b 20 69 66 20 73 75 63 63 65 73 73 66 75 6c  OK if successful
5aa0: 2c 20 6f 72 20 61 6e 20 53 51 4c 69 74 65 20 65  , or an SQLite e
5ab0: 72 72 6f 72 20 63 6f 64 65 20 6f 74 68 65 72 77  rror code otherw
5ac0: 69 73 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66  ise..**.** The f
5ad0: 6f 72 6d 61 74 20 6f 66 20 61 20 50 4d 41 20 69  ormat of a PMA i
5ae0: 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 2a 20 41  s:.**.**     * A
5af0: 20 76 61 72 69 6e 74 2e 20 54 68 69 73 20 76 61   varint. This va
5b00: 72 69 6e 74 20 63 6f 6e 74 61 69 6e 73 20 74 68  rint contains th
5b10: 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f  e total number o
5b20: 66 20 62 79 74 65 73 20 6f 66 20 63 6f 6e 74 65  f bytes of conte
5b30: 6e 74 0a 2a 2a 20 20 20 20 20 20 20 69 6e 20 74  nt.**       in t
5b40: 68 65 20 50 4d 41 20 28 6e 6f 74 20 69 6e 63 6c  he PMA (not incl
5b50: 75 64 69 6e 67 20 74 68 65 20 76 61 72 69 6e 74  uding the varint
5b60: 20 69 74 73 65 6c 66 29 2e 0a 2a 2a 0a 2a 2a 20   itself)..**.** 
5b70: 20 20 20 20 2a 20 4f 6e 65 20 6f 72 20 6d 6f 72      * One or mor
5b80: 65 20 72 65 63 6f 72 64 73 20 70 61 63 6b 65 64  e records packed
5b90: 20 65 6e 64 2d 74 6f 2d 65 6e 64 20 69 6e 20 6f   end-to-end in o
5ba0: 72 64 65 72 20 6f 66 20 61 73 63 65 6e 64 69 6e  rder of ascendin
5bb0: 67 20 6b 65 79 73 2e 20 0a 2a 2a 20 20 20 20 20  g keys. .**     
5bc0: 20 20 45 61 63 68 20 72 65 63 6f 72 64 20 63 6f    Each record co
5bd0: 6e 73 69 73 74 73 20 6f 66 20 61 20 76 61 72 69  nsists of a vari
5be0: 6e 74 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61  nt followed by a
5bf0: 20 62 6c 6f 62 20 6f 66 20 64 61 74 61 20 28 74   blob of data (t
5c00: 68 65 20 0a 2a 2a 20 20 20 20 20 20 20 6b 65 79  he .**       key
5c10: 29 2e 20 54 68 65 20 76 61 72 69 6e 74 20 69 73  ). The varint is
5c20: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62   the number of b
5c30: 79 74 65 73 20 69 6e 20 74 68 65 20 62 6c 6f 62  ytes in the blob
5c40: 20 6f 66 20 64 61 74 61 2e 0a 2a 2f 0a 73 74 61   of data..*/.sta
5c50: 74 69 63 20 69 6e 74 20 76 64 62 65 53 6f 72 74  tic int vdbeSort
5c60: 65 72 4c 69 73 74 54 6f 50 4d 41 28 73 71 6c 69  erListToPMA(sqli
5c70: 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 56  te3 *db, const V
5c80: 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 29  dbeCursor *pCsr)
5c90: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c  {.  int rc = SQL
5ca0: 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20  ITE_OK;         
5cb0: 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f      /* Return co
5cc0: 64 65 20 2a 2f 0a 20 20 56 64 62 65 53 6f 72 74  de */.  VdbeSort
5cd0: 65 72 20 2a 70 53 6f 72 74 65 72 20 3d 20 70 43  er *pSorter = pC
5ce0: 73 72 2d 3e 70 53 6f 72 74 65 72 3b 0a 20 20 46  sr->pSorter;.  F
5cf0: 69 6c 65 57 72 69 74 65 72 20 77 72 69 74 65 72  ileWriter writer
5d00: 3b 0a 0a 20 20 6d 65 6d 73 65 74 28 26 77 72 69  ;..  memset(&wri
5d10: 74 65 72 2c 20 30 2c 20 73 69 7a 65 6f 66 28 46  ter, 0, sizeof(F
5d20: 69 6c 65 57 72 69 74 65 72 29 29 3b 0a 0a 20 20  ileWriter));..  
5d30: 69 66 28 20 70 53 6f 72 74 65 72 2d 3e 6e 49 6e  if( pSorter->nIn
5d40: 4d 65 6d 6f 72 79 3d 3d 30 20 29 7b 0a 20 20 20  Memory==0 ){.   
5d50: 20 61 73 73 65 72 74 28 20 70 53 6f 72 74 65 72   assert( pSorter
5d60: 2d 3e 70 52 65 63 6f 72 64 3d 3d 30 20 29 3b 0a  ->pRecord==0 );.
5d70: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
5d80: 20 7d 0a 0a 20 20 72 63 20 3d 20 76 64 62 65 53   }..  rc = vdbeS
5d90: 6f 72 74 65 72 53 6f 72 74 28 70 43 73 72 29 3b  orterSort(pCsr);
5da0: 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 66 69  ..  /* If the fi
5db0: 72 73 74 20 74 65 6d 70 6f 72 61 72 79 20 50 4d  rst temporary PM
5dc0: 41 20 66 69 6c 65 20 68 61 73 20 6e 6f 74 20 62  A file has not b
5dd0: 65 65 6e 20 6f 70 65 6e 65 64 2c 20 6f 70 65 6e  een opened, open
5de0: 20 69 74 20 6e 6f 77 2e 20 2a 2f 0a 20 20 69 66   it now. */.  if
5df0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
5e00: 26 26 20 70 53 6f 72 74 65 72 2d 3e 70 54 65 6d  && pSorter->pTem
5e10: 70 31 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 20  p1==0 ){.    rc 
5e20: 3d 20 76 64 62 65 53 6f 72 74 65 72 4f 70 65 6e  = vdbeSorterOpen
5e30: 54 65 6d 70 46 69 6c 65 28 64 62 2c 20 26 70 53  TempFile(db, &pS
5e40: 6f 72 74 65 72 2d 3e 70 54 65 6d 70 31 29 3b 0a  orter->pTemp1);.
5e50: 20 20 20 20 61 73 73 65 72 74 28 20 72 63 21 3d      assert( rc!=
5e60: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 53 6f  SQLITE_OK || pSo
5e70: 72 74 65 72 2d 3e 70 54 65 6d 70 31 20 29 3b 0a  rter->pTemp1 );.
5e80: 20 20 20 20 61 73 73 65 72 74 28 20 70 53 6f 72      assert( pSor
5e90: 74 65 72 2d 3e 69 57 72 69 74 65 4f 66 66 3d 3d  ter->iWriteOff==
5ea0: 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  0 );.    assert(
5eb0: 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d 41 3d 3d   pSorter->nPMA==
5ec0: 30 20 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20  0 );.  }..  if( 
5ed0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
5ee0: 0a 20 20 20 20 53 6f 72 74 65 72 52 65 63 6f 72  .    SorterRecor
5ef0: 64 20 2a 70 3b 0a 20 20 20 20 53 6f 72 74 65 72  d *p;.    Sorter
5f00: 52 65 63 6f 72 64 20 2a 70 4e 65 78 74 20 3d 20  Record *pNext = 
5f10: 30 3b 0a 0a 20 20 20 20 66 69 6c 65 57 72 69 74  0;..    fileWrit
5f20: 65 72 49 6e 69 74 28 64 62 2c 20 70 53 6f 72 74  erInit(db, pSort
5f30: 65 72 2d 3e 70 54 65 6d 70 31 2c 20 26 77 72 69  er->pTemp1, &wri
5f40: 74 65 72 2c 20 70 53 6f 72 74 65 72 2d 3e 69 57  ter, pSorter->iW
5f50: 72 69 74 65 4f 66 66 29 3b 0a 20 20 20 20 70 53  riteOff);.    pS
5f60: 6f 72 74 65 72 2d 3e 6e 50 4d 41 2b 2b 3b 0a 20  orter->nPMA++;. 
5f70: 20 20 20 66 69 6c 65 57 72 69 74 65 72 57 72 69     fileWriterWri
5f80: 74 65 56 61 72 69 6e 74 28 26 77 72 69 74 65 72  teVarint(&writer
5f90: 2c 20 70 53 6f 72 74 65 72 2d 3e 6e 49 6e 4d 65  , pSorter->nInMe
5fa0: 6d 6f 72 79 29 3b 0a 20 20 20 20 66 6f 72 28 70  mory);.    for(p
5fb0: 3d 70 53 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72  =pSorter->pRecor
5fc0: 64 3b 20 70 3b 20 70 3d 70 4e 65 78 74 29 7b 0a  d; p; p=pNext){.
5fd0: 20 20 20 20 20 20 70 4e 65 78 74 20 3d 20 70 2d        pNext = p-
5fe0: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 66 69  >pNext;.      fi
5ff0: 6c 65 57 72 69 74 65 72 57 72 69 74 65 56 61 72  leWriterWriteVar
6000: 69 6e 74 28 26 77 72 69 74 65 72 2c 20 70 2d 3e  int(&writer, p->
6010: 6e 56 61 6c 29 3b 0a 20 20 20 20 20 20 66 69 6c  nVal);.      fil
6020: 65 57 72 69 74 65 72 57 72 69 74 65 28 26 77 72  eWriterWrite(&wr
6030: 69 74 65 72 2c 20 70 2d 3e 70 56 61 6c 2c 20 70  iter, p->pVal, p
6040: 2d 3e 6e 56 61 6c 29 3b 0a 20 20 20 20 20 20 73  ->nVal);.      s
6050: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c  qlite3DbFree(db,
6060: 20 70 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70   p);.    }.    p
6070: 53 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 20  Sorter->pRecord 
6080: 3d 20 70 3b 0a 20 20 20 20 72 63 20 3d 20 66 69  = p;.    rc = fi
6090: 6c 65 57 72 69 74 65 72 46 69 6e 69 73 68 28 64  leWriterFinish(d
60a0: 62 2c 20 26 77 72 69 74 65 72 2c 20 26 70 53 6f  b, &writer, &pSo
60b0: 72 74 65 72 2d 3e 69 57 72 69 74 65 4f 66 66 29  rter->iWriteOff)
60c0: 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20  ;.  }..  return 
60d0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64  rc;.}../*.** Add
60e0: 20 61 20 72 65 63 6f 72 64 20 74 6f 20 74 68 65   a record to the
60f0: 20 73 6f 72 74 65 72 2e 0a 2a 2f 0a 69 6e 74 20   sorter..*/.int 
6100: 73 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65  sqlite3VdbeSorte
6110: 72 57 72 69 74 65 28 0a 20 20 73 71 6c 69 74 65  rWrite(.  sqlite
6120: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  3 *db,          
6130: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74            /* Dat
6140: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a  abase handle */.
6150: 20 20 63 6f 6e 73 74 20 56 64 62 65 43 75 72 73    const VdbeCurs
6160: 6f 72 20 2a 70 43 73 72 2c 20 20 20 20 20 20 20  or *pCsr,       
6170: 20 20 20 20 20 20 20 20 2f 2a 20 53 6f 72 74 65          /* Sorte
6180: 72 20 63 75 72 73 6f 72 20 2a 2f 0a 20 20 4d 65  r cursor */.  Me
6190: 6d 20 2a 70 56 61 6c 20 20 20 20 20 20 20 20 20  m *pVal         
61a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
61b0: 20 4d 65 6d 6f 72 79 20 63 65 6c 6c 20 63 6f 6e   Memory cell con
61c0: 74 61 69 6e 69 6e 67 20 72 65 63 6f 72 64 20 2a  taining record *
61d0: 2f 0a 29 7b 0a 20 20 56 64 62 65 53 6f 72 74 65  /.){.  VdbeSorte
61e0: 72 20 2a 70 53 6f 72 74 65 72 20 3d 20 70 43 73  r *pSorter = pCs
61f0: 72 2d 3e 70 53 6f 72 74 65 72 3b 0a 20 20 69 6e  r->pSorter;.  in
6200: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  t rc = SQLITE_OK
6210: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
6220: 20 52 65 74 75 72 6e 20 43 6f 64 65 20 2a 2f 0a   Return Code */.
6230: 20 20 53 6f 72 74 65 72 52 65 63 6f 72 64 20 2a    SorterRecord *
6240: 70 4e 65 77 3b 20 20 20 20 20 20 20 20 20 20 20  pNew;           
6250: 20 20 2f 2a 20 4e 65 77 20 6c 69 73 74 20 65 6c    /* New list el
6260: 65 6d 65 6e 74 20 2a 2f 0a 0a 20 20 61 73 73 65  ement */..  asse
6270: 72 74 28 20 70 53 6f 72 74 65 72 20 29 3b 0a 20  rt( pSorter );. 
6280: 20 70 53 6f 72 74 65 72 2d 3e 6e 49 6e 4d 65 6d   pSorter->nInMem
6290: 6f 72 79 20 2b 3d 20 73 71 6c 69 74 65 33 56 61  ory += sqlite3Va
62a0: 72 69 6e 74 4c 65 6e 28 70 56 61 6c 2d 3e 6e 29  rintLen(pVal->n)
62b0: 20 2b 20 70 56 61 6c 2d 3e 6e 3b 0a 0a 20 20 70   + pVal->n;..  p
62c0: 4e 65 77 20 3d 20 28 53 6f 72 74 65 72 52 65 63  New = (SorterRec
62d0: 6f 72 64 20 2a 29 73 71 6c 69 74 65 33 44 62 4d  ord *)sqlite3DbM
62e0: 61 6c 6c 6f 63 52 61 77 28 64 62 2c 20 70 56 61  allocRaw(db, pVa
62f0: 6c 2d 3e 6e 20 2b 20 73 69 7a 65 6f 66 28 53 6f  l->n + sizeof(So
6300: 72 74 65 72 52 65 63 6f 72 64 29 29 3b 0a 20 20  rterRecord));.  
6310: 69 66 28 20 70 4e 65 77 3d 3d 30 20 29 7b 0a 20  if( pNew==0 ){. 
6320: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e     rc = SQLITE_N
6330: 4f 4d 45 4d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  OMEM;.  }else{. 
6340: 20 20 20 70 4e 65 77 2d 3e 70 56 61 6c 20 3d 20     pNew->pVal = 
6350: 28 76 6f 69 64 20 2a 29 26 70 4e 65 77 5b 31 5d  (void *)&pNew[1]
6360: 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 4e 65  ;.    memcpy(pNe
6370: 77 2d 3e 70 56 61 6c 2c 20 70 56 61 6c 2d 3e 7a  w->pVal, pVal->z
6380: 2c 20 70 56 61 6c 2d 3e 6e 29 3b 0a 20 20 20 20  , pVal->n);.    
6390: 70 4e 65 77 2d 3e 6e 56 61 6c 20 3d 20 70 56 61  pNew->nVal = pVa
63a0: 6c 2d 3e 6e 3b 0a 20 20 20 20 70 4e 65 77 2d 3e  l->n;.    pNew->
63b0: 70 4e 65 78 74 20 3d 20 70 53 6f 72 74 65 72 2d  pNext = pSorter-
63c0: 3e 70 52 65 63 6f 72 64 3b 0a 20 20 20 20 70 53  >pRecord;.    pS
63d0: 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 20 3d  orter->pRecord =
63e0: 20 70 4e 65 77 3b 0a 20 20 7d 0a 0a 20 20 2f 2a   pNew;.  }..  /*
63f0: 20 53 65 65 20 69 66 20 74 68 65 20 63 6f 6e 74   See if the cont
6400: 65 6e 74 73 20 6f 66 20 74 68 65 20 73 6f 72 74  ents of the sort
6410: 65 72 20 73 68 6f 75 6c 64 20 6e 6f 77 20 62 65  er should now be
6420: 20 77 72 69 74 74 65 6e 20 6f 75 74 2e 20 54 68   written out. Th
6430: 65 79 0a 20 20 2a 2a 20 61 72 65 20 77 72 69 74  ey.  ** are writ
6440: 74 65 6e 20 6f 75 74 20 77 68 65 6e 20 65 69 74  ten out when eit
6450: 68 65 72 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  her of the follo
6460: 77 69 6e 67 20 61 72 65 20 74 72 75 65 3a 0a 20  wing are true:. 
6470: 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 54 68 65   **.  **   * The
6480: 20 74 6f 74 61 6c 20 6d 65 6d 6f 72 79 20 61 6c   total memory al
6490: 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 20  located for the 
64a0: 69 6e 2d 6d 65 6d 6f 72 79 20 6c 69 73 74 20 69  in-memory list i
64b0: 73 20 67 72 65 61 74 65 72 20 0a 20 20 2a 2a 20  s greater .  ** 
64c0: 20 20 20 20 74 68 61 6e 20 28 70 61 67 65 2d 73      than (page-s
64d0: 69 7a 65 20 2a 20 63 61 63 68 65 2d 73 69 7a 65  ize * cache-size
64e0: 29 2c 20 6f 72 0a 20 20 2a 2a 0a 20 20 2a 2a 20  ), or.  **.  ** 
64f0: 20 20 2a 20 54 68 65 20 74 6f 74 61 6c 20 6d 65    * The total me
6500: 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 65 64 20 66  mory allocated f
6510: 6f 72 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79  or the in-memory
6520: 20 6c 69 73 74 20 69 73 20 67 72 65 61 74 65 72   list is greater
6530: 20 0a 20 20 2a 2a 20 20 20 20 20 74 68 61 6e 20   .  **     than 
6540: 28 70 61 67 65 2d 73 69 7a 65 20 2a 20 31 30 29  (page-size * 10)
6550: 20 61 6e 64 20 73 71 6c 69 74 65 33 48 65 61 70   and sqlite3Heap
6560: 4e 65 61 72 6c 79 46 75 6c 6c 28 29 20 72 65 74  NearlyFull() ret
6570: 75 72 6e 73 20 74 72 75 65 2e 0a 20 20 2a 2f 0a  urns true..  */.
6580: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
6590: 5f 4f 4b 20 26 26 20 70 53 6f 72 74 65 72 2d 3e  _OK && pSorter->
65a0: 6d 78 50 6d 61 53 69 7a 65 3e 30 20 26 26 20 28  mxPmaSize>0 && (
65b0: 0a 20 20 20 20 20 20 20 20 28 70 53 6f 72 74 65  .        (pSorte
65c0: 72 2d 3e 6e 49 6e 4d 65 6d 6f 72 79 3e 70 53 6f  r->nInMemory>pSo
65d0: 72 74 65 72 2d 3e 6d 78 50 6d 61 53 69 7a 65 29  rter->mxPmaSize)
65e0: 0a 20 20 20 20 20 7c 7c 20 28 70 53 6f 72 74 65  .     || (pSorte
65f0: 72 2d 3e 6e 49 6e 4d 65 6d 6f 72 79 3e 70 53 6f  r->nInMemory>pSo
6600: 72 74 65 72 2d 3e 6d 6e 50 6d 61 53 69 7a 65 20  rter->mnPmaSize 
6610: 26 26 20 73 71 6c 69 74 65 33 48 65 61 70 4e 65  && sqlite3HeapNe
6620: 61 72 6c 79 46 75 6c 6c 28 29 29 0a 20 20 29 29  arlyFull()).  ))
6630: 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  {.#ifdef SQLITE_
6640: 44 45 42 55 47 0a 20 20 20 20 69 36 34 20 6e 45  DEBUG.    i64 nE
6650: 78 70 65 63 74 20 3d 20 70 53 6f 72 74 65 72 2d  xpect = pSorter-
6660: 3e 69 57 72 69 74 65 4f 66 66 0a 20 20 20 20 20  >iWriteOff.     
6670: 20 20 20 20 20 20 20 20 20 20 20 2b 20 73 71 6c             + sql
6680: 69 74 65 33 56 61 72 69 6e 74 4c 65 6e 28 70 53  ite3VarintLen(pS
6690: 6f 72 74 65 72 2d 3e 6e 49 6e 4d 65 6d 6f 72 79  orter->nInMemory
66a0: 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ).              
66b0: 20 20 2b 20 70 53 6f 72 74 65 72 2d 3e 6e 49 6e    + pSorter->nIn
66c0: 4d 65 6d 6f 72 79 3b 0a 23 65 6e 64 69 66 0a 20  Memory;.#endif. 
66d0: 20 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72 74     rc = vdbeSort
66e0: 65 72 4c 69 73 74 54 6f 50 4d 41 28 64 62 2c 20  erListToPMA(db, 
66f0: 70 43 73 72 29 3b 0a 20 20 20 20 70 53 6f 72 74  pCsr);.    pSort
6700: 65 72 2d 3e 6e 49 6e 4d 65 6d 6f 72 79 20 3d 20  er->nInMemory = 
6710: 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72  0;.    assert( r
6720: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20  c!=SQLITE_OK || 
6730: 28 6e 45 78 70 65 63 74 3d 3d 70 53 6f 72 74 65  (nExpect==pSorte
6740: 72 2d 3e 69 57 72 69 74 65 4f 66 66 29 20 29 3b  r->iWriteOff) );
6750: 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72  .  }..  return r
6760: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 48 65 6c 70  c;.}../*.** Help
6770: 65 72 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20  er function for 
6780: 73 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65  sqlite3VdbeSorte
6790: 72 52 65 77 69 6e 64 28 29 2e 20 0a 2a 2f 0a 73  rRewind(). .*/.s
67a0: 74 61 74 69 63 20 69 6e 74 20 76 64 62 65 53 6f  tatic int vdbeSo
67b0: 72 74 65 72 49 6e 69 74 4d 65 72 67 65 28 0a 20  rterInitMerge(. 
67c0: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20   sqlite3 *db,   
67d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
67e0: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e   /* Database han
67f0: 64 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 56  dle */.  const V
6800: 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 2c  dbeCursor *pCsr,
6810: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 73           /* Curs
6820: 6f 72 20 68 61 6e 64 6c 65 20 66 6f 72 20 74 68  or handle for th
6830: 69 73 20 73 6f 72 74 65 72 20 2a 2f 0a 20 20 69  is sorter */.  i
6840: 36 34 20 2a 70 6e 42 79 74 65 20 20 20 20 20 20  64 *pnByte      
6850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
6860: 2a 20 53 75 6d 20 6f 66 20 62 79 74 65 73 20 69  * Sum of bytes i
6870: 6e 20 61 6c 6c 20 6f 70 65 6e 65 64 20 50 4d 41  n all opened PMA
6880: 73 20 2a 2f 0a 29 7b 0a 20 20 56 64 62 65 53 6f  s */.){.  VdbeSo
6890: 72 74 65 72 20 2a 70 53 6f 72 74 65 72 20 3d 20  rter *pSorter = 
68a0: 70 43 73 72 2d 3e 70 53 6f 72 74 65 72 3b 0a 20  pCsr->pSorter;. 
68b0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
68c0: 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20  _OK;            
68d0: 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20   /* Return code 
68e0: 2a 2f 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20  */.  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 2f 2a 20 55 73 65 64 20 74 6f 20       /* Used to 
6910: 69 74 65 72 61 74 6f 72 20 74 68 72 6f 75 67 68  iterator through
6920: 20 61 49 74 65 72 5b 5d 20 2a 2f 0a 20 20 69 36   aIter[] */.  i6
6930: 34 20 6e 42 79 74 65 20 3d 20 30 3b 20 20 20 20  4 nByte = 0;    
6940: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
6950: 20 54 6f 74 61 6c 20 62 79 74 65 73 20 69 6e 20   Total bytes in 
6960: 61 6c 6c 20 6f 70 65 6e 65 64 20 50 4d 41 73 20  all opened PMAs 
6970: 2a 2f 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c  */..  /* Initial
6980: 69 7a 65 20 74 68 65 20 69 74 65 72 61 74 6f 72  ize the iterator
6990: 73 2e 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b  s. */.  for(i=0;
69a0: 20 69 3c 53 4f 52 54 45 52 5f 4d 41 58 5f 4d 45   i<SORTER_MAX_ME
69b0: 52 47 45 5f 43 4f 55 4e 54 3b 20 69 2b 2b 29 7b  RGE_COUNT; i++){
69c0: 0a 20 20 20 20 56 64 62 65 53 6f 72 74 65 72 49  .    VdbeSorterI
69d0: 74 65 72 20 2a 70 49 74 65 72 20 3d 20 26 70 53  ter *pIter = &pS
69e0: 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b 69 5d 3b  orter->aIter[i];
69f0: 0a 20 20 20 20 72 63 20 3d 20 76 64 62 65 53 6f  .    rc = vdbeSo
6a00: 72 74 65 72 49 74 65 72 49 6e 69 74 28 64 62 2c  rterIterInit(db,
6a10: 20 70 53 6f 72 74 65 72 2c 20 70 53 6f 72 74 65   pSorter, pSorte
6a20: 72 2d 3e 69 52 65 61 64 4f 66 66 2c 20 70 49 74  r->iReadOff, pIt
6a30: 65 72 2c 20 26 6e 42 79 74 65 29 3b 0a 20 20 20  er, &nByte);.   
6a40: 20 70 53 6f 72 74 65 72 2d 3e 69 52 65 61 64 4f   pSorter->iReadO
6a50: 66 66 20 3d 20 70 49 74 65 72 2d 3e 69 45 6f 66  ff = pIter->iEof
6a60: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63  ;.    assert( rc
6a70: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70  !=SQLITE_OK || p
6a80: 53 6f 72 74 65 72 2d 3e 69 52 65 61 64 4f 66 66  Sorter->iReadOff
6a90: 3c 3d 70 53 6f 72 74 65 72 2d 3e 69 57 72 69 74  <=pSorter->iWrit
6aa0: 65 4f 66 66 20 29 3b 0a 20 20 20 20 69 66 28 20  eOff );.    if( 
6ab0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c  rc!=SQLITE_OK ||
6ac0: 20 70 53 6f 72 74 65 72 2d 3e 69 52 65 61 64 4f   pSorter->iReadO
6ad0: 66 66 3e 3d 70 53 6f 72 74 65 72 2d 3e 69 57 72  ff>=pSorter->iWr
6ae0: 69 74 65 4f 66 66 20 29 20 62 72 65 61 6b 3b 0a  iteOff ) break;.
6af0: 20 20 7d 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61    }..  /* Initia
6b00: 6c 69 7a 65 20 74 68 65 20 61 54 72 65 65 5b 5d  lize the aTree[]
6b10: 20 61 72 72 61 79 2e 20 2a 2f 0a 20 20 66 6f 72   array. */.  for
6b20: 28 69 3d 70 53 6f 72 74 65 72 2d 3e 6e 54 72 65  (i=pSorter->nTre
6b30: 65 2d 31 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f  e-1; rc==SQLITE_
6b40: 4f 4b 20 26 26 20 69 3e 30 3b 20 69 2d 2d 29 7b  OK && i>0; i--){
6b50: 0a 20 20 20 20 72 63 20 3d 20 76 64 62 65 53 6f  .    rc = vdbeSo
6b60: 72 74 65 72 44 6f 43 6f 6d 70 61 72 65 28 70 43  rterDoCompare(pC
6b70: 73 72 2c 20 69 29 3b 0a 20 20 7d 0a 0a 20 20 2a  sr, i);.  }..  *
6b80: 70 6e 42 79 74 65 20 3d 20 6e 42 79 74 65 3b 0a  pnByte = nByte;.
6b90: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
6ba0: 2f 2a 0a 2a 2a 20 4f 6e 63 65 20 74 68 65 20 73  /*.** Once the s
6bb0: 6f 72 74 65 72 20 68 61 73 20 62 65 65 6e 20 70  orter has been p
6bc0: 6f 70 75 6c 61 74 65 64 2c 20 74 68 69 73 20 66  opulated, this f
6bd0: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
6be0: 64 20 74 6f 20 70 72 65 70 61 72 65 0a 2a 2a 20  d to prepare.** 
6bf0: 66 6f 72 20 69 74 65 72 61 74 69 6e 67 20 74 68  for iterating th
6c00: 72 6f 75 67 68 20 69 74 73 20 63 6f 6e 74 65 6e  rough its conten
6c10: 74 73 20 69 6e 20 73 6f 72 74 65 64 20 6f 72 64  ts in sorted ord
6c20: 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  er..*/.int sqlit
6c30: 65 33 56 64 62 65 53 6f 72 74 65 72 52 65 77 69  e3VdbeSorterRewi
6c40: 6e 64 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  nd(sqlite3 *db, 
6c50: 63 6f 6e 73 74 20 56 64 62 65 43 75 72 73 6f 72  const VdbeCursor
6c60: 20 2a 70 43 73 72 2c 20 69 6e 74 20 2a 70 62 45   *pCsr, int *pbE
6c70: 6f 66 29 7b 0a 20 20 56 64 62 65 53 6f 72 74 65  of){.  VdbeSorte
6c80: 72 20 2a 70 53 6f 72 74 65 72 20 3d 20 70 43 73  r *pSorter = pCs
6c90: 72 2d 3e 70 53 6f 72 74 65 72 3b 0a 20 20 69 6e  r->pSorter;.  in
6ca0: 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20  t rc;           
6cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
6cc0: 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a   Return code */.
6cd0: 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a    sqlite3_file *
6ce0: 70 54 65 6d 70 32 20 3d 20 30 3b 20 20 20 20 20  pTemp2 = 0;     
6cf0: 20 20 2f 2a 20 53 65 63 6f 6e 64 20 74 65 6d 70    /* Second temp
6d00: 20 66 69 6c 65 20 74 6f 20 75 73 65 20 2a 2f 0a   file to use */.
6d10: 20 20 69 36 34 20 69 57 72 69 74 65 32 20 3d 20    i64 iWrite2 = 
6d20: 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0;              
6d30: 20 20 2f 2a 20 57 72 69 74 65 20 6f 66 66 73 65    /* Write offse
6d40: 74 20 66 6f 72 20 70 54 65 6d 70 32 20 2a 2f 0a  t for pTemp2 */.
6d50: 20 20 69 6e 74 20 6e 49 74 65 72 3b 20 20 20 20    int nIter;    
6d60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6d70: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 69    /* Number of i
6d80: 74 65 72 61 74 6f 72 73 20 75 73 65 64 20 2a 2f  terators used */
6d90: 0a 20 20 69 6e 74 20 6e 42 79 74 65 3b 20 20 20  .  int nByte;   
6da0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6db0: 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 73     /* Bytes of s
6dc0: 70 61 63 65 20 72 65 71 75 69 72 65 64 20 66 6f  pace required fo
6dd0: 72 20 61 49 74 65 72 2f 61 54 72 65 65 20 2a 2f  r aIter/aTree */
6de0: 0a 20 20 69 6e 74 20 4e 20 3d 20 32 3b 20 20 20  .  int N = 2;   
6df0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6e00: 20 20 20 2f 2a 20 50 6f 77 65 72 20 6f 66 20 32     /* Power of 2
6e10: 20 3e 3d 20 6e 49 74 65 72 20 2a 2f 0a 0a 20 20   >= nIter */..  
6e20: 61 73 73 65 72 74 28 20 70 53 6f 72 74 65 72 20  assert( pSorter 
6e30: 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 6e 6f 20 64  );..  /* If no d
6e40: 61 74 61 20 68 61 73 20 62 65 65 6e 20 77 72 69  ata has been wri
6e50: 74 74 65 6e 20 74 6f 20 64 69 73 6b 2c 20 74 68  tten to disk, th
6e60: 65 6e 20 64 6f 20 6e 6f 74 20 64 6f 20 73 6f 20  en do not do so 
6e70: 6e 6f 77 2e 20 49 6e 73 74 65 61 64 2c 0a 20 20  now. Instead,.  
6e80: 2a 2a 20 73 6f 72 74 20 74 68 65 20 56 64 62 65  ** sort the Vdbe
6e90: 53 6f 72 74 65 72 2e 70 52 65 63 6f 72 64 20 6c  Sorter.pRecord l
6ea0: 69 73 74 2e 20 54 68 65 20 76 64 62 65 20 6c 61  ist. The vdbe la
6eb0: 79 65 72 20 77 69 6c 6c 20 72 65 61 64 20 64 61  yer will read da
6ec0: 74 61 20 64 69 72 65 63 74 6c 79 0a 20 20 2a 2a  ta directly.  **
6ed0: 20 66 72 6f 6d 20 74 68 65 20 69 6e 2d 6d 65 6d   from the in-mem
6ee0: 6f 72 79 20 6c 69 73 74 2e 20 20 2a 2f 0a 20 20  ory list.  */.  
6ef0: 69 66 28 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d  if( pSorter->nPM
6f00: 41 3d 3d 30 20 29 7b 0a 20 20 20 20 2a 70 62 45  A==0 ){.    *pbE
6f10: 6f 66 20 3d 20 21 70 53 6f 72 74 65 72 2d 3e 70  of = !pSorter->p
6f20: 52 65 63 6f 72 64 3b 0a 20 20 20 20 61 73 73 65  Record;.    asse
6f30: 72 74 28 20 70 53 6f 72 74 65 72 2d 3e 61 54 72  rt( pSorter->aTr
6f40: 65 65 3d 3d 30 20 29 3b 0a 20 20 20 20 72 65 74  ee==0 );.    ret
6f50: 75 72 6e 20 76 64 62 65 53 6f 72 74 65 72 53 6f  urn vdbeSorterSo
6f60: 72 74 28 70 43 73 72 29 3b 0a 20 20 7d 0a 0a 20  rt(pCsr);.  }.. 
6f70: 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 63 75   /* Write the cu
6f80: 72 72 65 6e 74 20 69 6e 2d 6d 65 6d 6f 72 79 20  rrent in-memory 
6f90: 6c 69 73 74 20 74 6f 20 61 20 50 4d 41 2e 20 2a  list to a PMA. *
6fa0: 2f 0a 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72  /.  rc = vdbeSor
6fb0: 74 65 72 4c 69 73 74 54 6f 50 4d 41 28 64 62 2c  terListToPMA(db,
6fc0: 20 70 43 73 72 29 3b 0a 20 20 69 66 28 20 72 63   pCsr);.  if( rc
6fd0: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65  !=SQLITE_OK ) re
6fe0: 74 75 72 6e 20 72 63 3b 0a 0a 20 20 2f 2a 20 41  turn rc;..  /* A
6ff0: 6c 6c 6f 63 61 74 65 20 73 70 61 63 65 20 66 6f  llocate space fo
7000: 72 20 61 49 74 65 72 5b 5d 20 61 6e 64 20 61 54  r aIter[] and aT
7010: 72 65 65 5b 5d 2e 20 2a 2f 0a 20 20 6e 49 74 65  ree[]. */.  nIte
7020: 72 20 3d 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d  r = pSorter->nPM
7030: 41 3b 0a 20 20 69 66 28 20 6e 49 74 65 72 3e 53  A;.  if( nIter>S
7040: 4f 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f  ORTER_MAX_MERGE_
7050: 43 4f 55 4e 54 20 29 20 6e 49 74 65 72 20 3d 20  COUNT ) nIter = 
7060: 53 4f 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45  SORTER_MAX_MERGE
7070: 5f 43 4f 55 4e 54 3b 0a 20 20 61 73 73 65 72 74  _COUNT;.  assert
7080: 28 20 6e 49 74 65 72 3e 30 20 29 3b 0a 20 20 77  ( nIter>0 );.  w
7090: 68 69 6c 65 28 20 4e 3c 6e 49 74 65 72 20 29 20  hile( N<nIter ) 
70a0: 4e 20 2b 3d 20 4e 3b 0a 20 20 6e 42 79 74 65 20  N += N;.  nByte 
70b0: 3d 20 4e 20 2a 20 28 73 69 7a 65 6f 66 28 69 6e  = N * (sizeof(in
70c0: 74 29 20 2b 20 73 69 7a 65 6f 66 28 56 64 62 65  t) + sizeof(Vdbe
70d0: 53 6f 72 74 65 72 49 74 65 72 29 29 3b 0a 20 20  SorterIter));.  
70e0: 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 20 3d  pSorter->aIter =
70f0: 20 28 56 64 62 65 53 6f 72 74 65 72 49 74 65 72   (VdbeSorterIter
7100: 20 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c   *)sqlite3DbMall
7110: 6f 63 5a 65 72 6f 28 64 62 2c 20 6e 42 79 74 65  ocZero(db, nByte
7120: 29 3b 0a 20 20 69 66 28 20 21 70 53 6f 72 74 65  );.  if( !pSorte
7130: 72 2d 3e 61 49 74 65 72 20 29 20 72 65 74 75 72  r->aIter ) retur
7140: 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  n SQLITE_NOMEM;.
7150: 20 20 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65    pSorter->aTree
7160: 20 3d 20 28 69 6e 74 20 2a 29 26 70 53 6f 72 74   = (int *)&pSort
7170: 65 72 2d 3e 61 49 74 65 72 5b 4e 5d 3b 0a 20 20  er->aIter[N];.  
7180: 70 53 6f 72 74 65 72 2d 3e 6e 54 72 65 65 20 3d  pSorter->nTree =
7190: 20 4e 3b 0a 0a 20 20 64 6f 20 7b 0a 20 20 20 20   N;..  do {.    
71a0: 69 6e 74 20 69 4e 65 77 3b 20 20 20 20 20 20 20  int iNew;       
71b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
71c0: 20 49 6e 64 65 78 20 6f 66 20 6e 65 77 2c 20 6d   Index of new, m
71d0: 65 72 67 65 64 2c 20 50 4d 41 20 2a 2f 0a 0a 20  erged, PMA */.. 
71e0: 20 20 20 66 6f 72 28 69 4e 65 77 3d 30 3b 20 0a     for(iNew=0; .
71f0: 20 20 20 20 20 20 20 20 72 63 3d 3d 53 51 4c 49          rc==SQLI
7200: 54 45 5f 4f 4b 20 26 26 20 69 4e 65 77 2a 53 4f  TE_OK && iNew*SO
7210: 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f 43  RTER_MAX_MERGE_C
7220: 4f 55 4e 54 3c 70 53 6f 72 74 65 72 2d 3e 6e 50  OUNT<pSorter->nP
7230: 4d 41 3b 20 0a 20 20 20 20 20 20 20 20 69 4e 65  MA; .        iNe
7240: 77 2b 2b 0a 20 20 20 20 29 7b 0a 20 20 20 20 20  w++.    ){.     
7250: 20 69 6e 74 20 72 63 32 3b 20 20 20 20 20 20 20   int rc2;       
7260: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
7270: 52 65 74 75 72 6e 20 63 6f 64 65 20 66 72 6f 6d  Return code from
7280: 20 66 69 6c 65 57 72 69 74 65 72 46 69 6e 69 73   fileWriterFinis
7290: 68 28 29 20 2a 2f 0a 20 20 20 20 20 20 46 69 6c  h() */.      Fil
72a0: 65 57 72 69 74 65 72 20 77 72 69 74 65 72 3b 20  eWriter writer; 
72b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 62 6a 65           /* Obje
72c0: 63 74 20 75 73 65 64 20 74 6f 20 77 72 69 74 65  ct used to write
72d0: 20 74 6f 20 64 69 73 6b 20 2a 2f 0a 20 20 20 20   to disk */.    
72e0: 20 20 69 36 34 20 6e 57 72 69 74 65 3b 20 20 20    i64 nWrite;   
72f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
7300: 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   Number of bytes
7310: 20 69 6e 20 6e 65 77 20 50 4d 41 20 2a 2f 0a 0a   in new PMA */..
7320: 20 20 20 20 20 20 6d 65 6d 73 65 74 28 26 77 72        memset(&wr
7330: 69 74 65 72 2c 20 30 2c 20 73 69 7a 65 6f 66 28  iter, 0, sizeof(
7340: 46 69 6c 65 57 72 69 74 65 72 29 29 3b 0a 0a 20  FileWriter));.. 
7350: 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65       /* If there
7360: 20 61 72 65 20 53 4f 52 54 45 52 5f 4d 41 58 5f   are SORTER_MAX_
7370: 4d 45 52 47 45 5f 43 4f 55 4e 54 20 6f 72 20 6c  MERGE_COUNT or l
7380: 65 73 73 20 50 4d 41 73 20 69 6e 20 66 69 6c 65  ess PMAs in file
7390: 20 70 54 65 6d 70 31 2c 0a 20 20 20 20 20 20 2a   pTemp1,.      *
73a0: 2a 20 69 6e 69 74 69 61 6c 69 7a 65 20 61 6e 20  * initialize an 
73b0: 69 74 65 72 61 74 6f 72 20 66 6f 72 20 65 61 63  iterator for eac
73c0: 68 20 6f 66 20 74 68 65 6d 20 61 6e 64 20 62 72  h of them and br
73d0: 65 61 6b 20 6f 75 74 20 6f 66 20 74 68 65 20 6c  eak out of the l
73e0: 6f 6f 70 2e 0a 20 20 20 20 20 20 2a 2a 20 54 68  oop..      ** Th
73f0: 65 73 65 20 69 74 65 72 61 74 6f 72 73 20 77 69  ese iterators wi
7400: 6c 6c 20 62 65 20 69 6e 63 72 65 6d 65 6e 74 61  ll be incrementa
7410: 6c 6c 79 20 6d 65 72 67 65 64 20 61 73 20 74 68  lly merged as th
7420: 65 20 56 44 42 45 20 6c 61 79 65 72 20 63 61 6c  e VDBE layer cal
7430: 6c 73 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69  ls.      ** sqli
7440: 74 65 33 56 64 62 65 53 6f 72 74 65 72 4e 65 78  te3VdbeSorterNex
7450: 74 28 29 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20  t()..      **.  
7460: 20 20 20 20 2a 2a 20 4f 74 68 65 72 77 69 73 65      ** Otherwise
7470: 2c 20 69 66 20 70 54 65 6d 70 31 20 63 6f 6e 74  , if pTemp1 cont
7480: 61 69 6e 73 20 6d 6f 72 65 20 74 68 61 6e 20 53  ains more than S
7490: 4f 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f  ORTER_MAX_MERGE_
74a0: 43 4f 55 4e 54 20 50 4d 41 73 2c 0a 20 20 20 20  COUNT PMAs,.    
74b0: 20 20 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 65 20    ** initialize 
74c0: 69 6e 74 65 72 61 74 6f 72 73 20 66 6f 72 20 53  interators for S
74d0: 4f 52 54 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f  ORTER_MAX_MERGE_
74e0: 43 4f 55 4e 54 20 6f 66 20 74 68 65 6d 2e 20 54  COUNT of them. T
74f0: 68 65 73 65 20 50 4d 41 73 0a 20 20 20 20 20 20  hese PMAs.      
7500: 2a 2a 20 61 72 65 20 6d 65 72 67 65 64 20 69 6e  ** are merged in
7510: 74 6f 20 61 20 73 69 6e 67 6c 65 20 50 4d 41 20  to a single PMA 
7520: 74 68 61 74 20 69 73 20 77 72 69 74 74 65 6e 20  that is written 
7530: 74 6f 20 66 69 6c 65 20 70 54 65 6d 70 32 2e 0a  to file pTemp2..
7540: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72        */.      r
7550: 63 20 3d 20 76 64 62 65 53 6f 72 74 65 72 49 6e  c = vdbeSorterIn
7560: 69 74 4d 65 72 67 65 28 64 62 2c 20 70 43 73 72  itMerge(db, pCsr
7570: 2c 20 26 6e 57 72 69 74 65 29 3b 0a 20 20 20 20  , &nWrite);.    
7580: 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51    assert( rc!=SQ
7590: 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 53 6f 72 74  LITE_OK || pSort
75a0: 65 72 2d 3e 61 49 74 65 72 5b 20 70 53 6f 72 74  er->aIter[ pSort
75b0: 65 72 2d 3e 61 54 72 65 65 5b 31 5d 20 5d 2e 70  er->aTree[1] ].p
75c0: 46 69 6c 65 20 29 3b 0a 20 20 20 20 20 20 69 66  File );.      if
75d0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
75e0: 7c 7c 20 70 53 6f 72 74 65 72 2d 3e 6e 50 4d 41  || pSorter->nPMA
75f0: 3c 3d 53 4f 52 54 45 52 5f 4d 41 58 5f 4d 45 52  <=SORTER_MAX_MER
7600: 47 45 5f 43 4f 55 4e 54 20 29 7b 0a 20 20 20 20  GE_COUNT ){.    
7610: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
7620: 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 4f 70 65   }..      /* Ope
7630: 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 74 65 6d  n the second tem
7640: 70 20 66 69 6c 65 2c 20 69 66 20 69 74 20 69 73  p file, if it is
7650: 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 65   not already ope
7660: 6e 2e 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20  n. */.      if( 
7670: 70 54 65 6d 70 32 3d 3d 30 20 29 7b 0a 20 20 20  pTemp2==0 ){.   
7680: 20 20 20 20 20 61 73 73 65 72 74 28 20 69 57 72       assert( iWr
7690: 69 74 65 32 3d 3d 30 20 29 3b 0a 20 20 20 20 20  ite2==0 );.     
76a0: 20 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72 74     rc = vdbeSort
76b0: 65 72 4f 70 65 6e 54 65 6d 70 46 69 6c 65 28 64  erOpenTempFile(d
76c0: 62 2c 20 26 70 54 65 6d 70 32 29 3b 0a 20 20 20  b, &pTemp2);.   
76d0: 20 20 20 7d 0a 0a 20 20 20 20 20 20 69 66 28 20     }..      if( 
76e0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
76f0: 0a 20 20 20 20 20 20 20 20 69 6e 74 20 62 45 6f  .        int bEo
7700: 66 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 66  f = 0;.        f
7710: 69 6c 65 57 72 69 74 65 72 49 6e 69 74 28 64 62  ileWriterInit(db
7720: 2c 20 70 54 65 6d 70 32 2c 20 26 77 72 69 74 65  , pTemp2, &write
7730: 72 2c 20 69 57 72 69 74 65 32 29 3b 0a 20 20 20  r, iWrite2);.   
7740: 20 20 20 20 20 66 69 6c 65 57 72 69 74 65 72 57       fileWriterW
7750: 72 69 74 65 56 61 72 69 6e 74 28 26 77 72 69 74  riteVarint(&writ
7760: 65 72 2c 20 6e 57 72 69 74 65 29 3b 0a 20 20 20  er, nWrite);.   
7770: 20 20 20 20 20 77 68 69 6c 65 28 20 72 63 3d 3d       while( rc==
7780: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 62 45 6f  SQLITE_OK && bEo
7790: 66 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  f==0 ){.        
77a0: 20 20 56 64 62 65 53 6f 72 74 65 72 49 74 65 72    VdbeSorterIter
77b0: 20 2a 70 49 74 65 72 20 3d 20 26 70 53 6f 72 74   *pIter = &pSort
77c0: 65 72 2d 3e 61 49 74 65 72 5b 20 70 53 6f 72 74  er->aIter[ pSort
77d0: 65 72 2d 3e 61 54 72 65 65 5b 31 5d 20 5d 3b 0a  er->aTree[1] ];.
77e0: 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74            assert
77f0: 28 20 70 49 74 65 72 2d 3e 70 46 69 6c 65 20 29  ( pIter->pFile )
7800: 3b 0a 0a 20 20 20 20 20 20 20 20 20 20 66 69 6c  ;..          fil
7810: 65 57 72 69 74 65 72 57 72 69 74 65 56 61 72 69  eWriterWriteVari
7820: 6e 74 28 26 77 72 69 74 65 72 2c 20 70 49 74 65  nt(&writer, pIte
7830: 72 2d 3e 6e 4b 65 79 29 3b 0a 20 20 20 20 20 20  r->nKey);.      
7840: 20 20 20 20 66 69 6c 65 57 72 69 74 65 72 57 72      fileWriterWr
7850: 69 74 65 28 26 77 72 69 74 65 72 2c 20 70 49 74  ite(&writer, pIt
7860: 65 72 2d 3e 61 4b 65 79 2c 20 70 49 74 65 72 2d  er->aKey, pIter-
7870: 3e 6e 4b 65 79 29 3b 0a 20 20 20 20 20 20 20 20  >nKey);.        
7880: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64    rc = sqlite3Vd
7890: 62 65 53 6f 72 74 65 72 4e 65 78 74 28 64 62 2c  beSorterNext(db,
78a0: 20 70 43 73 72 2c 20 26 62 45 6f 66 29 3b 0a 20   pCsr, &bEof);. 
78b0: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20         }.       
78c0: 20 72 63 32 20 3d 20 66 69 6c 65 57 72 69 74 65   rc2 = fileWrite
78d0: 72 46 69 6e 69 73 68 28 64 62 2c 20 26 77 72 69  rFinish(db, &wri
78e0: 74 65 72 2c 20 26 69 57 72 69 74 65 32 29 3b 0a  ter, &iWrite2);.
78f0: 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d          if( rc==
7900: 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20 3d  SQLITE_OK ) rc =
7910: 20 72 63 32 3b 0a 20 20 20 20 20 20 7d 0a 20 20   rc2;.      }.  
7920: 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 70 53 6f    }..    if( pSo
7930: 72 74 65 72 2d 3e 6e 50 4d 41 3c 3d 53 4f 52 54  rter->nPMA<=SORT
7940: 45 52 5f 4d 41 58 5f 4d 45 52 47 45 5f 43 4f 55  ER_MAX_MERGE_COU
7950: 4e 54 20 29 7b 0a 20 20 20 20 20 20 62 72 65 61  NT ){.      brea
7960: 6b 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  k;.    }else{.  
7970: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65      sqlite3_file
7980: 20 2a 70 54 6d 70 20 3d 20 70 53 6f 72 74 65 72   *pTmp = pSorter
7990: 2d 3e 70 54 65 6d 70 31 3b 0a 20 20 20 20 20 20  ->pTemp1;.      
79a0: 70 53 6f 72 74 65 72 2d 3e 6e 50 4d 41 20 3d 20  pSorter->nPMA = 
79b0: 69 4e 65 77 3b 0a 20 20 20 20 20 20 70 53 6f 72  iNew;.      pSor
79c0: 74 65 72 2d 3e 70 54 65 6d 70 31 20 3d 20 70 54  ter->pTemp1 = pT
79d0: 65 6d 70 32 3b 0a 20 20 20 20 20 20 70 54 65 6d  emp2;.      pTem
79e0: 70 32 20 3d 20 70 54 6d 70 3b 0a 20 20 20 20 20  p2 = pTmp;.     
79f0: 20 70 53 6f 72 74 65 72 2d 3e 69 57 72 69 74 65   pSorter->iWrite
7a00: 4f 66 66 20 3d 20 69 57 72 69 74 65 32 3b 0a 20  Off = iWrite2;. 
7a10: 20 20 20 20 20 70 53 6f 72 74 65 72 2d 3e 69 52       pSorter->iR
7a20: 65 61 64 4f 66 66 20 3d 20 30 3b 0a 20 20 20 20  eadOff = 0;.    
7a30: 20 20 69 57 72 69 74 65 32 20 3d 20 30 3b 0a 20    iWrite2 = 0;. 
7a40: 20 20 20 7d 0a 20 20 7d 77 68 69 6c 65 28 20 72     }.  }while( r
7a50: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a  c==SQLITE_OK );.
7a60: 0a 20 20 69 66 28 20 70 54 65 6d 70 32 20 29 7b  .  if( pTemp2 ){
7a70: 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c  .    sqlite3OsCl
7a80: 6f 73 65 46 72 65 65 28 70 54 65 6d 70 32 29 3b  oseFree(pTemp2);
7a90: 0a 20 20 7d 0a 20 20 2a 70 62 45 6f 66 20 3d 20  .  }.  *pbEof = 
7aa0: 28 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b  (pSorter->aIter[
7ab0: 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 31  pSorter->aTree[1
7ac0: 5d 5d 2e 70 46 69 6c 65 3d 3d 30 29 3b 0a 20 20  ]].pFile==0);.  
7ad0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
7ae0: 0a 2a 2a 20 41 64 76 61 6e 63 65 20 74 6f 20 74  .** Advance to t
7af0: 68 65 20 6e 65 78 74 20 65 6c 65 6d 65 6e 74 20  he next element 
7b00: 69 6e 20 74 68 65 20 73 6f 72 74 65 72 2e 0a 2a  in the sorter..*
7b10: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
7b20: 65 53 6f 72 74 65 72 4e 65 78 74 28 73 71 6c 69  eSorterNext(sqli
7b30: 74 65 33 20 2a 64 62 2c 20 63 6f 6e 73 74 20 56  te3 *db, const V
7b40: 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72 2c  dbeCursor *pCsr,
7b50: 20 69 6e 74 20 2a 70 62 45 6f 66 29 7b 0a 20 20   int *pbEof){.  
7b60: 56 64 62 65 53 6f 72 74 65 72 20 2a 70 53 6f 72  VdbeSorter *pSor
7b70: 74 65 72 20 3d 20 70 43 73 72 2d 3e 70 53 6f 72  ter = pCsr->pSor
7b80: 74 65 72 3b 0a 20 20 69 6e 74 20 72 63 3b 20 20  ter;.  int rc;  
7b90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7ba0: 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e         /* Return
7bb0: 20 63 6f 64 65 20 2a 2f 0a 0a 20 20 69 66 28 20   code */..  if( 
7bc0: 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 20 29  pSorter->aTree )
7bd0: 7b 0a 20 20 20 20 69 6e 74 20 69 50 72 65 76 20  {.    int iPrev 
7be0: 3d 20 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65  = pSorter->aTree
7bf0: 5b 31 5d 3b 2f 2a 20 49 6e 64 65 78 20 6f 66 20  [1];/* Index of 
7c00: 69 74 65 72 61 74 6f 72 20 74 6f 20 61 64 76 61  iterator to adva
7c10: 6e 63 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69  nce */.    int i
7c20: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
7c30: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65           /* Inde
7c40: 78 20 6f 66 20 61 54 72 65 65 5b 5d 20 74 6f 20  x of aTree[] to 
7c50: 72 65 63 61 6c 63 75 6c 61 74 65 20 2a 2f 0a 0a  recalculate */..
7c60: 20 20 20 20 72 63 20 3d 20 76 64 62 65 53 6f 72      rc = vdbeSor
7c70: 74 65 72 49 74 65 72 4e 65 78 74 28 64 62 2c 20  terIterNext(db, 
7c80: 26 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b  &pSorter->aIter[
7c90: 69 50 72 65 76 5d 29 3b 0a 20 20 20 20 66 6f 72  iPrev]);.    for
7ca0: 28 69 3d 28 70 53 6f 72 74 65 72 2d 3e 6e 54 72  (i=(pSorter->nTr
7cb0: 65 65 2b 69 50 72 65 76 29 2f 32 3b 20 72 63 3d  ee+iPrev)/2; rc=
7cc0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3e  =SQLITE_OK && i>
7cd0: 30 3b 20 69 3d 69 2f 32 29 7b 0a 20 20 20 20 20  0; i=i/2){.     
7ce0: 20 72 63 20 3d 20 76 64 62 65 53 6f 72 74 65 72   rc = vdbeSorter
7cf0: 44 6f 43 6f 6d 70 61 72 65 28 70 43 73 72 2c 20  DoCompare(pCsr, 
7d00: 69 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2a  i);.    }..    *
7d10: 70 62 45 6f 66 20 3d 20 28 70 53 6f 72 74 65 72  pbEof = (pSorter
7d20: 2d 3e 61 49 74 65 72 5b 70 53 6f 72 74 65 72 2d  ->aIter[pSorter-
7d30: 3e 61 54 72 65 65 5b 31 5d 5d 2e 70 46 69 6c 65  >aTree[1]].pFile
7d40: 3d 3d 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  ==0);.  }else{. 
7d50: 20 20 20 53 6f 72 74 65 72 52 65 63 6f 72 64 20     SorterRecord 
7d60: 2a 70 46 72 65 65 20 3d 20 70 53 6f 72 74 65 72  *pFree = pSorter
7d70: 2d 3e 70 52 65 63 6f 72 64 3b 0a 20 20 20 20 70  ->pRecord;.    p
7d80: 53 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 20  Sorter->pRecord 
7d90: 3d 20 70 46 72 65 65 2d 3e 70 4e 65 78 74 3b 0a  = pFree->pNext;.
7da0: 20 20 20 20 70 46 72 65 65 2d 3e 70 4e 65 78 74      pFree->pNext
7db0: 20 3d 20 30 3b 0a 20 20 20 20 76 64 62 65 53 6f   = 0;.    vdbeSo
7dc0: 72 74 65 72 52 65 63 6f 72 64 46 72 65 65 28 64  rterRecordFree(d
7dd0: 62 2c 20 70 46 72 65 65 29 3b 0a 20 20 20 20 2a  b, pFree);.    *
7de0: 70 62 45 6f 66 20 3d 20 21 70 53 6f 72 74 65 72  pbEof = !pSorter
7df0: 2d 3e 70 52 65 63 6f 72 64 3b 0a 20 20 20 20 72  ->pRecord;.    r
7e00: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
7e10: 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a   }.  return rc;.
7e20: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
7e30: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 62  a pointer to a b
7e40: 75 66 66 65 72 20 6f 77 6e 65 64 20 62 79 20 74  uffer owned by t
7e50: 68 65 20 73 6f 72 74 65 72 20 74 68 61 74 20 63  he sorter that c
7e60: 6f 6e 74 61 69 6e 73 20 74 68 65 20 0a 2a 2a 20  ontains the .** 
7e70: 63 75 72 72 65 6e 74 20 6b 65 79 2e 0a 2a 2f 0a  current key..*/.
7e80: 73 74 61 74 69 63 20 76 6f 69 64 20 2a 76 64 62  static void *vdb
7e90: 65 53 6f 72 74 65 72 52 6f 77 6b 65 79 28 0a 20  eSorterRowkey(. 
7ea0: 20 63 6f 6e 73 74 20 56 64 62 65 53 6f 72 74 65   const VdbeSorte
7eb0: 72 20 2a 70 53 6f 72 74 65 72 2c 20 20 20 20 20  r *pSorter,     
7ec0: 20 2f 2a 20 53 6f 72 74 65 72 20 6f 62 6a 65 63   /* Sorter objec
7ed0: 74 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 4b 65  t */.  int *pnKe
7ee0: 79 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  y               
7ef0: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 53         /* OUT: S
7f00: 69 7a 65 20 6f 66 20 63 75 72 72 65 6e 74 20 6b  ize of current k
7f10: 65 79 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a 29  ey in bytes */.)
7f20: 7b 0a 20 20 76 6f 69 64 20 2a 70 4b 65 79 3b 0a  {.  void *pKey;.
7f30: 20 20 69 66 28 20 70 53 6f 72 74 65 72 2d 3e 61    if( pSorter->a
7f40: 54 72 65 65 20 29 7b 0a 20 20 20 20 56 64 62 65  Tree ){.    Vdbe
7f50: 53 6f 72 74 65 72 49 74 65 72 20 2a 70 49 74 65  SorterIter *pIte
7f60: 72 3b 0a 20 20 20 20 70 49 74 65 72 20 3d 20 26  r;.    pIter = &
7f70: 70 53 6f 72 74 65 72 2d 3e 61 49 74 65 72 5b 20  pSorter->aIter[ 
7f80: 70 53 6f 72 74 65 72 2d 3e 61 54 72 65 65 5b 31  pSorter->aTree[1
7f90: 5d 20 5d 3b 0a 20 20 20 20 2a 70 6e 4b 65 79 20  ] ];.    *pnKey 
7fa0: 3d 20 70 49 74 65 72 2d 3e 6e 4b 65 79 3b 0a 20  = pIter->nKey;. 
7fb0: 20 20 20 70 4b 65 79 20 3d 20 70 49 74 65 72 2d     pKey = pIter-
7fc0: 3e 61 4b 65 79 3b 0a 20 20 7d 65 6c 73 65 7b 0a  >aKey;.  }else{.
7fd0: 20 20 20 20 2a 70 6e 4b 65 79 20 3d 20 70 53 6f      *pnKey = pSo
7fe0: 72 74 65 72 2d 3e 70 52 65 63 6f 72 64 2d 3e 6e  rter->pRecord->n
7ff0: 56 61 6c 3b 0a 20 20 20 20 70 4b 65 79 20 3d 20  Val;.    pKey = 
8000: 70 53 6f 72 74 65 72 2d 3e 70 52 65 63 6f 72 64  pSorter->pRecord
8010: 2d 3e 70 56 61 6c 3b 0a 20 20 7d 0a 20 20 72 65  ->pVal;.  }.  re
8020: 74 75 72 6e 20 70 4b 65 79 3b 0a 7d 0a 0a 2f 2a  turn pKey;.}../*
8030: 0a 2a 2a 20 43 6f 70 79 20 74 68 65 20 63 75 72  .** Copy the cur
8040: 72 65 6e 74 20 73 6f 72 74 65 72 20 6b 65 79 20  rent sorter key 
8050: 69 6e 74 6f 20 74 68 65 20 6d 65 6d 6f 72 79 20  into the memory 
8060: 63 65 6c 6c 20 70 4f 75 74 2e 0a 2a 2f 0a 69 6e  cell pOut..*/.in
8070: 74 20 73 71 6c 69 74 65 33 56 64 62 65 53 6f 72  t sqlite3VdbeSor
8080: 74 65 72 52 6f 77 6b 65 79 28 63 6f 6e 73 74 20  terRowkey(const 
8090: 56 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73 72  VdbeCursor *pCsr
80a0: 2c 20 4d 65 6d 20 2a 70 4f 75 74 29 7b 0a 20 20  , Mem *pOut){.  
80b0: 56 64 62 65 53 6f 72 74 65 72 20 2a 70 53 6f 72  VdbeSorter *pSor
80c0: 74 65 72 20 3d 20 70 43 73 72 2d 3e 70 53 6f 72  ter = pCsr->pSor
80d0: 74 65 72 3b 0a 20 20 76 6f 69 64 20 2a 70 4b 65  ter;.  void *pKe
80e0: 79 3b 20 69 6e 74 20 6e 4b 65 79 3b 20 20 20 20  y; int nKey;    
80f0: 20 20 20 20 20 20 20 2f 2a 20 53 6f 72 74 65 72         /* Sorter
8100: 20 6b 65 79 20 74 6f 20 63 6f 70 79 20 69 6e 74   key to copy int
8110: 6f 20 70 4f 75 74 20 2a 2f 0a 0a 20 20 70 4b 65  o pOut */..  pKe
8120: 79 20 3d 20 76 64 62 65 53 6f 72 74 65 72 52 6f  y = vdbeSorterRo
8130: 77 6b 65 79 28 70 53 6f 72 74 65 72 2c 20 26 6e  wkey(pSorter, &n
8140: 4b 65 79 29 3b 0a 20 20 69 66 28 20 73 71 6c 69  Key);.  if( sqli
8150: 74 65 33 56 64 62 65 4d 65 6d 47 72 6f 77 28 70  te3VdbeMemGrow(p
8160: 4f 75 74 2c 20 6e 4b 65 79 2c 20 30 29 20 29 7b  Out, nKey, 0) ){
8170: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
8180: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20  TE_NOMEM;.  }.  
8190: 70 4f 75 74 2d 3e 6e 20 3d 20 6e 4b 65 79 3b 0a  pOut->n = nKey;.
81a0: 20 20 4d 65 6d 53 65 74 54 79 70 65 46 6c 61 67    MemSetTypeFlag
81b0: 28 70 4f 75 74 2c 20 4d 45 4d 5f 42 6c 6f 62 29  (pOut, MEM_Blob)
81c0: 3b 0a 20 20 6d 65 6d 63 70 79 28 70 4f 75 74 2d  ;.  memcpy(pOut-
81d0: 3e 7a 2c 20 70 4b 65 79 2c 20 6e 4b 65 79 29 3b  >z, pKey, nKey);
81e0: 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ..  return SQLIT
81f0: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  E_OK;.}../*.** C
8200: 6f 6d 70 61 72 65 20 74 68 65 20 6b 65 79 20 69  ompare the key i
8210: 6e 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 20 70 56  n memory cell pV
8220: 61 6c 20 77 69 74 68 20 74 68 65 20 6b 65 79 20  al with the key 
8230: 74 68 61 74 20 74 68 65 20 73 6f 72 74 65 72 20  that the sorter 
8240: 63 75 72 73 6f 72 0a 2a 2a 20 70 61 73 73 65 64  cursor.** passed
8250: 20 61 73 20 74 68 65 20 66 69 72 73 74 20 61 72   as the first ar
8260: 67 75 6d 65 6e 74 20 63 75 72 72 65 6e 74 6c 79  gument currently
8270: 20 70 6f 69 6e 74 73 20 74 6f 2e 20 46 6f 72 20   points to. For 
8280: 74 68 65 20 70 75 72 70 6f 73 65 73 20 6f 66 0a  the purposes of.
8290: 2a 2a 20 74 68 65 20 63 6f 6d 70 61 72 69 73 6f  ** the compariso
82a0: 6e 2c 20 69 67 6e 6f 72 65 20 74 68 65 20 72 6f  n, ignore the ro
82b0: 77 69 64 20 66 69 65 6c 64 20 61 74 20 74 68 65  wid field at the
82c0: 20 65 6e 64 20 6f 66 20 65 61 63 68 20 72 65 63   end of each rec
82d0: 6f 72 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e  ord..**.** If an
82e0: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 72   error occurs, r
82f0: 65 74 75 72 6e 20 61 6e 20 53 51 4c 69 74 65 20  eturn an SQLite 
8300: 65 72 72 6f 72 20 63 6f 64 65 20 28 69 2e 65 2e  error code (i.e.
8310: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 2e 0a   SQLITE_NOMEM)..
8320: 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 73 65  ** Otherwise, se
8330: 74 20 2a 70 52 65 73 20 74 6f 20 61 20 6e 65 67  t *pRes to a neg
8340: 61 74 69 76 65 2c 20 7a 65 72 6f 20 6f 72 20 70  ative, zero or p
8350: 6f 73 69 74 69 76 65 20 76 61 6c 75 65 20 69 66  ositive value if
8360: 20 74 68 65 0a 2a 2a 20 6b 65 79 20 69 6e 20 70   the.** key in p
8370: 56 61 6c 20 69 73 20 73 6d 61 6c 6c 65 72 20 74  Val is smaller t
8380: 68 61 6e 2c 20 65 71 75 61 6c 20 74 6f 20 6f 72  han, equal to or
8390: 20 6c 61 72 67 65 72 20 74 68 61 6e 20 74 68 65   larger than the
83a0: 20 63 75 72 72 65 6e 74 20 73 6f 72 74 65 72 0a   current sorter.
83b0: 2a 2a 20 6b 65 79 2e 0a 2a 2f 0a 69 6e 74 20 73  ** key..*/.int s
83c0: 71 6c 69 74 65 33 56 64 62 65 53 6f 72 74 65 72  qlite3VdbeSorter
83d0: 43 6f 6d 70 61 72 65 28 0a 20 20 63 6f 6e 73 74  Compare(.  const
83e0: 20 56 64 62 65 43 75 72 73 6f 72 20 2a 70 43 73   VdbeCursor *pCs
83f0: 72 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 53 6f  r,         /* So
8400: 72 74 65 72 20 63 75 72 73 6f 72 20 2a 2f 0a 20  rter cursor */. 
8410: 20 4d 65 6d 20 2a 70 56 61 6c 2c 20 20 20 20 20   Mem *pVal,     
8420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8430: 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 63 6f 6d   /* Value to com
8440: 70 61 72 65 20 74 6f 20 63 75 72 72 65 6e 74 20  pare to current 
8450: 73 6f 72 74 65 72 20 6b 65 79 20 2a 2f 0a 20 20  sorter key */.  
8460: 69 6e 74 20 2a 70 52 65 73 20 20 20 20 20 20 20  int *pRes       
8470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8480: 2f 2a 20 4f 55 54 3a 20 52 65 73 75 6c 74 20 6f  /* OUT: Result o
8490: 66 20 63 6f 6d 70 61 72 69 73 6f 6e 20 2a 2f 0a  f comparison */.
84a0: 29 7b 0a 20 20 56 64 62 65 53 6f 72 74 65 72 20  ){.  VdbeSorter 
84b0: 2a 70 53 6f 72 74 65 72 20 3d 20 70 43 73 72 2d  *pSorter = pCsr-
84c0: 3e 70 53 6f 72 74 65 72 3b 0a 20 20 76 6f 69 64  >pSorter;.  void
84d0: 20 2a 70 4b 65 79 3b 20 69 6e 74 20 6e 4b 65 79   *pKey; int nKey
84e0: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53  ;           /* S
84f0: 6f 72 74 65 72 20 6b 65 79 20 74 6f 20 63 6f 6d  orter key to com
8500: 70 61 72 65 20 70 56 61 6c 20 77 69 74 68 20 2a  pare pVal with *
8510: 2f 0a 0a 20 20 70 4b 65 79 20 3d 20 76 64 62 65  /..  pKey = vdbe
8520: 53 6f 72 74 65 72 52 6f 77 6b 65 79 28 70 53 6f  SorterRowkey(pSo
8530: 72 74 65 72 2c 20 26 6e 4b 65 79 29 3b 0a 20 20  rter, &nKey);.  
8540: 76 64 62 65 53 6f 72 74 65 72 43 6f 6d 70 61 72  vdbeSorterCompar
8550: 65 28 70 43 73 72 2c 20 31 2c 20 70 56 61 6c 2d  e(pCsr, 1, pVal-
8560: 3e 7a 2c 20 70 56 61 6c 2d 3e 6e 2c 20 70 4b 65  >z, pVal->n, pKe
8570: 79 2c 20 6e 4b 65 79 2c 20 70 52 65 73 29 3b 0a  y, nKey, pRes);.
8580: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
8590: 4f 4b 3b 0a 7d 0a                                OK;.}.