switch(pjBuf ? eTextRep : SQLITE_UTF8){
case SQLITE_UTF8: {
const char *zMsg = pjBuf ? (const char *)pjBuf : zUnspecified;
- sqlite3_result_error(PtrGet_sqlite3_context(jpCx), zMsg, baLen);
+ sqlite3_result_error(PtrGet_sqlite3_context(jpCx), zMsg, (int)baLen);
break;
}
case SQLITE_UTF16: {
const void *zMsg = pjBuf
? (const void *)pjBuf : (const void *)zUnspecified;
- sqlite3_result_error16(PtrGet_sqlite3_context(jpCx), zMsg, baLen);
+ sqlite3_result_error16(PtrGet_sqlite3_context(jpCx), zMsg, (int)baLen);
break;
}
default:
We do not use a generic OutputPointer<T> because working with those
from the native JNI code is unduly quirky due to a lack of
autoboxing at that level.
+
+ The usage is similar for all of thes types:
+
+ ```
+ OutputPointer.sqlite3 out = new OutputPointer.sqlite3();
+ assert( null==out.get() );
+ int rc = sqlite3_open(":memory:", out);
+ if( 0!=rc ) ... error;
+ assert( null!=out.get() );
+ sqlite3 db = out.take();
+ assert( null==out.get() );
+ ```
+
+ With the minor exception that the primitive types permit direct
+ access to the object's value via the `value` property, whereas the
+ JNI-level opaque types do not permit client-level code to set that
+ property.
*/
public final class OutputPointer {
*/
public static final class sqlite3 {
private org.sqlite.jni.sqlite3 value;
+ //! Initializes with a null value.
public sqlite3(){value = null;}
+ //! Sets the current value to null.
public void clear(){value = null;}
+ //! Returns the current value.
public final org.sqlite.jni.sqlite3 get(){return value;}
- /** Equivalent to calling get() then clear(). */
+ //! Equivalent to calling get() then clear().
public final org.sqlite.jni.sqlite3 take(){
final org.sqlite.jni.sqlite3 v = value;
value = null;
*/
public static final class sqlite3_stmt {
private org.sqlite.jni.sqlite3_stmt value;
+ //! Initializes with a null value.
public sqlite3_stmt(){value = null;}
+ //! Sets the current value to null.
public void clear(){value = null;}
+ //! Returns the current value.
public final org.sqlite.jni.sqlite3_stmt get(){return value;}
- /** Equivalent to calling get() then clear(). */
+ //! Equivalent to calling get() then clear().
public final org.sqlite.jni.sqlite3_stmt take(){
final org.sqlite.jni.sqlite3_stmt v = value;
value = null;
consistency with the higher-level types.
*/
public int value;
+ //! Initializes with the value 0.
public Int32(){this(0);}
+ //! Initializes with the value v.
public Int32(int v){value = v;}
+ //! Returns the current value.
public final int get(){return value;}
+ //! Sets the current value to v.
public final void set(int v){value = v;}
}
consistency with the higher-level types.
*/
public long value;
+ //! Initializes with the value 0.
public Int64(){this(0);}
+ //! Initializes with the value v.
public Int64(long v){value = v;}
+ //! Returns the current value.
public final long get(){return value;}
+ //! Sets the current value.
public final void set(long v){value = v;}
}
consistency with the higher-level types.
*/
public java.lang.String value;
+ //! Initializes with a null value.
public String(){this(null);}
+ //! Initializes with the value v.
public String(java.lang.String v){value = v;}
+ //! Returns the current value.
public final java.lang.String get(){return value;}
+ //! Sets the current value.
public final void set(java.lang.String v){value = v;}
}
consistency with the higher-level types.
*/
public byte[] value;
+ //! Initializes with the value null.
public ByteArray(){this(null);}
+ //! Initializes with the value v.
public ByteArray(byte[] v){value = v;}
+ //! Returns the current value.
public final byte[] get(){return value;}
+ //! Sets the current value.
public final void set(byte[] v){value = v;}
}
}
*/
package org.sqlite.jni;
-//! Internal level of indirection requires because we cannot reference
-// static enum members from an enum constructor.
-class ResultCodeMap {
- private static final java.util.Map<Integer,ResultCode> i2e
- = new java.util.HashMap<>();
-
- public static void set(int i, ResultCode src){
- i2e.put(i, src);
- }
- public static ResultCode get(int i){
- return i2e.get(i);
- }
-}
-
/**
- This enum of sqlite3 result codes is provided not for use with the
- C-style API (with which it won't work) but for higher-level code which
- may find it useful to map codes to human-readable names.
+ This enum contains all of the core and "extended" result codes used
+ by the sqlite3 library. It is provided not for use with the C-style
+ API (with which it won't work) but for higher-level code which may
+ find it useful to map SQLite result codes to human-readable names.
*/
public enum ResultCode {
SQLITE_OK(SQLite3Jni.SQLITE_OK),
public final int value;
- ResultCode(int v){
- value = v;
- ResultCodeMap.set(v, this);
+ ResultCode(int rc){
+ value = rc;
+ ResultCodeMap.set(rc, this);
}
+ /**
+ Returns the entry from this enum for the given result code, or
+ null if no match is found.
+ */
public static ResultCode getEntryForInt(int rc){
return ResultCodeMap.get(rc);
}
+
+ /**
+ Internal level of indirection required because we cannot initialize
+ static enum members in an enum before the enum constructor is
+ invoked.
+ */
+ private static final class ResultCodeMap {
+ private static final java.util.Map<Integer,ResultCode> i2e
+ = new java.util.HashMap<>();
+ private static void set(int rc, ResultCode e){ i2e.put(rc, e); }
+ private static ResultCode get(int rc){ return i2e.get(rc); }
+ }
+
}
effects if invoked from within the execution of an
auto-extension. i.e. auto extensions can neither be added,
removed, nor cleared while one registered with this function is
- running.
+ running. Auto-extensions registered directly with the library
+ via C code, as opposed to indirectly via Java, do not have that
+ limitation.
See the AutoExtension class docs for more information.
/**
Works like the C API except that it returns false, without side
- effects, if auto extensions are currently running.
+ effects, if auto extensions are currently running. (The JNI-level
+ list of extensions cannot be manipulated while it is being traversed.)
*/
public static synchronized native boolean sqlite3_cancel_auto_extension(
@NotNull AutoExtension ax
/**
Works like the C API except that it has no side effects if auto
- extensions are currently running.
+ extensions are currently running. (The JNI-level list of
+ extensions cannot be manipulated while it is being traversed.)
*/
public static synchronized native void sqlite3_reset_auto_extension();
-C Further\ssimplifications\sin\sthe\sinterface\sof\sthe\sOutputPointer\sfamily\sof\sJava\sclasses.
-D 2023-08-12T15:09:09.163
+C More\sJNI\sdocs.
+D 2023-08-12T15:37:53.147
F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
F LICENSE.md df5091916dbb40e6e9686186587125e1b2ff51f022cc334e886c19a0e9982724
F ext/jni/GNUmakefile 6a6633f768431bc1195c1b64bcec162069e3ed02442808eef9bd173c59ed0ddd
F ext/jni/README.md 7a614a2fa6c561205f7a53fd8626cf93a7b5711ff454fc1814517f796df398eb
F ext/jni/jar-dist.make f90a553203a57934bf275bed86479485135a52f48ac5c1cfe6499ae07b0b35a4
-F ext/jni/src/c/sqlite3-jni.c e48ec95bc671cc281a5b442f6e80ea62b40947b6434ed07593bdd831b24ec979
+F ext/jni/src/c/sqlite3-jni.c bea6b8691a5fa3a8626a771757bb261208d3c5fc6598266d3b0ee23d88e35632
F ext/jni/src/c/sqlite3-jni.h c5f941b057a24ee62942e6e1bf5a7fd527e5004d20d9638e84a9382813c3cf2a
F ext/jni/src/org/sqlite/jni/Authorizer.java 1308988f7f40579ea0e4deeaec3c6be971630566bd021c31367fe3f5140db892
F ext/jni/src/org/sqlite/jni/AutoExtension.java 18e83f6f463e306df60b2dceb65247d32af1f78af4bbbae9155411a8c6cdb093
F ext/jni/src/org/sqlite/jni/Fts5PhraseIter.java 6642beda341c0b1b46af4e2d7f6f9ab03a7aede43277b2c92859176d6bce3be9
F ext/jni/src/org/sqlite/jni/Fts5Tokenizer.java 91489893596b6528c0df5cd7180bd5b55809c26e2b797fb321dfcdbc1298c060
F ext/jni/src/org/sqlite/jni/NativePointerHolder.java 9c5d901cce4f7e57c3d623f4e2476f9f79a8eed6e51b2a603f37866018e040ee
-F ext/jni/src/org/sqlite/jni/OutputPointer.java b0adc42695f5c6d523f6b537b9eec7b5252581449d32a708aedfe323f6695407
+F ext/jni/src/org/sqlite/jni/OutputPointer.java d81f8bd43d2296ae373692370cfad16ddde76f5c14cd2760f7b4e1113ef56d4c
F ext/jni/src/org/sqlite/jni/ProgressHandler.java 6f62053a828a572de809828b1ee495380677e87daa29a1c57a0e2c06b0a131dc
-F ext/jni/src/org/sqlite/jni/ResultCode.java 7cdf993f2037ab7bd244c9a34dbaef2ace3beb5da5d7e7fda5c6f67634ceb647
+F ext/jni/src/org/sqlite/jni/ResultCode.java ba701f20213a5f259e94cfbfdd36eb7ac7ce7797f2c6c7fca2004ff12ce20f86
F ext/jni/src/org/sqlite/jni/RollbackHook.java b04c8abcc6ade44a8a57129e33765793f69df0ba909e49ba18d73f4268d92564
F ext/jni/src/org/sqlite/jni/SQLFunction.java 09ce81c1c637e31c3a830d4c859cce95d65f5e02ff45f8bd1985b3479381bc46
-F ext/jni/src/org/sqlite/jni/SQLite3Jni.java 18458d7419a9105e4987884f9a51a269a7aee3824abda861f937776a5dfd6b76
+F ext/jni/src/org/sqlite/jni/SQLite3Jni.java 4b6fd22e04e63eb65d8e4e38fda39ecf15ce244d034607517627ce2e766e7e65
F ext/jni/src/org/sqlite/jni/Tester1.java 07c14a90427529ceba54b5e8344ca03602f5789dc53c4163ce22f92d8c577a11
F ext/jni/src/org/sqlite/jni/TesterFts5.java 59e22dd24af033ea8827d36225a2f3297908fb6af8818ead8850c6c6847557b1
F ext/jni/src/org/sqlite/jni/Tracer.java a5cece9f947b0af27669b8baec300b6dd7ff859c3e6a6e4a1bd8b50f9714775d
F vsixtest/vsixtest.vcxproj.data 2ed517e100c66dc455b492e1a33350c1b20fbcdc
F vsixtest/vsixtest.vcxproj.filters 37e51ffedcdb064aad6ff33b6148725226cd608e
F vsixtest/vsixtest_TemporaryKey.pfx e5b1b036facdb453873e7084e1cae9102ccc67a0
-P 265c8fd0d4d425054f6bf7e9cb607ad2e0e46189f16c3014f7fdf9b650085497
-R 82a7bb87064debdd63f799e45e3a7aa0
+P 962c3e0de2d64ab8a2bcf1a19f9c4224df3d15a41ac9f9b29da685be95c4ef7a
+R 26b1f361ecc1f9ee890a179908638933
U stephan
-Z 038e6a5cd04ee9dc715f1c7cadd72bf8
+Z c7ff43bec79fef52fa552298593f1614
# Remove this line to create a well-formed Fossil manifest.
-962c3e0de2d64ab8a2bcf1a19f9c4224df3d15a41ac9f9b29da685be95c4ef7a
\ No newline at end of file
+290028d3ca5638f3bb18a0b243c7ba3c31c8a2b1a837c36ec29e0fc4ed6533f0
\ No newline at end of file
projects / thirdparty / sqlite.git / commitdiff
