group__g__lob.html

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

          <td class="paramtype">unsigned int&nbsp;</td>
          <td class="paramname"> <em>mode</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Open explicitly a Lob. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>lob</em>&nbsp;</td><td>- Lob handle </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>- open mode</td></tr>
  </table>
</dl>
Possible values for mode are :<p>
<ul>
<li>OCI_LOB_READONLY : read onluy access</li><li>OCI_LOB_READWRITE : read/write access</li></ul>
<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd><ul>
<li>A call to OCI_LobOpen is not necessary to manipulate a Lob.</li><li>If a lob hasn't been opened explicitly, triggers are fired and indexes updated at every read/write/append operation</li></ul>
</dd></dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>TRUE on success otherwise FALSE </dd></dl>

<p>Definition at line <a class="el" href="lob_8c-source.html#l00818">818</a> of file <a class="el" href="lob_8c-source.html">lob.c</a>.</p>

<p>References <a class="el" href="ocilib__types_8h-source.html#l00405">OCI_Lob::con</a>, <a class="el" href="ocilib__types_8h-source.html#l00237">OCI_Connection::cxt</a>, <a class="el" href="ocilib__types_8h-source.html#l00235">OCI_Connection::err</a>, and <a class="el" href="ocilib__types_8h-source.html#l00403">OCI_Lob::handle</a>.</p>

</div>
</div><p>
<a class="anchor" name="g36708313dc7d5c0b2c30f7f8b9fa2e2d"></a><!-- doxytag: member="ocilib.h::OCI_LobRead" ref="g36708313dc7d5c0b2c30f7f8b9fa2e2d" args="(OCI_Lob *lob, void *buffer, unsigned int len)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">OCI_EXPORT unsigned int OCI_API OCI_LobRead           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="struct_o_c_i___lob.html">OCI_Lob</a> *&nbsp;</td>
          <td class="paramname"> <em>lob</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>buffer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">unsigned int&nbsp;</td>
          <td class="paramname"> <em>len</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Read a portion of a lob into the given buffer. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>lob</em>&nbsp;</td><td>- Lob handle </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>buffer</em>&nbsp;</td><td>- Pointer to a buffer </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>- Length of the buffer (in bytes or characters)</td></tr>
  </table>
</dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Length is expressed in :<ul>
<li>Bytes for BLOBs</li><li>Characters for CLOBs/NCLOBS</li></ul>
</dd></dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Number of bytes/characters read on success otherwise 0 on failure </dd></dl>

<p>Definition at line <a class="el" href="lob_8c-source.html#l00246">246</a> of file <a class="el" href="lob_8c-source.html">lob.c</a>.</p>

<p>References <a class="el" href="ocilib__types_8h-source.html#l00405">OCI_Lob::con</a>, <a class="el" href="ocilib__types_8h-source.html#l00237">OCI_Connection::cxt</a>, <a class="el" href="ocilib__types_8h-source.html#l00235">OCI_Connection::err</a>, <a class="el" href="ocilib__types_8h-source.html#l00403">OCI_Lob::handle</a>, <a class="el" href="ocilib__types_8h-source.html#l00407">OCI_Lob::offset</a>, and <a class="el" href="ocilib__types_8h-source.html#l00406">OCI_Lob::type</a>.</p>

<p>Referenced by <a class="el" href="group__g__fetch.html#g755a9b07c174feacd05c86e0e44b0ab0">OCI_GetString()</a>.</p>

</div>
</div><p>
<a class="anchor" name="g63df7f944c418642fc04571a4a522b87"></a><!-- doxytag: member="ocilib.h::OCI_LobSeek" ref="g63df7f944c418642fc04571a4a522b87" args="(OCI_Lob *lob, big_uint offset, unsigned int mode)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">OCI_EXPORT boolean OCI_API OCI_LobSeek           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="struct_o_c_i___lob.html">OCI_Lob</a> *&nbsp;</td>
          <td class="paramname"> <em>lob</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">big_uint&nbsp;</td>
          <td class="paramname"> <em>offset</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">unsigned int&nbsp;</td>
          <td class="paramname"> <em>mode</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Perfom a seek operation on the OCI_lob content buffer. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>lob</em>&nbsp;</td><td>- Lob handle </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>offset</em>&nbsp;</td><td>- Offset from current position (bytes or characters) </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>- Seek mode</td></tr>
  </table>
</dl>
Parameter 'mode' can be one of the following value :<p>
<ul>
<li>OCI_SEEK_SET : set the lob current offset to the given absolute offset</li><li>OCI_SEEK_END : set the lob current offset to the end of the lob</li><li>OCI_SEEK_CUR : move the lob current offset to the number of bytes or characters given by parameter 'offset'</li></ul>
<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd><ul>
<li>For CLOB and CLOB, offset in in characters</li><li>For BLOB and BFILE, offset is in bytes</li></ul>
<p>
Position in the Lob buffer starts at 0.</dd></dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>TRUE on success otherwise FALSE </dd></dl>

<p>Definition at line <a class="el" href="lob_8c-source.html#l00204">204</a> of file <a class="el" href="lob_8c-source.html">lob.c</a>.</p>

<p>References <a class="el" href="group__g__lob.html#g1fed642e2fdc4b72724340e27e13153e">OCI_LobGetLength()</a>, and <a class="el" href="ocilib__types_8h-source.html#l00407">OCI_Lob::offset</a>.</p>

<p>Referenced by <a class="el" href="group__g__fetch.html#g755a9b07c174feacd05c86e0e44b0ab0">OCI_GetString()</a>, and <a class="el" href="group__g__lob.html#g7bfac772587753b2cef9c5a704ae7ce9">OCI_LobAppend()</a>.</p>

</div>
</div><p>
<a class="anchor" name="g75a8049251e51665b3103789573a3a3b"></a><!-- doxytag: member="ocilib.h::OCI_LobTruncate" ref="g75a8049251e51665b3103789573a3a3b" args="(OCI_Lob *lob, big_uint size)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">OCI_EXPORT boolean OCI_API OCI_LobTruncate           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="struct_o_c_i___lob.html">OCI_Lob</a> *&nbsp;</td>
          <td class="paramname"> <em>lob</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">big_uint&nbsp;</td>
          <td class="paramname"> <em>size</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Truncate the given lob to a shorter length. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>lob</em>&nbsp;</td><td>- Lob handle </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>size</em>&nbsp;</td><td>- New lenght (in bytes or characters)</td></tr>
  </table>
</dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Length is expressed in :<ul>
<li>Bytes for BLOBs</li><li>Characters for CLOBs/NCLOBs</li></ul>
</dd></dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>TRUE on success otherwise FALSE </dd></dl>

<p>Definition at line <a class="el" href="lob_8c-source.html#l00427">427</a> of file <a class="el" href="lob_8c-source.html">lob.c</a>.</p>

<p>References <a class="el" href="ocilib__types_8h-source.html#l00405">OCI_Lob::con</a>, <a class="el" href="ocilib__types_8h-source.html#l00237">OCI_Connection::cxt</a>, <a class="el" href="ocilib__types_8h-source.html#l00235">OCI_Connection::err</a>, and <a class="el" href="ocilib__types_8h-source.html#l00403">OCI_Lob::handle</a>.</p>

</div>
</div><p>
<a class="anchor" name="g949f7050609430486c9ef0f3c488d38a"></a><!-- doxytag: member="ocilib.h::OCI_LobWrite" ref="g949f7050609430486c9ef0f3c488d38a" args="(OCI_Lob *lob, void *buffer, unsigned int len)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">OCI_EXPORT unsigned int OCI_API OCI_LobWrite           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="struct_o_c_i___lob.html">OCI_Lob</a> *&nbsp;</td>
          <td class="paramname"> <em>lob</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>buffer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">unsigned int&nbsp;</td>
          <td class="paramname"> <em>len</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Write a buffer into a LOB. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>lob</em>&nbsp;</td><td>- Lob handle </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>buffer</em>&nbsp;</td><td>- Pointer to a buffer </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>len</em>&nbsp;</td><td>- Length of the buffer (in bytes or characters)</td></tr>
  </table>
</dl>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Length is expressed in :<ul>
<li>Bytes for BLOBs</li><li>Characters for CLOBs/NCLOBs</li></ul>
</dd></dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Number of bytes / characters written on success otherwise 0 on failure </dd></dl>

<p>Definition at line <a class="el" href="lob_8c-source.html#l00335">335</a> of file <a class="el" href="lob_8c-source.html">lob.c</a>.</p>

<p>References <a class="el" href="ocilib__types_8h-source.html#l00405">OCI_Lob::con</a>, <a class="el" href="ocilib__types_8h-source.html#l00237">OCI_Connection::cxt</a>, <a class="el" href="ocilib__types_8h-source.html#l00235">OCI_Connection::err</a>, <a class="el" href="ocilib__types_8h-source.html#l00403">OCI_Lob::handle</a>, <a class="el" href="ocilib__types_8h-source.html#l00407">OCI_Lob::offset</a>, and <a class="el" href="ocilib__types_8h-source.html#l00406">OCI_Lob::type</a>.</p>

<p>Referenced by <a class="el" href="group__g__lob.html#g7bfac772587753b2cef9c5a704ae7ce9">OCI_LobAppend()</a>.</p>

</div>
</div><p>
<hr size="1"><address style="text-align: right;"><small>Generated on Thu Oct 9 10:07:47 2008 for OCILIB (C Driver for Oracle) by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.4 </small></address>
</body>
</html>