0000: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a /***************
0010: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0020: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0030: 2a 2a 2a 2a 2a 2a 2a 2a 2a 0d 0a 20 2a 20 41 44 *********.. * AD
0040: 4f 2e 4e 45 54 20 32 2e 30 20 44 61 74 61 20 50 O.NET 2.0 Data P
0050: 72 6f 76 69 64 65 72 20 66 6f 72 20 53 51 4c 69 rovider for SQLi
0060: 74 65 20 56 65 72 73 69 6f 6e 20 33 2e 58 0d 0a te Version 3.X..
0070: 20 2a 20 57 72 69 74 74 65 6e 20 62 79 20 4a 6f * Written by Jo
0080: 65 20 4d 69 73 74 61 63 68 6b 69 6e 20 28 6a 6f e Mistachkin (jo
0090: 65 40 6d 69 73 74 61 63 68 6b 69 6e 2e 63 6f 6d e@mistachkin.com
00a0: 29 0d 0a 20 2a 0d 0a 20 2a 20 52 65 6c 65 61 73 ).. *.. * Releas
00b0: 65 64 20 74 6f 20 74 68 65 20 70 75 62 6c 69 63 ed to the public
00c0: 20 64 6f 6d 61 69 6e 2c 20 75 73 65 20 61 74 20 domain, use at
00d0: 79 6f 75 72 20 6f 77 6e 20 72 69 73 6b 21 0d 0a your own risk!..
00e0: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ***************
00f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0100: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0110: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0d 0a 0d 0a 75 73 *********/....us
0120: 69 6e 67 20 53 79 73 74 65 6d 2e 43 6f 6c 6c 65 ing System.Colle
0130: 63 74 69 6f 6e 73 2e 47 65 6e 65 72 69 63 3b 0d ctions.Generic;.
0140: 0a 75 73 69 6e 67 20 53 79 73 74 65 6d 2e 47 6c .using System.Gl
0150: 6f 62 61 6c 69 7a 61 74 69 6f 6e 3b 0d 0a 75 73 obalization;..us
0160: 69 6e 67 20 53 79 73 74 65 6d 2e 52 75 6e 74 69 ing System.Runti
0170: 6d 65 2e 49 6e 74 65 72 6f 70 53 65 72 76 69 63 me.InteropServic
0180: 65 73 3b 0d 0a 75 73 69 6e 67 20 53 79 73 74 65 es;..using Syste
0190: 6d 2e 54 65 78 74 3b 0d 0a 0d 0a 6e 61 6d 65 73 m.Text;....names
01a0: 70 61 63 65 20 53 79 73 74 65 6d 2e 44 61 74 61 pace System.Data
01b0: 2e 53 51 4c 69 74 65 0d 0a 7b 0d 0a 20 20 20 20 .SQLite..{..
01c0: 23 72 65 67 69 6f 6e 20 53 51 4c 69 74 65 43 6f #region SQLiteCo
01d0: 6e 74 65 78 74 20 48 65 6c 70 65 72 20 43 6c 61 ntext Helper Cla
01e0: 73 73 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d ss.. /// <sum
01f0: 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 mary>.. /// T
0200: 68 69 73 20 63 6c 61 73 73 20 72 65 70 72 65 73 his class repres
0210: 65 6e 74 73 20 61 20 63 6f 6e 74 65 78 74 20 66 ents a context f
0220: 72 6f 6d 20 74 68 65 20 53 51 4c 69 74 65 20 63 rom the SQLite c
0230: 6f 72 65 20 6c 69 62 72 61 72 79 20 74 68 61 74 ore library that
0240: 20 63 61 6e 0d 0a 20 20 20 20 2f 2f 2f 20 62 65 can.. /// be
0250: 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 20 73 passed to the s
0260: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 2a 28 qlite3_result_*(
0270: 29 20 61 6e 64 20 61 73 73 6f 63 69 61 74 65 64 ) and associated
0280: 20 66 75 6e 63 74 69 6f 6e 73 2e 0d 0a 20 20 20 functions...
0290: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
02a0: 0a 20 20 20 20 70 75 62 6c 69 63 20 73 65 61 6c . public seal
02b0: 65 64 20 63 6c 61 73 73 20 53 51 4c 69 74 65 43 ed class SQLiteC
02c0: 6f 6e 74 65 78 74 20 3a 20 49 53 51 4c 69 74 65 ontext : ISQLite
02d0: 4e 61 74 69 76 65 48 61 6e 64 6c 65 0d 0a 20 20 NativeHandle..
02e0: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 23 72 65 {.. #re
02f0: 67 69 6f 6e 20 50 72 69 76 61 74 65 20 44 61 74 gion Private Dat
0300: 61 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c a.. /// <
0310: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
0320: 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 /// The native
0330: 20 63 6f 6e 74 65 78 74 20 68 61 6e 64 6c 65 2e context handle.
0340: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
0350: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
0360: 20 20 70 72 69 76 61 74 65 20 49 6e 74 50 74 72 private IntPtr
0370: 20 70 43 6f 6e 74 65 78 74 3b 0d 0a 20 20 20 20 pContext;..
0380: 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a #endregion..
0390: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
03a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
03b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
03c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
03d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
03e0: 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 /.... #re
03f0: 67 69 6f 6e 20 50 72 69 76 61 74 65 20 43 6f 6e gion Private Con
0400: 73 74 72 75 63 74 6f 72 73 0d 0a 20 20 20 20 20 structors..
0410: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
0420: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 43 6f .. /// Co
0430: 6e 73 74 72 75 63 74 73 20 61 6e 20 69 6e 73 74 nstructs an inst
0440: 61 6e 63 65 20 6f 66 20 74 68 69 73 20 63 6c 61 ance of this cla
0450: 73 73 20 75 73 69 6e 67 20 74 68 65 20 73 70 65 ss using the spe
0460: 63 69 66 69 65 64 20 6e 61 74 69 76 65 0d 0a 20 cified native..
0470: 20 20 20 20 20 20 20 2f 2f 2f 20 63 6f 6e 74 65 /// conte
0480: 78 74 20 68 61 6e 64 6c 65 2e 0d 0a 20 20 20 20 xt handle...
0490: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
04a0: 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
04b0: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 43 6f <param name="pCo
04c0: 6e 74 65 78 74 22 3e 0d 0a 20 20 20 20 20 20 20 ntext">..
04d0: 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 /// The native
04e0: 63 6f 6e 74 65 78 74 20 68 61 6e 64 6c 65 20 74 context handle t
04f0: 6f 20 75 73 65 2e 0d 0a 20 20 20 20 20 20 20 20 o use...
0500: 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
0510: 20 20 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 53 internal S
0520: 51 4c 69 74 65 43 6f 6e 74 65 78 74 28 49 6e 74 QLiteContext(Int
0530: 50 74 72 20 70 43 6f 6e 74 65 78 74 29 0d 0a 20 Ptr pContext)..
0540: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
0550: 20 20 20 20 20 20 74 68 69 73 2e 70 43 6f 6e 74 this.pCont
0560: 65 78 74 20 3d 20 70 43 6f 6e 74 65 78 74 3b 0d ext = pContext;.
0570: 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 . }..
0580: 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a #endregion..
0590: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
05a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
05b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
05c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
05d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
05e0: 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 /.... #re
05f0: 67 69 6f 6e 20 49 53 51 4c 69 74 65 4e 61 74 69 gion ISQLiteNati
0600: 76 65 48 61 6e 64 6c 65 20 4d 65 6d 62 65 72 73 veHandle Members
0610: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
0620: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
0630: 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68 65 /// Returns the
0640: 20 75 6e 64 65 72 6c 79 69 6e 67 20 53 51 4c 69 underlying SQLi
0650: 74 65 20 6e 61 74 69 76 65 20 68 61 6e 64 6c 65 te native handle
0660: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
0670: 20 74 68 69 73 0d 0a 20 20 20 20 20 20 20 20 2f this.. /
0680: 2f 2f 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e // object instan
0690: 63 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ce... ///
06a0: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
06b0: 20 20 20 20 20 70 75 62 6c 69 63 20 49 6e 74 50 public IntP
06c0: 74 72 20 4e 61 74 69 76 65 48 61 6e 64 6c 65 0d tr NativeHandle.
06d0: 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 . {..
06e0: 20 20 20 20 20 20 20 20 67 65 74 20 7b 20 72 65 get { re
06f0: 74 75 72 6e 20 70 43 6f 6e 74 65 78 74 3b 20 7d turn pContext; }
0700: 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 .. }..
0710: 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d #endregion.
0720: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
0730: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0740: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0750: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0760: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0770: 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 //.... #r
0780: 65 67 69 6f 6e 20 50 75 62 6c 69 63 20 4d 65 74 egion Public Met
0790: 68 6f 64 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f hods.. //
07a0: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
07b0: 20 20 20 20 20 2f 2f 2f 20 53 65 74 73 20 74 68 /// Sets th
07c0: 65 20 63 6f 6e 74 65 78 74 20 72 65 73 75 6c 74 e context result
07d0: 20 74 6f 20 4e 55 4c 4c 2e 0d 0a 20 20 20 20 20 to NULL...
07e0: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
07f0: 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 >.. publi
0800: 63 20 76 6f 69 64 20 53 65 74 4e 75 6c 6c 28 29 c void SetNull()
0810: 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 .. {..
0820: 20 20 20 20 20 20 20 20 20 69 66 20 28 70 43 6f if (pCo
0830: 6e 74 65 78 74 20 3d 3d 20 49 6e 74 50 74 72 2e ntext == IntPtr.
0840: 5a 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 Zero)..
0850: 20 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77 throw new
0860: 20 49 6e 76 61 6c 69 64 4f 70 65 72 61 74 69 6f InvalidOperatio
0870: 6e 45 78 63 65 70 74 69 6f 6e 28 29 3b 0d 0a 0d nException();...
0880: 0a 20 20 20 20 20 20 20 20 20 20 20 20 55 6e 73 . Uns
0890: 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 afeNativeMethods
08a0: 2e 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f .sqlite3_result_
08b0: 6e 75 6c 6c 28 70 43 6f 6e 74 65 78 74 29 3b 0d null(pContext);.
08c0: 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 . }....
08d0: 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////
08e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
08f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0900: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0910: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d /////////////...
0920: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 . /// <su
0930: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
0940: 2f 2f 2f 20 53 65 74 73 20 74 68 65 20 63 6f 6e /// Sets the con
0950: 74 65 78 74 20 72 65 73 75 6c 74 20 74 6f 20 74 text result to t
0960: 68 65 20 73 70 65 63 69 66 69 65 64 20 3c 73 65 he specified <se
0970: 65 20 63 72 65 66 3d 22 44 6f 75 62 6c 65 22 20 e cref="Double"
0980: 2f 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 />.. ///
0990: 76 61 6c 75 65 2e 0d 0a 20 20 20 20 20 20 20 20 value...
09a0: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a /// </summary>..
09b0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
09c0: 61 6d 20 6e 61 6d 65 3d 22 76 61 6c 75 65 22 3e am name="value">
09d0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
09e0: 65 20 3c 73 65 65 20 63 72 65 66 3d 22 44 6f 75 e <see cref="Dou
09f0: 62 6c 65 22 20 2f 3e 20 76 61 6c 75 65 20 74 6f ble" /> value to
0a00: 20 75 73 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f use... /
0a10: 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
0a20: 20 20 20 20 20 70 75 62 6c 69 63 20 76 6f 69 64 public void
0a30: 20 53 65 74 44 6f 75 62 6c 65 28 64 6f 75 62 6c SetDouble(doubl
0a40: 65 20 76 61 6c 75 65 29 0d 0a 20 20 20 20 20 20 e value)..
0a50: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
0a60: 20 69 66 20 28 70 43 6f 6e 74 65 78 74 20 3d 3d if (pContext ==
0a70: 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a 20 IntPtr.Zero)..
0a80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 t
0a90: 68 72 6f 77 20 6e 65 77 20 49 6e 76 61 6c 69 64 hrow new Invalid
0aa0: 4f 70 65 72 61 74 69 6f 6e 45 78 63 65 70 74 69 OperationExcepti
0ab0: 6f 6e 28 29 3b 0d 0a 0d 0a 23 69 66 20 21 50 4c on();....#if !PL
0ac0: 41 54 46 4f 52 4d 5f 43 4f 4d 50 41 43 54 46 52 ATFORM_COMPACTFR
0ad0: 41 4d 45 57 4f 52 4b 0d 0a 20 20 20 20 20 20 20 AMEWORK..
0ae0: 20 20 20 20 20 55 6e 73 61 66 65 4e 61 74 69 76 UnsafeNativ
0af0: 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 eMethods.sqlite3
0b00: 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 28 70 _result_double(p
0b10: 43 6f 6e 74 65 78 74 2c 20 76 61 6c 75 65 29 3b Context, value);
0b20: 0d 0a 23 65 6c 69 66 20 21 53 51 4c 49 54 45 5f ..#elif !SQLITE_
0b30: 53 54 41 4e 44 41 52 44 0d 0a 20 20 20 20 20 20 STANDARD..
0b40: 20 20 20 20 20 20 55 6e 73 61 66 65 4e 61 74 69 UnsafeNati
0b50: 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 veMethods.sqlite
0b60: 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 5f 3_result_double_
0b70: 69 6e 74 65 72 6f 70 28 70 43 6f 6e 74 65 78 74 interop(pContext
0b80: 2c 20 72 65 66 20 76 61 6c 75 65 29 3b 0d 0a 23 , ref value);..#
0b90: 65 6c 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20 else..
0ba0: 20 20 74 68 72 6f 77 20 6e 65 77 20 4e 6f 74 49 throw new NotI
0bb0: 6d 70 6c 65 6d 65 6e 74 65 64 45 78 63 65 70 74 mplementedExcept
0bc0: 69 6f 6e 28 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a ion();..#endif..
0bd0: 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 }....
0be0: 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
0bf0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0c00: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0c10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0c20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
0c30: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
0c40: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
0c50: 2f 2f 20 53 65 74 73 20 74 68 65 20 63 6f 6e 74 // Sets the cont
0c60: 65 78 74 20 72 65 73 75 6c 74 20 74 6f 20 74 68 ext result to th
0c70: 65 20 73 70 65 63 69 66 69 65 64 20 3c 73 65 65 e specified <see
0c80: 20 63 72 65 66 3d 22 49 6e 74 33 32 22 20 2f 3e cref="Int32" />
0c90: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 76 61 .. /// va
0ca0: 6c 75 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f lue... //
0cb0: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 / </summary>..
0cc0: 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
0cd0: 20 6e 61 6d 65 3d 22 76 61 6c 75 65 22 3e 0d 0a name="value">..
0ce0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
0cf0: 3c 73 65 65 20 63 72 65 66 3d 22 49 6e 74 33 32 <see cref="Int32
0d00: 22 20 2f 3e 20 76 61 6c 75 65 20 74 6f 20 75 73 " /> value to us
0d10: 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
0d20: 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
0d30: 20 20 70 75 62 6c 69 63 20 76 6f 69 64 20 53 65 public void Se
0d40: 74 49 6e 74 28 69 6e 74 20 76 61 6c 75 65 29 0d tInt(int value).
0d50: 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 . {..
0d60: 20 20 20 20 20 20 20 20 69 66 20 28 70 43 6f 6e if (pCon
0d70: 74 65 78 74 20 3d 3d 20 49 6e 74 50 74 72 2e 5a text == IntPtr.Z
0d80: 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 20 ero)..
0d90: 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77 20 throw new
0da0: 49 6e 76 61 6c 69 64 4f 70 65 72 61 74 69 6f 6e InvalidOperation
0db0: 45 78 63 65 70 74 69 6f 6e 28 29 3b 0d 0a 0d 0a Exception();....
0dc0: 20 20 20 20 20 20 20 20 20 20 20 20 55 6e 73 61 Unsa
0dd0: 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e feNativeMethods.
0de0: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 sqlite3_result_i
0df0: 6e 74 28 70 43 6f 6e 74 65 78 74 2c 20 76 61 6c nt(pContext, val
0e00: 75 65 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d ue);.. }.
0e10: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
0e20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0e30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0e40: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0e50: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
0e60: 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f //.... //
0e70: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
0e80: 20 20 20 20 20 2f 2f 2f 20 53 65 74 73 20 74 68 /// Sets th
0e90: 65 20 63 6f 6e 74 65 78 74 20 72 65 73 75 6c 74 e context result
0ea0: 20 74 6f 20 74 68 65 20 73 70 65 63 69 66 69 65 to the specifie
0eb0: 64 20 3c 73 65 65 20 63 72 65 66 3d 22 49 6e 74 d <see cref="Int
0ec0: 36 34 22 20 2f 3e 0d 0a 20 20 20 20 20 20 20 20 64" />..
0ed0: 2f 2f 2f 20 76 61 6c 75 65 2e 0d 0a 20 20 20 20 /// value...
0ee0: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
0ef0: 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
0f00: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 76 61 6c <param name="val
0f10: 75 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ue">.. //
0f20: 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d / The <see cref=
0f30: 22 49 6e 74 36 34 22 20 2f 3e 20 76 61 6c 75 65 "Int64" /> value
0f40: 20 74 6f 20 75 73 65 2e 0d 0a 20 20 20 20 20 20 to use...
0f50: 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
0f60: 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 76 public v
0f70: 6f 69 64 20 53 65 74 49 6e 74 36 34 28 6c 6f 6e oid SetInt64(lon
0f80: 67 20 76 61 6c 75 65 29 0d 0a 20 20 20 20 20 20 g value)..
0f90: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
0fa0: 20 69 66 20 28 70 43 6f 6e 74 65 78 74 20 3d 3d if (pContext ==
0fb0: 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a 20 IntPtr.Zero)..
0fc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 t
0fd0: 68 72 6f 77 20 6e 65 77 20 49 6e 76 61 6c 69 64 hrow new Invalid
0fe0: 4f 70 65 72 61 74 69 6f 6e 45 78 63 65 70 74 69 OperationExcepti
0ff0: 6f 6e 28 29 3b 0d 0a 0d 0a 23 69 66 20 21 50 4c on();....#if !PL
1000: 41 54 46 4f 52 4d 5f 43 4f 4d 50 41 43 54 46 52 ATFORM_COMPACTFR
1010: 41 4d 45 57 4f 52 4b 0d 0a 20 20 20 20 20 20 20 AMEWORK..
1020: 20 20 20 20 20 55 6e 73 61 66 65 4e 61 74 69 76 UnsafeNativ
1030: 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 eMethods.sqlite3
1040: 5f 72 65 73 75 6c 74 5f 69 6e 74 36 34 28 70 43 _result_int64(pC
1050: 6f 6e 74 65 78 74 2c 20 76 61 6c 75 65 29 3b 0d ontext, value);.
1060: 0a 23 65 6c 69 66 20 21 53 51 4c 49 54 45 5f 53 .#elif !SQLITE_S
1070: 54 41 4e 44 41 52 44 0d 0a 20 20 20 20 20 20 20 TANDARD..
1080: 20 20 20 20 20 55 6e 73 61 66 65 4e 61 74 69 76 UnsafeNativ
1090: 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 eMethods.sqlite3
10a0: 5f 72 65 73 75 6c 74 5f 69 6e 74 36 34 5f 69 6e _result_int64_in
10b0: 74 65 72 6f 70 28 70 43 6f 6e 74 65 78 74 2c 20 terop(pContext,
10c0: 72 65 66 20 76 61 6c 75 65 29 3b 0d 0a 23 65 6c ref value);..#el
10d0: 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 se..
10e0: 74 68 72 6f 77 20 6e 65 77 20 4e 6f 74 49 6d 70 throw new NotImp
10f0: 6c 65 6d 65 6e 74 65 64 45 78 63 65 70 74 69 6f lementedExceptio
1100: 6e 28 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 n();..#endif..
1110: 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 }....
1120: 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
1130: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1140: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1150: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1160: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
1170: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
1180: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
1190: 20 53 65 74 73 20 74 68 65 20 63 6f 6e 74 65 78 Sets the contex
11a0: 74 20 72 65 73 75 6c 74 20 74 6f 20 74 68 65 20 t result to the
11b0: 73 70 65 63 69 66 69 65 64 20 3c 73 65 65 20 63 specified <see c
11c0: 72 65 66 3d 22 53 74 72 69 6e 67 22 20 2f 3e 0d ref="String" />.
11d0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 76 61 6c . /// val
11e0: 75 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ue... ///
11f0: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
1200: 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
1210: 6e 61 6d 65 3d 22 76 61 6c 75 65 22 3e 0d 0a 20 name="value">..
1220: 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c /// The <
1230: 73 65 65 20 63 72 65 66 3d 22 53 74 72 69 6e 67 see cref="String
1240: 22 20 2f 3e 20 76 61 6c 75 65 20 74 6f 20 75 73 " /> value to us
1250: 65 2e 20 20 54 68 69 73 20 76 61 6c 75 65 20 77 e. This value w
1260: 69 6c 6c 20 62 65 0d 0a 20 20 20 20 20 20 20 20 ill be..
1270: 2f 2f 2f 20 63 6f 6e 76 65 72 74 65 64 20 74 6f /// converted to
1280: 20 74 68 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 the UTF-8 encod
1290: 69 6e 67 20 70 72 69 6f 72 20 74 6f 20 62 65 69 ing prior to bei
12a0: 6e 67 20 75 73 65 64 2e 0d 0a 20 20 20 20 20 20 ng used...
12b0: 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
12c0: 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 76 public v
12d0: 6f 69 64 20 53 65 74 53 74 72 69 6e 67 28 73 74 oid SetString(st
12e0: 72 69 6e 67 20 76 61 6c 75 65 29 0d 0a 20 20 20 ring value)..
12f0: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
1300: 20 20 20 20 69 66 20 28 70 43 6f 6e 74 65 78 74 if (pContext
1310: 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 == IntPtr.Zero)
1320: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
1330: 20 20 74 68 72 6f 77 20 6e 65 77 20 49 6e 76 61 throw new Inva
1340: 6c 69 64 4f 70 65 72 61 74 69 6f 6e 45 78 63 65 lidOperationExce
1350: 70 74 69 6f 6e 28 29 3b 0d 0a 0d 0a 20 20 20 20 ption();....
1360: 20 20 20 20 20 20 20 20 62 79 74 65 5b 5d 20 62 byte[] b
1370: 79 74 65 73 20 3d 20 53 51 4c 69 74 65 53 74 72 ytes = SQLiteStr
1380: 69 6e 67 2e 47 65 74 55 74 66 38 42 79 74 65 73 ing.GetUtf8Bytes
1390: 46 72 6f 6d 53 74 72 69 6e 67 28 76 61 6c 75 65 FromString(value
13a0: 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 );....
13b0: 20 20 69 66 20 28 62 79 74 65 73 20 3d 3d 20 6e if (bytes == n
13c0: 75 6c 6c 29 0d 0a 20 20 20 20 20 20 20 20 20 20 ull)..
13d0: 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77 20 throw new
13e0: 41 72 67 75 6d 65 6e 74 4e 75 6c 6c 45 78 63 65 ArgumentNullExce
13f0: 70 74 69 6f 6e 28 22 76 61 6c 75 65 22 29 3b 0d ption("value");.
1400: 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 55 ... U
1410: 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
1420: 64 73 2e 73 71 6c 69 74 65 33 5f 72 65 73 75 6c ds.sqlite3_resul
1430: 74 5f 74 65 78 74 28 0d 0a 20 20 20 20 20 20 20 t_text(..
1440: 20 20 20 20 20 20 20 20 20 70 43 6f 6e 74 65 78 pContex
1450: 74 2c 20 62 79 74 65 73 2c 20 62 79 74 65 73 2e t, bytes, bytes.
1460: 4c 65 6e 67 74 68 2c 20 28 49 6e 74 50 74 72 29 Length, (IntPtr)
1470: 28 2d 31 29 29 3b 0d 0a 20 20 20 20 20 20 20 20 (-1));..
1480: 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f }.... ///
1490: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14d0: 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ////....
14e0: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
14f0: 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 74 73 20 /// Sets
1500: 74 68 65 20 63 6f 6e 74 65 78 74 20 72 65 73 75 the context resu
1510: 6c 74 20 74 6f 20 74 68 65 20 73 70 65 63 69 66 lt to the specif
1520: 69 65 64 20 3c 73 65 65 20 63 72 65 66 3d 22 53 ied <see cref="S
1530: 74 72 69 6e 67 22 20 2f 3e 0d 0a 20 20 20 20 20 tring" />..
1540: 20 20 20 2f 2f 2f 20 76 61 6c 75 65 20 63 6f 6e /// value con
1550: 74 61 69 6e 69 6e 67 20 61 6e 20 65 72 72 6f 72 taining an error
1560: 20 6d 65 73 73 61 67 65 2e 0d 0a 20 20 20 20 20 message...
1570: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
1580: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
1590: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 76 61 6c 75 param name="valu
15a0: 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f e">.. ///
15b0: 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 The <see cref="
15c0: 53 74 72 69 6e 67 22 20 2f 3e 20 76 61 6c 75 65 String" /> value
15d0: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 containing the
15e0: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 74 65 error message te
15f0: 78 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f xt... ///
1600: 20 54 68 69 73 20 76 61 6c 75 65 20 77 69 6c 6c This value will
1610: 20 62 65 20 63 6f 6e 76 65 72 74 65 64 20 74 6f be converted to
1620: 20 74 68 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 the UTF-8 encod
1630: 69 6e 67 20 70 72 69 6f 72 20 74 6f 20 62 65 69 ing prior to bei
1640: 6e 67 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ng.. ///
1650: 75 73 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f used... /
1660: 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
1670: 20 20 20 20 20 70 75 62 6c 69 63 20 76 6f 69 64 public void
1680: 20 53 65 74 45 72 72 6f 72 28 73 74 72 69 6e 67 SetError(string
1690: 20 76 61 6c 75 65 29 0d 0a 20 20 20 20 20 20 20 value)..
16a0: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 {..
16b0: 69 66 20 28 70 43 6f 6e 74 65 78 74 20 3d 3d 20 if (pContext ==
16c0: 49 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a 20 20 IntPtr.Zero)..
16d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 th
16e0: 72 6f 77 20 6e 65 77 20 49 6e 76 61 6c 69 64 4f row new InvalidO
16f0: 70 65 72 61 74 69 6f 6e 45 78 63 65 70 74 69 6f perationExceptio
1700: 6e 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 n();....
1710: 20 20 20 20 62 79 74 65 5b 5d 20 62 79 74 65 73 byte[] bytes
1720: 20 3d 20 53 51 4c 69 74 65 53 74 72 69 6e 67 2e = SQLiteString.
1730: 47 65 74 55 74 66 38 42 79 74 65 73 46 72 6f 6d GetUtf8BytesFrom
1740: 53 74 72 69 6e 67 28 76 61 6c 75 65 29 3b 0d 0a String(value);..
1750: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 .. if
1760: 20 28 62 79 74 65 73 20 3d 3d 20 6e 75 6c 6c 29 (bytes == null)
1770: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
1780: 20 20 74 68 72 6f 77 20 6e 65 77 20 41 72 67 75 throw new Argu
1790: 6d 65 6e 74 4e 75 6c 6c 45 78 63 65 70 74 69 6f mentNullExceptio
17a0: 6e 28 22 76 61 6c 75 65 22 29 3b 0d 0a 0d 0a 20 n("value");....
17b0: 20 20 20 20 20 20 20 20 20 20 20 55 6e 73 61 66 Unsaf
17c0: 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 eNativeMethods.s
17d0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 qlite3_result_er
17e0: 72 6f 72 28 0d 0a 20 20 20 20 20 20 20 20 20 20 ror(..
17f0: 20 20 20 20 20 20 70 43 6f 6e 74 65 78 74 2c 20 pContext,
1800: 62 79 74 65 73 2c 20 62 79 74 65 73 2e 4c 65 6e bytes, bytes.Len
1810: 67 74 68 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d gth);.. }
1820: 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
1830: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1840: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1850: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1860: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1870: 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ///.... /
1880: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
1890: 20 20 20 20 20 20 2f 2f 2f 20 53 65 74 73 20 74 /// Sets t
18a0: 68 65 20 63 6f 6e 74 65 78 74 20 72 65 73 75 6c he context resul
18b0: 74 20 74 6f 20 74 68 65 20 73 70 65 63 69 66 69 t to the specifi
18c0: 65 64 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 ed <see cref="SQ
18d0: 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 22 20 2f LiteErrorCode" /
18e0: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 76 >.. /// v
18f0: 61 6c 75 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f alue... /
1900: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
1910: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
1920: 6d 20 6e 61 6d 65 3d 22 76 61 6c 75 65 22 3e 0d m name="value">.
1930: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
1940: 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c 69 <see cref="SQLi
1950: 74 65 45 72 72 6f 72 43 6f 64 65 22 20 2f 3e 20 teErrorCode" />
1960: 76 61 6c 75 65 20 74 6f 20 75 73 65 2e 0d 0a 20 value to use...
1970: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
1980: 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 am>.. pub
1990: 6c 69 63 20 76 6f 69 64 20 53 65 74 45 72 72 6f lic void SetErro
19a0: 72 43 6f 64 65 28 53 51 4c 69 74 65 45 72 72 6f rCode(SQLiteErro
19b0: 72 43 6f 64 65 20 76 61 6c 75 65 29 0d 0a 20 20 rCode value)..
19c0: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
19d0: 20 20 20 20 20 69 66 20 28 70 43 6f 6e 74 65 78 if (pContex
19e0: 74 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f t == IntPtr.Zero
19f0: 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 )..
1a00: 20 20 20 74 68 72 6f 77 20 6e 65 77 20 49 6e 76 throw new Inv
1a10: 61 6c 69 64 4f 70 65 72 61 74 69 6f 6e 45 78 63 alidOperationExc
1a20: 65 70 74 69 6f 6e 28 29 3b 0d 0a 0d 0a 20 20 20 eption();....
1a30: 20 20 20 20 20 20 20 20 20 55 6e 73 61 66 65 4e UnsafeN
1a40: 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c ativeMethods.sql
1a50: 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f ite3_result_erro
1a60: 72 5f 63 6f 64 65 28 70 43 6f 6e 74 65 78 74 2c r_code(pContext,
1a70: 20 76 61 6c 75 65 29 3b 0d 0a 20 20 20 20 20 20 value);..
1a80: 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f }.... /
1a90: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1aa0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ab0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ac0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ad0: 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
1ae0: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d /// <summary>.
1af0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 74 . /// Set
1b00: 73 20 74 68 65 20 63 6f 6e 74 65 78 74 20 72 65 s the context re
1b10: 73 75 6c 74 20 74 6f 20 63 6f 6e 74 61 69 6e 20 sult to contain
1b20: 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 53 the error code S
1b30: 51 4c 49 54 45 5f 54 4f 4f 42 49 47 2e 0d 0a 20 QLITE_TOOBIG...
1b40: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
1b50: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 mary>.. p
1b60: 75 62 6c 69 63 20 76 6f 69 64 20 53 65 74 45 72 ublic void SetEr
1b70: 72 6f 72 54 6f 6f 42 69 67 28 29 0d 0a 20 20 20 rorTooBig()..
1b80: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
1b90: 20 20 20 20 69 66 20 28 70 43 6f 6e 74 65 78 74 if (pContext
1ba0: 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 == IntPtr.Zero)
1bb0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
1bc0: 20 20 74 68 72 6f 77 20 6e 65 77 20 49 6e 76 61 throw new Inva
1bd0: 6c 69 64 4f 70 65 72 61 74 69 6f 6e 45 78 63 65 lidOperationExce
1be0: 70 74 69 6f 6e 28 29 3b 0d 0a 0d 0a 20 20 20 20 ption();....
1bf0: 20 20 20 20 20 20 20 20 55 6e 73 61 66 65 4e 61 UnsafeNa
1c00: 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 tiveMethods.sqli
1c10: 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 te3_result_error
1c20: 5f 74 6f 6f 62 69 67 28 70 43 6f 6e 74 65 78 74 _toobig(pContext
1c30: 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d );.. }...
1c40: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
1c50: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1c60: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1c70: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1c80: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1c90: 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 .... ///
1ca0: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
1cb0: 20 20 20 2f 2f 2f 20 53 65 74 73 20 74 68 65 20 /// Sets the
1cc0: 63 6f 6e 74 65 78 74 20 72 65 73 75 6c 74 20 74 context result t
1cd0: 6f 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 65 72 o contain the er
1ce0: 72 6f 72 20 63 6f 64 65 20 53 51 4c 49 54 45 5f ror code SQLITE_
1cf0: 4e 4f 4d 45 4d 2e 0d 0a 20 20 20 20 20 20 20 20 NOMEM...
1d00: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a /// </summary>..
1d10: 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 76 public v
1d20: 6f 69 64 20 53 65 74 45 72 72 6f 72 4e 6f 4d 65 oid SetErrorNoMe
1d30: 6d 6f 72 79 28 29 0d 0a 20 20 20 20 20 20 20 20 mory()..
1d40: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 {.. i
1d50: 66 20 28 70 43 6f 6e 74 65 78 74 20 3d 3d 20 49 f (pContext == I
1d60: 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a 20 20 20 ntPtr.Zero)..
1d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 72 thr
1d80: 6f 77 20 6e 65 77 20 49 6e 76 61 6c 69 64 4f 70 ow new InvalidOp
1d90: 65 72 61 74 69 6f 6e 45 78 63 65 70 74 69 6f 6e erationException
1da0: 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 ();....
1db0: 20 20 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d UnsafeNativeM
1dc0: 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 72 ethods.sqlite3_r
1dd0: 65 73 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f 6d 65 esult_error_nome
1de0: 6d 28 70 43 6f 6e 74 65 78 74 29 3b 0d 0a 20 20 m(pContext);..
1df0: 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 }....
1e00: 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
1e10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e40: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
1e50: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
1e60: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
1e70: 20 53 65 74 73 20 74 68 65 20 63 6f 6e 74 65 78 Sets the contex
1e80: 74 20 72 65 73 75 6c 74 20 74 6f 20 74 68 65 20 t result to the
1e90: 73 70 65 63 69 66 69 65 64 20 3c 73 65 65 20 63 specified <see c
1ea0: 72 65 66 3d 22 42 79 74 65 22 20 2f 3e 20 61 72 ref="Byte" /> ar
1eb0: 72 61 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ray.. ///
1ec0: 20 76 61 6c 75 65 2e 0d 0a 20 20 20 20 20 20 20 value...
1ed0: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
1ee0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
1ef0: 72 61 6d 20 6e 61 6d 65 3d 22 76 61 6c 75 65 22 ram name="value"
1f00: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
1f10: 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 42 79 he <see cref="By
1f20: 74 65 22 20 2f 3e 20 61 72 72 61 79 20 76 61 6c te" /> array val
1f30: 75 65 20 74 6f 20 75 73 65 2e 0d 0a 20 20 20 20 ue to use...
1f40: 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
1f50: 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 .. public
1f60: 20 76 6f 69 64 20 53 65 74 42 6c 6f 62 28 62 79 void SetBlob(by
1f70: 74 65 5b 5d 20 76 61 6c 75 65 29 0d 0a 20 20 20 te[] value)..
1f80: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
1f90: 20 20 20 20 69 66 20 28 70 43 6f 6e 74 65 78 74 if (pContext
1fa0: 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 == IntPtr.Zero)
1fb0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
1fc0: 20 20 74 68 72 6f 77 20 6e 65 77 20 49 6e 76 61 throw new Inva
1fd0: 6c 69 64 4f 70 65 72 61 74 69 6f 6e 45 78 63 65 lidOperationExce
1fe0: 70 74 69 6f 6e 28 29 3b 0d 0a 0d 0a 20 20 20 20 ption();....
1ff0: 20 20 20 20 20 20 20 20 69 66 20 28 76 61 6c 75 if (valu
2000: 65 20 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 e == null)..
2010: 20 20 20 20 20 20 20 20 20 20 20 20 74 68 72 6f thro
2020: 77 20 6e 65 77 20 41 72 67 75 6d 65 6e 74 4e 75 w new ArgumentNu
2030: 6c 6c 45 78 63 65 70 74 69 6f 6e 28 22 76 61 6c llException("val
2040: 75 65 22 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 ue");....
2050: 20 20 20 20 20 55 6e 73 61 66 65 4e 61 74 69 76 UnsafeNativ
2060: 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 eMethods.sqlite3
2070: 5f 72 65 73 75 6c 74 5f 62 6c 6f 62 28 0d 0a 20 _result_blob(..
2080: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 p
2090: 43 6f 6e 74 65 78 74 2c 20 76 61 6c 75 65 2c 20 Context, value,
20a0: 76 61 6c 75 65 2e 4c 65 6e 67 74 68 2c 20 28 49 value.Length, (I
20b0: 6e 74 50 74 72 29 28 2d 31 29 29 3b 0d 0a 20 20 ntPtr)(-1));..
20c0: 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 }....
20d0: 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
20e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2100: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2110: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
2120: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
2130: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
2140: 20 53 65 74 73 20 74 68 65 20 63 6f 6e 74 65 78 Sets the contex
2150: 74 20 72 65 73 75 6c 74 20 74 6f 20 61 20 42 4c t result to a BL
2160: 4f 42 20 6f 66 20 7a 65 72 6f 73 20 6f 66 20 74 OB of zeros of t
2170: 68 65 20 73 70 65 63 69 66 69 65 64 20 73 69 7a he specified siz
2180: 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
2190: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
21a0: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
21b0: 61 6d 65 3d 22 76 61 6c 75 65 22 3e 0d 0a 20 20 ame="value">..
21c0: 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 75 /// The nu
21d0: 6d 62 65 72 20 6f 66 20 7a 65 72 6f 20 62 79 74 mber of zero byt
21e0: 65 73 20 74 6f 20 75 73 65 20 66 6f 72 20 74 68 es to use for th
21f0: 65 20 42 4c 4f 42 20 63 6f 6e 74 65 78 74 20 72 e BLOB context r
2200: 65 73 75 6c 74 2e 0d 0a 20 20 20 20 20 20 20 20 esult...
2210: 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
2220: 20 20 20 20 20 20 70 75 62 6c 69 63 20 76 6f 69 public voi
2230: 64 20 53 65 74 5a 65 72 6f 42 6c 6f 62 28 69 6e d SetZeroBlob(in
2240: 74 20 76 61 6c 75 65 29 0d 0a 20 20 20 20 20 20 t value)..
2250: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
2260: 20 69 66 20 28 70 43 6f 6e 74 65 78 74 20 3d 3d if (pContext ==
2270: 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a 20 IntPtr.Zero)..
2280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 t
2290: 68 72 6f 77 20 6e 65 77 20 49 6e 76 61 6c 69 64 hrow new Invalid
22a0: 4f 70 65 72 61 74 69 6f 6e 45 78 63 65 70 74 69 OperationExcepti
22b0: 6f 6e 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 on();....
22c0: 20 20 20 20 20 55 6e 73 61 66 65 4e 61 74 69 76 UnsafeNativ
22d0: 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 eMethods.sqlite3
22e0: 5f 72 65 73 75 6c 74 5f 7a 65 72 6f 62 6c 6f 62 _result_zeroblob
22f0: 28 70 43 6f 6e 74 65 78 74 2c 20 76 61 6c 75 65 (pContext, value
2300: 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d );.. }...
2310: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
2320: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2330: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2340: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2350: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2360: 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 .... ///
2370: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
2380: 20 20 20 2f 2f 2f 20 53 65 74 73 20 74 68 65 20 /// Sets the
2390: 63 6f 6e 74 65 78 74 20 72 65 73 75 6c 74 20 74 context result t
23a0: 6f 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 o the specified
23b0: 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 <see cref="SQLit
23c0: 65 56 61 6c 75 65 22 20 2f 3e 2e 0d 0a 20 20 20 eValue" />...
23d0: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
23e0: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
23f0: 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 76 61 <param name="va
2400: 6c 75 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f lue">.. /
2410: 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 // The <see cref
2420: 3d 22 53 51 4c 69 74 65 56 61 6c 75 65 22 20 2f ="SQLiteValue" /
2430: 3e 20 74 6f 20 75 73 65 2e 0d 0a 20 20 20 20 20 > to use...
2440: 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
2450: 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 . public
2460: 76 6f 69 64 20 53 65 74 56 61 6c 75 65 28 53 51 void SetValue(SQ
2470: 4c 69 74 65 56 61 6c 75 65 20 76 61 6c 75 65 29 LiteValue value)
2480: 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 .. {..
2490: 20 20 20 20 20 20 20 20 20 69 66 20 28 70 43 6f if (pCo
24a0: 6e 74 65 78 74 20 3d 3d 20 49 6e 74 50 74 72 2e ntext == IntPtr.
24b0: 5a 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 Zero)..
24c0: 20 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77 throw new
24d0: 20 49 6e 76 61 6c 69 64 4f 70 65 72 61 74 69 6f InvalidOperatio
24e0: 6e 45 78 63 65 70 74 69 6f 6e 28 29 3b 0d 0a 0d nException();...
24f0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 . if
2500: 28 76 61 6c 75 65 20 3d 3d 20 6e 75 6c 6c 29 0d (value == null).
2510: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2520: 20 74 68 72 6f 77 20 6e 65 77 20 41 72 67 75 6d throw new Argum
2530: 65 6e 74 4e 75 6c 6c 45 78 63 65 70 74 69 6f 6e entNullException
2540: 28 22 76 61 6c 75 65 22 29 3b 0d 0a 0d 0a 20 20 ("value");....
2550: 20 20 20 20 20 20 20 20 20 20 55 6e 73 61 66 65 Unsafe
2560: 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 NativeMethods.sq
2570: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c lite3_result_val
2580: 75 65 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ue(..
2590: 20 20 20 20 20 70 43 6f 6e 74 65 78 74 2c 20 76 pContext, v
25a0: 61 6c 75 65 2e 4e 61 74 69 76 65 48 61 6e 64 6c alue.NativeHandl
25b0: 65 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a e);.. }..
25c0: 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 #endregi
25d0: 6f 6e 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 on.. }.. #
25e0: 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 endregion....
25f0: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
2600: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2610: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2620: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2630: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
2640: 20 20 20 20 23 72 65 67 69 6f 6e 20 53 51 4c 69 #region SQLi
2650: 74 65 56 61 6c 75 65 20 48 65 6c 70 65 72 20 43 teValue Helper C
2660: 6c 61 73 73 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 lass.. /// <s
2670: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f ummary>.. ///
2680: 20 54 68 69 73 20 63 6c 61 73 73 20 72 65 70 72 This class repr
2690: 65 73 65 6e 74 73 20 61 20 76 61 6c 75 65 20 66 esents a value f
26a0: 72 6f 6d 20 74 68 65 20 53 51 4c 69 74 65 20 63 rom the SQLite c
26b0: 6f 72 65 20 6c 69 62 72 61 72 79 20 74 68 61 74 ore library that
26c0: 20 63 61 6e 20 62 65 0d 0a 20 20 20 20 2f 2f 2f can be.. ///
26d0: 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 20 73 passed to the s
26e0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 2a 28 29 qlite3_value_*()
26f0: 20 61 6e 64 20 61 73 73 6f 63 69 61 74 65 64 20 and associated
2700: 66 75 6e 63 74 69 6f 6e 73 2e 0d 0a 20 20 20 20 functions...
2710: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a /// </summary>..
2720: 20 20 20 20 70 75 62 6c 69 63 20 73 65 61 6c 65 public seale
2730: 64 20 63 6c 61 73 73 20 53 51 4c 69 74 65 56 61 d class SQLiteVa
2740: 6c 75 65 20 3a 20 49 53 51 4c 69 74 65 4e 61 74 lue : ISQLiteNat
2750: 69 76 65 48 61 6e 64 6c 65 0d 0a 20 20 20 20 7b iveHandle.. {
2760: 0d 0a 20 20 20 20 20 20 20 20 23 72 65 67 69 6f .. #regio
2770: 6e 20 50 72 69 76 61 74 65 20 44 61 74 61 0d 0a n Private Data..
2780: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
2790: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
27a0: 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 76 61 // The native va
27b0: 6c 75 65 20 68 61 6e 64 6c 65 2e 0d 0a 20 20 20 lue handle...
27c0: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
27d0: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 72 69 ry>.. pri
27e0: 76 61 74 65 20 49 6e 74 50 74 72 20 70 56 61 6c vate IntPtr pVal
27f0: 75 65 3b 0d 0a 20 20 20 20 20 20 20 20 23 65 6e ue;.. #en
2800: 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 dregion....
2810: 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
2820: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2830: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2840: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2850: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
2860: 20 20 20 20 20 20 23 72 65 67 69 6f 6e 20 50 72 #region Pr
2870: 69 76 61 74 65 20 43 6f 6e 73 74 72 75 63 74 6f ivate Constructo
2880: 72 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 rs.. ///
2890: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
28a0: 20 20 20 2f 2f 2f 20 43 6f 6e 73 74 72 75 63 74 /// Construct
28b0: 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 s an instance of
28c0: 20 74 68 69 73 20 63 6c 61 73 73 20 75 73 69 6e this class usin
28d0: 67 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 g the specified
28e0: 6e 61 74 69 76 65 0d 0a 20 20 20 20 20 20 20 20 native..
28f0: 2f 2f 2f 20 76 61 6c 75 65 20 68 61 6e 64 6c 65 /// value handle
2900: 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
2910: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
2920: 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
2930: 6d 65 3d 22 70 56 61 6c 75 65 22 3e 0d 0a 20 20 me="pValue">..
2940: 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 /// The na
2950: 74 69 76 65 20 76 61 6c 75 65 20 68 61 6e 64 6c tive value handl
2960: 65 20 74 6f 20 75 73 65 2e 0d 0a 20 20 20 20 20 e to use...
2970: 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
2980: 0a 20 20 20 20 20 20 20 20 70 72 69 76 61 74 65 . private
2990: 20 53 51 4c 69 74 65 56 61 6c 75 65 28 49 6e 74 SQLiteValue(Int
29a0: 50 74 72 20 70 56 61 6c 75 65 29 0d 0a 20 20 20 Ptr pValue)..
29b0: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
29c0: 20 20 20 20 74 68 69 73 2e 70 56 61 6c 75 65 20 this.pValue
29d0: 3d 20 70 56 61 6c 75 65 3b 0d 0a 20 20 20 20 20 = pValue;..
29e0: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 }.. #e
29f0: 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 ndregion....
2a00: 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
2a10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a40: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
2a50: 20 20 20 20 20 20 20 23 72 65 67 69 6f 6e 20 50 #region P
2a60: 72 69 76 61 74 65 20 4d 65 74 68 6f 64 73 0d 0a rivate Methods..
2a70: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
2a80: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
2a90: 2f 2f 20 49 6e 76 61 6c 69 64 61 74 65 73 20 74 // Invalidates t
2aa0: 68 65 20 6e 61 74 69 76 65 20 76 61 6c 75 65 20 he native value
2ab0: 68 61 6e 64 6c 65 2c 20 74 68 65 72 65 62 79 20 handle, thereby
2ac0: 70 72 65 76 65 6e 74 69 6e 67 20 66 75 72 74 68 preventing furth
2ad0: 65 72 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 er.. ///
2ae0: 61 63 63 65 73 73 20 74 6f 20 69 74 20 66 72 6f access to it fro
2af0: 6d 20 74 68 69 73 20 6f 62 6a 65 63 74 20 69 6e m this object in
2b00: 73 74 61 6e 63 65 2e 0d 0a 20 20 20 20 20 20 20 stance...
2b10: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
2b20: 0a 20 20 20 20 20 20 20 20 70 72 69 76 61 74 65 . private
2b30: 20 76 6f 69 64 20 50 72 65 76 65 6e 74 4e 61 74 void PreventNat
2b40: 69 76 65 41 63 63 65 73 73 28 29 0d 0a 20 20 20 iveAccess()..
2b50: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
2b60: 20 20 20 20 70 56 61 6c 75 65 20 3d 20 49 6e 74 pValue = Int
2b70: 50 74 72 2e 5a 65 72 6f 3b 0d 0a 20 20 20 20 20 Ptr.Zero;..
2b80: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 }.. #e
2b90: 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 ndregion....
2ba0: 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
2bb0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2bc0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2bd0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2be0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
2bf0: 20 20 20 20 20 20 20 23 72 65 67 69 6f 6e 20 49 #region I
2c00: 6e 74 65 72 6e 61 6c 20 4d 61 72 73 68 61 6c 20 nternal Marshal
2c10: 48 65 6c 70 65 72 20 4d 65 74 68 6f 64 73 0d 0a Helper Methods..
2c20: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
2c30: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
2c40: 2f 2f 20 43 6f 6e 76 65 72 74 73 20 61 20 6c 6f // Converts a lo
2c50: 67 69 63 61 6c 20 61 72 72 61 79 20 6f 66 20 6e gical array of n
2c60: 61 74 69 76 65 20 70 6f 69 6e 74 65 72 73 20 74 ative pointers t
2c70: 6f 20 6e 61 74 69 76 65 20 73 71 6c 69 74 65 33 o native sqlite3
2c80: 5f 76 61 6c 75 65 0d 0a 20 20 20 20 20 20 20 20 _value..
2c90: 2f 2f 2f 20 73 74 72 75 63 74 75 72 65 73 20 69 /// structures i
2ca0: 6e 74 6f 20 61 20 6d 61 6e 61 67 65 64 20 61 72 nto a managed ar
2cb0: 72 61 79 20 6f 66 20 3c 73 65 65 20 63 72 65 66 ray of <see cref
2cc0: 3d 22 53 51 4c 69 74 65 56 61 6c 75 65 22 20 2f ="SQLiteValue" /
2cd0: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6f >.. /// o
2ce0: 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 73 2e bject instances.
2cf0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
2d00: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
2d10: 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
2d20: 65 3d 22 61 72 67 63 22 3e 0d 0a 20 20 20 20 20 e="argc">..
2d30: 20 20 20 2f 2f 2f 20 54 68 65 20 6e 75 6d 62 65 /// The numbe
2d40: 72 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 69 6e r of elements in
2d50: 20 74 68 65 20 6c 6f 67 69 63 61 6c 20 61 72 72 the logical arr
2d60: 61 79 20 6f 66 20 6e 61 74 69 76 65 20 73 71 6c ay of native sql
2d70: 69 74 65 33 5f 76 61 6c 75 65 0d 0a 20 20 20 20 ite3_value..
2d80: 20 20 20 20 2f 2f 2f 20 73 74 72 75 63 74 75 72 /// structur
2d90: 65 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f es... ///
2da0: 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
2db0: 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
2dc0: 6d 65 3d 22 61 72 67 76 22 3e 0d 0a 20 20 20 20 me="argv">..
2dd0: 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 /// The nati
2de0: 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 ve pointer to th
2df0: 65 20 6c 6f 67 69 63 61 6c 20 61 72 72 61 79 20 e logical array
2e00: 6f 66 20 6e 61 74 69 76 65 20 73 71 6c 69 74 65 of native sqlite
2e10: 33 5f 76 61 6c 75 65 0d 0a 20 20 20 20 20 20 20 3_value..
2e20: 20 2f 2f 2f 20 73 74 72 75 63 74 75 72 65 73 20 /// structures
2e30: 74 6f 20 63 6f 6e 76 65 72 74 2e 0d 0a 20 20 20 to convert...
2e40: 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
2e50: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
2e60: 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
2e70: 20 20 2f 2f 2f 20 54 68 65 20 6d 61 6e 61 67 65 /// The manage
2e80: 64 20 61 72 72 61 79 20 6f 66 20 3c 73 65 65 20 d array of <see
2e90: 63 72 65 66 3d 22 53 51 4c 69 74 65 56 61 6c 75 cref="SQLiteValu
2ea0: 65 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 e" /> object ins
2eb0: 74 61 6e 63 65 73 20 6f 72 0d 0a 20 20 20 20 20 tances or..
2ec0: 20 20 20 2f 2f 2f 20 6e 75 6c 6c 20 75 70 6f 6e /// null upon
2ed0: 20 66 61 69 6c 75 72 65 2e 0d 0a 20 20 20 20 20 failure...
2ee0: 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 /// </returns
2ef0: 3e 0d 0a 20 20 20 20 20 20 20 20 69 6e 74 65 72 >.. inter
2f00: 6e 61 6c 20 73 74 61 74 69 63 20 53 51 4c 69 74 nal static SQLit
2f10: 65 56 61 6c 75 65 5b 5d 20 41 72 72 61 79 46 72 eValue[] ArrayFr
2f20: 6f 6d 53 69 7a 65 41 6e 64 49 6e 74 50 74 72 28 omSizeAndIntPtr(
2f30: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e .. in
2f40: 74 20 61 72 67 63 2c 0d 0a 20 20 20 20 20 20 20 t argc,..
2f50: 20 20 20 20 20 49 6e 74 50 74 72 20 61 72 67 76 IntPtr argv
2f60: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 0d .. ).
2f70: 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 . {..
2f80: 20 20 20 20 20 20 20 20 69 66 20 28 61 72 67 63 if (argc
2f90: 20 3c 20 30 29 0d 0a 20 20 20 20 20 20 20 20 20 < 0)..
2fa0: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6e 75 return nu
2fb0: 6c 6c 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 ll;....
2fc0: 20 20 20 69 66 20 28 61 72 67 76 20 3d 3d 20 49 if (argv == I
2fd0: 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a 20 20 20 ntPtr.Zero)..
2fe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 ret
2ff0: 75 72 6e 20 6e 75 6c 6c 3b 0d 0a 0d 0a 20 20 20 urn null;....
3000: 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 56 SQLiteV
3010: 61 6c 75 65 5b 5d 20 72 65 73 75 6c 74 20 3d 20 alue[] result =
3020: 6e 65 77 20 53 51 4c 69 74 65 56 61 6c 75 65 5b new SQLiteValue[
3030: 61 72 67 63 5d 3b 0d 0a 0d 0a 20 20 20 20 20 20 argc];....
3040: 20 20 20 20 20 20 66 6f 72 20 28 69 6e 74 20 69 for (int i
3050: 6e 64 65 78 20 3d 20 30 2c 20 6f 66 66 73 65 74 ndex = 0, offset
3060: 20 3d 20 30 3b 0d 0a 20 20 20 20 20 20 20 20 20 = 0;..
3070: 20 20 20 20 20 20 20 20 20 20 20 69 6e 64 65 78 index
3080: 20 3c 20 72 65 73 75 6c 74 2e 4c 65 6e 67 74 68 < result.Length
3090: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ;..
30a0: 20 20 20 20 20 20 20 69 6e 64 65 78 2b 2b 2c 20 index++,
30b0: 6f 66 66 73 65 74 20 2b 3d 20 49 6e 74 50 74 72 offset += IntPtr
30c0: 2e 53 69 7a 65 29 0d 0a 20 20 20 20 20 20 20 20 .Size)..
30d0: 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 {..
30e0: 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 41 IntPtr pA
30f0: 72 67 20 3d 20 53 51 4c 69 74 65 4d 61 72 73 68 rg = SQLiteMarsh
3100: 61 6c 2e 52 65 61 64 49 6e 74 50 74 72 28 61 72 al.ReadIntPtr(ar
3110: 67 76 2c 20 6f 66 66 73 65 74 29 3b 0d 0a 0d 0a gv, offset);....
3120: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
3130: 72 65 73 75 6c 74 5b 69 6e 64 65 78 5d 20 3d 20 result[index] =
3140: 28 70 41 72 67 20 21 3d 20 49 6e 74 50 74 72 2e (pArg != IntPtr.
3150: 5a 65 72 6f 29 20 3f 0d 0a 20 20 20 20 20 20 20 Zero) ?..
3160: 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 65 77 new
3170: 20 53 51 4c 69 74 65 56 61 6c 75 65 28 70 41 72 SQLiteValue(pAr
3180: 67 29 20 3a 20 6e 75 6c 6c 3b 0d 0a 20 20 20 20 g) : null;..
3190: 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 }....
31a0: 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 return
31b0: 72 65 73 75 6c 74 3b 0d 0a 20 20 20 20 20 20 20 result;..
31c0: 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 }.. #end
31d0: 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 region....
31e0: 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////////
31f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3200: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3210: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3220: 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 /////////....
3230: 20 20 20 20 20 23 72 65 67 69 6f 6e 20 49 53 51 #region ISQ
3240: 4c 69 74 65 4e 61 74 69 76 65 48 61 6e 64 6c 65 LiteNativeHandle
3250: 20 4d 65 6d 62 65 72 73 0d 0a 20 20 20 20 20 20 Members..
3260: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d /// <summary>.
3270: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 52 65 74 . /// Ret
3280: 75 72 6e 73 20 74 68 65 20 75 6e 64 65 72 6c 79 urns the underly
3290: 69 6e 67 20 53 51 4c 69 74 65 20 6e 61 74 69 76 ing SQLite nativ
32a0: 65 20 68 61 6e 64 6c 65 20 61 73 73 6f 63 69 61 e handle associa
32b0: 74 65 64 20 77 69 74 68 20 74 68 69 73 0d 0a 20 ted with this..
32c0: 20 20 20 20 20 20 20 2f 2f 2f 20 6f 62 6a 65 63 /// objec
32d0: 74 20 69 6e 73 74 61 6e 63 65 2e 0d 0a 20 20 20 t instance...
32e0: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
32f0: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 ry>.. pub
3300: 6c 69 63 20 49 6e 74 50 74 72 20 4e 61 74 69 76 lic IntPtr Nativ
3310: 65 48 61 6e 64 6c 65 0d 0a 20 20 20 20 20 20 20 eHandle..
3320: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 {..
3330: 67 65 74 20 7b 20 72 65 74 75 72 6e 20 70 56 61 get { return pVa
3340: 6c 75 65 3b 20 7d 0d 0a 20 20 20 20 20 20 20 20 lue; }..
3350: 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 72 }.. #endr
3360: 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 egion....
3370: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
3380: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3390: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
33a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
33b0: 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 ////////....
33c0: 20 20 20 20 23 72 65 67 69 6f 6e 20 50 75 62 6c #region Publ
33d0: 69 63 20 50 72 6f 70 65 72 74 69 65 73 0d 0a 20 ic Properties..
33e0: 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 62 private b
33f0: 6f 6f 6c 20 70 65 72 73 69 73 74 65 64 3b 0d 0a ool persisted;..
3400: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
3410: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
3420: 2f 2f 20 52 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a // Returns non-z
3430: 65 72 6f 20 69 66 20 74 68 65 20 6e 61 74 69 76 ero if the nativ
3440: 65 20 53 51 4c 69 74 65 20 76 61 6c 75 65 20 68 e SQLite value h
3450: 61 73 20 62 65 65 6e 20 73 75 63 63 65 73 73 66 as been successf
3460: 75 6c 6c 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f ully.. //
3470: 2f 20 70 65 72 73 69 73 74 65 64 20 61 73 20 61 / persisted as a
3480: 20 6d 61 6e 61 67 65 64 20 76 61 6c 75 65 20 77 managed value w
3490: 69 74 68 69 6e 20 74 68 69 73 20 6f 62 6a 65 63 ithin this objec
34a0: 74 20 69 6e 73 74 61 6e 63 65 20 28 69 2e 65 2e t instance (i.e.
34b0: 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f the.. //
34c0: 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 56 61 6c / <see cref="Val
34d0: 75 65 22 20 2f 3e 20 70 72 6f 70 65 72 74 79 20 ue" /> property
34e0: 6d 61 79 20 74 68 65 6e 20 62 65 20 72 65 61 64 may then be read
34f0: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 29 2e 0d successfully)..
3500: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
3510: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
3520: 20 70 75 62 6c 69 63 20 62 6f 6f 6c 20 50 65 72 public bool Per
3530: 73 69 73 74 65 64 0d 0a 20 20 20 20 20 20 20 20 sisted..
3540: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 {.. g
3550: 65 74 20 7b 20 72 65 74 75 72 6e 20 70 65 72 73 et { return pers
3560: 69 73 74 65 64 3b 20 7d 0d 0a 20 20 20 20 20 20 isted; }..
3570: 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f }.... /
3580: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3590: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
35a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
35b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
35c0: 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
35d0: 20 20 70 72 69 76 61 74 65 20 6f 62 6a 65 63 74 private object
35e0: 20 76 61 6c 75 65 3b 0d 0a 20 20 20 20 20 20 20 value;..
35f0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
3600: 20 20 20 20 20 20 20 20 2f 2f 2f 20 49 66 20 74 /// If t
3610: 68 65 20 6d 61 6e 61 67 65 64 20 76 61 6c 75 65 he managed value
3620: 20 66 6f 72 20 74 68 69 73 20 6f 62 6a 65 63 74 for this object
3630: 20 69 6e 73 74 61 6e 63 65 20 69 73 20 61 76 61 instance is ava
3640: 69 6c 61 62 6c 65 20 28 69 2e 65 2e 20 69 74 0d ilable (i.e. it.
3650: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 68 61 73 . /// has
3660: 20 62 65 65 6e 20 70 72 65 76 69 6f 75 73 6c 79 been previously
3670: 20 70 65 72 73 69 73 74 65 64 20 76 69 61 20 74 persisted via t
3680: 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 50 65 he <see cref="Pe
3690: 72 73 69 73 74 22 20 2f 3e 29 20 6d 65 74 68 6f rsist" />) metho
36a0: 64 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 d,.. ///
36b0: 74 68 61 74 20 76 61 6c 75 65 20 69 73 20 72 65 that value is re
36c0: 74 75 72 6e 65 64 3b 20 6f 74 68 65 72 77 69 73 turned; otherwis
36d0: 65 2c 20 61 6e 20 65 78 63 65 70 74 69 6f 6e 20 e, an exception
36e0: 69 73 20 74 68 72 6f 77 6e 2e 20 20 54 68 65 0d is thrown. The.
36f0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 72 65 74 . /// ret
3700: 75 72 6e 65 64 20 76 61 6c 75 65 20 6d 61 79 20 urned value may
3710: 62 65 20 6e 75 6c 6c 2e 0d 0a 20 20 20 20 20 20 be null...
3720: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
3730: 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 .. public
3740: 20 6f 62 6a 65 63 74 20 56 61 6c 75 65 0d 0a 20 object Value..
3750: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
3760: 20 20 20 20 20 20 67 65 74 0d 0a 20 20 20 20 20 get..
3770: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
3780: 20 20 20 20 20 20 20 20 20 20 69 66 20 28 21 70 if (!p
3790: 65 72 73 69 73 74 65 64 29 0d 0a 20 20 20 20 20 ersisted)..
37a0: 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 {..
37b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37c0: 20 20 74 68 72 6f 77 20 6e 65 77 20 49 6e 76 61 throw new Inva
37d0: 6c 69 64 4f 70 65 72 61 74 69 6f 6e 45 78 63 65 lidOperationExce
37e0: 70 74 69 6f 6e 28 0d 0a 20 20 20 20 20 20 20 20 ption(..
37f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
3800: 22 76 61 6c 75 65 20 77 61 73 20 6e 6f 74 20 70 "value was not p
3810: 65 72 73 69 73 74 65 64 22 29 3b 0d 0a 20 20 20 ersisted");..
3820: 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a }..
3830: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
3840: 20 20 72 65 74 75 72 6e 20 76 61 6c 75 65 3b 0d return value;.
3850: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a . }..
3860: 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 }..
3870: 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d #endregion...
3880: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
3890: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
38a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
38b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
38c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
38d0: 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 67 .... #reg
38e0: 69 6f 6e 20 50 75 62 6c 69 63 20 4d 65 74 68 6f ion Public Metho
38f0: 64 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ds.. ///
3900: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
3910: 20 20 20 2f 2f 2f 20 47 65 74 73 20 61 6e 64 20 /// Gets and
3920: 72 65 74 75 72 6e 73 20 74 68 65 20 74 79 70 65 returns the type
3930: 20 61 66 66 69 6e 69 74 79 20 61 73 73 6f 63 69 affinity associ
3940: 61 74 65 64 20 77 69 74 68 20 74 68 69 73 20 76 ated with this v
3950: 61 6c 75 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f alue... /
3960: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
3970: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 /// <retu
3980: 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f rns>.. //
3990: 2f 20 54 68 65 20 74 79 70 65 20 61 66 66 69 6e / The type affin
39a0: 69 74 79 20 61 73 73 6f 63 69 61 74 65 64 20 77 ity associated w
39b0: 69 74 68 20 74 68 69 73 20 76 61 6c 75 65 2e 0d ith this value..
39c0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 . /// </r
39d0: 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 eturns>..
39e0: 20 70 75 62 6c 69 63 20 54 79 70 65 41 66 66 69 public TypeAffi
39f0: 6e 69 74 79 20 47 65 74 54 79 70 65 41 66 66 69 nity GetTypeAffi
3a00: 6e 69 74 79 28 29 0d 0a 20 20 20 20 20 20 20 20 nity()..
3a10: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 {.. i
3a20: 66 20 28 70 56 61 6c 75 65 20 3d 3d 20 49 6e 74 f (pValue == Int
3a30: 50 74 72 2e 5a 65 72 6f 29 20 72 65 74 75 72 6e Ptr.Zero) return
3a40: 20 54 79 70 65 41 66 66 69 6e 69 74 79 2e 4e 6f TypeAffinity.No
3a50: 6e 65 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ne;..
3a60: 20 72 65 74 75 72 6e 20 55 6e 73 61 66 65 4e 61 return UnsafeNa
3a70: 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 tiveMethods.sqli
3a80: 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 28 70 te3_value_type(p
3a90: 56 61 6c 75 65 29 3b 0d 0a 20 20 20 20 20 20 20 Value);..
3aa0: 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f }.... //
3ab0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3ac0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3ad0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3ae0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3af0: 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
3b00: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
3b10: 20 20 20 20 20 20 20 20 2f 2f 2f 20 47 65 74 73 /// Gets
3b20: 20 61 6e 64 20 72 65 74 75 72 6e 73 20 74 68 65 and returns the
3b30: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 number of bytes
3b40: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
3b50: 20 74 68 69 73 20 76 61 6c 75 65 2c 20 69 66 0d this value, if.
3b60: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 74 20 . /// it
3b70: 72 65 66 65 72 73 20 74 6f 20 61 20 55 54 46 2d refers to a UTF-
3b80: 38 20 65 6e 63 6f 64 65 64 20 73 74 72 69 6e 67 8 encoded string
3b90: 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
3ba0: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
3bb0: 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e /// <returns>
3bc0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
3bd0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 e number of byte
3be0: 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 s associated wit
3bf0: 68 20 74 68 69 73 20 76 61 6c 75 65 2e 20 20 54 h this value. T
3c00: 68 65 20 72 65 74 75 72 6e 65 64 20 76 61 6c 75 he returned valu
3c10: 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6d e.. /// m
3c20: 61 79 20 62 65 20 7a 65 72 6f 2e 0d 0a 20 20 20 ay be zero...
3c30: 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 /// </retur
3c40: 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 ns>.. pub
3c50: 6c 69 63 20 69 6e 74 20 47 65 74 42 79 74 65 73 lic int GetBytes
3c60: 28 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 ().. {..
3c70: 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 70 if (p
3c80: 56 61 6c 75 65 20 3d 3d 20 49 6e 74 50 74 72 2e Value == IntPtr.
3c90: 5a 65 72 6f 29 20 72 65 74 75 72 6e 20 30 3b 0d Zero) return 0;.
3ca0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 . ret
3cb0: 75 72 6e 20 55 6e 73 61 66 65 4e 61 74 69 76 65 urn UnsafeNative
3cc0: 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f Methods.sqlite3_
3cd0: 76 61 6c 75 65 5f 62 79 74 65 73 28 70 56 61 6c value_bytes(pVal
3ce0: 75 65 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d ue);.. }.
3cf0: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
3d00: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3d10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3d20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3d30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3d40: 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f //.... //
3d50: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
3d60: 20 20 20 20 20 2f 2f 2f 20 47 65 74 73 20 61 6e /// Gets an
3d70: 64 20 72 65 74 75 72 6e 73 20 74 68 65 20 3c 73 d returns the <s
3d80: 65 65 20 63 72 65 66 3d 22 49 6e 74 33 32 22 20 ee cref="Int32"
3d90: 2f 3e 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 /> associated wi
3da0: 74 68 20 74 68 69 73 0d 0a 20 20 20 20 20 20 20 th this..
3db0: 20 2f 2f 2f 20 76 61 6c 75 65 2e 0d 0a 20 20 20 /// value...
3dc0: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
3dd0: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
3de0: 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 <returns>..
3df0: 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 /// The <see
3e00: 20 63 72 65 66 3d 22 49 6e 74 33 32 22 20 2f 3e cref="Int32" />
3e10: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
3e20: 20 74 68 69 73 20 76 61 6c 75 65 2e 0d 0a 20 20 this value...
3e30: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 /// </retu
3e40: 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 rns>.. pu
3e50: 62 6c 69 63 20 69 6e 74 20 47 65 74 49 6e 74 28 blic int GetInt(
3e60: 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 ).. {..
3e70: 20 20 20 20 20 20 20 20 20 20 69 66 20 28 70 56 if (pV
3e80: 61 6c 75 65 20 3d 3d 20 49 6e 74 50 74 72 2e 5a alue == IntPtr.Z
3e90: 65 72 6f 29 20 72 65 74 75 72 6e 20 64 65 66 61 ero) return defa
3ea0: 75 6c 74 28 69 6e 74 29 3b 0d 0a 20 20 20 20 20 ult(int);..
3eb0: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 55 6e return Un
3ec0: 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 safeNativeMethod
3ed0: 73 2e 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f s.sqlite3_value_
3ee0: 69 6e 74 28 70 56 61 6c 75 65 29 3b 0d 0a 20 20 int(pValue);..
3ef0: 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 }....
3f00: 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
3f10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3f20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3f30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
3f40: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
3f50: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
3f60: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
3f70: 20 47 65 74 73 20 61 6e 64 20 72 65 74 75 72 6e Gets and return
3f80: 73 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d s the <see cref=
3f90: 22 49 6e 74 36 34 22 20 2f 3e 20 61 73 73 6f 63 "Int64" /> assoc
3fa0: 69 61 74 65 64 20 77 69 74 68 0d 0a 20 20 20 20 iated with..
3fb0: 20 20 20 20 2f 2f 2f 20 74 68 69 73 20 76 61 6c /// this val
3fc0: 75 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ue... ///
3fd0: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
3fe0: 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e /// <return
3ff0: 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s>.. ///
4000: 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 The <see cref="I
4010: 6e 74 36 34 22 20 2f 3e 20 61 73 73 6f 63 69 61 nt64" /> associa
4020: 74 65 64 20 77 69 74 68 20 74 68 69 73 20 76 61 ted with this va
4030: 6c 75 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f lue... //
4040: 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 / </returns>..
4050: 20 20 20 20 20 20 70 75 62 6c 69 63 20 6c 6f 6e public lon
4060: 67 20 47 65 74 49 6e 74 36 34 28 29 0d 0a 20 20 g GetInt64()..
4070: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
4080: 20 20 20 20 20 69 66 20 28 70 56 61 6c 75 65 20 if (pValue
4090: 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 20 == IntPtr.Zero)
40a0: 72 65 74 75 72 6e 20 64 65 66 61 75 6c 74 28 6c return default(l
40b0: 6f 6e 67 29 3b 0d 0a 0d 0a 23 69 66 20 21 50 4c ong);....#if !PL
40c0: 41 54 46 4f 52 4d 5f 43 4f 4d 50 41 43 54 46 52 ATFORM_COMPACTFR
40d0: 41 4d 45 57 4f 52 4b 0d 0a 20 20 20 20 20 20 20 AMEWORK..
40e0: 20 20 20 20 20 72 65 74 75 72 6e 20 55 6e 73 61 return Unsa
40f0: 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e feNativeMethods.
4100: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e sqlite3_value_in
4110: 74 36 34 28 70 56 61 6c 75 65 29 3b 0d 0a 23 65 t64(pValue);..#e
4120: 6c 69 66 20 21 53 51 4c 49 54 45 5f 53 54 41 4e lif !SQLITE_STAN
4130: 44 41 52 44 0d 0a 20 20 20 20 20 20 20 20 20 20 DARD..
4140: 20 20 6c 6f 6e 67 20 76 61 6c 75 65 3b 0d 0a 20 long value;..
4150: 20 20 20 20 20 20 20 20 20 20 20 55 6e 73 61 66 Unsaf
4160: 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 eNativeMethods.s
4170: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 qlite3_value_int
4180: 36 34 5f 69 6e 74 65 72 6f 70 28 70 56 61 6c 75 64_interop(pValu
4190: 65 2c 20 6f 75 74 20 76 61 6c 75 65 29 3b 0d 0a e, out value);..
41a0: 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
41b0: 72 6e 20 76 61 6c 75 65 3b 0d 0a 23 65 6c 73 65 rn value;..#else
41c0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 68 .. th
41d0: 72 6f 77 20 6e 65 77 20 4e 6f 74 49 6d 70 6c 65 row new NotImple
41e0: 6d 65 6e 74 65 64 45 78 63 65 70 74 69 6f 6e 28 mentedException(
41f0: 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 );..#endif..
4200: 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 }....
4210: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
4220: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
4230: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
4240: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
4250: 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 ////////....
4260: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
4270: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 47 >.. /// G
4280: 65 74 73 20 61 6e 64 20 72 65 74 75 72 6e 73 20 ets and returns
4290: 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 44 the <see cref="D
42a0: 6f 75 62 6c 65 22 20 2f 3e 20 61 73 73 6f 63 69 ouble" /> associ
42b0: 61 74 65 64 20 77 69 74 68 20 74 68 69 73 0d 0a ated with this..
42c0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 76 61 6c 75 /// valu
42d0: 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
42e0: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
42f0: 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
4300: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
4310: 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 44 6f he <see cref="Do
4320: 75 62 6c 65 22 20 2f 3e 20 61 73 73 6f 63 69 61 uble" /> associa
4330: 74 65 64 20 77 69 74 68 20 74 68 69 73 20 76 61 ted with this va
4340: 6c 75 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f lue... //
4350: 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 / </returns>..
4360: 20 20 20 20 20 20 70 75 62 6c 69 63 20 64 6f 75 public dou
4370: 62 6c 65 20 47 65 74 44 6f 75 62 6c 65 28 29 0d ble GetDouble().
4380: 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 . {..
4390: 20 20 20 20 20 20 20 20 69 66 20 28 70 56 61 6c if (pVal
43a0: 75 65 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 ue == IntPtr.Zer
43b0: 6f 29 20 72 65 74 75 72 6e 20 64 65 66 61 75 6c o) return defaul
43c0: 74 28 64 6f 75 62 6c 65 29 3b 0d 0a 0d 0a 23 69 t(double);....#i
43d0: 66 20 21 50 4c 41 54 46 4f 52 4d 5f 43 4f 4d 50 f !PLATFORM_COMP
43e0: 41 43 54 46 52 41 4d 45 57 4f 52 4b 0d 0a 20 20 ACTFRAMEWORK..
43f0: 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
4400: 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 UnsafeNativeMet
4410: 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 76 61 6c hods.sqlite3_val
4420: 75 65 5f 64 6f 75 62 6c 65 28 70 56 61 6c 75 65 ue_double(pValue
4430: 29 3b 0d 0a 23 65 6c 69 66 20 21 53 51 4c 49 54 );..#elif !SQLIT
4440: 45 5f 53 54 41 4e 44 41 52 44 0d 0a 20 20 20 20 E_STANDARD..
4450: 20 20 20 20 20 20 20 20 64 6f 75 62 6c 65 20 76 double v
4460: 61 6c 75 65 3b 0d 0a 20 20 20 20 20 20 20 20 20 alue;..
4470: 20 20 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d UnsafeNativeM
4480: 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 76 ethods.sqlite3_v
4490: 61 6c 75 65 5f 64 6f 75 62 6c 65 5f 69 6e 74 65 alue_double_inte
44a0: 72 6f 70 28 70 56 61 6c 75 65 2c 20 6f 75 74 20 rop(pValue, out
44b0: 76 61 6c 75 65 29 3b 0d 0a 20 20 20 20 20 20 20 value);..
44c0: 20 20 20 20 20 72 65 74 75 72 6e 20 76 61 6c 75 return valu
44d0: 65 3b 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20 e;..#else..
44e0: 20 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77 throw new
44f0: 20 4e 6f 74 49 6d 70 6c 65 6d 65 6e 74 65 64 45 NotImplementedE
4500: 78 63 65 70 74 69 6f 6e 28 29 3b 0d 0a 23 65 6e xception();..#en
4510: 64 69 66 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a dif.. }..
4520: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
4530: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
4540: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
4550: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
4560: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
4570: 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f /.... ///
4580: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
4590: 20 20 20 20 2f 2f 2f 20 47 65 74 73 20 61 6e 64 /// Gets and
45a0: 20 72 65 74 75 72 6e 73 20 74 68 65 20 3c 73 65 returns the <se
45b0: 65 20 63 72 65 66 3d 22 53 74 72 69 6e 67 22 20 e cref="String"
45c0: 2f 3e 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 /> associated wi
45d0: 74 68 20 74 68 69 73 0d 0a 20 20 20 20 20 20 20 th this..
45e0: 20 2f 2f 2f 20 76 61 6c 75 65 2e 0d 0a 20 20 20 /// value...
45f0: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
4600: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
4610: 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 <returns>..
4620: 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 /// The <see
4630: 20 63 72 65 66 3d 22 53 74 72 69 6e 67 22 20 2f cref="String" /
4640: 3e 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 > associated wit
4650: 68 20 74 68 69 73 20 76 61 6c 75 65 2e 20 20 54 h this value. T
4660: 68 65 20 76 61 6c 75 65 20 69 73 0d 0a 20 20 20 he value is..
4670: 20 20 20 20 20 2f 2f 2f 20 63 6f 6e 76 65 72 74 /// convert
4680: 65 64 20 66 72 6f 6d 20 74 68 65 20 55 54 46 2d ed from the UTF-
4690: 38 20 65 6e 63 6f 64 69 6e 67 20 70 72 69 6f 72 8 encoding prior
46a0: 20 74 6f 20 62 65 69 6e 67 20 72 65 74 75 72 6e to being return
46b0: 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ed... ///
46c0: 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 </returns>..
46d0: 20 20 20 20 20 70 75 62 6c 69 63 20 73 74 72 69 public stri
46e0: 6e 67 20 47 65 74 53 74 72 69 6e 67 28 29 0d 0a ng GetString()..
46f0: 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
4700: 20 20 20 20 20 20 20 69 66 20 28 70 56 61 6c 75 if (pValu
4710: 65 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f e == IntPtr.Zero
4720: 29 20 72 65 74 75 72 6e 20 6e 75 6c 6c 3b 0d 0a ) return null;..
4730: 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
4740: 72 6e 20 53 51 4c 69 74 65 53 74 72 69 6e 67 2e rn SQLiteString.
4750: 53 74 72 69 6e 67 46 72 6f 6d 55 74 66 38 49 6e StringFromUtf8In
4760: 74 50 74 72 28 70 56 61 6c 75 65 2c 20 47 65 74 tPtr(pValue, Get
4770: 42 79 74 65 73 28 29 29 3b 0d 0a 20 20 20 20 20 Bytes());..
4780: 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 }....
4790: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
47a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
47b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
47c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
47d0: 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
47e0: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
47f0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 47 65 .. /// Ge
4800: 74 73 20 61 6e 64 20 72 65 74 75 72 6e 73 20 74 ts and returns t
4810: 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 42 79 he <see cref="By
4820: 74 65 22 20 2f 3e 20 61 72 72 61 79 20 61 73 73 te" /> array ass
4830: 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 69 ociated with thi
4840: 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 76 s.. /// v
4850: 61 6c 75 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f alue... /
4860: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
4870: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 /// <retu
4880: 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f rns>.. //
4890: 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d / The <see cref=
48a0: 22 42 79 74 65 22 20 2f 3e 20 61 72 72 61 79 20 "Byte" /> array
48b0: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
48c0: 74 68 69 73 20 76 61 6c 75 65 2e 0d 0a 20 20 20 this value...
48d0: 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 /// </retur
48e0: 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 ns>.. pub
48f0: 6c 69 63 20 62 79 74 65 5b 5d 20 47 65 74 42 6c lic byte[] GetBl
4900: 6f 62 28 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d ob().. {.
4910: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 . if
4920: 28 70 56 61 6c 75 65 20 3d 3d 20 49 6e 74 50 74 (pValue == IntPt
4930: 72 2e 5a 65 72 6f 29 20 72 65 74 75 72 6e 20 6e r.Zero) return n
4940: 75 6c 6c 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 ull;..
4950: 20 20 72 65 74 75 72 6e 20 53 51 4c 69 74 65 42 return SQLiteB
4960: 79 74 65 73 2e 46 72 6f 6d 49 6e 74 50 74 72 28 ytes.FromIntPtr(
4970: 70 56 61 6c 75 65 2c 20 47 65 74 42 79 74 65 73 pValue, GetBytes
4980: 28 29 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d ());.. }.
4990: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
49a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
49b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
49c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
49d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
49e0: 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f //.... //
49f0: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
4a00: 20 20 20 20 20 2f 2f 2f 20 55 73 65 73 20 74 68 /// Uses th
4a10: 65 20 6e 61 74 69 76 65 20 76 61 6c 75 65 20 68 e native value h
4a20: 61 6e 64 6c 65 20 74 6f 20 6f 62 74 61 69 6e 20 andle to obtain
4a30: 61 6e 64 20 73 74 6f 72 65 20 74 68 65 20 6d 61 and store the ma
4a40: 6e 61 67 65 64 20 76 61 6c 75 65 0d 0a 20 20 20 naged value..
4a50: 20 20 20 20 20 2f 2f 2f 20 66 6f 72 20 74 68 69 /// for thi
4a60: 73 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 s object instanc
4a70: 65 2c 20 74 68 75 73 20 73 61 76 69 6e 67 20 69 e, thus saving i
4a80: 74 20 66 6f 72 20 6c 61 74 65 72 20 75 73 65 2e t for later use.
4a90: 20 20 54 68 65 20 74 79 70 65 0d 0a 20 20 20 20 The type..
4aa0: 20 20 20 20 2f 2f 2f 20 6f 66 20 74 68 65 20 6d /// of the m
4ab0: 61 6e 61 67 65 64 20 76 61 6c 75 65 20 69 73 20 anaged value is
4ac0: 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 determined by th
4ad0: 65 20 74 79 70 65 20 61 66 66 69 6e 69 74 79 20 e type affinity
4ae0: 6f 66 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 of the..
4af0: 2f 2f 2f 20 6e 61 74 69 76 65 20 76 61 6c 75 65 /// native value
4b00: 2e 20 20 49 66 20 74 68 65 20 74 79 70 65 20 61 . If the type a
4b10: 66 66 69 6e 69 74 79 20 69 73 20 6e 6f 74 20 72 ffinity is not r
4b20: 65 63 6f 67 6e 69 7a 65 64 20 62 79 20 74 68 69 ecognized by thi
4b30: 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6d s.. /// m
4b40: 65 74 68 6f 64 2c 20 6e 6f 20 77 6f 72 6b 20 69 ethod, no work i
4b50: 73 20 64 6f 6e 65 20 61 6e 64 20 66 61 6c 73 65 s done and false
4b60: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0d 0a 20 is returned...
4b70: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
4b80: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
4b90: 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 // <returns>..
4ba0: 20 20 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 /// Non-ze
4bb0: 72 6f 20 69 66 20 74 68 65 20 6e 61 74 69 76 65 ro if the native
4bc0: 20 76 61 6c 75 65 20 77 61 73 20 70 65 72 73 69 value was persi
4bd0: 73 74 65 64 20 73 75 63 63 65 73 73 66 75 6c 6c sted successfull
4be0: 79 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y... ///
4bf0: 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 </returns>..
4c00: 20 20 20 20 70 75 62 6c 69 63 20 62 6f 6f 6c 20 public bool
4c10: 50 65 72 73 69 73 74 28 29 0d 0a 20 20 20 20 20 Persist()..
4c20: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
4c30: 20 20 73 77 69 74 63 68 20 28 47 65 74 54 79 70 switch (GetTyp
4c40: 65 41 66 66 69 6e 69 74 79 28 29 29 0d 0a 20 20 eAffinity())..
4c50: 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 {..
4c60: 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 73 cas
4c70: 65 20 54 79 70 65 41 66 66 69 6e 69 74 79 2e 55 e TypeAffinity.U
4c80: 6e 69 6e 69 74 69 61 6c 69 7a 65 64 3a 0d 0a 20 ninitialized:..
4c90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4ca0: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
4cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 76 61 va
4cc0: 6c 75 65 20 3d 20 6e 75 6c 6c 3b 0d 0a 20 20 20 lue = null;..
4cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4ce0: 20 20 20 20 20 50 72 65 76 65 6e 74 4e 61 74 69 PreventNati
4cf0: 76 65 41 63 63 65 73 73 28 29 3b 0d 0a 20 20 20 veAccess();..
4d00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4d10: 20 20 20 20 20 72 65 74 75 72 6e 20 28 70 65 72 return (per
4d20: 73 69 73 74 65 64 20 3d 20 74 72 75 65 29 3b 0d sisted = true);.
4d30: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
4d40: 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 }..
4d50: 20 20 20 20 20 20 20 20 63 61 73 65 20 54 79 70 case Typ
4d60: 65 41 66 66 69 6e 69 74 79 2e 49 6e 74 36 34 3a eAffinity.Int64:
4d70: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
4d80: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
4d90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4da0: 20 76 61 6c 75 65 20 3d 20 47 65 74 49 6e 74 36 value = GetInt6
4db0: 34 28 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 4();..
4dc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 50 72 Pr
4dd0: 65 76 65 6e 74 4e 61 74 69 76 65 41 63 63 65 73 eventNativeAcces
4de0: 73 28 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 s();..
4df0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
4e00: 74 75 72 6e 20 28 70 65 72 73 69 73 74 65 64 20 turn (persisted
4e10: 3d 20 74 72 75 65 29 3b 0d 0a 20 20 20 20 20 20 = true);..
4e20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d }.
4e30: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
4e40: 20 63 61 73 65 20 54 79 70 65 41 66 66 69 6e 69 case TypeAffini
4e50: 74 79 2e 44 6f 75 62 6c 65 3a 0d 0a 20 20 20 20 ty.Double:..
4e60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4e70: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 {..
4e80: 20 20 20 20 20 20 20 20 20 20 20 76 61 6c 75 65 value
4e90: 20 3d 20 47 65 74 44 6f 75 62 6c 65 28 29 3b 0d = GetDouble();.
4ea0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
4eb0: 20 20 20 20 20 20 20 20 20 50 72 65 76 65 6e 74 Prevent
4ec0: 4e 61 74 69 76 65 41 63 63 65 73 73 28 29 3b 0d NativeAccess();.
4ed0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
4ee0: 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 return
4ef0: 28 70 65 72 73 69 73 74 65 64 20 3d 20 74 72 75 (persisted = tru
4f00: 65 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 e);..
4f10: 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 }..
4f20: 20 20 20 20 20 20 20 20 20 20 20 20 63 61 73 65 case
4f30: 20 54 79 70 65 41 66 66 69 6e 69 74 79 2e 54 65 TypeAffinity.Te
4f40: 78 74 3a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 xt:..
4f50: 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
4f60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4f70: 20 20 20 20 76 61 6c 75 65 20 3d 20 47 65 74 53 value = GetS
4f80: 74 72 69 6e 67 28 29 3b 0d 0a 20 20 20 20 20 20 tring();..
4f90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4fa0: 20 20 50 72 65 76 65 6e 74 4e 61 74 69 76 65 41 PreventNativeA
4fb0: 63 63 65 73 73 28 29 3b 0d 0a 20 20 20 20 20 20 ccess();..
4fc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4fd0: 20 20 72 65 74 75 72 6e 20 28 70 65 72 73 69 73 return (persis
4fe0: 74 65 64 20 3d 20 74 72 75 65 29 3b 0d 0a 20 20 ted = true);..
4ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5000: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 }..
5010: 20 20 20 20 20 63 61 73 65 20 54 79 70 65 41 66 case TypeAf
5020: 66 69 6e 69 74 79 2e 42 6c 6f 62 3a 0d 0a 20 20 finity.Blob:..
5030: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5040: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
5050: 20 20 20 20 20 20 20 20 20 20 20 20 20 76 61 6c val
5060: 75 65 20 3d 20 47 65 74 42 79 74 65 73 28 29 3b ue = GetBytes();
5070: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
5080: 20 20 20 20 20 20 20 20 20 20 50 72 65 76 65 6e Preven
5090: 74 4e 61 74 69 76 65 41 63 63 65 73 73 28 29 3b tNativeAccess();
50a0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
50b0: 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
50c0: 20 28 70 65 72 73 69 73 74 65 64 20 3d 20 74 72 (persisted = tr
50d0: 75 65 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 ue);..
50e0: 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 }..
50f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 73 cas
5100: 65 20 54 79 70 65 41 66 66 69 6e 69 74 79 2e 4e e TypeAffinity.N
5110: 75 6c 6c 3a 0d 0a 20 20 20 20 20 20 20 20 20 20 ull:..
5120: 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 {..
5130: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5140: 20 20 20 20 20 76 61 6c 75 65 20 3d 20 44 42 4e value = DBN
5150: 75 6c 6c 2e 56 61 6c 75 65 3b 0d 0a 20 20 20 20 ull.Value;..
5160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5170: 20 20 20 20 50 72 65 76 65 6e 74 4e 61 74 69 76 PreventNativ
5180: 65 41 63 63 65 73 73 28 29 3b 0d 0a 20 20 20 20 eAccess();..
5190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
51a0: 20 20 20 20 72 65 74 75 72 6e 20 28 70 65 72 73 return (pers
51b0: 69 73 74 65 64 20 3d 20 74 72 75 65 29 3b 0d 0a isted = true);..
51c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
51d0: 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 }..
51e0: 20 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a 0d default:.
51f0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
5200: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
5210: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5220: 72 65 74 75 72 6e 20 66 61 6c 73 65 3b 0d 0a 20 return false;..
5230: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5240: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 }..
5250: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a }.. }..
5260: 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 #endregi
5270: 6f 6e 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 on.. }.. #
5280: 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 endregion....
5290: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
52a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
52b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
52c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
52d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
52e0: 20 20 20 20 23 72 65 67 69 6f 6e 20 53 51 4c 69 #region SQLi
52f0: 74 65 49 6e 64 65 78 43 6f 6e 73 74 72 61 69 6e teIndexConstrain
5300: 74 4f 70 20 45 6e 75 6d 65 72 61 74 69 6f 6e 0d tOp Enumeration.
5310: 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 . /// <summar
5320: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 65 73 y>.. /// Thes
5330: 65 20 61 72 65 20 74 68 65 20 61 6c 6c 6f 77 65 e are the allowe
5340: 64 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 65 d values for the
5350: 20 6f 70 65 72 61 74 6f 72 73 20 74 68 61 74 20 operators that
5360: 61 72 65 20 70 61 72 74 20 6f 66 20 61 0d 0a 20 are part of a..
5370: 20 20 20 2f 2f 2f 20 63 6f 6e 73 74 72 61 69 6e /// constrain
5380: 74 20 74 65 72 6d 20 69 6e 20 74 68 65 20 57 48 t term in the WH
5390: 45 52 45 20 63 6c 61 75 73 65 20 6f 66 20 61 20 ERE clause of a
53a0: 71 75 65 72 79 20 74 68 61 74 20 75 73 65 73 20 query that uses
53b0: 61 20 76 69 72 74 75 61 6c 0d 0a 20 20 20 20 2f a virtual.. /
53c0: 2f 2f 20 74 61 62 6c 65 2e 0d 0a 20 20 20 20 2f // table... /
53d0: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
53e0: 20 20 20 70 75 62 6c 69 63 20 65 6e 75 6d 20 53 public enum S
53f0: 51 4c 69 74 65 49 6e 64 65 78 43 6f 6e 73 74 72 QLiteIndexConstr
5400: 61 69 6e 74 4f 70 20 3a 20 62 79 74 65 0d 0a 20 aintOp : byte..
5410: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 2f 2f {.. //
5420: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
5430: 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 76 61 /// This va
5440: 6c 75 65 20 72 65 70 72 65 73 65 6e 74 73 20 74 lue represents t
5450: 68 65 20 65 71 75 61 6c 69 74 79 20 6f 70 65 72 he equality oper
5460: 61 74 6f 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f ator... /
5470: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
5480: 20 20 20 20 20 20 20 45 71 75 61 6c 54 6f 20 3d EqualTo =
5490: 20 32 2c 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2,.... /
54a0: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
54b0: 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 76 /// This v
54c0: 61 6c 75 65 20 72 65 70 72 65 73 65 6e 74 73 20 alue represents
54d0: 74 68 65 20 67 72 65 61 74 65 72 20 74 68 61 6e the greater than
54e0: 20 6f 70 65 72 61 74 6f 72 2e 0d 0a 20 20 20 20 operator...
54f0: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
5500: 79 3e 0d 0a 20 20 20 20 20 20 20 20 47 72 65 61 y>.. Grea
5510: 74 65 72 54 68 61 6e 20 3d 20 34 2c 0d 0a 0d 0a terThan = 4,....
5520: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
5530: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
5540: 2f 2f 20 54 68 69 73 20 76 61 6c 75 65 20 72 65 // This value re
5550: 70 72 65 73 65 6e 74 73 20 74 68 65 20 6c 65 73 presents the les
5560: 73 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 s than or equal
5570: 74 6f 20 6f 70 65 72 61 74 6f 72 2e 0d 0a 20 20 to operator...
5580: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d /// </summ
5590: 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 4c 65 ary>.. Le
55a0: 73 73 54 68 61 6e 4f 72 45 71 75 61 6c 54 6f 20 ssThanOrEqualTo
55b0: 3d 20 38 2c 0d 0a 0d 0a 20 20 20 20 20 20 20 20 = 8,....
55c0: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
55d0: 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 /// This
55e0: 76 61 6c 75 65 20 72 65 70 72 65 73 65 6e 74 73 value represents
55f0: 20 74 68 65 20 6c 65 73 73 20 74 68 61 6e 20 6f the less than o
5600: 70 65 72 61 74 6f 72 2e 0d 0a 20 20 20 20 20 20 perator...
5610: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
5620: 0d 0a 20 20 20 20 20 20 20 20 4c 65 73 73 54 68 .. LessTh
5630: 61 6e 20 3d 20 31 36 2c 0d 0a 0d 0a 20 20 20 20 an = 16,....
5640: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
5650: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
5660: 68 69 73 20 76 61 6c 75 65 20 72 65 70 72 65 73 his value repres
5670: 65 6e 74 73 20 74 68 65 20 67 72 65 61 74 65 72 ents the greater
5680: 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 than or equal t
5690: 6f 20 6f 70 65 72 61 74 6f 72 2e 0d 0a 20 20 20 o operator...
56a0: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
56b0: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 47 72 65 ry>.. Gre
56c0: 61 74 65 72 54 68 61 6e 4f 72 45 71 75 61 6c 54 aterThanOrEqualT
56d0: 6f 20 3d 20 33 32 2c 0d 0a 0d 0a 20 20 20 20 20 o = 32,....
56e0: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
56f0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
5700: 69 73 20 76 61 6c 75 65 20 72 65 70 72 65 73 65 is value represe
5710: 6e 74 73 20 74 68 65 20 4d 41 54 43 48 20 6f 70 nts the MATCH op
5720: 65 72 61 74 6f 72 2e 0d 0a 20 20 20 20 20 20 20 erator...
5730: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
5740: 0a 20 20 20 20 20 20 20 20 4d 61 74 63 68 20 3d . Match =
5750: 20 36 34 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 64.. }..
5760: 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 #endregion....
5770: 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////////
5780: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
5790: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
57a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
57b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d /////////////...
57c0: 0a 20 20 20 20 23 72 65 67 69 6f 6e 20 53 51 4c . #region SQL
57d0: 69 74 65 49 6e 64 65 78 43 6f 6e 73 74 72 61 69 iteIndexConstrai
57e0: 6e 74 20 48 65 6c 70 65 72 20 43 6c 61 73 73 0d nt Helper Class.
57f0: 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 . /// <summar
5800: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 69 73 y>.. /// This
5810: 20 63 6c 61 73 73 20 72 65 70 72 65 73 65 6e 74 class represent
5820: 73 20 74 68 65 20 6e 61 74 69 76 65 20 73 71 6c s the native sql
5830: 69 74 65 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 74 ite3_index_const
5840: 72 61 69 6e 74 20 73 74 72 75 63 74 75 72 65 0d raint structure.
5850: 0a 20 20 20 20 2f 2f 2f 20 66 72 6f 6d 20 74 68 . /// from th
5860: 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6c 69 e SQLite core li
5870: 62 72 61 72 79 2e 0d 0a 20 20 20 20 2f 2f 2f 20 brary... ///
5880: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
5890: 70 75 62 6c 69 63 20 73 65 61 6c 65 64 20 63 6c public sealed cl
58a0: 61 73 73 20 53 51 4c 69 74 65 49 6e 64 65 78 43 ass SQLiteIndexC
58b0: 6f 6e 73 74 72 61 69 6e 74 0d 0a 20 20 20 20 7b onstraint.. {
58c0: 0d 0a 20 20 20 20 20 20 20 20 23 72 65 67 69 6f .. #regio
58d0: 6e 20 49 6e 74 65 72 6e 61 6c 20 43 6f 6e 73 74 n Internal Const
58e0: 72 75 63 74 6f 72 73 0d 0a 20 20 20 20 20 20 20 ructors..
58f0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
5900: 20 20 20 20 20 20 20 20 2f 2f 2f 20 43 6f 6e 73 /// Cons
5910: 74 72 75 63 74 73 20 61 6e 20 69 6e 73 74 61 6e tructs an instan
5920: 63 65 20 6f 66 20 74 68 69 73 20 63 6c 61 73 73 ce of this class
5930: 20 75 73 69 6e 67 20 74 68 65 20 73 70 65 63 69 using the speci
5940: 66 69 65 64 20 6e 61 74 69 76 65 0d 0a 20 20 20 fied native..
5950: 20 20 20 20 20 2f 2f 2f 20 73 71 6c 69 74 65 33 /// sqlite3
5960: 5f 69 6e 64 65 78 5f 63 6f 6e 73 74 72 61 69 6e _index_constrain
5970: 74 20 73 74 72 75 63 74 75 72 65 2e 0d 0a 20 20 t structure...
5980: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d /// </summ
5990: 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
59a0: 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 63 / <param name="c
59b0: 6f 6e 73 74 72 61 69 6e 74 22 3e 0d 0a 20 20 20 onstraint">..
59c0: 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 /// The nat
59d0: 69 76 65 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 ive sqlite3_inde
59e0: 78 5f 63 6f 6e 73 74 72 61 69 6e 74 20 73 74 72 x_constraint str
59f0: 75 63 74 75 72 65 20 74 6f 20 75 73 65 2e 0d 0a ucture to use...
5a00: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
5a10: 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 69 6e ram>.. in
5a20: 74 65 72 6e 61 6c 20 53 51 4c 69 74 65 49 6e 64 ternal SQLiteInd
5a30: 65 78 43 6f 6e 73 74 72 61 69 6e 74 28 0d 0a 20 exConstraint(..
5a40: 20 20 20 20 20 20 20 20 20 20 20 55 6e 73 61 66 Unsaf
5a50: 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 eNativeMethods.s
5a60: 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 63 6f 6e qlite3_index_con
5a70: 73 74 72 61 69 6e 74 20 63 6f 6e 73 74 72 61 69 straint constrai
5a80: 6e 74 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 nt..
5a90: 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 3a ).. :
5aa0: 20 74 68 69 73 28 63 6f 6e 73 74 72 61 69 6e 74 this(constraint
5ab0: 2e 69 43 6f 6c 75 6d 6e 2c 20 63 6f 6e 73 74 72 .iColumn, constr
5ac0: 61 69 6e 74 2e 6f 70 2c 20 63 6f 6e 73 74 72 61 aint.op, constra
5ad0: 69 6e 74 2e 75 73 61 62 6c 65 2c 0d 0a 20 20 20 int.usable,..
5ae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5af0: 63 6f 6e 73 74 72 61 69 6e 74 2e 69 54 65 72 6d constraint.iTerm
5b00: 4f 66 66 73 65 74 29 0d 0a 20 20 20 20 20 20 20 Offset)..
5b10: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 {..
5b20: 2f 2f 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0d 0a // do nothing...
5b30: 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 }..
5b40: 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d #endregion...
5b50: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
5b60: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
5b70: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
5b80: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
5b90: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
5ba0: 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 67 69 ... #regi
5bb0: 6f 6e 20 50 72 69 76 61 74 65 20 43 6f 6e 73 74 on Private Const
5bc0: 72 75 63 74 6f 72 73 0d 0a 20 20 20 20 20 20 20 ructors..
5bd0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
5be0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 43 6f 6e 73 /// Cons
5bf0: 74 72 75 63 74 73 20 61 6e 20 69 6e 73 74 61 6e tructs an instan
5c00: 63 65 20 6f 66 20 74 68 69 73 20 63 6c 61 73 73 ce of this class
5c10: 20 75 73 69 6e 67 20 74 68 65 20 73 70 65 63 69 using the speci
5c20: 66 69 65 64 20 66 69 65 6c 64 0d 0a 20 20 20 20 fied field..
5c30: 20 20 20 20 2f 2f 2f 20 76 61 6c 75 65 73 2e 0d /// values..
5c40: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
5c50: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
5c60: 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
5c70: 3d 22 69 43 6f 6c 75 6d 6e 22 3e 0d 0a 20 20 20 ="iColumn">..
5c80: 20 20 20 20 20 2f 2f 2f 20 43 6f 6c 75 6d 6e 20 /// Column
5c90: 6f 6e 20 6c 65 66 74 2d 68 61 6e 64 20 73 69 64 on left-hand sid
5ca0: 65 20 6f 66 20 63 6f 6e 73 74 72 61 69 6e 74 2e e of constraint.
5cb0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
5cc0: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
5cd0: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
5ce0: 22 6f 70 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f "op">.. /
5cf0: 2f 2f 20 43 6f 6e 73 74 72 61 69 6e 74 20 6f 70 // Constraint op
5d00: 65 72 61 74 6f 72 20 28 3c 73 65 65 20 63 72 65 erator (<see cre
5d10: 66 3d 22 53 51 4c 69 74 65 49 6e 64 65 78 43 6f f="SQLiteIndexCo
5d20: 6e 73 74 72 61 69 6e 74 4f 70 22 20 2f 3e 29 2e nstraintOp" />).
5d30: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
5d40: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
5d50: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
5d60: 22 75 73 61 62 6c 65 22 3e 0d 0a 20 20 20 20 20 "usable">..
5d70: 20 20 20 2f 2f 2f 20 54 72 75 65 20 69 66 20 74 /// True if t
5d80: 68 69 73 20 63 6f 6e 73 74 72 61 69 6e 74 20 69 his constraint i
5d90: 73 20 75 73 61 62 6c 65 2e 0d 0a 20 20 20 20 20 s usable...
5da0: 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
5db0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
5dc0: 72 61 6d 20 6e 61 6d 65 3d 22 69 54 65 72 6d 4f ram name="iTermO
5dd0: 66 66 73 65 74 22 3e 0d 0a 20 20 20 20 20 20 20 ffset">..
5de0: 20 2f 2f 2f 20 55 73 65 64 20 69 6e 74 65 72 6e /// Used intern
5df0: 61 6c 6c 79 20 2d 20 3c 73 65 65 20 63 72 65 66 ally - <see cref
5e00: 3d 22 49 53 51 4c 69 74 65 4d 61 6e 61 67 65 64 ="ISQLiteManaged
5e10: 4d 6f 64 75 6c 65 2e 42 65 73 74 49 6e 64 65 78 Module.BestIndex
5e20: 22 20 2f 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f " />.. //
5e30: 2f 20 73 68 6f 75 6c 64 20 69 67 6e 6f 72 65 2e / should ignore.
5e40: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
5e50: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
5e60: 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 49 6e private SQLiteIn
5e70: 64 65 78 43 6f 6e 73 74 72 61 69 6e 74 28 0d 0a dexConstraint(..
5e80: 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 int
5e90: 69 43 6f 6c 75 6d 6e 2c 0d 0a 20 20 20 20 20 20 iColumn,..
5ea0: 20 20 20 20 20 20 53 51 4c 69 74 65 49 6e 64 65 SQLiteInde
5eb0: 78 43 6f 6e 73 74 72 61 69 6e 74 4f 70 20 6f 70 xConstraintOp op
5ec0: 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 ,.. b
5ed0: 79 74 65 20 75 73 61 62 6c 65 2c 0d 0a 20 20 20 yte usable,..
5ee0: 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 54 65 int iTe
5ef0: 72 6d 4f 66 66 73 65 74 0d 0a 20 20 20 20 20 20 rmOffset..
5f00: 20 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 )..
5f10: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 {..
5f20: 74 68 69 73 2e 69 43 6f 6c 75 6d 6e 20 3d 20 69 this.iColumn = i
5f30: 43 6f 6c 75 6d 6e 3b 0d 0a 20 20 20 20 20 20 20 Column;..
5f40: 20 20 20 20 20 74 68 69 73 2e 6f 70 20 3d 20 6f this.op = o
5f50: 70 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 p;..
5f60: 74 68 69 73 2e 75 73 61 62 6c 65 20 3d 20 75 73 this.usable = us
5f70: 61 62 6c 65 3b 0d 0a 20 20 20 20 20 20 20 20 20 able;..
5f80: 20 20 20 74 68 69 73 2e 69 54 65 72 6d 4f 66 66 this.iTermOff
5f90: 73 65 74 20 3d 20 69 54 65 72 6d 4f 66 66 73 65 set = iTermOffse
5fa0: 74 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 t;.. }..
5fb0: 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f #endregio
5fc0: 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f n.... ///
5fd0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
5fe0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
5ff0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6000: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6010: 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 ///.... #
6020: 72 65 67 69 6f 6e 20 50 75 62 6c 69 63 20 46 69 region Public Fi
6030: 65 6c 64 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f elds.. //
6040: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
6050: 20 20 20 20 20 2f 2f 2f 20 43 6f 6c 75 6d 6e 20 /// Column
6060: 6f 6e 20 6c 65 66 74 2d 68 61 6e 64 20 73 69 64 on left-hand sid
6070: 65 20 6f 66 20 63 6f 6e 73 74 72 61 69 6e 74 2e e of constraint.
6080: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
6090: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
60a0: 20 20 70 75 62 6c 69 63 20 69 6e 74 20 69 43 6f public int iCo
60b0: 6c 75 6d 6e 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 lumn;....
60c0: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
60d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
60e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
60f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6100: 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
6110: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
6120: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 43 6f .. /// Co
6130: 6e 73 74 72 61 69 6e 74 20 6f 70 65 72 61 74 6f nstraint operato
6140: 72 20 28 3c 73 65 65 20 63 72 65 66 3d 22 53 51 r (<see cref="SQ
6150: 4c 69 74 65 49 6e 64 65 78 43 6f 6e 73 74 72 61 LiteIndexConstra
6160: 69 6e 74 4f 70 22 20 2f 3e 29 2e 0d 0a 20 20 20 intOp" />)...
6170: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
6180: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 ry>.. pub
6190: 6c 69 63 20 53 51 4c 69 74 65 49 6e 64 65 78 43 lic SQLiteIndexC
61a0: 6f 6e 73 74 72 61 69 6e 74 4f 70 20 6f 70 3b 0d onstraintOp op;.
61b0: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
61c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
61d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
61e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
61f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6200: 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f /.... ///
6210: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
6220: 20 20 20 20 2f 2f 2f 20 54 72 75 65 20 69 66 20 /// True if
6230: 74 68 69 73 20 63 6f 6e 73 74 72 61 69 6e 74 20 this constraint
6240: 69 73 20 75 73 61 62 6c 65 2e 0d 0a 20 20 20 20 is usable...
6250: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
6260: 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c y>.. publ
6270: 69 63 20 62 79 74 65 20 75 73 61 62 6c 65 3b 0d ic byte usable;.
6280: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
6290: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
62a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
62b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
62c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
62d0: 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f /.... ///
62e0: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
62f0: 20 20 20 20 2f 2f 2f 20 55 73 65 64 20 69 6e 74 /// Used int
6300: 65 72 6e 61 6c 6c 79 20 2d 20 3c 73 65 65 20 63 ernally - <see c
6310: 72 65 66 3d 22 49 53 51 4c 69 74 65 4d 61 6e 61 ref="ISQLiteMana
6320: 67 65 64 4d 6f 64 75 6c 65 2e 42 65 73 74 49 6e gedModule.BestIn
6330: 64 65 78 22 20 2f 3e 0d 0a 20 20 20 20 20 20 20 dex" />..
6340: 20 2f 2f 2f 20 73 68 6f 75 6c 64 20 69 67 6e 6f /// should igno
6350: 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f re... ///
6360: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
6370: 20 20 20 20 20 70 75 62 6c 69 63 20 69 6e 74 20 public int
6380: 69 54 65 72 6d 4f 66 66 73 65 74 3b 0d 0a 20 20 iTermOffset;..
6390: 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e #endregion
63a0: 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 65 6e .. }.. #en
63b0: 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 2f dregion.... /
63c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
63d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
63e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
63f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6400: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
6410: 20 20 23 72 65 67 69 6f 6e 20 53 51 4c 69 74 65 #region SQLite
6420: 49 6e 64 65 78 4f 72 64 65 72 42 79 20 48 65 6c IndexOrderBy Hel
6430: 70 65 72 20 43 6c 61 73 73 0d 0a 20 20 20 20 2f per Class.. /
6440: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
6450: 20 20 2f 2f 2f 20 54 68 69 73 20 63 6c 61 73 73 /// This class
6460: 20 72 65 70 72 65 73 65 6e 74 73 20 74 68 65 20 represents the
6470: 6e 61 74 69 76 65 20 73 71 6c 69 74 65 33 5f 69 native sqlite3_i
6480: 6e 64 65 78 5f 6f 72 64 65 72 62 79 20 73 74 72 ndex_orderby str
6490: 75 63 74 75 72 65 20 66 72 6f 6d 0d 0a 20 20 20 ucture from..
64a0: 20 2f 2f 2f 20 74 68 65 20 53 51 4c 69 74 65 20 /// the SQLite
64b0: 63 6f 72 65 20 6c 69 62 72 61 72 79 2e 0d 0a 20 core library...
64c0: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
64d0: 3e 0d 0a 20 20 20 20 70 75 62 6c 69 63 20 73 65 >.. public se
64e0: 61 6c 65 64 20 63 6c 61 73 73 20 53 51 4c 69 74 aled class SQLit
64f0: 65 49 6e 64 65 78 4f 72 64 65 72 42 79 0d 0a 20 eIndexOrderBy..
6500: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 23 72 {.. #r
6510: 65 67 69 6f 6e 20 49 6e 74 65 72 6e 61 6c 20 43 egion Internal C
6520: 6f 6e 73 74 72 75 63 74 6f 72 73 0d 0a 20 20 20 onstructors..
6530: 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
6540: 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
6550: 43 6f 6e 73 74 72 75 63 74 73 20 61 6e 20 69 6e Constructs an in
6560: 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 63 stance of this c
6570: 6c 61 73 73 20 75 73 69 6e 67 20 74 68 65 20 73 lass using the s
6580: 70 65 63 69 66 69 65 64 20 6e 61 74 69 76 65 0d pecified native.
6590: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 6c . /// sql
65a0: 69 74 65 33 5f 69 6e 64 65 78 5f 6f 72 64 65 72 ite3_index_order
65b0: 62 79 20 73 74 72 75 63 74 75 72 65 2e 0d 0a 20 by structure...
65c0: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
65d0: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
65e0: 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
65f0: 6f 72 64 65 72 42 79 22 3e 0d 0a 20 20 20 20 20 orderBy">..
6600: 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 /// The nativ
6610: 65 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f e sqlite3_index_
6620: 6f 72 64 65 72 62 79 20 73 74 72 75 63 74 75 72 orderby structur
6630: 65 20 74 6f 20 75 73 65 2e 0d 0a 20 20 20 20 20 e to use...
6640: 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
6650: 0a 20 20 20 20 20 20 20 20 69 6e 74 65 72 6e 61 . interna
6660: 6c 20 53 51 4c 69 74 65 49 6e 64 65 78 4f 72 64 l SQLiteIndexOrd
6670: 65 72 42 79 28 0d 0a 20 20 20 20 20 20 20 20 20 erBy(..
6680: 20 20 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d UnsafeNativeM
6690: 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 69 ethods.sqlite3_i
66a0: 6e 64 65 78 5f 6f 72 64 65 72 62 79 20 6f 72 64 ndex_orderby ord
66b0: 65 72 42 79 0d 0a 20 20 20 20 20 20 20 20 20 20 erBy..
66c0: 20 20 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 )..
66d0: 20 3a 20 74 68 69 73 28 6f 72 64 65 72 42 79 2e : this(orderBy.
66e0: 69 43 6f 6c 75 6d 6e 2c 20 6f 72 64 65 72 42 79 iColumn, orderBy
66f0: 2e 64 65 73 63 29 0d 0a 20 20 20 20 20 20 20 20 .desc)..
6700: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f {.. /
6710: 2f 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0d 0a 20 / do nothing...
6720: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 }..
6730: 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a #endregion....
6740: 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f ////////
6750: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6760: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6770: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6780: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a //////////////..
6790: 0d 0a 20 20 20 20 20 20 20 20 23 72 65 67 69 6f .. #regio
67a0: 6e 20 50 72 69 76 61 74 65 20 43 6f 6e 73 74 72 n Private Constr
67b0: 75 63 74 6f 72 73 0d 0a 20 20 20 20 20 20 20 20 uctors..
67c0: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
67d0: 20 20 20 20 20 20 20 2f 2f 2f 20 43 6f 6e 73 74 /// Const
67e0: 72 75 63 74 73 20 61 6e 20 69 6e 73 74 61 6e 63 ructs an instanc
67f0: 65 20 6f 66 20 74 68 69 73 20 63 6c 61 73 73 20 e of this class
6800: 75 73 69 6e 67 20 74 68 65 20 73 70 65 63 69 66 using the specif
6810: 69 65 64 20 66 69 65 6c 64 0d 0a 20 20 20 20 20 ied field..
6820: 20 20 20 2f 2f 2f 20 76 61 6c 75 65 73 2e 0d 0a /// values...
6830: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
6840: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
6850: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
6860: 22 69 43 6f 6c 75 6d 6e 22 3e 0d 0a 20 20 20 20 "iColumn">..
6870: 20 20 20 20 2f 2f 2f 20 43 6f 6c 75 6d 6e 20 6e /// Column n
6880: 75 6d 62 65 72 2e 0d 0a 20 20 20 20 20 20 20 20 umber...
6890: 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
68a0: 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
68b0: 20 6e 61 6d 65 3d 22 64 65 73 63 22 3e 0d 0a 20 name="desc">..
68c0: 20 20 20 20 20 20 20 2f 2f 2f 20 54 72 75 65 20 /// True
68d0: 66 6f 72 20 44 45 53 43 2e 20 20 46 61 6c 73 65 for DESC. False
68e0: 20 66 6f 72 20 41 53 43 2e 0d 0a 20 20 20 20 20 for ASC...
68f0: 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
6900: 0a 20 20 20 20 20 20 20 20 70 72 69 76 61 74 65 . private
6910: 20 53 51 4c 69 74 65 49 6e 64 65 78 4f 72 64 65 SQLiteIndexOrde
6920: 72 42 79 28 0d 0a 20 20 20 20 20 20 20 20 20 20 rBy(..
6930: 20 20 69 6e 74 20 69 43 6f 6c 75 6d 6e 2c 0d 0a int iColumn,..
6940: 20 20 20 20 20 20 20 20 20 20 20 20 62 79 74 65 byte
6950: 20 64 65 73 63 0d 0a 20 20 20 20 20 20 20 20 20 desc..
6960: 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d ).. {.
6970: 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 68 69 . thi
6980: 73 2e 69 43 6f 6c 75 6d 6e 20 3d 20 69 43 6f 6c s.iColumn = iCol
6990: 75 6d 6e 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 umn;..
69a0: 20 20 74 68 69 73 2e 64 65 73 63 20 3d 20 64 65 this.desc = de
69b0: 73 63 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a sc;.. }..
69c0: 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 #endregi
69d0: 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f on.... //
69e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
69f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6a00: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6a10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6a20: 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ////....
6a30: 23 72 65 67 69 6f 6e 20 50 75 62 6c 69 63 20 46 #region Public F
6a40: 69 65 6c 64 73 0d 0a 20 20 20 20 20 20 20 20 2f ields.. /
6a50: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
6a60: 20 20 20 20 20 20 2f 2f 2f 20 43 6f 6c 75 6d 6e /// Column
6a70: 20 6e 75 6d 62 65 72 2e 0d 0a 20 20 20 20 20 20 number...
6a80: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
6a90: 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 .. public
6aa0: 20 69 6e 74 20 69 43 6f 6c 75 6d 6e 3b 0d 0a 0d int iColumn;...
6ab0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
6ac0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6ad0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6ae0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6af0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
6b00: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
6b10: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
6b20: 20 20 2f 2f 2f 20 54 72 75 65 20 66 6f 72 20 44 /// True for D
6b30: 45 53 43 2e 20 20 46 61 6c 73 65 20 66 6f 72 20 ESC. False for
6b40: 41 53 43 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ASC... //
6b50: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 / </summary>..
6b60: 20 20 20 20 20 20 70 75 62 6c 69 63 20 62 79 74 public byt
6b70: 65 20 64 65 73 63 3b 0d 0a 20 20 20 20 20 20 20 e desc;..
6b80: 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 20 20 20 #endregion..
6b90: 20 7d 0d 0a 20 20 20 20 23 65 6e 64 72 65 67 69 }.. #endregi
6ba0: 6f 6e 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f on.... //////
6bb0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6bc0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6bd0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6be0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6bf0: 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 23 72 65 /////.... #re
6c00: 67 69 6f 6e 20 53 51 4c 69 74 65 49 6e 64 65 78 gion SQLiteIndex
6c10: 43 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 65 20 ConstraintUsage
6c20: 48 65 6c 70 65 72 20 43 6c 61 73 73 0d 0a 20 20 Helper Class..
6c30: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d /// <summary>.
6c40: 0a 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 63 6c . /// This cl
6c50: 61 73 73 20 72 65 70 72 65 73 65 6e 74 73 20 74 ass represents t
6c60: 68 65 20 6e 61 74 69 76 65 20 73 71 6c 69 74 65 he native sqlite
6c70: 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 74 72 61 69 3_index_constrai
6c80: 6e 74 5f 75 73 61 67 65 0d 0a 20 20 20 20 2f 2f nt_usage.. //
6c90: 2f 20 73 74 72 75 63 74 75 72 65 20 66 72 6f 6d / structure from
6ca0: 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 the SQLite core
6cb0: 20 6c 69 62 72 61 72 79 2e 0d 0a 20 20 20 20 2f library... /
6cc0: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
6cd0: 20 20 20 70 75 62 6c 69 63 20 73 65 61 6c 65 64 public sealed
6ce0: 20 63 6c 61 73 73 20 53 51 4c 69 74 65 49 6e 64 class SQLiteInd
6cf0: 65 78 43 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 exConstraintUsag
6d00: 65 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 e.. {..
6d10: 20 20 23 72 65 67 69 6f 6e 20 49 6e 74 65 72 6e #region Intern
6d20: 61 6c 20 43 6f 6e 73 74 72 75 63 74 6f 72 73 0d al Constructors.
6d30: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 . /// <su
6d40: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
6d50: 2f 2f 2f 20 43 6f 6e 73 74 72 75 63 74 73 20 61 /// Constructs a
6d60: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
6d70: 69 73 20 63 6c 61 73 73 20 75 73 69 6e 67 20 74 is class using t
6d80: 68 65 20 73 70 65 63 69 66 69 65 64 20 6e 61 74 he specified nat
6d90: 69 76 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ive.. ///
6da0: 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 63 sqlite3_index_c
6db0: 6f 6e 73 74 72 61 69 6e 74 5f 75 73 61 67 65 20 onstraint_usage
6dc0: 73 74 72 75 63 74 75 72 65 2e 0d 0a 20 20 20 20 structure...
6dd0: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
6de0: 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
6df0: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 63 6f 6e <param name="con
6e00: 73 74 72 61 69 6e 74 55 73 61 67 65 22 3e 0d 0a straintUsage">..
6e10: 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
6e20: 6e 61 74 69 76 65 20 73 71 6c 69 74 65 33 5f 69 native sqlite3_i
6e30: 6e 64 65 78 5f 63 6f 6e 73 74 72 61 69 6e 74 5f ndex_constraint_
6e40: 75 73 61 67 65 20 73 74 72 75 63 74 75 72 65 20 usage structure
6e50: 74 6f 20 75 73 65 2e 0d 0a 20 20 20 20 20 20 20 to use...
6e60: 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
6e70: 20 20 20 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 internal
6e80: 53 51 4c 69 74 65 49 6e 64 65 78 43 6f 6e 73 74 SQLiteIndexConst
6e90: 72 61 69 6e 74 55 73 61 67 65 28 0d 0a 20 20 20 raintUsage(..
6ea0: 20 20 20 20 20 20 20 20 20 55 6e 73 61 66 65 4e UnsafeN
6eb0: 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c ativeMethods.sql
6ec0: 69 74 65 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 74 ite3_index_const
6ed0: 72 61 69 6e 74 5f 75 73 61 67 65 20 63 6f 6e 73 raint_usage cons
6ee0: 74 72 61 69 6e 74 55 73 61 67 65 0d 0a 20 20 20 traintUsage..
6ef0: 20 20 20 20 20 20 20 20 20 29 0d 0a 20 20 20 20 )..
6f00: 20 20 20 20 20 20 20 20 3a 20 74 68 69 73 28 63 : this(c
6f10: 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 65 2e 61 onstraintUsage.a
6f20: 72 67 76 49 6e 64 65 78 2c 20 63 6f 6e 73 74 72 rgvIndex, constr
6f30: 61 69 6e 74 55 73 61 67 65 2e 6f 6d 69 74 29 0d aintUsage.omit).
6f40: 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 . {..
6f50: 20 20 20 20 20 20 20 20 2f 2f 20 64 6f 20 6e 6f // do no
6f60: 74 68 69 6e 67 2e 0d 0a 20 20 20 20 20 20 20 20 thing...
6f70: 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 72 }.. #endr
6f80: 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 egion....
6f90: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
6fa0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6fb0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6fc0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
6fd0: 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
6fe0: 20 20 20 23 72 65 67 69 6f 6e 20 50 72 69 76 61 #region Priva
6ff0: 74 65 20 43 6f 6e 73 74 72 75 63 74 6f 72 73 0d te Constructors.
7000: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 . /// <su
7010: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
7020: 2f 2f 2f 20 43 6f 6e 73 74 72 75 63 74 73 20 61 /// Constructs a
7030: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
7040: 69 73 20 63 6c 61 73 73 20 75 73 69 6e 67 20 74 is class using t
7050: 68 65 20 73 70 65 63 69 66 69 65 64 20 66 69 65 he specified fie
7060: 6c 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ld.. ///
7070: 76 61 6c 75 65 73 2e 0d 0a 20 20 20 20 20 20 20 values...
7080: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
7090: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
70a0: 72 61 6d 20 6e 61 6d 65 3d 22 61 72 67 76 49 6e ram name="argvIn
70b0: 64 65 78 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f dex">.. /
70c0: 2f 2f 20 49 66 20 67 72 65 61 74 65 72 20 74 68 // If greater th
70d0: 61 6e 20 30 2c 20 63 6f 6e 73 74 72 61 69 6e 74 an 0, constraint
70e0: 20 69 73 20 70 61 72 74 20 6f 66 20 61 72 67 76 is part of argv
70f0: 20 74 6f 20 78 46 69 6c 74 65 72 2e 0d 0a 20 20 to xFilter...
7100: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
7110: 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
7120: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6f 6d 69 <param name="omi
7130: 74 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f t">.. ///
7140: 20 44 6f 20 6e 6f 74 20 63 6f 64 65 20 61 20 74 Do not code a t
7150: 65 73 74 20 66 6f 72 20 74 68 69 73 20 63 6f 6e est for this con
7160: 73 74 72 61 69 6e 74 2e 0d 0a 20 20 20 20 20 20 straint...
7170: 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
7180: 20 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 private
7190: 53 51 4c 69 74 65 49 6e 64 65 78 43 6f 6e 73 74 SQLiteIndexConst
71a0: 72 61 69 6e 74 55 73 61 67 65 28 0d 0a 20 20 20 raintUsage(..
71b0: 20 20 20 20 20 20 20 20 20 69 6e 74 20 61 72 67 int arg
71c0: 76 49 6e 64 65 78 2c 0d 0a 20 20 20 20 20 20 20 vIndex,..
71d0: 20 20 20 20 20 62 79 74 65 20 6f 6d 69 74 0d 0a byte omit..
71e0: 20 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 )..
71f0: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
7200: 20 20 20 20 20 20 74 68 69 73 2e 61 72 67 76 49 this.argvI
7210: 6e 64 65 78 20 3d 20 61 72 67 76 49 6e 64 65 78 ndex = argvIndex
7220: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 ;.. t
7230: 68 69 73 2e 6f 6d 69 74 20 3d 20 6f 6d 69 74 3b his.omit = omit;
7240: 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 .. }..
7250: 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d #endregion.
7260: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
7270: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7280: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7290: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
72a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
72b0: 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 //.... #r
72c0: 65 67 69 6f 6e 20 50 75 62 6c 69 63 20 46 69 65 egion Public Fie
72d0: 6c 64 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f lds.. ///
72e0: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
72f0: 20 20 20 20 2f 2f 2f 20 49 66 20 67 72 65 61 74 /// If great
7300: 65 72 20 74 68 61 6e 20 30 2c 20 63 6f 6e 73 74 er than 0, const
7310: 72 61 69 6e 74 20 69 73 20 70 61 72 74 20 6f 66 raint is part of
7320: 20 61 72 67 76 20 74 6f 20 78 46 69 6c 74 65 72 argv to xFilter
7330: 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
7340: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
7350: 20 20 20 70 75 62 6c 69 63 20 69 6e 74 20 61 72 public int ar
7360: 67 76 49 6e 64 65 78 3b 0d 0a 0d 0a 20 20 20 20 gvIndex;....
7370: 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
7380: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7390: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
73a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
73b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
73c0: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
73d0: 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
73e0: 2f 20 44 6f 20 6e 6f 74 20 63 6f 64 65 20 61 20 / Do not code a
73f0: 74 65 73 74 20 66 6f 72 20 74 68 69 73 20 63 6f test for this co
7400: 6e 73 74 72 61 69 6e 74 2e 0d 0a 20 20 20 20 20 nstraint...
7410: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
7420: 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 >.. publi
7430: 63 20 62 79 74 65 20 6f 6d 69 74 3b 0d 0a 20 20 c byte omit;..
7440: 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e #endregion
7450: 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 65 6e .. }.. #en
7460: 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 2f dregion.... /
7470: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7480: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7490: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
74a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
74b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
74c0: 20 20 23 72 65 67 69 6f 6e 20 53 51 4c 69 74 65 #region SQLite
74d0: 49 6e 64 65 78 49 6e 70 75 74 73 20 48 65 6c 70 IndexInputs Help
74e0: 65 72 20 43 6c 61 73 73 0d 0a 20 20 20 20 2f 2f er Class.. //
74f0: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
7500: 20 2f 2f 2f 20 54 68 69 73 20 63 6c 61 73 73 20 /// This class
7510: 72 65 70 72 65 73 65 6e 74 73 20 74 68 65 20 76 represents the v
7520: 61 72 69 6f 75 73 20 69 6e 70 75 74 73 20 70 72 arious inputs pr
7530: 6f 76 69 64 65 64 20 62 79 20 74 68 65 20 53 51 ovided by the SQ
7540: 4c 69 74 65 20 63 6f 72 65 0d 0a 20 20 20 20 2f Lite core.. /
7550: 2f 2f 20 6c 69 62 72 61 72 79 20 74 6f 20 74 68 // library to th
7560: 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 e <see cref="ISQ
7570: 4c 69 74 65 4d 61 6e 61 67 65 64 4d 6f 64 75 6c LiteManagedModul
7580: 65 2e 42 65 73 74 49 6e 64 65 78 22 20 2f 3e 20 e.BestIndex" />
7590: 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 2f 2f 2f method... ///
75a0: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
75b0: 20 70 75 62 6c 69 63 20 73 65 61 6c 65 64 20 63 public sealed c
75c0: 6c 61 73 73 20 53 51 4c 69 74 65 49 6e 64 65 78 lass SQLiteIndex
75d0: 49 6e 70 75 74 73 0d 0a 20 20 20 20 7b 0d 0a 20 Inputs.. {..
75e0: 20 20 20 20 20 20 20 23 72 65 67 69 6f 6e 20 49 #region I
75f0: 6e 74 65 72 6e 61 6c 20 43 6f 6e 73 74 72 75 63 nternal Construc
7600: 74 6f 72 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f tors.. //
7610: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
7620: 20 20 20 20 20 2f 2f 2f 20 43 6f 6e 73 74 72 75 /// Constru
7630: 63 74 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 cts an instance
7640: 6f 66 20 74 68 69 73 20 63 6c 61 73 73 2e 0d 0a of this class...
7650: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
7660: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
7670: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
7680: 22 6e 43 6f 6e 73 74 72 61 69 6e 74 22 3e 0d 0a "nConstraint">..
7690: 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
76a0: 6e 75 6d 62 65 72 20 6f 66 20 3c 73 65 65 20 63 number of <see c
76b0: 72 65 66 3d 22 53 51 4c 69 74 65 49 6e 64 65 78 ref="SQLiteIndex
76c0: 43 6f 6e 73 74 72 61 69 6e 74 22 20 2f 3e 20 69 Constraint" /> i
76d0: 6e 73 74 61 6e 63 65 73 20 74 6f 0d 0a 20 20 20 nstances to..
76e0: 20 20 20 20 20 2f 2f 2f 20 70 72 65 2d 61 6c 6c /// pre-all
76f0: 6f 63 61 74 65 20 73 70 61 63 65 20 66 6f 72 2e ocate space for.
7700: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
7710: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
7720: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
7730: 22 6e 4f 72 64 65 72 42 79 22 3e 0d 0a 20 20 20 "nOrderBy">..
7740: 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 75 6d /// The num
7750: 62 65 72 20 6f 66 20 3c 73 65 65 20 63 72 65 66 ber of <see cref
7760: 3d 22 53 51 4c 69 74 65 49 6e 64 65 78 4f 72 64 ="SQLiteIndexOrd
7770: 65 72 42 79 22 20 2f 3e 20 69 6e 73 74 61 6e 63 erBy" /> instanc
7780: 65 73 20 74 6f 0d 0a 20 20 20 20 20 20 20 20 2f es to.. /
7790: 2f 2f 20 70 72 65 2d 61 6c 6c 6f 63 61 74 65 20 // pre-allocate
77a0: 73 70 61 63 65 20 66 6f 72 2e 0d 0a 20 20 20 20 space for...
77b0: 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
77c0: 0d 0a 20 20 20 20 20 20 20 20 69 6e 74 65 72 6e .. intern
77d0: 61 6c 20 53 51 4c 69 74 65 49 6e 64 65 78 49 6e al SQLiteIndexIn
77e0: 70 75 74 73 28 69 6e 74 20 6e 43 6f 6e 73 74 72 puts(int nConstr
77f0: 61 69 6e 74 2c 20 69 6e 74 20 6e 4f 72 64 65 72 aint, int nOrder
7800: 42 79 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a By).. {..
7810: 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 cons
7820: 74 72 61 69 6e 74 73 20 3d 20 6e 65 77 20 53 51 traints = new SQ
7830: 4c 69 74 65 49 6e 64 65 78 43 6f 6e 73 74 72 61 LiteIndexConstra
7840: 69 6e 74 5b 6e 43 6f 6e 73 74 72 61 69 6e 74 5d int[nConstraint]
7850: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6f ;.. o
7860: 72 64 65 72 42 79 73 20 3d 20 6e 65 77 20 53 51 rderBys = new SQ
7870: 4c 69 74 65 49 6e 64 65 78 4f 72 64 65 72 42 79 LiteIndexOrderBy
7880: 5b 6e 4f 72 64 65 72 42 79 5d 3b 0d 0a 20 20 20 [nOrderBy];..
7890: 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 }..
78a0: 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 #endregion....
78b0: 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////
78c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
78d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
78e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
78f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d /////////////...
7900: 0a 20 20 20 20 20 20 20 20 23 72 65 67 69 6f 6e . #region
7910: 20 50 75 62 6c 69 63 20 50 72 6f 70 65 72 74 69 Public Properti
7920: 65 73 0d 0a 20 20 20 20 20 20 20 20 70 72 69 76 es.. priv
7930: 61 74 65 20 53 51 4c 69 74 65 49 6e 64 65 78 43 ate SQLiteIndexC
7940: 6f 6e 73 74 72 61 69 6e 74 5b 5d 20 63 6f 6e 73 onstraint[] cons
7950: 74 72 61 69 6e 74 73 3b 0d 0a 20 20 20 20 20 20 traints;..
7960: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d /// <summary>.
7970: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 6e 20 . /// An
7980: 61 72 72 61 79 20 6f 66 20 3c 73 65 65 20 63 72 array of <see cr
7990: 65 66 3d 22 53 51 4c 69 74 65 49 6e 64 65 78 43 ef="SQLiteIndexC
79a0: 6f 6e 73 74 72 61 69 6e 74 22 20 2f 3e 20 6f 62 onstraint" /> ob
79b0: 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 73 2c 0d ject instances,.
79c0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 65 61 63 . /// eac
79d0: 68 20 63 6f 6e 74 61 69 6e 69 6e 67 20 69 6e 66 h containing inf
79e0: 6f 72 6d 61 74 69 6f 6e 20 73 75 70 70 6c 69 65 ormation supplie
79f0: 64 20 62 79 20 74 68 65 20 53 51 4c 69 74 65 20 d by the SQLite
7a00: 63 6f 72 65 20 6c 69 62 72 61 72 79 2e 0d 0a 20 core library...
7a10: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
7a20: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 mary>.. p
7a30: 75 62 6c 69 63 20 53 51 4c 69 74 65 49 6e 64 65 ublic SQLiteInde
7a40: 78 43 6f 6e 73 74 72 61 69 6e 74 5b 5d 20 43 6f xConstraint[] Co
7a50: 6e 73 74 72 61 69 6e 74 73 0d 0a 20 20 20 20 20 nstraints..
7a60: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
7a70: 20 20 67 65 74 20 7b 20 72 65 74 75 72 6e 20 63 get { return c
7a80: 6f 6e 73 74 72 61 69 6e 74 73 3b 20 7d 0d 0a 20 onstraints; }..
7a90: 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 }....
7aa0: 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
7ab0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7ac0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7ad0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7ae0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
7af0: 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 53 private S
7b00: 51 4c 69 74 65 49 6e 64 65 78 4f 72 64 65 72 42 QLiteIndexOrderB
7b10: 79 5b 5d 20 6f 72 64 65 72 42 79 73 3b 0d 0a 20 y[] orderBys;..
7b20: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
7b30: 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
7b40: 2f 20 41 6e 20 61 72 72 61 79 20 6f 66 20 3c 73 / An array of <s
7b50: 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65 49 ee cref="SQLiteI
7b60: 6e 64 65 78 4f 72 64 65 72 42 79 22 20 2f 3e 20 ndexOrderBy" />
7b70: 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 73 object instances
7b80: 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 65 ,.. /// e
7b90: 61 63 68 20 63 6f 6e 74 61 69 6e 69 6e 67 20 69 ach containing i
7ba0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 73 75 70 70 6c nformation suppl
7bb0: 69 65 64 20 62 79 20 74 68 65 20 53 51 4c 69 74 ied by the SQLit
7bc0: 65 20 63 6f 72 65 20 6c 69 62 72 61 72 79 2e 0d e core library..
7bd0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
7be0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
7bf0: 20 70 75 62 6c 69 63 20 53 51 4c 69 74 65 49 6e public SQLiteIn
7c00: 64 65 78 4f 72 64 65 72 42 79 5b 5d 20 4f 72 64 dexOrderBy[] Ord
7c10: 65 72 42 79 73 0d 0a 20 20 20 20 20 20 20 20 7b erBys.. {
7c20: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 65 .. ge
7c30: 74 20 7b 20 72 65 74 75 72 6e 20 6f 72 64 65 72 t { return order
7c40: 42 79 73 3b 20 7d 0d 0a 20 20 20 20 20 20 20 20 Bys; }..
7c50: 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 72 }.. #endr
7c60: 65 67 69 6f 6e 0d 0a 20 20 20 20 7d 0d 0a 20 20 egion.. }..
7c70: 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a #endregion....
7c80: 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
7c90: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7ca0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7cb0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
7cc0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
7cd0: 0a 0d 0a 20 20 20 20 23 72 65 67 69 6f 6e 20 53 ... #region S
7ce0: 51 4c 69 74 65 49 6e 64 65 78 4f 75 74 70 75 74 QLiteIndexOutput
7cf0: 73 20 48 65 6c 70 65 72 20 43 6c 61 73 73 0d 0a s Helper Class..
7d00: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
7d10: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 >.. /// This
7d20: 63 6c 61 73 73 20 72 65 70 72 65 73 65 6e 74 73 class represents
7d30: 20 74 68 65 20 76 61 72 69 6f 75 73 20 6f 75 74 the various out
7d40: 70 75 74 73 20 70 72 6f 76 69 64 65 64 20 74 6f puts provided to
7d50: 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 the SQLite core
7d60: 0d 0a 20 20 20 20 2f 2f 2f 20 6c 69 62 72 61 72 .. /// librar
7d70: 79 20 62 79 20 74 68 65 20 3c 73 65 65 20 63 72 y by the <see cr
7d80: 65 66 3d 22 49 53 51 4c 69 74 65 4d 61 6e 61 67 ef="ISQLiteManag
7d90: 65 64 4d 6f 64 75 6c 65 2e 42 65 73 74 49 6e 64 edModule.BestInd
7da0: 65 78 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a ex" /> method...
7db0: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
7dc0: 79 3e 0d 0a 20 20 20 20 70 75 62 6c 69 63 20 73 y>.. public s
7dd0: 65 61 6c 65 64 20 63 6c 61 73 73 20 53 51 4c 69 ealed class SQLi
7de0: 74 65 49 6e 64 65 78 4f 75 74 70 75 74 73 0d 0a teIndexOutputs..
7df0: 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 23 {.. #
7e00: 72 65 67 69 6f 6e 20 49 6e 74 65 72 6e 61 6c 20 region Internal
7e10: 43 6f 6e 73 74 72 75 63 74 6f 72 73 0d 0a 20 20 Constructors..
7e20: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
7e30: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
7e40: 20 43 6f 6e 73 74 72 75 63 74 73 20 61 6e 20 69 Constructs an i
7e50: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 nstance of this
7e60: 63 6c 61 73 73 2e 0d 0a 20 20 20 20 20 20 20 20 class...
7e70: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a /// </summary>..
7e80: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
7e90: 61 6d 20 6e 61 6d 65 3d 22 6e 43 6f 6e 73 74 72 am name="nConstr
7ea0: 61 69 6e 74 22 3e 0d 0a 20 20 20 20 20 20 20 20 aint">..
7eb0: 2f 2f 2f 20 54 68 65 20 6e 75 6d 62 65 72 20 6f /// The number o
7ec0: 66 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c f <see cref="SQL
7ed0: 69 74 65 49 6e 64 65 78 43 6f 6e 73 74 72 61 69 iteIndexConstrai
7ee0: 6e 74 55 73 61 67 65 22 20 2f 3e 20 69 6e 73 74 ntUsage" /> inst
7ef0: 61 6e 63 65 73 0d 0a 20 20 20 20 20 20 20 20 2f ances.. /
7f00: 2f 2f 20 74 6f 20 70 72 65 2d 61 6c 6c 6f 63 61 // to pre-alloca
7f10: 74 65 20 73 70 61 63 65 20 66 6f 72 2e 0d 0a 20 te space for...
7f20: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
7f30: 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 69 6e 74 am>.. int
7f40: 65 72 6e 61 6c 20 53 51 4c 69 74 65 49 6e 64 65 ernal SQLiteInde
7f50: 78 4f 75 74 70 75 74 73 28 69 6e 74 20 6e 43 6f xOutputs(int nCo
7f60: 6e 73 74 72 61 69 6e 74 29 0d 0a 20 20 20 20 20 nstraint)..
7f70: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
7f80: 20 20 63 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 constraintUsag
7f90: 65 73 20 3d 20 6e 65 77 20 53 51 4c 69 74 65 49 es = new SQLiteI
7fa0: 6e 64 65 78 43 6f 6e 73 74 72 61 69 6e 74 55 73 ndexConstraintUs
7fb0: 61 67 65 5b 6e 43 6f 6e 73 74 72 61 69 6e 74 5d age[nConstraint]
7fc0: 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 ;.. }..
7fd0: 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e #endregion
7fe0: 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
7ff0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8000: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8010: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8020: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8030: 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 ///.... #
8040: 72 65 67 69 6f 6e 20 50 75 62 6c 69 63 20 50 72 region Public Pr
8050: 6f 70 65 72 74 69 65 73 0d 0a 20 20 20 20 20 20 operties..
8060: 20 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 private SQLite
8070: 49 6e 64 65 78 43 6f 6e 73 74 72 61 69 6e 74 55 IndexConstraintU
8080: 73 61 67 65 5b 5d 20 63 6f 6e 73 74 72 61 69 6e sage[] constrain
8090: 74 55 73 61 67 65 73 3b 0d 0a 20 20 20 20 20 20 tUsages;..
80a0: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d /// <summary>.
80b0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 6e 20 . /// An
80c0: 61 72 72 61 79 20 6f 66 20 3c 73 65 65 20 63 72 array of <see cr
80d0: 65 66 3d 22 53 51 4c 69 74 65 49 6e 64 65 78 43 ef="SQLiteIndexC
80e0: 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 65 22 20 onstraintUsage"
80f0: 2f 3e 20 6f 62 6a 65 63 74 0d 0a 20 20 20 20 20 /> object..
8100: 20 20 20 2f 2f 2f 20 69 6e 73 74 61 6e 63 65 73 /// instances
8110: 2c 20 65 61 63 68 20 63 6f 6e 74 61 69 6e 69 6e , each containin
8120: 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 6f g information to
8130: 20 62 65 20 73 75 70 70 6c 69 65 64 20 74 6f 20 be supplied to
8140: 74 68 65 20 53 51 4c 69 74 65 0d 0a 20 20 20 20 the SQLite..
8150: 20 20 20 20 2f 2f 2f 20 63 6f 72 65 20 6c 69 62 /// core lib
8160: 72 61 72 79 2e 0d 0a 20 20 20 20 20 20 20 20 2f rary... /
8170: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
8180: 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 53 51 public SQ
8190: 4c 69 74 65 49 6e 64 65 78 43 6f 6e 73 74 72 61 LiteIndexConstra
81a0: 69 6e 74 55 73 61 67 65 5b 5d 20 43 6f 6e 73 74 intUsage[] Const
81b0: 72 61 69 6e 74 55 73 61 67 65 73 0d 0a 20 20 20 raintUsages..
81c0: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
81d0: 20 20 20 20 67 65 74 20 7b 20 72 65 74 75 72 6e get { return
81e0: 20 63 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 65 constraintUsage
81f0: 73 3b 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d s; }.. }.
8200: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
8210: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8220: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8230: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8240: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8250: 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 70 72 //.... pr
8260: 69 76 61 74 65 20 69 6e 74 20 69 6e 64 65 78 4e ivate int indexN
8270: 75 6d 62 65 72 3b 0d 0a 20 20 20 20 20 20 20 20 umber;..
8280: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
8290: 20 20 20 20 20 20 20 2f 2f 2f 20 4e 75 6d 62 65 /// Numbe
82a0: 72 20 75 73 65 64 20 74 6f 20 68 65 6c 70 20 69 r used to help i
82b0: 64 65 6e 74 69 66 79 20 74 68 65 20 73 65 6c 65 dentify the sele
82c0: 63 74 65 64 20 69 6e 64 65 78 2e 20 20 54 68 69 cted index. Thi
82d0: 73 20 76 61 6c 75 65 20 77 69 6c 6c 0d 0a 20 20 s value will..
82e0: 20 20 20 20 20 20 2f 2f 2f 20 6c 61 74 65 72 20 /// later
82f0: 62 65 20 70 72 6f 76 69 64 65 64 20 74 6f 20 74 be provided to t
8300: 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 he <see cref="IS
8310: 51 4c 69 74 65 4d 61 6e 61 67 65 64 4d 6f 64 75 QLiteManagedModu
8320: 6c 65 2e 46 69 6c 74 65 72 22 20 2f 3e 0d 0a 20 le.Filter" />..
8330: 20 20 20 20 20 20 20 2f 2f 2f 20 6d 65 74 68 6f /// metho
8340: 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 d... ///
8350: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
8360: 20 20 20 20 70 75 62 6c 69 63 20 69 6e 74 20 49 public int I
8370: 6e 64 65 78 4e 75 6d 62 65 72 0d 0a 20 20 20 20 ndexNumber..
8380: 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 {..
8390: 20 20 20 67 65 74 20 7b 20 72 65 74 75 72 6e 20 get { return
83a0: 69 6e 64 65 78 4e 75 6d 62 65 72 3b 20 7d 0d 0a indexNumber; }..
83b0: 20 20 20 20 20 20 20 20 20 20 20 20 73 65 74 20 set
83c0: 7b 20 69 6e 64 65 78 4e 75 6d 62 65 72 20 3d 20 { indexNumber =
83d0: 76 61 6c 75 65 3b 20 7d 0d 0a 20 20 20 20 20 20 value; }..
83e0: 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f }.... /
83f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8400: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8410: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8420: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8430: 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
8440: 20 20 70 72 69 76 61 74 65 20 73 74 72 69 6e 67 private string
8450: 20 69 6e 64 65 78 53 74 72 69 6e 67 3b 0d 0a 20 indexString;..
8460: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
8470: 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
8480: 2f 20 53 74 72 69 6e 67 20 75 73 65 64 20 74 6f / String used to
8490: 20 68 65 6c 70 20 69 64 65 6e 74 69 66 79 20 74 help identify t
84a0: 68 65 20 73 65 6c 65 63 74 65 64 20 69 6e 64 65 he selected inde
84b0: 78 2e 20 20 54 68 69 73 20 76 61 6c 75 65 20 77 x. This value w
84c0: 69 6c 6c 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ill.. ///
84d0: 20 6c 61 74 65 72 20 62 65 20 70 72 6f 76 69 64 later be provid
84e0: 65 64 20 74 6f 20 74 68 65 20 3c 73 65 65 20 63 ed to the <see c
84f0: 72 65 66 3d 22 49 53 51 4c 69 74 65 4d 61 6e 61 ref="ISQLiteMana
8500: 67 65 64 4d 6f 64 75 6c 65 2e 46 69 6c 74 65 72 gedModule.Filter
8510: 22 20 2f 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f " />.. //
8520: 2f 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 / method...
8530: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
8540: 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 >.. publi
8550: 63 20 73 74 72 69 6e 67 20 49 6e 64 65 78 53 74 c string IndexSt
8560: 72 69 6e 67 0d 0a 20 20 20 20 20 20 20 20 7b 0d ring.. {.
8570: 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 65 74 . get
8580: 20 7b 20 72 65 74 75 72 6e 20 69 6e 64 65 78 53 { return indexS
8590: 74 72 69 6e 67 3b 20 7d 0d 0a 20 20 20 20 20 20 tring; }..
85a0: 20 20 20 20 20 20 73 65 74 20 7b 20 69 6e 64 65 set { inde
85b0: 78 53 74 72 69 6e 67 20 3d 20 76 61 6c 75 65 3b xString = value;
85c0: 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d }.. }...
85d0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
85e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
85f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8600: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8610: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8620: 0d 0a 0d 0a 20 20 20 20 20 20 20 20 70 72 69 76 .... priv
8630: 61 74 65 20 69 6e 74 20 6e 65 65 64 54 6f 46 72 ate int needToFr
8640: 65 65 49 6e 64 65 78 53 74 72 69 6e 67 3b 0d 0a eeIndexString;..
8650: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
8660: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
8670: 2f 2f 20 4e 6f 6e 2d 7a 65 72 6f 20 69 66 20 74 // Non-zero if t
8680: 68 65 20 69 6e 64 65 78 20 73 74 72 69 6e 67 20 he index string
8690: 6d 75 73 74 20 62 65 20 66 72 65 65 64 20 62 79 must be freed by
86a0: 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 the SQLite core
86b0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6c 69 .. /// li
86c0: 62 72 61 72 79 2e 0d 0a 20 20 20 20 20 20 20 20 brary...
86d0: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a /// </summary>..
86e0: 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 69 public i
86f0: 6e 74 20 4e 65 65 64 54 6f 46 72 65 65 49 6e 64 nt NeedToFreeInd
8700: 65 78 53 74 72 69 6e 67 0d 0a 20 20 20 20 20 20 exString..
8710: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
8720: 20 67 65 74 20 7b 20 72 65 74 75 72 6e 20 6e 65 get { return ne
8730: 65 64 54 6f 46 72 65 65 49 6e 64 65 78 53 74 72 edToFreeIndexStr
8740: 69 6e 67 3b 20 7d 0d 0a 20 20 20 20 20 20 20 20 ing; }..
8750: 20 20 20 20 73 65 74 20 7b 20 6e 65 65 64 54 6f set { needTo
8760: 46 72 65 65 49 6e 64 65 78 53 74 72 69 6e 67 20 FreeIndexString
8770: 3d 20 76 61 6c 75 65 3b 20 7d 0d 0a 20 20 20 20 = value; }..
8780: 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 }....
8790: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
87a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
87b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
87c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
87d0: 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 ////////....
87e0: 20 20 20 20 70 72 69 76 61 74 65 20 69 6e 74 20 private int
87f0: 6f 72 64 65 72 42 79 43 6f 6e 73 75 6d 65 64 3b orderByConsumed;
8800: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
8810: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
8820: 20 2f 2f 2f 20 54 72 75 65 20 69 66 20 6f 75 74 /// True if out
8830: 70 75 74 20 69 73 20 61 6c 72 65 61 64 79 20 6f put is already o
8840: 72 64 65 72 65 64 2e 0d 0a 20 20 20 20 20 20 20 rdered...
8850: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
8860: 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 . public
8870: 69 6e 74 20 4f 72 64 65 72 42 79 43 6f 6e 73 75 int OrderByConsu
8880: 6d 65 64 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a med.. {..
8890: 20 20 20 20 20 20 20 20 20 20 20 20 67 65 74 20 get
88a0: 7b 20 72 65 74 75 72 6e 20 6f 72 64 65 72 42 79 { return orderBy
88b0: 43 6f 6e 73 75 6d 65 64 3b 20 7d 0d 0a 20 20 20 Consumed; }..
88c0: 20 20 20 20 20 20 20 20 20 73 65 74 20 7b 20 6f set { o
88d0: 72 64 65 72 42 79 43 6f 6e 73 75 6d 65 64 20 3d rderByConsumed =
88e0: 20 76 61 6c 75 65 3b 20 7d 0d 0a 20 20 20 20 20 value; }..
88f0: 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 }....
8900: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8910: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8920: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8930: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8940: 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
8950: 20 20 20 70 72 69 76 61 74 65 20 64 6f 75 62 6c private doubl
8960: 65 20 65 73 74 69 6d 61 74 65 64 43 6f 73 74 3b e estimatedCost;
8970: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
8980: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
8990: 20 2f 2f 2f 20 45 73 74 69 6d 61 74 65 64 20 63 /// Estimated c
89a0: 6f 73 74 20 6f 66 20 75 73 69 6e 67 20 74 68 69 ost of using thi
89b0: 73 20 69 6e 64 65 78 2e 0d 0a 20 20 20 20 20 20 s index...
89c0: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
89d0: 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 .. public
89e0: 20 64 6f 75 62 6c 65 20 45 73 74 69 6d 61 74 65 double Estimate
89f0: 64 43 6f 73 74 0d 0a 20 20 20 20 20 20 20 20 7b dCost.. {
8a00: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 65 .. ge
8a10: 74 20 7b 20 72 65 74 75 72 6e 20 65 73 74 69 6d t { return estim
8a20: 61 74 65 64 43 6f 73 74 3b 20 7d 0d 0a 20 20 20 atedCost; }..
8a30: 20 20 20 20 20 20 20 20 20 73 65 74 20 7b 20 65 set { e
8a40: 73 74 69 6d 61 74 65 64 43 6f 73 74 20 3d 20 76 stimatedCost = v
8a50: 61 6c 75 65 3b 20 7d 0d 0a 20 20 20 20 20 20 20 alue; }..
8a60: 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 }.. #end
8a70: 72 65 67 69 6f 6e 0d 0a 20 20 20 20 7d 0d 0a 20 region.. }..
8a80: 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d #endregion...
8a90: 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f . ///////////
8aa0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8ab0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8ac0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8ad0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8ae0: 0d 0a 0d 0a 20 20 20 20 23 72 65 67 69 6f 6e 20 .... #region
8af0: 53 51 4c 69 74 65 49 6e 64 65 78 20 48 65 6c 70 SQLiteIndex Help
8b00: 65 72 20 43 6c 61 73 73 0d 0a 20 20 20 20 2f 2f er Class.. //
8b10: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
8b20: 20 2f 2f 2f 20 54 68 69 73 20 63 6c 61 73 73 20 /// This class
8b30: 72 65 70 72 65 73 65 6e 74 73 20 74 68 65 20 76 represents the v
8b40: 61 72 69 6f 75 73 20 69 6e 70 75 74 73 20 61 6e arious inputs an
8b50: 64 20 6f 75 74 70 75 74 73 20 75 73 65 64 20 77 d outputs used w
8b60: 69 74 68 20 74 68 65 0d 0a 20 20 20 20 2f 2f 2f ith the.. ///
8b70: 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
8b80: 69 74 65 4d 61 6e 61 67 65 64 4d 6f 64 75 6c 65 iteManagedModule
8b90: 2e 42 65 73 74 49 6e 64 65 78 22 20 2f 3e 20 6d .BestIndex" /> m
8ba0: 65 74 68 6f 64 2e 0d 0a 20 20 20 20 2f 2f 2f 20 ethod... ///
8bb0: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
8bc0: 70 75 62 6c 69 63 20 73 65 61 6c 65 64 20 63 6c public sealed cl
8bd0: 61 73 73 20 53 51 4c 69 74 65 49 6e 64 65 78 0d ass SQLiteIndex.
8be0: 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 . {..
8bf0: 23 72 65 67 69 6f 6e 20 49 6e 74 65 72 6e 61 6c #region Internal
8c00: 20 43 6f 6e 73 74 72 75 63 74 6f 72 73 0d 0a 20 Constructors..
8c10: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
8c20: 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
8c30: 2f 20 43 6f 6e 73 74 72 75 63 74 73 20 61 6e 20 / Constructs an
8c40: 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 instance of this
8c50: 20 63 6c 61 73 73 2e 0d 0a 20 20 20 20 20 20 20 class...
8c60: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
8c70: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
8c80: 72 61 6d 20 6e 61 6d 65 3d 22 6e 43 6f 6e 73 74 ram name="nConst
8c90: 72 61 69 6e 74 22 3e 0d 0a 20 20 20 20 20 20 20 raint">..
8ca0: 20 2f 2f 2f 20 54 68 65 20 6e 75 6d 62 65 72 20 /// The number
8cb0: 6f 66 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 of <see cref="SQ
8cc0: 4c 69 74 65 49 6e 64 65 78 43 6f 6e 73 74 72 61 LiteIndexConstra
8cd0: 69 6e 74 22 20 2f 3e 20 28 61 6e 64 0d 0a 20 20 int" /> (and..
8ce0: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 /// <see c
8cf0: 72 65 66 3d 22 53 51 4c 69 74 65 49 6e 64 65 78 ref="SQLiteIndex
8d00: 43 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 65 22 ConstraintUsage"
8d10: 20 2f 3e 29 20 69 6e 73 74 61 6e 63 65 73 20 74 />) instances t
8d20: 6f 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 70 o.. /// p
8d30: 72 65 2d 61 6c 6c 6f 63 61 74 65 20 73 70 61 63 re-allocate spac
8d40: 65 20 66 6f 72 2e 0d 0a 20 20 20 20 20 20 20 20 e for...
8d50: 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
8d60: 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
8d70: 20 6e 61 6d 65 3d 22 6e 4f 72 64 65 72 42 79 22 name="nOrderBy"
8d80: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
8d90: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 3c 73 65 he number of <se
8da0: 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65 49 6e e cref="SQLiteIn
8db0: 64 65 78 4f 72 64 65 72 42 79 22 20 2f 3e 20 69 dexOrderBy" /> i
8dc0: 6e 73 74 61 6e 63 65 73 20 74 6f 0d 0a 20 20 20 nstances to..
8dd0: 20 20 20 20 20 2f 2f 2f 20 70 72 65 2d 61 6c 6c /// pre-all
8de0: 6f 63 61 74 65 20 73 70 61 63 65 20 66 6f 72 2e ocate space for.
8df0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
8e00: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
8e10: 69 6e 74 65 72 6e 61 6c 20 53 51 4c 69 74 65 49 internal SQLiteI
8e20: 6e 64 65 78 28 0d 0a 20 20 20 20 20 20 20 20 20 ndex(..
8e30: 20 20 20 69 6e 74 20 6e 43 6f 6e 73 74 72 61 69 int nConstrai
8e40: 6e 74 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 nt,..
8e50: 20 69 6e 74 20 6e 4f 72 64 65 72 42 79 0d 0a 20 int nOrderBy..
8e60: 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 20 )..
8e70: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
8e80: 20 20 20 20 20 69 6e 70 75 74 73 20 3d 20 6e 65 inputs = ne
8e90: 77 20 53 51 4c 69 74 65 49 6e 64 65 78 49 6e 70 w SQLiteIndexInp
8ea0: 75 74 73 28 6e 43 6f 6e 73 74 72 61 69 6e 74 2c uts(nConstraint,
8eb0: 20 6e 4f 72 64 65 72 42 79 29 3b 0d 0a 20 20 20 nOrderBy);..
8ec0: 20 20 20 20 20 20 20 20 20 6f 75 74 70 75 74 73 outputs
8ed0: 20 3d 20 6e 65 77 20 53 51 4c 69 74 65 49 6e 64 = new SQLiteInd
8ee0: 65 78 4f 75 74 70 75 74 73 28 6e 43 6f 6e 73 74 exOutputs(nConst
8ef0: 72 61 69 6e 74 29 3b 0d 0a 20 20 20 20 20 20 20 raint);..
8f00: 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 }.. #end
8f10: 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 region....
8f20: 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////////
8f30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8f40: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8f50: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
8f60: 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 /////////....
8f70: 20 20 20 20 20 23 72 65 67 69 6f 6e 20 49 6e 74 #region Int
8f80: 65 72 6e 61 6c 20 4d 61 72 73 68 61 6c 20 48 65 ernal Marshal He
8f90: 6c 70 65 72 20 4d 65 74 68 6f 64 73 0d 0a 20 20 lper Methods..
8fa0: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
8fb0: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
8fc0: 20 43 6f 6e 76 65 72 74 73 20 61 20 6e 61 74 69 Converts a nati
8fd0: 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 ve pointer to a
8fe0: 6e 61 74 69 76 65 20 73 71 6c 69 74 65 33 5f 69 native sqlite3_i
8ff0: 6e 64 65 78 5f 69 6e 66 6f 20 73 74 72 75 63 74 ndex_info struct
9000: 75 72 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ure.. ///
9010: 20 69 6e 74 6f 20 61 20 6e 65 77 20 3c 73 65 65 into a new <see
9020: 20 63 72 65 66 3d 22 53 51 4c 69 74 65 49 6e 64 cref="SQLiteInd
9030: 65 78 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e ex" /> object in
9040: 73 74 61 6e 63 65 2e 0d 0a 20 20 20 20 20 20 20 stance...
9050: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
9060: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
9070: 72 61 6d 20 6e 61 6d 65 3d 22 70 49 6e 64 65 78 ram name="pIndex
9080: 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
9090: 54 68 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 The native point
90a0: 65 72 20 74 6f 20 74 68 65 20 6e 61 74 69 76 65 er to the native
90b0: 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 69 sqlite3_index_i
90c0: 6e 66 6f 20 73 74 72 75 63 74 75 72 65 20 74 6f nfo structure to
90d0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 63 6f .. /// co
90e0: 6e 76 65 72 74 2e 0d 0a 20 20 20 20 20 20 20 20 nvert...
90f0: 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
9100: 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
9110: 20 6e 61 6d 65 3d 22 69 6e 64 65 78 22 3e 0d 0a name="index">..
9120: 20 20 20 20 20 20 20 20 2f 2f 2f 20 55 70 6f 6e /// Upon
9130: 20 73 75 63 63 65 73 73 2c 20 74 68 69 73 20 70 success, this p
9140: 61 72 61 6d 65 74 65 72 20 77 69 6c 6c 20 62 65 arameter will be
9150: 20 6d 6f 64 69 66 69 65 64 20 74 6f 20 63 6f 6e modified to con
9160: 74 61 69 6e 20 74 68 65 20 6e 65 77 6c 79 0d 0a tain the newly..
9170: 20 20 20 20 20 20 20 20 2f 2f 2f 20 63 72 65 61 /// crea
9180: 74 65 64 20 3c 73 65 65 20 63 72 65 66 3d 22 53 ted <see cref="S
9190: 51 4c 69 74 65 49 6e 64 65 78 22 20 2f 3e 20 6f QLiteIndex" /> o
91a0: 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 2e 0d bject instance..
91b0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
91c0: 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 69 aram>.. i
91d0: 6e 74 65 72 6e 61 6c 20 73 74 61 74 69 63 20 76 nternal static v
91e0: 6f 69 64 20 46 72 6f 6d 49 6e 74 50 74 72 28 0d oid FromIntPtr(.
91f0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 . Int
9200: 50 74 72 20 70 49 6e 64 65 78 2c 0d 0a 20 20 20 Ptr pIndex,..
9210: 20 20 20 20 20 20 20 20 20 72 65 66 20 53 51 4c ref SQL
9220: 69 74 65 49 6e 64 65 78 20 69 6e 64 65 78 0d 0a iteIndex index..
9230: 20 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 )..
9240: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
9250: 20 20 20 20 20 20 69 66 20 28 70 49 6e 64 65 78 if (pIndex
9260: 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 == IntPtr.Zero)
9270: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
9280: 20 20 72 65 74 75 72 6e 3b 0d 0a 0d 0a 20 20 20 return;....
9290: 20 20 20 20 20 20 20 20 20 69 6e 74 20 6f 66 66 int off
92a0: 73 65 74 20 3d 20 30 3b 0d 0a 0d 0a 20 20 20 20 set = 0;....
92b0: 20 20 20 20 20 20 20 20 69 6e 74 20 6e 43 6f 6e int nCon
92c0: 73 74 72 61 69 6e 74 20 3d 20 53 51 4c 69 74 65 straint = SQLite
92d0: 4d 61 72 73 68 61 6c 2e 52 65 61 64 49 6e 74 33 Marshal.ReadInt3
92e0: 32 28 70 49 6e 64 65 78 2c 20 6f 66 66 73 65 74 2(pIndex, offset
92f0: 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 );....
9300: 20 20 6f 66 66 73 65 74 20 2b 3d 20 53 51 4c 69 offset += SQLi
9310: 74 65 4d 61 72 73 68 61 6c 2e 53 69 7a 65 4f 66 teMarshal.SizeOf
9320: 53 74 72 75 63 74 49 6e 74 28 29 3b 0d 0a 0d 0a StructInt();....
9330: 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 IntP
9340: 74 72 20 70 43 6f 6e 73 74 72 61 69 6e 74 20 3d tr pConstraint =
9350: 20 53 51 4c 69 74 65 4d 61 72 73 68 61 6c 2e 52 SQLiteMarshal.R
9360: 65 61 64 49 6e 74 50 74 72 28 70 49 6e 64 65 78 eadIntPtr(pIndex
9370: 2c 20 6f 66 66 73 65 74 29 3b 0d 0a 0d 0a 20 20 , offset);....
9380: 20 20 20 20 20 20 20 20 20 20 6f 66 66 73 65 74 offset
9390: 20 2b 3d 20 49 6e 74 50 74 72 2e 53 69 7a 65 3b += IntPtr.Size;
93a0: 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
93b0: 69 6e 74 20 6e 4f 72 64 65 72 42 79 20 3d 20 53 int nOrderBy = S
93c0: 51 4c 69 74 65 4d 61 72 73 68 61 6c 2e 52 65 61 QLiteMarshal.Rea
93d0: 64 49 6e 74 33 32 28 70 49 6e 64 65 78 2c 20 6f dInt32(pIndex, o
93e0: 66 66 73 65 74 29 3b 0d 0a 0d 0a 20 20 20 20 20 ffset);....
93f0: 20 20 20 20 20 20 20 6f 66 66 73 65 74 20 2b 3d offset +=
9400: 20 53 51 4c 69 74 65 4d 61 72 73 68 61 6c 2e 53 SQLiteMarshal.S
9410: 69 7a 65 4f 66 53 74 72 75 63 74 49 6e 74 28 29 izeOfStructInt()
9420: 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
9430: 20 49 6e 74 50 74 72 20 70 4f 72 64 65 72 42 79 IntPtr pOrderBy
9440: 20 3d 20 53 51 4c 69 74 65 4d 61 72 73 68 61 6c = SQLiteMarshal
9450: 2e 52 65 61 64 49 6e 74 50 74 72 28 70 49 6e 64 .ReadIntPtr(pInd
9460: 65 78 2c 20 6f 66 66 73 65 74 29 3b 0d 0a 0d 0a ex, offset);....
9470: 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 64 65 inde
9480: 78 20 3d 20 6e 65 77 20 53 51 4c 69 74 65 49 6e x = new SQLiteIn
9490: 64 65 78 28 6e 43 6f 6e 73 74 72 61 69 6e 74 2c dex(nConstraint,
94a0: 20 6e 4f 72 64 65 72 42 79 29 3b 0d 0a 0d 0a 20 nOrderBy);....
94b0: 20 20 20 20 20 20 20 20 20 20 20 54 79 70 65 20 Type
94c0: 69 6e 64 65 78 43 6f 6e 73 74 72 61 69 6e 74 54 indexConstraintT
94d0: 79 70 65 20 3d 20 74 79 70 65 6f 66 28 0d 0a 20 ype = typeof(..
94e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 55 U
94f0: 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
9500: 64 73 2e 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 ds.sqlite3_index
9510: 5f 63 6f 6e 73 74 72 61 69 6e 74 29 3b 0d 0a 0d _constraint);...
9520: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 . int
9530: 20 73 69 7a 65 4f 66 43 6f 6e 73 74 72 61 69 6e sizeOfConstrain
9540: 74 54 79 70 65 20 3d 20 4d 61 72 73 68 61 6c 2e tType = Marshal.
9550: 53 69 7a 65 4f 66 28 69 6e 64 65 78 43 6f 6e 73 SizeOf(indexCons
9560: 74 72 61 69 6e 74 54 79 70 65 29 3b 0d 0a 0d 0a traintType);....
9570: 20 20 20 20 20 20 20 20 20 20 20 20 66 6f 72 20 for
9580: 28 69 6e 74 20 69 43 6f 6e 73 74 72 61 69 6e 74 (int iConstraint
9590: 20 3d 20 30 3b 20 69 43 6f 6e 73 74 72 61 69 6e = 0; iConstrain
95a0: 74 20 3c 20 6e 43 6f 6e 73 74 72 61 69 6e 74 3b t < nConstraint;
95b0: 20 69 43 6f 6e 73 74 72 61 69 6e 74 2b 2b 29 0d iConstraint++).
95c0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a . {..
95d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
95e0: 49 6e 74 50 74 72 20 70 4f 66 66 73 65 74 20 3d IntPtr pOffset =
95f0: 20 53 51 4c 69 74 65 4d 61 72 73 68 61 6c 2e 49 SQLiteMarshal.I
9600: 6e 74 50 74 72 46 6f 72 4f 66 66 73 65 74 28 0d ntPtrForOffset(.
9610: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
9620: 20 20 20 20 20 70 43 6f 6e 73 74 72 61 69 6e 74 pConstraint
9630: 2c 20 69 43 6f 6e 73 74 72 61 69 6e 74 20 2a 20 , iConstraint *
9640: 73 69 7a 65 4f 66 43 6f 6e 73 74 72 61 69 6e 74 sizeOfConstraint
9650: 54 79 70 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 Type);....
9660: 20 20 20 20 20 20 20 20 20 20 55 6e 73 61 66 65 Unsafe
9670: 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 NativeMethods.sq
9680: 6c 69 74 65 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 lite3_index_cons
9690: 74 72 61 69 6e 74 20 63 6f 6e 73 74 72 61 69 6e traint constrain
96a0: 74 20 3d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 t =..
96b0: 20 20 20 20 20 20 20 20 20 28 55 6e 73 61 66 65 (Unsafe
96c0: 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 NativeMethods.sq
96d0: 6c 69 74 65 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 lite3_index_cons
96e0: 74 72 61 69 6e 74 29 0d 0a 20 20 20 20 20 20 20 traint)..
96f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9700: 20 4d 61 72 73 68 61 6c 2e 50 74 72 54 6f 53 74 Marshal.PtrToSt
9710: 72 75 63 74 75 72 65 28 70 4f 66 66 73 65 74 2c ructure(pOffset,
9720: 20 69 6e 64 65 78 43 6f 6e 73 74 72 61 69 6e 74 indexConstraint
9730: 54 79 70 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 Type);....
9740: 20 20 20 20 20 20 20 20 20 20 69 6e 64 65 78 2e index.
9750: 49 6e 70 75 74 73 2e 43 6f 6e 73 74 72 61 69 6e Inputs.Constrain
9760: 74 73 5b 69 43 6f 6e 73 74 72 61 69 6e 74 5d 20 ts[iConstraint]
9770: 3d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 =..
9780: 20 20 20 20 20 20 20 6e 65 77 20 53 51 4c 69 74 new SQLit
9790: 65 49 6e 64 65 78 43 6f 6e 73 74 72 61 69 6e 74 eIndexConstraint
97a0: 28 63 6f 6e 73 74 72 61 69 6e 74 29 3b 0d 0a 20 (constraint);..
97b0: 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a }....
97c0: 20 20 20 20 20 20 20 20 20 20 20 20 54 79 70 65 Type
97d0: 20 69 6e 64 65 78 4f 72 64 65 72 42 79 54 79 70 indexOrderByTyp
97e0: 65 20 3d 20 74 79 70 65 6f 66 28 0d 0a 20 20 20 e = typeof(..
97f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 55 6e 73 Uns
9800: 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 afeNativeMethods
9810: 2e 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 6f .sqlite3_index_o
9820: 72 64 65 72 62 79 29 3b 0d 0a 0d 0a 20 20 20 20 rderby);....
9830: 20 20 20 20 20 20 20 20 69 6e 74 20 73 69 7a 65 int size
9840: 4f 66 4f 72 64 65 72 42 79 54 79 70 65 20 3d 20 OfOrderByType =
9850: 4d 61 72 73 68 61 6c 2e 53 69 7a 65 4f 66 28 69 Marshal.SizeOf(i
9860: 6e 64 65 78 4f 72 64 65 72 42 79 54 79 70 65 29 ndexOrderByType)
9870: 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
9880: 20 66 6f 72 20 28 69 6e 74 20 69 4f 72 64 65 72 for (int iOrder
9890: 42 79 20 3d 20 30 3b 20 69 4f 72 64 65 72 42 79 By = 0; iOrderBy
98a0: 20 3c 20 6e 4f 72 64 65 72 42 79 3b 20 69 4f 72 < nOrderBy; iOr
98b0: 64 65 72 42 79 2b 2b 29 0d 0a 20 20 20 20 20 20 derBy++)..
98c0: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
98d0: 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 IntPtr
98e0: 70 4f 66 66 73 65 74 20 3d 20 53 51 4c 69 74 65 pOffset = SQLite
98f0: 4d 61 72 73 68 61 6c 2e 49 6e 74 50 74 72 46 6f Marshal.IntPtrFo
9900: 72 4f 66 66 73 65 74 28 0d 0a 20 20 20 20 20 20 rOffset(..
9910: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 4f pO
9920: 72 64 65 72 42 79 2c 20 69 4f 72 64 65 72 42 79 rderBy, iOrderBy
9930: 20 2a 20 73 69 7a 65 4f 66 4f 72 64 65 72 42 79 * sizeOfOrderBy
9940: 54 79 70 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 Type);....
9950: 20 20 20 20 20 20 20 20 20 20 55 6e 73 61 66 65 Unsafe
9960: 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 NativeMethods.sq
9970: 6c 69 74 65 33 5f 69 6e 64 65 78 5f 6f 72 64 65 lite3_index_orde
9980: 72 62 79 20 6f 72 64 65 72 42 79 20 3d 0d 0a 20 rby orderBy =..
9990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
99a0: 20 20 20 28 55 6e 73 61 66 65 4e 61 74 69 76 65 (UnsafeNative
99b0: 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f Methods.sqlite3_
99c0: 69 6e 64 65 78 5f 6f 72 64 65 72 62 79 29 0d 0a index_orderby)..
99d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
99e0: 20 20 20 20 20 20 20 20 4d 61 72 73 68 61 6c 2e Marshal.
99f0: 50 74 72 54 6f 53 74 72 75 63 74 75 72 65 28 70 PtrToStructure(p
9a00: 4f 66 66 73 65 74 2c 20 69 6e 64 65 78 4f 72 64 Offset, indexOrd
9a10: 65 72 42 79 54 79 70 65 29 3b 0d 0a 0d 0a 20 20 erByType);....
9a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e in
9a30: 64 65 78 2e 49 6e 70 75 74 73 2e 4f 72 64 65 72 dex.Inputs.Order
9a40: 42 79 73 5b 69 4f 72 64 65 72 42 79 5d 20 3d 0d Bys[iOrderBy] =.
9a50: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
9a60: 20 20 20 20 20 6e 65 77 20 53 51 4c 69 74 65 49 new SQLiteI
9a70: 6e 64 65 78 4f 72 64 65 72 42 79 28 6f 72 64 65 ndexOrderBy(orde
9a80: 72 42 79 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 rBy);..
9a90: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d }.. }.
9aa0: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
9ab0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
9ac0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
9ad0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
9ae0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
9af0: 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f //.... //
9b00: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
9b10: 20 20 20 20 20 2f 2f 2f 20 50 6f 70 75 6c 61 74 /// Populat
9b20: 65 73 20 74 68 65 20 6f 75 74 70 75 74 73 20 6f es the outputs o
9b30: 66 20 61 20 70 72 65 2d 61 6c 6c 6f 63 61 74 65 f a pre-allocate
9b40: 64 20 6e 61 74 69 76 65 20 73 71 6c 69 74 65 33 d native sqlite3
9b50: 5f 69 6e 64 65 78 5f 69 6e 66 6f 0d 0a 20 20 20 _index_info..
9b60: 20 20 20 20 20 2f 2f 2f 20 73 74 72 75 63 74 75 /// structu
9b70: 72 65 20 75 73 69 6e 67 20 61 6e 20 65 78 69 73 re using an exis
9b80: 74 69 6e 67 20 3c 73 65 65 20 63 72 65 66 3d 22 ting <see cref="
9b90: 53 51 4c 69 74 65 49 6e 64 65 78 22 20 2f 3e 20 SQLiteIndex" />
9ba0: 6f 62 6a 65 63 74 0d 0a 20 20 20 20 20 20 20 20 object..
9bb0: 2f 2f 2f 20 69 6e 73 74 61 6e 63 65 2e 0d 0a 20 /// instance...
9bc0: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
9bd0: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
9be0: 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
9bf0: 69 6e 64 65 78 22 3e 0d 0a 20 20 20 20 20 20 20 index">..
9c00: 20 2f 2f 2f 20 54 68 65 20 65 78 69 73 74 69 6e /// The existin
9c10: 67 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c g <see cref="SQL
9c20: 69 74 65 49 6e 64 65 78 22 20 2f 3e 20 6f 62 6a iteIndex" /> obj
9c30: 65 63 74 20 69 6e 73 74 61 6e 63 65 20 63 6f 6e ect instance con
9c40: 74 61 69 6e 69 6e 67 0d 0a 20 20 20 20 20 20 20 taining..
9c50: 20 2f 2f 2f 20 74 68 65 20 6f 75 74 70 75 74 20 /// the output
9c60: 64 61 74 61 20 74 6f 20 75 73 65 2e 0d 0a 20 20 data to use...
9c70: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
9c80: 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
9c90: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 49 6e <param name="pIn
9ca0: 64 65 78 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f dex">.. /
9cb0: 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 70 6f // The native po
9cc0: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 inter to the pre
9cd0: 2d 61 6c 6c 6f 63 61 74 65 64 20 6e 61 74 69 76 -allocated nativ
9ce0: 65 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f e sqlite3_index_
9cf0: 69 6e 66 6f 0d 0a 20 20 20 20 20 20 20 20 2f 2f info.. //
9d00: 2f 20 73 74 72 75 63 74 75 72 65 2e 0d 0a 20 20 / structure...
9d10: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
9d20: 6d 3e 0d 0a 20 20 20 20 20 20 20 20 69 6e 74 65 m>.. inte
9d30: 72 6e 61 6c 20 73 74 61 74 69 63 20 76 6f 69 64 rnal static void
9d40: 20 54 6f 49 6e 74 50 74 72 28 0d 0a 20 20 20 20 ToIntPtr(..
9d50: 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 49 6e SQLiteIn
9d60: 64 65 78 20 69 6e 64 65 78 2c 0d 0a 20 20 20 20 dex index,..
9d70: 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 IntPtr p
9d80: 49 6e 64 65 78 0d 0a 20 20 20 20 20 20 20 20 20 Index..
9d90: 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d ).. {.
9da0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 . if
9db0: 28 28 69 6e 64 65 78 20 3d 3d 20 6e 75 6c 6c 29 ((index == null)
9dc0: 20 7c 7c 20 28 69 6e 64 65 78 2e 49 6e 70 75 74 || (index.Input
9dd0: 73 20 3d 3d 20 6e 75 6c 6c 29 20 7c 7c 0d 0a 20 s == null) ||..
9de0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 (
9df0: 69 6e 64 65 78 2e 49 6e 70 75 74 73 2e 43 6f 6e index.Inputs.Con
9e00: 73 74 72 61 69 6e 74 73 20 3d 3d 20 6e 75 6c 6c straints == null
9e10: 29 20 7c 7c 0d 0a 20 20 20 20 20 20 20 20 20 20 ) ||..
9e20: 20 20 20 20 20 20 28 69 6e 64 65 78 2e 4f 75 74 (index.Out
9e30: 70 75 74 73 20 3d 3d 20 6e 75 6c 6c 29 20 7c 7c puts == null) ||
9e40: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
9e50: 20 20 28 69 6e 64 65 78 2e 4f 75 74 70 75 74 73 (index.Outputs
9e60: 2e 43 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 65 .ConstraintUsage
9e70: 73 20 3d 3d 20 6e 75 6c 6c 29 29 0d 0a 20 20 20 s == null))..
9e80: 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
9e90: 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
9ea0: 72 6e 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 rn;..
9eb0: 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 }....
9ec0: 20 20 69 66 20 28 70 49 6e 64 65 78 20 3d 3d 20 if (pIndex ==
9ed0: 49 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a 20 20 IntPtr.Zero)..
9ee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
9ef0: 74 75 72 6e 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 turn;....
9f00: 20 20 20 20 20 69 6e 74 20 6f 66 66 73 65 74 20 int offset
9f10: 3d 20 30 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 = 0;....
9f20: 20 20 20 20 69 6e 74 20 6e 43 6f 6e 73 74 72 61 int nConstra
9f30: 69 6e 74 20 3d 20 53 51 4c 69 74 65 4d 61 72 73 int = SQLiteMars
9f40: 68 61 6c 2e 52 65 61 64 49 6e 74 33 32 28 70 49 hal.ReadInt32(pI
9f50: 6e 64 65 78 2c 20 6f 66 66 73 65 74 29 3b 0d 0a ndex, offset);..
9f60: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 .. if
9f70: 20 28 6e 43 6f 6e 73 74 72 61 69 6e 74 20 21 3d (nConstraint !=
9f80: 20 69 6e 64 65 78 2e 49 6e 70 75 74 73 2e 43 6f index.Inputs.Co
9f90: 6e 73 74 72 61 69 6e 74 73 2e 4c 65 6e 67 74 68 nstraints.Length
9fa0: 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 )..
9fb0: 20 20 20 72 65 74 75 72 6e 3b 0d 0a 0d 0a 20 20 return;....
9fc0: 20 20 20 20 20 20 20 20 20 20 69 66 20 28 6e 43 if (nC
9fd0: 6f 6e 73 74 72 61 69 6e 74 20 21 3d 20 69 6e 64 onstraint != ind
9fe0: 65 78 2e 4f 75 74 70 75 74 73 2e 43 6f 6e 73 74 ex.Outputs.Const
9ff0: 72 61 69 6e 74 55 73 61 67 65 73 2e 4c 65 6e 67 raintUsages.Leng
a000: 74 68 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 th)..
a010: 20 20 20 20 20 72 65 74 75 72 6e 3b 0d 0a 0d 0a return;....
a020: 20 20 20 20 20 20 20 20 20 20 20 20 6f 66 66 73 offs
a030: 65 74 20 2b 3d 20 53 51 4c 69 74 65 4d 61 72 73 et += SQLiteMars
a040: 68 61 6c 2e 53 69 7a 65 4f 66 53 74 72 75 63 74 hal.SizeOfStruct
a050: 49 6e 74 28 29 20 2b 20 49 6e 74 50 74 72 2e 53 Int() + IntPtr.S
a060: 69 7a 65 20 2b 0d 0a 20 20 20 20 20 20 20 20 20 ize +..
a070: 20 20 20 20 20 20 20 53 51 4c 69 74 65 4d 61 72 SQLiteMar
a080: 73 68 61 6c 2e 53 69 7a 65 4f 66 53 74 72 75 63 shal.SizeOfStruc
a090: 74 49 6e 74 28 29 20 2b 20 49 6e 74 50 74 72 2e tInt() + IntPtr.
a0a0: 53 69 7a 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 Size;....
a0b0: 20 20 20 20 20 49 6e 74 50 74 72 20 70 43 6f 6e IntPtr pCon
a0c0: 73 74 72 61 69 6e 74 55 73 61 67 65 20 3d 20 53 straintUsage = S
a0d0: 51 4c 69 74 65 4d 61 72 73 68 61 6c 2e 52 65 61 QLiteMarshal.Rea
a0e0: 64 49 6e 74 50 74 72 28 70 49 6e 64 65 78 2c 20 dIntPtr(pIndex,
a0f0: 6f 66 66 73 65 74 29 3b 0d 0a 0d 0a 20 20 20 20 offset);....
a100: 20 20 20 20 20 20 20 20 69 6e 74 20 73 69 7a 65 int size
a110: 4f 66 43 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 OfConstraintUsag
a120: 65 54 79 70 65 20 3d 20 4d 61 72 73 68 61 6c 2e eType = Marshal.
a130: 53 69 7a 65 4f 66 28 74 79 70 65 6f 66 28 0d 0a SizeOf(typeof(..
a140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a150: 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 UnsafeNativeMeth
a160: 6f 64 73 2e 73 71 6c 69 74 65 33 5f 69 6e 64 65 ods.sqlite3_inde
a170: 78 5f 63 6f 6e 73 74 72 61 69 6e 74 5f 75 73 61 x_constraint_usa
a180: 67 65 29 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 ge));....
a190: 20 20 20 20 20 66 6f 72 20 28 69 6e 74 20 69 43 for (int iC
a1a0: 6f 6e 73 74 72 61 69 6e 74 20 3d 20 30 3b 20 69 onstraint = 0; i
a1b0: 43 6f 6e 73 74 72 61 69 6e 74 20 3c 20 6e 43 6f Constraint < nCo
a1c0: 6e 73 74 72 61 69 6e 74 3b 20 69 43 6f 6e 73 74 nstraint; iConst
a1d0: 72 61 69 6e 74 2b 2b 29 0d 0a 20 20 20 20 20 20 raint++)..
a1e0: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
a1f0: 20 20 20 20 20 20 20 20 20 55 6e 73 61 66 65 4e UnsafeN
a200: 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c ativeMethods.sql
a210: 69 74 65 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 74 ite3_index_const
a220: 72 61 69 6e 74 5f 75 73 61 67 65 20 63 6f 6e 73 raint_usage cons
a230: 74 72 61 69 6e 74 55 73 61 67 65 20 3d 0d 0a 20 traintUsage =..
a240: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a250: 20 20 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 new UnsafeNat
a260: 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 iveMethods.sqlit
a270: 65 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 74 72 61 e3_index_constra
a280: 69 6e 74 5f 75 73 61 67 65 28 0d 0a 20 20 20 20 int_usage(..
a290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a2a0: 20 20 20 20 69 6e 64 65 78 2e 4f 75 74 70 75 74 index.Output
a2b0: 73 2e 43 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 s.ConstraintUsag
a2c0: 65 73 5b 69 43 6f 6e 73 74 72 61 69 6e 74 5d 29 es[iConstraint])
a2d0: 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
a2e0: 20 20 20 20 20 4d 61 72 73 68 61 6c 2e 53 74 72 Marshal.Str
a2f0: 75 63 74 75 72 65 54 6f 50 74 72 28 0d 0a 20 20 uctureToPtr(..
a300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a310: 20 20 63 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 constraintUsag
a320: 65 2c 20 53 51 4c 69 74 65 4d 61 72 73 68 61 6c e, SQLiteMarshal
a330: 2e 49 6e 74 50 74 72 46 6f 72 4f 66 66 73 65 74 .IntPtrForOffset
a340: 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 (..
a350: 20 20 20 20 20 20 20 70 43 6f 6e 73 74 72 61 69 pConstrai
a360: 6e 74 55 73 61 67 65 2c 20 69 43 6f 6e 73 74 72 ntUsage, iConstr
a370: 61 69 6e 74 20 2a 20 73 69 7a 65 4f 66 43 6f 6e aint * sizeOfCon
a380: 73 74 72 61 69 6e 74 55 73 61 67 65 54 79 70 65 straintUsageType
a390: 29 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ),..
a3a0: 20 20 20 20 20 20 20 20 66 61 6c 73 65 29 3b 0d false);.
a3b0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a . }..
a3c0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6f 66 .. of
a3d0: 66 73 65 74 20 2b 3d 20 49 6e 74 50 74 72 2e 53 fset += IntPtr.S
a3e0: 69 7a 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ize;....
a3f0: 20 20 20 20 53 51 4c 69 74 65 4d 61 72 73 68 61 SQLiteMarsha
a400: 6c 2e 57 72 69 74 65 49 6e 74 33 32 28 70 49 6e l.WriteInt32(pIn
a410: 64 65 78 2c 20 6f 66 66 73 65 74 2c 0d 0a 20 20 dex, offset,..
a420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e in
a430: 64 65 78 2e 4f 75 74 70 75 74 73 2e 49 6e 64 65 dex.Outputs.Inde
a440: 78 4e 75 6d 62 65 72 29 3b 0d 0a 0d 0a 20 20 20 xNumber);....
a450: 20 20 20 20 20 20 20 20 20 6f 66 66 73 65 74 20 offset
a460: 2b 3d 20 53 51 4c 69 74 65 4d 61 72 73 68 61 6c += SQLiteMarshal
a470: 2e 53 69 7a 65 4f 66 53 74 72 75 63 74 49 6e 74 .SizeOfStructInt
a480: 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 ();....
a490: 20 20 20 53 51 4c 69 74 65 4d 61 72 73 68 61 6c SQLiteMarshal
a4a0: 2e 57 72 69 74 65 49 6e 74 50 74 72 28 70 49 6e .WriteIntPtr(pIn
a4b0: 64 65 78 2c 20 6f 66 66 73 65 74 2c 0d 0a 20 20 dex, offset,..
a4c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
a4d0: 4c 69 74 65 53 74 72 69 6e 67 2e 55 74 66 38 49 LiteString.Utf8I
a4e0: 6e 74 50 74 72 46 72 6f 6d 53 74 72 69 6e 67 28 ntPtrFromString(
a4f0: 69 6e 64 65 78 2e 4f 75 74 70 75 74 73 2e 49 6e index.Outputs.In
a500: 64 65 78 53 74 72 69 6e 67 29 29 3b 0d 0a 0d 0a dexString));....
a510: 20 20 20 20 20 20 20 20 20 20 20 20 6f 66 66 73 offs
a520: 65 74 20 2b 3d 20 49 6e 74 50 74 72 2e 53 69 7a et += IntPtr.Siz
a530: 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 e;....
a540: 20 20 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 //..
a550: 20 20 2f 2f 20 4e 4f 54 45 3a 20 57 65 20 6a 75 // NOTE: We ju
a560: 73 74 20 61 6c 6c 6f 63 61 74 65 64 20 74 68 65 st allocated the
a570: 20 49 6e 64 65 78 53 74 72 69 6e 67 20 66 69 65 IndexString fie
a580: 6c 64 3b 20 74 68 65 72 65 66 6f 72 65 2c 20 77 ld; therefore, w
a590: 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f e.. /
a5a0: 2f 20 20 20 20 20 20 20 6e 65 65 64 20 74 6f 20 / need to
a5b0: 73 65 74 20 74 68 65 20 4e 65 65 64 54 6f 46 72 set the NeedToFr
a5c0: 65 65 49 6e 64 65 78 53 74 72 69 6e 67 20 66 69 eeIndexString fi
a5d0: 65 6c 64 20 74 6f 20 6e 6f 6e 2d 7a 65 72 6f 2e eld to non-zero.
a5e0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
a5f0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 51 .. SQ
a600: 4c 69 74 65 4d 61 72 73 68 61 6c 2e 57 72 69 74 LiteMarshal.Writ
a610: 65 49 6e 74 33 32 28 70 49 6e 64 65 78 2c 20 6f eInt32(pIndex, o
a620: 66 66 73 65 74 2c 20 31 29 3b 0d 0a 0d 0a 20 20 ffset, 1);....
a630: 20 20 20 20 20 20 20 20 20 20 6f 66 66 73 65 74 offset
a640: 20 2b 3d 20 53 51 4c 69 74 65 4d 61 72 73 68 61 += SQLiteMarsha
a650: 6c 2e 53 69 7a 65 4f 66 53 74 72 75 63 74 49 6e l.SizeOfStructIn
a660: 74 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 t();....
a670: 20 20 20 20 53 51 4c 69 74 65 4d 61 72 73 68 61 SQLiteMarsha
a680: 6c 2e 57 72 69 74 65 49 6e 74 33 32 28 70 49 6e l.WriteInt32(pIn
a690: 64 65 78 2c 20 6f 66 66 73 65 74 2c 0d 0a 20 20 dex, offset,..
a6a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e in
a6b0: 64 65 78 2e 4f 75 74 70 75 74 73 2e 4f 72 64 65 dex.Outputs.Orde
a6c0: 72 42 79 43 6f 6e 73 75 6d 65 64 29 3b 0d 0a 0d rByConsumed);...
a6d0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 6f 66 66 . off
a6e0: 73 65 74 20 2b 3d 20 53 51 4c 69 74 65 4d 61 72 set += SQLiteMar
a6f0: 73 68 61 6c 2e 53 69 7a 65 4f 66 53 74 72 75 63 shal.SizeOfStruc
a700: 74 49 6e 74 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 tInt();....
a710: 20 20 20 20 20 20 20 53 51 4c 69 74 65 4d 61 72 SQLiteMar
a720: 73 68 61 6c 2e 57 72 69 74 65 44 6f 75 62 6c 65 shal.WriteDouble
a730: 28 70 49 6e 64 65 78 2c 20 6f 66 66 73 65 74 2c (pIndex, offset,
a740: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
a750: 20 20 69 6e 64 65 78 2e 4f 75 74 70 75 74 73 2e index.Outputs.
a760: 45 73 74 69 6d 61 74 65 64 43 6f 73 74 29 3b 0d EstimatedCost);.
a770: 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 . }..
a780: 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a #endregion..
a790: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
a7a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
a7b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
a7c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
a7d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
a7e0: 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 /.... #re
a7f0: 67 69 6f 6e 20 50 75 62 6c 69 63 20 50 72 6f 70 gion Public Prop
a800: 65 72 74 69 65 73 0d 0a 20 20 20 20 20 20 20 20 erties..
a810: 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 49 6e private SQLiteIn
a820: 64 65 78 49 6e 70 75 74 73 20 69 6e 70 75 74 73 dexInputs inputs
a830: 3b 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ;.. /// <
a840: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
a850: 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 /// The <see c
a860: 72 65 66 3d 22 53 51 4c 69 74 65 49 6e 64 65 78 ref="SQLiteIndex
a870: 49 6e 70 75 74 73 22 20 2f 3e 20 6f 62 6a 65 63 Inputs" /> objec
a880: 74 20 69 6e 73 74 61 6e 63 65 20 63 6f 6e 74 61 t instance conta
a890: 69 6e 69 6e 67 0d 0a 20 20 20 20 20 20 20 20 2f ining.. /
a8a0: 2f 2f 20 74 68 65 20 69 6e 70 75 74 73 20 74 6f // the inputs to
a8b0: 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 the <see cref="
a8c0: 49 53 51 4c 69 74 65 4d 61 6e 61 67 65 64 4d 6f ISQLiteManagedMo
a8d0: 64 75 6c 65 2e 42 65 73 74 49 6e 64 65 78 22 20 dule.BestIndex"
a8e0: 2f 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 />.. ///
a8f0: 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 method...
a900: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
a910: 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 . public
a920: 53 51 4c 69 74 65 49 6e 64 65 78 49 6e 70 75 74 SQLiteIndexInput
a930: 73 20 49 6e 70 75 74 73 0d 0a 20 20 20 20 20 20 s Inputs..
a940: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
a950: 20 67 65 74 20 7b 20 72 65 74 75 72 6e 20 69 6e get { return in
a960: 70 75 74 73 3b 20 7d 0d 0a 20 20 20 20 20 20 20 puts; }..
a970: 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f }.... //
a980: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
a990: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
a9a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
a9b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
a9c0: 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
a9d0: 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 49 private SQLiteI
a9e0: 6e 64 65 78 4f 75 74 70 75 74 73 20 6f 75 74 70 ndexOutputs outp
a9f0: 75 74 73 3b 0d 0a 20 20 20 20 20 20 20 20 2f 2f uts;.. //
aa00: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
aa10: 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 /// The <se
aa20: 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65 49 6e e cref="SQLiteIn
aa30: 64 65 78 4f 75 74 70 75 74 73 22 20 2f 3e 20 6f dexOutputs" /> o
aa40: 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 63 bject instance c
aa50: 6f 6e 74 61 69 6e 69 6e 67 0d 0a 20 20 20 20 20 ontaining..
aa60: 20 20 20 2f 2f 2f 20 74 68 65 20 6f 75 74 70 75 /// the outpu
aa70: 74 73 20 66 72 6f 6d 20 74 68 65 20 3c 73 65 65 ts from the <see
aa80: 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4d 61 cref="ISQLiteMa
aa90: 6e 61 67 65 64 4d 6f 64 75 6c 65 2e 42 65 73 74 nagedModule.Best
aaa0: 49 6e 64 65 78 22 20 2f 3e 0d 0a 20 20 20 20 20 Index" />..
aab0: 20 20 20 2f 2f 2f 20 6d 65 74 68 6f 64 2e 0d 0a /// method...
aac0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
aad0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
aae0: 70 75 62 6c 69 63 20 53 51 4c 69 74 65 49 6e 64 public SQLiteInd
aaf0: 65 78 4f 75 74 70 75 74 73 20 4f 75 74 70 75 74 exOutputs Output
ab00: 73 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 s.. {..
ab10: 20 20 20 20 20 20 20 20 20 20 67 65 74 20 7b 20 get {
ab20: 72 65 74 75 72 6e 20 6f 75 74 70 75 74 73 3b 20 return outputs;
ab30: 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 }.. }..
ab40: 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e #endregion
ab50: 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 65 6e .. }.. #en
ab60: 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 2f dregion.... /
ab70: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
ab80: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
ab90: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
aba0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
abb0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
abc0: 20 20 23 72 65 67 69 6f 6e 20 53 51 4c 69 74 65 #region SQLite
abd0: 56 69 72 74 75 61 6c 54 61 62 6c 65 20 42 61 73 VirtualTable Bas
abe0: 65 20 43 6c 61 73 73 0d 0a 20 20 20 20 2f 2f 2f e Class.. ///
abf0: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
ac00: 2f 2f 2f 20 54 68 69 73 20 63 6c 61 73 73 20 72 /// This class r
ac10: 65 70 72 65 73 65 6e 74 73 20 61 20 6d 61 6e 61 epresents a mana
ac20: 67 65 64 20 76 69 72 74 75 61 6c 20 74 61 62 6c ged virtual tabl
ac30: 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e e implementation
ac40: 2e 20 20 49 74 20 69 73 0d 0a 20 20 20 20 2f 2f . It is.. //
ac50: 2f 20 6e 6f 74 20 73 65 61 6c 65 64 20 61 6e 64 / not sealed and
ac60: 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 20 should be used
ac70: 61 73 20 74 68 65 20 62 61 73 65 20 63 6c 61 73 as the base clas
ac80: 73 20 66 6f 72 20 61 6e 79 20 75 73 65 72 2d 64 s for any user-d
ac90: 65 66 69 6e 65 64 0d 0a 20 20 20 20 2f 2f 2f 20 efined.. ///
aca0: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 63 6c virtual table cl
acb0: 61 73 73 65 73 20 69 6d 70 6c 65 6d 65 6e 74 65 asses implemente
acc0: 64 20 69 6e 20 6d 61 6e 61 67 65 64 20 63 6f 64 d in managed cod
acd0: 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 e... /// </su
ace0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 70 75 62 6c mmary>.. publ
acf0: 69 63 20 63 6c 61 73 73 20 53 51 4c 69 74 65 56 ic class SQLiteV
ad00: 69 72 74 75 61 6c 54 61 62 6c 65 20 3a 0d 0a 20 irtualTable :..
ad10: 20 20 20 20 20 20 20 20 20 20 20 49 53 51 4c 69 ISQLi
ad20: 74 65 4e 61 74 69 76 65 48 61 6e 64 6c 65 2c 20 teNativeHandle,
ad30: 49 44 69 73 70 6f 73 61 62 6c 65 20 2f 2a 20 4e IDisposable /* N
ad40: 4f 54 20 53 45 41 4c 45 44 20 2a 2f 0d 0a 20 20 OT SEALED */..
ad50: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 23 72 65 {.. #re
ad60: 67 69 6f 6e 20 50 72 69 76 61 74 65 20 43 6f 6e gion Private Con
ad70: 73 74 61 6e 74 73 0d 0a 20 20 20 20 20 20 20 20 stants..
ad80: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
ad90: 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 69 /// The i
ada0: 6e 64 65 78 20 77 69 74 68 69 6e 20 74 68 65 20 ndex within the
adb0: 61 72 72 61 79 20 6f 66 20 73 74 72 69 6e 67 73 array of strings
adc0: 20 70 72 6f 76 69 64 65 64 20 74 6f 20 74 68 65 provided to the
add0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
ade0: 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
adf0: 4d 61 6e 61 67 65 64 4d 6f 64 75 6c 65 2e 43 72 ManagedModule.Cr
ae00: 65 61 74 65 22 20 2f 3e 20 61 6e 64 0d 0a 20 20 eate" /> and..
ae10: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 /// <see c
ae20: 72 65 66 3d 22 49 53 51 4c 69 74 65 4d 61 6e 61 ref="ISQLiteMana
ae30: 67 65 64 4d 6f 64 75 6c 65 2e 43 6f 6e 6e 65 63 gedModule.Connec
ae40: 74 22 20 2f 3e 20 6d 65 74 68 6f 64 73 20 63 6f t" /> methods co
ae50: 6e 74 61 69 6e 69 6e 67 20 74 68 65 0d 0a 20 20 ntaining the..
ae60: 20 20 20 20 20 20 2f 2f 2f 20 6e 61 6d 65 20 6f /// name o
ae70: 66 20 74 68 65 20 6d 6f 64 75 6c 65 20 69 6d 70 f the module imp
ae80: 6c 65 6d 65 6e 74 69 6e 67 20 74 68 69 73 20 76 lementing this v
ae90: 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 irtual table...
aea0: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
aeb0: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 mary>.. p
aec0: 72 69 76 61 74 65 20 63 6f 6e 73 74 20 69 6e 74 rivate const int
aed0: 20 4d 6f 64 75 6c 65 4e 61 6d 65 49 6e 64 65 78 ModuleNameIndex
aee0: 20 3d 20 30 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 = 0;....
aef0: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
af00: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
af10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
af20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
af30: 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 ////////....
af40: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
af50: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
af60: 68 65 20 69 6e 64 65 78 20 77 69 74 68 69 6e 20 he index within
af70: 74 68 65 20 61 72 72 61 79 20 6f 66 20 73 74 72 the array of str
af80: 69 6e 67 73 20 70 72 6f 76 69 64 65 64 20 74 6f ings provided to
af90: 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f the.. //
afa0: 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 / <see cref="ISQ
afb0: 4c 69 74 65 4d 61 6e 61 67 65 64 4d 6f 64 75 6c LiteManagedModul
afc0: 65 2e 43 72 65 61 74 65 22 20 2f 3e 20 61 6e 64 e.Create" /> and
afd0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
afe0: 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
aff0: 4d 61 6e 61 67 65 64 4d 6f 64 75 6c 65 2e 43 6f ManagedModule.Co
b000: 6e 6e 65 63 74 22 20 2f 3e 20 6d 65 74 68 6f 64 nnect" /> method
b010: 73 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 s containing the
b020: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6e 61 .. /// na
b030: 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 me of the databa
b040: 73 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 se containing th
b050: 69 73 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 is virtual table
b060: 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
b070: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
b080: 20 20 20 70 72 69 76 61 74 65 20 63 6f 6e 73 74 private const
b090: 20 69 6e 74 20 44 61 74 61 62 61 73 65 4e 61 6d int DatabaseNam
b0a0: 65 49 6e 64 65 78 20 3d 20 31 3b 0d 0a 0d 0a 20 eIndex = 1;....
b0b0: 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
b0c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b0d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b0e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b0f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a //////////////..
b100: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
b110: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
b120: 20 2f 2f 2f 20 54 68 65 20 69 6e 64 65 78 20 77 /// The index w
b130: 69 74 68 69 6e 20 74 68 65 20 61 72 72 61 79 20 ithin the array
b140: 6f 66 20 73 74 72 69 6e 67 73 20 70 72 6f 76 69 of strings provi
b150: 64 65 64 20 74 6f 20 74 68 65 0d 0a 20 20 20 20 ded to the..
b160: 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 /// <see cre
b170: 66 3d 22 49 53 51 4c 69 74 65 4d 61 6e 61 67 65 f="ISQLiteManage
b180: 64 4d 6f 64 75 6c 65 2e 43 72 65 61 74 65 22 20 dModule.Create"
b190: 2f 3e 20 61 6e 64 0d 0a 20 20 20 20 20 20 20 20 /> and..
b1a0: 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 49 /// <see cref="I
b1b0: 53 51 4c 69 74 65 4d 61 6e 61 67 65 64 4d 6f 64 SQLiteManagedMod
b1c0: 75 6c 65 2e 43 6f 6e 6e 65 63 74 22 20 2f 3e 20 ule.Connect" />
b1d0: 6d 65 74 68 6f 64 73 20 63 6f 6e 74 61 69 6e 69 methods containi
b1e0: 6e 67 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 ng the..
b1f0: 2f 2f 2f 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 /// name of the
b200: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a virtual table...
b210: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
b220: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
b230: 70 72 69 76 61 74 65 20 63 6f 6e 73 74 20 69 6e private const in
b240: 74 20 54 61 62 6c 65 4e 61 6d 65 49 6e 64 65 78 t TableNameIndex
b250: 20 3d 20 32 3b 0d 0a 20 20 20 20 20 20 20 20 23 = 2;.. #
b260: 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 endregion....
b270: 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
b280: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b290: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b2a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b2b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
b2c0: 20 20 20 20 20 20 20 20 23 72 65 67 69 6f 6e 20 #region
b2d0: 50 75 62 6c 69 63 20 43 6f 6e 73 74 72 75 63 74 Public Construct
b2e0: 6f 72 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ors.. ///
b2f0: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
b300: 20 20 20 20 2f 2f 2f 20 43 6f 6e 73 74 72 75 63 /// Construc
b310: 74 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f ts an instance o
b320: 66 20 74 68 69 73 20 63 6c 61 73 73 2e 0d 0a 20 f this class...
b330: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
b340: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
b350: 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
b360: 61 72 67 75 6d 65 6e 74 73 22 3e 0d 0a 20 20 20 arguments">..
b370: 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6f 72 69 /// The ori
b380: 67 69 6e 61 6c 20 61 72 72 61 79 20 6f 66 20 73 ginal array of s
b390: 74 72 69 6e 67 73 20 70 72 6f 76 69 64 65 64 20 trings provided
b3a0: 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 to the..
b3b0: 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 49 /// <see cref="I
b3c0: 53 51 4c 69 74 65 4d 61 6e 61 67 65 64 4d 6f 64 SQLiteManagedMod
b3d0: 75 6c 65 2e 43 72 65 61 74 65 22 20 2f 3e 20 61 ule.Create" /> a
b3e0: 6e 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 nd.. ///
b3f0: 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 <see cref="ISQLi
b400: 74 65 4d 61 6e 61 67 65 64 4d 6f 64 75 6c 65 2e teManagedModule.
b410: 43 6f 6e 6e 65 63 74 22 20 2f 3e 20 6d 65 74 68 Connect" /> meth
b420: 6f 64 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ods... //
b430: 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
b440: 20 20 20 20 70 75 62 6c 69 63 20 53 51 4c 69 74 public SQLit
b450: 65 56 69 72 74 75 61 6c 54 61 62 6c 65 28 0d 0a eVirtualTable(..
b460: 20 20 20 20 20 20 20 20 20 20 20 20 73 74 72 69 stri
b470: 6e 67 5b 5d 20 61 72 67 75 6d 65 6e 74 73 0d 0a ng[] arguments..
b480: 20 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 )..
b490: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
b4a0: 20 20 20 20 20 20 74 68 69 73 2e 61 72 67 75 6d this.argum
b4b0: 65 6e 74 73 20 3d 20 61 72 67 75 6d 65 6e 74 73 ents = arguments
b4c0: 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 ;.. }..
b4d0: 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e #endregion
b4e0: 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
b4f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b500: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b510: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b520: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b530: 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 ///.... #
b540: 72 65 67 69 6f 6e 20 50 75 62 6c 69 63 20 50 72 region Public Pr
b550: 6f 70 65 72 74 69 65 73 0d 0a 20 20 20 20 20 20 operties..
b560: 20 20 70 72 69 76 61 74 65 20 73 74 72 69 6e 67 private string
b570: 5b 5d 20 61 72 67 75 6d 65 6e 74 73 3b 0d 0a 20 [] arguments;..
b580: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
b590: 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
b5a0: 2f 20 54 68 65 20 6f 72 69 67 69 6e 61 6c 20 61 / The original a
b5b0: 72 72 61 79 20 6f 66 20 73 74 72 69 6e 67 73 20 rray of strings
b5c0: 70 72 6f 76 69 64 65 64 20 74 6f 20 74 68 65 0d provided to the.
b5d0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 . /// <se
b5e0: 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4d e cref="ISQLiteM
b5f0: 61 6e 61 67 65 64 4d 6f 64 75 6c 65 2e 43 72 65 anagedModule.Cre
b600: 61 74 65 22 20 2f 3e 20 61 6e 64 0d 0a 20 20 20 ate" /> and..
b610: 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 /// <see cr
b620: 65 66 3d 22 49 53 51 4c 69 74 65 4d 61 6e 61 67 ef="ISQLiteManag
b630: 65 64 4d 6f 64 75 6c 65 2e 43 6f 6e 6e 65 63 74 edModule.Connect
b640: 22 20 2f 3e 20 6d 65 74 68 6f 64 73 2e 0d 0a 20 " /> methods...
b650: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
b660: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 mary>.. p
b670: 75 62 6c 69 63 20 76 69 72 74 75 61 6c 20 73 74 ublic virtual st
b680: 72 69 6e 67 5b 5d 20 41 72 67 75 6d 65 6e 74 73 ring[] Arguments
b690: 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 .. {..
b6a0: 20 20 20 20 20 20 20 20 20 67 65 74 20 7b 20 43 get { C
b6b0: 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 3b 20 heckDisposed();
b6c0: 72 65 74 75 72 6e 20 61 72 67 75 6d 65 6e 74 73 return arguments
b6d0: 3b 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a ; }.. }..
b6e0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
b6f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b700: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b710: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b720: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b730: 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f /.... ///
b740: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
b750: 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 6d 65 /// The name
b760: 20 6f 66 20 74 68 65 20 6d 6f 64 75 6c 65 20 69 of the module i
b770: 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 74 68 69 73 mplementing this
b780: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d virtual table..
b790: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
b7a0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
b7b0: 20 70 75 62 6c 69 63 20 76 69 72 74 75 61 6c 20 public virtual
b7c0: 73 74 72 69 6e 67 20 4d 6f 64 75 6c 65 4e 61 6d string ModuleNam
b7d0: 65 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 e.. {..
b7e0: 20 20 20 20 20 20 20 20 20 20 67 65 74 0d 0a 20 get..
b7f0: 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 {..
b800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 43 68 Ch
b810: 65 63 6b 44 69 73 70 6f 73 65 64 28 29 3b 0d 0a eckDisposed();..
b820: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
b830: 20 20 73 74 72 69 6e 67 5b 5d 20 61 72 67 75 6d string[] argum
b840: 65 6e 74 73 20 3d 20 41 72 67 75 6d 65 6e 74 73 ents = Arguments
b850: 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
b860: 20 20 20 20 20 69 66 20 28 28 61 72 67 75 6d 65 if ((argume
b870: 6e 74 73 20 21 3d 20 6e 75 6c 6c 29 20 26 26 0d nts != null) &&.
b880: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
b890: 20 20 20 20 20 28 61 72 67 75 6d 65 6e 74 73 2e (arguments.
b8a0: 4c 65 6e 67 74 68 20 3e 20 4d 6f 64 75 6c 65 4e Length > ModuleN
b8b0: 61 6d 65 49 6e 64 65 78 29 29 0d 0a 20 20 20 20 ameIndex))..
b8c0: 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 {..
b8d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b8e0: 20 20 20 72 65 74 75 72 6e 20 61 72 67 75 6d 65 return argume
b8f0: 6e 74 73 5b 4d 6f 64 75 6c 65 4e 61 6d 65 49 6e nts[ModuleNameIn
b900: 64 65 78 5d 3b 0d 0a 20 20 20 20 20 20 20 20 20 dex];..
b910: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 }..
b920: 20 20 20 20 20 20 20 20 20 20 65 6c 73 65 0d 0a else..
b930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b940: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 {..
b950: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6e 75 return nu
b960: 6c 6c 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ll;..
b970: 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 }..
b980: 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d }.. }
b990: 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
b9a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b9b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b9c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b9d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
b9e0: 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ///.... /
b9f0: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
ba00: 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 /// The na
ba10: 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 me of the databa
ba20: 73 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 se containing th
ba30: 69 73 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 is virtual table
ba40: 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
ba50: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
ba60: 20 20 20 70 75 62 6c 69 63 20 76 69 72 74 75 61 public virtua
ba70: 6c 20 73 74 72 69 6e 67 20 44 61 74 61 62 61 73 l string Databas
ba80: 65 4e 61 6d 65 0d 0a 20 20 20 20 20 20 20 20 7b eName.. {
ba90: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 65 .. ge
baa0: 74 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b t.. {
bab0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
bac0: 20 20 43 68 65 63 6b 44 69 73 70 6f 73 65 64 28 CheckDisposed(
bad0: 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 );....
bae0: 20 20 20 20 20 20 73 74 72 69 6e 67 5b 5d 20 61 string[] a
baf0: 72 67 75 6d 65 6e 74 73 20 3d 20 41 72 67 75 6d rguments = Argum
bb00: 65 6e 74 73 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 ents;....
bb10: 20 20 20 20 20 20 20 20 20 69 66 20 28 28 61 72 if ((ar
bb20: 67 75 6d 65 6e 74 73 20 21 3d 20 6e 75 6c 6c 29 guments != null)
bb30: 20 26 26 0d 0a 20 20 20 20 20 20 20 20 20 20 20 &&..
bb40: 20 20 20 20 20 20 20 20 20 28 61 72 67 75 6d 65 (argume
bb50: 6e 74 73 2e 4c 65 6e 67 74 68 20 3e 20 44 61 74 nts.Length > Dat
bb60: 61 62 61 73 65 4e 61 6d 65 49 6e 64 65 78 29 29 abaseNameIndex))
bb70: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
bb80: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
bb90: 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 return
bba0: 61 72 67 75 6d 65 6e 74 73 5b 44 61 74 61 62 61 arguments[Databa
bbb0: 73 65 4e 61 6d 65 49 6e 64 65 78 5d 3b 0d 0a 20 seNameIndex];..
bbc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d }
bbd0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
bbe0: 20 20 65 6c 73 65 0d 0a 20 20 20 20 20 20 20 20 else..
bbf0: 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
bc00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 r
bc10: 65 74 75 72 6e 20 6e 75 6c 6c 3b 0d 0a 20 20 20 eturn null;..
bc20: 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a }..
bc30: 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 }..
bc40: 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 }....
bc50: 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
bc60: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
bc70: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
bc80: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
bc90: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
bca0: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
bcb0: 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
bcc0: 2f 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 / The name of th
bcd0: 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e e virtual table.
bce0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
bcf0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
bd00: 20 20 70 75 62 6c 69 63 20 76 69 72 74 75 61 6c public virtual
bd10: 20 73 74 72 69 6e 67 20 54 61 62 6c 65 4e 61 6d string TableNam
bd20: 65 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 e.. {..
bd30: 20 20 20 20 20 20 20 20 20 20 67 65 74 0d 0a 20 get..
bd40: 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 {..
bd50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 43 68 Ch
bd60: 65 63 6b 44 69 73 70 6f 73 65 64 28 29 3b 0d 0a eckDisposed();..
bd70: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
bd80: 20 20 73 74 72 69 6e 67 5b 5d 20 61 72 67 75 6d string[] argum
bd90: 65 6e 74 73 20 3d 20 41 72 67 75 6d 65 6e 74 73 ents = Arguments
bda0: 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
bdb0: 20 20 20 20 20 69 66 20 28 28 61 72 67 75 6d 65 if ((argume
bdc0: 6e 74 73 20 21 3d 20 6e 75 6c 6c 29 20 26 26 0d nts != null) &&.
bdd0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
bde0: 20 20 20 20 20 28 61 72 67 75 6d 65 6e 74 73 2e (arguments.
bdf0: 4c 65 6e 67 74 68 20 3e 20 54 61 62 6c 65 4e 61 Length > TableNa
be00: 6d 65 49 6e 64 65 78 29 29 0d 0a 20 20 20 20 20 meIndex))..
be10: 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 {..
be20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
be30: 20 20 72 65 74 75 72 6e 20 61 72 67 75 6d 65 6e return argumen
be40: 74 73 5b 54 61 62 6c 65 4e 61 6d 65 49 6e 64 65 ts[TableNameInde
be50: 78 5d 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 x];..
be60: 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 }..
be70: 20 20 20 20 20 20 20 20 65 6c 73 65 0d 0a 20 20 else..
be80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d {.
be90: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
bea0: 20 20 20 20 20 72 65 74 75 72 6e 20 6e 75 6c 6c return null
beb0: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ;..
bec0: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 }..
bed0: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a }.. }..
bee0: 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 #endregi
bef0: 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f on.... //
bf00: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
bf10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
bf20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
bf30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
bf40: 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
bf50: 20 23 72 65 67 69 6f 6e 20 50 75 62 6c 69 63 20 #region Public
bf60: 4d 65 74 68 6f 64 73 0d 0a 20 20 20 20 20 20 20 Methods..
bf70: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
bf80: 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 74 74 65 /// Atte
bf90: 6d 70 74 73 20 74 6f 20 72 65 63 6f 72 64 20 74 mpts to record t
bfa0: 68 65 20 72 65 6e 61 6d 69 6e 67 20 6f 66 20 74 he renaming of t
bfb0: 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 he virtual table
bfc0: 20 61 73 73 6f 63 69 61 74 65 64 0d 0a 20 20 20 associated..
bfd0: 20 20 20 20 20 2f 2f 2f 20 77 69 74 68 20 74 68 /// with th
bfe0: 69 73 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e is object instan
bff0: 63 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ce... ///
c000: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
c010: 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
c020: 6e 61 6d 65 3d 22 6e 61 6d 65 22 3e 0d 0a 20 20 name="name">..
c030: 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 65 /// The ne
c040: 77 20 6e 61 6d 65 20 66 6f 72 20 74 68 65 20 76 w name for the v
c050: 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 irtual table...
c060: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
c070: 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f am>.. ///
c080: 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 <returns>..
c090: 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 6f /// Non-zero
c0a0: 20 75 70 6f 6e 20 73 75 63 63 65 73 73 2e 0d 0a upon success...
c0b0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 /// </re
c0c0: 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
c0d0: 70 75 62 6c 69 63 20 76 69 72 74 75 61 6c 20 62 public virtual b
c0e0: 6f 6f 6c 20 52 65 6e 61 6d 65 28 0d 0a 20 20 20 ool Rename(..
c0f0: 20 20 20 20 20 20 20 20 20 73 74 72 69 6e 67 20 string
c100: 6e 61 6d 65 0d 0a 20 20 20 20 20 20 20 20 20 20 name..
c110: 20 20 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a ).. {..
c120: 20 20 20 20 20 20 20 20 20 20 20 20 43 68 65 63 Chec
c130: 6b 44 69 73 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a kDisposed();....
c140: 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 if (
c150: 28 61 72 67 75 6d 65 6e 74 73 20 21 3d 20 6e 75 (arguments != nu
c160: 6c 6c 29 20 26 26 0d 0a 20 20 20 20 20 20 20 20 ll) &&..
c170: 20 20 20 20 20 20 20 20 28 61 72 67 75 6d 65 6e (argumen
c180: 74 73 2e 4c 65 6e 67 74 68 20 3e 20 54 61 62 6c ts.Length > Tabl
c190: 65 4e 61 6d 65 49 6e 64 65 78 29 29 0d 0a 20 20 eNameIndex))..
c1a0: 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 {..
c1b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 61 72 67 arg
c1c0: 75 6d 65 6e 74 73 5b 54 61 62 6c 65 4e 61 6d 65 uments[TableName
c1d0: 49 6e 64 65 78 5d 20 3d 20 6e 61 6d 65 3b 0d 0a Index] = name;..
c1e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c1f0: 72 65 74 75 72 6e 20 74 72 75 65 3b 0d 0a 20 20 return true;..
c200: 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 }....
c210: 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
c220: 6e 20 66 61 6c 73 65 3b 0d 0a 20 20 20 20 20 20 n false;..
c230: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 6e }.. #en
c240: 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 dregion....
c250: 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
c260: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c270: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c280: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c290: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
c2a0: 20 20 20 20 20 20 23 72 65 67 69 6f 6e 20 49 53 #region IS
c2b0: 51 4c 69 74 65 4e 61 74 69 76 65 48 61 6e 64 6c QLiteNativeHandl
c2c0: 65 20 4d 65 6d 62 65 72 73 0d 0a 20 20 20 20 20 e Members..
c2d0: 20 20 20 70 72 69 76 61 74 65 20 49 6e 74 50 74 private IntPt
c2e0: 72 20 6e 61 74 69 76 65 48 61 6e 64 6c 65 3b 0d r nativeHandle;.
c2f0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 . /// <su
c300: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
c310: 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68 65 20 /// Returns the
c320: 75 6e 64 65 72 6c 79 69 6e 67 20 53 51 4c 69 74 underlying SQLit
c330: 65 20 6e 61 74 69 76 65 20 68 61 6e 64 6c 65 20 e native handle
c340: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
c350: 74 68 69 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f this.. //
c360: 2f 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 / object instanc
c370: 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
c380: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
c390: 20 20 20 20 70 75 62 6c 69 63 20 76 69 72 74 75 public virtu
c3a0: 61 6c 20 49 6e 74 50 74 72 20 4e 61 74 69 76 65 al IntPtr Native
c3b0: 48 61 6e 64 6c 65 0d 0a 20 20 20 20 20 20 20 20 Handle..
c3c0: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 {.. g
c3d0: 65 74 20 7b 20 43 68 65 63 6b 44 69 73 70 6f 73 et { CheckDispos
c3e0: 65 64 28 29 3b 20 72 65 74 75 72 6e 20 6e 61 74 ed(); return nat
c3f0: 69 76 65 48 61 6e 64 6c 65 3b 20 7d 0d 0a 20 20 iveHandle; }..
c400: 20 20 20 20 20 20 20 20 20 20 69 6e 74 65 72 6e intern
c410: 61 6c 20 73 65 74 20 7b 20 6e 61 74 69 76 65 48 al set { nativeH
c420: 61 6e 64 6c 65 20 3d 20 76 61 6c 75 65 3b 20 7d andle = value; }
c430: 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 .. }..
c440: 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d #endregion.
c450: 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
c460: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c470: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c480: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c490: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c4a0: 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 //.... #r
c4b0: 65 67 69 6f 6e 20 49 44 69 73 70 6f 73 61 62 6c egion IDisposabl
c4c0: 65 20 4d 65 6d 62 65 72 73 0d 0a 20 20 20 20 20 e Members..
c4d0: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
c4e0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 44 69 .. /// Di
c4f0: 73 70 6f 73 65 73 20 6f 66 20 74 68 69 73 20 6f sposes of this o
c500: 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 2e 0d bject instance..
c510: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
c520: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
c530: 20 70 75 62 6c 69 63 20 76 6f 69 64 20 44 69 73 public void Dis
c540: 70 6f 73 65 28 29 0d 0a 20 20 20 20 20 20 20 20 pose()..
c550: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 44 {.. D
c560: 69 73 70 6f 73 65 28 74 72 75 65 29 3b 0d 0a 20 ispose(true);..
c570: 20 20 20 20 20 20 20 20 20 20 20 47 43 2e 53 75 GC.Su
c580: 70 70 72 65 73 73 46 69 6e 61 6c 69 7a 65 28 74 ppressFinalize(t
c590: 68 69 73 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d his);.. }
c5a0: 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 .. #endre
c5b0: 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 gion....
c5c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c5d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c5e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c5f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c600: 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
c610: 20 20 20 23 72 65 67 69 6f 6e 20 49 44 69 73 70 #region IDisp
c620: 6f 73 61 62 6c 65 20 22 50 61 74 74 65 72 6e 22 osable "Pattern"
c630: 20 4d 65 6d 62 65 72 73 0d 0a 20 20 20 20 20 20 Members..
c640: 20 20 70 72 69 76 61 74 65 20 62 6f 6f 6c 20 64 private bool d
c650: 69 73 70 6f 73 65 64 3b 0d 0a 20 20 20 20 20 20 isposed;..
c660: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d /// <summary>.
c670: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 72 . /// Thr
c680: 6f 77 73 20 61 6e 20 3c 73 65 65 20 63 72 65 66 ows an <see cref
c690: 3d 22 4f 62 6a 65 63 74 44 69 73 70 6f 73 65 64 ="ObjectDisposed
c6a0: 45 78 63 65 70 74 69 6f 6e 22 20 2f 3e 20 69 66 Exception" /> if
c6b0: 20 74 68 69 73 20 6f 62 6a 65 63 74 0d 0a 20 20 this object..
c6c0: 20 20 20 20 20 20 2f 2f 2f 20 69 6e 73 74 61 6e /// instan
c6d0: 63 65 20 68 61 73 20 62 65 65 6e 20 64 69 73 70 ce has been disp
c6e0: 6f 73 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f osed... /
c6f0: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
c700: 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 76 private v
c710: 6f 69 64 20 43 68 65 63 6b 44 69 73 70 6f 73 65 oid CheckDispose
c720: 64 28 29 20 2f 2a 20 74 68 72 6f 77 20 2a 2f 0d d() /* throw */.
c730: 0a 20 20 20 20 20 20 20 20 7b 0d 0a 23 69 66 20 . {..#if
c740: 54 48 52 4f 57 5f 4f 4e 5f 44 49 53 50 4f 53 45 THROW_ON_DISPOSE
c750: 44 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 D.. i
c760: 66 20 28 64 69 73 70 6f 73 65 64 29 0d 0a 20 20 f (disposed)..
c770: 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 {..
c780: 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 72 thr
c790: 6f 77 20 6e 65 77 20 4f 62 6a 65 63 74 44 69 73 ow new ObjectDis
c7a0: 70 6f 73 65 64 45 78 63 65 70 74 69 6f 6e 28 0d posedException(.
c7b0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
c7c0: 20 20 20 20 20 74 79 70 65 6f 66 28 53 51 4c 69 typeof(SQLi
c7d0: 74 65 56 69 72 74 75 61 6c 54 61 62 6c 65 29 2e teVirtualTable).
c7e0: 4e 61 6d 65 29 3b 0d 0a 20 20 20 20 20 20 20 20 Name);..
c7f0: 20 20 20 20 7d 0d 0a 23 65 6e 64 69 66 0d 0a 20 }..#endif..
c800: 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 }....
c810: 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
c820: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c830: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c840: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
c850: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
c860: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
c870: 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
c880: 2f 20 44 69 73 70 6f 73 65 73 20 6f 66 20 74 68 / Disposes of th
c890: 69 73 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e is object instan
c8a0: 63 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ce... ///
c8b0: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
c8c0: 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
c8d0: 6e 61 6d 65 3d 22 64 69 73 70 6f 73 69 6e 67 22 name="disposing"
c8e0: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 4e >.. /// N
c8f0: 6f 6e 2d 7a 65 72 6f 20 69 66 20 74 68 69 73 20 on-zero if this
c900: 6d 65 74 68 6f 64 20 69 73 20 62 65 69 6e 67 20 method is being
c910: 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 0d called from the.
c920: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 . /// <se
c930: 65 20 63 72 65 66 3d 22 44 69 73 70 6f 73 65 28 e cref="Dispose(
c940: 29 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 20 20 5a )" /> method. Z
c950: 65 72 6f 20 69 66 20 74 68 69 73 20 6d 65 74 68 ero if this meth
c960: 6f 64 20 69 73 20 62 65 69 6e 67 20 63 61 6c 6c od is being call
c970: 65 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ed.. ///
c980: 66 72 6f 6d 20 74 68 65 20 66 69 6e 61 6c 69 7a from the finaliz
c990: 65 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f er... ///
c9a0: 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
c9b0: 20 20 20 70 72 6f 74 65 63 74 65 64 20 76 69 72 protected vir
c9c0: 74 75 61 6c 20 76 6f 69 64 20 44 69 73 70 6f 73 tual void Dispos
c9d0: 65 28 62 6f 6f 6c 20 64 69 73 70 6f 73 69 6e 67 e(bool disposing
c9e0: 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 ).. {..
c9f0: 20 20 20 20 20 20 20 20 20 20 69 66 20 28 21 64 if (!d
ca00: 69 73 70 6f 73 65 64 29 0d 0a 20 20 20 20 20 20 isposed)..
ca10: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
ca20: 20 20 20 20 20 20 20 20 20 2f 2f 69 66 20 28 64 //if (d
ca30: 69 73 70 6f 73 69 6e 67 29 0d 0a 20 20 20 20 20 isposing)..
ca40: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 7b 0d 0a //{..
ca50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ca60: 2f 2f 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f // //////////
ca70: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
ca80: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 20 20 20 20 //////////..
ca90: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 20 //
caa0: 20 20 2f 2f 20 64 69 73 70 6f 73 65 20 6d 61 6e // dispose man
cab0: 61 67 65 64 20 72 65 73 6f 75 72 63 65 73 20 68 aged resources h
cac0: 65 72 65 2e 2e 2e 0d 0a 20 20 20 20 20 20 20 20 ere.....
cad0: 20 20 20 20 20 20 20 20 2f 2f 20 20 20 20 2f 2f // //
cae0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
caf0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cb00: 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 //..
cb10: 20 20 20 20 2f 2f 7d 0d 0a 0d 0a 20 20 20 20 20 //}....
cb20: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f /////
cb30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cb40: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cb50: 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 /..
cb60: 20 20 20 2f 2f 20 72 65 6c 65 61 73 65 20 75 6e // release un
cb70: 6d 61 6e 61 67 65 64 20 72 65 73 6f 75 72 63 65 managed resource
cb80: 73 20 68 65 72 65 2e 2e 2e 0d 0a 20 20 20 20 20 s here.....
cb90: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f /////
cba0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cbb0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cbc0: 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 /....
cbd0: 20 20 20 20 20 64 69 73 70 6f 73 65 64 20 3d 20 disposed =
cbe0: 74 72 75 65 3b 0d 0a 20 20 20 20 20 20 20 20 20 true;..
cbf0: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d }.. }.
cc00: 0a 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 . #endreg
cc10: 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ion.... /
cc20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cc30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cc40: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cc50: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cc60: 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
cc70: 20 20 23 72 65 67 69 6f 6e 20 44 65 73 74 72 75 #region Destru
cc80: 63 74 6f 72 0d 0a 20 20 20 20 20 20 20 20 2f 2f ctor.. //
cc90: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
cca0: 20 20 20 20 20 2f 2f 2f 20 46 69 6e 61 6c 69 7a /// Finaliz
ccb0: 65 73 20 74 68 69 73 20 6f 62 6a 65 63 74 20 69 es this object i
ccc0: 6e 73 74 61 6e 63 65 2e 0d 0a 20 20 20 20 20 20 nstance...
ccd0: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
cce0: 0d 0a 20 20 20 20 20 20 20 20 7e 53 51 4c 69 74 .. ~SQLit
ccf0: 65 56 69 72 74 75 61 6c 54 61 62 6c 65 28 29 0d eVirtualTable().
cd00: 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 . {..
cd10: 20 20 20 20 20 20 20 20 44 69 73 70 6f 73 65 28 Dispose(
cd20: 66 61 6c 73 65 29 3b 0d 0a 20 20 20 20 20 20 20 false);..
cd30: 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 }.. #end
cd40: 72 65 67 69 6f 6e 0d 0a 20 20 20 20 7d 0d 0a 20 region.. }..
cd50: 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d #endregion...
cd60: 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f . ///////////
cd70: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cd80: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cd90: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cda0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
cdb0: 0d 0a 0d 0a 20 20 20 20 23 72 65 67 69 6f 6e 20 .... #region
cdc0: 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 SQLiteVirtualTab
cdd0: 6c 65 43 75 72 73 6f 72 20 42 61 73 65 20 43 6c leCursor Base Cl
cde0: 61 73 73 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 ass.. /// <su
cdf0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 mmary>.. ///
ce00: 54 68 69 73 20 63 6c 61 73 73 20 72 65 70 72 65 This class repre
ce10: 73 65 6e 74 73 20 61 20 6d 61 6e 61 67 65 64 20 sents a managed
ce20: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 63 75 virtual table cu
ce30: 72 73 6f 72 20 69 6d 70 6c 65 6d 65 6e 74 61 74 rsor implementat
ce40: 69 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 49 74 ion... /// It
ce50: 20 69 73 20 6e 6f 74 20 73 65 61 6c 65 64 20 61 is not sealed a
ce60: 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 nd should be use
ce70: 64 20 61 73 20 74 68 65 20 62 61 73 65 20 63 6c d as the base cl
ce80: 61 73 73 20 66 6f 72 20 61 6e 79 0d 0a 20 20 20 ass for any..
ce90: 20 2f 2f 2f 20 75 73 65 72 2d 64 65 66 69 6e 65 /// user-define
cea0: 64 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 d virtual table
ceb0: 63 75 72 73 6f 72 20 63 6c 61 73 73 65 73 20 69 cursor classes i
cec0: 6d 70 6c 65 6d 65 6e 74 65 64 20 69 6e 20 6d 61 mplemented in ma
ced0: 6e 61 67 65 64 20 63 6f 64 65 2e 0d 0a 20 20 20 naged code...
cee0: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
cef0: 0a 20 20 20 20 70 75 62 6c 69 63 20 63 6c 61 73 . public clas
cf00: 73 20 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 s SQLiteVirtualT
cf10: 61 62 6c 65 43 75 72 73 6f 72 20 3a 0d 0a 20 20 ableCursor :..
cf20: 20 20 20 20 20 20 20 20 20 20 49 53 51 4c 69 74 ISQLit
cf30: 65 4e 61 74 69 76 65 48 61 6e 64 6c 65 2c 20 49 eNativeHandle, I
cf40: 44 69 73 70 6f 73 61 62 6c 65 20 2f 2a 20 4e 4f Disposable /* NO
cf50: 54 20 53 45 41 4c 45 44 20 2a 2f 0d 0a 20 20 20 T SEALED */..
cf60: 20 7b 0d 0a 20 20 20 20 20 20 20 20 23 72 65 67 {.. #reg
cf70: 69 6f 6e 20 50 75 62 6c 69 63 20 43 6f 6e 73 74 ion Public Const
cf80: 72 75 63 74 6f 72 73 0d 0a 20 20 20 20 20 20 20 ructors..
cf90: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
cfa0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 43 6f 6e 73 /// Cons
cfb0: 74 72 75 63 74 73 20 61 6e 20 69 6e 73 74 61 6e tructs an instan
cfc0: 63 65 20 6f 66 20 74 68 69 73 20 63 6c 61 73 73 ce of this class
cfd0: 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
cfe0: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
cff0: 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
d000: 6d 65 3d 22 74 61 62 6c 65 22 3e 0d 0a 20 20 20 me="table">..
d010: 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 /// The <se
d020: 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65 56 69 e cref="SQLiteVi
d030: 72 74 75 61 6c 54 61 62 6c 65 22 20 2f 3e 20 6f rtualTable" /> o
d040: 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 61 bject instance a
d050: 73 73 6f 63 69 61 74 65 64 0d 0a 20 20 20 20 20 ssociated..
d060: 20 20 20 2f 2f 2f 20 77 69 74 68 20 74 68 69 73 /// with this
d070: 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 object instance
d080: 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
d090: 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 /param>..
d0a0: 20 70 75 62 6c 69 63 20 53 51 4c 69 74 65 56 69 public SQLiteVi
d0b0: 72 74 75 61 6c 54 61 62 6c 65 43 75 72 73 6f 72 rtualTableCursor
d0c0: 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 (.. S
d0d0: 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c QLiteVirtualTabl
d0e0: 65 20 74 61 62 6c 65 0d 0a 20 20 20 20 20 20 20 e table..
d0f0: 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 )..
d100: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 {.. t
d110: 68 69 73 2e 74 61 62 6c 65 20 3d 20 74 61 62 6c his.table = tabl
d120: 65 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 e;.. }..
d130: 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f #endregio
d140: 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f n.... ///
d150: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d160: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d170: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d180: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d190: 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ////....
d1a0: 23 72 65 67 69 6f 6e 20 50 75 62 6c 69 63 20 50 #region Public P
d1b0: 72 6f 70 65 72 74 69 65 73 0d 0a 20 20 20 20 20 roperties..
d1c0: 20 20 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 private SQLit
d1d0: 65 56 69 72 74 75 61 6c 54 61 62 6c 65 20 74 61 eVirtualTable ta
d1e0: 62 6c 65 3b 0d 0a 20 20 20 20 20 20 20 20 2f 2f ble;.. //
d1f0: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
d200: 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 /// The <se
d210: 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65 56 69 e cref="SQLiteVi
d220: 72 74 75 61 6c 54 61 62 6c 65 22 20 2f 3e 20 6f rtualTable" /> o
d230: 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 61 bject instance a
d240: 73 73 6f 63 69 61 74 65 64 0d 0a 20 20 20 20 20 ssociated..
d250: 20 20 20 2f 2f 2f 20 77 69 74 68 20 74 68 69 73 /// with this
d260: 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 object instance
d270: 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
d280: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
d290: 20 20 20 70 75 62 6c 69 63 20 76 69 72 74 75 61 public virtua
d2a0: 6c 20 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 l SQLiteVirtualT
d2b0: 61 62 6c 65 20 54 61 62 6c 65 0d 0a 20 20 20 20 able Table..
d2c0: 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 {..
d2d0: 20 20 20 67 65 74 20 7b 20 43 68 65 63 6b 44 69 get { CheckDi
d2e0: 73 70 6f 73 65 64 28 29 3b 20 72 65 74 75 72 6e sposed(); return
d2f0: 20 74 61 62 6c 65 3b 20 7d 0d 0a 20 20 20 20 20 table; }..
d300: 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 }....
d310: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d320: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d330: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d340: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d350: 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
d360: 20 20 20 70 72 69 76 61 74 65 20 69 6e 74 20 69 private int i
d370: 6e 64 65 78 4e 75 6d 62 65 72 3b 0d 0a 20 20 20 ndexNumber;..
d380: 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
d390: 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
d3a0: 4e 75 6d 62 65 72 20 75 73 65 64 20 74 6f 20 68 Number used to h
d3b0: 65 6c 70 20 69 64 65 6e 74 69 66 79 20 74 68 65 elp identify the
d3c0: 20 73 65 6c 65 63 74 65 64 20 69 6e 64 65 78 2e selected index.
d3d0: 20 20 54 68 69 73 20 76 61 6c 75 65 20 77 69 6c This value wil
d3e0: 6c 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 62 l.. /// b
d3f0: 65 20 73 65 74 20 76 69 61 20 74 68 65 20 3c 73 e set via the <s
d400: 65 65 20 63 72 65 66 3d 22 46 69 6c 74 65 72 22 ee cref="Filter"
d410: 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 /> method...
d420: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
d430: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 ry>.. pub
d440: 6c 69 63 20 76 69 72 74 75 61 6c 20 69 6e 74 20 lic virtual int
d450: 49 6e 64 65 78 4e 75 6d 62 65 72 0d 0a 20 20 20 IndexNumber..
d460: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
d470: 20 20 20 20 67 65 74 20 7b 20 43 68 65 63 6b 44 get { CheckD
d480: 69 73 70 6f 73 65 64 28 29 3b 20 72 65 74 75 72 isposed(); retur
d490: 6e 20 69 6e 64 65 78 4e 75 6d 62 65 72 3b 20 7d n indexNumber; }
d4a0: 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 .. }....
d4b0: 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
d4c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d4d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d4e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d4f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a //////////////..
d500: 0d 0a 20 20 20 20 20 20 20 20 70 72 69 76 61 74 .. privat
d510: 65 20 73 74 72 69 6e 67 20 69 6e 64 65 78 53 74 e string indexSt
d520: 72 69 6e 67 3b 0d 0a 20 20 20 20 20 20 20 20 2f ring;.. /
d530: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
d540: 20 20 20 20 20 20 2f 2f 2f 20 53 74 72 69 6e 67 /// String
d550: 20 75 73 65 64 20 74 6f 20 68 65 6c 70 20 69 64 used to help id
d560: 65 6e 74 69 66 79 20 74 68 65 20 73 65 6c 65 63 entify the selec
d570: 74 65 64 20 69 6e 64 65 78 2e 20 20 54 68 69 73 ted index. This
d580: 20 76 61 6c 75 65 20 77 69 6c 6c 0d 0a 20 20 20 value will..
d590: 20 20 20 20 20 2f 2f 2f 20 62 65 20 73 65 74 20 /// be set
d5a0: 76 69 61 20 74 68 65 20 3c 73 65 65 20 63 72 65 via the <see cre
d5b0: 66 3d 22 46 69 6c 74 65 72 22 20 2f 3e 20 6d 65 f="Filter" /> me
d5c0: 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f thod... /
d5d0: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
d5e0: 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 76 69 public vi
d5f0: 72 74 75 61 6c 20 73 74 72 69 6e 67 20 49 6e 64 rtual string Ind
d600: 65 78 53 74 72 69 6e 67 0d 0a 20 20 20 20 20 20 exString..
d610: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
d620: 20 67 65 74 20 7b 20 43 68 65 63 6b 44 69 73 70 get { CheckDisp
d630: 6f 73 65 64 28 29 3b 20 72 65 74 75 72 6e 20 69 osed(); return i
d640: 6e 64 65 78 53 74 72 69 6e 67 3b 20 7d 0d 0a 20 ndexString; }..
d650: 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 }....
d660: 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
d670: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d680: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d690: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d6a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
d6b0: 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 53 private S
d6c0: 51 4c 69 74 65 56 61 6c 75 65 5b 5d 20 76 61 6c QLiteValue[] val
d6d0: 75 65 73 3b 0d 0a 20 20 20 20 20 20 20 20 2f 2f ues;.. //
d6e0: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
d6f0: 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 76 61 6c /// The val
d700: 75 65 73 20 75 73 65 64 20 74 6f 20 66 69 6c 74 ues used to filt
d710: 65 72 20 74 68 65 20 72 6f 77 73 20 72 65 74 75 er the rows retu
d720: 72 6e 65 64 20 76 69 61 20 74 68 69 73 20 63 75 rned via this cu
d730: 72 73 6f 72 20 6f 62 6a 65 63 74 0d 0a 20 20 20 rsor object..
d740: 20 20 20 20 20 2f 2f 2f 20 69 6e 73 74 61 6e 63 /// instanc
d750: 65 2e 20 20 54 68 69 73 20 76 61 6c 75 65 20 77 e. This value w
d760: 69 6c 6c 20 62 65 20 73 65 74 20 76 69 61 20 74 ill be set via t
d770: 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 46 69 he <see cref="Fi
d780: 6c 74 65 72 22 20 2f 3e 0d 0a 20 20 20 20 20 20 lter" />..
d790: 20 20 2f 2f 2f 20 6d 65 74 68 6f 64 2e 0d 0a 20 /// method...
d7a0: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
d7b0: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 mary>.. p
d7c0: 75 62 6c 69 63 20 76 69 72 74 75 61 6c 20 53 51 ublic virtual SQ
d7d0: 4c 69 74 65 56 61 6c 75 65 5b 5d 20 56 61 6c 75 LiteValue[] Valu
d7e0: 65 73 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 es.. {..
d7f0: 20 20 20 20 20 20 20 20 20 20 20 67 65 74 20 7b get {
d800: 20 43 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 CheckDisposed()
d810: 3b 20 72 65 74 75 72 6e 20 76 61 6c 75 65 73 3b ; return values;
d820: 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 }.. }..
d830: 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f #endregio
d840: 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f n.... ///
d850: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d860: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d870: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d880: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
d890: 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ////....
d8a0: 23 72 65 67 69 6f 6e 20 50 72 6f 74 65 63 74 65 #region Protecte
d8b0: 64 20 4d 65 74 68 6f 64 73 0d 0a 20 20 20 20 20 d Methods..
d8c0: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
d8d0: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 74 .. /// At
d8e0: 74 65 6d 70 74 73 20 74 6f 20 70 65 72 73 69 73 tempts to persis
d8f0: 74 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 t the specified
d900: 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 <see cref="SQLit
d910: 65 56 61 6c 75 65 22 20 2f 3e 20 6f 62 6a 65 63 eValue" /> objec
d920: 74 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 t.. /// i
d930: 6e 73 74 61 6e 63 65 73 20 69 6e 20 6f 72 64 65 nstances in orde
d940: 72 20 74 6f 20 6d 61 6b 65 20 74 68 65 6d 20 61 r to make them a
d950: 76 61 69 6c 61 62 6c 65 20 61 66 74 65 72 20 74 vailable after t
d960: 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 he.. ///
d970: 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 <see cref="ISQLi
d980: 74 65 4d 61 6e 61 67 65 64 4d 6f 64 75 6c 65 2e teManagedModule.
d990: 46 69 6c 74 65 72 22 20 2f 3e 20 6d 65 74 68 6f Filter" /> metho
d9a0: 64 20 72 65 74 75 72 6e 73 2e 0d 0a 20 20 20 20 d returns...
d9b0: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
d9c0: 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
d9d0: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 76 61 6c <param name="val
d9e0: 75 65 73 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f ues">.. /
d9f0: 2f 2f 20 54 68 65 20 61 72 72 61 79 20 6f 66 20 // The array of
da00: 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 <see cref="SQLit
da10: 65 56 61 6c 75 65 22 20 2f 3e 20 6f 62 6a 65 63 eValue" /> objec
da20: 74 20 69 6e 73 74 61 6e 63 65 73 20 74 6f 20 62 t instances to b
da30: 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 70 e.. /// p
da40: 65 72 73 69 73 74 65 64 2e 0d 0a 20 20 20 20 20 ersisted...
da50: 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
da60: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 . /// <re
da70: 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
da80: 2f 2f 2f 20 54 68 65 20 6e 75 6d 62 65 72 20 6f /// The number o
da90: 66 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c f <see cref="SQL
daa0: 69 74 65 56 61 6c 75 65 22 20 2f 3e 20 6f 62 6a iteValue" /> obj
dab0: 65 63 74 20 69 6e 73 74 61 6e 63 65 73 20 74 68 ect instances th
dac0: 61 74 20 77 65 72 65 0d 0a 20 20 20 20 20 20 20 at were..
dad0: 20 2f 2f 2f 20 73 75 63 63 65 73 73 66 75 6c 6c /// successfull
dae0: 79 20 70 65 72 73 69 73 74 65 64 2e 0d 0a 20 20 y persisted...
daf0: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 /// </retu
db00: 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 70 72 rns>.. pr
db10: 6f 74 65 63 74 65 64 20 76 69 72 74 75 61 6c 20 otected virtual
db20: 69 6e 74 20 54 72 79 50 65 72 73 69 73 74 56 61 int TryPersistVa
db30: 6c 75 65 73 28 0d 0a 20 20 20 20 20 20 20 20 20 lues(..
db40: 20 20 20 53 51 4c 69 74 65 56 61 6c 75 65 5b 5d SQLiteValue[]
db50: 20 76 61 6c 75 65 73 0d 0a 20 20 20 20 20 20 20 values..
db60: 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 )..
db70: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 {.. i
db80: 6e 74 20 72 65 73 75 6c 74 20 3d 20 30 3b 0d 0a nt result = 0;..
db90: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 .. if
dba0: 20 28 76 61 6c 75 65 73 20 21 3d 20 6e 75 6c 6c (values != null
dbb0: 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b ).. {
dbc0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
dbd0: 20 20 66 6f 72 65 61 63 68 20 28 53 51 4c 69 74 foreach (SQLit
dbe0: 65 56 61 6c 75 65 20 76 61 6c 75 65 20 69 6e 20 eValue value in
dbf0: 76 61 6c 75 65 73 29 0d 0a 20 20 20 20 20 20 20 values)..
dc00: 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
dc10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dc20: 69 66 20 28 76 61 6c 75 65 20 3d 3d 20 6e 75 6c if (value == nul
dc30: 6c 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 l)..
dc40: 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e 74 cont
dc50: 69 6e 75 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 inue;....
dc60: 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 if
dc70: 28 76 61 6c 75 65 2e 50 65 72 73 69 73 74 28 29 (value.Persist()
dc80: 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 )..
dc90: 20 20 20 20 20 20 20 20 20 20 20 72 65 73 75 6c resul
dca0: 74 2b 2b 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 t++;..
dcb0: 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 }..
dcc0: 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 }....
dcd0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 65 73 return res
dce0: 75 6c 74 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d ult;.. }.
dcf0: 0a 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 . #endreg
dd00: 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ion.... /
dd10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
dd20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
dd30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
dd40: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
dd50: 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
dd60: 20 20 23 72 65 67 69 6f 6e 20 50 75 62 6c 69 63 #region Public
dd70: 20 4d 65 74 68 6f 64 73 0d 0a 20 20 20 20 20 20 Methods..
dd80: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d /// <summary>.
dd90: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 . /// Thi
dda0: 73 20 6d 65 74 68 6f 64 20 73 68 6f 75 6c 64 20 s method should
ddb0: 6e 6f 72 6d 61 6c 6c 79 20 62 65 20 75 73 65 64 normally be used
ddc0: 20 62 79 20 74 68 65 0d 0a 20 20 20 20 20 20 20 by the..
ddd0: 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 /// <see cref="
dde0: 49 53 51 4c 69 74 65 4d 61 6e 61 67 65 64 4d 6f ISQLiteManagedMo
ddf0: 64 75 6c 65 2e 46 69 6c 74 65 72 22 20 2f 3e 20 dule.Filter" />
de00: 6d 65 74 68 6f 64 20 69 6e 20 6f 72 64 65 72 20 method in order
de10: 74 6f 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 to.. ///
de20: 70 65 72 66 6f 72 6d 20 66 69 6c 74 65 72 69 6e perform filterin
de30: 67 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 g of the result
de40: 72 6f 77 73 20 61 6e 64 2f 6f 72 20 74 6f 20 72 rows and/or to r
de50: 65 63 6f 72 64 20 74 68 65 20 66 69 6c 74 65 72 ecord the filter
de60: 69 6e 67 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ing.. ///
de70: 20 63 72 69 74 65 72 69 61 20 70 72 6f 76 69 64 criteria provid
de80: 65 64 20 62 79 20 74 68 65 20 53 51 4c 69 74 65 ed by the SQLite
de90: 20 63 6f 72 65 20 6c 69 62 72 61 72 79 2e 0d 0a core library...
dea0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
deb0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
dec0: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
ded0: 22 69 6e 64 65 78 4e 75 6d 62 65 72 22 3e 0d 0a "indexNumber">..
dee0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 4e 75 6d 62 /// Numb
def0: 65 72 20 75 73 65 64 20 74 6f 20 68 65 6c 70 20 er used to help
df00: 69 64 65 6e 74 69 66 79 20 74 68 65 20 73 65 6c identify the sel
df10: 65 63 74 65 64 20 69 6e 64 65 78 2e 0d 0a 20 20 ected index...
df20: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
df30: 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
df40: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 69 6e 64 <param name="ind
df50: 65 78 53 74 72 69 6e 67 22 3e 0d 0a 20 20 20 20 exString">..
df60: 20 20 20 20 2f 2f 2f 20 53 74 72 69 6e 67 20 75 /// String u
df70: 73 65 64 20 74 6f 20 68 65 6c 70 20 69 64 65 6e sed to help iden
df80: 74 69 66 79 20 74 68 65 20 73 65 6c 65 63 74 65 tify the selecte
df90: 64 20 69 6e 64 65 78 2e 0d 0a 20 20 20 20 20 20 d index...
dfa0: 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
dfb0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
dfc0: 61 6d 20 6e 61 6d 65 3d 22 76 61 6c 75 65 73 22 am name="values"
dfd0: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
dfe0: 68 65 20 76 61 6c 75 65 73 20 63 6f 72 72 65 73 he values corres
dff0: 70 6f 6e 64 69 6e 67 20 74 6f 20 65 61 63 68 20 ponding to each
e000: 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 20 73 65 column in the se
e010: 6c 65 63 74 65 64 20 69 6e 64 65 78 2e 0d 0a 20 lected index...
e020: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
e030: 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 am>.. pub
e040: 6c 69 63 20 76 69 72 74 75 61 6c 20 76 6f 69 64 lic virtual void
e050: 20 46 69 6c 74 65 72 28 0d 0a 20 20 20 20 20 20 Filter(..
e060: 20 20 20 20 20 20 69 6e 74 20 69 6e 64 65 78 4e int indexN
e070: 75 6d 62 65 72 2c 0d 0a 20 20 20 20 20 20 20 20 umber,..
e080: 20 20 20 20 73 74 72 69 6e 67 20 69 6e 64 65 78 string index
e090: 53 74 72 69 6e 67 2c 0d 0a 20 20 20 20 20 20 20 String,..
e0a0: 20 20 20 20 20 53 51 4c 69 74 65 56 61 6c 75 65 SQLiteValue
e0b0: 5b 5d 20 76 61 6c 75 65 73 0d 0a 20 20 20 20 20 [] values..
e0c0: 20 20 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 )..
e0d0: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
e0e0: 20 43 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 CheckDisposed()
e0f0: 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
e100: 20 69 66 20 28 28 76 61 6c 75 65 73 20 21 3d 20 if ((values !=
e110: 6e 75 6c 6c 29 20 26 26 0d 0a 20 20 20 20 20 20 null) &&..
e120: 20 20 20 20 20 20 20 20 20 20 28 54 72 79 50 65 (TryPe
e130: 72 73 69 73 74 56 61 6c 75 65 73 28 76 61 6c 75 rsistValues(valu
e140: 65 73 29 20 21 3d 20 76 61 6c 75 65 73 2e 4c 65 es) != values.Le
e150: 6e 67 74 68 29 29 0d 0a 20 20 20 20 20 20 20 20 ngth))..
e160: 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 {..
e170: 20 20 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77 throw new
e180: 20 53 51 4c 69 74 65 45 78 63 65 70 74 69 6f 6e SQLiteException
e190: 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 (..
e1a0: 20 20 20 20 20 20 20 22 66 61 69 6c 65 64 20 74 "failed t
e1b0: 6f 20 70 65 72 73 69 73 74 20 6f 6e 65 20 6f 72 o persist one or
e1c0: 20 6d 6f 72 65 20 76 61 6c 75 65 73 22 29 3b 0d more values");.
e1d0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a . }..
e1e0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 68 .. th
e1f0: 69 73 2e 69 6e 64 65 78 4e 75 6d 62 65 72 20 3d is.indexNumber =
e200: 20 69 6e 64 65 78 4e 75 6d 62 65 72 3b 0d 0a 20 indexNumber;..
e210: 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 2e this.
e220: 69 6e 64 65 78 53 74 72 69 6e 67 20 3d 20 69 6e indexString = in
e230: 64 65 78 53 74 72 69 6e 67 3b 0d 0a 20 20 20 20 dexString;..
e240: 20 20 20 20 20 20 20 20 74 68 69 73 2e 76 61 6c this.val
e250: 75 65 73 20 3d 20 76 61 6c 75 65 73 3b 0d 0a 20 ues = values;..
e260: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 }..
e270: 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a #endregion....
e280: 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f ////////
e290: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e2a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e2b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e2c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
e2d0: 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 67 69 ... #regi
e2e0: 6f 6e 20 49 53 51 4c 69 74 65 4e 61 74 69 76 65 on ISQLiteNative
e2f0: 48 61 6e 64 6c 65 20 4d 65 6d 62 65 72 73 0d 0a Handle Members..
e300: 20 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 private
e310: 49 6e 74 50 74 72 20 6e 61 74 69 76 65 48 61 6e IntPtr nativeHan
e320: 64 6c 65 3b 0d 0a 20 20 20 20 20 20 20 20 2f 2f dle;.. //
e330: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
e340: 20 20 20 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 /// Returns
e350: 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 the underlying
e360: 53 51 4c 69 74 65 20 6e 61 74 69 76 65 20 68 61 SQLite native ha
e370: 6e 64 6c 65 20 61 73 73 6f 63 69 61 74 65 64 20 ndle associated
e380: 77 69 74 68 20 74 68 69 73 0d 0a 20 20 20 20 20 with this..
e390: 20 20 20 2f 2f 2f 20 6f 62 6a 65 63 74 20 69 6e /// object in
e3a0: 73 74 61 6e 63 65 2e 0d 0a 20 20 20 20 20 20 20 stance...
e3b0: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
e3c0: 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 . public
e3d0: 76 69 72 74 75 61 6c 20 49 6e 74 50 74 72 20 4e virtual IntPtr N
e3e0: 61 74 69 76 65 48 61 6e 64 6c 65 0d 0a 20 20 20 ativeHandle..
e3f0: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
e400: 20 20 20 20 67 65 74 20 7b 20 43 68 65 63 6b 44 get { CheckD
e410: 69 73 70 6f 73 65 64 28 29 3b 20 72 65 74 75 72 isposed(); retur
e420: 6e 20 6e 61 74 69 76 65 48 61 6e 64 6c 65 3b 20 n nativeHandle;
e430: 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 }.. i
e440: 6e 74 65 72 6e 61 6c 20 73 65 74 20 7b 20 6e 61 nternal set { na
e450: 74 69 76 65 48 61 6e 64 6c 65 20 3d 20 76 61 6c tiveHandle = val
e460: 75 65 3b 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d ue; }.. }
e470: 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 .. #endre
e480: 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 gion....
e490: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e4a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e4b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e4c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e4d0: 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
e4e0: 20 20 20 23 72 65 67 69 6f 6e 20 49 44 69 73 70 #region IDisp
e4f0: 6f 73 61 62 6c 65 20 4d 65 6d 62 65 72 73 0d 0a osable Members..
e500: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
e510: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
e520: 2f 2f 20 44 69 73 70 6f 73 65 73 20 6f 66 20 74 // Disposes of t
e530: 68 69 73 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 his object insta
e540: 6e 63 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f nce... //
e550: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 / </summary>..
e560: 20 20 20 20 20 20 70 75 62 6c 69 63 20 76 6f 69 public voi
e570: 64 20 44 69 73 70 6f 73 65 28 29 0d 0a 20 20 20 d Dispose()..
e580: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
e590: 20 20 20 20 44 69 73 70 6f 73 65 28 74 72 75 65 Dispose(true
e5a0: 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 );..
e5b0: 47 43 2e 53 75 70 70 72 65 73 73 46 69 6e 61 6c GC.SuppressFinal
e5c0: 69 7a 65 28 74 68 69 73 29 3b 0d 0a 20 20 20 20 ize(this);..
e5d0: 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 }.. #
e5e0: 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 endregion....
e5f0: 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
e600: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e610: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e620: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e630: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
e640: 20 20 20 20 20 20 20 20 23 72 65 67 69 6f 6e 20 #region
e650: 49 44 69 73 70 6f 73 61 62 6c 65 20 22 50 61 74 IDisposable "Pat
e660: 74 65 72 6e 22 20 4d 65 6d 62 65 72 73 0d 0a 20 tern" Members..
e670: 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 62 private b
e680: 6f 6f 6c 20 64 69 73 70 6f 73 65 64 3b 0d 0a 20 ool disposed;..
e690: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
e6a0: 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
e6b0: 2f 20 54 68 72 6f 77 73 20 61 6e 20 3c 73 65 65 / Throws an <see
e6c0: 20 63 72 65 66 3d 22 4f 62 6a 65 63 74 44 69 73 cref="ObjectDis
e6d0: 70 6f 73 65 64 45 78 63 65 70 74 69 6f 6e 22 20 posedException"
e6e0: 2f 3e 20 69 66 20 74 68 69 73 20 6f 62 6a 65 63 /> if this objec
e6f0: 74 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 t.. /// i
e700: 6e 73 74 61 6e 63 65 20 68 61 73 20 62 65 65 6e nstance has been
e710: 20 64 69 73 70 6f 73 65 64 2e 0d 0a 20 20 20 20 disposed...
e720: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
e730: 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 72 69 76 y>.. priv
e740: 61 74 65 20 76 6f 69 64 20 43 68 65 63 6b 44 69 ate void CheckDi
e750: 73 70 6f 73 65 64 28 29 20 2f 2a 20 74 68 72 6f sposed() /* thro
e760: 77 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 7b 0d w */.. {.
e770: 0a 23 69 66 20 54 48 52 4f 57 5f 4f 4e 5f 44 49 .#if THROW_ON_DI
e780: 53 50 4f 53 45 44 0d 0a 20 20 20 20 20 20 20 20 SPOSED..
e790: 20 20 20 20 69 66 20 28 64 69 73 70 6f 73 65 64 if (disposed
e7a0: 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b ).. {
e7b0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
e7c0: 20 20 74 68 72 6f 77 20 6e 65 77 20 4f 62 6a 65 throw new Obje
e7d0: 63 74 44 69 73 70 6f 73 65 64 45 78 63 65 70 74 ctDisposedExcept
e7e0: 69 6f 6e 28 0d 0a 20 20 20 20 20 20 20 20 20 20 ion(..
e7f0: 20 20 20 20 20 20 20 20 20 20 74 79 70 65 6f 66 typeof
e800: 28 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 (SQLiteVirtualTa
e810: 62 6c 65 43 75 72 73 6f 72 29 2e 4e 61 6d 65 29 bleCursor).Name)
e820: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d ;.. }
e830: 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 20 ..#endif..
e840: 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f }.... /
e850: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e860: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e870: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e880: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
e890: 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
e8a0: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d /// <summary>.
e8b0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 44 69 73 . /// Dis
e8c0: 70 6f 73 65 73 20 6f 66 20 74 68 69 73 20 6f 62 poses of this ob
e8d0: 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 2e 0d 0a ject instance...
e8e0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
e8f0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
e900: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
e910: 22 64 69 73 70 6f 73 69 6e 67 22 3e 0d 0a 20 20 "disposing">..
e920: 20 20 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 /// Non-ze
e930: 72 6f 20 69 66 20 74 68 69 73 20 6d 65 74 68 6f ro if this metho
e940: 64 20 69 73 20 62 65 69 6e 67 20 63 61 6c 6c 65 d is being calle
e950: 64 20 66 72 6f 6d 20 74 68 65 0d 0a 20 20 20 20 d from the..
e960: 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 /// <see cre
e970: 66 3d 22 44 69 73 70 6f 73 65 28 29 22 20 2f 3e f="Dispose()" />
e980: 20 6d 65 74 68 6f 64 2e 20 20 5a 65 72 6f 20 69 method. Zero i
e990: 66 20 74 68 69 73 20 6d 65 74 68 6f 64 20 69 73 f this method is
e9a0: 20 62 65 69 6e 67 20 63 61 6c 6c 65 64 0d 0a 20 being called..
e9b0: 20 20 20 20 20 20 20 2f 2f 2f 20 66 72 6f 6d 20 /// from
e9c0: 74 68 65 20 66 69 6e 61 6c 69 7a 65 72 2e 0d 0a the finalizer...
e9d0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
e9e0: 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 70 72 ram>.. pr
e9f0: 6f 74 65 63 74 65 64 20 76 69 72 74 75 61 6c 20 otected virtual
ea00: 76 6f 69 64 20 44 69 73 70 6f 73 65 28 62 6f 6f void Dispose(boo
ea10: 6c 20 64 69 73 70 6f 73 69 6e 67 29 0d 0a 20 20 l disposing)..
ea20: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
ea30: 20 20 20 20 20 69 66 20 28 21 64 69 73 70 6f 73 if (!dispos
ea40: 65 64 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ed)..
ea50: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 {..
ea60: 20 20 20 20 2f 2f 69 66 20 28 64 69 73 70 6f 73 //if (dispos
ea70: 69 6e 67 29 0d 0a 20 20 20 20 20 20 20 20 20 20 ing)..
ea80: 20 20 20 20 20 20 2f 2f 7b 0d 0a 20 20 20 20 20 //{..
ea90: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 20 20 //
eaa0: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
eab0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
eac0: 2f 2f 2f 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20 /////..
ead0: 20 20 20 20 20 20 20 2f 2f 20 20 20 20 2f 2f 20 // //
eae0: 64 69 73 70 6f 73 65 20 6d 61 6e 61 67 65 64 20 dispose managed
eaf0: 72 65 73 6f 75 72 63 65 73 20 68 65 72 65 2e 2e resources here..
eb00: 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
eb10: 20 20 20 2f 2f 20 20 20 20 2f 2f 2f 2f 2f 2f 2f // ///////
eb20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
eb30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 20 /////////////..
eb40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
eb50: 2f 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 /}....
eb60: 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////
eb70: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
eb80: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 20 20 ////////////..
eb90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f //
eba0: 20 72 65 6c 65 61 73 65 20 75 6e 6d 61 6e 61 67 release unmanag
ebb0: 65 64 20 72 65 73 6f 75 72 63 65 73 20 68 65 72 ed resources her
ebc0: 65 2e 2e 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 e.....
ebd0: 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////
ebe0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
ebf0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
ec00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ec10: 64 69 73 70 6f 73 65 64 20 3d 20 74 72 75 65 3b disposed = true;
ec20: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d .. }.
ec30: 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 . }..
ec40: 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a #endregion..
ec50: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
ec60: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
ec70: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
ec80: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
ec90: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
eca0: 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 /.... #re
ecb0: 67 69 6f 6e 20 44 65 73 74 72 75 63 74 6f 72 0d gion Destructor.
ecc0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 . /// <su
ecd0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
ece0: 2f 2f 2f 20 46 69 6e 61 6c 69 7a 65 73 20 74 68 /// Finalizes th
ecf0: 69 73 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e is object instan
ed00: 63 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ce... ///
ed10: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
ed20: 20 20 20 20 20 7e 53 51 4c 69 74 65 56 69 72 74 ~SQLiteVirt
ed30: 75 61 6c 54 61 62 6c 65 43 75 72 73 6f 72 28 29 ualTableCursor()
ed40: 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 .. {..
ed50: 20 20 20 20 20 20 20 20 20 44 69 73 70 6f 73 65 Dispose
ed60: 28 66 61 6c 73 65 29 3b 0d 0a 20 20 20 20 20 20 (false);..
ed70: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 6e }.. #en
ed80: 64 72 65 67 69 6f 6e 0d 0a 20 20 20 20 7d 0d 0a dregion.. }..
ed90: 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a #endregion..
eda0: 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f .. //////////
edb0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
edc0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
edd0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
ede0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
edf0: 2f 0d 0a 0d 0a 20 20 20 20 23 72 65 67 69 6f 6e /.... #region
ee00: 20 49 53 51 4c 69 74 65 4e 61 74 69 76 65 48 61 ISQLiteNativeHa
ee10: 6e 64 6c 65 20 49 6e 74 65 72 66 61 63 65 0d 0a ndle Interface..
ee20: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
ee30: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 >.. /// This
ee40: 69 6e 74 65 72 66 61 63 65 20 72 65 70 72 65 73 interface repres
ee50: 65 6e 74 73 20 61 20 6e 61 74 69 76 65 20 68 61 ents a native ha
ee60: 6e 64 6c 65 20 70 72 6f 76 69 64 65 64 20 62 79 ndle provided by
ee70: 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 the SQLite core
ee80: 0d 0a 20 20 20 20 2f 2f 2f 20 6c 69 62 72 61 72 .. /// librar
ee90: 79 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 y... /// </su
eea0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 70 75 62 6c mmary>.. publ
eeb0: 69 63 20 69 6e 74 65 72 66 61 63 65 20 49 53 51 ic interface ISQ
eec0: 4c 69 74 65 4e 61 74 69 76 65 48 61 6e 64 6c 65 LiteNativeHandle
eed0: 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 .. {..
eee0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
eef0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
ef00: 6e 61 74 69 76 65 20 68 61 6e 64 6c 65 20 76 61 native handle va
ef10: 6c 75 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f lue... //
ef20: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 / </summary>..
ef30: 20 20 20 20 20 20 49 6e 74 50 74 72 20 4e 61 74 IntPtr Nat
ef40: 69 76 65 48 61 6e 64 6c 65 20 7b 20 67 65 74 3b iveHandle { get;
ef50: 20 7d 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 }.. }.. #
ef60: 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 endregion....
ef70: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
ef80: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
ef90: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
efa0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
efb0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
efc0: 20 20 20 20 23 72 65 67 69 6f 6e 20 49 53 51 4c #region ISQL
efd0: 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 20 iteNativeModule
efe0: 49 6e 74 65 72 66 61 63 65 0d 0a 20 20 20 20 2f Interface.. /
eff0: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
f000: 20 20 2f 2f 2f 20 54 68 69 73 20 69 6e 74 65 72 /// This inter
f010: 66 61 63 65 20 72 65 70 72 65 73 65 6e 74 73 20 face represents
f020: 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 a virtual table
f030: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 77 implementation w
f040: 72 69 74 74 65 6e 20 69 6e 0d 0a 20 20 20 20 2f ritten in.. /
f050: 2f 2f 20 6e 61 74 69 76 65 20 63 6f 64 65 2e 0d // native code..
f060: 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 . /// </summa
f070: 72 79 3e 0d 0a 20 20 20 20 70 75 62 6c 69 63 20 ry>.. public
f080: 69 6e 74 65 72 66 61 63 65 20 49 53 51 4c 69 74 interface ISQLit
f090: 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 0d 0a 20 eNativeModule..
f0a0: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 2f 2f {.. //
f0b0: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
f0c0: 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d /// <para>.
f0d0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 . /// Thi
f0e0: 73 20 6d 65 74 68 6f 64 20 69 73 20 63 61 6c 6c s method is call
f0f0: 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 6e ed to create a n
f100: 65 77 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 61 ew instance of a
f110: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 0d 0a virtual table..
f120: 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6e 20 72 /// in r
f130: 65 73 70 6f 6e 73 65 20 74 6f 20 61 20 43 52 45 esponse to a CRE
f140: 41 54 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c ATE VIRTUAL TABL
f150: 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 54 68 65 E statement. The
f160: 20 64 62 20 70 61 72 61 6d 65 74 65 72 0d 0a 20 db parameter..
f170: 20 20 20 20 20 20 20 2f 2f 2f 20 69 73 20 61 20 /// is a
f180: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 53 pointer to the S
f190: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 63 QLite database c
f1a0: 6f 6e 6e 65 63 74 69 6f 6e 20 74 68 61 74 20 69 onnection that i
f1b0: 73 20 65 78 65 63 75 74 69 6e 67 0d 0a 20 20 20 s executing..
f1c0: 20 20 20 20 20 2f 2f 2f 20 74 68 65 20 43 52 45 /// the CRE
f1d0: 41 54 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c ATE VIRTUAL TABL
f1e0: 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 54 68 65 E statement. The
f1f0: 20 70 41 75 78 20 61 72 67 75 6d 65 6e 74 20 69 pAux argument i
f200: 73 20 74 68 65 20 63 6f 70 79 0d 0a 20 20 20 20 s the copy..
f210: 20 20 20 20 2f 2f 2f 20 6f 66 20 74 68 65 20 63 /// of the c
f220: 6c 69 65 6e 74 20 64 61 74 61 20 70 6f 69 6e 74 lient data point
f230: 65 72 20 74 68 61 74 20 77 61 73 20 74 68 65 20 er that was the
f240: 66 6f 75 72 74 68 20 61 72 67 75 6d 65 6e 74 20 fourth argument
f250: 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 to the..
f260: 2f 2f 2f 20 73 71 6c 69 74 65 33 5f 63 72 65 61 /// sqlite3_crea
f270: 74 65 5f 6d 6f 64 75 6c 65 28 29 20 6f 72 20 73 te_module() or s
f280: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 6d 6f qlite3_create_mo
f290: 64 75 6c 65 5f 76 32 28 29 20 63 61 6c 6c 20 74 dule_v2() call t
f2a0: 68 61 74 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f hat.. ///
f2b0: 20 72 65 67 69 73 74 65 72 65 64 20 74 68 65 20 registered the
f2c0: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 6d 6f virtual table mo
f2d0: 64 75 6c 65 2e 20 54 68 65 20 61 72 67 76 20 70 dule. The argv p
f2e0: 61 72 61 6d 65 74 65 72 20 69 73 20 61 6e 0d 0a arameter is an..
f2f0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 72 72 61 /// arra
f300: 79 20 6f 66 20 61 72 67 63 20 70 6f 69 6e 74 65 y of argc pointe
f310: 72 73 20 74 6f 20 6e 75 6c 6c 20 74 65 72 6d 69 rs to null termi
f320: 6e 61 74 65 64 20 73 74 72 69 6e 67 73 2e 20 54 nated strings. T
f330: 68 65 20 66 69 72 73 74 0d 0a 20 20 20 20 20 20 he first..
f340: 20 20 2f 2f 2f 20 73 74 72 69 6e 67 2c 20 61 72 /// string, ar
f350: 67 76 5b 30 5d 2c 20 69 73 20 74 68 65 20 6e 61 gv[0], is the na
f360: 6d 65 20 6f 66 20 74 68 65 20 6d 6f 64 75 6c 65 me of the module
f370: 20 62 65 69 6e 67 20 69 6e 76 6f 6b 65 64 2e 20 being invoked.
f380: 54 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f The.. ///
f390: 20 6d 6f 64 75 6c 65 20 6e 61 6d 65 20 69 73 20 module name is
f3a0: 74 68 65 20 6e 61 6d 65 20 70 72 6f 76 69 64 65 the name provide
f3b0: 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 d as the second
f3c0: 61 72 67 75 6d 65 6e 74 20 74 6f 0d 0a 20 20 20 argument to..
f3d0: 20 20 20 20 20 2f 2f 2f 20 73 71 6c 69 74 65 33 /// sqlite3
f3e0: 5f 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 29 _create_module()
f3f0: 20 61 6e 64 20 61 73 20 74 68 65 20 61 72 67 75 and as the argu
f400: 6d 65 6e 74 20 74 6f 20 74 68 65 20 55 53 49 4e ment to the USIN
f410: 47 20 63 6c 61 75 73 65 20 6f 66 0d 0a 20 20 20 G clause of..
f420: 20 20 20 20 20 2f 2f 2f 20 74 68 65 20 43 52 45 /// the CRE
f430: 41 54 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c ATE VIRTUAL TABL
f440: 45 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61 74 E statement that
f450: 20 69 73 20 72 75 6e 6e 69 6e 67 2e 20 54 68 65 is running. The
f460: 20 73 65 63 6f 6e 64 2c 0d 0a 20 20 20 20 20 20 second,..
f470: 20 20 2f 2f 2f 20 61 72 67 76 5b 31 5d 2c 20 69 /// argv[1], i
f480: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 s the name of th
f490: 65 20 64 61 74 61 62 61 73 65 20 69 6e 20 77 68 e database in wh
f4a0: 69 63 68 20 74 68 65 20 6e 65 77 20 76 69 72 74 ich the new virt
f4b0: 75 61 6c 20 74 61 62 6c 65 0d 0a 20 20 20 20 20 ual table..
f4c0: 20 20 20 2f 2f 2f 20 69 73 20 62 65 69 6e 67 20 /// is being
f4d0: 63 72 65 61 74 65 64 2e 20 54 68 65 20 64 61 74 created. The dat
f4e0: 61 62 61 73 65 20 6e 61 6d 65 20 69 73 20 22 6d abase name is "m
f4f0: 61 69 6e 22 20 66 6f 72 20 74 68 65 20 70 72 69 ain" for the pri
f500: 6d 61 72 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f mary.. //
f510: 2f 20 64 61 74 61 62 61 73 65 2c 20 6f 72 20 22 / database, or "
f520: 74 65 6d 70 22 20 66 6f 72 20 54 45 4d 50 20 64 temp" for TEMP d
f530: 61 74 61 62 61 73 65 2c 20 6f 72 20 74 68 65 20 atabase, or the
f540: 6e 61 6d 65 20 67 69 76 65 6e 20 61 74 20 74 68 name given at th
f550: 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 65 e.. /// e
f560: 6e 64 20 6f 66 20 74 68 65 20 41 54 54 41 43 48 nd of the ATTACH
f570: 20 73 74 61 74 65 6d 65 6e 74 20 66 6f 72 20 61 statement for a
f580: 74 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65 ttached database
f590: 73 2e 20 54 68 65 20 74 68 69 72 64 0d 0a 20 20 s. The third..
f5a0: 20 20 20 20 20 20 2f 2f 2f 20 65 6c 65 6d 65 6e /// elemen
f5b0: 74 20 6f 66 20 74 68 65 20 61 72 72 61 79 2c 20 t of the array,
f5c0: 61 72 67 76 5b 32 5d 2c 20 69 73 20 74 68 65 20 argv[2], is the
f5d0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 6e 65 77 20 name of the new
f5e0: 76 69 72 74 75 61 6c 0d 0a 20 20 20 20 20 20 20 virtual..
f5f0: 20 2f 2f 2f 20 74 61 62 6c 65 2c 20 61 73 20 73 /// table, as s
f600: 70 65 63 69 66 69 65 64 20 66 6f 6c 6c 6f 77 69 pecified followi
f610: 6e 67 20 74 68 65 20 54 41 42 4c 45 20 6b 65 79 ng the TABLE key
f620: 77 6f 72 64 20 69 6e 20 74 68 65 20 43 52 45 41 word in the CREA
f630: 54 45 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 TE.. ///
f640: 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20 73 74 VIRTUAL TABLE st
f650: 61 74 65 6d 65 6e 74 2e 20 49 66 20 70 72 65 73 atement. If pres
f660: 65 6e 74 2c 20 74 68 65 20 66 6f 75 72 74 68 20 ent, the fourth
f670: 61 6e 64 20 73 75 62 73 65 71 75 65 6e 74 0d 0a and subsequent..
f680: 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 74 72 69 /// stri
f690: 6e 67 73 20 69 6e 20 74 68 65 20 61 72 67 76 5b ngs in the argv[
f6a0: 5d 20 61 72 72 61 79 20 72 65 70 6f 72 74 20 74 ] array report t
f6b0: 68 65 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 he arguments to
f6c0: 74 68 65 20 6d 6f 64 75 6c 65 20 6e 61 6d 65 0d the module name.
f6d0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6e 20 . /// in
f6e0: 74 68 65 20 43 52 45 41 54 45 20 56 49 52 54 55 the CREATE VIRTU
f6f0: 41 4c 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 AL TABLE stateme
f700: 6e 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f nt... ///
f710: 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 </para>..
f720: 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 /// <para>..
f730: 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6a 6f /// The jo
f740: 62 20 6f 66 20 74 68 69 73 20 6d 65 74 68 6f 64 b of this method
f750: 20 69 73 20 74 6f 20 63 6f 6e 73 74 72 75 63 74 is to construct
f760: 20 74 68 65 20 6e 65 77 20 76 69 72 74 75 61 6c the new virtual
f770: 20 74 61 62 6c 65 20 6f 62 6a 65 63 74 0d 0a 20 table object..
f780: 20 20 20 20 20 20 20 2f 2f 2f 20 28 61 6e 20 73 /// (an s
f790: 71 6c 69 74 65 33 5f 76 74 61 62 20 6f 62 6a 65 qlite3_vtab obje
f7a0: 63 74 29 20 61 6e 64 20 72 65 74 75 72 6e 20 61 ct) and return a
f7b0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 69 74 20 69 pointer to it i
f7c0: 6e 20 2a 70 70 56 54 61 62 2e 0d 0a 20 20 20 20 n *ppVTab...
f7d0: 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d /// </para>.
f7e0: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
f7f0: 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
f800: 20 41 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 As part of the
f810: 74 61 73 6b 20 6f 66 20 63 72 65 61 74 69 6e 67 task of creating
f820: 20 61 20 6e 65 77 20 73 71 6c 69 74 65 33 5f 76 a new sqlite3_v
f830: 74 61 62 20 73 74 72 75 63 74 75 72 65 2c 20 74 tab structure, t
f840: 68 69 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f his.. ///
f850: 20 6d 65 74 68 6f 64 20 6d 75 73 74 20 69 6e 76 method must inv
f860: 6f 6b 65 20 73 71 6c 69 74 65 33 5f 64 65 63 6c oke sqlite3_decl
f870: 61 72 65 5f 76 74 61 62 28 29 20 74 6f 20 74 65 are_vtab() to te
f880: 6c 6c 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f ll the SQLite co
f890: 72 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 re.. ///
f8a0: 61 62 6f 75 74 20 74 68 65 20 63 6f 6c 75 6d 6e about the column
f8b0: 73 20 61 6e 64 20 64 61 74 61 74 79 70 65 73 20 s and datatypes
f8c0: 69 6e 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 in the virtual t
f8d0: 61 62 6c 65 2e 20 54 68 65 0d 0a 20 20 20 20 20 able. The..
f8e0: 20 20 20 2f 2f 2f 20 73 71 6c 69 74 65 33 5f 64 /// sqlite3_d
f8f0: 65 63 6c 61 72 65 5f 76 74 61 62 28 29 20 41 50 eclare_vtab() AP
f900: 49 20 68 61 73 20 74 68 65 20 66 6f 6c 6c 6f 77 I has the follow
f910: 69 6e 67 20 70 72 6f 74 6f 74 79 70 65 3a 0d 0a ing prototype:..
f920: 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
f930: 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
f940: 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 <para>..
f950: 20 2f 2f 2f 20 3c 63 6f 64 65 3e 0d 0a 20 20 20 /// <code>..
f960: 20 20 20 20 20 2f 2f 2f 20 69 6e 74 20 73 71 6c /// int sql
f970: 69 74 65 33 5f 64 65 63 6c 61 72 65 5f 76 74 61 ite3_declare_vta
f980: 62 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 b(sqlite3 *db, c
f990: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 43 72 65 61 onst char *zCrea
f9a0: 74 65 54 61 62 6c 65 29 0d 0a 20 20 20 20 20 20 teTable)..
f9b0: 20 20 2f 2f 2f 20 3c 2f 63 6f 64 65 3e 0d 0a 20 /// </code>..
f9c0: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
f9d0: 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
f9e0: 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 <para>..
f9f0: 2f 2f 2f 20 54 68 65 20 66 69 72 73 74 20 61 72 /// The first ar
fa00: 67 75 6d 65 6e 74 20 74 6f 20 73 71 6c 69 74 65 gument to sqlite
fa10: 33 5f 64 65 63 6c 61 72 65 5f 76 74 61 62 28 29 3_declare_vtab()
fa20: 20 6d 75 73 74 20 62 65 20 74 68 65 20 73 61 6d must be the sam
fa30: 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 64 e.. /// d
fa40: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
fa50: 6f 6e 20 70 6f 69 6e 74 65 72 20 61 73 20 74 68 on pointer as th
fa60: 65 20 66 69 72 73 74 20 70 61 72 61 6d 65 74 65 e first paramete
fa70: 72 20 74 6f 20 74 68 69 73 20 6d 65 74 68 6f 64 r to this method
fa80: 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 ... /// T
fa90: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he second argume
faa0: 6e 74 20 74 6f 20 73 71 6c 69 74 65 33 5f 64 65 nt to sqlite3_de
fab0: 63 6c 61 72 65 5f 76 74 61 62 28 29 20 6d 75 73 clare_vtab() mus
fac0: 74 20 61 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f t a.. ///
fad0: 20 7a 65 72 6f 2d 74 65 72 6d 69 6e 61 74 65 64 zero-terminated
fae0: 20 55 54 46 2d 38 20 73 74 72 69 6e 67 20 74 68 UTF-8 string th
faf0: 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 20 77 65 at contains a we
fb00: 6c 6c 2d 66 6f 72 6d 65 64 20 43 52 45 41 54 45 ll-formed CREATE
fb10: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 41 .. /// TA
fb20: 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 20 74 68 BLE statement th
fb30: 61 74 20 64 65 66 69 6e 65 73 20 74 68 65 20 63 at defines the c
fb40: 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 76 69 olumns in the vi
fb50: 72 74 75 61 6c 20 74 61 62 6c 65 20 61 6e 64 0d rtual table and.
fb60: 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 68 65 . /// the
fb70: 69 72 20 64 61 74 61 20 74 79 70 65 73 2e 20 54 ir data types. T
fb80: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 he name of the t
fb90: 61 62 6c 65 20 69 6e 20 74 68 69 73 20 43 52 45 able in this CRE
fba0: 41 54 45 20 54 41 42 4c 45 0d 0a 20 20 20 20 20 ATE TABLE..
fbb0: 20 20 20 2f 2f 2f 20 73 74 61 74 65 6d 65 6e 74 /// statement
fbc0: 20 69 73 20 69 67 6e 6f 72 65 64 2c 20 61 73 20 is ignored, as
fbd0: 61 72 65 20 61 6c 6c 20 63 6f 6e 73 74 72 61 69 are all constrai
fbe0: 6e 74 73 2e 20 4f 6e 6c 79 20 74 68 65 20 63 6f nts. Only the co
fbf0: 6c 75 6d 6e 20 6e 61 6d 65 73 0d 0a 20 20 20 20 lumn names..
fc00: 20 20 20 20 2f 2f 2f 20 61 6e 64 20 64 61 74 61 /// and data
fc10: 74 79 70 65 73 20 6d 61 74 74 65 72 2e 20 54 68 types matter. Th
fc20: 65 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 e CREATE TABLE s
fc30: 74 61 74 65 6d 65 6e 74 20 73 74 72 69 6e 67 20 tatement string
fc40: 6e 65 65 64 20 6e 6f 74 20 74 6f 0d 0a 20 20 20 need not to..
fc50: 20 20 20 20 20 2f 2f 2f 20 62 65 20 68 65 6c 64 /// be held
fc60: 20 69 6e 20 70 65 72 73 69 73 74 65 6e 74 20 6d in persistent m
fc70: 65 6d 6f 72 79 2e 20 54 68 65 20 73 74 72 69 6e emory. The strin
fc80: 67 20 63 61 6e 20 62 65 20 64 65 61 6c 6c 6f 63 g can be dealloc
fc90: 61 74 65 64 20 61 6e 64 2f 6f 72 0d 0a 20 20 20 ated and/or..
fca0: 20 20 20 20 20 2f 2f 2f 20 72 65 75 73 65 64 20 /// reused
fcb0: 61 73 20 73 6f 6f 6e 20 61 73 20 74 68 65 20 73 as soon as the s
fcc0: 71 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 5f 76 qlite3_declare_v
fcd0: 74 61 62 28 29 20 72 6f 75 74 69 6e 65 20 72 65 tab() routine re
fce0: 74 75 72 6e 73 2e 0d 0a 20 20 20 20 20 20 20 20 turns...
fcf0: 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 /// </para>..
fd00: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
fd10: 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
fd20: 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 44 <param name="pD
fd30: 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f b">.. ///
fd40: 20 54 68 65 20 6e 61 74 69 76 65 20 64 61 74 61 The native data
fd50: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 base connection
fd60: 68 61 6e 64 6c 65 2e 0d 0a 20 20 20 20 20 20 20 handle...
fd70: 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
fd80: 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
fd90: 6d 20 6e 61 6d 65 3d 22 70 41 75 78 22 3e 0d 0a m name="pAux">..
fda0: 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
fdb0: 6f 72 69 67 69 6e 61 6c 20 6e 61 74 69 76 65 20 original native
fdc0: 70 6f 69 6e 74 65 72 20 76 61 6c 75 65 20 74 68 pointer value th
fdd0: 61 74 20 77 61 73 20 70 72 6f 76 69 64 65 64 20 at was provided
fde0: 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 to the..
fdf0: 2f 2f 2f 20 73 71 6c 69 74 65 33 5f 63 72 65 61 /// sqlite3_crea
fe00: 74 65 5f 6d 6f 64 75 6c 65 28 29 2c 20 73 71 6c te_module(), sql
fe10: 69 74 65 33 5f 63 72 65 61 74 65 5f 6d 6f 64 75 ite3_create_modu
fe20: 6c 65 5f 76 32 28 29 20 6f 72 0d 0a 20 20 20 20 le_v2() or..
fe30: 20 20 20 20 2f 2f 2f 20 73 71 6c 69 74 65 33 5f /// sqlite3_
fe40: 63 72 65 61 74 65 5f 64 69 73 70 6f 73 61 62 6c create_disposabl
fe50: 65 5f 6d 6f 64 75 6c 65 28 29 20 66 75 6e 63 74 e_module() funct
fe60: 69 6f 6e 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f ions... /
fe70: 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
fe80: 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
fe90: 6e 61 6d 65 3d 22 61 72 67 63 22 3e 0d 0a 20 20 name="argc">..
fea0: 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 75 /// The nu
feb0: 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 mber of argument
fec0: 73 20 66 72 6f 6d 20 74 68 65 20 43 52 45 41 54 s from the CREAT
fed0: 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20 E VIRTUAL TABLE
fee0: 73 74 61 74 65 6d 65 6e 74 2e 0d 0a 20 20 20 20 statement...
fef0: 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
ff00: 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
ff10: 61 72 61 6d 20 6e 61 6d 65 3d 22 61 72 67 76 22 aram name="argv"
ff20: 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
ff30: 68 65 20 61 72 72 61 79 20 6f 66 20 73 74 72 69 he array of stri
ff40: 6e 67 20 61 72 67 75 6d 65 6e 74 73 20 66 72 6f ng arguments fro
ff50: 6d 20 74 68 65 20 43 52 45 41 54 45 20 56 49 52 m the CREATE VIR
ff60: 54 55 41 4c 20 54 41 42 4c 45 0d 0a 20 20 20 20 TUAL TABLE..
ff70: 20 20 20 20 2f 2f 2f 20 73 74 61 74 65 6d 65 6e /// statemen
ff80: 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 t... ///
ff90: 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
ffa0: 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
ffb0: 65 3d 22 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 e="pVtab">..
ffc0: 20 20 20 20 2f 2f 2f 20 55 70 6f 6e 20 73 75 63 /// Upon suc
ffd0: 63 65 73 73 2c 20 74 68 69 73 20 70 61 72 61 6d cess, this param
ffe0: 65 74 65 72 20 6d 75 73 74 20 62 65 20 6d 6f 64 eter must be mod
fff0: 69 66 69 65 64 20 74 6f 20 70 6f 69 6e 74 20 74 ified to point t
10000 6f 20 74 68 65 20 6e 65 77 6c 79 0d 0a 20 20 20 o the newly..
10010 20 20 20 20 20 2f 2f 2f 20 63 72 65 61 74 65 64 /// created
10020 20 6e 61 74 69 76 65 20 73 71 6c 69 74 65 33 5f native sqlite3_
10030 76 74 61 62 20 64 65 72 69 76 65 64 20 73 74 72 vtab derived str
10040 75 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 ucture...
10050 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
10060 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
10070 6d 20 6e 61 6d 65 3d 22 70 45 72 72 6f 72 22 3e m name="pError">
10080 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 55 70 .. /// Up
10090 6f 6e 20 66 61 69 6c 75 72 65 2c 20 74 68 69 73 on failure, this
100a0 20 70 61 72 61 6d 65 74 65 72 20 6d 75 73 74 20 parameter must
100b0 62 65 20 6d 6f 64 69 66 69 65 64 20 74 6f 20 70 be modified to p
100c0 6f 69 6e 74 20 74 6f 20 74 68 65 20 65 72 72 6f oint to the erro
100d0 72 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6d r.. /// m
100e0 65 73 73 61 67 65 2c 20 77 69 74 68 20 74 68 65 essage, with the
100f0 20 75 6e 64 65 72 6c 79 69 6e 67 20 6d 65 6d 6f underlying memo
10100 72 79 20 68 61 76 69 6e 67 20 62 65 65 6e 20 6f ry having been o
10110 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 btained from the
10120 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 .. /// sq
10130 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 20 66 lite3_malloc() f
10140 75 6e 63 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 unction...
10150 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
10160 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 /// <ret
10170 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f urns>.. /
10180 2f 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 // A standard SQ
10190 4c 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 Lite return code
101a0 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
101b0 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 /returns>..
101c0 20 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f SQLiteErrorCo
101d0 64 65 20 78 43 72 65 61 74 65 28 0d 0a 20 20 20 de xCreate(..
101e0 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 IntPtr
101f0 70 44 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 pDb,..
10200 20 20 49 6e 74 50 74 72 20 70 41 75 78 2c 0d 0a IntPtr pAux,..
10210 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 int
10220 61 72 67 63 2c 0d 0a 20 20 20 20 20 20 20 20 20 argc,..
10230 20 20 20 49 6e 74 50 74 72 20 61 72 67 76 2c 0d IntPtr argv,.
10240 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 66 . ref
10250 20 49 6e 74 50 74 72 20 70 56 74 61 62 2c 0d 0a IntPtr pVtab,..
10260 20 20 20 20 20 20 20 20 20 20 20 20 72 65 66 20 ref
10270 49 6e 74 50 74 72 20 70 45 72 72 6f 72 0d 0a 20 IntPtr pError..
10280 20 20 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d );...
10290 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
102a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
102b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
102c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
102d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
102e0 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 .... ///
102f0 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
10300 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 /// <para>..
10310 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 78 /// The x
10320 43 6f 6e 6e 65 63 74 20 6d 65 74 68 6f 64 20 69 Connect method i
10330 73 20 76 65 72 79 20 73 69 6d 69 6c 61 72 20 74 s very similar t
10340 6f 20 78 43 72 65 61 74 65 2e 20 49 74 20 68 61 o xCreate. It ha
10350 73 20 74 68 65 20 73 61 6d 65 0d 0a 20 20 20 20 s the same..
10360 20 20 20 20 2f 2f 2f 20 70 61 72 61 6d 65 74 65 /// paramete
10370 72 73 20 61 6e 64 20 63 6f 6e 73 74 72 75 63 74 rs and construct
10380 73 20 61 20 6e 65 77 20 73 71 6c 69 74 65 33 5f s a new sqlite3_
10390 76 74 61 62 20 73 74 72 75 63 74 75 72 65 20 6a vtab structure j
103a0 75 73 74 20 6c 69 6b 65 0d 0a 20 20 20 20 20 20 ust like..
103b0 20 20 2f 2f 2f 20 78 43 72 65 61 74 65 2e 20 41 /// xCreate. A
103c0 6e 64 20 69 74 20 6d 75 73 74 20 61 6c 73 6f 20 nd it must also
103d0 63 61 6c 6c 20 73 71 6c 69 74 65 33 5f 64 65 63 call sqlite3_dec
103e0 6c 61 72 65 5f 76 74 61 62 28 29 20 6c 69 6b 65 lare_vtab() like
103f0 20 78 43 72 65 61 74 65 2e 0d 0a 20 20 20 20 20 xCreate...
10400 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a /// </para>..
10410 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
10420 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
10430 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 69 The difference i
10440 73 20 74 68 61 74 20 78 43 6f 6e 6e 65 63 74 20 s that xConnect
10450 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 65 73 74 is called to est
10460 61 62 6c 69 73 68 20 61 20 6e 65 77 0d 0a 20 20 ablish a new..
10470 20 20 20 20 20 20 2f 2f 2f 20 63 6f 6e 6e 65 63 /// connec
10480 74 69 6f 6e 20 74 6f 20 61 6e 20 65 78 69 73 74 tion to an exist
10490 69 6e 67 20 76 69 72 74 75 61 6c 20 74 61 62 6c ing virtual tabl
104a0 65 20 77 68 65 72 65 61 73 20 78 43 72 65 61 74 e whereas xCreat
104b0 65 20 69 73 20 63 61 6c 6c 65 64 0d 0a 20 20 20 e is called..
104c0 20 20 20 20 20 2f 2f 2f 20 74 6f 20 63 72 65 61 /// to crea
104d0 74 65 20 61 20 6e 65 77 20 76 69 72 74 75 61 6c te a new virtual
104e0 20 74 61 62 6c 65 20 66 72 6f 6d 20 73 63 72 61 table from scra
104f0 74 63 68 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f tch... //
10500 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 / </para>..
10510 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 /// <para>..
10520 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 78 /// The x
10530 43 72 65 61 74 65 20 61 6e 64 20 78 43 6f 6e 6e Create and xConn
10540 65 63 74 20 6d 65 74 68 6f 64 73 20 61 72 65 20 ect methods are
10550 6f 6e 6c 79 20 64 69 66 66 65 72 65 6e 74 20 77 only different w
10560 68 65 6e 20 74 68 65 0d 0a 20 20 20 20 20 20 20 hen the..
10570 20 2f 2f 2f 20 76 69 72 74 75 61 6c 20 74 61 62 /// virtual tab
10580 6c 65 20 68 61 73 20 73 6f 6d 65 20 6b 69 6e 64 le has some kind
10590 20 6f 66 20 62 61 63 6b 69 6e 67 20 73 74 6f 72 of backing stor
105a0 65 20 74 68 61 74 20 6d 75 73 74 20 62 65 0d 0a e that must be..
105b0 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6e 69 74 /// init
105c0 69 61 6c 69 7a 65 64 20 74 68 65 20 66 69 72 73 ialized the firs
105d0 74 20 74 69 6d 65 20 74 68 65 20 76 69 72 74 75 t time the virtu
105e0 61 6c 20 74 61 62 6c 65 20 69 73 20 63 72 65 61 al table is crea
105f0 74 65 64 2e 20 54 68 65 0d 0a 20 20 20 20 20 20 ted. The..
10600 20 20 2f 2f 2f 20 78 43 72 65 61 74 65 20 6d 65 /// xCreate me
10610 74 68 6f 64 20 63 72 65 61 74 65 73 20 61 6e 64 thod creates and
10620 20 69 6e 69 74 69 61 6c 69 7a 65 73 20 74 68 65 initializes the
10630 20 62 61 63 6b 69 6e 67 20 73 74 6f 72 65 2e 20 backing store.
10640 54 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f The.. ///
10650 20 78 43 6f 6e 6e 65 63 74 20 6d 65 74 68 6f 64 xConnect method
10660 20 6a 75 73 74 20 63 6f 6e 6e 65 63 74 73 20 74 just connects t
10670 6f 20 61 6e 20 65 78 69 73 74 69 6e 67 20 62 61 o an existing ba
10680 63 6b 69 6e 67 20 73 74 6f 72 65 2e 0d 0a 20 20 cking store...
10690 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
106a0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
106b0 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
106c0 2f 2f 20 41 73 20 61 6e 20 65 78 61 6d 70 6c 65 // As an example
106d0 2c 20 63 6f 6e 73 69 64 65 72 20 61 20 76 69 72 , consider a vir
106e0 74 75 61 6c 20 74 61 62 6c 65 20 69 6d 70 6c 65 tual table imple
106f0 6d 65 6e 74 61 74 69 6f 6e 20 74 68 61 74 0d 0a mentation that..
10700 20 20 20 20 20 20 20 20 2f 2f 2f 20 70 72 6f 76 /// prov
10710 69 64 65 73 20 72 65 61 64 2d 6f 6e 6c 79 20 61 ides read-only a
10720 63 63 65 73 73 20 74 6f 20 65 78 69 73 74 69 6e ccess to existin
10730 67 20 63 6f 6d 6d 61 2d 73 65 70 61 72 61 74 65 g comma-separate
10740 64 2d 76 61 6c 75 65 20 28 43 53 56 29 0d 0a 20 d-value (CSV)..
10750 20 20 20 20 20 20 20 2f 2f 2f 20 66 69 6c 65 73 /// files
10760 20 6f 6e 20 64 69 73 6b 2e 20 54 68 65 72 65 20 on disk. There
10770 69 73 20 6e 6f 20 62 61 63 6b 69 6e 67 20 73 74 is no backing st
10780 6f 72 65 20 74 68 61 74 20 6e 65 65 64 73 20 74 ore that needs t
10790 6f 20 62 65 20 63 72 65 61 74 65 64 0d 0a 20 20 o be created..
107a0 20 20 20 20 20 20 2f 2f 2f 20 6f 72 20 69 6e 69 /// or ini
107b0 74 69 61 6c 69 7a 65 64 20 66 6f 72 20 73 75 63 tialized for suc
107c0 68 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c h a virtual tabl
107d0 65 20 28 73 69 6e 63 65 20 74 68 65 20 43 53 56 e (since the CSV
107e0 20 66 69 6c 65 73 0d 0a 20 20 20 20 20 20 20 20 files..
107f0 2f 2f 2f 20 61 6c 72 65 61 64 79 20 65 78 69 73 /// already exis
10800 74 20 6f 6e 20 64 69 73 6b 29 20 73 6f 20 74 68 t on disk) so th
10810 65 20 78 43 72 65 61 74 65 20 61 6e 64 20 78 43 e xCreate and xC
10820 6f 6e 6e 65 63 74 20 6d 65 74 68 6f 64 73 20 77 onnect methods w
10830 69 6c 6c 20 62 65 0d 0a 20 20 20 20 20 20 20 20 ill be..
10840 2f 2f 2f 20 69 64 65 6e 74 69 63 61 6c 20 66 6f /// identical fo
10850 72 20 74 68 61 74 20 6d 6f 64 75 6c 65 2e 0d 0a r that module...
10860 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
10870 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
10880 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 <para>..
10890 20 2f 2f 2f 20 41 6e 6f 74 68 65 72 20 65 78 61 /// Another exa
108a0 6d 70 6c 65 20 69 73 20 61 20 76 69 72 74 75 61 mple is a virtua
108b0 6c 20 74 61 62 6c 65 20 74 68 61 74 20 69 6d 70 l table that imp
108c0 6c 65 6d 65 6e 74 73 20 61 20 66 75 6c 6c 2d 74 lements a full-t
108d0 65 78 74 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ext.. ///
108e0 20 69 6e 64 65 78 2e 20 54 68 65 20 78 43 72 65 index. The xCre
108f0 61 74 65 20 6d 65 74 68 6f 64 20 6d 75 73 74 20 ate method must
10900 63 72 65 61 74 65 20 61 6e 64 20 69 6e 69 74 69 create and initi
10910 61 6c 69 7a 65 20 64 61 74 61 0d 0a 20 20 20 20 alize data..
10920 20 20 20 20 2f 2f 2f 20 73 74 72 75 63 74 75 72 /// structur
10930 65 73 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 64 es to hold the d
10940 69 63 74 69 6f 6e 61 72 79 20 61 6e 64 20 70 6f ictionary and po
10950 73 74 69 6e 67 20 6c 69 73 74 73 20 66 6f 72 20 sting lists for
10960 74 68 61 74 20 69 6e 64 65 78 2e 0d 0a 20 20 20 that index...
10970 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 78 43 6f /// The xCo
10980 6e 6e 65 63 74 20 6d 65 74 68 6f 64 2c 20 6f 6e nnect method, on
10990 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 2c the other hand,
109a0 20 6f 6e 6c 79 20 68 61 73 20 74 6f 20 6c 6f 63 only has to loc
109b0 61 74 65 20 61 6e 64 20 75 73 65 0d 0a 20 20 20 ate and use..
109c0 20 20 20 20 20 2f 2f 2f 20 61 6e 20 65 78 69 73 /// an exis
109d0 74 69 6e 67 20 64 69 63 74 69 6f 6e 61 72 79 20 ting dictionary
109e0 61 6e 64 20 70 6f 73 74 69 6e 67 20 6c 69 73 74 and posting list
109f0 73 20 74 68 61 74 20 77 65 72 65 20 63 72 65 61 s that were crea
10a00 74 65 64 20 62 79 20 61 0d 0a 20 20 20 20 20 20 ted by a..
10a10 20 20 2f 2f 2f 20 70 72 69 6f 72 20 78 43 72 65 /// prior xCre
10a20 61 74 65 20 63 61 6c 6c 2e 0d 0a 20 20 20 20 20 ate call...
10a30 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a /// </para>..
10a40 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
10a50 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
10a60 54 68 65 20 78 43 6f 6e 6e 65 63 74 20 6d 65 74 The xConnect met
10a70 68 6f 64 20 6d 75 73 74 20 72 65 74 75 72 6e 20 hod must return
10a80 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 69 74 20 SQLITE_OK if it
10a90 69 73 20 73 75 63 63 65 73 73 66 75 6c 20 69 6e is successful in
10aa0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 63 72 .. /// cr
10ab0 65 61 74 69 6e 67 20 74 68 65 20 6e 65 77 20 76 eating the new v
10ac0 69 72 74 75 61 6c 20 74 61 62 6c 65 2c 20 6f 72 irtual table, or
10ad0 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 20 69 66 SQLITE_ERROR if
10ae0 20 69 74 20 69 73 20 6e 6f 74 0d 0a 20 20 20 20 it is not..
10af0 20 20 20 20 2f 2f 2f 20 73 75 63 63 65 73 73 66 /// successf
10b00 75 6c 2e 20 49 66 20 6e 6f 74 20 73 75 63 63 65 ul. If not succe
10b10 73 73 66 75 6c 2c 20 74 68 65 20 73 71 6c 69 74 ssful, the sqlit
10b20 65 33 5f 76 74 61 62 20 73 74 72 75 63 74 75 72 e3_vtab structur
10b30 65 20 6d 75 73 74 20 6e 6f 74 0d 0a 20 20 20 20 e must not..
10b40 20 20 20 20 2f 2f 2f 20 62 65 20 61 6c 6c 6f 63 /// be alloc
10b50 61 74 65 64 2e 20 41 6e 20 65 72 72 6f 72 20 6d ated. An error m
10b60 65 73 73 61 67 65 20 6d 61 79 20 6f 70 74 69 6f essage may optio
10b70 6e 61 6c 6c 79 20 62 65 20 72 65 74 75 72 6e 65 nally be returne
10b80 64 20 69 6e 20 2a 70 7a 45 72 72 0d 0a 20 20 20 d in *pzErr..
10b90 20 20 20 20 20 2f 2f 2f 20 69 66 20 75 6e 73 75 /// if unsu
10ba0 63 63 65 73 73 66 75 6c 2e 20 53 70 61 63 65 20 ccessful. Space
10bb0 74 6f 20 68 6f 6c 64 20 74 68 65 20 65 72 72 6f to hold the erro
10bc0 72 20 6d 65 73 73 61 67 65 20 73 74 72 69 6e 67 r message string
10bd0 20 6d 75 73 74 20 62 65 0d 0a 20 20 20 20 20 20 must be..
10be0 20 20 2f 2f 2f 20 61 6c 6c 6f 63 61 74 65 64 20 /// allocated
10bf0 75 73 69 6e 67 20 61 6e 20 53 51 4c 69 74 65 20 using an SQLite
10c00 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
10c10 6e 20 66 75 6e 63 74 69 6f 6e 20 6c 69 6b 65 0d n function like.
10c20 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 6c . /// sql
10c30 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 20 6f 72 ite3_malloc() or
10c40 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 sqlite3_mprintf
10c50 28 29 20 61 73 20 74 68 65 20 53 51 4c 69 74 65 () as the SQLite
10c60 20 63 6f 72 65 20 77 69 6c 6c 0d 0a 20 20 20 20 core will..
10c70 20 20 20 20 2f 2f 2f 20 61 74 74 65 6d 70 74 20 /// attempt
10c80 74 6f 20 66 72 65 65 20 74 68 65 20 73 70 61 63 to free the spac
10c90 65 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 5f e using sqlite3_
10ca0 66 72 65 65 28 29 20 61 66 74 65 72 20 74 68 65 free() after the
10cb0 20 65 72 72 6f 72 20 68 61 73 0d 0a 20 20 20 20 error has..
10cc0 20 20 20 20 2f 2f 2f 20 62 65 65 6e 20 72 65 70 /// been rep
10cd0 6f 72 74 65 64 20 75 70 20 74 6f 20 74 68 65 20 orted up to the
10ce0 61 70 70 6c 69 63 61 74 69 6f 6e 2e 0d 0a 20 20 application...
10cf0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
10d00 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
10d10 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
10d20 2f 2f 20 54 68 65 20 78 43 6f 6e 6e 65 63 74 20 // The xConnect
10d30 6d 65 74 68 6f 64 20 69 73 20 72 65 71 75 69 72 method is requir
10d40 65 64 20 66 6f 72 20 65 76 65 72 79 20 76 69 72 ed for every vir
10d50 74 75 61 6c 20 74 61 62 6c 65 0d 0a 20 20 20 20 tual table..
10d60 20 20 20 20 2f 2f 2f 20 69 6d 70 6c 65 6d 65 6e /// implemen
10d70 74 61 74 69 6f 6e 2c 20 74 68 6f 75 67 68 20 74 tation, though t
10d80 68 65 20 78 43 72 65 61 74 65 20 61 6e 64 20 78 he xCreate and x
10d90 43 6f 6e 6e 65 63 74 20 70 6f 69 6e 74 65 72 73 Connect pointers
10da0 20 6f 66 20 74 68 65 0d 0a 20 20 20 20 20 20 20 of the..
10db0 20 2f 2f 2f 20 73 71 6c 69 74 65 33 5f 6d 6f 64 /// sqlite3_mod
10dc0 75 6c 65 20 6f 62 6a 65 63 74 20 6d 61 79 20 70 ule object may p
10dd0 6f 69 6e 74 20 74 6f 20 74 68 65 20 73 61 6d 65 oint to the same
10de0 20 66 75 6e 63 74 69 6f 6e 20 74 68 65 20 76 69 function the vi
10df0 72 74 75 61 6c 0d 0a 20 20 20 20 20 20 20 20 2f rtual.. /
10e00 2f 2f 20 74 61 62 6c 65 20 64 6f 65 73 20 6e 6f // table does no
10e10 74 20 6e 65 65 64 20 74 6f 20 69 6e 69 74 69 61 t need to initia
10e20 6c 69 7a 65 20 62 61 63 6b 69 6e 67 20 73 74 6f lize backing sto
10e30 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f re... ///
10e40 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 </para>..
10e50 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
10e60 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
10e70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 44 62 22 3e aram name="pDb">
10e80 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
10e90 65 20 6e 61 74 69 76 65 20 64 61 74 61 62 61 73 e native databas
10ea0 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e e connection han
10eb0 64 6c 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f dle... //
10ec0 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
10ed0 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
10ee0 61 6d 65 3d 22 70 41 75 78 22 3e 0d 0a 20 20 20 ame="pAux">..
10ef0 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6f 72 69 /// The ori
10f00 67 69 6e 61 6c 20 6e 61 74 69 76 65 20 70 6f 69 ginal native poi
10f10 6e 74 65 72 20 76 61 6c 75 65 20 74 68 61 74 20 nter value that
10f20 77 61 73 20 70 72 6f 76 69 64 65 64 20 74 6f 20 was provided to
10f30 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f the.. ///
10f40 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f sqlite3_create_
10f50 6d 6f 64 75 6c 65 28 29 2c 20 73 71 6c 69 74 65 module(), sqlite
10f60 33 5f 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 5f 3_create_module_
10f70 76 32 28 29 20 6f 72 0d 0a 20 20 20 20 20 20 20 v2() or..
10f80 20 2f 2f 2f 20 73 71 6c 69 74 65 33 5f 63 72 65 /// sqlite3_cre
10f90 61 74 65 5f 64 69 73 70 6f 73 61 62 6c 65 5f 6d ate_disposable_m
10fa0 6f 64 75 6c 65 28 29 20 66 75 6e 63 74 69 6f 6e odule() function
10fb0 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s... ///
10fc0 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
10fd0 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
10fe0 65 3d 22 61 72 67 63 22 3e 0d 0a 20 20 20 20 20 e="argc">..
10ff0 20 20 20 2f 2f 2f 20 54 68 65 20 6e 75 6d 62 65 /// The numbe
11000 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 66 r of arguments f
11010 72 6f 6d 20 74 68 65 20 43 52 45 41 54 45 20 56 rom the CREATE V
11020 49 52 54 55 41 4c 20 54 41 42 4c 45 20 73 74 61 IRTUAL TABLE sta
11030 74 65 6d 65 6e 74 2e 0d 0a 20 20 20 20 20 20 20 tement...
11040 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
11050 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
11060 6d 20 6e 61 6d 65 3d 22 61 72 67 76 22 3e 0d 0a m name="argv">..
11070 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
11080 61 72 72 61 79 20 6f 66 20 73 74 72 69 6e 67 20 array of string
11090 61 72 67 75 6d 65 6e 74 73 20 66 72 6f 6d 20 74 arguments from t
110a0 68 65 20 43 52 45 41 54 45 20 56 49 52 54 55 41 he CREATE VIRTUA
110b0 4c 20 54 41 42 4c 45 0d 0a 20 20 20 20 20 20 20 L TABLE..
110c0 20 2f 2f 2f 20 73 74 61 74 65 6d 65 6e 74 2e 0d /// statement..
110d0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
110e0 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f aram>.. /
110f0 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
11100 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 pVtab">..
11110 20 2f 2f 2f 20 55 70 6f 6e 20 73 75 63 63 65 73 /// Upon succes
11120 73 2c 20 74 68 69 73 20 70 61 72 61 6d 65 74 65 s, this paramete
11130 72 20 6d 75 73 74 20 62 65 20 6d 6f 64 69 66 69 r must be modifi
11140 65 64 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 ed to point to t
11150 68 65 20 6e 65 77 6c 79 0d 0a 20 20 20 20 20 20 he newly..
11160 20 20 2f 2f 2f 20 63 72 65 61 74 65 64 20 6e 61 /// created na
11170 74 69 76 65 20 73 71 6c 69 74 65 33 5f 76 74 61 tive sqlite3_vta
11180 62 20 64 65 72 69 76 65 64 20 73 74 72 75 63 74 b derived struct
11190 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ure... //
111a0 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
111b0 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
111c0 61 6d 65 3d 22 70 45 72 72 6f 72 22 3e 0d 0a 20 ame="pError">..
111d0 20 20 20 20 20 20 20 2f 2f 2f 20 55 70 6f 6e 20 /// Upon
111e0 66 61 69 6c 75 72 65 2c 20 74 68 69 73 20 70 61 failure, this pa
111f0 72 61 6d 65 74 65 72 20 6d 75 73 74 20 62 65 20 rameter must be
11200 6d 6f 64 69 66 69 65 64 20 74 6f 20 70 6f 69 6e modified to poin
11210 74 20 74 6f 20 74 68 65 20 65 72 72 6f 72 0d 0a t to the error..
11220 20 20 20 20 20 20 20 20 2f 2f 2f 20 6d 65 73 73 /// mess
11230 61 67 65 2c 20 77 69 74 68 20 74 68 65 20 75 6e age, with the un
11240 64 65 72 6c 79 69 6e 67 20 6d 65 6d 6f 72 79 20 derlying memory
11250 68 61 76 69 6e 67 20 62 65 65 6e 20 6f 62 74 61 having been obta
11260 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 0d 0a 20 ined from the..
11270 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 6c 69 74 /// sqlit
11280 65 33 5f 6d 61 6c 6c 6f 63 28 29 20 66 75 6e 63 e3_malloc() func
11290 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f tion... /
112a0 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
112b0 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e /// <return
112c0 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s>.. ///
112d0 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 A standard SQLit
112e0 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a e return code...
112f0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 /// </re
11300 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
11310 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 SQLiteErrorCode
11320 78 43 6f 6e 6e 65 63 74 28 0d 0a 20 20 20 20 20 xConnect(..
11330 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 44 IntPtr pD
11340 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 b,..
11350 49 6e 74 50 74 72 20 70 41 75 78 2c 0d 0a 20 20 IntPtr pAux,..
11360 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 61 72 int ar
11370 67 63 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 gc,..
11380 20 49 6e 74 50 74 72 20 61 72 67 76 2c 0d 0a 20 IntPtr argv,..
11390 20 20 20 20 20 20 20 20 20 20 20 72 65 66 20 49 ref I
113a0 6e 74 50 74 72 20 70 56 74 61 62 2c 0d 0a 20 20 ntPtr pVtab,..
113b0 20 20 20 20 20 20 20 20 20 20 72 65 66 20 49 6e ref In
113c0 74 50 74 72 20 70 45 72 72 6f 72 0d 0a 20 20 20 tPtr pError..
113d0 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 );....
113e0 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
113f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
11400 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
11410 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
11420 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a //////////////..
11430 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
11440 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
11450 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
11460 20 20 20 20 20 2f 2f 2f 20 53 51 4c 69 74 65 20 /// SQLite
11470 75 73 65 73 20 74 68 65 20 78 42 65 73 74 49 6e uses the xBestIn
11480 64 65 78 20 6d 65 74 68 6f 64 20 6f 66 20 61 20 dex method of a
11490 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 6d 6f virtual table mo
114a0 64 75 6c 65 20 74 6f 0d 0a 20 20 20 20 20 20 20 dule to..
114b0 20 2f 2f 2f 20 64 65 74 65 72 6d 69 6e 65 20 74 /// determine t
114c0 68 65 20 62 65 73 74 20 77 61 79 20 74 6f 20 61 he best way to a
114d0 63 63 65 73 73 20 74 68 65 20 76 69 72 74 75 61 ccess the virtua
114e0 6c 20 74 61 62 6c 65 2e 20 54 68 65 20 78 42 65 l table. The xBe
114f0 73 74 49 6e 64 65 78 0d 0a 20 20 20 20 20 20 20 stIndex..
11500 20 2f 2f 2f 20 6d 65 74 68 6f 64 20 68 61 73 20 /// method has
11510 61 20 70 72 6f 74 6f 74 79 70 65 20 6c 69 6b 65 a prototype like
11520 20 74 68 69 73 3a 0d 0a 20 20 20 20 20 20 20 20 this:..
11530 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 /// </para>..
11540 20 20 20 20 20 2f 2f 2f 20 3c 63 6f 64 65 3e 0d /// <code>.
11550 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6e 74 . /// int
11560 20 28 2a 78 42 65 73 74 49 6e 64 65 78 29 28 73 (*xBestIndex)(s
11570 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56 54 qlite3_vtab *pVT
11580 61 62 2c 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 ab, sqlite3_inde
11590 78 5f 69 6e 66 6f 2a 29 3b 0d 0a 20 20 20 20 20 x_info*);..
115a0 20 20 20 2f 2f 2f 20 3c 2f 63 6f 64 65 3e 0d 0a /// </code>..
115b0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
115c0 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
115d0 54 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 The SQLite core
115e0 63 6f 6d 6d 75 6e 69 63 61 74 65 73 20 77 69 74 communicates wit
115f0 68 20 74 68 65 20 78 42 65 73 74 49 6e 64 65 78 h the xBestIndex
11600 20 6d 65 74 68 6f 64 20 62 79 20 66 69 6c 6c 69 method by filli
11610 6e 67 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ng.. ///
11620 69 6e 20 63 65 72 74 61 69 6e 20 66 69 65 6c 64 in certain field
11630 73 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 s of the sqlite3
11640 5f 69 6e 64 65 78 5f 69 6e 66 6f 20 73 74 72 75 _index_info stru
11650 63 74 75 72 65 20 61 6e 64 20 70 61 73 73 69 6e cture and passin
11660 67 20 61 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f g a.. ///
11670 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 61 74 pointer to that
11680 20 73 74 72 75 63 74 75 72 65 20 69 6e 74 6f 20 structure into
11690 78 42 65 73 74 49 6e 64 65 78 20 61 73 20 74 68 xBestIndex as th
116a0 65 20 73 65 63 6f 6e 64 20 70 61 72 61 6d 65 74 e second paramet
116b0 65 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f er... ///
116c0 20 54 68 65 20 78 42 65 73 74 49 6e 64 65 78 20 The xBestIndex
116d0 6d 65 74 68 6f 64 20 66 69 6c 6c 73 20 6f 75 74 method fills out
116e0 20 6f 74 68 65 72 20 66 69 65 6c 64 73 20 6f 66 other fields of
116f0 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 0d this structure.
11700 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 77 68 69 . /// whi
11710 63 68 20 66 6f 72 6d 73 20 74 68 65 20 72 65 70 ch forms the rep
11720 6c 79 2e 20 54 68 65 20 73 71 6c 69 74 65 33 5f ly. The sqlite3_
11730 69 6e 64 65 78 5f 69 6e 66 6f 20 73 74 72 75 63 index_info struc
11740 74 75 72 65 20 6c 6f 6f 6b 73 20 6c 69 6b 65 0d ture looks like.
11750 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 68 69 . /// thi
11760 73 3a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s:.. ///
11770 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
11780 20 2f 2f 2f 20 3c 63 6f 64 65 3e 0d 0a 20 20 20 /// <code>..
11790 20 20 20 20 20 2f 2f 2f 20 20 73 74 72 75 63 74 /// struct
117a0 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 69 sqlite3_index_i
117b0 6e 66 6f 20 7b 0d 0a 20 20 20 20 20 20 20 20 2f nfo {.. /
117c0 2f 2f 20 20 20 20 2f 2a 20 49 6e 70 75 74 73 20 // /* Inputs
117d0 2a 2f 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 */.. ///
117e0 20 20 20 63 6f 6e 73 74 20 69 6e 74 20 6e 43 6f const int nCo
117f0 6e 73 74 72 61 69 6e 74 3b 20 20 20 2f 2a 20 4e nstraint; /* N
11800 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 umber of entries
11810 20 69 6e 20 61 43 6f 6e 73 74 72 61 69 6e 74 20 in aConstraint
11820 2a 2f 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 */.. ///
11830 20 20 20 63 6f 6e 73 74 20 73 74 72 75 63 74 20 const struct
11840 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 63 6f sqlite3_index_co
11850 6e 73 74 72 61 69 6e 74 20 7b 0d 0a 20 20 20 20 nstraint {..
11860 20 20 20 20 2f 2f 2f 20 20 20 20 20 20 20 69 6e /// in
11870 74 20 69 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 t iColumn;
11880 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6f 6e /* Column on
11890 20 6c 65 66 74 2d 68 61 6e 64 20 73 69 64 65 20 left-hand side
118a0 6f 66 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 of.. ///
118b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
118c0 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 20 63 * c
118d0 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0d 0a 20 20 onstraint */..
118e0 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 20 20 ///
118f0 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 6f 70 unsigned char op
11900 3b 20 20 20 20 20 2f 2a 20 43 6f 6e 73 74 72 61 ; /* Constra
11910 69 6e 74 20 6f 70 65 72 61 74 6f 72 20 2a 2f 0d int operator */.
11920 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 . ///
11930 20 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 unsigned char
11940 20 75 73 61 62 6c 65 3b 20 2f 2a 20 54 72 75 65 usable; /* True
11950 20 69 66 20 74 68 69 73 20 63 6f 6e 73 74 72 61 if this constra
11960 69 6e 74 20 69 73 20 75 73 61 62 6c 65 20 2a 2f int is usable */
11970 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 20 .. ///
11980 20 20 20 20 69 6e 74 20 69 54 65 72 6d 4f 66 66 int iTermOff
11990 73 65 74 3b 20 20 20 20 20 20 2f 2a 20 55 73 65 set; /* Use
119a0 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 2d 20 78 d internally - x
119b0 42 65 73 74 49 6e 64 65 78 20 73 68 6f 75 6c 64 BestIndex should
119c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 20 .. ///
119d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
119e0 20 20 20 20 20 20 20 20 20 20 20 2a 20 69 67 6e * ign
119f0 6f 72 65 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 ore */..
11a00 2f 2f 2f 20 20 20 20 7d 20 2a 63 6f 6e 73 74 20 /// } *const
11a10 61 43 6f 6e 73 74 72 61 69 6e 74 3b 20 20 20 20 aConstraint;
11a20 2f 2a 20 54 61 62 6c 65 20 6f 66 20 57 48 45 52 /* Table of WHER
11a30 45 20 63 6c 61 75 73 65 20 63 6f 6e 73 74 72 61 E clause constra
11a40 69 6e 74 73 20 2a 2f 0d 0a 20 20 20 20 20 20 20 ints */..
11a50 20 2f 2f 2f 20 20 20 20 63 6f 6e 73 74 20 69 6e /// const in
11a60 74 20 6e 4f 72 64 65 72 42 79 3b 20 20 20 20 20 t nOrderBy;
11a70 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 65 /* Number of te
11a80 72 6d 73 20 69 6e 20 74 68 65 20 4f 52 44 45 52 rms in the ORDER
11a90 20 42 59 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f BY.. ///
11aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11ab0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 20 *
11ac0 63 6c 61 75 73 65 20 2a 2f 0d 0a 20 20 20 20 20 clause */..
11ad0 20 20 20 2f 2f 2f 20 20 20 20 63 6f 6e 73 74 20 /// const
11ae0 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 69 struct sqlite3_i
11af0 6e 64 65 78 5f 6f 72 64 65 72 62 79 20 7b 0d 0a ndex_orderby {..
11b00 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 ///
11b10 20 20 69 6e 74 20 69 43 6f 6c 75 6d 6e 3b 20 20 int iColumn;
11b20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d /* Colum
11b30 6e 20 6e 75 6d 62 65 72 20 2a 2f 0d 0a 20 20 20 n number */..
11b40 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 20 20 75 /// u
11b50 6e 73 69 67 6e 65 64 20 63 68 61 72 20 64 65 73 nsigned char des
11b60 63 3b 20 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 c; /* True for
11b70 20 44 45 53 43 2e 20 20 46 61 6c 73 65 20 66 6f DESC. False fo
11b80 72 20 41 53 43 2e 20 2a 2f 0d 0a 20 20 20 20 20 r ASC. */..
11b90 20 20 20 2f 2f 2f 20 20 20 20 7d 20 2a 63 6f 6e /// } *con
11ba0 73 74 20 61 4f 72 64 65 72 42 79 3b 20 20 20 20 st aOrderBy;
11bb0 20 20 20 2f 2a 20 54 68 65 20 4f 52 44 45 52 20 /* The ORDER
11bc0 42 59 20 63 6c 61 75 73 65 20 2a 2f 0d 0a 20 20 BY clause */..
11bd0 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 2f 2a 20 /// /*
11be0 4f 75 74 70 75 74 73 20 2a 2f 0d 0a 20 20 20 20 Outputs */..
11bf0 20 20 20 20 2f 2f 2f 20 20 20 20 73 74 72 75 63 /// struc
11c00 74 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f t sqlite3_index_
11c10 63 6f 6e 73 74 72 61 69 6e 74 5f 75 73 61 67 65 constraint_usage
11c20 20 7b 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 {.. ///
11c30 20 20 20 20 20 69 6e 74 20 61 72 67 76 49 6e 64 int argvInd
11c40 65 78 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 69 ex; /* i
11c50 66 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 7a f greater than z
11c60 65 72 6f 2c 20 63 6f 6e 73 74 72 61 69 6e 74 20 ero, constraint
11c70 69 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 is.. ///
11c80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11c90 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 20 70 * p
11ca0 61 72 74 20 6f 66 20 61 72 67 76 20 74 6f 20 78 art of argv to x
11cb0 46 69 6c 74 65 72 20 2a 2f 0d 0a 20 20 20 20 20 Filter */..
11cc0 20 20 20 2f 2f 2f 20 20 20 20 20 20 75 6e 73 69 /// unsi
11cd0 67 6e 65 64 20 63 68 61 72 20 6f 6d 69 74 3b 20 gned char omit;
11ce0 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 63 6f 64 /* Do not cod
11cf0 65 20 61 20 74 65 73 74 20 66 6f 72 20 74 68 69 e a test for thi
11d00 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 s.. ///
11d10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11d20 20 20 20 20 20 20 20 20 20 20 20 20 2a 20 63 6f * co
11d30 6e 73 74 72 61 69 6e 74 20 2a 2f 0d 0a 20 20 20 nstraint */..
11d40 20 20 20 20 20 2f 2f 2f 20 20 20 20 7d 20 2a 63 /// } *c
11d50 6f 6e 73 74 20 61 43 6f 6e 73 74 72 61 69 6e 74 onst aConstraint
11d60 55 73 61 67 65 3b 0d 0a 20 20 20 20 20 20 20 20 Usage;..
11d70 2f 2f 2f 20 20 20 20 69 6e 74 20 69 64 78 4e 75 /// int idxNu
11d80 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 m;
11d90 2f 2a 20 4e 75 6d 62 65 72 20 75 73 65 64 20 74 /* Number used t
11da0 6f 20 69 64 65 6e 74 69 66 79 20 74 68 65 20 69 o identify the i
11db0 6e 64 65 78 20 2a 2f 0d 0a 20 20 20 20 20 20 20 ndex */..
11dc0 20 2f 2f 2f 20 20 20 20 63 68 61 72 20 2a 69 64 /// char *id
11dd0 78 53 74 72 3b 20 20 20 20 20 20 20 20 20 20 20 xStr;
11de0 20 2f 2a 20 53 74 72 69 6e 67 2c 20 70 6f 73 73 /* String, poss
11df0 69 62 6c 79 20 6f 62 74 61 69 6e 65 64 20 66 72 ibly obtained fr
11e00 6f 6d 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 om.. ///
11e10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11e20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 20 73 * s
11e30 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 20 qlite3_malloc()
11e40 2a 2f 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 */.. ///
11e50 20 20 20 69 6e 74 20 6e 65 65 64 54 6f 46 72 65 int needToFre
11e60 65 49 64 78 53 74 72 3b 20 20 20 20 2f 2a 20 46 eIdxStr; /* F
11e70 72 65 65 20 69 64 78 53 74 72 20 75 73 69 6e 67 ree idxStr using
11e80 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29 20 sqlite3_free()
11e90 69 66 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 if.. ///
11ea0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11eb0 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 20 74 * t
11ec0 72 75 65 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 rue */..
11ed0 2f 2f 2f 20 20 20 20 69 6e 74 20 6f 72 64 65 72 /// int order
11ee0 42 79 43 6f 6e 73 75 6d 65 64 3b 20 20 20 20 20 ByConsumed;
11ef0 2f 2a 20 54 72 75 65 20 69 66 20 6f 75 74 70 75 /* True if outpu
11f00 74 20 69 73 20 61 6c 72 65 61 64 79 20 6f 72 64 t is already ord
11f10 65 72 65 64 20 2a 2f 0d 0a 20 20 20 20 20 20 20 ered */..
11f20 20 2f 2f 2f 20 20 20 20 64 6f 75 62 6c 65 20 65 /// double e
11f30 73 74 69 6d 61 74 65 64 43 6f 73 74 3b 20 20 20 stimatedCost;
11f40 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 20 63 6f /* Estimated co
11f50 73 74 20 6f 66 20 75 73 69 6e 67 20 74 68 69 73 st of using this
11f60 20 69 6e 64 65 78 20 2a 2f 0d 0a 20 20 20 20 20 index */..
11f70 20 20 20 2f 2f 2f 20 20 7d 3b 0d 0a 20 20 20 20 /// };..
11f80 20 20 20 20 2f 2f 2f 20 3c 2f 63 6f 64 65 3e 0d /// </code>.
11f90 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
11fa0 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
11fb0 20 49 6e 20 61 64 64 69 74 69 6f 6e 2c 20 74 68 In addition, th
11fc0 65 72 65 20 61 72 65 20 73 6f 6d 65 20 64 65 66 ere are some def
11fd0 69 6e 65 64 20 63 6f 6e 73 74 61 6e 74 73 3a 0d ined constants:.
11fe0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
11ff0 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
12000 2f 20 3c 63 6f 64 65 3e 0d 0a 20 20 20 20 20 20 / <code>..
12010 20 20 2f 2f 2f 20 20 23 64 65 66 69 6e 65 20 53 /// #define S
12020 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 QLITE_INDEX_CONS
12030 54 52 41 49 4e 54 5f 45 51 20 20 20 20 32 0d 0a TRAINT_EQ 2..
12040 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 23 64 65 /// #de
12050 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e 44 45 fine SQLITE_INDE
12060 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 47 54 20 X_CONSTRAINT_GT
12070 20 20 20 34 0d 0a 20 20 20 20 20 20 20 20 2f 2f 4.. //
12080 2f 20 20 23 64 65 66 69 6e 65 20 53 51 4c 49 54 / #define SQLIT
12090 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49 E_INDEX_CONSTRAI
120a0 4e 54 5f 4c 45 20 20 20 20 38 0d 0a 20 20 20 20 NT_LE 8..
120b0 20 20 20 20 2f 2f 2f 20 20 23 64 65 66 69 6e 65 /// #define
120c0 20 53 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f SQLITE_INDEX_CO
120d0 4e 53 54 52 41 49 4e 54 5f 4c 54 20 20 20 20 31 NSTRAINT_LT 1
120e0 36 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 6.. ///
120f0 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 #define SQLITE_I
12100 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f NDEX_CONSTRAINT_
12110 47 45 20 20 20 20 33 32 0d 0a 20 20 20 20 20 20 GE 32..
12120 20 20 2f 2f 2f 20 20 23 64 65 66 69 6e 65 20 53 /// #define S
12130 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 QLITE_INDEX_CONS
12140 54 52 41 49 4e 54 5f 4d 41 54 43 48 20 36 34 0d TRAINT_MATCH 64.
12150 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 63 . /// </c
12160 6f 64 65 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ode>.. //
12170 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 / <para>..
12180 20 20 2f 2f 2f 20 54 68 65 20 53 51 4c 69 74 65 /// The SQLite
12190 20 63 6f 72 65 20 63 61 6c 6c 73 20 74 68 65 20 core calls the
121a0 78 42 65 73 74 49 6e 64 65 78 20 6d 65 74 68 6f xBestIndex metho
121b0 64 20 77 68 65 6e 20 69 74 20 69 73 20 63 6f 6d d when it is com
121c0 70 69 6c 69 6e 67 20 61 0d 0a 20 20 20 20 20 20 piling a..
121d0 20 20 2f 2f 2f 20 71 75 65 72 79 20 74 68 61 74 /// query that
121e0 20 69 6e 76 6f 6c 76 65 73 20 61 20 76 69 72 74 involves a virt
121f0 75 61 6c 20 74 61 62 6c 65 2e 20 49 6e 20 6f 74 ual table. In ot
12200 68 65 72 20 77 6f 72 64 73 2c 20 53 51 4c 69 74 her words, SQLit
12210 65 20 63 61 6c 6c 73 0d 0a 20 20 20 20 20 20 20 e calls..
12220 20 2f 2f 2f 20 74 68 69 73 20 6d 65 74 68 6f 64 /// this method
12230 20 77 68 65 6e 20 69 74 20 69 73 20 72 75 6e 6e when it is runn
12240 69 6e 67 20 73 71 6c 69 74 65 33 5f 70 72 65 70 ing sqlite3_prep
12250 61 72 65 28 29 20 6f 72 20 74 68 65 20 65 71 75 are() or the equ
12260 69 76 61 6c 65 6e 74 2e 0d 0a 20 20 20 20 20 20 ivalent...
12270 20 20 2f 2f 2f 20 42 79 20 63 61 6c 6c 69 6e 67 /// By calling
12280 20 74 68 69 73 20 6d 65 74 68 6f 64 2c 20 74 68 this method, th
12290 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 69 73 e SQLite core is
122a0 20 73 61 79 69 6e 67 20 74 6f 20 74 68 65 20 76 saying to the v
122b0 69 72 74 75 61 6c 0d 0a 20 20 20 20 20 20 20 20 irtual..
122c0 2f 2f 2f 20 74 61 62 6c 65 20 74 68 61 74 20 69 /// table that i
122d0 74 20 6e 65 65 64 73 20 74 6f 20 61 63 63 65 73 t needs to acces
122e0 73 20 73 6f 6d 65 20 73 75 62 73 65 74 20 6f 66 s some subset of
122f0 20 74 68 65 20 72 6f 77 73 20 69 6e 20 74 68 65 the rows in the
12300 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 76 69 .. /// vi
12310 72 74 75 61 6c 20 74 61 62 6c 65 20 61 6e 64 20 rtual table and
12320 69 74 20 77 61 6e 74 73 20 74 6f 20 6b 6e 6f 77 it wants to know
12330 20 74 68 65 20 6d 6f 73 74 20 65 66 66 69 63 69 the most effici
12340 65 6e 74 20 77 61 79 20 74 6f 20 64 6f 0d 0a 20 ent way to do..
12350 20 20 20 20 20 20 20 2f 2f 2f 20 74 68 61 74 20 /// that
12360 61 63 63 65 73 73 2e 20 54 68 65 20 78 42 65 73 access. The xBes
12370 74 49 6e 64 65 78 20 6d 65 74 68 6f 64 20 72 65 tIndex method re
12380 70 6c 69 65 73 20 77 69 74 68 20 69 6e 66 6f 72 plies with infor
12390 6d 61 74 69 6f 6e 20 74 68 61 74 0d 0a 20 20 20 mation that..
123a0 20 20 20 20 20 2f 2f 2f 20 74 68 65 20 53 51 4c /// the SQL
123b0 69 74 65 20 63 6f 72 65 20 63 61 6e 20 74 68 65 ite core can the
123c0 6e 20 75 73 65 20 74 6f 20 63 6f 6e 64 75 63 74 n use to conduct
123d0 20 61 6e 20 65 66 66 69 63 69 65 6e 74 20 73 65 an efficient se
123e0 61 72 63 68 20 6f 66 20 74 68 65 0d 0a 20 20 20 arch of the..
123f0 20 20 20 20 20 2f 2f 2f 20 76 69 72 74 75 61 6c /// virtual
12400 20 74 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 table...
12410 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 /// </para>..
12420 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e /// <para>
12430 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 57 68 .. /// Wh
12440 69 6c 65 20 63 6f 6d 70 69 6c 69 6e 67 20 61 20 ile compiling a
12450 73 69 6e 67 6c 65 20 53 51 4c 20 71 75 65 72 79 single SQL query
12460 2c 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 , the SQLite cor
12470 65 20 6d 69 67 68 74 20 63 61 6c 6c 0d 0a 20 20 e might call..
12480 20 20 20 20 20 20 2f 2f 2f 20 78 42 65 73 74 49 /// xBestI
12490 6e 64 65 78 20 6d 75 6c 74 69 70 6c 65 20 74 69 ndex multiple ti
124a0 6d 65 73 20 77 69 74 68 20 64 69 66 66 65 72 65 mes with differe
124b0 6e 74 20 73 65 74 74 69 6e 67 73 20 69 6e 0d 0a nt settings in..
124c0 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 6c 69 /// sqli
124d0 74 65 33 5f 69 6e 64 65 78 5f 69 6e 66 6f 2e 20 te3_index_info.
124e0 54 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 The SQLite core
124f0 77 69 6c 6c 20 74 68 65 6e 20 73 65 6c 65 63 74 will then select
12500 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f the.. //
12510 2f 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 74 68 / combination th
12520 61 74 20 61 70 70 65 61 72 73 20 74 6f 20 67 69 at appears to gi
12530 76 65 20 74 68 65 20 62 65 73 74 20 70 65 72 66 ve the best perf
12540 6f 72 6d 61 6e 63 65 2e 0d 0a 20 20 20 20 20 20 ormance...
12550 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
12560 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
12570 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 42 >.. /// B
12580 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 74 68 efore calling th
12590 69 73 20 6d 65 74 68 6f 64 2c 20 74 68 65 20 53 is method, the S
125a0 51 4c 69 74 65 20 63 6f 72 65 20 69 6e 69 74 69 QLite core initi
125b0 61 6c 69 7a 65 73 20 61 6e 20 69 6e 73 74 61 6e alizes an instan
125c0 63 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ce.. ///
125d0 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 69 of the sqlite3_i
125e0 6e 64 65 78 5f 69 6e 66 6f 20 73 74 72 75 63 74 ndex_info struct
125f0 75 72 65 20 77 69 74 68 20 69 6e 66 6f 72 6d 61 ure with informa
12600 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 0d 0a tion about the..
12610 20 20 20 20 20 20 20 20 2f 2f 2f 20 71 75 65 72 /// quer
12620 79 20 74 68 61 74 20 69 74 20 69 73 20 63 75 72 y that it is cur
12630 72 65 6e 74 6c 79 20 74 72 79 69 6e 67 20 74 6f rently trying to
12640 20 70 72 6f 63 65 73 73 2e 20 54 68 69 73 20 69 process. This i
12650 6e 66 6f 72 6d 61 74 69 6f 6e 0d 0a 20 20 20 20 nformation..
12660 20 20 20 20 2f 2f 2f 20 64 65 72 69 76 65 73 20 /// derives
12670 6d 61 69 6e 6c 79 20 66 72 6f 6d 20 74 68 65 20 mainly from the
12680 57 48 45 52 45 20 63 6c 61 75 73 65 20 61 6e 64 WHERE clause and
12690 20 4f 52 44 45 52 20 42 59 20 6f 72 20 47 52 4f ORDER BY or GRO
126a0 55 50 20 42 59 0d 0a 20 20 20 20 20 20 20 20 2f UP BY.. /
126b0 2f 2f 20 63 6c 61 75 73 65 73 20 6f 66 20 74 68 // clauses of th
126c0 65 20 71 75 65 72 79 2c 20 62 75 74 20 61 6c 73 e query, but als
126d0 6f 20 66 72 6f 6d 20 61 6e 79 20 4f 4e 20 6f 72 o from any ON or
126e0 20 55 53 49 4e 47 20 63 6c 61 75 73 65 73 20 69 USING clauses i
126f0 66 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f f the.. /
12700 2f 2f 20 71 75 65 72 79 20 69 73 20 61 20 6a 6f // query is a jo
12710 69 6e 2e 20 54 68 65 20 69 6e 66 6f 72 6d 61 74 in. The informat
12720 69 6f 6e 20 74 68 61 74 20 74 68 65 20 53 51 4c ion that the SQL
12730 69 74 65 20 63 6f 72 65 20 70 72 6f 76 69 64 65 ite core provide
12740 73 20 74 6f 0d 0a 20 20 20 20 20 20 20 20 2f 2f s to.. //
12750 2f 20 74 68 65 20 78 42 65 73 74 49 6e 64 65 78 / the xBestIndex
12760 20 6d 65 74 68 6f 64 20 69 73 20 68 65 6c 64 20 method is held
12770 69 6e 20 74 68 65 20 70 61 72 74 20 6f 66 20 74 in the part of t
12780 68 65 20 73 74 72 75 63 74 75 72 65 20 74 68 61 he structure tha
12790 74 20 69 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f t is.. //
127a0 2f 20 6d 61 72 6b 65 64 20 61 73 20 22 49 6e 70 / marked as "Inp
127b0 75 74 73 22 2e 20 54 68 65 20 22 4f 75 74 70 75 uts". The "Outpu
127c0 74 73 22 20 73 65 63 74 69 6f 6e 20 69 73 20 69 ts" section is i
127d0 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f 20 7a 65 nitialized to ze
127e0 72 6f 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ro... ///
127f0 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 </para>..
12800 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 /// <para>..
12810 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 69 6e /// The in
12820 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 formation in the
12830 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 69 sqlite3_index_i
12840 6e 66 6f 20 73 74 72 75 63 74 75 72 65 20 69 73 nfo structure is
12850 20 65 70 68 65 6d 65 72 61 6c 0d 0a 20 20 20 20 ephemeral..
12860 20 20 20 20 2f 2f 2f 20 61 6e 64 20 6d 61 79 20 /// and may
12870 62 65 20 6f 76 65 72 77 72 69 74 74 65 6e 20 6f be overwritten o
12880 72 20 64 65 61 6c 6c 6f 63 61 74 65 64 20 61 73 r deallocated as
12890 20 73 6f 6f 6e 20 61 73 20 74 68 65 20 78 42 65 soon as the xBe
128a0 73 74 49 6e 64 65 78 0d 0a 20 20 20 20 20 20 20 stIndex..
128b0 20 2f 2f 2f 20 6d 65 74 68 6f 64 20 72 65 74 75 /// method retu
128c0 72 6e 73 2e 20 49 66 20 74 68 65 20 78 42 65 73 rns. If the xBes
128d0 74 49 6e 64 65 78 20 6d 65 74 68 6f 64 20 6e 65 tIndex method ne
128e0 65 64 73 20 74 6f 20 72 65 6d 65 6d 62 65 72 20 eds to remember
128f0 61 6e 79 20 70 61 72 74 0d 0a 20 20 20 20 20 20 any part..
12900 20 20 2f 2f 2f 20 6f 66 20 74 68 65 20 73 71 6c /// of the sql
12910 69 74 65 33 5f 69 6e 64 65 78 5f 69 6e 66 6f 20 ite3_index_info
12920 73 74 72 75 63 74 75 72 65 2c 20 69 74 20 73 68 structure, it sh
12930 6f 75 6c 64 20 6d 61 6b 65 20 61 20 63 6f 70 79 ould make a copy
12940 2e 20 43 61 72 65 0d 0a 20 20 20 20 20 20 20 20 . Care..
12950 2f 2f 2f 20 6d 75 73 74 20 62 65 20 74 61 6b 65 /// must be take
12960 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 63 6f to store the co
12970 70 79 20 69 6e 20 61 20 70 6c 61 63 65 20 77 68 py in a place wh
12980 65 72 65 20 69 74 20 77 69 6c 6c 20 62 65 0d 0a ere it will be..
12990 20 20 20 20 20 20 20 20 2f 2f 2f 20 64 65 61 6c /// deal
129a0 6c 6f 63 61 74 65 64 2c 20 73 75 63 68 20 61 73 located, such as
129b0 20 69 6e 20 74 68 65 20 69 64 78 53 74 72 20 66 in the idxStr f
129c0 69 65 6c 64 20 77 69 74 68 20 6e 65 65 64 54 6f ield with needTo
129d0 46 72 65 65 49 64 78 53 74 72 20 73 65 74 0d 0a FreeIdxStr set..
129e0 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 6f 20 31 /// to 1
129f0 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
12a00 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 /para>..
12a10 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 /// <para>..
12a20 20 20 20 20 2f 2f 2f 20 4e 6f 74 65 20 74 68 61 /// Note tha
12a30 74 20 78 42 65 73 74 49 6e 64 65 78 20 77 69 6c t xBestIndex wil
12a40 6c 20 61 6c 77 61 79 73 20 62 65 20 63 61 6c 6c l always be call
12a50 65 64 20 62 65 66 6f 72 65 20 78 46 69 6c 74 65 ed before xFilte
12a60 72 2c 20 73 69 6e 63 65 0d 0a 20 20 20 20 20 20 r, since..
12a70 20 20 2f 2f 2f 20 74 68 65 20 69 64 78 4e 75 6d /// the idxNum
12a80 20 61 6e 64 20 69 64 78 53 74 72 20 6f 75 74 70 and idxStr outp
12a90 75 74 73 20 66 72 6f 6d 20 78 42 65 73 74 49 6e uts from xBestIn
12aa0 64 65 78 20 61 72 65 20 72 65 71 75 69 72 65 64 dex are required
12ab0 20 69 6e 70 75 74 73 0d 0a 20 20 20 20 20 20 20 inputs..
12ac0 20 2f 2f 2f 20 74 6f 20 78 46 69 6c 74 65 72 2e /// to xFilter.
12ad0 20 48 6f 77 65 76 65 72 2c 20 74 68 65 72 65 20 However, there
12ae0 69 73 20 6e 6f 20 67 75 61 72 61 6e 74 65 65 20 is no guarantee
12af0 74 68 61 74 20 78 46 69 6c 74 65 72 20 77 69 6c that xFilter wil
12b00 6c 20 62 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f l be.. //
12b10 2f 20 63 61 6c 6c 65 64 20 66 6f 6c 6c 6f 77 69 / called followi
12b20 6e 67 20 61 20 73 75 63 63 65 73 73 66 75 6c 20 ng a successful
12b30 78 42 65 73 74 49 6e 64 65 78 2e 0d 0a 20 20 20 xBestIndex...
12b40 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e /// </para>
12b50 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
12b60 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
12b70 2f 20 54 68 65 20 78 42 65 73 74 49 6e 64 65 78 / The xBestIndex
12b80 20 6d 65 74 68 6f 64 20 69 73 20 72 65 71 75 69 method is requi
12b90 72 65 64 20 66 6f 72 20 65 76 65 72 79 20 76 69 red for every vi
12ba0 72 74 75 61 6c 20 74 61 62 6c 65 0d 0a 20 20 20 rtual table..
12bb0 20 20 20 20 20 2f 2f 2f 20 69 6d 70 6c 65 6d 65 /// impleme
12bc0 6e 74 61 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 ntation...
12bd0 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
12be0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
12bf0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 32 >.. /// 2
12c00 2e 33 2e 31 20 49 6e 70 75 74 73 0d 0a 20 20 20 .3.1 Inputs..
12c10 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e /// </para>
12c20 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
12c30 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
12c40 2f 20 54 68 65 20 6d 61 69 6e 20 74 68 69 6e 67 / The main thing
12c50 20 74 68 61 74 20 74 68 65 20 53 51 4c 69 74 65 that the SQLite
12c60 20 63 6f 72 65 20 69 73 20 74 72 79 69 6e 67 20 core is trying
12c70 74 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 65 20 74 to communicate t
12c80 6f 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f o the.. /
12c90 2f 2f 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 // virtual table
12ca0 20 69 73 20 74 68 65 20 63 6f 6e 73 74 72 61 69 is the constrai
12cb0 6e 74 73 20 74 68 61 74 20 61 72 65 20 61 76 61 nts that are ava
12cc0 69 6c 61 62 6c 65 20 74 6f 20 6c 69 6d 69 74 20 ilable to limit
12cd0 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f the.. ///
12ce0 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 number of rows
12cf0 74 68 61 74 20 6e 65 65 64 20 74 6f 20 62 65 20 that need to be
12d00 73 65 61 72 63 68 65 64 2e 20 54 68 65 20 61 43 searched. The aC
12d10 6f 6e 73 74 72 61 69 6e 74 5b 5d 20 61 72 72 61 onstraint[] arra
12d20 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 63 y.. /// c
12d30 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 65 6e 74 72 ontains one entr
12d40 79 20 66 6f 72 20 65 61 63 68 20 63 6f 6e 73 74 y for each const
12d50 72 61 69 6e 74 2e 20 54 68 65 72 65 20 77 69 6c raint. There wil
12d60 6c 20 62 65 20 65 78 61 63 74 6c 79 0d 0a 20 20 l be exactly..
12d70 20 20 20 20 20 20 2f 2f 2f 20 6e 43 6f 6e 73 74 /// nConst
12d80 72 61 69 6e 74 20 65 6e 74 72 69 65 73 20 69 6e raint entries in
12d90 20 74 68 61 74 20 61 72 72 61 79 2e 0d 0a 20 20 that array...
12da0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
12db0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
12dc0 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
12dd0 2f 2f 20 45 61 63 68 20 63 6f 6e 73 74 72 61 69 // Each constrai
12de0 6e 74 20 77 69 6c 6c 20 63 6f 72 72 65 73 70 6f nt will correspo
12df0 6e 64 20 74 6f 20 61 20 74 65 72 6d 20 69 6e 20 nd to a term in
12e00 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 the WHERE clause
12e10 20 6f 72 20 69 6e 0d 0a 20 20 20 20 20 20 20 20 or in..
12e20 2f 2f 2f 20 61 20 55 53 49 4e 47 20 6f 72 20 4f /// a USING or O
12e30 4e 20 63 6c 61 75 73 65 20 74 68 61 74 20 69 73 N clause that is
12e40 20 6f 66 20 74 68 65 20 66 6f 72 6d 0d 0a 20 20 of the form..
12e50 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
12e60 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
12e70 63 6f 64 65 3e 0d 0a 20 20 20 20 20 20 20 20 2f code>.. /
12e80 2f 2f 20 20 20 20 20 63 6f 6c 75 6d 6e 20 4f 50 // column OP
12e90 20 45 58 50 52 0d 0a 20 20 20 20 20 20 20 20 2f EXPR.. /
12ea0 2f 2f 20 3c 2f 63 6f 64 65 3e 0d 0a 20 20 20 20 // </code>..
12eb0 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a /// <para>..
12ec0 20 20 20 20 20 20 20 20 2f 2f 2f 20 57 68 65 72 /// Wher
12ed0 65 20 22 63 6f 6c 75 6d 6e 22 20 69 73 20 61 20 e "column" is a
12ee0 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 20 76 69 column in the vi
12ef0 72 74 75 61 6c 20 74 61 62 6c 65 2c 20 4f 50 20 rtual table, OP
12f00 69 73 20 61 6e 20 6f 70 65 72 61 74 6f 72 0d 0a is an operator..
12f10 20 20 20 20 20 20 20 20 2f 2f 2f 20 6c 69 6b 65 /// like
12f20 20 22 3d 22 20 6f 72 20 22 26 6c 74 3b 22 2c 20 "=" or "<",
12f30 61 6e 64 20 45 58 50 52 20 69 73 20 61 6e 20 61 and EXPR is an a
12f40 72 62 69 74 72 61 72 79 20 65 78 70 72 65 73 73 rbitrary express
12f50 69 6f 6e 2e 20 53 6f 2c 20 66 6f 72 0d 0a 20 20 ion. So, for..
12f60 20 20 20 20 20 20 2f 2f 2f 20 65 78 61 6d 70 6c /// exampl
12f70 65 2c 20 69 66 20 74 68 65 20 57 48 45 52 45 20 e, if the WHERE
12f80 63 6c 61 75 73 65 20 63 6f 6e 74 61 69 6e 65 64 clause contained
12f90 20 61 20 74 65 72 6d 20 6c 69 6b 65 20 74 68 69 a term like thi
12fa0 73 3a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s:.. ///
12fb0 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
12fc0 20 2f 2f 2f 20 3c 63 6f 64 65 3e 0d 0a 20 20 20 /// <code>..
12fd0 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 20 20 20 ///
12fe0 20 20 61 20 3d 20 35 0d 0a 20 20 20 20 20 20 20 a = 5..
12ff0 20 2f 2f 2f 20 3c 2f 63 6f 64 65 3e 0d 0a 20 20 /// </code>..
13000 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e /// <para>
13010 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
13020 65 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 63 6f en one of the co
13030 6e 73 74 72 61 69 6e 74 73 20 77 6f 75 6c 64 20 nstraints would
13040 62 65 20 6f 6e 20 74 68 65 20 22 61 22 20 63 6f be on the "a" co
13050 6c 75 6d 6e 20 77 69 74 68 0d 0a 20 20 20 20 20 lumn with..
13060 20 20 20 2f 2f 2f 20 6f 70 65 72 61 74 6f 72 20 /// operator
13070 22 3d 22 20 61 6e 64 20 61 6e 20 65 78 70 72 65 "=" and an expre
13080 73 73 69 6f 6e 20 6f 66 20 22 35 22 2e 20 43 6f ssion of "5". Co
13090 6e 73 74 72 61 69 6e 74 73 20 6e 65 65 64 20 6e nstraints need n
130a0 6f 74 20 68 61 76 65 20 61 0d 0a 20 20 20 20 20 ot have a..
130b0 20 20 20 2f 2f 2f 20 6c 69 74 65 72 61 6c 20 72 /// literal r
130c0 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 epresentation of
130d0 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 the WHERE claus
130e0 65 2e 20 54 68 65 20 71 75 65 72 79 20 6f 70 74 e. The query opt
130f0 69 6d 69 7a 65 72 0d 0a 20 20 20 20 20 20 20 20 imizer..
13100 2f 2f 2f 20 6d 69 67 68 74 20 6d 61 6b 65 20 74 /// might make t
13110 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 73 20 74 ransformations t
13120 6f 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 o the WHERE clau
13130 73 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 se in order to e
13140 78 74 72 61 63 74 0d 0a 20 20 20 20 20 20 20 20 xtract..
13150 2f 2f 2f 20 61 73 20 6d 61 6e 79 20 63 6f 6e 73 /// as many cons
13160 74 72 61 69 6e 74 73 20 61 73 20 69 74 20 63 61 traints as it ca
13170 6e 2e 20 53 6f 2c 20 66 6f 72 20 65 78 61 6d 70 n. So, for examp
13180 6c 65 2c 20 69 66 20 74 68 65 20 57 48 45 52 45 le, if the WHERE
13190 20 63 6c 61 75 73 65 0d 0a 20 20 20 20 20 20 20 clause..
131a0 20 2f 2f 2f 20 63 6f 6e 74 61 69 6e 65 64 20 73 /// contained s
131b0 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 68 omething like th
131c0 69 73 3a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f is:.. ///
131d0 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 </para>..
131e0 20 20 2f 2f 2f 20 3c 63 6f 64 65 3e 0d 0a 20 20 /// <code>..
131f0 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 20 20 ///
13200 20 20 20 78 20 42 45 54 57 45 45 4e 20 31 30 20 x BETWEEN 10
13210 41 4e 44 20 31 30 30 20 41 4e 44 20 39 39 39 26 AND 100 AND 999&
13220 67 74 3b 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f gt;y.. //
13230 2f 20 3c 2f 63 6f 64 65 3e 0d 0a 20 20 20 20 20 / </code>..
13240 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 /// <para>..
13250 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 71 /// The q
13260 75 65 72 79 20 6f 70 74 69 6d 69 7a 65 72 20 6d uery optimizer m
13270 69 67 68 74 20 74 72 61 6e 73 6c 61 74 65 20 74 ight translate t
13280 68 69 73 20 69 6e 74 6f 20 74 68 72 65 65 20 73 his into three s
13290 65 70 61 72 61 74 65 0d 0a 20 20 20 20 20 20 20 eparate..
132a0 20 2f 2f 2f 20 63 6f 6e 73 74 72 61 69 6e 74 73 /// constraints
132b0 3a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c :.. /// <
132c0 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 /para>..
132d0 2f 2f 2f 20 3c 63 6f 64 65 3e 0d 0a 20 20 20 20 /// <code>..
132e0 20 20 20 20 2f 2f 2f 20 20 20 20 20 20 20 20 20 ///
132f0 20 78 20 26 67 74 3b 3d 20 31 30 0d 0a 20 20 20 x >= 10..
13300 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 20 20 20 ///
13310 20 20 78 20 26 6c 74 3b 3d 20 31 30 30 0d 0a 20 x <= 100..
13320 20 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 20 ///
13330 20 20 20 20 79 20 26 6c 74 3b 20 39 39 39 0d 0a y < 999..
13340 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 63 6f /// </co
13350 64 65 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f de>.. ///
13360 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 <para>..
13370 20 2f 2f 2f 20 46 6f 72 20 65 61 63 68 20 63 6f /// For each co
13380 6e 73 74 72 61 69 6e 74 2c 20 74 68 65 20 61 43 nstraint, the aC
13390 6f 6e 73 74 72 61 69 6e 74 5b 5d 2e 69 43 6f 6c onstraint[].iCol
133a0 75 6d 6e 20 66 69 65 6c 64 20 69 6e 64 69 63 61 umn field indica
133b0 74 65 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f tes.. ///
133c0 20 77 68 69 63 68 20 63 6f 6c 75 6d 6e 20 61 70 which column ap
133d0 70 65 61 72 73 20 6f 6e 20 74 68 65 20 6c 65 66 pears on the lef
133e0 74 2d 68 61 6e 64 20 73 69 64 65 20 6f 66 20 74 t-hand side of t
133f0 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 2e 20 54 he constraint. T
13400 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 he.. ///
13410 66 69 72 73 74 20 63 6f 6c 75 6d 6e 20 6f 66 20 first column of
13420 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c the virtual tabl
13430 65 20 69 73 20 63 6f 6c 75 6d 6e 20 30 2e 20 54 e is column 0. T
13440 68 65 20 72 6f 77 69 64 20 6f 66 20 74 68 65 0d he rowid of the.
13450 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 76 69 72 . /// vir
13460 74 75 61 6c 20 74 61 62 6c 65 20 69 73 20 63 6f tual table is co
13470 6c 75 6d 6e 20 2d 31 2e 20 54 68 65 20 61 43 6f lumn -1. The aCo
13480 6e 73 74 72 61 69 6e 74 5b 5d 2e 6f 70 20 66 69 nstraint[].op fi
13490 65 6c 64 20 69 6e 64 69 63 61 74 65 73 0d 0a 20 eld indicates..
134a0 20 20 20 20 20 20 20 2f 2f 2f 20 77 68 69 63 68 /// which
134b0 20 6f 70 65 72 61 74 6f 72 20 69 73 20 75 73 65 operator is use
134c0 64 2e 20 54 68 65 20 53 51 4c 49 54 45 5f 49 4e d. The SQLITE_IN
134d0 44 45 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 2a DEX_CONSTRAINT_*
134e0 20 63 6f 6e 73 74 61 6e 74 73 20 6d 61 70 0d 0a constants map..
134f0 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6e 74 65 /// inte
13500 67 65 72 20 63 6f 6e 73 74 61 6e 74 73 20 69 6e ger constants in
13510 74 6f 20 6f 70 65 72 61 74 6f 72 20 76 61 6c 75 to operator valu
13520 65 73 2e 20 43 6f 6c 75 6d 6e 73 20 6f 63 63 75 es. Columns occu
13530 72 20 69 6e 20 74 68 65 20 6f 72 64 65 72 0d 0a r in the order..
13540 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 68 65 79 /// they
13550 20 77 65 72 65 20 64 65 66 69 6e 65 64 20 62 79 were defined by
13560 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 73 71 6c the call to sql
13570 69 74 65 33 5f 64 65 63 6c 61 72 65 5f 76 74 61 ite3_declare_vta
13580 62 28 29 20 69 6e 20 74 68 65 0d 0a 20 20 20 20 b() in the..
13590 20 20 20 20 2f 2f 2f 20 78 43 72 65 61 74 65 20 /// xCreate
135a0 6f 72 20 78 43 6f 6e 6e 65 63 74 20 6d 65 74 68 or xConnect meth
135b0 6f 64 2e 20 48 69 64 64 65 6e 20 63 6f 6c 75 6d od. Hidden colum
135c0 6e 73 20 61 72 65 20 63 6f 75 6e 74 65 64 20 77 ns are counted w
135d0 68 65 6e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f hen.. ///
135e0 20 64 65 74 65 72 6d 69 6e 69 6e 67 20 74 68 65 determining the
135f0 20 63 6f 6c 75 6d 6e 20 69 6e 64 65 78 2e 0d 0a column index...
13600 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
13610 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
13620 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 <para>..
13630 20 2f 2f 2f 20 54 68 65 20 61 43 6f 6e 73 74 72 /// The aConstr
13640 61 69 6e 74 5b 5d 20 61 72 72 61 79 20 63 6f 6e aint[] array con
13650 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61 74 69 6f tains informatio
13660 6e 20 61 62 6f 75 74 20 61 6c 6c 20 63 6f 6e 73 n about all cons
13670 74 72 61 69 6e 74 73 0d 0a 20 20 20 20 20 20 20 traints..
13680 20 2f 2f 2f 20 74 68 61 74 20 61 70 70 6c 79 20 /// that apply
13690 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 to the virtual t
136a0 61 62 6c 65 2e 20 42 75 74 20 73 6f 6d 65 20 6f able. But some o
136b0 66 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 f the constraint
136c0 73 20 6d 69 67 68 74 0d 0a 20 20 20 20 20 20 20 s might..
136d0 20 2f 2f 2f 20 6e 6f 74 20 62 65 20 75 73 61 62 /// not be usab
136e0 6c 65 20 62 65 63 61 75 73 65 20 6f 66 20 74 68 le because of th
136f0 65 20 77 61 79 20 74 61 62 6c 65 73 20 61 72 65 e way tables are
13700 20 6f 72 64 65 72 65 64 20 69 6e 20 61 20 6a 6f ordered in a jo
13710 69 6e 2e 20 54 68 65 0d 0a 20 20 20 20 20 20 20 in. The..
13720 20 2f 2f 2f 20 78 42 65 73 74 49 6e 64 65 78 20 /// xBestIndex
13730 6d 65 74 68 6f 64 20 6d 75 73 74 20 74 68 65 72 method must ther
13740 65 66 6f 72 65 20 6f 6e 6c 79 20 63 6f 6e 73 69 efore only consi
13750 64 65 72 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 der constraints
13760 74 68 61 74 0d 0a 20 20 20 20 20 20 20 20 2f 2f that.. //
13770 2f 20 68 61 76 65 20 61 6e 20 61 43 6f 6e 73 74 / have an aConst
13780 72 61 69 6e 74 5b 5d 2e 75 73 61 62 6c 65 20 66 raint[].usable f
13790 6c 61 67 20 77 68 69 63 68 20 69 73 20 74 72 75 lag which is tru
137a0 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
137b0 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
137c0 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
137d0 20 20 20 20 20 2f 2f 2f 20 49 6e 20 61 64 64 69 /// In addi
137e0 74 69 6f 6e 20 74 6f 20 57 48 45 52 45 20 63 6c tion to WHERE cl
137f0 61 75 73 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 ause constraints
13800 2c 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 , the SQLite cor
13810 65 20 61 6c 73 6f 20 74 65 6c 6c 73 0d 0a 20 20 e also tells..
13820 20 20 20 20 20 20 2f 2f 2f 20 74 68 65 20 78 42 /// the xB
13830 65 73 74 49 6e 64 65 78 20 6d 65 74 68 6f 64 20 estIndex method
13840 61 62 6f 75 74 20 74 68 65 20 4f 52 44 45 52 20 about the ORDER
13850 42 59 20 63 6c 61 75 73 65 2e 20 28 49 6e 20 61 BY clause. (In a
13860 6e 20 61 67 67 72 65 67 61 74 65 0d 0a 20 20 20 n aggregate..
13870 20 20 20 20 20 2f 2f 2f 20 71 75 65 72 79 2c 20 /// query,
13880 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 the SQLite core
13890 6d 69 67 68 74 20 70 75 74 20 69 6e 20 47 52 4f might put in GRO
138a0 55 50 20 42 59 20 63 6c 61 75 73 65 20 69 6e 66 UP BY clause inf
138b0 6f 72 6d 61 74 69 6f 6e 20 69 6e 0d 0a 20 20 20 ormation in..
138c0 20 20 20 20 20 2f 2f 2f 20 70 6c 61 63 65 20 6f /// place o
138d0 66 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 f the ORDER BY c
138e0 6c 61 75 73 65 20 69 6e 66 6f 72 6d 61 74 69 6f lause informatio
138f0 6e 2c 20 62 75 74 20 74 68 69 73 20 66 61 63 74 n, but this fact
13900 20 73 68 6f 75 6c 64 20 6e 6f 74 0d 0a 20 20 20 should not..
13910 20 20 20 20 20 2f 2f 2f 20 6d 61 6b 65 20 61 6e /// make an
13920 79 20 64 69 66 66 65 72 65 6e 63 65 20 74 6f 20 y difference to
13930 74 68 65 20 78 42 65 73 74 49 6e 64 65 78 20 6d the xBestIndex m
13940 65 74 68 6f 64 2e 29 20 49 66 20 61 6c 6c 20 74 ethod.) If all t
13950 65 72 6d 73 20 6f 66 20 74 68 65 0d 0a 20 20 20 erms of the..
13960 20 20 20 20 20 2f 2f 2f 20 4f 52 44 45 52 20 42 /// ORDER B
13970 59 20 63 6c 61 75 73 65 20 61 72 65 20 63 6f 6c Y clause are col
13980 75 6d 6e 73 20 69 6e 20 74 68 65 20 76 69 72 74 umns in the virt
13990 75 61 6c 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 ual table, then
139a0 6e 4f 72 64 65 72 42 79 0d 0a 20 20 20 20 20 20 nOrderBy..
139b0 20 20 2f 2f 2f 20 77 69 6c 6c 20 62 65 20 74 68 /// will be th
139c0 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 65 72 6d e number of term
139d0 73 20 69 6e 20 74 68 65 20 4f 52 44 45 52 20 42 s in the ORDER B
139e0 59 20 63 6c 61 75 73 65 20 61 6e 64 20 74 68 65 Y clause and the
139f0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 4f .. /// aO
13a00 72 64 65 72 42 79 5b 5d 20 61 72 72 61 79 20 77 rderBy[] array w
13a10 69 6c 6c 20 69 64 65 6e 74 69 66 79 20 74 68 65 ill identify the
13a20 20 63 6f 6c 75 6d 6e 20 66 6f 72 20 65 61 63 68 column for each
13a30 20 74 65 72 6d 20 69 6e 20 74 68 65 0d 0a 20 20 term in the..
13a40 20 20 20 20 20 20 2f 2f 2f 20 6f 72 64 65 72 20 /// order
13a50 62 79 20 63 6c 61 75 73 65 20 61 6e 64 20 77 68 by clause and wh
13a60 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 61 ether or not tha
13a70 74 20 63 6f 6c 75 6d 6e 20 69 73 20 41 53 43 20 t column is ASC
13a80 6f 72 20 44 45 53 43 2e 0d 0a 20 20 20 20 20 20 or DESC...
13a90 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
13aa0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
13ab0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 32 >.. /// 2
13ac0 2e 33 2e 32 20 4f 75 74 70 75 74 73 0d 0a 20 20 .3.2 Outputs..
13ad0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
13ae0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
13af0 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
13b00 2f 2f 20 47 69 76 65 6e 20 61 6c 6c 20 6f 66 20 // Given all of
13b10 74 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 the information
13b20 61 62 6f 76 65 2c 20 74 68 65 20 6a 6f 62 20 6f above, the job o
13b30 66 20 74 68 65 20 78 42 65 73 74 49 6e 64 65 78 f the xBestIndex
13b40 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6d 65 .. /// me
13b50 74 68 6f 64 20 69 74 20 74 6f 20 66 69 67 75 72 thod it to figur
13b60 65 20 6f 75 74 20 74 68 65 20 62 65 73 74 20 77 e out the best w
13b70 61 79 20 74 6f 20 73 65 61 72 63 68 20 74 68 65 ay to search the
13b80 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d virtual table..
13b90 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
13ba0 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
13bb0 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 / <para>..
13bc0 20 20 2f 2f 2f 20 54 68 65 20 78 42 65 73 74 49 /// The xBestI
13bd0 6e 64 65 78 20 6d 65 74 68 6f 64 20 66 69 6c 6c ndex method fill
13be0 73 20 74 68 65 20 69 64 78 4e 75 6d 20 61 6e 64 s the idxNum and
13bf0 20 69 64 78 53 74 72 20 66 69 65 6c 64 73 20 77 idxStr fields w
13c00 69 74 68 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ith.. ///
13c10 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 information tha
13c20 74 20 63 6f 6d 6d 75 6e 69 63 61 74 65 73 20 61 t communicates a
13c30 6e 20 69 6e 64 65 78 69 6e 67 20 73 74 72 61 74 n indexing strat
13c40 65 67 79 20 74 6f 20 74 68 65 20 78 46 69 6c 74 egy to the xFilt
13c50 65 72 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 er.. ///
13c60 6d 65 74 68 6f 64 2e 20 54 68 65 20 69 6e 66 6f method. The info
13c70 72 6d 61 74 69 6f 6e 20 69 6e 20 69 64 78 4e 75 rmation in idxNu
13c80 6d 20 61 6e 64 20 69 64 78 53 74 72 20 69 73 20 m and idxStr is
13c90 61 72 62 69 74 72 61 72 79 20 61 73 20 66 61 72 arbitrary as far
13ca0 20 61 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f as.. ///
13cb0 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 the SQLite core
13cc0 20 69 73 20 63 6f 6e 63 65 72 6e 65 64 2e 20 54 is concerned. T
13cd0 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6a he SQLite core j
13ce0 75 73 74 20 63 6f 70 69 65 73 20 74 68 65 0d 0a ust copies the..
13cf0 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6e 66 6f /// info
13d00 72 6d 61 74 69 6f 6e 20 74 68 72 6f 75 67 68 20 rmation through
13d10 74 6f 20 74 68 65 20 78 46 69 6c 74 65 72 20 6d to the xFilter m
13d20 65 74 68 6f 64 2e 20 41 6e 79 20 64 65 73 69 72 ethod. Any desir
13d30 65 64 20 6d 65 61 6e 69 6e 67 20 63 61 6e 0d 0a ed meaning can..
13d40 20 20 20 20 20 20 20 20 2f 2f 2f 20 62 65 20 61 /// be a
13d50 73 73 69 67 6e 65 64 20 74 6f 20 69 64 78 4e 75 ssigned to idxNu
13d60 6d 20 61 6e 64 20 69 64 78 53 74 72 20 61 73 20 m and idxStr as
13d70 6c 6f 6e 67 20 61 73 20 78 42 65 73 74 49 6e 64 long as xBestInd
13d80 65 78 20 61 6e 64 20 78 46 69 6c 74 65 72 0d 0a ex and xFilter..
13d90 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 67 72 65 /// agre
13da0 65 20 6f 6e 20 77 68 61 74 20 74 68 61 74 20 6d e on what that m
13db0 65 61 6e 69 6e 67 20 69 73 2e 0d 0a 20 20 20 20 eaning is...
13dc0 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d /// </para>.
13dd0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
13de0 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
13df0 20 54 68 65 20 69 64 78 53 74 72 20 76 61 6c 75 The idxStr valu
13e00 65 20 6d 61 79 20 62 65 20 61 20 73 74 72 69 6e e may be a strin
13e10 67 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 g obtained from
13e20 61 6e 20 53 51 4c 69 74 65 20 6d 65 6d 6f 72 79 an SQLite memory
13e30 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 6c .. /// al
13e40 6c 6f 63 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f location functio
13e50 6e 20 73 75 63 68 20 61 73 20 73 71 6c 69 74 65 n such as sqlite
13e60 33 5f 6d 70 72 69 6e 74 66 28 29 2e 20 49 66 20 3_mprintf(). If
13e70 74 68 69 73 20 69 73 20 74 68 65 20 63 61 73 65 this is the case
13e80 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 ,.. /// t
13e90 68 65 6e 20 74 68 65 20 6e 65 65 64 54 6f 46 72 hen the needToFr
13ea0 65 65 49 64 78 53 74 72 20 66 6c 61 67 20 6d 75 eeIdxStr flag mu
13eb0 73 74 20 62 65 20 73 65 74 20 74 6f 20 74 72 75 st be set to tru
13ec0 65 20 73 6f 20 74 68 61 74 20 74 68 65 0d 0a 20 e so that the..
13ed0 20 20 20 20 20 20 20 2f 2f 2f 20 53 51 4c 69 74 /// SQLit
13ee0 65 20 63 6f 72 65 20 77 69 6c 6c 20 6b 6e 6f 77 e core will know
13ef0 20 74 6f 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 to call sqlite3
13f00 5f 66 72 65 65 28 29 20 6f 6e 20 74 68 61 74 20 _free() on that
13f10 73 74 72 69 6e 67 20 77 68 65 6e 20 69 74 0d 0a string when it..
13f20 20 20 20 20 20 20 20 20 2f 2f 2f 20 68 61 73 20 /// has
13f30 66 69 6e 69 73 68 65 64 20 77 69 74 68 20 69 74 finished with it
13f40 2c 20 61 6e 64 20 74 68 75 73 20 61 76 6f 69 64 , and thus avoid
13f50 20 61 20 6d 65 6d 6f 72 79 20 6c 65 61 6b 2e 0d a memory leak..
13f60 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
13f70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
13f80 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 / <para>..
13f90 20 20 2f 2f 2f 20 49 66 20 74 68 65 20 76 69 72 /// If the vir
13fa0 74 75 61 6c 20 74 61 62 6c 65 20 77 69 6c 6c 20 tual table will
13fb0 6f 75 74 70 75 74 20 72 6f 77 73 20 69 6e 20 74 output rows in t
13fc0 68 65 20 6f 72 64 65 72 20 73 70 65 63 69 66 69 he order specifi
13fd0 65 64 20 62 79 20 74 68 65 0d 0a 20 20 20 20 20 ed by the..
13fe0 20 20 20 2f 2f 2f 20 4f 52 44 45 52 20 42 59 20 /// ORDER BY
13ff0 63 6c 61 75 73 65 2c 20 74 68 65 6e 20 74 68 65 clause, then the
14000 20 6f 72 64 65 72 42 79 43 6f 6e 73 75 6d 65 64 orderByConsumed
14010 20 66 6c 61 67 20 6d 61 79 20 62 65 20 73 65 74 flag may be set
14020 20 74 6f 20 74 72 75 65 2e 0d 0a 20 20 20 20 20 to true...
14030 20 20 20 2f 2f 2f 20 49 66 20 74 68 65 20 6f 75 /// If the ou
14040 74 70 75 74 20 69 73 20 6e 6f 74 20 61 75 74 6f tput is not auto
14050 6d 61 74 69 63 61 6c 6c 79 20 69 6e 20 74 68 65 matically in the
14060 20 63 6f 72 72 65 63 74 20 6f 72 64 65 72 20 74 correct order t
14070 68 65 6e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f hen.. ///
14080 20 6f 72 64 65 72 42 79 43 6f 6e 73 75 6d 65 64 orderByConsumed
14090 20 6d 75 73 74 20 62 65 20 6c 65 66 74 20 69 6e must be left in
140a0 20 69 74 73 20 64 65 66 61 75 6c 74 20 66 61 6c its default fal
140b0 73 65 20 73 65 74 74 69 6e 67 2e 20 54 68 69 73 se setting. This
140c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 77 69 .. /// wi
140d0 6c 6c 20 69 6e 64 69 63 61 74 65 20 74 6f 20 74 ll indicate to t
140e0 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 74 he SQLite core t
140f0 68 61 74 20 69 74 20 77 69 6c 6c 20 6e 65 65 64 hat it will need
14100 20 74 6f 20 64 6f 20 61 20 73 65 70 61 72 61 74 to do a separat
14110 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 e.. /// s
14120 6f 72 74 69 6e 67 20 70 61 73 73 20 6f 76 65 72 orting pass over
14130 20 74 68 65 20 64 61 74 61 20 61 66 74 65 72 20 the data after
14140 69 74 20 63 6f 6d 65 73 20 6f 75 74 20 6f 66 20 it comes out of
14150 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c the virtual tabl
14160 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
14170 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
14180 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
14190 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 65 73 74 /// The est
141a0 69 6d 61 74 65 64 43 6f 73 74 20 66 69 65 6c 64 imatedCost field
141b0 20 73 68 6f 75 6c 64 20 62 65 20 73 65 74 20 74 should be set t
141c0 6f 20 74 68 65 20 65 73 74 69 6d 61 74 65 64 20 o the estimated
141d0 6e 75 6d 62 65 72 20 6f 66 0d 0a 20 20 20 20 20 number of..
141e0 20 20 20 2f 2f 2f 20 64 69 73 6b 20 61 63 63 65 /// disk acce
141f0 73 73 20 6f 70 65 72 61 74 69 6f 6e 73 20 72 65 ss operations re
14200 71 75 69 72 65 64 20 74 6f 20 65 78 65 63 75 74 quired to execut
14210 65 20 74 68 69 73 20 71 75 65 72 79 20 61 67 61 e this query aga
14220 69 6e 73 74 20 74 68 65 0d 0a 20 20 20 20 20 20 inst the..
14230 20 20 2f 2f 2f 20 76 69 72 74 75 61 6c 20 74 61 /// virtual ta
14240 62 6c 65 2e 20 54 68 65 20 53 51 4c 69 74 65 20 ble. The SQLite
14250 63 6f 72 65 20 77 69 6c 6c 20 6f 66 74 65 6e 20 core will often
14260 63 61 6c 6c 20 78 42 65 73 74 49 6e 64 65 78 20 call xBestIndex
14270 6d 75 6c 74 69 70 6c 65 0d 0a 20 20 20 20 20 20 multiple..
14280 20 20 2f 2f 2f 20 74 69 6d 65 73 20 77 69 74 68 /// times with
14290 20 64 69 66 66 65 72 65 6e 74 20 63 6f 6e 73 74 different const
142a0 72 61 69 6e 74 73 2c 20 6f 62 74 61 69 6e 20 6d raints, obtain m
142b0 75 6c 74 69 70 6c 65 20 63 6f 73 74 20 65 73 74 ultiple cost est
142c0 69 6d 61 74 65 73 2c 0d 0a 20 20 20 20 20 20 20 imates,..
142d0 20 2f 2f 2f 20 74 68 65 6e 20 63 68 6f 6f 73 65 /// then choose
142e0 20 74 68 65 20 71 75 65 72 79 20 70 6c 61 6e 20 the query plan
142f0 74 68 61 74 20 67 69 76 65 73 20 74 68 65 20 6c that gives the l
14300 6f 77 65 73 74 20 65 73 74 69 6d 61 74 65 2e 0d owest estimate..
14310 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
14320 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
14330 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 / <para>..
14340 20 20 2f 2f 2f 20 54 68 65 20 61 43 6f 6e 73 74 /// The aConst
14350 72 61 69 6e 74 55 73 61 67 65 5b 5d 20 61 72 72 raintUsage[] arr
14360 61 79 20 63 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 ay contains one
14370 65 6c 65 6d 65 6e 74 20 66 6f 72 20 65 61 63 68 element for each
14380 20 6f 66 20 74 68 65 0d 0a 20 20 20 20 20 20 20 of the..
14390 20 2f 2f 2f 20 6e 43 6f 6e 73 74 72 61 69 6e 74 /// nConstraint
143a0 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 69 6e 20 constraints in
143b0 74 68 65 20 69 6e 70 75 74 73 20 73 65 63 74 69 the inputs secti
143c0 6f 6e 20 6f 66 20 74 68 65 0d 0a 20 20 20 20 20 on of the..
143d0 20 20 20 2f 2f 2f 20 73 71 6c 69 74 65 33 5f 69 /// sqlite3_i
143e0 6e 64 65 78 5f 69 6e 66 6f 20 73 74 72 75 63 74 ndex_info struct
143f0 75 72 65 2e 20 54 68 65 20 61 43 6f 6e 73 74 72 ure. The aConstr
14400 61 69 6e 74 55 73 61 67 65 5b 5d 20 61 72 72 61 aintUsage[] arra
14410 79 20 69 73 20 75 73 65 64 0d 0a 20 20 20 20 20 y is used..
14420 20 20 20 2f 2f 2f 20 62 79 20 78 42 65 73 74 49 /// by xBestI
14430 6e 64 65 78 20 74 6f 20 74 65 6c 6c 20 74 68 65 ndex to tell the
14440 20 63 6f 72 65 20 68 6f 77 20 69 74 20 69 73 20 core how it is
14450 75 73 69 6e 67 20 74 68 65 20 63 6f 6e 73 74 72 using the constr
14460 61 69 6e 74 73 2e 0d 0a 20 20 20 20 20 20 20 20 aints...
14470 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 /// </para>..
14480 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d /// <para>.
14490 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
144a0 20 78 42 65 73 74 49 6e 64 65 78 20 6d 65 74 68 xBestIndex meth
144b0 6f 64 20 6d 61 79 20 73 65 74 20 61 43 6f 6e 73 od may set aCons
144c0 74 72 61 69 6e 74 55 73 61 67 65 5b 5d 2e 61 72 traintUsage[].ar
144d0 67 76 49 6e 64 65 78 20 65 6e 74 72 69 65 73 0d gvIndex entries.
144e0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 6f 20 . /// to
144f0 76 61 6c 75 65 73 20 67 72 65 61 74 65 72 20 74 values greater t
14500 68 61 6e 20 6f 6e 65 2e 20 45 78 61 63 74 6c 79 han one. Exactly
14510 20 6f 6e 65 20 65 6e 74 72 79 20 73 68 6f 75 6c one entry shoul
14520 64 20 62 65 20 73 65 74 20 74 6f 20 31 2c 0d 0a d be set to 1,..
14530 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 6e 6f 74 /// anot
14540 68 65 72 20 74 6f 20 32 2c 20 61 6e 6f 74 68 65 her to 2, anothe
14550 72 20 74 6f 20 33 2c 20 61 6e 64 20 73 6f 20 66 r to 3, and so f
14560 6f 72 74 68 20 75 70 20 74 6f 20 61 73 20 6d 61 orth up to as ma
14570 6e 79 20 6f 72 20 61 73 20 66 65 77 20 61 73 0d ny or as few as.
14580 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 68 65 . /// the
14590 20 78 42 65 73 74 49 6e 64 65 78 20 6d 65 74 68 xBestIndex meth
145a0 6f 64 20 77 61 6e 74 73 2e 20 54 68 65 20 45 58 od wants. The EX
145b0 50 52 20 6f 66 20 74 68 65 20 63 6f 72 72 65 73 PR of the corres
145c0 70 6f 6e 64 69 6e 67 0d 0a 20 20 20 20 20 20 20 ponding..
145d0 20 2f 2f 2f 20 63 6f 6e 73 74 72 61 69 6e 74 73 /// constraints
145e0 20 77 69 6c 6c 20 74 68 65 6e 20 62 65 20 70 61 will then be pa
145f0 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 20 61 ssed in as the a
14600 72 67 76 5b 5d 20 70 61 72 61 6d 65 74 65 72 73 rgv[] parameters
14610 20 74 6f 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f to.. ///
14620 20 78 46 69 6c 74 65 72 2e 0d 0a 20 20 20 20 20 xFilter...
14630 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a /// </para>..
14640 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
14650 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
14660 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 For example, if
14670 74 68 65 20 61 43 6f 6e 73 74 72 61 69 6e 74 5b the aConstraint[
14680 33 5d 2e 61 72 67 76 49 6e 64 65 78 20 69 73 20 3].argvIndex is
14690 73 65 74 20 74 6f 20 31 2c 20 74 68 65 6e 20 77 set to 1, then w
146a0 68 65 6e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f hen.. ///
146b0 20 78 46 69 6c 74 65 72 20 69 73 20 63 61 6c 6c xFilter is call
146c0 65 64 2c 20 74 68 65 20 61 72 67 76 5b 30 5d 20 ed, the argv[0]
146d0 70 61 73 73 65 64 20 74 6f 20 78 46 69 6c 74 65 passed to xFilte
146e0 72 20 77 69 6c 6c 20 68 61 76 65 20 74 68 65 20 r will have the
146f0 45 58 50 52 0d 0a 20 20 20 20 20 20 20 20 2f 2f EXPR.. //
14700 2f 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 61 / value of the a
14710 43 6f 6e 73 74 72 61 69 6e 74 5b 33 5d 20 63 6f Constraint[3] co
14720 6e 73 74 72 61 69 6e 74 2e 0d 0a 20 20 20 20 20 nstraint...
14730 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a /// </para>..
14740 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
14750 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
14760 42 79 20 64 65 66 61 75 6c 74 2c 20 74 68 65 20 By default, the
14770 53 51 4c 69 74 65 20 63 6f 72 65 20 64 6f 75 62 SQLite core doub
14780 6c 65 20 63 68 65 63 6b 73 20 61 6c 6c 20 63 6f le checks all co
14790 6e 73 74 72 61 69 6e 74 73 20 6f 6e 20 65 61 63 nstraints on eac
147a0 68 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 72 h.. /// r
147b0 6f 77 20 6f 66 20 74 68 65 20 76 69 72 74 75 61 ow of the virtua
147c0 6c 20 74 61 62 6c 65 20 74 68 61 74 20 69 74 20 l table that it
147d0 72 65 63 65 69 76 65 73 2e 20 49 66 20 73 75 63 receives. If suc
147e0 68 20 61 20 63 68 65 63 6b 20 69 73 0d 0a 20 20 h a check is..
147f0 20 20 20 20 20 20 2f 2f 2f 20 72 65 64 75 6e 64 /// redund
14800 61 6e 74 2c 20 74 68 65 20 78 42 65 73 74 46 69 ant, the xBestFi
14810 6c 74 65 72 20 6d 65 74 68 6f 64 20 63 61 6e 20 lter method can
14820 73 75 70 70 72 65 73 73 20 74 68 61 74 20 64 6f suppress that do
14830 75 62 6c 65 2d 63 68 65 63 6b 20 62 79 0d 0a 20 uble-check by..
14840 20 20 20 20 20 20 20 2f 2f 2f 20 73 65 74 74 69 /// setti
14850 6e 67 20 61 43 6f 6e 73 74 72 61 69 6e 74 55 73 ng aConstraintUs
14860 61 67 65 5b 5d 2e 6f 6d 69 74 2e 0d 0a 20 20 20 age[].omit...
14870 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e /// </para>
14880 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
14890 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
148a0 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
148b0 65 3d 22 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 e="pVtab">..
148c0 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 /// The nati
148d0 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 ve pointer to th
148e0 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20 64 e sqlite3_vtab d
148f0 65 72 69 76 65 64 20 73 74 72 75 63 74 75 72 65 erived structure
14900 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
14910 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 /param>..
14920 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
14930 3d 22 70 49 6e 64 65 78 22 3e 0d 0a 20 20 20 20 ="pIndex">..
14940 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 /// The nati
14950 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 ve pointer to th
14960 65 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f e sqlite3_index_
14970 69 6e 66 6f 20 73 74 72 75 63 74 75 72 65 2e 0d info structure..
14980 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
14990 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f aram>.. /
149a0 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 // <returns>..
149b0 20 20 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e /// A stan
149c0 64 61 72 64 20 53 51 4c 69 74 65 20 72 65 74 75 dard SQLite retu
149d0 72 6e 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 rn code...
149e0 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e /// </returns>
149f0 0d 0a 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 .. SQLite
14a00 45 72 72 6f 72 43 6f 64 65 20 78 42 65 73 74 49 ErrorCode xBestI
14a10 6e 64 65 78 28 0d 0a 20 20 20 20 20 20 20 20 20 ndex(..
14a20 20 20 20 49 6e 74 50 74 72 20 70 56 74 61 62 2c IntPtr pVtab,
14a30 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 6e .. In
14a40 74 50 74 72 20 70 49 6e 64 65 78 0d 0a 20 20 20 tPtr pIndex..
14a50 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 );....
14a60 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
14a70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14a80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14a90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14aa0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a //////////////..
14ab0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
14ac0 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
14ad0 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
14ae0 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 /// This me
14af0 74 68 6f 64 20 72 65 6c 65 61 73 65 73 20 61 20 thod releases a
14b00 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 61 20 connection to a
14b10 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 20 4f virtual table. O
14b20 6e 6c 79 20 74 68 65 0d 0a 20 20 20 20 20 20 20 nly the..
14b30 20 2f 2f 2f 20 73 71 6c 69 74 65 33 5f 76 74 61 /// sqlite3_vta
14b40 62 20 6f 62 6a 65 63 74 20 69 73 20 64 65 73 74 b object is dest
14b50 72 6f 79 65 64 2e 20 54 68 65 20 76 69 72 74 75 royed. The virtu
14b60 61 6c 20 74 61 62 6c 65 20 69 73 20 6e 6f 74 0d al table is not.
14b70 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 64 65 73 . /// des
14b80 74 72 6f 79 65 64 20 61 6e 64 20 61 6e 79 20 62 troyed and any b
14b90 61 63 6b 69 6e 67 20 73 74 6f 72 65 20 61 73 73 acking store ass
14ba0 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 ociated with the
14bb0 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 0d 0a virtual table..
14bc0 20 20 20 20 20 20 20 20 2f 2f 2f 20 70 65 72 73 /// pers
14bd0 69 73 74 73 2e 20 54 68 69 73 20 6d 65 74 68 6f ists. This metho
14be0 64 20 75 6e 64 6f 65 73 20 74 68 65 20 77 6f 72 d undoes the wor
14bf0 6b 20 6f 66 20 78 43 6f 6e 6e 65 63 74 2e 0d 0a k of xConnect...
14c00 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
14c10 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
14c20 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 <para>..
14c30 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 /// This method
14c40 20 69 73 20 61 20 64 65 73 74 72 75 63 74 6f 72 is a destructor
14c50 20 66 6f 72 20 61 20 63 6f 6e 6e 65 63 74 69 6f for a connectio
14c60 6e 20 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c n to the virtual
14c70 20 74 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 table...
14c80 20 2f 2f 2f 20 43 6f 6e 74 72 61 73 74 20 74 68 /// Contrast th
14c90 69 73 20 6d 65 74 68 6f 64 20 77 69 74 68 20 78 is method with x
14ca0 44 65 73 74 72 6f 79 2e 20 54 68 65 20 78 44 65 Destroy. The xDe
14cb0 73 74 72 6f 79 20 69 73 20 61 20 64 65 73 74 72 stroy is a destr
14cc0 75 63 74 6f 72 0d 0a 20 20 20 20 20 20 20 20 2f uctor.. /
14cd0 2f 2f 20 66 6f 72 20 74 68 65 20 65 6e 74 69 72 // for the entir
14ce0 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e e virtual table.
14cf0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
14d00 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
14d10 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 // <para>..
14d20 20 20 20 2f 2f 2f 20 54 68 65 20 78 44 69 73 63 /// The xDisc
14d30 6f 6e 6e 65 63 74 20 6d 65 74 68 6f 64 20 69 73 onnect method is
14d40 20 72 65 71 75 69 72 65 64 20 66 6f 72 20 65 76 required for ev
14d50 65 72 79 20 76 69 72 74 75 61 6c 20 74 61 62 6c ery virtual tabl
14d60 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 e.. /// i
14d70 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2c 20 74 mplementation, t
14d80 68 6f 75 67 68 20 69 74 20 69 73 20 61 63 63 65 hough it is acce
14d90 70 74 61 62 6c 65 20 66 6f 72 20 74 68 65 20 78 ptable for the x
14da0 44 69 73 63 6f 6e 6e 65 63 74 20 61 6e 64 0d 0a Disconnect and..
14db0 20 20 20 20 20 20 20 20 2f 2f 2f 20 78 44 65 73 /// xDes
14dc0 74 72 6f 79 20 6d 65 74 68 6f 64 73 20 74 6f 20 troy methods to
14dd0 62 65 20 74 68 65 20 73 61 6d 65 20 66 75 6e 63 be the same func
14de0 74 69 6f 6e 20 69 66 20 74 68 61 74 20 6d 61 6b tion if that mak
14df0 65 73 20 73 65 6e 73 65 20 66 6f 72 0d 0a 20 20 es sense for..
14e00 20 20 20 20 20 20 2f 2f 2f 20 74 68 65 20 70 61 /// the pa
14e10 72 74 69 63 75 6c 61 72 20 76 69 72 74 75 61 6c rticular virtual
14e20 20 74 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 table...
14e30 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 /// </para>..
14e40 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d /// </summ
14e50 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
14e60 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 / <param name="p
14e70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 Vtab">..
14e80 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 70 /// The native p
14e90 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 73 71 ointer to the sq
14ea0 6c 69 74 65 33 5f 76 74 61 62 20 64 65 72 69 76 lite3_vtab deriv
14eb0 65 64 20 73 74 72 75 63 74 75 72 65 2e 0d 0a 20 ed structure...
14ec0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
14ed0 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f am>.. ///
14ee0 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 <returns>..
14ef0 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 /// A standa
14f00 72 64 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e rd SQLite return
14f10 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 20 code...
14f20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a /// </returns>..
14f30 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 45 72 SQLiteEr
14f40 72 6f 72 43 6f 64 65 20 78 44 69 73 63 6f 6e 6e rorCode xDisconn
14f50 65 63 74 28 0d 0a 20 20 20 20 20 20 20 20 20 20 ect(..
14f60 20 20 49 6e 74 50 74 72 20 70 56 74 61 62 0d 0a IntPtr pVtab..
14f70 20 20 20 20 20 20 20 20 20 20 20 20 29 3b 0d 0a );..
14f80 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
14f90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14fa0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14fb0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14fc0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
14fd0 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f /.... ///
14fe0 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
14ff0 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a /// <para>..
15000 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 /// This
15010 20 6d 65 74 68 6f 64 20 72 65 6c 65 61 73 65 73 method releases
15020 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f a connection to
15030 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 a virtual table
15040 2c 20 6a 75 73 74 20 6c 69 6b 65 20 74 68 65 0d , just like the.
15050 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 78 44 69 . /// xDi
15060 73 63 6f 6e 6e 65 63 74 20 6d 65 74 68 6f 64 2c sconnect method,
15070 20 61 6e 64 20 69 74 20 61 6c 73 6f 20 64 65 73 and it also des
15080 74 72 6f 79 73 20 74 68 65 20 75 6e 64 65 72 6c troys the underl
15090 79 69 6e 67 20 74 61 62 6c 65 0d 0a 20 20 20 20 ying table..
150a0 20 20 20 20 2f 2f 2f 20 69 6d 70 6c 65 6d 65 6e /// implemen
150b0 74 61 74 69 6f 6e 2e 20 54 68 69 73 20 6d 65 74 tation. This met
150c0 68 6f 64 20 75 6e 64 6f 65 73 20 74 68 65 20 77 hod undoes the w
150d0 6f 72 6b 20 6f 66 20 78 43 72 65 61 74 65 2e 0d ork of xCreate..
150e0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
150f0 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
15100 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 / <para>..
15110 20 20 2f 2f 2f 20 54 68 65 20 78 44 69 73 63 6f /// The xDisco
15120 6e 6e 65 63 74 20 6d 65 74 68 6f 64 20 69 73 20 nnect method is
15130 63 61 6c 6c 65 64 20 77 68 65 6e 65 76 65 72 20 called whenever
15140 61 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 a database conne
15150 63 74 69 6f 6e 0d 0a 20 20 20 20 20 20 20 20 2f ction.. /
15160 2f 2f 20 74 68 61 74 20 75 73 65 73 20 61 20 76 // that uses a v
15170 69 72 74 75 61 6c 20 74 61 62 6c 65 20 69 73 20 irtual table is
15180 63 6c 6f 73 65 64 2e 20 54 68 65 20 78 44 65 73 closed. The xDes
15190 74 72 6f 79 20 6d 65 74 68 6f 64 20 69 73 20 6f troy method is o
151a0 6e 6c 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f nly.. ///
151b0 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 20 44 called when a D
151c0 52 4f 50 20 54 41 42 4c 45 20 73 74 61 74 65 6d ROP TABLE statem
151d0 65 6e 74 20 69 73 20 65 78 65 63 75 74 65 64 20 ent is executed
151e0 61 67 61 69 6e 73 74 20 74 68 65 20 76 69 72 74 against the virt
151f0 75 61 6c 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ual.. ///
15200 20 74 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 table...
15210 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 /// </para>..
15220 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e /// <para>
15230 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
15240 65 20 78 44 65 73 74 72 6f 79 20 6d 65 74 68 6f e xDestroy metho
15250 64 20 69 73 20 72 65 71 75 69 72 65 64 20 66 6f d is required fo
15260 72 20 65 76 65 72 79 20 76 69 72 74 75 61 6c 20 r every virtual
15270 74 61 62 6c 65 0d 0a 20 20 20 20 20 20 20 20 2f table.. /
15280 2f 2f 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f // implementatio
15290 6e 2c 20 74 68 6f 75 67 68 20 69 74 20 69 73 20 n, though it is
152a0 61 63 63 65 70 74 61 62 6c 65 20 66 6f 72 20 74 acceptable for t
152b0 68 65 20 78 44 69 73 63 6f 6e 6e 65 63 74 20 61 he xDisconnect a
152c0 6e 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 nd.. ///
152d0 78 44 65 73 74 72 6f 79 20 6d 65 74 68 6f 64 73 xDestroy methods
152e0 20 74 6f 20 62 65 20 74 68 65 20 73 61 6d 65 20 to be the same
152f0 66 75 6e 63 74 69 6f 6e 20 69 66 20 74 68 61 74 function if that
15300 20 6d 61 6b 65 73 20 73 65 6e 73 65 20 66 6f 72 makes sense for
15310 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 68 .. /// th
15320 65 20 70 61 72 74 69 63 75 6c 61 72 20 76 69 72 e particular vir
15330 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 20 20 tual table...
15340 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e /// </para>
15350 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
15360 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
15370 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
15380 65 3d 22 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 e="pVtab">..
15390 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 /// The nati
153a0 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 ve pointer to th
153b0 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20 64 e sqlite3_vtab d
153c0 65 72 69 76 65 64 20 73 74 72 75 63 74 75 72 65 erived structure
153d0 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
153e0 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 /param>..
153f0 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a /// <returns>..
15400 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 20 73 74 /// A st
15410 61 6e 64 61 72 64 20 53 51 4c 69 74 65 20 72 65 andard SQLite re
15420 74 75 72 6e 20 63 6f 64 65 2e 0d 0a 20 20 20 20 turn code...
15430 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e /// </return
15440 73 3e 0d 0a 20 20 20 20 20 20 20 20 53 51 4c 69 s>.. SQLi
15450 74 65 45 72 72 6f 72 43 6f 64 65 20 78 44 65 73 teErrorCode xDes
15460 74 72 6f 79 28 0d 0a 20 20 20 20 20 20 20 20 20 troy(..
15470 20 20 20 49 6e 74 50 74 72 20 70 56 74 61 62 0d IntPtr pVtab.
15480 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 3b 0d . );.
15490 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
154a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
154b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
154c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
154d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
154e0 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f //.... //
154f0 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
15500 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d /// <para>.
15510 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
15520 20 78 4f 70 65 6e 20 6d 65 74 68 6f 64 20 63 72 xOpen method cr
15530 65 61 74 65 73 20 61 20 6e 65 77 20 63 75 72 73 eates a new curs
15540 6f 72 20 75 73 65 64 20 66 6f 72 20 61 63 63 65 or used for acce
15550 73 73 69 6e 67 20 28 72 65 61 64 0d 0a 20 20 20 ssing (read..
15560 20 20 20 20 20 2f 2f 2f 20 61 6e 64 2f 6f 72 20 /// and/or
15570 77 72 69 74 69 6e 67 29 20 61 20 76 69 72 74 75 writing) a virtu
15580 61 6c 20 74 61 62 6c 65 2e 20 41 20 73 75 63 63 al table. A succ
15590 65 73 73 66 75 6c 20 69 6e 76 6f 63 61 74 69 6f essful invocatio
155a0 6e 20 6f 66 20 74 68 69 73 0d 0a 20 20 20 20 20 n of this..
155b0 20 20 20 2f 2f 2f 20 6d 65 74 68 6f 64 20 77 69 /// method wi
155c0 6c 6c 20 61 6c 6c 6f 63 61 74 65 20 74 68 65 20 ll allocate the
155d0 6d 65 6d 6f 72 79 20 66 6f 72 20 74 68 65 20 73 memory for the s
155e0 71 6c 69 74 65 33 5f 76 74 61 62 5f 63 75 72 73 qlite3_vtab_curs
155f0 6f 72 20 28 6f 72 20 61 0d 0a 20 20 20 20 20 20 or (or a..
15600 20 20 2f 2f 2f 20 73 75 62 63 6c 61 73 73 29 2c /// subclass),
15610 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 initialize the
15620 6e 65 77 20 6f 62 6a 65 63 74 2c 20 61 6e 64 20 new object, and
15630 6d 61 6b 65 20 2a 70 70 43 75 72 73 6f 72 20 70 make *ppCursor p
15640 6f 69 6e 74 20 74 6f 0d 0a 20 20 20 20 20 20 20 oint to..
15650 20 2f 2f 2f 20 74 68 65 20 6e 65 77 20 6f 62 6a /// the new obj
15660 65 63 74 2e 20 54 68 65 20 73 75 63 63 65 73 73 ect. The success
15670 66 75 6c 20 63 61 6c 6c 20 74 68 65 6e 20 72 65 ful call then re
15680 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e turns SQLITE_OK.
15690 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
156a0 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
156b0 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 // <para>..
156c0 20 20 20 2f 2f 2f 20 46 6f 72 20 65 76 65 72 79 /// For every
156d0 20 73 75 63 63 65 73 73 66 75 6c 20 63 61 6c 6c successful call
156e0 20 74 6f 20 74 68 69 73 20 6d 65 74 68 6f 64 2c to this method,
156f0 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 the SQLite core
15700 20 77 69 6c 6c 0d 0a 20 20 20 20 20 20 20 20 2f will.. /
15710 2f 2f 20 6c 61 74 65 72 20 69 6e 76 6f 6b 65 20 // later invoke
15720 74 68 65 20 78 43 6c 6f 73 65 20 6d 65 74 68 6f the xClose metho
15730 64 20 74 6f 20 64 65 73 74 72 6f 79 20 74 68 65 d to destroy the
15740 20 61 6c 6c 6f 63 61 74 65 64 20 63 75 72 73 6f allocated curso
15750 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 r... ///
15760 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
15770 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
15780 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 78 4f 70 /// The xOp
15790 65 6e 20 6d 65 74 68 6f 64 20 6e 65 65 64 20 6e en method need n
157a0 6f 74 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 ot initialize th
157b0 65 20 70 56 74 61 62 20 66 69 65 6c 64 20 6f 66 e pVtab field of
157c0 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f the.. //
157d0 2f 20 73 71 6c 69 74 65 33 5f 76 74 61 62 5f 63 / sqlite3_vtab_c
157e0 75 72 73 6f 72 20 73 74 72 75 63 74 75 72 65 2e ursor structure.
157f0 20 54 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 The SQLite core
15800 20 77 69 6c 6c 20 74 61 6b 65 20 63 61 72 65 20 will take care
15810 6f 66 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 of.. ///
15820 74 68 61 74 20 63 68 6f 72 65 20 61 75 74 6f 6d that chore autom
15830 61 74 69 63 61 6c 6c 79 2e 0d 0a 20 20 20 20 20 atically...
15840 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a /// </para>..
15850 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
15860 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
15870 41 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 A virtual table
15880 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6d implementation m
15890 75 73 74 20 62 65 20 61 62 6c 65 20 74 6f 20 73 ust be able to s
158a0 75 70 70 6f 72 74 20 61 6e 20 61 72 62 69 74 72 upport an arbitr
158b0 61 72 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ary.. ///
158c0 20 6e 75 6d 62 65 72 20 6f 66 20 73 69 6d 75 6c number of simul
158d0 74 61 6e 65 6f 75 73 6c 79 20 6f 70 65 6e 20 63 taneously open c
158e0 75 72 73 6f 72 73 2e 0d 0a 20 20 20 20 20 20 20 ursors...
158f0 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 /// </para>..
15900 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e /// <para>
15910 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 57 68 .. /// Wh
15920 65 6e 20 69 6e 69 74 69 61 6c 6c 79 20 6f 70 65 en initially ope
15930 6e 65 64 2c 20 74 68 65 20 63 75 72 73 6f 72 20 ned, the cursor
15940 69 73 20 69 6e 20 61 6e 20 75 6e 64 65 66 69 6e is in an undefin
15950 65 64 20 73 74 61 74 65 2e 20 54 68 65 0d 0a 20 ed state. The..
15960 20 20 20 20 20 20 20 2f 2f 2f 20 53 51 4c 69 74 /// SQLit
15970 65 20 63 6f 72 65 20 77 69 6c 6c 20 69 6e 76 6f e core will invo
15980 6b 65 20 74 68 65 20 78 46 69 6c 74 65 72 20 6d ke the xFilter m
15990 65 74 68 6f 64 20 6f 6e 20 74 68 65 20 63 75 72 ethod on the cur
159a0 73 6f 72 20 70 72 69 6f 72 20 74 6f 0d 0a 20 20 sor prior to..
159b0 20 20 20 20 20 20 2f 2f 2f 20 61 6e 79 20 61 74 /// any at
159c0 74 65 6d 70 74 20 74 6f 20 70 6f 73 69 74 69 6f tempt to positio
159d0 6e 20 6f 72 20 72 65 61 64 20 66 72 6f 6d 20 74 n or read from t
159e0 68 65 20 63 75 72 73 6f 72 2e 0d 0a 20 20 20 20 he cursor...
159f0 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d /// </para>.
15a00 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
15a10 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
15a20 20 54 68 65 20 78 4f 70 65 6e 20 6d 65 74 68 6f The xOpen metho
15a30 64 20 69 73 20 72 65 71 75 69 72 65 64 20 66 6f d is required fo
15a40 72 20 65 76 65 72 79 20 76 69 72 74 75 61 6c 20 r every virtual
15a50 74 61 62 6c 65 0d 0a 20 20 20 20 20 20 20 20 2f table.. /
15a60 2f 2f 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f // implementatio
15a70 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 n... ///
15a80 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
15a90 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
15aa0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
15ab0 72 61 6d 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 ram name="pVtab"
15ac0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
15ad0 68 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 he native pointe
15ae0 72 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 r to the sqlite3
15af0 5f 76 74 61 62 20 64 65 72 69 76 65 64 20 73 74 _vtab derived st
15b00 72 75 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 ructure...
15b10 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
15b20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
15b30 61 6d 20 6e 61 6d 65 3d 22 70 43 75 72 73 6f 72 am name="pCursor
15b40 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
15b50 55 70 6f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 Upon success, th
15b60 69 73 20 70 61 72 61 6d 65 74 65 72 20 6d 75 73 is parameter mus
15b70 74 20 62 65 20 6d 6f 64 69 66 69 65 64 20 74 6f t be modified to
15b80 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 6e 65 point to the ne
15b90 77 6c 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f wly.. ///
15ba0 20 63 72 65 61 74 65 64 20 6e 61 74 69 76 65 20 created native
15bb0 73 71 6c 69 74 65 33 5f 76 74 61 62 5f 63 75 72 sqlite3_vtab_cur
15bc0 73 6f 72 20 64 65 72 69 76 65 64 20 73 74 72 75 sor derived stru
15bd0 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 cture...
15be0 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
15bf0 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 /// <retur
15c00 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ns>.. ///
15c10 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 A standard SQLi
15c20 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d te return code..
15c30 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 . /// </r
15c40 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 eturns>..
15c50 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 SQLiteErrorCode
15c60 20 78 4f 70 65 6e 28 0d 0a 20 20 20 20 20 20 20 xOpen(..
15c70 20 20 20 20 20 49 6e 74 50 74 72 20 70 56 74 61 IntPtr pVta
15c80 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 b,..
15c90 72 65 66 20 49 6e 74 50 74 72 20 70 43 75 72 73 ref IntPtr pCurs
15ca0 6f 72 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 or..
15cb0 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f );.... //
15cc0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
15cd0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
15ce0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
15cf0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
15d00 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
15d10 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
15d20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
15d30 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
15d40 54 68 65 20 78 43 6c 6f 73 65 20 6d 65 74 68 6f The xClose metho
15d50 64 20 63 6c 6f 73 65 73 20 61 20 63 75 72 73 6f d closes a curso
15d60 72 20 70 72 65 76 69 6f 75 73 6c 79 20 6f 70 65 r previously ope
15d70 6e 65 64 20 62 79 20 78 4f 70 65 6e 2e 20 54 68 ned by xOpen. Th
15d80 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 e.. /// S
15d90 51 4c 69 74 65 20 63 6f 72 65 20 77 69 6c 6c 20 QLite core will
15da0 61 6c 77 61 79 73 20 63 61 6c 6c 20 78 43 6c 6f always call xClo
15db0 73 65 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 se once for each
15dc0 20 63 75 72 73 6f 72 20 6f 70 65 6e 65 64 0d 0a cursor opened..
15dd0 20 20 20 20 20 20 20 20 2f 2f 2f 20 75 73 69 6e /// usin
15de0 67 20 78 4f 70 65 6e 2e 0d 0a 20 20 20 20 20 20 g xOpen...
15df0 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
15e00 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
15e10 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
15e20 68 69 73 20 6d 65 74 68 6f 64 20 6d 75 73 74 20 his method must
15e30 72 65 6c 65 61 73 65 20 61 6c 6c 20 72 65 73 6f release all reso
15e40 75 72 63 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 urces allocated
15e50 62 79 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 by the..
15e60 2f 2f 2f 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e /// correspondin
15e70 67 20 78 4f 70 65 6e 20 63 61 6c 6c 2e 20 54 68 g xOpen call. Th
15e80 65 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 6e e routine will n
15e90 6f 74 20 62 65 20 63 61 6c 6c 65 64 20 61 67 61 ot be called aga
15ea0 69 6e 20 65 76 65 6e 0d 0a 20 20 20 20 20 20 20 in even..
15eb0 20 2f 2f 2f 20 69 66 20 69 74 20 72 65 74 75 72 /// if it retur
15ec0 6e 73 20 61 6e 20 65 72 72 6f 72 2e 20 54 68 65 ns an error. The
15ed0 20 53 51 4c 69 74 65 20 63 6f 72 65 20 77 69 6c SQLite core wil
15ee0 6c 20 6e 6f 74 20 75 73 65 20 74 68 65 0d 0a 20 l not use the..
15ef0 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 6c 69 74 /// sqlit
15f00 65 33 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 61 e3_vtab_cursor a
15f10 67 61 69 6e 20 61 66 74 65 72 20 69 74 20 68 61 gain after it ha
15f20 73 20 62 65 65 6e 20 63 6c 6f 73 65 64 2e 0d 0a s been closed...
15f30 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
15f40 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
15f50 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 <para>..
15f60 20 2f 2f 2f 20 54 68 65 20 78 43 6c 6f 73 65 20 /// The xClose
15f70 6d 65 74 68 6f 64 20 69 73 20 72 65 71 75 69 72 method is requir
15f80 65 64 20 66 6f 72 20 65 76 65 72 79 20 76 69 72 ed for every vir
15f90 74 75 61 6c 20 74 61 62 6c 65 0d 0a 20 20 20 20 tual table..
15fa0 20 20 20 20 2f 2f 2f 20 69 6d 70 6c 65 6d 65 6e /// implemen
15fb0 74 61 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 tation...
15fc0 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 /// </para>..
15fd0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d /// </summ
15fe0 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
15ff0 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 / <param name="p
16000 43 75 72 73 6f 72 22 3e 0d 0a 20 20 20 20 20 20 Cursor">..
16010 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 /// The native
16020 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
16030 73 71 6c 69 74 65 33 5f 76 74 61 62 5f 63 75 72 sqlite3_vtab_cur
16040 73 6f 72 20 64 65 72 69 76 65 64 20 73 74 72 75 sor derived stru
16050 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 cture...
16060 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
16070 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 /// <retur
16080 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ns>.. ///
16090 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 A standard SQLi
160a0 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d te return code..
160b0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 . /// </r
160c0 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 eturns>..
160d0 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 SQLiteErrorCode
160e0 20 78 43 6c 6f 73 65 28 0d 0a 20 20 20 20 20 20 xClose(..
160f0 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 43 75 IntPtr pCu
16100 72 73 6f 72 0d 0a 20 20 20 20 20 20 20 20 20 20 rsor..
16110 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 );....
16120 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
16130 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
16140 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
16150 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
16160 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
16170 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
16180 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
16190 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
161a0 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 20 62 65 / This method be
161b0 67 69 6e 73 20 61 20 73 65 61 72 63 68 20 6f 66 gins a search of
161c0 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 a virtual table
161d0 2e 20 54 68 65 20 66 69 72 73 74 20 61 72 67 75 . The first argu
161e0 6d 65 6e 74 0d 0a 20 20 20 20 20 20 20 20 2f 2f ment.. //
161f0 2f 20 69 73 20 61 20 63 75 72 73 6f 72 20 6f 70 / is a cursor op
16200 65 6e 65 64 20 62 79 20 78 4f 70 65 6e 2e 20 54 ened by xOpen. T
16210 68 65 20 6e 65 78 74 20 74 77 6f 20 61 72 67 75 he next two argu
16220 6d 65 6e 74 20 64 65 66 69 6e 65 20 61 0d 0a 20 ment define a..
16230 20 20 20 20 20 20 20 2f 2f 2f 20 70 61 72 74 69 /// parti
16240 63 75 6c 61 72 20 73 65 61 72 63 68 20 69 6e 64 cular search ind
16250 65 78 20 70 72 65 76 69 6f 75 73 6c 79 20 63 68 ex previously ch
16260 6f 73 65 6e 20 62 79 20 78 42 65 73 74 49 6e 64 osen by xBestInd
16270 65 78 2e 20 54 68 65 0d 0a 20 20 20 20 20 20 20 ex. The..
16280 20 2f 2f 2f 20 73 70 65 63 69 66 69 63 20 6d 65 /// specific me
16290 61 6e 69 6e 67 73 20 6f 66 20 69 64 78 4e 75 6d anings of idxNum
162a0 20 61 6e 64 20 69 64 78 53 74 72 20 61 72 65 20 and idxStr are
162b0 75 6e 69 6d 70 6f 72 74 61 6e 74 20 61 73 20 6c unimportant as l
162c0 6f 6e 67 20 61 73 0d 0a 20 20 20 20 20 20 20 20 ong as..
162d0 2f 2f 2f 20 78 46 69 6c 74 65 72 20 61 6e 64 20 /// xFilter and
162e0 78 42 65 73 74 49 6e 64 65 78 20 61 67 72 65 65 xBestIndex agree
162f0 20 6f 6e 20 77 68 61 74 20 74 68 61 74 20 6d 65 on what that me
16300 61 6e 69 6e 67 20 69 73 2e 0d 0a 20 20 20 20 20 aning is...
16310 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a /// </para>..
16320 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
16330 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
16340 54 68 65 20 78 42 65 73 74 49 6e 64 65 78 20 66 The xBestIndex f
16350 75 6e 63 74 69 6f 6e 20 6d 61 79 20 68 61 76 65 unction may have
16360 20 72 65 71 75 65 73 74 65 64 20 74 68 65 20 76 requested the v
16370 61 6c 75 65 73 20 6f 66 20 63 65 72 74 61 69 6e alues of certain
16380 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 65 78 .. /// ex
16390 70 72 65 73 73 69 6f 6e 73 20 75 73 69 6e 67 20 pressions using
163a0 74 68 65 20 61 43 6f 6e 73 74 72 61 69 6e 74 55 the aConstraintU
163b0 73 61 67 65 5b 5d 2e 61 72 67 76 49 6e 64 65 78 sage[].argvIndex
163c0 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 0d 0a values of the..
163d0 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 6c 69 /// sqli
163e0 74 65 33 5f 69 6e 64 65 78 5f 69 6e 66 6f 20 73 te3_index_info s
163f0 74 72 75 63 74 75 72 65 2e 20 54 68 6f 73 65 20 tructure. Those
16400 76 61 6c 75 65 73 20 61 72 65 20 70 61 73 73 65 values are passe
16410 64 20 74 6f 20 78 46 69 6c 74 65 72 0d 0a 20 20 d to xFilter..
16420 20 20 20 20 20 20 2f 2f 2f 20 75 73 69 6e 67 20 /// using
16430 74 68 65 20 61 72 67 63 20 61 6e 64 20 61 72 67 the argc and arg
16440 76 20 70 61 72 61 6d 65 74 65 72 73 2e 0d 0a 20 v parameters...
16450 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
16460 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
16470 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 <para>..
16480 2f 2f 2f 20 49 66 20 74 68 65 20 76 69 72 74 75 /// If the virtu
16490 61 6c 20 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e al table contain
164a0 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 72 6f s one or more ro
164b0 77 73 20 74 68 61 74 20 6d 61 74 63 68 20 74 68 ws that match th
164c0 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 e.. /// s
164d0 65 61 72 63 68 20 63 72 69 74 65 72 69 61 2c 20 earch criteria,
164e0 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 20 then the cursor
164f0 6d 75 73 74 20 62 65 20 6c 65 66 74 20 70 6f 69 must be left poi
16500 6e 74 20 61 74 20 74 68 65 20 66 69 72 73 74 0d nt at the first.
16510 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 72 6f 77 . /// row
16520 2e 20 53 75 62 73 65 71 75 65 6e 74 20 63 61 6c . Subsequent cal
16530 6c 73 20 74 6f 20 78 45 6f 66 20 6d 75 73 74 20 ls to xEof must
16540 72 65 74 75 72 6e 20 66 61 6c 73 65 20 28 7a 65 return false (ze
16550 72 6f 29 2e 20 49 66 20 74 68 65 72 65 0d 0a 20 ro). If there..
16560 20 20 20 20 20 20 20 2f 2f 2f 20 61 72 65 20 6e /// are n
16570 6f 20 72 6f 77 73 20 6d 61 74 63 68 2c 20 74 68 o rows match, th
16580 65 6e 20 74 68 65 20 63 75 72 73 6f 72 20 6d 75 en the cursor mu
16590 73 74 20 62 65 20 6c 65 66 74 20 69 6e 20 61 20 st be left in a
165a0 73 74 61 74 65 20 74 68 61 74 0d 0a 20 20 20 20 state that..
165b0 20 20 20 20 2f 2f 2f 20 77 69 6c 6c 20 63 61 75 /// will cau
165c0 73 65 20 74 68 65 20 78 45 6f 66 20 74 6f 20 72 se the xEof to r
165d0 65 74 75 72 6e 20 74 72 75 65 20 28 6e 6f 6e 2d eturn true (non-
165e0 7a 65 72 6f 29 2e 20 54 68 65 20 53 51 4c 69 74 zero). The SQLit
165f0 65 20 65 6e 67 69 6e 65 0d 0a 20 20 20 20 20 20 e engine..
16600 20 20 2f 2f 2f 20 77 69 6c 6c 20 75 73 65 20 74 /// will use t
16610 68 65 20 78 43 6f 6c 75 6d 6e 20 61 6e 64 20 78 he xColumn and x
16620 52 6f 77 69 64 20 6d 65 74 68 6f 64 73 20 74 6f Rowid methods to
16630 20 61 63 63 65 73 73 20 74 68 61 74 20 72 6f 77 access that row
16640 20 63 6f 6e 74 65 6e 74 2e 0d 0a 20 20 20 20 20 content...
16650 20 20 20 2f 2f 2f 20 54 68 65 20 78 4e 65 78 74 /// The xNext
16660 20 6d 65 74 68 6f 64 20 77 69 6c 6c 20 62 65 20 method will be
16670 75 73 65 64 20 74 6f 20 61 64 76 61 6e 63 65 20 used to advance
16680 74 6f 20 74 68 65 20 6e 65 78 74 20 72 6f 77 2e to the next row.
16690 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
166a0 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
166b0 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 // <para>..
166c0 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 /// This meth
166d0 6f 64 20 6d 75 73 74 20 72 65 74 75 72 6e 20 53 od must return S
166e0 51 4c 49 54 45 5f 4f 4b 20 69 66 20 73 75 63 63 QLITE_OK if succ
166f0 65 73 73 66 75 6c 2c 20 6f 72 20 61 6e 20 73 71 essful, or an sq
16700 6c 69 74 65 20 65 72 72 6f 72 0d 0a 20 20 20 20 lite error..
16710 20 20 20 20 2f 2f 2f 20 63 6f 64 65 20 69 66 20 /// code if
16720 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2e an error occurs.
16730 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
16740 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
16750 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 // <para>..
16760 20 20 20 2f 2f 2f 20 54 68 65 20 78 46 69 6c 74 /// The xFilt
16770 65 72 20 6d 65 74 68 6f 64 20 69 73 20 72 65 71 er method is req
16780 75 69 72 65 64 20 66 6f 72 20 65 76 65 72 79 20 uired for every
16790 76 69 72 74 75 61 6c 20 74 61 62 6c 65 0d 0a 20 virtual table..
167a0 20 20 20 20 20 20 20 2f 2f 2f 20 69 6d 70 6c 65 /// imple
167b0 6d 65 6e 74 61 74 69 6f 6e 2e 0d 0a 20 20 20 20 mentation...
167c0 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d /// </para>.
167d0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
167e0 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
167f0 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
16800 3d 22 70 43 75 72 73 6f 72 22 3e 0d 0a 20 20 20 ="pCursor">..
16810 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 /// The nat
16820 69 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 ive pointer to t
16830 68 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 5f he sqlite3_vtab_
16840 63 75 72 73 6f 72 20 64 65 72 69 76 65 64 20 73 cursor derived s
16850 74 72 75 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 tructure...
16860 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
16870 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
16880 72 61 6d 20 6e 61 6d 65 3d 22 69 64 78 4e 75 6d ram name="idxNum
16890 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
168a0 4e 75 6d 62 65 72 20 75 73 65 64 20 74 6f 20 68 Number used to h
168b0 65 6c 70 20 69 64 65 6e 74 69 66 79 20 74 68 65 elp identify the
168c0 20 73 65 6c 65 63 74 65 64 20 69 6e 64 65 78 2e selected index.
168d0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
168e0 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
168f0 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
16900 22 69 64 78 53 74 72 22 3e 0d 0a 20 20 20 20 20 "idxStr">..
16910 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 /// The nativ
16920 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 e pointer to the
16930 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 73 UTF-8 encoded s
16940 74 72 69 6e 67 20 63 6f 6e 74 61 69 6e 69 6e 67 tring containing
16950 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f the.. //
16960 2f 20 73 74 72 69 6e 67 20 75 73 65 64 20 74 6f / string used to
16970 20 68 65 6c 70 20 69 64 65 6e 74 69 66 79 20 74 help identify t
16980 68 65 20 73 65 6c 65 63 74 65 64 20 69 6e 64 65 he selected inde
16990 78 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 x... ///
169a0 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
169b0 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
169c0 65 3d 22 61 72 67 63 22 3e 0d 0a 20 20 20 20 20 e="argc">..
169d0 20 20 20 2f 2f 2f 20 54 68 65 20 6e 75 6d 62 65 /// The numbe
169e0 72 20 6f 66 20 6e 61 74 69 76 65 20 70 6f 69 6e r of native poin
169f0 74 65 72 73 20 74 6f 20 73 71 6c 69 74 65 33 5f ters to sqlite3_
16a00 76 61 6c 75 65 20 73 74 72 75 63 74 75 72 65 73 value structures
16a10 20 73 70 65 63 69 66 69 65 64 0d 0a 20 20 20 20 specified..
16a20 20 20 20 20 2f 2f 2f 20 69 6e 20 3c 70 61 72 61 /// in <para
16a30 6d 72 65 66 20 6e 61 6d 65 3d 22 61 72 67 76 22 mref name="argv"
16a40 20 2f 3e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f />... //
16a50 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
16a60 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
16a70 61 6d 65 3d 22 61 72 67 76 22 3e 0d 0a 20 20 20 ame="argv">..
16a80 20 20 20 20 20 2f 2f 2f 20 41 6e 20 61 72 72 61 /// An arra
16a90 79 20 6f 66 20 6e 61 74 69 76 65 20 70 6f 69 6e y of native poin
16aa0 74 65 72 73 20 74 6f 20 73 71 6c 69 74 65 33 5f ters to sqlite3_
16ab0 76 61 6c 75 65 20 73 74 72 75 63 74 75 72 65 73 value structures
16ac0 20 63 6f 6e 74 61 69 6e 69 6e 67 0d 0a 20 20 20 containing..
16ad0 20 20 20 20 20 2f 2f 2f 20 66 69 6c 74 65 72 69 /// filteri
16ae0 6e 67 20 63 72 69 74 65 72 69 61 20 66 6f 72 20 ng criteria for
16af0 74 68 65 20 73 65 6c 65 63 74 65 64 20 69 6e 64 the selected ind
16b00 65 78 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ex... ///
16b10 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
16b20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e /// <returns>
16b30 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 20 .. /// A
16b40 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 65 20 standard SQLite
16b50 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a 20 20 return code...
16b60 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 /// </retu
16b70 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 53 51 rns>.. SQ
16b80 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 78 46 LiteErrorCode xF
16b90 69 6c 74 65 72 28 0d 0a 20 20 20 20 20 20 20 20 ilter(..
16ba0 20 20 20 20 49 6e 74 50 74 72 20 70 43 75 72 73 IntPtr pCurs
16bb0 6f 72 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 or,..
16bc0 20 69 6e 74 20 69 64 78 4e 75 6d 2c 0d 0a 20 20 int idxNum,..
16bd0 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 IntPtr
16be0 20 69 64 78 53 74 72 2c 0d 0a 20 20 20 20 20 20 idxStr,..
16bf0 20 20 20 20 20 20 69 6e 74 20 61 72 67 63 2c 0d int argc,.
16c00 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 . Int
16c10 50 74 72 20 61 72 67 76 0d 0a 20 20 20 20 20 20 Ptr argv..
16c20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 );....
16c30 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
16c40 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
16c50 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
16c60 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
16c70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
16c80 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
16c90 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
16ca0 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 / <para>..
16cb0 20 20 2f 2f 2f 20 54 68 65 20 78 4e 65 78 74 20 /// The xNext
16cc0 6d 65 74 68 6f 64 20 61 64 76 61 6e 63 65 73 20 method advances
16cd0 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 a virtual table
16ce0 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 6e 65 cursor to the ne
16cf0 78 74 20 72 6f 77 20 6f 66 0d 0a 20 20 20 20 20 xt row of..
16d00 20 20 20 2f 2f 2f 20 61 20 72 65 73 75 6c 74 20 /// a result
16d10 73 65 74 20 69 6e 69 74 69 61 74 65 64 20 62 79 set initiated by
16d20 20 78 46 69 6c 74 65 72 2e 20 49 66 20 74 68 65 xFilter. If the
16d30 20 63 75 72 73 6f 72 20 69 73 20 61 6c 72 65 61 cursor is alrea
16d40 64 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 dy.. ///
16d50 70 6f 69 6e 74 69 6e 67 20 61 74 20 74 68 65 20 pointing at the
16d60 6c 61 73 74 20 72 6f 77 20 77 68 65 6e 20 74 68 last row when th
16d70 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 is routine is ca
16d80 6c 6c 65 64 2c 20 74 68 65 6e 20 74 68 65 0d 0a lled, then the..
16d90 20 20 20 20 20 20 20 20 2f 2f 2f 20 63 75 72 73 /// curs
16da0 6f 72 20 6e 6f 20 6c 6f 6e 67 65 72 20 70 6f 69 or no longer poi
16db0 6e 74 73 20 74 6f 20 76 61 6c 69 64 20 64 61 74 nts to valid dat
16dc0 61 20 61 6e 64 20 61 20 73 75 62 73 65 71 75 65 a and a subseque
16dd0 6e 74 20 63 61 6c 6c 20 74 6f 20 74 68 65 0d 0a nt call to the..
16de0 20 20 20 20 20 20 20 20 2f 2f 2f 20 78 45 6f 66 /// xEof
16df0 20 6d 65 74 68 6f 64 20 6d 75 73 74 20 72 65 74 method must ret
16e00 75 72 6e 20 74 72 75 65 20 28 6e 6f 6e 2d 7a 65 urn true (non-ze
16e10 72 6f 29 2e 20 49 66 20 74 68 65 20 63 75 72 73 ro). If the curs
16e20 6f 72 20 69 73 0d 0a 20 20 20 20 20 20 20 20 2f or is.. /
16e30 2f 2f 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 // successfully
16e40 61 64 76 61 6e 63 65 64 20 74 6f 20 61 6e 6f 74 advanced to anot
16e50 68 65 72 20 72 6f 77 20 6f 66 20 63 6f 6e 74 65 her row of conte
16e60 6e 74 2c 20 74 68 65 6e 20 73 75 62 73 65 71 75 nt, then subsequ
16e70 65 6e 74 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ent.. ///
16e80 20 63 61 6c 6c 73 20 74 6f 20 78 45 6f 66 20 6d calls to xEof m
16e90 75 73 74 20 72 65 74 75 72 6e 20 66 61 6c 73 65 ust return false
16ea0 20 28 7a 65 72 6f 29 2e 0d 0a 20 20 20 20 20 20 (zero)...
16eb0 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
16ec0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
16ed0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
16ee0 68 69 73 20 6d 65 74 68 6f 64 20 6d 75 73 74 20 his method must
16ef0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
16f00 20 69 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 if successful,
16f10 6f 72 20 61 6e 20 73 71 6c 69 74 65 20 65 72 72 or an sqlite err
16f20 6f 72 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 or.. ///
16f30 63 6f 64 65 20 69 66 20 61 6e 20 65 72 72 6f 72 code if an error
16f40 20 6f 63 63 75 72 73 2e 0d 0a 20 20 20 20 20 20 occurs...
16f50 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
16f60 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
16f70 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
16f80 68 65 20 78 4e 65 78 74 20 6d 65 74 68 6f 64 20 he xNext method
16f90 69 73 20 72 65 71 75 69 72 65 64 20 66 6f 72 20 is required for
16fa0 65 76 65 72 79 20 76 69 72 74 75 61 6c 20 74 61 every virtual ta
16fb0 62 6c 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ble.. ///
16fc0 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e implementation.
16fd0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
16fe0 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
16ff0 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
17000 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
17010 6d 20 6e 61 6d 65 3d 22 70 43 75 72 73 6f 72 22 m name="pCursor"
17020 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
17030 68 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 he native pointe
17040 72 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 r to the sqlite3
17050 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 64 65 72 _vtab_cursor der
17060 69 76 65 64 20 73 74 72 75 63 74 75 72 65 2e 0d ived structure..
17070 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
17080 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f aram>.. /
17090 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 // <returns>..
170a0 20 20 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e /// A stan
170b0 64 61 72 64 20 53 51 4c 69 74 65 20 72 65 74 75 dard SQLite retu
170c0 72 6e 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 rn code...
170d0 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e /// </returns>
170e0 0d 0a 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 .. SQLite
170f0 45 72 72 6f 72 43 6f 64 65 20 78 4e 65 78 74 28 ErrorCode xNext(
17100 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 6e .. In
17110 74 50 74 72 20 70 43 75 72 73 6f 72 0d 0a 20 20 tPtr pCursor..
17120 20 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a );....
17130 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f ////////
17140 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
17150 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
17160 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
17170 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
17180 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
17190 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
171a0 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 /// <para>..
171b0 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 78 45 /// The xE
171c0 6f 66 20 6d 65 74 68 6f 64 20 6d 75 73 74 20 72 of method must r
171d0 65 74 75 72 6e 20 66 61 6c 73 65 20 28 7a 65 72 eturn false (zer
171e0 6f 29 20 69 66 20 74 68 65 20 73 70 65 63 69 66 o) if the specif
171f0 69 65 64 20 63 75 72 73 6f 72 0d 0a 20 20 20 20 ied cursor..
17200 20 20 20 20 2f 2f 2f 20 63 75 72 72 65 6e 74 6c /// currentl
17210 79 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 76 61 y points to a va
17220 6c 69 64 20 72 6f 77 20 6f 66 20 64 61 74 61 2c lid row of data,
17230 20 6f 72 20 74 72 75 65 20 28 6e 6f 6e 2d 7a 65 or true (non-ze
17240 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ro).. ///
17250 20 6f 74 68 65 72 77 69 73 65 2e 20 54 68 69 73 otherwise. This
17260 20 6d 65 74 68 6f 64 20 69 73 20 63 61 6c 6c 65 method is calle
17270 64 20 62 79 20 74 68 65 20 53 51 4c 20 65 6e 67 d by the SQL eng
17280 69 6e 65 20 69 6d 6d 65 64 69 61 74 65 6c 79 0d ine immediately.
17290 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 66 74 . /// aft
172a0 65 72 20 65 61 63 68 20 78 46 69 6c 74 65 72 20 er each xFilter
172b0 61 6e 64 20 78 4e 65 78 74 20 69 6e 76 6f 63 61 and xNext invoca
172c0 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f tion... /
172d0 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 // </para>..
172e0 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a /// <para>..
172f0 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
17300 78 45 6f 66 20 6d 65 74 68 6f 64 20 69 73 20 72 xEof method is r
17310 65 71 75 69 72 65 64 20 66 6f 72 20 65 76 65 72 equired for ever
17320 79 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 y virtual table
17330 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0d implementation..
17340 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
17350 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
17360 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 / </summary>..
17370 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
17380 20 6e 61 6d 65 3d 22 70 43 75 72 73 6f 72 22 3e name="pCursor">
17390 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
173a0 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 72 e native pointer
173b0 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f to the sqlite3_
173c0 76 74 61 62 5f 63 75 72 73 6f 72 20 64 65 72 69 vtab_cursor deri
173d0 76 65 64 20 73 74 72 75 63 74 75 72 65 2e 0d 0a ved structure...
173e0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
173f0 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
17400 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 / <returns>..
17410 20 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 /// Non-zer
17420 6f 20 69 66 20 6e 6f 20 6d 6f 72 65 20 72 6f 77 o if no more row
17430 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 3b s are available;
17440 20 7a 65 72 6f 20 6f 74 68 65 72 77 69 73 65 2e zero otherwise.
17450 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
17460 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
17470 20 20 69 6e 74 20 78 45 6f 66 28 0d 0a 20 20 20 int xEof(..
17480 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 IntPtr
17490 70 43 75 72 73 6f 72 0d 0a 20 20 20 20 20 20 20 pCursor..
174a0 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 );....
174b0 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
174c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
174d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
174e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
174f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
17500 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
17510 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
17520 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 <para>..
17530 20 2f 2f 2f 20 54 68 65 20 53 51 4c 69 74 65 20 /// The SQLite
17540 63 6f 72 65 20 69 6e 76 6f 6b 65 73 20 74 68 69 core invokes thi
17550 73 20 6d 65 74 68 6f 64 20 69 6e 20 6f 72 64 65 s method in orde
17560 72 20 74 6f 20 66 69 6e 64 20 74 68 65 20 76 61 r to find the va
17570 6c 75 65 20 66 6f 72 0d 0a 20 20 20 20 20 20 20 lue for..
17580 20 2f 2f 2f 20 74 68 65 20 4e 2d 74 68 20 63 6f /// the N-th co
17590 6c 75 6d 6e 20 6f 66 20 74 68 65 20 63 75 72 72 lumn of the curr
175a0 65 6e 74 20 72 6f 77 2e 20 4e 20 69 73 20 7a 65 ent row. N is ze
175b0 72 6f 2d 62 61 73 65 64 20 73 6f 20 74 68 65 20 ro-based so the
175c0 66 69 72 73 74 0d 0a 20 20 20 20 20 20 20 20 2f first.. /
175d0 2f 2f 20 63 6f 6c 75 6d 6e 20 69 73 20 6e 75 6d // column is num
175e0 62 65 72 65 64 20 30 2e 20 54 68 65 20 78 43 6f bered 0. The xCo
175f0 6c 75 6d 6e 20 6d 65 74 68 6f 64 20 6d 61 79 20 lumn method may
17600 72 65 74 75 72 6e 20 69 74 73 20 72 65 73 75 6c return its resul
17610 74 20 62 61 63 6b 0d 0a 20 20 20 20 20 20 20 20 t back..
17620 2f 2f 2f 20 74 6f 20 53 51 4c 69 74 65 20 75 73 /// to SQLite us
17630 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 ing one of the f
17640 6f 6c 6c 6f 77 69 6e 67 20 69 6e 74 65 72 66 61 ollowing interfa
17650 63 65 3a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ce:.. ///
17660 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 </para>..
17670 20 20 2f 2f 2f 20 3c 63 6f 64 65 3e 0d 0a 20 20 /// <code>..
17680 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 73 71 /// sq
17690 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 62 6c 6f lite3_result_blo
176a0 62 28 29 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f b().. ///
176b0 20 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 sqlite3_res
176c0 75 6c 74 5f 64 6f 75 62 6c 65 28 29 0d 0a 20 20 ult_double()..
176d0 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 73 71 /// sq
176e0 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74 lite3_result_int
176f0 28 29 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ().. ///
17700 20 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 sqlite3_resu
17710 6c 74 5f 69 6e 74 36 34 28 29 0d 0a 20 20 20 20 lt_int64()..
17720 20 20 20 20 2f 2f 2f 20 20 20 20 20 73 71 6c 69 /// sqli
17730 74 65 33 5f 72 65 73 75 6c 74 5f 6e 75 6c 6c 28 te3_result_null(
17740 29 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 ).. ///
17750 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c sqlite3_resul
17760 74 5f 74 65 78 74 28 29 0d 0a 20 20 20 20 20 20 t_text()..
17770 20 20 2f 2f 2f 20 20 20 20 20 73 71 6c 69 74 65 /// sqlite
17780 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 36 28 3_result_text16(
17790 29 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 ).. ///
177a0 20 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c sqlite3_resul
177b0 74 5f 74 65 78 74 31 36 6c 65 28 29 0d 0a 20 20 t_text16le()..
177c0 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 73 71 /// sq
177d0 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 lite3_result_tex
177e0 74 31 36 62 65 28 29 0d 0a 20 20 20 20 20 20 20 t16be()..
177f0 20 2f 2f 2f 20 20 20 20 20 73 71 6c 69 74 65 33 /// sqlite3
17800 5f 72 65 73 75 6c 74 5f 7a 65 72 6f 62 6c 6f 62 _result_zeroblob
17810 28 29 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ().. ///
17820 3c 2f 63 6f 64 65 3e 0d 0a 20 20 20 20 20 20 20 </code>..
17830 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
17840 20 20 20 20 20 2f 2f 2f 20 49 66 20 74 68 65 20 /// If the
17850 78 43 6f 6c 75 6d 6e 20 6d 65 74 68 6f 64 20 69 xColumn method i
17860 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 63 61 mplementation ca
17870 6c 6c 73 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20 lls none of the
17880 66 75 6e 63 74 69 6f 6e 73 0d 0a 20 20 20 20 20 functions..
17890 20 20 20 2f 2f 2f 20 61 62 6f 76 65 2c 20 74 68 /// above, th
178a0 65 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 en the value of
178b0 74 68 65 20 63 6f 6c 75 6d 6e 20 64 65 66 61 75 the column defau
178c0 6c 74 73 20 74 6f 20 61 6e 20 53 51 4c 20 4e 55 lts to an SQL NU
178d0 4c 4c 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f LL... ///
178e0 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 </para>..
178f0 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 /// <para>..
17900 20 20 20 20 20 20 2f 2f 2f 20 54 6f 20 72 61 69 /// To rai
17910 73 65 20 61 6e 20 65 72 72 6f 72 2c 20 74 68 65 se an error, the
17920 20 78 43 6f 6c 75 6d 6e 20 6d 65 74 68 6f 64 20 xColumn method
17930 73 68 6f 75 6c 64 20 75 73 65 20 6f 6e 65 20 6f should use one o
17940 66 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f f the.. /
17950 2f 2f 20 72 65 73 75 6c 74 5f 74 65 78 74 28 29 // result_text()
17960 20 6d 65 74 68 6f 64 73 20 74 6f 20 73 65 74 20 methods to set
17970 74 68 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 the error messag
17980 65 20 74 65 78 74 2c 20 74 68 65 6e 20 72 65 74 e text, then ret
17990 75 72 6e 20 61 6e 0d 0a 20 20 20 20 20 20 20 20 urn an..
179a0 2f 2f 2f 20 61 70 70 72 6f 70 72 69 61 74 65 20 /// appropriate
179b0 65 72 72 6f 72 20 63 6f 64 65 2e 20 54 68 65 20 error code. The
179c0 78 43 6f 6c 75 6d 6e 20 6d 65 74 68 6f 64 20 6d xColumn method m
179d0 75 73 74 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ust return SQLIT
179e0 45 5f 4f 4b 20 6f 6e 0d 0a 20 20 20 20 20 20 20 E_OK on..
179f0 20 2f 2f 2f 20 73 75 63 63 65 73 73 2e 0d 0a 20 /// success...
17a00 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
17a10 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
17a20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 <para>..
17a30 2f 2f 2f 20 54 68 65 20 78 43 6f 6c 75 6d 6e 20 /// The xColumn
17a40 6d 65 74 68 6f 64 20 69 73 20 72 65 71 75 69 72 method is requir
17a50 65 64 20 66 6f 72 20 65 76 65 72 79 20 76 69 72 ed for every vir
17a60 74 75 61 6c 20 74 61 62 6c 65 0d 0a 20 20 20 20 tual table..
17a70 20 20 20 20 2f 2f 2f 20 69 6d 70 6c 65 6d 65 6e /// implemen
17a80 74 61 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 tation...
17a90 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 /// </para>..
17aa0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d /// </summ
17ab0 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
17ac0 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 / <param name="p
17ad0 43 75 72 73 6f 72 22 3e 0d 0a 20 20 20 20 20 20 Cursor">..
17ae0 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 /// The native
17af0 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
17b00 73 71 6c 69 74 65 33 5f 76 74 61 62 5f 63 75 72 sqlite3_vtab_cur
17b10 73 6f 72 20 64 65 72 69 76 65 64 20 73 74 72 75 sor derived stru
17b20 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 cture...
17b30 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
17b40 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
17b50 20 6e 61 6d 65 3d 22 70 43 6f 6e 74 65 78 74 22 name="pContext"
17b60 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
17b70 68 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 he native pointe
17b80 72 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 r to the sqlite3
17b90 5f 63 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 _context structu
17ba0 72 65 20 74 6f 20 62 65 20 75 73 65 64 0d 0a 20 re to be used..
17bb0 20 20 20 20 20 20 20 2f 2f 2f 20 66 6f 72 20 72 /// for r
17bc0 65 74 75 72 6e 69 6e 67 20 74 68 65 20 73 70 65 eturning the spe
17bd0 63 69 66 69 65 64 20 63 6f 6c 75 6d 6e 20 76 61 cified column va
17be0 6c 75 65 20 74 6f 20 74 68 65 20 53 51 4c 69 74 lue to the SQLit
17bf0 65 20 63 6f 72 65 0d 0a 20 20 20 20 20 20 20 20 e core..
17c00 2f 2f 2f 20 6c 69 62 72 61 72 79 2e 0d 0a 20 20 /// library...
17c10 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
17c20 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
17c30 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 69 6e 64 <param name="ind
17c40 65 78 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ex">.. //
17c50 2f 20 54 68 65 20 7a 65 72 6f 2d 62 61 73 65 64 / The zero-based
17c60 20 69 6e 64 65 78 20 63 6f 72 72 65 73 70 6f 6e index correspon
17c70 64 69 6e 67 20 74 6f 20 74 68 65 20 63 6f 6c 75 ding to the colu
17c80 6d 6e 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 mn containing th
17c90 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 76 e.. /// v
17ca0 61 6c 75 65 20 74 6f 20 62 65 20 72 65 74 75 72 alue to be retur
17cb0 6e 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ned... //
17cc0 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
17cd0 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
17ce0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 >.. /// A
17cf0 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 65 standard SQLite
17d00 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a 20 return code...
17d10 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 /// </ret
17d20 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 53 urns>.. S
17d30 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 78 QLiteErrorCode x
17d40 43 6f 6c 75 6d 6e 28 0d 0a 20 20 20 20 20 20 20 Column(..
17d50 20 20 20 20 20 49 6e 74 50 74 72 20 70 43 75 72 IntPtr pCur
17d60 73 6f 72 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 sor,..
17d70 20 20 49 6e 74 50 74 72 20 70 43 6f 6e 74 65 78 IntPtr pContex
17d80 74 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 t,..
17d90 69 6e 74 20 69 6e 64 65 78 0d 0a 20 20 20 20 20 int index..
17da0 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 );....
17db0 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
17dc0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
17dd0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
17de0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
17df0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
17e00 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
17e10 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
17e20 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 // <para>..
17e30 20 20 20 2f 2f 2f 20 41 20 73 75 63 63 65 73 73 /// A success
17e40 66 75 6c 20 69 6e 76 6f 63 61 74 69 6f 6e 20 6f ful invocation o
17e50 66 20 74 68 69 73 20 6d 65 74 68 6f 64 20 77 69 f this method wi
17e60 6c 6c 20 63 61 75 73 65 20 2a 70 52 6f 77 69 64 ll cause *pRowid
17e70 20 74 6f 20 62 65 0d 0a 20 20 20 20 20 20 20 20 to be..
17e80 2f 2f 2f 20 66 69 6c 6c 65 64 20 77 69 74 68 20 /// filled with
17e90 74 68 65 20 72 6f 77 69 64 20 6f 66 20 72 6f 77 the rowid of row
17ea0 20 74 68 61 74 20 74 68 65 20 76 69 72 74 75 61 that the virtua
17eb0 6c 20 74 61 62 6c 65 20 63 75 72 73 6f 72 20 70 l table cursor p
17ec0 43 75 72 20 69 73 0d 0a 20 20 20 20 20 20 20 20 Cur is..
17ed0 2f 2f 2f 20 63 75 72 72 65 6e 74 6c 79 20 70 6f /// currently po
17ee0 69 6e 74 69 6e 67 20 61 74 2e 20 54 68 69 73 20 inting at. This
17ef0 6d 65 74 68 6f 64 20 72 65 74 75 72 6e 73 20 53 method returns S
17f00 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 QLITE_OK on succ
17f10 65 73 73 2e 20 49 74 0d 0a 20 20 20 20 20 20 20 ess. It..
17f20 20 2f 2f 2f 20 72 65 74 75 72 6e 73 20 61 6e 20 /// returns an
17f30 61 70 70 72 6f 70 72 69 61 74 65 20 65 72 72 6f appropriate erro
17f40 72 20 63 6f 64 65 20 6f 6e 20 66 61 69 6c 75 72 r code on failur
17f50 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
17f60 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
17f70 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
17f80 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 78 52 6f /// The xRo
17f90 77 69 64 20 6d 65 74 68 6f 64 20 69 73 20 72 65 wid method is re
17fa0 71 75 69 72 65 64 20 66 6f 72 20 65 76 65 72 79 quired for every
17fb0 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 0d 0a virtual table..
17fc0 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6d 70 6c /// impl
17fd0 65 6d 65 6e 74 61 74 69 6f 6e 2e 0d 0a 20 20 20 ementation...
17fe0 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e /// </para>
17ff0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
18000 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
18010 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
18020 65 3d 22 70 43 75 72 73 6f 72 22 3e 0d 0a 20 20 e="pCursor">..
18030 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 /// The na
18040 74 69 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 tive pointer to
18050 74 68 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 the sqlite3_vtab
18060 5f 63 75 72 73 6f 72 20 64 65 72 69 76 65 64 20 _cursor derived
18070 73 74 72 75 63 74 75 72 65 2e 0d 0a 20 20 20 20 structure...
18080 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
18090 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
180a0 61 72 61 6d 20 6e 61 6d 65 3d 22 72 6f 77 49 64 aram name="rowId
180b0 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
180c0 55 70 6f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 Upon success, th
180d0 69 73 20 70 61 72 61 6d 65 74 65 72 20 6d 75 73 is parameter mus
180e0 74 20 62 65 20 6d 6f 64 69 66 69 65 64 20 74 6f t be modified to
180f0 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 75 6e 69 contain the uni
18100 71 75 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f que.. ///
18110 20 69 6e 74 65 67 65 72 20 72 6f 77 20 69 64 65 integer row ide
18120 6e 74 69 66 69 65 72 20 66 6f 72 20 74 68 65 20 ntifier for the
18130 63 75 72 72 65 6e 74 20 72 6f 77 20 66 6f 72 20 current row for
18140 74 68 65 20 73 70 65 63 69 66 69 65 64 20 63 75 the specified cu
18150 72 73 6f 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f rsor... /
18160 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
18170 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e /// <return
18180 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s>.. ///
18190 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 A standard SQLit
181a0 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a e return code...
181b0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 /// </re
181c0 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
181d0 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 SQLiteErrorCode
181e0 78 52 6f 77 49 64 28 0d 0a 20 20 20 20 20 20 20 xRowId(..
181f0 20 20 20 20 20 49 6e 74 50 74 72 20 70 43 75 72 IntPtr pCur
18200 73 6f 72 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 sor,..
18210 20 20 72 65 66 20 6c 6f 6e 67 20 72 6f 77 49 64 ref long rowId
18220 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 3b .. );
18230 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
18240 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
18250 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
18260 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
18270 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
18280 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ///.... /
18290 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
182a0 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e /// <para>
182b0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 6c .. /// Al
182c0 6c 20 63 68 61 6e 67 65 73 20 74 6f 20 61 20 76 l changes to a v
182d0 69 72 74 75 61 6c 20 74 61 62 6c 65 20 61 72 65 irtual table are
182e0 20 6d 61 64 65 20 75 73 69 6e 67 20 74 68 65 20 made using the
182f0 78 55 70 64 61 74 65 20 6d 65 74 68 6f 64 2e 0d xUpdate method..
18300 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 . /// Thi
18310 73 20 6f 6e 65 20 6d 65 74 68 6f 64 20 63 61 6e s one method can
18320 20 62 65 20 75 73 65 64 20 74 6f 20 69 6e 73 65 be used to inse
18330 72 74 2c 20 64 65 6c 65 74 65 2c 20 6f 72 20 75 rt, delete, or u
18340 70 64 61 74 65 2e 0d 0a 20 20 20 20 20 20 20 20 pdate...
18350 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 /// </para>..
18360 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d /// <para>.
18370 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
18380 20 61 72 67 63 20 70 61 72 61 6d 65 74 65 72 20 argc parameter
18390 73 70 65 63 69 66 69 65 73 20 74 68 65 20 6e 75 specifies the nu
183a0 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 mber of entries
183b0 69 6e 20 74 68 65 20 61 72 67 76 0d 0a 20 20 20 in the argv..
183c0 20 20 20 20 20 2f 2f 2f 20 61 72 72 61 79 2e 20 /// array.
183d0 54 68 65 20 76 61 6c 75 65 20 6f 66 20 61 72 67 The value of arg
183e0 63 20 77 69 6c 6c 20 62 65 20 31 20 66 6f 72 20 c will be 1 for
183f0 61 20 70 75 72 65 20 64 65 6c 65 74 65 20 6f 70 a pure delete op
18400 65 72 61 74 69 6f 6e 20 6f 72 0d 0a 20 20 20 20 eration or..
18410 20 20 20 20 2f 2f 2f 20 4e 2b 32 20 66 6f 72 20 /// N+2 for
18420 61 6e 20 69 6e 73 65 72 74 20 6f 72 20 72 65 70 an insert or rep
18430 6c 61 63 65 20 6f 72 20 75 70 64 61 74 65 20 77 lace or update w
18440 68 65 72 65 20 4e 20 69 73 20 74 68 65 20 6e 75 here N is the nu
18450 6d 62 65 72 20 6f 66 0d 0a 20 20 20 20 20 20 20 mber of..
18460 20 2f 2f 2f 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 /// columns in
18470 74 68 65 20 74 61 62 6c 65 2e 20 49 6e 20 74 68 the table. In th
18480 65 20 70 72 65 76 69 6f 75 73 20 73 65 6e 74 65 e previous sente
18490 6e 63 65 2c 20 4e 20 69 6e 63 6c 75 64 65 73 20 nce, N includes
184a0 61 6e 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f any.. ///
184b0 20 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e 73 2e hidden columns.
184c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
184d0 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
184e0 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 // <para>..
184f0 20 20 20 2f 2f 2f 20 45 76 65 72 79 20 61 72 67 /// Every arg
18500 76 20 65 6e 74 72 79 20 77 69 6c 6c 20 68 61 76 v entry will hav
18510 65 20 61 20 6e 6f 6e 2d 4e 55 4c 4c 20 76 61 6c e a non-NULL val
18520 75 65 20 69 6e 20 43 20 62 75 74 20 6d 61 79 20 ue in C but may
18530 63 6f 6e 74 61 69 6e 0d 0a 20 20 20 20 20 20 20 contain..
18540 20 2f 2f 2f 20 74 68 65 20 53 51 4c 20 76 61 6c /// the SQL val
18550 75 65 20 4e 55 4c 4c 2e 20 49 6e 20 6f 74 68 65 ue NULL. In othe
18560 72 20 77 6f 72 64 73 2c 20 69 74 20 69 73 20 61 r words, it is a
18570 6c 77 61 79 73 20 74 72 75 65 20 74 68 61 74 0d lways true that.
18580 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 72 67 . /// arg
18590 76 5b 69 5d 21 3d 30 20 66 6f 72 20 69 20 62 65 v[i]!=0 for i be
185a0 74 77 65 65 6e 20 30 20 61 6e 64 20 61 72 67 63 tween 0 and argc
185b0 2d 31 2e 20 48 6f 77 65 76 65 72 2c 20 69 74 20 -1. However, it
185c0 6d 69 67 68 74 20 62 65 20 74 68 65 0d 0a 20 20 might be the..
185d0 20 20 20 20 20 20 2f 2f 2f 20 63 61 73 65 20 74 /// case t
185e0 68 61 74 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 hat sqlite3_valu
185f0 65 5f 74 79 70 65 28 61 72 67 76 5b 69 5d 29 3d e_type(argv[i])=
18600 3d 53 51 4c 49 54 45 5f 4e 55 4c 4c 2e 0d 0a 20 =SQLITE_NULL...
18610 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
18620 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
18630 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 <para>..
18640 2f 2f 2f 20 54 68 65 20 61 72 67 76 5b 30 5d 20 /// The argv[0]
18650 70 61 72 61 6d 65 74 65 72 20 69 73 20 74 68 65 parameter is the
18660 20 72 6f 77 69 64 20 6f 66 20 61 20 72 6f 77 20 rowid of a row
18670 69 6e 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 in the virtual t
18680 61 62 6c 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f able.. //
18690 2f 20 74 6f 20 62 65 20 64 65 6c 65 74 65 64 2e / to be deleted.
186a0 20 49 66 20 61 72 67 76 5b 30 5d 20 69 73 20 61 If argv[0] is a
186b0 6e 20 53 51 4c 20 4e 55 4c 4c 2c 20 74 68 65 6e n SQL NULL, then
186c0 20 6e 6f 20 64 65 6c 65 74 69 6f 6e 20 6f 63 63 no deletion occ
186d0 75 72 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f urs... //
186e0 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 / </para>..
186f0 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 /// <para>..
18700 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 61 /// The a
18710 72 67 76 5b 31 5d 20 70 61 72 61 6d 65 74 65 72 rgv[1] parameter
18720 20 69 73 20 74 68 65 20 72 6f 77 69 64 20 6f 66 is the rowid of
18730 20 61 20 6e 65 77 20 72 6f 77 20 74 6f 20 62 65 a new row to be
18740 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 0d 0a inserted into..
18750 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 68 65 20 /// the
18760 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 20 49 virtual table. I
18770 66 20 61 72 67 76 5b 31 5d 20 69 73 20 61 6e 20 f argv[1] is an
18780 53 51 4c 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 SQL NULL, then t
18790 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 he.. ///
187a0 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6d implementation m
187b0 75 73 74 20 63 68 6f 6f 73 65 20 61 20 72 6f 77 ust choose a row
187c0 69 64 20 66 6f 72 20 74 68 65 20 6e 65 77 6c 79 id for the newly
187d0 20 69 6e 73 65 72 74 65 64 20 72 6f 77 2e 0d 0a inserted row...
187e0 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 75 62 73 /// Subs
187f0 65 71 75 65 6e 74 20 61 72 67 76 5b 5d 20 65 6e equent argv[] en
18800 74 72 69 65 73 20 63 6f 6e 74 61 69 6e 20 76 61 tries contain va
18810 6c 75 65 73 20 6f 66 20 74 68 65 20 63 6f 6c 75 lues of the colu
18820 6d 6e 73 20 6f 66 20 74 68 65 0d 0a 20 20 20 20 mns of the..
18830 20 20 20 20 2f 2f 2f 20 76 69 72 74 75 61 6c 20 /// virtual
18840 74 61 62 6c 65 2c 20 69 6e 20 74 68 65 20 6f 72 table, in the or
18850 64 65 72 20 74 68 61 74 20 74 68 65 20 63 6f 6c der that the col
18860 75 6d 6e 73 20 77 65 72 65 20 64 65 63 6c 61 72 umns were declar
18870 65 64 2e 20 54 68 65 0d 0a 20 20 20 20 20 20 20 ed. The..
18880 20 2f 2f 2f 20 6e 75 6d 62 65 72 20 6f 66 20 63 /// number of c
18890 6f 6c 75 6d 6e 73 20 77 69 6c 6c 20 6d 61 74 63 olumns will matc
188a0 68 20 74 68 65 20 74 61 62 6c 65 20 64 65 63 6c h the table decl
188b0 61 72 61 74 69 6f 6e 20 74 68 61 74 20 74 68 65 aration that the
188c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 78 43 .. /// xC
188d0 6f 6e 6e 65 63 74 20 6f 72 20 78 43 72 65 61 74 onnect or xCreat
188e0 65 20 6d 65 74 68 6f 64 20 6d 61 64 65 20 75 73 e method made us
188f0 69 6e 67 20 74 68 65 20 73 71 6c 69 74 65 33 5f ing the sqlite3_
18900 64 65 63 6c 61 72 65 5f 76 74 61 62 28 29 0d 0a declare_vtab()..
18910 20 20 20 20 20 20 20 20 2f 2f 2f 20 63 61 6c 6c /// call
18920 2e 20 41 6c 6c 20 68 69 64 64 65 6e 20 63 6f 6c . All hidden col
18930 75 6d 6e 73 20 61 72 65 20 69 6e 63 6c 75 64 65 umns are include
18940 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 d... ///
18950 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
18960 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
18970 20 20 20 20 20 2f 2f 2f 20 57 68 65 6e 20 64 6f /// When do
18980 69 6e 67 20 61 6e 20 69 6e 73 65 72 74 20 77 69 ing an insert wi
18990 74 68 6f 75 74 20 61 20 72 6f 77 69 64 20 28 61 thout a rowid (a
189a0 72 67 63 3e 31 2c 20 61 72 67 76 5b 31 5d 20 69 rgc>1, argv[1] i
189b0 73 20 61 6e 20 53 51 4c 0d 0a 20 20 20 20 20 20 s an SQL..
189c0 20 20 2f 2f 2f 20 4e 55 4c 4c 29 2c 20 74 68 65 /// NULL), the
189d0 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
189e0 6d 75 73 74 20 73 65 74 20 2a 70 52 6f 77 69 64 must set *pRowid
189f0 20 74 6f 20 74 68 65 20 72 6f 77 69 64 20 6f 66 to the rowid of
18a00 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f the.. //
18a10 2f 20 6e 65 77 6c 79 20 69 6e 73 65 72 74 65 64 / newly inserted
18a20 20 72 6f 77 3b 20 74 68 69 73 20 77 69 6c 6c 20 row; this will
18a30 62 65 63 6f 6d 65 20 74 68 65 20 76 61 6c 75 65 become the value
18a40 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 65 returned by the
18a50 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 .. /// sq
18a60 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e 73 65 72 lite3_last_inser
18a70 74 5f 72 6f 77 69 64 28 29 20 66 75 6e 63 74 69 t_rowid() functi
18a80 6f 6e 2e 20 53 65 74 74 69 6e 67 20 74 68 69 73 on. Setting this
18a90 20 76 61 6c 75 65 20 69 6e 20 61 6c 6c 20 74 68 value in all th
18aa0 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6f e.. /// o
18ab0 74 68 65 72 20 63 61 73 65 73 20 69 73 20 61 20 ther cases is a
18ac0 68 61 72 6d 6c 65 73 73 20 6e 6f 2d 6f 70 3b 20 harmless no-op;
18ad0 74 68 65 20 53 51 4c 69 74 65 20 65 6e 67 69 6e the SQLite engin
18ae0 65 20 69 67 6e 6f 72 65 73 20 74 68 65 0d 0a 20 e ignores the..
18af0 20 20 20 20 20 20 20 2f 2f 2f 20 2a 70 52 6f 77 /// *pRow
18b00 69 64 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 id return value
18b10 69 66 20 61 72 67 63 3d 3d 31 20 6f 72 20 61 72 if argc==1 or ar
18b20 67 76 5b 31 5d 20 69 73 20 6e 6f 74 20 61 6e 20 gv[1] is not an
18b30 53 51 4c 20 4e 55 4c 4c 2e 0d 0a 20 20 20 20 20 SQL NULL...
18b40 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a /// </para>..
18b50 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
18b60 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
18b70 45 61 63 68 20 63 61 6c 6c 20 74 6f 20 78 55 70 Each call to xUp
18b80 64 61 74 65 20 77 69 6c 6c 20 66 61 6c 6c 20 69 date will fall i
18b90 6e 74 6f 20 6f 6e 65 20 6f 66 20 63 61 73 65 73 nto one of cases
18ba0 20 73 68 6f 77 6e 20 62 65 6c 6f 77 2e 20 4e 6f shown below. No
18bb0 74 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 te.. ///
18bc0 74 68 61 74 20 72 65 66 65 72 65 6e 63 65 73 20 that references
18bd0 74 6f 20 61 72 67 76 5b 69 5d 20 6d 65 61 6e 20 to argv[i] mean
18be0 74 68 65 20 53 51 4c 20 76 61 6c 75 65 20 68 65 the SQL value he
18bf0 6c 64 20 77 69 74 68 69 6e 20 74 68 65 0d 0a 20 ld within the..
18c00 20 20 20 20 20 20 20 2f 2f 2f 20 61 72 67 76 5b /// argv[
18c10 69 5d 20 6f 62 6a 65 63 74 2c 20 6e 6f 74 20 74 i] object, not t
18c20 68 65 20 61 72 67 76 5b 69 5d 20 6f 62 6a 65 63 he argv[i] objec
18c30 74 20 69 74 73 65 6c 66 2e 0d 0a 20 20 20 20 20 t itself...
18c40 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a /// </para>..
18c50 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 63 6f 64 /// <cod
18c60 65 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e>.. ///
18c70 20 20 20 20 61 72 67 63 20 3d 20 31 0d 0a 20 20 argc = 1..
18c80 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 63 6f 64 65 /// </code
18c90 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
18ca0 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
18cb0 2f 2f 20 20 20 20 20 20 20 20 20 54 68 65 20 73 // The s
18cc0 69 6e 67 6c 65 20 72 6f 77 20 77 69 74 68 20 72 ingle row with r
18cd0 6f 77 69 64 20 65 71 75 61 6c 20 74 6f 20 61 72 owid equal to ar
18ce0 67 76 5b 30 5d 20 69 73 20 64 65 6c 65 74 65 64 gv[0] is deleted
18cf0 2e 20 4e 6f 0d 0a 20 20 20 20 20 20 20 20 2f 2f . No.. //
18d00 2f 20 20 20 20 20 20 20 20 20 69 6e 73 65 72 74 / insert
18d10 20 6f 63 63 75 72 73 2e 0d 0a 20 20 20 20 20 20 occurs...
18d20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
18d30 20 20 20 20 20 20 20 2f 2f 2f 20 3c 63 6f 64 65 /// <code
18d40 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 >.. ///
18d50 20 20 20 61 72 67 63 20 3e 20 31 0d 0a 20 20 20 argc > 1..
18d60 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 61 72 67 /// arg
18d70 76 5b 30 5d 20 3d 20 4e 55 4c 4c 0d 0a 20 20 20 v[0] = NULL..
18d80 20 20 20 20 20 2f 2f 2f 20 3c 2f 63 6f 64 65 3e /// </code>
18d90 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
18da0 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
18db0 2f 20 20 20 20 20 20 20 20 20 41 20 6e 65 77 20 / A new
18dc0 72 6f 77 20 69 73 20 69 6e 73 65 72 74 65 64 20 row is inserted
18dd0 77 69 74 68 20 61 20 72 6f 77 69 64 20 61 72 67 with a rowid arg
18de0 76 5b 31 5d 20 61 6e 64 20 63 6f 6c 75 6d 6e 0d v[1] and column.
18df0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 . ///
18e00 20 20 20 20 20 76 61 6c 75 65 73 20 69 6e 20 61 values in a
18e10 72 67 76 5b 32 5d 20 61 6e 64 20 66 6f 6c 6c 6f rgv[2] and follo
18e20 77 69 6e 67 2e 20 49 66 20 61 72 67 76 5b 31 5d wing. If argv[1]
18e30 20 69 73 20 61 6e 20 53 51 4c 20 4e 55 4c 4c 2c is an SQL NULL,
18e40 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 20 .. ///
18e50 20 20 20 20 20 20 74 68 65 20 61 20 6e 65 77 20 the a new
18e60 75 6e 69 71 75 65 20 72 6f 77 69 64 20 69 73 20 unique rowid is
18e70 67 65 6e 65 72 61 74 65 64 20 61 75 74 6f 6d 61 generated automa
18e80 74 69 63 61 6c 6c 79 2e 0d 0a 20 20 20 20 20 20 tically...
18e90 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
18ea0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 63 6f 64 65 /// <code
18eb0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 >.. ///
18ec0 20 20 20 61 72 67 63 20 3e 20 31 0d 0a 20 20 20 argc > 1..
18ed0 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 61 72 67 /// arg
18ee0 76 5b 30 5d 20 3f 20 4e 55 4c 4c 0d 0a 20 20 20 v[0] ? NULL..
18ef0 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 61 72 67 /// arg
18f00 76 5b 30 5d 20 3d 20 61 72 67 76 5b 31 5d 0d 0a v[0] = argv[1]..
18f10 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 63 6f /// </co
18f20 64 65 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f de>.. ///
18f30 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 <para>..
18f40 20 2f 2f 2f 20 20 20 20 20 20 20 20 20 54 68 65 /// The
18f50 20 72 6f 77 20 77 69 74 68 20 72 6f 77 69 64 20 row with rowid
18f60 61 72 67 76 5b 30 5d 20 69 73 20 75 70 64 61 74 argv[0] is updat
18f70 65 64 20 77 69 74 68 20 6e 65 77 20 76 61 6c 75 ed with new valu
18f80 65 73 20 69 6e 0d 0a 20 20 20 20 20 20 20 20 2f es in.. /
18f90 2f 2f 20 20 20 20 20 20 20 20 20 61 72 67 76 5b // argv[
18fa0 32 5d 20 61 6e 64 20 66 6f 6c 6c 6f 77 69 6e 67 2] and following
18fb0 20 70 61 72 61 6d 65 74 65 72 73 2e 0d 0a 20 20 parameters...
18fc0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
18fd0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
18fe0 63 6f 64 65 3e 0d 0a 20 20 20 20 20 20 20 20 2f code>.. /
18ff0 2f 2f 20 20 20 20 20 61 72 67 63 20 3e 20 31 0d // argc > 1.
19000 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 . ///
19010 20 61 72 67 76 5b 30 5d 20 3f 20 4e 55 4c 4c 0d argv[0] ? NULL.
19020 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 20 20 . ///
19030 20 61 72 67 76 5b 30 5d 20 3f 20 61 72 67 76 5b argv[0] ? argv[
19040 31 5d 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 1].. ///
19050 3c 2f 63 6f 64 65 3e 0d 0a 20 20 20 20 20 20 20 </code>..
19060 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
19070 20 20 20 20 20 2f 2f 2f 20 20 20 20 20 20 20 20 ///
19080 20 54 68 65 20 72 6f 77 20 77 69 74 68 20 72 6f The row with ro
19090 77 69 64 20 61 72 67 76 5b 30 5d 20 69 73 20 75 wid argv[0] is u
190a0 70 64 61 74 65 64 20 77 69 74 68 20 72 6f 77 69 pdated with rowi
190b0 64 20 61 72 67 76 5b 31 5d 0d 0a 20 20 20 20 20 d argv[1]..
190c0 20 20 20 2f 2f 2f 20 20 20 20 20 20 20 20 20 61 /// a
190d0 6e 64 20 6e 65 77 20 76 61 6c 75 65 73 20 69 6e nd new values in
190e0 20 61 72 67 76 5b 32 5d 20 61 6e 64 20 66 6f 6c argv[2] and fol
190f0 6c 6f 77 69 6e 67 20 70 61 72 61 6d 65 74 65 72 lowing parameter
19100 73 2e 20 54 68 69 73 0d 0a 20 20 20 20 20 20 20 s. This..
19110 20 2f 2f 2f 20 20 20 20 20 20 20 20 20 77 69 6c /// wil
19120 6c 20 6f 63 63 75 72 20 77 68 65 6e 20 61 6e 20 l occur when an
19130 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 75 70 SQL statement up
19140 64 61 74 65 73 20 61 20 72 6f 77 69 64 2c 20 61 dates a rowid, a
19150 73 20 69 6e 0d 0a 20 20 20 20 20 20 20 20 2f 2f s in.. //
19160 2f 20 20 20 20 20 20 20 20 20 74 68 65 20 73 74 / the st
19170 61 74 65 6d 65 6e 74 3a 0d 0a 20 20 20 20 20 20 atement:..
19180 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
19190 20 20 20 20 20 20 20 2f 2f 2f 20 3c 63 6f 64 65 /// <code
191a0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 20 >.. ///
191b0 20 20 20 20 20 20 20 20 20 20 20 55 50 44 41 54 UPDAT
191c0 45 20 74 61 62 6c 65 20 53 45 54 20 72 6f 77 69 E table SET rowi
191d0 64 3d 72 6f 77 69 64 2b 31 20 57 48 45 52 45 20 d=rowid+1 WHERE
191e0 2e 2e 2e 3b 0d 0a 20 20 20 20 20 20 20 20 2f 2f ...;.. //
191f0 2f 20 3c 2f 63 6f 64 65 3e 0d 0a 20 20 20 20 20 / </code>..
19200 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 /// <para>..
19210 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 78 /// The x
19220 55 70 64 61 74 65 20 6d 65 74 68 6f 64 20 6d 75 Update method mu
19230 73 74 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 st return SQLITE
19240 5f 4f 4b 20 69 66 20 61 6e 64 20 6f 6e 6c 79 20 _OK if and only
19250 69 66 20 69 74 20 69 73 0d 0a 20 20 20 20 20 20 if it is..
19260 20 20 2f 2f 2f 20 73 75 63 63 65 73 73 66 75 6c /// successful
19270 2e 20 49 66 20 61 20 66 61 69 6c 75 72 65 20 6f . If a failure o
19280 63 63 75 72 73 2c 20 74 68 65 20 78 55 70 64 61 ccurs, the xUpda
19290 74 65 20 6d 75 73 74 20 72 65 74 75 72 6e 20 61 te must return a
192a0 6e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 n.. /// a
192b0 70 70 72 6f 70 72 69 61 74 65 20 65 72 72 6f 72 ppropriate error
192c0 20 63 6f 64 65 2e 20 4f 6e 20 61 20 66 61 69 6c code. On a fail
192d0 75 72 65 2c 20 74 68 65 20 70 56 54 61 62 2d 3e ure, the pVTab->
192e0 7a 45 72 72 4d 73 67 20 65 6c 65 6d 65 6e 74 0d zErrMsg element.
192f0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6d 61 79 . /// may
19300 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 62 65 20 72 optionally be r
19310 65 70 6c 61 63 65 64 20 77 69 74 68 20 65 72 72 eplaced with err
19320 6f 72 20 6d 65 73 73 61 67 65 20 74 65 78 74 20 or message text
19330 73 74 6f 72 65 64 20 69 6e 20 6d 65 6d 6f 72 79 stored in memory
19340 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 6c .. /// al
19350 6c 6f 63 61 74 65 64 20 66 72 6f 6d 20 53 51 4c located from SQL
19360 69 74 65 20 75 73 69 6e 67 20 66 75 6e 63 74 69 ite using functi
19370 6f 6e 73 20 73 75 63 68 20 61 73 20 73 71 6c 69 ons such as sqli
19380 74 65 33 5f 6d 70 72 69 6e 74 66 28 29 20 6f 72 te3_mprintf() or
19390 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 .. /// sq
193a0 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e 0d lite3_malloc()..
193b0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
193c0 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
193d0 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 / <para>..
193e0 20 20 2f 2f 2f 20 49 66 20 74 68 65 20 78 55 70 /// If the xUp
193f0 64 61 74 65 20 6d 65 74 68 6f 64 20 76 69 6f 6c date method viol
19400 61 74 65 73 20 73 6f 6d 65 20 63 6f 6e 73 74 72 ates some constr
19410 61 69 6e 74 20 6f 66 20 74 68 65 20 76 69 72 74 aint of the virt
19420 75 61 6c 20 74 61 62 6c 65 0d 0a 20 20 20 20 20 ual table..
19430 20 20 20 2f 2f 2f 20 28 69 6e 63 6c 75 64 69 6e /// (includin
19440 67 2c 20 62 75 74 20 6e 6f 74 20 6c 69 6d 69 74 g, but not limit
19450 65 64 20 74 6f 2c 20 61 74 74 65 6d 70 74 69 6e ed to, attemptin
19460 67 20 74 6f 20 73 74 6f 72 65 20 61 20 76 61 6c g to store a val
19470 75 65 20 6f 66 20 74 68 65 0d 0a 20 20 20 20 20 ue of the..
19480 20 20 20 2f 2f 2f 20 77 72 6f 6e 67 20 64 61 74 /// wrong dat
19490 61 74 79 70 65 2c 20 61 74 74 65 6d 70 74 69 6e atype, attemptin
194a0 67 20 74 6f 20 73 74 6f 72 65 20 61 20 76 61 6c g to store a val
194b0 75 65 20 74 68 61 74 20 69 73 20 74 6f 6f 20 6c ue that is too l
194c0 61 72 67 65 20 6f 72 0d 0a 20 20 20 20 20 20 20 arge or..
194d0 20 2f 2f 2f 20 74 6f 6f 20 73 6d 61 6c 6c 2c 20 /// too small,
194e0 6f 72 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f or attempting to
194f0 20 63 68 61 6e 67 65 20 61 20 72 65 61 64 2d 6f change a read-o
19500 6e 6c 79 20 76 61 6c 75 65 29 20 74 68 65 6e 20 nly value) then
19510 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f the.. ///
19520 20 78 55 70 64 61 74 65 20 6d 75 73 74 20 66 61 xUpdate must fa
19530 69 6c 20 77 69 74 68 20 61 6e 20 61 70 70 72 6f il with an appro
19540 70 72 69 61 74 65 20 65 72 72 6f 72 20 63 6f 64 priate error cod
19550 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
19560 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
19570 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
19580 20 20 20 20 20 2f 2f 2f 20 54 68 65 72 65 20 6d /// There m
19590 69 67 68 74 20 62 65 20 6f 6e 65 20 6f 72 20 6d ight be one or m
195a0 6f 72 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 ore sqlite3_vtab
195b0 5f 63 75 72 73 6f 72 20 6f 62 6a 65 63 74 73 20 _cursor objects
195c0 6f 70 65 6e 20 61 6e 64 20 69 6e 0d 0a 20 20 20 open and in..
195d0 20 20 20 20 20 2f 2f 2f 20 75 73 65 20 6f 6e 20 /// use on
195e0 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c the virtual tabl
195f0 65 20 69 6e 73 74 61 6e 63 65 20 61 6e 64 20 70 e instance and p
19600 65 72 68 61 70 73 20 65 76 65 6e 20 6f 6e 20 74 erhaps even on t
19610 68 65 20 72 6f 77 20 6f 66 0d 0a 20 20 20 20 20 he row of..
19620 20 20 20 2f 2f 2f 20 74 68 65 20 76 69 72 74 75 /// the virtu
19630 61 6c 20 74 61 62 6c 65 20 77 68 65 6e 20 74 68 al table when th
19640 65 20 78 55 70 64 61 74 65 20 6d 65 74 68 6f 64 e xUpdate method
19650 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 54 68 65 is invoked. The
19660 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6d .. /// im
19670 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 plementation of
19680 78 55 70 64 61 74 65 20 6d 75 73 74 20 62 65 20 xUpdate must be
19690 70 72 65 70 61 72 65 64 20 66 6f 72 20 61 74 74 prepared for att
196a0 65 6d 70 74 73 20 74 6f 20 64 65 6c 65 74 65 0d empts to delete.
196b0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6f 72 20 . /// or
196c0 6d 6f 64 69 66 79 20 72 6f 77 73 20 6f 66 20 74 modify rows of t
196d0 68 65 20 74 61 62 6c 65 20 6f 75 74 20 66 72 6f he table out fro
196e0 6d 20 6f 74 68 65 72 20 65 78 69 73 74 69 6e 67 m other existing
196f0 20 63 75 72 73 6f 72 73 2e 20 49 66 20 74 68 65 cursors. If the
19700 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 76 69 .. /// vi
19710 72 74 75 61 6c 20 74 61 62 6c 65 20 63 61 6e 6e rtual table cann
19720 6f 74 20 61 63 63 6f 6d 6d 6f 64 61 74 65 20 73 ot accommodate s
19730 75 63 68 20 63 68 61 6e 67 65 73 2c 20 74 68 65 uch changes, the
19740 20 78 55 70 64 61 74 65 20 6d 65 74 68 6f 64 0d xUpdate method.
19750 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6d 75 73 . /// mus
19760 74 20 72 65 74 75 72 6e 20 61 6e 20 65 72 72 6f t return an erro
19770 72 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 r code...
19780 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 /// </para>..
19790 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e /// <para>
197a0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
197b0 65 20 78 55 70 64 61 74 65 20 6d 65 74 68 6f 64 e xUpdate method
197c0 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 20 49 66 is optional. If
197d0 20 74 68 65 20 78 55 70 64 61 74 65 20 70 6f 69 the xUpdate poi
197e0 6e 74 65 72 20 69 6e 20 74 68 65 0d 0a 20 20 20 nter in the..
197f0 20 20 20 20 20 2f 2f 2f 20 73 71 6c 69 74 65 33 /// sqlite3
19800 5f 6d 6f 64 75 6c 65 20 66 6f 72 20 61 20 76 69 _module for a vi
19810 72 74 75 61 6c 20 74 61 62 6c 65 20 69 73 20 61 rtual table is a
19820 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 2c 20 74 NULL pointer, t
19830 68 65 6e 20 74 68 65 0d 0a 20 20 20 20 20 20 20 hen the..
19840 20 2f 2f 2f 20 76 69 72 74 75 61 6c 20 74 61 62 /// virtual tab
19850 6c 65 20 69 73 20 72 65 61 64 2d 6f 6e 6c 79 2e le is read-only.
19860 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
19870 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
19880 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
19890 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
198a0 6d 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 3e 0d m name="pVtab">.
198b0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
198c0 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 72 20 native pointer
198d0 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 to the sqlite3_v
198e0 74 61 62 20 64 65 72 69 76 65 64 20 73 74 72 75 tab derived stru
198f0 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 cture...
19900 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
19910 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
19920 20 6e 61 6d 65 3d 22 61 72 67 63 22 3e 0d 0a 20 name="argc">..
19930 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e /// The n
19940 75 6d 62 65 72 20 6f 66 20 6e 65 77 20 6f 72 20 umber of new or
19950 6d 6f 64 69 66 69 65 64 20 63 6f 6c 75 6d 6e 20 modified column
19960 76 61 6c 75 65 73 20 63 6f 6e 74 61 69 6e 65 64 values contained
19970 20 69 6e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f in.. ///
19980 20 3c 70 61 72 61 6d 72 65 66 20 6e 61 6d 65 3d <paramref name=
19990 22 61 72 67 76 22 20 2f 3e 2e 0d 0a 20 20 20 20 "argv" />...
199a0 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
199b0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
199c0 61 72 61 6d 20 6e 61 6d 65 3d 22 61 72 67 76 22 aram name="argv"
199d0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
199e0 68 65 20 61 72 72 61 79 20 6f 66 20 6e 61 74 69 he array of nati
199f0 76 65 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 73 ve pointers to s
19a00 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 73 74 72 qlite3_value str
19a10 75 63 74 75 72 65 73 20 63 6f 6e 74 61 69 6e 69 uctures containi
19a20 6e 67 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ng.. ///
19a30 74 68 65 20 6e 65 77 20 6f 72 20 6d 6f 64 69 66 the new or modif
19a40 69 65 64 20 63 6f 6c 75 6d 6e 20 76 61 6c 75 65 ied column value
19a50 73 2c 20 69 66 20 61 6e 79 2e 0d 0a 20 20 20 20 s, if any...
19a60 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
19a70 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
19a80 61 72 61 6d 20 6e 61 6d 65 3d 22 72 6f 77 49 64 aram name="rowId
19a90 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
19aa0 55 70 6f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 Upon success, th
19ab0 69 73 20 70 61 72 61 6d 65 74 65 72 20 6d 75 73 is parameter mus
19ac0 74 20 62 65 20 6d 6f 64 69 66 69 65 64 20 74 6f t be modified to
19ad0 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 75 6e 69 contain the uni
19ae0 71 75 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f que.. ///
19af0 20 69 6e 74 65 67 65 72 20 72 6f 77 20 69 64 65 integer row ide
19b00 6e 74 69 66 69 65 72 20 66 6f 72 20 74 68 65 20 ntifier for the
19b10 72 6f 77 20 74 68 61 74 20 77 61 73 20 69 6e 73 row that was ins
19b20 65 72 74 65 64 2c 20 69 66 20 61 6e 79 2e 0d 0a erted, if any...
19b30 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
19b40 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
19b50 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 / <returns>..
19b60 20 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 /// A stand
19b70 61 72 64 20 53 51 4c 69 74 65 20 72 65 74 75 72 ard SQLite retur
19b80 6e 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 n code...
19b90 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d /// </returns>.
19ba0 0a 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 45 . SQLiteE
19bb0 72 72 6f 72 43 6f 64 65 20 78 55 70 64 61 74 65 rrorCode xUpdate
19bc0 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 (.. I
19bd0 6e 74 50 74 72 20 70 56 74 61 62 2c 0d 0a 20 20 ntPtr pVtab,..
19be0 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 61 72 int ar
19bf0 67 63 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 gc,..
19c00 20 49 6e 74 50 74 72 20 61 72 67 76 2c 0d 0a 20 IntPtr argv,..
19c10 20 20 20 20 20 20 20 20 20 20 20 72 65 66 20 6c ref l
19c20 6f 6e 67 20 72 6f 77 49 64 0d 0a 20 20 20 20 20 ong rowId..
19c30 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 );....
19c40 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
19c50 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
19c60 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
19c70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
19c80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
19c90 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
19ca0 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
19cb0 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 // <para>..
19cc0 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 /// This meth
19cd0 6f 64 20 62 65 67 69 6e 73 20 61 20 74 72 61 6e od begins a tran
19ce0 73 61 63 74 69 6f 6e 20 6f 6e 20 61 20 76 69 72 saction on a vir
19cf0 74 75 61 6c 20 74 61 62 6c 65 2e 20 54 68 69 73 tual table. This
19d00 20 69 73 20 6d 65 74 68 6f 64 0d 0a 20 20 20 20 is method..
19d10 20 20 20 20 2f 2f 2f 20 69 73 20 6f 70 74 69 6f /// is optio
19d20 6e 61 6c 2e 20 54 68 65 20 78 42 65 67 69 6e 20 nal. The xBegin
19d30 70 6f 69 6e 74 65 72 20 6f 66 20 73 71 6c 69 74 pointer of sqlit
19d40 65 33 5f 6d 6f 64 75 6c 65 20 6d 61 79 20 62 65 e3_module may be
19d50 20 4e 55 4c 4c 2e 0d 0a 20 20 20 20 20 20 20 20 NULL...
19d60 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 /// </para>..
19d70 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d /// <para>.
19d80 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 . /// Thi
19d90 73 20 6d 65 74 68 6f 64 20 69 73 20 61 6c 77 61 s method is alwa
19da0 79 73 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6f ys followed by o
19db0 6e 65 20 63 61 6c 6c 20 74 6f 20 65 69 74 68 65 ne call to eithe
19dc0 72 20 74 68 65 20 78 43 6f 6d 6d 69 74 20 6f 72 r the xCommit or
19dd0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 78 52 .. /// xR
19de0 6f 6c 6c 62 61 63 6b 20 6d 65 74 68 6f 64 2e 20 ollback method.
19df0 56 69 72 74 75 61 6c 20 74 61 62 6c 65 20 74 72 Virtual table tr
19e00 61 6e 73 61 63 74 69 6f 6e 73 20 64 6f 20 6e 6f ansactions do no
19e10 74 20 6e 65 73 74 2c 20 73 6f 20 74 68 65 0d 0a t nest, so the..
19e20 20 20 20 20 20 20 20 20 2f 2f 2f 20 78 42 65 67 /// xBeg
19e30 69 6e 20 6d 65 74 68 6f 64 20 77 69 6c 6c 20 6e in method will n
19e40 6f 74 20 62 65 20 69 6e 76 6f 6b 65 64 20 6d 6f ot be invoked mo
19e50 72 65 20 74 68 61 6e 20 6f 6e 63 65 20 6f 6e 20 re than once on
19e60 61 20 73 69 6e 67 6c 65 0d 0a 20 20 20 20 20 20 a single..
19e70 20 20 2f 2f 2f 20 76 69 72 74 75 61 6c 20 74 61 /// virtual ta
19e80 62 6c 65 20 77 69 74 68 6f 75 74 20 61 6e 20 69 ble without an i
19e90 6e 74 65 72 76 65 6e 69 6e 67 20 63 61 6c 6c 20 ntervening call
19ea0 74 6f 20 65 69 74 68 65 72 20 78 43 6f 6d 6d 69 to either xCommi
19eb0 74 20 6f 72 0d 0a 20 20 20 20 20 20 20 20 2f 2f t or.. //
19ec0 2f 20 78 52 6f 6c 6c 62 61 63 6b 2e 20 4d 75 6c / xRollback. Mul
19ed0 74 69 70 6c 65 20 63 61 6c 6c 73 20 74 6f 20 6f tiple calls to o
19ee0 74 68 65 72 20 6d 65 74 68 6f 64 73 20 63 61 6e ther methods can
19ef0 20 61 6e 64 20 6c 69 6b 65 6c 79 20 77 69 6c 6c and likely will
19f00 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6f 63 .. /// oc
19f10 63 75 72 20 69 6e 20 62 65 74 77 65 65 6e 20 74 cur in between t
19f20 68 65 20 78 42 65 67 69 6e 20 61 6e 64 20 74 68 he xBegin and th
19f30 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 e corresponding
19f40 78 43 6f 6d 6d 69 74 20 6f 72 0d 0a 20 20 20 20 xCommit or..
19f50 20 20 20 20 2f 2f 2f 20 78 52 6f 6c 6c 62 61 63 /// xRollbac
19f60 6b 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 k... ///
19f70 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
19f80 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
19f90 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
19fa0 72 61 6d 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 ram name="pVtab"
19fb0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
19fc0 68 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 he native pointe
19fd0 72 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 r to the sqlite3
19fe0 5f 76 74 61 62 20 64 65 72 69 76 65 64 20 73 74 _vtab derived st
19ff0 72 75 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 ructure...
1a000 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
1a010 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 /// <ret
1a020 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f urns>.. /
1a030 2f 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 // A standard SQ
1a040 4c 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 Lite return code
1a050 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
1a060 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 /returns>..
1a070 20 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f SQLiteErrorCo
1a080 64 65 20 78 42 65 67 69 6e 28 0d 0a 20 20 20 20 de xBegin(..
1a090 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 IntPtr p
1a0a0 56 74 61 62 0d 0a 20 20 20 20 20 20 20 20 20 20 Vtab..
1a0b0 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 );....
1a0c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1a0d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1a0e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1a0f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1a100 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
1a110 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
1a120 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
1a130 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
1a140 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 20 73 69 / This method si
1a150 67 6e 61 6c 73 20 74 68 65 20 73 74 61 72 74 20 gnals the start
1a160 6f 66 20 61 20 74 77 6f 2d 70 68 61 73 65 20 63 of a two-phase c
1a170 6f 6d 6d 69 74 20 6f 6e 20 61 20 76 69 72 74 75 ommit on a virtu
1a180 61 6c 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 al.. ///
1a190 74 61 62 6c 65 2e 20 54 68 69 73 20 69 73 20 6d table. This is m
1a1a0 65 74 68 6f 64 20 69 73 20 6f 70 74 69 6f 6e 61 ethod is optiona
1a1b0 6c 2e 20 54 68 65 20 78 53 79 6e 63 20 70 6f 69 l. The xSync poi
1a1c0 6e 74 65 72 20 6f 66 0d 0a 20 20 20 20 20 20 20 nter of..
1a1d0 20 2f 2f 2f 20 73 71 6c 69 74 65 33 5f 6d 6f 64 /// sqlite3_mod
1a1e0 75 6c 65 20 6d 61 79 20 62 65 20 4e 55 4c 4c 2e ule may be NULL.
1a1f0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
1a200 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
1a210 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 // <para>..
1a220 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 /// This meth
1a230 6f 64 20 69 73 20 6f 6e 6c 79 20 69 6e 76 6f 6b od is only invok
1a240 65 64 20 61 66 74 65 72 20 63 61 6c 6c 20 74 6f ed after call to
1a250 20 74 68 65 20 78 42 65 67 69 6e 20 6d 65 74 68 the xBegin meth
1a260 6f 64 20 61 6e 64 0d 0a 20 20 20 20 20 20 20 20 od and..
1a270 2f 2f 2f 20 70 72 69 6f 72 20 74 6f 20 61 6e 20 /// prior to an
1a280 78 43 6f 6d 6d 69 74 20 6f 72 20 78 52 6f 6c 6c xCommit or xRoll
1a290 62 61 63 6b 2e 20 49 6e 20 6f 72 64 65 72 20 74 back. In order t
1a2a0 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74 77 6f 2d o implement two-
1a2b0 70 68 61 73 65 0d 0a 20 20 20 20 20 20 20 20 2f phase.. /
1a2c0 2f 2f 20 63 6f 6d 6d 69 74 2c 20 74 68 65 20 78 // commit, the x
1a2d0 53 79 6e 63 20 6d 65 74 68 6f 64 20 6f 6e 20 61 Sync method on a
1a2e0 6c 6c 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 ll virtual table
1a2f0 73 20 69 73 20 69 6e 76 6f 6b 65 64 20 70 72 69 s is invoked pri
1a300 6f 72 20 74 6f 0d 0a 20 20 20 20 20 20 20 20 2f or to.. /
1a310 2f 2f 20 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 // invoking the
1a320 78 43 6f 6d 6d 69 74 20 6d 65 74 68 6f 64 20 6f xCommit method o
1a330 6e 20 61 6e 79 20 76 69 72 74 75 61 6c 20 74 61 n any virtual ta
1a340 62 6c 65 2e 20 49 66 20 61 6e 79 20 6f 66 20 74 ble. If any of t
1a350 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 he.. ///
1a360 78 53 79 6e 63 20 6d 65 74 68 6f 64 73 20 66 61 xSync methods fa
1a370 69 6c 2c 20 74 68 65 20 65 6e 74 69 72 65 20 74 il, the entire t
1a380 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 6f ransaction is ro
1a390 6c 6c 65 64 20 62 61 63 6b 2e 0d 0a 20 20 20 20 lled back...
1a3a0 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d /// </para>.
1a3b0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
1a3c0 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
1a3d0 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
1a3e0 3d 22 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 ="pVtab">..
1a3f0 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 /// The nativ
1a400 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 e pointer to the
1a410 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20 64 65 sqlite3_vtab de
1a420 72 69 76 65 64 20 73 74 72 75 63 74 75 72 65 2e rived structure.
1a430 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
1a440 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
1a450 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 /// <returns>..
1a460 20 20 20 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 /// A sta
1a470 6e 64 61 72 64 20 53 51 4c 69 74 65 20 72 65 74 ndard SQLite ret
1a480 75 72 6e 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 urn code...
1a490 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 /// </returns
1a4a0 3e 0d 0a 20 20 20 20 20 20 20 20 53 51 4c 69 74 >.. SQLit
1a4b0 65 45 72 72 6f 72 43 6f 64 65 20 78 53 79 6e 63 eErrorCode xSync
1a4c0 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 (.. I
1a4d0 6e 74 50 74 72 20 70 56 74 61 62 0d 0a 20 20 20 ntPtr pVtab..
1a4e0 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 );....
1a4f0 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
1a500 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1a510 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1a520 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1a530 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a //////////////..
1a540 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
1a550 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
1a560 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 /// <para>..
1a570 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 /// This me
1a580 74 68 6f 64 20 63 61 75 73 65 73 20 61 20 76 69 thod causes a vi
1a590 72 74 75 61 6c 20 74 61 62 6c 65 20 74 72 61 6e rtual table tran
1a5a0 73 61 63 74 69 6f 6e 20 74 6f 20 63 6f 6d 6d 69 saction to commi
1a5b0 74 2e 20 54 68 69 73 20 69 73 0d 0a 20 20 20 20 t. This is..
1a5c0 20 20 20 20 2f 2f 2f 20 6d 65 74 68 6f 64 20 69 /// method i
1a5d0 73 20 6f 70 74 69 6f 6e 61 6c 2e 20 54 68 65 20 s optional. The
1a5e0 78 43 6f 6d 6d 69 74 20 70 6f 69 6e 74 65 72 20 xCommit pointer
1a5f0 6f 66 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c of sqlite3_modul
1a600 65 20 6d 61 79 20 62 65 0d 0a 20 20 20 20 20 20 e may be..
1a610 20 20 2f 2f 2f 20 4e 55 4c 4c 2e 0d 0a 20 20 20 /// NULL...
1a620 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e /// </para>
1a630 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
1a640 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
1a650 2f 20 41 20 63 61 6c 6c 20 74 6f 20 74 68 69 73 / A call to this
1a660 20 6d 65 74 68 6f 64 20 61 6c 77 61 79 73 20 66 method always f
1a670 6f 6c 6c 6f 77 73 20 61 20 70 72 69 6f 72 20 63 ollows a prior c
1a680 61 6c 6c 20 74 6f 20 78 42 65 67 69 6e 20 61 6e all to xBegin an
1a690 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 78 d.. /// x
1a6a0 53 79 6e 63 2e 0d 0a 20 20 20 20 20 20 20 20 2f Sync... /
1a6b0 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 // </para>..
1a6c0 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
1a6d0 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
1a6e0 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 56 74 <param name="pVt
1a6f0 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ab">.. //
1a700 2f 20 54 68 65 20 6e 61 74 69 76 65 20 70 6f 69 / The native poi
1a710 6e 74 65 72 20 74 6f 20 74 68 65 20 73 71 6c 69 nter to the sqli
1a720 74 65 33 5f 76 74 61 62 20 64 65 72 69 76 65 64 te3_vtab derived
1a730 20 73 74 72 75 63 74 75 72 65 2e 0d 0a 20 20 20 structure...
1a740 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
1a750 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
1a760 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
1a770 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 72 64 /// A standard
1a780 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e 20 63 SQLite return c
1a790 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ode... //
1a7a0 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 / </returns>..
1a7b0 20 20 20 20 20 20 53 51 4c 69 74 65 45 72 72 6f SQLiteErro
1a7c0 72 43 6f 64 65 20 78 43 6f 6d 6d 69 74 28 0d 0a rCode xCommit(..
1a7d0 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 IntP
1a7e0 74 72 20 70 56 74 61 62 0d 0a 20 20 20 20 20 20 tr pVtab..
1a7f0 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 );....
1a800 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
1a810 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1a820 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1a830 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1a840 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
1a850 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
1a860 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
1a870 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 / <para>..
1a880 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 6f /// This metho
1a890 64 20 63 61 75 73 65 73 20 61 20 76 69 72 74 75 d causes a virtu
1a8a0 61 6c 20 74 61 62 6c 65 20 74 72 61 6e 73 61 63 al table transac
1a8b0 74 69 6f 6e 20 74 6f 20 72 6f 6c 6c 62 61 63 6b tion to rollback
1a8c0 2e 20 54 68 69 73 20 69 73 0d 0a 20 20 20 20 20 . This is..
1a8d0 20 20 20 2f 2f 2f 20 6d 65 74 68 6f 64 20 69 73 /// method is
1a8e0 20 6f 70 74 69 6f 6e 61 6c 2e 20 54 68 65 20 78 optional. The x
1a8f0 52 6f 6c 6c 62 61 63 6b 20 70 6f 69 6e 74 65 72 Rollback pointer
1a900 20 6f 66 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 of sqlite3_modu
1a910 6c 65 20 6d 61 79 20 62 65 0d 0a 20 20 20 20 20 le may be..
1a920 20 20 20 2f 2f 2f 20 4e 55 4c 4c 2e 0d 0a 20 20 /// NULL...
1a930 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
1a940 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
1a950 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
1a960 2f 2f 20 41 20 63 61 6c 6c 20 74 6f 20 74 68 69 // A call to thi
1a970 73 20 6d 65 74 68 6f 64 20 61 6c 77 61 79 73 20 s method always
1a980 66 6f 6c 6c 6f 77 73 20 61 20 70 72 69 6f 72 20 follows a prior
1a990 63 61 6c 6c 20 74 6f 20 78 42 65 67 69 6e 2e 0d call to xBegin..
1a9a0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
1a9b0 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
1a9c0 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 / </summary>..
1a9d0 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
1a9e0 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 3e 0d 0a name="pVtab">..
1a9f0 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
1aa00 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 72 20 74 native pointer t
1aa10 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 74 o the sqlite3_vt
1aa20 61 62 20 64 65 72 69 76 65 64 20 73 74 72 75 63 ab derived struc
1aa30 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f ture... /
1aa40 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
1aa50 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e /// <return
1aa60 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s>.. ///
1aa70 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 A standard SQLit
1aa80 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a e return code...
1aa90 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 /// </re
1aaa0 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
1aab0 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 SQLiteErrorCode
1aac0 78 52 6f 6c 6c 62 61 63 6b 28 0d 0a 20 20 20 20 xRollback(..
1aad0 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 IntPtr p
1aae0 56 74 61 62 0d 0a 20 20 20 20 20 20 20 20 20 20 Vtab..
1aaf0 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 );....
1ab00 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ab10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ab20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ab30 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ab40 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
1ab50 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
1ab60 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
1ab70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
1ab80 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 20 70 72 / This method pr
1ab90 6f 76 69 64 65 73 20 6e 6f 74 69 66 69 63 61 74 ovides notificat
1aba0 69 6f 6e 20 74 68 61 74 20 74 68 65 20 76 69 72 ion that the vir
1abb0 74 75 61 6c 20 74 61 62 6c 65 0d 0a 20 20 20 20 tual table..
1abc0 20 20 20 20 2f 2f 2f 20 69 6d 70 6c 65 6d 65 6e /// implemen
1abd0 74 61 74 69 6f 6e 20 74 68 61 74 20 74 68 65 20 tation that the
1abe0 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 77 69 virtual table wi
1abf0 6c 6c 20 62 65 20 67 69 76 65 6e 20 61 20 6e 65 ll be given a ne
1ac00 77 20 6e 61 6d 65 2e 20 49 66 0d 0a 20 20 20 20 w name. If..
1ac10 20 20 20 20 2f 2f 2f 20 74 68 69 73 20 6d 65 74 /// this met
1ac20 68 6f 64 20 72 65 74 75 72 6e 73 20 53 51 4c 49 hod returns SQLI
1ac30 54 45 5f 4f 4b 20 74 68 65 6e 20 53 51 4c 69 74 TE_OK then SQLit
1ac40 65 20 72 65 6e 61 6d 65 73 20 74 68 65 20 74 61 e renames the ta
1ac50 62 6c 65 2e 20 49 66 0d 0a 20 20 20 20 20 20 20 ble. If..
1ac60 20 2f 2f 2f 20 74 68 69 73 20 6d 65 74 68 6f 64 /// this method
1ac70 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72 72 6f returns an erro
1ac80 72 20 63 6f 64 65 20 74 68 65 6e 20 74 68 65 20 r code then the
1ac90 72 65 6e 61 6d 69 6e 67 20 69 73 20 70 72 65 76 renaming is prev
1aca0 65 6e 74 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 ented...
1acb0 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 /// </para>..
1acc0 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d /// <para>.
1acd0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
1ace0 20 78 52 65 6e 61 6d 65 20 6d 65 74 68 6f 64 20 xRename method
1acf0 69 73 20 72 65 71 75 69 72 65 64 20 66 6f 72 20 is required for
1ad00 65 76 65 72 79 20 76 69 72 74 75 61 6c 20 74 61 every virtual ta
1ad10 62 6c 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ble.. ///
1ad20 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e implementation.
1ad30 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
1ad40 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
1ad50 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
1ad60 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
1ad70 6d 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 3e 0d m name="pVtab">.
1ad80 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
1ad90 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 72 20 native pointer
1ada0 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 to the sqlite3_v
1adb0 74 61 62 20 64 65 72 69 76 65 64 20 73 74 72 75 tab derived stru
1adc0 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 cture...
1add0 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
1ade0 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
1adf0 20 6e 61 6d 65 3d 22 6e 41 72 67 22 3e 0d 0a 20 name="nArg">..
1ae00 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e /// The n
1ae10 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e umber of argumen
1ae20 74 73 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69 ts to the functi
1ae30 6f 6e 20 62 65 69 6e 67 20 73 6f 75 67 68 74 2e on being sought.
1ae40 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
1ae50 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
1ae60 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
1ae70 22 7a 4e 61 6d 65 22 3e 0d 0a 20 20 20 20 20 20 "zName">..
1ae80 20 20 2f 2f 2f 20 54 68 65 20 6e 61 6d 65 20 6f /// The name o
1ae90 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 62 f the function b
1aea0 65 69 6e 67 20 73 6f 75 67 68 74 2e 0d 0a 20 20 eing sought...
1aeb0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
1aec0 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
1aed0 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 63 61 6c <param name="cal
1aee0 6c 62 61 63 6b 22 3e 0d 0a 20 20 20 20 20 20 20 lback">..
1aef0 20 2f 2f 2f 20 55 70 6f 6e 20 73 75 63 63 65 73 /// Upon succes
1af00 73 2c 20 74 68 69 73 20 70 61 72 61 6d 65 74 65 s, this paramete
1af10 72 20 6d 75 73 74 20 62 65 20 6d 6f 64 69 66 69 r must be modifi
1af20 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e 20 74 68 ed to contain th
1af30 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 64 e.. /// d
1af40 65 6c 65 67 61 74 65 20 72 65 73 70 6f 6e 73 69 elegate responsi
1af50 62 6c 65 20 66 6f 72 20 69 6d 70 6c 65 6d 65 6e ble for implemen
1af60 74 69 6e 67 20 74 68 65 20 73 70 65 63 69 66 69 ting the specifi
1af70 65 64 20 66 75 6e 63 74 69 6f 6e 2e 0d 0a 20 20 ed function...
1af80 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
1af90 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
1afa0 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 43 6c <param name="pCl
1afb0 69 65 6e 74 44 61 74 61 22 3e 0d 0a 20 20 20 20 ientData">..
1afc0 20 20 20 20 2f 2f 2f 20 55 70 6f 6e 20 73 75 63 /// Upon suc
1afd0 63 65 73 73 2c 20 74 68 69 73 20 70 61 72 61 6d cess, this param
1afe0 65 74 65 72 20 6d 75 73 74 20 62 65 20 6d 6f 64 eter must be mod
1aff0 69 66 69 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e ified to contain
1b000 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f the.. //
1b010 2f 20 6e 61 74 69 76 65 20 75 73 65 72 2d 64 61 / native user-da
1b020 74 61 20 70 6f 69 6e 74 65 72 20 61 73 73 6f 63 ta pointer assoc
1b030 69 61 74 65 64 20 77 69 74 68 0d 0a 20 20 20 20 iated with..
1b040 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 72 65 /// <paramre
1b050 66 20 6e 61 6d 65 3d 22 63 61 6c 6c 62 61 63 6b f name="callback
1b060 22 20 2f 3e 2e 0d 0a 20 20 20 20 20 20 20 20 2f " />... /
1b070 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
1b080 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e /// <return
1b090 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s>.. ///
1b0a0 4e 6f 6e 2d 7a 65 72 6f 20 69 66 20 74 68 65 20 Non-zero if the
1b0b0 73 70 65 63 69 66 69 65 64 20 66 75 6e 63 74 69 specified functi
1b0c0 6f 6e 20 77 61 73 20 66 6f 75 6e 64 3b 20 7a 65 on was found; ze
1b0d0 72 6f 20 6f 74 68 65 72 77 69 73 65 2e 0d 0a 20 ro otherwise...
1b0e0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 /// </ret
1b0f0 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 69 urns>.. i
1b100 6e 74 20 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e nt xFindFunction
1b110 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 (.. I
1b120 6e 74 50 74 72 20 70 56 74 61 62 2c 0d 0a 20 20 ntPtr pVtab,..
1b130 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 6e 41 int nA
1b140 72 67 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 rg,..
1b150 20 49 6e 74 50 74 72 20 7a 4e 61 6d 65 2c 0d 0a IntPtr zName,..
1b160 20 20 20 20 20 20 20 20 20 20 20 20 72 65 66 20 ref
1b170 53 51 4c 69 74 65 43 61 6c 6c 62 61 63 6b 20 63 SQLiteCallback c
1b180 61 6c 6c 62 61 63 6b 2c 0d 0a 20 20 20 20 20 20 allback,..
1b190 20 20 20 20 20 20 72 65 66 20 49 6e 74 50 74 72 ref IntPtr
1b1a0 20 70 43 6c 69 65 6e 74 44 61 74 61 0d 0a 20 20 pClientData..
1b1b0 20 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a );....
1b1c0 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f ////////
1b1d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1b1e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1b1f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1b200 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
1b210 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
1b220 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
1b230 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 /// <para>..
1b240 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d /// This m
1b250 65 74 68 6f 64 20 70 72 6f 76 69 64 65 73 20 6e ethod provides n
1b260 6f 74 69 66 69 63 61 74 69 6f 6e 20 74 68 61 74 otification that
1b270 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 the virtual tab
1b280 6c 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 le.. ///
1b290 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 74 implementation t
1b2a0 68 61 74 20 74 68 65 20 76 69 72 74 75 61 6c 20 hat the virtual
1b2b0 74 61 62 6c 65 20 77 69 6c 6c 20 62 65 20 67 69 table will be gi
1b2c0 76 65 6e 20 61 20 6e 65 77 20 6e 61 6d 65 2e 20 ven a new name.
1b2d0 49 66 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 If.. ///
1b2e0 74 68 69 73 20 6d 65 74 68 6f 64 20 72 65 74 75 this method retu
1b2f0 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 20 74 68 rns SQLITE_OK th
1b300 65 6e 20 53 51 4c 69 74 65 20 72 65 6e 61 6d 65 en SQLite rename
1b310 73 20 74 68 65 20 74 61 62 6c 65 2e 20 49 66 0d s the table. If.
1b320 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 68 69 . /// thi
1b330 73 20 6d 65 74 68 6f 64 20 72 65 74 75 72 6e 73 s method returns
1b340 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 74 an error code t
1b350 68 65 6e 20 74 68 65 20 72 65 6e 61 6d 69 6e 67 hen the renaming
1b360 20 69 73 20 70 72 65 76 65 6e 74 65 64 2e 0d 0a is prevented...
1b370 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
1b380 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
1b390 20 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 <para>..
1b3a0 20 2f 2f 2f 20 54 68 65 20 78 52 65 6e 61 6d 65 /// The xRename
1b3b0 20 6d 65 74 68 6f 64 20 69 73 20 72 65 71 75 69 method is requi
1b3c0 72 65 64 20 66 6f 72 20 65 76 65 72 79 20 76 69 red for every vi
1b3d0 72 74 75 61 6c 20 74 61 62 6c 65 0d 0a 20 20 20 rtual table..
1b3e0 20 20 20 20 20 2f 2f 2f 20 69 6d 70 6c 65 6d 65 /// impleme
1b3f0 6e 74 61 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 ntation...
1b400 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
1b410 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
1b420 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
1b430 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
1b440 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 pVtab">..
1b450 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 /// The native
1b460 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 73 pointer to the s
1b470 71 6c 69 74 65 33 5f 76 74 61 62 20 64 65 72 69 qlite3_vtab deri
1b480 76 65 64 20 73 74 72 75 63 74 75 72 65 2e 0d 0a ved structure...
1b490 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
1b4a0 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
1b4b0 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 7a / <param name="z
1b4c0 4e 65 77 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f New">.. /
1b4d0 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 70 6f // The native po
1b4e0 69 6e 74 65 72 20 74 6f 20 74 68 65 20 55 54 46 inter to the UTF
1b4f0 2d 38 20 65 6e 63 6f 64 65 64 20 73 74 72 69 6e -8 encoded strin
1b500 67 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 g containing the
1b510 20 6e 65 77 0d 0a 20 20 20 20 20 20 20 20 2f 2f new.. //
1b520 2f 20 6e 61 6d 65 20 66 6f 72 20 74 68 65 20 76 / name for the v
1b530 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 irtual table...
1b540 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
1b550 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f am>.. ///
1b560 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 <returns>..
1b570 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 /// A standa
1b580 72 64 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e rd SQLite return
1b590 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 20 code...
1b5a0 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a /// </returns>..
1b5b0 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 45 72 SQLiteEr
1b5c0 72 6f 72 43 6f 64 65 20 78 52 65 6e 61 6d 65 28 rorCode xRename(
1b5d0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 6e .. In
1b5e0 74 50 74 72 20 70 56 74 61 62 2c 0d 0a 20 20 20 tPtr pVtab,..
1b5f0 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 IntPtr
1b600 7a 4e 65 77 0d 0a 20 20 20 20 20 20 20 20 20 20 zNew..
1b610 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 );....
1b620 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1b630 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1b640 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1b650 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1b660 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
1b670 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
1b680 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
1b690 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ara>.. //
1b6a0 2f 20 54 68 65 73 65 20 6d 65 74 68 6f 64 73 20 / These methods
1b6b0 70 72 6f 76 69 64 65 20 74 68 65 20 76 69 72 74 provide the virt
1b6c0 75 61 6c 20 74 61 62 6c 65 20 69 6d 70 6c 65 6d ual table implem
1b6d0 65 6e 74 61 74 69 6f 6e 20 61 6e 0d 0a 20 20 20 entation an..
1b6e0 20 20 20 20 20 2f 2f 2f 20 6f 70 70 6f 72 74 75 /// opportu
1b6f0 6e 69 74 79 20 74 6f 20 69 6d 70 6c 65 6d 65 6e nity to implemen
1b700 74 20 6e 65 73 74 65 64 20 74 72 61 6e 73 61 63 t nested transac
1b710 74 69 6f 6e 73 2e 20 54 68 65 79 20 61 72 65 20 tions. They are
1b720 61 6c 77 61 79 73 0d 0a 20 20 20 20 20 20 20 20 always..
1b730 2f 2f 2f 20 6f 70 74 69 6f 6e 61 6c 20 61 6e 64 /// optional and
1b740 20 77 69 6c 6c 20 6f 6e 6c 79 20 62 65 20 63 61 will only be ca
1b750 6c 6c 65 64 20 69 6e 20 53 51 4c 69 74 65 20 76 lled in SQLite v
1b760 65 72 73 69 6f 6e 20 33 2e 37 2e 37 20 61 6e 64 ersion 3.7.7 and
1b770 20 6c 61 74 65 72 2e 0d 0a 20 20 20 20 20 20 20 later...
1b780 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 /// </para>..
1b790 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e /// <para>
1b7a0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 57 68 .. /// Wh
1b7b0 65 6e 20 78 53 61 76 65 70 6f 69 6e 74 28 58 2c en xSavepoint(X,
1b7c0 4e 29 20 69 73 20 69 6e 76 6f 6b 65 64 2c 20 74 N) is invoked, t
1b7d0 68 61 74 20 69 73 20 61 20 73 69 67 6e 61 6c 20 hat is a signal
1b7e0 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c 0d 0a to the virtual..
1b7f0 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 61 62 6c /// tabl
1b800 65 20 58 20 74 68 61 74 20 69 74 20 73 68 6f 75 e X that it shou
1b810 6c 64 20 73 61 76 65 20 69 74 73 20 63 75 72 72 ld save its curr
1b820 65 6e 74 20 73 74 61 74 65 20 61 73 20 73 61 76 ent state as sav
1b830 65 70 6f 69 6e 74 20 4e 2e 20 41 0d 0a 20 20 20 epoint N. A..
1b840 20 20 20 20 20 2f 2f 2f 20 73 75 62 73 65 71 75 /// subsequ
1b850 65 6e 74 20 63 61 6c 6c 20 74 6f 20 78 52 6f 6c ent call to xRol
1b860 6c 62 61 63 6b 54 6f 28 58 2c 52 29 20 6d 65 61 lbackTo(X,R) mea
1b870 6e 73 20 74 68 61 74 20 74 68 65 20 73 74 61 74 ns that the stat
1b880 65 20 6f 66 20 74 68 65 0d 0a 20 20 20 20 20 20 e of the..
1b890 20 20 2f 2f 2f 20 76 69 72 74 75 61 6c 20 74 61 /// virtual ta
1b8a0 62 6c 65 20 73 68 6f 75 6c 64 20 72 65 74 75 72 ble should retur
1b8b0 6e 20 74 6f 20 77 68 61 74 20 69 74 20 77 61 73 n to what it was
1b8c0 20 77 68 65 6e 20 78 53 61 76 65 70 6f 69 6e 74 when xSavepoint
1b8d0 28 58 2c 52 29 20 77 61 73 0d 0a 20 20 20 20 20 (X,R) was..
1b8e0 20 20 20 2f 2f 2f 20 6c 61 73 74 20 63 61 6c 6c /// last call
1b8f0 65 64 2e 20 54 68 65 20 63 61 6c 6c 20 74 6f 20 ed. The call to
1b900 78 52 6f 6c 6c 62 61 63 6b 54 6f 28 58 2c 52 29 xRollbackTo(X,R)
1b910 20 77 69 6c 6c 20 69 6e 76 61 6c 69 64 61 74 65 will invalidate
1b920 20 61 6c 6c 0d 0a 20 20 20 20 20 20 20 20 2f 2f all.. //
1b930 2f 20 73 61 76 65 70 6f 69 6e 74 73 20 77 69 74 / savepoints wit
1b940 68 20 4e 3e 52 3b 20 6e 6f 6e 65 20 6f 66 20 74 h N>R; none of t
1b950 68 65 20 69 6e 76 61 6c 69 64 65 64 20 73 61 76 he invalided sav
1b960 65 70 6f 69 6e 74 73 20 77 69 6c 6c 20 62 65 0d epoints will be.
1b970 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 72 6f 6c . /// rol
1b980 6c 65 64 20 62 61 63 6b 20 6f 72 20 72 65 6c 65 led back or rele
1b990 61 73 65 64 20 77 69 74 68 6f 75 74 20 66 69 72 ased without fir
1b9a0 73 74 20 62 65 69 6e 67 20 72 65 69 6e 69 74 69 st being reiniti
1b9b0 61 6c 69 7a 65 64 20 62 79 20 61 20 63 61 6c 6c alized by a call
1b9c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 6f .. /// to
1b9d0 20 78 53 61 76 65 70 6f 69 6e 74 28 29 2e 20 41 xSavepoint(). A
1b9e0 20 63 61 6c 6c 20 74 6f 20 78 52 65 6c 65 61 73 call to xReleas
1b9f0 65 28 58 2c 4d 29 20 69 6e 76 61 6c 69 64 61 74 e(X,M) invalidat
1ba00 65 73 20 61 6c 6c 20 73 61 76 65 70 6f 69 6e 74 es all savepoint
1ba10 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 77 s.. /// w
1ba20 68 65 72 65 20 4e 3e 3d 4d 2e 0d 0a 20 20 20 20 here N>=M...
1ba30 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d /// </para>.
1ba40 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
1ba50 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ra>.. ///
1ba60 20 4e 6f 6e 65 20 6f 66 20 74 68 65 20 78 53 61 None of the xSa
1ba70 76 65 70 6f 69 6e 74 28 29 2c 20 78 52 65 6c 65 vepoint(), xRele
1ba80 61 73 65 28 29 2c 20 6f 72 20 78 52 6f 6c 6c 62 ase(), or xRollb
1ba90 61 63 6b 54 6f 28 29 20 6d 65 74 68 6f 64 73 20 ackTo() methods
1baa0 77 69 6c 6c 0d 0a 20 20 20 20 20 20 20 20 2f 2f will.. //
1bab0 2f 20 65 76 65 72 20 62 65 20 63 61 6c 6c 65 64 / ever be called
1bac0 20 65 78 63 65 70 74 20 69 6e 20 62 65 74 77 65 except in betwe
1bad0 65 6e 20 63 61 6c 6c 73 20 74 6f 20 78 42 65 67 en calls to xBeg
1bae0 69 6e 28 29 20 61 6e 64 20 65 69 74 68 65 72 0d in() and either.
1baf0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 78 43 6f . /// xCo
1bb00 6d 6d 69 74 28 29 20 6f 72 20 78 52 6f 6c 6c 62 mmit() or xRollb
1bb10 61 63 6b 28 29 2e 0d 0a 20 20 20 20 20 20 20 20 ack()...
1bb20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 /// </para>..
1bb30 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
1bb40 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
1bb50 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 56 <param name="pV
1bb60 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f tab">.. /
1bb70 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 70 6f // The native po
1bb80 69 6e 74 65 72 20 74 6f 20 74 68 65 20 73 71 6c inter to the sql
1bb90 69 74 65 33 5f 76 74 61 62 20 64 65 72 69 76 65 ite3_vtab derive
1bba0 64 20 73 74 72 75 63 74 75 72 65 2e 0d 0a 20 20 d structure...
1bbb0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
1bbc0 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
1bbd0 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 69 53 61 <param name="iSa
1bbe0 76 65 70 6f 69 6e 74 22 3e 0d 0a 20 20 20 20 20 vepoint">..
1bbf0 20 20 20 2f 2f 2f 20 54 68 69 73 20 69 73 20 61 /// This is a
1bc00 6e 20 69 6e 74 65 67 65 72 20 69 64 65 6e 74 69 n integer identi
1bc10 66 69 65 72 20 75 6e 64 65 72 20 77 68 69 63 68 fier under which
1bc20 20 74 68 65 20 74 68 65 20 63 75 72 72 65 6e 74 the the current
1bc30 20 73 74 61 74 65 20 6f 66 0d 0a 20 20 20 20 20 state of..
1bc40 20 20 20 2f 2f 2f 20 74 68 65 20 76 69 72 74 75 /// the virtu
1bc50 61 6c 20 74 61 62 6c 65 20 73 68 6f 75 6c 64 20 al table should
1bc60 62 65 20 73 61 76 65 64 2e 0d 0a 20 20 20 20 20 be saved...
1bc70 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
1bc80 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 . /// <re
1bc90 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
1bca0 2f 2f 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 /// A standard S
1bcb0 51 4c 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 QLite return cod
1bcc0 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
1bcd0 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 </returns>..
1bce0 20 20 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43 SQLiteErrorC
1bcf0 6f 64 65 20 78 53 61 76 65 70 6f 69 6e 74 28 0d ode xSavepoint(.
1bd00 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 . Int
1bd10 50 74 72 20 70 56 74 61 62 2c 0d 0a 20 20 20 20 Ptr pVtab,..
1bd20 20 20 20 20 20 20 20 20 69 6e 74 20 69 53 61 76 int iSav
1bd30 65 70 6f 69 6e 74 0d 0a 20 20 20 20 20 20 20 20 epoint..
1bd40 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 );....
1bd50 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////////
1bd60 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1bd70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1bd80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1bd90 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 /////////....
1bda0 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
1bdb0 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
1bdc0 3c 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 <para>..
1bdd0 2f 2f 2f 20 54 68 65 73 65 20 6d 65 74 68 6f 64 /// These method
1bde0 73 20 70 72 6f 76 69 64 65 20 74 68 65 20 76 69 s provide the vi
1bdf0 72 74 75 61 6c 20 74 61 62 6c 65 20 69 6d 70 6c rtual table impl
1be00 65 6d 65 6e 74 61 74 69 6f 6e 20 61 6e 0d 0a 20 ementation an..
1be10 20 20 20 20 20 20 20 2f 2f 2f 20 6f 70 70 6f 72 /// oppor
1be20 74 75 6e 69 74 79 20 74 6f 20 69 6d 70 6c 65 6d tunity to implem
1be30 65 6e 74 20 6e 65 73 74 65 64 20 74 72 61 6e 73 ent nested trans
1be40 61 63 74 69 6f 6e 73 2e 20 54 68 65 79 20 61 72 actions. They ar
1be50 65 20 61 6c 77 61 79 73 0d 0a 20 20 20 20 20 20 e always..
1be60 20 20 2f 2f 2f 20 6f 70 74 69 6f 6e 61 6c 20 61 /// optional a
1be70 6e 64 20 77 69 6c 6c 20 6f 6e 6c 79 20 62 65 20 nd will only be
1be80 63 61 6c 6c 65 64 20 69 6e 20 53 51 4c 69 74 65 called in SQLite
1be90 20 76 65 72 73 69 6f 6e 20 33 2e 37 2e 37 20 61 version 3.7.7 a
1bea0 6e 64 20 6c 61 74 65 72 2e 0d 0a 20 20 20 20 20 nd later...
1beb0 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a /// </para>..
1bec0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
1bed0 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 a>.. ///
1bee0 57 68 65 6e 20 78 53 61 76 65 70 6f 69 6e 74 28 When xSavepoint(
1bef0 58 2c 4e 29 20 69 73 20 69 6e 76 6f 6b 65 64 2c X,N) is invoked,
1bf00 20 74 68 61 74 20 69 73 20 61 20 73 69 67 6e 61 that is a signa
1bf10 6c 20 74 6f 20 74 68 65 20 76 69 72 74 75 61 6c l to the virtual
1bf20 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 61 .. /// ta
1bf30 62 6c 65 20 58 20 74 68 61 74 20 69 74 20 73 68 ble X that it sh
1bf40 6f 75 6c 64 20 73 61 76 65 20 69 74 73 20 63 75 ould save its cu
1bf50 72 72 65 6e 74 20 73 74 61 74 65 20 61 73 20 73 rrent state as s
1bf60 61 76 65 70 6f 69 6e 74 20 4e 2e 20 41 0d 0a 20 avepoint N. A..
1bf70 20 20 20 20 20 20 20 2f 2f 2f 20 73 75 62 73 65 /// subse
1bf80 71 75 65 6e 74 20 63 61 6c 6c 20 74 6f 20 78 52 quent call to xR
1bf90 6f 6c 6c 62 61 63 6b 54 6f 28 58 2c 52 29 20 6d ollbackTo(X,R) m
1bfa0 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 73 74 eans that the st
1bfb0 61 74 65 20 6f 66 20 74 68 65 0d 0a 20 20 20 20 ate of the..
1bfc0 20 20 20 20 2f 2f 2f 20 76 69 72 74 75 61 6c 20 /// virtual
1bfd0 74 61 62 6c 65 20 73 68 6f 75 6c 64 20 72 65 74 table should ret
1bfe0 75 72 6e 20 74 6f 20 77 68 61 74 20 69 74 20 77 urn to what it w
1bff0 61 73 20 77 68 65 6e 20 78 53 61 76 65 70 6f 69 as when xSavepoi
1c000 6e 74 28 58 2c 52 29 20 77 61 73 0d 0a 20 20 20 nt(X,R) was..
1c010 20 20 20 20 20 2f 2f 2f 20 6c 61 73 74 20 63 61 /// last ca
1c020 6c 6c 65 64 2e 20 54 68 65 20 63 61 6c 6c 20 74 lled. The call t
1c030 6f 20 78 52 6f 6c 6c 62 61 63 6b 54 6f 28 58 2c o xRollbackTo(X,
1c040 52 29 20 77 69 6c 6c 20 69 6e 76 61 6c 69 64 61 R) will invalida
1c050 74 65 20 61 6c 6c 0d 0a 20 20 20 20 20 20 20 20 te all..
1c060 2f 2f 2f 20 73 61 76 65 70 6f 69 6e 74 73 20 77 /// savepoints w
1c070 69 74 68 20 4e 3e 52 3b 20 6e 6f 6e 65 20 6f 66 ith N>R; none of
1c080 20 74 68 65 20 69 6e 76 61 6c 69 64 65 64 20 73 the invalided s
1c090 61 76 65 70 6f 69 6e 74 73 20 77 69 6c 6c 20 62 avepoints will b
1c0a0 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 72 e.. /// r
1c0b0 6f 6c 6c 65 64 20 62 61 63 6b 20 6f 72 20 72 65 olled back or re
1c0c0 6c 65 61 73 65 64 20 77 69 74 68 6f 75 74 20 66 leased without f
1c0d0 69 72 73 74 20 62 65 69 6e 67 20 72 65 69 6e 69 irst being reini
1c0e0 74 69 61 6c 69 7a 65 64 20 62 79 20 61 20 63 61 tialized by a ca
1c0f0 6c 6c 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ll.. ///
1c100 74 6f 20 78 53 61 76 65 70 6f 69 6e 74 28 29 2e to xSavepoint().
1c110 20 41 20 63 61 6c 6c 20 74 6f 20 78 52 65 6c 65 A call to xRele
1c120 61 73 65 28 58 2c 4d 29 20 69 6e 76 61 6c 69 64 ase(X,M) invalid
1c130 61 74 65 73 20 61 6c 6c 20 73 61 76 65 70 6f 69 ates all savepoi
1c140 6e 74 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f nts.. ///
1c150 20 77 68 65 72 65 20 4e 3e 3d 4d 2e 0d 0a 20 20 where N>=M...
1c160 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
1c170 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
1c180 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 20 2f para>.. /
1c190 2f 2f 20 4e 6f 6e 65 20 6f 66 20 74 68 65 20 78 // None of the x
1c1a0 53 61 76 65 70 6f 69 6e 74 28 29 2c 20 78 52 65 Savepoint(), xRe
1c1b0 6c 65 61 73 65 28 29 2c 20 6f 72 20 78 52 6f 6c lease(), or xRol
1c1c0 6c 62 61 63 6b 54 6f 28 29 20 6d 65 74 68 6f 64 lbackTo() method
1c1d0 73 20 77 69 6c 6c 0d 0a 20 20 20 20 20 20 20 20 s will..
1c1e0 2f 2f 2f 20 65 76 65 72 20 62 65 20 63 61 6c 6c /// ever be call
1c1f0 65 64 20 65 78 63 65 70 74 20 69 6e 20 62 65 74 ed except in bet
1c200 77 65 65 6e 20 63 61 6c 6c 73 20 74 6f 20 78 42 ween calls to xB
1c210 65 67 69 6e 28 29 20 61 6e 64 20 65 69 74 68 65 egin() and eithe
1c220 72 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 78 r.. /// x
1c230 43 6f 6d 6d 69 74 28 29 20 6f 72 20 78 52 6f 6c Commit() or xRol
1c240 6c 62 61 63 6b 28 29 2e 0d 0a 20 20 20 20 20 20 lback()...
1c250 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 /// </para>..
1c260 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
1c270 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
1c280 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
1c290 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 pVtab">..
1c2a0 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 /// The native
1c2b0 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 73 pointer to the s
1c2c0 71 6c 69 74 65 33 5f 76 74 61 62 20 64 65 72 69 qlite3_vtab deri
1c2d0 76 65 64 20 73 74 72 75 63 74 75 72 65 2e 0d 0a ved structure...
1c2e0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
1c2f0 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
1c300 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 69 / <param name="i
1c310 53 61 76 65 70 6f 69 6e 74 22 3e 0d 0a 20 20 20 Savepoint">..
1c320 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 69 73 /// This is
1c330 20 61 6e 20 69 6e 74 65 67 65 72 20 75 73 65 64 an integer used
1c340 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 to indicate tha
1c350 74 20 61 6e 79 20 73 61 76 65 64 20 73 74 61 74 t any saved stat
1c360 65 73 20 77 69 74 68 20 61 6e 0d 0a 20 20 20 20 es with an..
1c370 20 20 20 20 2f 2f 2f 20 69 64 65 6e 74 69 66 69 /// identifi
1c380 65 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 er greater than
1c390 6f 72 20 65 71 75 61 6c 20 74 6f 20 74 68 69 73 or equal to this
1c3a0 20 73 68 6f 75 6c 64 20 62 65 20 64 65 6c 65 74 should be delet
1c3b0 65 64 20 62 79 20 74 68 65 0d 0a 20 20 20 20 20 ed by the..
1c3c0 20 20 20 2f 2f 2f 20 76 69 72 74 75 61 6c 20 74 /// virtual t
1c3d0 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f able... /
1c3e0 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
1c3f0 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e /// <return
1c400 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s>.. ///
1c410 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 A standard SQLit
1c420 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a e return code...
1c430 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 /// </re
1c440 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
1c450 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 SQLiteErrorCode
1c460 78 52 65 6c 65 61 73 65 28 0d 0a 20 20 20 20 20 xRelease(..
1c470 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 56 IntPtr pV
1c480 74 61 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 tab,..
1c490 20 20 69 6e 74 20 69 53 61 76 65 70 6f 69 6e 74 int iSavepoint
1c4a0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 3b .. );
1c4b0 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
1c4c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1c4d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1c4e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1c4f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1c500 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ///.... /
1c510 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
1c520 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e /// <para>
1c530 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
1c540 65 73 65 20 6d 65 74 68 6f 64 73 20 70 72 6f 76 ese methods prov
1c550 69 64 65 20 74 68 65 20 76 69 72 74 75 61 6c 20 ide the virtual
1c560 74 61 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 table implementa
1c570 74 69 6f 6e 20 61 6e 0d 0a 20 20 20 20 20 20 20 tion an..
1c580 20 2f 2f 2f 20 6f 70 70 6f 72 74 75 6e 69 74 79 /// opportunity
1c590 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 6e 65 to implement ne
1c5a0 73 74 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e sted transaction
1c5b0 73 2e 20 54 68 65 79 20 61 72 65 20 61 6c 77 61 s. They are alwa
1c5c0 79 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ys.. ///
1c5d0 6f 70 74 69 6f 6e 61 6c 20 61 6e 64 20 77 69 6c optional and wil
1c5e0 6c 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 l only be called
1c5f0 20 69 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 in SQLite versi
1c600 6f 6e 20 33 2e 37 2e 37 20 61 6e 64 20 6c 61 74 on 3.7.7 and lat
1c610 65 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f er... ///
1c620 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 </para>..
1c630 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d 0a 20 20 /// <para>..
1c640 20 20 20 20 20 20 2f 2f 2f 20 57 68 65 6e 20 78 /// When x
1c650 53 61 76 65 70 6f 69 6e 74 28 58 2c 4e 29 20 69 Savepoint(X,N) i
1c660 73 20 69 6e 76 6f 6b 65 64 2c 20 74 68 61 74 20 s invoked, that
1c670 69 73 20 61 20 73 69 67 6e 61 6c 20 74 6f 20 74 is a signal to t
1c680 68 65 20 76 69 72 74 75 61 6c 0d 0a 20 20 20 20 he virtual..
1c690 20 20 20 20 2f 2f 2f 20 74 61 62 6c 65 20 58 20 /// table X
1c6a0 74 68 61 74 20 69 74 20 73 68 6f 75 6c 64 20 73 that it should s
1c6b0 61 76 65 20 69 74 73 20 63 75 72 72 65 6e 74 20 ave its current
1c6c0 73 74 61 74 65 20 61 73 20 73 61 76 65 70 6f 69 state as savepoi
1c6d0 6e 74 20 4e 2e 20 41 0d 0a 20 20 20 20 20 20 20 nt N. A..
1c6e0 20 2f 2f 2f 20 73 75 62 73 65 71 75 65 6e 74 20 /// subsequent
1c6f0 63 61 6c 6c 20 74 6f 20 78 52 6f 6c 6c 62 61 63 call to xRollbac
1c700 6b 54 6f 28 58 2c 52 29 20 6d 65 61 6e 73 20 74 kTo(X,R) means t
1c710 68 61 74 20 74 68 65 20 73 74 61 74 65 20 6f 66 hat the state of
1c720 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f the.. //
1c730 2f 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 / virtual table
1c740 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 74 6f should return to
1c750 20 77 68 61 74 20 69 74 20 77 61 73 20 77 68 65 what it was whe
1c760 6e 20 78 53 61 76 65 70 6f 69 6e 74 28 58 2c 52 n xSavepoint(X,R
1c770 29 20 77 61 73 0d 0a 20 20 20 20 20 20 20 20 2f ) was.. /
1c780 2f 2f 20 6c 61 73 74 20 63 61 6c 6c 65 64 2e 20 // last called.
1c790 54 68 65 20 63 61 6c 6c 20 74 6f 20 78 52 6f 6c The call to xRol
1c7a0 6c 62 61 63 6b 54 6f 28 58 2c 52 29 20 77 69 6c lbackTo(X,R) wil
1c7b0 6c 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6c 6c l invalidate all
1c7c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 61 .. /// sa
1c7d0 76 65 70 6f 69 6e 74 73 20 77 69 74 68 20 4e 3e vepoints with N>
1c7e0 52 3b 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20 69 R; none of the i
1c7f0 6e 76 61 6c 69 64 65 64 20 73 61 76 65 70 6f 69 nvalided savepoi
1c800 6e 74 73 20 77 69 6c 6c 20 62 65 0d 0a 20 20 20 nts will be..
1c810 20 20 20 20 20 2f 2f 2f 20 72 6f 6c 6c 65 64 20 /// rolled
1c820 62 61 63 6b 20 6f 72 20 72 65 6c 65 61 73 65 64 back or released
1c830 20 77 69 74 68 6f 75 74 20 66 69 72 73 74 20 62 without first b
1c840 65 69 6e 67 20 72 65 69 6e 69 74 69 61 6c 69 7a eing reinitializ
1c850 65 64 20 62 79 20 61 20 63 61 6c 6c 0d 0a 20 20 ed by a call..
1c860 20 20 20 20 20 20 2f 2f 2f 20 74 6f 20 78 53 61 /// to xSa
1c870 76 65 70 6f 69 6e 74 28 29 2e 20 41 20 63 61 6c vepoint(). A cal
1c880 6c 20 74 6f 20 78 52 65 6c 65 61 73 65 28 58 2c l to xRelease(X,
1c890 4d 29 20 69 6e 76 61 6c 69 64 61 74 65 73 20 61 M) invalidates a
1c8a0 6c 6c 20 73 61 76 65 70 6f 69 6e 74 73 0d 0a 20 ll savepoints..
1c8b0 20 20 20 20 20 20 20 2f 2f 2f 20 77 68 65 72 65 /// where
1c8c0 20 4e 3e 3d 4d 2e 0d 0a 20 20 20 20 20 20 20 20 N>=M...
1c8d0 2f 2f 2f 20 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 /// </para>..
1c8e0 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 3e 0d /// <para>.
1c8f0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 4e 6f 6e . /// Non
1c900 65 20 6f 66 20 74 68 65 20 78 53 61 76 65 70 6f e of the xSavepo
1c910 69 6e 74 28 29 2c 20 78 52 65 6c 65 61 73 65 28 int(), xRelease(
1c920 29 2c 20 6f 72 20 78 52 6f 6c 6c 62 61 63 6b 54 ), or xRollbackT
1c930 6f 28 29 20 6d 65 74 68 6f 64 73 20 77 69 6c 6c o() methods will
1c940 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 65 76 .. /// ev
1c950 65 72 20 62 65 20 63 61 6c 6c 65 64 20 65 78 63 er be called exc
1c960 65 70 74 20 69 6e 20 62 65 74 77 65 65 6e 20 63 ept in between c
1c970 61 6c 6c 73 20 74 6f 20 78 42 65 67 69 6e 28 29 alls to xBegin()
1c980 20 61 6e 64 20 65 69 74 68 65 72 0d 0a 20 20 20 and either..
1c990 20 20 20 20 20 2f 2f 2f 20 78 43 6f 6d 6d 69 74 /// xCommit
1c9a0 28 29 20 6f 72 20 78 52 6f 6c 6c 62 61 63 6b 28 () or xRollback(
1c9b0 29 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 )... ///
1c9c0 3c 2f 70 61 72 61 3e 0d 0a 20 20 20 20 20 20 20 </para>..
1c9d0 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
1c9e0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
1c9f0 72 61 6d 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 ram name="pVtab"
1ca00 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
1ca10 68 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 he native pointe
1ca20 72 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 r to the sqlite3
1ca30 5f 76 74 61 62 20 64 65 72 69 76 65 64 20 73 74 _vtab derived st
1ca40 72 75 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 ructure...
1ca50 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
1ca60 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
1ca70 61 6d 20 6e 61 6d 65 3d 22 69 53 61 76 65 70 6f am name="iSavepo
1ca80 69 6e 74 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f int">.. /
1ca90 2f 2f 20 54 68 69 73 20 69 73 20 61 6e 20 69 6e // This is an in
1caa0 74 65 67 65 72 20 69 64 65 6e 74 69 66 69 65 72 teger identifier
1cab0 20 75 73 65 64 20 74 6f 20 73 70 65 63 69 66 79 used to specify
1cac0 20 61 20 73 70 65 63 69 66 69 63 20 73 61 76 65 a specific save
1cad0 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 d.. /// s
1cae0 74 61 74 65 20 66 6f 72 20 74 68 65 20 76 69 72 tate for the vir
1caf0 74 75 61 6c 20 74 61 62 6c 65 20 66 6f 72 20 69 tual table for i
1cb00 74 20 74 6f 20 72 65 73 74 6f 72 65 20 69 74 73 t to restore its
1cb10 65 6c 66 20 62 61 63 6b 20 74 6f 2c 20 77 68 69 elf back to, whi
1cb20 63 68 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ch.. ///
1cb30 73 68 6f 75 6c 64 20 61 6c 73 6f 20 68 61 76 65 should also have
1cb40 20 74 68 65 20 65 66 66 65 63 74 20 6f 66 20 64 the effect of d
1cb50 65 6c 65 74 69 6e 67 20 61 6c 6c 20 73 61 76 65 eleting all save
1cb60 64 20 73 74 61 74 65 73 20 77 69 74 68 20 61 6e d states with an
1cb70 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6e .. /// in
1cb80 74 65 67 65 72 20 69 64 65 6e 74 69 66 69 65 72 teger identifier
1cb90 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 74 68 greater than th
1cba0 69 73 20 6f 6e 65 2e 0d 0a 20 20 20 20 20 20 20 is one...
1cbb0 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
1cbc0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 /// <retu
1cbd0 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f rns>.. //
1cbe0 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c / A standard SQL
1cbf0 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e ite return code.
1cc00 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
1cc10 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
1cc20 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 SQLiteErrorCod
1cc30 65 20 78 52 6f 6c 6c 62 61 63 6b 54 6f 28 0d 0a e xRollbackTo(..
1cc40 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 IntP
1cc50 74 72 20 70 56 74 61 62 2c 0d 0a 20 20 20 20 20 tr pVtab,..
1cc60 20 20 20 20 20 20 20 69 6e 74 20 69 53 61 76 65 int iSave
1cc70 70 6f 69 6e 74 0d 0a 20 20 20 20 20 20 20 20 20 point..
1cc80 20 20 20 29 3b 0d 0a 20 20 20 20 7d 0d 0a 20 20 );.. }..
1cc90 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a #endregion....
1cca0 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
1ccb0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ccc0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ccd0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1cce0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
1ccf0 0a 0d 0a 20 20 20 20 23 72 65 67 69 6f 6e 20 49 ... #region I
1cd00 53 51 4c 69 74 65 4d 61 6e 61 67 65 64 4d 6f 64 SQLiteManagedMod
1cd10 75 6c 65 20 49 6e 74 65 72 66 61 63 65 0d 0a 20 ule Interface..
1cd20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
1cd30 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 69 .. /// This i
1cd40 6e 74 65 72 66 61 63 65 20 72 65 70 72 65 73 65 nterface represe
1cd50 6e 74 73 20 61 20 76 69 72 74 75 61 6c 20 74 61 nts a virtual ta
1cd60 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 ble implementati
1cd70 6f 6e 20 77 72 69 74 74 65 6e 20 69 6e 0d 0a 20 on written in..
1cd80 20 20 20 2f 2f 2f 20 6d 61 6e 61 67 65 64 20 63 /// managed c
1cd90 6f 64 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f ode... /// </
1cda0 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 70 75 summary>.. pu
1cdb0 62 6c 69 63 20 69 6e 74 65 72 66 61 63 65 20 49 blic interface I
1cdc0 53 51 4c 69 74 65 4d 61 6e 61 67 65 64 4d 6f 64 SQLiteManagedMod
1cdd0 75 6c 65 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 ule.. {..
1cde0 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
1cdf0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 52 >.. /// R
1ce00 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 20 eturns non-zero
1ce10 69 66 20 74 68 65 20 73 63 68 65 6d 61 20 66 6f if the schema fo
1ce20 72 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 r the virtual ta
1ce30 62 6c 65 20 68 61 73 20 62 65 65 6e 0d 0a 20 20 ble has been..
1ce40 20 20 20 20 20 20 2f 2f 2f 20 64 65 63 6c 61 72 /// declar
1ce50 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ed... ///
1ce60 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
1ce70 20 20 20 20 20 62 6f 6f 6c 20 44 65 63 6c 61 72 bool Declar
1ce80 65 64 20 7b 20 67 65 74 3b 20 7d 0d 0a 0d 0a 20 ed { get; }....
1ce90 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
1cea0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ceb0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1cec0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1ced0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a //////////////..
1cee0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
1cef0 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
1cf00 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68 65 /// Returns the
1cf10 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 6d 6f 64 name of the mod
1cf20 75 6c 65 20 61 73 20 69 74 20 77 61 73 20 72 65 ule as it was re
1cf30 67 69 73 74 65 72 65 64 20 77 69 74 68 20 74 68 gistered with th
1cf40 65 20 53 51 4c 69 74 65 0d 0a 20 20 20 20 20 20 e SQLite..
1cf50 20 20 2f 2f 2f 20 63 6f 72 65 20 6c 69 62 72 61 /// core libra
1cf60 72 79 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry... ///
1cf70 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
1cf80 20 20 20 20 20 73 74 72 69 6e 67 20 4e 61 6d 65 string Name
1cf90 20 7b 20 67 65 74 3b 20 7d 0d 0a 0d 0a 20 20 20 { get; }....
1cfa0 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
1cfb0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1cfc0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1cfd0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1cfe0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
1cff0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
1d000 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
1d010 2f 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 20 69 // This method i
1d020 73 20 63 61 6c 6c 65 64 20 69 6e 20 72 65 73 70 s called in resp
1d030 6f 6e 73 65 20 74 6f 20 74 68 65 0d 0a 20 20 20 onse to the..
1d040 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 /// <see cr
1d050 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 ef="ISQLiteNativ
1d060 65 4d 6f 64 75 6c 65 2e 78 43 72 65 61 74 65 22 eModule.xCreate"
1d070 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 /> method...
1d080 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
1d090 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
1d0a0 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 63 6f <param name="co
1d0b0 6e 6e 65 63 74 69 6f 6e 22 3e 0d 0a 20 20 20 20 nnection">..
1d0c0 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 /// The <see
1d0d0 20 63 72 65 66 3d 22 53 51 4c 69 74 65 43 6f 6e cref="SQLiteCon
1d0e0 6e 65 63 74 69 6f 6e 22 20 2f 3e 20 6f 62 6a 65 nection" /> obje
1d0f0 63 74 20 69 6e 73 74 61 6e 63 65 20 61 73 73 6f ct instance asso
1d100 63 69 61 74 65 64 20 77 69 74 68 0d 0a 20 20 20 ciated with..
1d110 20 20 20 20 20 2f 2f 2f 20 74 68 65 20 76 69 72 /// the vir
1d120 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 20 20 tual table...
1d130 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
1d140 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
1d150 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 43 6c 69 param name="pCli
1d160 65 6e 74 44 61 74 61 22 3e 0d 0a 20 20 20 20 20 entData">..
1d170 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 /// The nativ
1d180 65 20 75 73 65 72 2d 64 61 74 61 20 70 6f 69 6e e user-data poin
1d190 74 65 72 20 61 73 73 6f 63 69 61 74 65 64 20 77 ter associated w
1d1a0 69 74 68 20 74 68 69 73 20 6d 6f 64 75 6c 65 2c ith this module,
1d1b0 20 61 73 20 69 74 20 77 61 73 0d 0a 20 20 20 20 as it was..
1d1c0 20 20 20 20 2f 2f 2f 20 70 72 6f 76 69 64 65 64 /// provided
1d1d0 20 74 6f 20 74 68 65 20 53 51 4c 69 74 65 20 63 to the SQLite c
1d1e0 6f 72 65 20 6c 69 62 72 61 72 79 20 77 68 65 6e ore library when
1d1f0 20 74 68 65 20 6e 61 74 69 76 65 20 6d 6f 64 75 the native modu
1d200 6c 65 20 69 6e 73 74 61 6e 63 65 0d 0a 20 20 20 le instance..
1d210 20 20 20 20 20 2f 2f 2f 20 77 61 73 20 63 72 65 /// was cre
1d220 61 74 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f ated... /
1d230 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
1d240 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
1d250 6e 61 6d 65 3d 22 61 72 67 75 6d 65 6e 74 73 22 name="arguments"
1d260 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
1d270 68 65 20 6d 6f 64 75 6c 65 20 6e 61 6d 65 2c 20 he module name,
1d280 64 61 74 61 62 61 73 65 20 6e 61 6d 65 2c 20 76 database name, v
1d290 69 72 74 75 61 6c 20 74 61 62 6c 65 20 6e 61 6d irtual table nam
1d2a0 65 2c 20 61 6e 64 20 61 6c 6c 20 6f 74 68 65 72 e, and all other
1d2b0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 72 .. /// ar
1d2c0 67 75 6d 65 6e 74 73 20 70 61 73 73 65 64 20 74 guments passed t
1d2d0 6f 20 74 68 65 20 43 52 45 41 54 45 20 56 49 52 o the CREATE VIR
1d2e0 54 55 41 4c 20 54 41 42 4c 45 20 73 74 61 74 65 TUAL TABLE state
1d2f0 6d 65 6e 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f ment... /
1d300 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
1d310 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
1d320 6e 61 6d 65 3d 22 74 61 62 6c 65 22 3e 0d 0a 20 name="table">..
1d330 20 20 20 20 20 20 20 2f 2f 2f 20 55 70 6f 6e 20 /// Upon
1d340 73 75 63 63 65 73 73 2c 20 74 68 69 73 20 70 61 success, this pa
1d350 72 61 6d 65 74 65 72 20 6d 75 73 74 20 62 65 20 rameter must be
1d360 6d 6f 64 69 66 69 65 64 20 74 6f 20 63 6f 6e 74 modified to cont
1d370 61 69 6e 20 74 68 65 0d 0a 20 20 20 20 20 20 20 ain the..
1d380 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 /// <see cref="
1d390 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 SQLiteVirtualTab
1d3a0 6c 65 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e le" /> object in
1d3b0 73 74 61 6e 63 65 20 61 73 73 6f 63 69 61 74 65 stance associate
1d3c0 64 20 77 69 74 68 0d 0a 20 20 20 20 20 20 20 20 d with..
1d3d0 2f 2f 2f 20 74 68 65 20 76 69 72 74 75 61 6c 20 /// the virtual
1d3e0 74 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 20 table...
1d3f0 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
1d400 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
1d410 20 6e 61 6d 65 3d 22 65 72 72 6f 72 22 3e 0d 0a name="error">..
1d420 20 20 20 20 20 20 20 20 2f 2f 2f 20 55 70 6f 6e /// Upon
1d430 20 66 61 69 6c 75 72 65 2c 20 74 68 69 73 20 70 failure, this p
1d440 61 72 61 6d 65 74 65 72 20 6d 75 73 74 20 62 65 arameter must be
1d450 20 6d 6f 64 69 66 69 65 64 20 74 6f 20 63 6f 6e modified to con
1d460 74 61 69 6e 20 61 6e 20 65 72 72 6f 72 0d 0a 20 tain an error..
1d470 20 20 20 20 20 20 20 2f 2f 2f 20 6d 65 73 73 61 /// messa
1d480 67 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ge... ///
1d490 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
1d4a0 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e /// <returns>
1d4b0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 20 .. /// A
1d4c0 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 65 20 standard SQLite
1d4d0 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a 20 20 return code...
1d4e0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 /// </retu
1d4f0 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 53 51 rns>.. SQ
1d500 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 43 72 LiteErrorCode Cr
1d510 65 61 74 65 28 0d 0a 20 20 20 20 20 20 20 20 20 eate(..
1d520 20 20 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 SQLiteConnect
1d530 69 6f 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 ion connection,
1d540 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 /* in */..
1d550 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 43 IntPtr pC
1d560 6c 69 65 6e 74 44 61 74 61 2c 20 20 20 20 20 20 lientData,
1d570 20 20 20 20 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 /* in */..
1d580 20 20 20 20 20 20 20 20 20 20 20 73 74 72 69 6e strin
1d590 67 5b 5d 20 61 72 67 75 6d 65 6e 74 73 2c 20 20 g[] arguments,
1d5a0 20 20 20 20 20 20 20 20 20 2f 2a 20 69 6e 20 2a /* in *
1d5b0 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 /.. r
1d5c0 65 66 20 53 51 4c 69 74 65 56 69 72 74 75 61 6c ef SQLiteVirtual
1d5d0 54 61 62 6c 65 20 74 61 62 6c 65 2c 20 2f 2a 20 Table table, /*
1d5e0 6f 75 74 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 out */..
1d5f0 20 20 20 20 72 65 66 20 73 74 72 69 6e 67 20 65 ref string e
1d600 72 72 6f 72 20 20 20 20 20 20 20 20 20 20 20 20 rror
1d610 20 20 2f 2a 20 6f 75 74 20 2a 2f 0d 0a 20 20 20 /* out */..
1d620 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 );....
1d630 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
1d640 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1d650 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1d660 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1d670 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a //////////////..
1d680 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
1d690 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
1d6a0 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 /// This method
1d6b0 20 69 73 20 63 61 6c 6c 65 64 20 69 6e 20 72 65 is called in re
1d6c0 73 70 6f 6e 73 65 20 74 6f 20 74 68 65 0d 0a 20 sponse to the..
1d6d0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 /// <see
1d6e0 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
1d6f0 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6e 6e 65 iveModule.xConne
1d700 63 74 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a ct" /> method...
1d710 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
1d720 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
1d730 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
1d740 22 63 6f 6e 6e 65 63 74 69 6f 6e 22 3e 0d 0a 20 "connection">..
1d750 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c /// The <
1d760 73 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65 see cref="SQLite
1d770 43 6f 6e 6e 65 63 74 69 6f 6e 22 20 2f 3e 20 6f Connection" /> o
1d780 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 61 bject instance a
1d790 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 0d 0a ssociated with..
1d7a0 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 68 65 20 /// the
1d7b0 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a virtual table...
1d7c0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
1d7d0 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
1d7e0 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 / <param name="p
1d7f0 43 6c 69 65 6e 74 44 61 74 61 22 3e 0d 0a 20 20 ClientData">..
1d800 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 /// The na
1d810 74 69 76 65 20 75 73 65 72 2d 64 61 74 61 20 70 tive user-data p
1d820 6f 69 6e 74 65 72 20 61 73 73 6f 63 69 61 74 65 ointer associate
1d830 64 20 77 69 74 68 20 74 68 69 73 20 6d 6f 64 75 d with this modu
1d840 6c 65 2c 20 61 73 20 69 74 20 77 61 73 0d 0a 20 le, as it was..
1d850 20 20 20 20 20 20 20 2f 2f 2f 20 70 72 6f 76 69 /// provi
1d860 64 65 64 20 74 6f 20 74 68 65 20 53 51 4c 69 74 ded to the SQLit
1d870 65 20 63 6f 72 65 20 6c 69 62 72 61 72 79 20 77 e core library w
1d880 68 65 6e 20 74 68 65 20 6e 61 74 69 76 65 20 6d hen the native m
1d890 6f 64 75 6c 65 20 69 6e 73 74 61 6e 63 65 0d 0a odule instance..
1d8a0 20 20 20 20 20 20 20 20 2f 2f 2f 20 77 61 73 20 /// was
1d8b0 63 72 65 61 74 65 64 2e 0d 0a 20 20 20 20 20 20 created...
1d8c0 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
1d8d0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
1d8e0 61 6d 20 6e 61 6d 65 3d 22 61 72 67 75 6d 65 6e am name="argumen
1d8f0 74 73 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ts">.. //
1d900 2f 20 54 68 65 20 6d 6f 64 75 6c 65 20 6e 61 6d / The module nam
1d910 65 2c 20 64 61 74 61 62 61 73 65 20 6e 61 6d 65 e, database name
1d920 2c 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 , virtual table
1d930 6e 61 6d 65 2c 20 61 6e 64 20 61 6c 6c 20 6f 74 name, and all ot
1d940 68 65 72 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f her.. ///
1d950 20 61 72 67 75 6d 65 6e 74 73 20 70 61 73 73 65 arguments passe
1d960 64 20 74 6f 20 74 68 65 20 43 52 45 41 54 45 20 d to the CREATE
1d970 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20 73 74 VIRTUAL TABLE st
1d980 61 74 65 6d 65 6e 74 2e 0d 0a 20 20 20 20 20 20 atement...
1d990 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
1d9a0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
1d9b0 61 6d 20 6e 61 6d 65 3d 22 74 61 62 6c 65 22 3e am name="table">
1d9c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 55 70 .. /// Up
1d9d0 6f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 69 73 on success, this
1d9e0 20 70 61 72 61 6d 65 74 65 72 20 6d 75 73 74 20 parameter must
1d9f0 62 65 20 6d 6f 64 69 66 69 65 64 20 74 6f 20 63 be modified to c
1da00 6f 6e 74 61 69 6e 20 74 68 65 0d 0a 20 20 20 20 ontain the..
1da10 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 /// <see cre
1da20 66 3d 22 53 51 4c 69 74 65 56 69 72 74 75 61 6c f="SQLiteVirtual
1da30 54 61 62 6c 65 22 20 2f 3e 20 6f 62 6a 65 63 74 Table" /> object
1da40 20 69 6e 73 74 61 6e 63 65 20 61 73 73 6f 63 69 instance associ
1da50 61 74 65 64 20 77 69 74 68 0d 0a 20 20 20 20 20 ated with..
1da60 20 20 20 2f 2f 2f 20 74 68 65 20 76 69 72 74 75 /// the virtu
1da70 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 20 20 20 20 al table...
1da80 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
1da90 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
1daa0 72 61 6d 20 6e 61 6d 65 3d 22 65 72 72 6f 72 22 ram name="error"
1dab0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 55 >.. /// U
1dac0 70 6f 6e 20 66 61 69 6c 75 72 65 2c 20 74 68 69 pon failure, thi
1dad0 73 20 70 61 72 61 6d 65 74 65 72 20 6d 75 73 74 s parameter must
1dae0 20 62 65 20 6d 6f 64 69 66 69 65 64 20 74 6f 20 be modified to
1daf0 63 6f 6e 74 61 69 6e 20 61 6e 20 65 72 72 6f 72 contain an error
1db00 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6d 65 .. /// me
1db10 73 73 61 67 65 2e 0d 0a 20 20 20 20 20 20 20 20 ssage...
1db20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
1db30 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 /// <retur
1db40 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ns>.. ///
1db50 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 A standard SQLi
1db60 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d te return code..
1db70 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 . /// </r
1db80 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 eturns>..
1db90 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 SQLiteErrorCode
1dba0 20 43 6f 6e 6e 65 63 74 28 0d 0a 20 20 20 20 20 Connect(..
1dbb0 20 20 20 20 20 20 20 53 51 4c 69 74 65 43 6f 6e SQLiteCon
1dbc0 6e 65 63 74 69 6f 6e 20 63 6f 6e 6e 65 63 74 69 nection connecti
1dbd0 6f 6e 2c 20 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 on, /* in */..
1dbe0 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 IntPt
1dbf0 72 20 70 43 6c 69 65 6e 74 44 61 74 61 2c 20 20 r pClientData,
1dc00 20 20 20 20 20 20 20 20 20 2f 2a 20 69 6e 20 2a /* in *
1dc10 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 /.. s
1dc20 74 72 69 6e 67 5b 5d 20 61 72 67 75 6d 65 6e 74 tring[] argument
1dc30 73 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 s, /*
1dc40 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 20 in */..
1dc50 20 20 20 72 65 66 20 53 51 4c 69 74 65 56 69 72 ref SQLiteVir
1dc60 74 75 61 6c 54 61 62 6c 65 20 74 61 62 6c 65 2c tualTable table,
1dc70 20 2f 2a 20 6f 75 74 20 2a 2f 0d 0a 20 20 20 20 /* out */..
1dc80 20 20 20 20 20 20 20 20 72 65 66 20 73 74 72 69 ref stri
1dc90 6e 67 20 65 72 72 6f 72 20 20 20 20 20 20 20 20 ng error
1dca0 20 20 20 20 20 20 2f 2a 20 6f 75 74 20 2a 2f 0d /* out */.
1dcb0 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 3b 0d . );.
1dcc0 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
1dcd0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1dce0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1dcf0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1dd00 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1dd10 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f //.... //
1dd20 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
1dd30 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 /// This me
1dd40 74 68 6f 64 20 69 73 20 63 61 6c 6c 65 64 20 69 thod is called i
1dd50 6e 20 72 65 73 70 6f 6e 73 65 20 74 6f 20 74 68 n response to th
1dd60 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c e.. /// <
1dd70 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 see cref="ISQLit
1dd80 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 42 eNativeModule.xB
1dd90 65 73 74 49 6e 64 65 78 22 20 2f 3e 20 6d 65 74 estIndex" /> met
1dda0 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f hod... //
1ddb0 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 / </summary>..
1ddc0 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
1ddd0 20 6e 61 6d 65 3d 22 74 61 62 6c 65 22 3e 0d 0a name="table">..
1dde0 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
1ddf0 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 <see cref="SQLit
1de00 65 56 69 72 74 75 61 6c 54 61 62 6c 65 22 20 2f eVirtualTable" /
1de10 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 > object instanc
1de20 65 20 61 73 73 6f 63 69 61 74 65 64 0d 0a 20 20 e associated..
1de30 20 20 20 20 20 20 2f 2f 2f 20 77 69 74 68 20 74 /// with t
1de40 68 69 73 20 76 69 72 74 75 61 6c 20 74 61 62 6c his virtual tabl
1de50 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
1de60 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
1de70 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
1de80 65 3d 22 69 6e 64 65 78 22 3e 0d 0a 20 20 20 20 e="index">..
1de90 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 /// The <see
1dea0 20 63 72 65 66 3d 22 53 51 4c 69 74 65 49 6e 64 cref="SQLiteInd
1deb0 65 78 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e ex" /> object in
1dec0 73 74 61 6e 63 65 20 63 6f 6e 74 61 69 6e 69 6e stance containin
1ded0 67 20 61 6c 6c 20 74 68 65 0d 0a 20 20 20 20 20 g all the..
1dee0 20 20 20 2f 2f 2f 20 64 61 74 61 20 66 6f 72 20 /// data for
1def0 74 68 65 20 69 6e 70 75 74 73 20 61 6e 64 20 6f the inputs and o
1df00 75 74 70 75 74 73 20 72 65 6c 61 74 69 6e 67 20 utputs relating
1df10 74 6f 20 69 6e 64 65 78 20 73 65 6c 65 63 74 69 to index selecti
1df20 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f on... ///
1df30 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
1df40 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e /// <returns>
1df50 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 20 .. /// A
1df60 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 65 20 standard SQLite
1df70 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a 20 20 return code...
1df80 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 /// </retu
1df90 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 53 51 rns>.. SQ
1dfa0 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 42 65 LiteErrorCode Be
1dfb0 73 74 49 6e 64 65 78 28 0d 0a 20 20 20 20 20 20 stIndex(..
1dfc0 20 20 20 20 20 20 53 51 4c 69 74 65 56 69 72 74 SQLiteVirt
1dfd0 75 61 6c 54 61 62 6c 65 20 74 61 62 6c 65 2c 20 ualTable table,
1dfe0 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 20 /* in */..
1dff0 20 20 20 20 20 20 53 51 4c 69 74 65 49 6e 64 65 SQLiteInde
1e000 78 20 69 6e 64 65 78 20 20 20 20 20 20 20 20 20 x index
1e010 2f 2a 20 69 6e 2c 20 6f 75 74 20 2a 2f 0d 0a 20 /* in, out */..
1e020 20 20 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d );...
1e030 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
1e040 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e050 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e060 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e070 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e080 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 .... ///
1e090 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
1e0a0 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 /// This meth
1e0b0 6f 64 20 69 73 20 63 61 6c 6c 65 64 20 69 6e 20 od is called in
1e0c0 72 65 73 70 6f 6e 73 65 20 74 6f 20 74 68 65 0d response to the.
1e0d0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 . /// <se
1e0e0 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e e cref="ISQLiteN
1e0f0 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 44 69 73 ativeModule.xDis
1e100 63 6f 6e 6e 65 63 74 22 20 2f 3e 20 6d 65 74 68 connect" /> meth
1e110 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f od... ///
1e120 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
1e130 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
1e140 6e 61 6d 65 3d 22 74 61 62 6c 65 22 3e 0d 0a 20 name="table">..
1e150 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c /// The <
1e160 73 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65 see cref="SQLite
1e170 56 69 72 74 75 61 6c 54 61 62 6c 65 22 20 2f 3e VirtualTable" />
1e180 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 object instance
1e190 20 61 73 73 6f 63 69 61 74 65 64 0d 0a 20 20 20 associated..
1e1a0 20 20 20 20 20 2f 2f 2f 20 77 69 74 68 20 74 68 /// with th
1e1b0 69 73 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 is virtual table
1e1c0 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
1e1d0 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 /param>..
1e1e0 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a /// <returns>..
1e1f0 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 20 73 74 /// A st
1e200 61 6e 64 61 72 64 20 53 51 4c 69 74 65 20 72 65 andard SQLite re
1e210 74 75 72 6e 20 63 6f 64 65 2e 0d 0a 20 20 20 20 turn code...
1e220 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e /// </return
1e230 73 3e 0d 0a 20 20 20 20 20 20 20 20 53 51 4c 69 s>.. SQLi
1e240 74 65 45 72 72 6f 72 43 6f 64 65 20 44 69 73 63 teErrorCode Disc
1e250 6f 6e 6e 65 63 74 28 0d 0a 20 20 20 20 20 20 20 onnect(..
1e260 20 20 20 20 20 53 51 4c 69 74 65 56 69 72 74 75 SQLiteVirtu
1e270 61 6c 54 61 62 6c 65 20 74 61 62 6c 65 20 2f 2a alTable table /*
1e280 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 in */..
1e290 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 );....
1e2a0 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////////
1e2b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e2c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e2d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e2e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 /////////....
1e2f0 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
1e300 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
1e310 54 68 69 73 20 6d 65 74 68 6f 64 20 69 73 20 63 This method is c
1e320 61 6c 6c 65 64 20 69 6e 20 72 65 73 70 6f 6e 73 alled in respons
1e330 65 20 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 20 e to the..
1e340 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d /// <see cref=
1e350 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f "ISQLiteNativeMo
1e360 64 75 6c 65 2e 78 44 65 73 74 72 6f 79 22 20 2f dule.xDestroy" /
1e370 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
1e380 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
1e390 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
1e3a0 70 61 72 61 6d 20 6e 61 6d 65 3d 22 74 61 62 6c param name="tabl
1e3b0 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f e">.. ///
1e3c0 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 The <see cref="
1e3d0 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 SQLiteVirtualTab
1e3e0 6c 65 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e le" /> object in
1e3f0 73 74 61 6e 63 65 20 61 73 73 6f 63 69 61 74 65 stance associate
1e400 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 77 d.. /// w
1e410 69 74 68 20 74 68 69 73 20 76 69 72 74 75 61 6c ith this virtual
1e420 20 74 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 table...
1e430 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
1e440 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 /// <retu
1e450 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f rns>.. //
1e460 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c / A standard SQL
1e470 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e ite return code.
1e480 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
1e490 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
1e4a0 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 SQLiteErrorCod
1e4b0 65 20 44 65 73 74 72 6f 79 28 0d 0a 20 20 20 20 e Destroy(..
1e4c0 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 56 69 SQLiteVi
1e4d0 72 74 75 61 6c 54 61 62 6c 65 20 74 61 62 6c 65 rtualTable table
1e4e0 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 /* in */..
1e4f0 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 );....
1e500 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
1e510 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e520 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e530 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e540 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
1e550 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
1e560 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
1e570 2f 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 20 69 // This method i
1e580 73 20 63 61 6c 6c 65 64 20 69 6e 20 72 65 73 70 s called in resp
1e590 6f 6e 73 65 20 74 6f 20 74 68 65 0d 0a 20 20 20 onse to the..
1e5a0 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 /// <see cr
1e5b0 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 ef="ISQLiteNativ
1e5c0 65 4d 6f 64 75 6c 65 2e 78 4f 70 65 6e 22 20 2f eModule.xOpen" /
1e5d0 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
1e5e0 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
1e5f0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
1e600 70 61 72 61 6d 20 6e 61 6d 65 3d 22 74 61 62 6c param name="tabl
1e610 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f e">.. ///
1e620 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 The <see cref="
1e630 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 SQLiteVirtualTab
1e640 6c 65 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e le" /> object in
1e650 73 74 61 6e 63 65 20 61 73 73 6f 63 69 61 74 65 stance associate
1e660 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 77 d.. /// w
1e670 69 74 68 20 74 68 69 73 20 76 69 72 74 75 61 6c ith this virtual
1e680 20 74 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 table...
1e690 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
1e6a0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
1e6b0 6d 20 6e 61 6d 65 3d 22 63 75 72 73 6f 72 22 3e m name="cursor">
1e6c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 55 70 .. /// Up
1e6d0 6f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 69 73 on success, this
1e6e0 20 70 61 72 61 6d 65 74 65 72 20 6d 75 73 74 20 parameter must
1e6f0 62 65 20 6d 6f 64 69 66 69 65 64 20 74 6f 20 63 be modified to c
1e700 6f 6e 74 61 69 6e 20 74 68 65 0d 0a 20 20 20 20 ontain the..
1e710 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 /// <see cre
1e720 66 3d 22 53 51 4c 69 74 65 56 69 72 74 75 61 6c f="SQLiteVirtual
1e730 54 61 62 6c 65 43 75 72 73 6f 72 22 20 2f 3e 20 TableCursor" />
1e740 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 object instance
1e750 61 73 73 6f 63 69 61 74 65 64 0d 0a 20 20 20 20 associated..
1e760 20 20 20 20 2f 2f 2f 20 77 69 74 68 20 74 68 65 /// with the
1e770 20 6e 65 77 6c 79 20 6f 70 65 6e 65 64 20 76 69 newly opened vi
1e780 72 74 75 61 6c 20 74 61 62 6c 65 20 63 75 72 73 rtual table curs
1e790 6f 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f or... ///
1e7a0 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
1e7b0 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e /// <returns>
1e7c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 20 .. /// A
1e7d0 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 65 20 standard SQLite
1e7e0 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a 20 20 return code...
1e7f0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 /// </retu
1e800 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 53 51 rns>.. SQ
1e810 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 4f 70 LiteErrorCode Op
1e820 65 6e 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 en(..
1e830 20 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 SQLiteVirtualTa
1e840 62 6c 65 20 74 61 62 6c 65 2c 20 20 20 20 20 20 ble table,
1e850 20 20 20 20 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 /* in */..
1e860 20 20 20 20 20 20 20 20 20 20 20 72 65 66 20 53 ref S
1e870 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c QLiteVirtualTabl
1e880 65 43 75 72 73 6f 72 20 63 75 72 73 6f 72 20 2f eCursor cursor /
1e890 2a 20 6f 75 74 20 2a 2f 0d 0a 20 20 20 20 20 20 * out */..
1e8a0 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 );....
1e8b0 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
1e8c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e8d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e8e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1e8f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
1e900 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
1e910 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
1e920 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 20 69 73 / This method is
1e930 20 63 61 6c 6c 65 64 20 69 6e 20 72 65 73 70 6f called in respo
1e940 6e 73 65 20 74 6f 20 74 68 65 0d 0a 20 20 20 20 nse to the..
1e950 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 /// <see cre
1e960 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 f="ISQLiteNative
1e970 4d 6f 64 75 6c 65 2e 78 43 6c 6f 73 65 22 20 2f Module.xClose" /
1e980 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
1e990 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
1e9a0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
1e9b0 70 61 72 61 6d 20 6e 61 6d 65 3d 22 63 75 72 73 param name="curs
1e9c0 6f 72 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f or">.. //
1e9d0 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d / The <see cref=
1e9e0 22 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 "SQLiteVirtualTa
1e9f0 62 6c 65 43 75 72 73 6f 72 22 20 2f 3e 20 6f 62 bleCursor" /> ob
1ea00 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 0d 0a 20 ject instance..
1ea10 20 20 20 20 20 20 20 2f 2f 2f 20 61 73 73 6f 63 /// assoc
1ea20 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 70 iated with the p
1ea30 72 65 76 69 6f 75 73 6c 79 20 6f 70 65 6e 65 64 reviously opened
1ea40 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 63 virtual table c
1ea50 75 72 73 6f 72 20 74 6f 20 62 65 0d 0a 20 20 20 ursor to be..
1ea60 20 20 20 20 20 2f 2f 2f 20 75 73 65 64 2e 0d 0a /// used...
1ea70 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
1ea80 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
1ea90 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 / <returns>..
1eaa0 20 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 /// A stand
1eab0 61 72 64 20 53 51 4c 69 74 65 20 72 65 74 75 72 ard SQLite retur
1eac0 6e 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 n code...
1ead0 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d /// </returns>.
1eae0 0a 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 45 . SQLiteE
1eaf0 72 72 6f 72 43 6f 64 65 20 43 6c 6f 73 65 28 0d rrorCode Close(.
1eb00 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c . SQL
1eb10 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c 65 43 iteVirtualTableC
1eb20 75 72 73 6f 72 20 63 75 72 73 6f 72 20 2f 2a 20 ursor cursor /*
1eb30 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 20 in */..
1eb40 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 );....
1eb50 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
1eb60 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1eb70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1eb80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1eb90 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 ////////....
1eba0 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
1ebb0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
1ebc0 68 69 73 20 6d 65 74 68 6f 64 20 69 73 20 63 61 his method is ca
1ebd0 6c 6c 65 64 20 69 6e 20 72 65 73 70 6f 6e 73 65 lled in response
1ebe0 20 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 20 20 to the..
1ebf0 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 /// <see cref="
1ec00 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 ISQLiteNativeMod
1ec10 75 6c 65 2e 78 46 69 6c 74 65 72 22 20 2f 3e 20 ule.xFilter" />
1ec20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 method...
1ec30 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
1ec40 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
1ec50 72 61 6d 20 6e 61 6d 65 3d 22 63 75 72 73 6f 72 ram name="cursor
1ec60 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
1ec70 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 53 The <see cref="S
1ec80 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c QLiteVirtualTabl
1ec90 65 43 75 72 73 6f 72 22 20 2f 3e 20 6f 62 6a 65 eCursor" /> obje
1eca0 63 74 20 69 6e 73 74 61 6e 63 65 0d 0a 20 20 20 ct instance..
1ecb0 20 20 20 20 20 2f 2f 2f 20 61 73 73 6f 63 69 61 /// associa
1ecc0 74 65 64 20 77 69 74 68 20 74 68 65 20 70 72 65 ted with the pre
1ecd0 76 69 6f 75 73 6c 79 20 6f 70 65 6e 65 64 20 76 viously opened v
1ece0 69 72 74 75 61 6c 20 74 61 62 6c 65 20 63 75 72 irtual table cur
1ecf0 73 6f 72 20 74 6f 20 62 65 0d 0a 20 20 20 20 20 sor to be..
1ed00 20 20 20 2f 2f 2f 20 75 73 65 64 2e 0d 0a 20 20 /// used...
1ed10 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
1ed20 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
1ed30 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 69 6e 64 <param name="ind
1ed40 65 78 4e 75 6d 62 65 72 22 3e 0d 0a 20 20 20 20 exNumber">..
1ed50 20 20 20 20 2f 2f 2f 20 4e 75 6d 62 65 72 20 75 /// Number u
1ed60 73 65 64 20 74 6f 20 68 65 6c 70 20 69 64 65 6e sed to help iden
1ed70 74 69 66 79 20 74 68 65 20 73 65 6c 65 63 74 65 tify the selecte
1ed80 64 20 69 6e 64 65 78 2e 0d 0a 20 20 20 20 20 20 d index...
1ed90 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
1eda0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
1edb0 61 6d 20 6e 61 6d 65 3d 22 69 6e 64 65 78 53 74 am name="indexSt
1edc0 72 69 6e 67 22 3e 0d 0a 20 20 20 20 20 20 20 20 ring">..
1edd0 2f 2f 2f 20 53 74 72 69 6e 67 20 75 73 65 64 20 /// String used
1ede0 74 6f 20 68 65 6c 70 20 69 64 65 6e 74 69 66 79 to help identify
1edf0 20 74 68 65 20 73 65 6c 65 63 74 65 64 20 69 6e the selected in
1ee00 64 65 78 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f dex... //
1ee10 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
1ee20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
1ee30 61 6d 65 3d 22 76 61 6c 75 65 73 22 3e 0d 0a 20 ame="values">..
1ee40 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 76 /// The v
1ee50 61 6c 75 65 73 20 63 6f 72 72 65 73 70 6f 6e 64 alues correspond
1ee60 69 6e 67 20 74 6f 20 65 61 63 68 20 63 6f 6c 75 ing to each colu
1ee70 6d 6e 20 69 6e 20 74 68 65 20 73 65 6c 65 63 74 mn in the select
1ee80 65 64 20 69 6e 64 65 78 2e 0d 0a 20 20 20 20 20 ed index...
1ee90 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
1eea0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 . /// <re
1eeb0 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
1eec0 2f 2f 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 /// A standard S
1eed0 51 4c 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 QLite return cod
1eee0 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
1eef0 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 </returns>..
1ef00 20 20 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43 SQLiteErrorC
1ef10 6f 64 65 20 46 69 6c 74 65 72 28 0d 0a 20 20 20 ode Filter(..
1ef20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 56 SQLiteV
1ef30 69 72 74 75 61 6c 54 61 62 6c 65 43 75 72 73 6f irtualTableCurso
1ef40 72 20 63 75 72 73 6f 72 2c 20 2f 2a 20 69 6e 20 r cursor, /* in
1ef50 2a 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 */..
1ef60 69 6e 74 20 69 6e 64 65 78 4e 75 6d 62 65 72 2c int indexNumber,
1ef70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ef80 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 /* in */..
1ef90 20 20 20 20 20 20 20 73 74 72 69 6e 67 20 69 6e string in
1efa0 64 65 78 53 74 72 69 6e 67 2c 20 20 20 20 20 20 dexString,
1efb0 20 20 20 20 20 20 20 20 2f 2a 20 69 6e 20 2a 2f /* in */
1efc0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 51 .. SQ
1efd0 4c 69 74 65 56 61 6c 75 65 5b 5d 20 76 61 6c 75 LiteValue[] valu
1efe0 65 73 20 20 20 20 20 20 20 20 20 20 20 20 20 2f es /
1eff0 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 * in */..
1f000 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 );....
1f010 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
1f020 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f030 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f040 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f050 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
1f060 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
1f070 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
1f080 20 54 68 69 73 20 6d 65 74 68 6f 64 20 69 73 20 This method is
1f090 63 61 6c 6c 65 64 20 69 6e 20 72 65 73 70 6f 6e called in respon
1f0a0 73 65 20 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 se to the..
1f0b0 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 /// <see cref
1f0c0 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d ="ISQLiteNativeM
1f0d0 6f 64 75 6c 65 2e 78 4e 65 78 74 22 20 2f 3e 20 odule.xNext" />
1f0e0 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 method...
1f0f0 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
1f100 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
1f110 72 61 6d 20 6e 61 6d 65 3d 22 63 75 72 73 6f 72 ram name="cursor
1f120 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
1f130 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 53 The <see cref="S
1f140 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c QLiteVirtualTabl
1f150 65 43 75 72 73 6f 72 22 20 2f 3e 20 6f 62 6a 65 eCursor" /> obje
1f160 63 74 20 69 6e 73 74 61 6e 63 65 0d 0a 20 20 20 ct instance..
1f170 20 20 20 20 20 2f 2f 2f 20 61 73 73 6f 63 69 61 /// associa
1f180 74 65 64 20 77 69 74 68 20 74 68 65 20 70 72 65 ted with the pre
1f190 76 69 6f 75 73 6c 79 20 6f 70 65 6e 65 64 20 76 viously opened v
1f1a0 69 72 74 75 61 6c 20 74 61 62 6c 65 20 63 75 72 irtual table cur
1f1b0 73 6f 72 20 74 6f 20 62 65 0d 0a 20 20 20 20 20 sor to be..
1f1c0 20 20 20 2f 2f 2f 20 75 73 65 64 2e 0d 0a 20 20 /// used...
1f1d0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
1f1e0 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
1f1f0 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 <returns>..
1f200 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 72 /// A standar
1f210 64 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e 20 d SQLite return
1f220 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f code... /
1f230 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 // </returns>..
1f240 20 20 20 20 20 20 20 53 51 4c 69 74 65 45 72 72 SQLiteErr
1f250 6f 72 43 6f 64 65 20 4e 65 78 74 28 0d 0a 20 20 orCode Next(..
1f260 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 SQLite
1f270 56 69 72 74 75 61 6c 54 61 62 6c 65 43 75 72 73 VirtualTableCurs
1f280 6f 72 20 63 75 72 73 6f 72 20 2f 2a 20 69 6e 20 or cursor /* in
1f290 2a 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 */..
1f2a0 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f );.... //
1f2b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f2c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f2d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f2e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f2f0 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
1f300 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
1f310 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 /// This
1f320 20 6d 65 74 68 6f 64 20 69 73 20 63 61 6c 6c 65 method is calle
1f330 64 20 69 6e 20 72 65 73 70 6f 6e 73 65 20 74 6f d in response to
1f340 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f the.. //
1f350 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 / <see cref="ISQ
1f360 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
1f370 2e 78 45 6f 66 22 20 2f 3e 20 6d 65 74 68 6f 64 .xEof" /> method
1f380 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
1f390 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
1f3a0 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
1f3b0 6d 65 3d 22 63 75 72 73 6f 72 22 3e 0d 0a 20 20 me="cursor">..
1f3c0 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 /// The <s
1f3d0 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65 56 ee cref="SQLiteV
1f3e0 69 72 74 75 61 6c 54 61 62 6c 65 43 75 72 73 6f irtualTableCurso
1f3f0 72 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 r" /> object ins
1f400 74 61 6e 63 65 0d 0a 20 20 20 20 20 20 20 20 2f tance.. /
1f410 2f 2f 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 // associated wi
1f420 74 68 20 74 68 65 20 70 72 65 76 69 6f 75 73 6c th the previousl
1f430 79 20 6f 70 65 6e 65 64 20 76 69 72 74 75 61 6c y opened virtual
1f440 20 74 61 62 6c 65 20 63 75 72 73 6f 72 20 74 6f table cursor to
1f450 20 62 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f be.. ///
1f460 20 75 73 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 used...
1f470 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
1f480 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 /// <retur
1f490 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ns>.. ///
1f4a0 20 4e 6f 6e 2d 7a 65 72 6f 20 69 66 20 6e 6f 20 Non-zero if no
1f4b0 6d 6f 72 65 20 72 6f 77 73 20 61 72 65 20 61 76 more rows are av
1f4c0 61 69 6c 61 62 6c 65 3b 20 7a 65 72 6f 20 6f 74 ailable; zero ot
1f4d0 68 65 72 77 69 73 65 2e 0d 0a 20 20 20 20 20 20 herwise...
1f4e0 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e /// </returns>
1f4f0 0d 0a 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 45 .. bool E
1f500 6f 66 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 of(..
1f510 20 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 SQLiteVirtualTa
1f520 62 6c 65 43 75 72 73 6f 72 20 63 75 72 73 6f 72 bleCursor cursor
1f530 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 /* in */..
1f540 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 );....
1f550 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
1f560 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f570 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f580 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f590 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
1f5a0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
1f5b0 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
1f5c0 2f 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 20 69 // This method i
1f5d0 73 20 63 61 6c 6c 65 64 20 69 6e 20 72 65 73 70 s called in resp
1f5e0 6f 6e 73 65 20 74 6f 20 74 68 65 0d 0a 20 20 20 onse to the..
1f5f0 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 /// <see cr
1f600 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 ef="ISQLiteNativ
1f610 65 4d 6f 64 75 6c 65 2e 78 43 6f 6c 75 6d 6e 22 eModule.xColumn"
1f620 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 /> method...
1f630 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
1f640 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
1f650 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 63 75 <param name="cu
1f660 72 73 6f 72 22 3e 0d 0a 20 20 20 20 20 20 20 20 rsor">..
1f670 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 /// The <see cre
1f680 66 3d 22 53 51 4c 69 74 65 56 69 72 74 75 61 6c f="SQLiteVirtual
1f690 54 61 62 6c 65 43 75 72 73 6f 72 22 20 2f 3e 20 TableCursor" />
1f6a0 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 0d object instance.
1f6b0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 73 73 . /// ass
1f6c0 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 ociated with the
1f6d0 20 70 72 65 76 69 6f 75 73 6c 79 20 6f 70 65 6e previously open
1f6e0 65 64 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 ed virtual table
1f6f0 20 63 75 72 73 6f 72 20 74 6f 20 62 65 0d 0a 20 cursor to be..
1f700 20 20 20 20 20 20 20 2f 2f 2f 20 75 73 65 64 2e /// used.
1f710 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
1f720 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
1f730 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
1f740 22 63 6f 6e 74 65 78 74 22 3e 0d 0a 20 20 20 20 "context">..
1f750 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 /// The <see
1f760 20 63 72 65 66 3d 22 53 51 4c 69 74 65 43 6f 6e cref="SQLiteCon
1f770 74 65 78 74 22 20 2f 3e 20 6f 62 6a 65 63 74 20 text" /> object
1f780 69 6e 73 74 61 6e 63 65 20 74 6f 20 62 65 20 75 instance to be u
1f790 73 65 64 20 66 6f 72 0d 0a 20 20 20 20 20 20 20 sed for..
1f7a0 20 2f 2f 2f 20 72 65 74 75 72 6e 69 6e 67 20 74 /// returning t
1f7b0 68 65 20 73 70 65 63 69 66 69 65 64 20 63 6f 6c he specified col
1f7c0 75 6d 6e 20 76 61 6c 75 65 20 74 6f 20 74 68 65 umn value to the
1f7d0 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6c 69 62 SQLite core lib
1f7e0 72 61 72 79 2e 0d 0a 20 20 20 20 20 20 20 20 2f rary... /
1f7f0 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
1f800 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
1f810 6e 61 6d 65 3d 22 69 6e 64 65 78 22 3e 0d 0a 20 name="index">..
1f820 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 7a /// The z
1f830 65 72 6f 2d 62 61 73 65 64 20 69 6e 64 65 78 20 ero-based index
1f840 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f corresponding to
1f850 20 74 68 65 20 63 6f 6c 75 6d 6e 20 63 6f 6e 74 the column cont
1f860 61 69 6e 69 6e 67 20 74 68 65 0d 0a 20 20 20 20 aining the..
1f870 20 20 20 20 2f 2f 2f 20 76 61 6c 75 65 20 74 6f /// value to
1f880 20 62 65 20 72 65 74 75 72 6e 65 64 2e 0d 0a 20 be returned...
1f890 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
1f8a0 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f am>.. ///
1f8b0 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 <returns>..
1f8c0 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 /// A standa
1f8d0 72 64 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e rd SQLite return
1f8e0 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 20 code...
1f8f0 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a /// </returns>..
1f900 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 45 72 SQLiteEr
1f910 72 6f 72 43 6f 64 65 20 43 6f 6c 75 6d 6e 28 0d rorCode Column(.
1f920 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c . SQL
1f930 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c 65 43 iteVirtualTableC
1f940 75 72 73 6f 72 20 63 75 72 73 6f 72 2c 20 2f 2a ursor cursor, /*
1f950 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 in */..
1f960 20 20 20 20 53 51 4c 69 74 65 43 6f 6e 74 65 78 SQLiteContex
1f970 74 20 63 6f 6e 74 65 78 74 2c 20 20 20 20 20 20 t context,
1f980 20 20 20 20 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 /* in */..
1f990 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 int i
1f9a0 6e 64 65 78 20 20 20 20 20 20 20 20 20 20 20 20 ndex
1f9b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 /* i
1f9c0 6e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 n */..
1f9d0 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 );....
1f9e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1f9f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1fa00 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1fa10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1fa20 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
1fa30 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
1fa40 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
1fa50 69 73 20 6d 65 74 68 6f 64 20 69 73 20 63 61 6c is method is cal
1fa60 6c 65 64 20 69 6e 20 72 65 73 70 6f 6e 73 65 20 led in response
1fa70 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 to the..
1fa80 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 49 /// <see cref="I
1fa90 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 SQLiteNativeModu
1faa0 6c 65 2e 78 52 6f 77 49 64 22 20 2f 3e 20 6d 65 le.xRowId" /> me
1fab0 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f thod... /
1fac0 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
1fad0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
1fae0 6d 20 6e 61 6d 65 3d 22 63 75 72 73 6f 72 22 3e m name="cursor">
1faf0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
1fb00 65 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c e <see cref="SQL
1fb10 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c 65 43 iteVirtualTableC
1fb20 75 72 73 6f 72 22 20 2f 3e 20 6f 62 6a 65 63 74 ursor" /> object
1fb30 20 69 6e 73 74 61 6e 63 65 0d 0a 20 20 20 20 20 instance..
1fb40 20 20 20 2f 2f 2f 20 61 73 73 6f 63 69 61 74 65 /// associate
1fb50 64 20 77 69 74 68 20 74 68 65 20 70 72 65 76 69 d with the previ
1fb60 6f 75 73 6c 79 20 6f 70 65 6e 65 64 20 76 69 72 ously opened vir
1fb70 74 75 61 6c 20 74 61 62 6c 65 20 63 75 72 73 6f tual table curso
1fb80 72 20 74 6f 20 62 65 0d 0a 20 20 20 20 20 20 20 r to be..
1fb90 20 2f 2f 2f 20 75 73 65 64 2e 0d 0a 20 20 20 20 /// used...
1fba0 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
1fbb0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
1fbc0 61 72 61 6d 20 6e 61 6d 65 3d 22 72 6f 77 49 64 aram name="rowId
1fbd0 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
1fbe0 55 70 6f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 Upon success, th
1fbf0 69 73 20 70 61 72 61 6d 65 74 65 72 20 6d 75 73 is parameter mus
1fc00 74 20 62 65 20 6d 6f 64 69 66 69 65 64 20 74 6f t be modified to
1fc10 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 75 6e 69 contain the uni
1fc20 71 75 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f que.. ///
1fc30 20 69 6e 74 65 67 65 72 20 72 6f 77 20 69 64 65 integer row ide
1fc40 6e 74 69 66 69 65 72 20 66 6f 72 20 74 68 65 20 ntifier for the
1fc50 63 75 72 72 65 6e 74 20 72 6f 77 20 66 6f 72 20 current row for
1fc60 74 68 65 20 73 70 65 63 69 66 69 65 64 20 63 75 the specified cu
1fc70 72 73 6f 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f rsor... /
1fc80 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
1fc90 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e /// <return
1fca0 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s>.. ///
1fcb0 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 A standard SQLit
1fcc0 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a e return code...
1fcd0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 /// </re
1fce0 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
1fcf0 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 SQLiteErrorCode
1fd00 52 6f 77 49 64 28 0d 0a 20 20 20 20 20 20 20 20 RowId(..
1fd10 20 20 20 20 53 51 4c 69 74 65 56 69 72 74 75 61 SQLiteVirtua
1fd20 6c 54 61 62 6c 65 43 75 72 73 6f 72 20 63 75 72 lTableCursor cur
1fd30 73 6f 72 2c 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 sor, /* in */..
1fd40 20 20 20 20 20 20 20 20 20 20 20 72 65 66 20 6c ref l
1fd50 6f 6e 67 20 72 6f 77 49 64 20 20 20 20 20 20 20 ong rowId
1fd60 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 6f /* o
1fd70 75 74 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 20 ut */..
1fd80 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 );....
1fd90 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
1fda0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1fdb0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1fdc0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1fdd0 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 ////////....
1fde0 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
1fdf0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
1fe00 68 69 73 20 6d 65 74 68 6f 64 20 69 73 20 63 61 his method is ca
1fe10 6c 6c 65 64 20 69 6e 20 72 65 73 70 6f 6e 73 65 lled in response
1fe20 20 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 20 20 to the..
1fe30 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 /// <see cref="
1fe40 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 ISQLiteNativeMod
1fe50 75 6c 65 2e 78 55 70 64 61 74 65 22 20 2f 3e 20 ule.xUpdate" />
1fe60 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 method...
1fe70 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
1fe80 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
1fe90 72 61 6d 20 6e 61 6d 65 3d 22 74 61 62 6c 65 22 ram name="table"
1fea0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
1feb0 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 he <see cref="SQ
1fec0 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c 65 LiteVirtualTable
1fed0 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 " /> object inst
1fee0 61 6e 63 65 20 61 73 73 6f 63 69 61 74 65 64 0d ance associated.
1fef0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 77 69 74 . /// wit
1ff00 68 20 74 68 69 73 20 76 69 72 74 75 61 6c 20 74 h this virtual t
1ff10 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f able... /
1ff20 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
1ff30 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
1ff40 6e 61 6d 65 3d 22 76 61 6c 75 65 73 22 3e 0d 0a name="values">..
1ff50 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
1ff60 61 72 72 61 79 20 6f 66 20 3c 73 65 65 20 63 72 array of <see cr
1ff70 65 66 3d 22 53 51 4c 69 74 65 56 61 6c 75 65 22 ef="SQLiteValue"
1ff80 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 /> object insta
1ff90 6e 63 65 73 20 63 6f 6e 74 61 69 6e 69 6e 67 0d nces containing.
1ffa0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 74 68 65 . /// the
1ffb0 20 6e 65 77 20 6f 72 20 6d 6f 64 69 66 69 65 64 new or modified
1ffc0 20 63 6f 6c 75 6d 6e 20 76 61 6c 75 65 73 2c 20 column values,
1ffd0 69 66 20 61 6e 79 2e 0d 0a 20 20 20 20 20 20 20 if any...
1ffe0 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
1fff0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
20000 6d 20 6e 61 6d 65 3d 22 72 6f 77 49 64 22 3e 0d m name="rowId">.
20010 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 55 70 6f . /// Upo
20020 6e 20 73 75 63 63 65 73 73 2c 20 74 68 69 73 20 n success, this
20030 70 61 72 61 6d 65 74 65 72 20 6d 75 73 74 20 62 parameter must b
20040 65 20 6d 6f 64 69 66 69 65 64 20 74 6f 20 63 6f e modified to co
20050 6e 74 61 69 6e 20 74 68 65 20 75 6e 69 71 75 65 ntain the unique
20060 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6e .. /// in
20070 74 65 67 65 72 20 72 6f 77 20 69 64 65 6e 74 69 teger row identi
20080 66 69 65 72 20 66 6f 72 20 74 68 65 20 72 6f 77 fier for the row
20090 20 74 68 61 74 20 77 61 73 20 69 6e 73 65 72 74 that was insert
200a0 65 64 2c 20 69 66 20 61 6e 79 2e 0d 0a 20 20 20 ed, if any...
200b0 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
200c0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
200d0 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
200e0 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 72 64 /// A standard
200f0 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e 20 63 SQLite return c
20100 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ode... //
20110 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 / </returns>..
20120 20 20 20 20 20 20 53 51 4c 69 74 65 45 72 72 6f SQLiteErro
20130 72 43 6f 64 65 20 55 70 64 61 74 65 28 0d 0a 20 rCode Update(..
20140 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 SQLit
20150 65 56 69 72 74 75 61 6c 54 61 62 6c 65 20 74 61 eVirtualTable ta
20160 62 6c 65 2c 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 ble, /* in */..
20170 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 SQLit
20180 65 56 61 6c 75 65 5b 5d 20 76 61 6c 75 65 73 2c eValue[] values,
20190 20 20 20 20 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 /* in */..
201a0 20 20 20 20 20 20 20 20 20 20 20 72 65 66 20 6c ref l
201b0 6f 6e 67 20 72 6f 77 49 64 20 20 20 20 20 20 20 ong rowId
201c0 20 20 20 20 20 2f 2a 20 6f 75 74 20 2a 2f 0d 0a /* out */..
201d0 20 20 20 20 20 20 20 20 20 20 20 20 29 3b 0d 0a );..
201e0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
201f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20200 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20210 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20220 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20230 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f /.... ///
20240 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
20250 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 /// This met
20260 68 6f 64 20 69 73 20 63 61 6c 6c 65 64 20 69 6e hod is called in
20270 20 72 65 73 70 6f 6e 73 65 20 74 6f 20 74 68 65 response to the
20280 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
20290 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
202a0 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 42 65 NativeModule.xBe
202b0 67 69 6e 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d gin" /> method..
202c0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
202d0 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
202e0 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
202f0 3d 22 74 61 62 6c 65 22 3e 0d 0a 20 20 20 20 20 ="table">..
20300 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 /// The <see
20310 63 72 65 66 3d 22 53 51 4c 69 74 65 56 69 72 74 cref="SQLiteVirt
20320 75 61 6c 54 61 62 6c 65 22 20 2f 3e 20 6f 62 6a ualTable" /> obj
20330 65 63 74 20 69 6e 73 74 61 6e 63 65 20 61 73 73 ect instance ass
20340 6f 63 69 61 74 65 64 0d 0a 20 20 20 20 20 20 20 ociated..
20350 20 2f 2f 2f 20 77 69 74 68 20 74 68 69 73 20 76 /// with this v
20360 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 irtual table...
20370 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
20380 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f am>.. ///
20390 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 <returns>..
203a0 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 /// A standa
203b0 72 64 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e rd SQLite return
203c0 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 20 code...
203d0 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a /// </returns>..
203e0 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 45 72 SQLiteEr
203f0 72 6f 72 43 6f 64 65 20 42 65 67 69 6e 28 0d 0a rorCode Begin(..
20400 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 SQLi
20410 74 65 56 69 72 74 75 61 6c 54 61 62 6c 65 20 74 teVirtualTable t
20420 61 62 6c 65 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 able /* in */..
20430 20 20 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d );...
20440 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
20450 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20460 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20470 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20480 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20490 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 .... ///
204a0 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
204b0 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 /// This meth
204c0 6f 64 20 69 73 20 63 61 6c 6c 65 64 20 69 6e 20 od is called in
204d0 72 65 73 70 6f 6e 73 65 20 74 6f 20 74 68 65 0d response to the.
204e0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 . /// <se
204f0 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e e cref="ISQLiteN
20500 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 53 79 6e ativeModule.xSyn
20510 63 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 c" /> method...
20520 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
20530 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
20540 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
20550 74 61 62 6c 65 22 3e 0d 0a 20 20 20 20 20 20 20 table">..
20560 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 72 /// The <see cr
20570 65 66 3d 22 53 51 4c 69 74 65 56 69 72 74 75 61 ef="SQLiteVirtua
20580 6c 54 61 62 6c 65 22 20 2f 3e 20 6f 62 6a 65 63 lTable" /> objec
20590 74 20 69 6e 73 74 61 6e 63 65 20 61 73 73 6f 63 t instance assoc
205a0 69 61 74 65 64 0d 0a 20 20 20 20 20 20 20 20 2f iated.. /
205b0 2f 2f 20 77 69 74 68 20 74 68 69 73 20 76 69 72 // with this vir
205c0 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 20 20 tual table...
205d0 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
205e0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
205f0 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
20600 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 72 64 /// A standard
20610 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e 20 63 SQLite return c
20620 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ode... //
20630 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 / </returns>..
20640 20 20 20 20 20 20 53 51 4c 69 74 65 45 72 72 6f SQLiteErro
20650 72 43 6f 64 65 20 53 79 6e 63 28 0d 0a 20 20 20 rCode Sync(..
20660 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 56 SQLiteV
20670 69 72 74 75 61 6c 54 61 62 6c 65 20 74 61 62 6c irtualTable tabl
20680 65 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 e /* in */..
20690 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 );....
206a0 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////
206b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
206c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
206d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
206e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d /////////////...
206f0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 . /// <su
20700 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
20710 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 20 /// This method
20720 69 73 20 63 61 6c 6c 65 64 20 69 6e 20 72 65 73 is called in res
20730 70 6f 6e 73 65 20 74 6f 20 74 68 65 0d 0a 20 20 ponse to the..
20740 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 /// <see c
20750 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
20760 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6d 6d 69 74 veModule.xCommit
20770 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
20780 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d /// </summ
20790 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
207a0 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 74 / <param name="t
207b0 61 62 6c 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 able">..
207c0 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 /// The <see cre
207d0 66 3d 22 53 51 4c 69 74 65 56 69 72 74 75 61 6c f="SQLiteVirtual
207e0 54 61 62 6c 65 22 20 2f 3e 20 6f 62 6a 65 63 74 Table" /> object
207f0 20 69 6e 73 74 61 6e 63 65 20 61 73 73 6f 63 69 instance associ
20800 61 74 65 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f ated.. //
20810 2f 20 77 69 74 68 20 74 68 69 73 20 76 69 72 74 / with this virt
20820 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 20 20 20 ual table...
20830 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
20840 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 .. /// <r
20850 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 eturns>..
20860 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 72 64 20 /// A standard
20870 53 51 4c 69 74 65 20 72 65 74 75 72 6e 20 63 6f SQLite return co
20880 64 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f de... ///
20890 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 </returns>..
208a0 20 20 20 20 20 53 51 4c 69 74 65 45 72 72 6f 72 SQLiteError
208b0 43 6f 64 65 20 43 6f 6d 6d 69 74 28 0d 0a 20 20 Code Commit(..
208c0 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 SQLite
208d0 56 69 72 74 75 61 6c 54 61 62 6c 65 20 74 61 62 VirtualTable tab
208e0 6c 65 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 le /* in */..
208f0 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 );....
20900 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
20910 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20920 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20930 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20940 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a //////////////..
20950 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
20960 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
20970 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 /// This method
20980 20 69 73 20 63 61 6c 6c 65 64 20 69 6e 20 72 65 is called in re
20990 73 70 6f 6e 73 65 20 74 6f 20 74 68 65 0d 0a 20 sponse to the..
209a0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 /// <see
209b0 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
209c0 69 76 65 4d 6f 64 75 6c 65 2e 78 52 6f 6c 6c 62 iveModule.xRollb
209d0 61 63 6b 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d ack" /> method..
209e0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
209f0 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
20a00 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
20a10 3d 22 74 61 62 6c 65 22 3e 0d 0a 20 20 20 20 20 ="table">..
20a20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 /// The <see
20a30 63 72 65 66 3d 22 53 51 4c 69 74 65 56 69 72 74 cref="SQLiteVirt
20a40 75 61 6c 54 61 62 6c 65 22 20 2f 3e 20 6f 62 6a ualTable" /> obj
20a50 65 63 74 20 69 6e 73 74 61 6e 63 65 20 61 73 73 ect instance ass
20a60 6f 63 69 61 74 65 64 0d 0a 20 20 20 20 20 20 20 ociated..
20a70 20 2f 2f 2f 20 77 69 74 68 20 74 68 69 73 20 76 /// with this v
20a80 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 irtual table...
20a90 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
20aa0 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f am>.. ///
20ab0 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 <returns>..
20ac0 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 /// A standa
20ad0 72 64 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e rd SQLite return
20ae0 20 63 6f 64 65 2e 0d 0a 20 20 20 20 20 20 20 20 code...
20af0 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a /// </returns>..
20b00 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 45 72 SQLiteEr
20b10 72 6f 72 43 6f 64 65 20 52 6f 6c 6c 62 61 63 6b rorCode Rollback
20b20 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 (.. S
20b30 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c QLiteVirtualTabl
20b40 65 20 74 61 62 6c 65 20 2f 2a 20 69 6e 20 2a 2f e table /* in */
20b50 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 3b .. );
20b60 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
20b70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20b80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20b90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20ba0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
20bb0 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ///.... /
20bc0 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
20bd0 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d /// This m
20be0 65 74 68 6f 64 20 69 73 20 63 61 6c 6c 65 64 20 ethod is called
20bf0 69 6e 20 72 65 73 70 6f 6e 73 65 20 74 6f 20 74 in response to t
20c00 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 he.. ///
20c10 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 <see cref="ISQLi
20c20 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 teNativeModule.x
20c30 46 69 6e 64 46 75 6e 63 74 69 6f 6e 22 20 2f 3e FindFunction" />
20c40 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 method...
20c50 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
20c60 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
20c70 61 72 61 6d 20 6e 61 6d 65 3d 22 74 61 62 6c 65 aram name="table
20c80 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
20c90 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 53 The <see cref="S
20ca0 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c QLiteVirtualTabl
20cb0 65 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 e" /> object ins
20cc0 74 61 6e 63 65 20 61 73 73 6f 63 69 61 74 65 64 tance associated
20cd0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 77 69 .. /// wi
20ce0 74 68 20 74 68 69 73 20 76 69 72 74 75 61 6c 20 th this virtual
20cf0 74 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 20 table...
20d00 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
20d10 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
20d20 20 6e 61 6d 65 3d 22 61 72 67 75 6d 65 6e 74 43 name="argumentC
20d30 6f 75 6e 74 22 3e 0d 0a 20 20 20 20 20 20 20 20 ount">..
20d40 2f 2f 2f 20 54 68 65 20 6e 75 6d 62 65 72 20 6f /// The number o
20d50 66 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 74 f arguments to t
20d60 68 65 20 66 75 6e 63 74 69 6f 6e 20 62 65 69 6e he function bein
20d70 67 20 73 6f 75 67 68 74 2e 0d 0a 20 20 20 20 20 g sought...
20d80 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
20d90 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
20da0 72 61 6d 20 6e 61 6d 65 3d 22 6e 61 6d 65 22 3e ram name="name">
20db0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
20dc0 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 75 e name of the fu
20dd0 6e 63 74 69 6f 6e 20 62 65 69 6e 67 20 73 6f 75 nction being sou
20de0 67 68 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ght... //
20df0 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
20e00 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
20e10 61 6d 65 3d 22 66 75 6e 63 74 69 6f 6e 22 3e 0d ame="function">.
20e20 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 55 70 6f . /// Upo
20e30 6e 20 73 75 63 63 65 73 73 2c 20 74 68 69 73 20 n success, this
20e40 70 61 72 61 6d 65 74 65 72 20 6d 75 73 74 20 62 parameter must b
20e50 65 20 6d 6f 64 69 66 69 65 64 20 74 6f 20 63 6f e modified to co
20e60 6e 74 61 69 6e 20 74 68 65 0d 0a 20 20 20 20 20 ntain the..
20e70 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 /// <see cref
20e80 3d 22 53 51 4c 69 74 65 46 75 6e 63 74 69 6f 6e ="SQLiteFunction
20e90 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 " /> object inst
20ea0 61 6e 63 65 20 72 65 73 70 6f 6e 73 69 62 6c 65 ance responsible
20eb0 20 66 6f 72 0d 0a 20 20 20 20 20 20 20 20 2f 2f for.. //
20ec0 2f 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 74 / implementing t
20ed0 68 65 20 73 70 65 63 69 66 69 65 64 20 66 75 6e he specified fun
20ee0 63 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 ction...
20ef0 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
20f00 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
20f10 20 6e 61 6d 65 3d 22 70 43 6c 69 65 6e 74 44 61 name="pClientDa
20f20 74 61 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ta">.. //
20f30 2f 20 55 70 6f 6e 20 73 75 63 63 65 73 73 2c 20 / Upon success,
20f40 74 68 69 73 20 70 61 72 61 6d 65 74 65 72 20 6d this parameter m
20f50 75 73 74 20 62 65 20 6d 6f 64 69 66 69 65 64 20 ust be modified
20f60 74 6f 20 63 6f 6e 74 61 69 6e 20 74 68 65 0d 0a to contain the..
20f70 20 20 20 20 20 20 20 20 2f 2f 2f 20 6e 61 74 69 /// nati
20f80 76 65 20 75 73 65 72 2d 64 61 74 61 20 70 6f 69 ve user-data poi
20f90 6e 74 65 72 20 61 73 73 6f 63 69 61 74 65 64 20 nter associated
20fa0 77 69 74 68 0d 0a 20 20 20 20 20 20 20 20 2f 2f with.. //
20fb0 2f 20 3c 70 61 72 61 6d 72 65 66 20 6e 61 6d 65 / <paramref name
20fc0 3d 22 66 75 6e 63 74 69 6f 6e 22 20 2f 3e 2e 0d ="function" />..
20fd0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
20fe0 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f aram>.. /
20ff0 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 // <returns>..
21000 20 20 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 /// Non-ze
21010 72 6f 20 69 66 20 74 68 65 20 73 70 65 63 69 66 ro if the specif
21020 69 65 64 20 66 75 6e 63 74 69 6f 6e 20 77 61 73 ied function was
21030 20 66 6f 75 6e 64 3b 20 7a 65 72 6f 20 6f 74 68 found; zero oth
21040 65 72 77 69 73 65 2e 0d 0a 20 20 20 20 20 20 20 erwise...
21050 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d /// </returns>.
21060 0a 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 46 69 . bool Fi
21070 6e 64 46 75 6e 63 74 69 6f 6e 28 0d 0a 20 20 20 ndFunction(..
21080 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 56 SQLiteV
21090 69 72 74 75 61 6c 54 61 62 6c 65 20 74 61 62 6c irtualTable tabl
210a0 65 2c 20 20 20 20 2f 2a 20 69 6e 20 2a 2f 0d 0a e, /* in */..
210b0 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 int
210c0 61 72 67 75 6d 65 6e 74 43 6f 75 6e 74 2c 20 20 argumentCount,
210d0 20 20 20 20 20 20 20 20 20 2f 2a 20 69 6e 20 2a /* in *
210e0 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 /.. s
210f0 74 72 69 6e 67 20 6e 61 6d 65 2c 20 20 20 20 20 tring name,
21100 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 /* i
21110 6e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 n */..
21120 20 20 72 65 66 20 53 51 4c 69 74 65 46 75 6e 63 ref SQLiteFunc
21130 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 2c 20 2f tion function, /
21140 2a 20 6f 75 74 20 2a 2f 0d 0a 20 20 20 20 20 20 * out */..
21150 20 20 20 20 20 20 72 65 66 20 49 6e 74 50 74 72 ref IntPtr
21160 20 70 43 6c 69 65 6e 74 44 61 74 61 20 20 20 20 pClientData
21170 20 20 20 2f 2a 20 6f 75 74 20 2a 2f 0d 0a 20 20 /* out */..
21180 20 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a );....
21190 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f ////////
211a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
211b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
211c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
211d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
211e0 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
211f0 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
21200 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 6f /// This metho
21210 64 20 69 73 20 63 61 6c 6c 65 64 20 69 6e 20 72 d is called in r
21220 65 73 70 6f 6e 73 65 20 74 6f 20 74 68 65 0d 0a esponse to the..
21230 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 /// <see
21240 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 cref="ISQLiteNa
21250 74 69 76 65 4d 6f 64 75 6c 65 2e 78 52 65 6e 61 tiveModule.xRena
21260 6d 65 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a me" /> method...
21270 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
21280 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
21290 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
212a0 22 74 61 62 6c 65 22 3e 0d 0a 20 20 20 20 20 20 "table">..
212b0 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 /// The <see c
212c0 72 65 66 3d 22 53 51 4c 69 74 65 56 69 72 74 75 ref="SQLiteVirtu
212d0 61 6c 54 61 62 6c 65 22 20 2f 3e 20 6f 62 6a 65 alTable" /> obje
212e0 63 74 20 69 6e 73 74 61 6e 63 65 20 61 73 73 6f ct instance asso
212f0 63 69 61 74 65 64 0d 0a 20 20 20 20 20 20 20 20 ciated..
21300 2f 2f 2f 20 77 69 74 68 20 74 68 69 73 20 76 69 /// with this vi
21310 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 20 rtual table...
21320 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
21330 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
21340 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6e 65 77 <param name="new
21350 4e 61 6d 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 Name">..
21360 2f 2f 2f 20 54 68 65 20 6e 65 77 20 6e 61 6d 65 /// The new name
21370 20 66 6f 72 20 74 68 65 20 76 69 72 74 75 61 6c for the virtual
21380 20 74 61 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 table...
21390 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
213a0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 /// <retu
213b0 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f rns>.. //
213c0 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c / A standard SQL
213d0 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e ite return code.
213e0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
213f0 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
21400 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 SQLiteErrorCod
21410 65 20 52 65 6e 61 6d 65 28 0d 0a 20 20 20 20 20 e Rename(..
21420 20 20 20 20 20 20 20 53 51 4c 69 74 65 56 69 72 SQLiteVir
21430 74 75 61 6c 54 61 62 6c 65 20 74 61 62 6c 65 2c tualTable table,
21440 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 /* in */..
21450 20 20 20 20 20 20 20 73 74 72 69 6e 67 20 6e 65 string ne
21460 77 4e 61 6d 65 20 20 20 20 20 20 20 20 20 20 20 wName
21470 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 /* in */..
21480 20 20 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 );....
21490 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
214a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
214b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
214c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
214d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
214e0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
214f0 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
21500 2f 2f 20 54 68 69 73 20 6d 65 74 68 6f 64 20 69 // This method i
21510 73 20 63 61 6c 6c 65 64 20 69 6e 20 72 65 73 70 s called in resp
21520 6f 6e 73 65 20 74 6f 20 74 68 65 0d 0a 20 20 20 onse to the..
21530 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 /// <see cr
21540 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 ef="ISQLiteNativ
21550 65 4d 6f 64 75 6c 65 2e 78 53 61 76 65 70 6f 69 eModule.xSavepoi
21560 6e 74 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a nt" /> method...
21570 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
21580 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
21590 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
215a0 22 74 61 62 6c 65 22 3e 0d 0a 20 20 20 20 20 20 "table">..
215b0 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 /// The <see c
215c0 72 65 66 3d 22 53 51 4c 69 74 65 56 69 72 74 75 ref="SQLiteVirtu
215d0 61 6c 54 61 62 6c 65 22 20 2f 3e 20 6f 62 6a 65 alTable" /> obje
215e0 63 74 20 69 6e 73 74 61 6e 63 65 20 61 73 73 6f ct instance asso
215f0 63 69 61 74 65 64 0d 0a 20 20 20 20 20 20 20 20 ciated..
21600 2f 2f 2f 20 77 69 74 68 20 74 68 69 73 20 76 69 /// with this vi
21610 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 20 rtual table...
21620 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
21630 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
21640 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 73 61 76 <param name="sav
21650 65 70 6f 69 6e 74 22 3e 0d 0a 20 20 20 20 20 20 epoint">..
21660 20 20 2f 2f 2f 20 54 68 69 73 20 69 73 20 61 6e /// This is an
21670 20 69 6e 74 65 67 65 72 20 69 64 65 6e 74 69 66 integer identif
21680 69 65 72 20 75 6e 64 65 72 20 77 68 69 63 68 20 ier under which
21690 74 68 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 the the current
216a0 73 74 61 74 65 20 6f 66 0d 0a 20 20 20 20 20 20 state of..
216b0 20 20 2f 2f 2f 20 74 68 65 20 76 69 72 74 75 61 /// the virtua
216c0 6c 20 74 61 62 6c 65 20 73 68 6f 75 6c 64 20 62 l table should b
216d0 65 20 73 61 76 65 64 2e 0d 0a 20 20 20 20 20 20 e saved...
216e0 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
216f0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 /// <ret
21700 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f urns>.. /
21710 2f 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 // A standard SQ
21720 4c 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 Lite return code
21730 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
21740 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 /returns>..
21750 20 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f SQLiteErrorCo
21760 64 65 20 53 61 76 65 70 6f 69 6e 74 28 0d 0a 20 de Savepoint(..
21770 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 SQLit
21780 65 56 69 72 74 75 61 6c 54 61 62 6c 65 20 74 61 eVirtualTable ta
21790 62 6c 65 2c 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 ble, /* in */..
217a0 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 73 int s
217b0 61 76 65 70 6f 69 6e 74 20 20 20 20 20 20 20 20 avepoint
217c0 20 20 20 20 20 2f 2a 20 69 6e 20 2a 2f 0d 0a 20 /* in */..
217d0 20 20 20 20 20 20 20 20 20 20 20 29 3b 0d 0a 0d );...
217e0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
217f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21800 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21810 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21820 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21830 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 .... ///
21840 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
21850 20 20 20 2f 2f 2f 20 54 68 69 73 20 6d 65 74 68 /// This meth
21860 6f 64 20 69 73 20 63 61 6c 6c 65 64 20 69 6e 20 od is called in
21870 72 65 73 70 6f 6e 73 65 20 74 6f 20 74 68 65 0d response to the.
21880 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 . /// <se
21890 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e e cref="ISQLiteN
218a0 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 52 65 6c ativeModule.xRel
218b0 65 61 73 65 22 20 2f 3e 20 6d 65 74 68 6f 64 2e ease" /> method.
218c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
218d0 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
218e0 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
218f0 65 3d 22 74 61 62 6c 65 22 3e 0d 0a 20 20 20 20 e="table">..
21900 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 /// The <see
21910 20 63 72 65 66 3d 22 53 51 4c 69 74 65 56 69 72 cref="SQLiteVir
21920 74 75 61 6c 54 61 62 6c 65 22 20 2f 3e 20 6f 62 tualTable" /> ob
21930 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 61 73 ject instance as
21940 73 6f 63 69 61 74 65 64 0d 0a 20 20 20 20 20 20 sociated..
21950 20 20 2f 2f 2f 20 77 69 74 68 20 74 68 69 73 20 /// with this
21960 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a virtual table...
21970 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
21980 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
21990 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 73 / <param name="s
219a0 61 76 65 70 6f 69 6e 74 22 3e 0d 0a 20 20 20 20 avepoint">..
219b0 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 69 73 20 /// This is
219c0 61 6e 20 69 6e 74 65 67 65 72 20 75 73 65 64 20 an integer used
219d0 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 to indicate that
219e0 20 61 6e 79 20 73 61 76 65 64 20 73 74 61 74 65 any saved state
219f0 73 20 77 69 74 68 20 61 6e 0d 0a 20 20 20 20 20 s with an..
21a00 20 20 20 2f 2f 2f 20 69 64 65 6e 74 69 66 69 65 /// identifie
21a10 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 6f r greater than o
21a20 72 20 65 71 75 61 6c 20 74 6f 20 74 68 69 73 20 r equal to this
21a30 73 68 6f 75 6c 64 20 62 65 20 64 65 6c 65 74 65 should be delete
21a40 64 20 62 79 20 74 68 65 0d 0a 20 20 20 20 20 20 d by the..
21a50 20 20 2f 2f 2f 20 76 69 72 74 75 61 6c 20 74 61 /// virtual ta
21a60 62 6c 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ble... //
21a70 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
21a80 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
21a90 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 >.. /// A
21aa0 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 65 standard SQLite
21ab0 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a 20 return code...
21ac0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 /// </ret
21ad0 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 53 urns>.. S
21ae0 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 52 QLiteErrorCode R
21af0 65 6c 65 61 73 65 28 0d 0a 20 20 20 20 20 20 20 elease(..
21b00 20 20 20 20 20 53 51 4c 69 74 65 56 69 72 74 75 SQLiteVirtu
21b10 61 6c 54 61 62 6c 65 20 74 61 62 6c 65 2c 20 2f alTable table, /
21b20 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 * in */..
21b30 20 20 20 20 20 69 6e 74 20 73 61 76 65 70 6f 69 int savepoi
21b40 6e 74 20 20 20 20 20 20 20 20 20 20 20 20 20 2f nt /
21b50 2a 20 69 6e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 * in */..
21b60 20 20 20 20 20 29 3b 0d 0a 0d 0a 20 20 20 20 20 );....
21b70 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
21b80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21b90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21ba0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21bb0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
21bc0 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
21bd0 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
21be0 20 54 68 69 73 20 6d 65 74 68 6f 64 20 69 73 20 This method is
21bf0 63 61 6c 6c 65 64 20 69 6e 20 72 65 73 70 6f 6e called in respon
21c00 73 65 20 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 se to the..
21c10 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 /// <see cref
21c20 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d ="ISQLiteNativeM
21c30 6f 64 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 6b 54 odule.xRollbackT
21c40 6f 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 o" /> method...
21c50 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
21c60 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
21c70 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
21c80 74 61 62 6c 65 22 3e 0d 0a 20 20 20 20 20 20 20 table">..
21c90 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 72 /// The <see cr
21ca0 65 66 3d 22 53 51 4c 69 74 65 56 69 72 74 75 61 ef="SQLiteVirtua
21cb0 6c 54 61 62 6c 65 22 20 2f 3e 20 6f 62 6a 65 63 lTable" /> objec
21cc0 74 20 69 6e 73 74 61 6e 63 65 20 61 73 73 6f 63 t instance assoc
21cd0 69 61 74 65 64 0d 0a 20 20 20 20 20 20 20 20 2f iated.. /
21ce0 2f 2f 20 77 69 74 68 20 74 68 69 73 20 76 69 72 // with this vir
21cf0 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 20 20 tual table...
21d00 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
21d10 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
21d20 70 61 72 61 6d 20 6e 61 6d 65 3d 22 73 61 76 65 param name="save
21d30 70 6f 69 6e 74 22 3e 0d 0a 20 20 20 20 20 20 20 point">..
21d40 20 2f 2f 2f 20 54 68 69 73 20 69 73 20 61 6e 20 /// This is an
21d50 69 6e 74 65 67 65 72 20 69 64 65 6e 74 69 66 69 integer identifi
21d60 65 72 20 75 73 65 64 20 74 6f 20 73 70 65 63 69 er used to speci
21d70 66 79 20 61 20 73 70 65 63 69 66 69 63 20 73 61 fy a specific sa
21d80 76 65 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ved.. ///
21d90 20 73 74 61 74 65 20 66 6f 72 20 74 68 65 20 76 state for the v
21da0 69 72 74 75 61 6c 20 74 61 62 6c 65 20 66 6f 72 irtual table for
21db0 20 69 74 20 74 6f 20 72 65 73 74 6f 72 65 20 69 it to restore i
21dc0 74 73 65 6c 66 20 62 61 63 6b 20 74 6f 2c 20 77 tself back to, w
21dd0 68 69 63 68 0d 0a 20 20 20 20 20 20 20 20 2f 2f hich.. //
21de0 2f 20 73 68 6f 75 6c 64 20 61 6c 73 6f 20 68 61 / should also ha
21df0 76 65 20 74 68 65 20 65 66 66 65 63 74 20 6f 66 ve the effect of
21e00 20 64 65 6c 65 74 69 6e 67 20 61 6c 6c 20 73 61 deleting all sa
21e10 76 65 64 20 73 74 61 74 65 73 20 77 69 74 68 20 ved states with
21e20 61 6e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 an.. ///
21e30 69 6e 74 65 67 65 72 20 69 64 65 6e 74 69 66 69 integer identifi
21e40 65 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 er greater than
21e50 74 68 69 73 20 6f 6e 65 2e 0d 0a 20 20 20 20 20 this one...
21e60 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
21e70 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 . /// <re
21e80 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
21e90 2f 2f 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 /// A standard S
21ea0 51 4c 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 QLite return cod
21eb0 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
21ec0 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 </returns>..
21ed0 20 20 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43 SQLiteErrorC
21ee0 6f 64 65 20 52 6f 6c 6c 62 61 63 6b 54 6f 28 0d ode RollbackTo(.
21ef0 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c . SQL
21f00 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c 65 20 iteVirtualTable
21f10 74 61 62 6c 65 2c 20 2f 2a 20 69 6e 20 2a 2f 0d table, /* in */.
21f20 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 . int
21f30 20 73 61 76 65 70 6f 69 6e 74 20 20 20 20 20 20 savepoint
21f40 20 20 20 20 20 20 20 2f 2a 20 69 6e 20 2a 2f 0d /* in */.
21f50 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 3b 0d . );.
21f60 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 65 6e 64 . }.. #end
21f70 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 2f 2f region.... //
21f80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21f90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21fa0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21fb0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
21fc0 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 /////////....
21fd0 20 23 72 65 67 69 6f 6e 20 53 51 4c 69 74 65 4d #region SQLiteM
21fe0 65 6d 6f 72 79 20 53 74 61 74 69 63 20 43 6c 61 emory Static Cla
21ff0 73 73 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d ss.. /// <sum
22000 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 mary>.. /// T
22010 68 69 73 20 63 6c 61 73 73 20 63 6f 6e 74 61 69 his class contai
22020 6e 73 20 73 74 61 74 69 63 20 6d 65 74 68 6f 64 ns static method
22030 73 20 74 68 61 74 20 61 72 65 20 75 73 65 64 20 s that are used
22040 74 6f 20 61 6c 6c 6f 63 61 74 65 2c 0d 0a 20 20 to allocate,..
22050 20 20 2f 2f 2f 20 6d 61 6e 69 70 75 6c 61 74 65 /// manipulate
22060 2c 20 61 6e 64 20 66 72 65 65 20 6e 61 74 69 76 , and free nativ
22070 65 20 6d 65 6d 6f 72 79 20 70 72 6f 76 69 64 65 e memory provide
22080 64 20 62 79 20 74 68 65 20 53 51 4c 69 74 65 20 d by the SQLite
22090 63 6f 72 65 20 6c 69 62 72 61 72 79 2e 0d 0a 20 core library...
220a0 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
220b0 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 >.. internal
220c0 73 74 61 74 69 63 20 63 6c 61 73 73 20 53 51 4c static class SQL
220d0 69 74 65 4d 65 6d 6f 72 79 0d 0a 20 20 20 20 7b iteMemory.. {
220e0 0d 0a 20 20 20 20 20 20 20 20 23 72 65 67 69 6f .. #regio
220f0 6e 20 50 72 69 76 61 74 65 20 44 61 74 61 0d 0a n Private Data..
22100 23 69 66 20 54 52 41 43 4b 5f 4d 45 4d 4f 52 59 #if TRACK_MEMORY
22110 5f 42 59 54 45 53 0d 0a 20 20 20 20 20 20 20 20 _BYTES..
22120 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
22130 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 /// This
22140 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 object instance
22150 69 73 20 75 73 65 64 20 74 6f 20 73 79 6e 63 68 is used to synch
22160 72 6f 6e 69 7a 65 20 61 63 63 65 73 73 20 74 6f ronize access to
22170 20 74 68 65 20 6f 74 68 65 72 0d 0a 20 20 20 20 the other..
22180 20 20 20 20 2f 2f 2f 20 73 74 61 74 69 63 20 66 /// static f
22190 69 65 6c 64 73 20 6f 66 20 74 68 69 73 20 63 6c ields of this cl
221a0 61 73 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ass... //
221b0 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 / </summary>..
221c0 20 20 20 20 20 20 70 72 69 76 61 74 65 20 73 74 private st
221d0 61 74 69 63 20 6f 62 6a 65 63 74 20 73 79 6e 63 atic object sync
221e0 52 6f 6f 74 20 3d 20 6e 65 77 20 6f 62 6a 65 63 Root = new objec
221f0 74 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 t();....
22200 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22210 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22220 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22230 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22240 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
22250 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
22260 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
22270 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f e total number o
22280 66 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 6d 65 f outstanding me
22290 6d 6f 72 79 20 62 79 74 65 73 20 61 6c 6c 6f 63 mory bytes alloc
222a0 61 74 65 64 20 62 79 20 74 68 69 73 0d 0a 20 20 ated by this..
222b0 20 20 20 20 20 20 2f 2f 2f 20 63 6c 61 73 73 20 /// class
222c0 75 73 69 6e 67 20 74 68 65 20 53 51 4c 69 74 65 using the SQLite
222d0 20 63 6f 72 65 20 6c 69 62 72 61 72 79 2e 0d 0a core library...
222e0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
222f0 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
22300 70 72 69 76 61 74 65 20 73 74 61 74 69 63 20 69 private static i
22310 6e 74 20 62 79 74 65 73 41 6c 6c 6f 63 61 74 65 nt bytesAllocate
22320 64 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f d;.... //
22330 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22340 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22350 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22360 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22370 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
22380 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
22390 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
223a0 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f maximum number o
223b0 66 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 6d 65 f outstanding me
223c0 6d 6f 72 79 20 62 79 74 65 73 20 65 76 65 72 20 mory bytes ever
223d0 61 6c 6c 6f 63 61 74 65 64 20 62 79 0d 0a 20 20 allocated by..
223e0 20 20 20 20 20 20 2f 2f 2f 20 74 68 69 73 20 63 /// this c
223f0 6c 61 73 73 20 75 73 69 6e 67 20 74 68 65 20 53 lass using the S
22400 51 4c 69 74 65 20 63 6f 72 65 20 6c 69 62 72 61 QLite core libra
22410 72 79 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry... ///
22420 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
22430 20 20 20 20 20 70 72 69 76 61 74 65 20 73 74 61 private sta
22440 74 69 63 20 69 6e 74 20 6d 61 78 69 6d 75 6d 42 tic int maximumB
22450 79 74 65 73 41 6c 6c 6f 63 61 74 65 64 3b 0d 0a ytesAllocated;..
22460 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 20 20 20 #endif..
22470 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 #endregion....
22480 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////
22490 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
224a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
224b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
224c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d /////////////...
224d0 0a 20 20 20 20 20 20 20 20 23 72 65 67 69 6f 6e . #region
224e0 20 4d 65 6d 6f 72 79 20 41 6c 6c 6f 63 61 74 69 Memory Allocati
224f0 6f 6e 20 48 65 6c 70 65 72 20 4d 65 74 68 6f 64 on Helper Method
22500 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c s.. /// <
22510 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
22520 20 20 2f 2f 2f 20 41 6c 6c 6f 63 61 74 65 73 20 /// Allocates
22530 61 74 20 6c 65 61 73 74 20 74 68 65 20 73 70 65 at least the spe
22540 63 69 66 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 cified number of
22550 20 62 79 74 65 73 20 6f 66 20 6e 61 74 69 76 65 bytes of native
22560 20 6d 65 6d 6f 72 79 0d 0a 20 20 20 20 20 20 20 memory..
22570 20 2f 2f 2f 20 76 69 61 20 74 68 65 20 53 51 4c /// via the SQL
22580 69 74 65 20 63 6f 72 65 20 6c 69 62 72 61 72 79 ite core library
22590 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 sqlite3_malloc(
225a0 29 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 20 72 ) function and r
225b0 65 74 75 72 6e 73 0d 0a 20 20 20 20 20 20 20 20 eturns..
225c0 2f 2f 2f 20 74 68 65 20 72 65 73 75 6c 74 69 6e /// the resultin
225d0 67 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 72 g native pointer
225e0 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
225f0 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
22600 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
22610 6d 65 3d 22 73 69 7a 65 22 3e 0d 0a 20 20 20 20 me="size">..
22620 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 75 6d 62 /// The numb
22630 65 72 20 6f 66 20 62 79 74 65 73 20 74 6f 20 61 er of bytes to a
22640 6c 6c 6f 63 61 74 65 2e 0d 0a 20 20 20 20 20 20 llocate...
22650 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
22660 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 /// <ret
22670 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f urns>.. /
22680 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 70 6f // The native po
22690 69 6e 74 65 72 20 74 68 61 74 20 70 6f 69 6e 74 inter that point
226a0 73 20 74 6f 20 61 20 62 6c 6f 63 6b 20 6f 66 20 s to a block of
226b0 6d 65 6d 6f 72 79 20 6f 66 20 61 74 20 6c 65 61 memory of at lea
226c0 73 74 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 st the..
226d0 2f 2f 2f 20 73 70 65 63 69 66 69 65 64 20 73 69 /// specified si
226e0 7a 65 20 2d 4f 52 2d 20 3c 73 65 65 20 63 72 65 ze -OR- <see cre
226f0 66 3d 22 49 6e 74 50 74 72 2e 5a 65 72 6f 22 20 f="IntPtr.Zero"
22700 2f 3e 20 69 66 20 74 68 65 20 6d 65 6d 6f 72 79 /> if the memory
22710 20 63 6f 75 6c 64 0d 0a 20 20 20 20 20 20 20 20 could..
22720 2f 2f 2f 20 6e 6f 74 20 62 65 20 61 6c 6c 6f 63 /// not be alloc
22730 61 74 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f ated... /
22740 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 // </returns>..
22750 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 73 74 public st
22760 61 74 69 63 20 49 6e 74 50 74 72 20 41 6c 6c 6f atic IntPtr Allo
22770 63 61 74 65 28 69 6e 74 20 73 69 7a 65 29 0d 0a cate(int size)..
22780 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
22790 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 4d IntPtr pM
227a0 65 6d 6f 72 79 20 3d 20 55 6e 73 61 66 65 4e 61 emory = UnsafeNa
227b0 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 tiveMethods.sqli
227c0 74 65 33 5f 6d 61 6c 6c 6f 63 28 73 69 7a 65 29 te3_malloc(size)
227d0 3b 0d 0a 0d 0a 23 69 66 20 54 52 41 43 4b 5f 4d ;....#if TRACK_M
227e0 45 4d 4f 52 59 5f 42 59 54 45 53 0d 0a 20 20 20 EMORY_BYTES..
227f0 20 20 20 20 20 20 20 20 20 69 66 20 28 70 4d 65 if (pMe
22800 6d 6f 72 79 20 21 3d 20 49 6e 74 50 74 72 2e 5a mory != IntPtr.Z
22810 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 20 ero)..
22820 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
22830 20 20 20 20 20 69 6e 74 20 62 6c 6f 63 6b 53 69 int blockSi
22840 7a 65 20 3d 20 53 69 7a 65 28 70 4d 65 6d 6f 72 ze = Size(pMemor
22850 79 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 y);....
22860 20 20 20 20 20 20 20 69 66 20 28 62 6c 6f 63 6b if (block
22870 53 69 7a 65 20 3e 20 30 29 0d 0a 20 20 20 20 20 Size > 0)..
22880 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 {..
22890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
228a0 20 20 6c 6f 63 6b 20 28 73 79 6e 63 52 6f 6f 74 lock (syncRoot
228b0 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 )..
228c0 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
228d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
228e0 20 20 62 79 74 65 73 41 6c 6c 6f 63 61 74 65 64 bytesAllocated
228f0 20 2b 3d 20 62 6c 6f 63 6b 53 69 7a 65 3b 0d 0a += blockSize;..
22900 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
22910 20 20 20 20 20 20 20 20 20 20 69 66 20 28 62 79 if (by
22920 74 65 73 41 6c 6c 6f 63 61 74 65 64 20 3e 20 6d tesAllocated > m
22930 61 78 69 6d 75 6d 42 79 74 65 73 41 6c 6c 6f 63 aximumBytesAlloc
22940 61 74 65 64 29 0d 0a 20 20 20 20 20 20 20 20 20 ated)..
22950 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22960 20 20 20 6d 61 78 69 6d 75 6d 42 79 74 65 73 41 maximumBytesA
22970 6c 6c 6f 63 61 74 65 64 20 3d 20 62 79 74 65 73 llocated = bytes
22980 41 6c 6c 6f 63 61 74 65 64 3b 0d 0a 20 20 20 20 Allocated;..
22990 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
229a0 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 }..
229b0 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 }..
229c0 20 20 7d 0d 0a 23 65 6e 64 69 66 0d 0a 0d 0a 20 }..#endif....
229d0 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
229e0 6e 20 70 4d 65 6d 6f 72 79 3b 0d 0a 20 20 20 20 n pMemory;..
229f0 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 }....
22a00 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
22a10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22a20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22a30 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22a40 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 ////////....
22a50 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
22a60 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 47 >.. /// G
22a70 65 74 73 20 61 6e 64 20 72 65 74 75 72 6e 73 20 ets and returns
22a80 74 68 65 20 61 63 74 75 61 6c 20 73 69 7a 65 20 the actual size
22a90 6f 66 20 74 68 65 20 73 70 65 63 69 66 69 65 64 of the specified
22aa0 20 6d 65 6d 6f 72 79 20 62 6c 6f 63 6b 20 74 68 memory block th
22ab0 61 74 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 at.. ///
22ac0 77 61 73 20 70 72 65 76 69 6f 75 73 6c 79 20 6f was previously o
22ad0 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 btained from the
22ae0 20 3c 73 65 65 20 63 72 65 66 3d 22 41 6c 6c 6f <see cref="Allo
22af0 63 61 74 65 22 20 2f 3e 20 6d 65 74 68 6f 64 2e cate" /> method.
22b00 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
22b10 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
22b20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
22b30 65 3d 22 70 4d 65 6d 6f 72 79 22 3e 0d 0a 20 20 e="pMemory">..
22b40 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 /// The na
22b50 74 69 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 tive pointer to
22b60 74 68 65 20 6d 65 6d 6f 72 79 20 62 6c 6f 63 6b the memory block
22b70 20 70 72 65 76 69 6f 75 73 6c 79 20 6f 62 74 61 previously obta
22b80 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 0d 0a 20 ined from the..
22b90 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 /// <see
22ba0 63 72 65 66 3d 22 41 6c 6c 6f 63 61 74 65 22 20 cref="Allocate"
22bb0 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 /> method...
22bc0 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
22bd0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 .. /// <r
22be0 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 eturns>..
22bf0 20 2f 2f 2f 20 54 68 65 20 61 63 74 75 61 6c 20 /// The actual
22c00 73 69 7a 65 2c 20 69 6e 20 62 79 74 65 73 2c 20 size, in bytes,
22c10 6f 66 20 74 68 65 20 6d 65 6d 6f 72 79 20 62 6c of the memory bl
22c20 6f 63 6b 20 73 70 65 63 69 66 69 65 64 20 76 69 ock specified vi
22c30 61 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f a the.. /
22c40 2f 2f 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 // native pointe
22c50 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 r... ///
22c60 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 </returns>..
22c70 20 20 20 20 70 75 62 6c 69 63 20 73 74 61 74 69 public stati
22c80 63 20 69 6e 74 20 53 69 7a 65 28 49 6e 74 50 74 c int Size(IntPt
22c90 72 20 70 4d 65 6d 6f 72 79 29 0d 0a 20 20 20 20 r pMemory)..
22ca0 20 20 20 20 7b 0d 0a 23 69 66 20 21 53 51 4c 49 {..#if !SQLI
22cb0 54 45 5f 53 54 41 4e 44 41 52 44 0d 0a 20 20 20 TE_STANDARD..
22cc0 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 return
22cd0 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 UnsafeNativeMeth
22ce0 6f 64 73 2e 73 71 6c 69 74 65 33 5f 6d 61 6c 6c ods.sqlite3_mall
22cf0 6f 63 5f 73 69 7a 65 5f 69 6e 74 65 72 6f 70 28 oc_size_interop(
22d00 70 4d 65 6d 6f 72 79 29 3b 0d 0a 23 65 6c 69 66 pMemory);..#elif
22d10 20 54 52 41 43 4b 5f 4d 45 4d 4f 52 59 5f 42 59 TRACK_MEMORY_BY
22d20 54 45 53 0d 0a 20 20 20 20 20 20 20 20 20 20 20 TES..
22d30 20 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 //..
22d40 20 2f 2f 20 48 41 43 4b 3a 20 4f 6b 2c 20 77 65 // HACK: Ok, we
22d50 20 63 61 6e 6e 6f 74 20 64 65 74 65 72 6d 69 6e cannot determin
22d60 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 e the size of th
22d70 65 20 6d 65 6d 6f 72 79 20 62 6c 6f 63 6b 3b 0d e memory block;.
22d80 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 . //
22d90 20 20 20 20 20 20 74 68 65 72 65 66 6f 72 65 2c therefore,
22da0 20 6a 75 73 74 20 74 72 61 63 6b 20 6e 75 6d 62 just track numb
22db0 65 72 20 6f 66 20 61 6c 6c 6f 63 61 74 69 6f 6e er of allocation
22dc0 73 20 69 6e 73 74 65 61 64 2e 0d 0a 20 20 20 20 s instead...
22dd0 20 20 20 20 20 20 20 20 2f 2f 0d 0a 20 20 20 20 //..
22de0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 28 return (
22df0 70 4d 65 6d 6f 72 79 20 21 3d 20 49 6e 74 50 74 pMemory != IntPt
22e00 72 2e 5a 65 72 6f 29 20 3f 20 31 20 3a 20 30 3b r.Zero) ? 1 : 0;
22e10 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20 20 20 ..#else..
22e20 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0d 0a return 0;..
22e30 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 20 20 20 #endif..
22e40 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f }.... ///
22e50 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22e60 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22e70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22e80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
22e90 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ////....
22ea0 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
22eb0 20 20 20 20 20 20 20 2f 2f 2f 20 46 72 65 65 73 /// Frees
22ec0 20 61 20 6d 65 6d 6f 72 79 20 62 6c 6f 63 6b 20 a memory block
22ed0 70 72 65 76 69 6f 75 73 6c 79 20 6f 62 74 61 69 previously obtai
22ee0 6e 65 64 20 66 72 6f 6d 20 74 68 65 0d 0a 20 20 ned from the..
22ef0 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 /// <see c
22f00 72 65 66 3d 22 41 6c 6c 6f 63 61 74 65 22 20 2f ref="Allocate" /
22f10 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
22f20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
22f30 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
22f40 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 4d 65 6d param name="pMem
22f50 6f 72 79 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f ory">.. /
22f60 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 70 6f // The native po
22f70 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6d 65 6d inter to the mem
22f80 6f 72 79 20 62 6c 6f 63 6b 20 70 72 65 76 69 6f ory block previo
22f90 75 73 6c 79 20 6f 62 74 61 69 6e 65 64 20 66 72 usly obtained fr
22fa0 6f 6d 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 om the..
22fb0 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 41 /// <see cref="A
22fc0 6c 6c 6f 63 61 74 65 22 20 2f 3e 20 6d 65 74 68 llocate" /> meth
22fd0 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f od... ///
22fe0 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
22ff0 20 20 20 70 75 62 6c 69 63 20 73 74 61 74 69 63 public static
23000 20 76 6f 69 64 20 46 72 65 65 28 49 6e 74 50 74 void Free(IntPt
23010 72 20 70 4d 65 6d 6f 72 79 29 0d 0a 20 20 20 20 r pMemory)..
23020 20 20 20 20 7b 0d 0a 23 69 66 20 54 52 41 43 4b {..#if TRACK
23030 5f 4d 45 4d 4f 52 59 5f 42 59 54 45 53 0d 0a 20 _MEMORY_BYTES..
23040 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 70 if (p
23050 4d 65 6d 6f 72 79 20 21 3d 20 49 6e 74 50 74 72 Memory != IntPtr
23060 2e 5a 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 .Zero)..
23070 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 {..
23080 20 20 20 20 20 20 20 69 6e 74 20 62 6c 6f 63 6b int block
23090 53 69 7a 65 20 3d 20 53 69 7a 65 28 70 4d 65 6d Size = Size(pMem
230a0 6f 72 79 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 ory);....
230b0 20 20 20 20 20 20 20 20 20 69 66 20 28 62 6c 6f if (blo
230c0 63 6b 53 69 7a 65 20 3e 20 30 29 0d 0a 20 20 20 ckSize > 0)..
230d0 20 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a {..
230e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
230f0 20 20 20 20 6c 6f 63 6b 20 28 73 79 6e 63 52 6f lock (syncRo
23100 6f 74 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ot)..
23110 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
23120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23130 20 20 20 20 62 79 74 65 73 41 6c 6c 6f 63 61 74 bytesAllocat
23140 65 64 20 2d 3d 20 62 6c 6f 63 6b 53 69 7a 65 3b ed -= blockSize;
23150 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
23160 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 }..
23170 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 }..
23180 20 20 20 20 20 20 20 20 7d 0d 0a 23 65 6e 64 69 }..#endi
23190 66 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 f....
231a0 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 UnsafeNativeMet
231b0 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 66 72 65 hods.sqlite3_fre
231c0 65 28 70 4d 65 6d 6f 72 79 29 3b 0d 0a 20 20 20 e(pMemory);..
231d0 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 }..
231e0 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 20 20 20 20 #endregion..
231f0 7d 0d 0a 20 20 20 20 23 65 6e 64 72 65 67 69 6f }.. #endregio
23200 6e 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f n.... ///////
23210 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23220 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23230 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23240 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23250 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 23 72 65 67 ////.... #reg
23260 69 6f 6e 20 53 51 4c 69 74 65 53 74 72 69 6e 67 ion SQLiteString
23270 20 53 74 61 74 69 63 20 43 6c 61 73 73 0d 0a 20 Static Class..
23280 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
23290 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 63 .. /// This c
232a0 6c 61 73 73 20 63 6f 6e 74 61 69 6e 73 20 73 74 lass contains st
232b0 61 74 69 63 20 6d 65 74 68 6f 64 73 20 74 68 61 atic methods tha
232c0 74 20 61 72 65 20 75 73 65 64 20 74 6f 20 64 65 t are used to de
232d0 61 6c 20 77 69 74 68 20 6e 61 74 69 76 65 0d 0a al with native..
232e0 20 20 20 20 2f 2f 2f 20 55 54 46 2d 38 20 73 74 /// UTF-8 st
232f0 72 69 6e 67 20 70 6f 69 6e 74 65 72 73 20 74 6f ring pointers to
23300 20 62 65 20 75 73 65 64 20 77 69 74 68 20 74 68 be used with th
23310 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6c 69 e SQLite core li
23320 62 72 61 72 79 2e 0d 0a 20 20 20 20 2f 2f 2f 20 brary... ///
23330 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
23340 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 69 63 20 internal static
23350 63 6c 61 73 73 20 53 51 4c 69 74 65 53 74 72 69 class SQLiteStri
23360 6e 67 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20 ng.. {..
23370 20 20 20 23 72 65 67 69 6f 6e 20 50 72 69 76 61 #region Priva
23380 74 65 20 43 6f 6e 73 74 61 6e 74 73 0d 0a 20 20 te Constants..
23390 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
233a0 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
233b0 20 54 68 69 73 20 69 73 20 74 68 65 20 6d 61 78 This is the max
233c0 69 6d 75 6d 20 70 6f 73 73 69 62 6c 65 20 6c 65 imum possible le
233d0 6e 67 74 68 20 66 6f 72 20 74 68 65 20 6e 61 74 ngth for the nat
233e0 69 76 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 ive UTF-8 encode
233f0 64 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 d.. /// s
23400 74 72 69 6e 67 73 20 75 73 65 64 20 77 69 74 68 trings used with
23410 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 the SQLite core
23420 20 6c 69 62 72 61 72 79 2e 0d 0a 20 20 20 20 20 library...
23430 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
23440 3e 0d 0a 20 20 20 20 20 20 20 20 70 72 69 76 61 >.. priva
23450 74 65 20 73 74 61 74 69 63 20 69 6e 74 20 54 68 te static int Th
23460 69 72 74 79 42 69 74 73 20 3d 20 30 78 33 66 66 irtyBits = 0x3ff
23470 66 66 66 66 66 3b 0d 0a 0d 0a 20 20 20 20 20 20 fffff;....
23480 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////////
23490 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
234a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
234b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
234c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 /////////....
234d0 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
234e0 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
234f0 54 68 69 73 20 69 73 20 74 68 65 20 3c 73 65 65 This is the <see
23500 20 63 72 65 66 3d 22 45 6e 63 6f 64 69 6e 67 22 cref="Encoding"
23510 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 /> object insta
23520 6e 63 65 20 75 73 65 64 20 74 6f 20 68 61 6e 64 nce used to hand
23530 6c 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 le.. ///
23540 63 6f 6e 76 65 72 73 69 6f 6e 73 20 66 72 6f 6d conversions from
23550 2f 74 6f 20 55 54 46 2d 38 2e 0d 0a 20 20 20 20 /to UTF-8...
23560 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
23570 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 72 69 76 y>.. priv
23580 61 74 65 20 73 74 61 74 69 63 20 72 65 61 64 6f ate static reado
23590 6e 6c 79 20 45 6e 63 6f 64 69 6e 67 20 55 74 66 nly Encoding Utf
235a0 38 45 6e 63 6f 64 69 6e 67 20 3d 20 45 6e 63 6f 8Encoding = Enco
235b0 64 69 6e 67 2e 55 54 46 38 3b 0d 0a 20 20 20 20 ding.UTF8;..
235c0 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a #endregion..
235d0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
235e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
235f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23600 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23610 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23620 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 /.... #re
23630 67 69 6f 6e 20 55 54 46 2d 38 20 45 6e 63 6f 64 gion UTF-8 Encod
23640 69 6e 67 20 48 65 6c 70 65 72 20 4d 65 74 68 6f ing Helper Metho
23650 64 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ds.. ///
23660 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
23670 20 20 20 2f 2f 2f 20 43 6f 6e 76 65 72 74 73 20 /// Converts
23680 74 68 65 20 73 70 65 63 69 66 69 65 64 20 6d 61 the specified ma
23690 6e 61 67 65 64 20 73 74 72 69 6e 67 20 69 6e 74 naged string int
236a0 6f 20 74 68 65 20 55 54 46 2d 38 20 65 6e 63 6f o the UTF-8 enco
236b0 64 69 6e 67 20 61 6e 64 0d 0a 20 20 20 20 20 20 ding and..
236c0 20 20 2f 2f 2f 20 72 65 74 75 72 6e 73 20 74 68 /// returns th
236d0 65 20 61 72 72 61 79 20 6f 66 20 62 79 74 65 73 e array of bytes
236e0 20 63 6f 6e 74 61 69 6e 69 6e 67 20 69 74 73 20 containing its
236f0 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 69 representation i
23700 6e 20 74 68 61 74 0d 0a 20 20 20 20 20 20 20 20 n that..
23710 2f 2f 2f 20 65 6e 63 6f 64 69 6e 67 2e 0d 0a 20 /// encoding...
23720 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
23730 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
23740 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
23750 76 61 6c 75 65 22 3e 0d 0a 20 20 20 20 20 20 20 value">..
23760 20 2f 2f 2f 20 54 68 65 20 6d 61 6e 61 67 65 64 /// The managed
23770 20 73 74 72 69 6e 67 20 74 6f 20 63 6f 6e 76 65 string to conve
23780 72 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f rt... ///
23790 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
237a0 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e /// <returns>
237b0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
237c0 65 20 61 72 72 61 79 20 6f 66 20 62 79 74 65 73 e array of bytes
237d0 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 containing the
237e0 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f representation o
237f0 66 20 74 68 65 20 6d 61 6e 61 67 65 64 0d 0a 20 f the managed..
23800 20 20 20 20 20 20 20 2f 2f 2f 20 73 74 72 69 6e /// strin
23810 67 20 69 6e 20 74 68 65 20 55 54 46 2d 38 20 65 g in the UTF-8 e
23820 6e 63 6f 64 69 6e 67 20 6f 72 20 6e 75 6c 6c 20 ncoding or null
23830 75 70 6f 6e 20 66 61 69 6c 75 72 65 2e 0d 0a 20 upon failure...
23840 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 /// </ret
23850 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 70 urns>.. p
23860 75 62 6c 69 63 20 73 74 61 74 69 63 20 62 79 74 ublic static byt
23870 65 5b 5d 20 47 65 74 55 74 66 38 42 79 74 65 73 e[] GetUtf8Bytes
23880 46 72 6f 6d 53 74 72 69 6e 67 28 0d 0a 20 20 20 FromString(..
23890 20 20 20 20 20 20 20 20 20 73 74 72 69 6e 67 20 string
238a0 76 61 6c 75 65 0d 0a 20 20 20 20 20 20 20 20 20 value..
238b0 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d ).. {.
238c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 . if
238d0 28 76 61 6c 75 65 20 3d 3d 20 6e 75 6c 6c 29 0d (value == null).
238e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
238f0 20 72 65 74 75 72 6e 20 6e 75 6c 6c 3b 0d 0a 0d return null;...
23900 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 . ret
23910 75 72 6e 20 55 74 66 38 45 6e 63 6f 64 69 6e 67 urn Utf8Encoding
23920 2e 47 65 74 42 79 74 65 73 28 76 61 6c 75 65 29 .GetBytes(value)
23930 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a ;.. }....
23940 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f ////////
23950 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23960 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23970 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23980 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
23990 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
239a0 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
239b0 20 20 2f 2f 2f 20 43 6f 6e 76 65 72 74 73 20 74 /// Converts t
239c0 68 65 20 73 70 65 63 69 66 69 65 64 20 61 72 72 he specified arr
239d0 61 79 20 6f 66 20 62 79 74 65 73 20 72 65 70 72 ay of bytes repr
239e0 65 73 65 6e 74 69 6e 67 20 61 20 73 74 72 69 6e esenting a strin
239f0 67 20 69 6e 20 74 68 65 0d 0a 20 20 20 20 20 20 g in the..
23a00 20 20 2f 2f 2f 20 55 54 46 2d 38 20 65 6e 63 6f /// UTF-8 enco
23a10 64 69 6e 67 20 61 6e 64 20 72 65 74 75 72 6e 73 ding and returns
23a20 20 61 20 6d 61 6e 61 67 65 64 20 73 74 72 69 6e a managed strin
23a30 67 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 g... ///
23a40 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
23a50 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
23a60 61 6d 65 3d 22 62 79 74 65 73 22 3e 0d 0a 20 20 ame="bytes">..
23a70 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 61 72 /// The ar
23a80 72 61 79 20 6f 66 20 62 79 74 65 73 20 74 6f 20 ray of bytes to
23a90 63 6f 6e 76 65 72 74 2e 0d 0a 20 20 20 20 20 20 convert...
23aa0 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
23ab0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 /// <ret
23ac0 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f urns>.. /
23ad0 2f 2f 20 54 68 65 20 6d 61 6e 61 67 65 64 20 73 // The managed s
23ae0 74 72 69 6e 67 20 6f 72 20 6e 75 6c 6c 20 75 70 tring or null up
23af0 6f 6e 20 66 61 69 6c 75 72 65 2e 0d 0a 20 20 20 on failure...
23b00 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 /// </retur
23b10 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 ns>.. pub
23b20 6c 69 63 20 73 74 61 74 69 63 20 73 74 72 69 6e lic static strin
23b30 67 20 47 65 74 53 74 72 69 6e 67 46 72 6f 6d 55 g GetStringFromU
23b40 74 66 38 42 79 74 65 73 28 0d 0a 20 20 20 20 20 tf8Bytes(..
23b50 20 20 20 20 20 20 20 62 79 74 65 5b 5d 20 62 79 byte[] by
23b60 74 65 73 0d 0a 20 20 20 20 20 20 20 20 20 20 20 tes..
23b70 20 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 ).. {..
23b80 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 62 if (b
23b90 79 74 65 73 20 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 ytes == null)..
23ba0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 r
23bb0 65 74 75 72 6e 20 6e 75 6c 6c 3b 0d 0a 0d 0a 23 eturn null;....#
23bc0 69 66 20 21 50 4c 41 54 46 4f 52 4d 5f 43 4f 4d if !PLATFORM_COM
23bd0 50 41 43 54 46 52 41 4d 45 57 4f 52 4b 0d 0a 20 PACTFRAMEWORK..
23be0 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
23bf0 6e 20 55 74 66 38 45 6e 63 6f 64 69 6e 67 2e 47 n Utf8Encoding.G
23c00 65 74 53 74 72 69 6e 67 28 62 79 74 65 73 29 3b etString(bytes);
23c10 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20 20 20 ..#else..
23c20 20 20 20 20 20 72 65 74 75 72 6e 20 55 74 66 38 return Utf8
23c30 45 6e 63 6f 64 69 6e 67 2e 47 65 74 53 74 72 69 Encoding.GetStri
23c40 6e 67 28 62 79 74 65 73 2c 20 30 2c 20 62 79 74 ng(bytes, 0, byt
23c50 65 73 2e 4c 65 6e 67 74 68 29 3b 0d 0a 23 65 6e es.Length);..#en
23c60 64 69 66 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a dif.. }..
23c70 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 #endregi
23c80 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f on.... //
23c90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23ca0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23cb0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23cc0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
23cd0 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
23ce0 20 23 72 65 67 69 6f 6e 20 55 54 46 2d 38 20 53 #region UTF-8 S
23cf0 74 72 69 6e 67 20 48 65 6c 70 65 72 20 4d 65 74 tring Helper Met
23d00 68 6f 64 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f hods.. //
23d10 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
23d20 20 20 20 20 20 2f 2f 2f 20 50 72 6f 62 65 73 20 /// Probes
23d30 61 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 72 a native pointer
23d40 20 74 6f 20 61 20 73 74 72 69 6e 67 20 69 6e 20 to a string in
23d50 74 68 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 69 the UTF-8 encodi
23d60 6e 67 20 66 6f 72 20 69 74 73 0d 0a 20 20 20 20 ng for its..
23d70 20 20 20 20 2f 2f 2f 20 74 65 72 6d 69 6e 61 74 /// terminat
23d80 69 6e 67 20 4e 55 4c 20 63 68 61 72 61 63 74 65 ing NUL characte
23d90 72 2c 20 77 69 74 68 69 6e 20 74 68 65 20 73 70 r, within the sp
23da0 65 63 69 66 69 65 64 20 6c 65 6e 67 74 68 20 6c ecified length l
23db0 69 6d 69 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f imit... /
23dc0 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
23dd0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
23de0 6d 20 6e 61 6d 65 3d 22 70 56 61 6c 75 65 22 3e m name="pValue">
23df0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
23e00 65 20 6e 61 74 69 76 65 20 4e 55 4c 2d 74 65 72 e native NUL-ter
23e10 6d 69 6e 61 74 65 64 20 73 74 72 69 6e 67 20 70 minated string p
23e20 6f 69 6e 74 65 72 2e 0d 0a 20 20 20 20 20 20 20 ointer...
23e30 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
23e40 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
23e50 6d 20 6e 61 6d 65 3d 22 6c 69 6d 69 74 22 3e 0d m name="limit">.
23e60 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
23e70 20 6d 61 78 69 6d 75 6d 20 6c 65 6e 67 74 68 20 maximum length
23e80 6f 66 20 74 68 65 20 6e 61 74 69 76 65 20 73 74 of the native st
23e90 72 69 6e 67 2c 20 69 6e 20 62 79 74 65 73 2e 0d ring, in bytes..
23ea0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
23eb0 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f aram>.. /
23ec0 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 // <returns>..
23ed0 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6c 65 /// The le
23ee0 6e 67 74 68 20 6f 66 20 74 68 65 20 6e 61 74 69 ngth of the nati
23ef0 76 65 20 73 74 72 69 6e 67 2c 20 69 6e 20 62 79 ve string, in by
23f00 74 65 73 20 2d 4f 52 2d 20 7a 65 72 6f 20 69 66 tes -OR- zero if
23f10 20 74 68 65 20 6c 65 6e 67 74 68 0d 0a 20 20 20 the length..
23f20 20 20 20 20 20 2f 2f 2f 20 63 6f 75 6c 64 20 6e /// could n
23f30 6f 74 20 62 65 20 64 65 74 65 72 6d 69 6e 65 64 ot be determined
23f40 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
23f50 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 /returns>..
23f60 20 20 20 70 75 62 6c 69 63 20 73 74 61 74 69 63 public static
23f70 20 69 6e 74 20 50 72 6f 62 65 46 6f 72 55 74 66 int ProbeForUtf
23f80 38 42 79 74 65 4c 65 6e 67 74 68 28 0d 0a 20 20 8ByteLength(..
23f90 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 IntPtr
23fa0 20 70 56 61 6c 75 65 2c 0d 0a 20 20 20 20 20 20 pValue,..
23fb0 20 20 20 20 20 20 69 6e 74 20 6c 69 6d 69 74 0d int limit.
23fc0 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a . )..
23fd0 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
23fe0 20 20 20 20 20 20 20 69 6e 74 20 6c 65 6e 67 74 int lengt
23ff0 68 20 3d 20 30 3b 0d 0a 0d 0a 20 20 20 20 20 20 h = 0;....
24000 20 20 20 20 20 20 69 66 20 28 28 70 56 61 6c 75 if ((pValu
24010 65 20 21 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f e != IntPtr.Zero
24020 29 20 26 26 20 28 6c 69 6d 69 74 20 3e 20 30 29 ) && (limit > 0)
24030 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b ).. {
24040 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
24050 20 20 64 6f 0d 0a 20 20 20 20 20 20 20 20 20 20 do..
24060 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
24070 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 if
24080 28 4d 61 72 73 68 61 6c 2e 52 65 61 64 42 79 74 (Marshal.ReadByt
24090 65 28 70 56 61 6c 75 65 2c 20 6c 65 6e 67 74 68 e(pValue, length
240a0 29 20 3d 3d 20 30 29 0d 0a 20 20 20 20 20 20 20 ) == 0)..
240b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
240c0 20 62 72 65 61 6b 3b 0d 0a 0d 0a 20 20 20 20 20 break;....
240d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 i
240e0 66 20 28 6c 65 6e 67 74 68 20 3e 3d 20 6c 69 6d f (length >= lim
240f0 69 74 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 it)..
24100 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 bre
24110 61 6b 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 ak;....
24120 20 20 20 20 20 20 20 20 20 20 20 6c 65 6e 67 74 lengt
24130 68 2b 2b 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 h++;..
24140 20 20 20 20 20 20 7d 20 77 68 69 6c 65 20 28 74 } while (t
24150 72 75 65 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 rue);..
24160 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 }....
24170 20 20 20 20 72 65 74 75 72 6e 20 6c 65 6e 67 74 return lengt
24180 68 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d h;.. }...
24190 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
241a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
241b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
241c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
241d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
241e0 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 .... ///
241f0 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
24200 20 20 20 2f 2f 2f 20 43 6f 6e 76 65 72 74 73 20 /// Converts
24210 74 68 65 20 73 70 65 63 69 66 69 65 64 20 6e 61 the specified na
24220 74 69 76 65 20 4e 55 4c 2d 74 65 72 6d 69 6e 61 tive NUL-termina
24230 74 65 64 20 55 54 46 2d 38 20 73 74 72 69 6e 67 ted UTF-8 string
24240 20 70 6f 69 6e 74 65 72 0d 0a 20 20 20 20 20 20 pointer..
24250 20 20 2f 2f 2f 20 69 6e 74 6f 20 61 20 6d 61 6e /// into a man
24260 61 67 65 64 20 73 74 72 69 6e 67 2e 0d 0a 20 20 aged string...
24270 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d /// </summ
24280 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
24290 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 / <param name="p
242a0 56 61 6c 75 65 22 3e 0d 0a 20 20 20 20 20 20 20 Value">..
242b0 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 /// The native
242c0 4e 55 4c 2d 74 65 72 6d 69 6e 61 74 65 64 20 55 NUL-terminated U
242d0 54 46 2d 38 20 73 74 72 69 6e 67 20 70 6f 69 6e TF-8 string poin
242e0 74 65 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ter... //
242f0 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
24300 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
24310 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
24320 68 65 20 6d 61 6e 61 67 65 64 20 73 74 72 69 6e he managed strin
24330 67 20 6f 72 20 6e 75 6c 6c 20 75 70 6f 6e 20 66 g or null upon f
24340 61 69 6c 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 ailure...
24350 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d /// </returns>.
24360 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 . public
24370 73 74 61 74 69 63 20 73 74 72 69 6e 67 20 53 74 static string St
24380 72 69 6e 67 46 72 6f 6d 55 74 66 38 49 6e 74 50 ringFromUtf8IntP
24390 74 72 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 tr(..
243a0 20 49 6e 74 50 74 72 20 70 56 61 6c 75 65 0d 0a IntPtr pValue..
243b0 20 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 )..
243c0 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
243d0 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 74 72 return Str
243e0 69 6e 67 46 72 6f 6d 55 74 66 38 49 6e 74 50 74 ingFromUtf8IntPt
243f0 72 28 70 56 61 6c 75 65 2c 0d 0a 20 20 20 20 20 r(pValue,..
24400 20 20 20 20 20 20 20 20 20 20 20 50 72 6f 62 65 Probe
24410 46 6f 72 55 74 66 38 42 79 74 65 4c 65 6e 67 74 ForUtf8ByteLengt
24420 68 28 70 56 61 6c 75 65 2c 20 54 68 69 72 74 79 h(pValue, Thirty
24430 42 69 74 73 29 29 3b 0d 0a 20 20 20 20 20 20 20 Bits));..
24440 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f }.... //
24450 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
24460 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
24470 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
24480 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
24490 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
244a0 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
244b0 20 20 20 20 20 20 20 20 2f 2f 2f 20 43 6f 6e 76 /// Conv
244c0 65 72 74 73 20 74 68 65 20 73 70 65 63 69 66 69 erts the specifi
244d0 65 64 20 6e 61 74 69 76 65 20 55 54 46 2d 38 20 ed native UTF-8
244e0 73 74 72 69 6e 67 20 70 6f 69 6e 74 65 72 20 6f string pointer o
244f0 66 20 74 68 65 20 73 70 65 63 69 66 69 65 64 0d f the specified.
24500 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6c 65 6e . /// len
24510 67 74 68 20 69 6e 74 6f 20 61 20 6d 61 6e 61 67 gth into a manag
24520 65 64 20 73 74 72 69 6e 67 2e 0d 0a 20 20 20 20 ed string...
24530 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
24540 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
24550 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 56 61 <param name="pVa
24560 6c 75 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f lue">.. /
24570 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 55 54 // The native UT
24580 46 2d 38 20 73 74 72 69 6e 67 20 70 6f 69 6e 74 F-8 string point
24590 65 72 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f er... ///
245a0 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
245b0 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
245c0 6d 65 3d 22 6c 65 6e 67 74 68 22 3e 0d 0a 20 20 me="length">..
245d0 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6c 65 /// The le
245e0 6e 67 74 68 20 6f 66 20 74 68 65 20 6e 61 74 69 ngth of the nati
245f0 76 65 20 73 74 72 69 6e 67 2c 20 69 6e 20 62 79 ve string, in by
24600 74 65 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f tes... //
24610 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
24620 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
24630 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
24640 68 65 20 6d 61 6e 61 67 65 64 20 73 74 72 69 6e he managed strin
24650 67 20 6f 72 20 6e 75 6c 6c 20 75 70 6f 6e 20 66 g or null upon f
24660 61 69 6c 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 ailure...
24670 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d /// </returns>.
24680 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 . public
24690 73 74 61 74 69 63 20 73 74 72 69 6e 67 20 53 74 static string St
246a0 72 69 6e 67 46 72 6f 6d 55 74 66 38 49 6e 74 50 ringFromUtf8IntP
246b0 74 72 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 tr(..
246c0 20 49 6e 74 50 74 72 20 70 56 61 6c 75 65 2c 0d IntPtr pValue,.
246d0 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 . int
246e0 20 6c 65 6e 67 74 68 0d 0a 20 20 20 20 20 20 20 length..
246f0 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 )..
24700 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 {.. i
24710 66 20 28 70 56 61 6c 75 65 20 3d 3d 20 49 6e 74 f (pValue == Int
24720 50 74 72 2e 5a 65 72 6f 29 0d 0a 20 20 20 20 20 Ptr.Zero)..
24730 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
24740 6e 20 6e 75 6c 6c 3b 0d 0a 0d 0a 20 20 20 20 20 n null;....
24750 20 20 20 20 20 20 20 69 66 20 28 6c 65 6e 67 74 if (lengt
24760 68 20 3e 20 30 29 0d 0a 20 20 20 20 20 20 20 20 h > 0)..
24770 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 {..
24780 20 20 20 20 20 20 20 62 79 74 65 5b 5d 20 62 79 byte[] by
24790 74 65 73 20 3d 20 6e 65 77 20 62 79 74 65 5b 6c tes = new byte[l
247a0 65 6e 67 74 68 5d 3b 0d 0a 0d 0a 20 20 20 20 20 ength];....
247b0 20 20 20 20 20 20 20 20 20 20 20 4d 61 72 73 68 Marsh
247c0 61 6c 2e 43 6f 70 79 28 70 56 61 6c 75 65 2c 20 al.Copy(pValue,
247d0 62 79 74 65 73 2c 20 30 2c 20 6c 65 6e 67 74 68 bytes, 0, length
247e0 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 );....
247f0 20 20 20 20 20 20 72 65 74 75 72 6e 20 47 65 74 return Get
24800 53 74 72 69 6e 67 46 72 6f 6d 55 74 66 38 42 79 StringFromUtf8By
24810 74 65 73 28 62 79 74 65 73 29 3b 0d 0a 20 20 20 tes(bytes);..
24820 20 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 }....
24830 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
24840 20 53 74 72 69 6e 67 2e 45 6d 70 74 79 3b 0d 0a String.Empty;..
24850 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 }....
24860 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
24870 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
24880 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
24890 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
248a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
248b0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
248c0 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
248d0 2f 2f 20 43 6f 6e 76 65 72 74 73 20 74 68 65 20 // Converts the
248e0 73 70 65 63 69 66 69 65 64 20 6d 61 6e 61 67 65 specified manage
248f0 64 20 73 74 72 69 6e 67 20 69 6e 74 6f 20 61 20 d string into a
24900 6e 61 74 69 76 65 20 4e 55 4c 2d 74 65 72 6d 69 native NUL-termi
24910 6e 61 74 65 64 0d 0a 20 20 20 20 20 20 20 20 2f nated.. /
24920 2f 2f 20 55 54 46 2d 38 20 73 74 72 69 6e 67 20 // UTF-8 string
24930 70 6f 69 6e 74 65 72 20 75 73 69 6e 67 20 6d 65 pointer using me
24940 6d 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 mory obtained fr
24950 6f 6d 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f om the SQLite co
24960 72 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 re.. ///
24970 6c 69 62 72 61 72 79 2e 0d 0a 20 20 20 20 20 20 library...
24980 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
24990 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
249a0 61 72 61 6d 20 6e 61 6d 65 3d 22 76 61 6c 75 65 aram name="value
249b0 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
249c0 54 68 65 20 6d 61 6e 61 67 65 64 20 73 74 72 69 The managed stri
249d0 6e 67 20 74 6f 20 63 6f 6e 76 65 72 74 2e 0d 0a ng to convert...
249e0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
249f0 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
24a00 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 / <returns>..
24a10 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 /// The nat
24a20 69 76 65 20 4e 55 4c 2d 74 65 72 6d 69 6e 61 74 ive NUL-terminat
24a30 65 64 20 55 54 46 2d 38 20 73 74 72 69 6e 67 20 ed UTF-8 string
24a40 70 6f 69 6e 74 65 72 20 6f 72 0d 0a 20 20 20 20 pointer or..
24a50 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 /// <see cre
24a60 66 3d 22 49 6e 74 50 74 72 2e 5a 65 72 6f 22 20 f="IntPtr.Zero"
24a70 2f 3e 20 75 70 6f 6e 20 66 61 69 6c 75 72 65 2e /> upon failure.
24a80 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
24a90 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
24aa0 20 20 70 75 62 6c 69 63 20 73 74 61 74 69 63 20 public static
24ab0 49 6e 74 50 74 72 20 55 74 66 38 49 6e 74 50 74 IntPtr Utf8IntPt
24ac0 72 46 72 6f 6d 53 74 72 69 6e 67 28 0d 0a 20 20 rFromString(..
24ad0 20 20 20 20 20 20 20 20 20 20 73 74 72 69 6e 67 string
24ae0 20 76 61 6c 75 65 0d 0a 20 20 20 20 20 20 20 20 value..
24af0 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 7b ).. {
24b00 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 .. if
24b10 20 28 76 61 6c 75 65 20 3d 3d 20 6e 75 6c 6c 29 (value == null)
24b20 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
24b30 20 20 72 65 74 75 72 6e 20 49 6e 74 50 74 72 2e return IntPtr.
24b40 5a 65 72 6f 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 Zero;....
24b50 20 20 20 20 20 49 6e 74 50 74 72 20 72 65 73 75 IntPtr resu
24b60 6c 74 20 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f lt = IntPtr.Zero
24b70 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 ;.. b
24b80 79 74 65 5b 5d 20 62 79 74 65 73 20 3d 20 47 65 yte[] bytes = Ge
24b90 74 55 74 66 38 42 79 74 65 73 46 72 6f 6d 53 74 tUtf8BytesFromSt
24ba0 72 69 6e 67 28 76 61 6c 75 65 29 3b 0d 0a 0d 0a ring(value);....
24bb0 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 if (
24bc0 62 79 74 65 73 20 3d 3d 20 6e 75 6c 6c 29 0d 0a bytes == null)..
24bd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24be0 72 65 74 75 72 6e 20 49 6e 74 50 74 72 2e 5a 65 return IntPtr.Ze
24bf0 72 6f 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 ro;....
24c00 20 20 20 69 6e 74 20 6c 65 6e 67 74 68 20 3d 20 int length =
24c10 62 79 74 65 73 2e 4c 65 6e 67 74 68 3b 0d 0a 0d bytes.Length;...
24c20 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 73 . res
24c30 75 6c 74 20 3d 20 53 51 4c 69 74 65 4d 65 6d 6f ult = SQLiteMemo
24c40 72 79 2e 41 6c 6c 6f 63 61 74 65 28 6c 65 6e 67 ry.Allocate(leng
24c50 74 68 20 2b 20 31 29 3b 0d 0a 0d 0a 20 20 20 20 th + 1);....
24c60 20 20 20 20 20 20 20 20 69 66 20 28 72 65 73 75 if (resu
24c70 6c 74 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 lt == IntPtr.Zer
24c80 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 o)..
24c90 20 20 20 20 72 65 74 75 72 6e 20 49 6e 74 50 74 return IntPt
24ca0 72 2e 5a 65 72 6f 3b 0d 0a 0d 0a 20 20 20 20 20 r.Zero;....
24cb0 20 20 20 20 20 20 20 4d 61 72 73 68 61 6c 2e 43 Marshal.C
24cc0 6f 70 79 28 62 79 74 65 73 2c 20 30 2c 20 72 65 opy(bytes, 0, re
24cd0 73 75 6c 74 2c 20 6c 65 6e 67 74 68 29 3b 0d 0a sult, length);..
24ce0 20 20 20 20 20 20 20 20 20 20 20 20 4d 61 72 73 Mars
24cf0 68 61 6c 2e 57 72 69 74 65 42 79 74 65 28 72 65 hal.WriteByte(re
24d00 73 75 6c 74 2c 20 6c 65 6e 67 74 68 2c 20 30 29 sult, length, 0)
24d10 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
24d20 20 72 65 74 75 72 6e 20 72 65 73 75 6c 74 3b 0d return result;.
24d30 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 . }..
24d40 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a #endregion..
24d50 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
24d60 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
24d70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
24d80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
24d90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
24da0 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 /.... #re
24db0 67 69 6f 6e 20 55 54 46 2d 38 20 53 74 72 69 6e gion UTF-8 Strin
24dc0 67 20 41 72 72 61 79 20 48 65 6c 70 65 72 20 4d g Array Helper M
24dd0 65 74 68 6f 64 73 0d 0a 20 20 20 20 20 20 20 20 ethods..
24de0 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
24df0 20 20 20 20 20 20 20 2f 2f 2f 20 43 6f 6e 76 65 /// Conve
24e00 72 74 73 20 61 20 6c 6f 67 69 63 61 6c 20 61 72 rts a logical ar
24e10 72 61 79 20 6f 66 20 6e 61 74 69 76 65 20 4e 55 ray of native NU
24e20 4c 2d 74 65 72 6d 69 6e 61 74 65 64 20 55 54 46 L-terminated UTF
24e30 2d 38 20 73 74 72 69 6e 67 0d 0a 20 20 20 20 20 -8 string..
24e40 20 20 20 2f 2f 2f 20 70 6f 69 6e 74 65 72 73 20 /// pointers
24e50 69 6e 74 6f 20 61 6e 20 61 72 72 61 79 20 6f 66 into an array of
24e60 20 6d 61 6e 61 67 65 64 20 73 74 72 69 6e 67 73 managed strings
24e70 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
24e80 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
24e90 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
24ea0 6d 65 3d 22 61 72 67 63 22 3e 0d 0a 20 20 20 20 me="argc">..
24eb0 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 75 6d 62 /// The numb
24ec0 65 72 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 69 er of elements i
24ed0 6e 20 74 68 65 20 6c 6f 67 69 63 61 6c 20 61 72 n the logical ar
24ee0 72 61 79 20 6f 66 20 6e 61 74 69 76 65 0d 0a 20 ray of native..
24ef0 20 20 20 20 20 20 20 2f 2f 2f 20 4e 55 4c 2d 74 /// NUL-t
24f00 65 72 6d 69 6e 61 74 65 64 20 55 54 46 2d 38 20 erminated UTF-8
24f10 73 74 72 69 6e 67 20 70 6f 69 6e 74 65 72 73 2e string pointers.
24f20 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
24f30 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
24f40 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
24f50 22 61 72 67 76 22 3e 0d 0a 20 20 20 20 20 20 20 "argv">..
24f60 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 /// The native
24f70 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6c pointer to the l
24f80 6f 67 69 63 61 6c 20 61 72 72 61 79 20 6f 66 20 ogical array of
24f90 6e 61 74 69 76 65 20 4e 55 4c 2d 74 65 72 6d 69 native NUL-termi
24fa0 6e 61 74 65 64 0d 0a 20 20 20 20 20 20 20 20 2f nated.. /
24fb0 2f 2f 20 55 54 46 2d 38 20 73 74 72 69 6e 67 20 // UTF-8 string
24fc0 70 6f 69 6e 74 65 72 73 20 74 6f 20 63 6f 6e 76 pointers to conv
24fd0 65 72 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ert... //
24fe0 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
24ff0 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
25000 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
25010 68 65 20 61 72 72 61 79 20 6f 66 20 6d 61 6e 61 he array of mana
25020 67 65 64 20 73 74 72 69 6e 67 73 20 6f 72 20 6e ged strings or n
25030 75 6c 6c 20 75 70 6f 6e 20 66 61 69 6c 75 72 65 ull upon failure
25040 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
25050 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 /returns>..
25060 20 20 20 70 75 62 6c 69 63 20 73 74 61 74 69 63 public static
25070 20 73 74 72 69 6e 67 5b 5d 20 53 74 72 69 6e 67 string[] String
25080 41 72 72 61 79 46 72 6f 6d 55 74 66 38 53 69 7a ArrayFromUtf8Siz
25090 65 41 6e 64 49 6e 74 50 74 72 28 0d 0a 20 20 20 eAndIntPtr(..
250a0 20 20 20 20 20 20 20 20 20 69 6e 74 20 61 72 67 int arg
250b0 63 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 c,..
250c0 49 6e 74 50 74 72 20 61 72 67 76 0d 0a 20 20 20 IntPtr argv..
250d0 20 20 20 20 20 20 20 20 20 29 0d 0a 20 20 20 20 )..
250e0 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 {..
250f0 20 20 20 69 66 20 28 61 72 67 63 20 3c 20 30 29 if (argc < 0)
25100 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
25110 20 20 72 65 74 75 72 6e 20 6e 75 6c 6c 3b 0d 0a return null;..
25120 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 .. if
25130 20 28 61 72 67 76 20 3d 3d 20 49 6e 74 50 74 72 (argv == IntPtr
25140 2e 5a 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 .Zero)..
25150 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6e return n
25160 75 6c 6c 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ull;....
25170 20 20 20 20 73 74 72 69 6e 67 5b 5d 20 72 65 73 string[] res
25180 75 6c 74 20 3d 20 6e 65 77 20 73 74 72 69 6e 67 ult = new string
25190 5b 61 72 67 63 5d 3b 0d 0a 0d 0a 20 20 20 20 20 [argc];....
251a0 20 20 20 20 20 20 20 66 6f 72 20 28 69 6e 74 20 for (int
251b0 69 6e 64 65 78 20 3d 20 30 2c 20 6f 66 66 73 65 index = 0, offse
251c0 74 20 3d 20 30 3b 0d 0a 20 20 20 20 20 20 20 20 t = 0;..
251d0 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 64 65 inde
251e0 78 20 3c 20 72 65 73 75 6c 74 2e 4c 65 6e 67 74 x < result.Lengt
251f0 68 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 h;..
25200 20 20 20 20 20 20 20 20 69 6e 64 65 78 2b 2b 2c index++,
25210 20 6f 66 66 73 65 74 20 2b 3d 20 49 6e 74 50 74 offset += IntPt
25220 72 2e 53 69 7a 65 29 0d 0a 20 20 20 20 20 20 20 r.Size)..
25230 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
25240 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 IntPtr p
25250 41 72 67 20 3d 20 53 51 4c 69 74 65 4d 61 72 73 Arg = SQLiteMars
25260 68 61 6c 2e 52 65 61 64 49 6e 74 50 74 72 28 61 hal.ReadIntPtr(a
25270 72 67 76 2c 20 6f 66 66 73 65 74 29 3b 0d 0a 0d rgv, offset);...
25280 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
25290 20 72 65 73 75 6c 74 5b 69 6e 64 65 78 5d 20 3d result[index] =
252a0 20 28 70 41 72 67 20 21 3d 20 49 6e 74 50 74 72 (pArg != IntPtr
252b0 2e 5a 65 72 6f 29 20 3f 0d 0a 20 20 20 20 20 20 .Zero) ?..
252c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 74 St
252d0 72 69 6e 67 46 72 6f 6d 55 74 66 38 49 6e 74 50 ringFromUtf8IntP
252e0 74 72 28 70 41 72 67 29 20 3a 20 6e 75 6c 6c 3b tr(pArg) : null;
252f0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d .. }.
25300 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 ... r
25310 65 74 75 72 6e 20 72 65 73 75 6c 74 3b 0d 0a 20 eturn result;..
25320 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 }....
25330 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
25340 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25350 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25360 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25370 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
25380 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
25390 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
253a0 2f 20 43 6f 6e 76 65 72 74 73 20 61 6e 20 61 72 / Converts an ar
253b0 72 61 79 20 6f 66 20 6d 61 6e 61 67 65 64 20 73 ray of managed s
253c0 74 72 69 6e 67 73 20 69 6e 74 6f 20 61 6e 20 61 trings into an a
253d0 72 72 61 79 20 6f 66 20 6e 61 74 69 76 65 0d 0a rray of native..
253e0 20 20 20 20 20 20 20 20 2f 2f 2f 20 4e 55 4c 2d /// NUL-
253f0 74 65 72 6d 69 6e 61 74 65 64 20 55 54 46 2d 38 terminated UTF-8
25400 20 73 74 72 69 6e 67 20 70 6f 69 6e 74 65 72 73 string pointers
25410 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
25420 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
25430 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
25440 6d 65 3d 22 76 61 6c 75 65 73 22 3e 0d 0a 20 20 me="values">..
25450 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 61 72 /// The ar
25460 72 61 79 20 6f 66 20 6d 61 6e 61 67 65 64 20 73 ray of managed s
25470 74 72 69 6e 67 73 20 74 6f 20 63 6f 6e 76 65 72 trings to conver
25480 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 t... ///
25490 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
254a0 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d /// <returns>.
254b0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
254c0 20 61 72 72 61 79 20 6f 66 20 6e 61 74 69 76 65 array of native
254d0 20 4e 55 4c 2d 74 65 72 6d 69 6e 61 74 65 64 20 NUL-terminated
254e0 55 54 46 2d 38 20 73 74 72 69 6e 67 20 70 6f 69 UTF-8 string poi
254f0 6e 74 65 72 73 20 6f 72 20 6e 75 6c 6c 0d 0a 20 nters or null..
25500 20 20 20 20 20 20 20 2f 2f 2f 20 75 70 6f 6e 20 /// upon
25510 66 61 69 6c 75 72 65 2e 0d 0a 20 20 20 20 20 20 failure...
25520 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e /// </returns>
25530 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 .. public
25540 20 73 74 61 74 69 63 20 49 6e 74 50 74 72 5b 5d static IntPtr[]
25550 20 55 74 66 38 49 6e 74 50 74 72 41 72 72 61 79 Utf8IntPtrArray
25560 46 72 6f 6d 53 74 72 69 6e 67 41 72 72 61 79 28 FromStringArray(
25570 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 74 .. st
25580 72 69 6e 67 5b 5d 20 76 61 6c 75 65 73 0d 0a 20 ring[] values..
25590 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 20 )..
255a0 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
255b0 20 20 20 20 20 69 66 20 28 76 61 6c 75 65 73 20 if (values
255c0 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 20 == null)..
255d0 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
255e0 20 6e 75 6c 6c 3b 0d 0a 0d 0a 20 20 20 20 20 20 null;....
255f0 20 20 20 20 20 20 49 6e 74 50 74 72 5b 5d 20 72 IntPtr[] r
25600 65 73 75 6c 74 20 3d 20 6e 65 77 20 49 6e 74 50 esult = new IntP
25610 74 72 5b 76 61 6c 75 65 73 2e 4c 65 6e 67 74 68 tr[values.Length
25620 5d 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 ];....
25630 20 20 66 6f 72 20 28 69 6e 74 20 69 6e 64 65 78 for (int index
25640 20 3d 20 30 3b 20 69 6e 64 65 78 20 3c 20 72 65 = 0; index < re
25650 73 75 6c 74 2e 4c 65 6e 67 74 68 3b 20 69 6e 64 sult.Length; ind
25660 65 78 2b 2b 29 0d 0a 20 20 20 20 20 20 20 20 20 ex++)..
25670 20 20 20 20 20 20 20 72 65 73 75 6c 74 5b 69 6e result[in
25680 64 65 78 5d 20 3d 20 55 74 66 38 49 6e 74 50 74 dex] = Utf8IntPt
25690 72 46 72 6f 6d 53 74 72 69 6e 67 28 76 61 6c 75 rFromString(valu
256a0 65 73 5b 69 6e 64 65 78 5d 29 3b 0d 0a 0d 0a 20 es[index]);....
256b0 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
256c0 6e 20 72 65 73 75 6c 74 3b 0d 0a 20 20 20 20 20 n result;..
256d0 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 65 }.. #e
256e0 6e 64 72 65 67 69 6f 6e 0d 0a 20 20 20 20 7d 0d ndregion.. }.
256f0 0a 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d . #endregion.
25700 0a 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f ... /////////
25710 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25720 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25730 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25740 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25750 2f 2f 0d 0a 0d 0a 20 20 20 20 23 72 65 67 69 6f //.... #regio
25760 6e 20 53 51 4c 69 74 65 42 79 74 65 73 20 53 74 n SQLiteBytes St
25770 61 74 69 63 20 43 6c 61 73 73 0d 0a 20 20 20 20 atic Class..
25780 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
25790 20 20 20 2f 2f 2f 20 54 68 69 73 20 63 6c 61 73 /// This clas
257a0 73 20 63 6f 6e 74 61 69 6e 73 20 73 74 61 74 69 s contains stati
257b0 63 20 6d 65 74 68 6f 64 73 20 74 68 61 74 20 61 c methods that a
257c0 72 65 20 75 73 65 64 20 74 6f 20 64 65 61 6c 20 re used to deal
257d0 77 69 74 68 20 6e 61 74 69 76 65 0d 0a 20 20 20 with native..
257e0 20 2f 2f 2f 20 70 6f 69 6e 74 65 72 73 20 74 6f /// pointers to
257f0 20 6d 65 6d 6f 72 79 20 62 6c 6f 63 6b 73 20 74 memory blocks t
25800 68 61 74 20 6c 6f 67 69 63 61 6c 6c 79 20 63 6f hat logically co
25810 6e 74 61 69 6e 20 61 72 72 61 79 73 20 6f 66 20 ntain arrays of
25820 62 79 74 65 73 20 74 6f 20 62 65 0d 0a 20 20 20 bytes to be..
25830 20 2f 2f 2f 20 75 73 65 64 20 77 69 74 68 20 74 /// used with t
25840 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6c he SQLite core l
25850 69 62 72 61 72 79 2e 0d 0a 20 20 20 20 2f 2f 2f ibrary... ///
25860 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
25870 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 69 63 internal static
25880 20 63 6c 61 73 73 20 53 51 4c 69 74 65 42 79 74 class SQLiteByt
25890 65 73 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20 es.. {..
258a0 20 20 20 23 72 65 67 69 6f 6e 20 42 79 74 65 20 #region Byte
258b0 41 72 72 61 79 20 48 65 6c 70 65 72 20 4d 65 74 Array Helper Met
258c0 68 6f 64 73 0d 0a 20 20 20 20 20 20 20 20 2f 2f hods.. //
258d0 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 / <summary>..
258e0 20 20 20 20 20 2f 2f 2f 20 43 6f 6e 76 65 72 74 /// Convert
258f0 73 20 61 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 s a native point
25900 65 72 20 74 6f 20 61 20 6c 6f 67 69 63 61 6c 20 er to a logical
25910 61 72 72 61 79 20 6f 66 20 62 79 74 65 73 20 6f array of bytes o
25920 66 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f f the.. /
25930 2f 2f 20 73 70 65 63 69 66 69 65 64 20 6c 65 6e // specified len
25940 67 74 68 20 69 6e 74 6f 20 61 20 6d 61 6e 61 67 gth into a manag
25950 65 64 20 62 79 74 65 20 61 72 72 61 79 2e 0d 0a ed byte array...
25960 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
25970 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
25980 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
25990 22 70 56 61 6c 75 65 22 3e 0d 0a 20 20 20 20 20 "pValue">..
259a0 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 /// The nativ
259b0 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 e pointer to the
259c0 20 6c 6f 67 69 63 61 6c 20 61 72 72 61 79 20 6f logical array o
259d0 66 20 62 79 74 65 73 20 74 6f 20 63 6f 6e 76 65 f bytes to conve
259e0 72 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f rt... ///
259f0 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
25a00 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
25a10 6d 65 3d 22 6c 65 6e 67 74 68 22 3e 0d 0a 20 20 me="length">..
25a20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6c 65 /// The le
25a30 6e 67 74 68 2c 20 69 6e 20 62 79 74 65 73 2c 20 ngth, in bytes,
25a40 6f 66 20 74 68 65 20 6c 6f 67 69 63 61 6c 20 61 of the logical a
25a50 72 72 61 79 20 6f 66 20 62 79 74 65 73 20 74 6f rray of bytes to
25a60 20 63 6f 6e 76 65 72 74 2e 0d 0a 20 20 20 20 20 convert...
25a70 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
25a80 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 . /// <re
25a90 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
25aa0 2f 2f 2f 20 54 68 65 20 6d 61 6e 61 67 65 64 20 /// The managed
25ab0 62 79 74 65 20 61 72 72 61 79 20 6f 72 20 6e 75 byte array or nu
25ac0 6c 6c 20 75 70 6f 6e 20 66 61 69 6c 75 72 65 2e ll upon failure.
25ad0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
25ae0 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
25af0 20 20 70 75 62 6c 69 63 20 73 74 61 74 69 63 20 public static
25b00 62 79 74 65 5b 5d 20 46 72 6f 6d 49 6e 74 50 74 byte[] FromIntPt
25b10 72 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 r(..
25b20 49 6e 74 50 74 72 20 70 56 61 6c 75 65 2c 0d 0a IntPtr pValue,..
25b30 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 int
25b40 6c 65 6e 67 74 68 0d 0a 20 20 20 20 20 20 20 20 length..
25b50 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 7b ).. {
25b60 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 .. if
25b70 20 28 70 56 61 6c 75 65 20 3d 3d 20 49 6e 74 50 (pValue == IntP
25b80 74 72 2e 5a 65 72 6f 29 0d 0a 20 20 20 20 20 20 tr.Zero)..
25b90 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
25ba0 20 6e 75 6c 6c 3b 0d 0a 0d 0a 20 20 20 20 20 20 null;....
25bb0 20 20 20 20 20 20 69 66 20 28 6c 65 6e 67 74 68 if (length
25bc0 20 3d 3d 20 30 29 0d 0a 20 20 20 20 20 20 20 20 == 0)..
25bd0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6e return n
25be0 65 77 20 62 79 74 65 5b 30 5d 3b 0d 0a 0d 0a 20 ew byte[0];....
25bf0 20 20 20 20 20 20 20 20 20 20 20 62 79 74 65 5b byte[
25c00 5d 20 72 65 73 75 6c 74 20 3d 20 6e 65 77 20 62 ] result = new b
25c10 79 74 65 5b 6c 65 6e 67 74 68 5d 3b 0d 0a 0d 0a yte[length];....
25c20 20 20 20 20 20 20 20 20 20 20 20 20 4d 61 72 73 Mars
25c30 68 61 6c 2e 43 6f 70 79 28 70 56 61 6c 75 65 2c hal.Copy(pValue,
25c40 20 72 65 73 75 6c 74 2c 20 30 2c 20 6c 65 6e 67 result, 0, leng
25c50 74 68 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 th);....
25c60 20 20 20 20 72 65 74 75 72 6e 20 72 65 73 75 6c return resul
25c70 74 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d t;.. }...
25c80 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
25c90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25ca0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25cb0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25cc0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
25cd0 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 .... ///
25ce0 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
25cf0 20 20 20 2f 2f 2f 20 43 6f 6e 76 65 72 74 73 20 /// Converts
25d00 61 20 6d 61 6e 61 67 65 64 20 62 79 74 65 20 61 a managed byte a
25d10 72 72 61 79 20 69 6e 74 6f 20 61 20 6e 61 74 69 rray into a nati
25d20 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 ve pointer to a
25d30 6c 6f 67 69 63 61 6c 0d 0a 20 20 20 20 20 20 20 logical..
25d40 20 2f 2f 2f 20 61 72 72 61 79 20 6f 66 20 62 79 /// array of by
25d50 74 65 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f tes... //
25d60 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 / </summary>..
25d70 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
25d80 20 6e 61 6d 65 3d 22 76 61 6c 75 65 22 3e 0d 0a name="value">..
25d90 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
25da0 6d 61 6e 61 67 65 64 20 62 79 74 65 20 61 72 72 managed byte arr
25db0 61 79 20 74 6f 20 63 6f 6e 76 65 72 74 2e 0d 0a ay to convert...
25dc0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
25dd0 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
25de0 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 / <returns>..
25df0 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 /// The nat
25e00 69 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 ive pointer to a
25e10 20 6c 6f 67 69 63 61 6c 20 62 79 74 65 20 61 72 logical byte ar
25e20 72 61 79 20 6f 72 20 6e 75 6c 6c 20 75 70 6f 6e ray or null upon
25e30 20 66 61 69 6c 75 72 65 2e 0d 0a 20 20 20 20 20 failure...
25e40 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 /// </returns
25e50 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 >.. publi
25e60 63 20 73 74 61 74 69 63 20 49 6e 74 50 74 72 20 c static IntPtr
25e70 54 6f 49 6e 74 50 74 72 28 0d 0a 20 20 20 20 20 ToIntPtr(..
25e80 20 20 20 20 20 20 20 62 79 74 65 5b 5d 20 76 61 byte[] va
25e90 6c 75 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 lue..
25ea0 20 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 ).. {..
25eb0 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 76 if (v
25ec0 61 6c 75 65 20 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 alue == null)..
25ed0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 r
25ee0 65 74 75 72 6e 20 49 6e 74 50 74 72 2e 5a 65 72 eturn IntPtr.Zer
25ef0 6f 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 o;....
25f00 20 20 69 6e 74 20 6c 65 6e 67 74 68 20 3d 20 76 int length = v
25f10 61 6c 75 65 2e 4c 65 6e 67 74 68 3b 0d 0a 0d 0a alue.Length;....
25f20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 if (
25f30 6c 65 6e 67 74 68 20 3d 3d 20 30 29 0d 0a 20 20 length == 0)..
25f40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
25f50 74 75 72 6e 20 49 6e 74 50 74 72 2e 5a 65 72 6f turn IntPtr.Zero
25f60 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
25f70 20 49 6e 74 50 74 72 20 72 65 73 75 6c 74 20 3d IntPtr result =
25f80 20 53 51 4c 69 74 65 4d 65 6d 6f 72 79 2e 41 6c SQLiteMemory.Al
25f90 6c 6f 63 61 74 65 28 6c 65 6e 67 74 68 29 3b 0d locate(length);.
25fa0 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 ... i
25fb0 66 20 28 72 65 73 75 6c 74 20 3d 3d 20 49 6e 74 f (result == Int
25fc0 50 74 72 2e 5a 65 72 6f 29 0d 0a 20 20 20 20 20 Ptr.Zero)..
25fd0 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
25fe0 6e 20 49 6e 74 50 74 72 2e 5a 65 72 6f 3b 0d 0a n IntPtr.Zero;..
25ff0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4d 61 .. Ma
26000 72 73 68 61 6c 2e 43 6f 70 79 28 76 61 6c 75 65 rshal.Copy(value
26010 2c 20 30 2c 20 72 65 73 75 6c 74 2c 20 6c 65 6e , 0, result, len
26020 67 74 68 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 gth);....
26030 20 20 20 20 20 72 65 74 75 72 6e 20 72 65 73 75 return resu
26040 6c 74 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a lt;.. }..
26050 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 #endregi
26060 6f 6e 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 on.. }.. #
26070 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 endregion....
26080 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
26090 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
260a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
260b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
260c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
260d0 20 20 20 20 23 72 65 67 69 6f 6e 20 53 51 4c 69 #region SQLi
260e0 74 65 4d 61 72 73 68 61 6c 20 53 74 61 74 69 63 teMarshal Static
260f0 20 43 6c 61 73 73 0d 0a 20 20 20 20 69 6e 74 65 Class.. inte
26100 72 6e 61 6c 20 73 74 61 74 69 63 20 63 6c 61 73 rnal static clas
26110 73 20 53 51 4c 69 74 65 4d 61 72 73 68 61 6c 0d s SQLiteMarshal.
26120 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 . {..
26130 23 72 65 67 69 6f 6e 20 49 6e 74 50 74 72 20 48 #region IntPtr H
26140 65 6c 70 65 72 20 4d 65 74 68 6f 64 73 0d 0a 20 elper Methods..
26150 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
26160 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
26170 2f 20 52 65 74 75 72 6e 73 20 61 20 6e 65 77 20 / Returns a new
26180 3c 73 65 65 20 63 72 65 66 3d 22 49 6e 74 50 74 <see cref="IntPt
26190 72 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 r" /> object ins
261a0 74 61 6e 63 65 20 62 61 73 65 64 20 6f 6e 20 74 tance based on t
261b0 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 he.. ///
261c0 73 70 65 63 69 66 69 65 64 20 3c 73 65 65 20 63 specified <see c
261d0 72 65 66 3d 22 49 6e 74 50 74 72 22 20 2f 3e 20 ref="IntPtr" />
261e0 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 object instance
261f0 61 6e 64 20 61 6e 20 69 6e 74 65 67 65 72 0d 0a and an integer..
26200 20 20 20 20 20 20 20 20 2f 2f 2f 20 6f 66 66 73 /// offs
26210 65 74 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f et... ///
26220 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
26230 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
26240 6e 61 6d 65 3d 22 70 6f 69 6e 74 65 72 22 3e 0d name="pointer">.
26250 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
26260 20 3c 73 65 65 20 63 72 65 66 3d 22 49 6e 74 50 <see cref="IntP
26270 74 72 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e tr" /> object in
26280 73 74 61 6e 63 65 20 72 65 70 72 65 73 65 6e 74 stance represent
26290 69 6e 67 20 74 68 65 20 62 61 73 65 0d 0a 20 20 ing the base..
262a0 20 20 20 20 20 20 2f 2f 2f 20 6d 65 6d 6f 72 79 /// memory
262b0 20 6c 6f 63 61 74 69 6f 6e 2e 0d 0a 20 20 20 20 location...
262c0 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
262d0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
262e0 61 72 61 6d 20 6e 61 6d 65 3d 22 6f 66 66 73 65 aram name="offse
262f0 74 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f t">.. ///
26300 20 54 68 65 20 69 6e 74 65 67 65 72 20 6f 66 66 The integer off
26310 73 65 74 20 66 72 6f 6d 20 74 68 65 20 62 61 73 set from the bas
26320 65 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f e memory locatio
26330 6e 20 74 68 61 74 20 74 68 65 20 6e 65 77 0d 0a n that the new..
26340 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 /// <see
26350 20 63 72 65 66 3d 22 49 6e 74 50 74 72 22 20 2f cref="IntPtr" /
26360 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 > object instanc
26370 65 20 73 68 6f 75 6c 64 20 70 6f 69 6e 74 20 74 e should point t
26380 6f 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 o... ///
26390 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
263a0 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d /// <returns>.
263b0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
263c0 20 6e 65 77 20 3c 73 65 65 20 63 72 65 66 3d 22 new <see cref="
263d0 49 6e 74 50 74 72 22 20 2f 3e 20 6f 62 6a 65 63 IntPtr" /> objec
263e0 74 20 69 6e 73 74 61 6e 63 65 2e 0d 0a 20 20 20 t instance...
263f0 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 /// </retur
26400 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 ns>.. pub
26410 6c 69 63 20 73 74 61 74 69 63 20 49 6e 74 50 74 lic static IntPt
26420 72 20 49 6e 74 50 74 72 46 6f 72 4f 66 66 73 65 r IntPtrForOffse
26430 74 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 t(..
26440 49 6e 74 50 74 72 20 70 6f 69 6e 74 65 72 2c 0d IntPtr pointer,.
26450 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 . int
26460 20 6f 66 66 73 65 74 0d 0a 20 20 20 20 20 20 20 offset..
26470 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 )..
26480 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 {.. r
26490 65 74 75 72 6e 20 6e 65 77 20 49 6e 74 50 74 72 eturn new IntPtr
264a0 28 70 6f 69 6e 74 65 72 2e 54 6f 49 6e 74 36 34 (pointer.ToInt64
264b0 28 29 20 2b 20 6f 66 66 73 65 74 29 3b 0d 0a 20 () + offset);..
264c0 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 }....
264d0 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
264e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
264f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26500 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26510 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
26520 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
26530 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
26540 2f 20 44 65 74 65 72 6d 69 6e 65 73 20 74 68 65 / Determines the
26550 20 73 69 7a 65 20 6f 66 20 61 20 3c 73 65 65 20 size of a <see
26560 63 72 65 66 3d 22 49 6e 74 33 32 22 20 2f 3e 20 cref="Int32" />
26570 77 68 65 6e 20 69 74 20 72 65 73 69 64 65 73 0d when it resides.
26580 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6e 73 . /// ins
26590 69 64 65 20 6f 66 20 61 20 6e 61 74 69 76 65 20 ide of a native
265a0 73 74 72 75 63 74 75 72 65 2e 0d 0a 20 20 20 20 structure...
265b0 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
265c0 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
265d0 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 <returns>..
265e0 20 20 20 2f 2f 2f 20 54 68 65 20 73 69 7a 65 20 /// The size
265f0 6f 66 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 of the <see cref
26600 3d 22 49 6e 74 33 32 22 20 2f 3e 20 74 79 70 65 ="Int32" /> type
26610 2c 20 69 6e 20 62 79 74 65 73 2c 20 77 68 65 6e , in bytes, when
26620 20 69 74 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f it.. ///
26630 20 72 65 73 69 64 65 73 20 69 6e 73 69 64 65 20 resides inside
26640 61 20 6e 61 74 69 76 65 20 73 74 72 75 63 74 75 a native structu
26650 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f re... ///
26660 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 </returns>..
26670 20 20 20 20 20 70 75 62 6c 69 63 20 73 74 61 74 public stat
26680 69 63 20 69 6e 74 20 53 69 7a 65 4f 66 53 74 72 ic int SizeOfStr
26690 75 63 74 49 6e 74 28 29 0d 0a 20 20 20 20 20 20 uctInt()..
266a0 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
266b0 20 72 65 74 75 72 6e 20 49 6e 74 50 74 72 2e 53 return IntPtr.S
266c0 69 7a 65 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d ize;.. }.
266d0 0a 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 . #endreg
266e0 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ion.... /
266f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26700 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26710 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26720 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26730 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
26740 20 20 23 72 65 67 69 6f 6e 20 4d 61 72 73 68 61 #region Marsha
26750 6c 20 52 65 61 64 20 48 65 6c 70 65 72 20 4d 65 l Read Helper Me
26760 74 68 6f 64 73 0d 0a 20 20 20 20 20 20 20 20 2f thods.. /
26770 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
26780 20 20 20 20 20 20 2f 2f 2f 20 52 65 61 64 73 20 /// Reads
26790 61 20 3c 73 65 65 20 63 72 65 66 3d 22 49 6e 74 a <see cref="Int
267a0 33 32 22 20 2f 3e 20 76 61 6c 75 65 20 66 72 6f 32" /> value fro
267b0 6d 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 m the specified
267c0 6d 65 6d 6f 72 79 0d 0a 20 20 20 20 20 20 20 20 memory..
267d0 2f 2f 2f 20 6c 6f 63 61 74 69 6f 6e 2e 0d 0a 20 /// location...
267e0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
267f0 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
26800 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
26810 70 6f 69 6e 74 65 72 22 3e 0d 0a 20 20 20 20 20 pointer">..
26820 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 /// The <see
26830 63 72 65 66 3d 22 49 6e 74 50 74 72 22 20 2f 3e cref="IntPtr" />
26840 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 object instance
26850 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 representing th
26860 65 20 62 61 73 65 0d 0a 20 20 20 20 20 20 20 20 e base..
26870 2f 2f 2f 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 /// memory locat
26880 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ion... //
26890 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
268a0 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
268b0 61 6d 65 3d 22 6f 66 66 73 65 74 22 3e 0d 0a 20 ame="offset">..
268c0 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 69 /// The i
268d0 6e 74 65 67 65 72 20 6f 66 66 73 65 74 20 66 72 nteger offset fr
268e0 6f 6d 20 74 68 65 20 62 61 73 65 20 6d 65 6d 6f om the base memo
268f0 72 79 20 6c 6f 63 61 74 69 6f 6e 20 77 68 65 72 ry location wher
26900 65 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f e the.. /
26910 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 49 6e // <see cref="In
26920 74 33 32 22 20 2f 3e 20 76 61 6c 75 65 20 74 6f t32" /> value to
26930 20 62 65 20 72 65 61 64 20 69 73 20 6c 6f 63 61 be read is loca
26940 74 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ted... //
26950 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
26960 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
26970 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
26980 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 6e he <see cref="In
26990 74 33 32 22 20 2f 3e 20 76 61 6c 75 65 20 61 74 t32" /> value at
269a0 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 6d the specified m
269b0 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f 6e 2e 0d emory location..
269c0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 . /// </r
269d0 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 eturns>..
269e0 20 70 75 62 6c 69 63 20 73 74 61 74 69 63 20 69 public static i
269f0 6e 74 20 52 65 61 64 49 6e 74 33 32 28 0d 0a 20 nt ReadInt32(..
26a00 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 IntPt
26a10 72 20 70 6f 69 6e 74 65 72 2c 0d 0a 20 20 20 20 r pointer,..
26a20 20 20 20 20 20 20 20 20 69 6e 74 20 6f 66 66 73 int offs
26a30 65 74 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 et..
26a40 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 23 69 ).. {..#i
26a50 66 20 21 50 4c 41 54 46 4f 52 4d 5f 43 4f 4d 50 f !PLATFORM_COMP
26a60 41 43 54 46 52 41 4d 45 57 4f 52 4b 0d 0a 20 20 ACTFRAMEWORK..
26a70 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
26a80 20 4d 61 72 73 68 61 6c 2e 52 65 61 64 49 6e 74 Marshal.ReadInt
26a90 33 32 28 70 6f 69 6e 74 65 72 2c 20 6f 66 66 73 32(pointer, offs
26aa0 65 74 29 3b 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 et);..#else..
26ab0 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 return
26ac0 4d 61 72 73 68 61 6c 2e 52 65 61 64 49 6e 74 33 Marshal.ReadInt3
26ad0 32 28 49 6e 74 50 74 72 46 6f 72 4f 66 66 73 65 2(IntPtrForOffse
26ae0 74 28 70 6f 69 6e 74 65 72 2c 20 6f 66 66 73 65 t(pointer, offse
26af0 74 29 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 t));..#endif..
26b00 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 }....
26b10 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
26b20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26b30 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26b40 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26b50 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
26b60 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
26b70 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
26b80 20 52 65 61 64 73 20 61 20 3c 73 65 65 20 63 72 Reads a <see cr
26b90 65 66 3d 22 44 6f 75 62 6c 65 22 20 2f 3e 20 76 ef="Double" /> v
26ba0 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 73 70 alue from the sp
26bb0 65 63 69 66 69 65 64 20 6d 65 6d 6f 72 79 0d 0a ecified memory..
26bc0 20 20 20 20 20 20 20 20 2f 2f 2f 20 6c 6f 63 61 /// loca
26bd0 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f tion... /
26be0 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
26bf0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
26c00 6d 20 6e 61 6d 65 3d 22 70 6f 69 6e 74 65 72 22 m name="pointer"
26c10 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
26c20 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 6e he <see cref="In
26c30 74 50 74 72 22 20 2f 3e 20 6f 62 6a 65 63 74 20 tPtr" /> object
26c40 69 6e 73 74 61 6e 63 65 20 72 65 70 72 65 73 65 instance represe
26c50 6e 74 69 6e 67 20 74 68 65 20 62 61 73 65 0d 0a nting the base..
26c60 20 20 20 20 20 20 20 20 2f 2f 2f 20 6d 65 6d 6f /// memo
26c70 72 79 20 6c 6f 63 61 74 69 6f 6e 2e 0d 0a 20 20 ry location...
26c80 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
26c90 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
26ca0 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6f 66 66 <param name="off
26cb0 73 65 74 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f set">.. /
26cc0 2f 2f 20 54 68 65 20 69 6e 74 65 67 65 72 20 6f // The integer o
26cd0 66 66 73 65 74 20 66 72 6f 6d 20 74 68 65 20 62 ffset from the b
26ce0 61 73 65 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 ase memory locat
26cf0 69 6f 6e 20 77 68 65 72 65 20 74 68 65 0d 0a 20 ion where the..
26d00 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 /// <see
26d10 63 72 65 66 3d 22 44 6f 75 62 6c 65 22 20 2f 3e cref="Double" />
26d20 20 74 6f 20 62 65 20 72 65 61 64 20 69 73 20 6c to be read is l
26d30 6f 63 61 74 65 64 2e 0d 0a 20 20 20 20 20 20 20 ocated...
26d40 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
26d50 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 /// <retu
26d60 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f rns>.. //
26d70 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d / The <see cref=
26d80 22 44 6f 75 62 6c 65 22 20 2f 3e 20 76 61 6c 75 "Double" /> valu
26d90 65 20 61 74 20 74 68 65 20 73 70 65 63 69 66 69 e at the specifi
26da0 65 64 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 ed memory locati
26db0 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f on... ///
26dc0 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 </returns>..
26dd0 20 20 20 20 20 70 75 62 6c 69 63 20 73 74 61 74 public stat
26de0 69 63 20 64 6f 75 62 6c 65 20 52 65 61 64 44 6f ic double ReadDo
26df0 75 62 6c 65 28 0d 0a 20 20 20 20 20 20 20 20 20 uble(..
26e00 20 20 20 49 6e 74 50 74 72 20 70 6f 69 6e 74 65 IntPtr pointe
26e10 72 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 r,..
26e20 69 6e 74 20 6f 66 66 73 65 74 0d 0a 20 20 20 20 int offset..
26e30 20 20 20 20 20 20 20 20 29 0d 0a 20 20 20 20 20 )..
26e40 20 20 20 7b 0d 0a 23 69 66 20 21 50 4c 41 54 46 {..#if !PLATF
26e50 4f 52 4d 5f 43 4f 4d 50 41 43 54 46 52 41 4d 45 ORM_COMPACTFRAME
26e60 57 4f 52 4b 0d 0a 20 20 20 20 20 20 20 20 20 20 WORK..
26e70 20 20 72 65 74 75 72 6e 20 42 69 74 43 6f 6e 76 return BitConv
26e80 65 72 74 65 72 2e 49 6e 74 36 34 42 69 74 73 54 erter.Int64BitsT
26e90 6f 44 6f 75 62 6c 65 28 4d 61 72 73 68 61 6c 2e oDouble(Marshal.
26ea0 52 65 61 64 49 6e 74 36 34 28 0d 0a 20 20 20 20 ReadInt64(..
26eb0 20 20 20 20 20 20 20 20 20 20 20 20 70 6f 69 6e poin
26ec0 74 65 72 2c 20 6f 66 66 73 65 74 29 29 3b 0d 0a ter, offset));..
26ed0 23 65 6c 73 65 0d 0a 20 20 20 20 20 20 20 20 20 #else..
26ee0 20 20 20 72 65 74 75 72 6e 20 42 69 74 43 6f 6e return BitCon
26ef0 76 65 72 74 65 72 2e 54 6f 44 6f 75 62 6c 65 28 verter.ToDouble(
26f00 42 69 74 43 6f 6e 76 65 72 74 65 72 2e 47 65 74 BitConverter.Get
26f10 42 79 74 65 73 28 0d 0a 20 20 20 20 20 20 20 20 Bytes(..
26f20 20 20 20 20 20 20 20 20 4d 61 72 73 68 61 6c 2e Marshal.
26f30 52 65 61 64 49 6e 74 36 34 28 49 6e 74 50 74 72 ReadInt64(IntPtr
26f40 46 6f 72 4f 66 66 73 65 74 28 70 6f 69 6e 74 65 ForOffset(pointe
26f50 72 2c 20 6f 66 66 73 65 74 29 29 29 2c 20 30 29 r, offset))), 0)
26f60 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 ;..#endif..
26f70 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 }....
26f80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26f90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26fa0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26fb0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
26fc0 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
26fd0 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
26fe0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 52 65 .. /// Re
26ff0 61 64 73 20 61 6e 20 3c 73 65 65 20 63 72 65 66 ads an <see cref
27000 3d 22 49 6e 74 50 74 72 22 20 2f 3e 20 76 61 6c ="IntPtr" /> val
27010 75 65 20 66 72 6f 6d 20 74 68 65 20 73 70 65 63 ue from the spec
27020 69 66 69 65 64 20 6d 65 6d 6f 72 79 0d 0a 20 20 ified memory..
27030 20 20 20 20 20 20 2f 2f 2f 20 6c 6f 63 61 74 69 /// locati
27040 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f on... ///
27050 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
27060 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
27070 6e 61 6d 65 3d 22 70 6f 69 6e 74 65 72 22 3e 0d name="pointer">.
27080 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 . /// The
27090 20 3c 73 65 65 20 63 72 65 66 3d 22 49 6e 74 50 <see cref="IntP
270a0 74 72 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e tr" /> object in
270b0 73 74 61 6e 63 65 20 72 65 70 72 65 73 65 6e 74 stance represent
270c0 69 6e 67 20 74 68 65 20 62 61 73 65 0d 0a 20 20 ing the base..
270d0 20 20 20 20 20 20 2f 2f 2f 20 6d 65 6d 6f 72 79 /// memory
270e0 20 6c 6f 63 61 74 69 6f 6e 2e 0d 0a 20 20 20 20 location...
270f0 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
27100 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 .. /// <p
27110 61 72 61 6d 20 6e 61 6d 65 3d 22 6f 66 66 73 65 aram name="offse
27120 74 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f t">.. ///
27130 20 54 68 65 20 69 6e 74 65 67 65 72 20 6f 66 66 The integer off
27140 73 65 74 20 66 72 6f 6d 20 74 68 65 20 62 61 73 set from the bas
27150 65 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f e memory locatio
27160 6e 20 77 68 65 72 65 20 74 68 65 0d 0a 20 20 20 n where the..
27170 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 /// <see cr
27180 65 66 3d 22 49 6e 74 50 74 72 22 20 2f 3e 20 76 ef="IntPtr" /> v
27190 61 6c 75 65 20 74 6f 20 62 65 20 72 65 61 64 20 alue to be read
271a0 69 73 20 6c 6f 63 61 74 65 64 2e 0d 0a 20 20 20 is located...
271b0 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
271c0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
271d0 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
271e0 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 /// The <see c
271f0 72 65 66 3d 22 49 6e 74 50 74 72 22 20 2f 3e 20 ref="IntPtr" />
27200 76 61 6c 75 65 20 61 74 20 74 68 65 20 73 70 65 value at the spe
27210 63 69 66 69 65 64 20 6d 65 6d 6f 72 79 20 6c 6f cified memory lo
27220 63 61 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 cation...
27230 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d /// </returns>.
27240 0a 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 . public
27250 73 74 61 74 69 63 20 49 6e 74 50 74 72 20 52 65 static IntPtr Re
27260 61 64 49 6e 74 50 74 72 28 0d 0a 20 20 20 20 20 adIntPtr(..
27270 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 6f IntPtr po
27280 69 6e 74 65 72 2c 0d 0a 20 20 20 20 20 20 20 20 inter,..
27290 20 20 20 20 69 6e 74 20 6f 66 66 73 65 74 0d 0a int offset..
272a0 20 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 )..
272b0 20 20 20 20 20 20 20 7b 0d 0a 23 69 66 20 21 50 {..#if !P
272c0 4c 41 54 46 4f 52 4d 5f 43 4f 4d 50 41 43 54 46 LATFORM_COMPACTF
272d0 52 41 4d 45 57 4f 52 4b 0d 0a 20 20 20 20 20 20 RAMEWORK..
272e0 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d 61 72 return Mar
272f0 73 68 61 6c 2e 52 65 61 64 49 6e 74 50 74 72 28 shal.ReadIntPtr(
27300 70 6f 69 6e 74 65 72 2c 20 6f 66 66 73 65 74 29 pointer, offset)
27310 3b 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20 20 ;..#else..
27320 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d 61 72 return Mar
27330 73 68 61 6c 2e 52 65 61 64 49 6e 74 50 74 72 28 shal.ReadIntPtr(
27340 49 6e 74 50 74 72 46 6f 72 4f 66 66 73 65 74 28 IntPtrForOffset(
27350 70 6f 69 6e 74 65 72 2c 20 6f 66 66 73 65 74 29 pointer, offset)
27360 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 );..#endif..
27370 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 23 }.. #
27380 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 endregion....
27390 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
273a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
273b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
273c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
273d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
273e0 20 20 20 20 20 20 20 20 23 72 65 67 69 6f 6e 20 #region
273f0 4d 61 72 73 68 61 6c 20 57 72 69 74 65 20 48 65 Marshal Write He
27400 6c 70 65 72 20 4d 65 74 68 6f 64 73 0d 0a 20 20 lper Methods..
27410 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
27420 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
27430 20 57 72 69 74 65 73 20 61 6e 20 3c 73 65 65 20 Writes an <see
27440 63 72 65 66 3d 22 49 6e 74 33 32 22 20 2f 3e 20 cref="Int32" />
27450 76 61 6c 75 65 20 74 6f 20 74 68 65 20 73 70 65 value to the spe
27460 63 69 66 69 65 64 20 6d 65 6d 6f 72 79 0d 0a 20 cified memory..
27470 20 20 20 20 20 20 20 2f 2f 2f 20 6c 6f 63 61 74 /// locat
27480 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ion... //
27490 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 / </summary>..
274a0 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
274b0 20 6e 61 6d 65 3d 22 70 6f 69 6e 74 65 72 22 3e name="pointer">
274c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
274d0 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 6e 74 e <see cref="Int
274e0 50 74 72 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 Ptr" /> object i
274f0 6e 73 74 61 6e 63 65 20 72 65 70 72 65 73 65 6e nstance represen
27500 74 69 6e 67 20 74 68 65 20 62 61 73 65 0d 0a 20 ting the base..
27510 20 20 20 20 20 20 20 2f 2f 2f 20 6d 65 6d 6f 72 /// memor
27520 79 20 6c 6f 63 61 74 69 6f 6e 2e 0d 0a 20 20 20 y location...
27530 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
27540 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
27550 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6f 66 66 73 param name="offs
27560 65 74 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f et">.. //
27570 2f 20 54 68 65 20 69 6e 74 65 67 65 72 20 6f 66 / The integer of
27580 66 73 65 74 20 66 72 6f 6d 20 74 68 65 20 62 61 fset from the ba
27590 73 65 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 se memory locati
275a0 6f 6e 20 77 68 65 72 65 20 74 68 65 0d 0a 20 20 on where the..
275b0 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 /// <see c
275c0 72 65 66 3d 22 49 6e 74 33 32 22 20 2f 3e 20 76 ref="Int32" /> v
275d0 61 6c 75 65 20 74 6f 20 62 65 20 77 72 69 74 74 alue to be writt
275e0 65 6e 20 69 73 20 6c 6f 63 61 74 65 64 2e 0d 0a en is located...
275f0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
27600 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
27610 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 76 / <param name="v
27620 61 6c 75 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 alue">..
27630 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 /// The <see cre
27640 66 3d 22 49 6e 74 33 32 22 20 2f 3e 20 76 61 6c f="Int32" /> val
27650 75 65 20 74 6f 20 77 72 69 74 65 2e 0d 0a 20 20 ue to write...
27660 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
27670 6d 3e 0d 0a 20 20 20 20 20 20 20 20 70 75 62 6c m>.. publ
27680 69 63 20 73 74 61 74 69 63 20 76 6f 69 64 20 57 ic static void W
27690 72 69 74 65 49 6e 74 33 32 28 0d 0a 20 20 20 20 riteInt32(..
276a0 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 IntPtr p
276b0 6f 69 6e 74 65 72 2c 0d 0a 20 20 20 20 20 20 20 ointer,..
276c0 20 20 20 20 20 69 6e 74 20 6f 66 66 73 65 74 2c int offset,
276d0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e .. in
276e0 74 20 76 61 6c 75 65 0d 0a 20 20 20 20 20 20 20 t value..
276f0 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 )..
27700 7b 0d 0a 23 69 66 20 21 50 4c 41 54 46 4f 52 4d {..#if !PLATFORM
27710 5f 43 4f 4d 50 41 43 54 46 52 41 4d 45 57 4f 52 _COMPACTFRAMEWOR
27720 4b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4d K.. M
27730 61 72 73 68 61 6c 2e 57 72 69 74 65 49 6e 74 33 arshal.WriteInt3
27740 32 28 70 6f 69 6e 74 65 72 2c 20 6f 66 66 73 65 2(pointer, offse
27750 74 2c 20 76 61 6c 75 65 29 3b 0d 0a 23 65 6c 73 t, value);..#els
27760 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 4d e.. M
27770 61 72 73 68 61 6c 2e 57 72 69 74 65 49 6e 74 33 arshal.WriteInt3
27780 32 28 49 6e 74 50 74 72 46 6f 72 4f 66 66 73 65 2(IntPtrForOffse
27790 74 28 70 6f 69 6e 74 65 72 2c 20 6f 66 66 73 65 t(pointer, offse
277a0 74 29 2c 20 76 61 6c 75 65 29 3b 0d 0a 23 65 6e t), value);..#en
277b0 64 69 66 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a dif.. }..
277c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
277d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
277e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
277f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
27800 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
27810 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f /.... ///
27820 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
27830 20 20 20 20 2f 2f 2f 20 57 72 69 74 65 73 20 61 /// Writes a
27840 20 3c 73 65 65 20 63 72 65 66 3d 22 44 6f 75 62 <see cref="Doub
27850 6c 65 22 20 2f 3e 20 76 61 6c 75 65 20 74 6f 20 le" /> value to
27860 74 68 65 20 73 70 65 63 69 66 69 65 64 20 6d 65 the specified me
27870 6d 6f 72 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f mory.. //
27880 2f 20 6c 6f 63 61 74 69 6f 6e 2e 0d 0a 20 20 20 / location...
27890 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
278a0 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
278b0 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 6f <param name="po
278c0 69 6e 74 65 72 22 3e 0d 0a 20 20 20 20 20 20 20 inter">..
278d0 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 72 /// The <see cr
278e0 65 66 3d 22 49 6e 74 50 74 72 22 20 2f 3e 20 6f ef="IntPtr" /> o
278f0 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 72 bject instance r
27900 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 20 epresenting the
27910 62 61 73 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f base.. //
27920 2f 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f / memory locatio
27930 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 n... ///
27940 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
27950 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
27960 65 3d 22 6f 66 66 73 65 74 22 3e 0d 0a 20 20 20 e="offset">..
27970 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 69 6e 74 /// The int
27980 65 67 65 72 20 6f 66 66 73 65 74 20 66 72 6f 6d eger offset from
27990 20 74 68 65 20 62 61 73 65 20 6d 65 6d 6f 72 79 the base memory
279a0 20 6c 6f 63 61 74 69 6f 6e 20 77 68 65 72 65 20 location where
279b0 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f the.. ///
279c0 20 3c 73 65 65 20 63 72 65 66 3d 22 44 6f 75 62 <see cref="Doub
279d0 6c 65 22 20 2f 3e 20 76 61 6c 75 65 20 74 6f 20 le" /> value to
279e0 62 65 20 77 72 69 74 74 65 6e 20 69 73 20 6c 6f be written is lo
279f0 63 61 74 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 cated...
27a00 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
27a10 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
27a20 20 6e 61 6d 65 3d 22 76 61 6c 75 65 22 3e 0d 0a name="value">..
27a30 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
27a40 3c 73 65 65 20 63 72 65 66 3d 22 44 6f 75 62 6c <see cref="Doubl
27a50 65 22 20 2f 3e 20 76 61 6c 75 65 20 74 6f 20 77 e" /> value to w
27a60 72 69 74 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f rite... /
27a70 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
27a80 20 20 20 20 20 70 75 62 6c 69 63 20 73 74 61 74 public stat
27a90 69 63 20 76 6f 69 64 20 57 72 69 74 65 44 6f 75 ic void WriteDou
27aa0 62 6c 65 28 0d 0a 20 20 20 20 20 20 20 20 20 20 ble(..
27ab0 20 20 49 6e 74 50 74 72 20 70 6f 69 6e 74 65 72 IntPtr pointer
27ac0 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 ,.. i
27ad0 6e 74 20 6f 66 66 73 65 74 2c 0d 0a 20 20 20 20 nt offset,..
27ae0 20 20 20 20 20 20 20 20 64 6f 75 62 6c 65 20 76 double v
27af0 61 6c 75 65 0d 0a 20 20 20 20 20 20 20 20 20 20 alue..
27b00 20 20 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a ).. {..
27b10 23 69 66 20 21 50 4c 41 54 46 4f 52 4d 5f 43 4f #if !PLATFORM_CO
27b20 4d 50 41 43 54 46 52 41 4d 45 57 4f 52 4b 0d 0a MPACTFRAMEWORK..
27b30 20 20 20 20 20 20 20 20 20 20 20 20 4d 61 72 73 Mars
27b40 68 61 6c 2e 57 72 69 74 65 49 6e 74 36 34 28 70 hal.WriteInt64(p
27b50 6f 69 6e 74 65 72 2c 20 6f 66 66 73 65 74 2c 0d ointer, offset,.
27b60 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
27b70 20 42 69 74 43 6f 6e 76 65 72 74 65 72 2e 44 6f BitConverter.Do
27b80 75 62 6c 65 54 6f 49 6e 74 36 34 42 69 74 73 28 ubleToInt64Bits(
27b90 76 61 6c 75 65 29 29 3b 0d 0a 23 65 6c 73 65 0d value));..#else.
27ba0 0a 20 20 20 20 20 20 20 20 20 20 20 20 4d 61 72 . Mar
27bb0 73 68 61 6c 2e 57 72 69 74 65 49 6e 74 36 34 28 shal.WriteInt64(
27bc0 49 6e 74 50 74 72 46 6f 72 4f 66 66 73 65 74 28 IntPtrForOffset(
27bd0 70 6f 69 6e 74 65 72 2c 20 6f 66 66 73 65 74 29 pointer, offset)
27be0 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ,..
27bf0 20 20 20 42 69 74 43 6f 6e 76 65 72 74 65 72 2e BitConverter.
27c00 54 6f 49 6e 74 36 34 28 42 69 74 43 6f 6e 76 65 ToInt64(BitConve
27c10 72 74 65 72 2e 47 65 74 42 79 74 65 73 28 76 61 rter.GetBytes(va
27c20 6c 75 65 29 2c 20 30 29 29 3b 0d 0a 23 65 6e 64 lue), 0));..#end
27c30 69 66 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d if.. }...
27c40 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
27c50 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
27c60 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
27c70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
27c80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
27c90 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 .... ///
27ca0 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
27cb0 20 20 20 2f 2f 2f 20 57 72 69 74 65 73 20 61 20 /// Writes a
27cc0 3c 73 65 65 20 63 72 65 66 3d 22 49 6e 74 50 74 <see cref="IntPt
27cd0 72 22 20 2f 3e 20 76 61 6c 75 65 20 74 6f 20 74 r" /> value to t
27ce0 68 65 20 73 70 65 63 69 66 69 65 64 20 6d 65 6d he specified mem
27cf0 6f 72 79 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ory.. ///
27d00 20 6c 6f 63 61 74 69 6f 6e 2e 0d 0a 20 20 20 20 location...
27d10 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
27d20 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
27d30 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 6f 69 <param name="poi
27d40 6e 74 65 72 22 3e 0d 0a 20 20 20 20 20 20 20 20 nter">..
27d50 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 /// The <see cre
27d60 66 3d 22 49 6e 74 50 74 72 22 20 2f 3e 20 6f 62 f="IntPtr" /> ob
27d70 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 72 65 ject instance re
27d80 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 20 62 presenting the b
27d90 61 73 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ase.. ///
27da0 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f 6e memory location
27db0 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
27dc0 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 /param>..
27dd0 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
27de0 3d 22 6f 66 66 73 65 74 22 3e 0d 0a 20 20 20 20 ="offset">..
27df0 20 20 20 20 2f 2f 2f 20 54 68 65 20 69 6e 74 65 /// The inte
27e00 67 65 72 20 6f 66 66 73 65 74 20 66 72 6f 6d 20 ger offset from
27e10 74 68 65 20 62 61 73 65 20 6d 65 6d 6f 72 79 20 the base memory
27e20 6c 6f 63 61 74 69 6f 6e 20 77 68 65 72 65 20 74 location where t
27e30 68 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 he.. ///
27e40 3c 73 65 65 20 63 72 65 66 3d 22 49 6e 74 50 74 <see cref="IntPt
27e50 72 22 20 2f 3e 20 76 61 6c 75 65 20 74 6f 20 62 r" /> value to b
27e60 65 20 77 72 69 74 74 65 6e 20 69 73 20 6c 6f 63 e written is loc
27e70 61 74 65 64 2e 0d 0a 20 20 20 20 20 20 20 20 2f ated... /
27e80 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
27e90 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
27ea0 6e 61 6d 65 3d 22 76 61 6c 75 65 22 3e 0d 0a 20 name="value">..
27eb0 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c /// The <
27ec0 73 65 65 20 63 72 65 66 3d 22 49 6e 74 50 74 72 see cref="IntPtr
27ed0 22 20 2f 3e 20 76 61 6c 75 65 20 74 6f 20 77 72 " /> value to wr
27ee0 69 74 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ite... //
27ef0 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
27f00 20 20 20 20 70 75 62 6c 69 63 20 73 74 61 74 69 public stati
27f10 63 20 76 6f 69 64 20 57 72 69 74 65 49 6e 74 50 c void WriteIntP
27f20 74 72 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 tr(..
27f30 20 49 6e 74 50 74 72 20 70 6f 69 6e 74 65 72 2c IntPtr pointer,
27f40 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e .. in
27f50 74 20 6f 66 66 73 65 74 2c 0d 0a 20 20 20 20 20 t offset,..
27f60 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 76 61 IntPtr va
27f70 6c 75 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 lue..
27f80 20 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 23 ).. {..#
27f90 69 66 20 21 50 4c 41 54 46 4f 52 4d 5f 43 4f 4d if !PLATFORM_COM
27fa0 50 41 43 54 46 52 41 4d 45 57 4f 52 4b 0d 0a 20 PACTFRAMEWORK..
27fb0 20 20 20 20 20 20 20 20 20 20 20 4d 61 72 73 68 Marsh
27fc0 61 6c 2e 57 72 69 74 65 49 6e 74 50 74 72 28 70 al.WriteIntPtr(p
27fd0 6f 69 6e 74 65 72 2c 20 6f 66 66 73 65 74 2c 20 ointer, offset,
27fe0 76 61 6c 75 65 29 3b 0d 0a 23 65 6c 73 65 0d 0a value);..#else..
27ff0 20 20 20 20 20 20 20 20 20 20 20 20 4d 61 72 73 Mars
28000 68 61 6c 2e 57 72 69 74 65 49 6e 74 50 74 72 28 hal.WriteIntPtr(
28010 49 6e 74 50 74 72 46 6f 72 4f 66 66 73 65 74 28 IntPtrForOffset(
28020 70 6f 69 6e 74 65 72 2c 20 6f 66 66 73 65 74 29 pointer, offset)
28030 2c 20 76 61 6c 75 65 29 3b 0d 0a 23 65 6e 64 69 , value);..#endi
28040 66 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 f.. }..
28050 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e #endregion
28060 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 65 6e .. }.. #en
28070 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 2f dregion.... /
28080 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28090 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
280a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
280b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
280c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
280d0 20 20 23 72 65 67 69 6f 6e 20 53 51 4c 69 74 65 #region SQLite
280e0 4d 6f 64 75 6c 65 20 42 61 73 65 20 43 6c 61 73 Module Base Clas
280f0 73 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d s.. /// <summ
28100 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 ary>.. /// Th
28110 69 73 20 63 6c 61 73 73 20 72 65 70 72 65 73 65 is class represe
28120 6e 74 73 20 61 20 6d 61 6e 61 67 65 64 20 76 69 nts a managed vi
28130 72 74 75 61 6c 20 74 61 62 6c 65 20 6d 6f 64 75 rtual table modu
28140 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f le implementatio
28150 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 49 74 20 69 n... /// It i
28160 73 20 6e 6f 74 20 73 65 61 6c 65 64 20 61 6e 64 s not sealed and
28170 20 6d 75 73 74 20 62 65 20 75 73 65 64 20 61 73 must be used as
28180 20 74 68 65 20 62 61 73 65 20 63 6c 61 73 73 20 the base class
28190 66 6f 72 20 61 6e 79 0d 0a 20 20 20 20 2f 2f 2f for any.. ///
281a0 20 75 73 65 72 2d 64 65 66 69 6e 65 64 20 76 69 user-defined vi
281b0 72 74 75 61 6c 20 74 61 62 6c 65 20 6d 6f 64 75 rtual table modu
281c0 6c 65 20 63 6c 61 73 73 65 73 20 69 6d 70 6c 65 le classes imple
281d0 6d 65 6e 74 65 64 20 69 6e 20 6d 61 6e 61 67 65 mented in manage
281e0 64 20 63 6f 64 65 2e 0d 0a 20 20 20 20 2f 2f 2f d code... ///
281f0 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
28200 20 70 75 62 6c 69 63 20 61 62 73 74 72 61 63 74 public abstract
28210 20 63 6c 61 73 73 20 53 51 4c 69 74 65 4d 6f 64 class SQLiteMod
28220 75 6c 65 20 3a 0d 0a 20 20 20 20 20 20 20 20 20 ule :..
28230 20 20 20 49 53 51 4c 69 74 65 4d 61 6e 61 67 65 ISQLiteManage
28240 64 4d 6f 64 75 6c 65 2c 20 2f 2a 49 53 51 4c 69 dModule, /*ISQLi
28250 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2c 2a teNativeModule,*
28260 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 /.. I
28270 44 69 73 70 6f 73 61 62 6c 65 20 2f 2a 20 4e 4f Disposable /* NO
28280 54 20 53 45 41 4c 45 44 20 2a 2f 0d 0a 20 20 20 T SEALED */..
28290 20 7b 0d 0a 20 20 20 20 20 20 20 20 23 72 65 67 {.. #reg
282a0 69 6f 6e 20 53 51 4c 69 74 65 4e 61 74 69 76 65 ion SQLiteNative
282b0 4d 6f 64 75 6c 65 20 50 72 69 76 61 74 65 20 43 Module Private C
282c0 6c 61 73 73 0d 0a 20 20 20 20 20 20 20 20 70 72 lass.. pr
282d0 69 76 61 74 65 20 73 65 61 6c 65 64 20 63 6c 61 ivate sealed cla
282e0 73 73 20 53 51 4c 69 74 65 4e 61 74 69 76 65 4d ss SQLiteNativeM
282f0 6f 64 75 6c 65 20 3a 0d 0a 20 20 20 20 20 20 20 odule :..
28300 20 20 20 20 20 20 20 20 20 49 53 51 4c 69 74 65 ISQLite
28310 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2c 20 49 44 NativeModule, ID
28320 69 73 70 6f 73 61 62 6c 65 0d 0a 20 20 20 20 20 isposable..
28330 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
28340 20 20 23 72 65 67 69 6f 6e 20 50 72 69 76 61 74 #region Privat
28350 65 20 43 6f 6e 73 74 61 6e 74 73 0d 0a 20 20 20 e Constants..
28360 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 /// <su
28370 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
28380 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 69 73 20 /// This is
28390 74 68 65 20 76 61 6c 75 65 20 74 68 61 74 20 69 the value that i
283a0 73 20 61 6c 77 61 79 73 20 75 73 65 64 20 66 6f s always used fo
283b0 72 20 74 68 65 20 22 6c 6f 67 45 72 72 6f 72 73 r the "logErrors
283c0 22 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f ".. /
283d0 2f 2f 20 70 61 72 61 6d 65 74 65 72 20 74 6f 20 // parameter to
283e0 74 68 65 20 76 61 72 69 6f 75 73 20 73 74 61 74 the various stat
283f0 69 63 20 65 72 72 6f 72 20 68 61 6e 64 6c 69 6e ic error handlin
28400 67 20 6d 65 74 68 6f 64 73 20 70 72 6f 76 69 64 g methods provid
28410 65 64 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ed..
28420 2f 2f 2f 20 62 79 20 74 68 65 20 3c 73 65 65 20 /// by the <see
28430 63 72 65 66 3d 22 53 51 4c 69 74 65 4d 6f 64 75 cref="SQLiteModu
28440 6c 65 22 20 2f 3e 20 63 6c 61 73 73 2e 0d 0a 20 le" /> class...
28450 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
28460 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
28470 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 63 private c
28480 6f 6e 73 74 20 62 6f 6f 6c 20 44 65 66 61 75 6c onst bool Defaul
28490 74 4c 6f 67 45 72 72 6f 72 73 20 3d 20 74 72 75 tLogErrors = tru
284a0 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 e;....
284b0 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////////
284c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
284d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
284e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
284f0 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
28500 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
28510 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 y>..
28520 2f 2f 2f 20 54 68 69 73 20 69 73 20 74 68 65 20 /// This is the
28530 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 74 65 error message te
28540 78 74 20 75 73 65 64 20 77 68 65 6e 20 74 68 65 xt used when the
28550 20 63 6f 6e 74 61 69 6e 65 64 0d 0a 20 20 20 20 contained..
28560 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 /// <see
28570 20 63 72 65 66 3d 22 53 51 4c 69 74 65 4d 6f 64 cref="SQLiteMod
28580 75 6c 65 22 20 2f 3e 20 6f 62 6a 65 63 74 20 69 ule" /> object i
28590 6e 73 74 61 6e 63 65 20 69 73 20 6e 6f 74 20 61 nstance is not a
285a0 76 61 69 6c 61 62 6c 65 0d 0a 20 20 20 20 20 20 vailable..
285b0 20 20 20 20 20 20 2f 2f 2f 20 66 6f 72 20 61 6e /// for an
285c0 79 20 72 65 61 73 6f 6e 2e 0d 0a 20 20 20 20 20 y reason...
285d0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
285e0 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 mary>..
285f0 20 20 20 70 72 69 76 61 74 65 20 63 6f 6e 73 74 private const
28600 20 73 74 72 69 6e 67 20 4d 6f 64 75 6c 65 4e 6f string ModuleNo
28610 74 41 76 61 69 6c 61 62 6c 65 45 72 72 6f 72 4d tAvailableErrorM
28620 65 73 73 61 67 65 20 3d 0d 0a 20 20 20 20 20 20 essage =..
28630 20 20 20 20 20 20 20 20 20 20 22 6e 61 74 69 76 "nativ
28640 65 20 6d 6f 64 75 6c 65 20 69 6d 70 6c 65 6d 65 e module impleme
28650 6e 74 61 74 69 6f 6e 20 6e 6f 74 20 61 76 61 69 ntation not avai
28660 6c 61 62 6c 65 22 3b 0d 0a 20 20 20 20 20 20 20 lable";..
28670 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d #endregion.
28680 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f ... /
28690 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
286a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
286b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
286c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
286d0 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 //....
286e0 20 20 23 72 65 67 69 6f 6e 20 50 72 69 76 61 74 #region Privat
286f0 65 20 44 61 74 61 0d 0a 20 20 20 20 20 20 20 20 e Data..
28700 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
28710 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
28720 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 // The <see cref
28730 3d 22 53 51 4c 69 74 65 4d 6f 64 75 6c 65 22 20 ="SQLiteModule"
28740 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e /> object instan
28750 63 65 20 75 73 65 64 20 74 6f 20 70 72 6f 76 69 ce used to provi
28760 64 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 de..
28770 2f 2f 2f 20 61 6e 20 69 6d 70 6c 65 6d 65 6e 74 /// an implement
28780 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 3c 73 65 ation of the <se
28790 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e e cref="ISQLiteN
287a0 61 74 69 76 65 4d 6f 64 75 6c 65 22 20 2f 3e 0d ativeModule" />.
287b0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
287c0 20 69 6e 74 65 72 66 61 63 65 2e 0d 0a 20 20 20 interface...
287d0 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 /// </s
287e0 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
287f0 20 20 20 20 20 70 72 69 76 61 74 65 20 53 51 4c private SQL
28800 69 74 65 4d 6f 64 75 6c 65 20 6d 6f 64 75 6c 65 iteModule module
28810 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 23 ;.. #
28820 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 endregion....
28830 20 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f ///////
28840 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28850 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28860 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28870 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
28880 20 20 20 20 20 20 20 20 20 20 20 20 23 72 65 67 #reg
28890 69 6f 6e 20 50 75 62 6c 69 63 20 43 6f 6e 73 74 ion Public Const
288a0 72 75 63 74 6f 72 73 0d 0a 20 20 20 20 20 20 20 ructors..
288b0 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
288c0 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 y>..
288d0 2f 2f 2f 20 43 6f 6e 73 74 72 75 63 74 73 20 61 /// Constructs a
288e0 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
288f0 69 73 20 63 6c 61 73 73 2e 0d 0a 20 20 20 20 20 is class...
28900 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
28910 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 mary>..
28920 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
28930 6d 65 3d 22 6d 6f 64 75 6c 65 22 3e 0d 0a 20 20 me="module">..
28940 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 /// Th
28950 65 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c e <see cref="SQL
28960 69 74 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 6f 62 iteModule" /> ob
28970 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 75 73 ject instance us
28980 65 64 20 74 6f 20 70 72 6f 76 69 64 65 0d 0a 20 ed to provide..
28990 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 61 /// a
289a0 6e 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e n implementation
289b0 20 6f 66 20 74 68 65 20 3c 73 65 65 20 63 72 65 of the <see cre
289c0 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 f="ISQLiteNative
289d0 4d 6f 64 75 6c 65 22 20 2f 3e 0d 0a 20 20 20 20 Module" />..
289e0 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 6e 74 65 /// inte
289f0 72 66 61 63 65 2e 0d 0a 20 20 20 20 20 20 20 20 rface...
28a00 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
28a10 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 75 .. pu
28a20 62 6c 69 63 20 53 51 4c 69 74 65 4e 61 74 69 76 blic SQLiteNativ
28a30 65 4d 6f 64 75 6c 65 28 0d 0a 20 20 20 20 20 20 eModule(..
28a40 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 SQLite
28a50 4d 6f 64 75 6c 65 20 6d 6f 64 75 6c 65 0d 0a 20 Module module..
28a60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 29 )
28a70 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d .. {.
28a80 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
28a90 20 74 68 69 73 2e 6d 6f 64 75 6c 65 20 3d 20 6d this.module = m
28aa0 6f 64 75 6c 65 3b 0d 0a 20 20 20 20 20 20 20 20 odule;..
28ab0 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 }..
28ac0 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d #endregion...
28ad0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
28ae0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28af0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28b00 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28b10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28b20 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
28b30 23 72 65 67 69 6f 6e 20 50 72 69 76 61 74 65 20 #region Private
28b40 53 74 61 74 69 63 20 4d 65 74 68 6f 64 73 0d 0a Static Methods..
28b50 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
28b60 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
28b70 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 74 73 20 /// Sets
28b80 74 68 65 20 74 61 62 6c 65 20 65 72 72 6f 72 20 the table error
28b90 6d 65 73 73 61 67 65 20 74 6f 20 6f 6e 65 20 74 message to one t
28ba0 68 61 74 20 69 6e 64 69 63 61 74 65 73 20 74 68 hat indicates th
28bb0 65 20 6e 61 74 69 76 65 0d 0a 20 20 20 20 20 20 e native..
28bc0 20 20 20 20 20 20 2f 2f 2f 20 6d 6f 64 75 6c 65 /// module
28bd0 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
28be0 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 is not available
28bf0 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f ... /
28c00 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
28c10 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
28c20 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 56 74 61 param name="pVta
28c30 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 b">..
28c40 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 /// The native
28c50 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 73 pointer to the s
28c60 71 6c 69 74 65 33 5f 76 74 61 62 20 64 65 72 69 qlite3_vtab deri
28c70 76 65 64 20 73 74 72 75 63 74 75 72 65 2e 0d 0a ved structure...
28c80 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
28c90 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
28ca0 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 /// <retur
28cb0 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ns>..
28cc0 20 2f 2f 2f 20 54 68 65 20 76 61 6c 75 65 20 6f /// The value o
28cd0 66 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c f <see cref="SQL
28ce0 69 74 65 45 72 72 6f 72 43 6f 64 65 2e 45 72 72 iteErrorCode.Err
28cf0 6f 72 22 20 2f 3e 2e 0d 0a 20 20 20 20 20 20 20 or" />...
28d00 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 /// </retur
28d10 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ns>..
28d20 20 70 72 69 76 61 74 65 20 73 74 61 74 69 63 20 private static
28d30 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 SQLiteErrorCode
28d40 4d 6f 64 75 6c 65 4e 6f 74 41 76 61 69 6c 61 62 ModuleNotAvailab
28d50 6c 65 54 61 62 6c 65 45 72 72 6f 72 28 0d 0a 20 leTableError(..
28d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 I
28d70 6e 74 50 74 72 20 70 56 74 61 62 0d 0a 20 20 20 ntPtr pVtab..
28d80 20 20 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a )..
28d90 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 {..
28da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
28db0 65 74 54 61 62 6c 65 45 72 72 6f 72 28 6e 75 6c etTableError(nul
28dc0 6c 2c 20 70 56 74 61 62 2c 20 44 65 66 61 75 6c l, pVtab, Defaul
28dd0 74 4c 6f 67 45 72 72 6f 72 73 2c 0d 0a 20 20 20 tLogErrors,..
28de0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28df0 20 4d 6f 64 75 6c 65 4e 6f 74 41 76 61 69 6c 61 ModuleNotAvaila
28e00 62 6c 65 45 72 72 6f 72 4d 65 73 73 61 67 65 29 bleErrorMessage)
28e10 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
28e20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 69 return SQLi
28e30 74 65 45 72 72 6f 72 43 6f 64 65 2e 45 72 72 6f teErrorCode.Erro
28e40 72 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 r;..
28e50 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 }....
28e60 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
28e70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28e80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28e90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
28ea0 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ////....
28eb0 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 /// <summary
28ec0 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
28ed0 2f 2f 20 53 65 74 73 20 74 68 65 20 74 61 62 6c // Sets the tabl
28ee0 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 e error message
28ef0 74 6f 20 6f 6e 65 20 74 68 61 74 20 69 6e 64 69 to one that indi
28f00 63 61 74 65 73 20 74 68 65 20 6e 61 74 69 76 65 cates the native
28f10 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
28f20 2f 20 6d 6f 64 75 6c 65 20 69 6d 70 6c 65 6d 65 / module impleme
28f30 6e 74 61 74 69 6f 6e 20 69 73 20 6e 6f 74 20 61 ntation is not a
28f40 76 61 69 6c 61 62 6c 65 2e 0d 0a 20 20 20 20 20 vailable...
28f50 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
28f60 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 mary>..
28f70 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
28f80 6d 65 3d 22 70 43 75 72 73 6f 72 22 3e 0d 0a 20 me="pCursor">..
28f90 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 /// T
28fa0 68 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 he native pointe
28fb0 72 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 r to the sqlite3
28fc0 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 64 65 72 _vtab_cursor der
28fd0 69 76 65 64 0d 0a 20 20 20 20 20 20 20 20 20 20 ived..
28fe0 20 20 2f 2f 2f 20 73 74 72 75 63 74 75 72 65 2e /// structure.
28ff0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
29000 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
29010 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 /// <ret
29020 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 urns>..
29030 20 20 20 2f 2f 2f 20 54 68 65 20 76 61 6c 75 65 /// The value
29040 20 6f 66 20 3c 73 65 65 20 63 72 65 66 3d 22 53 of <see cref="S
29050 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 2e 45 QLiteErrorCode.E
29060 72 72 6f 72 22 20 2f 3e 2e 0d 0a 20 20 20 20 20 rror" />...
29070 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 /// </ret
29080 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 urns>..
29090 20 20 20 70 72 69 76 61 74 65 20 73 74 61 74 69 private stati
290a0 63 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 c SQLiteErrorCod
290b0 65 20 4d 6f 64 75 6c 65 4e 6f 74 41 76 61 69 6c e ModuleNotAvail
290c0 61 62 6c 65 43 75 72 73 6f 72 45 72 72 6f 72 28 ableCursorError(
290d0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
290e0 20 20 49 6e 74 50 74 72 20 70 43 75 72 73 6f 72 IntPtr pCursor
290f0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
29100 20 20 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 )..
29110 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 {..
29120 20 20 20 20 53 65 74 43 75 72 73 6f 72 45 72 72 SetCursorErr
29130 6f 72 28 6e 75 6c 6c 2c 20 70 43 75 72 73 6f 72 or(null, pCursor
29140 2c 20 44 65 66 61 75 6c 74 4c 6f 67 45 72 72 6f , DefaultLogErro
29150 72 73 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 rs,..
29160 20 20 20 20 20 20 20 20 20 4d 6f 64 75 6c 65 4e ModuleN
29170 6f 74 41 76 61 69 6c 61 62 6c 65 45 72 72 6f 72 otAvailableError
29180 4d 65 73 73 61 67 65 29 3b 0d 0a 0d 0a 20 20 20 Message);....
29190 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 ret
291a0 75 72 6e 20 53 51 4c 69 74 65 45 72 72 6f 72 43 urn SQLiteErrorC
291b0 6f 64 65 2e 45 72 72 6f 72 3b 0d 0a 20 20 20 20 ode.Error;..
291c0 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 }..
291d0 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f #endregio
291e0 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 n....
291f0 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////////
29200 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
29210 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
29220 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
29230 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ////....
29240 20 20 20 20 23 72 65 67 69 6f 6e 20 49 53 51 4c #region ISQL
29250 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 20 iteNativeModule
29260 4d 65 6d 62 65 72 73 0d 0a 20 20 20 20 20 20 20 Members..
29270 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
29280 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 y>..
29290 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 /// See the <see
292a0 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 cref="ISQLiteNa
292b0 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 72 65 61 tiveModule.xCrea
292c0 74 65 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a te" /> method...
292d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
292e0 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
292f0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
29300 61 6d 20 6e 61 6d 65 3d 22 70 44 62 22 3e 0d 0a am name="pDb">..
29310 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
29320 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 See the <see cre
29330 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 f="ISQLiteNative
29340 4d 6f 64 75 6c 65 2e 78 43 72 65 61 74 65 22 20 Module.xCreate"
29350 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 /> method...
29360 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
29370 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 ram>..
29380 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
29390 65 3d 22 70 41 75 78 22 3e 0d 0a 20 20 20 20 20 e="pAux">..
293a0 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 /// See t
293b0 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 he <see cref="IS
293c0 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c QLiteNativeModul
293d0 65 2e 78 43 72 65 61 74 65 22 20 2f 3e 20 6d 65 e.xCreate" /> me
293e0 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 thod...
293f0 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
29400 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
29410 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 61 72 <param name="ar
29420 67 63 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 gc">..
29430 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 /// See the <s
29440 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
29450 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 72 NativeModule.xCr
29460 65 61 74 65 22 20 2f 3e 20 6d 65 74 68 6f 64 2e eate" /> method.
29470 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
29480 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
29490 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
294a0 61 6d 20 6e 61 6d 65 3d 22 61 72 67 76 22 3e 0d am name="argv">.
294b0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
294c0 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 See the <see cr
294d0 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 ef="ISQLiteNativ
294e0 65 4d 6f 64 75 6c 65 2e 78 43 72 65 61 74 65 22 eModule.xCreate"
294f0 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 /> method...
29500 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 /// </p
29510 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 aram>..
29520 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
29530 6d 65 3d 22 70 56 74 61 62 22 3e 0d 0a 20 20 20 me="pVtab">..
29540 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 /// See
29550 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 the <see cref="
29560 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 ISQLiteNativeMod
29570 75 6c 65 2e 78 43 72 65 61 74 65 22 20 2f 3e 20 ule.xCreate" />
29580 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 method...
29590 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
295a0 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
295b0 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
295c0 70 45 72 72 6f 72 22 3e 0d 0a 20 20 20 20 20 20 pError">..
295d0 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 /// See th
295e0 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 e <see cref="ISQ
295f0 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
29600 2e 78 43 72 65 61 74 65 22 20 2f 3e 20 6d 65 74 .xCreate" /> met
29610 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 hod...
29620 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
29630 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
29640 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 <returns>..
29650 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 /// See t
29660 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 he <see cref="IS
29670 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c QLiteNativeModul
29680 65 2e 78 43 72 65 61 74 65 22 20 2f 3e 20 6d 65 e.xCreate" /> me
29690 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 thod...
296a0 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 /// </returns
296b0 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 >.. p
296c0 75 62 6c 69 63 20 53 51 4c 69 74 65 45 72 72 6f ublic SQLiteErro
296d0 72 43 6f 64 65 20 78 43 72 65 61 74 65 28 0d 0a rCode xCreate(..
296e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
296f0 49 6e 74 50 74 72 20 70 44 62 2c 0d 0a 20 20 20 IntPtr pDb,..
29700 20 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 Int
29710 50 74 72 20 70 41 75 78 2c 0d 0a 20 20 20 20 20 Ptr pAux,..
29720 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 61 int a
29730 72 67 63 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 rgc,..
29740 20 20 20 20 20 20 49 6e 74 50 74 72 20 61 72 67 IntPtr arg
29750 76 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 v,..
29760 20 20 20 20 72 65 66 20 49 6e 74 50 74 72 20 70 ref IntPtr p
29770 56 74 61 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 Vtab,..
29780 20 20 20 20 20 20 20 72 65 66 20 49 6e 74 50 74 ref IntPt
29790 72 20 70 45 72 72 6f 72 0d 0a 20 20 20 20 20 20 r pError..
297a0 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 20 20 )..
297b0 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
297c0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 43 // C
297d0 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 3b 0d heckDisposed();.
297e0 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
297f0 20 20 20 69 66 20 28 6d 6f 64 75 6c 65 20 3d 3d if (module ==
29800 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 20 20 20 null)..
29810 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
29820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 p
29830 45 72 72 6f 72 20 3d 20 53 51 4c 69 74 65 53 74 Error = SQLiteSt
29840 72 69 6e 67 2e 55 74 66 38 49 6e 74 50 74 72 46 ring.Utf8IntPtrF
29850 72 6f 6d 53 74 72 69 6e 67 28 0d 0a 20 20 20 20 romString(..
29860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29870 20 20 20 20 4d 6f 64 75 6c 65 4e 6f 74 41 76 61 ModuleNotAva
29880 69 6c 61 62 6c 65 45 72 72 6f 72 4d 65 73 73 61 ilableErrorMessa
29890 67 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ge);....
298a0 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
298b0 72 6e 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f rn SQLiteErrorCo
298c0 64 65 2e 45 72 72 6f 72 3b 0d 0a 20 20 20 20 20 de.Error;..
298d0 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a }....
298e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
298f0 72 65 74 75 72 6e 20 6d 6f 64 75 6c 65 2e 78 43 return module.xC
29900 72 65 61 74 65 28 0d 0a 20 20 20 20 20 20 20 20 reate(..
29910 20 20 20 20 20 20 20 20 20 20 20 20 70 44 62 2c pDb,
29920 20 70 41 75 78 2c 20 61 72 67 63 2c 20 61 72 67 pAux, argc, arg
29930 76 2c 20 72 65 66 20 70 56 74 61 62 2c 20 72 65 v, ref pVtab, re
29940 66 20 70 45 72 72 6f 72 29 3b 0d 0a 20 20 20 20 f pError);..
29950 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 }....
29960 20 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f ///////
29970 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
29980 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
29990 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
299a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
299b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
299c0 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 <summary>..
299d0 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 /// See t
299e0 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 he <see cref="IS
299f0 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c QLiteNativeModul
29a00 65 2e 78 43 6f 6e 6e 65 63 74 22 20 2f 3e 20 6d e.xConnect" /> m
29a10 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 ethod...
29a20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
29a30 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 y>..
29a40 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
29a50 22 70 44 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 "pDb">..
29a60 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 /// See the
29a70 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 <see cref="ISQLi
29a80 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 teNativeModule.x
29a90 43 6f 6e 6e 65 63 74 22 20 2f 3e 20 6d 65 74 68 Connect" /> meth
29aa0 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 od...
29ab0 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
29ac0 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
29ad0 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 41 75 78 param name="pAux
29ae0 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ">..
29af0 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 /// See the <see
29b00 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 cref="ISQLiteNa
29b10 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6e 6e tiveModule.xConn
29b20 65 63 74 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d ect" /> method..
29b30 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
29b40 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
29b50 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
29b60 6d 20 6e 61 6d 65 3d 22 61 72 67 63 22 3e 0d 0a m name="argc">..
29b70 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
29b80 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 See the <see cre
29b90 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 f="ISQLiteNative
29ba0 4d 6f 64 75 6c 65 2e 78 43 6f 6e 6e 65 63 74 22 Module.xConnect"
29bb0 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 /> method...
29bc0 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 /// </p
29bd0 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 aram>..
29be0 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
29bf0 6d 65 3d 22 61 72 67 76 22 3e 0d 0a 20 20 20 20 me="argv">..
29c00 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 /// See
29c10 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 the <see cref="I
29c20 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 SQLiteNativeModu
29c30 6c 65 2e 78 43 6f 6e 6e 65 63 74 22 20 2f 3e 20 le.xConnect" />
29c40 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 method...
29c50 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
29c60 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
29c70 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
29c80 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 pVtab">..
29c90 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
29ca0 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
29cb0 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
29cc0 78 43 6f 6e 6e 65 63 74 22 20 2f 3e 20 6d 65 74 xConnect" /> met
29cd0 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 hod...
29ce0 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
29cf0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
29d00 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 45 72 <param name="pEr
29d10 72 6f 72 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 ror">..
29d20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c /// See the <
29d30 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 see cref="ISQLit
29d40 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 eNativeModule.xC
29d50 6f 6e 6e 65 63 74 22 20 2f 3e 20 6d 65 74 68 6f onnect" /> metho
29d60 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 d...
29d70 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
29d80 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 /// <r
29d90 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 eturns>..
29da0 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
29db0 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
29dc0 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
29dd0 78 43 6f 6e 6e 65 63 74 22 20 2f 3e 20 6d 65 74 xConnect" /> met
29de0 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 hod...
29df0 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e /// </returns>
29e00 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 75 .. pu
29e10 62 6c 69 63 20 53 51 4c 69 74 65 45 72 72 6f 72 blic SQLiteError
29e20 43 6f 64 65 20 78 43 6f 6e 6e 65 63 74 28 0d 0a Code xConnect(..
29e30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29e40 49 6e 74 50 74 72 20 70 44 62 2c 0d 0a 20 20 20 IntPtr pDb,..
29e50 20 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 Int
29e60 50 74 72 20 70 41 75 78 2c 0d 0a 20 20 20 20 20 Ptr pAux,..
29e70 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 61 int a
29e80 72 67 63 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 rgc,..
29e90 20 20 20 20 20 20 49 6e 74 50 74 72 20 61 72 67 IntPtr arg
29ea0 76 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 v,..
29eb0 20 20 20 20 72 65 66 20 49 6e 74 50 74 72 20 70 ref IntPtr p
29ec0 56 74 61 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 Vtab,..
29ed0 20 20 20 20 20 20 20 72 65 66 20 49 6e 74 50 74 ref IntPt
29ee0 72 20 70 45 72 72 6f 72 0d 0a 20 20 20 20 20 20 r pError..
29ef0 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 20 20 )..
29f00 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
29f10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 43 // C
29f20 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 3b 0d heckDisposed();.
29f30 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
29f40 20 20 20 69 66 20 28 6d 6f 64 75 6c 65 20 3d 3d if (module ==
29f50 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 20 20 20 null)..
29f60 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
29f70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 p
29f80 45 72 72 6f 72 20 3d 20 53 51 4c 69 74 65 53 74 Error = SQLiteSt
29f90 72 69 6e 67 2e 55 74 66 38 49 6e 74 50 74 72 46 ring.Utf8IntPtrF
29fa0 72 6f 6d 53 74 72 69 6e 67 28 0d 0a 20 20 20 20 romString(..
29fb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29fc0 20 20 20 20 4d 6f 64 75 6c 65 4e 6f 74 41 76 61 ModuleNotAva
29fd0 69 6c 61 62 6c 65 45 72 72 6f 72 4d 65 73 73 61 ilableErrorMessa
29fe0 67 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ge);....
29ff0 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
2a000 72 6e 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f rn SQLiteErrorCo
2a010 64 65 2e 45 72 72 6f 72 3b 0d 0a 20 20 20 20 20 de.Error;..
2a020 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a }....
2a030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a040 72 65 74 75 72 6e 20 6d 6f 64 75 6c 65 2e 78 43 return module.xC
2a050 6f 6e 6e 65 63 74 28 0d 0a 20 20 20 20 20 20 20 onnect(..
2a060 20 20 20 20 20 20 20 20 20 20 20 20 20 70 44 62 pDb
2a070 2c 20 70 41 75 78 2c 20 61 72 67 63 2c 20 61 72 , pAux, argc, ar
2a080 67 76 2c 20 72 65 66 20 70 56 74 61 62 2c 20 72 gv, ref pVtab, r
2a090 65 66 20 70 45 72 72 6f 72 29 3b 0d 0a 20 20 20 ef pError);..
2a0a0 20 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 }....
2a0b0 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f //////
2a0c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a0d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a0e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a0f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d /////////////...
2a100 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2a110 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
2a120 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 /// See
2a130 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 the <see cref="I
2a140 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 SQLiteNativeModu
2a150 6c 65 2e 78 42 65 73 74 49 6e 64 65 78 22 20 2f le.xBestIndex" /
2a160 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
2a170 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
2a180 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 mary>..
2a190 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
2a1a0 6d 65 3d 22 70 56 74 61 62 22 3e 0d 0a 20 20 20 me="pVtab">..
2a1b0 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 /// See
2a1c0 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 the <see cref="
2a1d0 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 ISQLiteNativeMod
2a1e0 75 6c 65 2e 78 42 65 73 74 49 6e 64 65 78 22 20 ule.xBestIndex"
2a1f0 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 /> method...
2a200 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
2a210 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 ram>..
2a220 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
2a230 65 3d 22 70 49 6e 64 65 78 22 3e 0d 0a 20 20 20 e="pIndex">..
2a240 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 /// See
2a250 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 the <see cref="
2a260 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 ISQLiteNativeMod
2a270 75 6c 65 2e 78 42 65 73 74 49 6e 64 65 78 22 20 ule.xBestIndex"
2a280 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 /> method...
2a290 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
2a2a0 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 ram>..
2a2b0 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d /// <returns>.
2a2c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2a2d0 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 See the <see cr
2a2e0 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 ef="ISQLiteNativ
2a2f0 65 4d 6f 64 75 6c 65 2e 78 42 65 73 74 49 6e 64 eModule.xBestInd
2a300 65 78 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a ex" /> method...
2a310 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2a320 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 </returns>..
2a330 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 53 public S
2a340 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 78 QLiteErrorCode x
2a350 42 65 73 74 49 6e 64 65 78 28 0d 0a 20 20 20 20 BestIndex(..
2a360 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 IntP
2a370 74 72 20 70 56 74 61 62 2c 0d 0a 20 20 20 20 20 tr pVtab,..
2a380 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 IntPt
2a390 72 20 70 49 6e 64 65 78 0d 0a 20 20 20 20 20 20 r pIndex..
2a3a0 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 20 20 )..
2a3b0 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
2a3c0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 43 // C
2a3d0 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 3b 0d heckDisposed();.
2a3e0 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
2a3f0 20 20 20 69 66 20 28 6d 6f 64 75 6c 65 20 3d 3d if (module ==
2a400 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 20 20 20 null)..
2a410 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
2a420 72 6e 20 4d 6f 64 75 6c 65 4e 6f 74 41 76 61 69 rn ModuleNotAvai
2a430 6c 61 62 6c 65 54 61 62 6c 65 45 72 72 6f 72 28 lableTableError(
2a440 70 56 74 61 62 29 3b 0d 0a 0d 0a 20 20 20 20 20 pVtab);....
2a450 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
2a460 6e 20 6d 6f 64 75 6c 65 2e 78 42 65 73 74 49 6e n module.xBestIn
2a470 64 65 78 28 70 56 74 61 62 2c 20 70 49 6e 64 65 dex(pVtab, pInde
2a480 78 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 x);..
2a490 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 }....
2a4a0 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////////
2a4b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a4c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a4d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a4e0 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
2a4f0 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
2a500 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 y>..
2a510 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 /// See the <see
2a520 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 cref="ISQLiteNa
2a530 74 69 76 65 4d 6f 64 75 6c 65 2e 78 44 69 73 63 tiveModule.xDisc
2a540 6f 6e 6e 65 63 74 22 20 2f 3e 20 6d 65 74 68 6f onnect" /> metho
2a550 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 d...
2a560 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a /// </summary>..
2a570 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2a580 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 56 74 <param name="pVt
2a590 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 ab">..
2a5a0 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 /// See the <s
2a5b0 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
2a5c0 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 44 69 NativeModule.xDi
2a5d0 73 63 6f 6e 6e 65 63 74 22 20 2f 3e 20 6d 65 74 sconnect" /> met
2a5e0 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 hod...
2a5f0 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
2a600 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2a610 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 <returns>..
2a620 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 /// See t
2a630 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 he <see cref="IS
2a640 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c QLiteNativeModul
2a650 65 2e 78 44 69 73 63 6f 6e 6e 65 63 74 22 20 2f e.xDisconnect" /
2a660 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
2a670 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 /// </ret
2a680 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 urns>..
2a690 20 20 20 70 75 62 6c 69 63 20 53 51 4c 69 74 65 public SQLite
2a6a0 45 72 72 6f 72 43 6f 64 65 20 78 44 69 73 63 6f ErrorCode xDisco
2a6b0 6e 6e 65 63 74 28 0d 0a 20 20 20 20 20 20 20 20 nnect(..
2a6c0 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 IntPtr p
2a6d0 56 74 61 62 0d 0a 20 20 20 20 20 20 20 20 20 20 Vtab..
2a6e0 20 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 )..
2a6f0 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
2a700 20 20 20 20 20 20 20 20 2f 2f 20 43 68 65 63 6b // Check
2a710 44 69 73 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 Disposed();....
2a720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 i
2a730 66 20 28 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c f (module == nul
2a740 6c 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 l)..
2a750 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d return M
2a760 6f 64 75 6c 65 4e 6f 74 41 76 61 69 6c 61 62 6c oduleNotAvailabl
2a770 65 54 61 62 6c 65 45 72 72 6f 72 28 70 56 74 61 eTableError(pVta
2a780 62 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 b);....
2a790 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f return mo
2a7a0 64 75 6c 65 2e 78 44 69 73 63 6f 6e 6e 65 63 74 dule.xDisconnect
2a7b0 28 70 56 74 61 62 29 3b 0d 0a 20 20 20 20 20 20 (pVtab);..
2a7c0 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 }....
2a7d0 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
2a7e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a7f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a800 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2a810 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
2a820 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 /// <s
2a830 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
2a840 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
2a850 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
2a860 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
2a870 78 44 65 73 74 72 6f 79 22 20 2f 3e 20 6d 65 74 xDestroy" /> met
2a880 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 hod...
2a890 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
2a8a0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2a8b0 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 / <param name="p
2a8c0 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 Vtab">..
2a8d0 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 /// See the
2a8e0 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 <see cref="ISQLi
2a8f0 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 teNativeModule.x
2a900 44 65 73 74 72 6f 79 22 20 2f 3e 20 6d 65 74 68 Destroy" /> meth
2a910 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 od...
2a920 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
2a930 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2a940 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
2a950 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 /// See th
2a960 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 e <see cref="ISQ
2a970 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
2a980 2e 78 44 65 73 74 72 6f 79 22 20 2f 3e 20 6d 65 .xDestroy" /> me
2a990 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 thod...
2a9a0 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 /// </returns
2a9b0 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 >.. p
2a9c0 75 62 6c 69 63 20 53 51 4c 69 74 65 45 72 72 6f ublic SQLiteErro
2a9d0 72 43 6f 64 65 20 78 44 65 73 74 72 6f 79 28 0d rCode xDestroy(.
2a9e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2a9f0 20 49 6e 74 50 74 72 20 70 56 74 61 62 0d 0a 20 IntPtr pVtab..
2aa00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 29 )
2aa10 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d .. {.
2aa20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2aa30 20 2f 2f 20 43 68 65 63 6b 44 69 73 70 6f 73 65 // CheckDispose
2aa40 64 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 d();....
2aa50 20 20 20 20 20 20 20 20 69 66 20 28 6d 6f 64 75 if (modu
2aa60 6c 65 20 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 20 20 le == null)..
2aa70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2aa80 20 72 65 74 75 72 6e 20 4d 6f 64 75 6c 65 4e 6f return ModuleNo
2aa90 74 41 76 61 69 6c 61 62 6c 65 54 61 62 6c 65 45 tAvailableTableE
2aaa0 72 72 6f 72 28 70 56 74 61 62 29 3b 0d 0a 0d 0a rror(pVtab);....
2aab0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2aac0 72 65 74 75 72 6e 20 6d 6f 64 75 6c 65 2e 78 44 return module.xD
2aad0 65 73 74 72 6f 79 28 70 56 74 61 62 29 3b 0d 0a estroy(pVtab);..
2aae0 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 0d }...
2aaf0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2ab00 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2ab10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2ab20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2ab30 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2ab40 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
2ab50 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
2ab60 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 /// S
2ab70 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 ee the <see cref
2ab80 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d ="ISQLiteNativeM
2ab90 6f 64 75 6c 65 2e 78 4f 70 65 6e 22 20 2f 3e 20 odule.xOpen" />
2aba0 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 method...
2abb0 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
2abc0 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ry>..
2abd0 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
2abe0 3d 22 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 ="pVtab">..
2abf0 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 /// See t
2ac00 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 he <see cref="IS
2ac10 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c QLiteNativeModul
2ac20 65 2e 78 4f 70 65 6e 22 20 2f 3e 20 6d 65 74 68 e.xOpen" /> meth
2ac30 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 od...
2ac40 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
2ac50 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2ac60 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 43 75 72 param name="pCur
2ac70 73 6f 72 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 sor">..
2ac80 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c /// See the <
2ac90 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 see cref="ISQLit
2aca0 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 4f eNativeModule.xO
2acb0 70 65 6e 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d pen" /> method..
2acc0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2acd0 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
2ace0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 /// <retu
2acf0 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 rns>..
2ad00 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 /// See the <s
2ad10 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
2ad20 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 4f 70 NativeModule.xOp
2ad30 65 6e 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a en" /> method...
2ad40 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2ad50 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 </returns>..
2ad60 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 53 public S
2ad70 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 78 QLiteErrorCode x
2ad80 4f 70 65 6e 28 0d 0a 20 20 20 20 20 20 20 20 20 Open(..
2ad90 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 56 IntPtr pV
2ada0 74 61 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 tab,..
2adb0 20 20 20 20 20 20 72 65 66 20 49 6e 74 50 74 72 ref IntPtr
2adc0 20 70 43 75 72 73 6f 72 0d 0a 20 20 20 20 20 20 pCursor..
2add0 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 20 20 )..
2ade0 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
2adf0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 43 // C
2ae00 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 3b 0d heckDisposed();.
2ae10 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
2ae20 20 20 20 69 66 20 28 6d 6f 64 75 6c 65 20 3d 3d if (module ==
2ae30 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 20 20 20 null)..
2ae40 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
2ae50 72 6e 20 4d 6f 64 75 6c 65 4e 6f 74 41 76 61 69 rn ModuleNotAvai
2ae60 6c 61 62 6c 65 54 61 62 6c 65 45 72 72 6f 72 28 lableTableError(
2ae70 70 56 74 61 62 29 3b 0d 0a 0d 0a 20 20 20 20 20 pVtab);....
2ae80 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
2ae90 6e 20 6d 6f 64 75 6c 65 2e 78 4f 70 65 6e 28 70 n module.xOpen(p
2aea0 56 74 61 62 2c 20 72 65 66 20 70 43 75 72 73 6f Vtab, ref pCurso
2aeb0 72 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 r);..
2aec0 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 }....
2aed0 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////////
2aee0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2aef0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2af00 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2af10 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
2af20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
2af30 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 y>..
2af40 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 /// See the <see
2af50 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 cref="ISQLiteNa
2af60 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6c 6f 73 tiveModule.xClos
2af70 65 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 e" /> method...
2af80 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2af90 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
2afa0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
2afb0 6d 20 6e 61 6d 65 3d 22 70 43 75 72 73 6f 72 22 m name="pCursor"
2afc0 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2afd0 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 // See the <see
2afe0 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
2aff0 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6c 6f 73 65 iveModule.xClose
2b000 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2b010 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2b020 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
2b030 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
2b040 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2b050 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 // See the <see
2b060 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
2b070 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6c 6f 73 65 iveModule.xClose
2b080 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2b090 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2b0a0 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
2b0b0 20 20 20 20 20 20 70 75 62 6c 69 63 20 53 51 4c public SQL
2b0c0 69 74 65 45 72 72 6f 72 43 6f 64 65 20 78 43 6c iteErrorCode xCl
2b0d0 6f 73 65 28 0d 0a 20 20 20 20 20 20 20 20 20 20 ose(..
2b0e0 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 43 75 IntPtr pCu
2b0f0 72 73 6f 72 0d 0a 20 20 20 20 20 20 20 20 20 20 rsor..
2b100 20 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 )..
2b110 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
2b120 20 20 20 20 20 20 20 20 2f 2f 20 43 68 65 63 6b // Check
2b130 44 69 73 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 Disposed();....
2b140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 i
2b150 66 20 28 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c f (module == nul
2b160 6c 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 l)..
2b170 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d return M
2b180 6f 64 75 6c 65 4e 6f 74 41 76 61 69 6c 61 62 6c oduleNotAvailabl
2b190 65 43 75 72 73 6f 72 45 72 72 6f 72 28 70 43 75 eCursorError(pCu
2b1a0 72 73 6f 72 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 rsor);....
2b1b0 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
2b1c0 20 6d 6f 64 75 6c 65 2e 78 43 6c 6f 73 65 28 70 module.xClose(p
2b1d0 43 75 72 73 6f 72 29 3b 0d 0a 20 20 20 20 20 20 Cursor);..
2b1e0 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 }....
2b1f0 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
2b200 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2b210 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2b220 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2b230 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
2b240 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 /// <s
2b250 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
2b260 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
2b270 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
2b280 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
2b290 78 46 69 6c 74 65 72 22 20 2f 3e 20 6d 65 74 68 xFilter" /> meth
2b2a0 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 od...
2b2b0 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
2b2c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2b2d0 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 43 <param name="pC
2b2e0 75 72 73 6f 72 22 3e 0d 0a 20 20 20 20 20 20 20 ursor">..
2b2f0 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
2b300 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
2b310 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
2b320 78 46 69 6c 74 65 72 22 20 2f 3e 20 6d 65 74 68 xFilter" /> meth
2b330 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 od...
2b340 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
2b350 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2b360 70 61 72 61 6d 20 6e 61 6d 65 3d 22 69 64 78 4e param name="idxN
2b370 75 6d 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 um">..
2b380 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 /// See the <s
2b390 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
2b3a0 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 46 69 NativeModule.xFi
2b3b0 6c 74 65 72 22 20 2f 3e 20 6d 65 74 68 6f 64 2e lter" /> method.
2b3c0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2b3d0 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
2b3e0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
2b3f0 61 6d 20 6e 61 6d 65 3d 22 69 64 78 53 74 72 22 am name="idxStr"
2b400 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2b410 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 // See the <see
2b420 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
2b430 69 76 65 4d 6f 64 75 6c 65 2e 78 46 69 6c 74 65 iveModule.xFilte
2b440 72 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 r" /> method...
2b450 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2b460 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 /param>..
2b470 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
2b480 6e 61 6d 65 3d 22 61 72 67 63 22 3e 0d 0a 20 20 name="argc">..
2b490 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 /// Se
2b4a0 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d e the <see cref=
2b4b0 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f "ISQLiteNativeMo
2b4c0 64 75 6c 65 2e 78 46 69 6c 74 65 72 22 20 2f 3e dule.xFilter" />
2b4d0 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 method...
2b4e0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
2b4f0 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 m>..
2b500 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
2b510 22 61 72 67 76 22 3e 0d 0a 20 20 20 20 20 20 20 "argv">..
2b520 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
2b530 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
2b540 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
2b550 78 46 69 6c 74 65 72 22 20 2f 3e 20 6d 65 74 68 xFilter" /> meth
2b560 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 od...
2b570 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
2b580 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2b590 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
2b5a0 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 /// See th
2b5b0 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 e <see cref="ISQ
2b5c0 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
2b5d0 2e 78 46 69 6c 74 65 72 22 20 2f 3e 20 6d 65 74 .xFilter" /> met
2b5e0 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 hod...
2b5f0 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e /// </returns>
2b600 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 75 .. pu
2b610 62 6c 69 63 20 53 51 4c 69 74 65 45 72 72 6f 72 blic SQLiteError
2b620 43 6f 64 65 20 78 46 69 6c 74 65 72 28 0d 0a 20 Code xFilter(..
2b630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 I
2b640 6e 74 50 74 72 20 70 43 75 72 73 6f 72 2c 0d 0a ntPtr pCursor,..
2b650 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2b660 69 6e 74 20 69 64 78 4e 75 6d 2c 0d 0a 20 20 20 int idxNum,..
2b670 20 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 Int
2b680 50 74 72 20 69 64 78 53 74 72 2c 0d 0a 20 20 20 Ptr idxStr,..
2b690 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 int
2b6a0 20 61 72 67 63 2c 0d 0a 20 20 20 20 20 20 20 20 argc,..
2b6b0 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 61 IntPtr a
2b6c0 72 67 76 0d 0a 20 20 20 20 20 20 20 20 20 20 20 rgv..
2b6d0 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 )..
2b6e0 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 {..
2b6f0 20 20 20 20 20 20 20 2f 2f 20 43 68 65 63 6b 44 // CheckD
2b700 69 73 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 20 isposed();....
2b710 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 if
2b720 20 28 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c 6c (module == null
2b730 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 )..
2b740 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d 6f return Mo
2b750 64 75 6c 65 4e 6f 74 41 76 61 69 6c 61 62 6c 65 duleNotAvailable
2b760 43 75 72 73 6f 72 45 72 72 6f 72 28 70 43 75 72 CursorError(pCur
2b770 73 6f 72 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 sor);....
2b780 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 return
2b790 6d 6f 64 75 6c 65 2e 78 46 69 6c 74 65 72 28 70 module.xFilter(p
2b7a0 43 75 72 73 6f 72 2c 20 69 64 78 4e 75 6d 2c 20 Cursor, idxNum,
2b7b0 69 64 78 53 74 72 2c 20 61 72 67 63 2c 20 61 72 idxStr, argc, ar
2b7c0 67 76 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 gv);..
2b7d0 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 }....
2b7e0 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
2b7f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2b800 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2b810 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2b820 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
2b830 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
2b840 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ry>..
2b850 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 /// See the <se
2b860 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e e cref="ISQLiteN
2b870 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 4e 65 78 ativeModule.xNex
2b880 74 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 t" /> method...
2b890 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2b8a0 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
2b8b0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
2b8c0 6d 20 6e 61 6d 65 3d 22 70 43 75 72 73 6f 72 22 m name="pCursor"
2b8d0 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2b8e0 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 // See the <see
2b8f0 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
2b900 69 76 65 4d 6f 64 75 6c 65 2e 78 4e 65 78 74 22 iveModule.xNext"
2b910 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 /> method...
2b920 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 /// </p
2b930 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 aram>..
2b940 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e /// <returns>
2b950 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2b960 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 / See the <see c
2b970 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
2b980 76 65 4d 6f 64 75 6c 65 2e 78 4e 65 78 74 22 20 veModule.xNext"
2b990 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 /> method...
2b9a0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 /// </re
2b9b0 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
2b9c0 20 20 20 20 70 75 62 6c 69 63 20 53 51 4c 69 74 public SQLit
2b9d0 65 45 72 72 6f 72 43 6f 64 65 20 78 4e 65 78 74 eErrorCode xNext
2b9e0 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 (..
2b9f0 20 20 20 49 6e 74 50 74 72 20 70 43 75 72 73 6f IntPtr pCurso
2ba00 72 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 r..
2ba10 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 20 20 )..
2ba20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
2ba30 20 20 20 20 20 2f 2f 20 43 68 65 63 6b 44 69 73 // CheckDis
2ba40 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 20 posed();....
2ba50 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 if (
2ba60 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c 6c 29 0d module == null).
2ba70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2ba80 20 20 20 20 20 72 65 74 75 72 6e 20 4d 6f 64 75 return Modu
2ba90 6c 65 4e 6f 74 41 76 61 69 6c 61 62 6c 65 43 75 leNotAvailableCu
2baa0 72 73 6f 72 45 72 72 6f 72 28 70 43 75 72 73 6f rsorError(pCurso
2bab0 72 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 r);....
2bac0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f return mo
2bad0 64 75 6c 65 2e 78 4e 65 78 74 28 70 43 75 72 73 dule.xNext(pCurs
2bae0 6f 72 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 or);..
2baf0 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 }....
2bb00 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
2bb10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2bb20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2bb30 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2bb40 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
2bb50 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
2bb60 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ry>..
2bb70 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 /// See the <se
2bb80 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e e cref="ISQLiteN
2bb90 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 45 6f 66 ativeModule.xEof
2bba0 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2bbb0 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2bbc0 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
2bbd0 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
2bbe0 20 6e 61 6d 65 3d 22 70 43 75 72 73 6f 72 22 3e name="pCursor">
2bbf0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2bc00 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 / See the <see c
2bc10 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
2bc20 76 65 4d 6f 64 75 6c 65 2e 78 45 6f 66 22 20 2f veModule.xEof" /
2bc30 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
2bc40 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
2bc50 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 am>..
2bc60 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a /// <returns>..
2bc70 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2bc80 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 See the <see cre
2bc90 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 f="ISQLiteNative
2bca0 4d 6f 64 75 6c 65 2e 78 45 6f 66 22 20 2f 3e 20 Module.xEof" />
2bcb0 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 method...
2bcc0 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 /// </retur
2bcd0 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ns>..
2bce0 20 70 75 62 6c 69 63 20 69 6e 74 20 78 45 6f 66 public int xEof
2bcf0 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 (..
2bd00 20 20 20 49 6e 74 50 74 72 20 70 43 75 72 73 6f IntPtr pCurso
2bd10 72 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 r..
2bd20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 20 20 )..
2bd30 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
2bd40 20 20 20 20 20 2f 2f 20 43 68 65 63 6b 44 69 73 // CheckDis
2bd50 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 20 posed();....
2bd60 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 if (
2bd70 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c 6c 29 0d module == null).
2bd80 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2bd90 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 {..
2bda0 20 20 20 20 20 20 20 20 4d 6f 64 75 6c 65 4e 6f ModuleNo
2bdb0 74 41 76 61 69 6c 61 62 6c 65 43 75 72 73 6f 72 tAvailableCursor
2bdc0 45 72 72 6f 72 28 70 43 75 72 73 6f 72 29 3b 0d Error(pCursor);.
2bdd0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2bde0 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0d 0a return 1;..
2bdf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2be00 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 }....
2be10 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 64 75 return modu
2be20 6c 65 2e 78 45 6f 66 28 70 43 75 72 73 6f 72 29 le.xEof(pCursor)
2be30 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d ;.. }
2be40 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
2be50 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2be60 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2be70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2be80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2be90 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 ///....
2bea0 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
2beb0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2bec0 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 / See the <see c
2bed0 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
2bee0 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6c 75 6d 6e veModule.xColumn
2bef0 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2bf00 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2bf10 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
2bf20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
2bf30 20 6e 61 6d 65 3d 22 70 43 75 72 73 6f 72 22 3e name="pCursor">
2bf40 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2bf50 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 / See the <see c
2bf60 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
2bf70 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6c 75 6d 6e veModule.xColumn
2bf80 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2bf90 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2bfa0 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
2bfb0 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
2bfc0 61 6d 65 3d 22 70 43 6f 6e 74 65 78 74 22 3e 0d ame="pContext">.
2bfd0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2bfe0 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 See the <see cr
2bff0 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 ef="ISQLiteNativ
2c000 65 4d 6f 64 75 6c 65 2e 78 43 6f 6c 75 6d 6e 22 eModule.xColumn"
2c010 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 /> method...
2c020 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 /// </p
2c030 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 aram>..
2c040 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
2c050 6d 65 3d 22 69 6e 64 65 78 22 3e 0d 0a 20 20 20 me="index">..
2c060 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 /// See
2c070 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 the <see cref="
2c080 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 ISQLiteNativeMod
2c090 75 6c 65 2e 78 43 6f 6c 75 6d 6e 22 20 2f 3e 20 ule.xColumn" />
2c0a0 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 method...
2c0b0 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
2c0c0 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2c0d0 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 // <returns>..
2c0e0 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 /// Se
2c0f0 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d e the <see cref=
2c100 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f "ISQLiteNativeMo
2c110 64 75 6c 65 2e 78 43 6f 6c 75 6d 6e 22 20 2f 3e dule.xColumn" />
2c120 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 method...
2c130 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 /// </retu
2c140 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 rns>..
2c150 20 20 70 75 62 6c 69 63 20 53 51 4c 69 74 65 45 public SQLiteE
2c160 72 72 6f 72 43 6f 64 65 20 78 43 6f 6c 75 6d 6e rrorCode xColumn
2c170 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 (..
2c180 20 20 20 49 6e 74 50 74 72 20 70 43 75 72 73 6f IntPtr pCurso
2c190 72 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 r,..
2c1a0 20 20 20 20 49 6e 74 50 74 72 20 70 43 6f 6e 74 IntPtr pCont
2c1b0 65 78 74 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 ext,..
2c1c0 20 20 20 20 20 20 69 6e 74 20 69 6e 64 65 78 0d int index.
2c1d0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2c1e0 20 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 )..
2c1f0 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 {..
2c200 20 20 20 2f 2f 20 43 68 65 63 6b 44 69 73 70 6f // CheckDispo
2c210 73 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 sed();....
2c220 20 20 20 20 20 20 20 20 20 20 69 66 20 28 6d 6f if (mo
2c230 64 75 6c 65 20 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 dule == null)..
2c240 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2c250 20 20 20 72 65 74 75 72 6e 20 4d 6f 64 75 6c 65 return Module
2c260 4e 6f 74 41 76 61 69 6c 61 62 6c 65 43 75 72 73 NotAvailableCurs
2c270 6f 72 45 72 72 6f 72 28 70 43 75 72 73 6f 72 29 orError(pCursor)
2c280 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
2c290 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 64 75 return modu
2c2a0 6c 65 2e 78 43 6f 6c 75 6d 6e 28 70 43 75 72 73 le.xColumn(pCurs
2c2b0 6f 72 2c 20 70 43 6f 6e 74 65 78 74 2c 20 69 6e or, pContext, in
2c2c0 64 65 78 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 dex);..
2c2d0 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 }....
2c2e0 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
2c2f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2c300 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2c310 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2c320 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
2c330 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
2c340 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 ary>..
2c350 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 /// See the <s
2c360 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
2c370 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 52 6f NativeModule.xRo
2c380 77 49 64 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d wId" /> method..
2c390 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2c3a0 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
2c3b0 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 /// <pa
2c3c0 72 61 6d 20 6e 61 6d 65 3d 22 70 43 75 72 73 6f ram name="pCurso
2c3d0 72 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 r">..
2c3e0 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 /// See the <se
2c3f0 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e e cref="ISQLiteN
2c400 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 52 6f 77 ativeModule.xRow
2c410 49 64 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a Id" /> method...
2c420 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2c430 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
2c440 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
2c450 20 6e 61 6d 65 3d 22 72 6f 77 49 64 22 3e 0d 0a name="rowId">..
2c460 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2c470 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 See the <see cre
2c480 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 f="ISQLiteNative
2c490 4d 6f 64 75 6c 65 2e 78 52 6f 77 49 64 22 20 2f Module.xRowId" /
2c4a0 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
2c4b0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
2c4c0 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 am>..
2c4d0 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a /// <returns>..
2c4e0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2c4f0 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 See the <see cre
2c500 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 f="ISQLiteNative
2c510 4d 6f 64 75 6c 65 2e 78 52 6f 77 49 64 22 20 2f Module.xRowId" /
2c520 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
2c530 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 /// </ret
2c540 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 urns>..
2c550 20 20 20 70 75 62 6c 69 63 20 53 51 4c 69 74 65 public SQLite
2c560 45 72 72 6f 72 43 6f 64 65 20 78 52 6f 77 49 64 ErrorCode xRowId
2c570 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 (..
2c580 20 20 20 49 6e 74 50 74 72 20 70 43 75 72 73 6f IntPtr pCurso
2c590 72 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 r,..
2c5a0 20 20 20 20 72 65 66 20 6c 6f 6e 67 20 72 6f 77 ref long row
2c5b0 49 64 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 Id..
2c5c0 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 20 )..
2c5d0 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
2c5e0 20 20 20 20 20 20 2f 2f 20 43 68 65 63 6b 44 69 // CheckDi
2c5f0 73 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 sposed();....
2c600 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 if
2c610 28 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c 6c 29 (module == null)
2c620 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
2c630 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d 6f 64 return Mod
2c640 75 6c 65 4e 6f 74 41 76 61 69 6c 61 62 6c 65 43 uleNotAvailableC
2c650 75 72 73 6f 72 45 72 72 6f 72 28 70 43 75 72 73 ursorError(pCurs
2c660 6f 72 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 or);....
2c670 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d return m
2c680 6f 64 75 6c 65 2e 78 52 6f 77 49 64 28 70 43 75 odule.xRowId(pCu
2c690 72 73 6f 72 2c 20 72 65 66 20 72 6f 77 49 64 29 rsor, ref rowId)
2c6a0 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d ;.. }
2c6b0 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
2c6c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2c6d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2c6e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2c6f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2c700 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 ///....
2c710 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
2c720 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2c730 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 / See the <see c
2c740 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
2c750 76 65 4d 6f 64 75 6c 65 2e 78 55 70 64 61 74 65 veModule.xUpdate
2c760 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2c770 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2c780 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
2c790 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
2c7a0 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 3e 0d 0a name="pVtab">..
2c7b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2c7c0 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 See the <see cre
2c7d0 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 f="ISQLiteNative
2c7e0 4d 6f 64 75 6c 65 2e 78 55 70 64 61 74 65 22 20 Module.xUpdate"
2c7f0 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 /> method...
2c800 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
2c810 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 ram>..
2c820 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
2c830 65 3d 22 61 72 67 63 22 3e 0d 0a 20 20 20 20 20 e="argc">..
2c840 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 /// See t
2c850 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 he <see cref="IS
2c860 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c QLiteNativeModul
2c870 65 2e 78 55 70 64 61 74 65 22 20 2f 3e 20 6d 65 e.xUpdate" /> me
2c880 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 thod...
2c890 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
2c8a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2c8b0 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 61 72 <param name="ar
2c8c0 67 76 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 gv">..
2c8d0 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 /// See the <s
2c8e0 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
2c8f0 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 55 70 NativeModule.xUp
2c900 64 61 74 65 22 20 2f 3e 20 6d 65 74 68 6f 64 2e date" /> method.
2c910 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2c920 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
2c930 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
2c940 61 6d 20 6e 61 6d 65 3d 22 72 6f 77 49 64 22 3e am name="rowId">
2c950 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2c960 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 / See the <see c
2c970 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
2c980 76 65 4d 6f 64 75 6c 65 2e 78 55 70 64 61 74 65 veModule.xUpdate
2c990 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2c9a0 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2c9b0 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
2c9c0 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
2c9d0 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2c9e0 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 // See the <see
2c9f0 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
2ca00 69 76 65 4d 6f 64 75 6c 65 2e 78 55 70 64 61 74 iveModule.xUpdat
2ca10 65 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 e" /> method...
2ca20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2ca30 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 /returns>..
2ca40 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 53 51 public SQ
2ca50 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 78 55 LiteErrorCode xU
2ca60 70 64 61 74 65 28 0d 0a 20 20 20 20 20 20 20 20 pdate(..
2ca70 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 IntPtr p
2ca80 56 74 61 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 Vtab,..
2ca90 20 20 20 20 20 20 20 69 6e 74 20 61 72 67 63 2c int argc,
2caa0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
2cab0 20 20 49 6e 74 50 74 72 20 61 72 67 76 2c 0d 0a IntPtr argv,..
2cac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2cad0 72 65 66 20 6c 6f 6e 67 20 72 6f 77 49 64 0d 0a ref long rowId..
2cae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2caf0 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b ).. {
2cb00 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
2cb10 20 20 2f 2f 20 43 68 65 63 6b 44 69 73 70 6f 73 // CheckDispos
2cb20 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 ed();....
2cb30 20 20 20 20 20 20 20 20 20 69 66 20 28 6d 6f 64 if (mod
2cb40 75 6c 65 20 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 20 ule == null)..
2cb50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2cb60 20 20 72 65 74 75 72 6e 20 4d 6f 64 75 6c 65 4e return ModuleN
2cb70 6f 74 41 76 61 69 6c 61 62 6c 65 54 61 62 6c 65 otAvailableTable
2cb80 45 72 72 6f 72 28 70 56 74 61 62 29 3b 0d 0a 0d Error(pVtab);...
2cb90 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2cba0 20 72 65 74 75 72 6e 20 6d 6f 64 75 6c 65 2e 78 return module.x
2cbb0 55 70 64 61 74 65 28 70 56 74 61 62 2c 20 61 72 Update(pVtab, ar
2cbc0 67 63 2c 20 61 72 67 76 2c 20 72 65 66 20 72 6f gc, argv, ref ro
2cbd0 77 49 64 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 wId);..
2cbe0 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 }....
2cbf0 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
2cc00 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2cc10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2cc20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2cc30 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
2cc40 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
2cc50 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 ary>..
2cc60 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 /// See the <s
2cc70 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
2cc80 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 42 65 NativeModule.xBe
2cc90 67 69 6e 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d gin" /> method..
2cca0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2ccb0 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
2ccc0 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 /// <pa
2ccd0 72 61 6d 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 ram name="pVtab"
2cce0 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2ccf0 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 // See the <see
2cd00 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
2cd10 69 76 65 4d 6f 64 75 6c 65 2e 78 42 65 67 69 6e iveModule.xBegin
2cd20 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2cd30 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2cd40 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
2cd50 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
2cd60 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2cd70 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 // See the <see
2cd80 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
2cd90 69 76 65 4d 6f 64 75 6c 65 2e 78 42 65 67 69 6e iveModule.xBegin
2cda0 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2cdb0 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2cdc0 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
2cdd0 20 20 20 20 20 20 70 75 62 6c 69 63 20 53 51 4c public SQL
2cde0 69 74 65 45 72 72 6f 72 43 6f 64 65 20 78 42 65 iteErrorCode xBe
2cdf0 67 69 6e 28 0d 0a 20 20 20 20 20 20 20 20 20 20 gin(..
2ce00 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 56 74 IntPtr pVt
2ce10 61 62 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ab..
2ce20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 20 )..
2ce30 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
2ce40 20 20 20 20 20 20 2f 2f 20 43 68 65 63 6b 44 69 // CheckDi
2ce50 73 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 sposed();....
2ce60 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 if
2ce70 28 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c 6c 29 (module == null)
2ce80 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
2ce90 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d 6f 64 return Mod
2cea0 75 6c 65 4e 6f 74 41 76 61 69 6c 61 62 6c 65 54 uleNotAvailableT
2ceb0 61 62 6c 65 45 72 72 6f 72 28 70 56 74 61 62 29 ableError(pVtab)
2cec0 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
2ced0 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 64 75 return modu
2cee0 6c 65 2e 78 42 65 67 69 6e 28 70 56 74 61 62 29 le.xBegin(pVtab)
2cef0 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d ;.. }
2cf00 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
2cf10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2cf20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2cf30 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2cf40 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2cf50 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 ///....
2cf60 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
2cf70 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2cf80 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 / See the <see c
2cf90 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
2cfa0 76 65 4d 6f 64 75 6c 65 2e 78 53 79 6e 63 22 20 veModule.xSync"
2cfb0 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 /> method...
2cfc0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
2cfd0 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
2cfe0 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
2cff0 61 6d 65 3d 22 70 56 74 61 62 22 3e 0d 0a 20 20 ame="pVtab">..
2d000 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 /// Se
2d010 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d e the <see cref=
2d020 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f "ISQLiteNativeMo
2d030 64 75 6c 65 2e 78 53 79 6e 63 22 20 2f 3e 20 6d dule.xSync" /> m
2d040 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 ethod...
2d050 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
2d060 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2d070 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 / <returns>..
2d080 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 /// See
2d090 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 the <see cref="
2d0a0 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 ISQLiteNativeMod
2d0b0 75 6c 65 2e 78 53 79 6e 63 22 20 2f 3e 20 6d 65 ule.xSync" /> me
2d0c0 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 thod...
2d0d0 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 /// </returns
2d0e0 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 >.. p
2d0f0 75 62 6c 69 63 20 53 51 4c 69 74 65 45 72 72 6f ublic SQLiteErro
2d100 72 43 6f 64 65 20 78 53 79 6e 63 28 0d 0a 20 20 rCode xSync(..
2d110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 6e In
2d120 74 50 74 72 20 70 56 74 61 62 0d 0a 20 20 20 20 tPtr pVtab..
2d130 20 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 )..
2d140 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 {..
2d150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f //
2d160 20 43 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 CheckDisposed()
2d170 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
2d180 20 20 20 20 20 69 66 20 28 6d 6f 64 75 6c 65 20 if (module
2d190 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 20 == null)..
2d1a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
2d1b0 74 75 72 6e 20 4d 6f 64 75 6c 65 4e 6f 74 41 76 turn ModuleNotAv
2d1c0 61 69 6c 61 62 6c 65 54 61 62 6c 65 45 72 72 6f ailableTableErro
2d1d0 72 28 70 56 74 61 62 29 3b 0d 0a 0d 0a 20 20 20 r(pVtab);....
2d1e0 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 ret
2d1f0 75 72 6e 20 6d 6f 64 75 6c 65 2e 78 53 79 6e 63 urn module.xSync
2d200 28 70 56 74 61 62 29 3b 0d 0a 20 20 20 20 20 20 (pVtab);..
2d210 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 }....
2d220 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
2d230 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2d240 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2d250 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2d260 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
2d270 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 /// <s
2d280 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
2d290 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
2d2a0 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
2d2b0 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
2d2c0 78 43 6f 6d 6d 69 74 22 20 2f 3e 20 6d 65 74 68 xCommit" /> meth
2d2d0 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 od...
2d2e0 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
2d2f0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2d300 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 56 <param name="pV
2d310 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 tab">..
2d320 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c /// See the <
2d330 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 see cref="ISQLit
2d340 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 eNativeModule.xC
2d350 6f 6d 6d 69 74 22 20 2f 3e 20 6d 65 74 68 6f 64 ommit" /> method
2d360 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f ... /
2d370 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
2d380 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 /// <re
2d390 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
2d3a0 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 /// See the
2d3b0 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 <see cref="ISQLi
2d3c0 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 teNativeModule.x
2d3d0 43 6f 6d 6d 69 74 22 20 2f 3e 20 6d 65 74 68 6f Commit" /> metho
2d3e0 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 d...
2d3f0 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a /// </returns>..
2d400 20 20 20 20 20 20 20 20 20 20 20 20 70 75 62 6c publ
2d410 69 63 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f ic SQLiteErrorCo
2d420 64 65 20 78 43 6f 6d 6d 69 74 28 0d 0a 20 20 20 de xCommit(..
2d430 20 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 Int
2d440 50 74 72 20 70 56 74 61 62 0d 0a 20 20 20 20 20 Ptr pVtab..
2d450 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 20 )..
2d460 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 {..
2d470 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 //
2d480 43 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 3b CheckDisposed();
2d490 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
2d4a0 20 20 20 20 69 66 20 28 6d 6f 64 75 6c 65 20 3d if (module =
2d4b0 3d 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 20 20 = null)..
2d4c0 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 ret
2d4d0 75 72 6e 20 4d 6f 64 75 6c 65 4e 6f 74 41 76 61 urn ModuleNotAva
2d4e0 69 6c 61 62 6c 65 54 61 62 6c 65 45 72 72 6f 72 ilableTableError
2d4f0 28 70 56 74 61 62 29 3b 0d 0a 0d 0a 20 20 20 20 (pVtab);....
2d500 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
2d510 72 6e 20 6d 6f 64 75 6c 65 2e 78 43 6f 6d 6d 69 rn module.xCommi
2d520 74 28 70 56 74 61 62 29 3b 0d 0a 20 20 20 20 20 t(pVtab);..
2d530 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 }....
2d540 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f ////////
2d550 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2d560 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2d570 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2d580 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
2d590 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2d5a0 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
2d5b0 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 /// See th
2d5c0 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 e <see cref="ISQ
2d5d0 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
2d5e0 2e 78 52 6f 6c 6c 62 61 63 6b 22 20 2f 3e 20 6d .xRollback" /> m
2d5f0 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 ethod...
2d600 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
2d610 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 y>..
2d620 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
2d630 22 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 "pVtab">..
2d640 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 /// See th
2d650 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 e <see cref="ISQ
2d660 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
2d670 2e 78 52 6f 6c 6c 62 61 63 6b 22 20 2f 3e 20 6d .xRollback" /> m
2d680 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 ethod...
2d690 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
2d6a0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2d6b0 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 / <returns>..
2d6c0 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 /// See
2d6d0 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 the <see cref="
2d6e0 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 ISQLiteNativeMod
2d6f0 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 6b 22 20 2f ule.xRollback" /
2d700 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
2d710 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 /// </ret
2d720 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 urns>..
2d730 20 20 20 70 75 62 6c 69 63 20 53 51 4c 69 74 65 public SQLite
2d740 45 72 72 6f 72 43 6f 64 65 20 78 52 6f 6c 6c 62 ErrorCode xRollb
2d750 61 63 6b 28 0d 0a 20 20 20 20 20 20 20 20 20 20 ack(..
2d760 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 56 74 IntPtr pVt
2d770 61 62 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ab..
2d780 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 20 )..
2d790 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
2d7a0 20 20 20 20 20 20 2f 2f 20 43 68 65 63 6b 44 69 // CheckDi
2d7b0 73 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 sposed();....
2d7c0 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 if
2d7d0 28 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c 6c 29 (module == null)
2d7e0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
2d7f0 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d 6f 64 return Mod
2d800 75 6c 65 4e 6f 74 41 76 61 69 6c 61 62 6c 65 54 uleNotAvailableT
2d810 61 62 6c 65 45 72 72 6f 72 28 70 56 74 61 62 29 ableError(pVtab)
2d820 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
2d830 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 64 75 return modu
2d840 6c 65 2e 78 52 6f 6c 6c 62 61 63 6b 28 70 56 74 le.xRollback(pVt
2d850 61 62 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 ab);..
2d860 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 }....
2d870 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
2d880 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2d890 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2d8a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2d8b0 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
2d8c0 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
2d8d0 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ry>..
2d8e0 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 /// See the <se
2d8f0 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e e cref="ISQLiteN
2d900 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 46 69 6e ativeModule.xFin
2d910 64 46 75 6e 63 74 69 6f 6e 22 20 2f 3e 20 6d 65 dFunction" /> me
2d920 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 thod...
2d930 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
2d940 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2d950 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
2d960 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 pVtab">..
2d970 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
2d980 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
2d990 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
2d9a0 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e 22 20 2f xFindFunction" /
2d9b0 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
2d9c0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
2d9d0 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 am>..
2d9e0 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
2d9f0 3d 22 6e 41 72 67 22 3e 0d 0a 20 20 20 20 20 20 ="nArg">..
2da00 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 /// See th
2da10 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 e <see cref="ISQ
2da20 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
2da30 2e 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e 22 20 .xFindFunction"
2da40 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 /> method...
2da50 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
2da60 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 ram>..
2da70 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
2da80 65 3d 22 7a 4e 61 6d 65 22 3e 0d 0a 20 20 20 20 e="zName">..
2da90 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 /// See
2daa0 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 the <see cref="I
2dab0 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 SQLiteNativeModu
2dac0 6c 65 2e 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e le.xFindFunction
2dad0 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2dae0 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2daf0 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
2db00 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
2db10 61 6d 65 3d 22 63 61 6c 6c 62 61 63 6b 22 3e 0d ame="callback">.
2db20 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2db30 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 See the <see cr
2db40 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 ef="ISQLiteNativ
2db50 65 4d 6f 64 75 6c 65 2e 78 46 69 6e 64 46 75 6e eModule.xFindFun
2db60 63 74 69 6f 6e 22 20 2f 3e 20 6d 65 74 68 6f 64 ction" /> method
2db70 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f ... /
2db80 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
2db90 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 /// <pa
2dba0 72 61 6d 20 6e 61 6d 65 3d 22 70 43 6c 69 65 6e ram name="pClien
2dbb0 74 44 61 74 61 22 3e 0d 0a 20 20 20 20 20 20 20 tData">..
2dbc0 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
2dbd0 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
2dbe0 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
2dbf0 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e 22 20 2f xFindFunction" /
2dc00 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
2dc10 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
2dc20 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 am>..
2dc30 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a /// <returns>..
2dc40 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2dc50 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 See the <see cre
2dc60 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 f="ISQLiteNative
2dc70 4d 6f 64 75 6c 65 2e 78 46 69 6e 64 46 75 6e 63 Module.xFindFunc
2dc80 74 69 6f 6e 22 20 2f 3e 20 6d 65 74 68 6f 64 2e tion" /> method.
2dc90 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2dca0 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 / </returns>..
2dcb0 20 20 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 public
2dcc0 20 69 6e 74 20 78 46 69 6e 64 46 75 6e 63 74 69 int xFindFuncti
2dcd0 6f 6e 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 on(..
2dce0 20 20 20 20 20 49 6e 74 50 74 72 20 70 56 74 61 IntPtr pVta
2dcf0 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 b,..
2dd00 20 20 20 20 69 6e 74 20 6e 41 72 67 2c 0d 0a 20 int nArg,..
2dd10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 I
2dd20 6e 74 50 74 72 20 7a 4e 61 6d 65 2c 0d 0a 20 20 ntPtr zName,..
2dd30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
2dd40 66 20 53 51 4c 69 74 65 43 61 6c 6c 62 61 63 6b f SQLiteCallback
2dd50 20 63 61 6c 6c 62 61 63 6b 2c 0d 0a 20 20 20 20 callback,..
2dd60 20 20 20 20 20 20 20 20 20 20 20 20 72 65 66 20 ref
2dd70 49 6e 74 50 74 72 20 70 43 6c 69 65 6e 74 44 61 IntPtr pClientDa
2dd80 74 61 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ta..
2dd90 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 20 )..
2dda0 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
2ddb0 20 20 20 20 20 20 2f 2f 20 43 68 65 63 6b 44 69 // CheckDi
2ddc0 73 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 sposed();....
2ddd0 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 if
2dde0 28 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c 6c 29 (module == null)
2ddf0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
2de00 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
2de10 20 20 20 20 20 20 20 20 20 4d 6f 64 75 6c 65 4e ModuleN
2de20 6f 74 41 76 61 69 6c 61 62 6c 65 54 61 62 6c 65 otAvailableTable
2de30 45 72 72 6f 72 28 70 56 74 61 62 29 3b 0d 0a 20 Error(pVtab);..
2de40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2de50 20 20 20 72 65 74 75 72 6e 20 30 3b 0d 0a 20 20 return 0;..
2de60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d }.
2de70 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
2de80 20 20 20 72 65 74 75 72 6e 20 6d 6f 64 75 6c 65 return module
2de90 2e 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28 0d .xFindFunction(.
2dea0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2deb0 20 20 20 20 20 70 56 74 61 62 2c 20 6e 41 72 67 pVtab, nArg
2dec0 2c 20 7a 4e 61 6d 65 2c 20 72 65 66 20 63 61 6c , zName, ref cal
2ded0 6c 62 61 63 6b 2c 20 72 65 66 20 70 43 6c 69 65 lback, ref pClie
2dee0 6e 74 44 61 74 61 29 3b 0d 0a 20 20 20 20 20 20 ntData);..
2def0 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 }....
2df00 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
2df10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2df20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2df30 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2df40 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
2df50 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 /// <s
2df60 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
2df70 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
2df80 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
2df90 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
2dfa0 78 52 65 6e 61 6d 65 22 20 2f 3e 20 6d 65 74 68 xRename" /> meth
2dfb0 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 od...
2dfc0 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d /// </summary>.
2dfd0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2dfe0 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 56 <param name="pV
2dff0 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 tab">..
2e000 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c /// See the <
2e010 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 see cref="ISQLit
2e020 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 52 eNativeModule.xR
2e030 65 6e 61 6d 65 22 20 2f 3e 20 6d 65 74 68 6f 64 ename" /> method
2e040 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f ... /
2e050 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
2e060 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 /// <pa
2e070 72 61 6d 20 6e 61 6d 65 3d 22 7a 4e 65 77 22 3e ram name="zNew">
2e080 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2e090 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 / See the <see c
2e0a0 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
2e0b0 76 65 4d 6f 64 75 6c 65 2e 78 52 65 6e 61 6d 65 veModule.xRename
2e0c0 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 " /> method...
2e0d0 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2e0e0 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
2e0f0 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 /// <returns
2e100 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2e110 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 // See the <see
2e120 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
2e130 69 76 65 4d 6f 64 75 6c 65 2e 78 52 65 6e 61 6d iveModule.xRenam
2e140 65 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 e" /> method...
2e150 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2e160 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 /returns>..
2e170 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 53 51 public SQ
2e180 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 78 52 LiteErrorCode xR
2e190 65 6e 61 6d 65 28 0d 0a 20 20 20 20 20 20 20 20 ename(..
2e1a0 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 IntPtr p
2e1b0 56 74 61 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 Vtab,..
2e1c0 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 7a 4e IntPtr zN
2e1d0 65 77 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ew..
2e1e0 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 20 )..
2e1f0 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
2e200 20 20 20 20 20 20 2f 2f 20 43 68 65 63 6b 44 69 // CheckDi
2e210 73 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 sposed();....
2e220 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 if
2e230 28 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c 6c 29 (module == null)
2e240 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
2e250 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d 6f 64 return Mod
2e260 75 6c 65 4e 6f 74 41 76 61 69 6c 61 62 6c 65 54 uleNotAvailableT
2e270 61 62 6c 65 45 72 72 6f 72 28 70 56 74 61 62 29 ableError(pVtab)
2e280 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
2e290 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 64 75 return modu
2e2a0 6c 65 2e 78 52 65 6e 61 6d 65 28 70 56 74 61 62 le.xRename(pVtab
2e2b0 2c 20 7a 4e 65 77 29 3b 0d 0a 20 20 20 20 20 20 , zNew);..
2e2c0 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 }....
2e2d0 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////
2e2e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2e2f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2e300 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2e310 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
2e320 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 /// <s
2e330 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
2e340 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
2e350 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
2e360 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
2e370 78 53 61 76 65 70 6f 69 6e 74 22 20 2f 3e 20 6d xSavepoint" /> m
2e380 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 ethod...
2e390 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
2e3a0 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 y>..
2e3b0 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
2e3c0 22 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 "pVtab">..
2e3d0 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 /// See th
2e3e0 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 e <see cref="ISQ
2e3f0 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
2e400 2e 78 53 61 76 65 70 6f 69 6e 74 22 20 2f 3e 20 .xSavepoint" />
2e410 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 method...
2e420 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
2e430 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2e440 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
2e450 69 53 61 76 65 70 6f 69 6e 74 22 3e 0d 0a 20 20 iSavepoint">..
2e460 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 /// Se
2e470 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d e the <see cref=
2e480 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f "ISQLiteNativeMo
2e490 64 75 6c 65 2e 78 53 61 76 65 70 6f 69 6e 74 22 dule.xSavepoint"
2e4a0 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 /> method...
2e4b0 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 /// </p
2e4c0 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 20 aram>..
2e4d0 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e /// <returns>
2e4e0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2e4f0 2f 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 / See the <see c
2e500 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
2e510 76 65 4d 6f 64 75 6c 65 2e 78 53 61 76 65 70 6f veModule.xSavepo
2e520 69 6e 74 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d int" /> method..
2e530 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2e540 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 </returns>..
2e550 20 20 20 20 20 20 20 20 20 70 75 62 6c 69 63 20 public
2e560 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 SQLiteErrorCode
2e570 78 53 61 76 65 70 6f 69 6e 74 28 0d 0a 20 20 20 xSavepoint(..
2e580 20 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 Int
2e590 50 74 72 20 70 56 74 61 62 2c 0d 0a 20 20 20 20 Ptr pVtab,..
2e5a0 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 int
2e5b0 69 53 61 76 65 70 6f 69 6e 74 0d 0a 20 20 20 20 iSavepoint..
2e5c0 20 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 )..
2e5d0 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 {..
2e5e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f //
2e5f0 20 43 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 CheckDisposed()
2e600 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
2e610 20 20 20 20 20 69 66 20 28 6d 6f 64 75 6c 65 20 if (module
2e620 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 20 == null)..
2e630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
2e640 74 75 72 6e 20 4d 6f 64 75 6c 65 4e 6f 74 41 76 turn ModuleNotAv
2e650 61 69 6c 61 62 6c 65 54 61 62 6c 65 45 72 72 6f ailableTableErro
2e660 72 28 70 56 74 61 62 29 3b 0d 0a 0d 0a 20 20 20 r(pVtab);....
2e670 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 ret
2e680 75 72 6e 20 6d 6f 64 75 6c 65 2e 78 53 61 76 65 urn module.xSave
2e690 70 6f 69 6e 74 28 70 56 74 61 62 2c 20 69 53 61 point(pVtab, iSa
2e6a0 76 65 70 6f 69 6e 74 29 3b 0d 0a 20 20 20 20 20 vepoint);..
2e6b0 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 }....
2e6c0 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f ////////
2e6d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2e6e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2e6f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2e700 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
2e710 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2e720 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
2e730 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 /// See th
2e740 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 e <see cref="ISQ
2e750 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
2e760 2e 78 52 65 6c 65 61 73 65 22 20 2f 3e 20 6d 65 .xRelease" /> me
2e770 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 thod...
2e780 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
2e790 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f >.. /
2e7a0 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
2e7b0 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 20 20 pVtab">..
2e7c0 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 /// See the
2e7d0 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c <see cref="ISQL
2e7e0 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e iteNativeModule.
2e7f0 78 52 65 6c 65 61 73 65 22 20 2f 3e 20 6d 65 74 xRelease" /> met
2e800 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 hod...
2e810 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
2e820 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2e830 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 69 53 61 <param name="iSa
2e840 76 65 70 6f 69 6e 74 22 3e 0d 0a 20 20 20 20 20 vepoint">..
2e850 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 /// See t
2e860 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 he <see cref="IS
2e870 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c QLiteNativeModul
2e880 65 2e 78 52 65 6c 65 61 73 65 22 20 2f 3e 20 6d e.xRelease" /> m
2e890 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 ethod...
2e8a0 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e /// </param>
2e8b0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2e8c0 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 / <returns>..
2e8d0 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 /// See
2e8e0 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 the <see cref="
2e8f0 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 ISQLiteNativeMod
2e900 75 6c 65 2e 78 52 65 6c 65 61 73 65 22 20 2f 3e ule.xRelease" />
2e910 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20 method...
2e920 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 /// </retu
2e930 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 rns>..
2e940 20 20 70 75 62 6c 69 63 20 53 51 4c 69 74 65 45 public SQLiteE
2e950 72 72 6f 72 43 6f 64 65 20 78 52 65 6c 65 61 73 rrorCode xReleas
2e960 65 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 e(..
2e970 20 20 20 20 49 6e 74 50 74 72 20 70 56 74 61 62 IntPtr pVtab
2e980 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ,..
2e990 20 20 20 69 6e 74 20 69 53 61 76 65 70 6f 69 6e int iSavepoin
2e9a0 74 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 t..
2e9b0 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 20 20 )..
2e9c0 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
2e9d0 20 20 20 20 20 2f 2f 20 43 68 65 63 6b 44 69 73 // CheckDis
2e9e0 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 20 posed();....
2e9f0 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 if (
2ea00 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 6c 6c 29 0d module == null).
2ea10 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2ea20 20 20 20 20 20 72 65 74 75 72 6e 20 4d 6f 64 75 return Modu
2ea30 6c 65 4e 6f 74 41 76 61 69 6c 61 62 6c 65 54 61 leNotAvailableTa
2ea40 62 6c 65 45 72 72 6f 72 28 70 56 74 61 62 29 3b bleError(pVtab);
2ea50 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
2ea60 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 64 75 6c return modul
2ea70 65 2e 78 52 65 6c 65 61 73 65 28 70 56 74 61 62 e.xRelease(pVtab
2ea80 2c 20 69 53 61 76 65 70 6f 69 6e 74 29 3b 0d 0a , iSavepoint);..
2ea90 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 0d }...
2eaa0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2eab0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2eac0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2ead0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2eae0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2eaf0 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
2eb00 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
2eb10 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 53 /// S
2eb20 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 ee the <see cref
2eb30 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d ="ISQLiteNativeM
2eb40 6f 64 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 6b 54 odule.xRollbackT
2eb50 6f 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 o" /> method...
2eb60 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c /// <
2eb70 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
2eb80 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
2eb90 6d 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 3e 0d m name="pVtab">.
2eba0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2ebb0 20 53 65 65 20 74 68 65 20 3c 73 65 65 20 63 72 See the <see cr
2ebc0 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 ef="ISQLiteNativ
2ebd0 65 4d 6f 64 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 eModule.xRollbac
2ebe0 6b 54 6f 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d kTo" /> method..
2ebf0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2ec00 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
2ec10 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
2ec20 6d 20 6e 61 6d 65 3d 22 69 53 61 76 65 70 6f 69 m name="iSavepoi
2ec30 6e 74 22 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 nt">..
2ec40 20 20 2f 2f 2f 20 53 65 65 20 74 68 65 20 3c 73 /// See the <s
2ec50 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
2ec60 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 52 6f NativeModule.xRo
2ec70 6c 6c 62 61 63 6b 54 6f 22 20 2f 3e 20 6d 65 74 llbackTo" /> met
2ec80 68 6f 64 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 hod...
2ec90 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
2eca0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2ecb0 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 <returns>..
2ecc0 20 20 20 20 20 20 20 2f 2f 2f 20 53 65 65 20 74 /// See t
2ecd0 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 he <see cref="IS
2ece0 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c QLiteNativeModul
2ecf0 65 2e 78 52 6f 6c 6c 62 61 63 6b 54 6f 22 20 2f e.xRollbackTo" /
2ed00 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 > method...
2ed10 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 /// </ret
2ed20 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 20 urns>..
2ed30 20 20 20 70 75 62 6c 69 63 20 53 51 4c 69 74 65 public SQLite
2ed40 45 72 72 6f 72 43 6f 64 65 20 78 52 6f 6c 6c 62 ErrorCode xRollb
2ed50 61 63 6b 54 6f 28 0d 0a 20 20 20 20 20 20 20 20 ackTo(..
2ed60 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 IntPtr p
2ed70 56 74 61 62 2c 0d 0a 20 20 20 20 20 20 20 20 20 Vtab,..
2ed80 20 20 20 20 20 20 20 69 6e 74 20 69 53 61 76 65 int iSave
2ed90 70 6f 69 6e 74 0d 0a 20 20 20 20 20 20 20 20 20 point..
2eda0 20 20 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 )..
2edb0 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
2edc0 20 20 20 20 20 20 20 20 20 2f 2f 20 43 68 65 63 // Chec
2edd0 6b 44 69 73 70 6f 73 65 64 28 29 3b 0d 0a 0d 0a kDisposed();....
2ede0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2edf0 69 66 20 28 6d 6f 64 75 6c 65 20 3d 3d 20 6e 75 if (module == nu
2ee00 6c 6c 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ll)..
2ee10 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 return
2ee20 4d 6f 64 75 6c 65 4e 6f 74 41 76 61 69 6c 61 62 ModuleNotAvailab
2ee30 6c 65 54 61 62 6c 65 45 72 72 6f 72 28 70 56 74 leTableError(pVt
2ee40 61 62 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ab);....
2ee50 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d return m
2ee60 6f 64 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 6b 54 odule.xRollbackT
2ee70 6f 28 70 56 74 61 62 2c 20 69 53 61 76 65 70 6f o(pVtab, iSavepo
2ee80 69 6e 74 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 int);..
2ee90 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 }..
2eea0 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a #endregion....
2eeb0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 2f ////
2eec0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2eed0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2eee0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2eef0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
2ef00 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 23 ... #
2ef10 72 65 67 69 6f 6e 20 49 44 69 73 70 6f 73 61 62 region IDisposab
2ef20 6c 65 20 4d 65 6d 62 65 72 73 0d 0a 20 20 20 20 le Members..
2ef30 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
2ef40 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 mary>..
2ef50 20 20 20 2f 2f 2f 20 44 69 73 70 6f 73 65 73 20 /// Disposes
2ef60 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74 20 69 of this object i
2ef70 6e 73 74 61 6e 63 65 2e 0d 0a 20 20 20 20 20 20 nstance...
2ef80 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d /// </summ
2ef90 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 ary>..
2efa0 20 20 70 75 62 6c 69 63 20 76 6f 69 64 20 44 69 public void Di
2efb0 73 70 6f 73 65 28 29 0d 0a 20 20 20 20 20 20 20 spose()..
2efc0 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 {..
2efd0 20 20 20 20 20 20 20 20 44 69 73 70 6f 73 65 28 Dispose(
2efe0 74 72 75 65 29 3b 0d 0a 20 20 20 20 20 20 20 20 true);..
2eff0 20 20 20 20 20 20 20 20 47 43 2e 53 75 70 70 72 GC.Suppr
2f000 65 73 73 46 69 6e 61 6c 69 7a 65 28 74 68 69 73 essFinalize(this
2f010 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 );..
2f020 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 23 }.. #
2f030 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 endregion....
2f040 20 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f ///////
2f050 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f060 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f070 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f080 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a ////////////....
2f090 20 20 20 20 20 20 20 20 20 20 20 20 23 72 65 67 #reg
2f0a0 69 6f 6e 20 49 44 69 73 70 6f 73 61 62 6c 65 20 ion IDisposable
2f0b0 22 50 61 74 74 65 72 6e 22 20 4d 65 6d 62 65 72 "Pattern" Member
2f0c0 73 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 s.. p
2f0d0 72 69 76 61 74 65 20 62 6f 6f 6c 20 64 69 73 70 rivate bool disp
2f0e0 6f 73 65 64 3b 0d 0a 20 20 20 20 20 20 20 20 20 osed;..
2f0f0 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
2f100 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2f110 2f 20 54 68 72 6f 77 73 20 61 6e 20 3c 73 65 65 / Throws an <see
2f120 20 63 72 65 66 3d 22 4f 62 6a 65 63 74 44 69 73 cref="ObjectDis
2f130 70 6f 73 65 64 45 78 63 65 70 74 69 6f 6e 22 20 posedException"
2f140 2f 3e 20 69 66 20 74 68 69 73 20 6f 62 6a 65 63 /> if this objec
2f150 74 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f t.. /
2f160 2f 2f 20 69 6e 73 74 61 6e 63 65 20 68 61 73 20 // instance has
2f170 62 65 65 6e 20 64 69 73 70 6f 73 65 64 2e 0d 0a been disposed...
2f180 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2f190 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
2f1a0 20 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 private
2f1b0 76 6f 69 64 20 43 68 65 63 6b 44 69 73 70 6f 73 void CheckDispos
2f1c0 65 64 28 29 20 2f 2a 20 74 68 72 6f 77 20 2a 2f ed() /* throw */
2f1d0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d .. {.
2f1e0 0a 23 69 66 20 54 48 52 4f 57 5f 4f 4e 5f 44 49 .#if THROW_ON_DI
2f1f0 53 50 4f 53 45 44 0d 0a 20 20 20 20 20 20 20 20 SPOSED..
2f200 20 20 20 20 20 20 20 20 69 66 20 28 64 69 73 70 if (disp
2f210 6f 73 65 64 29 0d 0a 20 20 20 20 20 20 20 20 20 osed)..
2f220 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
2f230 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 th
2f240 72 6f 77 20 6e 65 77 20 4f 62 6a 65 63 74 44 69 row new ObjectDi
2f250 73 70 6f 73 65 64 45 78 63 65 70 74 69 6f 6e 28 sposedException(
2f260 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
2f270 20 20 20 20 20 20 20 20 20 20 74 79 70 65 6f 66 typeof
2f280 28 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 (SQLiteNativeMod
2f290 75 6c 65 29 2e 4e 61 6d 65 29 3b 0d 0a 20 20 20 ule).Name);..
2f2a0 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a }..
2f2b0 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 20 20 20 #endif..
2f2c0 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 }....
2f2d0 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ///////////
2f2e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f2f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f300 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f310 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 ////////....
2f320 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d /// <sum
2f330 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 mary>..
2f340 20 20 20 2f 2f 2f 20 44 69 73 70 6f 73 65 73 20 /// Disposes
2f350 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74 20 69 of this object i
2f360 6e 73 74 61 6e 63 65 2e 0d 0a 20 20 20 20 20 20 nstance...
2f370 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d /// </summ
2f380 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 20 20 ary>..
2f390 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
2f3a0 65 3d 22 64 69 73 70 6f 73 69 6e 67 22 3e 0d 0a e="disposing">..
2f3b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2f3c0 4e 6f 6e 2d 7a 65 72 6f 20 69 66 20 74 68 69 73 Non-zero if this
2f3d0 20 6d 65 74 68 6f 64 20 69 73 20 62 65 69 6e 67 method is being
2f3e0 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 called from the
2f3f0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2f400 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 44 69 73 / <see cref="Dis
2f410 70 6f 73 65 28 29 22 20 2f 3e 20 6d 65 74 68 6f pose()" /> metho
2f420 64 2e 20 20 5a 65 72 6f 20 69 66 20 74 68 69 73 d. Zero if this
2f430 20 6d 65 74 68 6f 64 20 69 73 20 62 65 69 6e 67 method is being
2f440 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2f450 2f 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 68 / called from th
2f460 65 20 66 69 6e 61 6c 69 7a 65 72 2e 0d 0a 20 20 e finalizer...
2f470 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f /// </
2f480 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
2f490 20 20 20 20 70 72 69 76 61 74 65 20 2f 2a 20 70 private /* p
2f4a0 72 6f 74 65 63 74 65 64 20 76 69 72 74 75 61 6c rotected virtual
2f4b0 20 2a 2f 20 76 6f 69 64 20 44 69 73 70 6f 73 65 */ void Dispose
2f4c0 28 62 6f 6f 6c 20 64 69 73 70 6f 73 69 6e 67 29 (bool disposing)
2f4d0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d .. {.
2f4e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2f4f0 20 69 66 20 28 21 64 69 73 70 6f 73 65 64 29 0d if (!disposed).
2f500 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2f510 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 {..
2f520 20 20 20 20 20 20 20 20 2f 2f 69 66 20 28 64 69 //if (di
2f530 73 70 6f 73 69 6e 67 29 0d 0a 20 20 20 20 20 20 sposing)..
2f540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f //
2f550 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 {..
2f560 20 20 20 20 20 20 20 2f 2f 20 20 20 20 2f 2f 2f // ///
2f570 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f580 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f590 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 /..
2f5a0 20 20 20 20 20 20 20 2f 2f 20 20 20 20 2f 2f 20 // //
2f5b0 64 69 73 70 6f 73 65 20 6d 61 6e 61 67 65 64 20 dispose managed
2f5c0 72 65 73 6f 75 72 63 65 73 20 68 65 72 65 2e 2e resources here..
2f5d0 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
2f5e0 20 20 20 20 20 20 20 2f 2f 20 20 20 20 2f 2f 2f // ///
2f5f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f600 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f610 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 /..
2f620 20 20 20 20 20 20 20 2f 2f 7d 0d 0a 0d 0a 20 20 //}....
2f630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f640 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f //////////////
2f650 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f660 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 20 20 20 20 20 20 ////////..
2f670 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f //
2f680 20 72 65 6c 65 61 73 65 20 75 6e 6d 61 6e 61 67 release unmanag
2f690 65 64 20 72 65 73 6f 75 72 63 65 73 20 68 65 72 ed resources her
2f6a0 65 2e 2e 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 e.....
2f6b0 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f //////
2f6c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f6d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f6e0 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
2f6f0 20 20 20 20 20 20 20 20 2f 2f 0d 0a 20 20 20 20 //..
2f700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f710 2f 2f 20 4e 4f 54 45 3a 20 54 68 65 20 6d 6f 64 // NOTE: The mod
2f720 75 6c 65 20 69 73 20 6e 6f 74 20 6f 77 6e 65 64 ule is not owned
2f730 20 62 79 20 75 73 3b 20 74 68 65 72 65 66 6f 72 by us; therefor
2f740 65 2c 20 64 6f 20 6e 6f 74 0d 0a 20 20 20 20 20 e, do not..
2f750 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2f760 2f 20 20 20 20 20 20 20 64 69 73 70 6f 73 65 20 / dispose
2f770 69 74 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 it...
2f780 20 20 20 20 20 20 20 20 20 2f 2f 0d 0a 20 20 20 //..
2f790 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f7a0 20 69 66 20 28 6d 6f 64 75 6c 65 20 21 3d 20 6e if (module != n
2f7b0 75 6c 6c 29 0d 0a 20 20 20 20 20 20 20 20 20 20 ull)..
2f7c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f mo
2f7d0 64 75 6c 65 20 3d 20 6e 75 6c 6c 3b 0d 0a 0d 0a dule = null;....
2f7e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f7f0 20 20 20 20 64 69 73 70 6f 73 65 64 20 3d 20 74 disposed = t
2f800 72 75 65 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 rue;..
2f810 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 }..
2f820 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 }..
2f830 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a #endregion..
2f840 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f .. //
2f850 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f860 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f870 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f880 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f890 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 /....
2f8a0 20 23 72 65 67 69 6f 6e 20 44 65 73 74 72 75 63 #region Destruc
2f8b0 74 6f 72 0d 0a 20 20 20 20 20 20 20 20 20 20 20 tor..
2f8c0 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
2f8d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f 20 ///
2f8e0 46 69 6e 61 6c 69 7a 65 73 20 74 68 69 73 20 6f Finalizes this o
2f8f0 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 2e 0d bject instance..
2f900 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 2f . ///
2f910 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
2f920 20 20 20 20 20 20 20 20 20 7e 53 51 4c 69 74 65 ~SQLite
2f930 4e 61 74 69 76 65 4d 6f 64 75 6c 65 28 29 0d 0a NativeModule()..
2f940 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 {..
2f950 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 44 D
2f960 69 73 70 6f 73 65 28 66 61 6c 73 65 29 3b 0d 0a ispose(false);..
2f970 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 }..
2f980 20 20 20 20 20 20 20 20 20 20 20 23 65 6e 64 72 #endr
2f990 65 67 69 6f 6e 0d 0a 20 20 20 20 20 20 20 20 7d egion.. }
2f9a0 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 .. #endre
2f9b0 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 gion....
2f9c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f9d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f9e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2f9f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fa00 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
2fa10 20 20 20 23 72 65 67 69 6f 6e 20 50 72 69 76 61 #region Priva
2fa20 74 65 20 43 6f 6e 73 74 61 6e 74 73 0d 0a 20 20 te Constants..
2fa30 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
2fa40 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
2fa50 20 54 68 65 20 64 65 66 61 75 6c 74 20 65 73 74 The default est
2fa60 69 6d 61 74 65 64 20 63 6f 73 74 20 66 6f 72 20 imated cost for
2fa70 75 73 65 20 77 69 74 68 20 74 68 65 0d 0a 20 20 use with the..
2fa80 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 /// <see c
2fa90 72 65 66 3d 22 49 53 51 4c 69 74 65 4d 61 6e 61 ref="ISQLiteMana
2faa0 67 65 64 4d 6f 64 75 6c 65 2e 42 65 73 74 49 6e gedModule.BestIn
2fab0 64 65 78 22 20 2f 3e 20 6d 65 74 68 6f 64 2e 0d dex" /> method..
2fac0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
2fad0 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
2fae0 20 70 72 69 76 61 74 65 20 73 74 61 74 69 63 20 private static
2faf0 72 65 61 64 6f 6e 6c 79 20 64 6f 75 62 6c 65 20 readonly double
2fb00 44 65 66 61 75 6c 74 45 73 74 69 6d 61 74 65 64 DefaultEstimated
2fb10 43 6f 73 74 20 3d 20 64 6f 75 62 6c 65 2e 4d 61 Cost = double.Ma
2fb20 78 56 61 6c 75 65 3b 0d 0a 0d 0a 20 20 20 20 20 xValue;....
2fb30 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f /////////////
2fb40 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fb50 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fb60 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fb70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 //////////....
2fb80 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 /// <summa
2fb90 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
2fba0 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 65 72 The default ver
2fbb0 73 69 6f 6e 20 6f 66 20 74 68 65 20 6e 61 74 69 sion of the nati
2fbc0 76 65 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c ve sqlite3_modul
2fbd0 65 20 73 74 72 75 63 74 75 72 65 20 69 6e 20 75 e structure in u
2fbe0 73 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f se... ///
2fbf0 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 </summary>..
2fc00 20 20 20 20 20 70 72 69 76 61 74 65 20 73 74 61 private sta
2fc10 74 69 63 20 72 65 61 64 6f 6e 6c 79 20 69 6e 74 tic readonly int
2fc20 20 44 65 66 61 75 6c 74 4d 6f 64 75 6c 65 56 65 DefaultModuleVe
2fc30 72 73 69 6f 6e 20 3d 20 32 3b 0d 0a 20 20 20 20 rsion = 2;..
2fc40 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a #endregion..
2fc50 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
2fc60 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fc70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fc80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fc90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fca0 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 /.... #re
2fcb0 67 69 6f 6e 20 50 72 69 76 61 74 65 20 44 61 74 gion Private Dat
2fcc0 61 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c a.. /// <
2fcd0 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
2fce0 20 20 2f 2f 2f 20 54 68 69 73 20 66 69 65 6c 64 /// This field
2fcf0 20 69 73 20 75 73 65 64 20 74 6f 20 73 74 6f 72 is used to stor
2fd00 65 20 74 68 65 20 6e 61 74 69 76 65 20 73 71 6c e the native sql
2fd10 69 74 65 33 5f 6d 6f 64 75 6c 65 20 73 74 72 75 ite3_module stru
2fd20 63 74 75 72 65 0d 0a 20 20 20 20 20 20 20 20 2f cture.. /
2fd30 2f 2f 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 // associated wi
2fd40 74 68 20 74 68 69 73 20 6f 62 6a 65 63 74 20 69 th this object i
2fd50 6e 73 74 61 6e 63 65 2e 0d 0a 20 20 20 20 20 20 nstance...
2fd60 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
2fd70 0d 0a 20 20 20 20 20 20 20 20 70 72 69 76 61 74 .. privat
2fd80 65 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 e UnsafeNativeMe
2fd90 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 6d 6f thods.sqlite3_mo
2fda0 64 75 6c 65 20 6e 61 74 69 76 65 4d 6f 64 75 6c dule nativeModul
2fdb0 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f e;.... //
2fdc0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fdd0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fde0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fdf0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2fe00 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 /////....
2fe10 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
2fe20 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 /// This
2fe30 20 66 69 65 6c 64 20 69 73 20 75 73 65 64 20 74 field is used t
2fe40 6f 20 73 74 6f 72 65 20 61 20 70 6f 69 6e 74 65 o store a pointe
2fe50 72 20 74 6f 20 74 68 65 20 6e 61 74 69 76 65 20 r to the native
2fe60 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 0d 0a sqlite3_module..
2fe70 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 74 72 75 /// stru
2fe80 63 74 75 72 65 20 72 65 74 75 72 6e 65 64 20 62 cture returned b
2fe90 79 20 74 68 65 20 73 71 6c 69 74 65 33 5f 63 72 y the sqlite3_cr
2fea0 65 61 74 65 5f 64 69 73 70 6f 73 61 62 6c 65 5f eate_disposable_
2feb0 6d 6f 64 75 6c 65 0d 0a 20 20 20 20 20 20 20 20 module..
2fec0 2f 2f 2f 20 66 75 6e 63 74 69 6f 6e 2e 0d 0a 20 /// function...
2fed0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
2fee0 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 mary>.. p
2fef0 72 69 76 61 74 65 20 49 6e 74 50 74 72 20 64 69 rivate IntPtr di
2ff00 73 70 6f 73 61 62 6c 65 4d 6f 64 75 6c 65 3b 0d sposableModule;.
2ff10 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f ... /////
2ff20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2ff30 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2ff40 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2ff50 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
2ff60 2f 2f 0d 0a 0d 0a 23 69 66 20 50 4c 41 54 46 4f //....#if PLATFO
2ff70 52 4d 5f 43 4f 4d 50 41 43 54 46 52 41 4d 45 57 RM_COMPACTFRAMEW
2ff80 4f 52 4b 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ORK.. ///
2ff90 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
2ffa0 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 66 69 65 /// This fie
2ffb0 6c 64 20 69 73 20 75 73 65 64 20 74 6f 20 68 6f ld is used to ho
2ffc0 6c 64 20 74 68 65 20 62 6c 6f 63 6b 20 6f 66 20 ld the block of
2ffd0 6e 61 74 69 76 65 20 6d 65 6d 6f 72 79 20 74 68 native memory th
2ffe0 61 74 20 63 6f 6e 74 61 69 6e 73 0d 0a 20 20 20 at contains..
2fff0 20 20 20 20 20 2f 2f 2f 20 74 68 65 20 6e 61 74 /// the nat
30000 69 76 65 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 ive sqlite3_modu
30010 6c 65 20 73 74 72 75 63 74 75 72 65 20 61 73 73 le structure ass
30020 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 69 ociated with thi
30030 73 20 6f 62 6a 65 63 74 0d 0a 20 20 20 20 20 20 s object..
30040 20 20 2f 2f 2f 20 69 6e 73 74 61 6e 63 65 20 77 /// instance w
30050 68 65 6e 20 72 75 6e 6e 69 6e 67 20 6f 6e 20 74 hen running on t
30060 68 65 20 2e 4e 45 54 20 43 6f 6d 70 61 63 74 20 he .NET Compact
30070 46 72 61 6d 65 77 6f 72 6b 2e 0d 0a 20 20 20 20 Framework...
30080 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
30090 79 3e 0d 0a 20 20 20 20 20 20 20 20 70 72 69 76 y>.. priv
300a0 61 74 65 20 49 6e 74 50 74 72 20 70 4e 61 74 69 ate IntPtr pNati
300b0 76 65 4d 6f 64 75 6c 65 3b 0d 0a 23 65 6e 64 69 veModule;..#endi
300c0 66 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f f.... ///
300d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
300e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
300f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30100 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30110 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ////....
30120 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
30130 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 /// This
30140 66 69 65 6c 64 20 69 73 20 75 73 65 64 20 74 6f field is used to
30150 20 73 74 6f 72 65 20 74 68 65 20 76 69 72 74 75 store the virtu
30160 61 6c 20 74 61 62 6c 65 20 69 6e 73 74 61 6e 63 al table instanc
30170 65 73 20 61 73 73 6f 63 69 61 74 65 64 0d 0a 20 es associated..
30180 20 20 20 20 20 20 20 2f 2f 2f 20 77 69 74 68 20 /// with
30190 74 68 69 73 20 6d 6f 64 75 6c 65 2e 20 20 54 68 this module. Th
301a0 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 72 e native pointer
301b0 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f to the sqlite3_
301c0 76 74 61 62 20 64 65 72 69 76 65 64 0d 0a 20 20 vtab derived..
301d0 20 20 20 20 20 20 2f 2f 2f 20 73 74 72 75 63 74 /// struct
301e0 75 72 65 20 69 73 20 75 73 65 64 20 74 6f 20 6b ure is used to k
301f0 65 79 20 69 6e 74 6f 20 74 68 69 73 20 63 6f 6c ey into this col
30200 6c 65 63 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 lection...
30210 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e /// </summary>
30220 0d 0a 20 20 20 20 20 20 20 20 70 72 69 76 61 74 .. privat
30230 65 20 44 69 63 74 69 6f 6e 61 72 79 3c 49 6e 74 e Dictionary<Int
30240 50 74 72 2c 20 53 51 4c 69 74 65 56 69 72 74 75 Ptr, SQLiteVirtu
30250 61 6c 54 61 62 6c 65 3e 20 74 61 62 6c 65 73 3b alTable> tables;
30260 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
30270 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30280 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30290 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
302a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
302b0 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ///.... /
302c0 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
302d0 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 66 /// This f
302e0 69 65 6c 64 20 69 73 20 75 73 65 64 20 74 6f 20 ield is used to
302f0 73 74 6f 72 65 20 74 68 65 20 76 69 72 74 75 61 store the virtua
30300 6c 20 74 61 62 6c 65 20 63 75 72 73 6f 72 20 69 l table cursor i
30310 6e 73 74 61 6e 63 65 73 0d 0a 20 20 20 20 20 20 nstances..
30320 20 20 2f 2f 2f 20 61 73 73 6f 63 69 61 74 65 64 /// associated
30330 20 77 69 74 68 20 74 68 69 73 20 6d 6f 64 75 6c with this modul
30340 65 2e 20 20 54 68 65 20 6e 61 74 69 76 65 20 70 e. The native p
30350 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 0d 0a 20 ointer to the..
30360 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 6c 69 74 /// sqlit
30370 65 33 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 64 e3_vtab_cursor d
30380 65 72 69 76 65 64 20 73 74 72 75 63 74 75 72 65 erived structure
30390 20 69 73 20 75 73 65 64 20 74 6f 20 6b 65 79 20 is used to key
303a0 69 6e 74 6f 20 74 68 69 73 0d 0a 20 20 20 20 20 into this..
303b0 20 20 20 2f 2f 2f 20 63 6f 6c 6c 65 63 74 69 6f /// collectio
303c0 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 n... ///
303d0 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
303e0 20 20 20 20 70 72 69 76 61 74 65 20 44 69 63 74 private Dict
303f0 69 6f 6e 61 72 79 3c 49 6e 74 50 74 72 2c 20 53 ionary<IntPtr, S
30400 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c QLiteVirtualTabl
30410 65 43 75 72 73 6f 72 3e 20 63 75 72 73 6f 72 73 eCursor> cursors
30420 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ;.... ///
30430 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30440 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30450 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30460 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30470 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ////....
30480 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 /// <summary>..
30490 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 /// This
304a0 66 69 65 6c 64 20 69 73 20 75 73 65 64 20 74 6f field is used to
304b0 20 73 74 6f 72 65 20 74 68 65 20 76 69 72 74 75 store the virtu
304c0 61 6c 20 74 61 62 6c 65 20 66 75 6e 63 74 69 6f al table functio
304d0 6e 20 69 6e 73 74 61 6e 63 65 73 0d 0a 20 20 20 n instances..
304e0 20 20 20 20 20 2f 2f 2f 20 61 73 73 6f 63 69 61 /// associa
304f0 74 65 64 20 77 69 74 68 20 74 68 69 73 20 6d 6f ted with this mo
30500 64 75 6c 65 2e 20 20 54 68 65 20 63 61 73 65 2d dule. The case-
30510 69 6e 73 65 6e 73 69 74 69 76 65 20 66 75 6e 63 insensitive func
30520 74 69 6f 6e 20 6e 61 6d 65 0d 0a 20 20 20 20 20 tion name..
30530 20 20 20 2f 2f 2f 20 61 6e 64 20 74 68 65 20 6e /// and the n
30540 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e umber of argumen
30550 74 73 20 28 77 69 74 68 20 2d 31 20 6d 65 61 6e ts (with -1 mean
30560 69 6e 67 20 22 61 6e 79 22 29 20 61 72 65 20 75 ing "any") are u
30570 73 65 64 20 74 6f 0d 0a 20 20 20 20 20 20 20 20 sed to..
30580 2f 2f 2f 20 63 6f 6e 73 74 72 75 63 74 20 74 68 /// construct th
30590 65 20 73 74 72 69 6e 67 20 74 68 61 74 20 69 73 e string that is
305a0 20 75 73 65 64 20 74 6f 20 6b 65 79 20 69 6e 74 used to key int
305b0 6f 20 74 68 69 73 20 63 6f 6c 6c 65 63 74 69 6f o this collectio
305c0 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 n... ///
305d0 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 </summary>..
305e0 20 20 20 20 70 72 69 76 61 74 65 20 44 69 63 74 private Dict
305f0 69 6f 6e 61 72 79 3c 73 74 72 69 6e 67 2c 20 53 ionary<string, S
30600 51 4c 69 74 65 46 75 6e 63 74 69 6f 6e 3e 20 66 QLiteFunction> f
30610 75 6e 63 74 69 6f 6e 73 3b 0d 0a 20 20 20 20 20 unctions;..
30620 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d #endregion...
30630 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
30640 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30650 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30660 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30670 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30680 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 67 .... #reg
30690 69 6f 6e 20 50 75 62 6c 69 63 20 43 6f 6e 73 74 ion Public Const
306a0 72 75 63 74 6f 72 73 0d 0a 20 20 20 20 20 20 20 ructors..
306b0 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
306c0 20 20 20 20 20 20 20 20 2f 2f 2f 20 43 6f 6e 73 /// Cons
306d0 74 72 75 63 74 73 20 61 6e 20 69 6e 73 74 61 6e tructs an instan
306e0 63 65 20 6f 66 20 74 68 69 73 20 63 6c 61 73 73 ce of this class
306f0 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
30700 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 /summary>..
30710 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
30720 6d 65 3d 22 6e 61 6d 65 22 3e 0d 0a 20 20 20 20 me="name">..
30730 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 6d 65 /// The name
30740 20 6f 66 20 74 68 65 20 6d 6f 64 75 6c 65 2e 20 of the module.
30750 20 54 68 69 73 20 70 61 72 61 6d 65 74 65 72 20 This parameter
30760 63 61 6e 6e 6f 74 20 62 65 20 6e 75 6c 6c 2e 0d cannot be null..
30770 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 . /// </p
30780 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 70 aram>.. p
30790 75 62 6c 69 63 20 53 51 4c 69 74 65 4d 6f 64 75 ublic SQLiteModu
307a0 6c 65 28 73 74 72 69 6e 67 20 6e 61 6d 65 29 0d le(string name).
307b0 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 . {..
307c0 20 20 20 20 20 20 20 20 69 66 20 28 6e 61 6d 65 if (name
307d0 20 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 == null)..
307e0 20 20 20 20 20 20 20 20 20 20 20 74 68 72 6f 77 throw
307f0 20 6e 65 77 20 41 72 67 75 6d 65 6e 74 4e 75 6c new ArgumentNul
30800 6c 45 78 63 65 70 74 69 6f 6e 28 22 6e 61 6d 65 lException("name
30810 22 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 ");....
30820 20 20 20 74 68 69 73 2e 6e 61 6d 65 20 3d 20 6e this.name = n
30830 61 6d 65 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 ame;..
30840 20 20 74 68 69 73 2e 74 61 62 6c 65 73 20 3d 20 this.tables =
30850 6e 65 77 20 44 69 63 74 69 6f 6e 61 72 79 3c 49 new Dictionary<I
30860 6e 74 50 74 72 2c 20 53 51 4c 69 74 65 56 69 72 ntPtr, SQLiteVir
30870 74 75 61 6c 54 61 62 6c 65 3e 28 29 3b 0d 0a 20 tualTable>();..
30880 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 2e this.
30890 63 75 72 73 6f 72 73 20 3d 20 6e 65 77 20 44 69 cursors = new Di
308a0 63 74 69 6f 6e 61 72 79 3c 49 6e 74 50 74 72 2c ctionary<IntPtr,
308b0 20 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 SQLiteVirtualTa
308c0 62 6c 65 43 75 72 73 6f 72 3e 28 29 3b 0d 0a 20 bleCursor>();..
308d0 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 2e this.
308e0 66 75 6e 63 74 69 6f 6e 73 20 3d 20 6e 65 77 20 functions = new
308f0 44 69 63 74 69 6f 6e 61 72 79 3c 73 74 72 69 6e Dictionary<strin
30900 67 2c 20 53 51 4c 69 74 65 46 75 6e 63 74 69 6f g, SQLiteFunctio
30910 6e 3e 28 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d n>();.. }
30920 0d 0a 20 20 20 20 20 20 20 20 23 65 6e 64 72 65 .. #endre
30930 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 gion....
30940 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30950 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30960 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30970 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
30980 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
30990 20 20 20 23 72 65 67 69 6f 6e 20 49 6e 74 65 72 #region Inter
309a0 6e 61 6c 20 4d 65 74 68 6f 64 73 0d 0a 20 20 20 nal Methods..
309b0 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 /// <summar
309c0 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
309d0 43 61 6c 6c 73 20 74 68 65 20 6e 61 74 69 76 65 Calls the native
309e0 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6c 69 62 SQLite core lib
309f0 72 61 72 79 20 69 6e 20 6f 72 64 65 72 20 74 6f rary in order to
30a00 20 63 72 65 61 74 65 20 61 20 6e 65 77 0d 0a 20 create a new..
30a10 20 20 20 20 20 20 20 2f 2f 2f 20 64 69 73 70 6f /// dispo
30a20 73 61 62 6c 65 20 6d 6f 64 75 6c 65 20 63 6f 6e sable module con
30a30 74 61 69 6e 69 6e 67 20 74 68 65 20 69 6d 70 6c taining the impl
30a40 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 61 20 ementation of a
30a50 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a virtual table...
30a60 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
30a70 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
30a80 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
30a90 22 70 44 62 22 3e 0d 0a 20 20 20 20 20 20 20 20 "pDb">..
30aa0 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 20 64 /// The native d
30ab0 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
30ac0 6f 6e 20 70 6f 69 6e 74 65 72 20 74 6f 20 75 73 on pointer to us
30ad0 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 e... ///
30ae0 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 </param>..
30af0 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d /// <returns>.
30b00 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 4e 6f 6e . /// Non
30b10 2d 7a 65 72 6f 20 75 70 6f 6e 20 73 75 63 63 65 -zero upon succe
30b20 73 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ss... ///
30b30 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 </returns>..
30b40 20 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 62 6f internal bo
30b50 6f 6c 20 43 72 65 61 74 65 44 69 73 70 6f 73 61 ol CreateDisposa
30b60 62 6c 65 4d 6f 64 75 6c 65 28 0d 0a 20 20 20 20 bleModule(..
30b70 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 IntPtr p
30b80 44 62 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 Db..
30b90 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 ).. {..
30ba0 20 20 20 20 20 20 20 20 20 20 69 66 20 28 64 69 if (di
30bb0 73 70 6f 73 61 62 6c 65 4d 6f 64 75 6c 65 20 21 sposableModule !
30bc0 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a = IntPtr.Zero)..
30bd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30be0 72 65 74 75 72 6e 20 74 72 75 65 3b 0d 0a 0d 0a return true;....
30bf0 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 IntP
30c00 74 72 20 70 4e 61 6d 65 20 3d 20 49 6e 74 50 74 tr pName = IntPt
30c10 72 2e 5a 65 72 6f 3b 0d 0a 0d 0a 20 20 20 20 20 r.Zero;....
30c20 20 20 20 20 20 20 20 74 72 79 0d 0a 20 20 20 20 try..
30c30 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
30c40 20 20 20 20 20 20 20 20 20 20 20 70 4e 61 6d 65 pName
30c50 20 3d 20 53 51 4c 69 74 65 53 74 72 69 6e 67 2e = SQLiteString.
30c60 55 74 66 38 49 6e 74 50 74 72 46 72 6f 6d 53 74 Utf8IntPtrFromSt
30c70 72 69 6e 67 28 6e 61 6d 65 29 3b 0d 0a 0d 0a 20 ring(name);....
30c80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 55 U
30c90 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
30ca0 64 73 2e 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c ds.sqlite3_modul
30cb0 65 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 20 3d e nativeModule =
30cc0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
30cd0 20 20 20 20 20 20 41 6c 6c 6f 63 61 74 65 4e 61 AllocateNa
30ce0 74 69 76 65 4d 6f 64 75 6c 65 28 29 3b 0d 0a 0d tiveModule();...
30cf0 0a 23 69 66 20 21 50 4c 41 54 46 4f 52 4d 5f 43 .#if !PLATFORM_C
30d00 4f 4d 50 41 43 54 46 52 41 4d 45 57 4f 52 4b 0d OMPACTFRAMEWORK.
30d10 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
30d20 20 64 69 73 70 6f 73 61 62 6c 65 4d 6f 64 75 6c disposableModul
30d30 65 20 3d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 e =..
30d40 20 20 20 20 20 20 20 20 20 55 6e 73 61 66 65 4e UnsafeN
30d50 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c ativeMethods.sql
30d60 69 74 65 33 5f 63 72 65 61 74 65 5f 64 69 73 70 ite3_create_disp
30d70 6f 73 61 62 6c 65 5f 6d 6f 64 75 6c 65 28 0d 0a osable_module(..
30d80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30d90 20 20 20 20 20 20 20 20 70 44 62 2c 20 70 4e 61 pDb, pNa
30da0 6d 65 2c 20 72 65 66 20 6e 61 74 69 76 65 4d 6f me, ref nativeMo
30db0 64 75 6c 65 2c 20 49 6e 74 50 74 72 2e 5a 65 72 dule, IntPtr.Zer
30dc0 6f 2c 20 6e 75 6c 6c 29 3b 0d 0a 0d 0a 20 20 20 o, null);....
30dd0 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 ret
30de0 75 72 6e 20 28 64 69 73 70 6f 73 61 62 6c 65 4d urn (disposableM
30df0 6f 64 75 6c 65 20 21 3d 20 49 6e 74 50 74 72 2e odule != IntPtr.
30e00 5a 65 72 6f 29 3b 0d 0a 23 65 6c 69 66 20 21 53 Zero);..#elif !S
30e10 51 4c 49 54 45 5f 53 54 41 4e 44 41 52 44 0d 0a QLITE_STANDARD..
30e20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30e30 64 69 73 70 6f 73 61 62 6c 65 4d 6f 64 75 6c 65 disposableModule
30e40 20 3d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 =..
30e50 20 20 20 20 20 20 20 20 55 6e 73 61 66 65 4e 61 UnsafeNa
30e60 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 tiveMethods.sqli
30e70 74 65 33 5f 63 72 65 61 74 65 5f 64 69 73 70 6f te3_create_dispo
30e80 73 61 62 6c 65 5f 6d 6f 64 75 6c 65 5f 69 6e 74 sable_module_int
30e90 65 72 6f 70 28 0d 0a 20 20 20 20 20 20 20 20 20 erop(..
30ea0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 44 pD
30eb0 62 2c 20 70 4e 61 6d 65 2c 20 41 6c 6c 6f 63 61 b, pName, Alloca
30ec0 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 49 6e teNativeModuleIn
30ed0 74 65 72 6f 70 28 29 2c 0d 0a 20 20 20 20 20 20 terop(),..
30ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30ef0 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 69 56 nativeModule.iV
30f00 65 72 73 69 6f 6e 2c 20 6e 61 74 69 76 65 4d 6f ersion, nativeMo
30f10 64 75 6c 65 2e 78 43 72 65 61 74 65 2c 0d 0a 20 dule.xCreate,..
30f20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30f30 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 nativeModu
30f40 6c 65 2e 78 43 6f 6e 6e 65 63 74 2c 20 6e 61 74 le.xConnect, nat
30f50 69 76 65 4d 6f 64 75 6c 65 2e 78 42 65 73 74 49 iveModule.xBestI
30f60 6e 64 65 78 2c 0d 0a 20 20 20 20 20 20 20 20 20 ndex,..
30f70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 na
30f80 74 69 76 65 4d 6f 64 75 6c 65 2e 78 44 69 73 63 tiveModule.xDisc
30f90 6f 6e 6e 65 63 74 2c 20 6e 61 74 69 76 65 4d 6f onnect, nativeMo
30fa0 64 75 6c 65 2e 78 44 65 73 74 72 6f 79 2c 0d 0a dule.xDestroy,..
30fb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
30fc0 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 nativeMod
30fd0 75 6c 65 2e 78 4f 70 65 6e 2c 20 6e 61 74 69 76 ule.xOpen, nativ
30fe0 65 4d 6f 64 75 6c 65 2e 78 43 6c 6f 73 65 2c 0d eModule.xClose,.
30ff0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
31000 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f nativeMo
31010 64 75 6c 65 2e 78 46 69 6c 74 65 72 2c 20 6e 61 dule.xFilter, na
31020 74 69 76 65 4d 6f 64 75 6c 65 2e 78 4e 65 78 74 tiveModule.xNext
31030 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ,..
31040 20 20 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 native
31050 4d 6f 64 75 6c 65 2e 78 45 6f 66 2c 20 6e 61 74 Module.xEof, nat
31060 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6c 75 6d iveModule.xColum
31070 6e 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 n,..
31080 20 20 20 20 20 20 20 20 20 20 20 6e 61 74 69 76 nativ
31090 65 4d 6f 64 75 6c 65 2e 78 52 6f 77 49 64 2c 20 eModule.xRowId,
310a0 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 55 70 nativeModule.xUp
310b0 64 61 74 65 2c 0d 0a 20 20 20 20 20 20 20 20 20 date,..
310c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 na
310d0 74 69 76 65 4d 6f 64 75 6c 65 2e 78 42 65 67 69 tiveModule.xBegi
310e0 6e 2c 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e n, nativeModule.
310f0 78 53 79 6e 63 2c 0d 0a 20 20 20 20 20 20 20 20 xSync,..
31100 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e n
31110 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6d ativeModule.xCom
31120 6d 69 74 2c 20 6e 61 74 69 76 65 4d 6f 64 75 6c mit, nativeModul
31130 65 2e 78 52 6f 6c 6c 62 61 63 6b 2c 0d 0a 20 20 e.xRollback,..
31140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31150 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c nativeModul
31160 65 2e 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e 2c e.xFindFunction,
31170 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 52 nativeModule.xR
31180 65 6e 61 6d 65 2c 0d 0a 20 20 20 20 20 20 20 20 ename,..
31190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e n
311a0 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 53 61 76 ativeModule.xSav
311b0 65 70 6f 69 6e 74 2c 20 6e 61 74 69 76 65 4d 6f epoint, nativeMo
311c0 64 75 6c 65 2e 78 52 65 6c 65 61 73 65 2c 0d 0a dule.xRelease,..
311d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
311e0 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 nativeMod
311f0 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 6b 54 6f 2c ule.xRollbackTo,
31200 20 49 6e 74 50 74 72 2e 5a 65 72 6f 2c 20 6e 75 IntPtr.Zero, nu
31210 6c 6c 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ll);....
31220 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 28 return (
31230 64 69 73 70 6f 73 61 62 6c 65 4d 6f 64 75 6c 65 disposableModule
31240 20 21 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 != IntPtr.Zero)
31250 3b 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20 20 ;..#else..
31260 20 20 20 20 20 20 20 20 20 20 74 68 72 6f 77 20 throw
31270 6e 65 77 20 4e 6f 74 49 6d 70 6c 65 6d 65 6e 74 new NotImplement
31280 65 64 45 78 63 65 70 74 69 6f 6e 28 29 3b 0d 0a edException();..
31290 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 20 20 20 #endif..
312a0 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 }..
312b0 20 20 20 66 69 6e 61 6c 6c 79 0d 0a 20 20 20 20 finally..
312c0 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
312d0 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 70 if (p
312e0 4e 61 6d 65 20 21 3d 20 49 6e 74 50 74 72 2e 5a Name != IntPtr.Z
312f0 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 20 ero)..
31300 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 {..
31310 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c SQL
31320 69 74 65 4d 65 6d 6f 72 79 2e 46 72 65 65 28 70 iteMemory.Free(p
31330 4e 61 6d 65 29 3b 0d 0a 20 20 20 20 20 20 20 20 Name);..
31340 20 20 20 20 20 20 20 20 20 20 20 20 70 4e 61 6d pNam
31350 65 20 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 3b e = IntPtr.Zero;
31360 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
31370 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 }..
31380 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 }.. }..
31390 20 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f #endregio
313a0 6e 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f n.... ///
313b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
313c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
313d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
313e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
313f0 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 ////....
31400 23 72 65 67 69 6f 6e 20 50 72 69 76 61 74 65 20 #region Private
31410 4d 65 74 68 6f 64 73 0d 0a 20 20 20 20 20 20 20 Methods..
31420 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a /// <summary>..
31430 20 20 20 20 20 20 20 20 2f 2f 2f 20 43 72 65 61 /// Crea
31440 74 65 73 20 61 6e 64 20 72 65 74 75 72 6e 73 20 tes and returns
31450 74 68 65 20 6e 61 74 69 76 65 20 73 71 6c 69 74 the native sqlit
31460 65 5f 6d 6f 64 75 6c 65 20 73 74 72 75 63 74 75 e_module structu
31470 72 65 20 75 73 69 6e 67 20 74 68 65 0d 0a 20 20 re using the..
31480 20 20 20 20 20 20 2f 2f 2f 20 63 6f 6e 66 69 67 /// config
31490 75 72 65 64 20 28 6f 72 20 64 65 66 61 75 6c 74 ured (or default
314a0 29 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 ) <see cref="ISQ
314b0 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
314c0 22 20 2f 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f " />.. //
314d0 2f 20 69 6e 74 65 72 66 61 63 65 20 69 6d 70 6c / interface impl
314e0 65 6d 65 6e 74 61 74 69 6f 6e 2e 0d 0a 20 20 20 ementation...
314f0 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 /// </summa
31500 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ry>.. ///
31510 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 <returns>..
31520 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 /// The nati
31530 76 65 20 73 71 6c 69 74 65 5f 6d 6f 64 75 6c 65 ve sqlite_module
31540 20 73 74 72 75 63 74 75 72 65 20 75 73 69 6e 67 structure using
31550 20 74 68 65 20 63 6f 6e 66 69 67 75 72 65 64 20 the configured
31560 28 6f 72 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f (or.. ///
31570 20 64 65 66 61 75 6c 74 29 20 3c 73 65 65 20 63 default) <see c
31580 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
31590 76 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 69 6e 74 veModule" /> int
315a0 65 72 66 61 63 65 0d 0a 20 20 20 20 20 20 20 20 erface..
315b0 2f 2f 2f 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 /// implementati
315c0 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f on... ///
315d0 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 </returns>..
315e0 20 20 20 20 20 70 72 69 76 61 74 65 20 55 6e 73 private Uns
315f0 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 afeNativeMethods
31600 2e 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 20 .sqlite3_module
31610 41 6c 6c 6f 63 61 74 65 4e 61 74 69 76 65 4d 6f AllocateNativeMo
31620 64 75 6c 65 28 29 0d 0a 20 20 20 20 20 20 20 20 dule()..
31630 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 {.. r
31640 65 74 75 72 6e 20 41 6c 6c 6f 63 61 74 65 4e 61 eturn AllocateNa
31650 74 69 76 65 4d 6f 64 75 6c 65 28 47 65 74 4e 61 tiveModule(GetNa
31660 74 69 76 65 4d 6f 64 75 6c 65 49 6d 70 6c 28 29 tiveModuleImpl()
31670 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d );.. }...
31680 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f . ///////
31690 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
316a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
316b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
316c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
316d0 0d 0a 0d 0a 23 69 66 20 50 4c 41 54 46 4f 52 4d ....#if PLATFORM
316e0 5f 43 4f 4d 50 41 43 54 46 52 41 4d 45 57 4f 52 _COMPACTFRAMEWOR
316f0 4b 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c K.. /// <
31700 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
31710 20 20 2f 2f 2f 20 43 72 65 61 74 65 73 20 61 6e /// Creates an
31720 64 20 72 65 74 75 72 6e 73 20 61 20 6d 65 6d 6f d returns a memo
31730 72 79 20 62 6c 6f 63 6b 20 6f 62 74 61 69 6e 65 ry block obtaine
31740 64 20 66 72 6f 6d 20 74 68 65 20 53 51 4c 69 74 d from the SQLit
31750 65 20 63 6f 72 65 0d 0a 20 20 20 20 20 20 20 20 e core..
31760 2f 2f 2f 20 6c 69 62 72 61 72 79 20 75 73 65 64 /// library used
31770 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 6e 61 to store the na
31780 74 69 76 65 20 73 71 6c 69 74 65 33 5f 6d 6f 64 tive sqlite3_mod
31790 75 6c 65 20 73 74 72 75 63 74 75 72 65 20 66 6f ule structure fo
317a0 72 20 74 68 69 73 0d 0a 20 20 20 20 20 20 20 20 r this..
317b0 2f 2f 2f 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 /// object insta
317c0 6e 63 65 20 77 68 65 6e 20 72 75 6e 6e 69 6e 67 nce when running
317d0 20 6f 6e 20 74 68 65 20 2e 4e 45 54 20 43 6f 6d on the .NET Com
317e0 70 61 63 74 20 46 72 61 6d 65 77 6f 72 6b 2e 0d pact Framework..
317f0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
31800 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
31810 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a /// <returns>..
31820 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
31830 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 72 20 74 native pointer t
31840 6f 20 74 68 65 20 6e 61 74 69 76 65 20 73 71 6c o the native sql
31850 69 74 65 33 5f 6d 6f 64 75 6c 65 20 73 74 72 75 ite3_module stru
31860 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 cture...
31870 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a /// </returns>..
31880 20 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 private
31890 49 6e 74 50 74 72 20 41 6c 6c 6f 63 61 74 65 4e IntPtr AllocateN
318a0 61 74 69 76 65 4d 6f 64 75 6c 65 49 6e 74 65 72 ativeModuleInter
318b0 6f 70 28 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d op().. {.
318c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 . if
318d0 28 70 4e 61 74 69 76 65 4d 6f 64 75 6c 65 20 3d (pNativeModule =
318e0 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a = IntPtr.Zero)..
318f0 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 {..
31900 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
31910 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 /..
31920 20 20 20 2f 2f 20 48 41 43 4b 3a 20 4e 6f 20 65 // HACK: No e
31930 61 73 79 20 77 61 79 20 74 6f 20 64 65 74 65 72 asy way to deter
31940 6d 69 6e 65 20 74 68 65 20 73 69 7a 65 20 6f 66 mine the size of
31950 20 74 68 65 20 6e 61 74 69 76 65 0d 0a 20 20 20 the native..
31960 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 //
31970 20 20 20 20 20 20 73 71 6c 69 74 65 5f 6d 6f 64 sqlite_mod
31980 75 6c 65 20 73 74 72 75 63 74 75 72 65 20 77 68 ule structure wh
31990 65 6e 20 72 75 6e 6e 69 6e 67 20 6f 6e 20 74 68 en running on th
319a0 65 20 2e 4e 45 54 0d 0a 20 20 20 20 20 20 20 20 e .NET..
319b0 20 20 20 20 20 20 20 20 2f 2f 20 20 20 20 20 20 //
319c0 20 43 6f 6d 70 61 63 74 20 46 72 61 6d 65 77 6f Compact Framewo
319d0 72 6b 3b 20 74 68 65 72 65 66 6f 72 65 2c 20 6a rk; therefore, j
319e0 75 73 74 20 62 61 73 65 20 74 68 65 20 73 69 7a ust base the siz
319f0 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 e..
31a00 20 20 20 2f 2f 20 20 20 20 20 20 20 6f 6e 20 77 // on w
31a10 68 61 74 20 77 65 20 6b 6e 6f 77 3a 0d 0a 20 20 hat we know:..
31a20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f //
31a30 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
31a40 20 20 2f 2f 20 20 20 20 20 20 20 54 68 65 72 65 // There
31a50 20 69 73 20 6f 6e 65 20 69 6e 74 65 67 65 72 20 is one integer
31a60 6d 65 6d 62 65 72 2e 0d 0a 20 20 20 20 20 20 20 member...
31a70 20 20 20 20 20 20 20 20 20 2f 2f 20 20 20 20 20 //
31a80 20 20 54 68 65 72 65 20 61 72 65 20 32 32 20 66 There are 22 f
31a90 75 6e 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 20 unction pointer
31aa0 6d 65 6d 62 65 72 73 2e 0d 0a 20 20 20 20 20 20 members...
31ab0 20 20 20 20 20 20 20 20 20 20 2f 2f 0d 0a 20 20 //..
31ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 4e pN
31ad0 61 74 69 76 65 4d 6f 64 75 6c 65 20 3d 20 53 51 ativeModule = SQ
31ae0 4c 69 74 65 4d 65 6d 6f 72 79 2e 41 6c 6c 6f 63 LiteMemory.Alloc
31af0 61 74 65 28 0d 0a 20 20 20 20 20 20 20 20 20 20 ate(..
31b00 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 SQLite
31b10 4d 61 72 73 68 61 6c 2e 53 69 7a 65 4f 66 53 74 Marshal.SizeOfSt
31b20 72 75 63 74 49 6e 74 28 29 20 2b 20 28 32 32 20 ructInt() + (22
31b30 2a 20 49 6e 74 50 74 72 2e 53 69 7a 65 29 29 3b * IntPtr.Size));
31b40 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
31b50 20 20 20 20 69 66 20 28 70 4e 61 74 69 76 65 4d if (pNativeM
31b60 6f 64 75 6c 65 20 3d 3d 20 49 6e 74 50 74 72 2e odule == IntPtr.
31b70 5a 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 Zero)..
31b80 20 20 20 20 20 20 20 20 20 20 20 74 68 72 6f 77 throw
31b90 20 6e 65 77 20 4f 75 74 4f 66 4d 65 6d 6f 72 79 new OutOfMemory
31ba0 45 78 63 65 70 74 69 6f 6e 28 22 73 71 6c 69 74 Exception("sqlit
31bb0 65 33 5f 6d 6f 64 75 6c 65 22 29 3b 0d 0a 20 20 e3_module");..
31bc0 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 }....
31bd0 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
31be0 6e 20 70 4e 61 74 69 76 65 4d 6f 64 75 6c 65 3b n pNativeModule;
31bf0 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 23 65 6e .. }..#en
31c00 64 69 66 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f dif.... /
31c10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
31c20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
31c30 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
31c40 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
31c50 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 //////....
31c60 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d /// <summary>.
31c70 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 43 72 65 . /// Cre
31c80 61 74 65 73 20 61 6e 64 20 72 65 74 75 72 6e 73 ates and returns
31c90 20 74 68 65 20 6e 61 74 69 76 65 20 73 71 6c 69 the native sqli
31ca0 74 65 5f 6d 6f 64 75 6c 65 20 73 74 72 75 63 74 te_module struct
31cb0 75 72 65 20 75 73 69 6e 67 20 74 68 65 0d 0a 20 ure using the..
31cc0 20 20 20 20 20 20 20 2f 2f 2f 20 73 70 65 63 69 /// speci
31cd0 66 69 65 64 20 3c 73 65 65 20 63 72 65 66 3d 22 fied <see cref="
31ce0 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 ISQLiteNativeMod
31cf0 75 6c 65 22 20 2f 3e 20 69 6e 74 65 72 66 61 63 ule" /> interfac
31d00 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 69 e.. /// i
31d10 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0d 0a mplementation...
31d20 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 /// </su
31d30 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
31d40 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
31d50 22 6d 6f 64 75 6c 65 22 3e 0d 0a 20 20 20 20 20 "module">..
31d60 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 /// The <see
31d70 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 cref="ISQLiteNat
31d80 69 76 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 69 6e iveModule" /> in
31d90 74 65 72 66 61 63 65 20 69 6d 70 6c 65 6d 65 6e terface implemen
31da0 74 61 74 69 6f 6e 20 74 6f 0d 0a 20 20 20 20 20 tation to..
31db0 20 20 20 2f 2f 2f 20 75 73 65 2e 0d 0a 20 20 20 /// use...
31dc0 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
31dd0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
31de0 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
31df0 20 20 2f 2f 2f 20 54 68 65 20 6e 61 74 69 76 65 /// The native
31e00 20 73 71 6c 69 74 65 5f 6d 6f 64 75 6c 65 20 73 sqlite_module s
31e10 74 72 75 63 74 75 72 65 20 75 73 69 6e 67 20 74 tructure using t
31e20 68 65 20 73 70 65 63 69 66 69 65 64 0d 0a 20 20 he specified..
31e30 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 /// <see c
31e40 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 ref="ISQLiteNati
31e50 76 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 69 6e 74 veModule" /> int
31e60 65 72 66 61 63 65 20 69 6d 70 6c 65 6d 65 6e 74 erface implement
31e70 61 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 20 ation...
31e80 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a /// </returns>..
31e90 20 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 private
31ea0 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 UnsafeNativeMeth
31eb0 6f 64 73 2e 73 71 6c 69 74 65 33 5f 6d 6f 64 75 ods.sqlite3_modu
31ec0 6c 65 20 41 6c 6c 6f 63 61 74 65 4e 61 74 69 76 le AllocateNativ
31ed0 65 4d 6f 64 75 6c 65 28 0d 0a 20 20 20 20 20 20 eModule(..
31ee0 20 20 20 20 20 20 49 53 51 4c 69 74 65 4e 61 74 ISQLiteNat
31ef0 69 76 65 4d 6f 64 75 6c 65 20 6d 6f 64 75 6c 65 iveModule module
31f00 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 0d .. ).
31f10 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 . {..
31f20 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f nativeMo
31f30 64 75 6c 65 20 3d 20 6e 65 77 20 55 6e 73 61 66 dule = new Unsaf
31f40 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 eNativeMethods.s
31f50 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 28 29 3b qlite3_module();
31f60 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 .. na
31f70 74 69 76 65 4d 6f 64 75 6c 65 2e 69 56 65 72 73 tiveModule.iVers
31f80 69 6f 6e 20 3d 20 44 65 66 61 75 6c 74 4d 6f 64 ion = DefaultMod
31f90 75 6c 65 56 65 72 73 69 6f 6e 3b 0d 0a 0d 0a 20 uleVersion;....
31fa0 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 6d if (m
31fb0 6f 64 75 6c 65 20 21 3d 20 6e 75 6c 6c 29 0d 0a odule != null)..
31fc0 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 {..
31fd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e n
31fe0 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 72 65 ativeModule.xCre
31ff0 61 74 65 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 ate = new Unsafe
32000 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 43 NativeMethods.xC
32010 72 65 61 74 65 28 0d 0a 20 20 20 20 20 20 20 20 reate(..
32020 20 20 20 20 20 20 20 20 20 20 20 6d 6f 64 75 6c modul
32030 65 2e 78 43 72 65 61 74 65 29 3b 0d 0a 0d 0a 20 e.xCreate);....
32040 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e n
32050 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6e ativeModule.xCon
32060 6e 65 63 74 20 3d 20 6e 65 77 20 55 6e 73 61 66 nect = new Unsaf
32070 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 eNativeMethods.x
32080 43 6f 6e 6e 65 63 74 28 0d 0a 20 20 20 20 20 20 Connect(..
32090 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f mo
320a0 64 75 6c 65 2e 78 43 6f 6e 6e 65 63 74 29 3b 0d dule.xConnect);.
320b0 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
320c0 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e nativeModule.
320d0 78 42 65 73 74 49 6e 64 65 78 20 3d 20 6e 65 77 xBestIndex = new
320e0 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 UnsafeNativeMet
320f0 68 6f 64 73 2e 78 42 65 73 74 49 6e 64 65 78 28 hods.xBestIndex(
32100 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
32110 20 20 20 20 20 20 6d 6f 64 75 6c 65 2e 78 42 65 module.xBe
32120 73 74 49 6e 64 65 78 29 3b 0d 0a 0d 0a 20 20 20 stIndex);....
32130 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 74 nat
32140 69 76 65 4d 6f 64 75 6c 65 2e 78 44 69 73 63 6f iveModule.xDisco
32150 6e 6e 65 63 74 20 3d 20 6e 65 77 20 55 6e 73 61 nnect = new Unsa
32160 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e feNativeMethods.
32170 78 44 69 73 63 6f 6e 6e 65 63 74 28 0d 0a 20 20 xDisconnect(..
32180 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32190 20 20 6d 6f 64 75 6c 65 2e 78 44 69 73 63 6f 6e module.xDiscon
321a0 6e 65 63 74 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 nect);....
321b0 20 20 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 native
321c0 4d 6f 64 75 6c 65 2e 78 44 65 73 74 72 6f 79 20 Module.xDestroy
321d0 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 69 = new UnsafeNati
321e0 76 65 4d 65 74 68 6f 64 73 2e 78 44 65 73 74 72 veMethods.xDestr
321f0 6f 79 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 oy(..
32200 20 20 20 20 20 20 20 20 20 6d 6f 64 75 6c 65 2e module.
32210 78 44 65 73 74 72 6f 79 29 3b 0d 0a 0d 0a 20 20 xDestroy);....
32220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 na
32230 74 69 76 65 4d 6f 64 75 6c 65 2e 78 4f 70 65 6e tiveModule.xOpen
32240 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 = new UnsafeNat
32250 69 76 65 4d 65 74 68 6f 64 73 2e 78 4f 70 65 6e iveMethods.xOpen
32260 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 (..
32270 20 20 20 20 20 20 20 6d 6f 64 75 6c 65 2e 78 4f module.xO
32280 70 65 6e 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 pen);....
32290 20 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d nativeM
322a0 6f 64 75 6c 65 2e 78 43 6c 6f 73 65 20 3d 20 6e odule.xClose = n
322b0 65 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d ew UnsafeNativeM
322c0 65 74 68 6f 64 73 2e 78 43 6c 6f 73 65 28 0d 0a ethods.xClose(..
322d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
322e0 20 20 20 20 6d 6f 64 75 6c 65 2e 78 43 6c 6f 73 module.xClos
322f0 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 e);....
32300 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 nativeMod
32310 75 6c 65 2e 78 46 69 6c 74 65 72 20 3d 20 6e 65 ule.xFilter = ne
32320 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 w UnsafeNativeMe
32330 74 68 6f 64 73 2e 78 46 69 6c 74 65 72 28 0d 0a thods.xFilter(..
32340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32350 20 20 20 20 6d 6f 64 75 6c 65 2e 78 46 69 6c 74 module.xFilt
32360 65 72 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 er);....
32370 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f nativeMo
32380 64 75 6c 65 2e 78 4e 65 78 74 20 3d 20 6e 65 77 dule.xNext = new
32390 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 UnsafeNativeMet
323a0 68 6f 64 73 2e 78 4e 65 78 74 28 0d 0a 20 20 20 hods.xNext(..
323b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
323c0 20 6d 6f 64 75 6c 65 2e 78 4e 65 78 74 29 3b 0d module.xNext);.
323d0 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
323e0 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e nativeModule.
323f0 78 45 6f 66 20 3d 20 6e 65 77 20 55 6e 73 61 66 xEof = new Unsaf
32400 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 eNativeMethods.x
32410 45 6f 66 28 6d 6f 64 75 6c 65 2e 78 45 6f 66 29 Eof(module.xEof)
32420 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
32430 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c nativeModul
32440 65 2e 78 43 6f 6c 75 6d 6e 20 3d 20 6e 65 77 20 e.xColumn = new
32450 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 UnsafeNativeMeth
32460 6f 64 73 2e 78 43 6f 6c 75 6d 6e 28 0d 0a 20 20 ods.xColumn(..
32470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32480 20 20 6d 6f 64 75 6c 65 2e 78 43 6f 6c 75 6d 6e module.xColumn
32490 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 );....
324a0 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 nativeModu
324b0 6c 65 2e 78 52 6f 77 49 64 20 3d 20 6e 65 77 20 le.xRowId = new
324c0 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 UnsafeNativeMeth
324d0 6f 64 73 2e 78 52 6f 77 49 64 28 0d 0a 20 20 20 ods.xRowId(..
324e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
324f0 20 6d 6f 64 75 6c 65 2e 78 52 6f 77 49 64 29 3b module.xRowId);
32500 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
32510 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 nativeModule
32520 2e 78 55 70 64 61 74 65 20 3d 20 6e 65 77 20 55 .xUpdate = new U
32530 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
32540 64 73 2e 78 55 70 64 61 74 65 28 0d 0a 20 20 20 ds.xUpdate(..
32550 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32560 20 6d 6f 64 75 6c 65 2e 78 55 70 64 61 74 65 29 module.xUpdate)
32570 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
32580 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c nativeModul
32590 65 2e 78 42 65 67 69 6e 20 3d 20 6e 65 77 20 55 e.xBegin = new U
325a0 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
325b0 64 73 2e 78 42 65 67 69 6e 28 0d 0a 20 20 20 20 ds.xBegin(..
325c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
325d0 6d 6f 64 75 6c 65 2e 78 42 65 67 69 6e 29 3b 0d module.xBegin);.
325e0 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
325f0 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e nativeModule.
32600 78 53 79 6e 63 20 3d 20 6e 65 77 20 55 6e 73 61 xSync = new Unsa
32610 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e feNativeMethods.
32620 78 53 79 6e 63 28 0d 0a 20 20 20 20 20 20 20 20 xSync(..
32630 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f 64 75 modu
32640 6c 65 2e 78 53 79 6e 63 29 3b 0d 0a 0d 0a 20 20 le.xSync);....
32650 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 na
32660 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6d 6d tiveModule.xComm
32670 69 74 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e it = new UnsafeN
32680 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 43 6f ativeMethods.xCo
32690 6d 6d 69 74 28 0d 0a 20 20 20 20 20 20 20 20 20 mmit(..
326a0 20 20 20 20 20 20 20 20 20 20 20 6d 6f 64 75 6c modul
326b0 65 2e 78 43 6f 6d 6d 69 74 29 3b 0d 0a 0d 0a 20 e.xCommit);....
326c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e n
326d0 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 52 6f 6c ativeModule.xRol
326e0 6c 62 61 63 6b 20 3d 20 6e 65 77 20 55 6e 73 61 lback = new Unsa
326f0 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e feNativeMethods.
32700 78 52 6f 6c 6c 62 61 63 6b 28 0d 0a 20 20 20 20 xRollback(..
32710 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32720 6d 6f 64 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 6b module.xRollback
32730 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 );....
32740 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 nativeModu
32750 6c 65 2e 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e le.xFindFunction
32760 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 = new UnsafeNat
32770 69 76 65 4d 65 74 68 6f 64 73 2e 78 46 69 6e 64 iveMethods.xFind
32780 46 75 6e 63 74 69 6f 6e 28 0d 0a 20 20 20 20 20 Function(..
32790 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d m
327a0 6f 64 75 6c 65 2e 78 46 69 6e 64 46 75 6e 63 74 odule.xFindFunct
327b0 69 6f 6e 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 ion);....
327c0 20 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d nativeM
327d0 6f 64 75 6c 65 2e 78 52 65 6e 61 6d 65 20 3d 20 odule.xRename =
327e0 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 new UnsafeNative
327f0 4d 65 74 68 6f 64 73 2e 78 52 65 6e 61 6d 65 28 Methods.xRename(
32800 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
32810 20 20 20 20 20 20 6d 6f 64 75 6c 65 2e 78 52 65 module.xRe
32820 6e 61 6d 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 name);....
32830 20 20 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 native
32840 4d 6f 64 75 6c 65 2e 78 53 61 76 65 70 6f 69 6e Module.xSavepoin
32850 74 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 t = new UnsafeNa
32860 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 53 61 76 tiveMethods.xSav
32870 65 70 6f 69 6e 74 28 0d 0a 20 20 20 20 20 20 20 epoint(..
32880 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f 64 mod
32890 75 6c 65 2e 78 53 61 76 65 70 6f 69 6e 74 29 3b ule.xSavepoint);
328a0 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
328b0 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 nativeModule
328c0 2e 78 52 65 6c 65 61 73 65 20 3d 20 6e 65 77 20 .xRelease = new
328d0 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 UnsafeNativeMeth
328e0 6f 64 73 2e 78 52 65 6c 65 61 73 65 28 0d 0a 20 ods.xRelease(..
328f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32900 20 20 20 6d 6f 64 75 6c 65 2e 78 52 65 6c 65 61 module.xRelea
32910 73 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 se);....
32920 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f nativeMo
32930 64 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 6b 54 6f dule.xRollbackTo
32940 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 = new UnsafeNat
32950 69 76 65 4d 65 74 68 6f 64 73 2e 78 52 6f 6c 6c iveMethods.xRoll
32960 62 61 63 6b 54 6f 28 0d 0a 20 20 20 20 20 20 20 backTo(..
32970 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f 64 mod
32980 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 6b 54 6f 29 ule.xRollbackTo)
32990 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d ;.. }
329a0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 65 6c .. el
329b0 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 se..
329c0 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 {..
329d0 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e nativeModule.
329e0 78 43 72 65 61 74 65 20 3d 20 6e 65 77 20 55 6e xCreate = new Un
329f0 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 safeNativeMethod
32a00 73 2e 78 43 72 65 61 74 65 28 0d 0a 20 20 20 20 s.xCreate(..
32a10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32a20 78 43 72 65 61 74 65 29 3b 0d 0a 0d 0a 20 20 20 xCreate);....
32a30 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 74 nat
32a40 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6e 6e 65 iveModule.xConne
32a50 63 74 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e ct = new UnsafeN
32a60 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 43 6f ativeMethods.xCo
32a70 6e 6e 65 63 74 28 0d 0a 20 20 20 20 20 20 20 20 nnect(..
32a80 20 20 20 20 20 20 20 20 20 20 20 20 78 43 6f 6e xCon
32a90 6e 65 63 74 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 nect);....
32aa0 20 20 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 native
32ab0 4d 6f 64 75 6c 65 2e 78 42 65 73 74 49 6e 64 65 Module.xBestInde
32ac0 78 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 x = new UnsafeNa
32ad0 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 42 65 73 tiveMethods.xBes
32ae0 74 49 6e 64 65 78 28 0d 0a 20 20 20 20 20 20 20 tIndex(..
32af0 20 20 20 20 20 20 20 20 20 20 20 20 20 78 42 65 xBe
32b00 73 74 49 6e 64 65 78 29 3b 0d 0a 0d 0a 20 20 20 stIndex);....
32b10 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 74 nat
32b20 69 76 65 4d 6f 64 75 6c 65 2e 78 44 69 73 63 6f iveModule.xDisco
32b30 6e 6e 65 63 74 20 3d 20 6e 65 77 20 55 6e 73 61 nnect = new Unsa
32b40 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e feNativeMethods.
32b50 78 44 69 73 63 6f 6e 6e 65 63 74 28 0d 0a 20 20 xDisconnect(..
32b60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32b70 20 20 78 44 69 73 63 6f 6e 6e 65 63 74 29 3b 0d xDisconnect);.
32b80 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
32b90 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e nativeModule.
32ba0 78 44 65 73 74 72 6f 79 20 3d 20 6e 65 77 20 55 xDestroy = new U
32bb0 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
32bc0 64 73 2e 78 44 65 73 74 72 6f 79 28 0d 0a 20 20 ds.xDestroy(..
32bd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32be0 20 20 78 44 65 73 74 72 6f 79 29 3b 0d 0a 0d 0a xDestroy);....
32bf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32c00 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 4f 70 nativeModule.xOp
32c10 65 6e 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e en = new UnsafeN
32c20 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 4f 70 ativeMethods.xOp
32c30 65 6e 28 78 4f 70 65 6e 29 3b 0d 0a 20 20 20 20 en(xOpen);..
32c40 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 74 69 nati
32c50 76 65 4d 6f 64 75 6c 65 2e 78 43 6c 6f 73 65 20 veModule.xClose
32c60 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 69 = new UnsafeNati
32c70 76 65 4d 65 74 68 6f 64 73 2e 78 43 6c 6f 73 65 veMethods.xClose
32c80 28 78 43 6c 6f 73 65 29 3b 0d 0a 0d 0a 20 20 20 (xClose);....
32c90 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 74 nat
32ca0 69 76 65 4d 6f 64 75 6c 65 2e 78 46 69 6c 74 65 iveModule.xFilte
32cb0 72 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 r = new UnsafeNa
32cc0 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 46 69 6c tiveMethods.xFil
32cd0 74 65 72 28 0d 0a 20 20 20 20 20 20 20 20 20 20 ter(..
32ce0 20 20 20 20 20 20 20 20 20 20 78 46 69 6c 74 65 xFilte
32cf0 72 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 r);....
32d00 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 nativeMod
32d10 75 6c 65 2e 78 4e 65 78 74 20 3d 20 6e 65 77 20 ule.xNext = new
32d20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 UnsafeNativeMeth
32d30 6f 64 73 2e 78 4e 65 78 74 28 78 4e 65 78 74 29 ods.xNext(xNext)
32d40 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ;..
32d50 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e nativeModule.
32d60 78 45 6f 66 20 3d 20 6e 65 77 20 55 6e 73 61 66 xEof = new Unsaf
32d70 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 eNativeMethods.x
32d80 45 6f 66 28 78 45 6f 66 29 3b 0d 0a 0d 0a 20 20 Eof(xEof);....
32d90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 61 na
32da0 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6c 75 tiveModule.xColu
32db0 6d 6e 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e mn = new UnsafeN
32dc0 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 43 6f ativeMethods.xCo
32dd0 6c 75 6d 6e 28 0d 0a 20 20 20 20 20 20 20 20 20 lumn(..
32de0 20 20 20 20 20 20 20 20 20 20 20 78 43 6f 6c 75 xColu
32df0 6d 6e 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 mn);....
32e00 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f nativeMo
32e10 64 75 6c 65 2e 78 52 6f 77 49 64 20 3d 20 6e 65 dule.xRowId = ne
32e20 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 w UnsafeNativeMe
32e30 74 68 6f 64 73 2e 78 52 6f 77 49 64 28 78 52 6f thods.xRowId(xRo
32e40 77 49 64 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 wId);....
32e50 20 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 4d nativeM
32e60 6f 64 75 6c 65 2e 78 55 70 64 61 74 65 20 3d 20 odule.xUpdate =
32e70 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 new UnsafeNative
32e80 4d 65 74 68 6f 64 73 2e 78 55 70 64 61 74 65 28 Methods.xUpdate(
32e90 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
32ea0 20 20 20 20 20 20 78 55 70 64 61 74 65 29 3b 0d xUpdate);.
32eb0 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
32ec0 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e nativeModule.
32ed0 78 42 65 67 69 6e 20 3d 20 6e 65 77 20 55 6e 73 xBegin = new Uns
32ee0 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 afeNativeMethods
32ef0 2e 78 42 65 67 69 6e 28 78 42 65 67 69 6e 29 3b .xBegin(xBegin);
32f00 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
32f10 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 nativeModule.x
32f20 53 79 6e 63 20 3d 20 6e 65 77 20 55 6e 73 61 66 Sync = new Unsaf
32f30 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 eNativeMethods.x
32f40 53 79 6e 63 28 78 53 79 6e 63 29 3b 0d 0a 0d 0a Sync(xSync);....
32f50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32f60 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 43 6f nativeModule.xCo
32f70 6d 6d 69 74 20 3d 20 6e 65 77 20 55 6e 73 61 66 mmit = new Unsaf
32f80 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 eNativeMethods.x
32f90 43 6f 6d 6d 69 74 28 0d 0a 20 20 20 20 20 20 20 Commit(..
32fa0 20 20 20 20 20 20 20 20 20 20 20 20 20 78 43 6f xCo
32fb0 6d 6d 69 74 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 mmit);....
32fc0 20 20 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 native
32fd0 4d 6f 64 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 6b Module.xRollback
32fe0 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 = new UnsafeNat
32ff0 69 76 65 4d 65 74 68 6f 64 73 2e 78 52 6f 6c 6c iveMethods.xRoll
33000 62 61 63 6b 28 0d 0a 20 20 20 20 20 20 20 20 20 back(..
33010 20 20 20 20 20 20 20 20 20 20 20 78 52 6f 6c 6c xRoll
33020 62 61 63 6b 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 back);....
33030 20 20 20 20 20 20 20 20 20 20 6e 61 74 69 76 65 native
33040 4d 6f 64 75 6c 65 2e 78 46 69 6e 64 46 75 6e 63 Module.xFindFunc
33050 74 69 6f 6e 20 3d 20 6e 65 77 20 55 6e 73 61 66 tion = new Unsaf
33060 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 eNativeMethods.x
33070 46 69 6e 64 46 75 6e 63 74 69 6f 6e 28 0d 0a 20 FindFunction(..
33080 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33090 20 20 20 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e xFindFunction
330a0 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 );....
330b0 20 20 20 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 nativeModu
330c0 6c 65 2e 78 52 65 6e 61 6d 65 20 3d 20 6e 65 77 le.xRename = new
330d0 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 UnsafeNativeMet
330e0 68 6f 64 73 2e 78 52 65 6e 61 6d 65 28 0d 0a 20 hods.xRename(..
330f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33100 20 20 20 78 52 65 6e 61 6d 65 29 3b 0d 0a 0d 0a xRename);....
33110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33120 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 53 61 nativeModule.xSa
33130 76 65 70 6f 69 6e 74 20 3d 20 6e 65 77 20 55 6e vepoint = new Un
33140 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 safeNativeMethod
33150 73 2e 78 53 61 76 65 70 6f 69 6e 74 28 0d 0a 20 s.xSavepoint(..
33160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33170 20 20 20 78 53 61 76 65 70 6f 69 6e 74 29 3b 0d xSavepoint);.
33180 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ...
33190 20 20 20 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e nativeModule.
331a0 78 52 65 6c 65 61 73 65 20 3d 20 6e 65 77 20 55 xRelease = new U
331b0 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
331c0 64 73 2e 78 52 65 6c 65 61 73 65 28 0d 0a 20 20 ds.xRelease(..
331d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
331e0 20 20 78 52 65 6c 65 61 73 65 29 3b 0d 0a 0d 0a xRelease);....
331f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33200 6e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78 52 6f nativeModule.xRo
33210 6c 6c 62 61 63 6b 54 6f 20 3d 20 6e 65 77 20 55 llbackTo = new U
33220 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
33230 64 73 2e 78 52 6f 6c 6c 62 61 63 6b 54 6f 28 0d ds.xRollbackTo(.
33240 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
33250 20 20 20 20 20 78 52 6f 6c 6c 62 61 63 6b 54 6f xRollbackTo
33260 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 );..
33270 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 }....
33280 20 72 65 74 75 72 6e 20 6e 61 74 69 76 65 4d 6f return nativeMo
33290 64 75 6c 65 3b 0d 0a 20 20 20 20 20 20 20 20 7d dule;.. }
332a0 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
332b0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
332c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
332d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
332e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
332f0 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ///.... /
33300 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
33310 20 20 20 20 20 20 2f 2f 2f 20 43 72 65 61 74 65 /// Create
33320 73 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 s a copy of the
33330 73 70 65 63 69 66 69 65 64 0d 0a 20 20 20 20 20 specified..
33340 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 /// <see cref
33350 3d 22 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 ="UnsafeNativeMe
33360 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 6d 6f thods.sqlite3_mo
33370 64 75 6c 65 22 20 2f 3e 20 6f 62 6a 65 63 74 20 dule" /> object
33380 69 6e 73 74 61 6e 63 65 2c 0d 0a 20 20 20 20 20 instance,..
33390 20 20 20 2f 2f 2f 20 75 73 69 6e 67 20 64 65 66 /// using def
333a0 61 75 6c 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 ault implementat
333b0 69 6f 6e 73 20 66 6f 72 20 74 68 65 20 63 6f 6e ions for the con
333c0 74 61 69 6e 65 64 20 64 65 6c 65 67 61 74 65 73 tained delegates
333d0 20 77 68 65 6e 0d 0a 20 20 20 20 20 20 20 20 2f when.. /
333e0 2f 2f 20 6e 65 63 65 73 73 61 72 79 2e 0d 0a 20 // necessary...
333f0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d /// </sum
33400 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f mary>.. /
33410 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 // <param name="
33420 6d 6f 64 75 6c 65 22 3e 0d 0a 20 20 20 20 20 20 module">..
33430 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 /// The <see c
33440 72 65 66 3d 22 55 6e 73 61 66 65 4e 61 74 69 76 ref="UnsafeNativ
33450 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 eMethods.sqlite3
33460 5f 6d 6f 64 75 6c 65 22 20 2f 3e 20 6f 62 6a 65 _module" /> obje
33470 63 74 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ct.. ///
33480 69 6e 73 74 61 6e 63 65 20 74 6f 20 63 6f 70 79 instance to copy
33490 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
334a0 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 /param>..
334b0 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a /// <returns>..
334c0 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
334d0 6e 65 77 20 3c 73 65 65 20 63 72 65 66 3d 22 55 new <see cref="U
334e0 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
334f0 64 73 2e 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c ds.sqlite3_modul
33500 65 22 20 2f 3e 20 6f 62 6a 65 63 74 0d 0a 20 20 e" /> object..
33510 20 20 20 20 20 20 2f 2f 2f 20 69 6e 73 74 61 6e /// instan
33520 63 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ce... ///
33530 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 </returns>..
33540 20 20 20 20 20 70 72 69 76 61 74 65 20 55 6e 73 private Uns
33550 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 afeNativeMethods
33560 2e 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 20 .sqlite3_module
33570 43 6f 70 79 4e 61 74 69 76 65 4d 6f 64 75 6c 65 CopyNativeModule
33580 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 55 (.. U
33590 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
335a0 64 73 2e 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c ds.sqlite3_modul
335b0 65 20 6d 6f 64 75 6c 65 0d 0a 20 20 20 20 20 20 e module..
335c0 20 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 )..
335d0 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 {..
335e0 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 UnsafeNativeMeth
335f0 6f 64 73 2e 73 71 6c 69 74 65 33 5f 6d 6f 64 75 ods.sqlite3_modu
33600 6c 65 20 6e 65 77 4d 6f 64 75 6c 65 20 3d 0d 0a le newModule =..
33610 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33620 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 new UnsafeNative
33630 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f Methods.sqlite3_
33640 6d 6f 64 75 6c 65 28 29 3b 0d 0a 0d 0a 20 20 20 module();....
33650 20 20 20 20 20 20 20 20 20 6e 65 77 4d 6f 64 75 newModu
33660 6c 65 2e 69 56 65 72 73 69 6f 6e 20 3d 20 6d 6f le.iVersion = mo
33670 64 75 6c 65 2e 69 56 65 72 73 69 6f 6e 3b 0d 0a dule.iVersion;..
33680 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6e 65 .. ne
33690 77 4d 6f 64 75 6c 65 2e 78 43 72 65 61 74 65 20 wModule.xCreate
336a0 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 69 = new UnsafeNati
336b0 76 65 4d 65 74 68 6f 64 73 2e 78 43 72 65 61 74 veMethods.xCreat
336c0 65 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 e(..
336d0 20 20 20 20 28 6d 6f 64 75 6c 65 2e 78 43 72 65 (module.xCre
336e0 61 74 65 20 21 3d 20 6e 75 6c 6c 29 20 3f 20 6d ate != null) ? m
336f0 6f 64 75 6c 65 2e 78 43 72 65 61 74 65 20 3a 20 odule.xCreate :
33700 78 43 72 65 61 74 65 29 3b 0d 0a 0d 0a 20 20 20 xCreate);....
33710 20 20 20 20 20 20 20 20 20 6e 65 77 4d 6f 64 75 newModu
33720 6c 65 2e 78 43 6f 6e 6e 65 63 74 20 3d 20 6e 65 le.xConnect = ne
33730 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 w UnsafeNativeMe
33740 74 68 6f 64 73 2e 78 43 6f 6e 6e 65 63 74 28 0d thods.xConnect(.
33750 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
33760 20 28 6d 6f 64 75 6c 65 2e 78 43 6f 6e 6e 65 63 (module.xConnec
33770 74 20 21 3d 20 6e 75 6c 6c 29 20 3f 20 6d 6f 64 t != null) ? mod
33780 75 6c 65 2e 78 43 6f 6e 6e 65 63 74 20 3a 20 78 ule.xConnect : x
33790 43 6f 6e 6e 65 63 74 29 3b 0d 0a 0d 0a 20 20 20 Connect);....
337a0 20 20 20 20 20 20 20 20 20 6e 65 77 4d 6f 64 75 newModu
337b0 6c 65 2e 78 42 65 73 74 49 6e 64 65 78 20 3d 20 le.xBestIndex =
337c0 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 new UnsafeNative
337d0 4d 65 74 68 6f 64 73 2e 78 42 65 73 74 49 6e 64 Methods.xBestInd
337e0 65 78 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ex(..
337f0 20 20 20 20 20 28 6d 6f 64 75 6c 65 2e 78 42 65 (module.xBe
33800 73 74 49 6e 64 65 78 20 21 3d 20 6e 75 6c 6c 29 stIndex != null)
33810 20 3f 20 6d 6f 64 75 6c 65 2e 78 42 65 73 74 49 ? module.xBestI
33820 6e 64 65 78 20 3a 20 78 42 65 73 74 49 6e 64 65 ndex : xBestInde
33830 78 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 x);....
33840 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 44 69 newModule.xDi
33850 73 63 6f 6e 6e 65 63 74 20 3d 20 6e 65 77 20 55 sconnect = new U
33860 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f nsafeNativeMetho
33870 64 73 2e 78 44 69 73 63 6f 6e 6e 65 63 74 28 0d ds.xDisconnect(.
33880 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
33890 20 28 6d 6f 64 75 6c 65 2e 78 44 69 73 63 6f 6e (module.xDiscon
338a0 6e 65 63 74 20 21 3d 20 6e 75 6c 6c 29 20 3f 20 nect != null) ?
338b0 6d 6f 64 75 6c 65 2e 78 44 69 73 63 6f 6e 6e 65 module.xDisconne
338c0 63 74 20 3a 0d 0a 20 20 20 20 20 20 20 20 20 20 ct :..
338d0 20 20 20 20 20 20 78 44 69 73 63 6f 6e 6e 65 63 xDisconnec
338e0 74 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 t);....
338f0 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 44 65 newModule.xDe
33900 73 74 72 6f 79 20 3d 20 6e 65 77 20 55 6e 73 61 stroy = new Unsa
33910 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e feNativeMethods.
33920 78 44 65 73 74 72 6f 79 28 0d 0a 20 20 20 20 20 xDestroy(..
33930 20 20 20 20 20 20 20 20 20 20 20 28 6d 6f 64 75 (modu
33940 6c 65 2e 78 44 65 73 74 72 6f 79 20 21 3d 20 6e le.xDestroy != n
33950 75 6c 6c 29 20 3f 20 6d 6f 64 75 6c 65 2e 78 44 ull) ? module.xD
33960 65 73 74 72 6f 79 20 3a 20 78 44 65 73 74 72 6f estroy : xDestro
33970 79 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 y);....
33980 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 4f 70 newModule.xOp
33990 65 6e 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e en = new UnsafeN
339a0 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 4f 70 ativeMethods.xOp
339b0 65 6e 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 en(..
339c0 20 20 20 20 20 28 6d 6f 64 75 6c 65 2e 78 4f 70 (module.xOp
339d0 65 6e 20 21 3d 20 6e 75 6c 6c 29 20 3f 20 6d 6f en != null) ? mo
339e0 64 75 6c 65 2e 78 4f 70 65 6e 20 3a 20 78 4f 70 dule.xOpen : xOp
339f0 65 6e 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 en);....
33a00 20 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 43 newModule.xC
33a10 6c 6f 73 65 20 3d 20 6e 65 77 20 55 6e 73 61 66 lose = new Unsaf
33a20 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 eNativeMethods.x
33a30 43 6c 6f 73 65 28 0d 0a 20 20 20 20 20 20 20 20 Close(..
33a40 20 20 20 20 20 20 20 20 28 6d 6f 64 75 6c 65 2e (module.
33a50 78 43 6c 6f 73 65 20 21 3d 20 6e 75 6c 6c 29 20 xClose != null)
33a60 3f 20 6d 6f 64 75 6c 65 2e 78 43 6c 6f 73 65 20 ? module.xClose
33a70 3a 20 78 43 6c 6f 73 65 29 3b 0d 0a 0d 0a 20 20 : xClose);....
33a80 20 20 20 20 20 20 20 20 20 20 6e 65 77 4d 6f 64 newMod
33a90 75 6c 65 2e 78 46 69 6c 74 65 72 20 3d 20 6e 65 ule.xFilter = ne
33aa0 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 w UnsafeNativeMe
33ab0 74 68 6f 64 73 2e 78 46 69 6c 74 65 72 28 0d 0a thods.xFilter(..
33ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33ad0 28 6d 6f 64 75 6c 65 2e 78 46 69 6c 74 65 72 20 (module.xFilter
33ae0 21 3d 20 6e 75 6c 6c 29 20 3f 20 6d 6f 64 75 6c != null) ? modul
33af0 65 2e 78 46 69 6c 74 65 72 20 3a 20 78 46 69 6c e.xFilter : xFil
33b00 74 65 72 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 ter);....
33b10 20 20 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 newModule.x
33b20 4e 65 78 74 20 3d 20 6e 65 77 20 55 6e 73 61 66 Next = new Unsaf
33b30 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 eNativeMethods.x
33b40 4e 65 78 74 28 0d 0a 20 20 20 20 20 20 20 20 20 Next(..
33b50 20 20 20 20 20 20 20 28 6d 6f 64 75 6c 65 2e 78 (module.x
33b60 4e 65 78 74 20 21 3d 20 6e 75 6c 6c 29 20 3f 20 Next != null) ?
33b70 6d 6f 64 75 6c 65 2e 78 4e 65 78 74 20 3a 20 78 module.xNext : x
33b80 4e 65 78 74 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 Next);....
33b90 20 20 20 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e newModule.
33ba0 78 45 6f 66 20 3d 20 6e 65 77 20 55 6e 73 61 66 xEof = new Unsaf
33bb0 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 eNativeMethods.x
33bc0 45 6f 66 28 0d 0a 20 20 20 20 20 20 20 20 20 20 Eof(..
33bd0 20 20 20 20 20 20 28 6d 6f 64 75 6c 65 2e 78 45 (module.xE
33be0 6f 66 20 21 3d 20 6e 75 6c 6c 29 20 3f 20 6d 6f of != null) ? mo
33bf0 64 75 6c 65 2e 78 45 6f 66 20 3a 20 78 45 6f 66 dule.xEof : xEof
33c00 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 );....
33c10 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 43 6f 6c newModule.xCol
33c20 75 6d 6e 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 umn = new Unsafe
33c30 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 43 NativeMethods.xC
33c40 6f 6c 75 6d 6e 28 0d 0a 20 20 20 20 20 20 20 20 olumn(..
33c50 20 20 20 20 20 20 20 20 28 6d 6f 64 75 6c 65 2e (module.
33c60 78 43 6f 6c 75 6d 6e 20 21 3d 20 6e 75 6c 6c 29 xColumn != null)
33c70 20 3f 20 6d 6f 64 75 6c 65 2e 78 43 6f 6c 75 6d ? module.xColum
33c80 6e 20 3a 20 78 43 6f 6c 75 6d 6e 29 3b 0d 0a 0d n : xColumn);...
33c90 0a 20 20 20 20 20 20 20 20 20 20 20 20 6e 65 77 . new
33ca0 4d 6f 64 75 6c 65 2e 78 52 6f 77 49 64 20 3d 20 Module.xRowId =
33cb0 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 new UnsafeNative
33cc0 4d 65 74 68 6f 64 73 2e 78 52 6f 77 49 64 28 0d Methods.xRowId(.
33cd0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
33ce0 20 28 6d 6f 64 75 6c 65 2e 78 52 6f 77 49 64 20 (module.xRowId
33cf0 21 3d 20 6e 75 6c 6c 29 20 3f 20 6d 6f 64 75 6c != null) ? modul
33d00 65 2e 78 52 6f 77 49 64 20 3a 20 78 52 6f 77 49 e.xRowId : xRowI
33d10 64 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 d);....
33d20 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 55 70 newModule.xUp
33d30 64 61 74 65 20 3d 20 6e 65 77 20 55 6e 73 61 66 date = new Unsaf
33d40 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 eNativeMethods.x
33d50 55 70 64 61 74 65 28 0d 0a 20 20 20 20 20 20 20 Update(..
33d60 20 20 20 20 20 20 20 20 20 28 6d 6f 64 75 6c 65 (module
33d70 2e 78 55 70 64 61 74 65 20 21 3d 20 6e 75 6c 6c .xUpdate != null
33d80 29 20 3f 20 6d 6f 64 75 6c 65 2e 78 55 70 64 61 ) ? module.xUpda
33d90 74 65 20 3a 20 78 55 70 64 61 74 65 29 3b 0d 0a te : xUpdate);..
33da0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6e 65 .. ne
33db0 77 4d 6f 64 75 6c 65 2e 78 42 65 67 69 6e 20 3d wModule.xBegin =
33dc0 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 69 76 new UnsafeNativ
33dd0 65 4d 65 74 68 6f 64 73 2e 78 42 65 67 69 6e 28 eMethods.xBegin(
33de0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
33df0 20 20 28 6d 6f 64 75 6c 65 2e 78 42 65 67 69 6e (module.xBegin
33e00 20 21 3d 20 6e 75 6c 6c 29 20 3f 20 6d 6f 64 75 != null) ? modu
33e10 6c 65 2e 78 42 65 67 69 6e 20 3a 20 78 42 65 67 le.xBegin : xBeg
33e20 69 6e 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 in);....
33e30 20 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 53 newModule.xS
33e40 79 6e 63 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 ync = new Unsafe
33e50 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 53 NativeMethods.xS
33e60 79 6e 63 28 0d 0a 20 20 20 20 20 20 20 20 20 20 ync(..
33e70 20 20 20 20 20 20 28 6d 6f 64 75 6c 65 2e 78 53 (module.xS
33e80 79 6e 63 20 21 3d 20 6e 75 6c 6c 29 20 3f 20 6d ync != null) ? m
33e90 6f 64 75 6c 65 2e 78 53 79 6e 63 20 3a 20 78 53 odule.xSync : xS
33ea0 79 6e 63 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 ync);....
33eb0 20 20 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 newModule.x
33ec0 43 6f 6d 6d 69 74 20 3d 20 6e 65 77 20 55 6e 73 Commit = new Uns
33ed0 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 afeNativeMethods
33ee0 2e 78 43 6f 6d 6d 69 74 28 0d 0a 20 20 20 20 20 .xCommit(..
33ef0 20 20 20 20 20 20 20 20 20 20 20 28 6d 6f 64 75 (modu
33f00 6c 65 2e 78 43 6f 6d 6d 69 74 20 21 3d 20 6e 75 le.xCommit != nu
33f10 6c 6c 29 20 3f 20 6d 6f 64 75 6c 65 2e 78 43 6f ll) ? module.xCo
33f20 6d 6d 69 74 20 3a 20 78 43 6f 6d 6d 69 74 29 3b mmit : xCommit);
33f30 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ....
33f40 6e 65 77 4d 6f 64 75 6c 65 2e 78 52 6f 6c 6c 62 newModule.xRollb
33f50 61 63 6b 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 ack = new Unsafe
33f60 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 78 52 NativeMethods.xR
33f70 6f 6c 6c 62 61 63 6b 28 0d 0a 20 20 20 20 20 20 ollback(..
33f80 20 20 20 20 20 20 20 20 20 20 28 6d 6f 64 75 6c (modul
33f90 65 2e 78 52 6f 6c 6c 62 61 63 6b 20 21 3d 20 6e e.xRollback != n
33fa0 75 6c 6c 29 20 3f 20 6d 6f 64 75 6c 65 2e 78 52 ull) ? module.xR
33fb0 6f 6c 6c 62 61 63 6b 20 3a 20 78 52 6f 6c 6c 62 ollback : xRollb
33fc0 61 63 6b 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 ack);....
33fd0 20 20 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 newModule.x
33fe0 46 69 6e 64 46 75 6e 63 74 69 6f 6e 20 3d 20 6e FindFunction = n
33ff0 65 77 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d ew UnsafeNativeM
34000 65 74 68 6f 64 73 2e 78 46 69 6e 64 46 75 6e 63 ethods.xFindFunc
34010 74 69 6f 6e 28 0d 0a 20 20 20 20 20 20 20 20 20 tion(..
34020 20 20 20 20 20 20 20 28 6d 6f 64 75 6c 65 2e 78 (module.x
34030 46 69 6e 64 46 75 6e 63 74 69 6f 6e 20 21 3d 20 FindFunction !=
34040 6e 75 6c 6c 29 20 3f 20 6d 6f 64 75 6c 65 2e 78 null) ? module.x
34050 46 69 6e 64 46 75 6e 63 74 69 6f 6e 20 3a 0d 0a FindFunction :..
34060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34070 78 46 69 6e 64 46 75 6e 63 74 69 6f 6e 29 3b 0d xFindFunction);.
34080 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6e ... n
34090 65 77 4d 6f 64 75 6c 65 2e 78 52 65 6e 61 6d 65 ewModule.xRename
340a0 20 3d 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 = new UnsafeNat
340b0 69 76 65 4d 65 74 68 6f 64 73 2e 78 52 65 6e 61 iveMethods.xRena
340c0 6d 65 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 me(..
340d0 20 20 20 20 20 28 6d 6f 64 75 6c 65 2e 78 52 65 (module.xRe
340e0 6e 61 6d 65 20 21 3d 20 6e 75 6c 6c 29 20 3f 20 name != null) ?
340f0 6d 6f 64 75 6c 65 2e 78 52 65 6e 61 6d 65 20 3a module.xRename :
34100 20 78 52 65 6e 61 6d 65 29 3b 0d 0a 0d 0a 20 20 xRename);....
34110 20 20 20 20 20 20 20 20 20 20 6e 65 77 4d 6f 64 newMod
34120 75 6c 65 2e 78 53 61 76 65 70 6f 69 6e 74 20 3d ule.xSavepoint =
34130 20 6e 65 77 20 55 6e 73 61 66 65 4e 61 74 69 76 new UnsafeNativ
34140 65 4d 65 74 68 6f 64 73 2e 78 53 61 76 65 70 6f eMethods.xSavepo
34150 69 6e 74 28 0d 0a 20 20 20 20 20 20 20 20 20 20 int(..
34160 20 20 20 20 20 20 28 6d 6f 64 75 6c 65 2e 78 53 (module.xS
34170 61 76 65 70 6f 69 6e 74 20 21 3d 20 6e 75 6c 6c avepoint != null
34180 29 20 3f 20 6d 6f 64 75 6c 65 2e 78 53 61 76 65 ) ? module.xSave
34190 70 6f 69 6e 74 20 3a 20 78 53 61 76 65 70 6f 69 point : xSavepoi
341a0 6e 74 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 nt);....
341b0 20 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 52 newModule.xR
341c0 65 6c 65 61 73 65 20 3d 20 6e 65 77 20 55 6e 73 elease = new Uns
341d0 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 afeNativeMethods
341e0 2e 78 52 65 6c 65 61 73 65 28 0d 0a 20 20 20 20 .xRelease(..
341f0 20 20 20 20 20 20 20 20 20 20 20 20 28 6d 6f 64 (mod
34200 75 6c 65 2e 78 52 65 6c 65 61 73 65 20 21 3d 20 ule.xRelease !=
34210 6e 75 6c 6c 29 20 3f 20 6d 6f 64 75 6c 65 2e 78 null) ? module.x
34220 52 65 6c 65 61 73 65 20 3a 20 78 52 65 6c 65 61 Release : xRelea
34230 73 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 se);....
34240 20 20 20 20 6e 65 77 4d 6f 64 75 6c 65 2e 78 52 newModule.xR
34250 6f 6c 6c 62 61 63 6b 54 6f 20 3d 20 6e 65 77 20 ollbackTo = new
34260 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 UnsafeNativeMeth
34270 6f 64 73 2e 78 52 6f 6c 6c 62 61 63 6b 54 6f 28 ods.xRollbackTo(
34280 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
34290 20 20 28 6d 6f 64 75 6c 65 2e 78 52 6f 6c 6c 62 (module.xRollb
342a0 61 63 6b 54 6f 20 21 3d 20 6e 75 6c 6c 29 20 3f ackTo != null) ?
342b0 20 6d 6f 64 75 6c 65 2e 78 52 6f 6c 6c 62 61 63 module.xRollbac
342c0 6b 54 6f 20 3a 0d 0a 20 20 20 20 20 20 20 20 20 kTo :..
342d0 20 20 20 20 20 20 20 78 52 6f 6c 6c 62 61 63 6b xRollback
342e0 54 6f 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 To);....
342f0 20 20 20 20 72 65 74 75 72 6e 20 6e 65 77 4d 6f return newMo
34300 64 75 6c 65 3b 0d 0a 20 20 20 20 20 20 20 20 7d dule;.. }
34310 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
34320 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
34330 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
34340 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
34350 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
34360 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f ///.... /
34370 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 // <summary>..
34380 20 20 20 20 20 20 2f 2f 2f 20 43 61 6c 6c 73 20 /// Calls
34390 6f 6e 65 20 6f 66 20 74 68 65 20 76 69 72 74 75 one of the virtu
343a0 61 6c 20 74 61 62 6c 65 20 69 6e 69 74 69 61 6c al table initial
343b0 69 7a 61 74 69 6f 6e 20 6d 65 74 68 6f 64 73 2e ization methods.
343c0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
343d0 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
343e0 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d /// <param nam
343f0 65 3d 22 63 72 65 61 74 65 22 3e 0d 0a 20 20 20 e="create">..
34400 20 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 /// Non-zer
34410 6f 20 74 6f 20 63 61 6c 6c 20 74 68 65 20 3c 73 o to call the <s
34420 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 ee cref="ISQLite
34430 4d 61 6e 61 67 65 64 4d 6f 64 75 6c 65 2e 43 72 ManagedModule.Cr
34440 65 61 74 65 22 20 2f 3e 0d 0a 20 20 20 20 20 20 eate" />..
34450 20 20 2f 2f 2f 20 6d 65 74 68 6f 64 3b 20 6f 74 /// method; ot
34460 68 65 72 77 69 73 65 2c 20 74 68 65 20 3c 73 65 herwise, the <se
34470 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4d e cref="ISQLiteM
34480 61 6e 61 67 65 64 4d 6f 64 75 6c 65 2e 43 6f 6e anagedModule.Con
34490 6e 65 63 74 22 20 2f 3e 0d 0a 20 20 20 20 20 20 nect" />..
344a0 20 20 2f 2f 2f 20 6d 65 74 68 6f 64 20 77 69 6c /// method wil
344b0 6c 20 62 65 20 63 61 6c 6c 65 64 2e 0d 0a 20 20 l be called...
344c0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 /// </para
344d0 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 m>.. ///
344e0 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 44 62 <param name="pDb
344f0 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
34500 54 68 65 20 6e 61 74 69 76 65 20 64 61 74 61 62 The native datab
34510 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 ase connection h
34520 61 6e 64 6c 65 2e 0d 0a 20 20 20 20 20 20 20 20 andle...
34530 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
34540 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
34550 20 6e 61 6d 65 3d 22 70 41 75 78 22 3e 0d 0a 20 name="pAux">..
34560 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6f /// The o
34570 72 69 67 69 6e 61 6c 20 6e 61 74 69 76 65 20 70 riginal native p
34580 6f 69 6e 74 65 72 20 76 61 6c 75 65 20 74 68 61 ointer value tha
34590 74 20 77 61 73 20 70 72 6f 76 69 64 65 64 20 74 t was provided t
345a0 6f 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 2f o the.. /
345b0 2f 2f 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 // sqlite3_creat
345c0 65 5f 6d 6f 64 75 6c 65 28 29 2c 20 73 71 6c 69 e_module(), sqli
345d0 74 65 33 5f 63 72 65 61 74 65 5f 6d 6f 64 75 6c te3_create_modul
345e0 65 5f 76 32 28 29 20 6f 72 0d 0a 20 20 20 20 20 e_v2() or..
345f0 20 20 20 2f 2f 2f 20 73 71 6c 69 74 65 33 5f 63 /// sqlite3_c
34600 72 65 61 74 65 5f 64 69 73 70 6f 73 61 62 6c 65 reate_disposable
34610 5f 6d 6f 64 75 6c 65 28 29 20 66 75 6e 63 74 69 _module() functi
34620 6f 6e 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ons... //
34630 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 / </param>..
34640 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e /// <param n
34650 61 6d 65 3d 22 61 72 67 63 22 3e 0d 0a 20 20 20 ame="argc">..
34660 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 75 6d /// The num
34670 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 ber of arguments
34680 20 66 72 6f 6d 20 74 68 65 20 43 52 45 41 54 45 from the CREATE
34690 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20 73 VIRTUAL TABLE s
346a0 74 61 74 65 6d 65 6e 74 2e 0d 0a 20 20 20 20 20 tatement...
346b0 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
346c0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
346d0 72 61 6d 20 6e 61 6d 65 3d 22 61 72 67 76 22 3e ram name="argv">
346e0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
346f0 65 20 61 72 72 61 79 20 6f 66 20 73 74 72 69 6e e array of strin
34700 67 20 61 72 67 75 6d 65 6e 74 73 20 66 72 6f 6d g arguments from
34710 20 74 68 65 20 43 52 45 41 54 45 20 56 49 52 54 the CREATE VIRT
34720 55 41 4c 20 54 41 42 4c 45 0d 0a 20 20 20 20 20 UAL TABLE..
34730 20 20 20 2f 2f 2f 20 73 74 61 74 65 6d 65 6e 74 /// statement
34740 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
34750 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 /param>..
34760 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
34770 3d 22 70 56 74 61 62 22 3e 0d 0a 20 20 20 20 20 ="pVtab">..
34780 20 20 20 2f 2f 2f 20 55 70 6f 6e 20 73 75 63 63 /// Upon succ
34790 65 73 73 2c 20 74 68 69 73 20 70 61 72 61 6d 65 ess, this parame
347a0 74 65 72 20 6d 75 73 74 20 62 65 20 6d 6f 64 69 ter must be modi
347b0 66 69 65 64 20 74 6f 20 70 6f 69 6e 74 20 74 6f fied to point to
347c0 20 74 68 65 20 6e 65 77 6c 79 0d 0a 20 20 20 20 the newly..
347d0 20 20 20 20 2f 2f 2f 20 63 72 65 61 74 65 64 20 /// created
347e0 6e 61 74 69 76 65 20 73 71 6c 69 74 65 33 5f 76 native sqlite3_v
347f0 74 61 62 20 64 65 72 69 76 65 64 20 73 74 72 75 tab derived stru
34800 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 20 cture...
34810 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
34820 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
34830 20 6e 61 6d 65 3d 22 70 45 72 72 6f 72 22 3e 0d name="pError">.
34840 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 55 70 6f . /// Upo
34850 6e 20 66 61 69 6c 75 72 65 2c 20 74 68 69 73 20 n failure, this
34860 70 61 72 61 6d 65 74 65 72 20 6d 75 73 74 20 62 parameter must b
34870 65 20 6d 6f 64 69 66 69 65 64 20 74 6f 20 70 6f e modified to po
34880 69 6e 74 20 74 6f 20 74 68 65 20 65 72 72 6f 72 int to the error
34890 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6d 65 .. /// me
348a0 73 73 61 67 65 2c 20 77 69 74 68 20 74 68 65 20 ssage, with the
348b0 75 6e 64 65 72 6c 79 69 6e 67 20 6d 65 6d 6f 72 underlying memor
348c0 79 20 68 61 76 69 6e 67 20 62 65 65 6e 20 6f 62 y having been ob
348d0 74 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 0d tained from the.
348e0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 73 71 6c . /// sql
348f0 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 20 66 75 ite3_malloc() fu
34900 6e 63 74 69 6f 6e 2e 0d 0a 20 20 20 20 20 20 20 nction...
34910 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
34920 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 /// <retu
34930 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f rns>.. //
34940 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c / A standard SQL
34950 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e ite return code.
34960 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
34970 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
34980 20 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 private SQLite
34990 45 72 72 6f 72 43 6f 64 65 20 43 72 65 61 74 65 ErrorCode Create
349a0 4f 72 43 6f 6e 6e 65 63 74 28 0d 0a 20 20 20 20 OrConnect(..
349b0 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 63 72 65 bool cre
349c0 61 74 65 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 ate,..
349d0 20 20 49 6e 74 50 74 72 20 70 44 62 2c 0d 0a 20 IntPtr pDb,..
349e0 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 IntPt
349f0 72 20 70 41 75 78 2c 0d 0a 20 20 20 20 20 20 20 r pAux,..
34a00 20 20 20 20 20 69 6e 74 20 61 72 67 63 2c 0d 0a int argc,..
34a10 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 IntP
34a20 74 72 20 61 72 67 76 2c 0d 0a 20 20 20 20 20 20 tr argv,..
34a30 20 20 20 20 20 20 72 65 66 20 49 6e 74 50 74 72 ref IntPtr
34a40 20 70 56 74 61 62 2c 0d 0a 20 20 20 20 20 20 20 pVtab,..
34a50 20 20 20 20 20 72 65 66 20 49 6e 74 50 74 72 20 ref IntPtr
34a60 70 45 72 72 6f 72 0d 0a 20 20 20 20 20 20 20 20 pError..
34a70 20 20 20 20 29 0d 0a 20 20 20 20 20 20 20 20 7b ).. {
34a80 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 72 .. tr
34a90 79 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b y.. {
34aa0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
34ab0 20 20 73 74 72 69 6e 67 20 66 69 6c 65 4e 61 6d string fileNam
34ac0 65 20 3d 20 53 51 4c 69 74 65 53 74 72 69 6e 67 e = SQLiteString
34ad0 2e 53 74 72 69 6e 67 46 72 6f 6d 55 74 66 38 49 .StringFromUtf8I
34ae0 6e 74 50 74 72 28 0d 0a 20 20 20 20 20 20 20 20 ntPtr(..
34af0 20 20 20 20 20 20 20 20 20 20 20 20 55 6e 73 61 Unsa
34b00 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e feNativeMethods.
34b10 73 71 6c 69 74 65 33 5f 64 62 5f 66 69 6c 65 6e sqlite3_db_filen
34b20 61 6d 65 28 70 44 62 2c 20 49 6e 74 50 74 72 2e ame(pDb, IntPtr.
34b30 5a 65 72 6f 29 29 3b 0d 0a 0d 0a 20 20 20 20 20 Zero));....
34b40 20 20 20 20 20 20 20 20 20 20 20 75 73 69 6e 67 using
34b50 20 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 (SQLiteConnecti
34b60 6f 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 3d 20 on connection =
34b70 6e 65 77 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 new SQLiteConnec
34b80 74 69 6f 6e 28 0d 0a 20 20 20 20 20 20 20 20 20 tion(..
34b90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 p
34ba0 44 62 2c 20 66 69 6c 65 4e 61 6d 65 2c 20 66 61 Db, fileName, fa
34bb0 6c 73 65 29 29 0d 0a 20 20 20 20 20 20 20 20 20 lse))..
34bc0 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
34bd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
34be0 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c 65 LiteVirtualTable
34bf0 20 74 61 62 6c 65 20 3d 20 6e 75 6c 6c 3b 0d 0a table = null;..
34c00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34c10 20 20 20 20 73 74 72 69 6e 67 20 65 72 72 6f 72 string error
34c20 20 3d 20 6e 75 6c 6c 3b 0d 0a 0d 0a 20 20 20 20 = null;....
34c30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34c40 69 66 20 28 28 63 72 65 61 74 65 20 26 26 20 43 if ((create && C
34c50 72 65 61 74 65 28 63 6f 6e 6e 65 63 74 69 6f 6e reate(connection
34c60 2c 20 70 41 75 78 2c 0d 0a 20 20 20 20 20 20 20 , pAux,..
34c70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34c80 20 20 20 20 20 53 51 4c 69 74 65 53 74 72 69 6e SQLiteStrin
34c90 67 2e 53 74 72 69 6e 67 41 72 72 61 79 46 72 6f g.StringArrayFro
34ca0 6d 55 74 66 38 53 69 7a 65 41 6e 64 49 6e 74 50 mUtf8SizeAndIntP
34cb0 74 72 28 61 72 67 63 2c 0d 0a 20 20 20 20 20 20 tr(argc,..
34cc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34cd0 20 20 20 20 20 20 61 72 67 76 29 2c 20 72 65 66 argv), ref
34ce0 20 74 61 62 6c 65 2c 20 72 65 66 20 65 72 72 6f table, ref erro
34cf0 72 29 20 3d 3d 20 53 51 4c 69 74 65 45 72 72 6f r) == SQLiteErro
34d00 72 43 6f 64 65 2e 4f 6b 29 20 7c 7c 0d 0a 20 20 rCode.Ok) ||..
34d10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34d20 20 20 20 20 20 20 28 21 63 72 65 61 74 65 20 26 (!create &
34d30 26 20 43 6f 6e 6e 65 63 74 28 63 6f 6e 6e 65 63 & Connect(connec
34d40 74 69 6f 6e 2c 20 70 41 75 78 2c 0d 0a 20 20 20 tion, pAux,..
34d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34d60 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 53 SQLiteS
34d70 74 72 69 6e 67 2e 53 74 72 69 6e 67 41 72 72 61 tring.StringArra
34d80 79 46 72 6f 6d 55 74 66 38 53 69 7a 65 41 6e 64 yFromUtf8SizeAnd
34d90 49 6e 74 50 74 72 28 61 72 67 63 2c 0d 0a 20 20 IntPtr(argc,..
34da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34db0 20 20 20 20 20 20 20 20 20 20 61 72 67 76 29 2c argv),
34dc0 20 72 65 66 20 74 61 62 6c 65 2c 20 72 65 66 20 ref table, ref
34dd0 65 72 72 6f 72 29 20 3d 3d 20 53 51 4c 69 74 65 error) == SQLite
34de0 45 72 72 6f 72 43 6f 64 65 2e 4f 6b 29 29 0d 0a ErrorCode.Ok))..
34df0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34e00 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 {..
34e10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 i
34e20 66 20 28 74 61 62 6c 65 20 21 3d 20 6e 75 6c 6c f (table != null
34e30 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 )..
34e40 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 {..
34e50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34e60 20 20 20 20 20 20 20 20 20 20 70 56 74 61 62 20 pVtab
34e70 3d 20 54 61 62 6c 65 54 6f 49 6e 74 50 74 72 28 = TableToIntPtr(
34e80 74 61 62 6c 65 29 3b 0d 0a 20 20 20 20 20 20 20 table);..
34e90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34ea0 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 69 return SQLi
34eb0 74 65 45 72 72 6f 72 43 6f 64 65 2e 4f 6b 3b 0d teErrorCode.Ok;.
34ec0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
34ed0 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 }..
34ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34ef0 20 20 20 20 65 6c 73 65 0d 0a 20 20 20 20 20 20 else..
34f00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34f10 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
34f20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34f30 20 70 45 72 72 6f 72 20 3d 20 53 51 4c 69 74 65 pError = SQLite
34f40 53 74 72 69 6e 67 2e 55 74 66 38 49 6e 74 50 74 String.Utf8IntPt
34f50 72 46 72 6f 6d 53 74 72 69 6e 67 28 0d 0a 20 20 rFromString(..
34f60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34f70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 6e "n
34f80 6f 20 74 61 62 6c 65 20 77 61 73 20 63 72 65 61 o table was crea
34f90 74 65 64 22 29 3b 0d 0a 20 20 20 20 20 20 20 20 ted");..
34fa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
34fb0 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 }..
34fc0 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 }..
34fd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 6c el
34fe0 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 se..
34ff0 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
35000 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35010 20 20 20 70 45 72 72 6f 72 20 3d 20 53 51 4c 69 pError = SQLi
35020 74 65 53 74 72 69 6e 67 2e 55 74 66 38 49 6e 74 teString.Utf8Int
35030 50 74 72 46 72 6f 6d 53 74 72 69 6e 67 28 65 72 PtrFromString(er
35040 72 6f 72 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 ror);..
35050 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 }..
35060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d }.
35070 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a . }..
35080 20 20 20 20 20 20 20 20 20 20 20 20 63 61 74 63 catc
35090 68 20 28 45 78 63 65 70 74 69 6f 6e 20 65 29 20 h (Exception e)
350a0 2f 2a 20 4e 4f 54 45 3a 20 4d 75 73 74 20 63 61 /* NOTE: Must ca
350b0 74 63 68 20 41 4c 4c 2e 20 2a 2f 0d 0a 20 20 20 tch ALL. */..
350c0 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
350d0 20 20 20 20 20 20 20 20 20 20 20 20 70 45 72 72 pErr
350e0 6f 72 20 3d 20 53 51 4c 69 74 65 53 74 72 69 6e or = SQLiteStrin
350f0 67 2e 55 74 66 38 49 6e 74 50 74 72 46 72 6f 6d g.Utf8IntPtrFrom
35100 53 74 72 69 6e 67 28 65 2e 54 6f 53 74 72 69 6e String(e.ToStrin
35110 67 28 29 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 g());..
35120 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 }....
35130 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 69 74 return SQLit
35140 65 45 72 72 6f 72 43 6f 64 65 2e 45 72 72 6f 72 eErrorCode.Error
35150 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a ;.. }....
35160 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f ////////
35170 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
35180 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
35190 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
351a0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d ///////////////.
351b0 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
351c0 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 summary>..
351d0 20 20 2f 2f 2f 20 43 61 6c 6c 73 20 6f 6e 65 20 /// Calls one
351e0 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 of the virtual t
351f0 61 62 6c 65 20 66 69 6e 61 6c 69 7a 61 74 69 6f able finalizatio
35200 6e 20 6d 65 74 68 6f 64 73 2e 0d 0a 20 20 20 20 n methods...
35210 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 /// </summar
35220 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 y>.. ///
35230 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 64 65 73 <param name="des
35240 74 72 6f 79 22 3e 0d 0a 20 20 20 20 20 20 20 20 troy">..
35250 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 6f 20 74 6f 20 /// Non-zero to
35260 63 61 6c 6c 20 74 68 65 20 3c 73 65 65 20 63 72 call the <see cr
35270 65 66 3d 22 49 53 51 4c 69 74 65 4d 61 6e 61 67 ef="ISQLiteManag
35280 65 64 4d 6f 64 75 6c 65 2e 44 65 73 74 72 6f 79 edModule.Destroy
35290 22 20 2f 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f " />.. //
352a0 2f 20 6d 65 74 68 6f 64 3b 20 6f 74 68 65 72 77 / method; otherw
352b0 69 73 65 2c 20 74 68 65 0d 0a 20 20 20 20 20 20 ise, the..
352c0 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d /// <see cref=
352d0 22 49 53 51 4c 69 74 65 4d 61 6e 61 67 65 64 4d "ISQLiteManagedM
352e0 6f 64 75 6c 65 2e 44 69 73 63 6f 6e 6e 65 63 74 odule.Disconnect
352f0 22 20 2f 3e 20 6d 65 74 68 6f 64 20 77 69 6c 6c " /> method will
35300 20 62 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f be.. ///
35310 20 63 61 6c 6c 65 64 2e 0d 0a 20 20 20 20 20 20 called...
35320 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
35330 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
35340 61 6d 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 3e am name="pVtab">
35350 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
35360 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 72 e native pointer
35370 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f to the sqlite3_
35380 76 74 61 62 20 64 65 72 69 76 65 64 20 73 74 72 vtab derived str
35390 75 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 20 ucture...
353a0 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 /// </param>..
353b0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 /// <retu
353c0 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f rns>.. //
353d0 2f 20 41 20 73 74 61 6e 64 61 72 64 20 53 51 4c / A standard SQL
353e0 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 2e ite return code.
353f0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
35400 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
35410 20 20 70 72 69 76 61 74 65 20 53 51 4c 69 74 65 private SQLite
35420 45 72 72 6f 72 43 6f 64 65 20 44 65 73 74 72 6f ErrorCode Destro
35430 79 4f 72 44 69 73 63 6f 6e 6e 65 63 74 28 0d 0a yOrDisconnect(..
35440 20 20 20 20 20 20 20 20 20 20 20 20 62 6f 6f 6c bool
35450 20 64 65 73 74 72 6f 79 2c 0d 0a 20 20 20 20 20 destroy,..
35460 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 70 56 IntPtr pV
35470 74 61 62 0d 0a 20 20 20 20 20 20 20 20 20 20 20 tab..
35480 20 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 ).. {..
35490 20 20 20 20 20 20 20 20 20 20 20 74 72 79 0d 0a try..
354a0 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 {..
354b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
354c0 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c QLiteVirtualTabl
354d0 65 20 74 61 62 6c 65 20 3d 20 54 61 62 6c 65 46 e table = TableF
354e0 72 6f 6d 49 6e 74 50 74 72 28 70 56 74 61 62 29 romIntPtr(pVtab)
354f0 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 ;....
35500 20 20 20 20 20 69 66 20 28 74 61 62 6c 65 20 21 if (table !
35510 3d 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 20 20 = null)..
35520 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
35530 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35540 69 66 20 28 28 64 65 73 74 72 6f 79 20 26 26 20 if ((destroy &&
35550 28 44 65 73 74 72 6f 79 28 74 61 62 6c 65 29 20 (Destroy(table)
35560 3d 3d 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f == SQLiteErrorCo
35570 64 65 2e 4f 6b 29 29 20 7c 7c 0d 0a 20 20 20 20 de.Ok)) ||..
35580 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35590 20 20 20 20 28 21 64 65 73 74 72 6f 79 20 26 26 (!destroy &&
355a0 20 28 44 69 73 63 6f 6e 6e 65 63 74 28 74 61 62 (Disconnect(tab
355b0 6c 65 29 20 3d 3d 20 53 51 4c 69 74 65 45 72 72 le) == SQLiteErr
355c0 6f 72 43 6f 64 65 2e 4f 6b 29 29 29 0d 0a 20 20 orCode.Ok)))..
355d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
355e0 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
355f0 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 if
35600 28 74 61 62 6c 65 73 20 21 3d 20 6e 75 6c 6c 29 (tables != null)
35610 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
35620 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 61 ta
35630 62 6c 65 73 2e 52 65 6d 6f 76 65 28 70 56 74 61 bles.Remove(pVta
35640 62 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 b);....
35650 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 r
35660 65 74 75 72 6e 20 53 51 4c 69 74 65 45 72 72 6f eturn SQLiteErro
35670 72 43 6f 64 65 2e 4f 6b 3b 0d 0a 20 20 20 20 20 rCode.Ok;..
35680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d }
35690 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
356a0 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 }..
356b0 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 }..
356c0 63 61 74 63 68 20 28 45 78 63 65 70 74 69 6f 6e catch (Exception
356d0 20 65 29 20 2f 2a 20 4e 4f 54 45 3a 20 4d 75 73 e) /* NOTE: Mus
356e0 74 20 63 61 74 63 68 20 41 4c 4c 2e 20 2a 2f 0d t catch ALL. */.
356f0 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a . {..
35700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35710 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 //..
35720 20 20 20 20 2f 2f 20 4e 4f 54 45 3a 20 41 74 20 // NOTE: At
35730 74 68 69 73 20 70 6f 69 6e 74 2c 20 74 68 65 72 this point, ther
35740 65 20 69 73 20 6e 6f 20 77 61 79 20 74 6f 20 72 e is no way to r
35750 65 70 6f 72 74 20 74 68 65 20 65 72 72 6f 72 0d eport the error.
35760 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
35770 20 2f 2f 20 20 20 20 20 20 20 63 6f 6e 64 69 74 // condit
35780 69 6f 6e 20 62 61 63 6b 20 74 6f 20 74 68 65 20 ion back to the
35790 63 61 6c 6c 65 72 3b 20 74 68 65 72 65 66 6f 72 caller; therefor
357a0 65 2c 20 75 73 65 20 74 68 65 0d 0a 20 20 20 20 e, use the..
357b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 20 //
357c0 20 20 20 20 20 6c 6f 67 67 69 6e 67 20 66 61 63 logging fac
357d0 69 6c 69 74 79 20 69 6e 73 74 65 61 64 2e 0d 0a ility instead...
357e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
357f0 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 //..
35800 20 20 20 20 74 72 79 0d 0a 20 20 20 20 20 20 20 try..
35810 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
35820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35830 69 66 20 28 4c 6f 67 45 78 63 65 70 74 69 6f 6e if (LogException
35840 73 4e 6f 54 68 72 6f 77 29 0d 0a 20 20 20 20 20 sNoThrow)..
35850 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7b {
35860 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
35870 20 20 20 20 20 20 20 20 20 20 2f 2a 20 74 68 72 /* thr
35880 6f 77 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 20 ow */..
35890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
358a0 51 4c 69 74 65 4c 6f 67 2e 4c 6f 67 4d 65 73 73 QLiteLog.LogMess
358b0 61 67 65 28 53 51 4c 69 74 65 42 61 73 65 2e 43 age(SQLiteBase.C
358c0 4f 52 5f 45 5f 45 58 43 45 50 54 49 4f 4e 2c 0d OR_E_EXCEPTION,.
358d0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
358e0 20 20 20 20 20 20 20 20 20 20 20 20 20 53 74 72 Str
358f0 69 6e 67 2e 46 6f 72 6d 61 74 28 43 75 6c 74 75 ing.Format(Cultu
35900 72 65 49 6e 66 6f 2e 43 75 72 72 65 6e 74 43 75 reInfo.CurrentCu
35910 6c 74 75 72 65 2c 0d 0a 20 20 20 20 20 20 20 20 lture,..
35920 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35930 20 20 20 20 22 43 61 75 67 68 74 20 65 78 63 65 "Caught exce
35940 70 74 69 6f 6e 20 69 6e 20 5c 22 7b 30 7d 5c 22 ption in \"{0}\"
35950 20 6d 65 74 68 6f 64 3a 20 7b 31 7d 22 2c 0d 0a method: {1}",..
35960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35970 20 20 20 20 20 20 20 20 20 20 20 20 64 65 73 74 dest
35980 72 6f 79 20 3f 20 22 78 44 65 73 74 72 6f 79 22 roy ? "xDestroy"
35990 20 3a 20 22 78 44 69 73 63 6f 6e 6e 65 63 74 22 : "xDisconnect"
359a0 2c 20 65 29 29 3b 0d 0a 20 20 20 20 20 20 20 20 , e));..
359b0 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 }..
359c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d }
359d0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
359e0 20 20 63 61 74 63 68 0d 0a 20 20 20 20 20 20 20 catch..
359f0 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 {..
35a00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35a10 2f 2f 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0d 0a // do nothing...
35a20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35a30 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d }.. }
35a40 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 66 69 .. fi
35a50 6e 61 6c 6c 79 0d 0a 20 20 20 20 20 20 20 20 20 nally..
35a60 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
35a70 20 20 20 20 20 20 46 72 65 65 54 61 62 6c 65 28 FreeTable(
35a80 70 56 74 61 62 29 3b 0d 0a 20 20 20 20 20 20 20 pVtab);..
35a90 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 }....
35aa0 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
35ab0 69 74 65 45 72 72 6f 72 43 6f 64 65 2e 45 72 72 iteErrorCode.Err
35ac0 6f 72 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a or;.. }..
35ad0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
35ae0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
35af0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
35b00 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
35b10 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
35b20 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 72 65 /.... #re
35b30 67 69 6f 6e 20 53 74 61 74 69 63 20 45 72 72 6f gion Static Erro
35b40 72 20 48 61 6e 64 6c 69 6e 67 20 48 65 6c 70 65 r Handling Helpe
35b50 72 20 4d 65 74 68 6f 64 73 0d 0a 20 20 20 20 20 r Methods..
35b60 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
35b70 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 72 .. /// Ar
35b80 72 61 6e 67 65 73 20 66 6f 72 20 74 68 65 20 73 ranges for the s
35b90 70 65 63 69 66 69 65 64 20 65 72 72 6f 72 20 6d pecified error m
35ba0 65 73 73 61 67 65 20 74 6f 20 62 65 20 70 6c 61 essage to be pla
35bb0 63 65 64 20 69 6e 74 6f 20 74 68 65 0d 0a 20 20 ced into the..
35bc0 20 20 20 20 20 20 2f 2f 2f 20 7a 45 72 72 4d 73 /// zErrMs
35bd0 67 20 66 69 65 6c 64 20 6f 66 20 61 20 73 71 6c g field of a sql
35be0 69 74 65 33 5f 76 74 61 62 20 64 65 72 69 76 65 ite3_vtab derive
35bf0 64 20 73 74 72 75 63 74 75 72 65 2c 20 66 72 65 d structure, fre
35c00 65 69 6e 67 20 74 68 65 0d 0a 20 20 20 20 20 20 eing the..
35c10 20 20 2f 2f 2f 20 65 78 69 73 74 69 6e 67 20 65 /// existing e
35c20 72 72 6f 72 20 6d 65 73 73 61 67 65 2c 20 69 66 rror message, if
35c30 20 61 6e 79 2e 0d 0a 20 20 20 20 20 20 20 20 2f any... /
35c40 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
35c50 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
35c60 6d 20 6e 61 6d 65 3d 22 6d 6f 64 75 6c 65 22 3e m name="module">
35c70 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
35c80 65 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c e <see cref="SQL
35c90 69 74 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 6f 62 iteModule" /> ob
35ca0 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 74 6f ject instance to
35cb0 20 62 65 20 75 73 65 64 2e 0d 0a 20 20 20 20 20 be used...
35cc0 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
35cd0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
35ce0 72 61 6d 20 6e 61 6d 65 3d 22 70 56 74 61 62 22 ram name="pVtab"
35cf0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 >.. /// T
35d00 68 65 20 6e 61 74 69 76 65 20 70 6f 69 6e 74 65 he native pointe
35d10 72 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 r to the sqlite3
35d20 5f 76 74 61 62 20 64 65 72 69 76 65 64 20 73 74 _vtab derived st
35d30 72 75 63 74 75 72 65 2e 0d 0a 20 20 20 20 20 20 ructure...
35d40 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a /// </param>..
35d50 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 /// <par
35d60 61 6d 20 6e 61 6d 65 3d 22 6c 6f 67 45 72 72 6f am name="logErro
35d70 72 73 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f rs">.. //
35d80 2f 20 4e 6f 6e 2d 7a 65 72 6f 20 69 66 20 74 68 / Non-zero if th
35d90 69 73 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 is error message
35da0 20 73 68 6f 75 6c 64 20 61 6c 73 6f 20 62 65 20 should also be
35db0 6c 6f 67 67 65 64 20 75 73 69 6e 67 20 74 68 65 logged using the
35dc0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 .. /// <s
35dd0 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65 4c ee cref="SQLiteL
35de0 6f 67 22 20 2f 3e 20 63 6c 61 73 73 2e 0d 0a 20 og" /> class...
35df0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
35e00 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f am>.. ///
35e10 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 65 72 <param name="er
35e20 72 6f 72 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f ror">.. /
35e30 2f 2f 20 54 68 65 20 65 72 72 6f 72 20 6d 65 73 // The error mes
35e40 73 61 67 65 2e 0d 0a 20 20 20 20 20 20 20 20 2f sage... /
35e50 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
35e60 20 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e /// <return
35e70 73 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 s>.. ///
35e80 4e 6f 6e 2d 7a 65 72 6f 20 75 70 6f 6e 20 73 75 Non-zero upon su
35e90 63 63 65 73 73 2e 0d 0a 20 20 20 20 20 20 20 20 ccess...
35ea0 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a /// </returns>..
35eb0 20 20 20 20 20 20 20 20 70 72 69 76 61 74 65 20 private
35ec0 73 74 61 74 69 63 20 62 6f 6f 6c 20 53 65 74 54 static bool SetT
35ed0 61 62 6c 65 45 72 72 6f 72 28 0d 0a 20 20 20 20 ableError(..
35ee0 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 4d 6f SQLiteMo
35ef0 64 75 6c 65 20 6d 6f 64 75 6c 65 2c 0d 0a 20 20 dule module,..
35f00 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 IntPtr
35f10 20 70 56 74 61 62 2c 0d 0a 20 20 20 20 20 20 20 pVtab,..
35f20 20 20 20 20 20 62 6f 6f 6c 20 6c 6f 67 45 72 72 bool logErr
35f30 6f 72 73 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 ors,..
35f40 20 20 73 74 72 69 6e 67 20 65 72 72 6f 72 0d 0a string error..
35f50 20 20 20 20 20 20 20 20 20 20 20 20 29 0d 0a 20 )..
35f60 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
35f70 20 20 20 20 20 20 74 72 79 0d 0a 20 20 20 20 20 try..
35f80 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 {..
35f90 20 20 20 20 20 20 20 20 20 20 69 66 20 28 6c 6f if (lo
35fa0 67 45 72 72 6f 72 73 29 0d 0a 20 20 20 20 20 20 gErrors)..
35fb0 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 {..
35fc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35fd0 20 53 51 4c 69 74 65 4c 6f 67 2e 4c 6f 67 4d 65 SQLiteLog.LogMe
35fe0 73 73 61 67 65 28 53 51 4c 69 74 65 45 72 72 6f ssage(SQLiteErro
35ff0 72 43 6f 64 65 2e 45 72 72 6f 72 2c 0d 0a 20 20 rCode.Error,..
36000 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
36010 20 20 20 20 20 20 53 74 72 69 6e 67 2e 46 6f 72 String.For
36020 6d 61 74 28 43 75 6c 74 75 72 65 49 6e 66 6f 2e mat(CultureInfo.
36030 43 75 72 72 65 6e 74 43 75 6c 74 75 72 65 2c 0d CurrentCulture,.
36040 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
36050 20 20 20 20 20 20 20 20 20 22 56 69 72 74 75 61 "Virtua
36060 6c 20 74 61 62 6c 65 20 65 72 72 6f 72 3a 20 7b l table error: {
36070 30 7d 22 2c 20 65 72 72 6f 72 29 29 3b 20 2f 2a 0}", error)); /*
36080 20 74 68 72 6f 77 20 2a 2f 0d 0a 20 20 20 20 20 throw */..
36090 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 }..
360a0 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 }..
360b0 20 20 20 20 20 20 20 20 20 63 61 74 63 68 0d 0a catch..
360c0 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 {..
360d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
360e0 2f 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0d 0a 20 / do nothing...
360f0 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 0d 0a }....
36100 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 if (
36110 70 56 74 61 62 20 3d 3d 20 49 6e 74 50 74 72 2e pVtab == IntPtr.
36120 5a 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 Zero)..
36130 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 66 61 return fa
36140 6c 73 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 lse;....
36150 20 20 20 20 69 6e 74 20 6f 66 66 73 65 74 20 3d int offset =
36160 20 49 6e 74 50 74 72 2e 53 69 7a 65 20 2b 20 53 IntPtr.Size + S
36170 51 4c 69 74 65 4d 61 72 73 68 61 6c 2e 53 69 7a QLiteMarshal.Siz
36180 65 4f 66 53 74 72 75 63 74 49 6e 74 28 29 3b 0d eOfStructInt();.
36190 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 . Int
361a0 50 74 72 20 70 45 72 72 6f 72 20 3d 20 53 51 4c Ptr pError = SQL
361b0 69 74 65 4d 61 72 73 68 61 6c 2e 52 65 61 64 49 iteMarshal.ReadI
361c0 6e 74 50 74 72 28 70 56 74 61 62 2c 20 6f 66 66 ntPtr(pVtab, off
361d0 73 65 74 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 set);....
361e0 20 20 20 20 20 69 66 20 28 70 45 72 72 6f 72 20 if (pError
361f0 21 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 0d != IntPtr.Zero).
36200 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a . {..
36210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
36220 53 51 4c 69 74 65 4d 65 6d 6f 72 79 2e 46 72 65 SQLiteMemory.Fre
36230 65 28 70 45 72 72 6f 72 29 3b 20 70 45 72 72 6f e(pError); pErro
36240 72 20 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 3b r = IntPtr.Zero;
36250 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
36260 20 20 53 51 4c 69 74 65 4d 61 72 73 68 61 6c 2e SQLiteMarshal.
36270 57 72 69 74 65 49 6e 74 50 74 72 28 70 56 74 61 WriteIntPtr(pVta
36280 62 2c 20 6f 66 66 73 65 74 2c 20 70 45 72 72 6f b, offset, pErro
36290 72 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 r);..
362a0 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 }....
362b0 20 20 69 66 20 28 65 72 72 6f 72 20 3d 3d 20 6e if (error == n
362c0 75 6c 6c 29 0d 0a 20 20 20 20 20 20 20 20 20 20 ull)..
362d0 20 20 20 20 20 20 72 65 74 75 72 6e 20 74 72 75 return tru
362e0 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 e;....
362f0 20 20 62 6f 6f 6c 20 73 75 63 63 65 73 73 20 3d bool success =
36300 20 66 61 6c 73 65 3b 0d 0a 0d 0a 20 20 20 20 20 false;....
36310 20 20 20 20 20 20 20 74 72 79 0d 0a 20 20 20 20 try..
36320 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
36330 20 20 20 20 20 20 20 20 20 20 20 70 45 72 72 6f pErro
36340 72 20 3d 20 53 51 4c 69 74 65 53 74 72 69 6e 67 r = SQLiteString
36350 2e 55 74 66 38 49 6e 74 50 74 72 46 72 6f 6d 53 .Utf8IntPtrFromS
36360 74 72 69 6e 67 28 65 72 72 6f 72 29 3b 0d 0a 20 tring(error);..
36370 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
36380 51 4c 69 74 65 4d 61 72 73 68 61 6c 2e 57 72 69 QLiteMarshal.Wri
36390 74 65 49 6e 74 50 74 72 28 70 56 74 61 62 2c 20 teIntPtr(pVtab,
363a0 6f 66 66 73 65 74 2c 20 70 45 72 72 6f 72 29 3b offset, pError);
363b0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ..
363c0 20 20 73 75 63 63 65 73 73 20 3d 20 74 72 75 65 success = true
363d0 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d ;.. }
363e0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 66 69 .. fi
363f0 6e 61 6c 6c 79 0d 0a 20 20 20 20 20 20 20 20 20 nally..
36400 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 {..
36410 20 20 20 20 20 20 69 66 20 28 21 73 75 63 63 65 if (!succe
36420 73 73 20 26 26 20 28 70 45 72 72 6f 72 20 21 3d ss && (pError !=
36430 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 29 0d 0a IntPtr.Zero))..
36440 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
36450 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 {..
36460 20 20 20 20 20 20 20 53 51 4c 69 74 65 4d 65 6d SQLiteMem
36470 6f 72 79 2e 46 72 65 65 28 70 45 72 72 6f 72 29 ory.Free(pError)
36480 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ;..
36490 20 20 20 20 20 20 20 70 45 72 72 6f 72 20 3d 20 pError =
364a0 49 6e 74 50 74 72 2e 5a 65 72 6f 3b 0d 0a 20 20 IntPtr.Zero;..
364b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d }.
364c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a . }..
364d0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 .. re
364e0 74 75 72 6e 20 73 75 63 63 65 73 73 3b 0d 0a 20 turn success;..
364f0 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 }....
36500 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////
36510 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
36520 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
36530 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
36540 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 ///////////....
36550 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d /// <summ
36560 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
36570 2f 20 41 72 72 61 6e 67 65 73 20 66 6f 72 20 74 / Arranges for t
36580 68 65 20 73 70 65 63 69 66 69 65 64 20 65 72 72 he specified err
36590 6f 72 20 6d 65 73 73 61 67 65 20 74 6f 20 62 65 or message to be
365a0 20 70 6c 61 63 65 64 20 69 6e 74 6f 20 74 68 65 placed into the
365b0 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 7a 45 .. /// zE
365c0 72 72 4d 73 67 20 66 69 65 6c 64 20 6f 66 20 61 rrMsg field of a
365d0 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20 64 65 sqlite3_vtab de
365e0 72 69 76 65 64 20 73 74 72 75 63 74 75 72 65 2c rived structure,
365f0 20 66 72 65 65 69 6e 67 20 74 68 65 0d 0a 20 20 freeing the..
36600 20 20 20 20 20 20 2f 2f 2f 20 65 78 69 73 74 69 /// existi
36610 6e 67 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 ng error message
36620 2c 20 69 66 20 61 6e 79 2e 0d 0a 20 20 20 20 20 , if any...
36630 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 /// </summary
36640 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
36650 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6d 6f 64 75 param name="modu
36660 6c 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f le">.. //
36670 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d / The <see cref=
36680 22 53 51 4c 69 74 65 4d 6f 64 75 6c 65 22 20 2f "SQLiteModule" /
36690 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 > object instanc
366a0 65 20 74 6f 20 62 65 20 75 73 65 64 2e 0d 0a 20 e to be used...
366b0 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
366c0 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f am>.. ///
366d0 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 74 61 <param name="ta
366e0 62 6c 65 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f ble">.. /
366f0 2f 2f 20 54 68 65 20 3c 73 65 65 20 63 72 65 66 // The <see cref
36700 3d 22 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 ="SQLiteVirtualT
36710 61 62 6c 65 22 20 2f 3e 20 6f 62 6a 65 63 74 20 able" /> object
36720 69 6e 73 74 61 6e 63 65 20 75 73 65 64 20 74 6f instance used to
36730 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 6c 6f .. /// lo
36740 6f 6b 75 70 20 74 68 65 20 6e 61 74 69 76 65 20 okup the native
36750 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 73 pointer to the s
36760 71 6c 69 74 65 33 5f 76 74 61 62 20 64 65 72 69 qlite3_vtab deri
36770 76 65 64 20 73 74 72 75 63 74 75 72 65 2e 0d 0a ved structure...
36780 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
36790 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
367a0 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6c / <param name="l
367b0 6f 67 45 72 72 6f 72 73 22 3e 0d 0a 20 20 20 20 ogErrors">..
367c0 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 6f /// Non-zero
367d0 20 69 66 20 74 68 69 73 20 65 72 72 6f 72 20 6d if this error m
367e0 65 73 73 61 67 65 20 73 68 6f 75 6c 64 20 61 6c essage should al
367f0 73 6f 20 62 65 20 6c 6f 67 67 65 64 20 75 73 69 so be logged usi
36800 6e 67 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 ng the..
36810 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 53 /// <see cref="S
36820 51 4c 69 74 65 4c 6f 67 22 20 2f 3e 20 63 6c 61 QLiteLog" /> cla
36830 73 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f ss... ///
36840 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 </param>..
36850 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 /// <param na
36860 6d 65 3d 22 65 72 72 6f 72 22 3e 0d 0a 20 20 20 me="error">..
36870 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 65 72 72 /// The err
36880 6f 72 20 6d 65 73 73 61 67 65 2e 0d 0a 20 20 20 or message...
36890 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d /// </param
368a0 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c >.. /// <
368b0 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 returns>..
368c0 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 6f 20 75 /// Non-zero u
368d0 70 6f 6e 20 73 75 63 63 65 73 73 2e 0d 0a 20 20 pon success...
368e0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 /// </retu
368f0 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 70 72 rns>.. pr
36900 69 76 61 74 65 20 73 74 61 74 69 63 20 62 6f 6f ivate static boo
36910 6c 20 53 65 74 54 61 62 6c 65 45 72 72 6f 72 28 l SetTableError(
36920 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 53 51 .. SQ
36930 4c 69 74 65 4d 6f 64 75 6c 65 20 6d 6f 64 75 6c LiteModule modul
36940 65 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 e,..
36950 53 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 SQLiteVirtualTab
36960 6c 65 20 74 61 62 6c 65 2c 0d 0a 20 20 20 20 20 le table,..
36970 20 20 20 20 20 20 20 62 6f 6f 6c 20 6c 6f 67 45 bool logE
36980 72 72 6f 72 73 2c 0d 0a 20 20 20 20 20 20 20 20 rrors,..
36990 20 20 20 20 73 74 72 69 6e 67 20 65 72 72 6f 72 string error
369a0 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 0d .. ).
369b0 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 . {..
369c0 20 20 20 20 20 20 20 20 69 66 20 28 74 61 62 6c if (tabl
369d0 65 20 3d 3d 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 e == null)..
369e0 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
369f0 72 6e 20 66 61 6c 73 65 3b 0d 0a 0d 0a 20 20 20 rn false;....
36a00 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 IntPtr
36a10 70 56 74 61 62 20 3d 20 74 61 62 6c 65 2e 4e 61 pVtab = table.Na
36a20 74 69 76 65 48 61 6e 64 6c 65 3b 0d 0a 0d 0a 20 tiveHandle;....
36a30 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 70 if (p
36a40 56 74 61 62 20 3d 3d 20 49 6e 74 50 74 72 2e 5a Vtab == IntPtr.Z
36a50 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 20 ero)..
36a60 20 20 20 20 20 20 72 65 74 75 72 6e 20 66 61 6c return fal
36a70 73 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 se;....
36a80 20 20 20 72 65 74 75 72 6e 20 53 65 74 54 61 62 return SetTab
36a90 6c 65 45 72 72 6f 72 28 6d 6f 64 75 6c 65 2c 20 leError(module,
36aa0 70 56 74 61 62 2c 20 6c 6f 67 45 72 72 6f 72 73 pVtab, logErrors
36ab0 2c 20 65 72 72 6f 72 29 3b 0d 0a 20 20 20 20 20 , error);..
36ac0 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 }....
36ad0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
36ae0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
36af0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
36b00 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
36b10 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
36b20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
36b30 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 72 .. /// Ar
36b40 72 61 6e 67 65 73 20 66 6f 72 20 74 68 65 20 73 ranges for the s
36b50 70 65 63 69 66 69 65 64 20 65 72 72 6f 72 20 6d pecified error m
36b60 65 73 73 61 67 65 20 74 6f 20 62 65 20 70 6c 61 essage to be pla
36b70 63 65 64 20 69 6e 74 6f 20 74 68 65 0d 0a 20 20 ced into the..
36b80 20 20 20 20 20 20 2f 2f 2f 20 7a 45 72 72 4d 73 /// zErrMs
36b90 67 20 66 69 65 6c 64 20 6f 66 20 61 20 73 71 6c g field of a sql
36ba0 69 74 65 33 5f 76 74 61 62 20 64 65 72 69 76 65 ite3_vtab derive
36bb0 64 20 73 74 72 75 63 74 75 72 65 2c 20 66 72 65 d structure, fre
36bc0 65 69 6e 67 20 74 68 65 0d 0a 20 20 20 20 20 20 eing the..
36bd0 20 20 2f 2f 2f 20 65 78 69 73 74 69 6e 67 20 65 /// existing e
36be0 72 72 6f 72 20 6d 65 73 73 61 67 65 2c 20 69 66 rror message, if
36bf0 20 61 6e 79 2e 0d 0a 20 20 20 20 20 20 20 20 2f any... /
36c00 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
36c10 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
36c20 6d 20 6e 61 6d 65 3d 22 6d 6f 64 75 6c 65 22 3e m name="module">
36c30 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
36c40 65 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c e <see cref="SQL
36c50 69 74 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 6f 62 iteModule" /> ob
36c60 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 74 6f ject instance to
36c70 20 62 65 20 75 73 65 64 2e 0d 0a 20 20 20 20 20 be used...
36c80 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
36c90 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
36ca0 72 61 6d 20 6e 61 6d 65 3d 22 70 43 75 72 73 6f ram name="pCurso
36cb0 72 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f r">.. ///
36cc0 20 54 68 65 20 6e 61 74 69 76 65 20 70 6f 69 6e The native poin
36cd0 74 65 72 20 74 6f 20 74 68 65 20 73 71 6c 69 74 ter to the sqlit
36ce0 65 33 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 64 e3_vtab_cursor d
36cf0 65 72 69 76 65 64 20 73 74 72 75 63 74 75 72 65 erived structure
36d00 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 75 73 .. /// us
36d10 65 64 20 74 6f 20 67 65 74 20 74 68 65 20 6e 61 ed to get the na
36d20 74 69 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 tive pointer to
36d30 74 68 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 the sqlite3_vtab
36d40 20 64 65 72 69 76 65 64 0d 0a 20 20 20 20 20 20 derived..
36d50 20 20 2f 2f 2f 20 73 74 72 75 63 74 75 72 65 2e /// structure.
36d60 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f .. /// </
36d70 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 param>..
36d80 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d /// <param name=
36d90 22 6c 6f 67 45 72 72 6f 72 73 22 3e 0d 0a 20 20 "logErrors">..
36da0 20 20 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 /// Non-ze
36db0 72 6f 20 69 66 20 74 68 69 73 20 65 72 72 6f 72 ro if this error
36dc0 20 6d 65 73 73 61 67 65 20 73 68 6f 75 6c 64 20 message should
36dd0 61 6c 73 6f 20 62 65 20 6c 6f 67 67 65 64 20 75 also be logged u
36de0 73 69 6e 67 20 74 68 65 0d 0a 20 20 20 20 20 20 sing the..
36df0 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d /// <see cref=
36e00 22 53 51 4c 69 74 65 4c 6f 67 22 20 2f 3e 20 63 "SQLiteLog" /> c
36e10 6c 61 73 73 2e 0d 0a 20 20 20 20 20 20 20 20 2f lass... /
36e20 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 // </param>..
36e30 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 /// <param
36e40 6e 61 6d 65 3d 22 65 72 72 6f 72 22 3e 0d 0a 20 name="error">..
36e50 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 65 /// The e
36e60 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 0d 0a 20 rror message...
36e70 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 /// </par
36e80 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f am>.. ///
36e90 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 <returns>..
36ea0 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 6f /// Non-zero
36eb0 20 75 70 6f 6e 20 73 75 63 63 65 73 73 2e 0d 0a upon success...
36ec0 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 /// </re
36ed0 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 20 turns>..
36ee0 70 72 69 76 61 74 65 20 73 74 61 74 69 63 20 62 private static b
36ef0 6f 6f 6c 20 53 65 74 43 75 72 73 6f 72 45 72 72 ool SetCursorErr
36f00 6f 72 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20 or(..
36f10 20 53 51 4c 69 74 65 4d 6f 64 75 6c 65 20 6d 6f SQLiteModule mo
36f20 64 75 6c 65 2c 0d 0a 20 20 20 20 20 20 20 20 20 dule,..
36f30 20 20 20 49 6e 74 50 74 72 20 70 43 75 72 73 6f IntPtr pCurso
36f40 72 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 r,..
36f50 62 6f 6f 6c 20 6c 6f 67 45 72 72 6f 72 73 2c 0d bool logErrors,.
36f60 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 74 72 . str
36f70 69 6e 67 20 65 72 72 6f 72 0d 0a 20 20 20 20 20 ing error..
36f80 20 20 20 20 20 20 20 29 0d 0a 20 20 20 20 20 20 )..
36f90 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 {..
36fa0 20 69 66 20 28 70 43 75 72 73 6f 72 20 3d 3d 20 if (pCursor ==
36fb0 49 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a 20 20 IntPtr.Zero)..
36fc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
36fd0 74 75 72 6e 20 66 61 6c 73 65 3b 0d 0a 0d 0a 20 turn false;....
36fe0 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 IntPt
36ff0 72 20 70 56 74 61 62 20 3d 20 54 61 62 6c 65 46 r pVtab = TableF
37000 72 6f 6d 43 75 72 73 6f 72 28 6d 6f 64 75 6c 65 romCursor(module
37010 2c 20 70 43 75 72 73 6f 72 29 3b 0d 0a 0d 0a 20 , pCursor);....
37020 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 70 if (p
37030 56 74 61 62 20 3d 3d 20 49 6e 74 50 74 72 2e 5a Vtab == IntPtr.Z
37040 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 20 ero)..
37050 20 20 20 20 20 20 72 65 74 75 72 6e 20 66 61 6c return fal
37060 73 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 20 se;....
37070 20 20 20 72 65 74 75 72 6e 20 53 65 74 54 61 62 return SetTab
37080 6c 65 45 72 72 6f 72 28 6d 6f 64 75 6c 65 2c 20 leError(module,
37090 70 56 74 61 62 2c 20 6c 6f 67 45 72 72 6f 72 73 pVtab, logErrors
370a0 2c 20 65 72 72 6f 72 29 3b 0d 0a 20 20 20 20 20 , error);..
370b0 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 }....
370c0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
370d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
370e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
370f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
37100 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 ///////....
37110 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e /// <summary>
37120 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 41 72 .. /// Ar
37130 72 61 6e 67 65 73 20 66 6f 72 20 74 68 65 20 73 ranges for the s
37140 70 65 63 69 66 69 65 64 20 65 72 72 6f 72 20 6d pecified error m
37150 65 73 73 61 67 65 20 74 6f 20 62 65 20 70 6c 61 essage to be pla
37160 63 65 64 20 69 6e 74 6f 20 74 68 65 0d 0a 20 20 ced into the..
37170 20 20 20 20 20 20 2f 2f 2f 20 7a 45 72 72 4d 73 /// zErrMs
37180 67 20 66 69 65 6c 64 20 6f 66 20 61 20 73 71 6c g field of a sql
37190 69 74 65 33 5f 76 74 61 62 20 64 65 72 69 76 65 ite3_vtab derive
371a0 64 20 73 74 72 75 63 74 75 72 65 2c 20 66 72 65 d structure, fre
371b0 65 69 6e 67 20 74 68 65 0d 0a 20 20 20 20 20 20 eing the..
371c0 20 20 2f 2f 2f 20 65 78 69 73 74 69 6e 67 20 65 /// existing e
371d0 72 72 6f 72 20 6d 65 73 73 61 67 65 2c 20 69 66 rror message, if
371e0 20 61 6e 79 2e 0d 0a 20 20 20 20 20 20 20 20 2f any... /
371f0 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 // </summary>..
37200 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 /// <para
37210 6d 20 6e 61 6d 65 3d 22 6d 6f 64 75 6c 65 22 3e m name="module">
37220 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 .. /// Th
37230 65 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c e <see cref="SQL
37240 69 74 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 6f 62 iteModule" /> ob
37250 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20 74 6f ject instance to
37260 20 62 65 20 75 73 65 64 2e 0d 0a 20 20 20 20 20 be used...
37270 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d /// </param>.
37280 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 . /// <pa
37290 72 61 6d 20 6e 61 6d 65 3d 22 63 75 72 73 6f 72 ram name="cursor
372a0 22 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 ">.. ///
372b0 54 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 53 The <see cref="S
372c0 51 4c 69 74 65 56 69 72 74 75 61 6c 54 61 62 6c QLiteVirtualTabl
372d0 65 43 75 72 73 6f 72 22 20 2f 3e 20 6f 62 6a 65 eCursor" /> obje
372e0 63 74 20 69 6e 73 74 61 6e 63 65 20 75 73 65 64 ct instance used
372f0 20 74 6f 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f to.. ///
37300 20 6c 6f 6f 6b 75 70 20 74 68 65 20 6e 61 74 69 lookup the nati
37310 76 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 ve pointer to th
37320 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20 64 e sqlite3_vtab d
37330 65 72 69 76 65 64 20 73 74 72 75 63 74 75 72 65 erived structure
37340 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
37350 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 /param>..
37360 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 /// <param name
37370 3d 22 6c 6f 67 45 72 72 6f 72 73 22 3e 0d 0a 20 ="logErrors">..
37380 20 20 20 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a /// Non-z
37390 65 72 6f 20 69 66 20 74 68 69 73 20 65 72 72 6f ero if this erro
373a0 72 20 6d 65 73 73 61 67 65 20 73 68 6f 75 6c 64 r message should
373b0 20 61 6c 73 6f 20 62 65 20 6c 6f 67 67 65 64 20 also be logged
373c0 75 73 69 6e 67 20 74 68 65 0d 0a 20 20 20 20 20 using the..
373d0 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 /// <see cref
373e0 3d 22 53 51 4c 69 74 65 4c 6f 67 22 20 2f 3e 20 ="SQLiteLog" />
373f0 63 6c 61 73 73 2e 0d 0a 20 20 20 20 20 20 20 20 class...
37400 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 /// </param>..
37410 20 20 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d /// <param
37420 20 6e 61 6d 65 3d 22 65 72 72 6f 72 22 3e 0d 0a name="error">..
37430 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
37440 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 0d 0a error message...
37450 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 /// </pa
37460 72 61 6d 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ram>.. //
37470 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 / <returns>..
37480 20 20 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 /// Non-zer
37490 6f 20 75 70 6f 6e 20 73 75 63 63 65 73 73 2e 0d o upon success..
374a0 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 72 . /// </r
374b0 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 20 20 eturns>..
374c0 20 70 72 69 76 61 74 65 20 73 74 61 74 69 63 20 private static
374d0 62 6f 6f 6c 20 53 65 74 43 75 72 73 6f 72 45 72 bool SetCursorEr
374e0 72 6f 72 28 0d 0a 20 20 20 20 20 20 20 20 20 20 ror(..
374f0 20 20 53 51 4c 69 74 65 4d 6f 64 75 6c 65 20 6d SQLiteModule m
37500 6f 64 75 6c 65 2c 0d 0a 20 20 20 20 20 20 20 20 odule,..
37510 20 20 20 20 53 51 4c 69 74 65 56 69 72 74 75 61 SQLiteVirtua
37520 6c 54 61 62 6c 65 43 75 72 73 6f 72 20 63 75 72 lTableCursor cur
37530 73 6f 72 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 sor,..
37540 20 20 62 6f 6f 6c 20 6c 6f 67 45 72 72 6f 72 73 bool logErrors
37550 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 ,.. s
37560 74 72 69 6e 67 20 65 72 72 6f 72 0d 0a 20 20 20 tring error..
37570 20 20 20 20 20 20 20 20 20 29 0d 0a 20 20 20 20 )..
37580 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 {..
37590 20 20 20 69 66 20 28 63 75 72 73 6f 72 20 3d 3d if (cursor ==
375a0 20 6e 75 6c 6c 29 0d 0a 20 20 20 20 20 20 20 20 null)..
375b0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 66 return f
375c0 61 6c 73 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 alse;....
375d0 20 20 20 20 20 49 6e 74 50 74 72 20 70 43 75 72 IntPtr pCur
375e0 73 6f 72 20 3d 20 63 75 72 73 6f 72 2e 4e 61 74 sor = cursor.Nat
375f0 69 76 65 48 61 6e 64 6c 65 3b 0d 0a 0d 0a 20 20 iveHandle;....
37600 20 20 20 20 20 20 20 20 20 20 69 66 20 28 70 43 if (pC
37610 75 72 73 6f 72 20 3d 3d 20 49 6e 74 50 74 72 2e ursor == IntPtr.
37620 5a 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 Zero)..
37630 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 66 61 return fa
37640 6c 73 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 lse;....
37650 20 20 20 20 72 65 74 75 72 6e 20 53 65 74 43 75 return SetCu
37660 72 73 6f 72 45 72 72 6f 72 28 6d 6f 64 75 6c 65 rsorError(module
37670 2c 20 70 43 75 72 73 6f 72 2c 20 6c 6f 67 45 72 , pCursor, logEr
37680 72 6f 72 73 2c 20 65 72 72 6f 72 29 3b 0d 0a 20 rors, error);..
37690 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 }..
376a0 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 20 20 #endregion..
376b0 20 20 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e #endregion
376c0 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f .... ////
376d0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
376e0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
376f0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
37700 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
37710 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 23 ///.... #
37720 72 65 67 69 6f 6e 20 50 72 6f 74 65 63 74 65 64 region Protected
37730 20 4d 65 6d 62 65 72 73 0d 0a 20 20 20 20 20 20 Members..
37740 20 20 23 72 65 67 69 6f 6e 20 4d 6f 64 75 6c 65 #region Module
37750 20 48 65 6c 70 65 72 20 4d 65 74 68 6f 64 73 0d Helper Methods.
37760 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 . /// <su
37770 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 mmary>..
37780 2f 2f 2f 20 47 65 74 73 20 61 6e 64 20 72 65 74 /// Gets and ret
37790 75 72 6e 73 20 74 68 65 20 3c 73 65 65 20 63 72 urns the <see cr
377a0 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 ef="ISQLiteNativ
377b0 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 69 6e 74 65 eModule" /> inte
377c0 72 66 61 63 65 0d 0a 20 20 20 20 20 20 20 20 2f rface.. /
377d0 2f 2f 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f // implementatio
377e0 6e 20 74 6f 20 62 65 20 75 73 65 64 20 77 68 65 n to be used whe
377f0 6e 20 63 72 65 61 74 69 6e 67 20 74 68 65 20 6e n creating the n
37800 61 74 69 76 65 20 73 71 6c 69 74 65 33 5f 6d 6f ative sqlite3_mo
37810 64 75 6c 65 0d 0a 20 20 20 20 20 20 20 20 2f 2f dule.. //
37820 2f 20 73 74 72 75 63 74 75 72 65 2e 20 20 44 65 / structure. De
37830 72 69 76 65 64 20 63 6c 61 73 73 65 73 20 6d 61 rived classes ma
37840 79 20 6f 76 65 72 72 69 64 65 20 74 68 69 73 20 y override this
37850 6d 65 74 68 6f 64 20 74 6f 20 73 75 70 70 6c 79 method to supply
37860 20 61 6e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f an.. ///
37870 20 61 6c 74 65 72 6e 61 74 65 20 69 6d 70 6c 65 alternate imple
37880 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 74 68 mentation for th
37890 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 e <see cref="ISQ
378a0 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 LiteNativeModule
378b0 22 20 2f 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f " />.. //
378c0 2f 20 69 6e 74 65 72 66 61 63 65 2e 0d 0a 20 20 / interface...
378d0 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d /// </summ
378e0 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f ary>.. //
378f0 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 / <returns>..
37900 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 /// The <se
37910 65 20 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e e cref="ISQLiteN
37920 61 74 69 76 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 ativeModule" />
37930 69 6e 74 65 72 66 61 63 65 20 69 6d 70 6c 65 6d interface implem
37940 65 6e 74 61 74 69 6f 6e 20 74 6f 0d 0a 20 20 20 entation to..
37950 20 20 20 20 20 2f 2f 2f 20 62 65 20 75 73 65 64 /// be used
37960 20 77 68 65 6e 20 70 6f 70 75 6c 61 74 69 6e 67 when populating
37970 20 74 68 65 20 6e 61 74 69 76 65 20 73 71 6c 69 the native sqli
37980 74 65 33 5f 6d 6f 64 75 6c 65 20 73 74 72 75 63 te3_module struc
37990 74 75 72 65 2e 20 20 49 66 0d 0a 20 20 20 20 20 ture. If..
379a0 20 20 20 2f 2f 2f 20 74 68 65 20 72 65 74 75 72 /// the retur
379b0 6e 65 64 20 76 61 6c 75 65 20 69 73 20 6e 75 6c ned value is nul
379c0 6c 2c 20 74 68 65 20 70 72 69 76 61 74 65 20 6d l, the private m
379d0 65 74 68 6f 64 73 20 70 72 6f 76 69 64 65 64 20 ethods provided
379e0 62 79 20 74 68 65 0d 0a 20 20 20 20 20 20 20 20 by the..
379f0 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 53 /// <see cref="S
37a00 51 4c 69 74 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 QLiteModule" />
37a10 63 6c 61 73 73 20 61 6e 64 20 72 65 6c 61 74 69 class and relati
37a20 6e 67 20 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 ng to the..
37a30 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 /// <see cref
37a40 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65 4d ="ISQLiteNativeM
37a50 6f 64 75 6c 65 22 20 2f 3e 20 69 6e 74 65 72 66 odule" /> interf
37a60 61 63 65 20 20 77 69 6c 6c 20 62 65 20 75 73 65 ace will be use
37a70 64 20 74 6f 0d 0a 20 20 20 20 20 20 20 20 2f 2f d to.. //
37a80 2f 20 63 72 65 61 74 65 20 74 68 65 20 6e 65 63 / create the nec
37a90 65 73 73 61 72 79 20 64 65 6c 65 67 61 74 65 73 essary delegates
37aa0 2e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c ... /// <
37ab0 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 20 /returns>..
37ac0 20 20 20 70 72 6f 74 65 63 74 65 64 20 76 69 72 protected vir
37ad0 74 75 61 6c 20 49 53 51 4c 69 74 65 4e 61 74 69 tual ISQLiteNati
37ae0 76 65 4d 6f 64 75 6c 65 20 47 65 74 4e 61 74 69 veModule GetNati
37af0 76 65 4d 6f 64 75 6c 65 49 6d 70 6c 28 29 0d 0a veModuleImpl()..
37b00 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 {..
37b10 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 6e 75 return nu
37b20 6c 6c 3b 20 2f 2a 20 4e 4f 54 45 3a 20 55 73 65 ll; /* NOTE: Use
37b30 20 74 68 65 20 62 75 69 6c 74 2d 69 6e 20 64 65 the built-in de
37b40 66 61 75 6c 74 20 64 65 6c 65 67 61 74 65 73 2e fault delegates.
37b50 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a */.. }..
37b60 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f .. //////
37b70 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
37b80 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
37b90 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
37ba0 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
37bb0 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f /.... ///
37bc0 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 <summary>..
37bd0 20 20 20 20 2f 2f 2f 20 43 72 65 61 74 65 73 20 /// Creates
37be0 61 6e 64 20 72 65 74 75 72 6e 73 20 74 68 65 20 and returns the
37bf0 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 <see cref="ISQLi
37c00 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 22 20 teNativeModule"
37c10 2f 3e 0d 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 />.. ///
37c20 69 6e 74 65 72 66 61 63 65 20 69 6d 70 6c 65 6d interface implem
37c30 65 6e 74 61 74 69 6f 6e 20 63 6f 72 72 65 73 70 entation corresp
37c40 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 63 75 onding to the cu
37c50 72 72 65 6e 74 0d 0a 20 20 20 20 20 20 20 20 2f rrent.. /
37c60 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 // <see cref="SQ
37c70 4c 69 74 65 4d 6f 64 75 6c 65 22 20 2f 3e 20 6f LiteModule" /> o
37c80 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 2e 0d bject instance..
37c90 0a 20 20 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 . /// </s
37ca0 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 20 ummary>..
37cb0 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a /// <returns>..
37cc0 20 20 20 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 /// The
37cd0 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69 <see cref="ISQLi
37ce0 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 22 20 teNativeModule"
37cf0 2f 3e 20 69 6e 74 65 72 66 61 63 65 20 69 6d 70 /> interface imp
37d00 6c 65 6d 65 6e 74 61 74 69 6f 6e 0d 0a 20 20 20 lementation..
37d10 20 20 20 20 20 2f 2f 2f 20 63 6f 72 72 65 73 70 /// corresp
37d20 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 6