C函數篇(OCI函數)

OCI函數簡單解析

OCL函數參考

下面的表列出了Open Client庫支持的函數。須要注意的是所涉及到的頭文件必須由用戶提供，Postgres Plus Advance Server自己並不提供這些文件。

表9-54與鏈接，認證和初始化相關的函數

函數名稱	描述
OCIEnvCreate	建立一個OCI環境
OCIEnvInit	初始化一個OCI環境句柄
OCIInitialize	初始化OCI環境
OCILogoff	釋放一個會話
OCILogon	建立一個登陸鏈接
OCILogon2	使用不一樣的方式建立一個登陸會話
OCIServerAttach	創建到數據源的訪問路徑
OCIServerDetach	刪除到數據源的訪問
OCISessionBegin	建立一個用戶會話
OCISessionEnd	結束一個用戶會話
OCISessionGet	從會話池中獲取一個會話
OCISessionRelease	釋放一個會話
OCITerminate	從共享內存子系統中分離

表9-55與句柄和描述符相關的函數

函數名稱	描述
OCIAttrGet	獲取句柄屬性
OCIAttrSet	設置句柄屬性
OCIDescriptorAlloc	分配而且初始化一個描述符
OCIDescriptorFree	釋放一個已分配的描述符
OCIHandleAlloc	分配而且初始化一個句柄
OCIHandleFree	釋放一個已分配的句柄
OCIParamGet	獲取一個參數描述符
OCIParamSet	設置一個參數描述符

表9-56 與綁定，定義和描述相關的函數

函數名稱	描述
OCIBindByName	使用名稱綁定
OCIBindByPos	使用位置綁定
OCIBindDynamic	綁定後設定其餘的屬性
OCIBindArrayOfStruct	爲批量操做綁定一個數組結構
OCIDefineByPos	定義一個輸出變量結合
OCIDefineDynamic	爲定義設定其餘屬性
OCIDescribeAny	描述存在的模式對象
OCIStmtGetBindInfo	獲取綁定和指示變量名稱和句柄

表 9-57與語句相關函數

函數名稱	描述
OCIStmtExecute	執行一個已準備的SQL語句
OCIStmtFetch	獲取數據集中一行記錄（已經做廢）
OCIStmtFetch2	獲取數據集中一條記錄
OCIStmtPrepare	準備一個SQL語句
OCIStmtPrepare2	準備一個SQL語句
OCIStmtRelease	釋放一個語句句柄。

表9-58與事務相關的函數

函數名稱	描述
OCITransCommit	提交事務
OCITransRollback	回滾事務

表 9-59其它相關函數

函數名稱	描述
OCIClientVersion	返回Client庫的版本號
OCIErrorGet	返回一條錯誤消息
OCIPasswordChange	更改密碼
OCIPing	肯定鏈接和服務器處於活動狀態
OCIServerVersion	獲取包含Oracle版本的字符串

 表 9-60與日期和日期時間類型的相關函數

函數名稱	描述
OCIDateAddDays	增長或者減去天數
OCIDateAddMonths	增長或者減去月份數
OCIDateAssign	分配日期
OCIDateCheck	檢查給定的日期是否有效
OCIDateCompare	比較兩個日期
OCIDateDaysBetween	找出兩個日期之間的天數
OCIDateFromText	將一個字符串轉換爲日期
OCIDateGetDate	獲取一個日期中的日期部分
OCIDateGetTime	獲取一個日期中的時間部分
OCIDateLastDay	獲取每個月最後一天的日期
OCIDateNextDay	獲取明天的日期
OCIDateSetDate	設置一個日期中的日期部分
OCIDateSetTime	設置一個日期中的時間部分
OCIDateSysDate	獲取當前系統日期和時間
OCIDateToText	將日期轉換爲字符串
OCIDateTimeAssign	賦予日期時間
OCIDateTimeCheck	檢查日期是否有效
OCIDateTimeCompare	比較兩個日期時間的值
OCIDateTimeConstruct	構建一個日期時間描述符
OCIDateTimeConvert	將日期時間類型變量轉換成其它類型變量
OCIDateTimeFromArray	將大小爲OCI_DT_ARRAYLEN的數組轉換爲OCIDateTime描述符。
OCIDateTimeFromText	根據指定的格式將字符串轉換成OCIDateTime描述符中的Oracle日期時間類型。
OCIDateTimeGetDate	獲取日期時間類型值中的日期部分。
OCIDateTimeGetTime	獲取日期時間類型值中的時間部分。
OCIDateTimeGetTimeZoneName	獲取一個日期時間類型值中時間區域名稱部分
OCIDateTimeGetTimeZoneOffset	獲取一個日期時間類型值中時間區域的(小時，分鐘)部分
OCIDateTimeSubtract	把兩個日期時間型的值做爲輸入參數，返回這兩個值的間隔
OCIDateTimeSysTimeStamp	獲取系統當前的日期和時間做爲一個時間戳，而且帶有一個時間區域。
OCIDateTimeToArray	將一個OCIDateTime描述符轉換成一個數組
OCIDateTimeToText	根據指定的格式將一個日期類型的值轉換成字符串類型的值

表9-61與數值相關的函數

函數名稱	描述
OCINumberAbs	計算絕對值
OCINumberAdd	執行數值加法操做
OCINumberArcCos	計算反餘玄函數值
OCINumberArcSin	計算反正玄函數值
OCINumberArcTan	計算反正切函數值
OCINumberArcTan2	計算反正切的兩個數值
OCINumberAssign	將一個數值分配給另一個變量
OCINumberCeil	計算一個數值的ceiling值
OCINumberCmp	比較數值
OCINumberCos	計算餘弦值
OCINumberDec	對數值進行減一操做
OCINumberDiv	對兩個數值進行除法操做
OCINumberExp	將 e 傳遞給指定的數值做爲冪級數
OCINumberFloor	計算一個數值的floor值
OCINumberFromInt	將一個整數轉換成一個Oracle數值
OCINumberFromReal	將一個實數轉換成一個Oracle數值
OCINumberFromText	將一個字符串轉換成一個Oracle數值
OCINumberHypCos	計算雙曲餘玄值
OCINumberHypSin	計算雙曲正玄值
OCINumberHypTan	計算雙曲正切值
OCINumberInc	對數值進行加一操做
OCINumberIntPower	傳遞給定的底數作爲整型的冪級數
OCINumberIsInt	測試數值是否爲一個整數
OCINumberIsZero	測試數值是否爲0
OCINumberLn	計算天然對數值
OCINumberLog	以任意數爲底計算對數值
OCINumberMod	對數值進行取模操做
OCINumberMul	對數值進行乘法操做
OCINumberNeg	對一個數值進行求反操做
OCINumberPower	以e爲底求冪級數
OCINumberPrec	將一個數值四捨五入到一個指定數值的小數點位
OCINumberRound	將一個數值四捨五入到指定的小數點位
OCINumberSetPi	將一個數值初始化爲Pi
OCINumberSetZero	將一個數值初始化爲0
OCINumberShift	執行乘10操做,移動指定數值的小數點位
OCINumberSign	獲取數值的符號
OCINumberSin	計算正玄值
OCINumberSqrt	計算一個數值的平方根
OCINumberSub	進行減法操做
OCINumberTan	計算正切值
OCINumberToInt	將一個數值轉換成一個整數
OCINumberToReal	將一個數值轉換成一個實數
OCINumberToRealArray	將一個數值型數組轉換成一個實數型數組
OCINumberToText	將一個數值轉換成一個字符串
OCINumberTrunc	在指定的小數位截斷一個數值

表9-62 字符串函數

函數名稱	描述
OCIStringAllocSize	獲取已分配用於存放字符串的內存字節數
OCIStringAssign	將字符串賦予一個字符串類型變量
OCIStringAssignText	將文本字符串賦予一個字符串類型變量
OCIStringPtr	獲取字符串指針
OCIStringResize	從新設定用於存放字符串內存的大小
OCIStringSize	獲取字符串的長度

表9-63與磁帶和文件I/O相關的接口函數

函數名稱	描述
OCIFileClose	關閉一個已打開的文件
OCIFileExists	測試文件是否存在
OCIFileFlush	將緩衝池的數據寫到一個文件中
OCIFileGetLength	獲取文件的長度
OCIFileInit	初始化OCIFile包
OCIFileOpen	打開一個文件
OCIFileRead	將文件內容讀取到緩衝區中
OCIFileSeek	改變文件中指針的當前位置
OCIFileTerm	結束包OCIFile
OCIFileWrite	將長度爲buflen的字節寫到文件中。

表9-64 所支持的數據類型

數據類型名稱	描述
ANSI_DATE	ANSI 日期類型
SQLT_AFC	ANSI 固定字符
SQLT_AVC	ANSI 可變字符串
SQLT_BDOUBLE	二進制雙精度類型
SQLT_BIN	二進制數據類型
SQLT_BFLOAT	二進制浮點型
SQLT_CHR	字符串類型
SQLT_DAT	Oracle 日期類型
SQLT_DATE	ANSI 日期類型
SQLT_FLT	浮點型
SQLT_INT	整型
SQLT_LBI	長二進制
SQLT_LNG	長整型
SQLT_LVB	超長的長型二進制
SQLT_LVC	超長的長整型數值（或字符串）
SQLT_NUM	Oracle數值
SQLT_ODT	OCI數據類型
SQLT_STR	以0結束的字符串
SQLT_TIMESTAMP	時間戳
SQLT_TIMESTAMP_TZ	帶有區域的時間戳
SQLT_TIMESTAMP_LTZ	帶有本地時間區域的時間戳
SQLT_UIN	無符號整數
SQLT_VBI	VCS格式的二進制數據
SQLT_VCS	變長字符串
SQLT_VNU	變長數值
SQLT_VST	OCI 字符串類型