LibOciLib使用说明
整理者:赤勇玄心行天道
QQ:280604597
Email:280604597@qq.com
大家有什么不明白的地方,或者想要详细了解的地方可以联系我,我会认真回复的!
你可以随意转载,无需注明出处!
写文档实属不易,我希望大家能捐助我,继续支持我的工作,我会继续努力帮助大家,金额随意,1块也行,感谢!
支付宝:280604597@qq.com
QQ红包
OCILIB的QQ群:553666676
1、 复制解决方案根目录下的“LibOciLib”文件夹到调用程序的解决方案根目录下。
2、 调用程序需添加代码:
#include "..\LibOciLib\ocilib.h"
#if (defined _WIN64) && (defined _DEBUG)
#pragma comment(lib, "..\\LibOciLib\\LibOciLib_x64_Debug_MDd_LIB.lib")
#pragma comment(lib, "..\\LibOciLib\\oci_x64.lib")
#elif (defined _WIN64) && (defined NDEBUG)
#pragma comment(lib, "..\\LibOciLib\\LibOciLib_x64_Release_MD_LIB.lib")
#pragma comment(lib, "..\\LibOciLib\\oci_x64.lib")
#elif (defined _WIN32) && (defined _DEBUG)
#pragma comment(lib, "..\\LibOciLib\\LibOciLib_x86_Debug_MDd_LIB.lib")
#pragma comment(lib, "..\\LibOciLib\\oci_x86.lib")
#elif (defined _WIN32) && (defined NDEBUG)
#pragma comment(lib, "..\\LibOciLib\\LibOciLib_x86_Release_MD_LIB.lib")
#pragma comment(lib, "..\\LibOciLib\\oci_x86.lib")
#endif
3、 编译调用程序的项目。
1 简介
2 字段数据类型对应规则
DATABASE TYPE
C API TYPE
C API SUBTYPE
C++ API
C++ API SUBTYPE
PL/SQL BOOLEAN
boolean
bool
NUMBER
short
short
NUMBER
unsigned short
unsigned short
NUMBER
int
int
NUMBER
unsigned int
unsigned int
NUMBER
big_int (long long)
big_int (long long
NUMBER
big_uint (unsigned
long long)
big_uint (unsigned
long long)
NUMBER
float
float
NUMBER
double
double
NUMBER
OCI_Number *
ocilib::number
FLOAT
double
double
BINARY FLOAT
float
float
BINARY DOUBLE
double
float
CHAR
otext *
ocilib::ostring
VARCHAR
otext *
ocilib::ostring
VARCHAR2
otext *
ocilib::ostring
NVARCHAR
otext *
ocilib::ostring
NVARCHAR2
otext *
ocilib::ostring
ROWID
otext *
ocilib::ostring
UROWID
otext *
ocilib::ostring
VARRAW
void *
ocilib::Raw
RAW
void *
ocilib::Raw
LONG
OCI_Long *
OCI_CLONG
ocilib::Clong
LONG VARCHAR
OCI_Long *
OCI_CLONG
ocilib::Clong
LONG RAW
OCI_Long *
OCI_BLONG
ocilib::Blong
DATE
OCI_Date *
ocilib::Date
TIMESTAMP
OCI_Timestamp *
OCI_TIMESTAMP
ocilib::Timestamp
NoTimeZone
TIMESTAMP WITH TIME
ZONE
OCI_Timestamp *
OCI_TIMESTAMP_TZ
ocilib::Timestamp
WithTimeZone
TIMESTAMP WITH
LOCAL TIME ZONE
OCI_Timestamp *
OCI_TIMESTAMP_LTZ
ocilib::Timestamp
WithLocalTimeZone
INTERVAL YEAR TO
MONTH
OCI_Interval *
OCI_INTERVAL_YM
ocilib::Interval
YearMonth
INTERVAL DAY TO
SECOND
OCI_Interval *
OCI_INTERVAL_DS
ocilib::Interval
DaySecond
Character LOB
OCI_Lob *
OCI_CLOB
ocilib::Clob
LobCharacter
National Character
LOB
OCI_Lob *
OCI__NCLOB
ocilib::NClob
LobNationalCharacter
Binary LOB
OCI_Lob *
OCI_BLOB
ocilib::Blob
LobBinary
Binary FILE
OCI_File *
OCI_BFILE
ocilib::File
VARRAY
OCI_Coll *
OCI_COLL_VARRAY
ocilib::Collection
Varray
NESTED TABLE
OCI_Coll *
OCI_COLL_NESTED_TABLE
ocilib::Collection
NestedTable
PL/SQL INDEXED
TABLE
OCI_Coll *
OCI_COLL_INDEXED_TABLE
ocilib::Collection
IndexedTable
NAMED DATATYPE
(TYPE, OBJECT)
OCI_Object *
ocilib::Object
PL/SQL RECORD
OCI_Object *
ocilib::Object
REF
OCI_Ref *
ocilib::Reference
3 常用函数
OCI_Initialize() 初始化OCILIB库
OCI_Cleanup() 释放OCILIB库
OCI_ConnectionCreate() 创建Oracle数据库连接,并返回Oracle数据库连接句柄
OCI_ConnectionFree() 断开Oracle数据库连接,并释放Oracle数据库连接句柄
OCI_GetServerMajorVersion() 获取Oracle数据库服务器版本号
OCI_GetServerMinorVersion() 获取Oracle数据库服务器版本号
OCI_GetServerRevisionVersion() 获取Oracle数据库服务器版本号
OCI_GetVersionConnection() 获取Oracle数据库服务器版本号
OCI_StatementCreate() 创建Statement句柄,Statement句柄用于执行SQL语句
OCI_StatementFree() 释放Statement句柄
OCI_Prepare() 准备SQL语句
OCI_BindString() 绑定SQL语句变量
OCI_Execute() 执行SQL语句
OCI_ExecuteStmt() 准备并执行SQL语句
OCI_GetResultset() 获取结果集句柄
OCI_ReleaseResultsets() 释放结果集句柄
OCI_FetchNext() 获取结果集句柄的第一条或下一条数据
OCI_GetString() 获取结果集句柄的当条数据的某个字段的字符串内容
OCI_GetInt() 获取结果集句柄的当条数据的某个字段的整数内容
3.1 函数模板(未完成)
函数名称
xxx
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
函数主要功能说明。
函数声明
类型 函数名 (
类型 参数1,
类型 参数2,
……
);
函数参数
参数1,[输入|输出|输入&输出]:
参数说明。
参数2,[输入|输出|输入&输出]:
参数说明。
……
返回值
返回值1:返回值说明。
返回值2:返回值说明。
……
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是,需启用多线程支持
其他说明
……
……
3.2 初始化
3.2.1 OCI_Initialize
函数名称
OCI_Initialize
头文件
#include
"..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
初始化OCILIB库,必须初始化后才能调用OCILIB库函数。
本函数只需调用一次,再次调用在函数内部自动忽略。
函数声明
boolean OCI_Initialize (
POCI_ERROR
err_handler,
const mtext
* lib_path,
unsigned
int mode
);
函数参数
err_handler,[输入]:
存放当执行数据库操作出错时的出错回调函数的内存指针,函数声明应为void err_handler (OCI_Error * err),err参数为错误码句柄。
如果本参数为NULL,表示不使用回调函数。
lib_path,[输入]:
存放Oracle数据库的Oci动态库的上级路径字符串的内存指针,例如:C:\instantclient_11_2。
如果本参数为NULL,表示从ORACLE_HOME环境变量获取Oracle数据库的动态库的路径。
如果要使本参数生效,需要在编译OCILIB库时指定OCI_IMPORT_RUNTIME宏,否则本参数将自动忽略为NULL。
mode,[输入]:
存放模式标记,可以为(用'|'选一至多个):
OCI_ENV_DEFAULT宏(0x0000):
默认模式,本标记强制设置。
OCI_ENV_THREADED宏(0x0001):
如果设置本标记,表示启用多线程支持使用本库。
如果不设置本标记,表示单线程使用本库,不能多线程使用本库,如果多线程使用会出现意外。
OCI_ENV_CONTEXT宏(0x0002):
如果设置本标记,表示启用线程上下文错误处理,其实就是用线程上下文保存每一次数据库操作的错误信息,以便可以调用OCI_GetLastError()函数来查看上次数据库操作的错误信息。
如果不设置本标记,表示不保存数据库操作的错误信息,调用OCI_GetLastError()函数将无法查看到错误信息。
是否设置本标记不影响err_handler参数指定的出错回调函数。
OCI_ENV_EVENTS(0x0004):
enables
events for subscription, HA Events, AQ notifications。
返回值
非0:成功。
0:失败,加载Oracle数据库的动态库或OCILIB动态库失败。
错误码
无
线程安全
否
原子操作
否
其他说明
本函数会加载Oracle数据库的动态库到调用进程。
如果程序不会再调用OCILIB库,可以调用OCI_Cleanup()函数释放OCILIB库。
3.2.2 OCI_Cleanup
函数名称
OCI_Cleanup
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
释放OCILIB库,释放后OCILIB库函数将不能再调用。
释放后,如果需要再次调用OCILIB库,再次初始化OCILIB库即可。
只需在初始化OCILIB库后,不再调用OCILIB库时,调用本函数,未初始化OCILIB库就调用本函数无意义。
函数声明
boolean OCI_Cleanup (
void
);
函数参数
无
返回值
非0:成功。
0:失败。
错误码
无
线程安全
否
原子操作
否
其他说明
本函数会从调用进程卸载Oracle数据库的动态库。
3.3 错误处理
3.3.1 OCI_GetLastError(未完成)
函数名称
OCI_GetLastError
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
获取最近一次调用OCILIB库的函数的错误或者警告。
函数声明
OCI_Error * OCI_GetLastError (
void
);
函数参数
无
返回值
非NULL:错误句柄,表示最近一次调用OCILIB库的函数出现了错误或者警告。
NULL:没有错误或者警告,表示最近一次调用OCILIB库的函数成功完成。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是,需启用多线程支持
其他说明
3.3.2 OCI_ErrorGetString
函数名称
OCI_ErrorGetString
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
根据错误句柄,获取错误或警告的提示信息字符串。
函数声明
const otext * OCI_ErrorGetString (
OCI_Error *
err
);
函数参数
err,[输入]:
存放错误句柄,不能为NULL。
返回值
错误或警告的提示信息字符串的内存指针。
错误码
无
线程安全
是,需启用多线程支持
原子操作
是,需启用多线程支持
其他说明
提示信息字符串示例:ORA-12154: TNS: 无法解析指定的连接标识符
3.3.3 OCI_ErrorGetType(未完成)
函数名称
OCI_ErrorGetType
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
根据错误句柄,获取错误类型,包括:Oracle错误、OCILIB错误、Warning警告。
函数声明
unsigned int OCI_ErrorGetType(
OCI_Error *
err
)
函数参数
err,[输入]:
存放错误句柄,不能为NULL。
返回值
OCI_ERR_ORACLE:Oracle错误。
OCI_ERR_OCILIB:OCILIB错误。
OCI_ERR_WARNING:Warning警告。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是,需启用多线程支持
其他说明
3.4 连接数据库
3.4.1 OCI_ConnectionCreate(未完成)
函数名称
OCI_ConnectionCreate
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
创建一个Oracle数据库的连接,并返回Oracle数据库连接句柄。
函数声明
OCI_Connection * OCI_ConnectionCreate (
const mtext
* db,
const mtext
* user,
const mtext
* pwd,
unsigned
int mode
);
函数参数
db,[输入]:
存放连接Oracle数据库的连接描述符字符串的内存指针,也可以直接存放连接描述符的配置字符串的内存指针。
连接描述符的配置在oracle的安装路径下的network/admin/tnsnames.ora中。
连接描述符的配置字符串就是tnsnames.ora文件中连接描述符等于符号后面所填写的内容。
user,[输入]:
存放连接Oracle数据库的用户名字符串的内存指针。
pwd,[输入]:
存放连接Oracle数据库的用户名对应的密码字符串的内存指针。
mode,[输入]:
存放连接Oracle数据库的会话模式,可以为(选一至一个):
OCI_SESSION_DEFAULT宏(0x0000):
以normal普通身份登陆Oracle数据库。
OCI_SESSION_SYSDBA宏(0x0002):
以SYSDBA系统管理员身份登陆Oracle数据库。
OCI_SESSION_SYSOPER宏(0x0004):
以SYSOPER系统操作员身份登陆Oracle数据库。
OCI_SESSION_XA宏(0x0001):
Oracle XA
support
OCILIB supports
Oracle XA connectivity. In order to get a connection using the XA interface :
Pass to the
parameter 'db' the value of the 'DB' parameter of the given XA connection
string pased to the Transaction Processing Monitor (TPM)
Pass NULL
to the 'user' and 'pwd' parameters
Pass the
value OCI_SESSION_XA to parameter 'mode'
Oracle XA
Connection String
The XA
connection string used in a transaction monitor to connect to Oracle must be
compatible with OCILIB :
the XA
parameter 'Objects' MUST be set to 'true'
If
OCI_ENV_THREADED is passed to OCI_Initialize(), the XA parameter 'Threads'
must be set to 'true', otherwise to 'false'
If
OCI_ENV_EVENTS is passed to OCI_Initialize(), the XA parameter 'Events' must
be set to 'true', otherwise to 'false'
As Oracle
does not support Unicode UTF16 characterset through the XA interface, Only
OCI_CHARSET_ANSI builds of OCILIB can be used
You still
can use UTF8 if the NLS_LANG environment variable is set with a valid UTF8
NLS value
DO NOT USE
OCI_CHARSET_MIXED or OCI_CHARSET_WIDE OCILIB builds with XA connections
返回值
非NULL:连接成功,Oracle数据库连接句柄。
NULL:连接失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是,需启用多线程支持
其他说明
如果要断开连接,可以调用OCI_ConnectionFree()函数。
3.4.2 OCI_ConnectionFree(未完成)
函数名称
OCI_ConnectionFree
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
断开一个Oracle数据库的连接。
函数声明
boolean OCI_ConnectionFree (
OCI_Connection
* con
)
函数参数
con,[输入]:
存放调用OCI_ConnectionCreate()函数返回的Oracle数据库连接句柄,不能为NULL。
本参数不能为错误的Oracle数据库连接句柄,否则会内存读写错误。
返回值
非0:断开成功。
0:断开失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
ORA-0:指定的Oracle数据库连接句柄为NULL。
线程安全
是,需启用多线程支持
原子操作
是
其他说明
Oracle数据库连接句柄在断开后就不能再使用了,再用就会报错误的Oracle数据库连接句柄。
3.5 执行Statement
3.5.1 OCI_StatementCreate(未完成)
函数名称
OCI_StatementCreate
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
根据Oracle数据库连接句柄,创建Statement对象句柄。
函数声明
OCI_Statement * OCI_StatementCreate (
OCI_Connection
* con
);
函数参数
con,[输入]:
存放Oracle数据库连接句柄。
返回值
非NULL:成功,Statement对象句柄。
NULL:失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明
创建完Statement对象句柄,就可以开始准备、解析并执行SQL语句或PL/SQL代码块了。
执行一个SQL语句或PL/SQL代码块需要经过三个步骤:准备、解析、执行。具体如下:
准备就是将SQL语句或PL/SQL代码块存放到Statement对象句柄。
解析就是让Oracle数据库服务器将准备好的SQL语句或PL/SQL代码块进行分析是否可以被执行。
执行就是将已经解析通过后的SQL语句或PL/SQL代码块进行执行。
一个Statement对象句柄在经过准备、解析、执行步骤之后,如果还需要再执行任何SQL语句或PL/SQL代码块,必须要重新进行准备、解析、执行步骤,不能只准备一次,然后重复执行,否则会出现意外错误。
当Statement对象句柄不再使用时,应调用OCI_StatementFree()函数释放Statement对象句柄。
3.5.2 OCI_StatementFree(未完成)
函数名称
OCI_StatementFree
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
释放Statement对象句柄。
函数声明
OCI_EXPORT boolean OCI_StatementFree (
OCI_Statement
* stmt
);
函数参数
stmt,[输入]:
存放Statement对象句柄。
返回值
非0:成功。
0:失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明
3.5.3 OCI_Prepare(未完成)
函数名称
OCI_Prepare
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
向指定的Statement对象句柄里,准备一个SQL语句或PL/SQL代码块,该SQL语句或PL/SQL代码块不会被解析和执行。
函数声明
boolean OCI_Prepare (
OCI_Statement
* stmt,
const otext
* sql
)
函数参数
stmt,[输入]:
存放Statement对象句柄。
sql,[输入]:
存放SQL语句或PL/SQL代码块字符串的内存指针,不能为NULL。
如果是SQL语句,不能在末尾添加';'分号,例如:select * from dual。
如果是PL/SQL代码块,必须要在末尾添加';'分号,例如:begin dbms_output.new_line();
end;。
返回值
非0:成功,或有警告,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
0:失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是,需启用多线程支持
其他说明
一般在调用本函数后,会再对SQL语句或PL/SQL代码块中的变量进行绑定,然后再调用OCI_Execute()函数解析并执行。如果不需要绑定变量的,一般会调用OCI_ExecuteStmt()函数来一次性完成准备、解析和执行。
如果SQL语句或PL/SQL代码块中有变量需要绑定,绑定变量的格式都是冒号后面加变量名,例如:insert
into table values (:var1, :var2)。
3.5.4 OCI_Execute(未完成)
函数名称
OCI_Execute
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
根据指定的Statement对象句柄,解析并执行一个已经准备好的并绑定了变量的SQL语句或PL/SQL代码块。
函数声明
boolean OCI_Execute (
OCI_Statement
* stmt
)
函数参数
stmt,[输入]:
存放Statement对象句柄。
返回值
非0:成功,或有警告,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
0:失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是,需启用多线程支持
其他说明
3.5.5 OCI_ExecuteStmt(未完成)
函数名称
OCI_ExecuteStmt
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
向指定的Statement对象句柄里,准备、解析并执行一个SQL语句或PL/SQL代码块。
函数声明
OCI_EXPORT boolean OCI_ExecuteStmt (
OCI_Statement
* stmt,
const otext
* sql
);
函数参数
stmt,[输入]:
存放Statement对象句柄。
sql,[输入]:
存放SQL语句或PL/SQL代码块字符串的内存指针,不能为NULL。
如果是SQL语句,不能在末尾添加';'分号,例如:select * from dual。
如果是PL/SQL代码块,必须要在末尾添加';'分号,例如:begin dbms_output.new_line();
end;。
返回值
非0:成功,或有警告,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
0:失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明
如果成功执行了Select查询语句,就可以调用OCI_GetResultset()函数来获取结果集。
3.5.6 OCI_Parse(未完成)
函数名称
OCI_Parse
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
向指定的Statement对象句柄里,准备并解析一个SQL语句或PL/SQL代码块,该SQL语句或PL/SQL代码块不会被执行。
函数声明
boolean OCI_Parse (
OCI_Statement
* stmt,
const otext
* sql
)
函数参数
stmt,[输入]:
存放Statement对象句柄。
sql,[输入]:
存放SQL语句或PL/SQL代码块字符串的内存指针,不能为NULL。
如果是SQL语句,不能在末尾添加';'分号,例如:select * from dual。
如果是PL/SQL代码块,必须要在末尾添加';'分号,例如:begin dbms_output.new_line();
end;。
返回值
非0:成功,或有警告,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
0:失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是,需启用多线程支持
其他说明
3.6 控制Statement
3.6.1 OCI_GetFetchSize(未完成)
函数名称
OCI_GetFetchSize
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
获取指定的Statement对象句柄在每次抽取数据时从Oracle数据库服务器预抽取多少行的数据。
函数声明
unsigned int OCI_GetFetchSize (
OCI_Statement
* stmt
)
函数参数
stmt,[输入]:
存放Statement对象句柄。
返回值
预抽取多少行的数据,默认值为OCI_FETCH_SIZE宏。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是,需启用多线程支持
其他说明
预抽取就是先从Oracle数据库服务器一次性抽取多行数据存放到缓存中,然后再从该缓存中依次抽取数据出来,当缓存中的数据抽取完毕时,又会从Oracle数据库服务器一次性抽取多行数据存放到缓存中,直到全部抽取完毕,这样可以加快抽取速度,减少Oracle数据库服务器的压力。
3.6.2 OCI_SetFetchSize(未完成)
函数名称
OCI_SetFetchSize
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
修改指定的Statement对象句柄在每次抽取数据时从Oracle数据库服务器预抽取多少行的数据。
函数声明
boolean OCI_SetFetchSize (
OCI_Statement
* stmt,
unsigned
int size
)
函数参数
stmt,[输入]:
存放Statement对象句柄。
size,[输入]:
存放预抽取多少行的数据的值。
返回值
非0:成功,或有警告,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
0:失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是,需启用多线程支持
其他说明
本函数必须要在调用OCI_GetResultset()函数之前调用,否则将无效。
调大预抽取行数可以加快抽取速度,越打越快,一般为10000至50000能达到最快抽取速度。
3.7 抽取结果集数据
3.7.1 OCI_GetResultset(未完成)
函数名称
OCI_GetResultset
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
获取根据Statement对象句柄执行Select查询语句后的结果集句柄。
函数声明
OCI_Resultset * OCI_GetResultset (
OCI_Statement
* stmt
);
函数参数
stmt,[输入]:
存放Statement对象句柄。
返回值
非0:成功,结果集句柄。
0:失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明
当结果集句柄不再使用时,应调用OCI_ReleaseResultsets()函数释放结果集句柄。
3.7.2 OCI_ReleaseResultsets(未完成)
函数名称
OCI_ReleaseResultsets
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
释放结果集句柄。
函数声明
boolean OCI_ReleaseResultsets (
OCI_Statement
* stmt
);
函数参数
stmt,[输入]:
存放Statement对象句柄。
返回值
非0:成功。
0:失败,通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明
3.7.3 OCI_GetColumnCount(未完成)
函数名称
OCI_GetColumnCount
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
获取结果集句柄的字段个数。
函数声明
unsigned int OCI_GetColumnCount (
OCI_Resultset
* rs
);
函数参数
rs,[输入]:
存放结果集句柄。
返回值
字段个数。
错误码
无
线程安全
是,需启用多线程支持
原子操作
是
其他说明
3.7.4 OCI_GetColumn(未完成)
函数名称
OCI_GetColumn
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
获取结果集句柄的指定索引的字段句柄。
函数声明
OCI_Column * OCI_GetColumn (
OCI_Resultset
* rs,
unsigned
int index
);
函数参数
rs,[输入]:
存放结果集句柄。
index,[输入]:
存放字段索引的值,从1开始。
返回值
非NULL:成功,返回值就是字段句柄。
NULL:失败,字段索引超出范围或发生错误,无法查看错误码。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明
3.7.5 OCI_ColumnGetName(未完成)
函数名称
OCI_ColumnGetName
头文件
#include
#include
库文件
#pragma comment(lib, "xxx.lib")
函数功能
获取字段句柄的名称字符串。
函数声明
const otext * OCI_ColumnGetName (
OCI_Column
* col
);
函数参数
col,[输入]:
存放字段句柄。
返回值
名称字符串的内存指针。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明
3.7.6 OCI_ColumnGetSQLType(未完成)
函数名称
OCI_ColumnGetSQLType
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
获取字段句柄的类型字符串,只有类型,没有精度。
例如:VARCHAR2。
函数声明
const otext * OCI_ColumnGetSQLType (
OCI_Column
* col
)
函数参数
col,[输入]:
存放字段句柄。
返回值
类型字符串的内存指针。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明
3.7.7 OCI_ColumnGetFullSQLType(未完成)
函数名称
OCI_ColumnGetFullSQLType
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
获取字段句柄的完整类型字符串,包括类型和精度。
注意:VARCHAR2类型的字段会写成VARCHAR,但是不影响,因为Oracle中VARCHAR和VARCHAR2是同一种类型。
例如:VARCHAR(30)。
函数声明
unsigned int OCI_ColumnGetFullSQLType (
OCI_Column
* col,
otext * buffer,
unsigned
int len
);
函数参数
col,[输入]:
存放字段句柄。
buffer,[输入]:
存放用于存放字段完整类型字符串的内存指针。
len,[输入]:
存放用于存放字段完整类型字符串的内存大小。
返回值
向用于存放字段完整类型字符串的内存写入了多少长度的字符,单位字节,不包括'\0'结束符。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明
3.7.8 OCI_ColumnGetSize(未完成)
函数名称
OCI_ColumnGetSize
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
获取字段句柄的大小,不同数据类型单位不一样。
VARCHAR2类型:单位为字符个数,和精度一致。
NUMBER类型:单位为字节,通常都是22个字节。
DATE类型:单位为字节,通常都是7个字节。
TIMESTAMP类型:单位为字节,通常都是11个字节,精度为0是7个字节。
TIMESTAMP
WITH LOCAL TIME ZONE类型:单位为字节,通常都是11个字节,精度为0是7个字节。
TIMESTAMP
WITH TIME ZONE类型:单位为字节,通常都是13个字节。
函数声明
unsigned int OCI_ColumnGetSize (
OCI_Column
* col
);
函数参数
col,[输入]:
存放字段句柄。
返回值
返回值1:返回值说明。
返回值2:返回值说明。
……
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明
3.7.9 OCI_ColumnGetNullable(未完成)
函数名称
OCI_ColumnGetNullable
头文件
#include "..\LibOciLib\ocilib.h"
库文件
#pragma comment(lib, "xxx.lib")
函数功能
获取字段句柄的值可否为NULL。
函数声明
boolean OCI_ColumnGetNullable (
OCI_Column
* col
);
函数参数
col,[输入]:
存放字段句柄。
返回值
非0:可以为NULL。
0:不可以为NULL。
错误码
EXXXX:错误码说明。
EXXXX:错误码说明。
……
线程安全
是,需启用多线程支持
原子操作
是
其他说明