Documentation Source Text

Check-in [74ab40f1f1]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Add a couple of sentences to the pointer-passing document to try to clarify that the caller owns the passed pointers.
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256: 74ab40f1f1e26cd66e90d0a39d22675a48018056323ff6275a2b57c54b8d97c9
User & Date: drh 2017-07-24 15:19:41.983
Context
2017-07-24
15:29
Further typo fixes in the pointer-passing document. (check-in: 3ae0a793ec user: drh tags: trunk)
15:19
Add a couple of sentences to the pointer-passing document to try to clarify that the caller owns the passed pointers. (check-in: 74ab40f1f1 user: drh tags: trunk)
15:15
Fix typos in the pointer-passing document. (check-in: 2c7e1e0eff user: drh tags: trunk)
Changes
Unified Diff Ignore Whitespace Patch
Changes to pages/bindptr.in.
299
300
301
302
303
304
305







306
307
308
309
310
311
312

<p>
Pointer values must flow directly from their producer into their
consumer, with no intermediate operators or functions.  Any transformation
of a pointer value destroys the pointer and transforms the value into
an ordinary SQL NULL.








<h1>Summary</h1>

<p>Key take-aways from this essay:

<ol>
<li><p>
The internet is an increasingly hostile place.  These day, developers







>
>
>
>
>
>
>







299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319

<p>
Pointer values must flow directly from their producer into their
consumer, with no intermediate operators or functions.  Any transformation
of a pointer value destroys the pointer and transforms the value into
an ordinary SQL NULL.

<p>
Both the pointer and the pointer type parameter to the
[sqlite3_bind_pointer()] and [sqlite3_result_pointer()] interfaces
are "owned" by the caller.  In other words, the caller is responsible
for ensuring that both values remain valid until after the last access
via [sqlite3_value_pointer()].

<h1>Summary</h1>

<p>Key take-aways from this essay:

<ol>
<li><p>
The internet is an increasingly hostile place.  These day, developers