xref: /netbsd-src/external/public-domain/sqlite/man/sqlite3_blob_bytes.3 (revision deb6f0161a9109e7de9b519dc8dfb9478668dcdd)
1.Dd March 11, 2017
2.Dt SQLITE3_BLOB_BYTES 3
3.Os
4.Sh NAME
5.Nm sqlite3_blob_bytes
6.Nd Return The Size Of An Open BLOB
7.Sh SYNOPSIS
8.Ft int
9.Fo sqlite3_blob_bytes
10.Fa "sqlite3_blob *"
11.Fc
12.Sh DESCRIPTION
13Returns the size in bytes of the BLOB accessible via the successfully
14opened BLOB handle in its only argument.
15The incremental blob I/O routines can only read or overwriting existing
16blob content; they cannot change the size of a blob.
17.Pp
18This routine only works on a BLOB handle which has been
19created by a prior successful call to sqlite3_blob_open()
20and which has not been closed by sqlite3_blob_close().
21Passing any other pointer in to this routine results in undefined and
22probably undesirable behavior.
23.Sh SEE ALSO
24.Xr sqlite3_blob 3 ,
25.Xr sqlite3_blob_close 3 ,
26.Xr sqlite3_blob_open 3
27