/ Hex Artifact Content
Login

Artifact cc86ad3d6ad54df7c63a3e807b5783c90411a08d:


0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65  /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68  mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69  e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20  ms copyright to 
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65  this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a  .  In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65  * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73  , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d  sing:.**.**    M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61  ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20  nd not evil..** 
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20     May you find 
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20  forgiveness for 
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72  yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20  give others..** 
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65     May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74   freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20  aking more than 
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a  you give..**.***
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: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66  ******.** This f
0180: 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 74 68 65  ile contains the
0190: 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 74 61 62   sqlite3_get_tab
01a0: 6c 65 28 29 20 61 6e 64 20 73 71 6c 69 74 65 33  le() and sqlite3
01b0: 5f 66 72 65 65 5f 74 61 62 6c 65 28 29 0a 2a 2a  _free_table().**
01c0: 20 69 6e 74 65 72 66 61 63 65 20 72 6f 75 74 69   interface routi
01d0: 6e 65 73 2e 20 20 54 68 65 73 65 20 61 72 65 20  nes.  These are 
01e0: 6a 75 73 74 20 77 72 61 70 70 65 72 73 20 61 72  just wrappers ar
01f0: 6f 75 6e 64 20 74 68 65 20 6d 61 69 6e 0a 2a 2a  ound the main.**
0200: 20 69 6e 74 65 72 66 61 63 65 20 72 6f 75 74 69   interface routi
0210: 6e 65 20 6f 66 20 73 71 6c 69 74 65 33 5f 65 78  ne of sqlite3_ex
0220: 65 63 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 73  ec()..**.** Thes
0230: 65 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 69  e routines are i
0240: 6e 20 61 20 73 65 70 61 72 61 74 65 20 66 69 6c  n a separate fil
0250: 65 73 20 73 6f 20 74 68 61 74 20 74 68 65 79 20  es so that they 
0260: 77 69 6c 6c 20 6e 6f 74 20 62 65 20 6c 69 6e 6b  will not be link
0270: 65 64 0a 2a 2a 20 69 66 20 74 68 65 79 20 61 72  ed.** if they ar
0280: 65 20 6e 6f 74 20 75 73 65 64 2e 0a 2a 2a 0a 2a  e not used..**.*
0290: 2a 20 24 49 64 3a 20 74 61 62 6c 65 2e 63 2c 76  * $Id: table.c,v
02a0: 20 31 2e 34 30 20 32 30 30 39 2f 30 34 2f 31 30   1.40 2009/04/10
02b0: 20 31 34 3a 32 38 3a 30 30 20 64 72 68 20 45 78   14:28:00 drh Ex
02c0: 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20  p $.*/.#include 
02d0: 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69  "sqliteInt.h".#i
02e0: 6e 63 6c 75 64 65 20 3c 73 74 64 6c 69 62 2e 68  nclude <stdlib.h
02f0: 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 72 69  >.#include <stri
0300: 6e 67 2e 68 3e 0a 0a 23 69 66 6e 64 65 66 20 53  ng.h>..#ifndef S
0310: 51 4c 49 54 45 5f 4f 4d 49 54 5f 47 45 54 5f 54  QLITE_OMIT_GET_T
0320: 41 42 4c 45 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  ABLE../*.** This
0330: 20 73 74 72 75 63 74 75 72 65 20 69 73 20 75 73   structure is us
0340: 65 64 20 74 6f 20 70 61 73 73 20 64 61 74 61 20  ed to pass data 
0350: 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 67 65 74  from sqlite3_get
0360: 5f 74 61 62 6c 65 28 29 20 74 68 72 6f 75 67 68  _table() through
0370: 0a 2a 2a 20 74 6f 20 74 68 65 20 63 61 6c 6c 62  .** to the callb
0380: 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  ack function is 
0390: 75 73 65 73 20 74 6f 20 62 75 69 6c 64 20 74 68  uses to build th
03a0: 65 20 72 65 73 75 6c 74 2e 0a 2a 2f 0a 74 79 70  e result..*/.typ
03b0: 65 64 65 66 20 73 74 72 75 63 74 20 54 61 62 52  edef struct TabR
03c0: 65 73 75 6c 74 20 7b 0a 20 20 63 68 61 72 20 2a  esult {.  char *
03d0: 2a 61 7a 52 65 73 75 6c 74 3b 20 20 20 2f 2a 20  *azResult;   /* 
03e0: 41 63 63 75 6d 75 6c 61 74 65 64 20 6f 75 74 70  Accumulated outp
03f0: 75 74 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 45  ut */.  char *zE
0400: 72 72 4d 73 67 3b 20 20 20 20 20 2f 2a 20 45 72  rrMsg;     /* Er
0410: 72 6f 72 20 6d 65 73 73 61 67 65 20 74 65 78 74  ror message text
0420: 2c 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63  , if an error oc
0430: 63 75 72 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 41  curs */.  int nA
0440: 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 2f 2a 20  lloc;        /* 
0450: 53 6c 6f 74 73 20 61 6c 6c 6f 63 61 74 65 64 20  Slots allocated 
0460: 66 6f 72 20 61 7a 52 65 73 75 6c 74 5b 5d 20 2a  for azResult[] *
0470: 2f 0a 20 20 69 6e 74 20 6e 52 6f 77 3b 20 20 20  /.  int nRow;   
0480: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
0490: 20 6f 66 20 72 6f 77 73 20 69 6e 20 74 68 65 20   of rows in the 
04a0: 72 65 73 75 6c 74 20 2a 2f 0a 20 20 69 6e 74 20  result */.  int 
04b0: 6e 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 2f  nColumn;       /
04c0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75  * Number of colu
04d0: 6d 6e 73 20 69 6e 20 74 68 65 20 72 65 73 75 6c  mns in the resul
04e0: 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 44 61 74 61  t */.  int nData
04f0: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53 6c 6f  ;         /* Slo
0500: 74 73 20 75 73 65 64 20 69 6e 20 61 7a 52 65 73  ts used in azRes
0510: 75 6c 74 5b 5d 2e 20 20 28 6e 52 6f 77 2b 31 29  ult[].  (nRow+1)
0520: 2a 6e 43 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 69 6e  *nColumn */.  in
0530: 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20  t rc;           
0540: 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20   /* Return code 
0550: 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 65 78 65  from sqlite3_exe
0560: 63 28 29 20 2a 2f 0a 7d 20 54 61 62 52 65 73 75  c() */.} TabResu
0570: 6c 74 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  lt;../*.** This 
0580: 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65  routine is calle
0590: 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 20  d once for each 
05a0: 72 6f 77 20 69 6e 20 74 68 65 20 72 65 73 75 6c  row in the resul
05b0: 74 20 74 61 62 6c 65 2e 20 20 49 74 73 20 6a 6f  t table.  Its jo
05c0: 62 0a 2a 2a 20 69 73 20 74 6f 20 66 69 6c 6c 20  b.** is to fill 
05d0: 69 6e 20 74 68 65 20 54 61 62 52 65 73 75 6c 74  in the TabResult
05e0: 20 73 74 72 75 63 74 75 72 65 20 61 70 70 72 6f   structure appro
05f0: 70 72 69 61 74 65 6c 79 2c 20 61 6c 6c 6f 63 61  priately, alloca
0600: 74 69 6e 67 20 6e 65 77 0a 2a 2a 20 6d 65 6d 6f  ting new.** memo
0610: 72 79 20 61 73 20 6e 65 63 65 73 73 61 72 79 2e  ry as necessary.
0620: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73  .*/.static int s
0630: 71 6c 69 74 65 33 5f 67 65 74 5f 74 61 62 6c 65  qlite3_get_table
0640: 5f 63 62 28 76 6f 69 64 20 2a 70 41 72 67 2c 20  _cb(void *pArg, 
0650: 69 6e 74 20 6e 43 6f 6c 2c 20 63 68 61 72 20 2a  int nCol, char *
0660: 2a 61 72 67 76 2c 20 63 68 61 72 20 2a 2a 63 6f  *argv, char **co
0670: 6c 76 29 7b 0a 20 20 54 61 62 52 65 73 75 6c 74  lv){.  TabResult
0680: 20 2a 70 20 3d 20 28 54 61 62 52 65 73 75 6c 74   *p = (TabResult
0690: 2a 29 70 41 72 67 3b 20 20 2f 2a 20 52 65 73 75  *)pArg;  /* Resu
06a0: 6c 74 20 61 63 63 75 6d 75 6c 61 74 6f 72 20 2a  lt accumulator *
06b0: 2f 0a 20 20 69 6e 74 20 6e 65 65 64 3b 20 20 20  /.  int need;   
06c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
06d0: 20 20 20 20 20 20 2f 2a 20 53 6c 6f 74 73 20 6e        /* Slots n
06e0: 65 65 64 65 64 20 69 6e 20 70 2d 3e 61 7a 52 65  eeded in p->azRe
06f0: 73 75 6c 74 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20  sult[] */.  int 
0700: 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  i;              
0710: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
0720: 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f   Loop counter */
0730: 0a 20 20 63 68 61 72 20 2a 7a 3b 20 20 20 20 20  .  char *z;     
0740: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0750: 20 20 20 20 20 2f 2a 20 41 20 73 69 6e 67 6c 65       /* A single
0760: 20 63 6f 6c 75 6d 6e 20 6f 66 20 72 65 73 75 6c   column of resul
0770: 74 20 2a 2f 0a 0a 20 20 2f 2a 20 4d 61 6b 65 20  t */..  /* Make 
0780: 73 75 72 65 20 74 68 65 72 65 20 69 73 20 65 6e  sure there is en
0790: 6f 75 67 68 20 73 70 61 63 65 20 69 6e 20 70 2d  ough space in p-
07a0: 3e 61 7a 52 65 73 75 6c 74 20 74 6f 20 68 6f 6c  >azResult to hol
07b0: 64 20 65 76 65 72 79 74 68 69 6e 67 0a 20 20 2a  d everything.  *
07c0: 2a 20 77 65 20 6e 65 65 64 20 74 6f 20 72 65 6d  * we need to rem
07d0: 65 6d 62 65 72 20 66 72 6f 6d 20 74 68 69 73 20  ember from this 
07e0: 69 6e 76 6f 63 61 74 69 6f 6e 20 6f 66 20 74 68  invocation of th
07f0: 65 20 63 61 6c 6c 62 61 63 6b 2e 0a 20 20 2a 2f  e callback..  */
0800: 0a 20 20 69 66 28 20 70 2d 3e 6e 52 6f 77 3d 3d  .  if( p->nRow==
0810: 30 20 26 26 20 61 72 67 76 21 3d 30 20 29 7b 0a  0 && argv!=0 ){.
0820: 20 20 20 20 6e 65 65 64 20 3d 20 6e 43 6f 6c 2a      need = nCol*
0830: 32 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  2;.  }else{.    
0840: 6e 65 65 64 20 3d 20 6e 43 6f 6c 3b 0a 20 20 7d  need = nCol;.  }
0850: 0a 20 20 69 66 28 20 70 2d 3e 6e 44 61 74 61 20  .  if( p->nData 
0860: 2b 20 6e 65 65 64 20 3e 20 70 2d 3e 6e 41 6c 6c  + need > p->nAll
0870: 6f 63 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a  oc ){.    char *
0880: 2a 61 7a 4e 65 77 3b 0a 20 20 20 20 70 2d 3e 6e  *azNew;.    p->n
0890: 41 6c 6c 6f 63 20 3d 20 70 2d 3e 6e 41 6c 6c 6f  Alloc = p->nAllo
08a0: 63 2a 32 20 2b 20 6e 65 65 64 3b 0a 20 20 20 20  c*2 + need;.    
08b0: 61 7a 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 5f  azNew = sqlite3_
08c0: 72 65 61 6c 6c 6f 63 28 20 70 2d 3e 61 7a 52 65  realloc( p->azRe
08d0: 73 75 6c 74 2c 20 73 69 7a 65 6f 66 28 63 68 61  sult, sizeof(cha
08e0: 72 2a 29 2a 70 2d 3e 6e 41 6c 6c 6f 63 20 29 3b  r*)*p->nAlloc );
08f0: 0a 20 20 20 20 69 66 28 20 61 7a 4e 65 77 3d 3d  .    if( azNew==
0900: 30 20 29 20 67 6f 74 6f 20 6d 61 6c 6c 6f 63 5f  0 ) goto malloc_
0910: 66 61 69 6c 65 64 3b 0a 20 20 20 20 70 2d 3e 61  failed;.    p->a
0920: 7a 52 65 73 75 6c 74 20 3d 20 61 7a 4e 65 77 3b  zResult = azNew;
0930: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68  .  }..  /* If th
0940: 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20  is is the first 
0950: 72 6f 77 2c 20 74 68 65 6e 20 67 65 6e 65 72 61  row, then genera
0960: 74 65 20 61 6e 20 65 78 74 72 61 20 72 6f 77 20  te an extra row 
0970: 63 6f 6e 74 61 69 6e 69 6e 67 0a 20 20 2a 2a 20  containing.  ** 
0980: 74 68 65 20 6e 61 6d 65 73 20 6f 66 20 61 6c 6c  the names of all
0990: 20 63 6f 6c 75 6d 6e 73 2e 0a 20 20 2a 2f 0a 20   columns..  */. 
09a0: 20 69 66 28 20 70 2d 3e 6e 52 6f 77 3d 3d 30 20   if( p->nRow==0 
09b0: 29 7b 0a 20 20 20 20 70 2d 3e 6e 43 6f 6c 75 6d  ){.    p->nColum
09c0: 6e 20 3d 20 6e 43 6f 6c 3b 0a 20 20 20 20 66 6f  n = nCol;.    fo
09d0: 72 28 69 3d 30 3b 20 69 3c 6e 43 6f 6c 3b 20 69  r(i=0; i<nCol; i
09e0: 2b 2b 29 7b 0a 20 20 20 20 20 20 7a 20 3d 20 73  ++){.      z = s
09f0: 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22  qlite3_mprintf("
0a00: 25 73 22 2c 20 63 6f 6c 76 5b 69 5d 29 3b 0a 20  %s", colv[i]);. 
0a10: 20 20 20 20 20 69 66 28 20 7a 3d 3d 30 20 29 20       if( z==0 ) 
0a20: 67 6f 74 6f 20 6d 61 6c 6c 6f 63 5f 66 61 69 6c  goto malloc_fail
0a30: 65 64 3b 0a 20 20 20 20 20 20 70 2d 3e 61 7a 52  ed;.      p->azR
0a40: 65 73 75 6c 74 5b 70 2d 3e 6e 44 61 74 61 2b 2b  esult[p->nData++
0a50: 5d 20 3d 20 7a 3b 0a 20 20 20 20 7d 0a 20 20 7d  ] = z;.    }.  }
0a60: 65 6c 73 65 20 69 66 28 20 70 2d 3e 6e 43 6f 6c  else if( p->nCol
0a70: 75 6d 6e 21 3d 6e 43 6f 6c 20 29 7b 0a 20 20 20  umn!=nCol ){.   
0a80: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 2d   sqlite3_free(p-
0a90: 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 70  >zErrMsg);.    p
0aa0: 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69  ->zErrMsg = sqli
0ab0: 74 65 33 5f 6d 70 72 69 6e 74 66 28 0a 20 20 20  te3_mprintf(.   
0ac0: 20 20 20 20 22 73 71 6c 69 74 65 33 5f 67 65 74      "sqlite3_get
0ad0: 5f 74 61 62 6c 65 28 29 20 63 61 6c 6c 65 64 20  _table() called 
0ae0: 77 69 74 68 20 74 77 6f 20 6f 72 20 6d 6f 72 65  with two or more
0af0: 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 71 75   incompatible qu
0b00: 65 72 69 65 73 22 0a 20 20 20 20 29 3b 0a 20 20  eries".    );.  
0b10: 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45    p->rc = SQLITE
0b20: 5f 45 52 52 4f 52 3b 0a 20 20 20 20 72 65 74 75  _ERROR;.    retu
0b30: 72 6e 20 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  rn 1;.  }..  /* 
0b40: 43 6f 70 79 20 6f 76 65 72 20 74 68 65 20 72 6f  Copy over the ro
0b50: 77 20 64 61 74 61 0a 20 20 2a 2f 0a 20 20 69 66  w data.  */.  if
0b60: 28 20 61 72 67 76 21 3d 30 20 29 7b 0a 20 20 20  ( argv!=0 ){.   
0b70: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 6f 6c   for(i=0; i<nCol
0b80: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66  ; i++){.      if
0b90: 28 20 61 72 67 76 5b 69 5d 3d 3d 30 20 29 7b 0a  ( argv[i]==0 ){.
0ba0: 20 20 20 20 20 20 20 20 7a 20 3d 20 30 3b 0a 20          z = 0;. 
0bb0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
0bc0: 20 20 20 20 69 6e 74 20 6e 20 3d 20 73 71 6c 69      int n = sqli
0bd0: 74 65 33 53 74 72 6c 65 6e 33 30 28 61 72 67 76  te3Strlen30(argv
0be0: 5b 69 5d 29 2b 31 3b 0a 20 20 20 20 20 20 20 20  [i])+1;.        
0bf0: 7a 20 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c  z = sqlite3_mall
0c00: 6f 63 28 20 6e 20 29 3b 0a 20 20 20 20 20 20 20  oc( n );.       
0c10: 20 69 66 28 20 7a 3d 3d 30 20 29 20 67 6f 74 6f   if( z==0 ) goto
0c20: 20 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 3b 0a   malloc_failed;.
0c30: 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 7a          memcpy(z
0c40: 2c 20 61 72 67 76 5b 69 5d 2c 20 6e 29 3b 0a 20  , argv[i], n);. 
0c50: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 2d 3e       }.      p->
0c60: 61 7a 52 65 73 75 6c 74 5b 70 2d 3e 6e 44 61 74  azResult[p->nDat
0c70: 61 2b 2b 5d 20 3d 20 7a 3b 0a 20 20 20 20 7d 0a  a++] = z;.    }.
0c80: 20 20 20 20 70 2d 3e 6e 52 6f 77 2b 2b 3b 0a 20      p->nRow++;. 
0c90: 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 0a   }.  return 0;..
0ca0: 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 3a 0a 20  malloc_failed:. 
0cb0: 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f   p->rc = SQLITE_
0cc0: 4e 4f 4d 45 4d 3b 0a 20 20 72 65 74 75 72 6e 20  NOMEM;.  return 
0cd0: 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 51 75 65 72  1;.}../*.** Quer
0ce0: 79 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20  y the database. 
0cf0: 20 42 75 74 20 69 6e 73 74 65 61 64 20 6f 66 20   But instead of 
0d00: 69 6e 76 6f 6b 69 6e 67 20 61 20 63 61 6c 6c 62  invoking a callb
0d10: 61 63 6b 20 66 6f 72 20 65 61 63 68 20 72 6f 77  ack for each row
0d20: 2c 0a 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 66 6f  ,.** malloc() fo
0d30: 72 20 73 70 61 63 65 20 74 6f 20 68 6f 6c 64 20  r space to hold 
0d40: 74 68 65 20 72 65 73 75 6c 74 20 61 6e 64 20 72  the result and r
0d50: 65 74 75 72 6e 20 74 68 65 20 65 6e 74 69 72 65  eturn the entire
0d60: 20 72 65 73 75 6c 74 73 0a 2a 2a 20 61 74 20 74   results.** at t
0d70: 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66  he conclusion of
0d80: 20 74 68 65 20 63 61 6c 6c 2e 0a 2a 2a 0a 2a 2a   the call..**.**
0d90: 20 54 68 65 20 72 65 73 75 6c 74 20 74 68 61 74   The result that
0da0: 20 69 73 20 77 72 69 74 74 65 6e 20 74 6f 20 2a   is written to *
0db0: 2a 2a 70 61 7a 52 65 73 75 6c 74 20 69 73 20 68  **pazResult is h
0dc0: 65 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 6f 62  eld in memory ob
0dd0: 74 61 69 6e 65 64 0a 2a 2a 20 66 72 6f 6d 20 6d  tained.** from m
0de0: 61 6c 6c 6f 63 28 29 2e 20 20 42 75 74 20 74 68  alloc().  But th
0df0: 65 20 63 61 6c 6c 65 72 20 63 61 6e 6e 6f 74 20  e caller cannot 
0e00: 66 72 65 65 20 74 68 69 73 20 6d 65 6d 6f 72 79  free this memory
0e10: 20 64 69 72 65 63 74 6c 79 2e 20 20 0a 2a 2a 20   directly.  .** 
0e20: 49 6e 73 74 65 61 64 2c 20 74 68 65 20 65 6e 74  Instead, the ent
0e30: 69 72 65 20 74 61 62 6c 65 20 73 68 6f 75 6c 64  ire table should
0e40: 20 62 65 20 70 61 73 73 65 64 20 74 6f 20 73 71   be passed to sq
0e50: 6c 69 74 65 33 5f 66 72 65 65 5f 74 61 62 6c 65  lite3_free_table
0e60: 28 29 20 77 68 65 6e 0a 2a 2a 20 74 68 65 20 63  () when.** the c
0e70: 61 6c 6c 69 6e 67 20 70 72 6f 63 65 64 75 72 65  alling procedure
0e80: 20 69 73 20 66 69 6e 69 73 68 65 64 20 75 73 69   is finished usi
0e90: 6e 67 20 69 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71  ng it..*/.int sq
0ea0: 6c 69 74 65 33 5f 67 65 74 5f 74 61 62 6c 65 28  lite3_get_table(
0eb0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  .  sqlite3 *db, 
0ec0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
0ed0: 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 6f  * The database o
0ee0: 6e 20 77 68 69 63 68 20 74 68 65 20 53 51 4c 20  n which the SQL 
0ef0: 65 78 65 63 75 74 65 73 20 2a 2f 0a 20 20 63 6f  executes */.  co
0f00: 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20  nst char *zSql, 
0f10: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
0f20: 20 53 51 4c 20 74 6f 20 62 65 20 65 78 65 63 75   SQL to be execu
0f30: 74 65 64 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a  ted */.  char **
0f40: 2a 70 61 7a 52 65 73 75 6c 74 2c 20 20 20 20 20  *pazResult,     
0f50: 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 74 68       /* Write th
0f60: 65 20 72 65 73 75 6c 74 20 74 61 62 6c 65 20 68  e result table h
0f70: 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e  ere */.  int *pn
0f80: 52 6f 77 2c 20 20 20 20 20 20 20 20 20 20 20 20  Row,            
0f90: 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 74 68       /* Write th
0fa0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73  e number of rows
0fb0: 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 20 68   in the result h
0fc0: 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e  ere */.  int *pn
0fd0: 43 6f 6c 75 6d 6e 2c 20 20 20 20 20 20 20 20 20  Column,         
0fe0: 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 74 68       /* Write th
0ff0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75  e number of colu
1000: 6d 6e 73 20 6f 66 20 72 65 73 75 6c 74 20 68 65  mns of result he
1010: 72 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70  re */.  char **p
1020: 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20 20 20  zErrMsg         
1030: 20 20 20 20 2f 2a 20 57 72 69 74 65 20 65 72 72      /* Write err
1040: 6f 72 20 6d 65 73 73 61 67 65 73 20 68 65 72 65  or messages here
1050: 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b   */.){.  int rc;
1060: 0a 20 20 54 61 62 52 65 73 75 6c 74 20 72 65 73  .  TabResult res
1070: 3b 0a 0a 20 20 2a 70 61 7a 52 65 73 75 6c 74 20  ;..  *pazResult 
1080: 3d 20 30 3b 0a 20 20 69 66 28 20 70 6e 43 6f 6c  = 0;.  if( pnCol
1090: 75 6d 6e 20 29 20 2a 70 6e 43 6f 6c 75 6d 6e 20  umn ) *pnColumn 
10a0: 3d 20 30 3b 0a 20 20 69 66 28 20 70 6e 52 6f 77  = 0;.  if( pnRow
10b0: 20 29 20 2a 70 6e 52 6f 77 20 3d 20 30 3b 0a 20   ) *pnRow = 0;. 
10c0: 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 20   if( pzErrMsg ) 
10d0: 2a 70 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20  *pzErrMsg = 0;. 
10e0: 20 72 65 73 2e 7a 45 72 72 4d 73 67 20 3d 20 30   res.zErrMsg = 0
10f0: 3b 0a 20 20 72 65 73 2e 6e 52 6f 77 20 3d 20 30  ;.  res.nRow = 0
1100: 3b 0a 20 20 72 65 73 2e 6e 43 6f 6c 75 6d 6e 20  ;.  res.nColumn 
1110: 3d 20 30 3b 0a 20 20 72 65 73 2e 6e 44 61 74 61  = 0;.  res.nData
1120: 20 3d 20 31 3b 0a 20 20 72 65 73 2e 6e 41 6c 6c   = 1;.  res.nAll
1130: 6f 63 20 3d 20 32 30 3b 0a 20 20 72 65 73 2e 72  oc = 20;.  res.r
1140: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
1150: 20 72 65 73 2e 61 7a 52 65 73 75 6c 74 20 3d 20   res.azResult = 
1160: 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 73  sqlite3_malloc(s
1170: 69 7a 65 6f 66 28 63 68 61 72 2a 29 2a 72 65 73  izeof(char*)*res
1180: 2e 6e 41 6c 6c 6f 63 20 29 3b 0a 20 20 69 66 28  .nAlloc );.  if(
1190: 20 72 65 73 2e 61 7a 52 65 73 75 6c 74 3d 3d 30   res.azResult==0
11a0: 20 29 7b 0a 20 20 20 20 20 64 62 2d 3e 65 72 72   ){.     db->err
11b0: 43 6f 64 65 20 3d 20 53 51 4c 49 54 45 5f 4e 4f  Code = SQLITE_NO
11c0: 4d 45 4d 3b 0a 20 20 20 20 20 72 65 74 75 72 6e  MEM;.     return
11d0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
11e0: 20 7d 0a 20 20 72 65 73 2e 61 7a 52 65 73 75 6c   }.  res.azResul
11f0: 74 5b 30 5d 20 3d 20 30 3b 0a 20 20 72 63 20 3d  t[0] = 0;.  rc =
1200: 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 64 62   sqlite3_exec(db
1210: 2c 20 7a 53 71 6c 2c 20 73 71 6c 69 74 65 33 5f  , zSql, sqlite3_
1220: 67 65 74 5f 74 61 62 6c 65 5f 63 62 2c 20 26 72  get_table_cb, &r
1230: 65 73 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20  es, pzErrMsg);. 
1240: 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28   assert( sizeof(
1250: 72 65 73 2e 61 7a 52 65 73 75 6c 74 5b 30 5d 29  res.azResult[0])
1260: 3e 3d 20 73 69 7a 65 6f 66 28 72 65 73 2e 6e 44  >= sizeof(res.nD
1270: 61 74 61 29 20 29 3b 0a 20 20 72 65 73 2e 61 7a  ata) );.  res.az
1280: 52 65 73 75 6c 74 5b 30 5d 20 3d 20 53 51 4c 49  Result[0] = SQLI
1290: 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 72 65  TE_INT_TO_PTR(re
12a0: 73 2e 6e 44 61 74 61 29 3b 0a 20 20 69 66 28 20  s.nData);.  if( 
12b0: 28 72 63 26 30 78 66 66 29 3d 3d 53 51 4c 49 54  (rc&0xff)==SQLIT
12c0: 45 5f 41 42 4f 52 54 20 29 7b 0a 20 20 20 20 73  E_ABORT ){.    s
12d0: 71 6c 69 74 65 33 5f 66 72 65 65 5f 74 61 62 6c  qlite3_free_tabl
12e0: 65 28 26 72 65 73 2e 61 7a 52 65 73 75 6c 74 5b  e(&res.azResult[
12f0: 31 5d 29 3b 0a 20 20 20 20 69 66 28 20 72 65 73  1]);.    if( res
1300: 2e 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20  .zErrMsg ){.    
1310: 20 20 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29    if( pzErrMsg )
1320: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  {.        sqlite
1330: 33 5f 66 72 65 65 28 2a 70 7a 45 72 72 4d 73 67  3_free(*pzErrMsg
1340: 29 3b 0a 20 20 20 20 20 20 20 20 2a 70 7a 45 72  );.        *pzEr
1350: 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d  rMsg = sqlite3_m
1360: 70 72 69 6e 74 66 28 22 25 73 22 2c 72 65 73 2e  printf("%s",res.
1370: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20  zErrMsg);.      
1380: 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  }.      sqlite3_
1390: 66 72 65 65 28 72 65 73 2e 7a 45 72 72 4d 73 67  free(res.zErrMsg
13a0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 62 2d  );.    }.    db-
13b0: 3e 65 72 72 43 6f 64 65 20 3d 20 72 65 73 2e 72  >errCode = res.r
13c0: 63 3b 20 20 2f 2a 20 41 73 73 75 6d 65 20 33 32  c;  /* Assume 32
13d0: 2d 62 69 74 20 61 73 73 69 67 6e 6d 65 6e 74 20  -bit assignment 
13e0: 69 73 20 61 74 6f 6d 69 63 20 2a 2f 0a 20 20 20  is atomic */.   
13f0: 20 72 65 74 75 72 6e 20 72 65 73 2e 72 63 3b 0a   return res.rc;.
1400: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 66 72    }.  sqlite3_fr
1410: 65 65 28 72 65 73 2e 7a 45 72 72 4d 73 67 29 3b  ee(res.zErrMsg);
1420: 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54  .  if( rc!=SQLIT
1430: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69  E_OK ){.    sqli
1440: 74 65 33 5f 66 72 65 65 5f 74 61 62 6c 65 28 26  te3_free_table(&
1450: 72 65 73 2e 61 7a 52 65 73 75 6c 74 5b 31 5d 29  res.azResult[1])
1460: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b  ;.    return rc;
1470: 0a 20 20 7d 0a 20 20 69 66 28 20 72 65 73 2e 6e  .  }.  if( res.n
1480: 41 6c 6c 6f 63 3e 72 65 73 2e 6e 44 61 74 61 20  Alloc>res.nData 
1490: 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 2a 61 7a  ){.    char **az
14a0: 4e 65 77 3b 0a 20 20 20 20 61 7a 4e 65 77 20 3d  New;.    azNew =
14b0: 20 73 71 6c 69 74 65 33 5f 72 65 61 6c 6c 6f 63   sqlite3_realloc
14c0: 28 20 72 65 73 2e 61 7a 52 65 73 75 6c 74 2c 20  ( res.azResult, 
14d0: 73 69 7a 65 6f 66 28 63 68 61 72 2a 29 2a 72 65  sizeof(char*)*re
14e0: 73 2e 6e 44 61 74 61 20 29 3b 0a 20 20 20 20 69  s.nData );.    i
14f0: 66 28 20 61 7a 4e 65 77 3d 3d 30 20 29 7b 0a 20  f( azNew==0 ){. 
1500: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65       sqlite3_fre
1510: 65 5f 74 61 62 6c 65 28 26 72 65 73 2e 61 7a 52  e_table(&res.azR
1520: 65 73 75 6c 74 5b 31 5d 29 3b 0a 20 20 20 20 20  esult[1]);.     
1530: 20 64 62 2d 3e 65 72 72 43 6f 64 65 20 3d 20 53   db->errCode = S
1540: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20  QLITE_NOMEM;.   
1550: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
1560: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20  _NOMEM;.    }.  
1570: 20 20 72 65 73 2e 61 7a 52 65 73 75 6c 74 20 3d    res.azResult =
1580: 20 61 7a 4e 65 77 3b 0a 20 20 7d 0a 20 20 2a 70   azNew;.  }.  *p
1590: 61 7a 52 65 73 75 6c 74 20 3d 20 26 72 65 73 2e  azResult = &res.
15a0: 61 7a 52 65 73 75 6c 74 5b 31 5d 3b 0a 20 20 69  azResult[1];.  i
15b0: 66 28 20 70 6e 43 6f 6c 75 6d 6e 20 29 20 2a 70  f( pnColumn ) *p
15c0: 6e 43 6f 6c 75 6d 6e 20 3d 20 72 65 73 2e 6e 43  nColumn = res.nC
15d0: 6f 6c 75 6d 6e 3b 0a 20 20 69 66 28 20 70 6e 52  olumn;.  if( pnR
15e0: 6f 77 20 29 20 2a 70 6e 52 6f 77 20 3d 20 72 65  ow ) *pnRow = re
15f0: 73 2e 6e 52 6f 77 3b 0a 20 20 72 65 74 75 72 6e  s.nRow;.  return
1600: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68   rc;.}../*.** Th
1610: 69 73 20 72 6f 75 74 69 6e 65 20 66 72 65 65 73  is routine frees
1620: 20 74 68 65 20 73 70 61 63 65 20 74 68 65 20 73   the space the s
1630: 71 6c 69 74 65 33 5f 67 65 74 5f 74 61 62 6c 65  qlite3_get_table
1640: 28 29 20 6d 61 6c 6c 6f 63 65 64 2e 0a 2a 2f 0a  () malloced..*/.
1650: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 66 72 65  void sqlite3_fre
1660: 65 5f 74 61 62 6c 65 28 0a 20 20 63 68 61 72 20  e_table(.  char 
1670: 2a 2a 61 7a 52 65 73 75 6c 74 20 20 20 20 20 20  **azResult      
1680: 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20        /* Result 
1690: 72 65 74 75 72 6e 65 64 20 66 72 6f 6d 20 66 72  returned from fr
16a0: 6f 6d 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 74  om sqlite3_get_t
16b0: 61 62 6c 65 28 29 20 2a 2f 0a 29 7b 0a 20 20 69  able() */.){.  i
16c0: 66 28 20 61 7a 52 65 73 75 6c 74 20 29 7b 0a 20  f( azResult ){. 
16d0: 20 20 20 69 6e 74 20 69 2c 20 6e 3b 0a 20 20 20     int i, n;.   
16e0: 20 61 7a 52 65 73 75 6c 74 2d 2d 3b 0a 20 20 20   azResult--;.   
16f0: 20 61 73 73 65 72 74 28 20 61 7a 52 65 73 75 6c   assert( azResul
1700: 74 21 3d 30 20 29 3b 0a 20 20 20 20 6e 20 3d 20  t!=0 );.    n = 
1710: 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e  SQLITE_PTR_TO_IN
1720: 54 28 61 7a 52 65 73 75 6c 74 5b 30 5d 29 3b 0a  T(azResult[0]);.
1730: 20 20 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c 6e      for(i=1; i<n
1740: 3b 20 69 2b 2b 29 7b 20 69 66 28 20 61 7a 52 65  ; i++){ if( azRe
1750: 73 75 6c 74 5b 69 5d 20 29 20 73 71 6c 69 74 65  sult[i] ) sqlite
1760: 33 5f 66 72 65 65 28 61 7a 52 65 73 75 6c 74 5b  3_free(azResult[
1770: 69 5d 29 3b 20 7d 0a 20 20 20 20 73 71 6c 69 74  i]); }.    sqlit
1780: 65 33 5f 66 72 65 65 28 61 7a 52 65 73 75 6c 74  e3_free(azResult
1790: 29 3b 0a 20 20 7d 0a 7d 0a 0a 23 65 6e 64 69 66  );.  }.}..#endif
17a0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f   /* SQLITE_OMIT_
17b0: 47 45 54 5f 54 41 42 4c 45 20 2a 2f 0a           GET_TABLE */.