index.html

ORACLE编程的好东西,纯C写的OCI封装.很好用,支持数据池.

    * Modified OCI_xxxFmt() calls :

      - Added new identifiers :

        * '%u'  : <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span>
        * '%hi' : <span class="keywordtype">short</span>
        * '%hu' : <span class="keywordtype">unsigned</span> <span class="keywordtype">short</span>
        * '%li' : big_int
        * '%lu' : big_uint

    * Miscellaneous changes

      - Added    : windows platforms (WIN32/WIN64) detection 
      - Modified : added some cast to please absolute paranoid builds
      - Modified : <a class="code" href="group__g__fetch.html#gd81efb112147c18b376c9524c91ecd28" title="Copy the current raw value of the column at the given index into the specified buffer...">OCI_GetRaw</a>() was not checking if parameter 'buffer' was null
      - Modified : rewritten implicit integers and <span class="keywordtype">double</span> type conversion in OCI_Getxxx() calls
      - Modified : Macro used for identifying Windows platforms from WIN32 to _WINDOWS
      - Modified : modified some expression evaluation for explicit checks (replaced some if(var) with if(var == x))
      - Modified : added some pointers reinitializations (not needed but we never known...)
      - Modified : OCI_ResultsetExpandStrings() is now included in builds only if OCI_CHECK_DATASTRINGS is defined
      - Modified : <a class="code" href="struct_o_c_i___thread.html" title="OCILIB encapsulation of OCI Threads.">OCI_Thread</a> and <a class="code" href="struct_o_c_i___mutex.html" title="OCILIB encapsulation of OCI mutexes.">OCI_Mutex</a> code relooking with OCI_DIRECT, OCI_CHECK_STATUS macros
      - Removed  : implicit conversion from text to integers in OCIGetxxxIntxx() calls

    * Miscellaneous Fixes

      - Fixed : OCILIB was not compiling with MSVC6 (added macro to use _vsnprintf()/_vsnwprintf with MS compilers and vsnprintf()/vsnwprintf() for all others compilers)
      - Fixed : <a class="code" href="group__g__lob.html#gcda64fca2ab7eb9d8a8d68190b13a285" title="Append a source LOB at the end of a destination LOB.">OCI_LobAppendLob</a>() was not updating internal current offset position
      - Fixed : OCI_ParseSqlFmt() : OCI_interval * variable was not checked for nullity
      - Fixed : OCI_Initialize() with runtime loading mode : oracle 11g detection was broken (missing 'else' keyword)
      - Fixed : <a class="code" href="group__g__fetch.html#gf2a9e28b66a9538ba0ffb62bffb87c16" title="Retrieve the resultset handle from an executed statement.">OCI_GetResultset</a>() : selecting unsupported REF datatype was throwing 2 errors instead of one.
      - Fixed : <a class="code" href="group__g__fetch.html#g1ad37dce6d6e900e98d39b2b2e0f5022" title="Return the current date value of the column at the given index in the resultset.">OCI_GetDate</a>()    + client Oracle 11g + "Return into" clause    : the OCILIB workaround for Oracle bug <span class="preprocessor">#3269146 was not working properly</span>
<span class="preprocessor"></span>      - Fixed : <a class="code" href="group__g__bind.html#g49988b9ca8f00b55cc3e62ca2385778b" title="Bind a string variable.">OCI_BindString</a>() + client Oracle 8i  + OCI_CHARSET_MIXED build : setting internally OCI_ATTR_CHARSET_FORM (since v2.0.0) caused a crash with Oracle 8.1.7.O (OCI bug ?)
      - Normalization of few Function Names :

        * OCI_CreateTransaction() -&gt; <a class="code" href="group__g__transac.html#g206d14aa9a25befd218a7f91a56d5c47" title="Create a new global transaction or a serializable/read-only local transaction.">OCI_TransactionCreate</a>()
        * OCI_FreeTransaction() -&gt; <a class="code" href="group__g__transac.html#gab96c358fd6074b5d4f027bd86cfa229" title="Free current transaction.">OCI_TransactionFree</a>()
        * OCI_CreateHashTable() -&gt; <a class="code" href="group__g__hash.html#ga4375677fb934961a73a1f5d0de6eadd" title="Create a hash table.">OCI_HashCreate</a>()
        * OCI_FreeHashTable() -&gt; <a class="code" href="group__g__hash.html#g9d85500c527e1cb75697abd663add2f1" title="Destroy a hash table.">OCI_HashFree</a>()
        * OCI_xxxTransaction() -&gt; OCI_Transactionxxx()
 
      - Added Macro for existing code compatibility (except for OCI_xxxTransaction() functions)
 
2008-03-31 Version 2.3.0 Vincent Rogier [e-mail]

    * Added Support for OCI Connection Pools

      - See new section in the documentation (page &lt;module&gt;, section &lt;Connection pooling&gt;)
      - Added type <a class="code" href="struct_o_c_i___conn_pool.html" title="Oracle Connection Pool.">OCI_ConnPool</a>
      - Added <a class="code" href="group__g__connpool.html#g55ba9db7940b0be1514ab3010c6a9e81" title="Create a Connection pool.">OCI_ConnPoolCreate</a>()
      - Added <a class="code" href="group__g__connpool.html#g4bca447fc21e09cb1cc4cc3ec2cfcde1" title="Destroy a Connection pool object.">OCI_ConnPoolFree</a>()
      - Added <a class="code" href="group__g__connpool.html#g774ce156deb3477c83237a633b6538f6" title="Get a connection from the pool.">OCI_ConnPoolGetConnection</a>()
      - Added <a class="code" href="group__g__connpool.html#g8fd224a01efdfbb76d642dff095d0612" title="Get the idle connection timeout.">OCI_ConnPoolGetTimeout</a>()
      - Added <a class="code" href="group__g__connpool.html#gae3bf80948897765fc15d363de073171" title="Set the idle connection timeout.">OCI_ConnPoolSetTimeout</a>()
      - Added <a class="code" href="group__g__connpool.html#g0dff250d296fe1060a576e9bdb43ffb0" title="Get the waiing mode used when no more connections are available from the pool.">OCI_ConnPoolGetlGetNoWait</a>()
      - Added <a class="code" href="group__g__connpool.html#g5d8458d13c8704dbf60cb7289b8c6240" title="Set the waiing mode used when no more connections are available from the pool.">OCI_ConnPoolSetNoWait</a>()
      - Added <a class="code" href="group__g__connpool.html#ga2cbd17675866a81848c5cd586dd43b6" title="Return the current number of busy connections.">OCI_ConnPoolGetBusyCount</a>()
      - Added <a class="code" href="group__g__connpool.html#gfe8e50af422954eac1fa3f33c6624cfd" title="Return the current number of opened connections.">OCI_ConnPoolGetOpenedCount</a>()
      - Added <a class="code" href="group__g__connpool.html#g11d1656264645b9ffb01405c2ff53021" title="Return the minimum number of connections that can be opened to the database.">OCI_ConnPoolGetMin</a>()
      - Added <a class="code" href="group__g__connpool.html#g24a3b2eaca171d4dbc3d40e1dc0229ca" title="Return the maximum number of connections that can be opened to the database.">OCI_ConnPoolGetMax</a>()
      - Added <a class="code" href="group__g__connpool.html#gc8f2a7bd2d053c9f774eb86a18533355" title="Return the increment for connections to be opened to the database when the pool is...">OCI_ConnPoolGetIncrement</a>()

    * Added Support for OCI Mutexes
     
      - See new section in the documentation (page &lt;module&gt;, section &lt;Threads and mutexes&gt;)
      - Added type <a class="code" href="struct_o_c_i___mutex.html" title="OCILIB encapsulation of OCI mutexes.">OCI_Mutex</a>
      - Added <a class="code" href="group__g__threads.html#gb0580aafc0e70358742e7c1e269895d5" title="Create a Mutex object.">OCI_MutexCreate</a>()
      - Added <a class="code" href="group__g__threads.html#g90c5cb68c0144b7bda9b75906c752ab5" title="Destroy a mutex object.">OCI_MutexFree</a>()
      - Added <a class="code" href="group__g__threads.html#g88a05b41e24b3bd1789688702cc6f4f4" title="Acquire a mutex lock.">OCI_MutexAcquire</a>()
      - Added <a class="code" href="group__g__threads.html#g366f287cf828533617faf0785181de7f" title="Release a mutex lock.">OCI_MutexRelease</a>()

    * Added Support for OCI Threads
     
      - See new section in the documentation (page &lt;module&gt;, section &lt;Threads and mutexes&gt;)
      - Added type <a class="code" href="struct_o_c_i___thread.html" title="OCILIB encapsulation of OCI Threads.">OCI_Thread</a>
      - Added <a class="code" href="group__g__threads.html#g1a2474e874215e0b42109ba042de5e3a" title="Create a Thread object.">OCI_ThreadCreate</a>()
      - Added <a class="code" href="group__g__threads.html#gda7fa41aeedc7be2ce4f40c93ece524d" title="Destroy a thread object.">OCI_ThreadFree</a>()
      - Added <a class="code" href="group__g__threads.html#g1076c9942cc395f298ca350021031bfd" title="Execute the given routine within the given thread object.">OCI_ThreadRun</a>()
      - Added <a class="code" href="group__g__threads.html#gdfec0263c6b8d508126a806c85898fb9" title="Join the given thread.">OCI_ThreadJoin</a>()

    * Extended support for public retrieval of internal OCI handles :

      - Added <a class="code" href="group__g__handles.html#gf0b3b3abf1d48da90f37b564dafeac93" title="Return OCI Mutex handle (OCIThreadMutex *) of an OCILIB OCI_Mutex object.">OCI_HandleGetMutex</a>()
      - Added <a class="code" href="group__g__handles.html#ga77980531a35fa442bfa3ef49f1a87af" title="Return OCI Thread handle (OCIThreadHandle *) of an OCILIB OCI_Thread object.">OCI_HandleGetThread</a>()
      - Added <a class="code" href="group__g__handles.html#g94df890665f1f2ea39c3f4f4a00f9987" title="Return OCI Thread ID (OCIThreadId *) of an OCILIB OCI_Thread object.">OCI_HandleGetThreadID</a>()

    * Extended Lobs support :

      - Added <a class="code" href="group__g__lob.html#g30c335eb342272b308eb3746e5b4ea75" title="Assign a lob to another one.">OCI_LobAssign</a>()
      - Added <a class="code" href="group__g__file.html#g2a37633ddf3d9c22575a85cee7b75f42" title="Assign a file to another one.">OCI_FileAssign</a>()

    * Extended "Formatted" functions support :

      - Added support for <a class="code" href="struct_o_c_i___timestamp.html" title="Oracle internal timespamp representation.">OCI_Timestamp</a> (&lt;%p&gt;) and <a class="code" href="struct_o_c_i___interval.html" title="Oracle internal interval representation.">OCI_Interval</a>(&lt;%v&gt;)

    * Public interface (IMPORTANT CHANGES)

      - OCI_Initialize() :

        * New flag : OCI_ENV_THREADED
        * Up to v2.2.0, OCILIB was internally initializing OCI in threaded mode (even for non threaded applications)
        * With  v2.3.0, applications HAVE TO SET EXPLICITLY the flag OCI_ENV_THREADED for multithreaded applications

      - Normalization of few Function Names :

        * OCI_CreateConnection() -&gt; <a class="code" href="group__g__connect.html#gdb6e2cdf759587dd81c2fda7c5f44338" title="Create a physical connection to an Oracle database server.">OCI_ConnectionCreate</a>()
        * OCI_FreeConnection() -&gt; <a class="code" href="group__g__connect.html#gc3fe655e96074adb119908be4650a4c9" title="Close a physical connection to an Oracle database server.">OCI_ConnectionFree</a>()
        * OCI_CreateStatement() -&gt; <a class="code" href="group__g__exec.html#g335822f983af0fb5c529431f06a9a17b" title="Create a statement object and return its handle.">OCI_StatementCreate</a>()
        * OCI_FreeStatement() -&gt; <a class="code" href="group__g__exec.html#g487b4f90f1fd4aee18f3d901f5aed104" title="Free a statement and all resources associated to it (resultsets, ....).">OCI_StatementFree</a>()

      - Added Macro for existing code compatibility

    * Bug fixes :

      - OCILIB_MINOR_VERSION was not updated
      - A segmentation fault could happen when fetching Long column
      - If an <a class="code" href="struct_o_c_i___statement.html" title="Oracle SQL or PL/SQL statement.">OCI_Statement</a> <span class="keywordtype">object</span> or its internal handle couldn't be allocated, the entry was not removed from the connection statements list
      - Binding and