php-doc-en/reference/cubrid/functions/cubrid-bind.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->

<refentry xml:id="function.cubrid-bind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>cubrid_bind</refname>
  <refpurpose>Is used to bind values</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>int</type><methodname>cubrid_bind</methodname>
   <methodparam><type>resource</type><parameter>req_identifier</parameter></methodparam>
   <methodparam><type>int</type><parameter>bind_index</parameter></methodparam>
   <methodparam><type>string</type><parameter>bind_value</parameter></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>bind_value_type</parameter></methodparam>
  </methodsynopsis>
  <para>
    The <function>cubrid_bind</function> function is used to bind values in a <function>cubrid_prepare</function> variable, a various types in PHP and corresponding types in SQL. If bind_value_type is not given, string will be the default.
  </para>
  <note>
  <para>
				Collection type (set, multiset or sequence) value can't be bind now.
  </para>
  </note>
  <note>
   <para>
    Known issue: If column data type is CLOB, binding parameter will fail. This bug will fixed later, better use BLOB now.
   </para>
  </note>
 </refsect1>

 <refsect1 role="parameters">
 &reftitle.parameters;
 <para>
  <variablelist>
    <varlistentry>
  <term><parameter>req_identifier</parameter></term>
  <listitem><para>Request identifier as a result of <function>cubrid_prepare</function>.</para></listitem>
   </varlistentry>
   <varlistentry>
  <term><parameter>bind_index</parameter></term>
  <listitem><para>Index for binding.</para></listitem>
   </varlistentry>
   <varlistentry>
  <term><parameter>bind_value</parameter></term>
  <listitem><para>Actual value for binding.</para></listitem>
   </varlistentry>
   <varlistentry>
  <term><parameter>bind_index</parameter></term>
  <listitem><para>A type of the value to bind. (It is omitted by default. Thus, system internally use string by default. However, you need to specify the exact type of the value as an argument when they are NCHAR, BIT, or BLOB/CLOB).</para></listitem>
   </varlistentry>
  </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
    &true;, when process is successful.
  </para>
  <para>
    &false;, when process is unsuccessful.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>8.3.1</entry>
       <entry>
        Added BLOB/CLOB data types support.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <example>
   <title><function>cubrid_bind</function> example</title>
   <programlisting role="php">
<![CDATA[
<?php
$con = cubrid_connect("dbsvr.cubrid.com", 12345, "demodb");
if ($con) {
    $sql = "insert into tbl values (?,?,?)"; 
    $req = cubrid_prepare($con, $sql, CUBRID_INCLUDE_OID); 

    $i = 0;
    while ($i < 2) { 
        $res = cubrid_bind($req, 1, "1", "NUMBER"); 
        $res = cubrid_bind($req, 2, "2"); 
        $res = cubrid_bind($req, 3, "04:22:34 PM 08/07/2007"); 
        $res = cubrid_execute( $req );  
        $i = $i + 1; 
    }
} 
?>
]]>
   </programlisting>
  </example>

  <example>
   <title><function>cubrid_bind</function> BLOB/CLOB example</title>
   <programlisting role="php">
<![CDATA[
<?php
$con = cubrid_connect ("localhost", 33000, "foo");
if ($con) {
    $sql = "INSERT INTO php_cubrid_lob_test(doc_content) VALUES(?)"; 
    $req = cubrid_prepare($con, $sql); 

    $fp = fopen("book.txt", "rb");

    cubrid_bind($req, 1, $fp, "blob"); 
    cubrid_execute($req);  
}
?>
]]>
   </programlisting>
  </example>
 </refsect1>

  <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>cubrid_execute</function></member>
    <member><function>cubrid_prepare</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->