/ Hex Artifact Content
Login

Artifact 1252d80c548711e47a6d84dae88ed4e95d3fbb4e7bd0eaa1347299af7efddf02:


0000: 2f 2a 0a 2a 2a 20 32 30 30 34 20 4d 61 79 20 32  /*.** 2004 May 2
0010: 36 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  6.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
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: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65  .**.** This file
0180: 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64 65 20 75   contains code u
0190: 73 65 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20  se to implement 
01a0: 41 50 49 73 20 74 68 61 74 20 61 72 65 20 70 61  APIs that are pa
01b0: 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 56 44 42  rt of the.** VDB
01c0: 45 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22  E..*/.#include "
01d0: 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e  sqliteInt.h".#in
01e0: 63 6c 75 64 65 20 22 76 64 62 65 49 6e 74 2e 68  clude "vdbeInt.h
01f0: 22 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  "..#ifndef SQLIT
0200: 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 45  E_OMIT_DEPRECATE
0210: 44 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54  D./*.** Return T
0220: 52 55 45 20 28 6e 6f 6e 2d 7a 65 72 6f 29 20 6f  RUE (non-zero) o
0230: 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20  f the statement 
0240: 73 75 70 70 6c 69 65 64 20 61 73 20 61 6e 20 61  supplied as an a
0250: 72 67 75 6d 65 6e 74 20 6e 65 65 64 73 0a 2a 2a  rgument needs.**
0260: 20 74 6f 20 62 65 20 72 65 63 6f 6d 70 69 6c 65   to be recompile
0270: 64 2e 20 20 41 20 73 74 61 74 65 6d 65 6e 74 20  d.  A statement 
0280: 6e 65 65 64 73 20 74 6f 20 62 65 20 72 65 63 6f  needs to be reco
0290: 6d 70 69 6c 65 64 20 77 68 65 6e 65 76 65 72 20  mpiled whenever 
02a0: 74 68 65 0a 2a 2a 20 65 78 65 63 75 74 69 6f 6e  the.** execution
02b0: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 63 68 61   environment cha
02c0: 6e 67 65 73 20 69 6e 20 61 20 77 61 79 20 74 68  nges in a way th
02d0: 61 74 20 77 6f 75 6c 64 20 61 6c 74 65 72 20 74  at would alter t
02e0: 68 65 20 70 72 6f 67 72 61 6d 0a 2a 2a 20 74 68  he program.** th
02f0: 61 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61  at sqlite3_prepa
0300: 72 65 28 29 20 67 65 6e 65 72 61 74 65 73 2e 20  re() generates. 
0310: 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66   For example, if
0320: 20 6e 65 77 20 66 75 6e 63 74 69 6f 6e 73 20 6f   new functions o
0330: 72 0a 2a 2a 20 63 6f 6c 6c 61 74 69 6e 67 20 73  r.** collating s
0340: 65 71 75 65 6e 63 65 73 20 61 72 65 20 72 65 67  equences are reg
0350: 69 73 74 65 72 65 64 20 6f 72 20 69 66 20 61 6e  istered or if an
0360: 20 61 75 74 68 6f 72 69 7a 65 72 20 66 75 6e 63   authorizer func
0370: 74 69 6f 6e 20 69 73 0a 2a 2a 20 61 64 64 65 64  tion is.** added
0380: 20 6f 72 20 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a   or changed..*/.
0390: 69 6e 74 20 73 71 6c 69 74 65 33 5f 65 78 70 69  int sqlite3_expi
03a0: 72 65 64 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  red(sqlite3_stmt
03b0: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65   *pStmt){.  Vdbe
03c0: 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74   *p = (Vdbe*)pSt
03d0: 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 3d 3d  mt;.  return p==
03e0: 30 20 7c 7c 20 70 2d 3e 65 78 70 69 72 65 64 3b  0 || p->expired;
03f0: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a  .}.#endif../*.**
0400: 20 43 68 65 63 6b 20 6f 6e 20 61 20 56 64 62 65   Check on a Vdbe
0410: 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 69 74   to make sure it
0420: 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 66 69   has not been fi
0430: 6e 61 6c 69 7a 65 64 2e 20 20 4c 6f 67 0a 2a 2a  nalized.  Log.**
0440: 20 61 6e 20 65 72 72 6f 72 20 61 6e 64 20 72 65   an error and re
0450: 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 74 20  turn true if it 
0460: 68 61 73 20 62 65 65 6e 20 66 69 6e 61 6c 69 7a  has been finaliz
0470: 65 64 20 28 6f 72 20 69 73 20 6f 74 68 65 72 77  ed (or is otherw
0480: 69 73 65 0a 2a 2a 20 69 6e 76 61 6c 69 64 29 2e  ise.** invalid).
0490: 20 20 52 65 74 75 72 6e 20 66 61 6c 73 65 20 69    Return false i
04a0: 66 20 69 74 20 69 73 20 6f 6b 2e 0a 2a 2f 0a 73  f it is ok..*/.s
04b0: 74 61 74 69 63 20 69 6e 74 20 76 64 62 65 53 61  tatic int vdbeSa
04c0: 66 65 74 79 28 56 64 62 65 20 2a 70 29 7b 0a 20  fety(Vdbe *p){. 
04d0: 20 69 66 28 20 70 2d 3e 64 62 3d 3d 30 20 29 7b   if( p->db==0 ){
04e0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67  .    sqlite3_log
04f0: 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20  (SQLITE_MISUSE, 
0500: 22 41 50 49 20 63 61 6c 6c 65 64 20 77 69 74 68  "API called with
0510: 20 66 69 6e 61 6c 69 7a 65 64 20 70 72 65 70 61   finalized prepa
0520: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 22 29 3b  red statement");
0530: 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20  .    return 1;. 
0540: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75   }else{.    retu
0550: 72 6e 20 30 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74  rn 0;.  }.}.stat
0560: 69 63 20 69 6e 74 20 76 64 62 65 53 61 66 65 74  ic int vdbeSafet
0570: 79 4e 6f 74 4e 75 6c 6c 28 56 64 62 65 20 2a 70  yNotNull(Vdbe *p
0580: 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 7b  ){.  if( p==0 ){
0590: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6c 6f 67  .    sqlite3_log
05a0: 28 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20  (SQLITE_MISUSE, 
05b0: 22 41 50 49 20 63 61 6c 6c 65 64 20 77 69 74 68  "API called with
05c0: 20 4e 55 4c 4c 20 70 72 65 70 61 72 65 64 20 73   NULL prepared s
05d0: 74 61 74 65 6d 65 6e 74 22 29 3b 0a 20 20 20 20  tatement");.    
05e0: 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 65 6c 73  return 1;.  }els
05f0: 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 76 64  e{.    return vd
0600: 62 65 53 61 66 65 74 79 28 70 29 3b 0a 20 20 7d  beSafety(p);.  }
0610: 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  .}..#ifndef SQLI
0620: 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 0a 2f 2a  TE_OMIT_TRACE./*
0630: 0a 2a 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 70  .** Invoke the p
0640: 72 6f 66 69 6c 65 20 63 61 6c 6c 62 61 63 6b 2e  rofile callback.
0650: 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69    This routine i
0660: 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 69 66  s only called if
0670: 20 77 65 20 61 6c 72 65 61 64 79 0a 2a 2a 20 6b   we already.** k
0680: 6e 6f 77 20 74 68 61 74 20 74 68 65 20 70 72 6f  now that the pro
0690: 66 69 6c 65 20 63 61 6c 6c 62 61 63 6b 20 69 73  file callback is
06a0: 20 64 65 66 69 6e 65 64 20 61 6e 64 20 6e 65 65   defined and nee
06b0: 64 73 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64  ds to be invoked
06c0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c 49  ..*/.static SQLI
06d0: 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 76 6f 69 64  TE_NOINLINE void
06e0: 20 69 6e 76 6f 6b 65 50 72 6f 66 69 6c 65 43 61   invokeProfileCa
06f0: 6c 6c 62 61 63 6b 28 73 71 6c 69 74 65 33 20 2a  llback(sqlite3 *
0700: 64 62 2c 20 56 64 62 65 20 2a 70 29 7b 0a 20 20  db, Vdbe *p){.  
0710: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 4e  sqlite3_int64 iN
0720: 6f 77 3b 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e  ow;.  sqlite3_in
0730: 74 36 34 20 69 45 6c 61 70 73 65 3b 0a 20 20 61  t64 iElapse;.  a
0740: 73 73 65 72 74 28 20 70 2d 3e 73 74 61 72 74 54  ssert( p->startT
0750: 69 6d 65 3e 30 20 29 3b 0a 20 20 61 73 73 65 72  ime>0 );.  asser
0760: 74 28 20 28 64 62 2d 3e 6d 54 72 61 63 65 20 26  t( (db->mTrace &
0770: 20 28 53 51 4c 49 54 45 5f 54 52 41 43 45 5f 50   (SQLITE_TRACE_P
0780: 52 4f 46 49 4c 45 7c 53 51 4c 49 54 45 5f 54 52  ROFILE|SQLITE_TR
0790: 41 43 45 5f 58 50 52 4f 46 49 4c 45 29 29 21 3d  ACE_XPROFILE))!=
07a0: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64  0 );.  assert( d
07b0: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 3d 3d 30 20  b->init.busy==0 
07c0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  );.  assert( p->
07d0: 7a 53 71 6c 21 3d 30 20 29 3b 0a 20 20 73 71 6c  zSql!=0 );.  sql
07e0: 69 74 65 33 4f 73 43 75 72 72 65 6e 74 54 69 6d  ite3OsCurrentTim
07f0: 65 49 6e 74 36 34 28 64 62 2d 3e 70 56 66 73 2c  eInt64(db->pVfs,
0800: 20 26 69 4e 6f 77 29 3b 0a 20 20 69 45 6c 61 70   &iNow);.  iElap
0810: 73 65 20 3d 20 28 69 4e 6f 77 20 2d 20 70 2d 3e  se = (iNow - p->
0820: 73 74 61 72 74 54 69 6d 65 29 2a 31 30 30 30 30  startTime)*10000
0830: 30 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  00;.#ifndef SQLI
0840: 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 54  TE_OMIT_DEPRECAT
0850: 45 44 0a 20 20 69 66 28 20 64 62 2d 3e 78 50 72  ED.  if( db->xPr
0860: 6f 66 69 6c 65 20 29 7b 0a 20 20 20 20 64 62 2d  ofile ){.    db-
0870: 3e 78 50 72 6f 66 69 6c 65 28 64 62 2d 3e 70 50  >xProfile(db->pP
0880: 72 6f 66 69 6c 65 41 72 67 2c 20 70 2d 3e 7a 53  rofileArg, p->zS
0890: 71 6c 2c 20 69 45 6c 61 70 73 65 29 3b 0a 20 20  ql, iElapse);.  
08a0: 7d 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 64  }.#endif.  if( d
08b0: 62 2d 3e 6d 54 72 61 63 65 20 26 20 53 51 4c 49  b->mTrace & SQLI
08c0: 54 45 5f 54 52 41 43 45 5f 50 52 4f 46 49 4c 45  TE_TRACE_PROFILE
08d0: 20 29 7b 0a 20 20 20 20 64 62 2d 3e 78 54 72 61   ){.    db->xTra
08e0: 63 65 28 53 51 4c 49 54 45 5f 54 52 41 43 45 5f  ce(SQLITE_TRACE_
08f0: 50 52 4f 46 49 4c 45 2c 20 64 62 2d 3e 70 54 72  PROFILE, db->pTr
0900: 61 63 65 41 72 67 2c 20 70 2c 20 28 76 6f 69 64  aceArg, p, (void
0910: 2a 29 26 69 45 6c 61 70 73 65 29 3b 0a 20 20 7d  *)&iElapse);.  }
0920: 0a 20 20 70 2d 3e 73 74 61 72 74 54 69 6d 65 20  .  p->startTime 
0930: 3d 20 30 3b 0a 7d 0a 2f 2a 0a 2a 2a 20 54 68 65  = 0;.}./*.** The
0940: 20 63 68 65 63 6b 50 72 6f 66 69 6c 65 43 61 6c   checkProfileCal
0950: 6c 62 61 63 6b 28 44 42 2c 50 29 20 6d 61 63 72  lback(DB,P) macr
0960: 6f 20 63 68 65 63 6b 73 20 74 6f 20 73 65 65 20  o checks to see 
0970: 69 66 20 61 20 70 72 6f 66 69 6c 65 20 63 61 6c  if a profile cal
0980: 6c 62 61 63 6b 0a 2a 2a 20 69 73 20 6e 65 65 64  lback.** is need
0990: 65 64 2c 20 61 6e 64 20 69 74 20 69 6e 76 6f 6b  ed, and it invok
09a0: 65 73 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20  es the callback 
09b0: 69 66 20 69 74 20 69 73 20 6e 65 65 64 65 64 2e  if it is needed.
09c0: 0a 2a 2f 0a 23 20 64 65 66 69 6e 65 20 63 68 65  .*/.# define che
09d0: 63 6b 50 72 6f 66 69 6c 65 43 61 6c 6c 62 61 63  ckProfileCallbac
09e0: 6b 28 44 42 2c 50 29 20 5c 0a 20 20 20 69 66 28  k(DB,P) \.   if(
09f0: 20 28 28 50 29 2d 3e 73 74 61 72 74 54 69 6d 65   ((P)->startTime
0a00: 29 3e 30 20 29 7b 20 69 6e 76 6f 6b 65 50 72 6f  )>0 ){ invokePro
0a10: 66 69 6c 65 43 61 6c 6c 62 61 63 6b 28 44 42 2c  fileCallback(DB,
0a20: 50 29 3b 20 7d 0a 23 65 6c 73 65 0a 23 20 64 65  P); }.#else.# de
0a30: 66 69 6e 65 20 63 68 65 63 6b 50 72 6f 66 69 6c  fine checkProfil
0a40: 65 43 61 6c 6c 62 61 63 6b 28 44 42 2c 50 29 20  eCallback(DB,P) 
0a50: 20 2f 2a 6e 6f 2d 6f 70 2a 2f 0a 23 65 6e 64 69   /*no-op*/.#endi
0a60: 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c  f../*.** The fol
0a70: 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 20 64  lowing routine d
0a80: 65 73 74 72 6f 79 73 20 61 20 76 69 72 74 75 61  estroys a virtua
0a90: 6c 20 6d 61 63 68 69 6e 65 20 74 68 61 74 20 69  l machine that i
0aa0: 73 20 63 72 65 61 74 65 64 20 62 79 0a 2a 2a 20  s created by.** 
0ab0: 74 68 65 20 73 71 6c 69 74 65 33 5f 63 6f 6d 70  the sqlite3_comp
0ac0: 69 6c 65 28 29 20 72 6f 75 74 69 6e 65 2e 20 54  ile() routine. T
0ad0: 68 65 20 69 6e 74 65 67 65 72 20 72 65 74 75 72  he integer retur
0ae0: 6e 65 64 20 69 73 20 61 6e 20 53 51 4c 49 54 45  ned is an SQLITE
0af0: 5f 0a 2a 2a 20 73 75 63 63 65 73 73 2f 66 61 69  _.** success/fai
0b00: 6c 75 72 65 20 63 6f 64 65 20 74 68 61 74 20 64  lure code that d
0b10: 65 73 63 72 69 62 65 73 20 74 68 65 20 72 65 73  escribes the res
0b20: 75 6c 74 20 6f 66 20 65 78 65 63 75 74 69 6e 67  ult of executing
0b30: 20 74 68 65 20 76 69 72 74 75 61 6c 0a 2a 2a 20   the virtual.** 
0b40: 6d 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54  machine..**.** T
0b50: 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 74 73  his routine sets
0b60: 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20   the error code 
0b70: 61 6e 64 20 73 74 72 69 6e 67 20 72 65 74 75 72  and string retur
0b80: 6e 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65  ned by.** sqlite
0b90: 33 5f 65 72 72 63 6f 64 65 28 29 2c 20 73 71 6c  3_errcode(), sql
0ba0: 69 74 65 33 5f 65 72 72 6d 73 67 28 29 20 61 6e  ite3_errmsg() an
0bb0: 64 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67  d sqlite3_errmsg
0bc0: 31 36 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  16()..*/.int sql
0bd0: 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 73 71  ite3_finalize(sq
0be0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
0bf0: 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  t){.  int rc;.  
0c00: 69 66 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b 0a  if( pStmt==0 ){.
0c10: 20 20 20 20 2f 2a 20 49 4d 50 4c 45 4d 45 4e 54      /* IMPLEMENT
0c20: 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d 35 37 32 32  ATION-OF: R-5722
0c30: 38 2d 31 32 39 30 34 20 49 6e 76 6f 6b 69 6e 67  8-12904 Invoking
0c40: 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a   sqlite3_finaliz
0c50: 65 28 29 20 6f 6e 20 61 20 4e 55 4c 4c 0a 20 20  e() on a NULL.  
0c60: 20 20 2a 2a 20 70 6f 69 6e 74 65 72 20 69 73 20    ** pointer is 
0c70: 61 20 68 61 72 6d 6c 65 73 73 20 6e 6f 2d 6f 70  a harmless no-op
0c80: 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 53 51  . */.    rc = SQ
0c90: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65  LITE_OK;.  }else
0ca0: 7b 0a 20 20 20 20 56 64 62 65 20 2a 76 20 3d 20  {.    Vdbe *v = 
0cb0: 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20  (Vdbe*)pStmt;.  
0cc0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20    sqlite3 *db = 
0cd0: 76 2d 3e 64 62 3b 0a 20 20 20 20 69 66 28 20 76  v->db;.    if( v
0ce0: 64 62 65 53 61 66 65 74 79 28 76 29 20 29 20 72  dbeSafety(v) ) r
0cf0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53  eturn SQLITE_MIS
0d00: 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 73 71  USE_BKPT;.    sq
0d10: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
0d20: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  r(db->mutex);.  
0d30: 20 20 63 68 65 63 6b 50 72 6f 66 69 6c 65 43 61    checkProfileCa
0d40: 6c 6c 62 61 63 6b 28 64 62 2c 20 76 29 3b 0a 20  llback(db, v);. 
0d50: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
0d60: 64 62 65 46 69 6e 61 6c 69 7a 65 28 76 29 3b 0a  dbeFinalize(v);.
0d70: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
0d80: 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b  ApiExit(db, rc);
0d90: 0a 20 20 20 20 73 71 6c 69 74 65 33 4c 65 61 76  .    sqlite3Leav
0da0: 65 4d 75 74 65 78 41 6e 64 43 6c 6f 73 65 5a 6f  eMutexAndCloseZo
0db0: 6d 62 69 65 28 64 62 29 3b 0a 20 20 7d 0a 20 20  mbie(db);.  }.  
0dc0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
0dd0: 0a 2a 2a 20 54 65 72 6d 69 6e 61 74 65 20 74 68  .** Terminate th
0de0: 65 20 63 75 72 72 65 6e 74 20 65 78 65 63 75 74  e current execut
0df0: 69 6f 6e 20 6f 66 20 61 6e 20 53 51 4c 20 73 74  ion of an SQL st
0e00: 61 74 65 6d 65 6e 74 20 61 6e 64 20 72 65 73 65  atement and rese
0e10: 74 20 69 74 0a 2a 2a 20 62 61 63 6b 20 74 6f 20  t it.** back to 
0e20: 69 74 73 20 73 74 61 72 74 69 6e 67 20 73 74 61  its starting sta
0e30: 74 65 20 73 6f 20 74 68 61 74 20 69 74 20 63 61  te so that it ca
0e40: 6e 20 62 65 20 72 65 75 73 65 64 2e 20 41 20 73  n be reused. A s
0e50: 75 63 63 65 73 73 20 63 6f 64 65 20 66 72 6f 6d  uccess code from
0e60: 0a 2a 2a 20 74 68 65 20 70 72 69 6f 72 20 65 78  .** the prior ex
0e70: 65 63 75 74 69 6f 6e 20 69 73 20 72 65 74 75 72  ecution is retur
0e80: 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ned..**.** This 
0e90: 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68 65  routine sets the
0ea0: 20 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20   error code and 
0eb0: 73 74 72 69 6e 67 20 72 65 74 75 72 6e 65 64 20  string returned 
0ec0: 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 65 72  by.** sqlite3_er
0ed0: 72 63 6f 64 65 28 29 2c 20 73 71 6c 69 74 65 33  rcode(), sqlite3
0ee0: 5f 65 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71  _errmsg() and sq
0ef0: 6c 69 74 65 33 5f 65 72 72 6d 73 67 31 36 28 29  lite3_errmsg16()
0f00: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
0f10: 5f 72 65 73 65 74 28 73 71 6c 69 74 65 33 5f 73  _reset(sqlite3_s
0f20: 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 69  tmt *pStmt){.  i
0f30: 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 70 53 74  nt rc;.  if( pSt
0f40: 6d 74 3d 3d 30 20 29 7b 0a 20 20 20 20 72 63 20  mt==0 ){.    rc 
0f50: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d  = SQLITE_OK;.  }
0f60: 65 6c 73 65 7b 0a 20 20 20 20 56 64 62 65 20 2a  else{.    Vdbe *
0f70: 76 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74  v = (Vdbe*)pStmt
0f80: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 20 2a 64  ;.    sqlite3 *d
0f90: 62 20 3d 20 76 2d 3e 64 62 3b 0a 20 20 20 20 73  b = v->db;.    s
0fa0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74  qlite3_mutex_ent
0fb0: 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  er(db->mutex);. 
0fc0: 20 20 20 63 68 65 63 6b 50 72 6f 66 69 6c 65 43     checkProfileC
0fd0: 61 6c 6c 62 61 63 6b 28 64 62 2c 20 76 29 3b 0a  allback(db, v);.
0fe0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
0ff0: 56 64 62 65 52 65 73 65 74 28 76 29 3b 0a 20 20  VdbeReset(v);.  
1000: 20 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 77    sqlite3VdbeRew
1010: 69 6e 64 28 76 29 3b 0a 20 20 20 20 61 73 73 65  ind(v);.    asse
1020: 72 74 28 20 28 72 63 20 26 20 28 64 62 2d 3e 65  rt( (rc & (db->e
1030: 72 72 4d 61 73 6b 29 29 3d 3d 72 63 20 29 3b 0a  rrMask))==rc );.
1040: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
1050: 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b  ApiExit(db, rc);
1060: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
1070: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74  ex_leave(db->mut
1080: 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  ex);.  }.  retur
1090: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53  n rc;.}../*.** S
10a0: 65 74 20 61 6c 6c 20 74 68 65 20 70 61 72 61 6d  et all the param
10b0: 65 74 65 72 73 20 69 6e 20 74 68 65 20 63 6f 6d  eters in the com
10c0: 70 69 6c 65 64 20 53 51 4c 20 73 74 61 74 65 6d  piled SQL statem
10d0: 65 6e 74 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2f 0a  ent to NULL..*/.
10e0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6c 65 61  int sqlite3_clea
10f0: 72 5f 62 69 6e 64 69 6e 67 73 28 73 71 6c 69 74  r_bindings(sqlit
1100: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b  e3_stmt *pStmt){
1110: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20  .  int i;.  int 
1120: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
1130: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
1140: 65 2a 29 70 53 74 6d 74 3b 0a 23 69 66 20 53 51  e*)pStmt;.#if SQ
1150: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a  LITE_THREADSAFE.
1160: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20    sqlite3_mutex 
1170: 2a 6d 75 74 65 78 20 3d 20 28 28 56 64 62 65 2a  *mutex = ((Vdbe*
1180: 29 70 53 74 6d 74 29 2d 3e 64 62 2d 3e 6d 75 74  )pStmt)->db->mut
1190: 65 78 3b 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c  ex;.#endif.  sql
11a0: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
11b0: 28 6d 75 74 65 78 29 3b 0a 20 20 66 6f 72 28 69  (mutex);.  for(i
11c0: 3d 30 3b 20 69 3c 70 2d 3e 6e 56 61 72 3b 20 69  =0; i<p->nVar; i
11d0: 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  ++){.    sqlite3
11e0: 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26  VdbeMemRelease(&
11f0: 70 2d 3e 61 56 61 72 5b 69 5d 29 3b 0a 20 20 20  p->aVar[i]);.   
1200: 20 70 2d 3e 61 56 61 72 5b 69 5d 2e 66 6c 61 67   p->aVar[i].flag
1210: 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20  s = MEM_Null;.  
1220: 7d 0a 20 20 61 73 73 65 72 74 28 20 28 70 2d 3e  }.  assert( (p->
1230: 70 72 65 70 46 6c 61 67 73 20 26 20 53 51 4c 49  prepFlags & SQLI
1240: 54 45 5f 50 52 45 50 41 52 45 5f 53 41 56 45 53  TE_PREPARE_SAVES
1250: 51 4c 29 21 3d 30 20 7c 7c 20 70 2d 3e 65 78 70  QL)!=0 || p->exp
1260: 6d 61 73 6b 3d 3d 30 20 29 3b 0a 20 20 69 66 28  mask==0 );.  if(
1270: 20 70 2d 3e 65 78 70 6d 61 73 6b 20 29 7b 0a 20   p->expmask ){. 
1280: 20 20 20 70 2d 3e 65 78 70 69 72 65 64 20 3d 20     p->expired = 
1290: 31 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  1;.  }.  sqlite3
12a0: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74  _mutex_leave(mut
12b0: 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63  ex);.  return rc
12c0: 3b 0a 7d 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a  ;.}.../*********
12d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
12e0: 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  *** sqlite3_valu
12f0: 65 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  e_  ************
1300: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1310: 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f  ***.** The follo
1320: 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 65 78  wing routines ex
1330: 74 72 61 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f  tract informatio
1340: 6e 20 66 72 6f 6d 20 61 20 4d 65 6d 20 6f 72 20  n from a Mem or 
1350: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 0a 2a 2a  sqlite3_value.**
1360: 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 63   structure..*/.c
1370: 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74  onst void *sqlit
1380: 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28 73 71  e3_value_blob(sq
1390: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61  lite3_value *pVa
13a0: 6c 29 7b 0a 20 20 4d 65 6d 20 2a 70 20 3d 20 28  l){.  Mem *p = (
13b0: 4d 65 6d 2a 29 70 56 61 6c 3b 0a 20 20 69 66 28  Mem*)pVal;.  if(
13c0: 20 70 2d 3e 66 6c 61 67 73 20 26 20 28 4d 45 4d   p->flags & (MEM
13d0: 5f 42 6c 6f 62 7c 4d 45 4d 5f 53 74 72 29 20 29  _Blob|MEM_Str) )
13e0: 7b 0a 20 20 20 20 69 66 28 20 45 78 70 61 6e 64  {.    if( Expand
13f0: 42 6c 6f 62 28 70 29 21 3d 53 51 4c 49 54 45 5f  Blob(p)!=SQLITE_
1400: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65  OK ){.      asse
1410: 72 74 28 20 70 2d 3e 66 6c 61 67 73 3d 3d 4d 45  rt( p->flags==ME
1420: 4d 5f 4e 75 6c 6c 20 26 26 20 70 2d 3e 7a 3d 3d  M_Null && p->z==
1430: 30 20 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72  0 );.      retur
1440: 6e 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70  n 0;.    }.    p
1450: 2d 3e 66 6c 61 67 73 20 7c 3d 20 4d 45 4d 5f 42  ->flags |= MEM_B
1460: 6c 6f 62 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  lob;.    return 
1470: 70 2d 3e 6e 20 3f 20 70 2d 3e 7a 20 3a 20 30 3b  p->n ? p->z : 0;
1480: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65  .  }else{.    re
1490: 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c  turn sqlite3_val
14a0: 75 65 5f 74 65 78 74 28 70 56 61 6c 29 3b 0a 20  ue_text(pVal);. 
14b0: 20 7d 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33   }.}.int sqlite3
14c0: 5f 76 61 6c 75 65 5f 62 79 74 65 73 28 73 71 6c  _value_bytes(sql
14d0: 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c  ite3_value *pVal
14e0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  ){.  return sqli
14f0: 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 70 56  te3ValueBytes(pV
1500: 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 29  al, SQLITE_UTF8)
1510: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  ;.}.int sqlite3_
1520: 76 61 6c 75 65 5f 62 79 74 65 73 31 36 28 73 71  value_bytes16(sq
1530: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61  lite3_value *pVa
1540: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c  l){.  return sql
1550: 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 70  ite3ValueBytes(p
1560: 56 61 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  Val, SQLITE_UTF1
1570: 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 64 6f 75 62  6NATIVE);.}.doub
1580: 6c 65 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  le sqlite3_value
1590: 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f  _double(sqlite3_
15a0: 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20  value *pVal){.  
15b0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64  return sqlite3Vd
15c0: 62 65 52 65 61 6c 56 61 6c 75 65 28 28 4d 65 6d  beRealValue((Mem
15d0: 2a 29 70 56 61 6c 29 3b 0a 7d 0a 69 6e 74 20 73  *)pVal);.}.int s
15e0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74  qlite3_value_int
15f0: 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a  (sqlite3_value *
1600: 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20  pVal){.  return 
1610: 28 69 6e 74 29 73 71 6c 69 74 65 33 56 64 62 65  (int)sqlite3Vdbe
1620: 49 6e 74 56 61 6c 75 65 28 28 4d 65 6d 2a 29 70  IntValue((Mem*)p
1630: 56 61 6c 29 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69  Val);.}.sqlite_i
1640: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 76 61 6c  nt64 sqlite3_val
1650: 75 65 5f 69 6e 74 36 34 28 73 71 6c 69 74 65 33  ue_int64(sqlite3
1660: 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20  _value *pVal){. 
1670: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56   return sqlite3V
1680: 64 62 65 49 6e 74 56 61 6c 75 65 28 28 4d 65 6d  dbeIntValue((Mem
1690: 2a 29 70 56 61 6c 29 3b 0a 7d 0a 75 6e 73 69 67  *)pVal);.}.unsig
16a0: 6e 65 64 20 69 6e 74 20 73 71 6c 69 74 65 33 5f  ned int sqlite3_
16b0: 76 61 6c 75 65 5f 73 75 62 74 79 70 65 28 73 71  value_subtype(sq
16c0: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61  lite3_value *pVa
16d0: 6c 29 7b 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 20  l){.  Mem *pMem 
16e0: 3d 20 28 4d 65 6d 2a 29 70 56 61 6c 3b 0a 20 20  = (Mem*)pVal;.  
16f0: 72 65 74 75 72 6e 20 28 28 70 4d 65 6d 2d 3e 66  return ((pMem->f
1700: 6c 61 67 73 20 26 20 4d 45 4d 5f 53 75 62 74 79  lags & MEM_Subty
1710: 70 65 29 20 3f 20 70 4d 65 6d 2d 3e 65 53 75 62  pe) ? pMem->eSub
1720: 74 79 70 65 20 3a 20 30 29 3b 0a 7d 0a 76 6f 69  type : 0);.}.voi
1730: 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65  d *sqlite3_value
1740: 5f 70 6f 69 6e 74 65 72 28 73 71 6c 69 74 65 33  _pointer(sqlite3
1750: 5f 76 61 6c 75 65 20 2a 70 56 61 6c 2c 20 63 6f  _value *pVal, co
1760: 6e 73 74 20 63 68 61 72 20 2a 7a 50 54 79 70 65  nst char *zPType
1770: 29 7b 0a 20 20 4d 65 6d 20 2a 70 20 3d 20 28 4d  ){.  Mem *p = (M
1780: 65 6d 2a 29 70 56 61 6c 3b 0a 20 20 69 66 28 20  em*)pVal;.  if( 
1790: 28 70 2d 3e 66 6c 61 67 73 26 28 4d 45 4d 5f 54  (p->flags&(MEM_T
17a0: 79 70 65 4d 61 73 6b 7c 4d 45 4d 5f 54 65 72 6d  ypeMask|MEM_Term
17b0: 7c 4d 45 4d 5f 53 75 62 74 79 70 65 29 29 20 3d  |MEM_Subtype)) =
17c0: 3d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  =.              
17d0: 20 20 20 28 4d 45 4d 5f 4e 75 6c 6c 7c 4d 45 4d     (MEM_Null|MEM
17e0: 5f 54 65 72 6d 7c 4d 45 4d 5f 53 75 62 74 79 70  _Term|MEM_Subtyp
17f0: 65 29 0a 20 20 20 26 26 20 7a 50 54 79 70 65 21  e).   && zPType!
1800: 3d 30 0a 20 20 20 26 26 20 70 2d 3e 65 53 75 62  =0.   && p->eSub
1810: 74 79 70 65 3d 3d 27 70 27 0a 20 20 20 26 26 20  type=='p'.   && 
1820: 73 74 72 63 6d 70 28 70 2d 3e 75 2e 7a 50 54 79  strcmp(p->u.zPTy
1830: 70 65 2c 20 7a 50 54 79 70 65 29 3d 3d 30 0a 20  pe, zPType)==0. 
1840: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28   ){.    return (
1850: 76 6f 69 64 2a 29 70 2d 3e 7a 3b 0a 20 20 7d 65  void*)p->z;.  }e
1860: 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  lse{.    return 
1870: 30 3b 0a 20 20 7d 0a 7d 0a 63 6f 6e 73 74 20 75  0;.  }.}.const u
1880: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 73 71  nsigned char *sq
1890: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
18a0: 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a  (sqlite3_value *
18b0: 70 56 61 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20  pVal){.  return 
18c0: 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20  (const unsigned 
18d0: 63 68 61 72 20 2a 29 73 71 6c 69 74 65 33 56 61  char *)sqlite3Va
18e0: 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 20 53 51  lueText(pVal, SQ
18f0: 4c 49 54 45 5f 55 54 46 38 29 3b 0a 7d 0a 23 69  LITE_UTF8);.}.#i
1900: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
1910: 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f  T_UTF16.const vo
1920: 69 64 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75  id *sqlite3_valu
1930: 65 5f 74 65 78 74 31 36 28 73 71 6c 69 74 65 33  e_text16(sqlite3
1940: 5f 76 61 6c 75 65 2a 20 70 56 61 6c 29 7b 0a 20  _value* pVal){. 
1950: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56   return sqlite3V
1960: 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 20 53  alueText(pVal, S
1970: 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56  QLITE_UTF16NATIV
1980: 45 29 3b 0a 7d 0a 63 6f 6e 73 74 20 76 6f 69 64  E);.}.const void
1990: 20 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f   *sqlite3_value_
19a0: 74 65 78 74 31 36 62 65 28 73 71 6c 69 74 65 33  text16be(sqlite3
19b0: 5f 76 61 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20  _value *pVal){. 
19c0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 56   return sqlite3V
19d0: 61 6c 75 65 54 65 78 74 28 70 56 61 6c 2c 20 53  alueText(pVal, S
19e0: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 29 3b 0a  QLITE_UTF16BE);.
19f0: 7d 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71  }.const void *sq
1a00: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
1a10: 31 36 6c 65 28 73 71 6c 69 74 65 33 5f 76 61 6c  16le(sqlite3_val
1a20: 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74  ue *pVal){.  ret
1a30: 75 72 6e 20 73 71 6c 69 74 65 33 56 61 6c 75 65  urn sqlite3Value
1a40: 54 65 78 74 28 70 56 61 6c 2c 20 53 51 4c 49 54  Text(pVal, SQLIT
1a50: 45 5f 55 54 46 31 36 4c 45 29 3b 0a 7d 0a 23 65  E_UTF16LE);.}.#e
1a60: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f  ndif /* SQLITE_O
1a70: 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 2f 2a 20  MIT_UTF16 */./* 
1a80: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31  EVIDENCE-OF: R-1
1a90: 32 37 39 33 2d 34 33 32 38 33 20 45 76 65 72 79  2793-43283 Every
1aa0: 20 76 61 6c 75 65 20 69 6e 20 53 51 4c 69 74 65   value in SQLite
1ab0: 20 68 61 73 20 6f 6e 65 20 6f 66 20 66 69 76 65   has one of five
1ac0: 0a 2a 2a 20 66 75 6e 64 61 6d 65 6e 74 61 6c 20  .** fundamental 
1ad0: 64 61 74 61 74 79 70 65 73 3a 20 36 34 2d 62 69  datatypes: 64-bi
1ae0: 74 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72  t signed integer
1af0: 20 36 34 2d 62 69 74 20 49 45 45 45 20 66 6c 6f   64-bit IEEE flo
1b00: 61 74 69 6e 67 0a 2a 2a 20 70 6f 69 6e 74 20 6e  ating.** point n
1b10: 75 6d 62 65 72 20 73 74 72 69 6e 67 20 42 4c 4f  umber string BLO
1b20: 42 20 4e 55 4c 4c 0a 2a 2f 0a 69 6e 74 20 73 71  B NULL.*/.int sq
1b30: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65  lite3_value_type
1b40: 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 20  (sqlite3_value* 
1b50: 70 56 61 6c 29 7b 0a 20 20 73 74 61 74 69 63 20  pVal){.  static 
1b60: 63 6f 6e 73 74 20 75 38 20 61 54 79 70 65 5b 5d  const u8 aType[]
1b70: 20 3d 20 7b 0a 20 20 20 20 20 53 51 4c 49 54 45   = {.     SQLITE
1b80: 5f 42 4c 4f 42 2c 20 20 20 20 20 2f 2a 20 30 78  _BLOB,     /* 0x
1b90: 30 30 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65  00 (not possible
1ba0: 29 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45  ) */.     SQLITE
1bb0: 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78  _NULL,     /* 0x
1bc0: 30 31 20 4e 55 4c 4c 20 2a 2f 0a 20 20 20 20 20  01 NULL */.     
1bd0: 53 51 4c 49 54 45 5f 54 45 58 54 2c 20 20 20 20  SQLITE_TEXT,    
1be0: 20 2f 2a 20 30 78 30 32 20 54 45 58 54 20 2a 2f   /* 0x02 TEXT */
1bf0: 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 4e 55 4c  .     SQLITE_NUL
1c00: 4c 2c 20 20 20 20 20 2f 2a 20 30 78 30 33 20 28  L,     /* 0x03 (
1c10: 6e 6f 74 20 70 6f 73 73 69 62 6c 65 29 20 2a 2f  not possible) */
1c20: 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 49 4e 54  .     SQLITE_INT
1c30: 45 47 45 52 2c 20 20 2f 2a 20 30 78 30 34 20 49  EGER,  /* 0x04 I
1c40: 4e 54 45 47 45 52 20 2a 2f 0a 20 20 20 20 20 53  NTEGER */.     S
1c50: 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20 20 20  QLITE_NULL,     
1c60: 2f 2a 20 30 78 30 35 20 28 6e 6f 74 20 70 6f 73  /* 0x05 (not pos
1c70: 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20 20 53  sible) */.     S
1c80: 51 4c 49 54 45 5f 49 4e 54 45 47 45 52 2c 20 20  QLITE_INTEGER,  
1c90: 2f 2a 20 30 78 30 36 20 49 4e 54 45 47 45 52 20  /* 0x06 INTEGER 
1ca0: 2b 20 54 45 58 54 20 2a 2f 0a 20 20 20 20 20 53  + TEXT */.     S
1cb0: 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20 20 20  QLITE_NULL,     
1cc0: 2f 2a 20 30 78 30 37 20 28 6e 6f 74 20 70 6f 73  /* 0x07 (not pos
1cd0: 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20 20 53  sible) */.     S
1ce0: 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20 20 20  QLITE_FLOAT,    
1cf0: 2f 2a 20 30 78 30 38 20 46 4c 4f 41 54 20 2a 2f  /* 0x08 FLOAT */
1d00: 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 4e 55 4c  .     SQLITE_NUL
1d10: 4c 2c 20 20 20 20 20 2f 2a 20 30 78 30 39 20 28  L,     /* 0x09 (
1d20: 6e 6f 74 20 70 6f 73 73 69 62 6c 65 29 20 2a 2f  not possible) */
1d30: 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 46 4c 4f  .     SQLITE_FLO
1d40: 41 54 2c 20 20 20 20 2f 2a 20 30 78 30 61 20 46  AT,    /* 0x0a F
1d50: 4c 4f 41 54 20 2b 20 54 45 58 54 20 2a 2f 0a 20  LOAT + TEXT */. 
1d60: 20 20 20 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c      SQLITE_NULL,
1d70: 20 20 20 20 20 2f 2a 20 30 78 30 62 20 28 6e 6f       /* 0x0b (no
1d80: 74 20 70 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20  t possible) */. 
1d90: 20 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 45 47      SQLITE_INTEG
1da0: 45 52 2c 20 20 2f 2a 20 30 78 30 63 20 28 6e 6f  ER,  /* 0x0c (no
1db0: 74 20 70 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20  t possible) */. 
1dc0: 20 20 20 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c      SQLITE_NULL,
1dd0: 20 20 20 20 20 2f 2a 20 30 78 30 64 20 28 6e 6f       /* 0x0d (no
1de0: 74 20 70 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20  t possible) */. 
1df0: 20 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 45 47      SQLITE_INTEG
1e00: 45 52 2c 20 20 2f 2a 20 30 78 30 65 20 28 6e 6f  ER,  /* 0x0e (no
1e10: 74 20 70 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20  t possible) */. 
1e20: 20 20 20 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c      SQLITE_NULL,
1e30: 20 20 20 20 20 2f 2a 20 30 78 30 66 20 28 6e 6f       /* 0x0f (no
1e40: 74 20 70 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20  t possible) */. 
1e50: 20 20 20 20 53 51 4c 49 54 45 5f 42 4c 4f 42 2c      SQLITE_BLOB,
1e60: 20 20 20 20 20 2f 2a 20 30 78 31 30 20 42 4c 4f       /* 0x10 BLO
1e70: 42 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45  B */.     SQLITE
1e80: 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78  _NULL,     /* 0x
1e90: 31 31 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65  11 (not possible
1ea0: 29 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45  ) */.     SQLITE
1eb0: 5f 54 45 58 54 2c 20 20 20 20 20 2f 2a 20 30 78  _TEXT,     /* 0x
1ec0: 31 32 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65  12 (not possible
1ed0: 29 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45  ) */.     SQLITE
1ee0: 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78  _NULL,     /* 0x
1ef0: 31 33 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65  13 (not possible
1f00: 29 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45  ) */.     SQLITE
1f10: 5f 49 4e 54 45 47 45 52 2c 20 20 2f 2a 20 30 78  _INTEGER,  /* 0x
1f20: 31 34 20 49 4e 54 45 47 45 52 20 2b 20 42 4c 4f  14 INTEGER + BLO
1f30: 42 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45  B */.     SQLITE
1f40: 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78  _NULL,     /* 0x
1f50: 31 35 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65  15 (not possible
1f60: 29 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45  ) */.     SQLITE
1f70: 5f 49 4e 54 45 47 45 52 2c 20 20 2f 2a 20 30 78  _INTEGER,  /* 0x
1f80: 31 36 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65  16 (not possible
1f90: 29 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45  ) */.     SQLITE
1fa0: 5f 4e 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78  _NULL,     /* 0x
1fb0: 31 37 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65  17 (not possible
1fc0: 29 20 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45  ) */.     SQLITE
1fd0: 5f 46 4c 4f 41 54 2c 20 20 20 20 2f 2a 20 30 78  _FLOAT,    /* 0x
1fe0: 31 38 20 46 4c 4f 41 54 20 2b 20 42 4c 4f 42 20  18 FLOAT + BLOB 
1ff0: 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 4e  */.     SQLITE_N
2000: 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78 31 39  ULL,     /* 0x19
2010: 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65 29 20   (not possible) 
2020: 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 46  */.     SQLITE_F
2030: 4c 4f 41 54 2c 20 20 20 20 2f 2a 20 30 78 31 61  LOAT,    /* 0x1a
2040: 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65 29 20   (not possible) 
2050: 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 4e  */.     SQLITE_N
2060: 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78 31 62  ULL,     /* 0x1b
2070: 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65 29 20   (not possible) 
2080: 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 49  */.     SQLITE_I
2090: 4e 54 45 47 45 52 2c 20 20 2f 2a 20 30 78 31 63  NTEGER,  /* 0x1c
20a0: 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65 29 20   (not possible) 
20b0: 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 4e  */.     SQLITE_N
20c0: 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78 31 64  ULL,     /* 0x1d
20d0: 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65 29 20   (not possible) 
20e0: 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 49  */.     SQLITE_I
20f0: 4e 54 45 47 45 52 2c 20 20 2f 2a 20 30 78 31 65  NTEGER,  /* 0x1e
2100: 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65 29 20   (not possible) 
2110: 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 4e  */.     SQLITE_N
2120: 55 4c 4c 2c 20 20 20 20 20 2f 2a 20 30 78 31 66  ULL,     /* 0x1f
2130: 20 28 6e 6f 74 20 70 6f 73 73 69 62 6c 65 29 20   (not possible) 
2140: 2a 2f 0a 20 20 20 20 20 53 51 4c 49 54 45 5f 46  */.     SQLITE_F
2150: 4c 4f 41 54 2c 20 20 20 20 2f 2a 20 30 78 32 30  LOAT,    /* 0x20
2160: 20 49 4e 54 52 45 41 4c 20 2a 2f 0a 20 20 20 20   INTREAL */.    
2170: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
2180: 20 20 2f 2a 20 30 78 32 31 20 28 6e 6f 74 20 70    /* 0x21 (not p
2190: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
21a0: 20 53 51 4c 49 54 45 5f 54 45 58 54 2c 20 20 20   SQLITE_TEXT,   
21b0: 20 20 2f 2a 20 30 78 32 32 20 49 4e 54 52 45 41    /* 0x22 INTREA
21c0: 4c 20 2b 20 54 45 58 54 20 2a 2f 0a 20 20 20 20  L + TEXT */.    
21d0: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
21e0: 20 20 2f 2a 20 30 78 32 33 20 28 6e 6f 74 20 70    /* 0x23 (not p
21f0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2200: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
2210: 20 20 2f 2a 20 30 78 32 34 20 28 6e 6f 74 20 70    /* 0x24 (not p
2220: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2230: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
2240: 20 20 2f 2a 20 30 78 32 35 20 28 6e 6f 74 20 70    /* 0x25 (not p
2250: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2260: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
2270: 20 20 2f 2a 20 30 78 32 36 20 28 6e 6f 74 20 70    /* 0x26 (not p
2280: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2290: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
22a0: 20 20 2f 2a 20 30 78 32 37 20 28 6e 6f 74 20 70    /* 0x27 (not p
22b0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
22c0: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
22d0: 20 20 2f 2a 20 30 78 32 38 20 28 6e 6f 74 20 70    /* 0x28 (not p
22e0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
22f0: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
2300: 20 20 2f 2a 20 30 78 32 39 20 28 6e 6f 74 20 70    /* 0x29 (not p
2310: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2320: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
2330: 20 20 2f 2a 20 30 78 32 61 20 28 6e 6f 74 20 70    /* 0x2a (not p
2340: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2350: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
2360: 20 20 2f 2a 20 30 78 32 62 20 28 6e 6f 74 20 70    /* 0x2b (not p
2370: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2380: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
2390: 20 20 2f 2a 20 30 78 32 63 20 28 6e 6f 74 20 70    /* 0x2c (not p
23a0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
23b0: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
23c0: 20 20 2f 2a 20 30 78 32 64 20 28 6e 6f 74 20 70    /* 0x2d (not p
23d0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
23e0: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
23f0: 20 20 2f 2a 20 30 78 32 65 20 28 6e 6f 74 20 70    /* 0x2e (not p
2400: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2410: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
2420: 20 20 2f 2a 20 30 78 32 66 20 28 6e 6f 74 20 70    /* 0x2f (not p
2430: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2440: 20 53 51 4c 49 54 45 5f 42 4c 4f 42 2c 20 20 20   SQLITE_BLOB,   
2450: 20 20 2f 2a 20 30 78 33 30 20 28 6e 6f 74 20 70    /* 0x30 (not p
2460: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2470: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
2480: 20 20 2f 2a 20 30 78 33 31 20 28 6e 6f 74 20 70    /* 0x31 (not p
2490: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
24a0: 20 53 51 4c 49 54 45 5f 54 45 58 54 2c 20 20 20   SQLITE_TEXT,   
24b0: 20 20 2f 2a 20 30 78 33 32 20 28 6e 6f 74 20 70    /* 0x32 (not p
24c0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
24d0: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
24e0: 20 20 2f 2a 20 30 78 33 33 20 28 6e 6f 74 20 70    /* 0x33 (not p
24f0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2500: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
2510: 20 20 2f 2a 20 30 78 33 34 20 28 6e 6f 74 20 70    /* 0x34 (not p
2520: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2530: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
2540: 20 20 2f 2a 20 30 78 33 35 20 28 6e 6f 74 20 70    /* 0x35 (not p
2550: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2560: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
2570: 20 20 2f 2a 20 30 78 33 36 20 28 6e 6f 74 20 70    /* 0x36 (not p
2580: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2590: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
25a0: 20 20 2f 2a 20 30 78 33 37 20 28 6e 6f 74 20 70    /* 0x37 (not p
25b0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
25c0: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
25d0: 20 20 2f 2a 20 30 78 33 38 20 28 6e 6f 74 20 70    /* 0x38 (not p
25e0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
25f0: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
2600: 20 20 2f 2a 20 30 78 33 39 20 28 6e 6f 74 20 70    /* 0x39 (not p
2610: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2620: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
2630: 20 20 2f 2a 20 30 78 33 61 20 28 6e 6f 74 20 70    /* 0x3a (not p
2640: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2650: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
2660: 20 20 2f 2a 20 30 78 33 62 20 28 6e 6f 74 20 70    /* 0x3b (not p
2670: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2680: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
2690: 20 20 2f 2a 20 30 78 33 63 20 28 6e 6f 74 20 70    /* 0x3c (not p
26a0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
26b0: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
26c0: 20 20 2f 2a 20 30 78 33 64 20 28 6e 6f 74 20 70    /* 0x3d (not p
26d0: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
26e0: 20 53 51 4c 49 54 45 5f 46 4c 4f 41 54 2c 20 20   SQLITE_FLOAT,  
26f0: 20 20 2f 2a 20 30 78 33 65 20 28 6e 6f 74 20 70    /* 0x3e (not p
2700: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 20 20  ossible) */.    
2710: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 20 20   SQLITE_NULL,   
2720: 20 20 2f 2a 20 30 78 33 66 20 28 6e 6f 74 20 70    /* 0x3f (not p
2730: 6f 73 73 69 62 6c 65 29 20 2a 2f 0a 20 20 7d 3b  ossible) */.  };
2740: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44  .#ifdef SQLITE_D
2750: 45 42 55 47 0a 20 20 7b 0a 20 20 20 20 69 6e 74  EBUG.  {.    int
2760: 20 65 54 79 70 65 20 3d 20 53 51 4c 49 54 45 5f   eType = SQLITE_
2770: 42 4c 4f 42 3b 0a 20 20 20 20 69 66 28 20 70 56  BLOB;.    if( pV
2780: 61 6c 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f  al->flags & MEM_
2790: 4e 75 6c 6c 20 29 7b 0a 20 20 20 20 20 20 65 54  Null ){.      eT
27a0: 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 4e 55 4c  ype = SQLITE_NUL
27b0: 4c 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28  L;.    }else if(
27c0: 20 70 56 61 6c 2d 3e 66 6c 61 67 73 20 26 20 28   pVal->flags & (
27d0: 4d 45 4d 5f 52 65 61 6c 7c 4d 45 4d 5f 49 6e 74  MEM_Real|MEM_Int
27e0: 52 65 61 6c 29 20 29 7b 0a 20 20 20 20 20 20 65  Real) ){.      e
27f0: 54 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 46 4c  Type = SQLITE_FL
2800: 4f 41 54 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69  OAT;.    }else i
2810: 66 28 20 70 56 61 6c 2d 3e 66 6c 61 67 73 20 26  f( pVal->flags &
2820: 20 4d 45 4d 5f 49 6e 74 20 29 7b 0a 20 20 20 20   MEM_Int ){.    
2830: 20 20 65 54 79 70 65 20 3d 20 53 51 4c 49 54 45    eType = SQLITE
2840: 5f 49 4e 54 45 47 45 52 3b 0a 20 20 20 20 7d 65  _INTEGER;.    }e
2850: 6c 73 65 20 69 66 28 20 70 56 61 6c 2d 3e 66 6c  lse if( pVal->fl
2860: 61 67 73 20 26 20 4d 45 4d 5f 53 74 72 20 29 7b  ags & MEM_Str ){
2870: 0a 20 20 20 20 20 20 65 54 79 70 65 20 3d 20 53  .      eType = S
2880: 51 4c 49 54 45 5f 54 45 58 54 3b 0a 20 20 20 20  QLITE_TEXT;.    
2890: 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 65 54  }.    assert( eT
28a0: 79 70 65 20 3d 3d 20 61 54 79 70 65 5b 70 56 61  ype == aType[pVa
28b0: 6c 2d 3e 66 6c 61 67 73 26 4d 45 4d 5f 41 66 66  l->flags&MEM_Aff
28c0: 4d 61 73 6b 5d 20 29 3b 0a 20 20 7d 0a 23 65 6e  Mask] );.  }.#en
28d0: 64 69 66 0a 20 20 72 65 74 75 72 6e 20 61 54 79  dif.  return aTy
28e0: 70 65 5b 70 56 61 6c 2d 3e 66 6c 61 67 73 26 4d  pe[pVal->flags&M
28f0: 45 4d 5f 41 66 66 4d 61 73 6b 5d 3b 0a 7d 0a 0a  EM_AffMask];.}..
2900: 2f 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69  /* Return true i
2910: 66 20 61 20 70 61 72 61 6d 65 74 65 72 20 74 6f  f a parameter to
2920: 20 78 55 70 64 61 74 65 20 72 65 70 72 65 73 65   xUpdate represe
2930: 6e 74 73 20 61 6e 20 75 6e 63 68 61 6e 67 65 64  nts an unchanged
2940: 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 69 6e 74 20 73   column */.int s
2950: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 6e 6f 63  qlite3_value_noc
2960: 68 61 6e 67 65 28 73 71 6c 69 74 65 33 5f 76 61  hange(sqlite3_va
2970: 6c 75 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65  lue *pVal){.  re
2980: 74 75 72 6e 20 28 70 56 61 6c 2d 3e 66 6c 61 67  turn (pVal->flag
2990: 73 26 28 4d 45 4d 5f 4e 75 6c 6c 7c 4d 45 4d 5f  s&(MEM_Null|MEM_
29a0: 5a 65 72 6f 29 29 3d 3d 28 4d 45 4d 5f 4e 75 6c  Zero))==(MEM_Nul
29b0: 6c 7c 4d 45 4d 5f 5a 65 72 6f 29 3b 0a 7d 0a 0a  l|MEM_Zero);.}..
29c0: 2f 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69  /* Return true i
29d0: 66 20 61 20 70 61 72 61 6d 65 74 65 72 20 76 61  f a parameter va
29e0: 6c 75 65 20 6f 72 69 67 69 6e 61 74 65 64 20 66  lue originated f
29f0: 72 6f 6d 20 61 6e 20 73 71 6c 69 74 65 33 5f 62  rom an sqlite3_b
2a00: 69 6e 64 28 29 20 2a 2f 0a 69 6e 74 20 73 71 6c  ind() */.int sql
2a10: 69 74 65 33 5f 76 61 6c 75 65 5f 66 72 6f 6d 62  ite3_value_fromb
2a20: 69 6e 64 28 73 71 6c 69 74 65 33 5f 76 61 6c 75  ind(sqlite3_valu
2a30: 65 20 2a 70 56 61 6c 29 7b 0a 20 20 72 65 74 75  e *pVal){.  retu
2a40: 72 6e 20 28 70 56 61 6c 2d 3e 66 6c 61 67 73 26  rn (pVal->flags&
2a50: 4d 45 4d 5f 46 72 6f 6d 42 69 6e 64 29 21 3d 30  MEM_FromBind)!=0
2a60: 3b 0a 7d 0a 0a 2f 2a 20 4d 61 6b 65 20 61 20 63  ;.}../* Make a c
2a70: 6f 70 79 20 6f 66 20 61 6e 20 73 71 6c 69 74 65  opy of an sqlite
2a80: 33 5f 76 61 6c 75 65 20 6f 62 6a 65 63 74 0a 2a  3_value object.*
2a90: 2f 0a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  /.sqlite3_value 
2aa0: 2a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64  *sqlite3_value_d
2ab0: 75 70 28 63 6f 6e 73 74 20 73 71 6c 69 74 65 33  up(const sqlite3
2ac0: 5f 76 61 6c 75 65 20 2a 70 4f 72 69 67 29 7b 0a  _value *pOrig){.
2ad0: 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20    sqlite3_value 
2ae0: 2a 70 4e 65 77 3b 0a 20 20 69 66 28 20 70 4f 72  *pNew;.  if( pOr
2af0: 69 67 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30  ig==0 ) return 0
2b00: 3b 0a 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74  ;.  pNew = sqlit
2b10: 65 33 5f 6d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f  e3_malloc( sizeo
2b20: 66 28 2a 70 4e 65 77 29 20 29 3b 0a 20 20 69 66  f(*pNew) );.  if
2b30: 28 20 70 4e 65 77 3d 3d 30 20 29 20 72 65 74 75  ( pNew==0 ) retu
2b40: 72 6e 20 30 3b 0a 20 20 6d 65 6d 73 65 74 28 70  rn 0;.  memset(p
2b50: 4e 65 77 2c 20 30 2c 20 73 69 7a 65 6f 66 28 2a  New, 0, sizeof(*
2b60: 70 4e 65 77 29 29 3b 0a 20 20 6d 65 6d 63 70 79  pNew));.  memcpy
2b70: 28 70 4e 65 77 2c 20 70 4f 72 69 67 2c 20 4d 45  (pNew, pOrig, ME
2b80: 4d 43 45 4c 4c 53 49 5a 45 29 3b 0a 20 20 70 4e  MCELLSIZE);.  pN
2b90: 65 77 2d 3e 66 6c 61 67 73 20 26 3d 20 7e 4d 45  ew->flags &= ~ME
2ba0: 4d 5f 44 79 6e 3b 0a 20 20 70 4e 65 77 2d 3e 64  M_Dyn;.  pNew->d
2bb0: 62 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 4e 65  b = 0;.  if( pNe
2bc0: 77 2d 3e 66 6c 61 67 73 26 28 4d 45 4d 5f 53 74  w->flags&(MEM_St
2bd0: 72 7c 4d 45 4d 5f 42 6c 6f 62 29 20 29 7b 0a 20  r|MEM_Blob) ){. 
2be0: 20 20 20 70 4e 65 77 2d 3e 66 6c 61 67 73 20 26     pNew->flags &
2bf0: 3d 20 7e 28 4d 45 4d 5f 53 74 61 74 69 63 7c 4d  = ~(MEM_Static|M
2c00: 45 4d 5f 44 79 6e 29 3b 0a 20 20 20 20 70 4e 65  EM_Dyn);.    pNe
2c10: 77 2d 3e 66 6c 61 67 73 20 7c 3d 20 4d 45 4d 5f  w->flags |= MEM_
2c20: 45 70 68 65 6d 3b 0a 20 20 20 20 69 66 28 20 73  Ephem;.    if( s
2c30: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 4d 61 6b  qlite3VdbeMemMak
2c40: 65 57 72 69 74 65 61 62 6c 65 28 70 4e 65 77 29  eWriteable(pNew)
2c50: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
2c60: 20 20 20 20 20 73 71 6c 69 74 65 33 56 61 6c 75       sqlite3Valu
2c70: 65 46 72 65 65 28 70 4e 65 77 29 3b 0a 20 20 20  eFree(pNew);.   
2c80: 20 20 20 70 4e 65 77 20 3d 20 30 3b 0a 20 20 20     pNew = 0;.   
2c90: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
2ca0: 70 4e 65 77 3b 0a 7d 0a 0a 2f 2a 20 44 65 73 74  pNew;.}../* Dest
2cb0: 72 6f 79 20 61 6e 20 73 71 6c 69 74 65 33 5f 76  roy an sqlite3_v
2cc0: 61 6c 75 65 20 6f 62 6a 65 63 74 20 70 72 65 76  alue object prev
2cd0: 69 6f 75 73 6c 79 20 6f 62 74 61 69 6e 65 64 20  iously obtained 
2ce0: 66 72 6f 6d 0a 2a 2a 20 73 71 6c 69 74 65 33 5f  from.** sqlite3_
2cf0: 76 61 6c 75 65 5f 64 75 70 28 29 2e 0a 2a 2f 0a  value_dup()..*/.
2d00: 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 76 61 6c  void sqlite3_val
2d10: 75 65 5f 66 72 65 65 28 73 71 6c 69 74 65 33 5f  ue_free(sqlite3_
2d20: 76 61 6c 75 65 20 2a 70 4f 6c 64 29 7b 0a 20 20  value *pOld){.  
2d30: 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65  sqlite3ValueFree
2d40: 28 70 4f 6c 64 29 3b 0a 7d 0a 20 20 0a 0a 2f 2a  (pOld);.}.  ../*
2d50: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2d60: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73 71 6c 69  *********** sqli
2d70: 74 65 33 5f 72 65 73 75 6c 74 5f 20 20 2a 2a 2a  te3_result_  ***
2d80: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
2d90: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20  ************.** 
2da0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f  The following ro
2db0: 75 74 69 6e 65 73 20 61 72 65 20 75 73 65 64 20  utines are used 
2dc0: 62 79 20 75 73 65 72 2d 64 65 66 69 6e 65 64 20  by user-defined 
2dd0: 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 73 70 65  functions to spe
2de0: 63 69 66 79 0a 2a 2a 20 74 68 65 20 66 75 6e 63  cify.** the func
2df0: 74 69 6f 6e 20 72 65 73 75 6c 74 2e 0a 2a 2a 0a  tion result..**.
2e00: 2a 2a 20 54 68 65 20 73 65 74 53 74 72 4f 72 45  ** The setStrOrE
2e10: 72 72 6f 72 28 29 20 66 75 6e 63 74 69 6f 6e 20  rror() function 
2e20: 63 61 6c 6c 73 20 73 71 6c 69 74 65 33 56 64 62  calls sqlite3Vdb
2e30: 65 4d 65 6d 53 65 74 53 74 72 28 29 20 74 6f 20  eMemSetStr() to 
2e40: 73 74 6f 72 65 20 74 68 65 0a 2a 2a 20 72 65 73  store the.** res
2e50: 75 6c 74 20 61 73 20 61 20 73 74 72 69 6e 67 20  ult as a string 
2e60: 6f 72 20 62 6c 6f 62 20 62 75 74 20 69 66 20 74  or blob but if t
2e70: 68 65 20 73 74 72 69 6e 67 20 6f 72 20 62 6c 6f  he string or blo
2e80: 62 20 69 73 20 74 6f 6f 20 6c 61 72 67 65 2c 20  b is too large, 
2e90: 69 74 0a 2a 2a 20 74 68 65 6e 20 73 65 74 73 20  it.** then sets 
2ea0: 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 74  the error code t
2eb0: 6f 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 0a  o SQLITE_TOOBIG.
2ec0: 2a 2a 0a 2a 2a 20 54 68 65 20 69 6e 76 6f 6b 65  **.** The invoke
2ed0: 56 61 6c 75 65 44 65 73 74 72 75 63 74 6f 72 28  ValueDestructor(
2ee0: 50 2c 58 29 20 72 6f 75 74 69 6e 65 20 69 6e 76  P,X) routine inv
2ef0: 6f 6b 65 73 20 64 65 73 74 72 75 63 74 6f 72 20  okes destructor 
2f00: 66 75 6e 63 74 69 6f 6e 20 58 28 29 0a 2a 2a 20  function X().** 
2f10: 6f 6e 20 76 61 6c 75 65 20 50 20 69 73 20 6e 6f  on value P is no
2f20: 74 20 67 6f 69 6e 67 20 74 6f 20 62 65 20 75 73  t going to be us
2f30: 65 64 20 61 6e 64 20 6e 65 65 64 20 74 6f 20 62  ed and need to b
2f40: 65 20 64 65 73 74 72 6f 79 65 64 2e 0a 2a 2f 0a  e destroyed..*/.
2f50: 73 74 61 74 69 63 20 76 6f 69 64 20 73 65 74 52  static void setR
2f60: 65 73 75 6c 74 53 74 72 4f 72 45 72 72 6f 72 28  esultStrOrError(
2f70: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  .  sqlite3_conte
2f80: 78 74 20 2a 70 43 74 78 2c 20 20 2f 2a 20 46 75  xt *pCtx,  /* Fu
2f90: 6e 63 74 69 6f 6e 20 63 6f 6e 74 65 78 74 20 2a  nction context *
2fa0: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
2fb0: 7a 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53  z,          /* S
2fc0: 74 72 69 6e 67 20 70 6f 69 6e 74 65 72 20 2a 2f  tring pointer */
2fd0: 0a 20 20 69 6e 74 20 6e 2c 20 20 20 20 20 20 20  .  int n,       
2fe0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79             /* By
2ff0: 74 65 73 20 69 6e 20 73 74 72 69 6e 67 2c 20 6f  tes in string, o
3000: 72 20 6e 65 67 61 74 69 76 65 20 2a 2f 0a 20 20  r negative */.  
3010: 75 38 20 65 6e 63 2c 20 20 20 20 20 20 20 20 20  u8 enc,         
3020: 20 20 20 20 20 20 20 20 2f 2a 20 45 6e 63 6f 64          /* Encod
3030: 69 6e 67 20 6f 66 20 7a 2e 20 20 30 20 66 6f 72  ing of z.  0 for
3040: 20 42 4c 4f 42 73 20 2a 2f 0a 20 20 76 6f 69 64   BLOBs */.  void
3050: 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 20   (*xDel)(void*) 
3060: 20 20 20 20 2f 2a 20 44 65 73 74 72 75 63 74 6f      /* Destructo
3070: 72 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 29 7b  r function */.){
3080: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 56 64  .  if( sqlite3Vd
3090: 62 65 4d 65 6d 53 65 74 53 74 72 28 70 43 74 78  beMemSetStr(pCtx
30a0: 2d 3e 70 4f 75 74 2c 20 7a 2c 20 6e 2c 20 65 6e  ->pOut, z, n, en
30b0: 63 2c 20 78 44 65 6c 29 3d 3d 53 51 4c 49 54 45  c, xDel)==SQLITE
30c0: 5f 54 4f 4f 42 49 47 20 29 7b 0a 20 20 20 20 73  _TOOBIG ){.    s
30d0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72  qlite3_result_er
30e0: 72 6f 72 5f 74 6f 6f 62 69 67 28 70 43 74 78 29  ror_toobig(pCtx)
30f0: 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20 69  ;.  }.}.static i
3100: 6e 74 20 69 6e 76 6f 6b 65 56 61 6c 75 65 44 65  nt invokeValueDe
3110: 73 74 72 75 63 74 6f 72 28 0a 20 20 63 6f 6e 73  structor(.  cons
3120: 74 20 76 6f 69 64 20 2a 70 2c 20 20 20 20 20 20  t void *p,      
3130: 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20         /* Value 
3140: 74 6f 20 64 65 73 74 72 6f 79 20 2a 2f 0a 20 20  to destroy */.  
3150: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
3160: 64 2a 29 2c 20 20 20 20 20 20 20 2f 2a 20 54 68  d*),       /* Th
3170: 65 20 64 65 73 74 72 75 63 74 6f 72 20 2a 2f 0a  e destructor */.
3180: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78    sqlite3_contex
3190: 74 20 2a 70 43 74 78 20 20 20 20 20 20 2f 2a 20  t *pCtx      /* 
31a0: 53 65 74 20 61 20 53 51 4c 49 54 45 5f 54 4f 4f  Set a SQLITE_TOO
31b0: 42 49 47 20 65 72 72 6f 72 20 69 66 20 6e 6f 20  BIG error if no 
31c0: 4e 55 4c 4c 20 2a 2f 0a 29 7b 0a 20 20 61 73 73  NULL */.){.  ass
31d0: 65 72 74 28 20 78 44 65 6c 21 3d 53 51 4c 49 54  ert( xDel!=SQLIT
31e0: 45 5f 44 59 4e 41 4d 49 43 20 29 3b 0a 20 20 69  E_DYNAMIC );.  i
31f0: 66 28 20 78 44 65 6c 3d 3d 30 20 29 7b 0a 20 20  f( xDel==0 ){.  
3200: 20 20 2f 2a 20 6e 6f 6f 70 20 2a 2f 0a 20 20 7d    /* noop */.  }
3210: 65 6c 73 65 20 69 66 28 20 78 44 65 6c 3d 3d 53  else if( xDel==S
3220: 51 4c 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 20  QLITE_TRANSIENT 
3230: 29 7b 0a 20 20 20 20 2f 2a 20 6e 6f 6f 70 20 2a  ){.    /* noop *
3240: 2f 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 78  /.  }else{.    x
3250: 44 65 6c 28 28 76 6f 69 64 2a 29 70 29 3b 0a 20  Del((void*)p);. 
3260: 20 7d 0a 20 20 69 66 28 20 70 43 74 78 20 29 20   }.  if( pCtx ) 
3270: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65  sqlite3_result_e
3280: 72 72 6f 72 5f 74 6f 6f 62 69 67 28 70 43 74 78  rror_toobig(pCtx
3290: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  );.  return SQLI
32a0: 54 45 5f 54 4f 4f 42 49 47 3b 0a 7d 0a 76 6f 69  TE_TOOBIG;.}.voi
32b0: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
32c0: 5f 62 6c 6f 62 28 0a 20 20 73 71 6c 69 74 65 33  _blob(.  sqlite3
32d0: 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20  _context *pCtx, 
32e0: 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a  .  const void *z
32f0: 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20 76  , .  int n, .  v
3300: 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64  oid (*xDel)(void
3310: 20 2a 29 0a 29 7b 0a 20 20 61 73 73 65 72 74 28   *).){.  assert(
3320: 20 6e 3e 3d 30 20 29 3b 0a 20 20 61 73 73 65 72   n>=0 );.  asser
3330: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
3340: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74  _held(pCtx->pOut
3350: 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  ->db->mutex) );.
3360: 20 20 73 65 74 52 65 73 75 6c 74 53 74 72 4f 72    setResultStrOr
3370: 45 72 72 6f 72 28 70 43 74 78 2c 20 7a 2c 20 6e  Error(pCtx, z, n
3380: 2c 20 30 2c 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f  , 0, xDel);.}.vo
3390: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  id sqlite3_resul
33a0: 74 5f 62 6c 6f 62 36 34 28 0a 20 20 73 71 6c 69  t_blob64(.  sqli
33b0: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
33c0: 78 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64  x, .  const void
33d0: 20 2a 7a 2c 20 0a 20 20 73 71 6c 69 74 65 33 5f   *z, .  sqlite3_
33e0: 75 69 6e 74 36 34 20 6e 2c 0a 20 20 76 6f 69 64  uint64 n,.  void
33f0: 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a 29   (*xDel)(void *)
3400: 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71  .){.  assert( sq
3410: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
3420: 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d  (pCtx->pOut->db-
3430: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73  >mutex) );.  ass
3440: 65 72 74 28 20 78 44 65 6c 21 3d 53 51 4c 49 54  ert( xDel!=SQLIT
3450: 45 5f 44 59 4e 41 4d 49 43 20 29 3b 0a 20 20 69  E_DYNAMIC );.  i
3460: 66 28 20 6e 3e 30 78 37 66 66 66 66 66 66 66 20  f( n>0x7fffffff 
3470: 29 7b 0a 20 20 20 20 28 76 6f 69 64 29 69 6e 76  ){.    (void)inv
3480: 6f 6b 65 56 61 6c 75 65 44 65 73 74 72 75 63 74  okeValueDestruct
3490: 6f 72 28 7a 2c 20 78 44 65 6c 2c 20 70 43 74 78  or(z, xDel, pCtx
34a0: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
34b0: 73 65 74 52 65 73 75 6c 74 53 74 72 4f 72 45 72  setResultStrOrEr
34c0: 72 6f 72 28 70 43 74 78 2c 20 7a 2c 20 28 69 6e  ror(pCtx, z, (in
34d0: 74 29 6e 2c 20 30 2c 20 78 44 65 6c 29 3b 0a 20  t)n, 0, xDel);. 
34e0: 20 7d 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65   }.}.void sqlite
34f0: 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28  3_result_double(
3500: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
3510: 2a 70 43 74 78 2c 20 64 6f 75 62 6c 65 20 72 56  *pCtx, double rV
3520: 61 6c 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73  al){.  assert( s
3530: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
3540: 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62  d(pCtx->pOut->db
3550: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71  ->mutex) );.  sq
3560: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 44  lite3VdbeMemSetD
3570: 6f 75 62 6c 65 28 70 43 74 78 2d 3e 70 4f 75 74  ouble(pCtx->pOut
3580: 2c 20 72 56 61 6c 29 3b 0a 7d 0a 76 6f 69 64 20  , rVal);.}.void 
3590: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65  sqlite3_result_e
35a0: 72 72 6f 72 28 73 71 6c 69 74 65 33 5f 63 6f 6e  rror(sqlite3_con
35b0: 74 65 78 74 20 2a 70 43 74 78 2c 20 63 6f 6e 73  text *pCtx, cons
35c0: 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e  t char *z, int n
35d0: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  ){.  assert( sql
35e0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
35f0: 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e  pCtx->pOut->db->
3600: 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 43 74 78  mutex) );.  pCtx
3610: 2d 3e 69 73 45 72 72 6f 72 20 3d 20 53 51 4c 49  ->isError = SQLI
3620: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 73 71 6c 69  TE_ERROR;.  sqli
3630: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72  te3VdbeMemSetStr
3640: 28 70 43 74 78 2d 3e 70 4f 75 74 2c 20 7a 2c 20  (pCtx->pOut, z, 
3650: 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20  n, SQLITE_UTF8, 
3660: 53 51 4c 49 54 45 5f 54 52 41 4e 53 49 45 4e 54  SQLITE_TRANSIENT
3670: 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c  );.}.#ifndef SQL
3680: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 76  ITE_OMIT_UTF16.v
3690: 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75  oid sqlite3_resu
36a0: 6c 74 5f 65 72 72 6f 72 31 36 28 73 71 6c 69 74  lt_error16(sqlit
36b0: 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78  e3_context *pCtx
36c0: 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c  , const void *z,
36d0: 20 69 6e 74 20 6e 29 7b 0a 20 20 61 73 73 65 72   int n){.  asser
36e0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
36f0: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74  _held(pCtx->pOut
3700: 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  ->db->mutex) );.
3710: 20 20 70 43 74 78 2d 3e 69 73 45 72 72 6f 72 20    pCtx->isError 
3720: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  = SQLITE_ERROR;.
3730: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
3740: 53 65 74 53 74 72 28 70 43 74 78 2d 3e 70 4f 75  SetStr(pCtx->pOu
3750: 74 2c 20 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f  t, z, n, SQLITE_
3760: 55 54 46 31 36 4e 41 54 49 56 45 2c 20 53 51 4c  UTF16NATIVE, SQL
3770: 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a  ITE_TRANSIENT);.
3780: 7d 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71  }.#endif.void sq
3790: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74  lite3_result_int
37a0: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74  (sqlite3_context
37b0: 20 2a 70 43 74 78 2c 20 69 6e 74 20 69 56 61 6c   *pCtx, int iVal
37c0: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  ){.  assert( sql
37d0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
37e0: 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e  pCtx->pOut->db->
37f0: 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69  mutex) );.  sqli
3800: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74  te3VdbeMemSetInt
3810: 36 34 28 70 43 74 78 2d 3e 70 4f 75 74 2c 20 28  64(pCtx->pOut, (
3820: 69 36 34 29 69 56 61 6c 29 3b 0a 7d 0a 76 6f 69  i64)iVal);.}.voi
3830: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
3840: 5f 69 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 63  _int64(sqlite3_c
3850: 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69 36  ontext *pCtx, i6
3860: 34 20 69 56 61 6c 29 7b 0a 20 20 61 73 73 65 72  4 iVal){.  asser
3870: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
3880: 5f 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74  _held(pCtx->pOut
3890: 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  ->db->mutex) );.
38a0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
38b0: 53 65 74 49 6e 74 36 34 28 70 43 74 78 2d 3e 70  SetInt64(pCtx->p
38c0: 4f 75 74 2c 20 69 56 61 6c 29 3b 0a 7d 0a 76 6f  Out, iVal);.}.vo
38d0: 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  id sqlite3_resul
38e0: 74 5f 6e 75 6c 6c 28 73 71 6c 69 74 65 33 5f 63  t_null(sqlite3_c
38f0: 6f 6e 74 65 78 74 20 2a 70 43 74 78 29 7b 0a 20  ontext *pCtx){. 
3900: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3910: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78  _mutex_held(pCtx
3920: 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 65  ->pOut->db->mute
3930: 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 56  x) );.  sqlite3V
3940: 64 62 65 4d 65 6d 53 65 74 4e 75 6c 6c 28 70 43  dbeMemSetNull(pC
3950: 74 78 2d 3e 70 4f 75 74 29 3b 0a 7d 0a 76 6f 69  tx->pOut);.}.voi
3960: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
3970: 5f 70 6f 69 6e 74 65 72 28 0a 20 20 73 71 6c 69  _pointer(.  sqli
3980: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
3990: 78 2c 0a 20 20 76 6f 69 64 20 2a 70 50 74 72 2c  x,.  void *pPtr,
39a0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
39b0: 50 54 79 70 65 2c 0a 20 20 76 6f 69 64 20 28 2a  PType,.  void (*
39c0: 78 44 65 73 74 72 75 63 74 6f 72 29 28 76 6f 69  xDestructor)(voi
39d0: 64 2a 29 0a 29 7b 0a 20 20 4d 65 6d 20 2a 70 4f  d*).){.  Mem *pO
39e0: 75 74 20 3d 20 70 43 74 78 2d 3e 70 4f 75 74 3b  ut = pCtx->pOut;
39f0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
3a00: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 4f  e3_mutex_held(pO
3a10: 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29  ut->db->mutex) )
3a20: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d  ;.  sqlite3VdbeM
3a30: 65 6d 52 65 6c 65 61 73 65 28 70 4f 75 74 29 3b  emRelease(pOut);
3a40: 0a 20 20 70 4f 75 74 2d 3e 66 6c 61 67 73 20 3d  .  pOut->flags =
3a50: 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 73 71 6c   MEM_Null;.  sql
3a60: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 50 6f  ite3VdbeMemSetPo
3a70: 69 6e 74 65 72 28 70 4f 75 74 2c 20 70 50 74 72  inter(pOut, pPtr
3a80: 2c 20 7a 50 54 79 70 65 2c 20 78 44 65 73 74 72  , zPType, xDestr
3a90: 75 63 74 6f 72 29 3b 0a 7d 0a 76 6f 69 64 20 73  uctor);.}.void s
3aa0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 73 75  qlite3_result_su
3ab0: 62 74 79 70 65 28 73 71 6c 69 74 65 33 5f 63 6f  btype(sqlite3_co
3ac0: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 75 6e 73  ntext *pCtx, uns
3ad0: 69 67 6e 65 64 20 69 6e 74 20 65 53 75 62 74 79  igned int eSubty
3ae0: 70 65 29 7b 0a 20 20 4d 65 6d 20 2a 70 4f 75 74  pe){.  Mem *pOut
3af0: 20 3d 20 70 43 74 78 2d 3e 70 4f 75 74 3b 0a 20   = pCtx->pOut;. 
3b00: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3b10: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 4f 75 74  _mutex_held(pOut
3b20: 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  ->db->mutex) );.
3b30: 20 20 70 4f 75 74 2d 3e 65 53 75 62 74 79 70 65    pOut->eSubtype
3b40: 20 3d 20 65 53 75 62 74 79 70 65 20 26 20 30 78   = eSubtype & 0x
3b50: 66 66 3b 0a 20 20 70 4f 75 74 2d 3e 66 6c 61 67  ff;.  pOut->flag
3b60: 73 20 7c 3d 20 4d 45 4d 5f 53 75 62 74 79 70 65  s |= MEM_Subtype
3b70: 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  ;.}.void sqlite3
3b80: 5f 72 65 73 75 6c 74 5f 74 65 78 74 28 0a 20 20  _result_text(.  
3b90: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
3ba0: 2a 70 43 74 78 2c 20 0a 20 20 63 6f 6e 73 74 20  *pCtx, .  const 
3bb0: 63 68 61 72 20 2a 7a 2c 20 0a 20 20 69 6e 74 20  char *z, .  int 
3bc0: 6e 2c 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c  n,.  void (*xDel
3bd0: 29 28 76 6f 69 64 20 2a 29 0a 29 7b 0a 20 20 61  )(void *).){.  a
3be0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
3bf0: 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e  utex_held(pCtx->
3c00: 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29  pOut->db->mutex)
3c10: 20 29 3b 0a 20 20 73 65 74 52 65 73 75 6c 74 53   );.  setResultS
3c20: 74 72 4f 72 45 72 72 6f 72 28 70 43 74 78 2c 20  trOrError(pCtx, 
3c30: 7a 2c 20 6e 2c 20 53 51 4c 49 54 45 5f 55 54 46  z, n, SQLITE_UTF
3c40: 38 2c 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64  8, xDel);.}.void
3c50: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
3c60: 74 65 78 74 36 34 28 0a 20 20 73 71 6c 69 74 65  text64(.  sqlite
3c70: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c  3_context *pCtx,
3c80: 20 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a   .  const char *
3c90: 7a 2c 20 0a 20 20 73 71 6c 69 74 65 33 5f 75 69  z, .  sqlite3_ui
3ca0: 6e 74 36 34 20 6e 2c 0a 20 20 76 6f 69 64 20 28  nt64 n,.  void (
3cb0: 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a 29 2c 0a  *xDel)(void *),.
3cc0: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20    unsigned char 
3cd0: 65 6e 63 0a 29 7b 0a 20 20 61 73 73 65 72 74 28  enc.){.  assert(
3ce0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
3cf0: 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e  eld(pCtx->pOut->
3d00: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20  db->mutex) );.  
3d10: 61 73 73 65 72 74 28 20 78 44 65 6c 21 3d 53 51  assert( xDel!=SQ
3d20: 4c 49 54 45 5f 44 59 4e 41 4d 49 43 20 29 3b 0a  LITE_DYNAMIC );.
3d30: 20 20 69 66 28 20 65 6e 63 3d 3d 53 51 4c 49 54    if( enc==SQLIT
3d40: 45 5f 55 54 46 31 36 20 29 20 65 6e 63 20 3d 20  E_UTF16 ) enc = 
3d50: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49  SQLITE_UTF16NATI
3d60: 56 45 3b 0a 20 20 69 66 28 20 6e 3e 30 78 37 66  VE;.  if( n>0x7f
3d70: 66 66 66 66 66 66 20 29 7b 0a 20 20 20 20 28 76  ffffff ){.    (v
3d80: 6f 69 64 29 69 6e 76 6f 6b 65 56 61 6c 75 65 44  oid)invokeValueD
3d90: 65 73 74 72 75 63 74 6f 72 28 7a 2c 20 78 44 65  estructor(z, xDe
3da0: 6c 2c 20 70 43 74 78 29 3b 0a 20 20 7d 65 6c 73  l, pCtx);.  }els
3db0: 65 7b 0a 20 20 20 20 73 65 74 52 65 73 75 6c 74  e{.    setResult
3dc0: 53 74 72 4f 72 45 72 72 6f 72 28 70 43 74 78 2c  StrOrError(pCtx,
3dd0: 20 7a 2c 20 28 69 6e 74 29 6e 2c 20 65 6e 63 2c   z, (int)n, enc,
3de0: 20 78 44 65 6c 29 3b 0a 20 20 7d 0a 7d 0a 23 69   xDel);.  }.}.#i
3df0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
3e00: 54 5f 55 54 46 31 36 0a 76 6f 69 64 20 73 71 6c  T_UTF16.void sql
3e10: 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74  ite3_result_text
3e20: 31 36 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f  16(.  sqlite3_co
3e30: 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20  ntext *pCtx, .  
3e40: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 2c 20 0a  const void *z, .
3e50: 20 20 69 6e 74 20 6e 2c 20 0a 20 20 76 6f 69 64    int n, .  void
3e60: 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 20 2a 29   (*xDel)(void *)
3e70: 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71  .){.  assert( sq
3e80: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
3e90: 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d  (pCtx->pOut->db-
3ea0: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 65 74  >mutex) );.  set
3eb0: 52 65 73 75 6c 74 53 74 72 4f 72 45 72 72 6f 72  ResultStrOrError
3ec0: 28 70 43 74 78 2c 20 7a 2c 20 6e 2c 20 53 51 4c  (pCtx, z, n, SQL
3ed0: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 2c  ITE_UTF16NATIVE,
3ee0: 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73   xDel);.}.void s
3ef0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65  qlite3_result_te
3f00: 78 74 31 36 62 65 28 0a 20 20 73 71 6c 69 74 65  xt16be(.  sqlite
3f10: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c  3_context *pCtx,
3f20: 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a   .  const void *
3f30: 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20  z, .  int n, .  
3f40: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
3f50: 64 20 2a 29 0a 29 7b 0a 20 20 61 73 73 65 72 74  d *).){.  assert
3f60: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
3f70: 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d  held(pCtx->pOut-
3f80: 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  >db->mutex) );. 
3f90: 20 73 65 74 52 65 73 75 6c 74 53 74 72 4f 72 45   setResultStrOrE
3fa0: 72 72 6f 72 28 70 43 74 78 2c 20 7a 2c 20 6e 2c  rror(pCtx, z, n,
3fb0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 2c   SQLITE_UTF16BE,
3fc0: 20 78 44 65 6c 29 3b 0a 7d 0a 76 6f 69 64 20 73   xDel);.}.void s
3fd0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65  qlite3_result_te
3fe0: 78 74 31 36 6c 65 28 0a 20 20 73 71 6c 69 74 65  xt16le(.  sqlite
3ff0: 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c  3_context *pCtx,
4000: 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a   .  const void *
4010: 7a 2c 20 0a 20 20 69 6e 74 20 6e 2c 20 0a 20 20  z, .  int n, .  
4020: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69  void (*xDel)(voi
4030: 64 20 2a 29 0a 29 7b 0a 20 20 61 73 73 65 72 74  d *).){.  assert
4040: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
4050: 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d  held(pCtx->pOut-
4060: 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  >db->mutex) );. 
4070: 20 73 65 74 52 65 73 75 6c 74 53 74 72 4f 72 45   setResultStrOrE
4080: 72 72 6f 72 28 70 43 74 78 2c 20 7a 2c 20 6e 2c  rror(pCtx, z, n,
4090: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 2c   SQLITE_UTF16LE,
40a0: 20 78 44 65 6c 29 3b 0a 7d 0a 23 65 6e 64 69 66   xDel);.}.#endif
40b0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f   /* SQLITE_OMIT_
40c0: 55 54 46 31 36 20 2a 2f 0a 76 6f 69 64 20 73 71  UTF16 */.void sq
40d0: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c  lite3_result_val
40e0: 75 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  ue(sqlite3_conte
40f0: 78 74 20 2a 70 43 74 78 2c 20 73 71 6c 69 74 65  xt *pCtx, sqlite
4100: 33 5f 76 61 6c 75 65 20 2a 70 56 61 6c 75 65 29  3_value *pValue)
4110: 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  {.  assert( sqli
4120: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
4130: 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d  Ctx->pOut->db->m
4140: 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74  utex) );.  sqlit
4150: 65 33 56 64 62 65 4d 65 6d 43 6f 70 79 28 70 43  e3VdbeMemCopy(pC
4160: 74 78 2d 3e 70 4f 75 74 2c 20 70 56 61 6c 75 65  tx->pOut, pValue
4170: 29 3b 0a 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65  );.}.void sqlite
4180: 33 5f 72 65 73 75 6c 74 5f 7a 65 72 6f 62 6c 6f  3_result_zeroblo
4190: 62 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78  b(sqlite3_contex
41a0: 74 20 2a 70 43 74 78 2c 20 69 6e 74 20 6e 29 7b  t *pCtx, int n){
41b0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
41c0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43  e3_mutex_held(pC
41d0: 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75  tx->pOut->db->mu
41e0: 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65  tex) );.  sqlite
41f0: 33 56 64 62 65 4d 65 6d 53 65 74 5a 65 72 6f 42  3VdbeMemSetZeroB
4200: 6c 6f 62 28 70 43 74 78 2d 3e 70 4f 75 74 2c 20  lob(pCtx->pOut, 
4210: 6e 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  n);.}.int sqlite
4220: 33 5f 72 65 73 75 6c 74 5f 7a 65 72 6f 62 6c 6f  3_result_zeroblo
4230: 62 36 34 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  b64(sqlite3_cont
4240: 65 78 74 20 2a 70 43 74 78 2c 20 75 36 34 20 6e  ext *pCtx, u64 n
4250: 29 7b 0a 20 20 4d 65 6d 20 2a 70 4f 75 74 20 3d  ){.  Mem *pOut =
4260: 20 70 43 74 78 2d 3e 70 4f 75 74 3b 0a 20 20 61   pCtx->pOut;.  a
4270: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
4280: 75 74 65 78 5f 68 65 6c 64 28 70 4f 75 74 2d 3e  utex_held(pOut->
4290: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20  db->mutex) );.  
42a0: 69 66 28 20 6e 3e 28 75 36 34 29 70 4f 75 74 2d  if( n>(u64)pOut-
42b0: 3e 64 62 2d 3e 61 4c 69 6d 69 74 5b 53 51 4c 49  >db->aLimit[SQLI
42c0: 54 45 5f 4c 49 4d 49 54 5f 4c 45 4e 47 54 48 5d  TE_LIMIT_LENGTH]
42d0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   ){.    return S
42e0: 51 4c 49 54 45 5f 54 4f 4f 42 49 47 3b 0a 20 20  QLITE_TOOBIG;.  
42f0: 7d 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d  }.  sqlite3VdbeM
4300: 65 6d 53 65 74 5a 65 72 6f 42 6c 6f 62 28 70 43  emSetZeroBlob(pC
4310: 74 78 2d 3e 70 4f 75 74 2c 20 28 69 6e 74 29 6e  tx->pOut, (int)n
4320: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  );.  return SQLI
4330: 54 45 5f 4f 4b 3b 0a 7d 0a 76 6f 69 64 20 73 71  TE_OK;.}.void sq
4340: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
4350: 6f 72 5f 63 6f 64 65 28 73 71 6c 69 74 65 33 5f  or_code(sqlite3_
4360: 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 2c 20 69  context *pCtx, i
4370: 6e 74 20 65 72 72 43 6f 64 65 29 7b 0a 20 20 70  nt errCode){.  p
4380: 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 65  Ctx->isError = e
4390: 72 72 43 6f 64 65 20 3f 20 65 72 72 43 6f 64 65  rrCode ? errCode
43a0: 20 3a 20 2d 31 3b 0a 23 69 66 64 65 66 20 53 51   : -1;.#ifdef SQ
43b0: 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 69 66 28  LITE_DEBUG.  if(
43c0: 20 70 43 74 78 2d 3e 70 56 64 62 65 20 29 20 70   pCtx->pVdbe ) p
43d0: 43 74 78 2d 3e 70 56 64 62 65 2d 3e 72 63 41 70  Ctx->pVdbe->rcAp
43e0: 70 20 3d 20 65 72 72 43 6f 64 65 3b 0a 23 65 6e  p = errCode;.#en
43f0: 64 69 66 0a 20 20 69 66 28 20 70 43 74 78 2d 3e  dif.  if( pCtx->
4400: 70 4f 75 74 2d 3e 66 6c 61 67 73 20 26 20 4d 45  pOut->flags & ME
4410: 4d 5f 4e 75 6c 6c 20 29 7b 0a 20 20 20 20 73 71  M_Null ){.    sq
4420: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53  lite3VdbeMemSetS
4430: 74 72 28 70 43 74 78 2d 3e 70 4f 75 74 2c 20 73  tr(pCtx->pOut, s
4440: 71 6c 69 74 65 33 45 72 72 53 74 72 28 65 72 72  qlite3ErrStr(err
4450: 43 6f 64 65 29 2c 20 2d 31 2c 20 0a 20 20 20 20  Code), -1, .    
4460: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4470: 20 20 20 20 20 53 51 4c 49 54 45 5f 55 54 46 38       SQLITE_UTF8
4480: 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29  , SQLITE_STATIC)
4490: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 20 46 6f 72 63  ;.  }.}../* Forc
44a0: 65 20 61 6e 20 53 51 4c 49 54 45 5f 54 4f 4f 42  e an SQLITE_TOOB
44b0: 49 47 20 65 72 72 6f 72 2e 20 2a 2f 0a 76 6f 69  IG error. */.voi
44c0: 64 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74  d sqlite3_result
44d0: 5f 65 72 72 6f 72 5f 74 6f 6f 62 69 67 28 73 71  _error_toobig(sq
44e0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70  lite3_context *p
44f0: 43 74 78 29 7b 0a 20 20 61 73 73 65 72 74 28 20  Ctx){.  assert( 
4500: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
4510: 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64  ld(pCtx->pOut->d
4520: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70  b->mutex) );.  p
4530: 43 74 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 53  Ctx->isError = S
4540: 51 4c 49 54 45 5f 54 4f 4f 42 49 47 3b 0a 20 20  QLITE_TOOBIG;.  
4550: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65  sqlite3VdbeMemSe
4560: 74 53 74 72 28 70 43 74 78 2d 3e 70 4f 75 74 2c  tStr(pCtx->pOut,
4570: 20 22 73 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62   "string or blob
4580: 20 74 6f 6f 20 62 69 67 22 2c 20 2d 31 2c 20 0a   too big", -1, .
4590: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
45a0: 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 55 54         SQLITE_UT
45b0: 46 38 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49  F8, SQLITE_STATI
45c0: 43 29 3b 0a 7d 0a 0a 2f 2a 20 41 6e 20 53 51 4c  C);.}../* An SQL
45d0: 49 54 45 5f 4e 4f 4d 45 4d 20 65 72 72 6f 72 2e  ITE_NOMEM error.
45e0: 20 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33   */.void sqlite3
45f0: 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f  _result_error_no
4600: 6d 65 6d 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  mem(sqlite3_cont
4610: 65 78 74 20 2a 70 43 74 78 29 7b 0a 20 20 61 73  ext *pCtx){.  as
4620: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
4630: 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e 70  tex_held(pCtx->p
4640: 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20  Out->db->mutex) 
4650: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  );.  sqlite3Vdbe
4660: 4d 65 6d 53 65 74 4e 75 6c 6c 28 70 43 74 78 2d  MemSetNull(pCtx-
4670: 3e 70 4f 75 74 29 3b 0a 20 20 70 43 74 78 2d 3e  >pOut);.  pCtx->
4680: 69 73 45 72 72 6f 72 20 3d 20 53 51 4c 49 54 45  isError = SQLITE
4690: 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 73  _NOMEM_BKPT;.  s
46a0: 71 6c 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28 70  qlite3OomFault(p
46b0: 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 29 3b 0a  Ctx->pOut->db);.
46c0: 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  }..#ifndef SQLIT
46d0: 45 5f 55 4e 54 45 53 54 41 42 4c 45 0a 2f 2a 20  E_UNTESTABLE./* 
46e0: 46 6f 72 63 65 20 74 68 65 20 49 4e 54 36 34 20  Force the INT64 
46f0: 76 61 6c 75 65 20 63 75 72 72 65 6e 74 6c 79 20  value currently 
4700: 73 74 6f 72 65 64 20 61 73 20 74 68 65 20 72 65  stored as the re
4710: 73 75 6c 74 20 74 6f 20 62 65 0a 2a 2a 20 61 20  sult to be.** a 
4720: 4d 45 4d 5f 49 6e 74 52 65 61 6c 20 76 61 6c 75  MEM_IntReal valu
4730: 65 2e 20 20 53 65 65 20 74 68 65 20 53 51 4c 49  e.  See the SQLI
4740: 54 45 5f 54 45 53 54 43 54 52 4c 5f 52 45 53 55  TE_TESTCTRL_RESU
4750: 4c 54 5f 49 4e 54 52 45 41 4c 0a 2a 2a 20 74 65  LT_INTREAL.** te
4760: 73 74 2d 63 6f 6e 74 72 6f 6c 2e 0a 2a 2f 0a 76  st-control..*/.v
4770: 6f 69 64 20 73 71 6c 69 74 65 33 52 65 73 75 6c  oid sqlite3Resul
4780: 74 49 6e 74 52 65 61 6c 28 73 71 6c 69 74 65 33  tIntReal(sqlite3
4790: 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74 78 29 7b  _context *pCtx){
47a0: 20 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69   .  assert( sqli
47b0: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70  te3_mutex_held(p
47c0: 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d 3e 6d  Ctx->pOut->db->m
47d0: 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70  utex) );.  if( p
47e0: 43 74 78 2d 3e 70 4f 75 74 2d 3e 66 6c 61 67 73  Ctx->pOut->flags
47f0: 20 26 20 4d 45 4d 5f 49 6e 74 20 29 7b 0a 20 20   & MEM_Int ){.  
4800: 20 20 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 66 6c    pCtx->pOut->fl
4810: 61 67 73 20 26 3d 20 7e 4d 45 4d 5f 49 6e 74 3b  ags &= ~MEM_Int;
4820: 0a 20 20 20 20 70 43 74 78 2d 3e 70 4f 75 74 2d  .    pCtx->pOut-
4830: 3e 66 6c 61 67 73 20 7c 3d 20 4d 45 4d 5f 49 6e  >flags |= MEM_In
4840: 74 52 65 61 6c 3b 0a 20 20 7d 0a 7d 0a 23 65 6e  tReal;.  }.}.#en
4850: 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  dif.../*.** This
4860: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
4870: 6c 65 64 20 61 66 74 65 72 20 61 20 74 72 61 6e  led after a tran
4880: 73 61 63 74 69 6f 6e 20 68 61 73 20 62 65 65 6e  saction has been
4890: 20 63 6f 6d 6d 69 74 74 65 64 2e 20 49 74 20 0a   committed. It .
48a0: 2a 2a 20 69 6e 76 6f 6b 65 73 20 63 61 6c 6c 62  ** invokes callb
48b0: 61 63 6b 73 20 72 65 67 69 73 74 65 72 65 64 20  acks registered 
48c0: 77 69 74 68 20 73 71 6c 69 74 65 33 5f 77 61 6c  with sqlite3_wal
48d0: 5f 68 6f 6f 6b 28 29 20 61 73 20 72 65 71 75 69  _hook() as requi
48e0: 72 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  red..*/.static i
48f0: 6e 74 20 64 6f 57 61 6c 43 61 6c 6c 62 61 63 6b  nt doWalCallback
4900: 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  s(sqlite3 *db){.
4910: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
4920: 45 5f 4f 4b 3b 0a 23 69 66 6e 64 65 66 20 53 51  E_OK;.#ifndef SQ
4930: 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20  LITE_OMIT_WAL.  
4940: 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30  int i;.  for(i=0
4950: 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b  ; i<db->nDb; i++
4960: 29 7b 0a 20 20 20 20 42 74 72 65 65 20 2a 70 42  ){.    Btree *pB
4970: 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70  t = db->aDb[i].p
4980: 42 74 3b 0a 20 20 20 20 69 66 28 20 70 42 74 20  Bt;.    if( pBt 
4990: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 45 6e  ){.      int nEn
49a0: 74 72 79 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  try;.      sqlit
49b0: 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 42 74  e3BtreeEnter(pBt
49c0: 29 3b 0a 20 20 20 20 20 20 6e 45 6e 74 72 79 20  );.      nEntry 
49d0: 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 61  = sqlite3PagerWa
49e0: 6c 43 61 6c 6c 62 61 63 6b 28 73 71 6c 69 74 65  lCallback(sqlite
49f0: 33 42 74 72 65 65 50 61 67 65 72 28 70 42 74 29  3BtreePager(pBt)
4a00: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
4a10: 42 74 72 65 65 4c 65 61 76 65 28 70 42 74 29 3b  BtreeLeave(pBt);
4a20: 0a 20 20 20 20 20 20 69 66 28 20 6e 45 6e 74 72  .      if( nEntr
4a30: 79 3e 30 20 26 26 20 64 62 2d 3e 78 57 61 6c 43  y>0 && db->xWalC
4a40: 61 6c 6c 62 61 63 6b 20 26 26 20 72 63 3d 3d 53  allback && rc==S
4a50: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
4a60: 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 78 57 61      rc = db->xWa
4a70: 6c 43 61 6c 6c 62 61 63 6b 28 64 62 2d 3e 70 57  lCallback(db->pW
4a80: 61 6c 41 72 67 2c 20 64 62 2c 20 64 62 2d 3e 61  alArg, db, db->a
4a90: 44 62 5b 69 5d 2e 7a 44 62 53 4e 61 6d 65 2c 20  Db[i].zDbSName, 
4aa0: 6e 45 6e 74 72 79 29 3b 0a 20 20 20 20 20 20 7d  nEntry);.      }
4ab0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69  .    }.  }.#endi
4ac0: 66 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  f.  return rc;.}
4ad0: 0a 0a 0a 2f 2a 0a 2a 2a 20 45 78 65 63 75 74 65  .../*.** Execute
4ae0: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 70   the statement p
4af0: 53 74 6d 74 2c 20 65 69 74 68 65 72 20 75 6e 74  Stmt, either unt
4b00: 69 6c 20 61 20 72 6f 77 20 6f 66 20 64 61 74 61  il a row of data
4b10: 20 69 73 20 72 65 61 64 79 2c 20 74 68 65 0a 2a   is ready, the.*
4b20: 2a 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 63  * statement is c
4b30: 6f 6d 70 6c 65 74 65 6c 79 20 65 78 65 63 75 74  ompletely execut
4b40: 65 64 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 6f  ed or an error o
4b50: 63 63 75 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69  ccurs..**.** Thi
4b60: 73 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d  s routine implem
4b70: 65 6e 74 73 20 74 68 65 20 62 75 6c 6b 20 6f 66  ents the bulk of
4b80: 20 74 68 65 20 6c 6f 67 69 63 20 62 65 68 69 6e   the logic behin
4b90: 64 20 74 68 65 20 73 71 6c 69 74 65 5f 73 74 65  d the sqlite_ste
4ba0: 70 28 29 0a 2a 2a 20 41 50 49 2e 20 20 54 68 65  p().** API.  The
4bb0: 20 6f 6e 6c 79 20 74 68 69 6e 67 20 6f 6d 69 74   only thing omit
4bc0: 74 65 64 20 69 73 20 74 68 65 20 61 75 74 6f 6d  ted is the autom
4bd0: 61 74 69 63 20 72 65 63 6f 6d 70 69 6c 65 20 69  atic recompile i
4be0: 66 20 61 20 0a 2a 2a 20 73 63 68 65 6d 61 20 63  f a .** schema c
4bf0: 68 61 6e 67 65 20 68 61 73 20 6f 63 63 75 72 72  hange has occurr
4c00: 65 64 2e 20 20 54 68 61 74 20 64 65 74 61 69 6c  ed.  That detail
4c10: 20 69 73 20 68 61 6e 64 6c 65 64 20 62 79 20 74   is handled by t
4c20: 68 65 0a 2a 2a 20 6f 75 74 65 72 20 73 71 6c 69  he.** outer sqli
4c30: 74 65 33 5f 73 74 65 70 28 29 20 77 72 61 70 70  te3_step() wrapp
4c40: 65 72 20 70 72 6f 63 65 64 75 72 65 2e 0a 2a 2f  er procedure..*/
4c50: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69  .static int sqli
4c60: 74 65 33 53 74 65 70 28 56 64 62 65 20 2a 70 29  te3Step(Vdbe *p)
4c70: 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b  {.  sqlite3 *db;
4c80: 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73  .  int rc;..  as
4c90: 73 65 72 74 28 70 29 3b 0a 20 20 69 66 28 20 70  sert(p);.  if( p
4ca0: 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41  ->magic!=VDBE_MA
4cb0: 47 49 43 5f 52 55 4e 20 29 7b 0a 20 20 20 20 2f  GIC_RUN ){.    /
4cc0: 2a 20 57 65 20 75 73 65 64 20 74 6f 20 72 65 71  * We used to req
4cd0: 75 69 72 65 20 74 68 61 74 20 73 71 6c 69 74 65  uire that sqlite
4ce0: 33 5f 72 65 73 65 74 28 29 20 62 65 20 63 61 6c  3_reset() be cal
4cf0: 6c 65 64 20 62 65 66 6f 72 65 20 72 65 74 72 79  led before retry
4d00: 69 6e 67 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74  ing.    ** sqlit
4d10: 65 33 5f 73 74 65 70 28 29 20 61 66 74 65 72 20  e3_step() after 
4d20: 61 6e 79 20 65 72 72 6f 72 20 6f 72 20 61 66 74  any error or aft
4d30: 65 72 20 53 51 4c 49 54 45 5f 44 4f 4e 45 2e 20  er SQLITE_DONE. 
4d40: 20 42 75 74 20 62 65 67 69 6e 6e 69 6e 67 0a 20   But beginning. 
4d50: 20 20 20 2a 2a 20 77 69 74 68 20 76 65 72 73 69     ** with versi
4d60: 6f 6e 20 33 2e 37 2e 30 2c 20 77 65 20 63 68 61  on 3.7.0, we cha
4d70: 6e 67 65 64 20 74 68 69 73 20 73 6f 20 74 68 61  nged this so tha
4d80: 74 20 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28  t sqlite3_reset(
4d90: 29 20 77 6f 75 6c 64 0a 20 20 20 20 2a 2a 20 62  ) would.    ** b
4da0: 65 20 63 61 6c 6c 65 64 20 61 75 74 6f 6d 61 74  e called automat
4db0: 69 63 61 6c 6c 79 20 69 6e 73 74 65 61 64 20 6f  ically instead o
4dc0: 66 20 74 68 72 6f 77 69 6e 67 20 74 68 65 20 53  f throwing the S
4dd0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 65 72 72  QLITE_MISUSE err
4de0: 6f 72 2e 0a 20 20 20 20 2a 2a 20 54 68 69 73 20  or..    ** This 
4df0: 22 61 75 74 6f 6d 61 74 69 63 2d 72 65 73 65 74  "automatic-reset
4e00: 22 20 63 68 61 6e 67 65 20 69 73 20 6e 6f 74 20  " change is not 
4e10: 74 65 63 68 6e 69 63 61 6c 6c 79 20 61 6e 20 69  technically an i
4e20: 6e 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 2c 20  ncompatibility, 
4e30: 0a 20 20 20 20 2a 2a 20 73 69 6e 63 65 20 61 6e  .    ** since an
4e40: 79 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 74 68  y application th
4e50: 61 74 20 72 65 63 65 69 76 65 73 20 61 6e 20 53  at receives an S
4e60: 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 69 73 20  QLITE_MISUSE is 
4e70: 62 72 6f 6b 65 6e 20 62 79 0a 20 20 20 20 2a 2a  broken by.    **
4e80: 20 64 65 66 69 6e 69 74 69 6f 6e 2e 0a 20 20 20   definition..   
4e90: 20 2a 2a 0a 20 20 20 20 2a 2a 20 4e 65 76 65 72   **.    ** Never
4ea0: 74 68 65 6c 65 73 73 2c 20 73 6f 6d 65 20 70 75  theless, some pu
4eb0: 62 6c 69 73 68 65 64 20 61 70 70 6c 69 63 61 74  blished applicat
4ec0: 69 6f 6e 73 20 74 68 61 74 20 77 65 72 65 20 6f  ions that were o
4ed0: 72 69 67 69 6e 61 6c 6c 79 20 77 72 69 74 74 65  riginally writte
4ee0: 6e 0a 20 20 20 20 2a 2a 20 66 6f 72 20 76 65 72  n.    ** for ver
4ef0: 73 69 6f 6e 20 33 2e 36 2e 32 33 20 6f 72 20 65  sion 3.6.23 or e
4f00: 61 72 6c 69 65 72 20 64 6f 20 69 6e 20 66 61 63  arlier do in fac
4f10: 74 20 64 65 70 65 6e 64 20 6f 6e 20 53 51 4c 49  t depend on SQLI
4f20: 54 45 5f 4d 49 53 55 53 45 20 0a 20 20 20 20 2a  TE_MISUSE .    *
4f30: 2a 20 72 65 74 75 72 6e 73 2c 20 61 6e 64 20 74  * returns, and t
4f40: 68 6f 73 65 20 77 65 72 65 20 62 72 6f 6b 65 6e  hose were broken
4f50: 20 62 79 20 74 68 65 20 61 75 74 6f 6d 61 74 69   by the automati
4f60: 63 2d 72 65 73 65 74 20 63 68 61 6e 67 65 2e 20  c-reset change. 
4f70: 20 41 73 20 61 0a 20 20 20 20 2a 2a 20 61 20 77   As a.    ** a w
4f80: 6f 72 6b 2d 61 72 6f 75 6e 64 2c 20 74 68 65 20  ork-around, the 
4f90: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f  SQLITE_OMIT_AUTO
4fa0: 52 45 53 45 54 20 63 6f 6d 70 69 6c 65 2d 74 69  RESET compile-ti
4fb0: 6d 65 20 72 65 73 74 6f 72 65 73 20 74 68 65 0a  me restores the.
4fc0: 20 20 20 20 2a 2a 20 6c 65 67 61 63 79 20 62 65      ** legacy be
4fd0: 68 61 76 69 6f 72 20 6f 66 20 72 65 74 75 72 6e  havior of return
4fe0: 69 6e 67 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  ing SQLITE_MISUS
4ff0: 45 20 66 6f 72 20 63 61 73 65 73 20 77 68 65 72  E for cases wher
5000: 65 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 70 72  e the .    ** pr
5010: 65 76 69 6f 75 73 20 73 71 6c 69 74 65 33 5f 73  evious sqlite3_s
5020: 74 65 70 28 29 20 72 65 74 75 72 6e 65 64 20 73  tep() returned s
5030: 6f 6d 65 74 68 69 6e 67 20 6f 74 68 65 72 20 74  omething other t
5040: 68 61 6e 20 61 20 53 51 4c 49 54 45 5f 4c 4f 43  han a SQLITE_LOC
5050: 4b 45 44 0a 20 20 20 20 2a 2a 20 6f 72 20 53 51  KED.    ** or SQ
5060: 4c 49 54 45 5f 42 55 53 59 20 65 72 72 6f 72 2e  LITE_BUSY error.
5070: 0a 20 20 20 20 2a 2f 0a 23 69 66 64 65 66 20 53  .    */.#ifdef S
5080: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 52  QLITE_OMIT_AUTOR
5090: 45 53 45 54 0a 20 20 20 20 69 66 28 20 28 72 63  ESET.    if( (rc
50a0: 20 3d 20 70 2d 3e 72 63 26 30 78 66 66 29 3d 3d   = p->rc&0xff)==
50b0: 53 51 4c 49 54 45 5f 42 55 53 59 20 7c 7c 20 72  SQLITE_BUSY || r
50c0: 63 3d 3d 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44  c==SQLITE_LOCKED
50d0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
50e0: 33 5f 72 65 73 65 74 28 28 73 71 6c 69 74 65 33  3_reset((sqlite3
50f0: 5f 73 74 6d 74 2a 29 70 29 3b 0a 20 20 20 20 7d  _stmt*)p);.    }
5100: 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 65 74 75  else{.      retu
5110: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
5120: 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 23 65 6c  _BKPT;.    }.#el
5130: 73 65 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 72  se.    sqlite3_r
5140: 65 73 65 74 28 28 73 71 6c 69 74 65 33 5f 73 74  eset((sqlite3_st
5150: 6d 74 2a 29 70 29 3b 0a 23 65 6e 64 69 66 0a 20  mt*)p);.#endif. 
5160: 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74   }..  /* Check t
5170: 68 61 74 20 6d 61 6c 6c 6f 63 28 29 20 68 61 73  hat malloc() has
5180: 20 6e 6f 74 20 66 61 69 6c 65 64 2e 20 49 66 20   not failed. If 
5190: 69 74 20 68 61 73 2c 20 72 65 74 75 72 6e 20 65  it has, return e
51a0: 61 72 6c 79 2e 20 2a 2f 0a 20 20 64 62 20 3d 20  arly. */.  db = 
51b0: 70 2d 3e 64 62 3b 0a 20 20 69 66 28 20 64 62 2d  p->db;.  if( db-
51c0: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b  >mallocFailed ){
51d0: 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c  .    p->rc = SQL
51e0: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 72  ITE_NOMEM;.    r
51f0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d  eturn SQLITE_NOM
5200: 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a 20 20  EM_BKPT;.  }..  
5210: 69 66 28 20 70 2d 3e 70 63 3c 30 20 26 26 20 70  if( p->pc<0 && p
5220: 2d 3e 65 78 70 69 72 65 64 20 29 7b 0a 20 20 20  ->expired ){.   
5230: 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f   p->rc = SQLITE_
5240: 53 43 48 45 4d 41 3b 0a 20 20 20 20 72 63 20 3d  SCHEMA;.    rc =
5250: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20   SQLITE_ERROR;. 
5260: 20 20 20 67 6f 74 6f 20 65 6e 64 5f 6f 66 5f 73     goto end_of_s
5270: 74 65 70 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70  tep;.  }.  if( p
5280: 2d 3e 70 63 3c 30 20 29 7b 0a 20 20 20 20 2f 2a  ->pc<0 ){.    /*
5290: 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6e 6f   If there are no
52a0: 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65 6e 74   other statement
52b0: 73 20 63 75 72 72 65 6e 74 6c 79 20 72 75 6e 6e  s currently runn
52c0: 69 6e 67 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a  ing, then.    **
52d0: 20 72 65 73 65 74 20 74 68 65 20 69 6e 74 65 72   reset the inter
52e0: 72 75 70 74 20 66 6c 61 67 2e 20 20 54 68 69 73  rupt flag.  This
52f0: 20 70 72 65 76 65 6e 74 73 20 61 20 63 61 6c 6c   prevents a call
5300: 20 74 6f 20 73 71 6c 69 74 65 33 5f 69 6e 74 65   to sqlite3_inte
5310: 72 72 75 70 74 0a 20 20 20 20 2a 2a 20 66 72 6f  rrupt.    ** fro
5320: 6d 20 69 6e 74 65 72 72 75 70 74 69 6e 67 20 61  m interrupting a
5330: 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61 74 20   statement that 
5340: 68 61 73 20 6e 6f 74 20 79 65 74 20 73 74 61 72  has not yet star
5350: 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20  ted..    */.    
5360: 69 66 28 20 64 62 2d 3e 6e 56 64 62 65 41 63 74  if( db->nVdbeAct
5370: 69 76 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  ive==0 ){.      
5380: 64 62 2d 3e 75 31 2e 69 73 49 6e 74 65 72 72 75  db->u1.isInterru
5390: 70 74 65 64 20 3d 20 30 3b 0a 20 20 20 20 7d 0a  pted = 0;.    }.
53a0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 64 62 2d  .    assert( db-
53b0: 3e 6e 56 64 62 65 57 72 69 74 65 3e 30 20 7c 7c  >nVdbeWrite>0 ||
53c0: 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 3d   db->autoCommit=
53d0: 3d 30 20 0a 20 20 20 20 20 20 20 20 7c 7c 20 28  =0 .        || (
53e0: 64 62 2d 3e 6e 44 65 66 65 72 72 65 64 43 6f 6e  db->nDeferredCon
53f0: 73 3d 3d 30 20 26 26 20 64 62 2d 3e 6e 44 65 66  s==0 && db->nDef
5400: 65 72 72 65 64 49 6d 6d 43 6f 6e 73 3d 3d 30 29  erredImmCons==0)
5410: 0a 20 20 20 20 29 3b 0a 0a 23 69 66 6e 64 65 66  .    );..#ifndef
5420: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41   SQLITE_OMIT_TRA
5430: 43 45 0a 20 20 20 20 69 66 28 20 28 64 62 2d 3e  CE.    if( (db->
5440: 6d 54 72 61 63 65 20 26 20 28 53 51 4c 49 54 45  mTrace & (SQLITE
5450: 5f 54 52 41 43 45 5f 50 52 4f 46 49 4c 45 7c 53  _TRACE_PROFILE|S
5460: 51 4c 49 54 45 5f 54 52 41 43 45 5f 58 50 52 4f  QLITE_TRACE_XPRO
5470: 46 49 4c 45 29 29 21 3d 30 0a 20 20 20 20 20 20  FILE))!=0.      
5480: 20 20 26 26 20 21 64 62 2d 3e 69 6e 69 74 2e 62    && !db->init.b
5490: 75 73 79 20 26 26 20 70 2d 3e 7a 53 71 6c 20 29  usy && p->zSql )
54a0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f  {.      sqlite3O
54b0: 73 43 75 72 72 65 6e 74 54 69 6d 65 49 6e 74 36  sCurrentTimeInt6
54c0: 34 28 64 62 2d 3e 70 56 66 73 2c 20 26 70 2d 3e  4(db->pVfs, &p->
54d0: 73 74 61 72 74 54 69 6d 65 29 3b 0a 20 20 20 20  startTime);.    
54e0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73  }else{.      ass
54f0: 65 72 74 28 20 70 2d 3e 73 74 61 72 74 54 69 6d  ert( p->startTim
5500: 65 3d 3d 30 20 29 3b 0a 20 20 20 20 7d 0a 23 65  e==0 );.    }.#e
5510: 6e 64 69 66 0a 0a 20 20 20 20 64 62 2d 3e 6e 56  ndif..    db->nV
5520: 64 62 65 41 63 74 69 76 65 2b 2b 3b 0a 20 20 20  dbeActive++;.   
5530: 20 69 66 28 20 70 2d 3e 72 65 61 64 4f 6e 6c 79   if( p->readOnly
5540: 3d 3d 30 20 29 20 64 62 2d 3e 6e 56 64 62 65 57  ==0 ) db->nVdbeW
5550: 72 69 74 65 2b 2b 3b 0a 20 20 20 20 69 66 28 20  rite++;.    if( 
5560: 70 2d 3e 62 49 73 52 65 61 64 65 72 20 29 20 64  p->bIsReader ) d
5570: 62 2d 3e 6e 56 64 62 65 52 65 61 64 2b 2b 3b 0a  b->nVdbeRead++;.
5580: 20 20 20 20 70 2d 3e 70 63 20 3d 20 30 3b 0a 20      p->pc = 0;. 
5590: 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45   }.#ifdef SQLITE
55a0: 5f 44 45 42 55 47 0a 20 20 70 2d 3e 72 63 41 70  _DEBUG.  p->rcAp
55b0: 70 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23  p = SQLITE_OK;.#
55c0: 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51  endif.#ifndef SQ
55d0: 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49  LITE_OMIT_EXPLAI
55e0: 4e 0a 20 20 69 66 28 20 70 2d 3e 65 78 70 6c 61  N.  if( p->expla
55f0: 69 6e 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73  in ){.    rc = s
5600: 71 6c 69 74 65 33 56 64 62 65 4c 69 73 74 28 70  qlite3VdbeList(p
5610: 29 3b 0a 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69  );.  }else.#endi
5620: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54  f /* SQLITE_OMIT
5630: 5f 45 58 50 4c 41 49 4e 20 2a 2f 0a 20 20 7b 0a  _EXPLAIN */.  {.
5640: 20 20 20 20 64 62 2d 3e 6e 56 64 62 65 45 78 65      db->nVdbeExe
5650: 63 2b 2b 3b 0a 20 20 20 20 72 63 20 3d 20 73 71  c++;.    rc = sq
5660: 6c 69 74 65 33 56 64 62 65 45 78 65 63 28 70 29  lite3VdbeExec(p)
5670: 3b 0a 20 20 20 20 64 62 2d 3e 6e 56 64 62 65 45  ;.    db->nVdbeE
5680: 78 65 63 2d 2d 3b 0a 20 20 7d 0a 0a 20 20 69 66  xec--;.  }..  if
5690: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 52 4f 57  ( rc!=SQLITE_ROW
56a0: 20 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49   ){.#ifndef SQLI
56b0: 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 0a 20 20  TE_OMIT_TRACE.  
56c0: 20 20 2f 2a 20 49 66 20 74 68 65 20 73 74 61 74    /* If the stat
56d0: 65 6d 65 6e 74 20 63 6f 6d 70 6c 65 74 65 64 20  ement completed 
56e0: 73 75 63 63 65 73 73 66 75 6c 6c 79 2c 20 69 6e  successfully, in
56f0: 76 6f 6b 65 20 74 68 65 20 70 72 6f 66 69 6c 65  voke the profile
5700: 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 20   callback */.   
5710: 20 63 68 65 63 6b 50 72 6f 66 69 6c 65 43 61 6c   checkProfileCal
5720: 6c 62 61 63 6b 28 64 62 2c 20 70 29 3b 0a 23 65  lback(db, p);.#e
5730: 6e 64 69 66 0a 0a 20 20 20 20 69 66 28 20 72 63  ndif..    if( rc
5740: 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 26 26  ==SQLITE_DONE &&
5750: 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20   db->autoCommit 
5760: 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  ){.      assert(
5770: 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f   p->rc==SQLITE_O
5780: 4b 20 29 3b 0a 20 20 20 20 20 20 70 2d 3e 72 63  K );.      p->rc
5790: 20 3d 20 64 6f 57 61 6c 43 61 6c 6c 62 61 63 6b   = doWalCallback
57a0: 73 28 64 62 29 3b 0a 20 20 20 20 20 20 69 66 28  s(db);.      if(
57b0: 20 70 2d 3e 72 63 21 3d 53 51 4c 49 54 45 5f 4f   p->rc!=SQLITE_O
57c0: 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20  K ){.        rc 
57d0: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  = SQLITE_ERROR;.
57e0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
57f0: 7d 0a 0a 20 20 64 62 2d 3e 65 72 72 43 6f 64 65  }..  db->errCode
5800: 20 3d 20 72 63 3b 0a 20 20 69 66 28 20 53 51 4c   = rc;.  if( SQL
5810: 49 54 45 5f 4e 4f 4d 45 4d 3d 3d 73 71 6c 69 74  ITE_NOMEM==sqlit
5820: 65 33 41 70 69 45 78 69 74 28 70 2d 3e 64 62 2c  e3ApiExit(p->db,
5830: 20 70 2d 3e 72 63 29 20 29 7b 0a 20 20 20 20 70   p->rc) ){.    p
5840: 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f  ->rc = SQLITE_NO
5850: 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a 65 6e  MEM_BKPT;.  }.en
5860: 64 5f 6f 66 5f 73 74 65 70 3a 0a 20 20 2f 2a 20  d_of_step:.  /* 
5870: 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 6c 6f  At this point lo
5880: 63 61 6c 20 76 61 72 69 61 62 6c 65 20 72 63 20  cal variable rc 
5890: 68 6f 6c 64 73 20 74 68 65 20 76 61 6c 75 65 20  holds the value 
58a0: 74 68 61 74 20 73 68 6f 75 6c 64 20 62 65 20 0a  that should be .
58b0: 20 20 2a 2a 20 72 65 74 75 72 6e 65 64 20 69 66    ** returned if
58c0: 20 74 68 69 73 20 73 74 61 74 65 6d 65 6e 74 20   this statement 
58d0: 77 61 73 20 63 6f 6d 70 69 6c 65 64 20 75 73 69  was compiled usi
58e0: 6e 67 20 74 68 65 20 6c 65 67 61 63 79 20 0a 20  ng the legacy . 
58f0: 20 2a 2a 20 73 71 6c 69 74 65 33 5f 70 72 65 70   ** sqlite3_prep
5900: 61 72 65 28 29 20 69 6e 74 65 72 66 61 63 65 2e  are() interface.
5910: 20 41 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68   According to th
5920: 65 20 64 6f 63 73 2c 20 74 68 69 73 20 63 61 6e  e docs, this can
5930: 20 6f 6e 6c 79 0a 20 20 2a 2a 20 62 65 20 6f 6e   only.  ** be on
5940: 65 20 6f 66 20 74 68 65 20 76 61 6c 75 65 73 20  e of the values 
5950: 69 6e 20 74 68 65 20 66 69 72 73 74 20 61 73 73  in the first ass
5960: 65 72 74 28 29 20 62 65 6c 6f 77 2e 20 56 61 72  ert() below. Var
5970: 69 61 62 6c 65 20 70 2d 3e 72 63 20 0a 20 20 2a  iable p->rc .  *
5980: 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 76  * contains the v
5990: 61 6c 75 65 20 74 68 61 74 20 77 6f 75 6c 64 20  alue that would 
59a0: 62 65 20 72 65 74 75 72 6e 65 64 20 69 66 20 73  be returned if s
59b0: 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28  qlite3_finalize(
59c0: 29 20 0a 20 20 2a 2a 20 77 65 72 65 20 63 61 6c  ) .  ** were cal
59d0: 6c 65 64 20 6f 6e 20 73 74 61 74 65 6d 65 6e 74  led on statement
59e0: 20 70 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72   p..  */.  asser
59f0: 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 52 4f  t( rc==SQLITE_RO
5a00: 57 20 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45  W  || rc==SQLITE
5a10: 5f 44 4f 4e 45 20 20 20 7c 7c 20 72 63 3d 3d 53  _DONE   || rc==S
5a20: 51 4c 49 54 45 5f 45 52 52 4f 52 20 0a 20 20 20  QLITE_ERROR .   
5a30: 20 20 20 20 7c 7c 20 28 72 63 26 30 78 66 66 29      || (rc&0xff)
5a40: 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 7c 7c  ==SQLITE_BUSY ||
5a50: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4d 49 53 55   rc==SQLITE_MISU
5a60: 53 45 0a 20 20 29 3b 0a 20 20 61 73 73 65 72 74  SE.  );.  assert
5a70: 28 20 28 70 2d 3e 72 63 21 3d 53 51 4c 49 54 45  ( (p->rc!=SQLITE
5a80: 5f 52 4f 57 20 26 26 20 70 2d 3e 72 63 21 3d 53  _ROW && p->rc!=S
5a90: 51 4c 49 54 45 5f 44 4f 4e 45 29 20 7c 7c 20 70  QLITE_DONE) || p
5aa0: 2d 3e 72 63 3d 3d 70 2d 3e 72 63 41 70 70 20 29  ->rc==p->rcApp )
5ab0: 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49  ;.  if( rc!=SQLI
5ac0: 54 45 5f 52 4f 57 20 0a 20 20 20 26 26 20 72 63  TE_ROW .   && rc
5ad0: 21 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 0a 20 20  !=SQLITE_DONE.  
5ae0: 20 26 26 20 28 70 2d 3e 70 72 65 70 46 6c 61 67   && (p->prepFlag
5af0: 73 20 26 20 53 51 4c 49 54 45 5f 50 52 45 50 41  s & SQLITE_PREPA
5b00: 52 45 5f 53 41 56 45 53 51 4c 29 21 3d 30 0a 20  RE_SAVESQL)!=0. 
5b10: 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68   ){.    /* If th
5b20: 69 73 20 73 74 61 74 65 6d 65 6e 74 20 77 61 73  is statement was
5b30: 20 70 72 65 70 61 72 65 64 20 75 73 69 6e 67 20   prepared using 
5b40: 73 61 76 65 64 20 53 51 4c 20 61 6e 64 20 61 6e  saved SQL and an
5b50: 20 0a 20 20 20 20 2a 2a 20 65 72 72 6f 72 20 68   .    ** error h
5b60: 61 73 20 6f 63 63 75 72 72 65 64 2c 20 74 68 65  as occurred, the
5b70: 6e 20 72 65 74 75 72 6e 20 74 68 65 20 65 72 72  n return the err
5b80: 6f 72 20 63 6f 64 65 20 69 6e 20 70 2d 3e 72 63  or code in p->rc
5b90: 20 74 6f 20 74 68 65 0a 20 20 20 20 2a 2a 20 63   to the.    ** c
5ba0: 61 6c 6c 65 72 2e 20 53 65 74 20 74 68 65 20 65  aller. Set the e
5bb0: 72 72 6f 72 20 63 6f 64 65 20 69 6e 20 74 68 65  rror code in the
5bc0: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
5bd0: 20 74 6f 20 74 68 65 20 73 61 6d 65 20 76 61 6c   to the same val
5be0: 75 65 2e 0a 20 20 20 20 2a 2f 20 0a 20 20 20 20  ue..    */ .    
5bf0: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
5c00: 54 72 61 6e 73 66 65 72 45 72 72 6f 72 28 70 29  TransferError(p)
5c10: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 28  ;.  }.  return (
5c20: 72 63 26 64 62 2d 3e 65 72 72 4d 61 73 6b 29 3b  rc&db->errMask);
5c30: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69  .}../*.** This i
5c40: 73 20 74 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20  s the top-level 
5c50: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f  implementation o
5c60: 66 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29  f sqlite3_step()
5c70: 2e 20 20 43 61 6c 6c 0a 2a 2a 20 73 71 6c 69 74  .  Call.** sqlit
5c80: 65 33 53 74 65 70 28 29 20 74 6f 20 64 6f 20 6d  e3Step() to do m
5c90: 6f 73 74 20 6f 66 20 74 68 65 20 77 6f 72 6b 2e  ost of the work.
5ca0: 20 20 49 66 20 61 20 73 63 68 65 6d 61 20 65 72    If a schema er
5cb0: 72 6f 72 20 6f 63 63 75 72 73 2c 0a 2a 2a 20 63  ror occurs,.** c
5cc0: 61 6c 6c 20 73 71 6c 69 74 65 33 52 65 70 72 65  all sqlite3Repre
5cd0: 70 61 72 65 28 29 20 61 6e 64 20 74 72 79 20 61  pare() and try a
5ce0: 67 61 69 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  gain..*/.int sql
5cf0: 69 74 65 33 5f 73 74 65 70 28 73 71 6c 69 74 65  ite3_step(sqlite
5d00: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a  3_stmt *pStmt){.
5d10: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
5d20: 45 5f 4f 4b 3b 20 20 20 20 20 20 2f 2a 20 52 65  E_OK;      /* Re
5d30: 73 75 6c 74 20 66 72 6f 6d 20 73 71 6c 69 74 65  sult from sqlite
5d40: 33 53 74 65 70 28 29 20 2a 2f 0a 20 20 56 64 62  3Step() */.  Vdb
5d50: 65 20 2a 76 20 3d 20 28 56 64 62 65 2a 29 70 53  e *v = (Vdbe*)pS
5d60: 74 6d 74 3b 20 20 2f 2a 20 74 68 65 20 70 72 65  tmt;  /* the pre
5d70: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20  pared statement 
5d80: 2a 2f 0a 20 20 69 6e 74 20 63 6e 74 20 3d 20 30  */.  int cnt = 0
5d90: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
5da0: 20 43 6f 75 6e 74 65 72 20 74 6f 20 70 72 65 76   Counter to prev
5db0: 65 6e 74 20 69 6e 66 69 6e 69 74 65 20 6c 6f 6f  ent infinite loo
5dc0: 70 20 6f 66 20 72 65 70 72 65 70 61 72 65 73 20  p of reprepares 
5dd0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  */.  sqlite3 *db
5de0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
5df0: 20 54 68 65 20 64 61 74 61 62 61 73 65 20 63 6f   The database co
5e00: 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 0a 20 20 69  nnection */..  i
5e10: 66 28 20 76 64 62 65 53 61 66 65 74 79 4e 6f 74  f( vdbeSafetyNot
5e20: 4e 75 6c 6c 28 76 29 20 29 7b 0a 20 20 20 20 72  Null(v) ){.    r
5e30: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53  eturn SQLITE_MIS
5e40: 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20  USE_BKPT;.  }.  
5e50: 64 62 20 3d 20 76 2d 3e 64 62 3b 0a 20 20 73 71  db = v->db;.  sq
5e60: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
5e70: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  r(db->mutex);.  
5e80: 76 2d 3e 64 6f 69 6e 67 52 65 72 75 6e 20 3d 20  v->doingRerun = 
5e90: 30 3b 0a 20 20 77 68 69 6c 65 28 20 28 72 63 20  0;.  while( (rc 
5ea0: 3d 20 73 71 6c 69 74 65 33 53 74 65 70 28 76 29  = sqlite3Step(v)
5eb0: 29 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d 41  )==SQLITE_SCHEMA
5ec0: 0a 20 20 20 20 20 20 20 20 20 26 26 20 63 6e 74  .         && cnt
5ed0: 2b 2b 20 3c 20 53 51 4c 49 54 45 5f 4d 41 58 5f  ++ < SQLITE_MAX_
5ee0: 53 43 48 45 4d 41 5f 52 45 54 52 59 20 29 7b 0a  SCHEMA_RETRY ){.
5ef0: 20 20 20 20 69 6e 74 20 73 61 76 65 64 50 63 20      int savedPc 
5f00: 3d 20 76 2d 3e 70 63 3b 0a 20 20 20 20 72 63 20  = v->pc;.    rc 
5f10: 3d 20 73 71 6c 69 74 65 33 52 65 70 72 65 70 61  = sqlite3Reprepa
5f20: 72 65 28 76 29 3b 0a 20 20 20 20 69 66 28 20 72  re(v);.    if( r
5f30: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
5f40: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 63 61        /* This ca
5f50: 73 65 20 6f 63 63 75 72 73 20 61 66 74 65 72 20  se occurs after 
5f60: 66 61 69 6c 69 6e 67 20 74 6f 20 72 65 63 6f 6d  failing to recom
5f70: 70 69 6c 65 20 61 6e 20 73 71 6c 20 73 74 61 74  pile an sql stat
5f80: 65 6d 65 6e 74 2e 20 0a 20 20 20 20 20 20 2a 2a  ement. .      **
5f90: 20 54 68 65 20 65 72 72 6f 72 20 6d 65 73 73 61   The error messa
5fa0: 67 65 20 66 72 6f 6d 20 74 68 65 20 53 51 4c 20  ge from the SQL 
5fb0: 63 6f 6d 70 69 6c 65 72 20 68 61 73 20 61 6c 72  compiler has alr
5fc0: 65 61 64 79 20 62 65 65 6e 20 6c 6f 61 64 65 64  eady been loaded
5fd0: 20 0a 20 20 20 20 20 20 2a 2a 20 69 6e 74 6f 20   .      ** into 
5fe0: 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e  the database han
5ff0: 64 6c 65 2e 20 54 68 69 73 20 62 6c 6f 63 6b 20  dle. This block 
6000: 63 6f 70 69 65 73 20 74 68 65 20 65 72 72 6f 72  copies the error
6010: 20 6d 65 73 73 61 67 65 20 0a 20 20 20 20 20 20   message .      
6020: 2a 2a 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61  ** from the data
6030: 62 61 73 65 20 68 61 6e 64 6c 65 20 69 6e 74 6f  base handle into
6040: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 61   the statement a
6050: 6e 64 20 73 65 74 73 20 74 68 65 20 73 74 61 74  nd sets the stat
6060: 65 6d 65 6e 74 0a 20 20 20 20 20 20 2a 2a 20 70  ement.      ** p
6070: 72 6f 67 72 61 6d 20 63 6f 75 6e 74 65 72 20 74  rogram counter t
6080: 6f 20 30 20 74 6f 20 65 6e 73 75 72 65 20 74 68  o 0 to ensure th
6090: 61 74 20 77 68 65 6e 20 74 68 65 20 73 74 61 74  at when the stat
60a0: 65 6d 65 6e 74 20 69 73 20 0a 20 20 20 20 20 20  ement is .      
60b0: 2a 2a 20 66 69 6e 61 6c 69 7a 65 64 20 6f 72 20  ** finalized or 
60c0: 72 65 73 65 74 20 74 68 65 20 70 61 72 73 65 72  reset the parser
60d0: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69   error message i
60e0: 73 20 61 76 61 69 6c 61 62 6c 65 20 76 69 61 0a  s available via.
60f0: 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33        ** sqlite3
6100: 5f 65 72 72 6d 73 67 28 29 20 61 6e 64 20 73 71  _errmsg() and sq
6110: 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 29 2e  lite3_errcode().
6120: 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20  .      */.      
6130: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 72 72  const char *zErr
6140: 20 3d 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a   = (const char *
6150: 29 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74  )sqlite3_value_t
6160: 65 78 74 28 64 62 2d 3e 70 45 72 72 29 3b 20 0a  ext(db->pErr); .
6170: 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46        sqlite3DbF
6180: 72 65 65 28 64 62 2c 20 76 2d 3e 7a 45 72 72 4d  ree(db, v->zErrM
6190: 73 67 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21  sg);.      if( !
61a0: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  db->mallocFailed
61b0: 20 29 7b 0a 20 20 20 20 20 20 20 20 76 2d 3e 7a   ){.        v->z
61c0: 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33  ErrMsg = sqlite3
61d0: 44 62 53 74 72 44 75 70 28 64 62 2c 20 7a 45 72  DbStrDup(db, zEr
61e0: 72 29 3b 0a 20 20 20 20 20 20 20 20 76 2d 3e 72  r);.        v->r
61f0: 63 20 3d 20 72 63 20 3d 20 73 71 6c 69 74 65 33  c = rc = sqlite3
6200: 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b  ApiExit(db, rc);
6210: 0a 20 20 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a  .      } else {.
6220: 20 20 20 20 20 20 20 20 76 2d 3e 7a 45 72 72 4d          v->zErrM
6230: 73 67 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  sg = 0;.        
6240: 76 2d 3e 72 63 20 3d 20 72 63 20 3d 20 53 51 4c  v->rc = rc = SQL
6250: 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a  ITE_NOMEM_BKPT;.
6260: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72        }.      br
6270: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73  eak;.    }.    s
6280: 71 6c 69 74 65 33 5f 72 65 73 65 74 28 70 53 74  qlite3_reset(pSt
6290: 6d 74 29 3b 0a 20 20 20 20 69 66 28 20 73 61 76  mt);.    if( sav
62a0: 65 64 50 63 3e 3d 30 20 29 20 76 2d 3e 64 6f 69  edPc>=0 ) v->doi
62b0: 6e 67 52 65 72 75 6e 20 3d 20 31 3b 0a 20 20 20  ngRerun = 1;.   
62c0: 20 61 73 73 65 72 74 28 20 76 2d 3e 65 78 70 69   assert( v->expi
62d0: 72 65 64 3d 3d 30 20 29 3b 0a 20 20 7d 0a 20 20  red==0 );.  }.  
62e0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
62f0: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  ave(db->mutex);.
6300: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
6310: 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61 63 74 20 74  ./*.** Extract t
6320: 68 65 20 75 73 65 72 20 64 61 74 61 20 66 72 6f  he user data fro
6330: 6d 20 61 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74  m a sqlite3_cont
6340: 65 78 74 20 73 74 72 75 63 74 75 72 65 20 61 6e  ext structure an
6350: 64 20 72 65 74 75 72 6e 20 61 0a 2a 2a 20 70 6f  d return a.** po
6360: 69 6e 74 65 72 20 74 6f 20 69 74 2e 0a 2a 2f 0a  inter to it..*/.
6370: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 75 73  void *sqlite3_us
6380: 65 72 5f 64 61 74 61 28 73 71 6c 69 74 65 33 5f  er_data(sqlite3_
6390: 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a 20 20 61  context *p){.  a
63a0: 73 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e 70  ssert( p && p->p
63b0: 46 75 6e 63 20 29 3b 0a 20 20 72 65 74 75 72 6e  Func );.  return
63c0: 20 70 2d 3e 70 46 75 6e 63 2d 3e 70 55 73 65 72   p->pFunc->pUser
63d0: 44 61 74 61 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45  Data;.}../*.** E
63e0: 78 74 72 61 63 74 20 74 68 65 20 75 73 65 72 20  xtract the user 
63f0: 64 61 74 61 20 66 72 6f 6d 20 61 20 73 71 6c 69  data from a sqli
6400: 74 65 33 5f 63 6f 6e 74 65 78 74 20 73 74 72 75  te3_context stru
6410: 63 74 75 72 65 20 61 6e 64 20 72 65 74 75 72 6e  cture and return
6420: 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f   a.** pointer to
6430: 20 69 74 2e 0a 2a 2a 0a 2a 2a 20 49 4d 50 4c 45   it..**.** IMPLE
6440: 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d  MENTATION-OF: R-
6450: 34 36 37 39 38 2d 35 30 33 30 31 20 54 68 65 20  46798-50301 The 
6460: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 5f  sqlite3_context_
6470: 64 62 5f 68 61 6e 64 6c 65 28 29 20 69 6e 74 65  db_handle() inte
6480: 72 66 61 63 65 0a 2a 2a 20 72 65 74 75 72 6e 73  rface.** returns
6490: 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 70   a copy of the p
64a0: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 64 61  ointer to the da
64b0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f  tabase connectio
64c0: 6e 20 28 74 68 65 20 31 73 74 0a 2a 2a 20 70 61  n (the 1st.** pa
64d0: 72 61 6d 65 74 65 72 29 20 6f 66 20 74 68 65 20  rameter) of the 
64e0: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66  sqlite3_create_f
64f0: 75 6e 63 74 69 6f 6e 28 29 20 61 6e 64 0a 2a 2a  unction() and.**
6500: 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f   sqlite3_create_
6510: 66 75 6e 63 74 69 6f 6e 31 36 28 29 20 72 6f 75  function16() rou
6520: 74 69 6e 65 73 20 74 68 61 74 20 6f 72 69 67 69  tines that origi
6530: 6e 61 6c 6c 79 20 72 65 67 69 73 74 65 72 65 64  nally registered
6540: 20 74 68 65 0a 2a 2a 20 61 70 70 6c 69 63 61 74   the.** applicat
6550: 69 6f 6e 20 64 65 66 69 6e 65 64 20 66 75 6e 63  ion defined func
6560: 74 69 6f 6e 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33  tion..*/.sqlite3
6570: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78   *sqlite3_contex
6580: 74 5f 64 62 5f 68 61 6e 64 6c 65 28 73 71 6c 69  t_db_handle(sqli
6590: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b  te3_context *p){
65a0: 0a 20 20 61 73 73 65 72 74 28 20 70 20 26 26 20  .  assert( p && 
65b0: 70 2d 3e 70 4f 75 74 20 29 3b 0a 20 20 72 65 74  p->pOut );.  ret
65c0: 75 72 6e 20 70 2d 3e 70 4f 75 74 2d 3e 64 62 3b  urn p->pOut->db;
65d0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 69  .}../*.** If thi
65e0: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 69 6e 76  s routine is inv
65f0: 6f 6b 65 64 20 66 72 6f 6d 20 77 69 74 68 69 6e  oked from within
6600: 20 61 6e 20 78 43 6f 6c 75 6d 6e 20 6d 65 74 68   an xColumn meth
6610: 6f 64 20 6f 66 20 61 20 76 69 72 74 75 61 6c 0a  od of a virtual.
6620: 2a 2a 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 69  ** table, then i
6630: 74 20 72 65 74 75 72 6e 73 20 74 72 75 65 20 69  t returns true i
6640: 66 20 61 6e 64 20 6f 6e 6c 79 20 69 66 20 74 68  f and only if th
6650: 65 20 74 68 65 20 63 61 6c 6c 20 69 73 20 64 75  e the call is du
6660: 72 69 6e 67 20 61 6e 0a 2a 2a 20 55 50 44 41 54  ring an.** UPDAT
6670: 45 20 6f 70 65 72 61 74 69 6f 6e 20 61 6e 64 20  E operation and 
6680: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65  the value of the
6690: 20 63 6f 6c 75 6d 6e 20 77 69 6c 6c 20 6e 6f 74   column will not
66a0: 20 62 65 20 6d 6f 64 69 66 69 65 64 0a 2a 2a 20   be modified.** 
66b0: 62 79 20 74 68 65 20 55 50 44 41 54 45 2e 0a 2a  by the UPDATE..*
66c0: 2a 0a 2a 2a 20 49 66 20 74 68 69 73 20 72 6f 75  *.** If this rou
66d0: 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 66  tine is called f
66e0: 72 6f 6d 20 61 6e 79 20 63 6f 6e 74 65 78 74 20  rom any context 
66f0: 6f 74 68 65 72 20 74 68 61 6e 20 77 69 74 68 69  other than withi
6700: 6e 20 74 68 65 0a 2a 2a 20 78 43 6f 6c 75 6d 6e  n the.** xColumn
6710: 20 6d 65 74 68 6f 64 20 6f 66 20 61 20 76 69 72   method of a vir
6720: 74 75 61 6c 20 74 61 62 6c 65 2c 20 74 68 65 6e  tual table, then
6730: 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75   the return valu
6740: 65 20 69 73 20 6d 65 61 6e 69 6e 67 6c 65 73 73  e is meaningless
6750: 0a 2a 2a 20 61 6e 64 20 61 72 62 69 74 72 61 72  .** and arbitrar
6760: 79 2e 0a 2a 2a 0a 2a 2a 20 56 69 72 74 75 61 6c  y..**.** Virtual
6770: 20 74 61 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74   table implement
6780: 73 20 6d 69 67 68 74 20 75 73 65 20 74 68 69 73  s might use this
6790: 20 72 6f 75 74 69 6e 65 20 74 6f 20 6f 70 74 69   routine to opti
67a0: 6d 69 7a 65 20 74 68 65 69 72 0a 2a 2a 20 70 65  mize their.** pe
67b0: 72 66 6f 72 6d 61 6e 63 65 20 62 79 20 73 75 62  rformance by sub
67c0: 73 74 69 74 75 74 69 6e 67 20 61 20 4e 55 4c 4c  stituting a NULL
67d0: 20 72 65 73 75 6c 74 2c 20 6f 72 20 73 6f 6d 65   result, or some
67e0: 20 6f 74 68 65 72 20 6c 69 67 68 74 2d 77 65 69   other light-wei
67f0: 67 68 74 0a 2a 2a 20 76 61 6c 75 65 2c 20 61 73  ght.** value, as
6800: 20 61 20 73 69 67 6e 61 6c 20 74 6f 20 74 68 65   a signal to the
6810: 20 78 55 70 64 61 74 65 20 72 6f 75 74 69 6e 65   xUpdate routine
6820: 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75 6d 6e   that the column
6830: 20 69 73 20 75 6e 63 68 61 6e 67 65 64 2e 0a 2a   is unchanged..*
6840: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 76 74  /.int sqlite3_vt
6850: 61 62 5f 6e 6f 63 68 61 6e 67 65 28 73 71 6c 69  ab_nochange(sqli
6860: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b  te3_context *p){
6870: 0a 20 20 61 73 73 65 72 74 28 20 70 20 29 3b 0a  .  assert( p );.
6880: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
6890: 5f 76 61 6c 75 65 5f 6e 6f 63 68 61 6e 67 65 28  _value_nochange(
68a0: 70 2d 3e 70 4f 75 74 29 3b 0a 7d 0a 0a 2f 2a 0a  p->pOut);.}../*.
68b0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 63 75  ** Return the cu
68c0: 72 72 65 6e 74 20 74 69 6d 65 20 66 6f 72 20 61  rrent time for a
68d0: 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 49 66 20   statement.  If 
68e0: 74 68 65 20 63 75 72 72 65 6e 74 20 74 69 6d 65  the current time
68f0: 0a 2a 2a 20 69 73 20 72 65 71 75 65 73 74 65 64  .** is requested
6900: 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 63 65 20   more than once 
6910: 77 69 74 68 69 6e 20 74 68 65 20 73 61 6d 65 20  within the same 
6920: 72 75 6e 20 6f 66 20 61 20 73 69 6e 67 6c 65 20  run of a single 
6930: 70 72 65 70 61 72 65 64 0a 2a 2a 20 73 74 61 74  prepared.** stat
6940: 65 6d 65 6e 74 2c 20 74 68 65 20 65 78 61 63 74  ement, the exact
6950: 20 73 61 6d 65 20 74 69 6d 65 20 69 73 20 72 65   same time is re
6960: 74 75 72 6e 65 64 20 66 6f 72 20 65 61 63 68 20  turned for each 
6970: 69 6e 76 6f 63 61 74 69 6f 6e 20 72 65 67 61 72  invocation regar
6980: 64 6c 65 73 73 0a 2a 2a 20 6f 66 20 74 68 65 20  dless.** of the 
6990: 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 74  amount of time t
69a0: 68 61 74 20 65 6c 61 70 73 65 73 20 62 65 74 77  hat elapses betw
69b0: 65 65 6e 20 69 6e 76 6f 63 61 74 69 6f 6e 73 2e  een invocations.
69c0: 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73    In other words
69d0: 2c 0a 2a 2a 20 74 68 65 20 74 69 6d 65 20 72 65  ,.** the time re
69e0: 74 75 72 6e 65 64 20 69 73 20 61 6c 77 61 79 73  turned is always
69f0: 20 74 68 65 20 74 69 6d 65 20 6f 66 20 74 68 65   the time of the
6a00: 20 66 69 72 73 74 20 63 61 6c 6c 2e 0a 2a 2f 0a   first call..*/.
6a10: 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71  sqlite3_int64 sq
6a20: 6c 69 74 65 33 53 74 6d 74 43 75 72 72 65 6e 74  lite3StmtCurrent
6a30: 54 69 6d 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e  Time(sqlite3_con
6a40: 74 65 78 74 20 2a 70 29 7b 0a 20 20 69 6e 74 20  text *p){.  int 
6a50: 72 63 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  rc;.#ifndef SQLI
6a60: 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 34 0a  TE_ENABLE_STAT4.
6a70: 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20    sqlite3_int64 
6a80: 2a 70 69 54 69 6d 65 20 3d 20 26 70 2d 3e 70 56  *piTime = &p->pV
6a90: 64 62 65 2d 3e 69 43 75 72 72 65 6e 74 54 69 6d  dbe->iCurrentTim
6aa0: 65 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  e;.  assert( p->
6ab0: 70 56 64 62 65 21 3d 30 20 29 3b 0a 23 65 6c 73  pVdbe!=0 );.#els
6ac0: 65 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36  e.  sqlite3_int6
6ad0: 34 20 69 54 69 6d 65 20 3d 20 30 3b 0a 20 20 73  4 iTime = 0;.  s
6ae0: 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 2a 70 69  qlite3_int64 *pi
6af0: 54 69 6d 65 20 3d 20 70 2d 3e 70 56 64 62 65 21  Time = p->pVdbe!
6b00: 3d 30 20 3f 20 26 70 2d 3e 70 56 64 62 65 2d 3e  =0 ? &p->pVdbe->
6b10: 69 43 75 72 72 65 6e 74 54 69 6d 65 20 3a 20 26  iCurrentTime : &
6b20: 69 54 69 6d 65 3b 0a 23 65 6e 64 69 66 0a 20 20  iTime;.#endif.  
6b30: 69 66 28 20 2a 70 69 54 69 6d 65 3d 3d 30 20 29  if( *piTime==0 )
6b40: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  {.    rc = sqlit
6b50: 65 33 4f 73 43 75 72 72 65 6e 74 54 69 6d 65 49  e3OsCurrentTimeI
6b60: 6e 74 36 34 28 70 2d 3e 70 4f 75 74 2d 3e 64 62  nt64(p->pOut->db
6b70: 2d 3e 70 56 66 73 2c 20 70 69 54 69 6d 65 29 3b  ->pVfs, piTime);
6b80: 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 2a 70  .    if( rc ) *p
6b90: 69 54 69 6d 65 20 3d 20 30 3b 0a 20 20 7d 0a 20  iTime = 0;.  }. 
6ba0: 20 72 65 74 75 72 6e 20 2a 70 69 54 69 6d 65 3b   return *piTime;
6bb0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65  .}../*.** Create
6bc0: 20 61 20 6e 65 77 20 61 67 67 72 65 67 61 74 65   a new aggregate
6bd0: 20 63 6f 6e 74 65 78 74 20 66 6f 72 20 70 20 61   context for p a
6be0: 6e 64 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e  nd return a poin
6bf0: 74 65 72 20 74 6f 0a 2a 2a 20 69 74 73 20 70 4d  ter to.** its pM
6c00: 65 6d 2d 3e 7a 20 65 6c 65 6d 65 6e 74 2e 0a 2a  em->z element..*
6c10: 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f  /.static SQLITE_
6c20: 4e 4f 49 4e 4c 49 4e 45 20 76 6f 69 64 20 2a 63  NOINLINE void *c
6c30: 72 65 61 74 65 41 67 67 43 6f 6e 74 65 78 74 28  reateAggContext(
6c40: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20  sqlite3_context 
6c50: 2a 70 2c 20 69 6e 74 20 6e 42 79 74 65 29 7b 0a  *p, int nByte){.
6c60: 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 3d 20 70 2d    Mem *pMem = p-
6c70: 3e 70 4d 65 6d 3b 0a 20 20 61 73 73 65 72 74 28  >pMem;.  assert(
6c80: 20 28 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 20   (pMem->flags & 
6c90: 4d 45 4d 5f 41 67 67 29 3d 3d 30 20 29 3b 0a 20  MEM_Agg)==0 );. 
6ca0: 20 69 66 28 20 6e 42 79 74 65 3c 3d 30 20 29 7b   if( nByte<=0 ){
6cb0: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
6cc0: 4d 65 6d 53 65 74 4e 75 6c 6c 28 70 4d 65 6d 29  MemSetNull(pMem)
6cd0: 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20  ;.    pMem->z = 
6ce0: 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  0;.  }else{.    
6cf0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 43 6c  sqlite3VdbeMemCl
6d00: 65 61 72 41 6e 64 52 65 73 69 7a 65 28 70 4d 65  earAndResize(pMe
6d10: 6d 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 70  m, nByte);.    p
6d20: 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d  Mem->flags = MEM
6d30: 5f 41 67 67 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e  _Agg;.    pMem->
6d40: 75 2e 70 44 65 66 20 3d 20 70 2d 3e 70 46 75 6e  u.pDef = p->pFun
6d50: 63 3b 0a 20 20 20 20 69 66 28 20 70 4d 65 6d 2d  c;.    if( pMem-
6d60: 3e 7a 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 73  >z ){.      mems
6d70: 65 74 28 70 4d 65 6d 2d 3e 7a 2c 20 30 2c 20 6e  et(pMem->z, 0, n
6d80: 42 79 74 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  Byte);.    }.  }
6d90: 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 2a  .  return (void*
6da0: 29 70 4d 65 6d 2d 3e 7a 3b 0a 7d 0a 0a 2f 2a 0a  )pMem->z;.}../*.
6db0: 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6f 72 20 72  ** Allocate or r
6dc0: 65 74 75 72 6e 20 74 68 65 20 61 67 67 72 65 67  eturn the aggreg
6dd0: 61 74 65 20 63 6f 6e 74 65 78 74 20 66 6f 72 20  ate context for 
6de0: 61 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 2e  a user function.
6df0: 20 20 41 20 6e 65 77 0a 2a 2a 20 63 6f 6e 74 65    A new.** conte
6e00: 78 74 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20  xt is allocated 
6e10: 6f 6e 20 74 68 65 20 66 69 72 73 74 20 63 61 6c  on the first cal
6e20: 6c 2e 20 20 53 75 62 73 65 71 75 65 6e 74 20 63  l.  Subsequent c
6e30: 61 6c 6c 73 20 72 65 74 75 72 6e 20 74 68 65 0a  alls return the.
6e40: 2a 2a 20 73 61 6d 65 20 63 6f 6e 74 65 78 74 20  ** same context 
6e50: 74 68 61 74 20 77 61 73 20 72 65 74 75 72 6e 65  that was returne
6e60: 64 20 6f 6e 20 70 72 69 6f 72 20 63 61 6c 6c 73  d on prior calls
6e70: 2e 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74  ..*/.void *sqlit
6e80: 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f 6e  e3_aggregate_con
6e90: 74 65 78 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e  text(sqlite3_con
6ea0: 74 65 78 74 20 2a 70 2c 20 69 6e 74 20 6e 42 79  text *p, int nBy
6eb0: 74 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70  te){.  assert( p
6ec0: 20 26 26 20 70 2d 3e 70 46 75 6e 63 20 26 26 20   && p->pFunc && 
6ed0: 70 2d 3e 70 46 75 6e 63 2d 3e 78 46 69 6e 61 6c  p->pFunc->xFinal
6ee0: 69 7a 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ize );.  assert(
6ef0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
6f00: 65 6c 64 28 70 2d 3e 70 4f 75 74 2d 3e 64 62 2d  eld(p->pOut->db-
6f10: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 74 65 73  >mutex) );.  tes
6f20: 74 63 61 73 65 28 20 6e 42 79 74 65 3c 30 20 29  tcase( nByte<0 )
6f30: 3b 0a 20 20 69 66 28 20 28 70 2d 3e 70 4d 65 6d  ;.  if( (p->pMem
6f40: 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 41 67  ->flags & MEM_Ag
6f50: 67 29 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74  g)==0 ){.    ret
6f60: 75 72 6e 20 63 72 65 61 74 65 41 67 67 43 6f 6e  urn createAggCon
6f70: 74 65 78 74 28 70 2c 20 6e 42 79 74 65 29 3b 0a  text(p, nByte);.
6f80: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74    }else{.    ret
6f90: 75 72 6e 20 28 76 6f 69 64 2a 29 70 2d 3e 70 4d  urn (void*)p->pM
6fa0: 65 6d 2d 3e 7a 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  em->z;.  }.}../*
6fb0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 61  .** Return the a
6fc0: 75 78 69 6c 69 61 72 79 20 64 61 74 61 20 70 6f  uxiliary data po
6fd0: 69 6e 74 65 72 2c 20 69 66 20 61 6e 79 2c 20 66  inter, if any, f
6fe0: 6f 72 20 74 68 65 20 69 41 72 67 27 74 68 20 61  or the iArg'th a
6ff0: 72 67 75 6d 65 6e 74 20 74 6f 0a 2a 2a 20 74 68  rgument to.** th
7000: 65 20 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20  e user-function 
7010: 64 65 66 69 6e 65 64 20 62 79 20 70 43 74 78 2e  defined by pCtx.
7020: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 65 66 74 2d  .**.** The left-
7030: 6d 6f 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73  most argument is
7040: 20 30 2e 0a 2a 2a 0a 2a 2a 20 55 6e 64 6f 63 75   0..**.** Undocu
7050: 6d 65 6e 74 65 64 20 62 65 68 61 76 69 6f 72 3a  mented behavior:
7060: 20 20 49 66 20 69 41 72 67 20 69 73 20 6e 65 67    If iArg is neg
7070: 61 74 69 76 65 20 74 68 65 6e 20 61 63 63 65 73  ative then acces
7080: 73 20 61 20 63 61 63 68 65 20 6f 66 0a 2a 2a 20  s a cache of.** 
7090: 61 75 78 69 6c 69 61 72 79 20 64 61 74 61 20 70  auxiliary data p
70a0: 6f 69 6e 74 65 72 73 20 74 68 61 74 20 69 73 20  ointers that is 
70b0: 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 61 6c 6c  available to all
70c0: 20 66 75 6e 63 74 69 6f 6e 73 20 77 69 74 68 69   functions withi
70d0: 6e 20 61 0a 2a 2a 20 73 69 6e 67 6c 65 20 70 72  n a.** single pr
70e0: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74  epared statement
70f0: 2e 20 20 54 68 65 20 69 41 72 67 20 76 61 6c 75  .  The iArg valu
7100: 65 73 20 6d 75 73 74 20 6d 61 74 63 68 2e 0a 2a  es must match..*
7110: 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  /.void *sqlite3_
7120: 67 65 74 5f 61 75 78 64 61 74 61 28 73 71 6c 69  get_auxdata(sqli
7130: 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70 43 74  te3_context *pCt
7140: 78 2c 20 69 6e 74 20 69 41 72 67 29 7b 0a 20 20  x, int iArg){.  
7150: 41 75 78 44 61 74 61 20 2a 70 41 75 78 44 61 74  AuxData *pAuxDat
7160: 61 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71  a;..  assert( sq
7170: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64  lite3_mutex_held
7180: 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64 62 2d  (pCtx->pOut->db-
7190: 3e 6d 75 74 65 78 29 20 29 3b 0a 23 69 66 20 53  >mutex) );.#if S
71a0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41  QLITE_ENABLE_STA
71b0: 54 34 0a 20 20 69 66 28 20 70 43 74 78 2d 3e 70  T4.  if( pCtx->p
71c0: 56 64 62 65 3d 3d 30 20 29 20 72 65 74 75 72 6e  Vdbe==0 ) return
71d0: 20 30 3b 0a 23 65 6c 73 65 0a 20 20 61 73 73 65   0;.#else.  asse
71e0: 72 74 28 20 70 43 74 78 2d 3e 70 56 64 62 65 21  rt( pCtx->pVdbe!
71f0: 3d 30 20 29 3b 0a 23 65 6e 64 69 66 0a 20 20 66  =0 );.#endif.  f
7200: 6f 72 28 70 41 75 78 44 61 74 61 3d 70 43 74 78  or(pAuxData=pCtx
7210: 2d 3e 70 56 64 62 65 2d 3e 70 41 75 78 44 61 74  ->pVdbe->pAuxDat
7220: 61 3b 20 70 41 75 78 44 61 74 61 3b 20 70 41 75  a; pAuxData; pAu
7230: 78 44 61 74 61 3d 70 41 75 78 44 61 74 61 2d 3e  xData=pAuxData->
7240: 70 4e 65 78 74 41 75 78 29 7b 0a 20 20 20 20 69  pNextAux){.    i
7250: 66 28 20 20 70 41 75 78 44 61 74 61 2d 3e 69 41  f(  pAuxData->iA
7260: 75 78 41 72 67 3d 3d 69 41 72 67 20 26 26 20 28  uxArg==iArg && (
7270: 70 41 75 78 44 61 74 61 2d 3e 69 41 75 78 4f 70  pAuxData->iAuxOp
7280: 3d 3d 70 43 74 78 2d 3e 69 4f 70 20 7c 7c 20 69  ==pCtx->iOp || i
7290: 41 72 67 3c 30 29 20 29 7b 0a 20 20 20 20 20 20  Arg<0) ){.      
72a0: 72 65 74 75 72 6e 20 70 41 75 78 44 61 74 61 2d  return pAuxData-
72b0: 3e 70 41 75 78 3b 0a 20 20 20 20 7d 0a 20 20 7d  >pAux;.    }.  }
72c0: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a  .  return 0;.}..
72d0: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 61 75  /*.** Set the au
72e0: 78 69 6c 69 61 72 79 20 64 61 74 61 20 70 6f 69  xiliary data poi
72f0: 6e 74 65 72 20 61 6e 64 20 64 65 6c 65 74 65 20  nter and delete 
7300: 66 75 6e 63 74 69 6f 6e 2c 20 66 6f 72 20 74 68  function, for th
7310: 65 20 69 41 72 67 27 74 68 0a 2a 2a 20 61 72 67  e iArg'th.** arg
7320: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 75 73 65  ument to the use
7330: 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e  r-function defin
7340: 65 64 20 62 79 20 70 43 74 78 2e 20 41 6e 79 20  ed by pCtx. Any 
7350: 70 72 65 76 69 6f 75 73 20 76 61 6c 75 65 20 69  previous value i
7360: 73 0a 2a 2a 20 64 65 6c 65 74 65 64 20 62 79 20  s.** deleted by 
7370: 63 61 6c 6c 69 6e 67 20 74 68 65 20 64 65 6c 65  calling the dele
7380: 74 65 20 66 75 6e 63 74 69 6f 6e 20 73 70 65 63  te function spec
7390: 69 66 69 65 64 20 77 68 65 6e 20 69 74 20 77 61  ified when it wa
73a0: 73 20 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  s set..**.** The
73b0: 20 6c 65 66 74 2d 6d 6f 73 74 20 61 72 67 75 6d   left-most argum
73c0: 65 6e 74 20 69 73 20 30 2e 0a 2a 2a 0a 2a 2a 20  ent is 0..**.** 
73d0: 55 6e 64 6f 63 75 6d 65 6e 74 65 64 20 62 65 68  Undocumented beh
73e0: 61 76 69 6f 72 3a 20 20 49 66 20 69 41 72 67 20  avior:  If iArg 
73f0: 69 73 20 6e 65 67 61 74 69 76 65 20 74 68 65 6e  is negative then
7400: 20 6d 61 6b 65 20 74 68 65 20 64 61 74 61 20 61   make the data a
7410: 76 61 69 6c 61 62 6c 65 0a 2a 2a 20 74 6f 20 61  vailable.** to a
7420: 6c 6c 20 66 75 6e 63 74 69 6f 6e 73 20 77 69 74  ll functions wit
7430: 68 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20  hin the current 
7440: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  prepared stateme
7450: 6e 74 20 75 73 69 6e 67 20 69 41 72 67 20 61 73  nt using iArg as
7460: 20 61 6e 0a 2a 2a 20 61 63 63 65 73 73 20 63 6f   an.** access co
7470: 64 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  de..*/.void sqli
7480: 74 65 33 5f 73 65 74 5f 61 75 78 64 61 74 61 28  te3_set_auxdata(
7490: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65  .  sqlite3_conte
74a0: 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 69 6e 74  xt *pCtx, .  int
74b0: 20 69 41 72 67 2c 20 0a 20 20 76 6f 69 64 20 2a   iArg, .  void *
74c0: 70 41 75 78 2c 20 0a 20 20 76 6f 69 64 20 28 2a  pAux, .  void (*
74d0: 78 44 65 6c 65 74 65 29 28 76 6f 69 64 2a 29 0a  xDelete)(void*).
74e0: 29 7b 0a 20 20 41 75 78 44 61 74 61 20 2a 70 41  ){.  AuxData *pA
74f0: 75 78 44 61 74 61 3b 0a 20 20 56 64 62 65 20 2a  uxData;.  Vdbe *
7500: 70 56 64 62 65 20 3d 20 70 43 74 78 2d 3e 70 56  pVdbe = pCtx->pV
7510: 64 62 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  dbe;..  assert( 
7520: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
7530: 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d 3e 64  ld(pCtx->pOut->d
7540: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 23 69 66  b->mutex) );.#if
7550: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c  def SQLITE_ENABL
7560: 45 5f 53 54 41 54 34 0a 20 20 69 66 28 20 70 56  E_STAT4.  if( pV
7570: 64 62 65 3d 3d 30 20 29 20 67 6f 74 6f 20 66 61  dbe==0 ) goto fa
7580: 69 6c 65 64 3b 0a 23 65 6c 73 65 0a 20 20 61 73  iled;.#else.  as
7590: 73 65 72 74 28 20 70 56 64 62 65 21 3d 30 20 29  sert( pVdbe!=0 )
75a0: 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 66 6f 72 28  ;.#endif..  for(
75b0: 70 41 75 78 44 61 74 61 3d 70 56 64 62 65 2d 3e  pAuxData=pVdbe->
75c0: 70 41 75 78 44 61 74 61 3b 20 70 41 75 78 44 61  pAuxData; pAuxDa
75d0: 74 61 3b 20 70 41 75 78 44 61 74 61 3d 70 41 75  ta; pAuxData=pAu
75e0: 78 44 61 74 61 2d 3e 70 4e 65 78 74 41 75 78 29  xData->pNextAux)
75f0: 7b 0a 20 20 20 20 69 66 28 20 70 41 75 78 44 61  {.    if( pAuxDa
7600: 74 61 2d 3e 69 41 75 78 41 72 67 3d 3d 69 41 72  ta->iAuxArg==iAr
7610: 67 20 26 26 20 28 70 41 75 78 44 61 74 61 2d 3e  g && (pAuxData->
7620: 69 41 75 78 4f 70 3d 3d 70 43 74 78 2d 3e 69 4f  iAuxOp==pCtx->iO
7630: 70 20 7c 7c 20 69 41 72 67 3c 30 29 20 29 7b 0a  p || iArg<0) ){.
7640: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
7650: 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 41 75   }.  }.  if( pAu
7660: 78 44 61 74 61 3d 3d 30 20 29 7b 0a 20 20 20 20  xData==0 ){.    
7670: 70 41 75 78 44 61 74 61 20 3d 20 73 71 6c 69 74  pAuxData = sqlit
7680: 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 70  e3DbMallocZero(p
7690: 56 64 62 65 2d 3e 64 62 2c 20 73 69 7a 65 6f 66  Vdbe->db, sizeof
76a0: 28 41 75 78 44 61 74 61 29 29 3b 0a 20 20 20 20  (AuxData));.    
76b0: 69 66 28 20 21 70 41 75 78 44 61 74 61 20 29 20  if( !pAuxData ) 
76c0: 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a 20 20 20  goto failed;.   
76d0: 20 70 41 75 78 44 61 74 61 2d 3e 69 41 75 78 4f   pAuxData->iAuxO
76e0: 70 20 3d 20 70 43 74 78 2d 3e 69 4f 70 3b 0a 20  p = pCtx->iOp;. 
76f0: 20 20 20 70 41 75 78 44 61 74 61 2d 3e 69 41 75     pAuxData->iAu
7700: 78 41 72 67 20 3d 20 69 41 72 67 3b 0a 20 20 20  xArg = iArg;.   
7710: 20 70 41 75 78 44 61 74 61 2d 3e 70 4e 65 78 74   pAuxData->pNext
7720: 41 75 78 20 3d 20 70 56 64 62 65 2d 3e 70 41 75  Aux = pVdbe->pAu
7730: 78 44 61 74 61 3b 0a 20 20 20 20 70 56 64 62 65  xData;.    pVdbe
7740: 2d 3e 70 41 75 78 44 61 74 61 20 3d 20 70 41 75  ->pAuxData = pAu
7750: 78 44 61 74 61 3b 0a 20 20 20 20 69 66 28 20 70  xData;.    if( p
7760: 43 74 78 2d 3e 69 73 45 72 72 6f 72 3d 3d 30 20  Ctx->isError==0 
7770: 29 20 70 43 74 78 2d 3e 69 73 45 72 72 6f 72 20  ) pCtx->isError 
7780: 3d 20 2d 31 3b 0a 20 20 7d 65 6c 73 65 20 69 66  = -1;.  }else if
7790: 28 20 70 41 75 78 44 61 74 61 2d 3e 78 44 65 6c  ( pAuxData->xDel
77a0: 65 74 65 41 75 78 20 29 7b 0a 20 20 20 20 70 41  eteAux ){.    pA
77b0: 75 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65 41  uxData->xDeleteA
77c0: 75 78 28 70 41 75 78 44 61 74 61 2d 3e 70 41 75  ux(pAuxData->pAu
77d0: 78 29 3b 0a 20 20 7d 0a 0a 20 20 70 41 75 78 44  x);.  }..  pAuxD
77e0: 61 74 61 2d 3e 70 41 75 78 20 3d 20 70 41 75 78  ata->pAux = pAux
77f0: 3b 0a 20 20 70 41 75 78 44 61 74 61 2d 3e 78 44  ;.  pAuxData->xD
7800: 65 6c 65 74 65 41 75 78 20 3d 20 78 44 65 6c 65  eleteAux = xDele
7810: 74 65 3b 0a 20 20 72 65 74 75 72 6e 3b 0a 0a 66  te;.  return;..f
7820: 61 69 6c 65 64 3a 0a 20 20 69 66 28 20 78 44 65  ailed:.  if( xDe
7830: 6c 65 74 65 20 29 7b 0a 20 20 20 20 78 44 65 6c  lete ){.    xDel
7840: 65 74 65 28 70 41 75 78 29 3b 0a 20 20 7d 0a 7d  ete(pAux);.  }.}
7850: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  ..#ifndef SQLITE
7860: 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44  _OMIT_DEPRECATED
7870: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
7880: 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65  e number of time
7890: 73 20 74 68 65 20 53 74 65 70 20 66 75 6e 63 74  s the Step funct
78a0: 69 6f 6e 20 6f 66 20 61 6e 20 61 67 67 72 65 67  ion of an aggreg
78b0: 61 74 65 20 68 61 73 20 62 65 65 6e 20 0a 2a 2a  ate has been .**
78c0: 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54   called..**.** T
78d0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
78e0: 64 65 70 72 65 63 61 74 65 64 2e 20 20 44 6f 20  deprecated.  Do 
78f0: 6e 6f 74 20 75 73 65 20 69 74 20 66 6f 72 20 6e  not use it for n
7900: 65 77 20 63 6f 64 65 2e 20 20 49 74 20 69 73 0a  ew code.  It is.
7910: 2a 2a 20 70 72 6f 76 69 64 65 20 6f 6e 6c 79 20  ** provide only 
7920: 74 6f 20 61 76 6f 69 64 20 62 72 65 61 6b 69 6e  to avoid breakin
7930: 67 20 6c 65 67 61 63 79 20 63 6f 64 65 2e 20 20  g legacy code.  
7940: 4e 65 77 20 61 67 67 72 65 67 61 74 65 20 66 75  New aggregate fu
7950: 6e 63 74 69 6f 6e 0a 2a 2a 20 69 6d 70 6c 65 6d  nction.** implem
7960: 65 6e 74 61 74 69 6f 6e 73 20 73 68 6f 75 6c 64  entations should
7970: 20 6b 65 65 70 20 74 68 65 69 72 20 6f 77 6e 20   keep their own 
7980: 63 6f 75 6e 74 73 20 77 69 74 68 69 6e 20 74 68  counts within th
7990: 65 69 72 20 61 67 67 72 65 67 61 74 65 0a 2a 2a  eir aggregate.**
79a0: 20 63 6f 6e 74 65 78 74 2e 0a 2a 2f 0a 69 6e 74   context..*/.int
79b0: 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61   sqlite3_aggrega
79c0: 74 65 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33  te_count(sqlite3
79d0: 5f 63 6f 6e 74 65 78 74 20 2a 70 29 7b 0a 20 20  _context *p){.  
79e0: 61 73 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e  assert( p && p->
79f0: 70 4d 65 6d 20 26 26 20 70 2d 3e 70 46 75 6e 63  pMem && p->pFunc
7a00: 20 26 26 20 70 2d 3e 70 46 75 6e 63 2d 3e 78 46   && p->pFunc->xF
7a10: 69 6e 61 6c 69 7a 65 20 29 3b 0a 20 20 72 65 74  inalize );.  ret
7a20: 75 72 6e 20 70 2d 3e 70 4d 65 6d 2d 3e 6e 3b 0a  urn p->pMem->n;.
7a30: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  }.#endif../*.** 
7a40: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
7a50: 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20  r of columns in 
7a60: 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 66  the result set f
7a70: 6f 72 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  or the statement
7a80: 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 20 73   pStmt..*/.int s
7a90: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f  qlite3_column_co
7aa0: 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  unt(sqlite3_stmt
7ab0: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65   *pStmt){.  Vdbe
7ac0: 20 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29   *pVm = (Vdbe *)
7ad0: 70 53 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20  pStmt;.  return 
7ae0: 70 56 6d 20 3f 20 70 56 6d 2d 3e 6e 52 65 73 43  pVm ? pVm->nResC
7af0: 6f 6c 75 6d 6e 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a  olumn : 0;.}../*
7b00: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e  .** Return the n
7b10: 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65 73 20  umber of values 
7b20: 61 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d 20 74  available from t
7b30: 68 65 20 63 75 72 72 65 6e 74 20 72 6f 77 20 6f  he current row o
7b40: 66 20 74 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74  f the.** current
7b50: 6c 79 20 65 78 65 63 75 74 69 6e 67 20 73 74 61  ly executing sta
7b60: 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f  tement pStmt..*/
7b70: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 64 61 74  .int sqlite3_dat
7b80: 61 5f 63 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f  a_count(sqlite3_
7b90: 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20  stmt *pStmt){.  
7ba0: 56 64 62 65 20 2a 70 56 6d 20 3d 20 28 56 64 62  Vdbe *pVm = (Vdb
7bb0: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66 28  e *)pStmt;.  if(
7bc0: 20 70 56 6d 3d 3d 30 20 7c 7c 20 70 56 6d 2d 3e   pVm==0 || pVm->
7bd0: 70 52 65 73 75 6c 74 53 65 74 3d 3d 30 20 29 20  pResultSet==0 ) 
7be0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 72 65 74 75  return 0;.  retu
7bf0: 72 6e 20 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75  rn pVm->nResColu
7c00: 6d 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  mn;.}../*.** Ret
7c10: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f  urn a pointer to
7c20: 20 73 74 61 74 69 63 20 6d 65 6d 6f 72 79 20 63   static memory c
7c30: 6f 6e 74 61 69 6e 69 6e 67 20 61 6e 20 53 51 4c  ontaining an SQL
7c40: 20 4e 55 4c 4c 20 76 61 6c 75 65 2e 0a 2a 2f 0a   NULL value..*/.
7c50: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 4d 65 6d  static const Mem
7c60: 20 2a 63 6f 6c 75 6d 6e 4e 75 6c 6c 56 61 6c 75   *columnNullValu
7c70: 65 28 76 6f 69 64 29 7b 0a 20 20 2f 2a 20 45 76  e(void){.  /* Ev
7c80: 65 6e 20 74 68 6f 75 67 68 20 74 68 65 20 4d 65  en though the Me
7c90: 6d 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74  m structure cont
7ca0: 61 69 6e 73 20 61 6e 20 65 6c 65 6d 65 6e 74 0a  ains an element.
7cb0: 20 20 2a 2a 20 6f 66 20 74 79 70 65 20 69 36 34    ** of type i64
7cc0: 2c 20 6f 6e 20 63 65 72 74 61 69 6e 20 61 72 63  , on certain arc
7cd0: 68 69 74 65 63 74 75 72 65 73 20 28 78 38 36 29  hitectures (x86)
7ce0: 20 77 69 74 68 20 63 65 72 74 61 69 6e 20 63 6f   with certain co
7cf0: 6d 70 69 6c 65 72 0a 20 20 2a 2a 20 73 77 69 74  mpiler.  ** swit
7d00: 63 68 65 73 20 28 2d 4f 73 29 2c 20 67 63 63 20  ches (-Os), gcc 
7d10: 6d 61 79 20 61 6c 69 67 6e 20 74 68 69 73 20 4d  may align this M
7d20: 65 6d 20 6f 62 6a 65 63 74 20 6f 6e 20 61 20 34  em object on a 4
7d30: 2d 62 79 74 65 20 62 6f 75 6e 64 61 72 79 0a 20  -byte boundary. 
7d40: 20 2a 2a 20 69 6e 73 74 65 61 64 20 6f 66 20 61   ** instead of a
7d50: 6e 20 38 2d 62 79 74 65 20 6f 6e 65 2e 20 54 68  n 8-byte one. Th
7d60: 69 73 20 61 6c 6c 20 77 6f 72 6b 73 20 66 69 6e  is all works fin
7d70: 65 2c 20 65 78 63 65 70 74 20 74 68 61 74 20 77  e, except that w
7d80: 68 65 6e 0a 20 20 2a 2a 20 72 75 6e 6e 69 6e 67  hen.  ** running
7d90: 20 77 69 74 68 20 53 51 4c 49 54 45 5f 44 45 42   with SQLITE_DEB
7da0: 55 47 20 64 65 66 69 6e 65 64 20 74 68 65 20 53  UG defined the S
7db0: 51 4c 69 74 65 20 63 6f 64 65 20 73 6f 6d 65 74  QLite code somet
7dc0: 69 6d 65 73 20 61 73 73 65 72 74 28 29 73 0a 20  imes assert()s. 
7dd0: 20 2a 2a 20 74 68 61 74 20 61 20 4d 65 6d 20 73   ** that a Mem s
7de0: 74 72 75 63 74 75 72 65 20 69 73 20 6c 6f 63 61  tructure is loca
7df0: 74 65 64 20 6f 6e 20 61 6e 20 38 2d 62 79 74 65  ted on an 8-byte
7e00: 20 62 6f 75 6e 64 61 72 79 2e 20 54 6f 20 70 72   boundary. To pr
7e10: 65 76 65 6e 74 0a 20 20 2a 2a 20 74 68 65 73 65  event.  ** these
7e20: 20 61 73 73 65 72 74 28 29 73 20 66 72 6f 6d 20   assert()s from 
7e30: 66 61 69 6c 69 6e 67 2c 20 77 68 65 6e 20 62 75  failing, when bu
7e40: 69 6c 64 69 6e 67 20 77 69 74 68 20 53 51 4c 49  ilding with SQLI
7e50: 54 45 5f 44 45 42 55 47 20 64 65 66 69 6e 65 64  TE_DEBUG defined
7e60: 0a 20 20 2a 2a 20 75 73 69 6e 67 20 67 63 63 2c  .  ** using gcc,
7e70: 20 77 65 20 66 6f 72 63 65 20 6e 75 6c 6c 4d 65   we force nullMe
7e80: 6d 20 74 6f 20 62 65 20 38 2d 62 79 74 65 20 61  m to be 8-byte a
7e90: 6c 69 67 6e 65 64 20 75 73 69 6e 67 20 74 68 65  ligned using the
7ea0: 20 6d 61 67 69 63 61 6c 0a 20 20 2a 2a 20 5f 5f   magical.  ** __
7eb0: 61 74 74 72 69 62 75 74 65 5f 5f 28 28 61 6c 69  attribute__((ali
7ec0: 67 6e 65 64 28 38 29 29 29 20 6d 61 63 72 6f 2e  gned(8))) macro.
7ed0: 20 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 6f    */.  static co
7ee0: 6e 73 74 20 4d 65 6d 20 6e 75 6c 6c 4d 65 6d 20  nst Mem nullMem 
7ef0: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c  .#if defined(SQL
7f00: 49 54 45 5f 44 45 42 55 47 29 20 26 26 20 64 65  ITE_DEBUG) && de
7f10: 66 69 6e 65 64 28 5f 5f 47 4e 55 43 5f 5f 29 0a  fined(__GNUC__).
7f20: 20 20 20 20 5f 5f 61 74 74 72 69 62 75 74 65 5f      __attribute_
7f30: 5f 28 28 61 6c 69 67 6e 65 64 28 38 29 29 29 20  _((aligned(8))) 
7f40: 0a 23 65 6e 64 69 66 0a 20 20 20 20 3d 20 7b 0a  .#endif.    = {.
7f50: 20 20 20 20 20 20 20 20 2f 2a 20 2e 75 20 20 20          /* .u   
7f60: 20 20 20 20 20 20 20 3d 20 2a 2f 20 7b 30 7d 2c         = */ {0},
7f70: 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 66 6c 61  .        /* .fla
7f80: 67 73 20 20 20 20 20 20 3d 20 2a 2f 20 28 75 31  gs      = */ (u1
7f90: 36 29 4d 45 4d 5f 4e 75 6c 6c 2c 0a 20 20 20 20  6)MEM_Null,.    
7fa0: 20 20 20 20 2f 2a 20 2e 65 6e 63 20 20 20 20 20      /* .enc     
7fb0: 20 20 20 3d 20 2a 2f 20 28 75 38 29 30 2c 0a 20     = */ (u8)0,. 
7fc0: 20 20 20 20 20 20 20 2f 2a 20 2e 65 53 75 62 74         /* .eSubt
7fd0: 79 70 65 20 20 20 3d 20 2a 2f 20 28 75 38 29 30  ype   = */ (u8)0
7fe0: 2c 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 6e 20  ,.        /* .n 
7ff0: 20 20 20 20 20 20 20 20 20 3d 20 2a 2f 20 28 69           = */ (i
8000: 6e 74 29 30 2c 0a 20 20 20 20 20 20 20 20 2f 2a  nt)0,.        /*
8010: 20 2e 7a 20 20 20 20 20 20 20 20 20 20 3d 20 2a   .z          = *
8020: 2f 20 28 63 68 61 72 2a 29 30 2c 0a 20 20 20 20  / (char*)0,.    
8030: 20 20 20 20 2f 2a 20 2e 7a 4d 61 6c 6c 6f 63 20      /* .zMalloc 
8040: 20 20 20 3d 20 2a 2f 20 28 63 68 61 72 2a 29 30     = */ (char*)0
8050: 2c 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 73 7a  ,.        /* .sz
8060: 4d 61 6c 6c 6f 63 20 20 20 3d 20 2a 2f 20 28 69  Malloc   = */ (i
8070: 6e 74 29 30 2c 0a 20 20 20 20 20 20 20 20 2f 2a  nt)0,.        /*
8080: 20 2e 75 54 65 6d 70 20 20 20 20 20 20 3d 20 2a   .uTemp      = *
8090: 2f 20 28 75 33 32 29 30 2c 0a 20 20 20 20 20 20  / (u32)0,.      
80a0: 20 20 2f 2a 20 2e 64 62 20 20 20 20 20 20 20 20    /* .db        
80b0: 20 3d 20 2a 2f 20 28 73 71 6c 69 74 65 33 2a 29   = */ (sqlite3*)
80c0: 30 2c 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 78  0,.        /* .x
80d0: 44 65 6c 20 20 20 20 20 20 20 3d 20 2a 2f 20 28  Del       = */ (
80e0: 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 29 29 30  void(*)(void*))0
80f0: 2c 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ,.#ifdef SQLITE_
8100: 44 45 42 55 47 0a 20 20 20 20 20 20 20 20 2f 2a  DEBUG.        /*
8110: 20 2e 70 53 63 6f 70 79 46 72 6f 6d 20 3d 20 2a   .pScopyFrom = *
8120: 2f 20 28 4d 65 6d 2a 29 30 2c 0a 20 20 20 20 20  / (Mem*)0,.     
8130: 20 20 20 2f 2a 20 2e 6d 53 63 6f 70 79 46 6c 61     /* .mScopyFla
8140: 67 73 3d 20 2a 2f 20 30 2c 0a 23 65 6e 64 69 66  gs= */ 0,.#endif
8150: 0a 20 20 20 20 20 20 7d 3b 0a 20 20 72 65 74 75  .      };.  retu
8160: 72 6e 20 26 6e 75 6c 6c 4d 65 6d 3b 0a 7d 0a 0a  rn &nullMem;.}..
8170: 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73  /*.** Check to s
8180: 65 65 20 69 66 20 63 6f 6c 75 6d 6e 20 69 43 6f  ee if column iCo
8190: 6c 20 6f 66 20 74 68 65 20 67 69 76 65 6e 20 73  l of the given s
81a0: 74 61 74 65 6d 65 6e 74 20 69 73 20 76 61 6c 69  tatement is vali
81b0: 64 2e 20 20 49 66 0a 2a 2a 20 69 74 20 69 73 2c  d.  If.** it is,
81c0: 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65   return a pointe
81d0: 72 20 74 6f 20 74 68 65 20 4d 65 6d 20 66 6f 72  r to the Mem for
81e0: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68   the value of th
81f0: 61 74 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a 20 49 66  at column..** If
8200: 20 69 43 6f 6c 20 69 73 20 6e 6f 74 20 76 61 6c   iCol is not val
8210: 69 64 2c 20 72 65 74 75 72 6e 20 61 20 70 6f 69  id, return a poi
8220: 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d 20 77 68  nter to a Mem wh
8230: 69 63 68 20 68 61 73 20 61 20 76 61 6c 75 65 0a  ich has a value.
8240: 2a 2a 20 6f 66 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73  ** of NULL..*/.s
8250: 74 61 74 69 63 20 4d 65 6d 20 2a 63 6f 6c 75 6d  tatic Mem *colum
8260: 6e 4d 65 6d 28 73 71 6c 69 74 65 33 5f 73 74 6d  nMem(sqlite3_stm
8270: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29  t *pStmt, int i)
8280: 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d 3b 0a 20  {.  Vdbe *pVm;. 
8290: 20 4d 65 6d 20 2a 70 4f 75 74 3b 0a 0a 20 20 70   Mem *pOut;..  p
82a0: 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74  Vm = (Vdbe *)pSt
82b0: 6d 74 3b 0a 20 20 69 66 28 20 70 56 6d 3d 3d 30  mt;.  if( pVm==0
82c0: 20 29 20 72 65 74 75 72 6e 20 28 4d 65 6d 2a 29   ) return (Mem*)
82d0: 63 6f 6c 75 6d 6e 4e 75 6c 6c 56 61 6c 75 65 28  columnNullValue(
82e0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 56 6d  );.  assert( pVm
82f0: 2d 3e 64 62 20 29 3b 0a 20 20 73 71 6c 69 74 65  ->db );.  sqlite
8300: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 56  3_mutex_enter(pV
8310: 6d 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  m->db->mutex);. 
8320: 20 69 66 28 20 70 56 6d 2d 3e 70 52 65 73 75 6c   if( pVm->pResul
8330: 74 53 65 74 21 3d 30 20 26 26 20 69 3c 70 56 6d  tSet!=0 && i<pVm
8340: 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 26 26 20  ->nResColumn && 
8350: 69 3e 3d 30 20 29 7b 0a 20 20 20 20 70 4f 75 74  i>=0 ){.    pOut
8360: 20 3d 20 26 70 56 6d 2d 3e 70 52 65 73 75 6c 74   = &pVm->pResult
8370: 53 65 74 5b 69 5d 3b 0a 20 20 7d 65 6c 73 65 7b  Set[i];.  }else{
8380: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f  .    sqlite3Erro
8390: 72 28 70 56 6d 2d 3e 64 62 2c 20 53 51 4c 49 54  r(pVm->db, SQLIT
83a0: 45 5f 52 41 4e 47 45 29 3b 0a 20 20 20 20 70 4f  E_RANGE);.    pO
83b0: 75 74 20 3d 20 28 4d 65 6d 2a 29 63 6f 6c 75 6d  ut = (Mem*)colum
83c0: 6e 4e 75 6c 6c 56 61 6c 75 65 28 29 3b 0a 20 20  nNullValue();.  
83d0: 7d 0a 20 20 72 65 74 75 72 6e 20 70 4f 75 74 3b  }.  return pOut;
83e0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
83f0: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
8400: 64 20 61 66 74 65 72 20 69 6e 76 6f 6b 69 6e 67  d after invoking
8410: 20 61 6e 20 73 71 6c 69 74 65 33 5f 76 61 6c 75   an sqlite3_valu
8420: 65 5f 58 58 58 20 66 75 6e 63 74 69 6f 6e 20 6f  e_XXX function o
8430: 6e 20 61 20 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 76  n a .** column v
8440: 61 6c 75 65 20 28 69 2e 65 2e 20 61 20 76 61 6c  alue (i.e. a val
8450: 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 65  ue returned by e
8460: 76 61 6c 75 61 74 69 6e 67 20 61 6e 20 53 51 4c  valuating an SQL
8470: 20 65 78 70 72 65 73 73 69 6f 6e 20 69 6e 20 74   expression in t
8480: 68 65 0a 2a 2a 20 73 65 6c 65 63 74 20 6c 69 73  he.** select lis
8490: 74 20 6f 66 20 61 20 53 45 4c 45 43 54 20 73 74  t of a SELECT st
84a0: 61 74 65 6d 65 6e 74 29 20 74 68 61 74 20 6d 61  atement) that ma
84b0: 79 20 63 61 75 73 65 20 61 20 6d 61 6c 6c 6f 63  y cause a malloc
84c0: 28 29 20 66 61 69 6c 75 72 65 2e 20 49 66 20 0a  () failure. If .
84d0: 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 68 61 73 20  ** malloc() has 
84e0: 66 61 69 6c 65 64 2c 20 74 68 65 20 74 68 72 65  failed, the thre
84f0: 61 64 73 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  ads mallocFailed
8500: 20 66 6c 61 67 20 69 73 20 63 6c 65 61 72 65 64   flag is cleared
8510: 20 61 6e 64 20 74 68 65 20 72 65 73 75 6c 74 0a   and the result.
8520: 2a 2a 20 63 6f 64 65 20 6f 66 20 73 74 61 74 65  ** code of state
8530: 6d 65 6e 74 20 70 53 74 6d 74 20 73 65 74 20 74  ment pStmt set t
8540: 6f 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 0a  o SQLITE_NOMEM..
8550: 2a 2a 0a 2a 2a 20 53 70 65 63 69 66 69 63 61 6c  **.** Specifical
8560: 6c 79 2c 20 74 68 69 73 20 69 73 20 63 61 6c 6c  ly, this is call
8570: 65 64 20 66 72 6f 6d 20 77 69 74 68 69 6e 3a 0a  ed from within:.
8580: 2a 2a 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65  **.**     sqlite
8590: 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 28 29 0a 2a  3_column_int().*
85a0: 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f  *     sqlite3_co
85b0: 6c 75 6d 6e 5f 69 6e 74 36 34 28 29 0a 2a 2a 20  lumn_int64().** 
85c0: 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75      sqlite3_colu
85d0: 6d 6e 5f 74 65 78 74 28 29 0a 2a 2a 20 20 20 20  mn_text().**    
85e0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
85f0: 74 65 78 74 31 36 28 29 0a 2a 2a 20 20 20 20 20  text16().**     
8600: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 72  sqlite3_column_r
8610: 65 61 6c 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c  eal().**     sql
8620: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65  ite3_column_byte
8630: 73 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74  s().**     sqlit
8640: 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 31  e3_column_bytes1
8650: 36 28 29 0a 2a 2a 20 20 20 20 20 73 71 69 69 74  6().**     sqiit
8660: 65 33 5f 63 6f 6c 75 6d 6e 5f 62 6c 6f 62 28 29  e3_column_blob()
8670: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
8680: 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c  columnMallocFail
8690: 75 72 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ure(sqlite3_stmt
86a0: 20 2a 70 53 74 6d 74 29 0a 7b 0a 20 20 2f 2a 20   *pStmt).{.  /* 
86b0: 49 66 20 6d 61 6c 6c 6f 63 28 29 20 66 61 69 6c  If malloc() fail
86c0: 65 64 20 64 75 72 69 6e 67 20 61 6e 20 65 6e 63  ed during an enc
86d0: 6f 64 69 6e 67 20 63 6f 6e 76 65 72 73 69 6f 6e  oding conversion
86e0: 20 77 69 74 68 69 6e 20 61 6e 0a 20 20 2a 2a 20   within an.  ** 
86f0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 58  sqlite3_column_X
8700: 58 58 20 41 50 49 2c 20 74 68 65 6e 20 73 65 74  XX API, then set
8710: 20 74 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65   the return code
8720: 20 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e   of the statemen
8730: 74 20 74 6f 0a 20 20 2a 2a 20 53 51 4c 49 54 45  t to.  ** SQLITE
8740: 5f 4e 4f 4d 45 4d 2e 20 54 68 65 20 6e 65 78 74  _NOMEM. The next
8750: 20 63 61 6c 6c 20 74 6f 20 5f 73 74 65 70 28 29   call to _step()
8760: 20 28 69 66 20 61 6e 79 29 20 77 69 6c 6c 20 72   (if any) will r
8770: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52  eturn SQLITE_ERR
8780: 4f 52 0a 20 20 2a 2a 20 61 6e 64 20 5f 66 69 6e  OR.  ** and _fin
8790: 61 6c 69 7a 65 28 29 20 77 69 6c 6c 20 72 65 74  alize() will ret
87a0: 75 72 6e 20 4e 4f 4d 45 4d 2e 0a 20 20 2a 2f 0a  urn NOMEM..  */.
87b0: 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62    Vdbe *p = (Vdb
87c0: 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66 28  e *)pStmt;.  if(
87d0: 20 70 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74   p ){.    assert
87e0: 28 20 70 2d 3e 64 62 21 3d 30 20 29 3b 0a 20 20  ( p->db!=0 );.  
87f0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
8800: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e  3_mutex_held(p->
8810: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20  db->mutex) );.  
8820: 20 20 70 2d 3e 72 63 20 3d 20 73 71 6c 69 74 65    p->rc = sqlite
8830: 33 41 70 69 45 78 69 74 28 70 2d 3e 64 62 2c 20  3ApiExit(p->db, 
8840: 70 2d 3e 72 63 29 3b 0a 20 20 20 20 73 71 6c 69  p->rc);.    sqli
8850: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
8860: 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  p->db->mutex);. 
8870: 20 7d 0a 7d 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a   }.}../*********
8880: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
8890: 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  *** sqlite3_colu
88a0: 6d 6e 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  mn_  ***********
88b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
88c0: 2a 2a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c  ****.** The foll
88d0: 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 61  owing routines a
88e0: 72 65 20 75 73 65 64 20 74 6f 20 61 63 63 65 73  re used to acces
88f0: 73 20 65 6c 65 6d 65 6e 74 73 20 6f 66 20 74 68  s elements of th
8900: 65 20 63 75 72 72 65 6e 74 20 72 6f 77 0a 2a 2a  e current row.**
8910: 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 20 73   in the result s
8920: 65 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 76 6f 69  et..*/.const voi
8930: 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  d *sqlite3_colum
8940: 6e 5f 62 6c 6f 62 28 73 71 6c 69 74 65 33 5f 73  n_blob(sqlite3_s
8950: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
8960: 69 29 7b 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64  i){.  const void
8970: 20 2a 76 61 6c 3b 0a 20 20 76 61 6c 20 3d 20 73   *val;.  val = s
8980: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 6c 6f  qlite3_value_blo
8990: 62 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74  b( columnMem(pSt
89a0: 6d 74 2c 69 29 20 29 3b 0a 20 20 2f 2a 20 45 76  mt,i) );.  /* Ev
89b0: 65 6e 20 74 68 6f 75 67 68 20 74 68 65 72 65 20  en though there 
89c0: 69 73 20 6e 6f 20 65 6e 63 6f 64 69 6e 67 20 63  is no encoding c
89d0: 6f 6e 76 65 72 73 69 6f 6e 2c 20 76 61 6c 75 65  onversion, value
89e0: 5f 62 6c 6f 62 28 29 20 6d 69 67 68 74 0a 20 20  _blob() might.  
89f0: 2a 2a 20 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20  ** need to call 
8a00: 6d 61 6c 6c 6f 63 28 29 20 74 6f 20 65 78 70 61  malloc() to expa
8a10: 6e 64 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66  nd the result of
8a20: 20 61 20 7a 65 72 6f 62 6c 6f 62 28 29 20 0a 20   a zeroblob() . 
8a30: 20 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e 2e 20   ** expression. 
8a40: 0a 20 20 2a 2f 0a 20 20 63 6f 6c 75 6d 6e 4d 61  .  */.  columnMa
8a50: 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d  llocFailure(pStm
8a60: 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 6c  t);.  return val
8a70: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  ;.}.int sqlite3_
8a80: 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 28 73 71 6c  column_bytes(sql
8a90: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
8aa0: 2c 20 69 6e 74 20 69 29 7b 0a 20 20 69 6e 74 20  , int i){.  int 
8ab0: 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76 61  val = sqlite3_va
8ac0: 6c 75 65 5f 62 79 74 65 73 28 20 63 6f 6c 75 6d  lue_bytes( colum
8ad0: 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b  nMem(pStmt,i) );
8ae0: 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46  .  columnMallocF
8af0: 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20  ailure(pStmt);. 
8b00: 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69   return val;.}.i
8b10: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  nt sqlite3_colum
8b20: 6e 5f 62 79 74 65 73 31 36 28 73 71 6c 69 74 65  n_bytes16(sqlite
8b30: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
8b40: 6e 74 20 69 29 7b 0a 20 20 69 6e 74 20 76 61 6c  nt i){.  int val
8b50: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
8b60: 5f 62 79 74 65 73 31 36 28 20 63 6f 6c 75 6d 6e  _bytes16( column
8b70: 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a  Mem(pStmt,i) );.
8b80: 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61    columnMallocFa
8b90: 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20  ilure(pStmt);.  
8ba0: 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 64 6f  return val;.}.do
8bb0: 75 62 6c 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c  uble sqlite3_col
8bc0: 75 6d 6e 5f 64 6f 75 62 6c 65 28 73 71 6c 69 74  umn_double(sqlit
8bd0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
8be0: 69 6e 74 20 69 29 7b 0a 20 20 64 6f 75 62 6c 65  int i){.  double
8bf0: 20 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76   val = sqlite3_v
8c00: 61 6c 75 65 5f 64 6f 75 62 6c 65 28 20 63 6f 6c  alue_double( col
8c10: 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20  umnMem(pStmt,i) 
8c20: 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f  );.  columnMallo
8c30: 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b  cFailure(pStmt);
8c40: 0a 20 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d  .  return val;.}
8c50: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c  .int sqlite3_col
8c60: 75 6d 6e 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f  umn_int(sqlite3_
8c70: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
8c80: 20 69 29 7b 0a 20 20 69 6e 74 20 76 61 6c 20 3d   i){.  int val =
8c90: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69   sqlite3_value_i
8ca0: 6e 74 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53  nt( columnMem(pS
8cb0: 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75  tmt,i) );.  colu
8cc0: 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28  mnMallocFailure(
8cd0: 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e  pStmt);.  return
8ce0: 20 76 61 6c 3b 0a 7d 0a 73 71 6c 69 74 65 5f 69   val;.}.sqlite_i
8cf0: 6e 74 36 34 20 73 71 6c 69 74 65 33 5f 63 6f 6c  nt64 sqlite3_col
8d00: 75 6d 6e 5f 69 6e 74 36 34 28 73 71 6c 69 74 65  umn_int64(sqlite
8d10: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
8d20: 6e 74 20 69 29 7b 0a 20 20 73 71 6c 69 74 65 5f  nt i){.  sqlite_
8d30: 69 6e 74 36 34 20 76 61 6c 20 3d 20 73 71 6c 69  int64 val = sqli
8d40: 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 36 34 28  te3_value_int64(
8d50: 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74   columnMem(pStmt
8d60: 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d  ,i) );.  columnM
8d70: 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74  allocFailure(pSt
8d80: 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61  mt);.  return va
8d90: 6c 3b 0a 7d 0a 63 6f 6e 73 74 20 75 6e 73 69 67  l;.}.const unsig
8da0: 6e 65 64 20 63 68 61 72 20 2a 73 71 6c 69 74 65  ned char *sqlite
8db0: 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 73 71  3_column_text(sq
8dc0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
8dd0: 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 63 6f 6e  t, int i){.  con
8de0: 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72  st unsigned char
8df0: 20 2a 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f   *val = sqlite3_
8e00: 76 61 6c 75 65 5f 74 65 78 74 28 20 63 6f 6c 75  value_text( colu
8e10: 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29  mnMem(pStmt,i) )
8e20: 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63  ;.  columnMalloc
8e30: 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a  Failure(pStmt);.
8e40: 20 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a    return val;.}.
8e50: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 73  sqlite3_value *s
8e60: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 76 61  qlite3_column_va
8e70: 6c 75 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  lue(sqlite3_stmt
8e80: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
8e90: 0a 20 20 4d 65 6d 20 2a 70 4f 75 74 20 3d 20 63  .  Mem *pOut = c
8ea0: 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 20  olumnMem(pStmt, 
8eb0: 69 29 3b 0a 20 20 69 66 28 20 70 4f 75 74 2d 3e  i);.  if( pOut->
8ec0: 66 6c 61 67 73 26 4d 45 4d 5f 53 74 61 74 69 63  flags&MEM_Static
8ed0: 20 29 7b 0a 20 20 20 20 70 4f 75 74 2d 3e 66 6c   ){.    pOut->fl
8ee0: 61 67 73 20 26 3d 20 7e 4d 45 4d 5f 53 74 61 74  ags &= ~MEM_Stat
8ef0: 69 63 3b 0a 20 20 20 20 70 4f 75 74 2d 3e 66 6c  ic;.    pOut->fl
8f00: 61 67 73 20 7c 3d 20 4d 45 4d 5f 45 70 68 65 6d  ags |= MEM_Ephem
8f10: 3b 0a 20 20 7d 0a 20 20 63 6f 6c 75 6d 6e 4d 61  ;.  }.  columnMa
8f20: 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d  llocFailure(pStm
8f30: 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 73 71  t);.  return (sq
8f40: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 29 70 4f  lite3_value *)pO
8f50: 75 74 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51  ut;.}.#ifndef SQ
8f60: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a  LITE_OMIT_UTF16.
8f70: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69  const void *sqli
8f80: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31  te3_column_text1
8f90: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  6(sqlite3_stmt *
8fa0: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
8fb0: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 76 61 6c   const void *val
8fc0: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
8fd0: 5f 74 65 78 74 31 36 28 20 63 6f 6c 75 6d 6e 4d  _text16( columnM
8fe0: 65 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20  em(pStmt,i) );. 
8ff0: 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69   columnMallocFai
9000: 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72  lure(pStmt);.  r
9010: 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 23 65 6e  eturn val;.}.#en
9020: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d  dif /* SQLITE_OM
9030: 49 54 5f 55 54 46 31 36 20 2a 2f 0a 69 6e 74 20  IT_UTF16 */.int 
9040: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74  sqlite3_column_t
9050: 79 70 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ype(sqlite3_stmt
9060: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b   *pStmt, int i){
9070: 0a 20 20 69 6e 74 20 69 54 79 70 65 20 3d 20 73  .  int iType = s
9080: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79 70  qlite3_value_typ
9090: 65 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74  e( columnMem(pSt
90a0: 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75 6d  mt,i) );.  colum
90b0: 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 70  nMallocFailure(p
90c0: 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e 20  Stmt);.  return 
90d0: 69 54 79 70 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  iType;.}../*.** 
90e0: 43 6f 6e 76 65 72 74 20 74 68 65 20 4e 2d 74 68  Convert the N-th
90f0: 20 65 6c 65 6d 65 6e 74 20 6f 66 20 70 53 74 6d   element of pStm
9100: 74 2d 3e 70 43 6f 6c 4e 61 6d 65 5b 5d 20 69 6e  t->pColName[] in
9110: 74 6f 20 61 20 73 74 72 69 6e 67 20 75 73 69 6e  to a string usin
9120: 67 0a 2a 2a 20 78 46 75 6e 63 28 29 20 74 68 65  g.** xFunc() the
9130: 6e 20 72 65 74 75 72 6e 20 74 68 61 74 20 73 74  n return that st
9140: 72 69 6e 67 2e 20 20 49 66 20 4e 20 69 73 20 6f  ring.  If N is o
9150: 75 74 20 6f 66 20 72 61 6e 67 65 2c 20 72 65 74  ut of range, ret
9160: 75 72 6e 20 30 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  urn 0..**.** The
9170: 72 65 20 61 72 65 20 75 70 20 74 6f 20 35 20 6e  re are up to 5 n
9180: 61 6d 65 73 20 66 6f 72 20 65 61 63 68 20 63 6f  ames for each co
9190: 6c 75 6d 6e 2e 20 20 75 73 65 54 79 70 65 20 64  lumn.  useType d
91a0: 65 74 65 72 6d 69 6e 65 73 20 77 68 69 63 68 0a  etermines which.
91b0: 2a 2a 20 6e 61 6d 65 20 69 73 20 72 65 74 75 72  ** name is retur
91c0: 6e 65 64 2e 20 20 48 65 72 65 20 61 72 65 20 74  ned.  Here are t
91d0: 68 65 20 6e 61 6d 65 73 3a 0a 2a 2a 0a 2a 2a 20  he names:.**.** 
91e0: 20 20 20 30 20 20 20 20 20 20 54 68 65 20 63 6f     0      The co
91f0: 6c 75 6d 6e 20 6e 61 6d 65 20 61 73 20 69 74 20  lumn name as it 
9200: 73 68 6f 75 6c 64 20 62 65 20 64 69 73 70 6c 61  should be displa
9210: 79 65 64 20 66 6f 72 20 6f 75 74 70 75 74 0a 2a  yed for output.*
9220: 2a 20 20 20 20 31 20 20 20 20 20 20 54 68 65 20  *    1      The 
9230: 64 61 74 61 74 79 70 65 20 6e 61 6d 65 20 66 6f  datatype name fo
9240: 72 20 74 68 65 20 63 6f 6c 75 6d 6e 0a 2a 2a 20  r the column.** 
9250: 20 20 20 32 20 20 20 20 20 20 54 68 65 20 6e 61     2      The na
9260: 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  me of the databa
9270: 73 65 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75  se that the colu
9280: 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a  mn derives from.
9290: 2a 2a 20 20 20 20 33 20 20 20 20 20 20 54 68 65  **    3      The
92a0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62   name of the tab
92b0: 6c 65 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75  le that the colu
92c0: 6d 6e 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a  mn derives from.
92d0: 2a 2a 20 20 20 20 34 20 20 20 20 20 20 54 68 65  **    4      The
92e0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62   name of the tab
92f0: 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20 74  le column that t
9300: 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e  he result column
9310: 20 64 65 72 69 76 65 73 20 66 72 6f 6d 0a 2a 2a   derives from.**
9320: 0a 2a 2a 20 49 66 20 74 68 65 20 72 65 73 75 6c  .** If the resul
9330: 74 20 69 73 20 6e 6f 74 20 61 20 73 69 6d 70 6c  t is not a simpl
9340: 65 20 63 6f 6c 75 6d 6e 20 72 65 66 65 72 65 6e  e column referen
9350: 63 65 20 28 69 66 20 69 74 20 69 73 20 61 6e 20  ce (if it is an 
9360: 65 78 70 72 65 73 73 69 6f 6e 0a 2a 2a 20 6f 72  expression.** or
9370: 20 61 20 63 6f 6e 73 74 61 6e 74 29 20 74 68 65   a constant) the
9380: 6e 20 75 73 65 54 79 70 65 73 20 32 2c 20 33 2c  n useTypes 2, 3,
9390: 20 61 6e 64 20 34 20 72 65 74 75 72 6e 20 4e 55   and 4 return NU
93a0: 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f  LL..*/.static co
93b0: 6e 73 74 20 76 6f 69 64 20 2a 63 6f 6c 75 6d 6e  nst void *column
93c0: 4e 61 6d 65 28 0a 20 20 73 71 6c 69 74 65 33 5f  Name(.  sqlite3_
93d0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 20 20 20  stmt *pStmt,    
93e0: 20 2f 2a 20 54 68 65 20 73 74 61 74 65 6d 65 6e   /* The statemen
93f0: 74 20 2a 2f 0a 20 20 69 6e 74 20 4e 2c 20 20 20  t */.  int N,   
9400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9410: 2f 2a 20 57 68 69 63 68 20 63 6f 6c 75 6d 6e 20  /* Which column 
9420: 74 6f 20 67 65 74 20 74 68 65 20 6e 61 6d 65 20  to get the name 
9430: 66 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 75 73 65  for */.  int use
9440: 55 74 66 31 36 2c 20 20 20 20 20 20 20 20 20 20  Utf16,          
9450: 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 72 65 74    /* True to ret
9460: 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 61 73 20  urn the name as 
9470: 55 54 46 31 36 20 2a 2f 0a 20 20 69 6e 74 20 75  UTF16 */.  int u
9480: 73 65 54 79 70 65 20 20 20 20 20 20 20 20 20 20  seType          
9490: 20 20 20 20 2f 2a 20 57 68 61 74 20 74 79 70 65      /* What type
94a0: 20 6f 66 20 6e 61 6d 65 20 2a 2f 0a 29 7b 0a 20   of name */.){. 
94b0: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 72 65 74   const void *ret
94c0: 3b 0a 20 20 56 64 62 65 20 2a 70 3b 0a 20 20 69  ;.  Vdbe *p;.  i
94d0: 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 74 65 33 20  nt n;.  sqlite3 
94e0: 2a 64 62 3b 0a 23 69 66 64 65 66 20 53 51 4c 49  *db;.#ifdef SQLI
94f0: 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52  TE_ENABLE_API_AR
9500: 4d 4f 52 0a 20 20 69 66 28 20 70 53 74 6d 74 3d  MOR.  if( pStmt=
9510: 3d 30 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29  =0 ){.    (void)
9520: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b  SQLITE_MISUSE_BK
9530: 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30  PT;.    return 0
9540: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 72  ;.  }.#endif.  r
9550: 65 74 20 3d 20 30 3b 0a 20 20 70 20 3d 20 28 56  et = 0;.  p = (V
9560: 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 64  dbe *)pStmt;.  d
9570: 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 61 73 73  b = p->db;.  ass
9580: 65 72 74 28 20 64 62 21 3d 30 20 29 3b 0a 20 20  ert( db!=0 );.  
9590: 6e 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  n = sqlite3_colu
95a0: 6d 6e 5f 63 6f 75 6e 74 28 70 53 74 6d 74 29 3b  mn_count(pStmt);
95b0: 0a 20 20 69 66 28 20 4e 3c 6e 20 26 26 20 4e 3e  .  if( N<n && N>
95c0: 3d 30 20 29 7b 0a 20 20 20 20 4e 20 2b 3d 20 75  =0 ){.    N += u
95d0: 73 65 54 79 70 65 2a 6e 3b 0a 20 20 20 20 73 71  seType*n;.    sq
95e0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
95f0: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  r(db->mutex);.  
9600: 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6d 61    assert( db->ma
9610: 6c 6c 6f 63 46 61 69 6c 65 64 3d 3d 30 20 29 3b  llocFailed==0 );
9620: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
9630: 4f 4d 49 54 5f 55 54 46 31 36 0a 20 20 20 20 69  OMIT_UTF16.    i
9640: 66 28 20 75 73 65 55 74 66 31 36 20 29 7b 0a 20  f( useUtf16 ){. 
9650: 20 20 20 20 20 72 65 74 20 3d 20 73 71 6c 69 74       ret = sqlit
9660: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 28  e3_value_text16(
9670: 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 29  (sqlite3_value*)
9680: 26 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 4e 5d 29  &p->aColName[N])
9690: 3b 0a 20 20 20 20 7d 65 6c 73 65 0a 23 65 6e 64  ;.    }else.#end
96a0: 69 66 0a 20 20 20 20 7b 0a 20 20 20 20 20 20 72  if.    {.      r
96b0: 65 74 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c  et = sqlite3_val
96c0: 75 65 5f 74 65 78 74 28 28 73 71 6c 69 74 65 33  ue_text((sqlite3
96d0: 5f 76 61 6c 75 65 2a 29 26 70 2d 3e 61 43 6f 6c  _value*)&p->aCol
96e0: 4e 61 6d 65 5b 4e 5d 29 3b 0a 20 20 20 20 7d 0a  Name[N]);.    }.
96f0: 20 20 20 20 2f 2a 20 41 20 6d 61 6c 6c 6f 63 20      /* A malloc 
9700: 6d 61 79 20 68 61 76 65 20 66 61 69 6c 65 64 20  may have failed 
9710: 69 6e 73 69 64 65 20 6f 66 20 74 68 65 20 5f 74  inside of the _t
9720: 65 78 74 28 29 20 63 61 6c 6c 2e 20 49 66 20 74  ext() call. If t
9730: 68 69 73 0a 20 20 20 20 2a 2a 20 69 73 20 74 68  his.    ** is th
9740: 65 20 63 61 73 65 2c 20 63 6c 65 61 72 20 74 68  e case, clear th
9750: 65 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 66  e mallocFailed f
9760: 6c 61 67 20 61 6e 64 20 72 65 74 75 72 6e 20 4e  lag and return N
9770: 55 4c 4c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20  ULL..    */.    
9780: 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61  if( db->mallocFa
9790: 69 6c 65 64 20 29 7b 0a 20 20 20 20 20 20 73 71  iled ){.      sq
97a0: 6c 69 74 65 33 4f 6f 6d 43 6c 65 61 72 28 64 62  lite3OomClear(db
97b0: 29 3b 0a 20 20 20 20 20 20 72 65 74 20 3d 20 30  );.      ret = 0
97c0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  ;.    }.    sqli
97d0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
97e0: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a  db->mutex);.  }.
97f0: 20 20 72 65 74 75 72 6e 20 72 65 74 3b 0a 7d 0a    return ret;.}.
9800: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
9810: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 4e 74  e name of the Nt
9820: 68 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20  h column of the 
9830: 72 65 73 75 6c 74 20 73 65 74 20 72 65 74 75 72  result set retur
9840: 6e 65 64 20 62 79 20 53 51 4c 0a 2a 2a 20 73 74  ned by SQL.** st
9850: 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a  atement pStmt..*
9860: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71  /.const char *sq
9870: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d  lite3_column_nam
9880: 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  e(sqlite3_stmt *
9890: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20  pStmt, int N){. 
98a0: 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61   return columnNa
98b0: 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 30 2c 20  me(pStmt, N, 0, 
98c0: 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 29 3b 0a 7d  COLNAME_NAME);.}
98d0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
98e0: 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74  OMIT_UTF16.const
98f0: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63   void *sqlite3_c
9900: 6f 6c 75 6d 6e 5f 6e 61 6d 65 31 36 28 73 71 6c  olumn_name16(sql
9910: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
9920: 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75  , int N){.  retu
9930: 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53  rn columnName(pS
9940: 74 6d 74 2c 20 4e 2c 20 31 2c 20 43 4f 4c 4e 41  tmt, N, 1, COLNA
9950: 4d 45 5f 4e 41 4d 45 29 3b 0a 7d 0a 23 65 6e 64  ME_NAME);.}.#end
9960: 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 73 74 72  if../*.** Constr
9970: 61 69 6e 74 3a 20 20 49 66 20 79 6f 75 20 68 61  aint:  If you ha
9980: 76 65 20 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e  ve ENABLE_COLUMN
9990: 5f 4d 45 54 41 44 41 54 41 20 74 68 65 6e 20 79  _METADATA then y
99a0: 6f 75 20 6d 75 73 74 0a 2a 2a 20 6e 6f 74 20 64  ou must.** not d
99b0: 65 66 69 6e 65 20 4f 4d 49 54 5f 44 45 43 4c 54  efine OMIT_DECLT
99c0: 59 50 45 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69  YPE..*/.#if defi
99d0: 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ned(SQLITE_OMIT_
99e0: 44 45 43 4c 54 59 50 45 29 20 26 26 20 64 65 66  DECLTYPE) && def
99f0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42  ined(SQLITE_ENAB
9a00: 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41  LE_COLUMN_METADA
9a10: 54 41 29 0a 23 20 65 72 72 6f 72 20 22 4d 75 73  TA).# error "Mus
9a20: 74 20 6e 6f 74 20 64 65 66 69 6e 65 20 62 6f 74  t not define bot
9a30: 68 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45  h SQLITE_OMIT_DE
9a40: 43 4c 54 59 50 45 20 5c 0a 20 20 20 20 20 20 20  CLTYPE \.       
9a50: 20 20 61 6e 64 20 53 51 4c 49 54 45 5f 45 4e 41    and SQLITE_ENA
9a60: 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44  BLE_COLUMN_METAD
9a70: 41 54 41 22 0a 23 65 6e 64 69 66 0a 0a 23 69 66  ATA".#endif..#if
9a80: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
9a90: 5f 44 45 43 4c 54 59 50 45 0a 2f 2a 0a 2a 2a 20  _DECLTYPE./*.** 
9aa0: 52 65 74 75 72 6e 20 74 68 65 20 63 6f 6c 75 6d  Return the colum
9ab0: 6e 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 74 79  n declaration ty
9ac0: 70 65 20 28 69 66 20 61 70 70 6c 69 63 61 62 6c  pe (if applicabl
9ad0: 65 29 20 6f 66 20 74 68 65 20 27 69 27 74 68 20  e) of the 'i'th 
9ae0: 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f 66 20 74 68 65  column.** of the
9af0: 20 72 65 73 75 6c 74 20 73 65 74 20 6f 66 20 53   result set of S
9b00: 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74  QL statement pSt
9b10: 6d 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61  mt..*/.const cha
9b20: 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  r *sqlite3_colum
9b30: 6e 5f 64 65 63 6c 74 79 70 65 28 73 71 6c 69 74  n_decltype(sqlit
9b40: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
9b50: 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e  int N){.  return
9b60: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d   columnName(pStm
9b70: 74 2c 20 4e 2c 20 30 2c 20 43 4f 4c 4e 41 4d 45  t, N, 0, COLNAME
9b80: 5f 44 45 43 4c 54 59 50 45 29 3b 0a 7d 0a 23 69  _DECLTYPE);.}.#i
9b90: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
9ba0: 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f  T_UTF16.const vo
9bb0: 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75  id *sqlite3_colu
9bc0: 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36 28 73 71  mn_decltype16(sq
9bd0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
9be0: 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74  t, int N){.  ret
9bf0: 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70  urn columnName(p
9c00: 53 74 6d 74 2c 20 4e 2c 20 31 2c 20 43 4f 4c 4e  Stmt, N, 1, COLN
9c10: 41 4d 45 5f 44 45 43 4c 54 59 50 45 29 3b 0a 7d  AME_DECLTYPE);.}
9c20: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54  .#endif /* SQLIT
9c30: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a  E_OMIT_UTF16 */.
9c40: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
9c50: 5f 4f 4d 49 54 5f 44 45 43 4c 54 59 50 45 20 2a  _OMIT_DECLTYPE *
9c60: 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  /..#ifdef SQLITE
9c70: 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d  _ENABLE_COLUMN_M
9c80: 45 54 41 44 41 54 41 0a 2f 2a 0a 2a 2a 20 52 65  ETADATA./*.** Re
9c90: 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66  turn the name of
9ca0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 72   the database fr
9cb0: 6f 6d 20 77 68 69 63 68 20 61 20 72 65 73 75 6c  om which a resul
9cc0: 74 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73  t column derives
9cd0: 2e 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74  ..** NULL is ret
9ce0: 75 72 6e 65 64 20 69 66 20 74 68 65 20 72 65 73  urned if the res
9cf0: 75 6c 74 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e  ult column is an
9d00: 20 65 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 63   expression or c
9d10: 6f 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e  onstant or.** an
9d20: 79 74 68 69 6e 67 20 65 6c 73 65 20 77 68 69 63  ything else whic
9d30: 68 20 69 73 20 6e 6f 74 20 61 6e 20 75 6e 61 6d  h is not an unam
9d40: 62 69 67 75 6f 75 73 20 72 65 66 65 72 65 6e 63  biguous referenc
9d50: 65 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20  e to a database 
9d60: 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74  column..*/.const
9d70: 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63   char *sqlite3_c
9d80: 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e  olumn_database_n
9d90: 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ame(sqlite3_stmt
9da0: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b   *pStmt, int N){
9db0: 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e  .  return column
9dc0: 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 30  Name(pStmt, N, 0
9dd0: 2c 20 43 4f 4c 4e 41 4d 45 5f 44 41 54 41 42 41  , COLNAME_DATABA
9de0: 53 45 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53  SE);.}.#ifndef S
9df0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
9e00: 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c  .const void *sql
9e10: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61  ite3_column_data
9e20: 62 61 73 65 5f 6e 61 6d 65 31 36 28 73 71 6c 69  base_name16(sqli
9e30: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
9e40: 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75 72   int N){.  retur
9e50: 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74  n columnName(pSt
9e60: 6d 74 2c 20 4e 2c 20 31 2c 20 43 4f 4c 4e 41 4d  mt, N, 1, COLNAM
9e70: 45 5f 44 41 54 41 42 41 53 45 29 3b 0a 7d 0a 23  E_DATABASE);.}.#
9e80: 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f  endif /* SQLITE_
9e90: 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a 0a 2f  OMIT_UTF16 */../
9ea0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
9eb0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
9ec0: 65 20 66 72 6f 6d 20 77 68 69 63 68 20 61 20 72  e from which a r
9ed0: 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 65 72  esult column der
9ee0: 69 76 65 73 2e 0a 2a 2a 20 4e 55 4c 4c 20 69 73  ives..** NULL is
9ef0: 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65   returned if the
9f00: 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 69   result column i
9f10: 73 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20  s an expression 
9f20: 6f 72 20 63 6f 6e 73 74 61 6e 74 20 6f 72 0a 2a  or constant or.*
9f30: 2a 20 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20  * anything else 
9f40: 77 68 69 63 68 20 69 73 20 6e 6f 74 20 61 6e 20  which is not an 
9f50: 75 6e 61 6d 62 69 67 75 6f 75 73 20 72 65 66 65  unambiguous refe
9f60: 72 65 6e 63 65 20 74 6f 20 61 20 64 61 74 61 62  rence to a datab
9f70: 61 73 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63  ase column..*/.c
9f80: 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74  onst char *sqlit
9f90: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f  e3_column_table_
9fa0: 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  name(sqlite3_stm
9fb0: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29  t *pStmt, int N)
9fc0: 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d  {.  return colum
9fd0: 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20  nName(pStmt, N, 
9fe0: 30 2c 20 43 4f 4c 4e 41 4d 45 5f 54 41 42 4c 45  0, COLNAME_TABLE
9ff0: 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c  );.}.#ifndef SQL
a000: 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63  ITE_OMIT_UTF16.c
a010: 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74  onst void *sqlit
a020: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f  e3_column_table_
a030: 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33 5f 73  name16(sqlite3_s
a040: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
a050: 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c  N){.  return col
a060: 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e  umnName(pStmt, N
a070: 2c 20 31 2c 20 43 4f 4c 4e 41 4d 45 5f 54 41 42  , 1, COLNAME_TAB
a080: 4c 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a  LE);.}.#endif /*
a090: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
a0a0: 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  16 */../*.** Ret
a0b0: 75 72 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  urn the name of 
a0c0: 74 68 65 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e  the table column
a0d0: 20 66 72 6f 6d 20 77 68 69 63 68 20 61 20 72 65   from which a re
a0e0: 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 65 72 69  sult column deri
a0f0: 76 65 73 2e 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20  ves..** NULL is 
a100: 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 20  returned if the 
a110: 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 69 73  result column is
a120: 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 6f   an expression o
a130: 72 20 63 6f 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a  r constant or.**
a140: 20 61 6e 79 74 68 69 6e 67 20 65 6c 73 65 20 77   anything else w
a150: 68 69 63 68 20 69 73 20 6e 6f 74 20 61 6e 20 75  hich is not an u
a160: 6e 61 6d 62 69 67 75 6f 75 73 20 72 65 66 65 72  nambiguous refer
a170: 65 6e 63 65 20 74 6f 20 61 20 64 61 74 61 62 61  ence to a databa
a180: 73 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f  se column..*/.co
a190: 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65  nst char *sqlite
a1a0: 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f  3_column_origin_
a1b0: 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  name(sqlite3_stm
a1c0: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29  t *pStmt, int N)
a1d0: 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d  {.  return colum
a1e0: 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20  nName(pStmt, N, 
a1f0: 30 2c 20 43 4f 4c 4e 41 4d 45 5f 43 4f 4c 55 4d  0, COLNAME_COLUM
a200: 4e 29 3b 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51  N);.}.#ifndef SQ
a210: 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a  LITE_OMIT_UTF16.
a220: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69  const void *sqli
a230: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69  te3_column_origi
a240: 6e 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33  n_name16(sqlite3
a250: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
a260: 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63  t N){.  return c
a270: 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c  olumnName(pStmt,
a280: 20 4e 2c 20 31 2c 20 43 4f 4c 4e 41 4d 45 5f 43   N, 1, COLNAME_C
a290: 4f 4c 55 4d 4e 29 3b 0a 7d 0a 23 65 6e 64 69 66  OLUMN);.}.#endif
a2a0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f   /* SQLITE_OMIT_
a2b0: 55 54 46 31 36 20 2a 2f 0a 23 65 6e 64 69 66 20  UTF16 */.#endif 
a2c0: 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  /* SQLITE_ENABLE
a2d0: 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41  _COLUMN_METADATA
a2e0: 20 2a 2f 0a 0a 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a   */.../*********
a2f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
a300: 2a 2a 2a 2a 2a 2a 20 73 71 6c 69 74 65 33 5f 62  ****** sqlite3_b
a310: 69 6e 64 5f 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ind_  **********
a320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
a330: 2a 0a 2a 2a 20 0a 2a 2a 20 52 6f 75 74 69 6e 65  *.** .** Routine
a340: 73 20 75 73 65 64 20 74 6f 20 61 74 74 61 63 68  s used to attach
a350: 20 76 61 6c 75 65 73 20 74 6f 20 77 69 6c 64 63   values to wildc
a360: 61 72 64 73 20 69 6e 20 61 20 63 6f 6d 70 69 6c  ards in a compil
a370: 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  ed SQL statement
a380: 2e 0a 2a 2f 0a 2f 2a 0a 2a 2a 20 55 6e 62 69 6e  ..*/./*.** Unbin
a390: 64 20 74 68 65 20 76 61 6c 75 65 20 62 6f 75 6e  d the value boun
a3a0: 64 20 74 6f 20 76 61 72 69 61 62 6c 65 20 69 20  d to variable i 
a3b0: 69 6e 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  in virtual machi
a3c0: 6e 65 20 70 2e 20 54 68 69 73 20 69 73 20 74 68  ne p. This is th
a3d0: 65 20 0a 2a 2a 20 74 68 65 20 73 61 6d 65 20 61  e .** the same a
a3e0: 73 20 62 69 6e 64 69 6e 67 20 61 20 4e 55 4c 4c  s binding a NULL
a3f0: 20 76 61 6c 75 65 20 74 6f 20 74 68 65 20 63 6f   value to the co
a400: 6c 75 6d 6e 2e 20 49 66 20 74 68 65 20 22 69 22  lumn. If the "i"
a410: 20 70 61 72 61 6d 65 74 65 72 20 69 73 0a 2a 2a   parameter is.**
a420: 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2c 20 74   out of range, t
a430: 68 65 6e 20 53 51 4c 49 54 45 5f 52 41 4e 47 45  hen SQLITE_RANGE
a440: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74   is returned. Ot
a450: 68 65 77 69 73 65 20 53 51 4c 49 54 45 5f 4f 4b  hewise SQLITE_OK
a460: 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 75 63 63 65 73  ..**.** A succes
a470: 73 66 75 6c 20 65 76 61 6c 75 61 74 69 6f 6e 20  sful evaluation 
a480: 6f 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  of this routine 
a490: 61 63 71 75 69 72 65 73 20 74 68 65 20 6d 75 74  acquires the mut
a4a0: 65 78 20 6f 6e 20 70 2e 0a 2a 2a 20 74 68 65 20  ex on p..** the 
a4b0: 6d 75 74 65 78 20 69 73 20 72 65 6c 65 61 73 65  mutex is release
a4c0: 64 20 69 66 20 61 6e 79 20 6b 69 6e 64 20 6f 66  d if any kind of
a4d0: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e 0a 2a   error occurs..*
a4e0: 2a 0a 2a 2a 20 54 68 65 20 65 72 72 6f 72 20 63  *.** The error c
a4f0: 6f 64 65 20 73 74 6f 72 65 64 20 69 6e 20 64 61  ode stored in da
a500: 74 61 62 61 73 65 20 70 2d 3e 64 62 20 69 73 20  tabase p->db is 
a510: 6f 76 65 72 77 72 69 74 74 65 6e 20 77 69 74 68  overwritten with
a520: 20 74 68 65 20 72 65 74 75 72 6e 0a 2a 2a 20 76   the return.** v
a530: 61 6c 75 65 20 69 6e 20 61 6e 79 20 63 61 73 65  alue in any case
a540: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
a550: 76 64 62 65 55 6e 62 69 6e 64 28 56 64 62 65 20  vdbeUnbind(Vdbe 
a560: 2a 70 2c 20 69 6e 74 20 69 29 7b 0a 20 20 4d 65  *p, int i){.  Me
a570: 6d 20 2a 70 56 61 72 3b 0a 20 20 69 66 28 20 76  m *pVar;.  if( v
a580: 64 62 65 53 61 66 65 74 79 4e 6f 74 4e 75 6c 6c  dbeSafetyNotNull
a590: 28 70 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72  (p) ){.    retur
a5a0: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f  n SQLITE_MISUSE_
a5b0: 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  BKPT;.  }.  sqli
a5c0: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
a5d0: 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  p->db->mutex);. 
a5e0: 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56   if( p->magic!=V
a5f0: 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 7c 7c  DBE_MAGIC_RUN ||
a600: 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20   p->pc>=0 ){.   
a610: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d   sqlite3Error(p-
a620: 3e 64 62 2c 20 53 51 4c 49 54 45 5f 4d 49 53 55  >db, SQLITE_MISU
a630: 53 45 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  SE);.    sqlite3
a640: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e  _mutex_leave(p->
a650: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20  db->mutex);.    
a660: 73 71 6c 69 74 65 33 5f 6c 6f 67 28 53 51 4c 49  sqlite3_log(SQLI
a670: 54 45 5f 4d 49 53 55 53 45 2c 20 0a 20 20 20 20  TE_MISUSE, .    
a680: 20 20 20 20 22 62 69 6e 64 20 6f 6e 20 61 20 62      "bind on a b
a690: 75 73 79 20 70 72 65 70 61 72 65 64 20 73 74 61  usy prepared sta
a6a0: 74 65 6d 65 6e 74 3a 20 5b 25 73 5d 22 2c 20 70  tement: [%s]", p
a6b0: 2d 3e 7a 53 71 6c 29 3b 0a 20 20 20 20 72 65 74  ->zSql);.    ret
a6c0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
a6d0: 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 69 66  E_BKPT;.  }.  if
a6e0: 28 20 69 3c 31 20 7c 7c 20 69 3e 70 2d 3e 6e 56  ( i<1 || i>p->nV
a6f0: 61 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  ar ){.    sqlite
a700: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51  3Error(p->db, SQ
a710: 4c 49 54 45 5f 52 41 4e 47 45 29 3b 0a 20 20 20  LITE_RANGE);.   
a720: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
a730: 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65  eave(p->db->mute
a740: 78 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53  x);.    return S
a750: 51 4c 49 54 45 5f 52 41 4e 47 45 3b 0a 20 20 7d  QLITE_RANGE;.  }
a760: 0a 20 20 69 2d 2d 3b 0a 20 20 70 56 61 72 20 3d  .  i--;.  pVar =
a770: 20 26 70 2d 3e 61 56 61 72 5b 69 5d 3b 0a 20 20   &p->aVar[i];.  
a780: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65  sqlite3VdbeMemRe
a790: 6c 65 61 73 65 28 70 56 61 72 29 3b 0a 20 20 70  lease(pVar);.  p
a7a0: 56 61 72 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d  Var->flags = MEM
a7b0: 5f 4e 75 6c 6c 3b 0a 20 20 70 2d 3e 64 62 2d 3e  _Null;.  p->db->
a7c0: 65 72 72 43 6f 64 65 20 3d 20 53 51 4c 49 54 45  errCode = SQLITE
a7d0: 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68  _OK;..  /* If th
a7e0: 65 20 62 69 74 20 63 6f 72 72 65 73 70 6f 6e 64  e bit correspond
a7f0: 69 6e 67 20 74 6f 20 74 68 69 73 20 76 61 72 69  ing to this vari
a800: 61 62 6c 65 20 69 6e 20 56 64 62 65 2e 65 78 70  able in Vdbe.exp
a810: 6d 61 73 6b 20 69 73 20 73 65 74 2c 20 74 68 65  mask is set, the
a820: 6e 20 0a 20 20 2a 2a 20 62 69 6e 64 69 6e 67 20  n .  ** binding 
a830: 61 20 6e 65 77 20 76 61 6c 75 65 20 74 6f 20 74  a new value to t
a840: 68 69 73 20 76 61 72 69 61 62 6c 65 20 69 6e 76  his variable inv
a850: 61 6c 69 64 61 74 65 73 20 74 68 65 20 63 75 72  alidates the cur
a860: 72 65 6e 74 20 71 75 65 72 79 20 70 6c 61 6e 2e  rent query plan.
a870: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 4d 50 4c 45  .  **.  ** IMPLE
a880: 4d 45 4e 54 41 54 49 4f 4e 2d 4f 46 3a 20 52 2d  MENTATION-OF: R-
a890: 34 38 34 34 30 2d 33 37 35 39 35 20 49 66 20 74  48440-37595 If t
a8a0: 68 65 20 73 70 65 63 69 66 69 63 20 76 61 6c 75  he specific valu
a8b0: 65 20 62 6f 75 6e 64 20 74 6f 20 68 6f 73 74 0a  e bound to host.
a8c0: 20 20 2a 2a 20 70 61 72 61 6d 65 74 65 72 20 69    ** parameter i
a8d0: 6e 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 75  n the WHERE clau
a8e0: 73 65 20 6d 69 67 68 74 20 69 6e 66 6c 75 65 6e  se might influen
a8f0: 63 65 20 74 68 65 20 63 68 6f 69 63 65 20 6f 66  ce the choice of
a900: 20 71 75 65 72 79 20 70 6c 61 6e 0a 20 20 2a 2a   query plan.  **
a910: 20 66 6f 72 20 61 20 73 74 61 74 65 6d 65 6e 74   for a statement
a920: 2c 20 74 68 65 6e 20 74 68 65 20 73 74 61 74 65  , then the state
a930: 6d 65 6e 74 20 77 69 6c 6c 20 62 65 20 61 75 74  ment will be aut
a940: 6f 6d 61 74 69 63 61 6c 6c 79 20 72 65 63 6f 6d  omatically recom
a950: 70 69 6c 65 64 2c 0a 20 20 2a 2a 20 61 73 20 69  piled,.  ** as i
a960: 66 20 74 68 65 72 65 20 68 61 64 20 62 65 65 6e  f there had been
a970: 20 61 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65   a schema change
a980: 2c 20 6f 6e 20 74 68 65 20 66 69 72 73 74 20 73  , on the first s
a990: 71 6c 69 74 65 33 5f 73 74 65 70 28 29 20 63 61  qlite3_step() ca
a9a0: 6c 6c 0a 20 20 2a 2a 20 66 6f 6c 6c 6f 77 69 6e  ll.  ** followin
a9b0: 67 20 61 6e 79 20 63 68 61 6e 67 65 20 74 6f 20  g any change to 
a9c0: 74 68 65 20 62 69 6e 64 69 6e 67 73 20 6f 66 20  the bindings of 
a9d0: 74 68 61 74 20 70 61 72 61 6d 65 74 65 72 2e 0a  that parameter..
a9e0: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 28    */.  assert( (
a9f0: 70 2d 3e 70 72 65 70 46 6c 61 67 73 20 26 20 53  p->prepFlags & S
aa00: 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 53 41  QLITE_PREPARE_SA
aa10: 56 45 53 51 4c 29 21 3d 30 20 7c 7c 20 70 2d 3e  VESQL)!=0 || p->
aa20: 65 78 70 6d 61 73 6b 3d 3d 30 20 29 3b 0a 20 20  expmask==0 );.  
aa30: 69 66 28 20 70 2d 3e 65 78 70 6d 61 73 6b 21 3d  if( p->expmask!=
aa40: 30 20 26 26 20 28 70 2d 3e 65 78 70 6d 61 73 6b  0 && (p->expmask
aa50: 20 26 20 28 69 3e 3d 33 31 20 3f 20 30 78 38 30   & (i>=31 ? 0x80
aa60: 30 30 30 30 30 30 20 3a 20 28 75 33 32 29 31 3c  000000 : (u32)1<
aa70: 3c 69 29 29 21 3d 30 20 29 7b 0a 20 20 20 20 70  <i))!=0 ){.    p
aa80: 2d 3e 65 78 70 69 72 65 64 20 3d 20 31 3b 0a 20  ->expired = 1;. 
aa90: 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49   }.  return SQLI
aaa0: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  TE_OK;.}../*.** 
aab0: 42 69 6e 64 20 61 20 74 65 78 74 20 6f 72 20 42  Bind a text or B
aac0: 4c 4f 42 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74  LOB value..*/.st
aad0: 61 74 69 63 20 69 6e 74 20 62 69 6e 64 54 65 78  atic int bindTex
aae0: 74 28 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d  t(.  sqlite3_stm
aaf0: 74 20 2a 70 53 74 6d 74 2c 20 20 20 2f 2a 20 54  t *pStmt,   /* T
ab00: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 6f 20  he statement to 
ab10: 62 69 6e 64 20 61 67 61 69 6e 73 74 20 2a 2f 0a  bind against */.
ab20: 20 20 69 6e 74 20 69 2c 20 20 20 20 20 20 20 20    int i,        
ab30: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65           /* Inde
ab40: 78 20 6f 66 20 74 68 65 20 70 61 72 61 6d 65 74  x of the paramet
ab50: 65 72 20 74 6f 20 62 69 6e 64 20 2a 2f 0a 20 20  er to bind */.  
ab60: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74  const void *zDat
ab70: 61 2c 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65  a,     /* Pointe
ab80: 72 20 74 6f 20 74 68 65 20 64 61 74 61 20 74 6f  r to the data to
ab90: 20 62 65 20 62 6f 75 6e 64 20 2a 2f 0a 20 20 69   be bound */.  i
aba0: 6e 74 20 6e 44 61 74 61 2c 20 20 20 20 20 20 20  nt nData,       
abb0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
abc0: 6f 66 20 62 79 74 65 73 20 6f 66 20 64 61 74 61  of bytes of data
abd0: 20 74 6f 20 62 65 20 62 6f 75 6e 64 20 2a 2f 0a   to be bound */.
abe0: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76    void (*xDel)(v
abf0: 6f 69 64 2a 29 2c 20 20 20 2f 2a 20 44 65 73 74  oid*),   /* Dest
ac00: 72 75 63 74 6f 72 20 66 6f 72 20 74 68 65 20 64  ructor for the d
ac10: 61 74 61 20 2a 2f 0a 20 20 75 38 20 65 6e 63 6f  ata */.  u8 enco
ac20: 64 69 6e 67 20 20 20 20 20 20 20 20 20 20 20 20  ding            
ac30: 2f 2a 20 45 6e 63 6f 64 69 6e 67 20 66 6f 72 20  /* Encoding for 
ac40: 74 68 65 20 64 61 74 61 20 2a 2f 0a 29 7b 0a 20  the data */.){. 
ac50: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
ac60: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 4d 65 6d 20   *)pStmt;.  Mem 
ac70: 2a 70 56 61 72 3b 0a 20 20 69 6e 74 20 72 63 3b  *pVar;.  int rc;
ac80: 0a 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62  ..  rc = vdbeUnb
ac90: 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28  ind(p, i);.  if(
aca0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
acb0: 7b 0a 20 20 20 20 69 66 28 20 7a 44 61 74 61 21  {.    if( zData!
acc0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 56 61 72  =0 ){.      pVar
acd0: 20 3d 20 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d   = &p->aVar[i-1]
ace0: 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  ;.      rc = sql
acf0: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53 74  ite3VdbeMemSetSt
ad00: 72 28 70 56 61 72 2c 20 7a 44 61 74 61 2c 20 6e  r(pVar, zData, n
ad10: 44 61 74 61 2c 20 65 6e 63 6f 64 69 6e 67 2c 20  Data, encoding, 
ad20: 78 44 65 6c 29 3b 0a 20 20 20 20 20 20 69 66 28  xDel);.      if(
ad30: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
ad40: 26 20 65 6e 63 6f 64 69 6e 67 21 3d 30 20 29 7b  & encoding!=0 ){
ad50: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71  .        rc = sq
ad60: 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 45  lite3VdbeChangeE
ad70: 6e 63 6f 64 69 6e 67 28 70 56 61 72 2c 20 45 4e  ncoding(pVar, EN
ad80: 43 28 70 2d 3e 64 62 29 29 3b 0a 20 20 20 20 20  C(p->db));.     
ad90: 20 7d 0a 20 20 20 20 20 20 69 66 28 20 72 63 20   }.      if( rc 
ada0: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  ){.        sqlit
adb0: 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 72  e3Error(p->db, r
adc0: 63 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d  c);.        rc =
add0: 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28   sqlite3ApiExit(
ade0: 70 2d 3e 64 62 2c 20 72 63 29 3b 0a 20 20 20 20  p->db, rc);.    
adf0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71    }.    }.    sq
ae00: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
ae10: 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b  e(p->db->mutex);
ae20: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 78 44 65  .  }else if( xDe
ae30: 6c 21 3d 53 51 4c 49 54 45 5f 53 54 41 54 49 43  l!=SQLITE_STATIC
ae40: 20 26 26 20 78 44 65 6c 21 3d 53 51 4c 49 54 45   && xDel!=SQLITE
ae50: 5f 54 52 41 4e 53 49 45 4e 54 20 29 7b 0a 20 20  _TRANSIENT ){.  
ae60: 20 20 78 44 65 6c 28 28 76 6f 69 64 2a 29 7a 44    xDel((void*)zD
ae70: 61 74 61 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  ata);.  }.  retu
ae80: 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a  rn rc;.}.../*.**
ae90: 20 42 69 6e 64 20 61 20 62 6c 6f 62 20 76 61 6c   Bind a blob val
aea0: 75 65 20 74 6f 20 61 6e 20 53 51 4c 20 73 74 61  ue to an SQL sta
aeb0: 74 65 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e  tement variable.
aec0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
aed0: 62 69 6e 64 5f 62 6c 6f 62 28 0a 20 20 73 71 6c  bind_blob(.  sql
aee0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
aef0: 2c 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63  , .  int i, .  c
af00: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61  onst void *zData
af10: 2c 20 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20  , .  int nData, 
af20: 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28  .  void (*xDel)(
af30: 76 6f 69 64 2a 29 0a 29 7b 0a 23 69 66 64 65 66  void*).){.#ifdef
af40: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41   SQLITE_ENABLE_A
af50: 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 6e  PI_ARMOR.  if( n
af60: 44 61 74 61 3c 30 20 29 20 72 65 74 75 72 6e 20  Data<0 ) return 
af70: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b  SQLITE_MISUSE_BK
af80: 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 72 65 74  PT;.#endif.  ret
af90: 75 72 6e 20 62 69 6e 64 54 65 78 74 28 70 53 74  urn bindText(pSt
afa0: 6d 74 2c 20 69 2c 20 7a 44 61 74 61 2c 20 6e 44  mt, i, zData, nD
afb0: 61 74 61 2c 20 78 44 65 6c 2c 20 30 29 3b 0a 7d  ata, xDel, 0);.}
afc0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e  .int sqlite3_bin
afd0: 64 5f 62 6c 6f 62 36 34 28 0a 20 20 73 71 6c 69  d_blob64(.  sqli
afe0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
aff0: 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63 6f   .  int i, .  co
b000: 6e 73 74 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c  nst void *zData,
b010: 20 0a 20 20 73 71 6c 69 74 65 33 5f 75 69 6e 74   .  sqlite3_uint
b020: 36 34 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f 69  64 nData, .  voi
b030: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29  d (*xDel)(void*)
b040: 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 20 78 44  .){.  assert( xD
b050: 65 6c 21 3d 53 51 4c 49 54 45 5f 44 59 4e 41 4d  el!=SQLITE_DYNAM
b060: 49 43 20 29 3b 0a 20 20 69 66 28 20 6e 44 61 74  IC );.  if( nDat
b070: 61 3e 30 78 37 66 66 66 66 66 66 66 20 29 7b 0a  a>0x7fffffff ){.
b080: 20 20 20 20 72 65 74 75 72 6e 20 69 6e 76 6f 6b      return invok
b090: 65 56 61 6c 75 65 44 65 73 74 72 75 63 74 6f 72  eValueDestructor
b0a0: 28 7a 44 61 74 61 2c 20 78 44 65 6c 2c 20 30 29  (zData, xDel, 0)
b0b0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72  ;.  }else{.    r
b0c0: 65 74 75 72 6e 20 62 69 6e 64 54 65 78 74 28 70  eturn bindText(p
b0d0: 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74 61 2c 20  Stmt, i, zData, 
b0e0: 28 69 6e 74 29 6e 44 61 74 61 2c 20 78 44 65 6c  (int)nData, xDel
b0f0: 2c 20 30 29 3b 0a 20 20 7d 0a 7d 0a 69 6e 74 20  , 0);.  }.}.int 
b100: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 64 6f 75  sqlite3_bind_dou
b110: 62 6c 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ble(sqlite3_stmt
b120: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20   *pStmt, int i, 
b130: 64 6f 75 62 6c 65 20 72 56 61 6c 75 65 29 7b 0a  double rValue){.
b140: 20 20 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65    int rc;.  Vdbe
b150: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53   *p = (Vdbe *)pS
b160: 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 65  tmt;.  rc = vdbe
b170: 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20  Unbind(p, i);.  
b180: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
b190: 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  K ){.    sqlite3
b1a0: 56 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c 65  VdbeMemSetDouble
b1b0: 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20  (&p->aVar[i-1], 
b1c0: 72 56 61 6c 75 65 29 3b 0a 20 20 20 20 73 71 6c  rValue);.    sql
b1d0: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
b1e0: 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (p->db->mutex);.
b1f0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
b200: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62  .}.int sqlite3_b
b210: 69 6e 64 5f 69 6e 74 28 73 71 6c 69 74 65 33 5f  ind_int(sqlite3_
b220: 73 74 6d 74 20 2a 70 2c 20 69 6e 74 20 69 2c 20  stmt *p, int i, 
b230: 69 6e 74 20 69 56 61 6c 75 65 29 7b 0a 20 20 72  int iValue){.  r
b240: 65 74 75 72 6e 20 73 71 6c 69 74 65 33 5f 62 69  eturn sqlite3_bi
b250: 6e 64 5f 69 6e 74 36 34 28 70 2c 20 69 2c 20 28  nd_int64(p, i, (
b260: 69 36 34 29 69 56 61 6c 75 65 29 3b 0a 7d 0a 69  i64)iValue);.}.i
b270: 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f  nt sqlite3_bind_
b280: 69 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 73 74  int64(sqlite3_st
b290: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
b2a0: 2c 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 69  , sqlite_int64 i
b2b0: 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74 20 72 63  Value){.  int rc
b2c0: 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56  ;.  Vdbe *p = (V
b2d0: 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 72  dbe *)pStmt;.  r
b2e0: 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70  c = vdbeUnbind(p
b2f0: 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d  , i);.  if( rc==
b300: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
b310: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
b320: 65 74 49 6e 74 36 34 28 26 70 2d 3e 61 56 61 72  etInt64(&p->aVar
b330: 5b 69 2d 31 5d 2c 20 69 56 61 6c 75 65 29 3b 0a  [i-1], iValue);.
b340: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
b350: 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d  x_leave(p->db->m
b360: 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 74  utex);.  }.  ret
b370: 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71  urn rc;.}.int sq
b380: 6c 69 74 65 33 5f 62 69 6e 64 5f 6e 75 6c 6c 28  lite3_bind_null(
b390: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
b3a0: 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 69  tmt, int i){.  i
b3b0: 6e 74 20 72 63 3b 0a 20 20 56 64 62 65 20 2a 70  nt rc;.  Vdbe *p
b3c0: 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b   = (Vdbe*)pStmt;
b3d0: 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69  .  rc = vdbeUnbi
b3e0: 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20  nd(p, i);.  if( 
b3f0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
b400: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
b410: 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e  ex_leave(p->db->
b420: 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65  mutex);.  }.  re
b430: 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73  turn rc;.}.int s
b440: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 6f 69 6e  qlite3_bind_poin
b450: 74 65 72 28 0a 20 20 73 71 6c 69 74 65 33 5f 73  ter(.  sqlite3_s
b460: 74 6d 74 20 2a 70 53 74 6d 74 2c 0a 20 20 69 6e  tmt *pStmt,.  in
b470: 74 20 69 2c 0a 20 20 76 6f 69 64 20 2a 70 50 74  t i,.  void *pPt
b480: 72 2c 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  r,.  const char 
b490: 2a 7a 50 54 74 79 70 65 2c 0a 20 20 76 6f 69 64  *zPTtype,.  void
b4a0: 20 28 2a 78 44 65 73 74 72 75 63 74 6f 72 29 28   (*xDestructor)(
b4b0: 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 69 6e 74 20  void*).){.  int 
b4c0: 72 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20  rc;.  Vdbe *p = 
b4d0: 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20  (Vdbe*)pStmt;.  
b4e0: 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28  rc = vdbeUnbind(
b4f0: 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63 3d  p, i);.  if( rc=
b500: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
b510: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
b520: 53 65 74 50 6f 69 6e 74 65 72 28 26 70 2d 3e 61  SetPointer(&p->a
b530: 56 61 72 5b 69 2d 31 5d 2c 20 70 50 74 72 2c 20  Var[i-1], pPtr, 
b540: 7a 50 54 74 79 70 65 2c 20 78 44 65 73 74 72 75  zPTtype, xDestru
b550: 63 74 6f 72 29 3b 0a 20 20 20 20 73 71 6c 69 74  ctor);.    sqlit
b560: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70  e3_mutex_leave(p
b570: 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  ->db->mutex);.  
b580: 7d 65 6c 73 65 20 69 66 28 20 78 44 65 73 74 72  }else if( xDestr
b590: 75 63 74 6f 72 20 29 7b 0a 20 20 20 20 78 44 65  uctor ){.    xDe
b5a0: 73 74 72 75 63 74 6f 72 28 70 50 74 72 29 3b 0a  structor(pPtr);.
b5b0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
b5c0: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62  .}.int sqlite3_b
b5d0: 69 6e 64 5f 74 65 78 74 28 20 0a 20 20 73 71 6c  ind_text( .  sql
b5e0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
b5f0: 2c 20 0a 20 20 69 6e 74 20 69 2c 20 0a 20 20 63  , .  int i, .  c
b600: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 61 74 61  onst char *zData
b610: 2c 20 0a 20 20 69 6e 74 20 6e 44 61 74 61 2c 20  , .  int nData, 
b620: 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28  .  void (*xDel)(
b630: 76 6f 69 64 2a 29 0a 29 7b 0a 20 20 72 65 74 75  void*).){.  retu
b640: 72 6e 20 62 69 6e 64 54 65 78 74 28 70 53 74 6d  rn bindText(pStm
b650: 74 2c 20 69 2c 20 7a 44 61 74 61 2c 20 6e 44 61  t, i, zData, nDa
b660: 74 61 2c 20 78 44 65 6c 2c 20 53 51 4c 49 54 45  ta, xDel, SQLITE
b670: 5f 55 54 46 38 29 3b 0a 7d 0a 69 6e 74 20 73 71  _UTF8);.}.int sq
b680: 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 36  lite3_bind_text6
b690: 34 28 20 0a 20 20 73 71 6c 69 74 65 33 5f 73 74  4( .  sqlite3_st
b6a0: 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e  mt *pStmt, .  in
b6b0: 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 63 68  t i, .  const ch
b6c0: 61 72 20 2a 7a 44 61 74 61 2c 20 0a 20 20 73 71  ar *zData, .  sq
b6d0: 6c 69 74 65 33 5f 75 69 6e 74 36 34 20 6e 44 61  lite3_uint64 nDa
b6e0: 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78 44  ta, .  void (*xD
b6f0: 65 6c 29 28 76 6f 69 64 2a 29 2c 0a 20 20 75 6e  el)(void*),.  un
b700: 73 69 67 6e 65 64 20 63 68 61 72 20 65 6e 63 0a  signed char enc.
b710: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 78 44 65  ){.  assert( xDe
b720: 6c 21 3d 53 51 4c 49 54 45 5f 44 59 4e 41 4d 49  l!=SQLITE_DYNAMI
b730: 43 20 29 3b 0a 20 20 69 66 28 20 6e 44 61 74 61  C );.  if( nData
b740: 3e 30 78 37 66 66 66 66 66 66 66 20 29 7b 0a 20  >0x7fffffff ){. 
b750: 20 20 20 72 65 74 75 72 6e 20 69 6e 76 6f 6b 65     return invoke
b760: 56 61 6c 75 65 44 65 73 74 72 75 63 74 6f 72 28  ValueDestructor(
b770: 7a 44 61 74 61 2c 20 78 44 65 6c 2c 20 30 29 3b  zData, xDel, 0);
b780: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 66  .  }else{.    if
b790: 28 20 65 6e 63 3d 3d 53 51 4c 49 54 45 5f 55 54  ( enc==SQLITE_UT
b7a0: 46 31 36 20 29 20 65 6e 63 20 3d 20 53 51 4c 49  F16 ) enc = SQLI
b7b0: 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 3b 0a  TE_UTF16NATIVE;.
b7c0: 20 20 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54      return bindT
b7d0: 65 78 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44  ext(pStmt, i, zD
b7e0: 61 74 61 2c 20 28 69 6e 74 29 6e 44 61 74 61 2c  ata, (int)nData,
b7f0: 20 78 44 65 6c 2c 20 65 6e 63 29 3b 0a 20 20 7d   xDel, enc);.  }
b800: 0a 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  .}.#ifndef SQLIT
b810: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 69 6e 74  E_OMIT_UTF16.int
b820: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65   sqlite3_bind_te
b830: 78 74 31 36 28 0a 20 20 73 71 6c 69 74 65 33 5f  xt16(.  sqlite3_
b840: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20  stmt *pStmt, .  
b850: 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20  int i, .  const 
b860: 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20  void *zData, .  
b870: 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f  int nData, .  vo
b880: 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a  id (*xDel)(void*
b890: 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 62 69  ).){.  return bi
b8a0: 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 20 69 2c  ndText(pStmt, i,
b8b0: 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20 78   zData, nData, x
b8c0: 44 65 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 31  Del, SQLITE_UTF1
b8d0: 36 4e 41 54 49 56 45 29 3b 0a 7d 0a 23 65 6e 64  6NATIVE);.}.#end
b8e0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49  if /* SQLITE_OMI
b8f0: 54 5f 55 54 46 31 36 20 2a 2f 0a 69 6e 74 20 73  T_UTF16 */.int s
b900: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 76 61 6c 75  qlite3_bind_valu
b910: 65 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  e(sqlite3_stmt *
b920: 70 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20 63 6f  pStmt, int i, co
b930: 6e 73 74 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  nst sqlite3_valu
b940: 65 20 2a 70 56 61 6c 75 65 29 7b 0a 20 20 69 6e  e *pValue){.  in
b950: 74 20 72 63 3b 0a 20 20 73 77 69 74 63 68 28 20  t rc;.  switch( 
b960: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 79  sqlite3_value_ty
b970: 70 65 28 28 73 71 6c 69 74 65 33 5f 76 61 6c 75  pe((sqlite3_valu
b980: 65 2a 29 70 56 61 6c 75 65 29 20 29 7b 0a 20 20  e*)pValue) ){.  
b990: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e    case SQLITE_IN
b9a0: 54 45 47 45 52 3a 20 7b 0a 20 20 20 20 20 20 72  TEGER: {.      r
b9b0: 63 20 3d 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  c = sqlite3_bind
b9c0: 5f 69 6e 74 36 34 28 70 53 74 6d 74 2c 20 69 2c  _int64(pStmt, i,
b9d0: 20 70 56 61 6c 75 65 2d 3e 75 2e 69 29 3b 0a 20   pValue->u.i);. 
b9e0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
b9f0: 7d 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54  }.    case SQLIT
ba00: 45 5f 46 4c 4f 41 54 3a 20 7b 0a 20 20 20 20 20  E_FLOAT: {.     
ba10: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 62 69   rc = sqlite3_bi
ba20: 6e 64 5f 64 6f 75 62 6c 65 28 70 53 74 6d 74 2c  nd_double(pStmt,
ba30: 20 69 2c 20 70 56 61 6c 75 65 2d 3e 75 2e 72 29   i, pValue->u.r)
ba40: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  ;.      break;. 
ba50: 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53 51     }.    case SQ
ba60: 4c 49 54 45 5f 42 4c 4f 42 3a 20 7b 0a 20 20 20  LITE_BLOB: {.   
ba70: 20 20 20 69 66 28 20 70 56 61 6c 75 65 2d 3e 66     if( pValue->f
ba80: 6c 61 67 73 20 26 20 4d 45 4d 5f 5a 65 72 6f 20  lags & MEM_Zero 
ba90: 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20  ){.        rc = 
baa0: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 7a 65 72  sqlite3_bind_zer
bab0: 6f 62 6c 6f 62 28 70 53 74 6d 74 2c 20 69 2c 20  oblob(pStmt, i, 
bac0: 70 56 61 6c 75 65 2d 3e 75 2e 6e 5a 65 72 6f 29  pValue->u.nZero)
bad0: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20  ;.      }else{. 
bae0: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69         rc = sqli
baf0: 74 65 33 5f 62 69 6e 64 5f 62 6c 6f 62 28 70 53  te3_bind_blob(pS
bb00: 74 6d 74 2c 20 69 2c 20 70 56 61 6c 75 65 2d 3e  tmt, i, pValue->
bb10: 7a 2c 20 70 56 61 6c 75 65 2d 3e 6e 2c 53 51 4c  z, pValue->n,SQL
bb20: 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a  ITE_TRANSIENT);.
bb30: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72        }.      br
bb40: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63  eak;.    }.    c
bb50: 61 73 65 20 53 51 4c 49 54 45 5f 54 45 58 54 3a  ase SQLITE_TEXT:
bb60: 20 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 62 69   {.      rc = bi
bb70: 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 69 2c 20  ndText(pStmt,i, 
bb80: 20 70 56 61 6c 75 65 2d 3e 7a 2c 20 70 56 61 6c   pValue->z, pVal
bb90: 75 65 2d 3e 6e 2c 20 53 51 4c 49 54 45 5f 54 52  ue->n, SQLITE_TR
bba0: 41 4e 53 49 45 4e 54 2c 0a 20 20 20 20 20 20 20  ANSIENT,.       
bbb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
bbc0: 20 20 20 20 20 20 20 70 56 61 6c 75 65 2d 3e 65         pValue->e
bbd0: 6e 63 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  nc);.      break
bbe0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66 61  ;.    }.    defa
bbf0: 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 72 63 20  ult: {.      rc 
bc00: 3d 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 6e  = sqlite3_bind_n
bc10: 75 6c 6c 28 70 53 74 6d 74 2c 20 69 29 3b 0a 20  ull(pStmt, i);. 
bc20: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
bc30: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  }.  }.  return r
bc40: 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  c;.}.int sqlite3
bc50: 5f 62 69 6e 64 5f 7a 65 72 6f 62 6c 6f 62 28 73  _bind_zeroblob(s
bc60: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
bc70: 6d 74 2c 20 69 6e 74 20 69 2c 20 69 6e 74 20 6e  mt, int i, int n
bc80: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56  ){.  int rc;.  V
bc90: 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a  dbe *p = (Vdbe *
bca0: 29 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76  )pStmt;.  rc = v
bcb0: 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b  dbeUnbind(p, i);
bcc0: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
bcd0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69  E_OK ){.    sqli
bce0: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 5a 65 72  te3VdbeMemSetZer
bcf0: 6f 42 6c 6f 62 28 26 70 2d 3e 61 56 61 72 5b 69  oBlob(&p->aVar[i
bd00: 2d 31 5d 2c 20 6e 29 3b 0a 20 20 20 20 73 71 6c  -1], n);.    sql
bd10: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
bd20: 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  (p->db->mutex);.
bd30: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
bd40: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62  .}.int sqlite3_b
bd50: 69 6e 64 5f 7a 65 72 6f 62 6c 6f 62 36 34 28 73  ind_zeroblob64(s
bd60: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
bd70: 6d 74 2c 20 69 6e 74 20 69 2c 20 73 71 6c 69 74  mt, int i, sqlit
bd80: 65 33 5f 75 69 6e 74 36 34 20 6e 29 7b 0a 20 20  e3_uint64 n){.  
bd90: 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65 20 2a  int rc;.  Vdbe *
bda0: 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d  p = (Vdbe *)pStm
bdb0: 74 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  t;.  sqlite3_mut
bdc0: 65 78 5f 65 6e 74 65 72 28 70 2d 3e 64 62 2d 3e  ex_enter(p->db->
bdd0: 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 6e 3e  mutex);.  if( n>
bde0: 28 75 36 34 29 70 2d 3e 64 62 2d 3e 61 4c 69 6d  (u64)p->db->aLim
bdf0: 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f  it[SQLITE_LIMIT_
be00: 4c 45 4e 47 54 48 5d 20 29 7b 0a 20 20 20 20 72  LENGTH] ){.    r
be10: 63 20 3d 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49  c = SQLITE_TOOBI
be20: 47 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  G;.  }else{.    
be30: 61 73 73 65 72 74 28 20 28 6e 20 26 20 30 78 37  assert( (n & 0x7
be40: 46 46 46 46 46 46 46 29 3d 3d 6e 20 29 3b 0a 20  FFFFFFF)==n );. 
be50: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f     rc = sqlite3_
be60: 62 69 6e 64 5f 7a 65 72 6f 62 6c 6f 62 28 70 53  bind_zeroblob(pS
be70: 74 6d 74 2c 20 69 2c 20 6e 29 3b 0a 20 20 7d 0a  tmt, i, n);.  }.
be80: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70    rc = sqlite3Ap
be90: 69 45 78 69 74 28 70 2d 3e 64 62 2c 20 72 63 29  iExit(p->db, rc)
bea0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  ;.  sqlite3_mute
beb0: 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d  x_leave(p->db->m
bec0: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20  utex);.  return 
bed0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  rc;.}../*.** Ret
bee0: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  urn the number o
bef0: 66 20 77 69 6c 64 63 61 72 64 73 20 74 68 61 74  f wildcards that
bf00: 20 63 61 6e 20 62 65 20 70 6f 74 65 6e 74 69 61   can be potentia
bf10: 6c 6c 79 20 62 6f 75 6e 64 20 74 6f 2e 0a 2a 2a  lly bound to..**
bf20: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
bf30: 20 61 64 64 65 64 20 74 6f 20 73 75 70 70 6f 72   added to suppor
bf40: 74 20 44 42 44 3a 3a 53 51 4c 69 74 65 2e 20 20  t DBD::SQLite.  
bf50: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
bf60: 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f 63  bind_parameter_c
bf70: 6f 75 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d  ount(sqlite3_stm
bf80: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62  t *pStmt){.  Vdb
bf90: 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53  e *p = (Vdbe*)pS
bfa0: 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 20  tmt;.  return p 
bfb0: 3f 20 70 2d 3e 6e 56 61 72 20 3a 20 30 3b 0a 7d  ? p->nVar : 0;.}
bfc0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
bfd0: 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 77 69 6c  he name of a wil
bfe0: 64 63 61 72 64 20 70 61 72 61 6d 65 74 65 72 2e  dcard parameter.
bff0: 20 20 52 65 74 75 72 6e 20 4e 55 4c 4c 20 69 66    Return NULL if
c000: 20 74 68 65 20 69 6e 64 65 78 0a 2a 2a 20 69 73   the index.** is
c010: 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 20 6f 72   out of range or
c020: 20 69 66 20 74 68 65 20 77 69 6c 64 63 61 72 64   if the wildcard
c030: 20 69 73 20 75 6e 6e 61 6d 65 64 2e 0a 2a 2a 0a   is unnamed..**.
c040: 2a 2a 20 54 68 65 20 72 65 73 75 6c 74 20 69 73  ** The result is
c050: 20 61 6c 77 61 79 73 20 55 54 46 2d 38 2e 0a 2a   always UTF-8..*
c060: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71  /.const char *sq
c070: 6c 69 74 65 33 5f 62 69 6e 64 5f 70 61 72 61 6d  lite3_bind_param
c080: 65 74 65 72 5f 6e 61 6d 65 28 73 71 6c 69 74 65  eter_name(sqlite
c090: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
c0a0: 6e 74 20 69 29 7b 0a 20 20 56 64 62 65 20 2a 70  nt i){.  Vdbe *p
c0b0: 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b   = (Vdbe*)pStmt;
c0c0: 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 65  .  if( p==0 ) re
c0d0: 74 75 72 6e 20 30 3b 0a 20 20 72 65 74 75 72 6e  turn 0;.  return
c0e0: 20 73 71 6c 69 74 65 33 56 4c 69 73 74 4e 75 6d   sqlite3VListNum
c0f0: 54 6f 4e 61 6d 65 28 70 2d 3e 70 56 4c 69 73 74  ToName(p->pVList
c100: 2c 20 69 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47  , i);.}../*.** G
c110: 69 76 65 6e 20 61 20 77 69 6c 64 63 61 72 64 20  iven a wildcard 
c120: 70 61 72 61 6d 65 74 65 72 20 6e 61 6d 65 2c 20  parameter name, 
c130: 72 65 74 75 72 6e 20 74 68 65 20 69 6e 64 65 78  return the index
c140: 20 6f 66 20 74 68 65 20 76 61 72 69 61 62 6c 65   of the variable
c150: 0a 2a 2a 20 77 69 74 68 20 74 68 61 74 20 6e 61  .** with that na
c160: 6d 65 2e 20 20 49 66 20 74 68 65 72 65 20 69 73  me.  If there is
c170: 20 6e 6f 20 76 61 72 69 61 62 6c 65 20 77 69 74   no variable wit
c180: 68 20 74 68 65 20 67 69 76 65 6e 20 6e 61 6d 65  h the given name
c190: 2c 0a 2a 2a 20 72 65 74 75 72 6e 20 30 2e 0a 2a  ,.** return 0..*
c1a0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
c1b0: 65 50 61 72 61 6d 65 74 65 72 49 6e 64 65 78 28  eParameterIndex(
c1c0: 56 64 62 65 20 2a 70 2c 20 63 6f 6e 73 74 20 63  Vdbe *p, const c
c1d0: 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 69 6e 74 20  har *zName, int 
c1e0: 6e 4e 61 6d 65 29 7b 0a 20 20 69 66 28 20 70 3d  nName){.  if( p=
c1f0: 3d 30 20 7c 7c 20 7a 4e 61 6d 65 3d 3d 30 20 29  =0 || zName==0 )
c200: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 72 65 74   return 0;.  ret
c210: 75 72 6e 20 73 71 6c 69 74 65 33 56 4c 69 73 74  urn sqlite3VList
c220: 4e 61 6d 65 54 6f 4e 75 6d 28 70 2d 3e 70 56 4c  NameToNum(p->pVL
c230: 69 73 74 2c 20 7a 4e 61 6d 65 2c 20 6e 4e 61 6d  ist, zName, nNam
c240: 65 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  e);.}.int sqlite
c250: 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72  3_bind_parameter
c260: 5f 69 6e 64 65 78 28 73 71 6c 69 74 65 33 5f 73  _index(sqlite3_s
c270: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 63 6f 6e 73  tmt *pStmt, cons
c280: 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 29 7b 0a  t char *zName){.
c290: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
c2a0: 56 64 62 65 50 61 72 61 6d 65 74 65 72 49 6e 64  VdbeParameterInd
c2b0: 65 78 28 28 56 64 62 65 2a 29 70 53 74 6d 74 2c  ex((Vdbe*)pStmt,
c2c0: 20 7a 4e 61 6d 65 2c 20 73 71 6c 69 74 65 33 53   zName, sqlite3S
c2d0: 74 72 6c 65 6e 33 30 28 7a 4e 61 6d 65 29 29 3b  trlen30(zName));
c2e0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 61 6e 73 66  .}../*.** Transf
c2f0: 65 72 20 61 6c 6c 20 62 69 6e 64 69 6e 67 73 20  er all bindings 
c300: 66 72 6f 6d 20 74 68 65 20 66 69 72 73 74 20 73  from the first s
c310: 74 61 74 65 6d 65 6e 74 20 6f 76 65 72 20 74 6f  tatement over to
c320: 20 74 68 65 20 73 65 63 6f 6e 64 2e 0a 2a 2f 0a   the second..*/.
c330: 69 6e 74 20 73 71 6c 69 74 65 33 54 72 61 6e 73  int sqlite3Trans
c340: 66 65 72 42 69 6e 64 69 6e 67 73 28 73 71 6c 69  ferBindings(sqli
c350: 74 65 33 5f 73 74 6d 74 20 2a 70 46 72 6f 6d 53  te3_stmt *pFromS
c360: 74 6d 74 2c 20 73 71 6c 69 74 65 33 5f 73 74 6d  tmt, sqlite3_stm
c370: 74 20 2a 70 54 6f 53 74 6d 74 29 7b 0a 20 20 56  t *pToStmt){.  V
c380: 64 62 65 20 2a 70 46 72 6f 6d 20 3d 20 28 56 64  dbe *pFrom = (Vd
c390: 62 65 2a 29 70 46 72 6f 6d 53 74 6d 74 3b 0a 20  be*)pFromStmt;. 
c3a0: 20 56 64 62 65 20 2a 70 54 6f 20 3d 20 28 56 64   Vdbe *pTo = (Vd
c3b0: 62 65 2a 29 70 54 6f 53 74 6d 74 3b 0a 20 20 69  be*)pToStmt;.  i
c3c0: 6e 74 20 69 3b 0a 20 20 61 73 73 65 72 74 28 20  nt i;.  assert( 
c3d0: 70 54 6f 2d 3e 64 62 3d 3d 70 46 72 6f 6d 2d 3e  pTo->db==pFrom->
c3e0: 64 62 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  db );.  assert( 
c3f0: 70 54 6f 2d 3e 6e 56 61 72 3d 3d 70 46 72 6f 6d  pTo->nVar==pFrom
c400: 2d 3e 6e 56 61 72 20 29 3b 0a 20 20 73 71 6c 69  ->nVar );.  sqli
c410: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28  te3_mutex_enter(
c420: 70 54 6f 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b  pTo->db->mutex);
c430: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 46  .  for(i=0; i<pF
c440: 72 6f 6d 2d 3e 6e 56 61 72 3b 20 69 2b 2b 29 7b  rom->nVar; i++){
c450: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
c460: 4d 65 6d 4d 6f 76 65 28 26 70 54 6f 2d 3e 61 56  MemMove(&pTo->aV
c470: 61 72 5b 69 5d 2c 20 26 70 46 72 6f 6d 2d 3e 61  ar[i], &pFrom->a
c480: 56 61 72 5b 69 5d 29 3b 0a 20 20 7d 0a 20 20 73  Var[i]);.  }.  s
c490: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
c4a0: 76 65 28 70 54 6f 2d 3e 64 62 2d 3e 6d 75 74 65  ve(pTo->db->mute
c4b0: 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  x);.  return SQL
c4c0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 6e 64  ITE_OK;.}..#ifnd
c4d0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44  ef SQLITE_OMIT_D
c4e0: 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a 2a 2a 20  EPRECATED./*.** 
c4f0: 44 65 70 72 65 63 61 74 65 64 20 65 78 74 65 72  Deprecated exter
c500: 6e 61 6c 20 69 6e 74 65 72 66 61 63 65 2e 20 20  nal interface.  
c510: 49 6e 74 65 72 6e 61 6c 2f 63 6f 72 65 20 53 51  Internal/core SQ
c520: 4c 69 74 65 20 63 6f 64 65 0a 2a 2a 20 73 68 6f  Lite code.** sho
c530: 75 6c 64 20 63 61 6c 6c 20 73 71 6c 69 74 65 33  uld call sqlite3
c540: 54 72 61 6e 73 66 65 72 42 69 6e 64 69 6e 67 73  TransferBindings
c550: 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 69 73 20 6d 69  ..**.** It is mi
c560: 73 75 73 65 20 74 6f 20 63 61 6c 6c 20 74 68 69  suse to call thi
c570: 73 20 72 6f 75 74 69 6e 65 20 77 69 74 68 20 73  s routine with s
c580: 74 61 74 65 6d 65 6e 74 73 20 66 72 6f 6d 20 64  tatements from d
c590: 69 66 66 65 72 65 6e 74 0a 2a 2a 20 64 61 74 61  ifferent.** data
c5a0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73  base connections
c5b0: 2e 20 20 42 75 74 20 61 73 20 74 68 69 73 20 69  .  But as this i
c5c0: 73 20 61 20 64 65 70 72 65 63 61 74 65 64 20 69  s a deprecated i
c5d0: 6e 74 65 72 66 61 63 65 2c 20 77 65 0a 2a 2a 20  nterface, we.** 
c5e0: 77 69 6c 6c 20 6e 6f 74 20 62 6f 74 68 65 72 20  will not bother 
c5f0: 74 6f 20 63 68 65 63 6b 20 66 6f 72 20 74 68 61  to check for tha
c600: 74 20 63 6f 6e 64 69 74 69 6f 6e 2e 0a 2a 2a 0a  t condition..**.
c610: 2a 2a 20 49 66 20 74 68 65 20 74 77 6f 20 73 74  ** If the two st
c620: 61 74 65 6d 65 6e 74 73 20 63 6f 6e 74 61 69 6e  atements contain
c630: 20 61 20 64 69 66 66 65 72 65 6e 74 20 6e 75 6d   a different num
c640: 62 65 72 20 6f 66 20 62 69 6e 64 69 6e 67 73 2c  ber of bindings,
c650: 20 74 68 65 6e 0a 2a 2a 20 61 6e 20 53 51 4c 49   then.** an SQLI
c660: 54 45 5f 45 52 52 4f 52 20 69 73 20 72 65 74 75  TE_ERROR is retu
c670: 72 6e 65 64 2e 20 20 4e 6f 74 68 69 6e 67 20 65  rned.  Nothing e
c680: 6c 73 65 20 63 61 6e 20 67 6f 20 77 72 6f 6e 67  lse can go wrong
c690: 2c 20 73 6f 20 6f 74 68 65 72 77 69 73 65 0a 2a  , so otherwise.*
c6a0: 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72  * SQLITE_OK is r
c6b0: 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20  eturned..*/.int 
c6c0: 73 71 6c 69 74 65 33 5f 74 72 61 6e 73 66 65 72  sqlite3_transfer
c6d0: 5f 62 69 6e 64 69 6e 67 73 28 73 71 6c 69 74 65  _bindings(sqlite
c6e0: 33 5f 73 74 6d 74 20 2a 70 46 72 6f 6d 53 74 6d  3_stmt *pFromStm
c6f0: 74 2c 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  t, sqlite3_stmt 
c700: 2a 70 54 6f 53 74 6d 74 29 7b 0a 20 20 56 64 62  *pToStmt){.  Vdb
c710: 65 20 2a 70 46 72 6f 6d 20 3d 20 28 56 64 62 65  e *pFrom = (Vdbe
c720: 2a 29 70 46 72 6f 6d 53 74 6d 74 3b 0a 20 20 56  *)pFromStmt;.  V
c730: 64 62 65 20 2a 70 54 6f 20 3d 20 28 56 64 62 65  dbe *pTo = (Vdbe
c740: 2a 29 70 54 6f 53 74 6d 74 3b 0a 20 20 69 66 28  *)pToStmt;.  if(
c750: 20 70 46 72 6f 6d 2d 3e 6e 56 61 72 21 3d 70 54   pFrom->nVar!=pT
c760: 6f 2d 3e 6e 56 61 72 20 29 7b 0a 20 20 20 20 72  o->nVar ){.    r
c770: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52  eturn SQLITE_ERR
c780: 4f 52 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74  OR;.  }.  assert
c790: 28 20 28 70 54 6f 2d 3e 70 72 65 70 46 6c 61 67  ( (pTo->prepFlag
c7a0: 73 20 26 20 53 51 4c 49 54 45 5f 50 52 45 50 41  s & SQLITE_PREPA
c7b0: 52 45 5f 53 41 56 45 53 51 4c 29 21 3d 30 20 7c  RE_SAVESQL)!=0 |
c7c0: 7c 20 70 54 6f 2d 3e 65 78 70 6d 61 73 6b 3d 3d  | pTo->expmask==
c7d0: 30 20 29 3b 0a 20 20 69 66 28 20 70 54 6f 2d 3e  0 );.  if( pTo->
c7e0: 65 78 70 6d 61 73 6b 20 29 7b 0a 20 20 20 20 70  expmask ){.    p
c7f0: 54 6f 2d 3e 65 78 70 69 72 65 64 20 3d 20 31 3b  To->expired = 1;
c800: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 28  .  }.  assert( (
c810: 70 46 72 6f 6d 2d 3e 70 72 65 70 46 6c 61 67 73  pFrom->prepFlags
c820: 20 26 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52   & SQLITE_PREPAR
c830: 45 5f 53 41 56 45 53 51 4c 29 21 3d 30 20 7c 7c  E_SAVESQL)!=0 ||
c840: 20 70 46 72 6f 6d 2d 3e 65 78 70 6d 61 73 6b 3d   pFrom->expmask=
c850: 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 46 72 6f  =0 );.  if( pFro
c860: 6d 2d 3e 65 78 70 6d 61 73 6b 20 29 7b 0a 20 20  m->expmask ){.  
c870: 20 20 70 46 72 6f 6d 2d 3e 65 78 70 69 72 65 64    pFrom->expired
c880: 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75   = 1;.  }.  retu
c890: 72 6e 20 73 71 6c 69 74 65 33 54 72 61 6e 73 66  rn sqlite3Transf
c8a0: 65 72 42 69 6e 64 69 6e 67 73 28 70 46 72 6f 6d  erBindings(pFrom
c8b0: 53 74 6d 74 2c 20 70 54 6f 53 74 6d 74 29 3b 0a  Stmt, pToStmt);.
c8c0: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  }.#endif../*.** 
c8d0: 52 65 74 75 72 6e 20 74 68 65 20 73 71 6c 69 74  Return the sqlit
c8e0: 65 33 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e  e3* database han
c8f0: 64 6c 65 20 74 6f 20 77 68 69 63 68 20 74 68 65  dle to which the
c900: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
c910: 65 6e 74 20 67 69 76 65 6e 0a 2a 2a 20 69 6e 20  ent given.** in 
c920: 74 68 65 20 61 72 67 75 6d 65 6e 74 20 62 65 6c  the argument bel
c930: 6f 6e 67 73 2e 20 20 54 68 69 73 20 69 73 20 74  ongs.  This is t
c940: 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65  he same database
c950: 20 68 61 6e 64 6c 65 20 74 68 61 74 20 77 61 73   handle that was
c960: 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 20 61 72  .** the first ar
c970: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 73 71  gument to the sq
c980: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 20  lite3_prepare() 
c990: 74 68 61 74 20 77 61 73 20 75 73 65 64 20 74 6f  that was used to
c9a0: 20 63 72 65 61 74 65 0a 2a 2a 20 74 68 65 20 73   create.** the s
c9b0: 74 61 74 65 6d 65 6e 74 20 69 6e 20 74 68 65 20  tatement in the 
c9c0: 66 69 72 73 74 20 70 6c 61 63 65 2e 0a 2a 2f 0a  first place..*/.
c9d0: 73 71 6c 69 74 65 33 20 2a 73 71 6c 69 74 65 33  sqlite3 *sqlite3
c9e0: 5f 64 62 5f 68 61 6e 64 6c 65 28 73 71 6c 69 74  _db_handle(sqlit
c9f0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b  e3_stmt *pStmt){
ca00: 0a 20 20 72 65 74 75 72 6e 20 70 53 74 6d 74 20  .  return pStmt 
ca10: 3f 20 28 28 56 64 62 65 2a 29 70 53 74 6d 74 29  ? ((Vdbe*)pStmt)
ca20: 2d 3e 64 62 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a  ->db : 0;.}../*.
ca30: 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69  ** Return true i
ca40: 66 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73  f the prepared s
ca50: 74 61 74 65 6d 65 6e 74 20 69 73 20 67 75 61 72  tatement is guar
ca60: 61 6e 74 65 65 64 20 74 6f 20 6e 6f 74 20 6d 6f  anteed to not mo
ca70: 64 69 66 79 20 74 68 65 0a 2a 2a 20 64 61 74 61  dify the.** data
ca80: 62 61 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  base..*/.int sql
ca90: 69 74 65 33 5f 73 74 6d 74 5f 72 65 61 64 6f 6e  ite3_stmt_readon
caa0: 6c 79 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  ly(sqlite3_stmt 
cab0: 2a 70 53 74 6d 74 29 7b 0a 20 20 72 65 74 75 72  *pStmt){.  retur
cac0: 6e 20 70 53 74 6d 74 20 3f 20 28 28 56 64 62 65  n pStmt ? ((Vdbe
cad0: 2a 29 70 53 74 6d 74 29 2d 3e 72 65 61 64 4f 6e  *)pStmt)->readOn
cae0: 6c 79 20 3a 20 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ly : 1;.}../*.**
caf0: 20 52 65 74 75 72 6e 20 31 20 69 66 20 74 68 65   Return 1 if the
cb00: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 61 6e   statement is an
cb10: 20 45 58 50 4c 41 49 4e 20 61 6e 64 20 72 65 74   EXPLAIN and ret
cb20: 75 72 6e 20 32 20 69 66 20 74 68 65 0a 2a 2a 20  urn 2 if the.** 
cb30: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 61 6e 20  statement is an 
cb40: 45 58 50 4c 41 49 4e 20 51 55 45 52 59 20 50 4c  EXPLAIN QUERY PL
cb50: 41 4e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  AN.*/.int sqlite
cb60: 33 5f 73 74 6d 74 5f 69 73 65 78 70 6c 61 69 6e  3_stmt_isexplain
cb70: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
cb80: 53 74 6d 74 29 7b 0a 20 20 72 65 74 75 72 6e 20  Stmt){.  return 
cb90: 70 53 74 6d 74 20 3f 20 28 28 56 64 62 65 2a 29  pStmt ? ((Vdbe*)
cba0: 70 53 74 6d 74 29 2d 3e 65 78 70 6c 61 69 6e 20  pStmt)->explain 
cbb0: 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  : 0;.}../*.** Re
cbc0: 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 68 65  turn true if the
cbd0: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
cbe0: 65 6e 74 20 69 73 20 69 6e 20 6e 65 65 64 20 6f  ent is in need o
cbf0: 66 20 62 65 69 6e 67 20 72 65 73 65 74 2e 0a 2a  f being reset..*
cc00: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 74  /.int sqlite3_st
cc10: 6d 74 5f 62 75 73 79 28 73 71 6c 69 74 65 33 5f  mt_busy(sqlite3_
cc20: 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20  stmt *pStmt){.  
cc30: 56 64 62 65 20 2a 76 20 3d 20 28 56 64 62 65 2a  Vdbe *v = (Vdbe*
cc40: 29 70 53 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e  )pStmt;.  return
cc50: 20 76 21 3d 30 20 26 26 20 76 2d 3e 6d 61 67 69   v!=0 && v->magi
cc60: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55  c==VDBE_MAGIC_RU
cc70: 4e 20 26 26 20 76 2d 3e 70 63 3e 3d 30 3b 0a 7d  N && v->pc>=0;.}
cc80: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61  ../*.** Return a
cc90: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
cca0: 6e 65 78 74 20 70 72 65 70 61 72 65 64 20 73 74  next prepared st
ccb0: 61 74 65 6d 65 6e 74 20 61 66 74 65 72 20 70 53  atement after pS
ccc0: 74 6d 74 20 61 73 73 6f 63 69 61 74 65 64 0a 2a  tmt associated.*
ccd0: 2a 20 77 69 74 68 20 64 61 74 61 62 61 73 65 20  * with database 
cce0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 44 62 2e 20  connection pDb. 
ccf0: 20 49 66 20 70 53 74 6d 74 20 69 73 20 4e 55 4c   If pStmt is NUL
cd00: 4c 2c 20 72 65 74 75 72 6e 20 74 68 65 20 66 69  L, return the fi
cd10: 72 73 74 0a 2a 2a 20 70 72 65 70 61 72 65 64 20  rst.** prepared 
cd20: 73 74 61 74 65 6d 65 6e 74 20 66 6f 72 20 74 68  statement for th
cd30: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  e database conne
cd40: 63 74 69 6f 6e 2e 20 20 52 65 74 75 72 6e 20 4e  ction.  Return N
cd50: 55 4c 4c 20 69 66 20 74 68 65 72 65 0a 2a 2a 20  ULL if there.** 
cd60: 61 72 65 20 6e 6f 20 6d 6f 72 65 2e 0a 2a 2f 0a  are no more..*/.
cd70: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 73 71  sqlite3_stmt *sq
cd80: 6c 69 74 65 33 5f 6e 65 78 74 5f 73 74 6d 74 28  lite3_next_stmt(
cd90: 73 71 6c 69 74 65 33 20 2a 70 44 62 2c 20 73 71  sqlite3 *pDb, sq
cda0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
cdb0: 74 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 73 74  t){.  sqlite3_st
cdc0: 6d 74 20 2a 70 4e 65 78 74 3b 0a 23 69 66 64 65  mt *pNext;.#ifde
cdd0: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
cde0: 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20  API_ARMOR.  if( 
cdf0: 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68  !sqlite3SafetyCh
ce00: 65 63 6b 4f 6b 28 70 44 62 29 20 29 7b 0a 20 20  eckOk(pDb) ){.  
ce10: 20 20 28 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d    (void)SQLITE_M
ce20: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20  ISUSE_BKPT;.    
ce30: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65  return 0;.  }.#e
ce40: 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 33 5f 6d  ndif.  sqlite3_m
ce50: 75 74 65 78 5f 65 6e 74 65 72 28 70 44 62 2d 3e  utex_enter(pDb->
ce60: 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 70 53  mutex);.  if( pS
ce70: 74 6d 74 3d 3d 30 20 29 7b 0a 20 20 20 20 70 4e  tmt==0 ){.    pN
ce80: 65 78 74 20 3d 20 28 73 71 6c 69 74 65 33 5f 73  ext = (sqlite3_s
ce90: 74 6d 74 2a 29 70 44 62 2d 3e 70 56 64 62 65 3b  tmt*)pDb->pVdbe;
cea0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 4e  .  }else{.    pN
ceb0: 65 78 74 20 3d 20 28 73 71 6c 69 74 65 33 5f 73  ext = (sqlite3_s
cec0: 74 6d 74 2a 29 28 28 56 64 62 65 2a 29 70 53 74  tmt*)((Vdbe*)pSt
ced0: 6d 74 29 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a  mt)->pNext;.  }.
cee0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
cef0: 6c 65 61 76 65 28 70 44 62 2d 3e 6d 75 74 65 78  leave(pDb->mutex
cf00: 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 4e 65 78  );.  return pNex
cf10: 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  t;.}../*.** Retu
cf20: 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  rn the value of 
cf30: 61 20 73 74 61 74 75 73 20 63 6f 75 6e 74 65 72  a status counter
cf40: 20 66 6f 72 20 61 20 70 72 65 70 61 72 65 64 20   for a prepared 
cf50: 73 74 61 74 65 6d 65 6e 74 0a 2a 2f 0a 69 6e 74  statement.*/.int
cf60: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 5f 73 74   sqlite3_stmt_st
cf70: 61 74 75 73 28 73 71 6c 69 74 65 33 5f 73 74 6d  atus(sqlite3_stm
cf80: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 6f 70  t *pStmt, int op
cf90: 2c 20 69 6e 74 20 72 65 73 65 74 46 6c 61 67 29  , int resetFlag)
cfa0: 7b 0a 20 20 56 64 62 65 20 2a 70 56 64 62 65 20  {.  Vdbe *pVdbe 
cfb0: 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a  = (Vdbe*)pStmt;.
cfc0: 20 20 75 33 32 20 76 3b 0a 23 69 66 64 65 66 20    u32 v;.#ifdef 
cfd0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50  SQLITE_ENABLE_AP
cfe0: 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 21 70  I_ARMOR.  if( !p
cff0: 53 74 6d 74 20 0a 20 20 20 7c 7c 20 28 6f 70 21  Stmt .   || (op!
d000: 3d 53 51 4c 49 54 45 5f 53 54 4d 54 53 54 41 54  =SQLITE_STMTSTAT
d010: 55 53 5f 4d 45 4d 55 53 45 44 20 26 26 20 28 6f  US_MEMUSED && (o
d020: 70 3c 30 7c 7c 6f 70 3e 3d 41 72 72 61 79 53 69  p<0||op>=ArraySi
d030: 7a 65 28 70 56 64 62 65 2d 3e 61 43 6f 75 6e 74  ze(pVdbe->aCount
d040: 65 72 29 29 29 0a 20 20 29 7b 0a 20 20 20 20 28  er))).  ){.    (
d050: 76 6f 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55  void)SQLITE_MISU
d060: 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74  SE_BKPT;.    ret
d070: 75 72 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69  urn 0;.  }.#endi
d080: 66 0a 20 20 69 66 28 20 6f 70 3d 3d 53 51 4c 49  f.  if( op==SQLI
d090: 54 45 5f 53 54 4d 54 53 54 41 54 55 53 5f 4d 45  TE_STMTSTATUS_ME
d0a0: 4d 55 53 45 44 20 29 7b 0a 20 20 20 20 73 71 6c  MUSED ){.    sql
d0b0: 69 74 65 33 20 2a 64 62 20 3d 20 70 56 64 62 65  ite3 *db = pVdbe
d0c0: 2d 3e 64 62 3b 0a 20 20 20 20 73 71 6c 69 74 65  ->db;.    sqlite
d0d0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62  3_mutex_enter(db
d0e0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 76 20  ->mutex);.    v 
d0f0: 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 70 6e 42  = 0;.    db->pnB
d100: 79 74 65 73 46 72 65 65 64 20 3d 20 28 69 6e 74  ytesFreed = (int
d110: 2a 29 26 76 3b 0a 20 20 20 20 73 71 6c 69 74 65  *)&v;.    sqlite
d120: 33 56 64 62 65 43 6c 65 61 72 4f 62 6a 65 63 74  3VdbeClearObject
d130: 28 64 62 2c 20 70 56 64 62 65 29 3b 0a 20 20 20  (db, pVdbe);.   
d140: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64   sqlite3DbFree(d
d150: 62 2c 20 70 56 64 62 65 29 3b 0a 20 20 20 20 64  b, pVdbe);.    d
d160: 62 2d 3e 70 6e 42 79 74 65 73 46 72 65 65 64 20  b->pnBytesFreed 
d170: 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  = 0;.    sqlite3
d180: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d  _mutex_leave(db-
d190: 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65  >mutex);.  }else
d1a0: 7b 0a 20 20 20 20 76 20 3d 20 70 56 64 62 65 2d  {.    v = pVdbe-
d1b0: 3e 61 43 6f 75 6e 74 65 72 5b 6f 70 5d 3b 0a 20  >aCounter[op];. 
d1c0: 20 20 20 69 66 28 20 72 65 73 65 74 46 6c 61 67     if( resetFlag
d1d0: 20 29 20 70 56 64 62 65 2d 3e 61 43 6f 75 6e 74   ) pVdbe->aCount
d1e0: 65 72 5b 6f 70 5d 20 3d 20 30 3b 0a 20 20 7d 0a  er[op] = 0;.  }.
d1f0: 20 20 72 65 74 75 72 6e 20 28 69 6e 74 29 76 3b    return (int)v;
d200: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
d210: 20 74 68 65 20 53 51 4c 20 61 73 73 6f 63 69 61   the SQL associa
d220: 74 65 64 20 77 69 74 68 20 61 20 70 72 65 70 61  ted with a prepa
d230: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2f  red statement.*/
d240: 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c  .const char *sql
d250: 69 74 65 33 5f 73 71 6c 28 73 71 6c 69 74 65 33  ite3_sql(sqlite3
d260: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20  _stmt *pStmt){. 
d270: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
d280: 20 2a 29 70 53 74 6d 74 3b 0a 20 20 72 65 74 75   *)pStmt;.  retu
d290: 72 6e 20 70 20 3f 20 70 2d 3e 7a 53 71 6c 20 3a  rn p ? p->zSql :
d2a0: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74   0;.}../*.** Ret
d2b0: 75 72 6e 20 74 68 65 20 53 51 4c 20 61 73 73 6f  urn the SQL asso
d2c0: 63 69 61 74 65 64 20 77 69 74 68 20 61 20 70 72  ciated with a pr
d2d0: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74  epared statement
d2e0: 20 77 69 74 68 0a 2a 2a 20 62 6f 75 6e 64 20 70   with.** bound p
d2f0: 61 72 61 6d 65 74 65 72 73 20 65 78 70 61 6e 64  arameters expand
d300: 65 64 2e 20 20 53 70 61 63 65 20 74 6f 20 68 6f  ed.  Space to ho
d310: 6c 64 20 74 68 65 20 72 65 74 75 72 6e 65 64 20  ld the returned 
d320: 73 74 72 69 6e 67 20 69 73 0a 2a 2a 20 6f 62 74  string is.** obt
d330: 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74  ained from sqlit
d340: 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e 20 20 54 68  e3_malloc().  Th
d350: 65 20 63 61 6c 6c 65 72 20 69 73 20 72 65 73 70  e caller is resp
d360: 6f 6e 73 69 62 6c 65 20 66 6f 72 0a 2a 2a 20 66  onsible for.** f
d370: 72 65 65 69 6e 67 20 74 68 65 20 72 65 74 75 72  reeing the retur
d380: 6e 65 64 20 73 74 72 69 6e 67 20 62 79 20 70 61  ned string by pa
d390: 73 73 69 6e 67 20 69 74 20 74 6f 20 73 71 6c 69  ssing it to sqli
d3a0: 74 65 33 5f 66 72 65 65 28 29 2e 0a 2a 2a 0a 2a  te3_free()..**.*
d3b0: 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 54 52 41  * The SQLITE_TRA
d3c0: 43 45 5f 53 49 5a 45 5f 4c 49 4d 49 54 20 70 75  CE_SIZE_LIMIT pu
d3d0: 74 73 20 61 6e 20 75 70 70 65 72 20 62 6f 75 6e  ts an upper boun
d3e0: 64 20 6f 6e 20 74 68 65 20 73 69 7a 65 20 6f 66  d on the size of
d3f0: 0a 2a 2a 20 65 78 70 61 6e 64 65 64 20 62 6f 75  .** expanded bou
d400: 6e 64 20 70 61 72 61 6d 65 74 65 72 73 2e 0a 2a  nd parameters..*
d410: 2f 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f  /.char *sqlite3_
d420: 65 78 70 61 6e 64 65 64 5f 73 71 6c 28 73 71 6c  expanded_sql(sql
d430: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
d440: 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  ){.#ifdef SQLITE
d450: 5f 4f 4d 49 54 5f 54 52 41 43 45 0a 20 20 72 65  _OMIT_TRACE.  re
d460: 74 75 72 6e 20 30 3b 0a 23 65 6c 73 65 0a 20 20  turn 0;.#else.  
d470: 63 68 61 72 20 2a 7a 20 3d 20 30 3b 0a 20 20 63  char *z = 0;.  c
d480: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 20  onst char *zSql 
d490: 3d 20 73 71 6c 69 74 65 33 5f 73 71 6c 28 70 53  = sqlite3_sql(pS
d4a0: 74 6d 74 29 3b 0a 20 20 69 66 28 20 7a 53 71 6c  tmt);.  if( zSql
d4b0: 20 29 7b 0a 20 20 20 20 56 64 62 65 20 2a 70 20   ){.    Vdbe *p 
d4c0: 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b  = (Vdbe *)pStmt;
d4d0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
d4e0: 65 78 5f 65 6e 74 65 72 28 70 2d 3e 64 62 2d 3e  ex_enter(p->db->
d4f0: 6d 75 74 65 78 29 3b 0a 20 20 20 20 7a 20 3d 20  mutex);.    z = 
d500: 73 71 6c 69 74 65 33 56 64 62 65 45 78 70 61 6e  sqlite3VdbeExpan
d510: 64 53 71 6c 28 70 2c 20 7a 53 71 6c 29 3b 0a 20  dSql(p, zSql);. 
d520: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78     sqlite3_mutex
d530: 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75  _leave(p->db->mu
d540: 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  tex);.  }.  retu
d550: 72 6e 20 7a 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a  rn z;.#endif.}..
d560: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e  #ifdef SQLITE_EN
d570: 41 42 4c 45 5f 4e 4f 52 4d 41 4c 49 5a 45 0a 2f  ABLE_NORMALIZE./
d580: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
d590: 6e 6f 72 6d 61 6c 69 7a 65 64 20 53 51 4c 20 61  normalized SQL a
d5a0: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61  ssociated with a
d5b0: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
d5c0: 65 6e 74 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68  ent..*/.const ch
d5d0: 61 72 20 2a 73 71 6c 69 74 65 33 5f 6e 6f 72 6d  ar *sqlite3_norm
d5e0: 61 6c 69 7a 65 64 5f 73 71 6c 28 73 71 6c 69 74  alized_sql(sqlit
d5f0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b  e3_stmt *pStmt){
d600: 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64  .  Vdbe *p = (Vd
d610: 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66  be *)pStmt;.  if
d620: 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  ( p==0 ) return 
d630: 30 3b 0a 20 20 69 66 28 20 70 2d 3e 7a 4e 6f 72  0;.  if( p->zNor
d640: 6d 53 71 6c 3d 3d 30 20 26 26 20 41 4c 57 41 59  mSql==0 && ALWAY
d650: 53 28 70 2d 3e 7a 53 71 6c 21 3d 30 29 20 29 7b  S(p->zSql!=0) ){
d660: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
d670: 65 78 5f 65 6e 74 65 72 28 70 2d 3e 64 62 2d 3e  ex_enter(p->db->
d680: 6d 75 74 65 78 29 3b 0a 20 20 20 20 70 2d 3e 7a  mutex);.    p->z
d690: 4e 6f 72 6d 53 71 6c 20 3d 20 73 71 6c 69 74 65  NormSql = sqlite
d6a0: 33 4e 6f 72 6d 61 6c 69 7a 65 28 70 2c 20 70 2d  3Normalize(p, p-
d6b0: 3e 7a 53 71 6c 29 3b 0a 20 20 20 20 73 71 6c 69  >zSql);.    sqli
d6c0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
d6d0: 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  p->db->mutex);. 
d6e0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 7a   }.  return p->z
d6f0: 4e 6f 72 6d 53 71 6c 3b 0a 7d 0a 23 65 6e 64 69  NormSql;.}.#endi
d700: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42  f /* SQLITE_ENAB
d710: 4c 45 5f 4e 4f 52 4d 41 4c 49 5a 45 20 2a 2f 0a  LE_NORMALIZE */.
d720: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45  .#ifdef SQLITE_E
d730: 4e 41 42 4c 45 5f 50 52 45 55 50 44 41 54 45 5f  NABLE_PREUPDATE_
d740: 48 4f 4f 4b 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63  HOOK./*.** Alloc
d750: 61 74 65 20 61 6e 64 20 70 6f 70 75 6c 61 74 65  ate and populate
d760: 20 61 6e 20 55 6e 70 61 63 6b 65 64 52 65 63 6f   an UnpackedReco
d770: 72 64 20 73 74 72 75 63 74 75 72 65 20 62 61 73  rd structure bas
d780: 65 64 20 6f 6e 20 74 68 65 20 73 65 72 69 61 6c  ed on the serial
d790: 69 7a 65 64 0a 2a 2a 20 72 65 63 6f 72 64 20 69  ized.** record i
d7a0: 6e 20 6e 4b 65 79 2f 70 4b 65 79 2e 20 52 65 74  n nKey/pKey. Ret
d7b0: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f  urn a pointer to
d7c0: 20 74 68 65 20 6e 65 77 20 55 6e 70 61 63 6b 65   the new Unpacke
d7d0: 64 52 65 63 6f 72 64 20 73 74 72 75 63 74 75 72  dRecord structur
d7e0: 65 0a 2a 2a 20 69 66 20 73 75 63 63 65 73 73 66  e.** if successf
d7f0: 75 6c 2c 20 6f 72 20 61 20 4e 55 4c 4c 20 70 6f  ul, or a NULL po
d800: 69 6e 74 65 72 20 69 66 20 61 6e 20 4f 4f 4d 20  inter if an OOM 
d810: 65 72 72 6f 72 20 69 73 20 65 6e 63 6f 75 6e 74  error is encount
d820: 65 72 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ered..*/.static 
d830: 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 20 2a  UnpackedRecord *
d840: 76 64 62 65 55 6e 70 61 63 6b 52 65 63 6f 72 64  vdbeUnpackRecord
d850: 28 0a 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65  (.  KeyInfo *pKe
d860: 79 49 6e 66 6f 2c 20 0a 20 20 69 6e 74 20 6e 4b  yInfo, .  int nK
d870: 65 79 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69  ey, .  const voi
d880: 64 20 2a 70 4b 65 79 0a 29 7b 0a 20 20 55 6e 70  d *pKey.){.  Unp
d890: 61 63 6b 65 64 52 65 63 6f 72 64 20 2a 70 52 65  ackedRecord *pRe
d8a0: 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  t;           /* 
d8b0: 52 65 74 75 72 6e 20 76 61 6c 75 65 20 2a 2f 0a  Return value */.
d8c0: 0a 20 20 70 52 65 74 20 3d 20 73 71 6c 69 74 65  .  pRet = sqlite
d8d0: 33 56 64 62 65 41 6c 6c 6f 63 55 6e 70 61 63 6b  3VdbeAllocUnpack
d8e0: 65 64 52 65 63 6f 72 64 28 70 4b 65 79 49 6e 66  edRecord(pKeyInf
d8f0: 6f 29 3b 0a 20 20 69 66 28 20 70 52 65 74 20 29  o);.  if( pRet )
d900: 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 52 65  {.    memset(pRe
d910: 74 2d 3e 61 4d 65 6d 2c 20 30 2c 20 73 69 7a 65  t->aMem, 0, size
d920: 6f 66 28 4d 65 6d 29 2a 28 70 4b 65 79 49 6e 66  of(Mem)*(pKeyInf
d930: 6f 2d 3e 6e 4b 65 79 46 69 65 6c 64 2b 31 29 29  o->nKeyField+1))
d940: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  ;.    sqlite3Vdb
d950: 65 52 65 63 6f 72 64 55 6e 70 61 63 6b 28 70 4b  eRecordUnpack(pK
d960: 65 79 49 6e 66 6f 2c 20 6e 4b 65 79 2c 20 70 4b  eyInfo, nKey, pK
d970: 65 79 2c 20 70 52 65 74 29 3b 0a 20 20 7d 0a 20  ey, pRet);.  }. 
d980: 20 72 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a   return pRet;.}.
d990: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
d9a0: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66  tion is called f
d9b0: 72 6f 6d 20 77 69 74 68 69 6e 20 61 20 70 72 65  rom within a pre
d9c0: 2d 75 70 64 61 74 65 20 63 61 6c 6c 62 61 63 6b  -update callback
d9d0: 20 74 6f 20 72 65 74 72 69 65 76 65 0a 2a 2a 20   to retrieve.** 
d9e0: 61 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 72  a field of the r
d9f0: 6f 77 20 63 75 72 72 65 6e 74 6c 79 20 62 65 69  ow currently bei
da00: 6e 67 20 75 70 64 61 74 65 64 20 6f 72 20 64 65  ng updated or de
da10: 6c 65 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71  leted..*/.int sq
da20: 6c 69 74 65 33 5f 70 72 65 75 70 64 61 74 65 5f  lite3_preupdate_
da30: 6f 6c 64 28 73 71 6c 69 74 65 33 20 2a 64 62 2c  old(sqlite3 *db,
da40: 20 69 6e 74 20 69 49 64 78 2c 20 73 71 6c 69 74   int iIdx, sqlit
da50: 65 33 5f 76 61 6c 75 65 20 2a 2a 70 70 56 61 6c  e3_value **ppVal
da60: 75 65 29 7b 0a 20 20 50 72 65 55 70 64 61 74 65  ue){.  PreUpdate
da70: 20 2a 70 20 3d 20 64 62 2d 3e 70 50 72 65 55 70   *p = db->pPreUp
da80: 64 61 74 65 3b 0a 20 20 4d 65 6d 20 2a 70 4d 65  date;.  Mem *pMe
da90: 6d 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  m;.  int rc = SQ
daa0: 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 54  LITE_OK;..  /* T
dab0: 65 73 74 20 74 68 61 74 20 74 68 69 73 20 63 61  est that this ca
dac0: 6c 6c 20 69 73 20 62 65 69 6e 67 20 6d 61 64 65  ll is being made
dad0: 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 61 6e 20   from within an 
dae0: 53 51 4c 49 54 45 5f 44 45 4c 45 54 45 20 6f 72  SQLITE_DELETE or
daf0: 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 55 50 44  .  ** SQLITE_UPD
db00: 41 54 45 20 70 72 65 2d 75 70 64 61 74 65 20 63  ATE pre-update c
db10: 61 6c 6c 62 61 63 6b 2c 20 61 6e 64 20 74 68 61  allback, and tha
db20: 74 20 69 49 64 78 20 69 73 20 77 69 74 68 69 6e  t iIdx is within
db30: 20 72 61 6e 67 65 2e 20 2a 2f 0a 20 20 69 66 28   range. */.  if(
db40: 20 21 70 20 7c 7c 20 70 2d 3e 6f 70 3d 3d 53 51   !p || p->op==SQ
db50: 4c 49 54 45 5f 49 4e 53 45 52 54 20 29 7b 0a 20  LITE_INSERT ){. 
db60: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d     rc = SQLITE_M
db70: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 20 20  ISUSE_BKPT;.    
db80: 67 6f 74 6f 20 70 72 65 75 70 64 61 74 65 5f 6f  goto preupdate_o
db90: 6c 64 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 69 66  ld_out;.  }.  if
dba0: 28 20 70 2d 3e 70 50 6b 20 29 7b 0a 20 20 20 20  ( p->pPk ){.    
dbb0: 69 49 64 78 20 3d 20 73 71 6c 69 74 65 33 54 61  iIdx = sqlite3Ta
dbc0: 62 6c 65 43 6f 6c 75 6d 6e 54 6f 49 6e 64 65 78  bleColumnToIndex
dbd0: 28 70 2d 3e 70 50 6b 2c 20 69 49 64 78 29 3b 0a  (p->pPk, iIdx);.
dbe0: 20 20 7d 0a 20 20 69 66 28 20 69 49 64 78 3e 3d    }.  if( iIdx>=
dbf0: 70 2d 3e 70 43 73 72 2d 3e 6e 46 69 65 6c 64 20  p->pCsr->nField 
dc00: 7c 7c 20 69 49 64 78 3c 30 20 29 7b 0a 20 20 20  || iIdx<0 ){.   
dc10: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 41 4e   rc = SQLITE_RAN
dc20: 47 45 3b 0a 20 20 20 20 67 6f 74 6f 20 70 72 65  GE;.    goto pre
dc30: 75 70 64 61 74 65 5f 6f 6c 64 5f 6f 75 74 3b 0a  update_old_out;.
dc40: 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65    }..  /* If the
dc50: 20 6f 6c 64 2e 2a 20 72 65 63 6f 72 64 20 68 61   old.* record ha
dc60: 73 20 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 6c  s not yet been l
dc70: 6f 61 64 65 64 20 69 6e 74 6f 20 6d 65 6d 6f 72  oaded into memor
dc80: 79 2c 20 64 6f 20 73 6f 20 6e 6f 77 2e 20 2a 2f  y, do so now. */
dc90: 0a 20 20 69 66 28 20 70 2d 3e 70 55 6e 70 61 63  .  if( p->pUnpac
dca0: 6b 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20 75 33  ked==0 ){.    u3
dcb0: 32 20 6e 52 65 63 3b 0a 20 20 20 20 75 38 20 2a  2 nRec;.    u8 *
dcc0: 61 52 65 63 3b 0a 0a 20 20 20 20 6e 52 65 63 20  aRec;..    nRec 
dcd0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 61  = sqlite3BtreePa
dce0: 79 6c 6f 61 64 53 69 7a 65 28 70 2d 3e 70 43 73  yloadSize(p->pCs
dcf0: 72 2d 3e 75 63 2e 70 43 75 72 73 6f 72 29 3b 0a  r->uc.pCursor);.
dd00: 20 20 20 20 61 52 65 63 20 3d 20 73 71 6c 69 74      aRec = sqlit
dd10: 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 64 62  e3DbMallocRaw(db
dd20: 2c 20 6e 52 65 63 29 3b 0a 20 20 20 20 69 66 28  , nRec);.    if(
dd30: 20 21 61 52 65 63 20 29 20 67 6f 74 6f 20 70 72   !aRec ) goto pr
dd40: 65 75 70 64 61 74 65 5f 6f 6c 64 5f 6f 75 74 3b  eupdate_old_out;
dd50: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
dd60: 33 42 74 72 65 65 50 61 79 6c 6f 61 64 28 70 2d  3BtreePayload(p-
dd70: 3e 70 43 73 72 2d 3e 75 63 2e 70 43 75 72 73 6f  >pCsr->uc.pCurso
dd80: 72 2c 20 30 2c 20 6e 52 65 63 2c 20 61 52 65 63  r, 0, nRec, aRec
dd90: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53  );.    if( rc==S
dda0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
ddb0: 20 20 70 2d 3e 70 55 6e 70 61 63 6b 65 64 20 3d    p->pUnpacked =
ddc0: 20 76 64 62 65 55 6e 70 61 63 6b 52 65 63 6f 72   vdbeUnpackRecor
ddd0: 64 28 26 70 2d 3e 6b 65 79 69 6e 66 6f 2c 20 6e  d(&p->keyinfo, n
dde0: 52 65 63 2c 20 61 52 65 63 29 3b 0a 20 20 20 20  Rec, aRec);.    
ddf0: 20 20 69 66 28 20 21 70 2d 3e 70 55 6e 70 61 63    if( !p->pUnpac
de00: 6b 65 64 20 29 20 72 63 20 3d 20 53 51 4c 49 54  ked ) rc = SQLIT
de10: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20  E_NOMEM;.    }. 
de20: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
de30: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71  E_OK ){.      sq
de40: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20  lite3DbFree(db, 
de50: 61 52 65 63 29 3b 0a 20 20 20 20 20 20 67 6f 74  aRec);.      got
de60: 6f 20 70 72 65 75 70 64 61 74 65 5f 6f 6c 64 5f  o preupdate_old_
de70: 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70  out;.    }.    p
de80: 2d 3e 61 52 65 63 6f 72 64 20 3d 20 61 52 65 63  ->aRecord = aRec
de90: 3b 0a 20 20 7d 0a 0a 20 20 70 4d 65 6d 20 3d 20  ;.  }..  pMem = 
dea0: 2a 70 70 56 61 6c 75 65 20 3d 20 26 70 2d 3e 70  *ppValue = &p->p
deb0: 55 6e 70 61 63 6b 65 64 2d 3e 61 4d 65 6d 5b 69  Unpacked->aMem[i
dec0: 49 64 78 5d 3b 0a 20 20 69 66 28 20 69 49 64 78  Idx];.  if( iIdx
ded0: 3d 3d 70 2d 3e 70 54 61 62 2d 3e 69 50 4b 65 79  ==p->pTab->iPKey
dee0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56   ){.    sqlite3V
def0: 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 70  dbeMemSetInt64(p
df00: 4d 65 6d 2c 20 70 2d 3e 69 4b 65 79 31 29 3b 0a  Mem, p->iKey1);.
df10: 20 20 7d 65 6c 73 65 20 69 66 28 20 69 49 64 78    }else if( iIdx
df20: 3e 3d 70 2d 3e 70 55 6e 70 61 63 6b 65 64 2d 3e  >=p->pUnpacked->
df30: 6e 46 69 65 6c 64 20 29 7b 0a 20 20 20 20 2a 70  nField ){.    *p
df40: 70 56 61 6c 75 65 20 3d 20 28 73 71 6c 69 74 65  pValue = (sqlite
df50: 33 5f 76 61 6c 75 65 20 2a 29 63 6f 6c 75 6d 6e  3_value *)column
df60: 4e 75 6c 6c 56 61 6c 75 65 28 29 3b 0a 20 20 7d  NullValue();.  }
df70: 65 6c 73 65 20 69 66 28 20 70 2d 3e 70 54 61 62  else if( p->pTab
df80: 2d 3e 61 43 6f 6c 5b 69 49 64 78 5d 2e 61 66 66  ->aCol[iIdx].aff
df90: 69 6e 69 74 79 3d 3d 53 51 4c 49 54 45 5f 41 46  inity==SQLITE_AF
dfa0: 46 5f 52 45 41 4c 20 29 7b 0a 20 20 20 20 69 66  F_REAL ){.    if
dfb0: 28 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 20  ( pMem->flags & 
dfc0: 28 4d 45 4d 5f 49 6e 74 7c 4d 45 4d 5f 49 6e 74  (MEM_Int|MEM_Int
dfd0: 52 65 61 6c 29 20 29 7b 0a 20 20 20 20 20 20 74  Real) ){.      t
dfe0: 65 73 74 63 61 73 65 28 20 70 4d 65 6d 2d 3e 66  estcase( pMem->f
dff0: 6c 61 67 73 20 26 20 4d 45 4d 5f 49 6e 74 20 29  lags & MEM_Int )
e000: 3b 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 65  ;.      testcase
e010: 28 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 20  ( pMem->flags & 
e020: 4d 45 4d 5f 49 6e 74 52 65 61 6c 20 29 3b 0a 20  MEM_IntReal );. 
e030: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
e040: 4d 65 6d 52 65 61 6c 69 66 79 28 70 4d 65 6d 29  MemRealify(pMem)
e050: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 70 72  ;.    }.  }.. pr
e060: 65 75 70 64 61 74 65 5f 6f 6c 64 5f 6f 75 74 3a  eupdate_old_out:
e070: 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28  .  sqlite3Error(
e080: 64 62 2c 20 72 63 29 3b 0a 20 20 72 65 74 75 72  db, rc);.  retur
e090: 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74  n sqlite3ApiExit
e0a0: 28 64 62 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e 64  (db, rc);.}.#end
e0b0: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41  if /* SQLITE_ENA
e0c0: 42 4c 45 5f 50 52 45 55 50 44 41 54 45 5f 48 4f  BLE_PREUPDATE_HO
e0d0: 4f 4b 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51  OK */..#ifdef SQ
e0e0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 50 52 45 55  LITE_ENABLE_PREU
e0f0: 50 44 41 54 45 5f 48 4f 4f 4b 0a 2f 2a 0a 2a 2a  PDATE_HOOK./*.**
e100: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
e110: 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 77 69  s called from wi
e120: 74 68 69 6e 20 61 20 70 72 65 2d 75 70 64 61 74  thin a pre-updat
e130: 65 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 72 65  e callback to re
e140: 74 72 69 65 76 65 0a 2a 2a 20 74 68 65 20 6e 75  trieve.** the nu
e150: 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20  mber of columns 
e160: 69 6e 20 74 68 65 20 72 6f 77 20 62 65 69 6e 67  in the row being
e170: 20 75 70 64 61 74 65 64 2c 20 64 65 6c 65 74 65   updated, delete
e180: 64 20 6f 72 20 69 6e 73 65 72 74 65 64 2e 0a 2a  d or inserted..*
e190: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72  /.int sqlite3_pr
e1a0: 65 75 70 64 61 74 65 5f 63 6f 75 6e 74 28 73 71  eupdate_count(sq
e1b0: 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 50 72  lite3 *db){.  Pr
e1c0: 65 55 70 64 61 74 65 20 2a 70 20 3d 20 64 62 2d  eUpdate *p = db-
e1d0: 3e 70 50 72 65 55 70 64 61 74 65 3b 0a 20 20 72  >pPreUpdate;.  r
e1e0: 65 74 75 72 6e 20 28 70 20 3f 20 70 2d 3e 6b 65  eturn (p ? p->ke
e1f0: 79 69 6e 66 6f 2e 6e 4b 65 79 46 69 65 6c 64 20  yinfo.nKeyField 
e200: 3a 20 30 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f  : 0);.}.#endif /
e210: 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  * SQLITE_ENABLE_
e220: 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b 20 2a  PREUPDATE_HOOK *
e230: 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  /..#ifdef SQLITE
e240: 5f 45 4e 41 42 4c 45 5f 50 52 45 55 50 44 41 54  _ENABLE_PREUPDAT
e250: 45 5f 48 4f 4f 4b 0a 2f 2a 0a 2a 2a 20 54 68 69  E_HOOK./*.** Thi
e260: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 64 65  s function is de
e270: 73 69 67 6e 65 64 20 74 6f 20 62 65 20 63 61 6c  signed to be cal
e280: 6c 65 64 20 66 72 6f 6d 20 77 69 74 68 69 6e 20  led from within 
e290: 61 20 70 72 65 2d 75 70 64 61 74 65 20 63 61 6c  a pre-update cal
e2a0: 6c 62 61 63 6b 0a 2a 2a 20 6f 6e 6c 79 2e 20 49  lback.** only. I
e2b0: 74 20 72 65 74 75 72 6e 73 20 7a 65 72 6f 20 69  t returns zero i
e2c0: 66 20 74 68 65 20 63 68 61 6e 67 65 20 74 68 61  f the change tha
e2d0: 74 20 63 61 75 73 65 64 20 74 68 65 20 63 61 6c  t caused the cal
e2e0: 6c 62 61 63 6b 20 77 61 73 20 6d 61 64 65 0a 2a  lback was made.*
e2f0: 2a 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 62 79  * immediately by
e300: 20 61 20 75 73 65 72 20 53 51 4c 20 73 74 61 74   a user SQL stat
e310: 65 6d 65 6e 74 2e 20 4f 72 2c 20 69 66 20 74 68  ement. Or, if th
e320: 65 20 63 68 61 6e 67 65 20 77 61 73 20 6d 61 64  e change was mad
e330: 65 20 62 79 20 61 0a 2a 2a 20 74 72 69 67 67 65  e by a.** trigge
e340: 72 20 70 72 6f 67 72 61 6d 2c 20 69 74 20 72 65  r program, it re
e350: 74 75 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72  turns the number
e360: 20 6f 66 20 74 72 69 67 67 65 72 20 70 72 6f 67   of trigger prog
e370: 72 61 6d 73 20 63 75 72 72 65 6e 74 6c 79 0a 2a  rams currently.*
e380: 2a 20 6f 6e 20 74 68 65 20 73 74 61 63 6b 20 28  * on the stack (
e390: 31 20 66 6f 72 20 61 20 74 6f 70 2d 6c 65 76 65  1 for a top-leve
e3a0: 6c 20 74 72 69 67 67 65 72 2c 20 32 20 66 6f 72  l trigger, 2 for
e3b0: 20 61 20 74 72 69 67 67 65 72 20 66 69 72 65 64   a trigger fired
e3c0: 20 62 79 20 61 20 0a 2a 2a 20 74 6f 70 2d 6c 65   by a .** top-le
e3d0: 76 65 6c 20 74 72 69 67 67 65 72 20 65 74 63 2e  vel trigger etc.
e3e0: 29 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 74 68 65  )..**.** For the
e3f0: 20 70 75 72 70 6f 73 65 73 20 6f 66 20 74 68 65   purposes of the
e400: 20 70 72 65 76 69 6f 75 73 20 70 61 72 61 67 72   previous paragr
e410: 61 70 68 2c 20 61 20 66 6f 72 65 69 67 6e 20 6b  aph, a foreign k
e420: 65 79 20 43 41 53 43 41 44 45 2c 20 53 45 54 20  ey CASCADE, SET 
e430: 4e 55 4c 4c 0a 2a 2a 20 6f 72 20 53 45 54 20 44  NULL.** or SET D
e440: 45 46 41 55 4c 54 20 61 63 74 69 6f 6e 20 69 73  EFAULT action is
e450: 20 63 6f 6e 73 69 64 65 72 65 64 20 61 20 74 72   considered a tr
e460: 69 67 67 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71  igger..*/.int sq
e470: 6c 69 74 65 33 5f 70 72 65 75 70 64 61 74 65 5f  lite3_preupdate_
e480: 64 65 70 74 68 28 73 71 6c 69 74 65 33 20 2a 64  depth(sqlite3 *d
e490: 62 29 7b 0a 20 20 50 72 65 55 70 64 61 74 65 20  b){.  PreUpdate 
e4a0: 2a 70 20 3d 20 64 62 2d 3e 70 50 72 65 55 70 64  *p = db->pPreUpd
e4b0: 61 74 65 3b 0a 20 20 72 65 74 75 72 6e 20 28 70  ate;.  return (p
e4c0: 20 3f 20 70 2d 3e 76 2d 3e 6e 46 72 61 6d 65 20   ? p->v->nFrame 
e4d0: 3a 20 30 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f  : 0);.}.#endif /
e4e0: 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  * SQLITE_ENABLE_
e4f0: 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b 20 2a  PREUPDATE_HOOK *
e500: 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  /..#ifdef SQLITE
e510: 5f 45 4e 41 42 4c 45 5f 50 52 45 55 50 44 41 54  _ENABLE_PREUPDAT
e520: 45 5f 48 4f 4f 4b 0a 2f 2a 0a 2a 2a 20 54 68 69  E_HOOK./*.** Thi
e530: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61  s function is ca
e540: 6c 6c 65 64 20 66 72 6f 6d 20 77 69 74 68 69 6e  lled from within
e550: 20 61 20 70 72 65 2d 75 70 64 61 74 65 20 63 61   a pre-update ca
e560: 6c 6c 62 61 63 6b 20 74 6f 20 72 65 74 72 69 65  llback to retrie
e570: 76 65 0a 2a 2a 20 61 20 66 69 65 6c 64 20 6f 66  ve.** a field of
e580: 20 74 68 65 20 72 6f 77 20 63 75 72 72 65 6e 74   the row current
e590: 6c 79 20 62 65 69 6e 67 20 75 70 64 61 74 65 64  ly being updated
e5a0: 20 6f 72 20 69 6e 73 65 72 74 65 64 2e 0a 2a 2f   or inserted..*/
e5b0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65  .int sqlite3_pre
e5c0: 75 70 64 61 74 65 5f 6e 65 77 28 73 71 6c 69 74  update_new(sqlit
e5d0: 65 33 20 2a 64 62 2c 20 69 6e 74 20 69 49 64 78  e3 *db, int iIdx
e5e0: 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20  , sqlite3_value 
e5f0: 2a 2a 70 70 56 61 6c 75 65 29 7b 0a 20 20 50 72  **ppValue){.  Pr
e600: 65 55 70 64 61 74 65 20 2a 70 20 3d 20 64 62 2d  eUpdate *p = db-
e610: 3e 70 50 72 65 55 70 64 61 74 65 3b 0a 20 20 69  >pPreUpdate;.  i
e620: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
e630: 4b 3b 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 3b 0a  K;.  Mem *pMem;.
e640: 0a 20 20 69 66 28 20 21 70 20 7c 7c 20 70 2d 3e  .  if( !p || p->
e650: 6f 70 3d 3d 53 51 4c 49 54 45 5f 44 45 4c 45 54  op==SQLITE_DELET
e660: 45 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51  E ){.    rc = SQ
e670: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54  LITE_MISUSE_BKPT
e680: 3b 0a 20 20 20 20 67 6f 74 6f 20 70 72 65 75 70  ;.    goto preup
e690: 64 61 74 65 5f 6e 65 77 5f 6f 75 74 3b 0a 20 20  date_new_out;.  
e6a0: 7d 0a 20 20 69 66 28 20 70 2d 3e 70 50 6b 20 26  }.  if( p->pPk &
e6b0: 26 20 70 2d 3e 6f 70 21 3d 53 51 4c 49 54 45 5f  & p->op!=SQLITE_
e6c0: 55 50 44 41 54 45 20 29 7b 0a 20 20 20 20 69 49  UPDATE ){.    iI
e6d0: 64 78 20 3d 20 73 71 6c 69 74 65 33 54 61 62 6c  dx = sqlite3Tabl
e6e0: 65 43 6f 6c 75 6d 6e 54 6f 49 6e 64 65 78 28 70  eColumnToIndex(p
e6f0: 2d 3e 70 50 6b 2c 20 69 49 64 78 29 3b 0a 20 20  ->pPk, iIdx);.  
e700: 7d 0a 20 20 69 66 28 20 69 49 64 78 3e 3d 70 2d  }.  if( iIdx>=p-
e710: 3e 70 43 73 72 2d 3e 6e 46 69 65 6c 64 20 7c 7c  >pCsr->nField ||
e720: 20 69 49 64 78 3c 30 20 29 7b 0a 20 20 20 20 72   iIdx<0 ){.    r
e730: 63 20 3d 20 53 51 4c 49 54 45 5f 52 41 4e 47 45  c = SQLITE_RANGE
e740: 3b 0a 20 20 20 20 67 6f 74 6f 20 70 72 65 75 70  ;.    goto preup
e750: 64 61 74 65 5f 6e 65 77 5f 6f 75 74 3b 0a 20 20  date_new_out;.  
e760: 7d 0a 0a 20 20 69 66 28 20 70 2d 3e 6f 70 3d 3d  }..  if( p->op==
e770: 53 51 4c 49 54 45 5f 49 4e 53 45 52 54 20 29 7b  SQLITE_INSERT ){
e780: 0a 20 20 20 20 2f 2a 20 46 6f 72 20 61 6e 20 49  .    /* For an I
e790: 4e 53 45 52 54 2c 20 6d 65 6d 6f 72 79 20 63 65  NSERT, memory ce
e7a0: 6c 6c 20 70 2d 3e 69 4e 65 77 52 65 67 20 63 6f  ll p->iNewReg co
e7b0: 6e 74 61 69 6e 73 20 74 68 65 20 73 65 72 69 61  ntains the seria
e7c0: 6c 69 7a 65 64 20 72 65 63 6f 72 64 0a 20 20 20  lized record.   
e7d0: 20 2a 2a 20 74 68 61 74 20 69 73 20 62 65 69 6e   ** that is bein
e7e0: 67 20 69 6e 73 65 72 74 65 64 2e 20 44 65 73 65  g inserted. Dese
e7f0: 72 69 61 6c 69 7a 65 20 69 74 2e 20 2a 2f 0a 20  rialize it. */. 
e800: 20 20 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72     UnpackedRecor
e810: 64 20 2a 70 55 6e 70 61 63 6b 20 3d 20 70 2d 3e  d *pUnpack = p->
e820: 70 4e 65 77 55 6e 70 61 63 6b 65 64 3b 0a 20 20  pNewUnpacked;.  
e830: 20 20 69 66 28 20 21 70 55 6e 70 61 63 6b 20 29    if( !pUnpack )
e840: 7b 0a 20 20 20 20 20 20 4d 65 6d 20 2a 70 44 61  {.      Mem *pDa
e850: 74 61 20 3d 20 26 70 2d 3e 76 2d 3e 61 4d 65 6d  ta = &p->v->aMem
e860: 5b 70 2d 3e 69 4e 65 77 52 65 67 5d 3b 0a 20 20  [p->iNewReg];.  
e870: 20 20 20 20 72 63 20 3d 20 45 78 70 61 6e 64 42      rc = ExpandB
e880: 6c 6f 62 28 70 44 61 74 61 29 3b 0a 20 20 20 20  lob(pData);.    
e890: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
e8a0: 5f 4f 4b 20 29 20 67 6f 74 6f 20 70 72 65 75 70  _OK ) goto preup
e8b0: 64 61 74 65 5f 6e 65 77 5f 6f 75 74 3b 0a 20 20  date_new_out;.  
e8c0: 20 20 20 20 70 55 6e 70 61 63 6b 20 3d 20 76 64      pUnpack = vd
e8d0: 62 65 55 6e 70 61 63 6b 52 65 63 6f 72 64 28 26  beUnpackRecord(&
e8e0: 70 2d 3e 6b 65 79 69 6e 66 6f 2c 20 70 44 61 74  p->keyinfo, pDat
e8f0: 61 2d 3e 6e 2c 20 70 44 61 74 61 2d 3e 7a 29 3b  a->n, pData->z);
e900: 0a 20 20 20 20 20 20 69 66 28 20 21 70 55 6e 70  .      if( !pUnp
e910: 61 63 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 72  ack ){.        r
e920: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
e930: 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70  ;.        goto p
e940: 72 65 75 70 64 61 74 65 5f 6e 65 77 5f 6f 75 74  reupdate_new_out
e950: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
e960: 70 2d 3e 70 4e 65 77 55 6e 70 61 63 6b 65 64 20  p->pNewUnpacked 
e970: 3d 20 70 55 6e 70 61 63 6b 3b 0a 20 20 20 20 7d  = pUnpack;.    }
e980: 0a 20 20 20 20 70 4d 65 6d 20 3d 20 26 70 55 6e  .    pMem = &pUn
e990: 70 61 63 6b 2d 3e 61 4d 65 6d 5b 69 49 64 78 5d  pack->aMem[iIdx]
e9a0: 3b 0a 20 20 20 20 69 66 28 20 69 49 64 78 3d 3d  ;.    if( iIdx==
e9b0: 70 2d 3e 70 54 61 62 2d 3e 69 50 4b 65 79 20 29  p->pTab->iPKey )
e9c0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  {.      sqlite3V
e9d0: 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 70  dbeMemSetInt64(p
e9e0: 4d 65 6d 2c 20 70 2d 3e 69 4b 65 79 32 29 3b 0a  Mem, p->iKey2);.
e9f0: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 69 49      }else if( iI
ea00: 64 78 3e 3d 70 55 6e 70 61 63 6b 2d 3e 6e 46 69  dx>=pUnpack->nFi
ea10: 65 6c 64 20 29 7b 0a 20 20 20 20 20 20 70 4d 65  eld ){.      pMe
ea20: 6d 20 3d 20 28 73 71 6c 69 74 65 33 5f 76 61 6c  m = (sqlite3_val
ea30: 75 65 20 2a 29 63 6f 6c 75 6d 6e 4e 75 6c 6c 56  ue *)columnNullV
ea40: 61 6c 75 65 28 29 3b 0a 20 20 20 20 7d 0a 20 20  alue();.    }.  
ea50: 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 46 6f  }else{.    /* Fo
ea60: 72 20 61 6e 20 55 50 44 41 54 45 2c 20 6d 65 6d  r an UPDATE, mem
ea70: 6f 72 79 20 63 65 6c 6c 20 28 70 2d 3e 69 4e 65  ory cell (p->iNe
ea80: 77 52 65 67 2b 31 2b 69 49 64 78 29 20 63 6f 6e  wReg+1+iIdx) con
ea90: 74 61 69 6e 73 20 74 68 65 20 72 65 71 75 69 72  tains the requir
eaa0: 65 64 0a 20 20 20 20 2a 2a 20 76 61 6c 75 65 2e  ed.    ** value.
eab0: 20 4d 61 6b 65 20 61 20 63 6f 70 79 20 6f 66 20   Make a copy of 
eac0: 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74  the cell content
ead0: 73 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20 70  s and return a p
eae0: 6f 69 6e 74 65 72 20 74 6f 20 69 74 2e 0a 20 20  ointer to it..  
eaf0: 20 20 2a 2a 20 49 74 20 69 73 20 6e 6f 74 20 73    ** It is not s
eb00: 61 66 65 20 74 6f 20 72 65 74 75 72 6e 20 61 20  afe to return a 
eb10: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6d  pointer to the m
eb20: 65 6d 6f 72 79 20 63 65 6c 6c 20 69 74 73 65 6c  emory cell itsel
eb30: 66 20 61 73 20 74 68 65 0a 20 20 20 20 2a 2a 20  f as the.    ** 
eb40: 63 61 6c 6c 65 72 20 6d 61 79 20 6d 6f 64 69 66  caller may modif
eb50: 79 20 74 68 65 20 76 61 6c 75 65 20 74 65 78 74  y the value text
eb60: 20 65 6e 63 6f 64 69 6e 67 2e 0a 20 20 20 20 2a   encoding..    *
eb70: 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d  /.    assert( p-
eb80: 3e 6f 70 3d 3d 53 51 4c 49 54 45 5f 55 50 44 41  >op==SQLITE_UPDA
eb90: 54 45 20 29 3b 0a 20 20 20 20 69 66 28 20 21 70  TE );.    if( !p
eba0: 2d 3e 61 4e 65 77 20 29 7b 0a 20 20 20 20 20 20  ->aNew ){.      
ebb0: 70 2d 3e 61 4e 65 77 20 3d 20 28 4d 65 6d 20 2a  p->aNew = (Mem *
ebc0: 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63  )sqlite3DbMalloc
ebd0: 5a 65 72 6f 28 64 62 2c 20 73 69 7a 65 6f 66 28  Zero(db, sizeof(
ebe0: 4d 65 6d 29 20 2a 20 70 2d 3e 70 43 73 72 2d 3e  Mem) * p->pCsr->
ebf0: 6e 46 69 65 6c 64 29 3b 0a 20 20 20 20 20 20 69  nField);.      i
ec00: 66 28 20 21 70 2d 3e 61 4e 65 77 20 29 7b 0a 20  f( !p->aNew ){. 
ec10: 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49         rc = SQLI
ec20: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20  TE_NOMEM;.      
ec30: 20 20 67 6f 74 6f 20 70 72 65 75 70 64 61 74 65    goto preupdate
ec40: 5f 6e 65 77 5f 6f 75 74 3b 0a 20 20 20 20 20 20  _new_out;.      
ec50: 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65  }.    }.    asse
ec60: 72 74 28 20 69 49 64 78 3e 3d 30 20 26 26 20 69  rt( iIdx>=0 && i
ec70: 49 64 78 3c 70 2d 3e 70 43 73 72 2d 3e 6e 46 69  Idx<p->pCsr->nFi
ec80: 65 6c 64 20 29 3b 0a 20 20 20 20 70 4d 65 6d 20  eld );.    pMem 
ec90: 3d 20 26 70 2d 3e 61 4e 65 77 5b 69 49 64 78 5d  = &p->aNew[iIdx]
eca0: 3b 0a 20 20 20 20 69 66 28 20 70 4d 65 6d 2d 3e  ;.    if( pMem->
ecb0: 66 6c 61 67 73 3d 3d 30 20 29 7b 0a 20 20 20 20  flags==0 ){.    
ecc0: 20 20 69 66 28 20 69 49 64 78 3d 3d 70 2d 3e 70    if( iIdx==p->p
ecd0: 54 61 62 2d 3e 69 50 4b 65 79 20 29 7b 0a 20 20  Tab->iPKey ){.  
ece0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
ecf0: 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 70 4d 65  eMemSetInt64(pMe
ed00: 6d 2c 20 70 2d 3e 69 4b 65 79 32 29 3b 0a 20 20  m, p->iKey2);.  
ed10: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
ed20: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
ed30: 64 62 65 4d 65 6d 43 6f 70 79 28 70 4d 65 6d 2c  dbeMemCopy(pMem,
ed40: 20 26 70 2d 3e 76 2d 3e 61 4d 65 6d 5b 70 2d 3e   &p->v->aMem[p->
ed50: 69 4e 65 77 52 65 67 2b 31 2b 69 49 64 78 5d 29  iNewReg+1+iIdx])
ed60: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63  ;.        if( rc
ed70: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f  !=SQLITE_OK ) go
ed80: 74 6f 20 70 72 65 75 70 64 61 74 65 5f 6e 65 77  to preupdate_new
ed90: 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20  _out;.      }.  
eda0: 20 20 7d 0a 20 20 7d 0a 20 20 2a 70 70 56 61 6c    }.  }.  *ppVal
edb0: 75 65 20 3d 20 70 4d 65 6d 3b 0a 0a 20 70 72 65  ue = pMem;.. pre
edc0: 75 70 64 61 74 65 5f 6e 65 77 5f 6f 75 74 3a 0a  update_new_out:.
edd0: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64    sqlite3Error(d
ede0: 62 2c 20 72 63 29 3b 0a 20 20 72 65 74 75 72 6e  b, rc);.  return
edf0: 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28   sqlite3ApiExit(
ee00: 64 62 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e 64 69  db, rc);.}.#endi
ee10: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42  f /* SQLITE_ENAB
ee20: 4c 45 5f 50 52 45 55 50 44 41 54 45 5f 48 4f 4f  LE_PREUPDATE_HOO
ee30: 4b 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c  K */..#ifdef SQL
ee40: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 4d 54 5f  ITE_ENABLE_STMT_
ee50: 53 43 41 4e 53 54 41 54 55 53 0a 2f 2a 0a 2a 2a  SCANSTATUS./*.**
ee60: 20 52 65 74 75 72 6e 20 73 74 61 74 75 73 20 64   Return status d
ee70: 61 74 61 20 66 6f 72 20 61 20 73 69 6e 67 6c 65  ata for a single
ee80: 20 6c 6f 6f 70 20 77 69 74 68 69 6e 20 71 75 65   loop within que
ee90: 72 79 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74  ry pStmt..*/.int
eea0: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 5f 73 63   sqlite3_stmt_sc
eeb0: 61 6e 73 74 61 74 75 73 28 0a 20 20 73 71 6c 69  anstatus(.  sqli
eec0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c  te3_stmt *pStmt,
eed0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50              /* P
eee0: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e  repared statemen
eef0: 74 20 62 65 69 6e 67 20 71 75 65 72 69 65 64 20  t being queried 
ef00: 2a 2f 0a 20 20 69 6e 74 20 69 64 78 2c 20 20 20  */.  int idx,   
ef10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ef20: 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66       /* Index of
ef30: 20 6c 6f 6f 70 20 74 6f 20 72 65 70 6f 72 74 20   loop to report 
ef40: 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 69 53 63 61  on */.  int iSca
ef50: 6e 53 74 61 74 75 73 4f 70 2c 20 20 20 20 20 20  nStatusOp,      
ef60: 20 20 20 20 20 20 20 20 2f 2a 20 57 68 69 63 68          /* Which
ef70: 20 6d 65 74 72 69 63 20 74 6f 20 72 65 74 75 72   metric to retur
ef80: 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 4f 75  n */.  void *pOu
ef90: 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t               
efa0: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 57         /* OUT: W
efb0: 72 69 74 65 20 74 68 65 20 61 6e 73 77 65 72 20  rite the answer 
efc0: 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 56 64 62  here */.){.  Vdb
efd0: 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53  e *p = (Vdbe*)pS
efe0: 74 6d 74 3b 0a 20 20 53 63 61 6e 53 74 61 74 75  tmt;.  ScanStatu
eff0: 73 20 2a 70 53 63 61 6e 3b 0a 20 20 69 66 28 20  s *pScan;.  if( 
f000: 69 64 78 3c 30 20 7c 7c 20 69 64 78 3e 3d 70 2d  idx<0 || idx>=p-
f010: 3e 6e 53 63 61 6e 20 29 20 72 65 74 75 72 6e 20  >nScan ) return 
f020: 31 3b 0a 20 20 70 53 63 61 6e 20 3d 20 26 70 2d  1;.  pScan = &p-
f030: 3e 61 53 63 61 6e 5b 69 64 78 5d 3b 0a 20 20 73  >aScan[idx];.  s
f040: 77 69 74 63 68 28 20 69 53 63 61 6e 53 74 61 74  witch( iScanStat
f050: 75 73 4f 70 20 29 7b 0a 20 20 20 20 63 61 73 65  usOp ){.    case
f060: 20 53 51 4c 49 54 45 5f 53 43 41 4e 53 54 41 54   SQLITE_SCANSTAT
f070: 5f 4e 4c 4f 4f 50 3a 20 7b 0a 20 20 20 20 20 20  _NLOOP: {.      
f080: 2a 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 2a  *(sqlite3_int64*
f090: 29 70 4f 75 74 20 3d 20 70 2d 3e 61 6e 45 78 65  )pOut = p->anExe
f0a0: 63 5b 70 53 63 61 6e 2d 3e 61 64 64 72 4c 6f 6f  c[pScan->addrLoo
f0b0: 70 5d 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b  p];.      break;
f0c0: 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20  .    }.    case 
f0d0: 53 51 4c 49 54 45 5f 53 43 41 4e 53 54 41 54 5f  SQLITE_SCANSTAT_
f0e0: 4e 56 49 53 49 54 3a 20 7b 0a 20 20 20 20 20 20  NVISIT: {.      
f0f0: 2a 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 2a  *(sqlite3_int64*
f100: 29 70 4f 75 74 20 3d 20 70 2d 3e 61 6e 45 78 65  )pOut = p->anExe
f110: 63 5b 70 53 63 61 6e 2d 3e 61 64 64 72 56 69 73  c[pScan->addrVis
f120: 69 74 5d 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  it];.      break
f130: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65  ;.    }.    case
f140: 20 53 51 4c 49 54 45 5f 53 43 41 4e 53 54 41 54   SQLITE_SCANSTAT
f150: 5f 45 53 54 3a 20 7b 0a 20 20 20 20 20 20 64 6f  _EST: {.      do
f160: 75 62 6c 65 20 72 20 3d 20 31 2e 30 3b 0a 20 20  uble r = 1.0;.  
f170: 20 20 20 20 4c 6f 67 45 73 74 20 78 20 3d 20 70      LogEst x = p
f180: 53 63 61 6e 2d 3e 6e 45 73 74 3b 0a 20 20 20 20  Scan->nEst;.    
f190: 20 20 77 68 69 6c 65 28 20 78 3c 31 30 30 20 29    while( x<100 )
f1a0: 7b 0a 20 20 20 20 20 20 20 20 78 20 2b 3d 20 31  {.        x += 1
f1b0: 30 3b 0a 20 20 20 20 20 20 20 20 72 20 2a 3d 20  0;.        r *= 
f1c0: 30 2e 35 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  0.5;.      }.   
f1d0: 20 20 20 2a 28 64 6f 75 62 6c 65 2a 29 70 4f 75     *(double*)pOu
f1e0: 74 20 3d 20 72 2a 73 71 6c 69 74 65 33 4c 6f 67  t = r*sqlite3Log
f1f0: 45 73 74 54 6f 49 6e 74 28 78 29 3b 0a 20 20 20  EstToInt(x);.   
f200: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a     break;.    }.
f210: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f      case SQLITE_
f220: 53 43 41 4e 53 54 41 54 5f 4e 41 4d 45 3a 20 7b  SCANSTAT_NAME: {
f230: 0a 20 20 20 20 20 20 2a 28 63 6f 6e 73 74 20 63  .      *(const c
f240: 68 61 72 2a 2a 29 70 4f 75 74 20 3d 20 70 53 63  har**)pOut = pSc
f250: 61 6e 2d 3e 7a 4e 61 6d 65 3b 0a 20 20 20 20 20  an->zName;.     
f260: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20   break;.    }.  
f270: 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43    case SQLITE_SC
f280: 41 4e 53 54 41 54 5f 45 58 50 4c 41 49 4e 3a 20  ANSTAT_EXPLAIN: 
f290: 7b 0a 20 20 20 20 20 20 69 66 28 20 70 53 63 61  {.      if( pSca
f2a0: 6e 2d 3e 61 64 64 72 45 78 70 6c 61 69 6e 20 29  n->addrExplain )
f2b0: 7b 0a 20 20 20 20 20 20 20 20 2a 28 63 6f 6e 73  {.        *(cons
f2c0: 74 20 63 68 61 72 2a 2a 29 70 4f 75 74 20 3d 20  t char**)pOut = 
f2d0: 70 2d 3e 61 4f 70 5b 20 70 53 63 61 6e 2d 3e 61  p->aOp[ pScan->a
f2e0: 64 64 72 45 78 70 6c 61 69 6e 20 5d 2e 70 34 2e  ddrExplain ].p4.
f2f0: 7a 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a  z;.      }else{.
f300: 20 20 20 20 20 20 20 20 2a 28 63 6f 6e 73 74 20          *(const 
f310: 63 68 61 72 2a 2a 29 70 4f 75 74 20 3d 20 30 3b  char**)pOut = 0;
f320: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62  .      }.      b
f330: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  reak;.    }.    
f340: 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43 41 4e  case SQLITE_SCAN
f350: 53 54 41 54 5f 53 45 4c 45 43 54 49 44 3a 20 7b  STAT_SELECTID: {
f360: 0a 20 20 20 20 20 20 69 66 28 20 70 53 63 61 6e  .      if( pScan
f370: 2d 3e 61 64 64 72 45 78 70 6c 61 69 6e 20 29 7b  ->addrExplain ){
f380: 0a 20 20 20 20 20 20 20 20 2a 28 69 6e 74 2a 29  .        *(int*)
f390: 70 4f 75 74 20 3d 20 70 2d 3e 61 4f 70 5b 20 70  pOut = p->aOp[ p
f3a0: 53 63 61 6e 2d 3e 61 64 64 72 45 78 70 6c 61 69  Scan->addrExplai
f3b0: 6e 20 5d 2e 70 31 3b 0a 20 20 20 20 20 20 7d 65  n ].p1;.      }e
f3c0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2a 28 69  lse{.        *(i
f3d0: 6e 74 2a 29 70 4f 75 74 20 3d 20 2d 31 3b 0a 20  nt*)pOut = -1;. 
f3e0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72 65       }.      bre
f3f0: 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65  ak;.    }.    de
f400: 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 72  fault: {.      r
f410: 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d 0a 20  eturn 1;.    }. 
f420: 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d   }.  return 0;.}
f430: 0a 0a 2f 2a 0a 2a 2a 20 5a 65 72 6f 20 61 6c 6c  ../*.** Zero all
f440: 20 63 6f 75 6e 74 65 72 73 20 61 73 73 6f 63 69   counters associ
f450: 61 74 65 64 20 77 69 74 68 20 74 68 65 20 73 71  ated with the sq
f460: 6c 69 74 65 33 5f 73 74 6d 74 5f 73 63 61 6e 73  lite3_stmt_scans
f470: 74 61 74 75 73 28 29 20 64 61 74 61 2e 0a 2a 2f  tatus() data..*/
f480: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 73 74  .void sqlite3_st
f490: 6d 74 5f 73 63 61 6e 73 74 61 74 75 73 5f 72 65  mt_scanstatus_re
f4a0: 73 65 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  set(sqlite3_stmt
f4b0: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65   *pStmt){.  Vdbe
f4c0: 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53 74   *p = (Vdbe*)pSt
f4d0: 6d 74 3b 0a 20 20 6d 65 6d 73 65 74 28 70 2d 3e  mt;.  memset(p->
f4e0: 61 6e 45 78 65 63 2c 20 30 2c 20 70 2d 3e 6e 4f  anExec, 0, p->nO
f4f0: 70 20 2a 20 73 69 7a 65 6f 66 28 69 36 34 29 29  p * sizeof(i64))
f500: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51  ;.}.#endif /* SQ
f510: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 4d 54  LITE_ENABLE_STMT
f520: 5f 53 43 41 4e 53 54 41 54 55 53 20 2a 2f 0a     _SCANSTATUS */.