勇芳软件工作室.汉化:  SQLite3 API Functions > Blobs >

sqlite3_blob_bytes

Previous pageReturn to chapter overviewNext page

描述

 

返回通过其唯一参数中成功打开的BLOB句柄可访问的BLOB的字节大小。增量blob I / O功能只能读取或覆盖现有的blob内容;它们不能改变blob的大小。

 

C / C ++语法

 

int sqlite3_blob_bytes(sqlite3_blob *);

 

PB语法

 

FUNCTION sqlite3_blob_bytes ( _

BYVAL pBlob AS DWORD _

) AS LONG

 

参数

 

pBlob

 

[in]blob句柄。

 

返回值

 

blob的大小(以字节为单位)。

 

备注

 

此函数仅适用于先前成功调用sqlite3_blob_open而尚未由sqlite3_blob_close关闭的BLOB句柄。将任何其他指针传递到此函数会导致未定义且可能不受欢迎的行为。

 

C ++实现代码

 

/*

** Query a blob handle for the size of the data.

**

** The Incrblob.nByte field is fixed for the lifetime of the Incrblob

** so no mutex is required for access.

*/

SQLITE_API int sqlite3_blob_bytes(sqlite3_blob *pBlob){

Incrblob *p = (Incrblob *)pBlob;

return (p && p->pStmt) ? p->nByte : 0;

}