From: larrybr <larrybr@noemail.net>
Date: Thu, 10 Mar 2022 19:53:49 +0000 (+0000)
Subject: Doc improvements re sqlite3_column_text*() endianness (no code change)
X-Git-Tag: version-3.38.1~3
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=c606152c7b35cf5ae3797bc40b5486835fe2aa9a;p=thirdparty%2Fsqlite.git

Doc improvements re sqlite3_column_text*() endianness (no code change)

FossilOrigin-Name: a37c20d40f97570575abb1f1db31dbc934300e7f2294d38fe41850baedb3766f
---

diff --git a/manifest b/manifest
index 1672843b51..afc148ce10 100644
--- a/manifest
+++ b/manifest
@@ -1,5 +1,5 @@
-C Prevent\sa\sNULL-pointer\sdereference\swhen\strying\sto\sparse\sa\sillegal\nschema\sentry\sthat\scontains\sa\swindow\sfunction\swhile\sdoing\sa\sRENAME\sCOLUMN.\n[forum:/forumpost/ec2a2e0deb|Forum\spost\sec2a2e0deb].
-D 2022-03-10T16:28:13.109
+C Doc\simprovements\sre\ssqlite3_column_text*()\sendianness\s(no\scode\schange)
+D 2022-03-10T19:53:49.324
 F .fossil-settings/empty-dirs dbb81e8fc0401ac46a1491ab34a7f2c7c0452f2f06b54ebb845d024ca8283ef1
 F .fossil-settings/ignore-glob 35175cdfcf539b2318cb04a9901442804be81cd677d8b889fcc9149c21f239ea
 F LICENSE.md df5091916dbb40e6e9686186587125e1b2ff51f022cc334e886c19a0e9982724
@@ -554,7 +554,7 @@ F src/resolve.c ea935b87d6fb36c78b70cdc7b28561dc8f33f2ef37048389549c7b5ef9b0ba5e
 F src/rowset.c ba9515a922af32abe1f7d39406b9d35730ed65efab9443dc5702693b60854c92
 F src/select.c 3baa9dd8cf240654773c7974e2bcce398ac9dd24419c36684156963defe43b35
 F src/shell.c.in 69d1e59da4881f096ab47fbd3e6d99794f3e4a43f41fd9e4d2e845c9b8d20fd5
-F src/sqlite.h.in e82ac380b307659d0892f502b742f825504e78729f4edaadce946003b9c00816
+F src/sqlite.h.in b93deee892f1bc4030e5c8712df9e21d786a1bf8e921ab8dc987eaf1e44c676f
 F src/sqlite3.rc 5121c9e10c3964d5755191c80dd1180c122fc3a8
 F src/sqlite3ext.h a95cb9ed106e3d39e2118e4dcc15a14faec3fa50d0093425083d340d9dfd96e6
 F src/sqliteInt.h e7b93bb693cb14259f6c3faadc6d7c824ff509aac673622a76c161a96c5872d0
@@ -1944,9 +1944,10 @@ F vsixtest/vsixtest.tcl 6a9a6ab600c25a91a7acc6293828957a386a8a93
 F vsixtest/vsixtest.vcxproj.data 2ed517e100c66dc455b492e1a33350c1b20fbcdc
 F vsixtest/vsixtest.vcxproj.filters 37e51ffedcdb064aad6ff33b6148725226cd608e
 F vsixtest/vsixtest_TemporaryKey.pfx e5b1b036facdb453873e7084e1cae9102ccc67a0
-P b6c4c8a09a63693dd515d30a9f07f67ed81dc14df2586835fcb2b1bc6a9d01fc
-Q +58de3c2b1a773a71b2d6a5d9a4dc0f839185d78d64519e7d267ad133b9830120
-R 7f00f09efc9ea2f6eb3332f345d78af3
-U drh
-Z 3d37c68651afadf2e39b0d02d5b69141
+P 2c393228257490efcf609f3e428f0d02c74cbea48a28763b2414e69a4ced66da
+Q +1f473099776249f774a285fa117316636e00c3ff030ba0f22ed5bd05641c1bc9
+Q +25b7f88fcb2bb1908abde109c1167c462efbb156b4a8a8f94d36202bd93ea433
+R d04b5609ab6e8e6c106630371a1e077f
+U larrybr
+Z 1a60ea63ca750484d919d79c98674151
 # Remove this line to create a well-formed Fossil manifest.
diff --git a/manifest.uuid b/manifest.uuid
index 8e7483387f..77cecce219 100644
--- a/manifest.uuid
+++ b/manifest.uuid
@@ -1 +1 @@
-2c393228257490efcf609f3e428f0d02c74cbea48a28763b2414e69a4ced66da
\ No newline at end of file
+a37c20d40f97570575abb1f1db31dbc934300e7f2294d38fe41850baedb3766f
\ No newline at end of file
diff --git a/src/sqlite.h.in b/src/sqlite.h.in
index 97ffcd88cc..6062f79c22 100644
--- a/src/sqlite.h.in
+++ b/src/sqlite.h.in
@@ -4979,6 +4979,10 @@ int sqlite3_data_count(sqlite3_stmt *pStmt);
 ** even empty strings, are always zero-terminated.  ^The return
 ** value from sqlite3_column_blob() for a zero-length BLOB is a NULL pointer.
 **
+** ^Strings returned by sqlite3_column_text16() always have the endianness
+** which is native to the platform, regardless of the text encoding set
+** for the database.
+**
 ** <b>Warning:</b> ^The object returned by [sqlite3_column_value()] is an
 ** [unprotected sqlite3_value] object.  In a multithreaded environment,
 ** an unprotected sqlite3_value object may only be used safely with
@@ -4992,7 +4996,7 @@ int sqlite3_data_count(sqlite3_stmt *pStmt);
 ** [application-defined SQL functions] or [virtual tables], not within
 ** top-level application code.
 **
-** The these routines may attempt to convert the datatype of the result.
+** These routines may attempt to convert the datatype of the result.
 ** ^For example, if the internal representation is FLOAT and a text result
 ** is requested, [sqlite3_snprintf()] is used internally to perform the
 ** conversion automatically.  ^(The following table details the conversions
@@ -5017,7 +5021,7 @@ int sqlite3_data_count(sqlite3_stmt *pStmt);
 ** <tr><td>  TEXT    <td>   BLOB    <td> No change
 ** <tr><td>  BLOB    <td> INTEGER   <td> [CAST] to INTEGER
 ** <tr><td>  BLOB    <td>  FLOAT    <td> [CAST] to REAL
-** <tr><td>  BLOB    <td>   TEXT    <td> Add a zero terminator if needed
+** <tr><td>  BLOB    <td>   TEXT    <td> [CAST] to TEXT, ensure zero terminator
 ** </table>
 ** </blockquote>)^
 **