<HTML ><HEAD ><TITLE >odbc_binmode</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="Unified ODBC functions" HREF="ref.odbc.html"><LINK REL="PREVIOUS" TITLE="odbc_autocommit" HREF="function.odbc-autocommit.html"><LINK REL="NEXT" TITLE="odbc_close_all" HREF="function.odbc-close-all.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.odbc-autocommit.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.odbc-close-all.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.odbc-binmode" ></A >odbc_binmode</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN64686" ></A ><P > (PHP 3>= 3.0.6, PHP 4 )</P >odbc_binmode -- Handling of binary column data</DIV ><DIV CLASS="refsect1" ><A NAME="AEN64689" ></A ><H2 >Description</H2 >int <B CLASS="methodname" >odbc_binmode</B > ( resource result_id, int mode)<BR ></BR ><P > (ODBC SQL types affected: BINARY, VARBINARY, LONGVARBINARY) </P ><P ></P ><UL ><LI ><P > ODBC_BINMODE_PASSTHRU: Passthru BINARY data </P ></LI ><LI ><P > ODBC_BINMODE_RETURN: Return as is </P ></LI ><LI ><P > ODBC_BINMODE_CONVERT: Convert to char and return </P ></LI ></UL ><P > When binary SQL data is converted to character C data, each byte (8 bits) of source data is represented as two ASCII characters. These characters are the ASCII character representation of the number in its hexadecimal form. For example, a binary 00000001 is converted to <TT CLASS="literal" >"01"</TT > and a binary 11111111 is converted to <TT CLASS="literal" >"FF"</TT >. <DIV CLASS="table" ><A NAME="AEN64711" ></A ><P ><B >Table 1. LONGVARBINARY handling</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH ALIGN="LEFT" VALIGN="MIDDLE" >binmode</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >longreadlen</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >result</TH ></TR ></THEAD ><TBODY ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ODBC_BINMODE_PASSTHRU</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >0</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >passthru</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ODBC_BINMODE_RETURN</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >0</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >passthru</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ODBC_BINMODE_CONVERT</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >0</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >passthru</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ODBC_BINMODE_PASSTHRU</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >0</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >passthru</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ODBC_BINMODE_PASSTHRU</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >>0</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >passthru</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ODBC_BINMODE_RETURN</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >>0</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >return as is</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ODBC_BINMODE_CONVERT</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >>0</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >return as char</TD ></TR ></TBODY ></TABLE ></DIV > </P ><P > If <A HREF="function.odbc-fetch-into.html" ><B CLASS="function" >odbc_fetch_into()</B ></A > is used, passthru means that an empty string is returned for these columns. </P ><P > If <TT CLASS="parameter" ><I >result_id</I ></TT > is <TT CLASS="literal" >0</TT >, the settings apply as default for new results. <DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Note: </B > Default for longreadlen is <TT CLASS="literal" >4096</TT > and binmode defaults to <TT CLASS="literal" >ODBC_BINMODE_RETURN</TT >. Handling of binary long columns is also affected by <A HREF="function.odbc-longreadlen.html" ><B CLASS="function" >odbc_longreadlen()</B ></A > </P ></BLOCKQUOTE ></DIV > </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.odbc-autocommit.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.odbc-close-all.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >odbc_autocommit</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.odbc.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >odbc_close_all</TD ></TR ></TABLE ></DIV ></BODY ></HTML >