/ Hex Artifact Content
Login

Artifact 0147c9f8539d421d6c5558d3e854b78387372fae:


0000: 2f 2a 0a 2a 2a 20 43 6f 70 79 72 69 67 68 74 20  /*.** Copyright 
0010: 28 63 29 20 31 39 39 39 2c 20 32 30 30 30 20 44  (c) 1999, 2000 D
0020: 2e 20 52 69 63 68 61 72 64 20 48 69 70 70 0a 2a  . Richard Hipp.*
0030: 2a 0a 2a 2a 20 54 68 69 73 20 70 72 6f 67 72 61  *.** This progra
0040: 6d 20 69 73 20 66 72 65 65 20 73 6f 66 74 77 61  m is free softwa
0050: 72 65 3b 20 79 6f 75 20 63 61 6e 20 72 65 64 69  re; you can redi
0060: 73 74 72 69 62 75 74 65 20 69 74 20 61 6e 64 2f  stribute it and/
0070: 6f 72 0a 2a 2a 20 6d 6f 64 69 66 79 20 69 74 20  or.** modify it 
0080: 75 6e 64 65 72 20 74 68 65 20 74 65 72 6d 73 20  under the terms 
0090: 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72  of the GNU Gener
00a0: 61 6c 20 50 75 62 6c 69 63 0a 2a 2a 20 4c 69 63  al Public.** Lic
00b0: 65 6e 73 65 20 61 73 20 70 75 62 6c 69 73 68 65  ense as publishe
00c0: 64 20 62 79 20 74 68 65 20 46 72 65 65 20 53 6f  d by the Free So
00d0: 66 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69 6f  ftware Foundatio
00e0: 6e 3b 20 65 69 74 68 65 72 0a 2a 2a 20 76 65 72  n; either.** ver
00f0: 73 69 6f 6e 20 32 20 6f 66 20 74 68 65 20 4c 69  sion 2 of the Li
0100: 63 65 6e 73 65 2c 20 6f 72 20 28 61 74 20 79 6f  cense, or (at yo
0110: 75 72 20 6f 70 74 69 6f 6e 29 20 61 6e 79 20 6c  ur option) any l
0120: 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 2a 2a  ater version..**
0130: 0a 2a 2a 20 54 68 69 73 20 70 72 6f 67 72 61 6d  .** This program
0140: 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20   is distributed 
0150: 69 6e 20 74 68 65 20 68 6f 70 65 20 74 68 61 74  in the hope that
0160: 20 69 74 20 77 69 6c 6c 20 62 65 20 75 73 65 66   it will be usef
0170: 75 6c 2c 0a 2a 2a 20 62 75 74 20 57 49 54 48 4f  ul,.** but WITHO
0180: 55 54 20 41 4e 59 20 57 41 52 52 41 4e 54 59 3b  UT ANY WARRANTY;
0190: 20 77 69 74 68 6f 75 74 20 65 76 65 6e 20 74 68   without even th
01a0: 65 20 69 6d 70 6c 69 65 64 20 77 61 72 72 61 6e  e implied warran
01b0: 74 79 20 6f 66 0a 2a 2a 20 4d 45 52 43 48 41 4e  ty of.** MERCHAN
01c0: 54 41 42 49 4c 49 54 59 20 6f 72 20 46 49 54 4e  TABILITY or FITN
01d0: 45 53 53 20 46 4f 52 20 41 20 50 41 52 54 49 43  ESS FOR A PARTIC
01e0: 55 4c 41 52 20 50 55 52 50 4f 53 45 2e 20 20 53  ULAR PURPOSE.  S
01f0: 65 65 20 74 68 65 20 47 4e 55 0a 2a 2a 20 47 65  ee the GNU.** Ge
0200: 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63  neral Public Lic
0210: 65 6e 73 65 20 66 6f 72 20 6d 6f 72 65 20 64 65  ense for more de
0220: 74 61 69 6c 73 2e 0a 2a 2a 20 0a 2a 2a 20 59 6f  tails..** .** Yo
0230: 75 20 73 68 6f 75 6c 64 20 68 61 76 65 20 72 65  u should have re
0240: 63 65 69 76 65 64 20 61 20 63 6f 70 79 20 6f 66  ceived a copy of
0250: 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c   the GNU General
0260: 20 50 75 62 6c 69 63 0a 2a 2a 20 4c 69 63 65 6e   Public.** Licen
0270: 73 65 20 61 6c 6f 6e 67 20 77 69 74 68 20 74 68  se along with th
0280: 69 73 20 6c 69 62 72 61 72 79 3b 20 69 66 20 6e  is library; if n
0290: 6f 74 2c 20 77 72 69 74 65 20 74 6f 20 74 68 65  ot, write to the
02a0: 0a 2a 2a 20 46 72 65 65 20 53 6f 66 74 77 61 72  .** Free Softwar
02b0: 65 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 49 6e  e Foundation, In
02c0: 63 2e 2c 20 35 39 20 54 65 6d 70 6c 65 20 50 6c  c., 59 Temple Pl
02d0: 61 63 65 20 2d 20 53 75 69 74 65 20 33 33 30 2c  ace - Suite 330,
02e0: 0a 2a 2a 20 42 6f 73 74 6f 6e 2c 20 4d 41 20 20  .** Boston, MA  
02f0: 30 32 31 31 31 2d 31 33 30 37 2c 20 55 53 41 2e  02111-1307, USA.
0300: 0a 2a 2a 0a 2a 2a 20 41 75 74 68 6f 72 20 63 6f  .**.** Author co
0310: 6e 74 61 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f  ntact informatio
0320: 6e 3a 0a 2a 2a 20 20 20 64 72 68 40 68 77 61 63  n:.**   drh@hwac
0330: 69 2e 63 6f 6d 0a 2a 2a 20 20 20 68 74 74 70 3a  i.com.**   http:
0340: 2f 2f 77 77 77 2e 68 77 61 63 69 2e 63 6f 6d 2f  //www.hwaci.com/
0350: 64 72 68 2f 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a  drh/.**.********
0360: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0370: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0380: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0390: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
03a0: 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 64  *.** This file d
03b0: 65 66 69 6e 65 73 20 74 68 65 20 69 6e 74 65 72  efines the inter
03c0: 66 61 63 65 20 74 6f 20 74 68 65 20 64 61 74 61  face to the data
03d0: 62 61 73 65 20 62 61 63 6b 65 6e 64 20 28 44 62  base backend (Db
03e0: 62 65 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64  be)..**.** The d
03f0: 61 74 61 62 61 73 65 20 62 61 63 6b 65 6e 64 20  atabase backend 
0400: 69 73 20 64 65 73 69 67 6e 65 64 20 74 6f 20 62  is designed to b
0410: 65 20 61 73 20 67 65 6e 65 72 61 6c 20 61 73 20  e as general as 
0420: 70 6f 73 73 69 62 6c 65 0a 2a 2a 20 73 6f 20 74  possible.** so t
0430: 68 61 74 20 69 74 20 63 61 6e 20 65 61 73 69 6c  hat it can easil
0440: 79 20 62 65 20 72 65 70 6c 61 63 65 64 20 62 79  y be replaced by
0450: 20 61 20 64 69 66 66 65 72 65 6e 74 20 62 61 63   a different bac
0460: 6b 65 6e 64 2e 0a 2a 2a 20 54 68 69 73 20 6c 69  kend..** This li
0470: 62 72 61 72 79 20 77 61 73 20 6f 72 69 67 69 6e  brary was origin
0480: 61 6c 6c 79 20 64 65 73 69 67 6e 65 64 20 74 6f  ally designed to
0490: 20 73 75 70 70 6f 72 74 20 74 68 65 20 66 6f 6c   support the fol
04a0: 6c 6f 77 69 6e 67 0a 2a 2a 20 62 61 63 6b 65 6e  lowing.** backen
04b0: 64 73 3a 20 47 44 42 4d 2c 20 4e 44 42 4d 2c 20  ds: GDBM, NDBM, 
04c0: 53 44 42 4d 2c 20 42 65 72 6b 65 6c 65 79 20 44  SDBM, Berkeley D
04d0: 42 2e 0a 2a 2a 0a 2a 2a 20 24 49 64 3a 20 64 62  B..**.** $Id: db
04e0: 62 65 2e 68 2c 76 20 31 2e 33 20 32 30 30 30 2f  be.h,v 1.3 2000/
04f0: 30 35 2f 33 31 20 32 30 3a 30 30 3a 35 32 20 64  05/31 20:00:52 d
0500: 72 68 20 45 78 70 20 24 0a 2a 2f 0a 23 69 66 6e  rh Exp $.*/.#ifn
0510: 64 65 66 20 5f 53 51 4c 49 54 45 5f 44 42 42 45  def _SQLITE_DBBE
0520: 5f 48 5f 0a 23 64 65 66 69 6e 65 20 5f 53 51 4c  _H_.#define _SQL
0530: 49 54 45 5f 44 42 42 45 5f 48 5f 0a 23 69 6e 63  ITE_DBBE_H_.#inc
0540: 6c 75 64 65 20 3c 73 74 64 69 6f 2e 68 3e 0a 0a  lude <stdio.h>..
0550: 2f 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 62 61  /*.** The databa
0560: 73 65 20 62 61 63 6b 65 6e 64 20 73 75 70 70 6f  se backend suppo
0570: 72 74 73 20 74 77 6f 20 6f 70 61 71 75 65 20 73  rts two opaque s
0580: 74 72 75 63 74 75 72 65 73 2e 20 20 41 20 44 62  tructures.  A Db
0590: 62 65 20 69 73 0a 2a 2a 20 61 20 63 6f 6e 74 65  be is.** a conte
05a0: 78 74 20 66 6f 72 20 74 68 65 20 65 6e 74 69 72  xt for the entir
05b0: 65 20 73 65 74 20 6f 66 20 74 61 62 6c 65 73 20  e set of tables 
05c0: 66 6f 72 6d 69 6e 67 20 61 20 63 6f 6d 70 6c 65  forming a comple
05d0: 74 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20  te.** database. 
05e0: 20 41 20 44 62 62 65 54 61 62 6c 65 20 69 73 20   A DbbeTable is 
05f0: 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 2e 20  a single table. 
0600: 20 0a 2a 2a 0a 2a 2a 20 54 68 65 20 44 62 62 65   .**.** The Dbbe
0610: 54 61 62 6c 65 20 73 74 72 75 63 74 75 72 65 20  Table structure 
0620: 68 6f 6c 64 73 20 73 6f 6d 65 20 73 74 61 74 65  holds some state
0630: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 73 75   information, su
0640: 63 68 20 61 73 0a 2a 2a 20 74 68 65 20 6b 65 79  ch as.** the key
0650: 20 61 6e 64 20 64 61 74 61 20 66 72 6f 6d 20 74   and data from t
0660: 68 65 20 6c 61 73 74 20 72 65 74 72 69 65 76 61  he last retrieva
0670: 6c 2e 20 20 46 6f 72 20 74 68 69 73 20 72 65 61  l.  For this rea
0680: 73 6f 6e 2c 20 0a 2a 2a 20 74 68 65 20 62 61 63  son, .** the bac
0690: 6b 65 6e 64 20 6d 75 73 74 20 61 6c 6c 6f 77 20  kend must allow 
06a0: 74 68 65 20 63 72 65 61 74 69 6f 6e 20 6f 66 20  the creation of 
06b0: 6d 75 6c 74 69 70 6c 65 20 69 6e 64 65 70 65 6e  multiple indepen
06c0: 64 65 6e 74 0a 2a 2a 20 44 62 62 65 54 61 62 6c  dent.** DbbeTabl
06d0: 65 20 73 74 72 75 63 74 75 72 65 73 20 66 6f 72  e structures for
06e0: 20 65 61 63 68 20 74 61 62 6c 65 20 69 6e 20 74   each table in t
06f0: 68 65 20 64 61 74 61 62 61 73 65 2e 0a 2a 2f 0a  he database..*/.
0700: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 44  typedef struct D
0710: 62 62 65 20 44 62 62 65 3b 0a 74 79 70 65 64 65  bbe Dbbe;.typede
0720: 66 20 73 74 72 75 63 74 20 44 62 62 65 54 61 62  f struct DbbeTab
0730: 6c 65 20 44 62 62 65 54 61 62 6c 65 3b 0a 0a 2f  le DbbeTable;../
0740: 2a 0a 2a 2a 20 54 68 65 20 31 38 20 69 6e 74 65  *.** The 18 inte
0750: 72 66 61 63 65 20 72 6f 75 74 69 6e 65 73 2e 0a  rface routines..
0760: 2a 2f 0a 0a 2f 2a 20 4f 70 65 6e 20 61 20 63 6f  */../* Open a co
0770: 6d 70 6c 65 74 65 20 64 61 74 61 62 61 73 65 20  mplete database 
0780: 2a 2f 0a 44 62 62 65 20 2a 73 71 6c 69 74 65 44  */.Dbbe *sqliteD
0790: 62 62 65 4f 70 65 6e 28 63 6f 6e 73 74 20 63 68  bbeOpen(const ch
07a0: 61 72 20 2a 7a 4e 61 6d 65 2c 20 69 6e 74 20 77  ar *zName, int w
07b0: 72 69 74 65 2c 20 69 6e 74 20 63 72 65 61 74 65  rite, int create
07c0: 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 29 3b  , char **pzErr);
07d0: 0a 0a 2f 2a 20 43 6c 6f 73 65 20 74 68 65 20 77  ../* Close the w
07e0: 68 6f 6c 65 20 64 61 74 61 62 61 73 65 2e 20 2a  hole database. *
07f0: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 44 62 62  /.void sqliteDbb
0800: 65 43 6c 6f 73 65 28 44 62 62 65 2a 29 3b 0a 0a  eClose(Dbbe*);..
0810: 2f 2a 20 4f 70 65 6e 20 61 20 70 61 72 74 69 63  /* Open a partic
0820: 75 6c 61 72 20 74 61 62 6c 65 20 6f 66 20 61 20  ular table of a 
0830: 70 72 65 76 69 6f 75 73 6c 79 20 6f 70 65 6e 65  previously opene
0840: 64 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 20 43  d database..** C
0850: 72 65 61 74 65 20 74 68 65 20 74 61 62 6c 65 20  reate the table 
0860: 69 66 20 69 74 20 64 6f 65 73 6e 27 74 20 61 6c  if it doesn't al
0870: 72 65 61 64 79 20 65 78 69 73 74 20 61 6e 64 20  ready exist and 
0880: 77 72 69 74 65 61 62 6c 65 21 3d 30 2e 0a 2a 2a  writeable!=0..**
0890: 0a 2a 2a 20 49 66 20 7a 54 61 62 6c 65 4e 61 6d  .** If zTableNam
08a0: 65 20 69 73 20 30 20 6f 72 20 22 22 2c 20 74 68  e is 0 or "", th
08b0: 65 6e 20 61 20 74 65 6d 70 6f 72 61 72 79 20 74  en a temporary t
08c0: 61 62 6c 65 20 69 73 20 63 72 65 61 74 65 64 20  able is created 
08d0: 74 68 61 74 0a 2a 2a 20 77 69 6c 6c 20 62 65 20  that.** will be 
08e0: 64 65 6c 65 74 65 64 20 77 68 65 6e 20 63 6c 6f  deleted when clo
08f0: 73 65 64 2e 0a 2a 2f 0a 44 62 62 65 54 61 62 6c  sed..*/.DbbeTabl
0900: 65 20 2a 73 71 6c 69 74 65 44 62 62 65 4f 70 65  e *sqliteDbbeOpe
0910: 6e 54 61 62 6c 65 28 44 62 62 65 2a 2c 20 63 6f  nTable(Dbbe*, co
0920: 6e 73 74 20 63 68 61 72 20 2a 7a 54 61 62 6c 65  nst char *zTable
0930: 4e 61 6d 65 2c 20 69 6e 74 20 77 72 69 74 65 61  Name, int writea
0940: 62 6c 65 29 3b 0a 0a 2f 2a 20 44 65 6c 65 74 65  ble);../* Delete
0950: 20 61 20 74 61 62 6c 65 20 66 72 6f 6d 20 74 68   a table from th
0960: 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 76 6f  e database */.vo
0970: 69 64 20 73 71 6c 69 74 65 44 62 62 65 44 72 6f  id sqliteDbbeDro
0980: 70 54 61 62 6c 65 28 44 62 62 65 2a 2c 20 63 6f  pTable(Dbbe*, co
0990: 6e 73 74 20 63 68 61 72 20 2a 7a 54 61 62 6c 65  nst char *zTable
09a0: 4e 61 6d 65 29 3b 0a 0a 2f 2a 20 52 65 6f 72 67  Name);../* Reorg
09b0: 61 6e 69 7a 65 20 61 20 74 61 62 6c 65 20 74 6f  anize a table to
09c0: 20 73 70 65 65 64 20 61 63 63 65 73 73 20 6f 72   speed access or
09d0: 20 72 65 64 75 63 65 20 69 74 73 20 64 69 73 6b   reduce its disk
09e0: 20 75 73 61 67 65 20 2a 2f 0a 76 6f 69 64 20 73   usage */.void s
09f0: 71 6c 69 74 65 44 62 62 65 52 65 6f 72 67 61 6e  qliteDbbeReorgan
0a00: 69 7a 65 54 61 62 6c 65 28 44 62 62 65 2a 2c 20  izeTable(Dbbe*, 
0a10: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 61 62  const char *zTab
0a20: 6c 65 4e 61 6d 65 29 3b 0a 0a 2f 2a 20 43 6c 6f  leName);../* Clo
0a30: 73 65 20 61 20 74 61 62 6c 65 20 2a 2f 0a 76 6f  se a table */.vo
0a40: 69 64 20 73 71 6c 69 74 65 44 62 62 65 43 6c 6f  id sqliteDbbeClo
0a50: 73 65 54 61 62 6c 65 28 44 62 62 65 54 61 62 6c  seTable(DbbeTabl
0a60: 65 2a 29 3b 0a 0a 2f 2a 20 46 65 74 63 68 20 61  e*);../* Fetch a
0a70: 6e 20 65 6e 74 72 79 20 66 72 6f 6d 20 61 20 74  n entry from a t
0a80: 61 62 6c 65 20 77 69 74 68 20 74 68 65 20 67 69  able with the gi
0a90: 76 65 6e 20 6b 65 79 2e 20 20 52 65 74 75 72 6e  ven key.  Return
0aa0: 20 31 20 69 66 0a 2a 2a 20 73 75 63 63 65 73 73   1 if.** success
0ab0: 66 75 6c 20 61 6e 64 20 30 20 69 66 20 6e 6f 20  ful and 0 if no 
0ac0: 73 75 63 68 20 65 6e 74 72 79 20 65 78 69 73 74  such entry exist
0ad0: 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  s..*/.int sqlite
0ae0: 44 62 62 65 46 65 74 63 68 28 44 62 62 65 54 61  DbbeFetch(DbbeTa
0af0: 62 6c 65 2a 2c 20 69 6e 74 20 6e 4b 65 79 2c 20  ble*, int nKey, 
0b00: 63 68 61 72 20 2a 70 4b 65 79 29 3b 0a 0a 2f 2a  char *pKey);../*
0b10: 20 52 65 74 75 72 6e 20 31 20 69 66 20 74 68 65   Return 1 if the
0b20: 20 67 69 76 65 6e 20 6b 65 79 20 69 73 20 61 6c   given key is al
0b30: 72 65 61 64 79 20 69 6e 20 74 68 65 20 74 61 62  ready in the tab
0b40: 6c 65 2e 20 20 52 65 74 75 72 6e 20 30 0a 2a 2a  le.  Return 0.**
0b50: 20 69 66 20 69 74 20 69 73 20 6e 6f 74 2e 0a 2a   if it is not..*
0b60: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 44 62 62 65  /.int sqliteDbbe
0b70: 54 65 73 74 28 44 62 62 65 54 61 62 6c 65 2a 2c  Test(DbbeTable*,
0b80: 20 69 6e 74 20 6e 4b 65 79 2c 20 63 68 61 72 20   int nKey, char 
0b90: 2a 70 4b 65 79 29 3b 0a 0a 2f 2a 20 52 65 74 72  *pKey);../* Retr
0ba0: 69 65 76 65 20 74 68 65 20 6b 65 79 20 6f 72 20  ieve the key or 
0bb0: 64 61 74 61 20 75 73 65 64 20 66 6f 72 20 74 68  data used for th
0bc0: 65 20 6c 61 73 74 20 66 65 74 63 68 2e 20 20 4f  e last fetch.  O
0bd0: 6e 6c 79 20 73 69 7a 65 0a 2a 2a 20 62 79 74 65  nly size.** byte
0be0: 73 20 61 72 65 20 72 65 61 64 20 62 65 67 69 6e  s are read begin
0bf0: 6e 69 6e 67 20 77 69 74 68 20 74 68 65 20 6f 66  ning with the of
0c00: 66 73 65 74 2d 74 68 20 62 79 74 65 2e 20 20 54  fset-th byte.  T
0c10: 68 65 20 72 65 74 75 72 6e 0a 2a 2a 20 76 61 6c  he return.** val
0c20: 75 65 20 69 73 20 74 68 65 20 61 63 74 75 61 6c  ue is the actual
0c30: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   number of bytes
0c40: 20 72 65 61 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71   read..*/.int sq
0c50: 6c 69 74 65 44 62 62 65 43 6f 70 79 4b 65 79 28  liteDbbeCopyKey(
0c60: 44 62 62 65 54 61 62 6c 65 2a 2c 20 69 6e 74 20  DbbeTable*, int 
0c70: 6f 66 66 73 65 74 2c 20 69 6e 74 20 73 69 7a 65  offset, int size
0c80: 2c 20 63 68 61 72 20 2a 7a 42 75 66 29 3b 0a 69  , char *zBuf);.i
0c90: 6e 74 20 73 71 6c 69 74 65 44 62 62 65 43 6f 70  nt sqliteDbbeCop
0ca0: 79 44 61 74 61 28 44 62 62 65 54 61 62 6c 65 2a  yData(DbbeTable*
0cb0: 2c 20 69 6e 74 20 6f 66 66 73 65 74 2c 20 69 6e  , int offset, in
0cc0: 74 20 73 69 7a 65 2c 20 63 68 61 72 20 2a 7a 42  t size, char *zB
0cd0: 75 66 29 3b 0a 0a 2f 2a 20 52 65 74 72 69 65 76  uf);../* Retriev
0ce0: 65 20 74 68 65 20 6b 65 79 20 6f 72 20 64 61 74  e the key or dat
0cf0: 61 2e 20 20 54 68 65 20 72 65 73 75 6c 74 20 69  a.  The result i
0d00: 73 20 65 70 68 65 6d 65 72 61 6c 2e 0a 2a 2f 0a  s ephemeral..*/.
0d10: 63 68 61 72 20 2a 73 71 6c 69 74 65 44 62 62 65  char *sqliteDbbe
0d20: 52 65 61 64 4b 65 79 28 44 62 62 65 54 61 62 6c  ReadKey(DbbeTabl
0d30: 65 2a 2c 20 69 6e 74 20 6f 66 66 73 65 74 29 3b  e*, int offset);
0d40: 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 44 62 62  .char *sqliteDbb
0d50: 65 52 65 61 64 44 61 74 61 28 44 62 62 65 54 61  eReadData(DbbeTa
0d60: 62 6c 65 2a 2c 20 69 6e 74 20 6f 66 66 73 65 74  ble*, int offset
0d70: 29 3b 0a 0a 2f 2a 20 52 65 74 75 72 6e 20 74 68  );../* Return th
0d80: 65 20 6c 65 6e 67 74 68 20 6f 66 20 74 68 65 20  e length of the 
0d90: 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 66 65  most recently fe
0da0: 74 63 68 65 64 20 6b 65 79 20 6f 72 20 64 61 74  tched key or dat
0db0: 61 2e 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  a. */.int sqlite
0dc0: 44 62 62 65 4b 65 79 4c 65 6e 67 74 68 28 44 62  DbbeKeyLength(Db
0dd0: 62 65 54 61 62 6c 65 2a 29 3b 0a 69 6e 74 20 73  beTable*);.int s
0de0: 71 6c 69 74 65 44 62 62 65 44 61 74 61 4c 65 6e  qliteDbbeDataLen
0df0: 67 74 68 28 44 62 62 65 54 61 62 6c 65 2a 29 3b  gth(DbbeTable*);
0e00: 0a 0a 2f 2a 20 52 65 74 72 69 65 76 65 20 74 68  ../* Retrieve th
0e10: 65 20 6e 65 78 74 20 65 6e 74 72 79 20 69 6e 20  e next entry in 
0e20: 74 68 65 20 74 61 62 6c 65 2e 20 20 54 68 65 20  the table.  The 
0e30: 66 69 72 73 74 20 6b 65 79 20 69 73 20 72 65 74  first key is ret
0e40: 72 69 65 76 65 64 0a 2a 2a 20 74 68 65 20 66 69  rieved.** the fi
0e50: 72 73 74 20 74 69 6d 65 20 74 68 69 73 20 72 6f  rst time this ro
0e60: 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2c  utine is called,
0e70: 20 6f 72 20 61 66 74 65 72 20 61 20 63 61 6c 6c   or after a call
0e80: 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 44 62 62   to.** sqliteDbb
0e90: 65 52 65 77 69 6e 64 28 29 2e 20 20 54 68 65 20  eRewind().  The 
0ea0: 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20  return value is 
0eb0: 31 20 69 66 20 74 68 65 72 65 20 69 73 20 61 6e  1 if there is an
0ec0: 6f 74 68 65 72 0a 2a 2a 20 65 6e 74 72 79 2c 20  other.** entry, 
0ed0: 6f 72 20 30 20 69 66 20 74 68 65 72 65 20 61 72  or 0 if there ar
0ee0: 65 20 6e 6f 20 6d 6f 72 65 20 65 6e 74 72 69 65  e no more entrie
0ef0: 73 2e 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  s. */.int sqlite
0f00: 44 62 62 65 4e 65 78 74 4b 65 79 28 44 62 62 65  DbbeNextKey(Dbbe
0f10: 54 61 62 6c 65 2a 29 3b 0a 0a 2f 2a 20 4d 61 6b  Table*);../* Mak
0f20: 65 20 69 74 20 73 6f 20 74 68 61 74 20 74 68 65  e it so that the
0f30: 20 6e 65 78 74 20 63 61 6c 6c 20 74 6f 20 73 71   next call to sq
0f40: 6c 69 74 65 44 62 62 65 4e 65 78 74 4b 65 79 28  liteDbbeNextKey(
0f50: 29 20 72 65 74 75 72 6e 73 0a 2a 2a 20 74 68 65  ) returns.** the
0f60: 20 66 69 72 73 74 20 65 6e 74 72 79 20 6f 66 20   first entry of 
0f70: 74 68 65 20 74 61 62 6c 65 2e 20 2a 2f 0a 69 6e  the table. */.in
0f80: 74 20 73 71 6c 69 74 65 44 62 62 65 52 65 77 69  t sqliteDbbeRewi
0f90: 6e 64 28 44 62 62 65 54 61 62 6c 65 2a 29 3b 0a  nd(DbbeTable*);.
0fa0: 0a 2f 2a 20 47 65 74 20 61 20 6e 65 77 20 69 6e  ./* Get a new in
0fb0: 74 65 67 65 72 20 6b 65 79 20 66 6f 72 20 74 68  teger key for th
0fc0: 69 73 20 74 61 62 6c 65 2e 20 2a 2f 0a 69 6e 74  is table. */.int
0fd0: 20 73 71 6c 69 74 65 44 62 62 65 4e 65 77 28 44   sqliteDbbeNew(D
0fe0: 62 62 65 54 61 62 6c 65 2a 29 3b 0a 0a 2f 2a 20  bbeTable*);../* 
0ff0: 57 72 69 74 65 20 61 6e 20 65 6e 74 72 79 20 69  Write an entry i
1000: 6e 74 6f 20 61 20 74 61 62 6c 65 2e 20 20 49 66  nto a table.  If
1010: 20 61 6e 6f 74 68 65 72 20 65 6e 74 72 79 20 61   another entry a
1020: 6c 72 65 61 64 79 20 65 78 69 73 74 73 20 77 69  lready exists wi
1030: 74 68 0a 2a 2a 20 74 68 65 20 73 61 6d 65 20 6b  th.** the same k
1040: 65 79 2c 20 74 68 65 20 6f 6c 64 20 65 6e 74 72  ey, the old entr
1050: 79 20 69 73 20 64 69 73 63 61 72 64 65 64 20 66  y is discarded f
1060: 69 72 73 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  irst..*/.int sql
1070: 69 74 65 44 62 62 65 50 75 74 28 44 62 62 65 54  iteDbbePut(DbbeT
1080: 61 62 6c 65 2a 2c 20 69 6e 74 20 6e 4b 65 79 2c  able*, int nKey,
1090: 20 63 68 61 72 20 2a 70 4b 65 79 2c 20 69 6e 74   char *pKey, int
10a0: 20 6e 44 61 74 61 2c 20 63 68 61 72 20 2a 70 44   nData, char *pD
10b0: 61 74 61 29 3b 0a 0a 2f 2a 20 52 65 6d 6f 76 65  ata);../* Remove
10c0: 20 61 6e 20 65 6e 74 72 79 20 66 72 6f 6d 20 74   an entry from t
10d0: 68 65 20 74 61 62 6c 65 20 2a 2f 0a 69 6e 74 20  he table */.int 
10e0: 73 71 6c 69 74 65 44 62 62 65 44 65 6c 65 74 65  sqliteDbbeDelete
10f0: 28 44 62 62 65 54 61 62 6c 65 2a 2c 20 69 6e 74  (DbbeTable*, int
1100: 20 6e 4b 65 79 2c 20 63 68 61 72 20 2a 70 4b 65   nKey, char *pKe
1110: 79 29 3b 0a 0a 2f 2a 20 4f 70 65 6e 20 61 20 66  y);../* Open a f
1120: 69 6c 65 20 73 75 69 74 61 62 6c 65 20 66 6f 72  ile suitable for
1130: 20 74 65 6d 70 6f 72 61 72 79 20 73 74 6f 72 61   temporary stora
1140: 67 65 20 2a 2f 0a 46 49 4c 45 20 2a 73 71 6c 69  ge */.FILE *sqli
1150: 74 65 44 62 62 65 4f 70 65 6e 54 65 6d 70 46 69  teDbbeOpenTempFi
1160: 6c 65 28 44 62 62 65 2a 29 3b 0a 0a 2f 2a 20 43  le(Dbbe*);../* C
1170: 6c 6f 73 65 20 61 20 74 65 6d 70 6f 72 61 72 79  lose a temporary
1180: 20 66 69 6c 65 20 2a 2f 0a 76 6f 69 64 20 73 71   file */.void sq
1190: 6c 69 74 65 44 62 62 65 43 6c 6f 73 65 54 65 6d  liteDbbeCloseTem
11a0: 70 46 69 6c 65 28 44 62 62 65 20 2a 2c 20 46 49  pFile(Dbbe *, FI
11b0: 4c 45 20 2a 29 3b 0a 0a 23 65 6e 64 69 66 20 2f  LE *);..#endif /
11c0: 2a 20 64 65 66 69 6e 65 64 28 5f 53 51 4c 49 54  * defined(_SQLIT
11d0: 45 5f 44 42 42 45 5f 48 5f 29 20 2a 2f 0a        E_DBBE_H_) */.