/ Hex Artifact Content
Login

Artifact f64ec4fbfe333f8df925bc6ba494f55e05b0e75e:


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 2f 0a 23  e not used..*/.#
0290: 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49  include "sqliteI
02a0: 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 3c  nt.h".#include <
02b0: 73 74 64 6c 69 62 2e 68 3e 0a 23 69 6e 63 6c 75  stdlib.h>.#inclu
02c0: 64 65 20 3c 73 74 72 69 6e 67 2e 68 3e 0a 0a 23  de <string.h>..#
02d0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
02e0: 49 54 5f 47 45 54 5f 54 41 42 4c 45 0a 0a 2f 2a  IT_GET_TABLE../*
02f0: 0a 2a 2a 20 54 68 69 73 20 73 74 72 75 63 74 75  .** This structu
0300: 72 65 20 69 73 20 75 73 65 64 20 74 6f 20 70 61  re is used to pa
0310: 73 73 20 64 61 74 61 20 66 72 6f 6d 20 73 71 6c  ss data from sql
0320: 69 74 65 33 5f 67 65 74 5f 74 61 62 6c 65 28 29  ite3_get_table()
0330: 20 74 68 72 6f 75 67 68 0a 2a 2a 20 74 6f 20 74   through.** to t
0340: 68 65 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63  he callback func
0350: 74 69 6f 6e 20 69 73 20 75 73 65 73 20 74 6f 20  tion is uses to 
0360: 62 75 69 6c 64 20 74 68 65 20 72 65 73 75 6c 74  build the result
0370: 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72  ..*/.typedef str
0380: 75 63 74 20 54 61 62 52 65 73 75 6c 74 20 7b 0a  uct TabResult {.
0390: 20 20 63 68 61 72 20 2a 2a 61 7a 52 65 73 75 6c    char **azResul
03a0: 74 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d  t;.  char *zErrM
03b0: 73 67 3b 0a 20 20 69 6e 74 20 6e 52 65 73 75 6c  sg;.  int nResul
03c0: 74 3b 0a 20 20 69 6e 74 20 6e 41 6c 6c 6f 63 3b  t;.  int nAlloc;
03d0: 0a 20 20 69 6e 74 20 6e 52 6f 77 3b 0a 20 20 69  .  int nRow;.  i
03e0: 6e 74 20 6e 43 6f 6c 75 6d 6e 3b 0a 20 20 69 6e  nt nColumn;.  in
03f0: 74 20 6e 44 61 74 61 3b 0a 20 20 69 6e 74 20 72  t nData;.  int r
0400: 63 3b 0a 7d 20 54 61 62 52 65 73 75 6c 74 3b 0a  c;.} TabResult;.
0410: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  ./*.** This rout
0420: 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e  ine is called on
0430: 63 65 20 66 6f 72 20 65 61 63 68 20 72 6f 77 20  ce for each row 
0440: 69 6e 20 74 68 65 20 72 65 73 75 6c 74 20 74 61  in the result ta
0450: 62 6c 65 2e 20 20 49 74 73 20 6a 6f 62 0a 2a 2a  ble.  Its job.**
0460: 20 69 73 20 74 6f 20 66 69 6c 6c 20 69 6e 20 74   is to fill in t
0470: 68 65 20 54 61 62 52 65 73 75 6c 74 20 73 74 72  he TabResult str
0480: 75 63 74 75 72 65 20 61 70 70 72 6f 70 72 69 61  ucture appropria
0490: 74 65 6c 79 2c 20 61 6c 6c 6f 63 61 74 69 6e 67  tely, allocating
04a0: 20 6e 65 77 0a 2a 2a 20 6d 65 6d 6f 72 79 20 61   new.** memory a
04b0: 73 20 6e 65 63 65 73 73 61 72 79 2e 0a 2a 2f 0a  s necessary..*/.
04c0: 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74  static int sqlit
04d0: 65 33 5f 67 65 74 5f 74 61 62 6c 65 5f 63 62 28  e3_get_table_cb(
04e0: 76 6f 69 64 20 2a 70 41 72 67 2c 20 69 6e 74 20  void *pArg, int 
04f0: 6e 43 6f 6c 2c 20 63 68 61 72 20 2a 2a 61 72 67  nCol, char **arg
0500: 76 2c 20 63 68 61 72 20 2a 2a 63 6f 6c 76 29 7b  v, char **colv){
0510: 0a 20 20 54 61 62 52 65 73 75 6c 74 20 2a 70 20  .  TabResult *p 
0520: 3d 20 28 54 61 62 52 65 73 75 6c 74 2a 29 70 41  = (TabResult*)pA
0530: 72 67 3b 0a 20 20 69 6e 74 20 6e 65 65 64 3b 0a  rg;.  int need;.
0540: 20 20 69 6e 74 20 69 3b 0a 20 20 63 68 61 72 20    int i;.  char 
0550: 2a 7a 3b 0a 0a 20 20 2f 2a 20 4d 61 6b 65 20 73  *z;..  /* Make s
0560: 75 72 65 20 74 68 65 72 65 20 69 73 20 65 6e 6f  ure there is eno
0570: 75 67 68 20 73 70 61 63 65 20 69 6e 20 70 2d 3e  ugh space in p->
0580: 61 7a 52 65 73 75 6c 74 20 74 6f 20 68 6f 6c 64  azResult to hold
0590: 20 65 76 65 72 79 74 68 69 6e 67 0a 20 20 2a 2a   everything.  **
05a0: 20 77 65 20 6e 65 65 64 20 74 6f 20 72 65 6d 65   we need to reme
05b0: 6d 62 65 72 20 66 72 6f 6d 20 74 68 69 73 20 69  mber from this i
05c0: 6e 76 6f 63 61 74 69 6f 6e 20 6f 66 20 74 68 65  nvocation of the
05d0: 20 63 61 6c 6c 62 61 63 6b 2e 0a 20 20 2a 2f 0a   callback..  */.
05e0: 20 20 69 66 28 20 70 2d 3e 6e 52 6f 77 3d 3d 30    if( p->nRow==0
05f0: 20 26 26 20 61 72 67 76 21 3d 30 20 29 7b 0a 20   && argv!=0 ){. 
0600: 20 20 20 6e 65 65 64 20 3d 20 6e 43 6f 6c 2a 32     need = nCol*2
0610: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 6e  ;.  }else{.    n
0620: 65 65 64 20 3d 20 6e 43 6f 6c 3b 0a 20 20 7d 0a  eed = nCol;.  }.
0630: 20 20 69 66 28 20 70 2d 3e 6e 44 61 74 61 20 2b    if( p->nData +
0640: 20 6e 65 65 64 20 3e 3d 20 70 2d 3e 6e 41 6c 6c   need >= p->nAll
0650: 6f 63 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a  oc ){.    char *
0660: 2a 61 7a 4e 65 77 3b 0a 20 20 20 20 70 2d 3e 6e  *azNew;.    p->n
0670: 41 6c 6c 6f 63 20 3d 20 70 2d 3e 6e 41 6c 6c 6f  Alloc = p->nAllo
0680: 63 2a 32 20 2b 20 6e 65 65 64 20 2b 20 31 3b 0a  c*2 + need + 1;.
0690: 20 20 20 20 61 7a 4e 65 77 20 3d 20 72 65 61 6c      azNew = real
06a0: 6c 6f 63 28 20 70 2d 3e 61 7a 52 65 73 75 6c 74  loc( p->azResult
06b0: 2c 20 73 69 7a 65 6f 66 28 63 68 61 72 2a 29 2a  , sizeof(char*)*
06c0: 70 2d 3e 6e 41 6c 6c 6f 63 20 29 3b 0a 20 20 20  p->nAlloc );.   
06d0: 20 69 66 28 20 61 7a 4e 65 77 3d 3d 30 20 29 20   if( azNew==0 ) 
06e0: 67 6f 74 6f 20 6d 61 6c 6c 6f 63 5f 66 61 69 6c  goto malloc_fail
06f0: 65 64 3b 0a 20 20 20 20 70 2d 3e 61 7a 52 65 73  ed;.    p->azRes
0700: 75 6c 74 20 3d 20 61 7a 4e 65 77 3b 0a 20 20 7d  ult = azNew;.  }
0710: 0a 0a 20 20 2f 2a 20 49 66 20 74 68 69 73 20 69  ..  /* If this i
0720: 73 20 74 68 65 20 66 69 72 73 74 20 72 6f 77 2c  s the first row,
0730: 20 74 68 65 6e 20 67 65 6e 65 72 61 74 65 20 61   then generate a
0740: 6e 20 65 78 74 72 61 20 72 6f 77 20 63 6f 6e 74  n extra row cont
0750: 61 69 6e 69 6e 67 0a 20 20 2a 2a 20 74 68 65 20  aining.  ** the 
0760: 6e 61 6d 65 73 20 6f 66 20 61 6c 6c 20 63 6f 6c  names of all col
0770: 75 6d 6e 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  umns..  */.  if(
0780: 20 70 2d 3e 6e 52 6f 77 3d 3d 30 20 29 7b 0a 20   p->nRow==0 ){. 
0790: 20 20 20 70 2d 3e 6e 43 6f 6c 75 6d 6e 20 3d 20     p->nColumn = 
07a0: 6e 43 6f 6c 3b 0a 20 20 20 20 66 6f 72 28 69 3d  nCol;.    for(i=
07b0: 30 3b 20 69 3c 6e 43 6f 6c 3b 20 69 2b 2b 29 7b  0; i<nCol; i++){
07c0: 0a 20 20 20 20 20 20 69 66 28 20 63 6f 6c 76 5b  .      if( colv[
07d0: 69 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20  i]==0 ){.       
07e0: 20 7a 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 65   z = 0;.      }e
07f0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 7a 20 3d  lse{.        z =
0800: 20 6d 61 6c 6c 6f 63 28 20 73 74 72 6c 65 6e 28   malloc( strlen(
0810: 63 6f 6c 76 5b 69 5d 29 2b 31 20 29 3b 0a 20 20  colv[i])+1 );.  
0820: 20 20 20 20 20 20 69 66 28 20 7a 3d 3d 30 20 29        if( z==0 )
0830: 20 67 6f 74 6f 20 6d 61 6c 6c 6f 63 5f 66 61 69   goto malloc_fai
0840: 6c 65 64 3b 0a 20 20 20 20 20 20 20 20 73 74 72  led;.        str
0850: 63 70 79 28 7a 2c 20 63 6f 6c 76 5b 69 5d 29 3b  cpy(z, colv[i]);
0860: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70  .      }.      p
0870: 2d 3e 61 7a 52 65 73 75 6c 74 5b 70 2d 3e 6e 44  ->azResult[p->nD
0880: 61 74 61 2b 2b 5d 20 3d 20 7a 3b 0a 20 20 20 20  ata++] = z;.    
0890: 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d  }.  }else if( p-
08a0: 3e 6e 43 6f 6c 75 6d 6e 21 3d 6e 43 6f 6c 20 29  >nColumn!=nCol )
08b0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 65 74  {.    sqlite3Set
08c0: 53 74 72 69 6e 67 28 26 70 2d 3e 7a 45 72 72 4d  String(&p->zErrM
08d0: 73 67 2c 0a 20 20 20 20 20 20 20 22 73 71 6c 69  sg,.       "sqli
08e0: 74 65 33 5f 67 65 74 5f 74 61 62 6c 65 28 29 20  te3_get_table() 
08f0: 63 61 6c 6c 65 64 20 77 69 74 68 20 74 77 6f 20  called with two 
0900: 6f 72 20 6d 6f 72 65 20 69 6e 63 6f 6d 70 61 74  or more incompat
0910: 69 62 6c 65 20 71 75 65 72 69 65 73 22 2c 0a 20  ible queries",. 
0920: 20 20 20 20 20 20 28 63 68 61 72 2a 29 30 29 3b        (char*)0);
0930: 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c  .    p->rc = SQL
0940: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 72  ITE_ERROR;.    r
0950: 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 0a 20 20  eturn 1;.  }..  
0960: 2f 2a 20 43 6f 70 79 20 6f 76 65 72 20 74 68 65  /* Copy over the
0970: 20 72 6f 77 20 64 61 74 61 0a 20 20 2a 2f 0a 20   row data.  */. 
0980: 20 69 66 28 20 61 72 67 76 21 3d 30 20 29 7b 0a   if( argv!=0 ){.
0990: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e      for(i=0; i<n
09a0: 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  Col; i++){.     
09b0: 20 69 66 28 20 61 72 67 76 5b 69 5d 3d 3d 30 20   if( argv[i]==0 
09c0: 29 7b 0a 20 20 20 20 20 20 20 20 7a 20 3d 20 30  ){.        z = 0
09d0: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ;.      }else{. 
09e0: 20 20 20 20 20 20 20 7a 20 3d 20 6d 61 6c 6c 6f         z = mallo
09f0: 63 28 20 73 74 72 6c 65 6e 28 61 72 67 76 5b 69  c( strlen(argv[i
0a00: 5d 29 2b 31 20 29 3b 0a 20 20 20 20 20 20 20 20  ])+1 );.        
0a10: 69 66 28 20 7a 3d 3d 30 20 29 20 67 6f 74 6f 20  if( z==0 ) goto 
0a20: 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 3b 0a 20  malloc_failed;. 
0a30: 20 20 20 20 20 20 20 73 74 72 63 70 79 28 7a 2c         strcpy(z,
0a40: 20 61 72 67 76 5b 69 5d 29 3b 0a 20 20 20 20 20   argv[i]);.     
0a50: 20 7d 0a 20 20 20 20 20 20 70 2d 3e 61 7a 52 65   }.      p->azRe
0a60: 73 75 6c 74 5b 70 2d 3e 6e 44 61 74 61 2b 2b 5d  sult[p->nData++]
0a70: 20 3d 20 7a 3b 0a 20 20 20 20 7d 0a 20 20 20 20   = z;.    }.    
0a80: 70 2d 3e 6e 52 6f 77 2b 2b 3b 0a 20 20 7d 0a 20  p->nRow++;.  }. 
0a90: 20 72 65 74 75 72 6e 20 30 3b 0a 0a 6d 61 6c 6c   return 0;..mall
0aa0: 6f 63 5f 66 61 69 6c 65 64 3a 0a 20 20 70 2d 3e  oc_failed:.  p->
0ab0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  rc = SQLITE_NOME
0ac0: 4d 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d  M;.  return 1;.}
0ad0: 0a 0a 2f 2a 0a 2a 2a 20 51 75 65 72 79 20 74 68  ../*.** Query th
0ae0: 65 20 64 61 74 61 62 61 73 65 2e 20 20 42 75 74  e database.  But
0af0: 20 69 6e 73 74 65 61 64 20 6f 66 20 69 6e 76 6f   instead of invo
0b00: 6b 69 6e 67 20 61 20 63 61 6c 6c 62 61 63 6b 20  king a callback 
0b10: 66 6f 72 20 65 61 63 68 20 72 6f 77 2c 0a 2a 2a  for each row,.**
0b20: 20 6d 61 6c 6c 6f 63 28 29 20 66 6f 72 20 73 70   malloc() for sp
0b30: 61 63 65 20 74 6f 20 68 6f 6c 64 20 74 68 65 20  ace to hold the 
0b40: 72 65 73 75 6c 74 20 61 6e 64 20 72 65 74 75 72  result and retur
0b50: 6e 20 74 68 65 20 65 6e 74 69 72 65 20 72 65 73  n the entire res
0b60: 75 6c 74 73 0a 2a 2a 20 61 74 20 74 68 65 20 63  ults.** at the c
0b70: 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 74 68 65  onclusion of the
0b80: 20 63 61 6c 6c 2e 0a 2a 2a 0a 2a 2a 20 54 68 65   call..**.** The
0b90: 20 72 65 73 75 6c 74 20 74 68 61 74 20 69 73 20   result that is 
0ba0: 77 72 69 74 74 65 6e 20 74 6f 20 2a 2a 2a 70 61  written to ***pa
0bb0: 7a 52 65 73 75 6c 74 20 69 73 20 68 65 6c 64 20  zResult is held 
0bc0: 69 6e 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69 6e  in memory obtain
0bd0: 65 64 0a 2a 2a 20 66 72 6f 6d 20 6d 61 6c 6c 6f  ed.** from mallo
0be0: 63 28 29 2e 20 20 42 75 74 20 74 68 65 20 63 61  c().  But the ca
0bf0: 6c 6c 65 72 20 63 61 6e 6e 6f 74 20 66 72 65 65  ller cannot free
0c00: 20 74 68 69 73 20 6d 65 6d 6f 72 79 20 64 69 72   this memory dir
0c10: 65 63 74 6c 79 2e 20 20 0a 2a 2a 20 49 6e 73 74  ectly.  .** Inst
0c20: 65 61 64 2c 20 74 68 65 20 65 6e 74 69 72 65 20  ead, the entire 
0c30: 74 61 62 6c 65 20 73 68 6f 75 6c 64 20 62 65 20  table should be 
0c40: 70 61 73 73 65 64 20 74 6f 20 73 71 6c 69 74 65  passed to sqlite
0c50: 33 5f 66 72 65 65 5f 74 61 62 6c 65 28 29 20 77  3_free_table() w
0c60: 68 65 6e 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 69  hen.** the calli
0c70: 6e 67 20 70 72 6f 63 65 64 75 72 65 20 69 73 20  ng procedure is 
0c80: 66 69 6e 69 73 68 65 64 20 75 73 69 6e 67 20 69  finished using i
0c90: 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  t..*/.int sqlite
0ca0: 33 5f 67 65 74 5f 74 61 62 6c 65 28 0a 20 20 73  3_get_table(.  s
0cb0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20  qlite3 *db,     
0cc0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68             /* Th
0cd0: 65 20 64 61 74 61 62 61 73 65 20 6f 6e 20 77 68  e database on wh
0ce0: 69 63 68 20 74 68 65 20 53 51 4c 20 65 78 65 63  ich the SQL exec
0cf0: 75 74 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20  utes */.  const 
0d00: 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20  char *zSql,     
0d10: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 53 51 4c        /* The SQL
0d20: 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 20   to be executed 
0d30: 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 2a 70 61 7a  */.  char ***paz
0d40: 52 65 73 75 6c 74 2c 20 20 20 20 20 20 20 20 20  Result,         
0d50: 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 72 65   /* Write the re
0d60: 73 75 6c 74 20 74 61 62 6c 65 20 68 65 72 65 20  sult table here 
0d70: 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 52 6f 77 2c  */.  int *pnRow,
0d80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0d90: 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 6e 75   /* Write the nu
0da0: 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 69 6e 20  mber of rows in 
0db0: 74 68 65 20 72 65 73 75 6c 74 20 68 65 72 65 20  the result here 
0dc0: 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 43 6f 6c 75  */.  int *pnColu
0dd0: 6d 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  mn,             
0de0: 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 6e 75   /* Write the nu
0df0: 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20  mber of columns 
0e00: 6f 66 20 72 65 73 75 6c 74 20 68 65 72 65 20 2a  of result here *
0e10: 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72  /.  char **pzErr
0e20: 4d 73 67 20 20 20 20 20 20 20 20 20 20 20 20 20  Msg             
0e30: 2f 2a 20 57 72 69 74 65 20 65 72 72 6f 72 20 6d  /* Write error m
0e40: 65 73 73 61 67 65 73 20 68 65 72 65 20 2a 2f 0a  essages here */.
0e50: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 54  ){.  int rc;.  T
0e60: 61 62 52 65 73 75 6c 74 20 72 65 73 3b 0a 20 20  abResult res;.  
0e70: 69 66 28 20 70 61 7a 52 65 73 75 6c 74 3d 3d 30  if( pazResult==0
0e80: 20 29 7b 20 72 65 74 75 72 6e 20 53 51 4c 49 54   ){ return SQLIT
0e90: 45 5f 45 52 52 4f 52 3b 20 7d 0a 20 20 2a 70 61  E_ERROR; }.  *pa
0ea0: 7a 52 65 73 75 6c 74 20 3d 20 30 3b 0a 20 20 69  zResult = 0;.  i
0eb0: 66 28 20 70 6e 43 6f 6c 75 6d 6e 20 29 20 2a 70  f( pnColumn ) *p
0ec0: 6e 43 6f 6c 75 6d 6e 20 3d 20 30 3b 0a 20 20 69  nColumn = 0;.  i
0ed0: 66 28 20 70 6e 52 6f 77 20 29 20 2a 70 6e 52 6f  f( pnRow ) *pnRo
0ee0: 77 20 3d 20 30 3b 0a 20 20 72 65 73 2e 7a 45 72  w = 0;.  res.zEr
0ef0: 72 4d 73 67 20 3d 20 30 3b 0a 20 20 72 65 73 2e  rMsg = 0;.  res.
0f00: 6e 52 65 73 75 6c 74 20 3d 20 30 3b 0a 20 20 72  nResult = 0;.  r
0f10: 65 73 2e 6e 52 6f 77 20 3d 20 30 3b 0a 20 20 72  es.nRow = 0;.  r
0f20: 65 73 2e 6e 43 6f 6c 75 6d 6e 20 3d 20 30 3b 0a  es.nColumn = 0;.
0f30: 20 20 72 65 73 2e 6e 44 61 74 61 20 3d 20 31 3b    res.nData = 1;
0f40: 0a 20 20 72 65 73 2e 6e 41 6c 6c 6f 63 20 3d 20  .  res.nAlloc = 
0f50: 32 30 3b 0a 20 20 72 65 73 2e 72 63 20 3d 20 53  20;.  res.rc = S
0f60: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 72 65 73 2e  QLITE_OK;.  res.
0f70: 61 7a 52 65 73 75 6c 74 20 3d 20 6d 61 6c 6c 6f  azResult = mallo
0f80: 63 28 20 73 69 7a 65 6f 66 28 63 68 61 72 2a 29  c( sizeof(char*)
0f90: 2a 72 65 73 2e 6e 41 6c 6c 6f 63 20 29 3b 0a 20  *res.nAlloc );. 
0fa0: 20 69 66 28 20 72 65 73 2e 61 7a 52 65 73 75 6c   if( res.azResul
0fb0: 74 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51  t==0 ) return SQ
0fc0: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 72 65  LITE_NOMEM;.  re
0fd0: 73 2e 61 7a 52 65 73 75 6c 74 5b 30 5d 20 3d 20  s.azResult[0] = 
0fe0: 30 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  0;.  rc = sqlite
0ff0: 33 5f 65 78 65 63 28 64 62 2c 20 7a 53 71 6c 2c  3_exec(db, zSql,
1000: 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 74 61 62   sqlite3_get_tab
1010: 6c 65 5f 63 62 2c 20 26 72 65 73 2c 20 70 7a 45  le_cb, &res, pzE
1020: 72 72 4d 73 67 29 3b 0a 20 20 69 66 28 20 72 65  rrMsg);.  if( re
1030: 73 2e 61 7a 52 65 73 75 6c 74 20 29 7b 0a 20 20  s.azResult ){.  
1040: 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66    assert( sizeof
1050: 28 72 65 73 2e 61 7a 52 65 73 75 6c 74 5b 30 5d  (res.azResult[0]
1060: 29 3e 3d 20 73 69 7a 65 6f 66 28 72 65 73 2e 6e  )>= sizeof(res.n
1070: 44 61 74 61 29 20 29 3b 0a 20 20 20 20 72 65 73  Data) );.    res
1080: 2e 61 7a 52 65 73 75 6c 74 5b 30 5d 20 3d 20 28  .azResult[0] = (
1090: 63 68 61 72 2a 29 72 65 73 2e 6e 44 61 74 61 3b  char*)res.nData;
10a0: 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53  .  }.  if( rc==S
10b0: 51 4c 49 54 45 5f 41 42 4f 52 54 20 29 7b 0a 20  QLITE_ABORT ){. 
10c0: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 5f     sqlite3_free_
10d0: 74 61 62 6c 65 28 26 72 65 73 2e 61 7a 52 65 73  table(&res.azRes
10e0: 75 6c 74 5b 31 5d 29 3b 0a 20 20 20 20 69 66 28  ult[1]);.    if(
10f0: 20 72 65 73 2e 7a 45 72 72 4d 73 67 20 29 7b 0a   res.zErrMsg ){.
1100: 20 20 20 20 20 20 69 66 28 20 70 7a 45 72 72 4d        if( pzErrM
1110: 73 67 20 29 7b 0a 20 20 20 20 20 20 20 20 66 72  sg ){.        fr
1120: 65 65 28 2a 70 7a 45 72 72 4d 73 67 29 3b 0a 20  ee(*pzErrMsg);. 
1130: 20 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 67         *pzErrMsg
1140: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e   = sqlite3_mprin
1150: 74 66 28 22 25 73 22 2c 72 65 73 2e 7a 45 72 72  tf("%s",res.zErr
1160: 4d 73 67 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  Msg);.      }.  
1170: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 72      sqliteFree(r
1180: 65 73 2e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20  es.zErrMsg);.   
1190: 20 7d 0a 20 20 20 20 64 62 2d 3e 65 72 72 43 6f   }.    db->errCo
11a0: 64 65 20 3d 20 72 65 73 2e 72 63 3b 0a 20 20 20  de = res.rc;.   
11b0: 20 72 65 74 75 72 6e 20 72 65 73 2e 72 63 3b 0a   return res.rc;.
11c0: 20 20 7d 0a 20 20 73 71 6c 69 74 65 46 72 65 65    }.  sqliteFree
11d0: 28 72 65 73 2e 7a 45 72 72 4d 73 67 29 3b 0a 20  (res.zErrMsg);. 
11e0: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
11f0: 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  OK ){.    sqlite
1200: 33 5f 66 72 65 65 5f 74 61 62 6c 65 28 26 72 65  3_free_table(&re
1210: 73 2e 61 7a 52 65 73 75 6c 74 5b 31 5d 29 3b 0a  s.azResult[1]);.
1220: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
1230: 20 7d 0a 20 20 69 66 28 20 72 65 73 2e 6e 41 6c   }.  if( res.nAl
1240: 6c 6f 63 3e 72 65 73 2e 6e 44 61 74 61 20 29 7b  loc>res.nData ){
1250: 0a 20 20 20 20 63 68 61 72 20 2a 2a 61 7a 4e 65  .    char **azNe
1260: 77 3b 0a 20 20 20 20 61 7a 4e 65 77 20 3d 20 72  w;.    azNew = r
1270: 65 61 6c 6c 6f 63 28 20 72 65 73 2e 61 7a 52 65  ealloc( res.azRe
1280: 73 75 6c 74 2c 20 73 69 7a 65 6f 66 28 63 68 61  sult, sizeof(cha
1290: 72 2a 29 2a 28 72 65 73 2e 6e 44 61 74 61 2b 31  r*)*(res.nData+1
12a0: 29 20 29 3b 0a 20 20 20 20 69 66 28 20 61 7a 4e  ) );.    if( azN
12b0: 65 77 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73  ew==0 ){.      s
12c0: 71 6c 69 74 65 33 5f 66 72 65 65 5f 74 61 62 6c  qlite3_free_tabl
12d0: 65 28 26 72 65 73 2e 61 7a 52 65 73 75 6c 74 5b  e(&res.azResult[
12e0: 31 5d 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72  1]);.      retur
12f0: 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  n SQLITE_NOMEM;.
1300: 20 20 20 20 7d 0a 20 20 20 20 72 65 73 2e 6e 41      }.    res.nA
1310: 6c 6c 6f 63 20 3d 20 72 65 73 2e 6e 44 61 74 61  lloc = res.nData
1320: 2b 31 3b 0a 20 20 20 20 72 65 73 2e 61 7a 52 65  +1;.    res.azRe
1330: 73 75 6c 74 20 3d 20 61 7a 4e 65 77 3b 0a 20 20  sult = azNew;.  
1340: 7d 0a 20 20 2a 70 61 7a 52 65 73 75 6c 74 20 3d  }.  *pazResult =
1350: 20 26 72 65 73 2e 61 7a 52 65 73 75 6c 74 5b 31   &res.azResult[1
1360: 5d 3b 0a 20 20 69 66 28 20 70 6e 43 6f 6c 75 6d  ];.  if( pnColum
1370: 6e 20 29 20 2a 70 6e 43 6f 6c 75 6d 6e 20 3d 20  n ) *pnColumn = 
1380: 72 65 73 2e 6e 43 6f 6c 75 6d 6e 3b 0a 20 20 69  res.nColumn;.  i
1390: 66 28 20 70 6e 52 6f 77 20 29 20 2a 70 6e 52 6f  f( pnRow ) *pnRo
13a0: 77 20 3d 20 72 65 73 2e 6e 52 6f 77 3b 0a 20 20  w = res.nRow;.  
13b0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
13c0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
13d0: 20 66 72 65 65 73 20 74 68 65 20 73 70 61 63 65   frees the space
13e0: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 67 65 74   the sqlite3_get
13f0: 5f 74 61 62 6c 65 28 29 20 6d 61 6c 6c 6f 63 65  _table() malloce
1400: 64 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  d..*/.void sqlit
1410: 65 33 5f 66 72 65 65 5f 74 61 62 6c 65 28 0a 20  e3_free_table(. 
1420: 20 63 68 61 72 20 2a 2a 61 7a 52 65 73 75 6c 74   char **azResult
1430: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52              /* R
1440: 65 73 75 6c 74 20 72 65 74 75 72 6e 65 64 20 66  esult returned f
1450: 72 6f 6d 20 66 72 6f 6d 20 73 71 6c 69 74 65 33  rom from sqlite3
1460: 5f 67 65 74 5f 74 61 62 6c 65 28 29 20 2a 2f 0a  _get_table() */.
1470: 29 7b 0a 20 20 69 66 28 20 61 7a 52 65 73 75 6c  ){.  if( azResul
1480: 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 2c 20  t ){.    int i, 
1490: 6e 3b 0a 20 20 20 20 61 7a 52 65 73 75 6c 74 2d  n;.    azResult-
14a0: 2d 3b 0a 20 20 20 20 69 66 28 20 61 7a 52 65 73  -;.    if( azRes
14b0: 75 6c 74 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b  ult==0 ) return;
14c0: 0a 20 20 20 20 6e 20 3d 20 28 69 6e 74 29 61 7a  .    n = (int)az
14d0: 52 65 73 75 6c 74 5b 30 5d 3b 0a 20 20 20 20 66  Result[0];.    f
14e0: 6f 72 28 69 3d 31 3b 20 69 3c 6e 3b 20 69 2b 2b  or(i=1; i<n; i++
14f0: 29 7b 20 69 66 28 20 61 7a 52 65 73 75 6c 74 5b  ){ if( azResult[
1500: 69 5d 20 29 20 66 72 65 65 28 61 7a 52 65 73 75  i] ) free(azResu
1510: 6c 74 5b 69 5d 29 3b 20 7d 0a 20 20 20 20 66 72  lt[i]); }.    fr
1520: 65 65 28 61 7a 52 65 73 75 6c 74 29 3b 0a 20 20  ee(azResult);.  
1530: 7d 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53  }.}..#endif /* S
1540: 51 4c 49 54 45 5f 4f 4d 49 54 5f 47 45 54 5f 54  QLITE_OMIT_GET_T
1550: 41 42 4c 45 20 2a 2f 0a                          ABLE */.