/ Hex Artifact Content
Login

Artifact f9161e5c77f512fbb80091ce8af621d19c9556bda5e734cffaac1198407400da:


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 33 5f  TE_ENABLE_STAT3_
6a70: 4f 52 5f 53 54 41 54 34 0a 20 20 73 71 6c 69 74  OR_STAT4.  sqlit
6a80: 65 33 5f 69 6e 74 36 34 20 2a 70 69 54 69 6d 65  e3_int64 *piTime
6a90: 20 3d 20 26 70 2d 3e 70 56 64 62 65 2d 3e 69 43   = &p->pVdbe->iC
6aa0: 75 72 72 65 6e 74 54 69 6d 65 3b 0a 20 20 61 73  urrentTime;.  as
6ab0: 73 65 72 74 28 20 70 2d 3e 70 56 64 62 65 21 3d  sert( p->pVdbe!=
6ac0: 30 20 29 3b 0a 23 65 6c 73 65 0a 20 20 73 71 6c  0 );.#else.  sql
6ad0: 69 74 65 33 5f 69 6e 74 36 34 20 69 54 69 6d 65  ite3_int64 iTime
6ae0: 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 33 5f   = 0;.  sqlite3_
6af0: 69 6e 74 36 34 20 2a 70 69 54 69 6d 65 20 3d 20  int64 *piTime = 
6b00: 70 2d 3e 70 56 64 62 65 21 3d 30 20 3f 20 26 70  p->pVdbe!=0 ? &p
6b10: 2d 3e 70 56 64 62 65 2d 3e 69 43 75 72 72 65 6e  ->pVdbe->iCurren
6b20: 74 54 69 6d 65 20 3a 20 26 69 54 69 6d 65 3b 0a  tTime : &iTime;.
6b30: 23 65 6e 64 69 66 0a 20 20 69 66 28 20 2a 70 69  #endif.  if( *pi
6b40: 54 69 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 20 72  Time==0 ){.    r
6b50: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 43 75 72  c = sqlite3OsCur
6b60: 72 65 6e 74 54 69 6d 65 49 6e 74 36 34 28 70 2d  rentTimeInt64(p-
6b70: 3e 70 4f 75 74 2d 3e 64 62 2d 3e 70 56 66 73 2c  >pOut->db->pVfs,
6b80: 20 70 69 54 69 6d 65 29 3b 0a 20 20 20 20 69 66   piTime);.    if
6b90: 28 20 72 63 20 29 20 2a 70 69 54 69 6d 65 20 3d  ( rc ) *piTime =
6ba0: 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e   0;.  }.  return
6bb0: 20 2a 70 69 54 69 6d 65 3b 0a 7d 0a 0a 2f 2a 0a   *piTime;.}../*.
6bc0: 2a 2a 20 43 72 65 61 74 65 20 61 20 6e 65 77 20  ** Create a new 
6bd0: 61 67 67 72 65 67 61 74 65 20 63 6f 6e 74 65 78  aggregate contex
6be0: 74 20 66 6f 72 20 70 20 61 6e 64 20 72 65 74 75  t for p and retu
6bf0: 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 0a  rn a pointer to.
6c00: 2a 2a 20 69 74 73 20 70 4d 65 6d 2d 3e 7a 20 65  ** its pMem->z e
6c10: 6c 65 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69  lement..*/.stati
6c20: 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e  c SQLITE_NOINLIN
6c30: 45 20 76 6f 69 64 20 2a 63 72 65 61 74 65 41 67  E void *createAg
6c40: 67 43 6f 6e 74 65 78 74 28 73 71 6c 69 74 65 33  gContext(sqlite3
6c50: 5f 63 6f 6e 74 65 78 74 20 2a 70 2c 20 69 6e 74  _context *p, int
6c60: 20 6e 42 79 74 65 29 7b 0a 20 20 4d 65 6d 20 2a   nByte){.  Mem *
6c70: 70 4d 65 6d 20 3d 20 70 2d 3e 70 4d 65 6d 3b 0a  pMem = p->pMem;.
6c80: 20 20 61 73 73 65 72 74 28 20 28 70 4d 65 6d 2d    assert( (pMem-
6c90: 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 41 67 67  >flags & MEM_Agg
6ca0: 29 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 6e 42  )==0 );.  if( nB
6cb0: 79 74 65 3c 3d 30 20 29 7b 0a 20 20 20 20 73 71  yte<=0 ){.    sq
6cc0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 4e  lite3VdbeMemSetN
6cd0: 75 6c 6c 28 70 4d 65 6d 29 3b 0a 20 20 20 20 70  ull(pMem);.    p
6ce0: 4d 65 6d 2d 3e 7a 20 3d 20 30 3b 0a 20 20 7d 65  Mem->z = 0;.  }e
6cf0: 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  lse{.    sqlite3
6d00: 56 64 62 65 4d 65 6d 43 6c 65 61 72 41 6e 64 52  VdbeMemClearAndR
6d10: 65 73 69 7a 65 28 70 4d 65 6d 2c 20 6e 42 79 74  esize(pMem, nByt
6d20: 65 29 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  e);.    pMem->fl
6d30: 61 67 73 20 3d 20 4d 45 4d 5f 41 67 67 3b 0a 20  ags = MEM_Agg;. 
6d40: 20 20 20 70 4d 65 6d 2d 3e 75 2e 70 44 65 66 20     pMem->u.pDef 
6d50: 3d 20 70 2d 3e 70 46 75 6e 63 3b 0a 20 20 20 20  = p->pFunc;.    
6d60: 69 66 28 20 70 4d 65 6d 2d 3e 7a 20 29 7b 0a 20  if( pMem->z ){. 
6d70: 20 20 20 20 20 6d 65 6d 73 65 74 28 70 4d 65 6d       memset(pMem
6d80: 2d 3e 7a 2c 20 30 2c 20 6e 42 79 74 65 29 3b 0a  ->z, 0, nByte);.
6d90: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75      }.  }.  retu
6da0: 72 6e 20 28 76 6f 69 64 2a 29 70 4d 65 6d 2d 3e  rn (void*)pMem->
6db0: 7a 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f  z;.}../*.** Allo
6dc0: 63 61 74 65 20 6f 72 20 72 65 74 75 72 6e 20 74  cate or return t
6dd0: 68 65 20 61 67 67 72 65 67 61 74 65 20 63 6f 6e  he aggregate con
6de0: 74 65 78 74 20 66 6f 72 20 61 20 75 73 65 72 20  text for a user 
6df0: 66 75 6e 63 74 69 6f 6e 2e 20 20 41 20 6e 65 77  function.  A new
6e00: 0a 2a 2a 20 63 6f 6e 74 65 78 74 20 69 73 20 61  .** context is a
6e10: 6c 6c 6f 63 61 74 65 64 20 6f 6e 20 74 68 65 20  llocated on the 
6e20: 66 69 72 73 74 20 63 61 6c 6c 2e 20 20 53 75 62  first call.  Sub
6e30: 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 72 65  sequent calls re
6e40: 74 75 72 6e 20 74 68 65 0a 2a 2a 20 73 61 6d 65  turn the.** same
6e50: 20 63 6f 6e 74 65 78 74 20 74 68 61 74 20 77 61   context that wa
6e60: 73 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 70 72  s returned on pr
6e70: 69 6f 72 20 63 61 6c 6c 73 2e 0a 2a 2f 0a 76 6f  ior calls..*/.vo
6e80: 69 64 20 2a 73 71 6c 69 74 65 33 5f 61 67 67 72  id *sqlite3_aggr
6e90: 65 67 61 74 65 5f 63 6f 6e 74 65 78 74 28 73 71  egate_context(sq
6ea0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 2a 70  lite3_context *p
6eb0: 2c 20 69 6e 74 20 6e 42 79 74 65 29 7b 0a 20 20  , int nByte){.  
6ec0: 61 73 73 65 72 74 28 20 70 20 26 26 20 70 2d 3e  assert( p && p->
6ed0: 70 46 75 6e 63 20 26 26 20 70 2d 3e 70 46 75 6e  pFunc && p->pFun
6ee0: 63 2d 3e 78 46 69 6e 61 6c 69 7a 65 20 29 3b 0a  c->xFinalize );.
6ef0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
6f00: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e  3_mutex_held(p->
6f10: 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29  pOut->db->mutex)
6f20: 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20   );.  testcase( 
6f30: 6e 42 79 74 65 3c 30 20 29 3b 0a 20 20 69 66 28  nByte<0 );.  if(
6f40: 20 28 70 2d 3e 70 4d 65 6d 2d 3e 66 6c 61 67 73   (p->pMem->flags
6f50: 20 26 20 4d 45 4d 5f 41 67 67 29 3d 3d 30 20 29   & MEM_Agg)==0 )
6f60: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 63 72 65  {.    return cre
6f70: 61 74 65 41 67 67 43 6f 6e 74 65 78 74 28 70 2c  ateAggContext(p,
6f80: 20 6e 42 79 74 65 29 3b 0a 20 20 7d 65 6c 73 65   nByte);.  }else
6f90: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 76 6f  {.    return (vo
6fa0: 69 64 2a 29 70 2d 3e 70 4d 65 6d 2d 3e 7a 3b 0a  id*)p->pMem->z;.
6fb0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74    }.}../*.** Ret
6fc0: 75 72 6e 20 74 68 65 20 61 75 78 69 6c 69 61 72  urn the auxiliar
6fd0: 79 20 64 61 74 61 20 70 6f 69 6e 74 65 72 2c 20  y data pointer, 
6fe0: 69 66 20 61 6e 79 2c 20 66 6f 72 20 74 68 65 20  if any, for the 
6ff0: 69 41 72 67 27 74 68 20 61 72 67 75 6d 65 6e 74  iArg'th argument
7000: 20 74 6f 0a 2a 2a 20 74 68 65 20 75 73 65 72 2d   to.** the user-
7010: 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 65 64  function defined
7020: 20 62 79 20 70 43 74 78 2e 0a 2a 2a 0a 2a 2a 20   by pCtx..**.** 
7030: 54 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 61 72  The left-most ar
7040: 67 75 6d 65 6e 74 20 69 73 20 30 2e 0a 2a 2a 0a  gument is 0..**.
7050: 2a 2a 20 55 6e 64 6f 63 75 6d 65 6e 74 65 64 20  ** Undocumented 
7060: 62 65 68 61 76 69 6f 72 3a 20 20 49 66 20 69 41  behavior:  If iA
7070: 72 67 20 69 73 20 6e 65 67 61 74 69 76 65 20 74  rg is negative t
7080: 68 65 6e 20 61 63 63 65 73 73 20 61 20 63 61 63  hen access a cac
7090: 68 65 20 6f 66 0a 2a 2a 20 61 75 78 69 6c 69 61  he of.** auxilia
70a0: 72 79 20 64 61 74 61 20 70 6f 69 6e 74 65 72 73  ry data pointers
70b0: 20 74 68 61 74 20 69 73 20 61 76 61 69 6c 61 62   that is availab
70c0: 6c 65 20 74 6f 20 61 6c 6c 20 66 75 6e 63 74 69  le to all functi
70d0: 6f 6e 73 20 77 69 74 68 69 6e 20 61 0a 2a 2a 20  ons within a.** 
70e0: 73 69 6e 67 6c 65 20 70 72 65 70 61 72 65 64 20  single prepared 
70f0: 73 74 61 74 65 6d 65 6e 74 2e 20 20 54 68 65 20  statement.  The 
7100: 69 41 72 67 20 76 61 6c 75 65 73 20 6d 75 73 74  iArg values must
7110: 20 6d 61 74 63 68 2e 0a 2a 2f 0a 76 6f 69 64 20   match..*/.void 
7120: 2a 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 78  *sqlite3_get_aux
7130: 64 61 74 61 28 73 71 6c 69 74 65 33 5f 63 6f 6e  data(sqlite3_con
7140: 74 65 78 74 20 2a 70 43 74 78 2c 20 69 6e 74 20  text *pCtx, int 
7150: 69 41 72 67 29 7b 0a 20 20 41 75 78 44 61 74 61  iArg){.  AuxData
7160: 20 2a 70 41 75 78 44 61 74 61 3b 0a 0a 20 20 61   *pAuxData;..  a
7170: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
7180: 75 74 65 78 5f 68 65 6c 64 28 70 43 74 78 2d 3e  utex_held(pCtx->
7190: 70 4f 75 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29  pOut->db->mutex)
71a0: 20 29 3b 0a 23 69 66 20 53 51 4c 49 54 45 5f 45   );.#if SQLITE_E
71b0: 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53  NABLE_STAT3_OR_S
71c0: 54 41 54 34 0a 20 20 69 66 28 20 70 43 74 78 2d  TAT4.  if( pCtx-
71d0: 3e 70 56 64 62 65 3d 3d 30 20 29 20 72 65 74 75  >pVdbe==0 ) retu
71e0: 72 6e 20 30 3b 0a 23 65 6c 73 65 0a 20 20 61 73  rn 0;.#else.  as
71f0: 73 65 72 74 28 20 70 43 74 78 2d 3e 70 56 64 62  sert( pCtx->pVdb
7200: 65 21 3d 30 20 29 3b 0a 23 65 6e 64 69 66 0a 20  e!=0 );.#endif. 
7210: 20 66 6f 72 28 70 41 75 78 44 61 74 61 3d 70 43   for(pAuxData=pC
7220: 74 78 2d 3e 70 56 64 62 65 2d 3e 70 41 75 78 44  tx->pVdbe->pAuxD
7230: 61 74 61 3b 20 70 41 75 78 44 61 74 61 3b 20 70  ata; pAuxData; p
7240: 41 75 78 44 61 74 61 3d 70 41 75 78 44 61 74 61  AuxData=pAuxData
7250: 2d 3e 70 4e 65 78 74 41 75 78 29 7b 0a 20 20 20  ->pNextAux){.   
7260: 20 69 66 28 20 20 70 41 75 78 44 61 74 61 2d 3e   if(  pAuxData->
7270: 69 41 75 78 41 72 67 3d 3d 69 41 72 67 20 26 26  iAuxArg==iArg &&
7280: 20 28 70 41 75 78 44 61 74 61 2d 3e 69 41 75 78   (pAuxData->iAux
7290: 4f 70 3d 3d 70 43 74 78 2d 3e 69 4f 70 20 7c 7c  Op==pCtx->iOp ||
72a0: 20 69 41 72 67 3c 30 29 20 29 7b 0a 20 20 20 20   iArg<0) ){.    
72b0: 20 20 72 65 74 75 72 6e 20 70 41 75 78 44 61 74    return pAuxDat
72c0: 61 2d 3e 70 41 75 78 3b 0a 20 20 20 20 7d 0a 20  a->pAux;.    }. 
72d0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d   }.  return 0;.}
72e0: 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20  ../*.** Set the 
72f0: 61 75 78 69 6c 69 61 72 79 20 64 61 74 61 20 70  auxiliary data p
7300: 6f 69 6e 74 65 72 20 61 6e 64 20 64 65 6c 65 74  ointer and delet
7310: 65 20 66 75 6e 63 74 69 6f 6e 2c 20 66 6f 72 20  e function, for 
7320: 74 68 65 20 69 41 72 67 27 74 68 0a 2a 2a 20 61  the iArg'th.** a
7330: 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 75  rgument to the u
7340: 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 66  ser-function def
7350: 69 6e 65 64 20 62 79 20 70 43 74 78 2e 20 41 6e  ined by pCtx. An
7360: 79 20 70 72 65 76 69 6f 75 73 20 76 61 6c 75 65  y previous value
7370: 20 69 73 0a 2a 2a 20 64 65 6c 65 74 65 64 20 62   is.** deleted b
7380: 79 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 64 65  y calling the de
7390: 6c 65 74 65 20 66 75 6e 63 74 69 6f 6e 20 73 70  lete function sp
73a0: 65 63 69 66 69 65 64 20 77 68 65 6e 20 69 74 20  ecified when it 
73b0: 77 61 73 20 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 54  was set..**.** T
73c0: 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 61 72 67  he left-most arg
73d0: 75 6d 65 6e 74 20 69 73 20 30 2e 0a 2a 2a 0a 2a  ument is 0..**.*
73e0: 2a 20 55 6e 64 6f 63 75 6d 65 6e 74 65 64 20 62  * Undocumented b
73f0: 65 68 61 76 69 6f 72 3a 20 20 49 66 20 69 41 72  ehavior:  If iAr
7400: 67 20 69 73 20 6e 65 67 61 74 69 76 65 20 74 68  g is negative th
7410: 65 6e 20 6d 61 6b 65 20 74 68 65 20 64 61 74 61  en make the data
7420: 20 61 76 61 69 6c 61 62 6c 65 0a 2a 2a 20 74 6f   available.** to
7430: 20 61 6c 6c 20 66 75 6e 63 74 69 6f 6e 73 20 77   all functions w
7440: 69 74 68 69 6e 20 74 68 65 20 63 75 72 72 65 6e  ithin the curren
7450: 74 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  t prepared state
7460: 6d 65 6e 74 20 75 73 69 6e 67 20 69 41 72 67 20  ment using iArg 
7470: 61 73 20 61 6e 0a 2a 2a 20 61 63 63 65 73 73 20  as an.** access 
7480: 63 6f 64 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  code..*/.void sq
7490: 6c 69 74 65 33 5f 73 65 74 5f 61 75 78 64 61 74  lite3_set_auxdat
74a0: 61 28 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e  a(.  sqlite3_con
74b0: 74 65 78 74 20 2a 70 43 74 78 2c 20 0a 20 20 69  text *pCtx, .  i
74c0: 6e 74 20 69 41 72 67 2c 20 0a 20 20 76 6f 69 64  nt iArg, .  void
74d0: 20 2a 70 41 75 78 2c 20 0a 20 20 76 6f 69 64 20   *pAux, .  void 
74e0: 28 2a 78 44 65 6c 65 74 65 29 28 76 6f 69 64 2a  (*xDelete)(void*
74f0: 29 0a 29 7b 0a 20 20 41 75 78 44 61 74 61 20 2a  ).){.  AuxData *
7500: 70 41 75 78 44 61 74 61 3b 0a 20 20 56 64 62 65  pAuxData;.  Vdbe
7510: 20 2a 70 56 64 62 65 20 3d 20 70 43 74 78 2d 3e   *pVdbe = pCtx->
7520: 70 56 64 62 65 3b 0a 0a 20 20 61 73 73 65 72 74  pVdbe;..  assert
7530: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
7540: 68 65 6c 64 28 70 43 74 78 2d 3e 70 4f 75 74 2d  held(pCtx->pOut-
7550: 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 23  >db->mutex) );.#
7560: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41  ifdef SQLITE_ENA
7570: 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41  BLE_STAT3_OR_STA
7580: 54 34 0a 20 20 69 66 28 20 70 56 64 62 65 3d 3d  T4.  if( pVdbe==
7590: 30 20 29 20 67 6f 74 6f 20 66 61 69 6c 65 64 3b  0 ) goto failed;
75a0: 0a 23 65 6c 73 65 0a 20 20 61 73 73 65 72 74 28  .#else.  assert(
75b0: 20 70 56 64 62 65 21 3d 30 20 29 3b 0a 23 65 6e   pVdbe!=0 );.#en
75c0: 64 69 66 0a 0a 20 20 66 6f 72 28 70 41 75 78 44  dif..  for(pAuxD
75d0: 61 74 61 3d 70 56 64 62 65 2d 3e 70 41 75 78 44  ata=pVdbe->pAuxD
75e0: 61 74 61 3b 20 70 41 75 78 44 61 74 61 3b 20 70  ata; pAuxData; p
75f0: 41 75 78 44 61 74 61 3d 70 41 75 78 44 61 74 61  AuxData=pAuxData
7600: 2d 3e 70 4e 65 78 74 41 75 78 29 7b 0a 20 20 20  ->pNextAux){.   
7610: 20 69 66 28 20 70 41 75 78 44 61 74 61 2d 3e 69   if( pAuxData->i
7620: 41 75 78 41 72 67 3d 3d 69 41 72 67 20 26 26 20  AuxArg==iArg && 
7630: 28 70 41 75 78 44 61 74 61 2d 3e 69 41 75 78 4f  (pAuxData->iAuxO
7640: 70 3d 3d 70 43 74 78 2d 3e 69 4f 70 20 7c 7c 20  p==pCtx->iOp || 
7650: 69 41 72 67 3c 30 29 20 29 7b 0a 20 20 20 20 20  iArg<0) ){.     
7660: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20   break;.    }.  
7670: 7d 0a 20 20 69 66 28 20 70 41 75 78 44 61 74 61  }.  if( pAuxData
7680: 3d 3d 30 20 29 7b 0a 20 20 20 20 70 41 75 78 44  ==0 ){.    pAuxD
7690: 61 74 61 20 3d 20 73 71 6c 69 74 65 33 44 62 4d  ata = sqlite3DbM
76a0: 61 6c 6c 6f 63 5a 65 72 6f 28 70 56 64 62 65 2d  allocZero(pVdbe-
76b0: 3e 64 62 2c 20 73 69 7a 65 6f 66 28 41 75 78 44  >db, sizeof(AuxD
76c0: 61 74 61 29 29 3b 0a 20 20 20 20 69 66 28 20 21  ata));.    if( !
76d0: 70 41 75 78 44 61 74 61 20 29 20 67 6f 74 6f 20  pAuxData ) goto 
76e0: 66 61 69 6c 65 64 3b 0a 20 20 20 20 70 41 75 78  failed;.    pAux
76f0: 44 61 74 61 2d 3e 69 41 75 78 4f 70 20 3d 20 70  Data->iAuxOp = p
7700: 43 74 78 2d 3e 69 4f 70 3b 0a 20 20 20 20 70 41  Ctx->iOp;.    pA
7710: 75 78 44 61 74 61 2d 3e 69 41 75 78 41 72 67 20  uxData->iAuxArg 
7720: 3d 20 69 41 72 67 3b 0a 20 20 20 20 70 41 75 78  = iArg;.    pAux
7730: 44 61 74 61 2d 3e 70 4e 65 78 74 41 75 78 20 3d  Data->pNextAux =
7740: 20 70 56 64 62 65 2d 3e 70 41 75 78 44 61 74 61   pVdbe->pAuxData
7750: 3b 0a 20 20 20 20 70 56 64 62 65 2d 3e 70 41 75  ;.    pVdbe->pAu
7760: 78 44 61 74 61 20 3d 20 70 41 75 78 44 61 74 61  xData = pAuxData
7770: 3b 0a 20 20 20 20 69 66 28 20 70 43 74 78 2d 3e  ;.    if( pCtx->
7780: 69 73 45 72 72 6f 72 3d 3d 30 20 29 20 70 43 74  isError==0 ) pCt
7790: 78 2d 3e 69 73 45 72 72 6f 72 20 3d 20 2d 31 3b  x->isError = -1;
77a0: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 41 75  .  }else if( pAu
77b0: 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65 41 75  xData->xDeleteAu
77c0: 78 20 29 7b 0a 20 20 20 20 70 41 75 78 44 61 74  x ){.    pAuxDat
77d0: 61 2d 3e 78 44 65 6c 65 74 65 41 75 78 28 70 41  a->xDeleteAux(pA
77e0: 75 78 44 61 74 61 2d 3e 70 41 75 78 29 3b 0a 20  uxData->pAux);. 
77f0: 20 7d 0a 0a 20 20 70 41 75 78 44 61 74 61 2d 3e   }..  pAuxData->
7800: 70 41 75 78 20 3d 20 70 41 75 78 3b 0a 20 20 70  pAux = pAux;.  p
7810: 41 75 78 44 61 74 61 2d 3e 78 44 65 6c 65 74 65  AuxData->xDelete
7820: 41 75 78 20 3d 20 78 44 65 6c 65 74 65 3b 0a 20  Aux = xDelete;. 
7830: 20 72 65 74 75 72 6e 3b 0a 0a 66 61 69 6c 65 64   return;..failed
7840: 3a 0a 20 20 69 66 28 20 78 44 65 6c 65 74 65 20  :.  if( xDelete 
7850: 29 7b 0a 20 20 20 20 78 44 65 6c 65 74 65 28 70  ){.    xDelete(p
7860: 41 75 78 29 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66  Aux);.  }.}..#if
7870: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
7880: 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 0a 2a  _DEPRECATED./*.*
7890: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d  * Return the num
78a0: 62 65 72 20 6f 66 20 74 69 6d 65 73 20 74 68 65  ber of times the
78b0: 20 53 74 65 70 20 66 75 6e 63 74 69 6f 6e 20 6f   Step function o
78c0: 66 20 61 6e 20 61 67 67 72 65 67 61 74 65 20 68  f an aggregate h
78d0: 61 73 20 62 65 65 6e 20 0a 2a 2a 20 63 61 6c 6c  as been .** call
78e0: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66  ed..**.** This f
78f0: 75 6e 63 74 69 6f 6e 20 69 73 20 64 65 70 72 65  unction is depre
7900: 63 61 74 65 64 2e 20 20 44 6f 20 6e 6f 74 20 75  cated.  Do not u
7910: 73 65 20 69 74 20 66 6f 72 20 6e 65 77 20 63 6f  se it for new co
7920: 64 65 2e 20 20 49 74 20 69 73 0a 2a 2a 20 70 72  de.  It is.** pr
7930: 6f 76 69 64 65 20 6f 6e 6c 79 20 74 6f 20 61 76  ovide only to av
7940: 6f 69 64 20 62 72 65 61 6b 69 6e 67 20 6c 65 67  oid breaking leg
7950: 61 63 79 20 63 6f 64 65 2e 20 20 4e 65 77 20 61  acy code.  New a
7960: 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f  ggregate functio
7970: 6e 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74  n.** implementat
7980: 69 6f 6e 73 20 73 68 6f 75 6c 64 20 6b 65 65 70  ions should keep
7990: 20 74 68 65 69 72 20 6f 77 6e 20 63 6f 75 6e 74   their own count
79a0: 73 20 77 69 74 68 69 6e 20 74 68 65 69 72 20 61  s within their a
79b0: 67 67 72 65 67 61 74 65 0a 2a 2a 20 63 6f 6e 74  ggregate.** cont
79c0: 65 78 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ext..*/.int sqli
79d0: 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f  te3_aggregate_co
79e0: 75 6e 74 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74  unt(sqlite3_cont
79f0: 65 78 74 20 2a 70 29 7b 0a 20 20 61 73 73 65 72  ext *p){.  asser
7a00: 74 28 20 70 20 26 26 20 70 2d 3e 70 4d 65 6d 20  t( p && p->pMem 
7a10: 26 26 20 70 2d 3e 70 46 75 6e 63 20 26 26 20 70  && p->pFunc && p
7a20: 2d 3e 70 46 75 6e 63 2d 3e 78 46 69 6e 61 6c 69  ->pFunc->xFinali
7a30: 7a 65 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70  ze );.  return p
7a40: 2d 3e 70 4d 65 6d 2d 3e 6e 3b 0a 7d 0a 23 65 6e  ->pMem->n;.}.#en
7a50: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  dif../*.** Retur
7a60: 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  n the number of 
7a70: 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 72  columns in the r
7a80: 65 73 75 6c 74 20 73 65 74 20 66 6f 72 20 74 68  esult set for th
7a90: 65 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d  e statement pStm
7aa0: 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  t..*/.int sqlite
7ab0: 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 73  3_column_count(s
7ac0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
7ad0: 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 56 6d  mt){.  Vdbe *pVm
7ae0: 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74   = (Vdbe *)pStmt
7af0: 3b 0a 20 20 72 65 74 75 72 6e 20 70 56 6d 20 3f  ;.  return pVm ?
7b00: 20 70 56 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e   pVm->nResColumn
7b10: 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52   : 0;.}../*.** R
7b20: 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72  eturn the number
7b30: 20 6f 66 20 76 61 6c 75 65 73 20 61 76 61 69 6c   of values avail
7b40: 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 63 75  able from the cu
7b50: 72 72 65 6e 74 20 72 6f 77 20 6f 66 20 74 68 65  rrent row of the
7b60: 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 65 78  .** currently ex
7b70: 65 63 75 74 69 6e 67 20 73 74 61 74 65 6d 65 6e  ecuting statemen
7b80: 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e 74 20  t pStmt..*/.int 
7b90: 73 71 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f 75  sqlite3_data_cou
7ba0: 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  nt(sqlite3_stmt 
7bb0: 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20  *pStmt){.  Vdbe 
7bc0: 2a 70 56 6d 20 3d 20 28 56 64 62 65 20 2a 29 70  *pVm = (Vdbe *)p
7bd0: 53 74 6d 74 3b 0a 20 20 69 66 28 20 70 56 6d 3d  Stmt;.  if( pVm=
7be0: 3d 30 20 7c 7c 20 70 56 6d 2d 3e 70 52 65 73 75  =0 || pVm->pResu
7bf0: 6c 74 53 65 74 3d 3d 30 20 29 20 72 65 74 75 72  ltSet==0 ) retur
7c00: 6e 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 70 56  n 0;.  return pV
7c10: 6d 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a 7d  m->nResColumn;.}
7c20: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61  ../*.** Return a
7c30: 20 70 6f 69 6e 74 65 72 20 74 6f 20 73 74 61 74   pointer to stat
7c40: 69 63 20 6d 65 6d 6f 72 79 20 63 6f 6e 74 61 69  ic memory contai
7c50: 6e 69 6e 67 20 61 6e 20 53 51 4c 20 4e 55 4c 4c  ning an SQL NULL
7c60: 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74 69   value..*/.stati
7c70: 63 20 63 6f 6e 73 74 20 4d 65 6d 20 2a 63 6f 6c  c const Mem *col
7c80: 75 6d 6e 4e 75 6c 6c 56 61 6c 75 65 28 76 6f 69  umnNullValue(voi
7c90: 64 29 7b 0a 20 20 2f 2a 20 45 76 65 6e 20 74 68  d){.  /* Even th
7ca0: 6f 75 67 68 20 74 68 65 20 4d 65 6d 20 73 74 72  ough the Mem str
7cb0: 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 20  ucture contains 
7cc0: 61 6e 20 65 6c 65 6d 65 6e 74 0a 20 20 2a 2a 20  an element.  ** 
7cd0: 6f 66 20 74 79 70 65 20 69 36 34 2c 20 6f 6e 20  of type i64, on 
7ce0: 63 65 72 74 61 69 6e 20 61 72 63 68 69 74 65 63  certain architec
7cf0: 74 75 72 65 73 20 28 78 38 36 29 20 77 69 74 68  tures (x86) with
7d00: 20 63 65 72 74 61 69 6e 20 63 6f 6d 70 69 6c 65   certain compile
7d10: 72 0a 20 20 2a 2a 20 73 77 69 74 63 68 65 73 20  r.  ** switches 
7d20: 28 2d 4f 73 29 2c 20 67 63 63 20 6d 61 79 20 61  (-Os), gcc may a
7d30: 6c 69 67 6e 20 74 68 69 73 20 4d 65 6d 20 6f 62  lign this Mem ob
7d40: 6a 65 63 74 20 6f 6e 20 61 20 34 2d 62 79 74 65  ject on a 4-byte
7d50: 20 62 6f 75 6e 64 61 72 79 0a 20 20 2a 2a 20 69   boundary.  ** i
7d60: 6e 73 74 65 61 64 20 6f 66 20 61 6e 20 38 2d 62  nstead of an 8-b
7d70: 79 74 65 20 6f 6e 65 2e 20 54 68 69 73 20 61 6c  yte one. This al
7d80: 6c 20 77 6f 72 6b 73 20 66 69 6e 65 2c 20 65 78  l works fine, ex
7d90: 63 65 70 74 20 74 68 61 74 20 77 68 65 6e 0a 20  cept that when. 
7da0: 20 2a 2a 20 72 75 6e 6e 69 6e 67 20 77 69 74 68   ** running with
7db0: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 64 65   SQLITE_DEBUG de
7dc0: 66 69 6e 65 64 20 74 68 65 20 53 51 4c 69 74 65  fined the SQLite
7dd0: 20 63 6f 64 65 20 73 6f 6d 65 74 69 6d 65 73 20   code sometimes 
7de0: 61 73 73 65 72 74 28 29 73 0a 20 20 2a 2a 20 74  assert()s.  ** t
7df0: 68 61 74 20 61 20 4d 65 6d 20 73 74 72 75 63 74  hat a Mem struct
7e00: 75 72 65 20 69 73 20 6c 6f 63 61 74 65 64 20 6f  ure is located o
7e10: 6e 20 61 6e 20 38 2d 62 79 74 65 20 62 6f 75 6e  n an 8-byte boun
7e20: 64 61 72 79 2e 20 54 6f 20 70 72 65 76 65 6e 74  dary. To prevent
7e30: 0a 20 20 2a 2a 20 74 68 65 73 65 20 61 73 73 65  .  ** these asse
7e40: 72 74 28 29 73 20 66 72 6f 6d 20 66 61 69 6c 69  rt()s from faili
7e50: 6e 67 2c 20 77 68 65 6e 20 62 75 69 6c 64 69 6e  ng, when buildin
7e60: 67 20 77 69 74 68 20 53 51 4c 49 54 45 5f 44 45  g with SQLITE_DE
7e70: 42 55 47 20 64 65 66 69 6e 65 64 0a 20 20 2a 2a  BUG defined.  **
7e80: 20 75 73 69 6e 67 20 67 63 63 2c 20 77 65 20 66   using gcc, we f
7e90: 6f 72 63 65 20 6e 75 6c 6c 4d 65 6d 20 74 6f 20  orce nullMem to 
7ea0: 62 65 20 38 2d 62 79 74 65 20 61 6c 69 67 6e 65  be 8-byte aligne
7eb0: 64 20 75 73 69 6e 67 20 74 68 65 20 6d 61 67 69  d using the magi
7ec0: 63 61 6c 0a 20 20 2a 2a 20 5f 5f 61 74 74 72 69  cal.  ** __attri
7ed0: 62 75 74 65 5f 5f 28 28 61 6c 69 67 6e 65 64 28  bute__((aligned(
7ee0: 38 29 29 29 20 6d 61 63 72 6f 2e 20 20 2a 2f 0a  8))) macro.  */.
7ef0: 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 4d    static const M
7f00: 65 6d 20 6e 75 6c 6c 4d 65 6d 20 0a 23 69 66 20  em nullMem .#if 
7f10: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44  defined(SQLITE_D
7f20: 45 42 55 47 29 20 26 26 20 64 65 66 69 6e 65 64  EBUG) && defined
7f30: 28 5f 5f 47 4e 55 43 5f 5f 29 0a 20 20 20 20 5f  (__GNUC__).    _
7f40: 5f 61 74 74 72 69 62 75 74 65 5f 5f 28 28 61 6c  _attribute__((al
7f50: 69 67 6e 65 64 28 38 29 29 29 20 0a 23 65 6e 64  igned(8))) .#end
7f60: 69 66 0a 20 20 20 20 3d 20 7b 0a 20 20 20 20 20  if.    = {.     
7f70: 20 20 20 2f 2a 20 2e 75 20 20 20 20 20 20 20 20     /* .u        
7f80: 20 20 3d 20 2a 2f 20 7b 30 7d 2c 0a 20 20 20 20    = */ {0},.    
7f90: 20 20 20 20 2f 2a 20 2e 66 6c 61 67 73 20 20 20      /* .flags   
7fa0: 20 20 20 3d 20 2a 2f 20 28 75 31 36 29 4d 45 4d     = */ (u16)MEM
7fb0: 5f 4e 75 6c 6c 2c 0a 20 20 20 20 20 20 20 20 2f  _Null,.        /
7fc0: 2a 20 2e 65 6e 63 20 20 20 20 20 20 20 20 3d 20  * .enc        = 
7fd0: 2a 2f 20 28 75 38 29 30 2c 0a 20 20 20 20 20 20  */ (u8)0,.      
7fe0: 20 20 2f 2a 20 2e 65 53 75 62 74 79 70 65 20 20    /* .eSubtype  
7ff0: 20 3d 20 2a 2f 20 28 75 38 29 30 2c 0a 20 20 20   = */ (u8)0,.   
8000: 20 20 20 20 20 2f 2a 20 2e 6e 20 20 20 20 20 20       /* .n      
8010: 20 20 20 20 3d 20 2a 2f 20 28 69 6e 74 29 30 2c      = */ (int)0,
8020: 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 7a 20 20  .        /* .z  
8030: 20 20 20 20 20 20 20 20 3d 20 2a 2f 20 28 63 68          = */ (ch
8040: 61 72 2a 29 30 2c 0a 20 20 20 20 20 20 20 20 2f  ar*)0,.        /
8050: 2a 20 2e 7a 4d 61 6c 6c 6f 63 20 20 20 20 3d 20  * .zMalloc    = 
8060: 2a 2f 20 28 63 68 61 72 2a 29 30 2c 0a 20 20 20  */ (char*)0,.   
8070: 20 20 20 20 20 2f 2a 20 2e 73 7a 4d 61 6c 6c 6f       /* .szMallo
8080: 63 20 20 20 3d 20 2a 2f 20 28 69 6e 74 29 30 2c  c   = */ (int)0,
8090: 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 75 54 65  .        /* .uTe
80a0: 6d 70 20 20 20 20 20 20 3d 20 2a 2f 20 28 75 33  mp      = */ (u3
80b0: 32 29 30 2c 0a 20 20 20 20 20 20 20 20 2f 2a 20  2)0,.        /* 
80c0: 2e 64 62 20 20 20 20 20 20 20 20 20 3d 20 2a 2f  .db         = */
80d0: 20 28 73 71 6c 69 74 65 33 2a 29 30 2c 0a 20 20   (sqlite3*)0,.  
80e0: 20 20 20 20 20 20 2f 2a 20 2e 78 44 65 6c 20 20        /* .xDel  
80f0: 20 20 20 20 20 3d 20 2a 2f 20 28 76 6f 69 64 28       = */ (void(
8100: 2a 29 28 76 6f 69 64 2a 29 29 30 2c 0a 23 69 66  *)(void*))0,.#if
8110: 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47  def SQLITE_DEBUG
8120: 0a 20 20 20 20 20 20 20 20 2f 2a 20 2e 70 53 63  .        /* .pSc
8130: 6f 70 79 46 72 6f 6d 20 3d 20 2a 2f 20 28 4d 65  opyFrom = */ (Me
8140: 6d 2a 29 30 2c 0a 20 20 20 20 20 20 20 20 2f 2a  m*)0,.        /*
8150: 20 2e 6d 53 63 6f 70 79 46 6c 61 67 73 3d 20 2a   .mScopyFlags= *
8160: 2f 20 30 2c 0a 23 65 6e 64 69 66 0a 20 20 20 20  / 0,.#endif.    
8170: 20 20 7d 3b 0a 20 20 72 65 74 75 72 6e 20 26 6e    };.  return &n
8180: 75 6c 6c 4d 65 6d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ullMem;.}../*.**
8190: 20 43 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66   Check to see if
81a0: 20 63 6f 6c 75 6d 6e 20 69 43 6f 6c 20 6f 66 20   column iCol of 
81b0: 74 68 65 20 67 69 76 65 6e 20 73 74 61 74 65 6d  the given statem
81c0: 65 6e 74 20 69 73 20 76 61 6c 69 64 2e 20 20 49  ent is valid.  I
81d0: 66 0a 2a 2a 20 69 74 20 69 73 2c 20 72 65 74 75  f.** it is, retu
81e0: 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  rn a pointer to 
81f0: 74 68 65 20 4d 65 6d 20 66 6f 72 20 74 68 65 20  the Mem for the 
8200: 76 61 6c 75 65 20 6f 66 20 74 68 61 74 20 63 6f  value of that co
8210: 6c 75 6d 6e 2e 0a 2a 2a 20 49 66 20 69 43 6f 6c  lumn..** If iCol
8220: 20 69 73 20 6e 6f 74 20 76 61 6c 69 64 2c 20 72   is not valid, r
8230: 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20  eturn a pointer 
8240: 74 6f 20 61 20 4d 65 6d 20 77 68 69 63 68 20 68  to a Mem which h
8250: 61 73 20 61 20 76 61 6c 75 65 0a 2a 2a 20 6f 66  as a value.** of
8260: 20 4e 55 4c 4c 2e 0a 2a 2f 0a 73 74 61 74 69 63   NULL..*/.static
8270: 20 4d 65 6d 20 2a 63 6f 6c 75 6d 6e 4d 65 6d 28   Mem *columnMem(
8280: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
8290: 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 56  tmt, int i){.  V
82a0: 64 62 65 20 2a 70 56 6d 3b 0a 20 20 4d 65 6d 20  dbe *pVm;.  Mem 
82b0: 2a 70 4f 75 74 3b 0a 0a 20 20 70 56 6d 20 3d 20  *pOut;..  pVm = 
82c0: 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20  (Vdbe *)pStmt;. 
82d0: 20 69 66 28 20 70 56 6d 3d 3d 30 20 29 20 72 65   if( pVm==0 ) re
82e0: 74 75 72 6e 20 28 4d 65 6d 2a 29 63 6f 6c 75 6d  turn (Mem*)colum
82f0: 6e 4e 75 6c 6c 56 61 6c 75 65 28 29 3b 0a 20 20  nNullValue();.  
8300: 61 73 73 65 72 74 28 20 70 56 6d 2d 3e 64 62 20  assert( pVm->db 
8310: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  );.  sqlite3_mut
8320: 65 78 5f 65 6e 74 65 72 28 70 56 6d 2d 3e 64 62  ex_enter(pVm->db
8330: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20  ->mutex);.  if( 
8340: 70 56 6d 2d 3e 70 52 65 73 75 6c 74 53 65 74 21  pVm->pResultSet!
8350: 3d 30 20 26 26 20 69 3c 70 56 6d 2d 3e 6e 52 65  =0 && i<pVm->nRe
8360: 73 43 6f 6c 75 6d 6e 20 26 26 20 69 3e 3d 30 20  sColumn && i>=0 
8370: 29 7b 0a 20 20 20 20 70 4f 75 74 20 3d 20 26 70  ){.    pOut = &p
8380: 56 6d 2d 3e 70 52 65 73 75 6c 74 53 65 74 5b 69  Vm->pResultSet[i
8390: 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  ];.  }else{.    
83a0: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 70 56 6d  sqlite3Error(pVm
83b0: 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f 52 41 4e  ->db, SQLITE_RAN
83c0: 47 45 29 3b 0a 20 20 20 20 70 4f 75 74 20 3d 20  GE);.    pOut = 
83d0: 28 4d 65 6d 2a 29 63 6f 6c 75 6d 6e 4e 75 6c 6c  (Mem*)columnNull
83e0: 56 61 6c 75 65 28 29 3b 0a 20 20 7d 0a 20 20 72  Value();.  }.  r
83f0: 65 74 75 72 6e 20 70 4f 75 74 3b 0a 7d 0a 0a 2f  eturn pOut;.}../
8400: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69  *.** This functi
8410: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 61 66 74  on is called aft
8420: 65 72 20 69 6e 76 6f 6b 69 6e 67 20 61 6e 20 73  er invoking an s
8430: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 58 58 58  qlite3_value_XXX
8440: 20 66 75 6e 63 74 69 6f 6e 20 6f 6e 20 61 20 0a   function on a .
8450: 2a 2a 20 63 6f 6c 75 6d 6e 20 76 61 6c 75 65 20  ** column value 
8460: 28 69 2e 65 2e 20 61 20 76 61 6c 75 65 20 72 65  (i.e. a value re
8470: 74 75 72 6e 65 64 20 62 79 20 65 76 61 6c 75 61  turned by evalua
8480: 74 69 6e 67 20 61 6e 20 53 51 4c 20 65 78 70 72  ting an SQL expr
8490: 65 73 73 69 6f 6e 20 69 6e 20 74 68 65 0a 2a 2a  ession in the.**
84a0: 20 73 65 6c 65 63 74 20 6c 69 73 74 20 6f 66 20   select list of 
84b0: 61 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65  a SELECT stateme
84c0: 6e 74 29 20 74 68 61 74 20 6d 61 79 20 63 61 75  nt) that may cau
84d0: 73 65 20 61 20 6d 61 6c 6c 6f 63 28 29 20 66 61  se a malloc() fa
84e0: 69 6c 75 72 65 2e 20 49 66 20 0a 2a 2a 20 6d 61  ilure. If .** ma
84f0: 6c 6c 6f 63 28 29 20 68 61 73 20 66 61 69 6c 65  lloc() has faile
8500: 64 2c 20 74 68 65 20 74 68 72 65 61 64 73 20 6d  d, the threads m
8510: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67  allocFailed flag
8520: 20 69 73 20 63 6c 65 61 72 65 64 20 61 6e 64 20   is cleared and 
8530: 74 68 65 20 72 65 73 75 6c 74 0a 2a 2a 20 63 6f  the result.** co
8540: 64 65 20 6f 66 20 73 74 61 74 65 6d 65 6e 74 20  de of statement 
8550: 70 53 74 6d 74 20 73 65 74 20 74 6f 20 53 51 4c  pStmt set to SQL
8560: 49 54 45 5f 4e 4f 4d 45 4d 2e 0a 2a 2a 0a 2a 2a  ITE_NOMEM..**.**
8570: 20 53 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 74   Specifically, t
8580: 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 66 72  his is called fr
8590: 6f 6d 20 77 69 74 68 69 6e 3a 0a 2a 2a 0a 2a 2a  om within:.**.**
85a0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c       sqlite3_col
85b0: 75 6d 6e 5f 69 6e 74 28 29 0a 2a 2a 20 20 20 20  umn_int().**    
85c0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
85d0: 69 6e 74 36 34 28 29 0a 2a 2a 20 20 20 20 20 73  int64().**     s
85e0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65  qlite3_column_te
85f0: 78 74 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c 69  xt().**     sqli
8600: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31  te3_column_text1
8610: 36 28 29 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74  6().**     sqlit
8620: 65 33 5f 63 6f 6c 75 6d 6e 5f 72 65 61 6c 28 29  e3_column_real()
8630: 0a 2a 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f  .**     sqlite3_
8640: 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 28 29 0a 2a  column_bytes().*
8650: 2a 20 20 20 20 20 73 71 6c 69 74 65 33 5f 63 6f  *     sqlite3_co
8660: 6c 75 6d 6e 5f 62 79 74 65 73 31 36 28 29 0a 2a  lumn_bytes16().*
8670: 2a 20 20 20 20 20 73 71 69 69 74 65 33 5f 63 6f  *     sqiite3_co
8680: 6c 75 6d 6e 5f 62 6c 6f 62 28 29 0a 2a 2f 0a 73  lumn_blob().*/.s
8690: 74 61 74 69 63 20 76 6f 69 64 20 63 6f 6c 75 6d  tatic void colum
86a0: 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28 73  nMallocFailure(s
86b0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
86c0: 6d 74 29 0a 7b 0a 20 20 2f 2a 20 49 66 20 6d 61  mt).{.  /* If ma
86d0: 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64 20 64 75  lloc() failed du
86e0: 72 69 6e 67 20 61 6e 20 65 6e 63 6f 64 69 6e 67  ring an encoding
86f0: 20 63 6f 6e 76 65 72 73 69 6f 6e 20 77 69 74 68   conversion with
8700: 69 6e 20 61 6e 0a 20 20 2a 2a 20 73 71 6c 69 74  in an.  ** sqlit
8710: 65 33 5f 63 6f 6c 75 6d 6e 5f 58 58 58 20 41 50  e3_column_XXX AP
8720: 49 2c 20 74 68 65 6e 20 73 65 74 20 74 68 65 20  I, then set the 
8730: 72 65 74 75 72 6e 20 63 6f 64 65 20 6f 66 20 74  return code of t
8740: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 6f 0a  he statement to.
8750: 20 20 2a 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45    ** SQLITE_NOME
8760: 4d 2e 20 54 68 65 20 6e 65 78 74 20 63 61 6c 6c  M. The next call
8770: 20 74 6f 20 5f 73 74 65 70 28 29 20 28 69 66 20   to _step() (if 
8780: 61 6e 79 29 20 77 69 6c 6c 20 72 65 74 75 72 6e  any) will return
8790: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 0a 20 20   SQLITE_ERROR.  
87a0: 2a 2a 20 61 6e 64 20 5f 66 69 6e 61 6c 69 7a 65  ** and _finalize
87b0: 28 29 20 77 69 6c 6c 20 72 65 74 75 72 6e 20 4e  () will return N
87c0: 4f 4d 45 4d 2e 0a 20 20 2a 2f 0a 20 20 56 64 62  OMEM..  */.  Vdb
87d0: 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70  e *p = (Vdbe *)p
87e0: 53 74 6d 74 3b 0a 20 20 69 66 28 20 70 20 29 7b  Stmt;.  if( p ){
87f0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
8800: 64 62 21 3d 30 20 29 3b 0a 20 20 20 20 61 73 73  db!=0 );.    ass
8810: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
8820: 65 78 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d  ex_held(p->db->m
8830: 75 74 65 78 29 20 29 3b 0a 20 20 20 20 70 2d 3e  utex) );.    p->
8840: 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45  rc = sqlite3ApiE
8850: 78 69 74 28 70 2d 3e 64 62 2c 20 70 2d 3e 72 63  xit(p->db, p->rc
8860: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  );.    sqlite3_m
8870: 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62  utex_leave(p->db
8880: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 7d 0a  ->mutex);.  }.}.
8890: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ./**************
88a0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 73  ************** s
88b0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 20 20  qlite3_column_  
88c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
88d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a  ***************.
88e0: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ** The following
88f0: 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 75 73   routines are us
8900: 65 64 20 74 6f 20 61 63 63 65 73 73 20 65 6c 65  ed to access ele
8910: 6d 65 6e 74 73 20 6f 66 20 74 68 65 20 63 75 72  ments of the cur
8920: 72 65 6e 74 20 72 6f 77 0a 2a 2a 20 69 6e 20 74  rent row.** in t
8930: 68 65 20 72 65 73 75 6c 74 20 73 65 74 2e 0a 2a  he result set..*
8940: 2f 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71  /.const void *sq
8950: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 6c 6f  lite3_column_blo
8960: 62 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  b(sqlite3_stmt *
8970: 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20  pStmt, int i){. 
8980: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 76 61 6c   const void *val
8990: 3b 0a 20 20 76 61 6c 20 3d 20 73 71 6c 69 74 65  ;.  val = sqlite
89a0: 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 28 20 63 6f  3_value_blob( co
89b0: 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29  lumnMem(pStmt,i)
89c0: 20 29 3b 0a 20 20 2f 2a 20 45 76 65 6e 20 74 68   );.  /* Even th
89d0: 6f 75 67 68 20 74 68 65 72 65 20 69 73 20 6e 6f  ough there is no
89e0: 20 65 6e 63 6f 64 69 6e 67 20 63 6f 6e 76 65 72   encoding conver
89f0: 73 69 6f 6e 2c 20 76 61 6c 75 65 5f 62 6c 6f 62  sion, value_blob
8a00: 28 29 20 6d 69 67 68 74 0a 20 20 2a 2a 20 6e 65  () might.  ** ne
8a10: 65 64 20 74 6f 20 63 61 6c 6c 20 6d 61 6c 6c 6f  ed to call mallo
8a20: 63 28 29 20 74 6f 20 65 78 70 61 6e 64 20 74 68  c() to expand th
8a30: 65 20 72 65 73 75 6c 74 20 6f 66 20 61 20 7a 65  e result of a ze
8a40: 72 6f 62 6c 6f 62 28 29 20 0a 20 20 2a 2a 20 65  roblob() .  ** e
8a50: 78 70 72 65 73 73 69 6f 6e 2e 20 0a 20 20 2a 2f  xpression. .  */
8a60: 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46  .  columnMallocF
8a70: 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20  ailure(pStmt);. 
8a80: 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69   return val;.}.i
8a90: 6e 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  nt sqlite3_colum
8aa0: 6e 5f 62 79 74 65 73 28 73 71 6c 69 74 65 33 5f  n_bytes(sqlite3_
8ab0: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
8ac0: 20 69 29 7b 0a 20 20 69 6e 74 20 76 61 6c 20 3d   i){.  int val =
8ad0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62   sqlite3_value_b
8ae0: 79 74 65 73 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28  ytes( columnMem(
8af0: 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f  pStmt,i) );.  co
8b00: 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72  lumnMallocFailur
8b10: 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75  e(pStmt);.  retu
8b20: 72 6e 20 76 61 6c 3b 0a 7d 0a 69 6e 74 20 73 71  rn val;.}.int sq
8b30: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74  lite3_column_byt
8b40: 65 73 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d  es16(sqlite3_stm
8b50: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29  t *pStmt, int i)
8b60: 7b 0a 20 20 69 6e 74 20 76 61 6c 20 3d 20 73 71  {.  int val = sq
8b70: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65  lite3_value_byte
8b80: 73 31 36 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70  s16( columnMem(p
8b90: 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c  Stmt,i) );.  col
8ba0: 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65  umnMallocFailure
8bb0: 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72  (pStmt);.  retur
8bc0: 6e 20 76 61 6c 3b 0a 7d 0a 64 6f 75 62 6c 65 20  n val;.}.double 
8bd0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64  sqlite3_column_d
8be0: 6f 75 62 6c 65 28 73 71 6c 69 74 65 33 5f 73 74  ouble(sqlite3_st
8bf0: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69  mt *pStmt, int i
8c00: 29 7b 0a 20 20 64 6f 75 62 6c 65 20 76 61 6c 20  ){.  double val 
8c10: 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f  = sqlite3_value_
8c20: 64 6f 75 62 6c 65 28 20 63 6f 6c 75 6d 6e 4d 65  double( columnMe
8c30: 6d 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20  m(pStmt,i) );.  
8c40: 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c  columnMallocFail
8c50: 75 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65  ure(pStmt);.  re
8c60: 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a 69 6e 74 20  turn val;.}.int 
8c70: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69  sqlite3_column_i
8c80: 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  nt(sqlite3_stmt 
8c90: 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29 7b 0a  *pStmt, int i){.
8ca0: 20 20 69 6e 74 20 76 61 6c 20 3d 20 73 71 6c 69    int val = sqli
8cb0: 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 28 20 63  te3_value_int( c
8cc0: 6f 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69  olumnMem(pStmt,i
8cd0: 29 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c  ) );.  columnMal
8ce0: 6c 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74  locFailure(pStmt
8cf0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 76 61 6c 3b  );.  return val;
8d00: 0a 7d 0a 73 71 6c 69 74 65 5f 69 6e 74 36 34 20  .}.sqlite_int64 
8d10: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69  sqlite3_column_i
8d20: 6e 74 36 34 28 73 71 6c 69 74 65 33 5f 73 74 6d  nt64(sqlite3_stm
8d30: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29  t *pStmt, int i)
8d40: 7b 0a 20 20 73 71 6c 69 74 65 5f 69 6e 74 36 34  {.  sqlite_int64
8d50: 20 76 61 6c 20 3d 20 73 71 6c 69 74 65 33 5f 76   val = sqlite3_v
8d60: 61 6c 75 65 5f 69 6e 74 36 34 28 20 63 6f 6c 75  alue_int64( colu
8d70: 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29 20 29  mnMem(pStmt,i) )
8d80: 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63  ;.  columnMalloc
8d90: 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a  Failure(pStmt);.
8da0: 20 20 72 65 74 75 72 6e 20 76 61 6c 3b 0a 7d 0a    return val;.}.
8db0: 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63  const unsigned c
8dc0: 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c  har *sqlite3_col
8dd0: 75 6d 6e 5f 74 65 78 74 28 73 71 6c 69 74 65 33  umn_text(sqlite3
8de0: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
8df0: 74 20 69 29 7b 0a 20 20 63 6f 6e 73 74 20 75 6e  t i){.  const un
8e00: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 76 61 6c  signed char *val
8e10: 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65   = sqlite3_value
8e20: 5f 74 65 78 74 28 20 63 6f 6c 75 6d 6e 4d 65 6d  _text( columnMem
8e30: 28 70 53 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63  (pStmt,i) );.  c
8e40: 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75  olumnMallocFailu
8e50: 72 65 28 70 53 74 6d 74 29 3b 0a 20 20 72 65 74  re(pStmt);.  ret
8e60: 75 72 6e 20 76 61 6c 3b 0a 7d 0a 73 71 6c 69 74  urn val;.}.sqlit
8e70: 65 33 5f 76 61 6c 75 65 20 2a 73 71 6c 69 74 65  e3_value *sqlite
8e80: 33 5f 63 6f 6c 75 6d 6e 5f 76 61 6c 75 65 28 73  3_column_value(s
8e90: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
8ea0: 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 4d 65  mt, int i){.  Me
8eb0: 6d 20 2a 70 4f 75 74 20 3d 20 63 6f 6c 75 6d 6e  m *pOut = column
8ec0: 4d 65 6d 28 70 53 74 6d 74 2c 20 69 29 3b 0a 20  Mem(pStmt, i);. 
8ed0: 20 69 66 28 20 70 4f 75 74 2d 3e 66 6c 61 67 73   if( pOut->flags
8ee0: 26 4d 45 4d 5f 53 74 61 74 69 63 20 29 7b 0a 20  &MEM_Static ){. 
8ef0: 20 20 20 70 4f 75 74 2d 3e 66 6c 61 67 73 20 26     pOut->flags &
8f00: 3d 20 7e 4d 45 4d 5f 53 74 61 74 69 63 3b 0a 20  = ~MEM_Static;. 
8f10: 20 20 20 70 4f 75 74 2d 3e 66 6c 61 67 73 20 7c     pOut->flags |
8f20: 3d 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 20 7d  = MEM_Ephem;.  }
8f30: 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c 6f 63 46  .  columnMallocF
8f40: 61 69 6c 75 72 65 28 70 53 74 6d 74 29 3b 0a 20  ailure(pStmt);. 
8f50: 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33   return (sqlite3
8f60: 5f 76 61 6c 75 65 20 2a 29 70 4f 75 74 3b 0a 7d  _value *)pOut;.}
8f70: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
8f80: 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74  OMIT_UTF16.const
8f90: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63   void *sqlite3_c
8fa0: 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28 73 71 6c  olumn_text16(sql
8fb0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
8fc0: 2c 20 69 6e 74 20 69 29 7b 0a 20 20 63 6f 6e 73  , int i){.  cons
8fd0: 74 20 76 6f 69 64 20 2a 76 61 6c 20 3d 20 73 71  t void *val = sq
8fe0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
8ff0: 31 36 28 20 63 6f 6c 75 6d 6e 4d 65 6d 28 70 53  16( columnMem(pS
9000: 74 6d 74 2c 69 29 20 29 3b 0a 20 20 63 6f 6c 75  tmt,i) );.  colu
9010: 6d 6e 4d 61 6c 6c 6f 63 46 61 69 6c 75 72 65 28  mnMallocFailure(
9020: 70 53 74 6d 74 29 3b 0a 20 20 72 65 74 75 72 6e  pStmt);.  return
9030: 20 76 61 6c 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f   val;.}.#endif /
9040: 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54  * SQLITE_OMIT_UT
9050: 46 31 36 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  F16 */.int sqlit
9060: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 79 70 65 28 73  e3_column_type(s
9070: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
9080: 6d 74 2c 20 69 6e 74 20 69 29 7b 0a 20 20 69 6e  mt, int i){.  in
9090: 74 20 69 54 79 70 65 20 3d 20 73 71 6c 69 74 65  t iType = sqlite
90a0: 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 20 63 6f  3_value_type( co
90b0: 6c 75 6d 6e 4d 65 6d 28 70 53 74 6d 74 2c 69 29  lumnMem(pStmt,i)
90c0: 20 29 3b 0a 20 20 63 6f 6c 75 6d 6e 4d 61 6c 6c   );.  columnMall
90d0: 6f 63 46 61 69 6c 75 72 65 28 70 53 74 6d 74 29  ocFailure(pStmt)
90e0: 3b 0a 20 20 72 65 74 75 72 6e 20 69 54 79 70 65  ;.  return iType
90f0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65  ;.}../*.** Conve
9100: 72 74 20 74 68 65 20 4e 2d 74 68 20 65 6c 65 6d  rt the N-th elem
9110: 65 6e 74 20 6f 66 20 70 53 74 6d 74 2d 3e 70 43  ent of pStmt->pC
9120: 6f 6c 4e 61 6d 65 5b 5d 20 69 6e 74 6f 20 61 20  olName[] into a 
9130: 73 74 72 69 6e 67 20 75 73 69 6e 67 0a 2a 2a 20  string using.** 
9140: 78 46 75 6e 63 28 29 20 74 68 65 6e 20 72 65 74  xFunc() then ret
9150: 75 72 6e 20 74 68 61 74 20 73 74 72 69 6e 67 2e  urn that string.
9160: 20 20 49 66 20 4e 20 69 73 20 6f 75 74 20 6f 66    If N is out of
9170: 20 72 61 6e 67 65 2c 20 72 65 74 75 72 6e 20 30   range, return 0
9180: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 61 72  ..**.** There ar
9190: 65 20 75 70 20 74 6f 20 35 20 6e 61 6d 65 73 20  e up to 5 names 
91a0: 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 2e  for each column.
91b0: 20 20 75 73 65 54 79 70 65 20 64 65 74 65 72 6d    useType determ
91c0: 69 6e 65 73 20 77 68 69 63 68 0a 2a 2a 20 6e 61  ines which.** na
91d0: 6d 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20  me is returned. 
91e0: 20 48 65 72 65 20 61 72 65 20 74 68 65 20 6e 61   Here are the na
91f0: 6d 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 30 20  mes:.**.**    0 
9200: 20 20 20 20 20 54 68 65 20 63 6f 6c 75 6d 6e 20       The column 
9210: 6e 61 6d 65 20 61 73 20 69 74 20 73 68 6f 75 6c  name as it shoul
9220: 64 20 62 65 20 64 69 73 70 6c 61 79 65 64 20 66  d be displayed f
9230: 6f 72 20 6f 75 74 70 75 74 0a 2a 2a 20 20 20 20  or output.**    
9240: 31 20 20 20 20 20 20 54 68 65 20 64 61 74 61 74  1      The datat
9250: 79 70 65 20 6e 61 6d 65 20 66 6f 72 20 74 68 65  ype name for the
9260: 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 20 20 20 32 20   column.**    2 
9270: 20 20 20 20 20 54 68 65 20 6e 61 6d 65 20 6f 66       The name of
9280: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 74 68   the database th
9290: 61 74 20 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65  at the column de
92a0: 72 69 76 65 73 20 66 72 6f 6d 0a 2a 2a 20 20 20  rives from.**   
92b0: 20 33 20 20 20 20 20 20 54 68 65 20 6e 61 6d 65   3      The name
92c0: 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 68   of the table th
92d0: 61 74 20 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65  at the column de
92e0: 72 69 76 65 73 20 66 72 6f 6d 0a 2a 2a 20 20 20  rives from.**   
92f0: 20 34 20 20 20 20 20 20 54 68 65 20 6e 61 6d 65   4      The name
9300: 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 63 6f   of the table co
9310: 6c 75 6d 6e 20 74 68 61 74 20 74 68 65 20 72 65  lumn that the re
9320: 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 64 65 72 69  sult column deri
9330: 76 65 73 20 66 72 6f 6d 0a 2a 2a 0a 2a 2a 20 49  ves from.**.** I
9340: 66 20 74 68 65 20 72 65 73 75 6c 74 20 69 73 20  f the result is 
9350: 6e 6f 74 20 61 20 73 69 6d 70 6c 65 20 63 6f 6c  not a simple col
9360: 75 6d 6e 20 72 65 66 65 72 65 6e 63 65 20 28 69  umn reference (i
9370: 66 20 69 74 20 69 73 20 61 6e 20 65 78 70 72 65  f it is an expre
9380: 73 73 69 6f 6e 0a 2a 2a 20 6f 72 20 61 20 63 6f  ssion.** or a co
9390: 6e 73 74 61 6e 74 29 20 74 68 65 6e 20 75 73 65  nstant) then use
93a0: 54 79 70 65 73 20 32 2c 20 33 2c 20 61 6e 64 20  Types 2, 3, and 
93b0: 34 20 72 65 74 75 72 6e 20 4e 55 4c 4c 2e 0a 2a  4 return NULL..*
93c0: 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 76  /.static const v
93d0: 6f 69 64 20 2a 63 6f 6c 75 6d 6e 4e 61 6d 65 28  oid *columnName(
93e0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
93f0: 2a 70 53 74 6d 74 2c 20 20 20 20 20 2f 2a 20 54  *pStmt,     /* T
9400: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a  he statement */.
9410: 20 20 69 6e 74 20 4e 2c 20 20 20 20 20 20 20 20    int N,        
9420: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 68             /* Wh
9430: 69 63 68 20 63 6f 6c 75 6d 6e 20 74 6f 20 67 65  ich column to ge
9440: 74 20 74 68 65 20 6e 61 6d 65 20 66 6f 72 20 2a  t the name for *
9450: 2f 0a 20 20 69 6e 74 20 75 73 65 55 74 66 31 36  /.  int useUtf16
9460: 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ,            /* 
9470: 54 72 75 65 20 74 6f 20 72 65 74 75 72 6e 20 74  True to return t
9480: 68 65 20 6e 61 6d 65 20 61 73 20 55 54 46 31 36  he name as UTF16
9490: 20 2a 2f 0a 20 20 69 6e 74 20 75 73 65 54 79 70   */.  int useTyp
94a0: 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  e              /
94b0: 2a 20 57 68 61 74 20 74 79 70 65 20 6f 66 20 6e  * What type of n
94c0: 61 6d 65 20 2a 2f 0a 29 7b 0a 20 20 63 6f 6e 73  ame */.){.  cons
94d0: 74 20 76 6f 69 64 20 2a 72 65 74 3b 0a 20 20 56  t void *ret;.  V
94e0: 64 62 65 20 2a 70 3b 0a 20 20 69 6e 74 20 6e 3b  dbe *p;.  int n;
94f0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a  .  sqlite3 *db;.
9500: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e  #ifdef SQLITE_EN
9510: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20  ABLE_API_ARMOR. 
9520: 20 69 66 28 20 70 53 74 6d 74 3d 3d 30 20 29 7b   if( pStmt==0 ){
9530: 0a 20 20 20 20 28 76 6f 69 64 29 53 51 4c 49 54  .    (void)SQLIT
9540: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20  E_MISUSE_BKPT;. 
9550: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d     return 0;.  }
9560: 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 20 3d 20  .#endif.  ret = 
9570: 30 3b 0a 20 20 70 20 3d 20 28 56 64 62 65 20 2a  0;.  p = (Vdbe *
9580: 29 70 53 74 6d 74 3b 0a 20 20 64 62 20 3d 20 70  )pStmt;.  db = p
9590: 2d 3e 64 62 3b 0a 20 20 61 73 73 65 72 74 28 20  ->db;.  assert( 
95a0: 64 62 21 3d 30 20 29 3b 0a 20 20 6e 20 3d 20 73  db!=0 );.  n = s
95b0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f  qlite3_column_co
95c0: 75 6e 74 28 70 53 74 6d 74 29 3b 0a 20 20 69 66  unt(pStmt);.  if
95d0: 28 20 4e 3c 6e 20 26 26 20 4e 3e 3d 30 20 29 7b  ( N<n && N>=0 ){
95e0: 0a 20 20 20 20 4e 20 2b 3d 20 75 73 65 54 79 70  .    N += useTyp
95f0: 65 2a 6e 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  e*n;.    sqlite3
9600: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d  _mutex_enter(db-
9610: 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 61 73 73  >mutex);.    ass
9620: 65 72 74 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46  ert( db->mallocF
9630: 61 69 6c 65 64 3d 3d 30 20 29 3b 0a 23 69 66 6e  ailed==0 );.#ifn
9640: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
9650: 55 54 46 31 36 0a 20 20 20 20 69 66 28 20 75 73  UTF16.    if( us
9660: 65 55 74 66 31 36 20 29 7b 0a 20 20 20 20 20 20  eUtf16 ){.      
9670: 72 65 74 20 3d 20 73 71 6c 69 74 65 33 5f 76 61  ret = sqlite3_va
9680: 6c 75 65 5f 74 65 78 74 31 36 28 28 73 71 6c 69  lue_text16((sqli
9690: 74 65 33 5f 76 61 6c 75 65 2a 29 26 70 2d 3e 61  te3_value*)&p->a
96a0: 43 6f 6c 4e 61 6d 65 5b 4e 5d 29 3b 0a 20 20 20  ColName[N]);.   
96b0: 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20   }else.#endif.  
96c0: 20 20 7b 0a 20 20 20 20 20 20 72 65 74 20 3d 20    {.      ret = 
96d0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
96e0: 78 74 28 28 73 71 6c 69 74 65 33 5f 76 61 6c 75  xt((sqlite3_valu
96f0: 65 2a 29 26 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b  e*)&p->aColName[
9700: 4e 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2f  N]);.    }.    /
9710: 2a 20 41 20 6d 61 6c 6c 6f 63 20 6d 61 79 20 68  * A malloc may h
9720: 61 76 65 20 66 61 69 6c 65 64 20 69 6e 73 69 64  ave failed insid
9730: 65 20 6f 66 20 74 68 65 20 5f 74 65 78 74 28 29  e of the _text()
9740: 20 63 61 6c 6c 2e 20 49 66 20 74 68 69 73 0a 20   call. If this. 
9750: 20 20 20 2a 2a 20 69 73 20 74 68 65 20 63 61 73     ** is the cas
9760: 65 2c 20 63 6c 65 61 72 20 74 68 65 20 6d 61 6c  e, clear the mal
9770: 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 61  locFailed flag a
9780: 6e 64 20 72 65 74 75 72 6e 20 4e 55 4c 4c 2e 0a  nd return NULL..
9790: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 64      */.    if( d
97a0: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20  b->mallocFailed 
97b0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
97c0: 4f 6f 6d 43 6c 65 61 72 28 64 62 29 3b 0a 20 20  OomClear(db);.  
97d0: 20 20 20 20 72 65 74 20 3d 20 30 3b 0a 20 20 20      ret = 0;.   
97e0: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d   }.    sqlite3_m
97f0: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d  utex_leave(db->m
9800: 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20 72 65 74  utex);.  }.  ret
9810: 75 72 6e 20 72 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a  urn ret;.}../*.*
9820: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d  * Return the nam
9830: 65 20 6f 66 20 74 68 65 20 4e 74 68 20 63 6f 6c  e of the Nth col
9840: 75 6d 6e 20 6f 66 20 74 68 65 20 72 65 73 75 6c  umn of the resul
9850: 74 20 73 65 74 20 72 65 74 75 72 6e 65 64 20 62  t set returned b
9860: 79 20 53 51 4c 0a 2a 2a 20 73 74 61 74 65 6d 65  y SQL.** stateme
9870: 6e 74 20 70 53 74 6d 74 2e 0a 2a 2f 0a 63 6f 6e  nt pStmt..*/.con
9880: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33  st char *sqlite3
9890: 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 28 73 71 6c  _column_name(sql
98a0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
98b0: 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65 74 75  , int N){.  retu
98c0: 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53  rn columnName(pS
98d0: 74 6d 74 2c 20 4e 2c 20 30 2c 20 43 4f 4c 4e 41  tmt, N, 0, COLNA
98e0: 4d 45 5f 4e 41 4d 45 29 3b 0a 7d 0a 23 69 66 6e  ME_NAME);.}.#ifn
98f0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
9900: 55 54 46 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64  UTF16.const void
9910: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   *sqlite3_column
9920: 5f 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33 5f  _name16(sqlite3_
9930: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74  stmt *pStmt, int
9940: 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f   N){.  return co
9950: 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20  lumnName(pStmt, 
9960: 4e 2c 20 31 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41  N, 1, COLNAME_NA
9970: 4d 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f  ME);.}.#endif../
9980: 2a 0a 2a 2a 20 43 6f 6e 73 74 72 61 69 6e 74 3a  *.** Constraint:
9990: 20 20 49 66 20 79 6f 75 20 68 61 76 65 20 45 4e    If you have EN
99a0: 41 42 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41  ABLE_COLUMN_META
99b0: 44 41 54 41 20 74 68 65 6e 20 79 6f 75 20 6d 75  DATA then you mu
99c0: 73 74 0a 2a 2a 20 6e 6f 74 20 64 65 66 69 6e 65  st.** not define
99d0: 20 4f 4d 49 54 5f 44 45 43 4c 54 59 50 45 2e 0a   OMIT_DECLTYPE..
99e0: 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53  */.#if defined(S
99f0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43 4c 54  QLITE_OMIT_DECLT
9a00: 59 50 45 29 20 26 26 20 64 65 66 69 6e 65 64 28  YPE) && defined(
9a10: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f  SQLITE_ENABLE_CO
9a20: 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 29 0a 23  LUMN_METADATA).#
9a30: 20 65 72 72 6f 72 20 22 4d 75 73 74 20 6e 6f 74   error "Must not
9a40: 20 64 65 66 69 6e 65 20 62 6f 74 68 20 53 51 4c   define both SQL
9a50: 49 54 45 5f 4f 4d 49 54 5f 44 45 43 4c 54 59 50  ITE_OMIT_DECLTYP
9a60: 45 20 5c 0a 20 20 20 20 20 20 20 20 20 61 6e 64  E \.         and
9a70: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43   SQLITE_ENABLE_C
9a80: 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 22 0a  OLUMN_METADATA".
9a90: 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20  #endif..#ifndef 
9aa0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 43 4c  SQLITE_OMIT_DECL
9ab0: 54 59 50 45 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  TYPE./*.** Retur
9ac0: 6e 20 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65 63  n the column dec
9ad0: 6c 61 72 61 74 69 6f 6e 20 74 79 70 65 20 28 69  laration type (i
9ae0: 66 20 61 70 70 6c 69 63 61 62 6c 65 29 20 6f 66  f applicable) of
9af0: 20 74 68 65 20 27 69 27 74 68 20 63 6f 6c 75 6d   the 'i'th colum
9b00: 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 72 65 73 75  n.** of the resu
9b10: 6c 74 20 73 65 74 20 6f 66 20 53 51 4c 20 73 74  lt set of SQL st
9b20: 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 0a 2a  atement pStmt..*
9b30: 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71  /.const char *sq
9b40: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63  lite3_column_dec
9b50: 6c 74 79 70 65 28 73 71 6c 69 74 65 33 5f 73 74  ltype(sqlite3_st
9b60: 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e  mt *pStmt, int N
9b70: 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75  ){.  return colu
9b80: 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c  mnName(pStmt, N,
9b90: 20 30 2c 20 43 4f 4c 4e 41 4d 45 5f 44 45 43 4c   0, COLNAME_DECL
9ba0: 54 59 50 45 29 3b 0a 7d 0a 23 69 66 6e 64 65 66  TYPE);.}.#ifndef
9bb0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
9bc0: 31 36 0a 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73  16.const void *s
9bd0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65  qlite3_column_de
9be0: 63 6c 74 79 70 65 31 36 28 73 71 6c 69 74 65 33  cltype16(sqlite3
9bf0: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e  _stmt *pStmt, in
9c00: 74 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63  t N){.  return c
9c10: 6f 6c 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c  olumnName(pStmt,
9c20: 20 4e 2c 20 31 2c 20 43 4f 4c 4e 41 4d 45 5f 44   N, 1, COLNAME_D
9c30: 45 43 4c 54 59 50 45 29 3b 0a 7d 0a 23 65 6e 64  ECLTYPE);.}.#end
9c40: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49  if /* SQLITE_OMI
9c50: 54 5f 55 54 46 31 36 20 2a 2f 0a 23 65 6e 64 69  T_UTF16 */.#endi
9c60: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54  f /* SQLITE_OMIT
9c70: 5f 44 45 43 4c 54 59 50 45 20 2a 2f 0a 0a 23 69  _DECLTYPE */..#i
9c80: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42  fdef SQLITE_ENAB
9c90: 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41  LE_COLUMN_METADA
9ca0: 54 41 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  TA./*.** Return 
9cb0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
9cc0: 64 61 74 61 62 61 73 65 20 66 72 6f 6d 20 77 68  database from wh
9cd0: 69 63 68 20 61 20 72 65 73 75 6c 74 20 63 6f 6c  ich a result col
9ce0: 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a 2a 2a 20  umn derives..** 
9cf0: 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64  NULL is returned
9d00: 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 20 63   if the result c
9d10: 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72  olumn is an expr
9d20: 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e 73 74 61  ession or consta
9d30: 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74 68 69 6e  nt or.** anythin
9d40: 67 20 65 6c 73 65 20 77 68 69 63 68 20 69 73 20  g else which is 
9d50: 6e 6f 74 20 61 6e 20 75 6e 61 6d 62 69 67 75 6f  not an unambiguo
9d60: 75 73 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20  us reference to 
9d70: 61 20 64 61 74 61 62 61 73 65 20 63 6f 6c 75 6d  a database colum
9d80: 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72  n..*/.const char
9d90: 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e   *sqlite3_column
9da0: 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 28 73  _database_name(s
9db0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
9dc0: 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72 65  mt, int N){.  re
9dd0: 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65 28  turn columnName(
9de0: 70 53 74 6d 74 2c 20 4e 2c 20 30 2c 20 43 4f 4c  pStmt, N, 0, COL
9df0: 4e 41 4d 45 5f 44 41 54 41 42 41 53 45 29 3b 0a  NAME_DATABASE);.
9e00: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  }.#ifndef SQLITE
9e10: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73  _OMIT_UTF16.cons
9e20: 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f  t void *sqlite3_
9e30: 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f  column_database_
9e40: 6e 61 6d 65 31 36 28 73 71 6c 69 74 65 33 5f 73  name16(sqlite3_s
9e50: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20  tmt *pStmt, int 
9e60: 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c  N){.  return col
9e70: 75 6d 6e 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e  umnName(pStmt, N
9e80: 2c 20 31 2c 20 43 4f 4c 4e 41 4d 45 5f 44 41 54  , 1, COLNAME_DAT
9e90: 41 42 41 53 45 29 3b 0a 7d 0a 23 65 6e 64 69 66  ABASE);.}.#endif
9ea0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f   /* SQLITE_OMIT_
9eb0: 55 54 46 31 36 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  UTF16 */../*.** 
9ec0: 52 65 74 75 72 6e 20 74 68 65 20 6e 61 6d 65 20  Return the name 
9ed0: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 66 72 6f  of the table fro
9ee0: 6d 20 77 68 69 63 68 20 61 20 72 65 73 75 6c 74  m which a result
9ef0: 20 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e   column derives.
9f00: 0a 2a 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74 75  .** NULL is retu
9f10: 72 6e 65 64 20 69 66 20 74 68 65 20 72 65 73 75  rned if the resu
9f20: 6c 74 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20  lt column is an 
9f30: 65 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f  expression or co
9f40: 6e 73 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79  nstant or.** any
9f50: 74 68 69 6e 67 20 65 6c 73 65 20 77 68 69 63 68  thing else which
9f60: 20 69 73 20 6e 6f 74 20 61 6e 20 75 6e 61 6d 62   is not an unamb
9f70: 69 67 75 6f 75 73 20 72 65 66 65 72 65 6e 63 65  iguous reference
9f80: 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 63   to a database c
9f90: 6f 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20  olumn..*/.const 
9fa0: 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f  char *sqlite3_co
9fb0: 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 28  lumn_table_name(
9fc0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
9fd0: 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72  tmt, int N){.  r
9fe0: 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65  eturn columnName
9ff0: 28 70 53 74 6d 74 2c 20 4e 2c 20 30 2c 20 43 4f  (pStmt, N, 0, CO
a000: 4c 4e 41 4d 45 5f 54 41 42 4c 45 29 3b 0a 7d 0a  LNAME_TABLE);.}.
a010: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
a020: 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74 20  MIT_UTF16.const 
a030: 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63 6f  void *sqlite3_co
a040: 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 31  lumn_table_name1
a050: 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  6(sqlite3_stmt *
a060: 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20  pStmt, int N){. 
a070: 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61   return columnNa
a080: 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 31 2c 20  me(pStmt, N, 1, 
a090: 43 4f 4c 4e 41 4d 45 5f 54 41 42 4c 45 29 3b 0a  COLNAME_TABLE);.
a0a0: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  }.#endif /* SQLI
a0b0: 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f  TE_OMIT_UTF16 */
a0c0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
a0d0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74  he name of the t
a0e0: 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 66 72 6f 6d  able column from
a0f0: 20 77 68 69 63 68 20 61 20 72 65 73 75 6c 74 20   which a result 
a100: 63 6f 6c 75 6d 6e 20 64 65 72 69 76 65 73 2e 0a  column derives..
a110: 2a 2a 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72  ** NULL is retur
a120: 6e 65 64 20 69 66 20 74 68 65 20 72 65 73 75 6c  ned if the resul
a130: 74 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65  t column is an e
a140: 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 63 6f 6e  xpression or con
a150: 73 74 61 6e 74 20 6f 72 0a 2a 2a 20 61 6e 79 74  stant or.** anyt
a160: 68 69 6e 67 20 65 6c 73 65 20 77 68 69 63 68 20  hing else which 
a170: 69 73 20 6e 6f 74 20 61 6e 20 75 6e 61 6d 62 69  is not an unambi
a180: 67 75 6f 75 73 20 72 65 66 65 72 65 6e 63 65 20  guous reference 
a190: 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 63 6f  to a database co
a1a0: 6c 75 6d 6e 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63  lumn..*/.const c
a1b0: 68 61 72 20 2a 73 71 6c 69 74 65 33 5f 63 6f 6c  har *sqlite3_col
a1c0: 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 28  umn_origin_name(
a1d0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
a1e0: 74 6d 74 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 72  tmt, int N){.  r
a1f0: 65 74 75 72 6e 20 63 6f 6c 75 6d 6e 4e 61 6d 65  eturn columnName
a200: 28 70 53 74 6d 74 2c 20 4e 2c 20 30 2c 20 43 4f  (pStmt, N, 0, CO
a210: 4c 4e 41 4d 45 5f 43 4f 4c 55 4d 4e 29 3b 0a 7d  LNAME_COLUMN);.}
a220: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
a230: 4f 4d 49 54 5f 55 54 46 31 36 0a 63 6f 6e 73 74  OMIT_UTF16.const
a240: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 63   void *sqlite3_c
a250: 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d  olumn_origin_nam
a260: 65 31 36 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  e16(sqlite3_stmt
a270: 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 4e 29 7b   *pStmt, int N){
a280: 0a 20 20 72 65 74 75 72 6e 20 63 6f 6c 75 6d 6e  .  return column
a290: 4e 61 6d 65 28 70 53 74 6d 74 2c 20 4e 2c 20 31  Name(pStmt, N, 1
a2a0: 2c 20 43 4f 4c 4e 41 4d 45 5f 43 4f 4c 55 4d 4e  , COLNAME_COLUMN
a2b0: 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53  );.}.#endif /* S
a2c0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36  QLITE_OMIT_UTF16
a2d0: 20 2a 2f 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51   */.#endif /* SQ
a2e0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 4c 55  LITE_ENABLE_COLU
a2f0: 4d 4e 5f 4d 45 54 41 44 41 54 41 20 2a 2f 0a 0a  MN_METADATA */..
a300: 0a 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ./**************
a310: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
a320: 2a 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 20  * sqlite3_bind_ 
a330: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a   ***************
a340: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 20  ************.** 
a350: 0a 2a 2a 20 52 6f 75 74 69 6e 65 73 20 75 73 65  .** Routines use
a360: 64 20 74 6f 20 61 74 74 61 63 68 20 76 61 6c 75  d to attach valu
a370: 65 73 20 74 6f 20 77 69 6c 64 63 61 72 64 73 20  es to wildcards 
a380: 69 6e 20 61 20 63 6f 6d 70 69 6c 65 64 20 53 51  in a compiled SQ
a390: 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a  L statement..*/.
a3a0: 2f 2a 0a 2a 2a 20 55 6e 62 69 6e 64 20 74 68 65  /*.** Unbind the
a3b0: 20 76 61 6c 75 65 20 62 6f 75 6e 64 20 74 6f 20   value bound to 
a3c0: 76 61 72 69 61 62 6c 65 20 69 20 69 6e 20 76 69  variable i in vi
a3d0: 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 70 2e  rtual machine p.
a3e0: 20 54 68 69 73 20 69 73 20 74 68 65 20 0a 2a 2a   This is the .**
a3f0: 20 74 68 65 20 73 61 6d 65 20 61 73 20 62 69 6e   the same as bin
a400: 64 69 6e 67 20 61 20 4e 55 4c 4c 20 76 61 6c 75  ding a NULL valu
a410: 65 20 74 6f 20 74 68 65 20 63 6f 6c 75 6d 6e 2e  e to the column.
a420: 20 49 66 20 74 68 65 20 22 69 22 20 70 61 72 61   If the "i" para
a430: 6d 65 74 65 72 20 69 73 0a 2a 2a 20 6f 75 74 20  meter is.** out 
a440: 6f 66 20 72 61 6e 67 65 2c 20 74 68 65 6e 20 53  of range, then S
a450: 51 4c 49 54 45 5f 52 41 4e 47 45 20 69 73 20 72  QLITE_RANGE is r
a460: 65 74 75 72 6e 65 64 2e 20 4f 74 68 65 77 69 73  eturned. Othewis
a470: 65 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a  e SQLITE_OK..**.
a480: 2a 2a 20 41 20 73 75 63 63 65 73 73 66 75 6c 20  ** A successful 
a490: 65 76 61 6c 75 61 74 69 6f 6e 20 6f 66 20 74 68  evaluation of th
a4a0: 69 73 20 72 6f 75 74 69 6e 65 20 61 63 71 75 69  is routine acqui
a4b0: 72 65 73 20 74 68 65 20 6d 75 74 65 78 20 6f 6e  res the mutex on
a4c0: 20 70 2e 0a 2a 2a 20 74 68 65 20 6d 75 74 65 78   p..** the mutex
a4d0: 20 69 73 20 72 65 6c 65 61 73 65 64 20 69 66 20   is released if 
a4e0: 61 6e 79 20 6b 69 6e 64 20 6f 66 20 65 72 72 6f  any kind of erro
a4f0: 72 20 6f 63 63 75 72 73 2e 0a 2a 2a 0a 2a 2a 20  r occurs..**.** 
a500: 54 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 73  The error code s
a510: 74 6f 72 65 64 20 69 6e 20 64 61 74 61 62 61 73  tored in databas
a520: 65 20 70 2d 3e 64 62 20 69 73 20 6f 76 65 72 77  e p->db is overw
a530: 72 69 74 74 65 6e 20 77 69 74 68 20 74 68 65 20  ritten with the 
a540: 72 65 74 75 72 6e 0a 2a 2a 20 76 61 6c 75 65 20  return.** value 
a550: 69 6e 20 61 6e 79 20 63 61 73 65 2e 0a 2a 2f 0a  in any case..*/.
a560: 73 74 61 74 69 63 20 69 6e 74 20 76 64 62 65 55  static int vdbeU
a570: 6e 62 69 6e 64 28 56 64 62 65 20 2a 70 2c 20 69  nbind(Vdbe *p, i
a580: 6e 74 20 69 29 7b 0a 20 20 4d 65 6d 20 2a 70 56  nt i){.  Mem *pV
a590: 61 72 3b 0a 20 20 69 66 28 20 76 64 62 65 53 61  ar;.  if( vdbeSa
a5a0: 66 65 74 79 4e 6f 74 4e 75 6c 6c 28 70 29 20 29  fetyNotNull(p) )
a5b0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
a5c0: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b  ITE_MISUSE_BKPT;
a5d0: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d  .  }.  sqlite3_m
a5e0: 75 74 65 78 5f 65 6e 74 65 72 28 70 2d 3e 64 62  utex_enter(p->db
a5f0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20  ->mutex);.  if( 
a600: 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d  p->magic!=VDBE_M
a610: 41 47 49 43 5f 52 55 4e 20 7c 7c 20 70 2d 3e 70  AGIC_RUN || p->p
a620: 63 3e 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69  c>=0 ){.    sqli
a630: 74 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20  te3Error(p->db, 
a640: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 29 3b 0a  SQLITE_MISUSE);.
a650: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
a660: 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d 3e 6d  x_leave(p->db->m
a670: 75 74 65 78 29 3b 0a 20 20 20 20 73 71 6c 69 74  utex);.    sqlit
a680: 65 33 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 4d 49  e3_log(SQLITE_MI
a690: 53 55 53 45 2c 20 0a 20 20 20 20 20 20 20 20 22  SUSE, .        "
a6a0: 62 69 6e 64 20 6f 6e 20 61 20 62 75 73 79 20 70  bind on a busy p
a6b0: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e  repared statemen
a6c0: 74 3a 20 5b 25 73 5d 22 2c 20 70 2d 3e 7a 53 71  t: [%s]", p->zSq
a6d0: 6c 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53  l);.    return S
a6e0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50  QLITE_MISUSE_BKP
a6f0: 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 3c 31  T;.  }.  if( i<1
a700: 20 7c 7c 20 69 3e 70 2d 3e 6e 56 61 72 20 29 7b   || i>p->nVar ){
a710: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f  .    sqlite3Erro
a720: 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49 54 45 5f  r(p->db, SQLITE_
a730: 52 41 4e 47 45 29 3b 0a 20 20 20 20 73 71 6c 69  RANGE);.    sqli
a740: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
a750: 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  p->db->mutex);. 
a760: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
a770: 5f 52 41 4e 47 45 3b 0a 20 20 7d 0a 20 20 69 2d  _RANGE;.  }.  i-
a780: 2d 3b 0a 20 20 70 56 61 72 20 3d 20 26 70 2d 3e  -;.  pVar = &p->
a790: 61 56 61 72 5b 69 5d 3b 0a 20 20 73 71 6c 69 74  aVar[i];.  sqlit
a7a0: 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65  e3VdbeMemRelease
a7b0: 28 70 56 61 72 29 3b 0a 20 20 70 56 61 72 2d 3e  (pVar);.  pVar->
a7c0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c  flags = MEM_Null
a7d0: 3b 0a 20 20 70 2d 3e 64 62 2d 3e 65 72 72 43 6f  ;.  p->db->errCo
a7e0: 64 65 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  de = SQLITE_OK;.
a7f0: 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 62 69 74  .  /* If the bit
a800: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74   corresponding t
a810: 6f 20 74 68 69 73 20 76 61 72 69 61 62 6c 65 20  o this variable 
a820: 69 6e 20 56 64 62 65 2e 65 78 70 6d 61 73 6b 20  in Vdbe.expmask 
a830: 69 73 20 73 65 74 2c 20 74 68 65 6e 20 0a 20 20  is set, then .  
a840: 2a 2a 20 62 69 6e 64 69 6e 67 20 61 20 6e 65 77  ** binding a new
a850: 20 76 61 6c 75 65 20 74 6f 20 74 68 69 73 20 76   value to this v
a860: 61 72 69 61 62 6c 65 20 69 6e 76 61 6c 69 64 61  ariable invalida
a870: 74 65 73 20 74 68 65 20 63 75 72 72 65 6e 74 20  tes the current 
a880: 71 75 65 72 79 20 70 6c 61 6e 2e 0a 20 20 2a 2a  query plan..  **
a890: 0a 20 20 2a 2a 20 49 4d 50 4c 45 4d 45 4e 54 41  .  ** IMPLEMENTA
a8a0: 54 49 4f 4e 2d 4f 46 3a 20 52 2d 34 38 34 34 30  TION-OF: R-48440
a8b0: 2d 33 37 35 39 35 20 49 66 20 74 68 65 20 73 70  -37595 If the sp
a8c0: 65 63 69 66 69 63 20 76 61 6c 75 65 20 62 6f 75  ecific value bou
a8d0: 6e 64 20 74 6f 20 68 6f 73 74 0a 20 20 2a 2a 20  nd to host.  ** 
a8e0: 70 61 72 61 6d 65 74 65 72 20 69 6e 20 74 68 65  parameter in the
a8f0: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 6d 69   WHERE clause mi
a900: 67 68 74 20 69 6e 66 6c 75 65 6e 63 65 20 74 68  ght influence th
a910: 65 20 63 68 6f 69 63 65 20 6f 66 20 71 75 65 72  e choice of quer
a920: 79 20 70 6c 61 6e 0a 20 20 2a 2a 20 66 6f 72 20  y plan.  ** for 
a930: 61 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65  a statement, the
a940: 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20  n the statement 
a950: 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69  will be automati
a960: 63 61 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65 64  cally recompiled
a970: 2c 0a 20 20 2a 2a 20 61 73 20 69 66 20 74 68 65  ,.  ** as if the
a980: 72 65 20 68 61 64 20 62 65 65 6e 20 61 20 73 63  re had been a sc
a990: 68 65 6d 61 20 63 68 61 6e 67 65 2c 20 6f 6e 20  hema change, on 
a9a0: 74 68 65 20 66 69 72 73 74 20 73 71 6c 69 74 65  the first sqlite
a9b0: 33 5f 73 74 65 70 28 29 20 63 61 6c 6c 0a 20 20  3_step() call.  
a9c0: 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 6e 79  ** following any
a9d0: 20 63 68 61 6e 67 65 20 74 6f 20 74 68 65 20 62   change to the b
a9e0: 69 6e 64 69 6e 67 73 20 6f 66 20 74 68 61 74 20  indings of that 
a9f0: 70 61 72 61 6d 65 74 65 72 2e 0a 20 20 2a 2f 0a  parameter..  */.
aa00: 20 20 61 73 73 65 72 74 28 20 28 70 2d 3e 70 72    assert( (p->pr
aa10: 65 70 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45  epFlags & SQLITE
aa20: 5f 50 52 45 50 41 52 45 5f 53 41 56 45 53 51 4c  _PREPARE_SAVESQL
aa30: 29 21 3d 30 20 7c 7c 20 70 2d 3e 65 78 70 6d 61  )!=0 || p->expma
aa40: 73 6b 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70  sk==0 );.  if( p
aa50: 2d 3e 65 78 70 6d 61 73 6b 21 3d 30 20 26 26 20  ->expmask!=0 && 
aa60: 28 70 2d 3e 65 78 70 6d 61 73 6b 20 26 20 28 69  (p->expmask & (i
aa70: 3e 3d 33 31 20 3f 20 30 78 38 30 30 30 30 30 30  >=31 ? 0x8000000
aa80: 30 20 3a 20 28 75 33 32 29 31 3c 3c 69 29 29 21  0 : (u32)1<<i))!
aa90: 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e 65 78 70  =0 ){.    p->exp
aaa0: 69 72 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20  ired = 1;.  }.  
aab0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
aac0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 42 69 6e 64 20  ;.}../*.** Bind 
aad0: 61 20 74 65 78 74 20 6f 72 20 42 4c 4f 42 20 76  a text or BLOB v
aae0: 61 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  alue..*/.static 
aaf0: 69 6e 74 20 62 69 6e 64 54 65 78 74 28 0a 20 20  int bindText(.  
ab00: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
ab10: 74 6d 74 2c 20 20 20 2f 2a 20 54 68 65 20 73 74  tmt,   /* The st
ab20: 61 74 65 6d 65 6e 74 20 74 6f 20 62 69 6e 64 20  atement to bind 
ab30: 61 67 61 69 6e 73 74 20 2a 2f 0a 20 20 69 6e 74  against */.  int
ab40: 20 69 2c 20 20 20 20 20 20 20 20 20 20 20 20 20   i,             
ab50: 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20      /* Index of 
ab60: 74 68 65 20 70 61 72 61 6d 65 74 65 72 20 74 6f  the parameter to
ab70: 20 62 69 6e 64 20 2a 2f 0a 20 20 63 6f 6e 73 74   bind */.  const
ab80: 20 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20 20 20   void *zData,   
ab90: 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20    /* Pointer to 
aba0: 74 68 65 20 64 61 74 61 20 74 6f 20 62 65 20 62  the data to be b
abb0: 6f 75 6e 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 44  ound */.  int nD
abc0: 61 74 61 2c 20 20 20 20 20 20 20 20 20 20 20 20  ata,            
abd0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79   /* Number of by
abe0: 74 65 73 20 6f 66 20 64 61 74 61 20 74 6f 20 62  tes of data to b
abf0: 65 20 62 6f 75 6e 64 20 2a 2f 0a 20 20 76 6f 69  e bound */.  voi
ac00: 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29  d (*xDel)(void*)
ac10: 2c 20 20 20 2f 2a 20 44 65 73 74 72 75 63 74 6f  ,   /* Destructo
ac20: 72 20 66 6f 72 20 74 68 65 20 64 61 74 61 20 2a  r for the data *
ac30: 2f 0a 20 20 75 38 20 65 6e 63 6f 64 69 6e 67 20  /.  u8 encoding 
ac40: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 6e             /* En
ac50: 63 6f 64 69 6e 67 20 66 6f 72 20 74 68 65 20 64  coding for the d
ac60: 61 74 61 20 2a 2f 0a 29 7b 0a 20 20 56 64 62 65  ata */.){.  Vdbe
ac70: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53   *p = (Vdbe *)pS
ac80: 74 6d 74 3b 0a 20 20 4d 65 6d 20 2a 70 56 61 72  tmt;.  Mem *pVar
ac90: 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 72  ;.  int rc;..  r
aca0: 63 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70  c = vdbeUnbind(p
acb0: 2c 20 69 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d  , i);.  if( rc==
acc0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
acd0: 20 69 66 28 20 7a 44 61 74 61 21 3d 30 20 29 7b   if( zData!=0 ){
ace0: 0a 20 20 20 20 20 20 70 56 61 72 20 3d 20 26 70  .      pVar = &p
acf0: 2d 3e 61 56 61 72 5b 69 2d 31 5d 3b 0a 20 20 20  ->aVar[i-1];.   
ad00: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
ad10: 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70 56 61  dbeMemSetStr(pVa
ad20: 72 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c  r, zData, nData,
ad30: 20 65 6e 63 6f 64 69 6e 67 2c 20 78 44 65 6c 29   encoding, xDel)
ad40: 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d  ;.      if( rc==
ad50: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 65 6e 63  SQLITE_OK && enc
ad60: 6f 64 69 6e 67 21 3d 30 20 29 7b 0a 20 20 20 20  oding!=0 ){.    
ad70: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
ad80: 56 64 62 65 43 68 61 6e 67 65 45 6e 63 6f 64 69  VdbeChangeEncodi
ad90: 6e 67 28 70 56 61 72 2c 20 45 4e 43 28 70 2d 3e  ng(pVar, ENC(p->
ada0: 64 62 29 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  db));.      }.  
adb0: 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20      if( rc ){.  
adc0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72        sqlite3Err
add0: 6f 72 28 70 2d 3e 64 62 2c 20 72 63 29 3b 0a 20  or(p->db, rc);. 
ade0: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69         rc = sqli
adf0: 74 65 33 41 70 69 45 78 69 74 28 70 2d 3e 64 62  te3ApiExit(p->db
ae00: 2c 20 72 63 29 3b 0a 20 20 20 20 20 20 7d 0a 20  , rc);.      }. 
ae10: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33     }.    sqlite3
ae20: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e  _mutex_leave(p->
ae30: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 65  db->mutex);.  }e
ae40: 6c 73 65 20 69 66 28 20 78 44 65 6c 21 3d 53 51  lse if( xDel!=SQ
ae50: 4c 49 54 45 5f 53 54 41 54 49 43 20 26 26 20 78  LITE_STATIC && x
ae60: 44 65 6c 21 3d 53 51 4c 49 54 45 5f 54 52 41 4e  Del!=SQLITE_TRAN
ae70: 53 49 45 4e 54 20 29 7b 0a 20 20 20 20 78 44 65  SIENT ){.    xDe
ae80: 6c 28 28 76 6f 69 64 2a 29 7a 44 61 74 61 29 3b  l((void*)zData);
ae90: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
aea0: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 42 69 6e 64  ;.}.../*.** Bind
aeb0: 20 61 20 62 6c 6f 62 20 76 61 6c 75 65 20 74 6f   a blob value to
aec0: 20 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e   an SQL statemen
aed0: 74 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2f 0a 69  t variable..*/.i
aee0: 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f  nt sqlite3_bind_
aef0: 62 6c 6f 62 28 0a 20 20 73 71 6c 69 74 65 33 5f  blob(.  sqlite3_
af00: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20  stmt *pStmt, .  
af10: 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20  int i, .  const 
af20: 76 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20  void *zData, .  
af30: 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f  int nData, .  vo
af40: 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a  id (*xDel)(void*
af50: 29 0a 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49  ).){.#ifdef SQLI
af60: 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52  TE_ENABLE_API_AR
af70: 4d 4f 52 0a 20 20 69 66 28 20 6e 44 61 74 61 3c  MOR.  if( nData<
af80: 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54  0 ) return SQLIT
af90: 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23  E_MISUSE_BKPT;.#
afa0: 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 62  endif.  return b
afb0: 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 20 69  indText(pStmt, i
afc0: 2c 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20  , zData, nData, 
afd0: 78 44 65 6c 2c 20 30 29 3b 0a 7d 0a 69 6e 74 20  xDel, 0);.}.int 
afe0: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 62 6c 6f  sqlite3_bind_blo
aff0: 62 36 34 28 0a 20 20 73 71 6c 69 74 65 33 5f 73  b64(.  sqlite3_s
b000: 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20 69  tmt *pStmt, .  i
b010: 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20 76  nt i, .  const v
b020: 6f 69 64 20 2a 7a 44 61 74 61 2c 20 0a 20 20 73  oid *zData, .  s
b030: 71 6c 69 74 65 33 5f 75 69 6e 74 36 34 20 6e 44  qlite3_uint64 nD
b040: 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a 78  ata, .  void (*x
b050: 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a 20  Del)(void*).){. 
b060: 20 61 73 73 65 72 74 28 20 78 44 65 6c 21 3d 53   assert( xDel!=S
b070: 51 4c 49 54 45 5f 44 59 4e 41 4d 49 43 20 29 3b  QLITE_DYNAMIC );
b080: 0a 20 20 69 66 28 20 6e 44 61 74 61 3e 30 78 37  .  if( nData>0x7
b090: 66 66 66 66 66 66 66 20 29 7b 0a 20 20 20 20 72  fffffff ){.    r
b0a0: 65 74 75 72 6e 20 69 6e 76 6f 6b 65 56 61 6c 75  eturn invokeValu
b0b0: 65 44 65 73 74 72 75 63 74 6f 72 28 7a 44 61 74  eDestructor(zDat
b0c0: 61 2c 20 78 44 65 6c 2c 20 30 29 3b 0a 20 20 7d  a, xDel, 0);.  }
b0d0: 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e  else{.    return
b0e0: 20 62 69 6e 64 54 65 78 74 28 70 53 74 6d 74 2c   bindText(pStmt,
b0f0: 20 69 2c 20 7a 44 61 74 61 2c 20 28 69 6e 74 29   i, zData, (int)
b100: 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20 30 29 3b  nData, xDel, 0);
b110: 0a 20 20 7d 0a 7d 0a 69 6e 74 20 73 71 6c 69 74  .  }.}.int sqlit
b120: 65 33 5f 62 69 6e 64 5f 64 6f 75 62 6c 65 28 73  e3_bind_double(s
b130: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
b140: 6d 74 2c 20 69 6e 74 20 69 2c 20 64 6f 75 62 6c  mt, int i, doubl
b150: 65 20 72 56 61 6c 75 65 29 7b 0a 20 20 69 6e 74  e rValue){.  int
b160: 20 72 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d   rc;.  Vdbe *p =
b170: 20 28 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a   (Vdbe *)pStmt;.
b180: 20 20 72 63 20 3d 20 76 64 62 65 55 6e 62 69 6e    rc = vdbeUnbin
b190: 64 28 70 2c 20 69 29 3b 0a 20 20 69 66 28 20 72  d(p, i);.  if( r
b1a0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
b1b0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d      sqlite3VdbeM
b1c0: 65 6d 53 65 74 44 6f 75 62 6c 65 28 26 70 2d 3e  emSetDouble(&p->
b1d0: 61 56 61 72 5b 69 2d 31 5d 2c 20 72 56 61 6c 75  aVar[i-1], rValu
b1e0: 65 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  e);.    sqlite3_
b1f0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64  mutex_leave(p->d
b200: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20  b->mutex);.  }. 
b210: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e   return rc;.}.in
b220: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69  t sqlite3_bind_i
b230: 6e 74 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  nt(sqlite3_stmt 
b240: 2a 70 2c 20 69 6e 74 20 69 2c 20 69 6e 74 20 69  *p, int i, int i
b250: 56 61 6c 75 65 29 7b 0a 20 20 72 65 74 75 72 6e  Value){.  return
b260: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e   sqlite3_bind_in
b270: 74 36 34 28 70 2c 20 69 2c 20 28 69 36 34 29 69  t64(p, i, (i64)i
b280: 56 61 6c 75 65 29 3b 0a 7d 0a 69 6e 74 20 73 71  Value);.}.int sq
b290: 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36 34  lite3_bind_int64
b2a0: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70  (sqlite3_stmt *p
b2b0: 53 74 6d 74 2c 20 69 6e 74 20 69 2c 20 73 71 6c  Stmt, int i, sql
b2c0: 69 74 65 5f 69 6e 74 36 34 20 69 56 61 6c 75 65  ite_int64 iValue
b2d0: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 56  ){.  int rc;.  V
b2e0: 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a  dbe *p = (Vdbe *
b2f0: 29 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20 76  )pStmt;.  rc = v
b300: 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29 3b  dbeUnbind(p, i);
b310: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
b320: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69  E_OK ){.    sqli
b330: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74  te3VdbeMemSetInt
b340: 36 34 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d  64(&p->aVar[i-1]
b350: 2c 20 69 56 61 6c 75 65 29 3b 0a 20 20 20 20 73  , iValue);.    s
b360: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
b370: 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29  ve(p->db->mutex)
b380: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  ;.  }.  return r
b390: 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  c;.}.int sqlite3
b3a0: 5f 62 69 6e 64 5f 6e 75 6c 6c 28 73 71 6c 69 74  _bind_null(sqlit
b3b0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
b3c0: 69 6e 74 20 69 29 7b 0a 20 20 69 6e 74 20 72 63  int i){.  int rc
b3d0: 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56  ;.  Vdbe *p = (V
b3e0: 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 72 63  dbe*)pStmt;.  rc
b3f0: 20 3d 20 76 64 62 65 55 6e 62 69 6e 64 28 70 2c   = vdbeUnbind(p,
b400: 20 69 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53   i);.  if( rc==S
b410: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
b420: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
b430: 61 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78  ave(p->db->mutex
b440: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
b450: 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  rc;.}.int sqlite
b460: 33 5f 62 69 6e 64 5f 70 6f 69 6e 74 65 72 28 0a  3_bind_pointer(.
b470: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a    sqlite3_stmt *
b480: 70 53 74 6d 74 2c 0a 20 20 69 6e 74 20 69 2c 0a  pStmt,.  int i,.
b490: 20 20 76 6f 69 64 20 2a 70 50 74 72 2c 0a 20 20    void *pPtr,.  
b4a0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 54 74  const char *zPTt
b4b0: 79 70 65 2c 0a 20 20 76 6f 69 64 20 28 2a 78 44  ype,.  void (*xD
b4c0: 65 73 74 72 75 63 74 6f 72 29 28 76 6f 69 64 2a  estructor)(void*
b4d0: 29 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  ).){.  int rc;. 
b4e0: 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64 62 65   Vdbe *p = (Vdbe
b4f0: 2a 29 70 53 74 6d 74 3b 0a 20 20 72 63 20 3d 20  *)pStmt;.  rc = 
b500: 76 64 62 65 55 6e 62 69 6e 64 28 70 2c 20 69 29  vdbeUnbind(p, i)
b510: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  ;.  if( rc==SQLI
b520: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c  TE_OK ){.    sql
b530: 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 50 6f  ite3VdbeMemSetPo
b540: 69 6e 74 65 72 28 26 70 2d 3e 61 56 61 72 5b 69  inter(&p->aVar[i
b550: 2d 31 5d 2c 20 70 50 74 72 2c 20 7a 50 54 74 79  -1], pPtr, zPTty
b560: 70 65 2c 20 78 44 65 73 74 72 75 63 74 6f 72 29  pe, xDestructor)
b570: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75  ;.    sqlite3_mu
b580: 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62 2d  tex_leave(p->db-
b590: 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 65 6c 73 65  >mutex);.  }else
b5a0: 20 69 66 28 20 78 44 65 73 74 72 75 63 74 6f 72   if( xDestructor
b5b0: 20 29 7b 0a 20 20 20 20 78 44 65 73 74 72 75 63   ){.    xDestruc
b5c0: 74 6f 72 28 70 50 74 72 29 3b 0a 20 20 7d 0a 20  tor(pPtr);.  }. 
b5d0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e   return rc;.}.in
b5e0: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74  t sqlite3_bind_t
b5f0: 65 78 74 28 20 0a 20 20 73 71 6c 69 74 65 33 5f  ext( .  sqlite3_
b600: 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 0a 20 20  stmt *pStmt, .  
b610: 69 6e 74 20 69 2c 20 0a 20 20 63 6f 6e 73 74 20  int i, .  const 
b620: 63 68 61 72 20 2a 7a 44 61 74 61 2c 20 0a 20 20  char *zData, .  
b630: 69 6e 74 20 6e 44 61 74 61 2c 20 0a 20 20 76 6f  int nData, .  vo
b640: 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a  id (*xDel)(void*
b650: 29 0a 29 7b 0a 20 20 72 65 74 75 72 6e 20 62 69  ).){.  return bi
b660: 6e 64 54 65 78 74 28 70 53 74 6d 74 2c 20 69 2c  ndText(pStmt, i,
b670: 20 7a 44 61 74 61 2c 20 6e 44 61 74 61 2c 20 78   zData, nData, x
b680: 44 65 6c 2c 20 53 51 4c 49 54 45 5f 55 54 46 38  Del, SQLITE_UTF8
b690: 29 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  );.}.int sqlite3
b6a0: 5f 62 69 6e 64 5f 74 65 78 74 36 34 28 20 0a 20  _bind_text64( . 
b6b0: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70   sqlite3_stmt *p
b6c0: 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69 2c 20  Stmt, .  int i, 
b6d0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
b6e0: 44 61 74 61 2c 20 0a 20 20 73 71 6c 69 74 65 33  Data, .  sqlite3
b6f0: 5f 75 69 6e 74 36 34 20 6e 44 61 74 61 2c 20 0a  _uint64 nData, .
b700: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76    void (*xDel)(v
b710: 6f 69 64 2a 29 2c 0a 20 20 75 6e 73 69 67 6e 65  oid*),.  unsigne
b720: 64 20 63 68 61 72 20 65 6e 63 0a 29 7b 0a 20 20  d char enc.){.  
b730: 61 73 73 65 72 74 28 20 78 44 65 6c 21 3d 53 51  assert( xDel!=SQ
b740: 4c 49 54 45 5f 44 59 4e 41 4d 49 43 20 29 3b 0a  LITE_DYNAMIC );.
b750: 20 20 69 66 28 20 6e 44 61 74 61 3e 30 78 37 66    if( nData>0x7f
b760: 66 66 66 66 66 66 20 29 7b 0a 20 20 20 20 72 65  ffffff ){.    re
b770: 74 75 72 6e 20 69 6e 76 6f 6b 65 56 61 6c 75 65  turn invokeValue
b780: 44 65 73 74 72 75 63 74 6f 72 28 7a 44 61 74 61  Destructor(zData
b790: 2c 20 78 44 65 6c 2c 20 30 29 3b 0a 20 20 7d 65  , xDel, 0);.  }e
b7a0: 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 65 6e 63  lse{.    if( enc
b7b0: 3d 3d 53 51 4c 49 54 45 5f 55 54 46 31 36 20 29  ==SQLITE_UTF16 )
b7c0: 20 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54   enc = SQLITE_UT
b7d0: 46 31 36 4e 41 54 49 56 45 3b 0a 20 20 20 20 72  F16NATIVE;.    r
b7e0: 65 74 75 72 6e 20 62 69 6e 64 54 65 78 74 28 70  eturn bindText(p
b7f0: 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74 61 2c 20  Stmt, i, zData, 
b800: 28 69 6e 74 29 6e 44 61 74 61 2c 20 78 44 65 6c  (int)nData, xDel
b810: 2c 20 65 6e 63 29 3b 0a 20 20 7d 0a 7d 0a 23 69  , enc);.  }.}.#i
b820: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
b830: 54 5f 55 54 46 31 36 0a 69 6e 74 20 73 71 6c 69  T_UTF16.int sqli
b840: 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 31 36 28  te3_bind_text16(
b850: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
b860: 2a 70 53 74 6d 74 2c 20 0a 20 20 69 6e 74 20 69  *pStmt, .  int i
b870: 2c 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  , .  const void 
b880: 2a 7a 44 61 74 61 2c 20 0a 20 20 69 6e 74 20 6e  *zData, .  int n
b890: 44 61 74 61 2c 20 0a 20 20 76 6f 69 64 20 28 2a  Data, .  void (*
b8a0: 78 44 65 6c 29 28 76 6f 69 64 2a 29 0a 29 7b 0a  xDel)(void*).){.
b8b0: 20 20 72 65 74 75 72 6e 20 62 69 6e 64 54 65 78    return bindTex
b8c0: 74 28 70 53 74 6d 74 2c 20 69 2c 20 7a 44 61 74  t(pStmt, i, zDat
b8d0: 61 2c 20 6e 44 61 74 61 2c 20 78 44 65 6c 2c 20  a, nData, xDel, 
b8e0: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49  SQLITE_UTF16NATI
b8f0: 56 45 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a  VE);.}.#endif /*
b900: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46   SQLITE_OMIT_UTF
b910: 31 36 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  16 */.int sqlite
b920: 33 5f 62 69 6e 64 5f 76 61 6c 75 65 28 73 71 6c  3_bind_value(sql
b930: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
b940: 2c 20 69 6e 74 20 69 2c 20 63 6f 6e 73 74 20 73  , int i, const s
b950: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56  qlite3_value *pV
b960: 61 6c 75 65 29 7b 0a 20 20 69 6e 74 20 72 63 3b  alue){.  int rc;
b970: 0a 20 20 73 77 69 74 63 68 28 20 73 71 6c 69 74  .  switch( sqlit
b980: 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 28 73  e3_value_type((s
b990: 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 29 70 56  qlite3_value*)pV
b9a0: 61 6c 75 65 29 20 29 7b 0a 20 20 20 20 63 61 73  alue) ){.    cas
b9b0: 65 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 52  e SQLITE_INTEGER
b9c0: 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73  : {.      rc = s
b9d0: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36  qlite3_bind_int6
b9e0: 34 28 70 53 74 6d 74 2c 20 69 2c 20 70 56 61 6c  4(pStmt, i, pVal
b9f0: 75 65 2d 3e 75 2e 69 29 3b 0a 20 20 20 20 20 20  ue->u.i);.      
ba00: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20  break;.    }.   
ba10: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 46 4c 4f   case SQLITE_FLO
ba20: 41 54 3a 20 7b 0a 20 20 20 20 20 20 72 63 20 3d  AT: {.      rc =
ba30: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 64 6f   sqlite3_bind_do
ba40: 75 62 6c 65 28 70 53 74 6d 74 2c 20 69 2c 20 70  uble(pStmt, i, p
ba50: 56 61 6c 75 65 2d 3e 75 2e 72 29 3b 0a 20 20 20  Value->u.r);.   
ba60: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a     break;.    }.
ba70: 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f      case SQLITE_
ba80: 42 4c 4f 42 3a 20 7b 0a 20 20 20 20 20 20 69 66  BLOB: {.      if
ba90: 28 20 70 56 61 6c 75 65 2d 3e 66 6c 61 67 73 20  ( pValue->flags 
baa0: 26 20 4d 45 4d 5f 5a 65 72 6f 20 29 7b 0a 20 20  & MEM_Zero ){.  
bab0: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74        rc = sqlit
bac0: 65 33 5f 62 69 6e 64 5f 7a 65 72 6f 62 6c 6f 62  e3_bind_zeroblob
bad0: 28 70 53 74 6d 74 2c 20 69 2c 20 70 56 61 6c 75  (pStmt, i, pValu
bae0: 65 2d 3e 75 2e 6e 5a 65 72 6f 29 3b 0a 20 20 20  e->u.nZero);.   
baf0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
bb00: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 62    rc = sqlite3_b
bb10: 69 6e 64 5f 62 6c 6f 62 28 70 53 74 6d 74 2c 20  ind_blob(pStmt, 
bb20: 69 2c 20 70 56 61 6c 75 65 2d 3e 7a 2c 20 70 56  i, pValue->z, pV
bb30: 61 6c 75 65 2d 3e 6e 2c 53 51 4c 49 54 45 5f 54  alue->n,SQLITE_T
bb40: 52 41 4e 53 49 45 4e 54 29 3b 0a 20 20 20 20 20  RANSIENT);.     
bb50: 20 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a   }.      break;.
bb60: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 53      }.    case S
bb70: 51 4c 49 54 45 5f 54 45 58 54 3a 20 7b 0a 20 20  QLITE_TEXT: {.  
bb80: 20 20 20 20 72 63 20 3d 20 62 69 6e 64 54 65 78      rc = bindTex
bb90: 74 28 70 53 74 6d 74 2c 69 2c 20 20 70 56 61 6c  t(pStmt,i,  pVal
bba0: 75 65 2d 3e 7a 2c 20 70 56 61 6c 75 65 2d 3e 6e  ue->z, pValue->n
bbb0: 2c 20 53 51 4c 49 54 45 5f 54 52 41 4e 53 49 45  , SQLITE_TRANSIE
bbc0: 4e 54 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  NT,.            
bbd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
bbe0: 20 20 70 56 61 6c 75 65 2d 3e 65 6e 63 29 3b 0a    pValue->enc);.
bbf0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
bc00: 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20   }.    default: 
bc10: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  {.      rc = sql
bc20: 69 74 65 33 5f 62 69 6e 64 5f 6e 75 6c 6c 28 70  ite3_bind_null(p
bc30: 53 74 6d 74 2c 20 69 29 3b 0a 20 20 20 20 20 20  Stmt, i);.      
bc40: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d  break;.    }.  }
bc50: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
bc60: 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  int sqlite3_bind
bc70: 5f 7a 65 72 6f 62 6c 6f 62 28 73 71 6c 69 74 65  _zeroblob(sqlite
bc80: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
bc90: 6e 74 20 69 2c 20 69 6e 74 20 6e 29 7b 0a 20 20  nt i, int n){.  
bca0: 69 6e 74 20 72 63 3b 0a 20 20 56 64 62 65 20 2a  int rc;.  Vdbe *
bcb0: 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53 74 6d  p = (Vdbe *)pStm
bcc0: 74 3b 0a 20 20 72 63 20 3d 20 76 64 62 65 55 6e  t;.  rc = vdbeUn
bcd0: 62 69 6e 64 28 70 2c 20 69 29 3b 0a 20 20 69 66  bind(p, i);.  if
bce0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
bcf0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64  ){.    sqlite3Vd
bd00: 62 65 4d 65 6d 53 65 74 5a 65 72 6f 42 6c 6f 62  beMemSetZeroBlob
bd10: 28 26 70 2d 3e 61 56 61 72 5b 69 2d 31 5d 2c 20  (&p->aVar[i-1], 
bd20: 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  n);.    sqlite3_
bd30: 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64  mutex_leave(p->d
bd40: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20  b->mutex);.  }. 
bd50: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e   return rc;.}.in
bd60: 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 7a  t sqlite3_bind_z
bd70: 65 72 6f 62 6c 6f 62 36 34 28 73 71 6c 69 74 65  eroblob64(sqlite
bd80: 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 69  3_stmt *pStmt, i
bd90: 6e 74 20 69 2c 20 73 71 6c 69 74 65 33 5f 75 69  nt i, sqlite3_ui
bda0: 6e 74 36 34 20 6e 29 7b 0a 20 20 69 6e 74 20 72  nt64 n){.  int r
bdb0: 63 3b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28  c;.  Vdbe *p = (
bdc0: 56 64 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20  Vdbe *)pStmt;.  
bdd0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
bde0: 74 65 72 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78  ter(p->db->mutex
bdf0: 29 3b 0a 20 20 69 66 28 20 6e 3e 28 75 36 34 29  );.  if( n>(u64)
be00: 70 2d 3e 64 62 2d 3e 61 4c 69 6d 69 74 5b 53 51  p->db->aLimit[SQ
be10: 4c 49 54 45 5f 4c 49 4d 49 54 5f 4c 45 4e 47 54  LITE_LIMIT_LENGT
be20: 48 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53  H] ){.    rc = S
be30: 51 4c 49 54 45 5f 54 4f 4f 42 49 47 3b 0a 20 20  QLITE_TOOBIG;.  
be40: 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72  }else{.    asser
be50: 74 28 20 28 6e 20 26 20 30 78 37 46 46 46 46 46  t( (n & 0x7FFFFF
be60: 46 46 29 3d 3d 6e 20 29 3b 0a 20 20 20 20 72 63  FF)==n );.    rc
be70: 20 3d 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f   = sqlite3_bind_
be80: 7a 65 72 6f 62 6c 6f 62 28 70 53 74 6d 74 2c 20  zeroblob(pStmt, 
be90: 69 2c 20 6e 29 3b 0a 20 20 7d 0a 20 20 72 63 20  i, n);.  }.  rc 
bea0: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74  = sqlite3ApiExit
beb0: 28 70 2d 3e 64 62 2c 20 72 63 29 3b 0a 20 20 73  (p->db, rc);.  s
bec0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61  qlite3_mutex_lea
bed0: 76 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29  ve(p->db->mutex)
bee0: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
bef0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
bf00: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 77 69 6c  he number of wil
bf10: 64 63 61 72 64 73 20 74 68 61 74 20 63 61 6e 20  dcards that can 
bf20: 62 65 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 62  be potentially b
bf30: 6f 75 6e 64 20 74 6f 2e 0a 2a 2a 20 54 68 69 73  ound to..** This
bf40: 20 72 6f 75 74 69 6e 65 20 69 73 20 61 64 64 65   routine is adde
bf50: 64 20 74 6f 20 73 75 70 70 6f 72 74 20 44 42 44  d to support DBD
bf60: 3a 3a 53 51 4c 69 74 65 2e 20 20 0a 2a 2f 0a 69  ::SQLite.  .*/.i
bf70: 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f  nt sqlite3_bind_
bf80: 70 61 72 61 6d 65 74 65 72 5f 63 6f 75 6e 74 28  parameter_count(
bf90: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
bfa0: 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 20  tmt){.  Vdbe *p 
bfb0: 3d 20 28 56 64 62 65 2a 29 70 53 74 6d 74 3b 0a  = (Vdbe*)pStmt;.
bfc0: 20 20 72 65 74 75 72 6e 20 70 20 3f 20 70 2d 3e    return p ? p->
bfd0: 6e 56 61 72 20 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a  nVar : 0;.}../*.
bfe0: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 61  ** Return the na
bff0: 6d 65 20 6f 66 20 61 20 77 69 6c 64 63 61 72 64  me of a wildcard
c000: 20 70 61 72 61 6d 65 74 65 72 2e 20 20 52 65 74   parameter.  Ret
c010: 75 72 6e 20 4e 55 4c 4c 20 69 66 20 74 68 65 20  urn NULL if the 
c020: 69 6e 64 65 78 0a 2a 2a 20 69 73 20 6f 75 74 20  index.** is out 
c030: 6f 66 20 72 61 6e 67 65 20 6f 72 20 69 66 20 74  of range or if t
c040: 68 65 20 77 69 6c 64 63 61 72 64 20 69 73 20 75  he wildcard is u
c050: 6e 6e 61 6d 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68  nnamed..**.** Th
c060: 65 20 72 65 73 75 6c 74 20 69 73 20 61 6c 77 61  e result is alwa
c070: 79 73 20 55 54 46 2d 38 2e 0a 2a 2f 0a 63 6f 6e  ys UTF-8..*/.con
c080: 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33  st char *sqlite3
c090: 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f  _bind_parameter_
c0a0: 6e 61 6d 65 28 73 71 6c 69 74 65 33 5f 73 74 6d  name(sqlite3_stm
c0b0: 74 20 2a 70 53 74 6d 74 2c 20 69 6e 74 20 69 29  t *pStmt, int i)
c0c0: 7b 0a 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56  {.  Vdbe *p = (V
c0d0: 64 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 69 66  dbe*)pStmt;.  if
c0e0: 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 20  ( p==0 ) return 
c0f0: 30 3b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69  0;.  return sqli
c100: 74 65 33 56 4c 69 73 74 4e 75 6d 54 6f 4e 61 6d  te3VListNumToNam
c110: 65 28 70 2d 3e 70 56 4c 69 73 74 2c 20 69 29 3b  e(p->pVList, i);
c120: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20  .}../*.** Given 
c130: 61 20 77 69 6c 64 63 61 72 64 20 70 61 72 61 6d  a wildcard param
c140: 65 74 65 72 20 6e 61 6d 65 2c 20 72 65 74 75 72  eter name, retur
c150: 6e 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20 74  n the index of t
c160: 68 65 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 77  he variable.** w
c170: 69 74 68 20 74 68 61 74 20 6e 61 6d 65 2e 20 20  ith that name.  
c180: 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 76  If there is no v
c190: 61 72 69 61 62 6c 65 20 77 69 74 68 20 74 68 65  ariable with the
c1a0: 20 67 69 76 65 6e 20 6e 61 6d 65 2c 0a 2a 2a 20   given name,.** 
c1b0: 72 65 74 75 72 6e 20 30 2e 0a 2a 2f 0a 69 6e 74  return 0..*/.int
c1c0: 20 73 71 6c 69 74 65 33 56 64 62 65 50 61 72 61   sqlite3VdbePara
c1d0: 6d 65 74 65 72 49 6e 64 65 78 28 56 64 62 65 20  meterIndex(Vdbe 
c1e0: 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  *p, const char *
c1f0: 7a 4e 61 6d 65 2c 20 69 6e 74 20 6e 4e 61 6d 65  zName, int nName
c200: 29 7b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c  ){.  if( p==0 ||
c210: 20 7a 4e 61 6d 65 3d 3d 30 20 29 20 72 65 74 75   zName==0 ) retu
c220: 72 6e 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 73  rn 0;.  return s
c230: 71 6c 69 74 65 33 56 4c 69 73 74 4e 61 6d 65 54  qlite3VListNameT
c240: 6f 4e 75 6d 28 70 2d 3e 70 56 4c 69 73 74 2c 20  oNum(p->pVList, 
c250: 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 29 3b 0a 7d  zName, nName);.}
c260: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 62 69 6e  .int sqlite3_bin
c270: 64 5f 70 61 72 61 6d 65 74 65 72 5f 69 6e 64 65  d_parameter_inde
c280: 78 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  x(sqlite3_stmt *
c290: 70 53 74 6d 74 2c 20 63 6f 6e 73 74 20 63 68 61  pStmt, const cha
c2a0: 72 20 2a 7a 4e 61 6d 65 29 7b 0a 20 20 72 65 74  r *zName){.  ret
c2b0: 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62 65 50  urn sqlite3VdbeP
c2c0: 61 72 61 6d 65 74 65 72 49 6e 64 65 78 28 28 56  arameterIndex((V
c2d0: 64 62 65 2a 29 70 53 74 6d 74 2c 20 7a 4e 61 6d  dbe*)pStmt, zNam
c2e0: 65 2c 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e  e, sqlite3Strlen
c2f0: 33 30 28 7a 4e 61 6d 65 29 29 3b 0a 7d 0a 0a 2f  30(zName));.}../
c300: 2a 0a 2a 2a 20 54 72 61 6e 73 66 65 72 20 61 6c  *.** Transfer al
c310: 6c 20 62 69 6e 64 69 6e 67 73 20 66 72 6f 6d 20  l bindings from 
c320: 74 68 65 20 66 69 72 73 74 20 73 74 61 74 65 6d  the first statem
c330: 65 6e 74 20 6f 76 65 72 20 74 6f 20 74 68 65 20  ent over to the 
c340: 73 65 63 6f 6e 64 2e 0a 2a 2f 0a 69 6e 74 20 73  second..*/.int s
c350: 71 6c 69 74 65 33 54 72 61 6e 73 66 65 72 42 69  qlite3TransferBi
c360: 6e 64 69 6e 67 73 28 73 71 6c 69 74 65 33 5f 73  ndings(sqlite3_s
c370: 74 6d 74 20 2a 70 46 72 6f 6d 53 74 6d 74 2c 20  tmt *pFromStmt, 
c380: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 54  sqlite3_stmt *pT
c390: 6f 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a  oStmt){.  Vdbe *
c3a0: 70 46 72 6f 6d 20 3d 20 28 56 64 62 65 2a 29 70  pFrom = (Vdbe*)p
c3b0: 46 72 6f 6d 53 74 6d 74 3b 0a 20 20 56 64 62 65  FromStmt;.  Vdbe
c3c0: 20 2a 70 54 6f 20 3d 20 28 56 64 62 65 2a 29 70   *pTo = (Vdbe*)p
c3d0: 54 6f 53 74 6d 74 3b 0a 20 20 69 6e 74 20 69 3b  ToStmt;.  int i;
c3e0: 0a 20 20 61 73 73 65 72 74 28 20 70 54 6f 2d 3e  .  assert( pTo->
c3f0: 64 62 3d 3d 70 46 72 6f 6d 2d 3e 64 62 20 29 3b  db==pFrom->db );
c400: 0a 20 20 61 73 73 65 72 74 28 20 70 54 6f 2d 3e  .  assert( pTo->
c410: 6e 56 61 72 3d 3d 70 46 72 6f 6d 2d 3e 6e 56 61  nVar==pFrom->nVa
c420: 72 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d  r );.  sqlite3_m
c430: 75 74 65 78 5f 65 6e 74 65 72 28 70 54 6f 2d 3e  utex_enter(pTo->
c440: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 66 6f  db->mutex);.  fo
c450: 72 28 69 3d 30 3b 20 69 3c 70 46 72 6f 6d 2d 3e  r(i=0; i<pFrom->
c460: 6e 56 61 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  nVar; i++){.    
c470: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 4d 6f  sqlite3VdbeMemMo
c480: 76 65 28 26 70 54 6f 2d 3e 61 56 61 72 5b 69 5d  ve(&pTo->aVar[i]
c490: 2c 20 26 70 46 72 6f 6d 2d 3e 61 56 61 72 5b 69  , &pFrom->aVar[i
c4a0: 5d 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  ]);.  }.  sqlite
c4b0: 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 54  3_mutex_leave(pT
c4c0: 6f 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20  o->db->mutex);. 
c4d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
c4e0: 4b 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51  K;.}..#ifndef SQ
c4f0: 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43  LITE_OMIT_DEPREC
c500: 41 54 45 44 0a 2f 2a 0a 2a 2a 20 44 65 70 72 65  ATED./*.** Depre
c510: 63 61 74 65 64 20 65 78 74 65 72 6e 61 6c 20 69  cated external i
c520: 6e 74 65 72 66 61 63 65 2e 20 20 49 6e 74 65 72  nterface.  Inter
c530: 6e 61 6c 2f 63 6f 72 65 20 53 51 4c 69 74 65 20  nal/core SQLite 
c540: 63 6f 64 65 0a 2a 2a 20 73 68 6f 75 6c 64 20 63  code.** should c
c550: 61 6c 6c 20 73 71 6c 69 74 65 33 54 72 61 6e 73  all sqlite3Trans
c560: 66 65 72 42 69 6e 64 69 6e 67 73 2e 0a 2a 2a 0a  ferBindings..**.
c570: 2a 2a 20 49 74 20 69 73 20 6d 69 73 75 73 65 20  ** It is misuse 
c580: 74 6f 20 63 61 6c 6c 20 74 68 69 73 20 72 6f 75  to call this rou
c590: 74 69 6e 65 20 77 69 74 68 20 73 74 61 74 65 6d  tine with statem
c5a0: 65 6e 74 73 20 66 72 6f 6d 20 64 69 66 66 65 72  ents from differ
c5b0: 65 6e 74 0a 2a 2a 20 64 61 74 61 62 61 73 65 20  ent.** database 
c5c0: 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 20 20 42 75  connections.  Bu
c5d0: 74 20 61 73 20 74 68 69 73 20 69 73 20 61 20 64  t as this is a d
c5e0: 65 70 72 65 63 61 74 65 64 20 69 6e 74 65 72 66  eprecated interf
c5f0: 61 63 65 2c 20 77 65 0a 2a 2a 20 77 69 6c 6c 20  ace, we.** will 
c600: 6e 6f 74 20 62 6f 74 68 65 72 20 74 6f 20 63 68  not bother to ch
c610: 65 63 6b 20 66 6f 72 20 74 68 61 74 20 63 6f 6e  eck for that con
c620: 64 69 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66  dition..**.** If
c630: 20 74 68 65 20 74 77 6f 20 73 74 61 74 65 6d 65   the two stateme
c640: 6e 74 73 20 63 6f 6e 74 61 69 6e 20 61 20 64 69  nts contain a di
c650: 66 66 65 72 65 6e 74 20 6e 75 6d 62 65 72 20 6f  fferent number o
c660: 66 20 62 69 6e 64 69 6e 67 73 2c 20 74 68 65 6e  f bindings, then
c670: 0a 2a 2a 20 61 6e 20 53 51 4c 49 54 45 5f 45 52  .** an SQLITE_ER
c680: 52 4f 52 20 69 73 20 72 65 74 75 72 6e 65 64 2e  ROR is returned.
c690: 20 20 4e 6f 74 68 69 6e 67 20 65 6c 73 65 20 63    Nothing else c
c6a0: 61 6e 20 67 6f 20 77 72 6f 6e 67 2c 20 73 6f 20  an go wrong, so 
c6b0: 6f 74 68 65 72 77 69 73 65 0a 2a 2a 20 53 51 4c  otherwise.** SQL
c6c0: 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e  ITE_OK is return
c6d0: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ed..*/.int sqlit
c6e0: 65 33 5f 74 72 61 6e 73 66 65 72 5f 62 69 6e 64  e3_transfer_bind
c6f0: 69 6e 67 73 28 73 71 6c 69 74 65 33 5f 73 74 6d  ings(sqlite3_stm
c700: 74 20 2a 70 46 72 6f 6d 53 74 6d 74 2c 20 73 71  t *pFromStmt, sq
c710: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 54 6f 53  lite3_stmt *pToS
c720: 74 6d 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 46  tmt){.  Vdbe *pF
c730: 72 6f 6d 20 3d 20 28 56 64 62 65 2a 29 70 46 72  rom = (Vdbe*)pFr
c740: 6f 6d 53 74 6d 74 3b 0a 20 20 56 64 62 65 20 2a  omStmt;.  Vdbe *
c750: 70 54 6f 20 3d 20 28 56 64 62 65 2a 29 70 54 6f  pTo = (Vdbe*)pTo
c760: 53 74 6d 74 3b 0a 20 20 69 66 28 20 70 46 72 6f  Stmt;.  if( pFro
c770: 6d 2d 3e 6e 56 61 72 21 3d 70 54 6f 2d 3e 6e 56  m->nVar!=pTo->nV
c780: 61 72 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ar ){.    return
c790: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20   SQLITE_ERROR;. 
c7a0: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 28 70 54   }.  assert( (pT
c7b0: 6f 2d 3e 70 72 65 70 46 6c 61 67 73 20 26 20 53  o->prepFlags & S
c7c0: 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 53 41  QLITE_PREPARE_SA
c7d0: 56 45 53 51 4c 29 21 3d 30 20 7c 7c 20 70 54 6f  VESQL)!=0 || pTo
c7e0: 2d 3e 65 78 70 6d 61 73 6b 3d 3d 30 20 29 3b 0a  ->expmask==0 );.
c7f0: 20 20 69 66 28 20 70 54 6f 2d 3e 65 78 70 6d 61    if( pTo->expma
c800: 73 6b 20 29 7b 0a 20 20 20 20 70 54 6f 2d 3e 65  sk ){.    pTo->e
c810: 78 70 69 72 65 64 20 3d 20 31 3b 0a 20 20 7d 0a  xpired = 1;.  }.
c820: 20 20 61 73 73 65 72 74 28 20 28 70 46 72 6f 6d    assert( (pFrom
c830: 2d 3e 70 72 65 70 46 6c 61 67 73 20 26 20 53 51  ->prepFlags & SQ
c840: 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 53 41 56  LITE_PREPARE_SAV
c850: 45 53 51 4c 29 21 3d 30 20 7c 7c 20 70 46 72 6f  ESQL)!=0 || pFro
c860: 6d 2d 3e 65 78 70 6d 61 73 6b 3d 3d 30 20 29 3b  m->expmask==0 );
c870: 0a 20 20 69 66 28 20 70 46 72 6f 6d 2d 3e 65 78  .  if( pFrom->ex
c880: 70 6d 61 73 6b 20 29 7b 0a 20 20 20 20 70 46 72  pmask ){.    pFr
c890: 6f 6d 2d 3e 65 78 70 69 72 65 64 20 3d 20 31 3b  om->expired = 1;
c8a0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 73 71  .  }.  return sq
c8b0: 6c 69 74 65 33 54 72 61 6e 73 66 65 72 42 69 6e  lite3TransferBin
c8c0: 64 69 6e 67 73 28 70 46 72 6f 6d 53 74 6d 74 2c  dings(pFromStmt,
c8d0: 20 70 54 6f 53 74 6d 74 29 3b 0a 7d 0a 23 65 6e   pToStmt);.}.#en
c8e0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  dif../*.** Retur
c8f0: 6e 20 74 68 65 20 73 71 6c 69 74 65 33 2a 20 64  n the sqlite3* d
c900: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 74  atabase handle t
c910: 6f 20 77 68 69 63 68 20 74 68 65 20 70 72 65 70  o which the prep
c920: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 67  ared statement g
c930: 69 76 65 6e 0a 2a 2a 20 69 6e 20 74 68 65 20 61  iven.** in the a
c940: 72 67 75 6d 65 6e 74 20 62 65 6c 6f 6e 67 73 2e  rgument belongs.
c950: 20 20 54 68 69 73 20 69 73 20 74 68 65 20 73 61    This is the sa
c960: 6d 65 20 64 61 74 61 62 61 73 65 20 68 61 6e 64  me database hand
c970: 6c 65 20 74 68 61 74 20 77 61 73 0a 2a 2a 20 74  le that was.** t
c980: 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e  he first argumen
c990: 74 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33  t to the sqlite3
c9a0: 5f 70 72 65 70 61 72 65 28 29 20 74 68 61 74 20  _prepare() that 
c9b0: 77 61 73 20 75 73 65 64 20 74 6f 20 63 72 65 61  was used to crea
c9c0: 74 65 0a 2a 2a 20 74 68 65 20 73 74 61 74 65 6d  te.** the statem
c9d0: 65 6e 74 20 69 6e 20 74 68 65 20 66 69 72 73 74  ent in the first
c9e0: 20 70 6c 61 63 65 2e 0a 2a 2f 0a 73 71 6c 69 74   place..*/.sqlit
c9f0: 65 33 20 2a 73 71 6c 69 74 65 33 5f 64 62 5f 68  e3 *sqlite3_db_h
ca00: 61 6e 64 6c 65 28 73 71 6c 69 74 65 33 5f 73 74  andle(sqlite3_st
ca10: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 72 65  mt *pStmt){.  re
ca20: 74 75 72 6e 20 70 53 74 6d 74 20 3f 20 28 28 56  turn pStmt ? ((V
ca30: 64 62 65 2a 29 70 53 74 6d 74 29 2d 3e 64 62 20  dbe*)pStmt)->db 
ca40: 3a 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  : 0;.}../*.** Re
ca50: 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 68 65  turn true if the
ca60: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
ca70: 65 6e 74 20 69 73 20 67 75 61 72 61 6e 74 65 65  ent is guarantee
ca80: 64 20 74 6f 20 6e 6f 74 20 6d 6f 64 69 66 79 20  d to not modify 
ca90: 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e  the.** database.
caa0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
cab0: 73 74 6d 74 5f 72 65 61 64 6f 6e 6c 79 28 73 71  stmt_readonly(sq
cac0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d  lite3_stmt *pStm
cad0: 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 53 74  t){.  return pSt
cae0: 6d 74 20 3f 20 28 28 56 64 62 65 2a 29 70 53 74  mt ? ((Vdbe*)pSt
caf0: 6d 74 29 2d 3e 72 65 61 64 4f 6e 6c 79 20 3a 20  mt)->readOnly : 
cb00: 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75  1;.}../*.** Retu
cb10: 72 6e 20 31 20 69 66 20 74 68 65 20 73 74 61 74  rn 1 if the stat
cb20: 65 6d 65 6e 74 20 69 73 20 61 6e 20 45 58 50 4c  ement is an EXPL
cb30: 41 49 4e 20 61 6e 64 20 72 65 74 75 72 6e 20 32  AIN and return 2
cb40: 20 69 66 20 74 68 65 0a 2a 2a 20 73 74 61 74 65   if the.** state
cb50: 6d 65 6e 74 20 69 73 20 61 6e 20 45 58 50 4c 41  ment is an EXPLA
cb60: 49 4e 20 51 55 45 52 59 20 50 4c 41 4e 0a 2a 2f  IN QUERY PLAN.*/
cb70: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 74 6d  .int sqlite3_stm
cb80: 74 5f 69 73 65 78 70 6c 61 69 6e 28 73 71 6c 69  t_isexplain(sqli
cb90: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29  te3_stmt *pStmt)
cba0: 7b 0a 20 20 72 65 74 75 72 6e 20 70 53 74 6d 74  {.  return pStmt
cbb0: 20 3f 20 28 28 56 64 62 65 2a 29 70 53 74 6d 74   ? ((Vdbe*)pStmt
cbc0: 29 2d 3e 65 78 70 6c 61 69 6e 20 3a 20 30 3b 0a  )->explain : 0;.
cbd0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
cbe0: 74 72 75 65 20 69 66 20 74 68 65 20 70 72 65 70  true if the prep
cbf0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 69  ared statement i
cc00: 73 20 69 6e 20 6e 65 65 64 20 6f 66 20 62 65 69  s in need of bei
cc10: 6e 67 20 72 65 73 65 74 2e 0a 2a 2f 0a 69 6e 74  ng reset..*/.int
cc20: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 5f 62 75   sqlite3_stmt_bu
cc30: 73 79 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  sy(sqlite3_stmt 
cc40: 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65 20  *pStmt){.  Vdbe 
cc50: 2a 76 20 3d 20 28 56 64 62 65 2a 29 70 53 74 6d  *v = (Vdbe*)pStm
cc60: 74 3b 0a 20 20 72 65 74 75 72 6e 20 76 21 3d 30  t;.  return v!=0
cc70: 20 26 26 20 76 2d 3e 6d 61 67 69 63 3d 3d 56 44   && v->magic==VD
cc80: 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26 26 20  BE_MAGIC_RUN && 
cc90: 76 2d 3e 70 63 3e 3d 30 3b 0a 7d 0a 0a 2f 2a 0a  v->pc>=0;.}../*.
cca0: 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e  ** Return a poin
ccb0: 74 65 72 20 74 6f 20 74 68 65 20 6e 65 78 74 20  ter to the next 
ccc0: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  prepared stateme
ccd0: 6e 74 20 61 66 74 65 72 20 70 53 74 6d 74 20 61  nt after pStmt a
cce0: 73 73 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69 74  ssociated.** wit
ccf0: 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  h database conne
cd00: 63 74 69 6f 6e 20 70 44 62 2e 20 20 49 66 20 70  ction pDb.  If p
cd10: 53 74 6d 74 20 69 73 20 4e 55 4c 4c 2c 20 72 65  Stmt is NULL, re
cd20: 74 75 72 6e 20 74 68 65 20 66 69 72 73 74 0a 2a  turn the first.*
cd30: 2a 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  * prepared state
cd40: 6d 65 6e 74 20 66 6f 72 20 74 68 65 20 64 61 74  ment for the dat
cd50: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
cd60: 2e 20 20 52 65 74 75 72 6e 20 4e 55 4c 4c 20 69  .  Return NULL i
cd70: 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e  f there.** are n
cd80: 6f 20 6d 6f 72 65 2e 0a 2a 2f 0a 73 71 6c 69 74  o more..*/.sqlit
cd90: 65 33 5f 73 74 6d 74 20 2a 73 71 6c 69 74 65 33  e3_stmt *sqlite3
cda0: 5f 6e 65 78 74 5f 73 74 6d 74 28 73 71 6c 69 74  _next_stmt(sqlit
cdb0: 65 33 20 2a 70 44 62 2c 20 73 71 6c 69 74 65 33  e3 *pDb, sqlite3
cdc0: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20  _stmt *pStmt){. 
cdd0: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70   sqlite3_stmt *p
cde0: 4e 65 78 74 3b 0a 23 69 66 64 65 66 20 53 51 4c  Next;.#ifdef SQL
cdf0: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41  ITE_ENABLE_API_A
ce00: 52 4d 4f 52 0a 20 20 69 66 28 20 21 73 71 6c 69  RMOR.  if( !sqli
ce10: 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b  te3SafetyCheckOk
ce20: 28 70 44 62 29 20 29 7b 0a 20 20 20 20 28 76 6f  (pDb) ){.    (vo
ce30: 69 64 29 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  id)SQLITE_MISUSE
ce40: 5f 42 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72  _BKPT;.    retur
ce50: 6e 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a  n 0;.  }.#endif.
ce60: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
ce70: 65 6e 74 65 72 28 70 44 62 2d 3e 6d 75 74 65 78  enter(pDb->mutex
ce80: 29 3b 0a 20 20 69 66 28 20 70 53 74 6d 74 3d 3d  );.  if( pStmt==
ce90: 30 20 29 7b 0a 20 20 20 20 70 4e 65 78 74 20 3d  0 ){.    pNext =
cea0: 20 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 29   (sqlite3_stmt*)
ceb0: 70 44 62 2d 3e 70 56 64 62 65 3b 0a 20 20 7d 65  pDb->pVdbe;.  }e
cec0: 6c 73 65 7b 0a 20 20 20 20 70 4e 65 78 74 20 3d  lse{.    pNext =
ced0: 20 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 29   (sqlite3_stmt*)
cee0: 28 28 56 64 62 65 2a 29 70 53 74 6d 74 29 2d 3e  ((Vdbe*)pStmt)->
cef0: 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 73 71 6c  pNext;.  }.  sql
cf00: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
cf10: 28 70 44 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  (pDb->mutex);.  
cf20: 72 65 74 75 72 6e 20 70 4e 65 78 74 3b 0a 7d 0a  return pNext;.}.
cf30: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
cf40: 65 20 76 61 6c 75 65 20 6f 66 20 61 20 73 74 61  e value of a sta
cf50: 74 75 73 20 63 6f 75 6e 74 65 72 20 66 6f 72 20  tus counter for 
cf60: 61 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  a prepared state
cf70: 6d 65 6e 74 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ment.*/.int sqli
cf80: 74 65 33 5f 73 74 6d 74 5f 73 74 61 74 75 73 28  te3_stmt_status(
cf90: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53  sqlite3_stmt *pS
cfa0: 74 6d 74 2c 20 69 6e 74 20 6f 70 2c 20 69 6e 74  tmt, int op, int
cfb0: 20 72 65 73 65 74 46 6c 61 67 29 7b 0a 20 20 56   resetFlag){.  V
cfc0: 64 62 65 20 2a 70 56 64 62 65 20 3d 20 28 56 64  dbe *pVdbe = (Vd
cfd0: 62 65 2a 29 70 53 74 6d 74 3b 0a 20 20 75 33 32  be*)pStmt;.  u32
cfe0: 20 76 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54   v;.#ifdef SQLIT
cff0: 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d  E_ENABLE_API_ARM
d000: 4f 52 0a 20 20 69 66 28 20 21 70 53 74 6d 74 20  OR.  if( !pStmt 
d010: 0a 20 20 20 7c 7c 20 28 6f 70 21 3d 53 51 4c 49  .   || (op!=SQLI
d020: 54 45 5f 53 54 4d 54 53 54 41 54 55 53 5f 4d 45  TE_STMTSTATUS_ME
d030: 4d 55 53 45 44 20 26 26 20 28 6f 70 3c 30 7c 7c  MUSED && (op<0||
d040: 6f 70 3e 3d 41 72 72 61 79 53 69 7a 65 28 70 56  op>=ArraySize(pV
d050: 64 62 65 2d 3e 61 43 6f 75 6e 74 65 72 29 29 29  dbe->aCounter)))
d060: 0a 20 20 29 7b 0a 20 20 20 20 28 76 6f 69 64 29  .  ){.    (void)
d070: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b  SQLITE_MISUSE_BK
d080: 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 30  PT;.    return 0
d090: 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 69  ;.  }.#endif.  i
d0a0: 66 28 20 6f 70 3d 3d 53 51 4c 49 54 45 5f 53 54  f( op==SQLITE_ST
d0b0: 4d 54 53 54 41 54 55 53 5f 4d 45 4d 55 53 45 44  MTSTATUS_MEMUSED
d0c0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 20   ){.    sqlite3 
d0d0: 2a 64 62 20 3d 20 70 56 64 62 65 2d 3e 64 62 3b  *db = pVdbe->db;
d0e0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  .    sqlite3_mut
d0f0: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74  ex_enter(db->mut
d100: 65 78 29 3b 0a 20 20 20 20 76 20 3d 20 30 3b 0a  ex);.    v = 0;.
d110: 20 20 20 20 64 62 2d 3e 70 6e 42 79 74 65 73 46      db->pnBytesF
d120: 72 65 65 64 20 3d 20 28 69 6e 74 2a 29 26 76 3b  reed = (int*)&v;
d130: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
d140: 43 6c 65 61 72 4f 62 6a 65 63 74 28 64 62 2c 20  ClearObject(db, 
d150: 70 56 64 62 65 29 3b 0a 20 20 20 20 73 71 6c 69  pVdbe);.    sqli
d160: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 56  te3DbFree(db, pV
d170: 64 62 65 29 3b 0a 20 20 20 20 64 62 2d 3e 70 6e  dbe);.    db->pn
d180: 42 79 74 65 73 46 72 65 65 64 20 3d 20 30 3b 0a  BytesFreed = 0;.
d190: 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65      sqlite3_mute
d1a0: 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65  x_leave(db->mute
d1b0: 78 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  x);.  }else{.   
d1c0: 20 76 20 3d 20 70 56 64 62 65 2d 3e 61 43 6f 75   v = pVdbe->aCou
d1d0: 6e 74 65 72 5b 6f 70 5d 3b 0a 20 20 20 20 69 66  nter[op];.    if
d1e0: 28 20 72 65 73 65 74 46 6c 61 67 20 29 20 70 56  ( resetFlag ) pV
d1f0: 64 62 65 2d 3e 61 43 6f 75 6e 74 65 72 5b 6f 70  dbe->aCounter[op
d200: 5d 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74  ] = 0;.  }.  ret
d210: 75 72 6e 20 28 69 6e 74 29 76 3b 0a 7d 0a 0a 2f  urn (int)v;.}../
d220: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
d230: 53 51 4c 20 61 73 73 6f 63 69 61 74 65 64 20 77  SQL associated w
d240: 69 74 68 20 61 20 70 72 65 70 61 72 65 64 20 73  ith a prepared s
d250: 74 61 74 65 6d 65 6e 74 0a 2a 2f 0a 63 6f 6e 73  tatement.*/.cons
d260: 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 5f  t char *sqlite3_
d270: 73 71 6c 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  sql(sqlite3_stmt
d280: 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62 65   *pStmt){.  Vdbe
d290: 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29 70 53   *p = (Vdbe *)pS
d2a0: 74 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 20  tmt;.  return p 
d2b0: 3f 20 70 2d 3e 7a 53 71 6c 20 3a 20 30 3b 0a 7d  ? p->zSql : 0;.}
d2c0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
d2d0: 68 65 20 53 51 4c 20 61 73 73 6f 63 69 61 74 65  he SQL associate
d2e0: 64 20 77 69 74 68 20 61 20 70 72 65 70 61 72 65  d with a prepare
d2f0: 64 20 73 74 61 74 65 6d 65 6e 74 20 77 69 74 68  d statement with
d300: 0a 2a 2a 20 62 6f 75 6e 64 20 70 61 72 61 6d 65  .** bound parame
d310: 74 65 72 73 20 65 78 70 61 6e 64 65 64 2e 20 20  ters expanded.  
d320: 53 70 61 63 65 20 74 6f 20 68 6f 6c 64 20 74 68  Space to hold th
d330: 65 20 72 65 74 75 72 6e 65 64 20 73 74 72 69 6e  e returned strin
d340: 67 20 69 73 0a 2a 2a 20 6f 62 74 61 69 6e 65 64  g is.** obtained
d350: 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 6d 61   from sqlite3_ma
d360: 6c 6c 6f 63 28 29 2e 20 20 54 68 65 20 63 61 6c  lloc().  The cal
d370: 6c 65 72 20 69 73 20 72 65 73 70 6f 6e 73 69 62  ler is responsib
d380: 6c 65 20 66 6f 72 0a 2a 2a 20 66 72 65 65 69 6e  le for.** freein
d390: 67 20 74 68 65 20 72 65 74 75 72 6e 65 64 20 73  g the returned s
d3a0: 74 72 69 6e 67 20 62 79 20 70 61 73 73 69 6e 67  tring by passing
d3b0: 20 69 74 20 74 6f 20 73 71 6c 69 74 65 33 5f 66   it to sqlite3_f
d3c0: 72 65 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  ree()..**.** The
d3d0: 20 53 51 4c 49 54 45 5f 54 52 41 43 45 5f 53 49   SQLITE_TRACE_SI
d3e0: 5a 45 5f 4c 49 4d 49 54 20 70 75 74 73 20 61 6e  ZE_LIMIT puts an
d3f0: 20 75 70 70 65 72 20 62 6f 75 6e 64 20 6f 6e 20   upper bound on 
d400: 74 68 65 20 73 69 7a 65 20 6f 66 0a 2a 2a 20 65  the size of.** e
d410: 78 70 61 6e 64 65 64 20 62 6f 75 6e 64 20 70 61  xpanded bound pa
d420: 72 61 6d 65 74 65 72 73 2e 0a 2a 2f 0a 63 68 61  rameters..*/.cha
d430: 72 20 2a 73 71 6c 69 74 65 33 5f 65 78 70 61 6e  r *sqlite3_expan
d440: 64 65 64 5f 73 71 6c 28 73 71 6c 69 74 65 33 5f  ded_sql(sqlite3_
d450: 73 74 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 23 69  stmt *pStmt){.#i
d460: 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  fdef SQLITE_OMIT
d470: 5f 54 52 41 43 45 0a 20 20 72 65 74 75 72 6e 20  _TRACE.  return 
d480: 30 3b 0a 23 65 6c 73 65 0a 20 20 63 68 61 72 20  0;.#else.  char 
d490: 2a 7a 20 3d 20 30 3b 0a 20 20 63 6f 6e 73 74 20  *z = 0;.  const 
d4a0: 63 68 61 72 20 2a 7a 53 71 6c 20 3d 20 73 71 6c  char *zSql = sql
d4b0: 69 74 65 33 5f 73 71 6c 28 70 53 74 6d 74 29 3b  ite3_sql(pStmt);
d4c0: 0a 20 20 69 66 28 20 7a 53 71 6c 20 29 7b 0a 20  .  if( zSql ){. 
d4d0: 20 20 20 56 64 62 65 20 2a 70 20 3d 20 28 56 64     Vdbe *p = (Vd
d4e0: 62 65 20 2a 29 70 53 74 6d 74 3b 0a 20 20 20 20  be *)pStmt;.    
d4f0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
d500: 74 65 72 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78  ter(p->db->mutex
d510: 29 3b 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69 74  );.    z = sqlit
d520: 65 33 56 64 62 65 45 78 70 61 6e 64 53 71 6c 28  e3VdbeExpandSql(
d530: 70 2c 20 7a 53 71 6c 29 3b 0a 20 20 20 20 73 71  p, zSql);.    sq
d540: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
d550: 65 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 3b  e(p->db->mutex);
d560: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 7a 3b  .  }.  return z;
d570: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 23 69 66 64 65  .#endif.}..#ifde
d580: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f  f SQLITE_ENABLE_
d590: 4e 4f 52 4d 41 4c 49 5a 45 0a 2f 2a 0a 2a 2a 20  NORMALIZE./*.** 
d5a0: 52 65 74 75 72 6e 20 74 68 65 20 6e 6f 72 6d 61  Return the norma
d5b0: 6c 69 7a 65 64 20 53 51 4c 20 61 73 73 6f 63 69  lized SQL associ
d5c0: 61 74 65 64 20 77 69 74 68 20 61 20 70 72 65 70  ated with a prep
d5d0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 2e 0a  ared statement..
d5e0: 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73  */.const char *s
d5f0: 71 6c 69 74 65 33 5f 6e 6f 72 6d 61 6c 69 7a 65  qlite3_normalize
d600: 64 5f 73 71 6c 28 73 71 6c 69 74 65 33 5f 73 74  d_sql(sqlite3_st
d610: 6d 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64  mt *pStmt){.  Vd
d620: 62 65 20 2a 70 20 3d 20 28 56 64 62 65 20 2a 29  be *p = (Vdbe *)
d630: 70 53 74 6d 74 3b 0a 20 20 69 66 28 20 70 3d 3d  pStmt;.  if( p==
d640: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20  0 ) return 0;.  
d650: 69 66 28 20 70 2d 3e 7a 4e 6f 72 6d 53 71 6c 3d  if( p->zNormSql=
d660: 3d 30 20 26 26 20 41 4c 57 41 59 53 28 70 2d 3e  =0 && ALWAYS(p->
d670: 7a 53 71 6c 21 3d 30 29 20 29 7b 0a 20 20 20 20  zSql!=0) ){.    
d680: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
d690: 74 65 72 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78  ter(p->db->mutex
d6a0: 29 3b 0a 20 20 20 20 70 2d 3e 7a 4e 6f 72 6d 53  );.    p->zNormS
d6b0: 71 6c 20 3d 20 73 71 6c 69 74 65 33 4e 6f 72 6d  ql = sqlite3Norm
d6c0: 61 6c 69 7a 65 28 70 2c 20 70 2d 3e 7a 53 71 6c  alize(p, p->zSql
d6d0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d  );.    sqlite3_m
d6e0: 75 74 65 78 5f 6c 65 61 76 65 28 70 2d 3e 64 62  utex_leave(p->db
d6f0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7d 0a 20 20  ->mutex);.  }.  
d700: 72 65 74 75 72 6e 20 70 2d 3e 7a 4e 6f 72 6d 53  return p->zNormS
d710: 71 6c 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20  ql;.}.#endif /* 
d720: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4e 4f  SQLITE_ENABLE_NO
d730: 52 4d 41 4c 49 5a 45 20 2a 2f 0a 0a 23 69 66 64  RMALIZE */..#ifd
d740: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ef SQLITE_ENABLE
d750: 5f 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b 0a  _PREUPDATE_HOOK.
d760: 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61  /*.** Allocate a
d770: 6e 64 20 70 6f 70 75 6c 61 74 65 20 61 6e 20 55  nd populate an U
d780: 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 20 73 74  npackedRecord st
d790: 72 75 63 74 75 72 65 20 62 61 73 65 64 20 6f 6e  ructure based on
d7a0: 20 74 68 65 20 73 65 72 69 61 6c 69 7a 65 64 0a   the serialized.
d7b0: 2a 2a 20 72 65 63 6f 72 64 20 69 6e 20 6e 4b 65  ** record in nKe
d7c0: 79 2f 70 4b 65 79 2e 20 52 65 74 75 72 6e 20 61  y/pKey. Return a
d7d0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
d7e0: 6e 65 77 20 55 6e 70 61 63 6b 65 64 52 65 63 6f  new UnpackedReco
d7f0: 72 64 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20  rd structure.** 
d800: 69 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 6f  if successful, o
d810: 72 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72  r a NULL pointer
d820: 20 69 66 20 61 6e 20 4f 4f 4d 20 65 72 72 6f 72   if an OOM error
d830: 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 2e   is encountered.
d840: 0a 2a 2f 0a 73 74 61 74 69 63 20 55 6e 70 61 63  .*/.static Unpac
d850: 6b 65 64 52 65 63 6f 72 64 20 2a 76 64 62 65 55  kedRecord *vdbeU
d860: 6e 70 61 63 6b 52 65 63 6f 72 64 28 0a 20 20 4b  npackRecord(.  K
d870: 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f  eyInfo *pKeyInfo
d880: 2c 20 0a 20 20 69 6e 74 20 6e 4b 65 79 2c 20 0a  , .  int nKey, .
d890: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b    const void *pK
d8a0: 65 79 0a 29 7b 0a 20 20 55 6e 70 61 63 6b 65 64  ey.){.  Unpacked
d8b0: 52 65 63 6f 72 64 20 2a 70 52 65 74 3b 20 20 20  Record *pRet;   
d8c0: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72          /* Retur
d8d0: 6e 20 76 61 6c 75 65 20 2a 2f 0a 0a 20 20 70 52  n value */..  pR
d8e0: 65 74 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  et = sqlite3Vdbe
d8f0: 41 6c 6c 6f 63 55 6e 70 61 63 6b 65 64 52 65 63  AllocUnpackedRec
d900: 6f 72 64 28 70 4b 65 79 49 6e 66 6f 29 3b 0a 20  ord(pKeyInfo);. 
d910: 20 69 66 28 20 70 52 65 74 20 29 7b 0a 20 20 20   if( pRet ){.   
d920: 20 6d 65 6d 73 65 74 28 70 52 65 74 2d 3e 61 4d   memset(pRet->aM
d930: 65 6d 2c 20 30 2c 20 73 69 7a 65 6f 66 28 4d 65  em, 0, sizeof(Me
d940: 6d 29 2a 28 70 4b 65 79 49 6e 66 6f 2d 3e 6e 4b  m)*(pKeyInfo->nK
d950: 65 79 46 69 65 6c 64 2b 31 29 29 3b 0a 20 20 20  eyField+1));.   
d960: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f   sqlite3VdbeReco
d970: 72 64 55 6e 70 61 63 6b 28 70 4b 65 79 49 6e 66  rdUnpack(pKeyInf
d980: 6f 2c 20 6e 4b 65 79 2c 20 70 4b 65 79 2c 20 70  o, nKey, pKey, p
d990: 52 65 74 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75  Ret);.  }.  retu
d9a0: 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a  rn pRet;.}../*.*
d9b0: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
d9c0: 69 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 77  is called from w
d9d0: 69 74 68 69 6e 20 61 20 70 72 65 2d 75 70 64 61  ithin a pre-upda
d9e0: 74 65 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20 72  te callback to r
d9f0: 65 74 72 69 65 76 65 0a 2a 2a 20 61 20 66 69 65  etrieve.** a fie
da00: 6c 64 20 6f 66 20 74 68 65 20 72 6f 77 20 63 75  ld of the row cu
da10: 72 72 65 6e 74 6c 79 20 62 65 69 6e 67 20 75 70  rrently being up
da20: 64 61 74 65 64 20 6f 72 20 64 65 6c 65 74 65 64  dated or deleted
da30: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
da40: 5f 70 72 65 75 70 64 61 74 65 5f 6f 6c 64 28 73  _preupdate_old(s
da50: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20  qlite3 *db, int 
da60: 69 49 64 78 2c 20 73 71 6c 69 74 65 33 5f 76 61  iIdx, sqlite3_va
da70: 6c 75 65 20 2a 2a 70 70 56 61 6c 75 65 29 7b 0a  lue **ppValue){.
da80: 20 20 50 72 65 55 70 64 61 74 65 20 2a 70 20 3d    PreUpdate *p =
da90: 20 64 62 2d 3e 70 50 72 65 55 70 64 61 74 65 3b   db->pPreUpdate;
daa0: 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 3b 0a 20 20  .  Mem *pMem;.  
dab0: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
dac0: 4f 4b 3b 0a 0a 20 20 2f 2a 20 54 65 73 74 20 74  OK;..  /* Test t
dad0: 68 61 74 20 74 68 69 73 20 63 61 6c 6c 20 69 73  hat this call is
dae0: 20 62 65 69 6e 67 20 6d 61 64 65 20 66 72 6f 6d   being made from
daf0: 20 77 69 74 68 69 6e 20 61 6e 20 53 51 4c 49 54   within an SQLIT
db00: 45 5f 44 45 4c 45 54 45 20 6f 72 0a 20 20 2a 2a  E_DELETE or.  **
db10: 20 53 51 4c 49 54 45 5f 55 50 44 41 54 45 20 70   SQLITE_UPDATE p
db20: 72 65 2d 75 70 64 61 74 65 20 63 61 6c 6c 62 61  re-update callba
db30: 63 6b 2c 20 61 6e 64 20 74 68 61 74 20 69 49 64  ck, and that iId
db40: 78 20 69 73 20 77 69 74 68 69 6e 20 72 61 6e 67  x is within rang
db50: 65 2e 20 2a 2f 0a 20 20 69 66 28 20 21 70 20 7c  e. */.  if( !p |
db60: 7c 20 70 2d 3e 6f 70 3d 3d 53 51 4c 49 54 45 5f  | p->op==SQLITE_
db70: 49 4e 53 45 52 54 20 29 7b 0a 20 20 20 20 72 63  INSERT ){.    rc
db80: 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45   = SQLITE_MISUSE
db90: 5f 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f 20  _BKPT;.    goto 
dba0: 70 72 65 75 70 64 61 74 65 5f 6f 6c 64 5f 6f 75  preupdate_old_ou
dbb0: 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e  t;.  }.  if( p->
dbc0: 70 50 6b 20 29 7b 0a 20 20 20 20 69 49 64 78 20  pPk ){.    iIdx 
dbd0: 3d 20 73 71 6c 69 74 65 33 43 6f 6c 75 6d 6e 4f  = sqlite3ColumnO
dbe0: 66 49 6e 64 65 78 28 70 2d 3e 70 50 6b 2c 20 69  fIndex(p->pPk, i
dbf0: 49 64 78 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  Idx);.  }.  if( 
dc00: 69 49 64 78 3e 3d 70 2d 3e 70 43 73 72 2d 3e 6e  iIdx>=p->pCsr->n
dc10: 46 69 65 6c 64 20 7c 7c 20 69 49 64 78 3c 30 20  Field || iIdx<0 
dc20: 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  ){.    rc = SQLI
dc30: 54 45 5f 52 41 4e 47 45 3b 0a 20 20 20 20 67 6f  TE_RANGE;.    go
dc40: 74 6f 20 70 72 65 75 70 64 61 74 65 5f 6f 6c 64  to preupdate_old
dc50: 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  _out;.  }..  /* 
dc60: 49 66 20 74 68 65 20 6f 6c 64 2e 2a 20 72 65 63  If the old.* rec
dc70: 6f 72 64 20 68 61 73 20 6e 6f 74 20 79 65 74 20  ord has not yet 
dc80: 62 65 65 6e 20 6c 6f 61 64 65 64 20 69 6e 74 6f  been loaded into
dc90: 20 6d 65 6d 6f 72 79 2c 20 64 6f 20 73 6f 20 6e   memory, do so n
dca0: 6f 77 2e 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e  ow. */.  if( p->
dcb0: 70 55 6e 70 61 63 6b 65 64 3d 3d 30 20 29 7b 0a  pUnpacked==0 ){.
dcc0: 20 20 20 20 75 33 32 20 6e 52 65 63 3b 0a 20 20      u32 nRec;.  
dcd0: 20 20 75 38 20 2a 61 52 65 63 3b 0a 0a 20 20 20    u8 *aRec;..   
dce0: 20 6e 52 65 63 20 3d 20 73 71 6c 69 74 65 33 42   nRec = sqlite3B
dcf0: 74 72 65 65 50 61 79 6c 6f 61 64 53 69 7a 65 28  treePayloadSize(
dd00: 70 2d 3e 70 43 73 72 2d 3e 75 63 2e 70 43 75 72  p->pCsr->uc.pCur
dd10: 73 6f 72 29 3b 0a 20 20 20 20 61 52 65 63 20 3d  sor);.    aRec =
dd20: 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63   sqlite3DbMalloc
dd30: 52 61 77 28 64 62 2c 20 6e 52 65 63 29 3b 0a 20  Raw(db, nRec);. 
dd40: 20 20 20 69 66 28 20 21 61 52 65 63 20 29 20 67     if( !aRec ) g
dd50: 6f 74 6f 20 70 72 65 75 70 64 61 74 65 5f 6f 6c  oto preupdate_ol
dd60: 64 5f 6f 75 74 3b 0a 20 20 20 20 72 63 20 3d 20  d_out;.    rc = 
dd70: 73 71 6c 69 74 65 33 42 74 72 65 65 50 61 79 6c  sqlite3BtreePayl
dd80: 6f 61 64 28 70 2d 3e 70 43 73 72 2d 3e 75 63 2e  oad(p->pCsr->uc.
dd90: 70 43 75 72 73 6f 72 2c 20 30 2c 20 6e 52 65 63  pCursor, 0, nRec
dda0: 2c 20 61 52 65 63 29 3b 0a 20 20 20 20 69 66 28  , aRec);.    if(
ddb0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
ddc0: 7b 0a 20 20 20 20 20 20 70 2d 3e 70 55 6e 70 61  {.      p->pUnpa
ddd0: 63 6b 65 64 20 3d 20 76 64 62 65 55 6e 70 61 63  cked = vdbeUnpac
dde0: 6b 52 65 63 6f 72 64 28 26 70 2d 3e 6b 65 79 69  kRecord(&p->keyi
ddf0: 6e 66 6f 2c 20 6e 52 65 63 2c 20 61 52 65 63 29  nfo, nRec, aRec)
de00: 3b 0a 20 20 20 20 20 20 69 66 28 20 21 70 2d 3e  ;.      if( !p->
de10: 70 55 6e 70 61 63 6b 65 64 20 29 20 72 63 20 3d  pUnpacked ) rc =
de20: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
de30: 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 21     }.    if( rc!
de40: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
de50: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65      sqlite3DbFre
de60: 65 28 64 62 2c 20 61 52 65 63 29 3b 0a 20 20 20  e(db, aRec);.   
de70: 20 20 20 67 6f 74 6f 20 70 72 65 75 70 64 61 74     goto preupdat
de80: 65 5f 6f 6c 64 5f 6f 75 74 3b 0a 20 20 20 20 7d  e_old_out;.    }
de90: 0a 20 20 20 20 70 2d 3e 61 52 65 63 6f 72 64 20  .    p->aRecord 
dea0: 3d 20 61 52 65 63 3b 0a 20 20 7d 0a 0a 20 20 70  = aRec;.  }..  p
deb0: 4d 65 6d 20 3d 20 2a 70 70 56 61 6c 75 65 20 3d  Mem = *ppValue =
dec0: 20 26 70 2d 3e 70 55 6e 70 61 63 6b 65 64 2d 3e   &p->pUnpacked->
ded0: 61 4d 65 6d 5b 69 49 64 78 5d 3b 0a 20 20 69 66  aMem[iIdx];.  if
dee0: 28 20 69 49 64 78 3d 3d 70 2d 3e 70 54 61 62 2d  ( iIdx==p->pTab-
def0: 3e 69 50 4b 65 79 20 29 7b 0a 20 20 20 20 73 71  >iPKey ){.    sq
df00: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49  lite3VdbeMemSetI
df10: 6e 74 36 34 28 70 4d 65 6d 2c 20 70 2d 3e 69 4b  nt64(pMem, p->iK
df20: 65 79 31 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66  ey1);.  }else if
df30: 28 20 69 49 64 78 3e 3d 70 2d 3e 70 55 6e 70 61  ( iIdx>=p->pUnpa
df40: 63 6b 65 64 2d 3e 6e 46 69 65 6c 64 20 29 7b 0a  cked->nField ){.
df50: 20 20 20 20 2a 70 70 56 61 6c 75 65 20 3d 20 28      *ppValue = (
df60: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 29  sqlite3_value *)
df70: 63 6f 6c 75 6d 6e 4e 75 6c 6c 56 61 6c 75 65 28  columnNullValue(
df80: 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70  );.  }else if( p
df90: 2d 3e 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 49 64  ->pTab->aCol[iId
dfa0: 78 5d 2e 61 66 66 69 6e 69 74 79 3d 3d 53 51 4c  x].affinity==SQL
dfb0: 49 54 45 5f 41 46 46 5f 52 45 41 4c 20 29 7b 0a  ITE_AFF_REAL ){.
dfc0: 20 20 20 20 69 66 28 20 70 4d 65 6d 2d 3e 66 6c      if( pMem->fl
dfd0: 61 67 73 20 26 20 28 4d 45 4d 5f 49 6e 74 7c 4d  ags & (MEM_Int|M
dfe0: 45 4d 5f 49 6e 74 52 65 61 6c 29 20 29 7b 0a 20  EM_IntReal) ){. 
dff0: 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70       testcase( p
e000: 4d 65 6d 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d  Mem->flags & MEM
e010: 5f 49 6e 74 20 29 3b 0a 20 20 20 20 20 20 74 65  _Int );.      te
e020: 73 74 63 61 73 65 28 20 70 4d 65 6d 2d 3e 66 6c  stcase( pMem->fl
e030: 61 67 73 20 26 20 4d 45 4d 5f 49 6e 74 52 65 61  ags & MEM_IntRea
e040: 6c 20 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  l );.      sqlit
e050: 65 33 56 64 62 65 4d 65 6d 52 65 61 6c 69 66 79  e3VdbeMemRealify
e060: 28 70 4d 65 6d 29 3b 0a 20 20 20 20 7d 0a 20 20  (pMem);.    }.  
e070: 7d 0a 0a 20 70 72 65 75 70 64 61 74 65 5f 6f 6c  }.. preupdate_ol
e080: 64 5f 6f 75 74 3a 0a 20 20 73 71 6c 69 74 65 33  d_out:.  sqlite3
e090: 45 72 72 6f 72 28 64 62 2c 20 72 63 29 3b 0a 20  Error(db, rc);. 
e0a0: 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41   return sqlite3A
e0b0: 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a  piExit(db, rc);.
e0c0: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49  }.#endif /* SQLI
e0d0: 54 45 5f 45 4e 41 42 4c 45 5f 50 52 45 55 50 44  TE_ENABLE_PREUPD
e0e0: 41 54 45 5f 48 4f 4f 4b 20 2a 2f 0a 0a 23 69 66  ATE_HOOK */..#if
e0f0: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c  def SQLITE_ENABL
e100: 45 5f 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b  E_PREUPDATE_HOOK
e110: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
e120: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 66  tion is called f
e130: 72 6f 6d 20 77 69 74 68 69 6e 20 61 20 70 72 65  rom within a pre
e140: 2d 75 70 64 61 74 65 20 63 61 6c 6c 62 61 63 6b  -update callback
e150: 20 74 6f 20 72 65 74 72 69 65 76 65 0a 2a 2a 20   to retrieve.** 
e160: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  the number of co
e170: 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 72 6f 77  lumns in the row
e180: 20 62 65 69 6e 67 20 75 70 64 61 74 65 64 2c 20   being updated, 
e190: 64 65 6c 65 74 65 64 20 6f 72 20 69 6e 73 65 72  deleted or inser
e1a0: 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ted..*/.int sqli
e1b0: 74 65 33 5f 70 72 65 75 70 64 61 74 65 5f 63 6f  te3_preupdate_co
e1c0: 75 6e 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29  unt(sqlite3 *db)
e1d0: 7b 0a 20 20 50 72 65 55 70 64 61 74 65 20 2a 70  {.  PreUpdate *p
e1e0: 20 3d 20 64 62 2d 3e 70 50 72 65 55 70 64 61 74   = db->pPreUpdat
e1f0: 65 3b 0a 20 20 72 65 74 75 72 6e 20 28 70 20 3f  e;.  return (p ?
e200: 20 70 2d 3e 6b 65 79 69 6e 66 6f 2e 6e 4b 65 79   p->keyinfo.nKey
e210: 46 69 65 6c 64 20 3a 20 30 29 3b 0a 7d 0a 23 65  Field : 0);.}.#e
e220: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45  ndif /* SQLITE_E
e230: 4e 41 42 4c 45 5f 50 52 45 55 50 44 41 54 45 5f  NABLE_PREUPDATE_
e240: 48 4f 4f 4b 20 2a 2f 0a 0a 23 69 66 64 65 66 20  HOOK */..#ifdef 
e250: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 50 52  SQLITE_ENABLE_PR
e260: 45 55 50 44 41 54 45 5f 48 4f 4f 4b 0a 2f 2a 0a  EUPDATE_HOOK./*.
e270: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
e280: 20 69 73 20 64 65 73 69 67 6e 65 64 20 74 6f 20   is designed to 
e290: 62 65 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 77  be called from w
e2a0: 69 74 68 69 6e 20 61 20 70 72 65 2d 75 70 64 61  ithin a pre-upda
e2b0: 74 65 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 6f  te callback.** o
e2c0: 6e 6c 79 2e 20 49 74 20 72 65 74 75 72 6e 73 20  nly. It returns 
e2d0: 7a 65 72 6f 20 69 66 20 74 68 65 20 63 68 61 6e  zero if the chan
e2e0: 67 65 20 74 68 61 74 20 63 61 75 73 65 64 20 74  ge that caused t
e2f0: 68 65 20 63 61 6c 6c 62 61 63 6b 20 77 61 73 20  he callback was 
e300: 6d 61 64 65 0a 2a 2a 20 69 6d 6d 65 64 69 61 74  made.** immediat
e310: 65 6c 79 20 62 79 20 61 20 75 73 65 72 20 53 51  ely by a user SQ
e320: 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 4f 72 2c  L statement. Or,
e330: 20 69 66 20 74 68 65 20 63 68 61 6e 67 65 20 77   if the change w
e340: 61 73 20 6d 61 64 65 20 62 79 20 61 0a 2a 2a 20  as made by a.** 
e350: 74 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d 2c  trigger program,
e360: 20 69 74 20 72 65 74 75 72 6e 73 20 74 68 65 20   it returns the 
e370: 6e 75 6d 62 65 72 20 6f 66 20 74 72 69 67 67 65  number of trigge
e380: 72 20 70 72 6f 67 72 61 6d 73 20 63 75 72 72 65  r programs curre
e390: 6e 74 6c 79 0a 2a 2a 20 6f 6e 20 74 68 65 20 73  ntly.** on the s
e3a0: 74 61 63 6b 20 28 31 20 66 6f 72 20 61 20 74 6f  tack (1 for a to
e3b0: 70 2d 6c 65 76 65 6c 20 74 72 69 67 67 65 72 2c  p-level trigger,
e3c0: 20 32 20 66 6f 72 20 61 20 74 72 69 67 67 65 72   2 for a trigger
e3d0: 20 66 69 72 65 64 20 62 79 20 61 20 0a 2a 2a 20   fired by a .** 
e3e0: 74 6f 70 2d 6c 65 76 65 6c 20 74 72 69 67 67 65  top-level trigge
e3f0: 72 20 65 74 63 2e 29 2e 0a 2a 2a 0a 2a 2a 20 46  r etc.)..**.** F
e400: 6f 72 20 74 68 65 20 70 75 72 70 6f 73 65 73 20  or the purposes 
e410: 6f 66 20 74 68 65 20 70 72 65 76 69 6f 75 73 20  of the previous 
e420: 70 61 72 61 67 72 61 70 68 2c 20 61 20 66 6f 72  paragraph, a for
e430: 65 69 67 6e 20 6b 65 79 20 43 41 53 43 41 44 45  eign key CASCADE
e440: 2c 20 53 45 54 20 4e 55 4c 4c 0a 2a 2a 20 6f 72  , SET NULL.** or
e450: 20 53 45 54 20 44 45 46 41 55 4c 54 20 61 63 74   SET DEFAULT act
e460: 69 6f 6e 20 69 73 20 63 6f 6e 73 69 64 65 72 65  ion is considere
e470: 64 20 61 20 74 72 69 67 67 65 72 2e 0a 2a 2f 0a  d a trigger..*/.
e480: 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 75  int sqlite3_preu
e490: 70 64 61 74 65 5f 64 65 70 74 68 28 73 71 6c 69  pdate_depth(sqli
e4a0: 74 65 33 20 2a 64 62 29 7b 0a 20 20 50 72 65 55  te3 *db){.  PreU
e4b0: 70 64 61 74 65 20 2a 70 20 3d 20 64 62 2d 3e 70  pdate *p = db->p
e4c0: 50 72 65 55 70 64 61 74 65 3b 0a 20 20 72 65 74  PreUpdate;.  ret
e4d0: 75 72 6e 20 28 70 20 3f 20 70 2d 3e 76 2d 3e 6e  urn (p ? p->v->n
e4e0: 46 72 61 6d 65 20 3a 20 30 29 3b 0a 7d 0a 23 65  Frame : 0);.}.#e
e4f0: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45  ndif /* SQLITE_E
e500: 4e 41 42 4c 45 5f 50 52 45 55 50 44 41 54 45 5f  NABLE_PREUPDATE_
e510: 48 4f 4f 4b 20 2a 2f 0a 0a 23 69 66 64 65 66 20  HOOK */..#ifdef 
e520: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 50 52  SQLITE_ENABLE_PR
e530: 45 55 50 44 41 54 45 5f 48 4f 4f 4b 0a 2f 2a 0a  EUPDATE_HOOK./*.
e540: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
e550: 20 69 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20   is called from 
e560: 77 69 74 68 69 6e 20 61 20 70 72 65 2d 75 70 64  within a pre-upd
e570: 61 74 65 20 63 61 6c 6c 62 61 63 6b 20 74 6f 20  ate callback to 
e580: 72 65 74 72 69 65 76 65 0a 2a 2a 20 61 20 66 69  retrieve.** a fi
e590: 65 6c 64 20 6f 66 20 74 68 65 20 72 6f 77 20 63  eld of the row c
e5a0: 75 72 72 65 6e 74 6c 79 20 62 65 69 6e 67 20 75  urrently being u
e5b0: 70 64 61 74 65 64 20 6f 72 20 69 6e 73 65 72 74  pdated or insert
e5c0: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ed..*/.int sqlit
e5d0: 65 33 5f 70 72 65 75 70 64 61 74 65 5f 6e 65 77  e3_preupdate_new
e5e0: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e  (sqlite3 *db, in
e5f0: 74 20 69 49 64 78 2c 20 73 71 6c 69 74 65 33 5f  t iIdx, sqlite3_
e600: 76 61 6c 75 65 20 2a 2a 70 70 56 61 6c 75 65 29  value **ppValue)
e610: 7b 0a 20 20 50 72 65 55 70 64 61 74 65 20 2a 70  {.  PreUpdate *p
e620: 20 3d 20 64 62 2d 3e 70 50 72 65 55 70 64 61 74   = db->pPreUpdat
e630: 65 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  e;.  int rc = SQ
e640: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4d 65 6d 20 2a  LITE_OK;.  Mem *
e650: 70 4d 65 6d 3b 0a 0a 20 20 69 66 28 20 21 70 20  pMem;..  if( !p 
e660: 7c 7c 20 70 2d 3e 6f 70 3d 3d 53 51 4c 49 54 45  || p->op==SQLITE
e670: 5f 44 45 4c 45 54 45 20 29 7b 0a 20 20 20 20 72  _DELETE ){.    r
e680: 63 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  c = SQLITE_MISUS
e690: 45 5f 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f  E_BKPT;.    goto
e6a0: 20 70 72 65 75 70 64 61 74 65 5f 6e 65 77 5f 6f   preupdate_new_o
e6b0: 75 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d  ut;.  }.  if( p-
e6c0: 3e 70 50 6b 20 26 26 20 70 2d 3e 6f 70 21 3d 53  >pPk && p->op!=S
e6d0: 51 4c 49 54 45 5f 55 50 44 41 54 45 20 29 7b 0a  QLITE_UPDATE ){.
e6e0: 20 20 20 20 69 49 64 78 20 3d 20 73 71 6c 69 74      iIdx = sqlit
e6f0: 65 33 43 6f 6c 75 6d 6e 4f 66 49 6e 64 65 78 28  e3ColumnOfIndex(
e700: 70 2d 3e 70 50 6b 2c 20 69 49 64 78 29 3b 0a 20  p->pPk, iIdx);. 
e710: 20 7d 0a 20 20 69 66 28 20 69 49 64 78 3e 3d 70   }.  if( iIdx>=p
e720: 2d 3e 70 43 73 72 2d 3e 6e 46 69 65 6c 64 20 7c  ->pCsr->nField |
e730: 7c 20 69 49 64 78 3c 30 20 29 7b 0a 20 20 20 20  | iIdx<0 ){.    
e740: 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 41 4e 47  rc = SQLITE_RANG
e750: 45 3b 0a 20 20 20 20 67 6f 74 6f 20 70 72 65 75  E;.    goto preu
e760: 70 64 61 74 65 5f 6e 65 77 5f 6f 75 74 3b 0a 20  pdate_new_out;. 
e770: 20 7d 0a 0a 20 20 69 66 28 20 70 2d 3e 6f 70 3d   }..  if( p->op=
e780: 3d 53 51 4c 49 54 45 5f 49 4e 53 45 52 54 20 29  =SQLITE_INSERT )
e790: 7b 0a 20 20 20 20 2f 2a 20 46 6f 72 20 61 6e 20  {.    /* For an 
e7a0: 49 4e 53 45 52 54 2c 20 6d 65 6d 6f 72 79 20 63  INSERT, memory c
e7b0: 65 6c 6c 20 70 2d 3e 69 4e 65 77 52 65 67 20 63  ell p->iNewReg c
e7c0: 6f 6e 74 61 69 6e 73 20 74 68 65 20 73 65 72 69  ontains the seri
e7d0: 61 6c 69 7a 65 64 20 72 65 63 6f 72 64 0a 20 20  alized record.  
e7e0: 20 20 2a 2a 20 74 68 61 74 20 69 73 20 62 65 69    ** that is bei
e7f0: 6e 67 20 69 6e 73 65 72 74 65 64 2e 20 44 65 73  ng inserted. Des
e800: 65 72 69 61 6c 69 7a 65 20 69 74 2e 20 2a 2f 0a  erialize it. */.
e810: 20 20 20 20 55 6e 70 61 63 6b 65 64 52 65 63 6f      UnpackedReco
e820: 72 64 20 2a 70 55 6e 70 61 63 6b 20 3d 20 70 2d  rd *pUnpack = p-
e830: 3e 70 4e 65 77 55 6e 70 61 63 6b 65 64 3b 0a 20  >pNewUnpacked;. 
e840: 20 20 20 69 66 28 20 21 70 55 6e 70 61 63 6b 20     if( !pUnpack 
e850: 29 7b 0a 20 20 20 20 20 20 4d 65 6d 20 2a 70 44  ){.      Mem *pD
e860: 61 74 61 20 3d 20 26 70 2d 3e 76 2d 3e 61 4d 65  ata = &p->v->aMe
e870: 6d 5b 70 2d 3e 69 4e 65 77 52 65 67 5d 3b 0a 20  m[p->iNewReg];. 
e880: 20 20 20 20 20 72 63 20 3d 20 45 78 70 61 6e 64       rc = Expand
e890: 42 6c 6f 62 28 70 44 61 74 61 29 3b 0a 20 20 20  Blob(pData);.   
e8a0: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
e8b0: 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 70 72 65 75  E_OK ) goto preu
e8c0: 70 64 61 74 65 5f 6e 65 77 5f 6f 75 74 3b 0a 20  pdate_new_out;. 
e8d0: 20 20 20 20 20 70 55 6e 70 61 63 6b 20 3d 20 76       pUnpack = v
e8e0: 64 62 65 55 6e 70 61 63 6b 52 65 63 6f 72 64 28  dbeUnpackRecord(
e8f0: 26 70 2d 3e 6b 65 79 69 6e 66 6f 2c 20 70 44 61  &p->keyinfo, pDa
e900: 74 61 2d 3e 6e 2c 20 70 44 61 74 61 2d 3e 7a 29  ta->n, pData->z)
e910: 3b 0a 20 20 20 20 20 20 69 66 28 20 21 70 55 6e  ;.      if( !pUn
e920: 70 61 63 6b 20 29 7b 0a 20 20 20 20 20 20 20 20  pack ){.        
e930: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  rc = SQLITE_NOME
e940: 4d 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20  M;.        goto 
e950: 70 72 65 75 70 64 61 74 65 5f 6e 65 77 5f 6f 75  preupdate_new_ou
e960: 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  t;.      }.     
e970: 20 70 2d 3e 70 4e 65 77 55 6e 70 61 63 6b 65 64   p->pNewUnpacked
e980: 20 3d 20 70 55 6e 70 61 63 6b 3b 0a 20 20 20 20   = pUnpack;.    
e990: 7d 0a 20 20 20 20 70 4d 65 6d 20 3d 20 26 70 55  }.    pMem = &pU
e9a0: 6e 70 61 63 6b 2d 3e 61 4d 65 6d 5b 69 49 64 78  npack->aMem[iIdx
e9b0: 5d 3b 0a 20 20 20 20 69 66 28 20 69 49 64 78 3d  ];.    if( iIdx=
e9c0: 3d 70 2d 3e 70 54 61 62 2d 3e 69 50 4b 65 79 20  =p->pTab->iPKey 
e9d0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
e9e0: 56 64 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 28  VdbeMemSetInt64(
e9f0: 70 4d 65 6d 2c 20 70 2d 3e 69 4b 65 79 32 29 3b  pMem, p->iKey2);
ea00: 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 69  .    }else if( i
ea10: 49 64 78 3e 3d 70 55 6e 70 61 63 6b 2d 3e 6e 46  Idx>=pUnpack->nF
ea20: 69 65 6c 64 20 29 7b 0a 20 20 20 20 20 20 70 4d  ield ){.      pM
ea30: 65 6d 20 3d 20 28 73 71 6c 69 74 65 33 5f 76 61  em = (sqlite3_va
ea40: 6c 75 65 20 2a 29 63 6f 6c 75 6d 6e 4e 75 6c 6c  lue *)columnNull
ea50: 56 61 6c 75 65 28 29 3b 0a 20 20 20 20 7d 0a 20  Value();.    }. 
ea60: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 46   }else{.    /* F
ea70: 6f 72 20 61 6e 20 55 50 44 41 54 45 2c 20 6d 65  or an UPDATE, me
ea80: 6d 6f 72 79 20 63 65 6c 6c 20 28 70 2d 3e 69 4e  mory cell (p->iN
ea90: 65 77 52 65 67 2b 31 2b 69 49 64 78 29 20 63 6f  ewReg+1+iIdx) co
eaa0: 6e 74 61 69 6e 73 20 74 68 65 20 72 65 71 75 69  ntains the requi
eab0: 72 65 64 0a 20 20 20 20 2a 2a 20 76 61 6c 75 65  red.    ** value
eac0: 2e 20 4d 61 6b 65 20 61 20 63 6f 70 79 20 6f 66  . Make a copy of
ead0: 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e   the cell conten
eae0: 74 73 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20  ts and return a 
eaf0: 70 6f 69 6e 74 65 72 20 74 6f 20 69 74 2e 0a 20  pointer to it.. 
eb00: 20 20 20 2a 2a 20 49 74 20 69 73 20 6e 6f 74 20     ** It is not 
eb10: 73 61 66 65 20 74 6f 20 72 65 74 75 72 6e 20 61  safe to return a
eb20: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
eb30: 6d 65 6d 6f 72 79 20 63 65 6c 6c 20 69 74 73 65  memory cell itse
eb40: 6c 66 20 61 73 20 74 68 65 0a 20 20 20 20 2a 2a  lf as the.    **
eb50: 20 63 61 6c 6c 65 72 20 6d 61 79 20 6d 6f 64 69   caller may modi
eb60: 66 79 20 74 68 65 20 76 61 6c 75 65 20 74 65 78  fy the value tex
eb70: 74 20 65 6e 63 6f 64 69 6e 67 2e 0a 20 20 20 20  t encoding..    
eb80: 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  */.    assert( p
eb90: 2d 3e 6f 70 3d 3d 53 51 4c 49 54 45 5f 55 50 44  ->op==SQLITE_UPD
eba0: 41 54 45 20 29 3b 0a 20 20 20 20 69 66 28 20 21  ATE );.    if( !
ebb0: 70 2d 3e 61 4e 65 77 20 29 7b 0a 20 20 20 20 20  p->aNew ){.     
ebc0: 20 70 2d 3e 61 4e 65 77 20 3d 20 28 4d 65 6d 20   p->aNew = (Mem 
ebd0: 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f  *)sqlite3DbMallo
ebe0: 63 5a 65 72 6f 28 64 62 2c 20 73 69 7a 65 6f 66  cZero(db, sizeof
ebf0: 28 4d 65 6d 29 20 2a 20 70 2d 3e 70 43 73 72 2d  (Mem) * p->pCsr-
ec00: 3e 6e 46 69 65 6c 64 29 3b 0a 20 20 20 20 20 20  >nField);.      
ec10: 69 66 28 20 21 70 2d 3e 61 4e 65 77 20 29 7b 0a  if( !p->aNew ){.
ec20: 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c          rc = SQL
ec30: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20  ITE_NOMEM;.     
ec40: 20 20 20 67 6f 74 6f 20 70 72 65 75 70 64 61 74     goto preupdat
ec50: 65 5f 6e 65 77 5f 6f 75 74 3b 0a 20 20 20 20 20  e_new_out;.     
ec60: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73   }.    }.    ass
ec70: 65 72 74 28 20 69 49 64 78 3e 3d 30 20 26 26 20  ert( iIdx>=0 && 
ec80: 69 49 64 78 3c 70 2d 3e 70 43 73 72 2d 3e 6e 46  iIdx<p->pCsr->nF
ec90: 69 65 6c 64 20 29 3b 0a 20 20 20 20 70 4d 65 6d  ield );.    pMem
eca0: 20 3d 20 26 70 2d 3e 61 4e 65 77 5b 69 49 64 78   = &p->aNew[iIdx
ecb0: 5d 3b 0a 20 20 20 20 69 66 28 20 70 4d 65 6d 2d  ];.    if( pMem-
ecc0: 3e 66 6c 61 67 73 3d 3d 30 20 29 7b 0a 20 20 20  >flags==0 ){.   
ecd0: 20 20 20 69 66 28 20 69 49 64 78 3d 3d 70 2d 3e     if( iIdx==p->
ece0: 70 54 61 62 2d 3e 69 50 4b 65 79 20 29 7b 0a 20  pTab->iPKey ){. 
ecf0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64         sqlite3Vd
ed00: 62 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 70 4d  beMemSetInt64(pM
ed10: 65 6d 2c 20 70 2d 3e 69 4b 65 79 32 29 3b 0a 20  em, p->iKey2);. 
ed20: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
ed30: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
ed40: 56 64 62 65 4d 65 6d 43 6f 70 79 28 70 4d 65 6d  VdbeMemCopy(pMem
ed50: 2c 20 26 70 2d 3e 76 2d 3e 61 4d 65 6d 5b 70 2d  , &p->v->aMem[p-
ed60: 3e 69 4e 65 77 52 65 67 2b 31 2b 69 49 64 78 5d  >iNewReg+1+iIdx]
ed70: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72  );.        if( r
ed80: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67  c!=SQLITE_OK ) g
ed90: 6f 74 6f 20 70 72 65 75 70 64 61 74 65 5f 6e 65  oto preupdate_ne
eda0: 77 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d 0a 20  w_out;.      }. 
edb0: 20 20 20 7d 0a 20 20 7d 0a 20 20 2a 70 70 56 61     }.  }.  *ppVa
edc0: 6c 75 65 20 3d 20 70 4d 65 6d 3b 0a 0a 20 70 72  lue = pMem;.. pr
edd0: 65 75 70 64 61 74 65 5f 6e 65 77 5f 6f 75 74 3a  eupdate_new_out:
ede0: 0a 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28  .  sqlite3Error(
edf0: 64 62 2c 20 72 63 29 3b 0a 20 20 72 65 74 75 72  db, rc);.  retur
ee00: 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74  n sqlite3ApiExit
ee10: 28 64 62 2c 20 72 63 29 3b 0a 7d 0a 23 65 6e 64  (db, rc);.}.#end
ee20: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41  if /* SQLITE_ENA
ee30: 42 4c 45 5f 50 52 45 55 50 44 41 54 45 5f 48 4f  BLE_PREUPDATE_HO
ee40: 4f 4b 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51  OK */..#ifdef SQ
ee50: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 4d 54  LITE_ENABLE_STMT
ee60: 5f 53 43 41 4e 53 54 41 54 55 53 0a 2f 2a 0a 2a  _SCANSTATUS./*.*
ee70: 2a 20 52 65 74 75 72 6e 20 73 74 61 74 75 73 20  * Return status 
ee80: 64 61 74 61 20 66 6f 72 20 61 20 73 69 6e 67 6c  data for a singl
ee90: 65 20 6c 6f 6f 70 20 77 69 74 68 69 6e 20 71 75  e loop within qu
eea0: 65 72 79 20 70 53 74 6d 74 2e 0a 2a 2f 0a 69 6e  ery pStmt..*/.in
eeb0: 74 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 5f 73  t sqlite3_stmt_s
eec0: 63 61 6e 73 74 61 74 75 73 28 0a 20 20 73 71 6c  canstatus(.  sql
eed0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74  ite3_stmt *pStmt
eee0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ,            /* 
eef0: 50 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  Prepared stateme
ef00: 6e 74 20 62 65 69 6e 67 20 71 75 65 72 69 65 64  nt being queried
ef10: 20 2a 2f 0a 20 20 69 6e 74 20 69 64 78 2c 20 20   */.  int idx,  
ef20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ef30: 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f        /* Index o
ef40: 66 20 6c 6f 6f 70 20 74 6f 20 72 65 70 6f 72 74  f loop to report
ef50: 20 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 69 53 63   on */.  int iSc
ef60: 61 6e 53 74 61 74 75 73 4f 70 2c 20 20 20 20 20  anStatusOp,     
ef70: 20 20 20 20 20 20 20 20 20 2f 2a 20 57 68 69 63           /* Whic
ef80: 68 20 6d 65 74 72 69 63 20 74 6f 20 72 65 74 75  h metric to retu
ef90: 72 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 4f  rn */.  void *pO
efa0: 75 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ut              
efb0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20          /* OUT: 
efc0: 57 72 69 74 65 20 74 68 65 20 61 6e 73 77 65 72  Write the answer
efd0: 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 56 64   here */.){.  Vd
efe0: 62 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70  be *p = (Vdbe*)p
eff0: 53 74 6d 74 3b 0a 20 20 53 63 61 6e 53 74 61 74  Stmt;.  ScanStat
f000: 75 73 20 2a 70 53 63 61 6e 3b 0a 20 20 69 66 28  us *pScan;.  if(
f010: 20 69 64 78 3c 30 20 7c 7c 20 69 64 78 3e 3d 70   idx<0 || idx>=p
f020: 2d 3e 6e 53 63 61 6e 20 29 20 72 65 74 75 72 6e  ->nScan ) return
f030: 20 31 3b 0a 20 20 70 53 63 61 6e 20 3d 20 26 70   1;.  pScan = &p
f040: 2d 3e 61 53 63 61 6e 5b 69 64 78 5d 3b 0a 20 20  ->aScan[idx];.  
f050: 73 77 69 74 63 68 28 20 69 53 63 61 6e 53 74 61  switch( iScanSta
f060: 74 75 73 4f 70 20 29 7b 0a 20 20 20 20 63 61 73  tusOp ){.    cas
f070: 65 20 53 51 4c 49 54 45 5f 53 43 41 4e 53 54 41  e SQLITE_SCANSTA
f080: 54 5f 4e 4c 4f 4f 50 3a 20 7b 0a 20 20 20 20 20  T_NLOOP: {.     
f090: 20 2a 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34   *(sqlite3_int64
f0a0: 2a 29 70 4f 75 74 20 3d 20 70 2d 3e 61 6e 45 78  *)pOut = p->anEx
f0b0: 65 63 5b 70 53 63 61 6e 2d 3e 61 64 64 72 4c 6f  ec[pScan->addrLo
f0c0: 6f 70 5d 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  op];.      break
f0d0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65  ;.    }.    case
f0e0: 20 53 51 4c 49 54 45 5f 53 43 41 4e 53 54 41 54   SQLITE_SCANSTAT
f0f0: 5f 4e 56 49 53 49 54 3a 20 7b 0a 20 20 20 20 20  _NVISIT: {.     
f100: 20 2a 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34   *(sqlite3_int64
f110: 2a 29 70 4f 75 74 20 3d 20 70 2d 3e 61 6e 45 78  *)pOut = p->anEx
f120: 65 63 5b 70 53 63 61 6e 2d 3e 61 64 64 72 56 69  ec[pScan->addrVi
f130: 73 69 74 5d 3b 0a 20 20 20 20 20 20 62 72 65 61  sit];.      brea
f140: 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73  k;.    }.    cas
f150: 65 20 53 51 4c 49 54 45 5f 53 43 41 4e 53 54 41  e SQLITE_SCANSTA
f160: 54 5f 45 53 54 3a 20 7b 0a 20 20 20 20 20 20 64  T_EST: {.      d
f170: 6f 75 62 6c 65 20 72 20 3d 20 31 2e 30 3b 0a 20  ouble r = 1.0;. 
f180: 20 20 20 20 20 4c 6f 67 45 73 74 20 78 20 3d 20       LogEst x = 
f190: 70 53 63 61 6e 2d 3e 6e 45 73 74 3b 0a 20 20 20  pScan->nEst;.   
f1a0: 20 20 20 77 68 69 6c 65 28 20 78 3c 31 30 30 20     while( x<100 
f1b0: 29 7b 0a 20 20 20 20 20 20 20 20 78 20 2b 3d 20  ){.        x += 
f1c0: 31 30 3b 0a 20 20 20 20 20 20 20 20 72 20 2a 3d  10;.        r *=
f1d0: 20 30 2e 35 3b 0a 20 20 20 20 20 20 7d 0a 20 20   0.5;.      }.  
f1e0: 20 20 20 20 2a 28 64 6f 75 62 6c 65 2a 29 70 4f      *(double*)pO
f1f0: 75 74 20 3d 20 72 2a 73 71 6c 69 74 65 33 4c 6f  ut = r*sqlite3Lo
f200: 67 45 73 74 54 6f 49 6e 74 28 78 29 3b 0a 20 20  gEstToInt(x);.  
f210: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
f220: 0a 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 45  .    case SQLITE
f230: 5f 53 43 41 4e 53 54 41 54 5f 4e 41 4d 45 3a 20  _SCANSTAT_NAME: 
f240: 7b 0a 20 20 20 20 20 20 2a 28 63 6f 6e 73 74 20  {.      *(const 
f250: 63 68 61 72 2a 2a 29 70 4f 75 74 20 3d 20 70 53  char**)pOut = pS
f260: 63 61 6e 2d 3e 7a 4e 61 6d 65 3b 0a 20 20 20 20  can->zName;.    
f270: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20    break;.    }. 
f280: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53     case SQLITE_S
f290: 43 41 4e 53 54 41 54 5f 45 58 50 4c 41 49 4e 3a  CANSTAT_EXPLAIN:
f2a0: 20 7b 0a 20 20 20 20 20 20 69 66 28 20 70 53 63   {.      if( pSc
f2b0: 61 6e 2d 3e 61 64 64 72 45 78 70 6c 61 69 6e 20  an->addrExplain 
f2c0: 29 7b 0a 20 20 20 20 20 20 20 20 2a 28 63 6f 6e  ){.        *(con
f2d0: 73 74 20 63 68 61 72 2a 2a 29 70 4f 75 74 20 3d  st char**)pOut =
f2e0: 20 70 2d 3e 61 4f 70 5b 20 70 53 63 61 6e 2d 3e   p->aOp[ pScan->
f2f0: 61 64 64 72 45 78 70 6c 61 69 6e 20 5d 2e 70 34  addrExplain ].p4
f300: 2e 7a 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b  .z;.      }else{
f310: 0a 20 20 20 20 20 20 20 20 2a 28 63 6f 6e 73 74  .        *(const
f320: 20 63 68 61 72 2a 2a 29 70 4f 75 74 20 3d 20 30   char**)pOut = 0
f330: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
f340: 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20  break;.    }.   
f350: 20 63 61 73 65 20 53 51 4c 49 54 45 5f 53 43 41   case SQLITE_SCA
f360: 4e 53 54 41 54 5f 53 45 4c 45 43 54 49 44 3a 20  NSTAT_SELECTID: 
f370: 7b 0a 20 20 20 20 20 20 69 66 28 20 70 53 63 61  {.      if( pSca
f380: 6e 2d 3e 61 64 64 72 45 78 70 6c 61 69 6e 20 29  n->addrExplain )
f390: 7b 0a 20 20 20 20 20 20 20 20 2a 28 69 6e 74 2a  {.        *(int*
f3a0: 29 70 4f 75 74 20 3d 20 70 2d 3e 61 4f 70 5b 20  )pOut = p->aOp[ 
f3b0: 70 53 63 61 6e 2d 3e 61 64 64 72 45 78 70 6c 61  pScan->addrExpla
f3c0: 69 6e 20 5d 2e 70 31 3b 0a 20 20 20 20 20 20 7d  in ].p1;.      }
f3d0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 2a 28  else{.        *(
f3e0: 69 6e 74 2a 29 70 4f 75 74 20 3d 20 2d 31 3b 0a  int*)pOut = -1;.
f3f0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 62 72        }.      br
f400: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64  eak;.    }.    d
f410: 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20  efault: {.      
f420: 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d 0a  return 1;.    }.
f430: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a    }.  return 0;.
f440: 7d 0a 0a 2f 2a 0a 2a 2a 20 5a 65 72 6f 20 61 6c  }../*.** Zero al
f450: 6c 20 63 6f 75 6e 74 65 72 73 20 61 73 73 6f 63  l counters assoc
f460: 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 73  iated with the s
f470: 71 6c 69 74 65 33 5f 73 74 6d 74 5f 73 63 61 6e  qlite3_stmt_scan
f480: 73 74 61 74 75 73 28 29 20 64 61 74 61 2e 0a 2a  status() data..*
f490: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 5f 73  /.void sqlite3_s
f4a0: 74 6d 74 5f 73 63 61 6e 73 74 61 74 75 73 5f 72  tmt_scanstatus_r
f4b0: 65 73 65 74 28 73 71 6c 69 74 65 33 5f 73 74 6d  eset(sqlite3_stm
f4c0: 74 20 2a 70 53 74 6d 74 29 7b 0a 20 20 56 64 62  t *pStmt){.  Vdb
f4d0: 65 20 2a 70 20 3d 20 28 56 64 62 65 2a 29 70 53  e *p = (Vdbe*)pS
f4e0: 74 6d 74 3b 0a 20 20 6d 65 6d 73 65 74 28 70 2d  tmt;.  memset(p-
f4f0: 3e 61 6e 45 78 65 63 2c 20 30 2c 20 70 2d 3e 6e  >anExec, 0, p->n
f500: 4f 70 20 2a 20 73 69 7a 65 6f 66 28 69 36 34 29  Op * sizeof(i64)
f510: 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53  );.}.#endif /* S
f520: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 4d  QLITE_ENABLE_STM
f530: 54 5f 53 43 41 4e 53 54 41 54 55 53 20 2a 2f 0a  T_SCANSTATUS */.