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

Artifact ea7a08c3a87e47031bcefccde4e641914d013a99:


0000: 23 21 2f 75 73 72 2f 62 69 6e 2f 74 63 6c 73 68  #!/usr/bin/tclsh
0010: 0a 23 0a 23 20 54 6f 20 62 75 69 6c 64 20 61 20  .#.# To build a 
0020: 73 69 6e 67 6c 65 20 68 75 67 65 20 73 6f 75 72  single huge sour
0030: 63 65 20 66 69 6c 65 20 68 6f 6c 64 69 6e 67 20  ce file holding 
0040: 61 6c 6c 20 6f 66 20 53 51 4c 69 74 65 20 28 6f  all of SQLite (o
0050: 72 20 61 74 0a 23 20 6c 65 61 73 74 20 74 68 65  r at.# least the
0060: 20 63 6f 72 65 20 63 6f 6d 70 6f 6e 65 6e 74 73   core components
0070: 20 2d 20 74 68 65 20 74 65 73 74 20 68 61 72 6e   - the test harn
0080: 65 73 73 2c 20 73 68 65 6c 6c 2c 20 61 6e 64 20  ess, shell, and 
0090: 54 43 4c 20 0a 23 20 69 6e 74 65 72 66 61 63 65  TCL .# interface
00a0: 20 61 72 65 20 6f 6d 69 74 74 65 64 2e 29 20 66   are omitted.) f
00b0: 69 72 73 74 20 64 6f 0a 23 0a 23 20 20 20 20 20  irst do.#.#     
00c0: 20 6d 61 6b 65 20 74 61 72 67 65 74 5f 73 6f 75   make target_sou
00d0: 72 63 65 0a 23 0a 23 20 54 68 65 20 6d 61 6b 65  rce.#.# The make
00e0: 20 74 61 72 67 65 74 20 61 62 6f 76 65 20 6d 6f   target above mo
00f0: 76 65 73 20 61 6c 6c 20 6f 66 20 74 68 65 20 73  ves all of the s
0100: 6f 75 72 63 65 20 63 6f 64 65 20 66 69 6c 65 73  ource code files
0110: 20 69 6e 74 6f 0a 23 20 61 20 73 75 62 64 69 72   into.# a subdir
0120: 65 63 74 6f 72 79 20 6e 61 6d 65 64 20 22 74 73  ectory named "ts
0130: 72 63 22 2e 20 20 28 54 68 69 73 20 73 63 72 69  rc".  (This scri
0140: 70 74 20 65 78 70 65 63 74 73 20 74 6f 20 66 69  pt expects to fi
0150: 6e 64 20 74 68 65 20 66 69 6c 65 73 0a 23 20 74  nd the files.# t
0160: 68 65 72 65 20 61 6e 64 20 77 69 6c 6c 20 6e 6f  here and will no
0170: 74 20 77 6f 72 6b 20 69 66 20 74 68 65 79 20 61  t work if they a
0180: 72 65 20 6e 6f 74 20 66 6f 75 6e 64 2e 29 20 20  re not found.)  
0190: 54 68 65 72 65 20 61 72 65 20 61 20 66 65 77 0a  There are a few.
01a0: 23 20 67 65 6e 65 72 61 74 65 64 20 43 20 63 6f  # generated C co
01b0: 64 65 20 66 69 6c 65 73 20 74 68 61 74 20 61 72  de files that ar
01c0: 65 20 61 6c 73 6f 20 61 64 64 65 64 20 74 6f 20  e also added to 
01d0: 74 68 65 20 74 73 72 63 20 64 69 72 65 63 74 6f  the tsrc directo
01e0: 72 79 2e 0a 23 20 46 6f 72 20 65 78 61 6d 70 6c  ry..# For exampl
01f0: 65 2c 20 74 68 65 20 22 70 61 72 73 65 2e 63 22  e, the "parse.c"
0200: 20 61 6e 64 20 22 70 61 72 73 65 2e 68 22 20 66   and "parse.h" f
0210: 69 6c 65 73 20 74 6f 20 69 6d 70 6c 65 6d 65 6e  iles to implemen
0220: 74 20 74 68 65 0a 23 20 74 68 65 20 70 61 72 73  t the.# the pars
0230: 65 72 20 61 72 65 20 64 65 72 69 76 65 64 20 66  er are derived f
0240: 72 6f 6d 20 22 70 61 72 73 65 2e 79 22 20 75 73  rom "parse.y" us
0250: 69 6e 67 20 6c 65 6d 6f 6e 2e 20 20 41 6e 64 20  ing lemon.  And 
0260: 74 68 65 20 0a 23 20 22 6b 65 79 77 6f 72 64 68  the .# "keywordh
0270: 61 73 68 2e 68 22 20 66 69 6c 65 73 20 69 73 20  ash.h" files is 
0280: 67 65 6e 65 72 61 74 65 64 20 62 79 20 61 20 70  generated by a p
0290: 72 6f 67 72 61 6d 20 6e 61 6d 65 64 20 22 6d 6b  rogram named "mk
02a0: 6b 65 79 77 6f 72 64 68 61 73 68 22 2e 0a 23 0a  keywordhash"..#.
02b0: 23 20 41 66 74 65 72 20 74 68 65 20 22 74 73 72  # After the "tsr
02c0: 63 22 20 64 69 72 65 63 74 6f 72 79 20 68 61 73  c" directory has
02d0: 20 62 65 65 6e 20 63 72 65 61 74 65 64 20 61 6e   been created an
02e0: 64 20 70 6f 70 75 6c 61 74 65 64 2c 20 72 75 6e  d populated, run
02f0: 0a 23 20 74 68 69 73 20 73 63 72 69 70 74 3a 0a  .# this script:.
0300: 23 0a 23 20 20 20 20 20 20 74 63 6c 73 68 20 6d  #.#      tclsh m
0310: 6b 73 71 6c 69 74 65 33 63 2e 74 63 6c 0a 23 0a  ksqlite3c.tcl.#.
0320: 23 20 54 68 65 20 61 6d 61 6c 67 61 6d 61 74 65  # The amalgamate
0330: 64 20 53 51 4c 69 74 65 20 63 6f 64 65 20 77 69  d SQLite code wi
0340: 6c 6c 20 62 65 20 77 72 69 74 74 65 6e 20 69 6e  ll be written in
0350: 74 6f 20 73 71 6c 69 74 65 33 2e 63 0a 23 0a 0a  to sqlite3.c.#..
0360: 23 20 42 65 67 69 6e 20 62 79 20 72 65 61 64 69  # Begin by readi
0370: 6e 67 20 74 68 65 20 22 73 71 6c 69 74 65 33 2e  ng the "sqlite3.
0380: 68 22 20 68 65 61 64 65 72 20 66 69 6c 65 2e 20  h" header file. 
0390: 20 43 6f 75 6e 74 20 74 68 65 20 6e 75 6d 62 65   Count the numbe
03a0: 72 20 6f 66 20 6c 69 6e 65 73 0a 23 20 69 6e 20  r of lines.# in 
03b0: 74 68 69 73 20 66 69 6c 65 20 61 6e 64 20 65 78  this file and ex
03c0: 74 72 61 63 74 20 74 68 65 20 76 65 72 73 69 6f  tract the versio
03d0: 6e 20 6e 75 6d 62 65 72 2e 20 20 54 68 61 74 20  n number.  That 
03e0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 77 69 6c 6c  information will
03f0: 20 62 65 0a 23 20 6e 65 65 64 65 64 20 69 6e 20   be.# needed in 
0400: 6f 72 64 65 72 20 74 6f 20 67 65 6e 65 72 61 74  order to generat
0410: 65 20 74 68 65 20 68 65 61 64 65 72 20 6f 66 20  e the header of 
0420: 74 68 65 20 61 6d 61 6c 67 61 6d 61 74 69 6f 6e  the amalgamation
0430: 2e 0a 23 0a 73 65 74 20 69 6e 20 5b 6f 70 65 6e  ..#.set in [open
0440: 20 74 73 72 63 2f 73 71 6c 69 74 65 33 2e 68 5d   tsrc/sqlite3.h]
0450: 0a 73 65 74 20 63 6e 74 20 30 0a 73 65 74 20 56  .set cnt 0.set V
0460: 45 52 53 49 4f 4e 20 3f 3f 3f 3f 3f 0a 77 68 69  ERSION ?????.whi
0470: 6c 65 20 7b 21 5b 65 6f 66 20 24 69 6e 5d 7d 20  le {![eof $in]} 
0480: 7b 0a 20 20 73 65 74 20 6c 69 6e 65 20 5b 67 65  {.  set line [ge
0490: 74 73 20 24 69 6e 5d 0a 20 20 69 66 20 7b 24 6c  ts $in].  if {$l
04a0: 69 6e 65 3d 3d 22 22 20 26 26 20 5b 65 6f 66 20  ine=="" && [eof 
04b0: 24 69 6e 5d 7d 20 62 72 65 61 6b 0a 20 20 69 6e  $in]} break.  in
04c0: 63 72 20 63 6e 74 0a 20 20 72 65 67 65 78 70 20  cr cnt.  regexp 
04d0: 7b 23 64 65 66 69 6e 65 5c 73 2b 53 51 4c 49 54  {#define\s+SQLIT
04e0: 45 5f 56 45 52 53 49 4f 4e 5c 73 2b 22 28 2e 2a  E_VERSION\s+"(.*
04f0: 29 22 7d 20 24 6c 69 6e 65 20 61 6c 6c 20 56 45  )"} $line all VE
0500: 52 53 49 4f 4e 0a 7d 0a 63 6c 6f 73 65 20 24 69  RSION.}.close $i
0510: 6e 0a 0a 23 20 4f 70 65 6e 20 74 68 65 20 6f 75  n..# Open the ou
0520: 74 70 75 74 20 66 69 6c 65 20 61 6e 64 20 77 72  tput file and wr
0530: 69 74 65 20 61 20 68 65 61 64 65 72 20 63 6f 6d  ite a header com
0540: 6d 65 6e 74 20 61 74 20 74 68 65 20 62 65 67 69  ment at the begi
0550: 6e 6e 69 6e 67 0a 23 20 6f 66 20 74 68 65 20 66  nning.# of the f
0560: 69 6c 65 2e 0a 23 0a 73 65 74 20 6f 75 74 20 5b  ile..#.set out [
0570: 6f 70 65 6e 20 73 71 6c 69 74 65 33 2e 63 20 77  open sqlite3.c w
0580: 5d 0a 73 65 74 20 74 6f 64 61 79 20 5b 63 6c 6f  ].set today [clo
0590: 63 6b 20 66 6f 72 6d 61 74 20 5b 63 6c 6f 63 6b  ck format [clock
05a0: 20 73 65 63 6f 6e 64 73 5d 20 2d 66 6f 72 6d 61   seconds] -forma
05b0: 74 20 22 25 59 2d 25 6d 2d 25 64 20 25 48 3a 25  t "%Y-%m-%d %H:%
05c0: 4d 3a 25 53 20 55 54 43 22 20 2d 67 6d 74 20 31  M:%S UTC" -gmt 1
05d0: 5d 0a 70 75 74 73 20 24 6f 75 74 20 5b 73 75 62  ].puts $out [sub
05e0: 73 74 20 5c 0a 7b 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a  st \.{/*********
05f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0600: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0610: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0620: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0630: 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69  *****.** This fi
0640: 6c 65 20 69 73 20 61 6e 20 61 6d 61 6c 67 61 6d  le is an amalgam
0650: 61 74 69 6f 6e 20 6f 66 20 6d 61 6e 79 20 73 65  ation of many se
0660: 70 61 72 61 74 65 20 43 20 73 6f 75 72 63 65 20  parate C source 
0670: 66 69 6c 65 73 20 66 72 6f 6d 20 53 51 4c 69 74  files from SQLit
0680: 65 0a 2a 2a 20 76 65 72 73 69 6f 6e 20 24 56 45  e.** version $VE
0690: 52 53 49 4f 4e 2e 20 20 42 79 20 63 6f 6d 62 69  RSION.  By combi
06a0: 6e 69 6e 67 20 61 6c 6c 20 74 68 65 20 69 6e 64  ning all the ind
06b0: 69 76 69 64 75 61 6c 20 43 20 63 6f 64 65 20 66  ividual C code f
06c0: 69 6c 65 73 20 69 6e 74 6f 20 74 68 69 73 20 0a  iles into this .
06d0: 2a 2a 20 73 69 6e 67 6c 65 20 6c 61 72 67 65 20  ** single large 
06e0: 66 69 6c 65 2c 20 74 68 65 20 65 6e 74 69 72 65  file, the entire
06f0: 20 63 6f 64 65 20 63 61 6e 20 62 65 20 63 6f 6d   code can be com
0700: 70 69 6c 65 64 20 61 73 20 61 20 6f 6e 65 20 74  piled as a one t
0710: 72 61 6e 73 6c 61 74 69 6f 6e 0a 2a 2a 20 75 6e  ranslation.** un
0720: 69 74 2e 20 20 54 68 69 73 20 61 6c 6c 6f 77 73  it.  This allows
0730: 20 6d 61 6e 79 20 63 6f 6d 70 69 6c 65 72 73 20   many compilers 
0740: 74 6f 20 64 6f 20 6f 70 74 69 6d 69 7a 61 74 69  to do optimizati
0750: 6f 6e 73 20 74 68 61 74 20 77 6f 75 6c 64 20 6e  ons that would n
0760: 6f 74 20 62 65 0a 2a 2a 20 70 6f 73 73 69 62 6c  ot be.** possibl
0770: 65 20 69 66 20 74 68 65 20 66 69 6c 65 73 20 77  e if the files w
0780: 65 72 65 20 63 6f 6d 70 69 6c 65 64 20 73 65 70  ere compiled sep
0790: 61 72 61 74 65 6c 79 2e 20 20 50 65 72 66 6f 72  arately.  Perfor
07a0: 6d 61 6e 63 65 20 69 6d 70 72 6f 76 65 6d 65 6e  mance improvemen
07b0: 74 73 0a 2a 2a 20 6f 66 20 35 25 20 61 72 65 20  ts.** of 5% are 
07c0: 6d 6f 72 65 20 61 72 65 20 63 6f 6d 6d 6f 6e 6c  more are commonl
07d0: 79 20 73 65 65 6e 20 77 68 65 6e 20 53 51 4c 69  y seen when SQLi
07e0: 74 65 20 69 73 20 63 6f 6d 70 69 6c 65 64 20 61  te is compiled a
07f0: 73 20 61 20 73 69 6e 67 6c 65 0a 2a 2a 20 74 72  s a single.** tr
0800: 61 6e 73 6c 61 74 69 6f 6e 20 75 6e 69 74 2e 0a  anslation unit..
0810: 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20  **.** This file 
0820: 69 73 20 61 6c 6c 20 79 6f 75 20 6e 65 65 64 20  is all you need 
0830: 74 6f 20 63 6f 6d 70 69 6c 65 20 53 51 4c 69 74  to compile SQLit
0840: 65 2e 20 20 54 6f 20 75 73 65 20 53 51 4c 69 74  e.  To use SQLit
0850: 65 20 69 6e 20 6f 74 68 65 72 0a 2a 2a 20 70 72  e in other.** pr
0860: 6f 67 72 61 6d 73 2c 20 79 6f 75 20 6e 65 65 64  ograms, you need
0870: 20 74 68 69 73 20 66 69 6c 65 20 61 6e 64 20 74   this file and t
0880: 68 65 20 22 73 71 6c 69 74 65 33 2e 68 22 20 68  he "sqlite3.h" h
0890: 65 61 64 65 72 20 66 69 6c 65 20 74 68 61 74 20  eader file that 
08a0: 64 65 66 69 6e 65 73 0a 2a 2a 20 74 68 65 20 70  defines.** the p
08b0: 72 6f 67 72 61 6d 6d 69 6e 67 20 69 6e 74 65 72  rogramming inter
08c0: 66 61 63 65 20 74 6f 20 74 68 65 20 53 51 4c 69  face to the SQLi
08d0: 74 65 20 6c 69 62 72 61 72 79 2e 20 20 28 49 66  te library.  (If
08e0: 20 79 6f 75 20 64 6f 20 6e 6f 74 20 68 61 76 65   you do not have
08f0: 20 0a 2a 2a 20 74 68 65 20 22 73 71 6c 69 74 65   .** the "sqlite
0900: 33 2e 68 22 20 68 65 61 64 65 72 20 66 69 6c 65  3.h" header file
0910: 20 61 74 20 68 61 6e 64 2c 20 79 6f 75 20 77 69   at hand, you wi
0920: 6c 6c 20 66 69 6e 64 20 61 20 63 6f 70 79 20 69  ll find a copy i
0930: 6e 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 24  n the first.** $
0940: 63 6e 74 20 6c 69 6e 65 73 20 70 61 73 74 20 74  cnt lines past t
0950: 68 69 73 20 68 65 61 64 65 72 20 63 6f 6d 6d 65  his header comme
0960: 6e 74 2e 29 20 20 41 64 64 69 74 69 6f 6e 61 6c  nt.)  Additional
0970: 20 63 6f 64 65 20 66 69 6c 65 73 20 6d 61 79 20   code files may 
0980: 62 65 0a 2a 2a 20 6e 65 65 64 65 64 20 69 66 20  be.** needed if 
0990: 79 6f 75 20 77 61 6e 74 20 61 20 77 72 61 70 70  you want a wrapp
09a0: 65 72 20 74 6f 20 69 6e 74 65 72 66 61 63 65 20  er to interface 
09b0: 53 51 4c 69 74 65 20 77 69 74 68 20 79 6f 75 72  SQLite with your
09c0: 20 63 68 6f 69 63 65 20 6f 66 0a 2a 2a 20 70 72   choice of.** pr
09d0: 6f 67 72 61 6d 6d 69 6e 67 20 6c 61 6e 67 75 61  ogramming langua
09e0: 67 65 2e 20 20 54 68 65 20 63 6f 64 65 20 66 6f  ge.  The code fo
09f0: 72 20 74 68 65 20 22 73 71 6c 69 74 65 33 22 20  r the "sqlite3" 
0a00: 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 68 65  command-line she
0a10: 6c 6c 0a 2a 2a 20 69 73 20 61 6c 73 6f 20 69 6e  ll.** is also in
0a20: 20 61 20 73 65 70 61 72 61 74 65 20 66 69 6c 65   a separate file
0a30: 2e 20 20 54 68 69 73 20 66 69 6c 65 20 63 6f 6e  .  This file con
0a40: 74 61 69 6e 73 20 6f 6e 6c 79 20 63 6f 64 65 20  tains only code 
0a50: 66 6f 72 20 74 68 65 20 63 6f 72 65 0a 2a 2a 20  for the core.** 
0a60: 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 2e 0a  SQLite library..
0a70: 2a 2a 0a 2a 2a 20 54 68 69 73 20 61 6d 61 6c 67  **.** This amalg
0a80: 61 6d 61 74 69 6f 6e 20 77 61 73 20 67 65 6e 65  amation was gene
0a90: 72 61 74 65 64 20 6f 6e 20 24 74 6f 64 61 79 2e  rated on $today.
0aa0: 0a 2a 2f 7d 5d 0a 0a 23 20 54 68 65 73 65 20 61  .*/}]..# These a
0ab0: 72 65 20 74 68 65 20 68 65 61 64 65 72 20 66 69  re the header fi
0ac0: 6c 65 73 20 75 73 65 64 20 62 79 20 53 51 4c 69  les used by SQLi
0ad0: 74 65 2e 20 20 54 68 65 20 66 69 72 73 74 20 74  te.  The first t
0ae0: 69 6d 65 20 61 6e 79 20 6f 66 20 74 68 65 73 65  ime any of these
0af0: 20 0a 23 20 66 69 6c 65 73 20 61 72 65 20 73 65   .# files are se
0b00: 65 6e 20 69 6e 20 61 20 23 69 6e 63 6c 75 64 65  en in a #include
0b10: 20 73 74 61 74 65 6d 65 6e 74 20 69 6e 20 74 68   statement in th
0b20: 65 20 43 20 63 6f 64 65 2c 20 69 6e 63 6c 75 64  e C code, includ
0b30: 65 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 0a 23  e the complete.#
0b40: 20 74 65 78 74 20 6f 66 20 74 68 65 20 66 69 6c   text of the fil
0b50: 65 20 69 6e 2d 6c 69 6e 65 2e 20 20 54 68 65 20  e in-line.  The 
0b60: 66 69 6c 65 20 6f 6e 6c 79 20 6e 65 65 64 73 20  file only needs 
0b70: 74 6f 20 62 65 20 69 6e 63 6c 75 64 65 64 20 6f  to be included o
0b80: 6e 63 65 2e 0a 23 0a 66 6f 72 65 61 63 68 20 68  nce..#.foreach h
0b90: 64 72 20 7b 0a 20 20 20 62 74 72 65 65 2e 68 0a  dr {.   btree.h.
0ba0: 20 20 20 68 61 73 68 2e 68 0a 20 20 20 6b 65 79     hash.h.   key
0bb0: 77 6f 72 64 68 61 73 68 2e 68 0a 20 20 20 6f 70  wordhash.h.   op
0bc0: 63 6f 64 65 73 2e 68 0a 20 20 20 6f 73 5f 63 6f  codes.h.   os_co
0bd0: 6d 6d 6f 6e 2e 68 0a 20 20 20 6f 73 2e 68 0a 20  mmon.h.   os.h. 
0be0: 20 20 6f 73 5f 6f 73 32 2e 68 0a 20 20 20 70 61    os_os2.h.   pa
0bf0: 67 65 72 2e 68 0a 20 20 20 70 61 72 73 65 2e 68  ger.h.   parse.h
0c00: 0a 20 20 20 73 71 6c 69 74 65 33 65 78 74 2e 68  .   sqlite3ext.h
0c10: 0a 20 20 20 73 71 6c 69 74 65 33 2e 68 0a 20 20  .   sqlite3.h.  
0c20: 20 73 71 6c 69 74 65 49 6e 74 2e 68 0a 20 20 20   sqliteInt.h.   
0c30: 76 64 62 65 2e 68 0a 20 20 20 76 64 62 65 49 6e  vdbe.h.   vdbeIn
0c40: 74 2e 68 0a 7d 20 7b 0a 20 20 73 65 74 20 61 76  t.h.} {.  set av
0c50: 61 69 6c 61 62 6c 65 5f 68 64 72 28 24 68 64 72  ailable_hdr($hdr
0c60: 29 20 31 0a 7d 0a 73 65 74 20 61 76 61 69 6c 61  ) 1.}.set availa
0c70: 62 6c 65 5f 68 64 72 28 73 71 6c 69 74 65 33 2e  ble_hdr(sqlite3.
0c80: 68 29 20 30 0a 0a 23 20 37 38 20 73 74 61 72 73  h) 0..# 78 stars
0c90: 20 75 73 65 64 20 66 6f 72 20 63 6f 6d 6d 65 6e   used for commen
0ca0: 74 20 66 6f 72 6d 61 74 74 69 6e 67 2e 0a 73 65  t formatting..se
0cb0: 74 20 73 37 38 20 5c 0a 7b 2a 2a 2a 2a 2a 2a 2a  t s78 \.{*******
0cc0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0cd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0ce0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0cf0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0d00: 2a 2a 2a 2a 2a 2a 7d 0a 0a 23 20 49 6e 73 65 72  ******}..# Inser
0d10: 74 20 61 20 63 6f 6d 6d 65 6e 74 20 69 6e 74 6f  t a comment into
0d20: 20 74 68 65 20 63 6f 64 65 0a 23 0a 70 72 6f 63   the code.#.proc
0d30: 20 73 65 63 74 69 6f 6e 5f 63 6f 6d 6d 65 6e 74   section_comment
0d40: 20 7b 74 65 78 74 7d 20 7b 0a 20 20 67 6c 6f 62   {text} {.  glob
0d50: 61 6c 20 6f 75 74 20 73 37 38 0a 20 20 73 65 74  al out s78.  set
0d60: 20 6e 20 5b 73 74 72 69 6e 67 20 6c 65 6e 67 74   n [string lengt
0d70: 68 20 24 74 65 78 74 5d 0a 20 20 73 65 74 20 6e  h $text].  set n
0d80: 73 74 61 72 20 5b 65 78 70 72 20 7b 36 30 20 2d  star [expr {60 -
0d90: 20 24 6e 7d 5d 0a 20 20 73 65 74 20 73 74 61 72   $n}].  set star
0da0: 73 20 5b 73 74 72 69 6e 67 20 72 61 6e 67 65 20  s [string range 
0db0: 24 73 37 38 20 30 20 24 6e 73 74 61 72 5d 0a 20  $s78 0 $nstar]. 
0dc0: 20 70 75 74 73 20 24 6f 75 74 20 22 2f 2a 2a 2a   puts $out "/***
0dd0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 24 74 65 78  *********** $tex
0de0: 74 20 24 73 74 61 72 73 2f 22 0a 7d 0a 0a 23 20  t $stars/".}..# 
0df0: 52 65 61 64 20 74 68 65 20 73 6f 75 72 63 65 20  Read the source 
0e00: 66 69 6c 65 20 6e 61 6d 65 64 20 24 66 69 6c 65  file named $file
0e10: 6e 61 6d 65 20 61 6e 64 20 77 72 69 74 65 20 69  name and write i
0e20: 74 20 69 6e 74 6f 20 74 68 65 0a 23 20 73 71 6c  t into the.# sql
0e30: 69 74 65 33 2e 63 20 6f 75 74 70 75 74 20 66 69  ite3.c output fi
0e40: 6c 65 2e 20 20 49 66 20 61 6e 79 20 23 69 6e 63  le.  If any #inc
0e50: 6c 75 64 65 20 73 74 61 74 65 6d 65 6e 74 73 20  lude statements 
0e60: 61 72 65 20 73 65 65 6e 2c 0a 23 20 70 72 6f 63  are seen,.# proc
0e70: 65 73 73 20 74 68 65 6d 20 61 70 70 72 6f 70 72  ess them appropr
0e80: 61 74 65 6c 79 2e 0a 23 0a 70 72 6f 63 20 63 6f  ately..#.proc co
0e90: 70 79 5f 66 69 6c 65 20 7b 66 69 6c 65 6e 61 6d  py_file {filenam
0ea0: 65 7d 20 7b 0a 20 20 67 6c 6f 62 61 6c 20 73 65  e} {.  global se
0eb0: 65 6e 5f 68 64 72 20 61 76 61 69 6c 61 62 6c 65  en_hdr available
0ec0: 5f 68 64 72 20 6f 75 74 0a 20 20 73 65 74 20 74  _hdr out.  set t
0ed0: 61 69 6c 20 5b 66 69 6c 65 20 74 61 69 6c 20 24  ail [file tail $
0ee0: 66 69 6c 65 6e 61 6d 65 5d 0a 20 20 73 65 63 74  filename].  sect
0ef0: 69 6f 6e 5f 63 6f 6d 6d 65 6e 74 20 22 42 65 67  ion_comment "Beg
0f00: 69 6e 20 66 69 6c 65 20 24 74 61 69 6c 22 0a 20  in file $tail". 
0f10: 20 73 65 74 20 69 6e 20 5b 6f 70 65 6e 20 24 66   set in [open $f
0f20: 69 6c 65 6e 61 6d 65 20 72 5d 0a 20 20 77 68 69  ilename r].  whi
0f30: 6c 65 20 7b 21 5b 65 6f 66 20 24 69 6e 5d 7d 20  le {![eof $in]} 
0f40: 7b 0a 20 20 20 20 73 65 74 20 6c 69 6e 65 20 5b  {.    set line [
0f50: 67 65 74 73 20 24 69 6e 5d 0a 20 20 20 20 69 66  gets $in].    if
0f60: 20 7b 5b 72 65 67 65 78 70 20 7b 5e 23 5c 73 2a   {[regexp {^#\s*
0f70: 69 6e 63 6c 75 64 65 5c 73 2b 5b 22 3c 5d 28 5b  include\s+["<]([
0f80: 5e 22 3e 5d 2b 29 5b 22 3e 5d 7d 20 24 6c 69 6e  ^">]+)[">]} $lin
0f90: 65 20 61 6c 6c 20 68 64 72 5d 7d 20 7b 0a 20 20  e all hdr]} {.  
0fa0: 20 20 20 20 69 66 20 7b 5b 69 6e 66 6f 20 65 78      if {[info ex
0fb0: 69 73 74 73 20 61 76 61 69 6c 61 62 6c 65 5f 68  ists available_h
0fc0: 64 72 28 24 68 64 72 29 5d 7d 20 7b 0a 20 20 20  dr($hdr)]} {.   
0fd0: 20 20 20 20 20 69 66 20 7b 24 61 76 61 69 6c 61       if {$availa
0fe0: 62 6c 65 5f 68 64 72 28 24 68 64 72 29 7d 20 7b  ble_hdr($hdr)} {
0ff0: 0a 20 20 20 20 20 20 20 20 20 20 69 66 20 7b 24  .          if {$
1000: 68 64 72 21 3d 22 6f 73 5f 63 6f 6d 6d 6f 6e 2e  hdr!="os_common.
1010: 68 22 7d 20 7b 0a 20 20 20 20 20 20 20 20 20 20  h"} {.          
1020: 20 20 73 65 74 20 61 76 61 69 6c 61 62 6c 65 5f    set available_
1030: 68 64 72 28 24 68 64 72 29 20 30 0a 20 20 20 20  hdr($hdr) 0.    
1040: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20        }.        
1050: 20 20 73 65 63 74 69 6f 6e 5f 63 6f 6d 6d 65 6e    section_commen
1060: 74 20 22 49 6e 63 6c 75 64 65 20 24 68 64 72 20  t "Include $hdr 
1070: 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 20 6f 66  in the middle of
1080: 20 24 74 61 69 6c 22 0a 20 20 20 20 20 20 20 20   $tail".        
1090: 20 20 63 6f 70 79 5f 66 69 6c 65 20 74 73 72 63    copy_file tsrc
10a0: 2f 24 68 64 72 0a 20 20 20 20 20 20 20 20 20 20  /$hdr.          
10b0: 73 65 63 74 69 6f 6e 5f 63 6f 6d 6d 65 6e 74 20  section_comment 
10c0: 22 43 6f 6e 74 69 6e 75 69 6e 67 20 77 68 65 72  "Continuing wher
10d0: 65 20 77 65 20 6c 65 66 74 20 6f 66 66 20 69 6e  e we left off in
10e0: 20 24 74 61 69 6c 22 0a 20 20 20 20 20 20 20 20   $tail".        
10f0: 7d 0a 20 20 20 20 20 20 7d 20 65 6c 73 65 69 66  }.      } elseif
1100: 20 7b 21 5b 69 6e 66 6f 20 65 78 69 73 74 73 20   {![info exists 
1110: 73 65 65 6e 5f 68 64 72 28 24 68 64 72 29 5d 7d  seen_hdr($hdr)]}
1120: 20 7b 0a 20 20 20 20 20 20 20 20 73 65 74 20 73   {.        set s
1130: 65 65 6e 5f 68 64 72 28 24 68 64 72 29 20 31 0a  een_hdr($hdr) 1.
1140: 20 20 20 20 20 20 20 20 70 75 74 73 20 24 6f 75          puts $ou
1150: 74 20 24 6c 69 6e 65 0a 20 20 20 20 20 20 7d 0a  t $line.      }.
1160: 20 20 20 20 7d 20 65 6c 73 65 69 66 20 7b 5b 72      } elseif {[r
1170: 65 67 65 78 70 20 7b 5e 23 69 66 64 65 66 20 5f  egexp {^#ifdef _
1180: 5f 63 70 6c 75 73 70 6c 75 73 7d 20 24 6c 69 6e  _cplusplus} $lin
1190: 65 5d 7d 20 7b 0a 20 20 20 20 20 20 70 75 74 73  e]} {.      puts
11a0: 20 24 6f 75 74 20 22 23 69 66 20 30 22 0a 20 20   $out "#if 0".  
11b0: 20 20 7d 20 65 6c 73 65 69 66 20 7b 5b 72 65 67    } elseif {[reg
11c0: 65 78 70 20 7b 5e 23 6c 69 6e 65 7d 20 24 6c 69  exp {^#line} $li
11d0: 6e 65 5d 7d 20 7b 0a 20 20 20 20 20 20 23 20 53  ne]} {.      # S
11e0: 6b 69 70 20 23 6c 69 6e 65 20 64 69 72 65 63 74  kip #line direct
11f0: 69 76 65 73 2e 0a 20 20 20 20 7d 20 65 6c 73 65  ives..    } else
1200: 20 7b 0a 20 20 20 20 20 20 70 75 74 73 20 24 6f   {.      puts $o
1210: 75 74 20 24 6c 69 6e 65 0a 20 20 20 20 7d 0a 20  ut $line.    }. 
1220: 20 7d 0a 20 20 63 6c 6f 73 65 20 24 69 6e 0a 20   }.  close $in. 
1230: 20 73 65 63 74 69 6f 6e 5f 63 6f 6d 6d 65 6e 74   section_comment
1240: 20 22 45 6e 64 20 6f 66 20 24 74 61 69 6c 22 0a   "End of $tail".
1250: 7d 0a 0a 0a 23 20 50 72 6f 63 65 73 73 20 74 68  }...# Process th
1260: 65 20 73 6f 75 72 63 65 20 66 69 6c 65 73 2e 20  e source files. 
1270: 20 50 72 6f 63 65 73 73 20 66 69 6c 65 73 20 63   Process files c
1280: 6f 6e 74 61 69 6e 69 6e 67 20 63 6f 6d 6d 6f 6e  ontaining common
1290: 6c 79 0a 23 20 75 73 65 64 20 73 75 62 72 6f 75  ly.# used subrou
12a0: 74 69 6e 65 73 20 66 69 72 73 74 20 69 6e 20 6f  tines first in o
12b0: 72 64 65 72 20 74 6f 20 68 65 6c 70 20 74 68 65  rder to help the
12c0: 20 63 6f 6d 70 69 6c 65 72 20 66 69 6e 64 0a 23   compiler find.#
12d0: 20 69 6e 6c 69 6e 69 6e 67 20 6f 70 70 6f 72 74   inlining opport
12e0: 75 6e 69 74 69 65 73 2e 0a 23 0a 66 6f 72 65 61  unities..#.forea
12f0: 63 68 20 66 69 6c 65 20 7b 0a 20 20 20 73 71 6c  ch file {.   sql
1300: 69 74 65 33 2e 68 0a 0a 20 20 20 64 61 74 65 2e  ite3.h..   date.
1310: 63 0a 20 20 20 6f 73 2e 63 0a 0a 20 20 20 70 72  c.   os.c..   pr
1320: 69 6e 74 66 2e 63 0a 20 20 20 72 61 6e 64 6f 6d  intf.c.   random
1330: 2e 63 0a 20 20 20 75 74 66 2e 63 0a 20 20 20 75  .c.   utf.c.   u
1340: 74 69 6c 2e 63 0a 20 20 20 68 61 73 68 2e 63 0a  til.c.   hash.c.
1350: 20 20 20 6f 70 63 6f 64 65 73 2e 63 0a 0a 20 20     opcodes.c..  
1360: 20 6f 73 5f 6f 73 32 2e 63 0a 20 20 20 6f 73 5f   os_os2.c.   os_
1370: 75 6e 69 78 2e 63 0a 20 20 20 6f 73 5f 77 69 6e  unix.c.   os_win
1380: 2e 63 0a 0a 20 20 20 70 61 67 65 72 2e 63 0a 20  .c..   pager.c. 
1390: 20 20 0a 20 20 20 62 74 72 65 65 2e 63 0a 0a 20    .   btree.c.. 
13a0: 20 20 76 64 62 65 66 69 66 6f 2e 63 0a 20 20 20    vdbefifo.c.   
13b0: 76 64 62 65 6d 65 6d 2e 63 0a 20 20 20 76 64 62  vdbemem.c.   vdb
13c0: 65 61 75 78 2e 63 0a 20 20 20 76 64 62 65 61 70  eaux.c.   vdbeap
13d0: 69 2e 63 0a 20 20 20 76 64 62 65 2e 63 0a 0a 20  i.c.   vdbe.c.. 
13e0: 20 20 65 78 70 72 2e 63 0a 20 20 20 61 6c 74 65    expr.c.   alte
13f0: 72 2e 63 0a 20 20 20 61 6e 61 6c 79 7a 65 2e 63  r.c.   analyze.c
1400: 0a 20 20 20 61 74 74 61 63 68 2e 63 0a 20 20 20  .   attach.c.   
1410: 61 75 74 68 2e 63 0a 20 20 20 62 75 69 6c 64 2e  auth.c.   build.
1420: 63 0a 20 20 20 63 61 6c 6c 62 61 63 6b 2e 63 0a  c.   callback.c.
1430: 20 20 20 63 6f 6d 70 6c 65 74 65 2e 63 0a 20 20     complete.c.  
1440: 20 64 65 6c 65 74 65 2e 63 0a 20 20 20 66 75 6e   delete.c.   fun
1450: 63 2e 63 0a 20 20 20 69 6e 73 65 72 74 2e 63 0a  c.c.   insert.c.
1460: 20 20 20 6c 65 67 61 63 79 2e 63 0a 20 20 20 6c     legacy.c.   l
1470: 6f 61 64 65 78 74 2e 63 0a 20 20 20 70 72 61 67  oadext.c.   prag
1480: 6d 61 2e 63 0a 20 20 20 70 72 65 70 61 72 65 2e  ma.c.   prepare.
1490: 63 0a 20 20 20 73 65 6c 65 63 74 2e 63 0a 20 20  c.   select.c.  
14a0: 20 74 61 62 6c 65 2e 63 0a 20 20 20 74 72 69 67   table.c.   trig
14b0: 67 65 72 2e 63 0a 20 20 20 75 70 64 61 74 65 2e  ger.c.   update.
14c0: 63 0a 20 20 20 76 61 63 75 75 6d 2e 63 0a 20 20  c.   vacuum.c.  
14d0: 20 76 74 61 62 2e 63 0a 20 20 20 77 68 65 72 65   vtab.c.   where
14e0: 2e 63 0a 0a 20 20 20 70 61 72 73 65 2e 63 0a 0a  .c..   parse.c..
14f0: 20 20 20 74 6f 6b 65 6e 69 7a 65 2e 63 0a 0a 20     tokenize.c.. 
1500: 20 20 6d 61 69 6e 2e 63 0a 7d 20 7b 0a 20 20 63    main.c.} {.  c
1510: 6f 70 79 5f 66 69 6c 65 20 74 73 72 63 2f 24 66  opy_file tsrc/$f
1520: 69 6c 65 0a 7d 0a 0a 69 66 20 30 20 7b 0a 70 75  ile.}..if 0 {.pu
1530: 74 73 20 24 6f 75 74 20 22 23 69 66 64 65 66 20  ts $out "#ifdef 
1540: 53 51 4c 49 54 45 5f 54 45 53 54 22 0a 66 6f 72  SQLITE_TEST".for
1550: 65 61 63 68 20 66 69 6c 65 20 7b 0a 20 20 20 74  each file {.   t
1560: 65 73 74 31 2e 63 0a 20 20 20 74 65 73 74 32 2e  est1.c.   test2.
1570: 63 0a 20 20 20 74 65 73 74 33 2e 63 0a 20 20 20  c.   test3.c.   
1580: 74 65 73 74 34 2e 63 0a 20 20 20 74 65 73 74 35  test4.c.   test5
1590: 2e 63 0a 20 20 20 74 65 73 74 36 2e 63 0a 20 20  .c.   test6.c.  
15a0: 20 74 65 73 74 37 2e 63 0a 20 20 20 74 65 73 74   test7.c.   test
15b0: 38 2e 63 0a 20 20 20 74 65 73 74 5f 61 73 79 6e  8.c.   test_asyn
15c0: 63 2e 63 0a 20 20 20 74 65 73 74 5f 61 75 74 6f  c.c.   test_auto
15d0: 65 78 74 2e 63 0a 20 20 20 74 65 73 74 5f 6c 6f  ext.c.   test_lo
15e0: 61 64 65 78 74 2e 63 0a 20 20 20 74 65 73 74 5f  adext.c.   test_
15f0: 6d 64 35 2e 63 0a 20 20 20 74 65 73 74 5f 73 63  md5.c.   test_sc
1600: 68 65 6d 61 2e 63 0a 20 20 20 74 65 73 74 5f 73  hema.c.   test_s
1610: 65 72 76 65 72 2e 63 0a 20 20 20 74 65 73 74 5f  erver.c.   test_
1620: 74 63 6c 76 61 72 2e 63 0a 7d 20 7b 0a 20 20 63  tclvar.c.} {.  c
1630: 6f 70 79 5f 66 69 6c 65 20 2e 2e 2f 73 71 6c 69  opy_file ../sqli
1640: 74 65 2f 73 72 63 2f 24 66 69 6c 65 0a 7d 0a 70  te/src/$file.}.p
1650: 75 74 73 20 24 6f 75 74 20 22 23 65 6e 64 69 66  uts $out "#endif
1660: 20 2f 2a 20 53 51 4c 49 54 45 5f 54 45 53 54 20   /* SQLITE_TEST 
1670: 2a 2f 22 0a 70 75 74 73 20 24 6f 75 74 20 22 23  */".puts $out "#
1680: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 43 4c  ifdef SQLITE_TCL
1690: 22 0a 63 6f 70 79 5f 66 69 6c 65 20 2e 2e 2f 73  ".copy_file ../s
16a0: 71 6c 69 74 65 2f 73 72 63 2f 74 63 6c 73 71 6c  qlite/src/tclsql
16b0: 69 74 65 2e 63 0a 70 75 74 73 20 24 6f 75 74 20  ite.c.puts $out 
16c0: 22 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54  "#endif /* SQLIT
16d0: 45 5f 54 43 4c 20 2a 2f 22 0a 7d 0a 0a 63 6c 6f  E_TCL */".}..clo
16e0: 73 65 20 24 6f 75 74 0a                          se $out.