95 lines
6.0 KiB
HTML
95 lines
6.0 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
|||
|
|
<!DOCTYPE html
|
|||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|||
|
|
<html lang="en-us" xml:lang="en-us">
|
|||
|
|
<head>
|
|||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|||
|
|
<meta name="security" content="public" />
|
|||
|
|
<meta name="Robots" content="index,follow" />
|
|||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|||
|
|
<meta name="DC.Type" content="reference" />
|
|||
|
|
<meta name="DC.Title" content="Binary host variables in C and C++ applications that use SQL" />
|
|||
|
|
<meta name="abstract" content="C and C++ do not have variables that correspond to the SQL binary data types. To create host variables that can be used with these data types, use the SQL TYPE IS clause. The SQL precompiler replaces this declaration with a C language structure in the output source member." />
|
|||
|
|
<meta name="description" content="C and C++ do not have variables that correspond to the SQL binary data types. To create host variables that can be used with these data types, use the SQL TYPE IS clause. The SQL precompiler replaces this declaration with a C language structure in the output source member." />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rzajpdeclaringhostc.htm" />
|
|||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|||
|
|
<meta name="DC.Format" content="XHTML" />
|
|||
|
|
<meta name="DC.Identifier" content="rzajpcisbinary" />
|
|||
|
|
<meta name="DC.Language" content="en-us" />
|
|||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|||
|
|
<!-- US Government Users Restricted Rights -->
|
|||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|||
|
|
<title>Binary host variables in C and C++ applications that use SQL</title>
|
|||
|
|
</head>
|
|||
|
|
<body id="rzajpcisbinary"><a name="rzajpcisbinary"><!-- --></a>
|
|||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|||
|
|
<h1 class="topictitle1">Binary host variables in C and C++ applications that use SQL</h1>
|
|||
|
|
<div><p>C and C++ do not have variables that correspond to the SQL binary
|
|||
|
|
data types. To create host variables that can be used with these data types,
|
|||
|
|
use the SQL TYPE IS clause. The SQL precompiler replaces this declaration
|
|||
|
|
with a C language structure in the output source member.</p>
|
|||
|
|
<div class="section"><h4 class="sectiontitle">BINARY</h4><pre><span><img src="./c.gif" border="0" alt="Read syntax diagram" longdesc="rzajpcisbinarysyn1.htm" /></span><a href="#d0e15"><img src="./c.gif" border="0" alt="Skip visual syntax diagram" /></a>
|
|||
|
|
>>-+--------+--+----------+--SQL TYPE IS--BINARY--<i>(length)</i>------>
|
|||
|
|
+-auto---+ +-const----+
|
|||
|
|
+-extern-+ '-volatile-'
|
|||
|
|
'-static-'
|
|||
|
|
|
|||
|
|
.-,---------------------------------.
|
|||
|
|
V |
|
|||
|
|
>----<i>variable-name</i>--+----------------+-+-- ; ------------------><
|
|||
|
|
'- = --<i>init-data</i>-'
|
|||
|
|
|
|||
|
|
</pre><a name="d0e15"></a></div>
|
|||
|
|
<div class="section"><h4 class="sectiontitle">VARBINARY</h4><pre><span><img src="./c.gif" border="0" alt="Read syntax diagram" longdesc="rzajpcisbinarysyn2.htm" /></span><a href="#d0e54"><img src="./c.gif" border="0" alt="Skip visual syntax diagram" /></a>
|
|||
|
|
>>-+--------+--+----------+--SQL TYPE IS--+-VARBINARY------+---->
|
|||
|
|
+-auto---+ +-const----+ '-BINARY VARYING-'
|
|||
|
|
+-extern-+ '-volatile-'
|
|||
|
|
'-static-'
|
|||
|
|
|
|||
|
|
>--<i>(length)</i>----------------------------------------------------->
|
|||
|
|
|
|||
|
|
.-,-------------------------------------------------------.
|
|||
|
|
V |
|
|||
|
|
>----<i>variable-name</i>--+--------------------------------------+-+-->
|
|||
|
|
+- = --{--<i>init-len,"init-data"</i>--}------+
|
|||
|
|
'- = --<i>SQL_VARBINARY_INIT("init-data")</i>-'
|
|||
|
|
|
|||
|
|
>-- ; ---------------------------------------------------------><
|
|||
|
|
|
|||
|
|
</pre><a name="d0e54"></a></div>
|
|||
|
|
<div class="section"> <div class="note"><span class="notetitle">Note:</span> <ol><li>For BINARY host variables, the length must be in the range 1 to 32766.</li>
|
|||
|
|
<li>For VARBINARY and BINARY VARYING host variables, the length must in the
|
|||
|
|
range 1 to 32740.</li>
|
|||
|
|
<li>SQL TYPE IS, BINARY, VARBINARY, and BINARY VARYING can be in mixed case.</li>
|
|||
|
|
</ol>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
<div class="section"><h4 class="sectiontitle"><em>BINARY Example</em></h4><p>The following declaration: </p>
|
|||
|
|
<pre>SQL TYPE IS BINARY(4) myBinField;</pre>
|
|||
|
|
</div>
|
|||
|
|
<div class="section"><p>Results in the generation of the following code: </p>
|
|||
|
|
<pre>unsigned char myBinField[4];</pre>
|
|||
|
|
</div>
|
|||
|
|
<div class="section"><h4 class="sectiontitle"><em>VARBINARY Example</em></h4><p>The following
|
|||
|
|
declaration: </p>
|
|||
|
|
<pre>SQL TYPE IS VARBINARY(12) myVarBinField;</pre>
|
|||
|
|
</div>
|
|||
|
|
<div class="section"><p>Results in the generation of the following structure: </p>
|
|||
|
|
<pre>_Packed struct myVarBinField_t {
|
|||
|
|
short length;
|
|||
|
|
char data[12]; }
|
|||
|
|
myVarBinField;</pre>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
<div>
|
|||
|
|
<div class="familylinks">
|
|||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzajpdeclaringhostc.htm" title="The C and C++ precompilers recognize only a subset of valid C and C++ declarations as valid host variable declarations.">Declare host variables in C and C++ applications that use SQL</a></div>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
</body>
|
|||
|
|
</html>
|