/ Hex Artifact Content
Login

Artifact 247f2ba9009f8114036080e758e7d9d3b884dd32:


0000: 23 0a 23 20 52 75 6e 20 74 68 69 73 20 54 43 4c  #.# Run this TCL
0010: 20 73 63 72 69 70 74 20 74 6f 20 67 65 6e 65 72   script to gener
0020: 61 74 65 20 48 54 4d 4c 20 66 6f 72 20 74 68 65  ate HTML for the
0030: 20 71 75 69 63 6b 73 74 61 72 74 2e 68 74 6d 6c   quickstart.html
0040: 20 66 69 6c 65 2e 0a 23 0a 73 65 74 20 72 63 73   file..#.set rcs
0050: 69 64 20 7b 24 49 64 3a 20 71 75 69 63 6b 73 74  id {$Id: quickst
0060: 61 72 74 2e 74 63 6c 2c 76 20 31 2e 31 20 32 30  art.tcl,v 1.1 20
0070: 30 32 2f 30 38 2f 31 35 20 31 33 3a 34 35 3a 31  02/08/15 13:45:1
0080: 37 20 64 72 68 20 45 78 70 20 24 7d 0a 0a 70 75  7 drh Exp $}..pu
0090: 74 73 20 7b 3c 68 74 6d 6c 3e 0a 3c 68 65 61 64  ts {<html>.<head
00a0: 3e 3c 74 69 74 6c 65 3e 53 51 4c 69 74 65 20 49  ><title>SQLite I
00b0: 6e 20 35 20 4d 69 6e 75 74 65 73 20 4f 72 20 4c  n 5 Minutes Or L
00c0: 65 73 73 3c 2f 74 69 74 6c 65 3e 3c 2f 68 65 61  ess</title></hea
00d0: 64 3e 0a 3c 62 6f 64 79 20 62 67 63 6f 6c 6f 72  d>.<body bgcolor
00e0: 3d 77 68 69 74 65 3e 0a 3c 68 31 20 61 6c 69 67  =white>.<h1 alig
00f0: 6e 3d 63 65 6e 74 65 72 3e 53 51 4c 69 74 65 20  n=center>SQLite 
0100: 49 6e 20 35 20 4d 69 6e 75 74 65 73 20 4f 72 20  In 5 Minutes Or 
0110: 4c 65 73 73 3c 2f 68 31 3e 7d 0a 0a 70 75 74 73  Less</h1>}..puts
0120: 20 7b 0a 3c 70 3e 48 65 72 65 20 69 73 20 77 68   {.<p>Here is wh
0130: 61 74 20 79 6f 75 20 64 6f 20 74 6f 20 73 74 61  at you do to sta
0140: 72 74 20 65 78 70 65 72 69 6d 65 6e 74 69 6e 67  rt experimenting
0150: 20 77 69 74 68 20 53 51 4c 69 74 65 20 77 69 74   with SQLite wit
0160: 68 6f 75 74 20 68 61 76 69 6e 67 0a 74 6f 20 64  hout having.to d
0170: 6f 20 61 20 6c 6f 74 20 6f 66 20 74 65 64 69 6f  o a lot of tedio
0180: 75 73 20 72 65 61 64 69 6e 67 20 61 6e 64 20 63  us reading and c
0190: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 3a 3c 2f 70  onfiguration:</p
01a0: 3e 0a 0a 3c 68 32 3e 44 6f 77 6e 6c 6f 61 64 20  >..<h2>Download 
01b0: 54 68 65 20 43 6f 64 65 3c 2f 68 32 3e 0a 0a 3c  The Code</h2>..<
01c0: 75 6c 3e 0a 3c 6c 69 3e 3c 70 3e 47 65 74 20 61  ul>.<li><p>Get a
01d0: 20 63 6f 70 79 20 6f 66 20 74 68 65 20 70 72 65   copy of the pre
01e0: 62 75 69 6c 64 20 62 69 6e 61 72 69 65 73 20 66  build binaries f
01f0: 6f 72 20 79 6f 75 72 20 6d 61 63 68 69 6e 65 2c  or your machine,
0200: 20 6f 72 20 67 65 74 20 61 20 63 6f 70 79 0a 6f   or get a copy.o
0210: 66 20 74 68 65 20 73 6f 75 72 63 65 73 20 61 6e  f the sources an
0220: 64 20 63 6f 6d 70 69 6c 65 20 74 68 65 6d 20 79  d compile them y
0230: 6f 75 72 73 65 6c 66 2e 20 20 56 69 73 69 74 0a  ourself.  Visit.
0240: 74 68 65 20 3c 61 20 68 72 65 66 3d 22 64 6f 77  the <a href="dow
0250: 6e 6c 6f 61 64 2e 68 74 6d 6c 22 3e 64 6f 77 6e  nload.html">down
0260: 6c 6f 61 64 3c 2f 61 3e 20 70 61 67 65 20 66 6f  load</a> page fo
0270: 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69  r more informati
0280: 6f 6e 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 3c 2f 75  on.</p></li>.</u
0290: 6c 3e 0a 0a 3c 68 32 3e 43 72 65 61 74 65 20 41  l>..<h2>Create A
02a0: 20 4e 65 77 20 44 61 74 61 62 61 73 65 3c 2f 68   New Database</h
02b0: 32 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 70 3e  2>..<ul>.<li><p>
02c0: 41 74 20 61 20 73 68 65 6c 6c 20 6f 72 20 44 4f  At a shell or DO
02d0: 53 20 70 72 6f 6d 70 74 2c 20 65 6e 74 65 72 3a  S prompt, enter:
02e0: 20 22 3c 62 3e 73 71 6c 69 74 65 20 74 65 73 74   "<b>sqlite test
02f0: 2e 64 62 3c 2f 62 3e 22 2e 20 20 54 68 69 73 20  .db</b>".  This 
0300: 77 69 6c 6c 0a 63 72 65 61 74 65 20 61 20 6e 65  will.create a ne
0310: 77 20 64 61 74 61 62 61 73 65 20 6e 61 6d 65 64  w database named
0320: 20 22 74 65 73 74 2e 64 62 22 2e 20 20 28 59 6f   "test.db".  (Yo
0330: 75 20 63 61 6e 20 75 73 65 20 61 20 64 69 66 66  u can use a diff
0340: 65 72 65 6e 74 20 6e 61 6d 65 20 69 66 0a 79 6f  erent name if.yo
0350: 75 20 6c 69 6b 65 2e 29 3c 2f 70 3e 3c 2f 6c 69  u like.)</p></li
0360: 3e 0a 3c 6c 69 3e 3c 70 3e 45 6e 74 65 72 20 53  >.<li><p>Enter S
0370: 51 4c 20 63 6f 6d 6d 61 6e 64 73 20 61 74 20 74  QL commands at t
0380: 68 65 20 70 72 6f 6d 70 74 20 74 6f 20 63 72 65  he prompt to cre
0390: 61 74 65 20 61 6e 64 20 70 6f 70 75 6c 61 74 65  ate and populate
03a0: 20 74 68 65 0a 6e 65 77 20 64 61 74 61 62 61 73   the.new databas
03b0: 65 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 3c 2f 75 6c  e.</p></li>.</ul
03c0: 3e 0a 0a 3c 68 32 3e 57 72 69 74 65 20 50 72 6f  >..<h2>Write Pro
03d0: 67 72 61 6d 73 20 54 68 61 74 20 55 73 65 20 53  grams That Use S
03e0: 51 4c 69 74 65 3c 2f 68 32 3e 0a 0a 3c 75 6c 3e  QLite</h2>..<ul>
03f0: 0a 3c 6c 69 3e 3c 70 3e 42 65 6c 6f 77 20 69 73  .<li><p>Below is
0400: 20 61 20 73 69 6d 70 6c 65 20 54 43 4c 20 70 72   a simple TCL pr
0410: 6f 67 72 61 6d 20 74 68 61 74 20 64 65 6d 6f 6e  ogram that demon
0420: 73 74 72 61 74 65 73 20 68 6f 77 20 74 6f 20 75  strates how to u
0430: 73 65 0a 74 68 65 20 54 43 4c 20 69 6e 74 65 72  se.the TCL inter
0440: 66 61 63 65 20 74 6f 20 53 51 4c 69 74 65 2e 20  face to SQLite. 
0450: 20 54 68 65 20 70 72 6f 67 72 61 6d 20 65 78 65   The program exe
0460: 63 75 74 65 73 20 74 68 65 20 53 51 4c 20 73 74  cutes the SQL st
0470: 61 74 65 6d 65 6e 74 73 0a 67 69 76 65 6e 20 61  atements.given a
0480: 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67  s the second arg
0490: 75 6d 65 6e 74 20 6f 6e 20 74 68 65 20 64 61 74  ument on the dat
04a0: 61 62 61 73 65 20 64 65 66 69 6e 65 64 20 62 79  abase defined by
04b0: 20 74 68 65 20 66 69 72 73 74 0a 61 72 67 75 6d   the first.argum
04c0: 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b  ent.</p>..<block
04d0: 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 23 21 2f 75  quote><pre>.#!/u
04e0: 73 72 2f 62 69 6e 2f 74 63 6c 73 68 0a 69 66 20  sr/bin/tclsh.if 
04f0: 7b 24 61 72 67 63 21 3d 32 7d 20 7b 0a 20 20 70  {$argc!=2} {.  p
0500: 75 74 73 20 73 74 64 65 72 72 20 22 55 73 61 67  uts stderr "Usag
0510: 65 3a 20 25 73 20 44 41 54 41 42 41 53 45 20 53  e: %s DATABASE S
0520: 51 4c 2d 53 54 41 54 45 4d 45 4e 54 22 0a 20 20  QL-STATEMENT".  
0530: 65 78 69 74 20 31 0a 7d 0a 6c 6f 61 64 20 2f 75  exit 1.}.load /u
0540: 73 72 2f 6c 69 62 2f 74 63 6c 73 71 6c 69 74 65  sr/lib/tclsqlite
0550: 2e 73 6f 20 53 71 6c 69 74 65 0a 73 71 6c 69 74  .so Sqlite.sqlit
0560: 65 20 64 62 20 5b 6c 69 6e 64 65 78 20 24 61 72  e db [lindex $ar
0570: 67 76 20 30 5d 0a 64 62 20 65 76 61 6c 20 5b 6c  gv 0].db eval [l
0580: 69 6e 64 65 78 20 24 61 72 67 76 20 31 5d 20 78  index $argv 1] x
0590: 20 7b 0a 20 20 66 6f 72 65 61 63 68 20 76 20 24   {.  foreach v $
05a0: 78 28 2a 29 20 7b 0a 20 20 20 20 70 75 74 73 20  x(*) {.    puts 
05b0: 22 24 76 20 3d 20 24 78 28 24 76 29 22 0a 20 20  "$v = $x($v)".  
05c0: 7d 0a 20 20 70 75 74 73 20 22 22 0a 7d 0a 64 62  }.  puts "".}.db
05d0: 20 63 6c 6f 73 65 0a 3c 2f 70 72 65 3e 3c 2f 62   close.</pre></b
05e0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 2f 6c 69 3e  lockquote>.</li>
05f0: 0a 0a 3c 6c 69 3e 3c 70 3e 42 65 6c 6f 77 20 69  ..<li><p>Below i
0600: 73 20 61 20 73 69 6d 70 6c 65 20 43 20 70 72 6f  s a simple C pro
0610: 67 72 61 6d 20 74 68 61 74 20 64 65 6d 6f 6e 73  gram that demons
0620: 74 72 61 74 65 73 20 68 6f 77 20 74 6f 20 75 73  trates how to us
0630: 65 0a 74 68 65 20 43 2f 43 2b 2b 20 69 6e 74 65  e.the C/C++ inte
0640: 72 66 61 63 65 20 74 6f 20 53 51 4c 69 74 65 2e  rface to SQLite.
0650: 20 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 61 20    The name of a 
0660: 64 61 74 61 62 61 73 65 20 69 73 20 67 69 76 65  database is give
0670: 6e 20 62 79 0a 74 68 65 20 66 69 72 73 74 20 61  n by.the first a
0680: 72 67 75 6d 65 6e 74 20 61 6e 64 20 74 68 65 20  rgument and the 
0690: 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20  second argument 
06a0: 69 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 53  is one or more S
06b0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 0a 74 6f  QL statements.to
06c0: 20 65 78 65 63 75 74 65 20 61 67 61 69 6e 73 74   execute against
06d0: 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 3c 2f   the database.</
06e0: 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e  p>..<blockquote>
06f0: 3c 70 72 65 3e 0a 23 69 6e 63 6c 75 64 65 20 26  <pre>.#include &
0700: 6c 74 3b 73 74 64 69 6f 2e 68 26 67 74 3b 0a 23  lt;stdio.h&gt;.#
0710: 69 6e 63 6c 75 64 65 20 26 6c 74 3b 73 71 6c 69  include &lt;sqli
0720: 74 65 2e 68 26 67 74 3b 0a 0a 73 74 61 74 69 63  te.h&gt;..static
0730: 20 69 6e 74 20 63 61 6c 6c 62 61 63 6b 28 76 6f   int callback(vo
0740: 69 64 20 2a 4e 6f 74 55 73 65 64 2c 20 69 6e 74  id *NotUsed, int
0750: 20 61 72 67 63 2c 20 63 68 61 72 20 2a 2a 61 72   argc, char **ar
0760: 67 76 2c 20 63 68 61 72 20 2a 2a 61 7a 43 6f 6c  gv, char **azCol
0770: 4e 61 6d 65 29 7b 0a 20 20 69 6e 74 20 69 3b 0a  Name){.  int i;.
0780: 20 20 66 6f 72 28 69 3d 30 3b 20 69 26 6c 74 3b    for(i=0; i&lt;
0790: 61 72 67 63 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  argc; i++){.    
07a0: 70 72 69 6e 74 66 28 22 25 73 20 3d 20 25 73 5c  printf("%s = %s\
07b0: 6e 22 2c 20 61 7a 43 6f 6c 4e 61 6d 65 5b 69 5d  n", azColName[i]
07c0: 2c 20 61 72 67 76 5b 69 5d 20 3f 20 61 72 67 76  , argv[i] ? argv
07d0: 5b 69 5d 20 3a 20 22 4e 55 4c 4c 22 29 3b 0a 20  [i] : "NULL");. 
07e0: 20 7d 0a 20 20 70 72 69 6e 74 66 28 22 5c 6e 22   }.  printf("\n"
07f0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d  );.  return 0;.}
0800: 0a 0a 69 6e 74 20 6d 61 69 6e 28 69 6e 74 20 61  ..int main(int a
0810: 72 67 63 2c 20 63 68 61 72 20 2a 2a 61 72 67 76  rgc, char **argv
0820: 29 7b 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 3b  ){.  sqlite *db;
0830: 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67  .  char *zErrMsg
0840: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b 0a   = 0;.  int rc;.
0850: 0a 20 20 69 66 28 20 61 72 67 63 21 3d 33 20 29  .  if( argc!=3 )
0860: 7b 0a 20 20 20 20 66 70 72 69 6e 74 66 28 73 74  {.    fprintf(st
0870: 64 65 72 72 2c 20 22 55 73 61 67 65 3a 20 25 73  derr, "Usage: %s
0880: 20 44 41 54 41 42 41 53 45 20 53 51 4c 2d 53 54   DATABASE SQL-ST
0890: 41 54 45 4d 45 4e 54 5c 6e 22 2c 20 61 72 67 76  ATEMENT\n", argv
08a0: 5b 30 5d 29 3b 0a 20 20 20 20 65 78 69 74 28 31  [0]);.    exit(1
08b0: 29 3b 0a 20 20 7d 0a 20 20 64 62 20 3d 20 73 71  );.  }.  db = sq
08c0: 6c 69 74 65 5f 6f 70 65 6e 28 61 72 67 76 5b 31  lite_open(argv[1
08d0: 5d 2c 20 30 2c 20 26 7a 45 72 72 4d 73 67 29 3b  ], 0, &zErrMsg);
08e0: 0a 20 20 69 66 28 20 64 62 3d 3d 30 20 29 7b 0a  .  if( db==0 ){.
08f0: 20 20 20 20 66 70 72 69 6e 74 66 28 73 74 64 65      fprintf(stde
0900: 72 72 2c 20 22 43 61 6e 27 74 20 6f 70 65 6e 20  rr, "Can't open 
0910: 64 61 74 61 62 61 73 65 3a 20 25 73 5c 6e 22 2c  database: %s\n",
0920: 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20   &zErrMsg);.    
0930: 65 78 69 74 28 31 29 3b 0a 20 20 7d 0a 20 20 72  exit(1);.  }.  r
0940: 63 20 3d 20 73 71 6c 69 74 65 5f 65 78 65 63 28  c = sqlite_exec(
0950: 64 62 2c 20 61 72 67 76 5b 32 5d 2c 20 63 61 6c  db, argv[2], cal
0960: 6c 62 61 63 6b 2c 20 30 2c 20 26 7a 45 72 72 4d  lback, 0, &zErrM
0970: 73 67 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53  sg);.  if( rc!=S
0980: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
0990: 66 70 72 69 6e 74 66 28 73 74 64 65 72 72 2c 20  fprintf(stderr, 
09a0: 22 53 51 4c 20 65 72 72 6f 72 3a 20 25 73 5c 6e  "SQL error: %s\n
09b0: 22 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 7d  ", zErrMsg);.  }
09c0: 0a 20 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65 28  .  sqlite_close(
09d0: 64 62 29 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b  db);.  return 0;
09e0: 0a 7d 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b  .}.</pre></block
09f0: 71 75 6f 74 65 3e 0a 3c 2f 6c 69 3e 0a 3c 2f 75  quote>.</li>.</u
0a00: 6c 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  l>.}..puts {.<p>
0a10: 3c 68 72 20 2f 3e 3c 2f 70 3e 0a 3c 70 3e 0a 3c  <hr /></p>.<p>.<
0a20: 61 20 68 72 65 66 3d 22 69 6e 64 65 78 2e 68 74  a href="index.ht
0a30: 6d 6c 22 3e 3c 69 6d 67 20 73 72 63 3d 22 2f 67  ml"><img src="/g
0a40: 6f 62 61 63 6b 2e 6a 70 67 22 20 62 6f 72 64 65  oback.jpg" borde
0a50: 72 3d 30 20 2f 3e 0a 42 61 63 6b 20 74 6f 20 74  r=0 />.Back to t
0a60: 68 65 20 53 51 4c 69 74 65 20 68 6f 6d 65 20 70  he SQLite home p
0a70: 61 67 65 3c 2f 61 3e 0a 3c 2f 70 3e 0a 0a 3c 2f  age</a>.</p>..</
0a80: 62 6f 64 79 3e 3c 2f 68 74 6d 6c 3e 7d 0a        body></html>}.