/ Hex Artifact Content
Login

Artifact c688f2679d3b2221bc122afdc6771fa34813493d:


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 73 71 6c 69      azNew = sqli
06a0: 74 65 33 5f 72 65 61 6c 6c 6f 63 28 20 70 2d 3e  te3_realloc( p->
06b0: 61 7a 52 65 73 75 6c 74 2c 20 73 69 7a 65 6f 66  azResult, sizeof
06c0: 28 63 68 61 72 2a 29 2a 70 2d 3e 6e 41 6c 6c 6f  (char*)*p->nAllo
06d0: 63 20 29 3b 0a 20 20 20 20 69 66 28 20 61 7a 4e  c );.    if( azN
06e0: 65 77 3d 3d 30 20 29 20 67 6f 74 6f 20 6d 61 6c  ew==0 ) goto mal
06f0: 6c 6f 63 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20  loc_failed;.    
0700: 70 2d 3e 61 7a 52 65 73 75 6c 74 20 3d 20 61 7a  p->azResult = az
0710: 4e 65 77 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49  New;.  }..  /* I
0720: 66 20 74 68 69 73 20 69 73 20 74 68 65 20 66 69  f this is the fi
0730: 72 73 74 20 72 6f 77 2c 20 74 68 65 6e 20 67 65  rst row, then ge
0740: 6e 65 72 61 74 65 20 61 6e 20 65 78 74 72 61 20  nerate an extra 
0750: 72 6f 77 20 63 6f 6e 74 61 69 6e 69 6e 67 0a 20  row containing. 
0760: 20 2a 2a 20 74 68 65 20 6e 61 6d 65 73 20 6f 66   ** the names of
0770: 20 61 6c 6c 20 63 6f 6c 75 6d 6e 73 2e 0a 20 20   all columns..  
0780: 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 6e 52 6f 77  */.  if( p->nRow
0790: 3d 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e 6e 43  ==0 ){.    p->nC
07a0: 6f 6c 75 6d 6e 20 3d 20 6e 43 6f 6c 3b 0a 20 20  olumn = nCol;.  
07b0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 6f    for(i=0; i<nCo
07c0: 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 7a  l; i++){.      z
07d0: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e   = sqlite3_mprin
07e0: 74 66 28 22 25 73 22 2c 20 63 6f 6c 76 5b 69 5d  tf("%s", colv[i]
07f0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 7a 3d 3d  );.      if( z==
0800: 30 20 29 20 67 6f 74 6f 20 6d 61 6c 6c 6f 63 5f  0 ) goto malloc_
0810: 66 61 69 6c 65 64 3b 0a 20 20 20 20 20 20 70 2d  failed;.      p-
0820: 3e 61 7a 52 65 73 75 6c 74 5b 70 2d 3e 6e 44 61  >azResult[p->nDa
0830: 74 61 2b 2b 5d 20 3d 20 7a 3b 0a 20 20 20 20 7d  ta++] = z;.    }
0840: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e  .  }else if( p->
0850: 6e 43 6f 6c 75 6d 6e 21 3d 6e 43 6f 6c 20 29 7b  nColumn!=nCol ){
0860: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65  .    sqlite3_fre
0870: 65 28 70 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20  e(p->zErrMsg);. 
0880: 20 20 20 70 2d 3e 7a 45 72 72 4d 73 67 20 3d 20     p->zErrMsg = 
0890: 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28  sqlite3_mprintf(
08a0: 0a 20 20 20 20 20 20 20 22 73 71 6c 69 74 65 33  .       "sqlite3
08b0: 5f 67 65 74 5f 74 61 62 6c 65 28 29 20 63 61 6c  _get_table() cal
08c0: 6c 65 64 20 77 69 74 68 20 74 77 6f 20 6f 72 20  led with two or 
08d0: 6d 6f 72 65 20 69 6e 63 6f 6d 70 61 74 69 62 6c  more incompatibl
08e0: 65 20 71 75 65 72 69 65 73 22 0a 20 20 20 20 29  e queries".    )
08f0: 3b 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51  ;.    p->rc = SQ
0900: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20  LITE_ERROR;.    
0910: 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 0a 20  return 1;.  }.. 
0920: 20 2f 2a 20 43 6f 70 79 20 6f 76 65 72 20 74 68   /* Copy over th
0930: 65 20 72 6f 77 20 64 61 74 61 0a 20 20 2a 2f 0a  e row data.  */.
0940: 20 20 69 66 28 20 61 72 67 76 21 3d 30 20 29 7b    if( argv!=0 ){
0950: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
0960: 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  nCol; i++){.    
0970: 20 20 69 66 28 20 61 72 67 76 5b 69 5d 3d 3d 30    if( argv[i]==0
0980: 20 29 7b 0a 20 20 20 20 20 20 20 20 7a 20 3d 20   ){.        z = 
0990: 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a  0;.      }else{.
09a0: 20 20 20 20 20 20 20 20 69 6e 74 20 6e 20 3d 20          int n = 
09b0: 73 74 72 6c 65 6e 28 61 72 67 76 5b 69 5d 29 2b  strlen(argv[i])+
09c0: 31 3b 0a 20 20 20 20 20 20 20 20 7a 20 3d 20 73  1;.        z = s
09d0: 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 6e  qlite3_malloc( n
09e0: 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20   );.        if( 
09f0: 7a 3d 3d 30 20 29 20 67 6f 74 6f 20 6d 61 6c 6c  z==0 ) goto mall
0a00: 6f 63 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 20  oc_failed;.     
0a10: 20 20 20 6d 65 6d 63 70 79 28 7a 2c 20 61 72 67     memcpy(z, arg
0a20: 76 5b 69 5d 2c 20 6e 29 3b 0a 20 20 20 20 20 20  v[i], n);.      
0a30: 7d 0a 20 20 20 20 20 20 70 2d 3e 61 7a 52 65 73  }.      p->azRes
0a40: 75 6c 74 5b 70 2d 3e 6e 44 61 74 61 2b 2b 5d 20  ult[p->nData++] 
0a50: 3d 20 7a 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70  = z;.    }.    p
0a60: 2d 3e 6e 52 6f 77 2b 2b 3b 0a 20 20 7d 0a 20 20  ->nRow++;.  }.  
0a70: 72 65 74 75 72 6e 20 30 3b 0a 0a 6d 61 6c 6c 6f  return 0;..mallo
0a80: 63 5f 66 61 69 6c 65 64 3a 0a 20 20 70 2d 3e 72  c_failed:.  p->r
0a90: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
0aa0: 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a 7d 0a  ;.  return 1;.}.
0ab0: 0a 2f 2a 0a 2a 2a 20 51 75 65 72 79 20 74 68 65  ./*.** Query the
0ac0: 20 64 61 74 61 62 61 73 65 2e 20 20 42 75 74 20   database.  But 
0ad0: 69 6e 73 74 65 61 64 20 6f 66 20 69 6e 76 6f 6b  instead of invok
0ae0: 69 6e 67 20 61 20 63 61 6c 6c 62 61 63 6b 20 66  ing a callback f
0af0: 6f 72 20 65 61 63 68 20 72 6f 77 2c 0a 2a 2a 20  or each row,.** 
0b00: 6d 61 6c 6c 6f 63 28 29 20 66 6f 72 20 73 70 61  malloc() for spa
0b10: 63 65 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 72  ce to hold the r
0b20: 65 73 75 6c 74 20 61 6e 64 20 72 65 74 75 72 6e  esult and return
0b30: 20 74 68 65 20 65 6e 74 69 72 65 20 72 65 73 75   the entire resu
0b40: 6c 74 73 0a 2a 2a 20 61 74 20 74 68 65 20 63 6f  lts.** at the co
0b50: 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 74 68 65 20  nclusion of the 
0b60: 63 61 6c 6c 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  call..**.** The 
0b70: 72 65 73 75 6c 74 20 74 68 61 74 20 69 73 20 77  result that is w
0b80: 72 69 74 74 65 6e 20 74 6f 20 2a 2a 2a 70 61 7a  ritten to ***paz
0b90: 52 65 73 75 6c 74 20 69 73 20 68 65 6c 64 20 69  Result is held i
0ba0: 6e 20 6d 65 6d 6f 72 79 20 6f 62 74 61 69 6e 65  n memory obtaine
0bb0: 64 0a 2a 2a 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63  d.** from malloc
0bc0: 28 29 2e 20 20 42 75 74 20 74 68 65 20 63 61 6c  ().  But the cal
0bd0: 6c 65 72 20 63 61 6e 6e 6f 74 20 66 72 65 65 20  ler cannot free 
0be0: 74 68 69 73 20 6d 65 6d 6f 72 79 20 64 69 72 65  this memory dire
0bf0: 63 74 6c 79 2e 20 20 0a 2a 2a 20 49 6e 73 74 65  ctly.  .** Inste
0c00: 61 64 2c 20 74 68 65 20 65 6e 74 69 72 65 20 74  ad, the entire t
0c10: 61 62 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 70  able should be p
0c20: 61 73 73 65 64 20 74 6f 20 73 71 6c 69 74 65 33  assed to sqlite3
0c30: 5f 66 72 65 65 5f 74 61 62 6c 65 28 29 20 77 68  _free_table() wh
0c40: 65 6e 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 69 6e  en.** the callin
0c50: 67 20 70 72 6f 63 65 64 75 72 65 20 69 73 20 66  g procedure is f
0c60: 69 6e 69 73 68 65 64 20 75 73 69 6e 67 20 69 74  inished using it
0c70: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
0c80: 5f 67 65 74 5f 74 61 62 6c 65 28 0a 20 20 73 71  _get_table(.  sq
0c90: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20  lite3 *db,      
0ca0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
0cb0: 20 64 61 74 61 62 61 73 65 20 6f 6e 20 77 68 69   database on whi
0cc0: 63 68 20 74 68 65 20 53 51 4c 20 65 78 65 63 75  ch the SQL execu
0cd0: 74 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  tes */.  const c
0ce0: 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20  har *zSql,      
0cf0: 20 20 20 20 20 2f 2a 20 54 68 65 20 53 51 4c 20       /* The SQL 
0d00: 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 20 2a  to be executed *
0d10: 2f 0a 20 20 63 68 61 72 20 2a 2a 2a 70 61 7a 52  /.  char ***pazR
0d20: 65 73 75 6c 74 2c 20 20 20 20 20 20 20 20 20 20  esult,          
0d30: 2f 2a 20 57 72 69 74 65 20 74 68 65 20 72 65 73  /* Write the res
0d40: 75 6c 74 20 74 61 62 6c 65 20 68 65 72 65 20 2a  ult table here *
0d50: 2f 0a 20 20 69 6e 74 20 2a 70 6e 52 6f 77 2c 20  /.  int *pnRow, 
0d60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0d70: 2f 2a 20 57 72 69 74 65 20 74 68 65 20 6e 75 6d  /* Write the num
0d80: 62 65 72 20 6f 66 20 72 6f 77 73 20 69 6e 20 74  ber of rows in t
0d90: 68 65 20 72 65 73 75 6c 74 20 68 65 72 65 20 2a  he result here *
0da0: 2f 0a 20 20 69 6e 74 20 2a 70 6e 43 6f 6c 75 6d  /.  int *pnColum
0db0: 6e 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  n,              
0dc0: 2f 2a 20 57 72 69 74 65 20 74 68 65 20 6e 75 6d  /* Write the num
0dd0: 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 6f  ber of columns o
0de0: 66 20 72 65 73 75 6c 74 20 68 65 72 65 20 2a 2f  f result here */
0df0: 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d  .  char **pzErrM
0e00: 73 67 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  sg             /
0e10: 2a 20 57 72 69 74 65 20 65 72 72 6f 72 20 6d 65  * Write error me
0e20: 73 73 61 67 65 73 20 68 65 72 65 20 2a 2f 0a 29  ssages here */.)
0e30: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 54 61  {.  int rc;.  Ta
0e40: 62 52 65 73 75 6c 74 20 72 65 73 3b 0a 0a 20 20  bResult res;..  
0e50: 2a 70 61 7a 52 65 73 75 6c 74 20 3d 20 30 3b 0a  *pazResult = 0;.
0e60: 20 20 69 66 28 20 70 6e 43 6f 6c 75 6d 6e 20 29    if( pnColumn )
0e70: 20 2a 70 6e 43 6f 6c 75 6d 6e 20 3d 20 30 3b 0a   *pnColumn = 0;.
0e80: 20 20 69 66 28 20 70 6e 52 6f 77 20 29 20 2a 70    if( pnRow ) *p
0e90: 6e 52 6f 77 20 3d 20 30 3b 0a 20 20 72 65 73 2e  nRow = 0;.  res.
0ea0: 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 72  zErrMsg = 0;.  r
0eb0: 65 73 2e 6e 52 65 73 75 6c 74 20 3d 20 30 3b 0a  es.nResult = 0;.
0ec0: 20 20 72 65 73 2e 6e 52 6f 77 20 3d 20 30 3b 0a    res.nRow = 0;.
0ed0: 20 20 72 65 73 2e 6e 43 6f 6c 75 6d 6e 20 3d 20    res.nColumn = 
0ee0: 30 3b 0a 20 20 72 65 73 2e 6e 44 61 74 61 20 3d  0;.  res.nData =
0ef0: 20 31 3b 0a 20 20 72 65 73 2e 6e 41 6c 6c 6f 63   1;.  res.nAlloc
0f00: 20 3d 20 32 30 3b 0a 20 20 72 65 73 2e 72 63 20   = 20;.  res.rc 
0f10: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 72  = SQLITE_OK;.  r
0f20: 65 73 2e 61 7a 52 65 73 75 6c 74 20 3d 20 73 71  es.azResult = sq
0f30: 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 73 69 7a  lite3_malloc(siz
0f40: 65 6f 66 28 63 68 61 72 2a 29 2a 72 65 73 2e 6e  eof(char*)*res.n
0f50: 41 6c 6c 6f 63 20 29 3b 0a 20 20 69 66 28 20 72  Alloc );.  if( r
0f60: 65 73 2e 61 7a 52 65 73 75 6c 74 3d 3d 30 20 29  es.azResult==0 )
0f70: 7b 0a 20 20 20 20 20 64 62 2d 3e 65 72 72 43 6f  {.     db->errCo
0f80: 64 65 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  de = SQLITE_NOME
0f90: 4d 3b 0a 20 20 20 20 20 72 65 74 75 72 6e 20 53  M;.     return S
0fa0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d  QLITE_NOMEM;.  }
0fb0: 0a 20 20 72 65 73 2e 61 7a 52 65 73 75 6c 74 5b  .  res.azResult[
0fc0: 30 5d 20 3d 20 30 3b 0a 20 20 72 63 20 3d 20 73  0] = 0;.  rc = s
0fd0: 71 6c 69 74 65 33 5f 65 78 65 63 28 64 62 2c 20  qlite3_exec(db, 
0fe0: 7a 53 71 6c 2c 20 73 71 6c 69 74 65 33 5f 67 65  zSql, sqlite3_ge
0ff0: 74 5f 74 61 62 6c 65 5f 63 62 2c 20 26 72 65 73  t_table_cb, &res
1000: 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 61  , pzErrMsg);.  a
1010: 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 72 65  ssert( sizeof(re
1020: 73 2e 61 7a 52 65 73 75 6c 74 5b 30 5d 29 3e 3d  s.azResult[0])>=
1030: 20 73 69 7a 65 6f 66 28 72 65 73 2e 6e 44 61 74   sizeof(res.nDat
1040: 61 29 20 29 3b 0a 20 20 72 65 73 2e 61 7a 52 65  a) );.  res.azRe
1050: 73 75 6c 74 5b 30 5d 20 3d 20 28 63 68 61 72 2a  sult[0] = (char*
1060: 29 28 69 6e 74 70 74 72 5f 74 29 72 65 73 2e 6e  )(intptr_t)res.n
1070: 44 61 74 61 3b 0a 20 20 69 66 28 20 28 72 63 26  Data;.  if( (rc&
1080: 30 78 66 66 29 3d 3d 53 51 4c 49 54 45 5f 41 42  0xff)==SQLITE_AB
1090: 4f 52 54 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  ORT ){.    sqlit
10a0: 65 33 5f 66 72 65 65 5f 74 61 62 6c 65 28 26 72  e3_free_table(&r
10b0: 65 73 2e 61 7a 52 65 73 75 6c 74 5b 31 5d 29 3b  es.azResult[1]);
10c0: 0a 20 20 20 20 69 66 28 20 72 65 73 2e 7a 45 72  .    if( res.zEr
10d0: 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 69 66  rMsg ){.      if
10e0: 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20  ( pzErrMsg ){.  
10f0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72        sqlite3_fr
1100: 65 65 28 2a 70 7a 45 72 72 4d 73 67 29 3b 0a 20  ee(*pzErrMsg);. 
1110: 20 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 67         *pzErrMsg
1120: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e   = sqlite3_mprin
1130: 74 66 28 22 25 73 22 2c 72 65 73 2e 7a 45 72 72  tf("%s",res.zErr
1140: 4d 73 67 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  Msg);.      }.  
1150: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65      sqlite3_free
1160: 28 72 65 73 2e 7a 45 72 72 4d 73 67 29 3b 0a 20  (res.zErrMsg);. 
1170: 20 20 20 7d 0a 20 20 20 20 64 62 2d 3e 65 72 72     }.    db->err
1180: 43 6f 64 65 20 3d 20 72 65 73 2e 72 63 3b 20 20  Code = res.rc;  
1190: 2f 2a 20 41 73 73 75 6d 65 20 33 32 2d 62 69 74  /* Assume 32-bit
11a0: 20 61 73 73 69 67 6e 6d 65 6e 74 20 69 73 20 61   assignment is a
11b0: 74 6f 6d 69 63 20 2a 2f 0a 20 20 20 20 72 65 74  tomic */.    ret
11c0: 75 72 6e 20 72 65 73 2e 72 63 3b 0a 20 20 7d 0a  urn res.rc;.  }.
11d0: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 72    sqlite3_free(r
11e0: 65 73 2e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 69  es.zErrMsg);.  i
11f0: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
1200: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
1210: 66 72 65 65 5f 74 61 62 6c 65 28 26 72 65 73 2e  free_table(&res.
1220: 61 7a 52 65 73 75 6c 74 5b 31 5d 29 3b 0a 20 20  azResult[1]);.  
1230: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d    return rc;.  }
1240: 0a 20 20 69 66 28 20 72 65 73 2e 6e 41 6c 6c 6f  .  if( res.nAllo
1250: 63 3e 72 65 73 2e 6e 44 61 74 61 20 29 7b 0a 20  c>res.nData ){. 
1260: 20 20 20 63 68 61 72 20 2a 2a 61 7a 4e 65 77 3b     char **azNew;
1270: 0a 20 20 20 20 61 7a 4e 65 77 20 3d 20 73 71 6c  .    azNew = sql
1280: 69 74 65 33 5f 72 65 61 6c 6c 6f 63 28 20 72 65  ite3_realloc( re
1290: 73 2e 61 7a 52 65 73 75 6c 74 2c 20 73 69 7a 65  s.azResult, size
12a0: 6f 66 28 63 68 61 72 2a 29 2a 28 72 65 73 2e 6e  of(char*)*(res.n
12b0: 44 61 74 61 2b 31 29 20 29 3b 0a 20 20 20 20 69  Data+1) );.    i
12c0: 66 28 20 61 7a 4e 65 77 3d 3d 30 20 29 7b 0a 20  f( azNew==0 ){. 
12d0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65       sqlite3_fre
12e0: 65 5f 74 61 62 6c 65 28 26 72 65 73 2e 61 7a 52  e_table(&res.azR
12f0: 65 73 75 6c 74 5b 31 5d 29 3b 0a 20 20 20 20 20  esult[1]);.     
1300: 20 64 62 2d 3e 65 72 72 43 6f 64 65 20 3d 20 53   db->errCode = S
1310: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20  QLITE_NOMEM;.   
1320: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
1330: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20  _NOMEM;.    }.  
1340: 20 20 72 65 73 2e 6e 41 6c 6c 6f 63 20 3d 20 72    res.nAlloc = r
1350: 65 73 2e 6e 44 61 74 61 2b 31 3b 0a 20 20 20 20  es.nData+1;.    
1360: 72 65 73 2e 61 7a 52 65 73 75 6c 74 20 3d 20 61  res.azResult = a
1370: 7a 4e 65 77 3b 0a 20 20 7d 0a 20 20 2a 70 61 7a  zNew;.  }.  *paz
1380: 52 65 73 75 6c 74 20 3d 20 26 72 65 73 2e 61 7a  Result = &res.az
1390: 52 65 73 75 6c 74 5b 31 5d 3b 0a 20 20 69 66 28  Result[1];.  if(
13a0: 20 70 6e 43 6f 6c 75 6d 6e 20 29 20 2a 70 6e 43   pnColumn ) *pnC
13b0: 6f 6c 75 6d 6e 20 3d 20 72 65 73 2e 6e 43 6f 6c  olumn = res.nCol
13c0: 75 6d 6e 3b 0a 20 20 69 66 28 20 70 6e 52 6f 77  umn;.  if( pnRow
13d0: 20 29 20 2a 70 6e 52 6f 77 20 3d 20 72 65 73 2e   ) *pnRow = res.
13e0: 6e 52 6f 77 3b 0a 20 20 72 65 74 75 72 6e 20 72  nRow;.  return r
13f0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  c;.}../*.** This
1400: 20 72 6f 75 74 69 6e 65 20 66 72 65 65 73 20 74   routine frees t
1410: 68 65 20 73 70 61 63 65 20 74 68 65 20 73 71 6c  he space the sql
1420: 69 74 65 33 5f 67 65 74 5f 74 61 62 6c 65 28 29  ite3_get_table()
1430: 20 6d 61 6c 6c 6f 63 65 64 2e 0a 2a 2f 0a 76 6f   malloced..*/.vo
1440: 69 64 20 73 71 6c 69 74 65 33 5f 66 72 65 65 5f  id sqlite3_free_
1450: 74 61 62 6c 65 28 0a 20 20 63 68 61 72 20 2a 2a  table(.  char **
1460: 61 7a 52 65 73 75 6c 74 20 20 20 20 20 20 20 20  azResult        
1470: 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 72 65      /* Result re
1480: 74 75 72 6e 65 64 20 66 72 6f 6d 20 66 72 6f 6d  turned from from
1490: 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 74 61 62   sqlite3_get_tab
14a0: 6c 65 28 29 20 2a 2f 0a 29 7b 0a 20 20 69 66 28  le() */.){.  if(
14b0: 20 61 7a 52 65 73 75 6c 74 20 29 7b 0a 20 20 20   azResult ){.   
14c0: 20 69 6e 74 70 74 72 5f 74 20 69 2c 20 6e 3b 0a   intptr_t i, n;.
14d0: 20 20 20 20 61 7a 52 65 73 75 6c 74 2d 2d 3b 0a      azResult--;.
14e0: 20 20 20 20 61 73 73 65 72 74 28 20 61 7a 52 65      assert( azRe
14f0: 73 75 6c 74 21 3d 30 20 29 3b 0a 20 20 20 20 6e  sult!=0 );.    n
1500: 20 3d 20 28 69 6e 74 70 74 72 5f 74 29 61 7a 52   = (intptr_t)azR
1510: 65 73 75 6c 74 5b 30 5d 3b 0a 20 20 20 20 66 6f  esult[0];.    fo
1520: 72 28 69 3d 31 3b 20 69 3c 6e 3b 20 69 2b 2b 29  r(i=1; i<n; i++)
1530: 7b 20 69 66 28 20 61 7a 52 65 73 75 6c 74 5b 69  { if( azResult[i
1540: 5d 20 29 20 73 71 6c 69 74 65 33 5f 66 72 65 65  ] ) sqlite3_free
1550: 28 61 7a 52 65 73 75 6c 74 5b 69 5d 29 3b 20 7d  (azResult[i]); }
1560: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65  .    sqlite3_fre
1570: 65 28 61 7a 52 65 73 75 6c 74 29 3b 0a 20 20 7d  e(azResult);.  }
1580: 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  .}..#endif /* SQ
1590: 4c 49 54 45 5f 4f 4d 49 54 5f 47 45 54 5f 54 41  LITE_OMIT_GET_TA
15a0: 42 4c 45 20 2a 2f 0a                             BLE */.