<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.12"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>FreeTDS API: Primary functions</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">FreeTDS API
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.12 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
</div><!-- top -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="summary">
<a href="#define-members">Macros</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Primary functions<div class="ingroups"><a class="el" href="a00517.html">The db-lib API</a></div></div> </div>
</div><!--header-->
<div class="contents">
<p>Core functions needed by most db-lib programs.
<a href="#details">More...</a></p>
<div class="dynheader">
Collaboration diagram for Primary functions:</div>
<div class="dyncontent">
<center><table><tr><td><div class="center"><iframe scrolling="no" frameborder="0" src="a00518.svg" width="299" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</td></tr></table></center>
</div>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:ga8b263669ce0312e52b5ea42a57a56838"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga8b263669ce0312e52b5ea42a57a56838">DBCMDROW</a>(x)   <a class="el" href="a00524.html#ga196f6d67de47f34a32fcc2103ab0f416">dbcmdrow</a>((x))</td></tr>
<tr class="memdesc:ga8b263669ce0312e52b5ea42a57a56838"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#ga8b263669ce0312e52b5ea42a57a56838">More...</a><br /></td></tr>
<tr class="separator:ga8b263669ce0312e52b5ea42a57a56838"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0ac1828f731a21c591c8d6330cbba3a9"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga0ac1828f731a21c591c8d6330cbba3a9">DBCOUNT</a>(x)   <a class="el" href="a00518.html#ga9433bc200c0978569964354451d9b64e">dbcount</a>((x))</td></tr>
<tr class="memdesc:ga0ac1828f731a21c591c8d6330cbba3a9"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#ga0ac1828f731a21c591c8d6330cbba3a9">More...</a><br /></td></tr>
<tr class="separator:ga0ac1828f731a21c591c8d6330cbba3a9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae375344b1ec50c1f756e3b69f3cef715"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gae375344b1ec50c1f756e3b69f3cef715">DBCURCMD</a>(x)   <a class="el" href="a00524.html#ga01e7fb38bece3bb07526532fa6be50e5">dbcurcmd</a>((x))</td></tr>
<tr class="memdesc:gae375344b1ec50c1f756e3b69f3cef715"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#gae375344b1ec50c1f756e3b69f3cef715">More...</a><br /></td></tr>
<tr class="separator:gae375344b1ec50c1f756e3b69f3cef715"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf49e4b58918bfa4d4adaa14ee5bb375c"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaf49e4b58918bfa4d4adaa14ee5bb375c">DBCURROW</a>(x)   <a class="el" href="a00524.html#ga9e23a95d84192b4fc83db7544d772d16">dbcurrow</a>((x))</td></tr>
<tr class="memdesc:gaf49e4b58918bfa4d4adaa14ee5bb375c"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#gaf49e4b58918bfa4d4adaa14ee5bb375c">More...</a><br /></td></tr>
<tr class="separator:gaf49e4b58918bfa4d4adaa14ee5bb375c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2c7b5eec4843ea326b21f2db2ded2754"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga2c7b5eec4843ea326b21f2db2ded2754">DBDEAD</a>(x)   <a class="el" href="a00524.html#gaed43cb21ed54dc1a6340075d6290e4b0">dbdead</a>((x))</td></tr>
<tr class="memdesc:ga2c7b5eec4843ea326b21f2db2ded2754"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#ga2c7b5eec4843ea326b21f2db2ded2754">More...</a><br /></td></tr>
<tr class="separator:ga2c7b5eec4843ea326b21f2db2ded2754"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga97a6493786124215ec9fe4b4bd2d7cbb"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga97a6493786124215ec9fe4b4bd2d7cbb">DBFIRSTROW</a>(x)   <a class="el" href="a00524.html#gaf40b925f3b3ba43804720dd4ae584935">dbfirstrow</a>((x))</td></tr>
<tr class="memdesc:ga97a6493786124215ec9fe4b4bd2d7cbb"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#ga97a6493786124215ec9fe4b4bd2d7cbb">More...</a><br /></td></tr>
<tr class="separator:ga97a6493786124215ec9fe4b4bd2d7cbb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga74ac942f9b7baa49e1d7d18628321297"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga74ac942f9b7baa49e1d7d18628321297">DBIORDESC</a>(x)   <a class="el" href="a00524.html#gab842baac0ec420b265d8c199cc45059d">dbiordesc</a>((x))</td></tr>
<tr class="memdesc:ga74ac942f9b7baa49e1d7d18628321297"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro, maps to the internal (lower-case) function. <a href="#ga74ac942f9b7baa49e1d7d18628321297">More...</a><br /></td></tr>
<tr class="separator:ga74ac942f9b7baa49e1d7d18628321297"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5afb13924cda059d30be36a70dcf2cd9"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga5afb13924cda059d30be36a70dcf2cd9">DBIOWDESC</a>(x)   <a class="el" href="a00524.html#ga666a4d0609ee7f241deb0a62893d2cfa">dbiowdesc</a>((x))</td></tr>
<tr class="memdesc:ga5afb13924cda059d30be36a70dcf2cd9"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro, maps to the internal (lower-case) function. <a href="#ga5afb13924cda059d30be36a70dcf2cd9">More...</a><br /></td></tr>
<tr class="separator:ga5afb13924cda059d30be36a70dcf2cd9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga40f6c951a851744e58ee715c652a8ac8"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga40f6c951a851744e58ee715c652a8ac8">DBISAVAIL</a>(x)   dbisavail((x))</td></tr>
<tr class="memdesc:ga40f6c951a851744e58ee715c652a8ac8"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#ga40f6c951a851744e58ee715c652a8ac8">More...</a><br /></td></tr>
<tr class="separator:ga40f6c951a851744e58ee715c652a8ac8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga10b9b26cf9a901146e9675a9e678632b"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga10b9b26cf9a901146e9675a9e678632b">DBLASTROW</a>(x)   <a class="el" href="a00524.html#ga13ead146339b43b3a4d9049eb124ef4b">dblastrow</a>((x))</td></tr>
<tr class="memdesc:ga10b9b26cf9a901146e9675a9e678632b"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#ga10b9b26cf9a901146e9675a9e678632b">More...</a><br /></td></tr>
<tr class="separator:ga10b9b26cf9a901146e9675a9e678632b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad887bdce8cb0d3b8c6aaf659eb477b48"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gad887bdce8cb0d3b8c6aaf659eb477b48">DBMORECMDS</a>(x)   <a class="el" href="a00518.html#gac3ba9f53cc77e4dde8f48335ed94ac19">dbmorecmds</a>((x))</td></tr>
<tr class="memdesc:gad887bdce8cb0d3b8c6aaf659eb477b48"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#gad887bdce8cb0d3b8c6aaf659eb477b48">More...</a><br /></td></tr>
<tr class="separator:gad887bdce8cb0d3b8c6aaf659eb477b48"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga48d71b32c26703c810191ef916c5448c"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga48d71b32c26703c810191ef916c5448c">DBROWS</a>(x)   <a class="el" href="a00524.html#ga4be2ab59dc7161d6b93c17202e7ae9b1">dbrows</a>((x))</td></tr>
<tr class="memdesc:ga48d71b32c26703c810191ef916c5448c"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#ga48d71b32c26703c810191ef916c5448c">More...</a><br /></td></tr>
<tr class="separator:ga48d71b32c26703c810191ef916c5448c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6fda3f4982dda5825d13fee392e89fd9"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga6fda3f4982dda5825d13fee392e89fd9">DBROWTYPE</a>(x)   <a class="el" href="a00524.html#gaa2dc8c062342f76adffe53ee280b7fb4">dbrowtype</a>((x))</td></tr>
<tr class="memdesc:ga6fda3f4982dda5825d13fee392e89fd9"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro mapping to the Microsoft (lower-case) function. <a href="#ga6fda3f4982dda5825d13fee392e89fd9">More...</a><br /></td></tr>
<tr class="separator:ga6fda3f4982dda5825d13fee392e89fd9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga316c0fd24b8dc1259ce9eb4d25016400"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga316c0fd24b8dc1259ce9eb4d25016400">DBSETLCHARSET</a>(x, y)   <a class="el" href="a00524.html#gae1fc46447c4f8a9ff7f66607b8cd23b6">dbsetlname</a>((x), (y), DBSETCHARSET)</td></tr>
<tr class="memdesc:ga316c0fd24b8dc1259ce9eb4d25016400"><td class="mdescLeft"> </td><td class="mdescRight">Set the client character set in the login packet. <a href="#ga316c0fd24b8dc1259ce9eb4d25016400">More...</a><br /></td></tr>
<tr class="separator:ga316c0fd24b8dc1259ce9eb4d25016400"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac51e3075197963557a8d2a37d82df921"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gac51e3075197963557a8d2a37d82df921">DBSETLENCRYPT</a>(x, y)   <a class="el" href="a00524.html#ga03e850369aca6fba074da5e9da4effd7">dbsetlbool</a>((x), (y), DBSETENCRYPT)</td></tr>
<tr class="memdesc:gac51e3075197963557a8d2a37d82df921"><td class="mdescLeft"> </td><td class="mdescRight">Enable (or not) network password encryption for Sybase servers version 10.0 or above. <a href="#gac51e3075197963557a8d2a37d82df921">More...</a><br /></td></tr>
<tr class="separator:gac51e3075197963557a8d2a37d82df921"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gadada0e76c811a6fb84ce6759bcf116b5"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gadada0e76c811a6fb84ce6759bcf116b5">DBSETLNATLANG</a>(x, y)   <a class="el" href="a00524.html#gae1fc46447c4f8a9ff7f66607b8cd23b6">dbsetlname</a>((x), (y), DBSETNATLANG)</td></tr>
<tr class="memdesc:gadada0e76c811a6fb84ce6759bcf116b5"><td class="mdescLeft"> </td><td class="mdescRight">Set the language the server should use for messages. <a href="#gadada0e76c811a6fb84ce6759bcf116b5">More...</a><br /></td></tr>
<tr class="separator:gadada0e76c811a6fb84ce6759bcf116b5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga30e0028e6208414c2245e5fcd6740d9d"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga30e0028e6208414c2245e5fcd6740d9d">dbsetlnatlang</a>(x, y)   <a class="el" href="a00524.html#gae1fc46447c4f8a9ff7f66607b8cd23b6">dbsetlname</a>((x), (y), DBSETNATLANG)</td></tr>
<tr class="memdesc:ga30e0028e6208414c2245e5fcd6740d9d"><td class="mdescLeft"> </td><td class="mdescRight">Set the language the server should use for messages. <a href="#ga30e0028e6208414c2245e5fcd6740d9d">More...</a><br /></td></tr>
<tr class="separator:ga30e0028e6208414c2245e5fcd6740d9d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae7e59f9c3cc0ec5916c06977ff7d8565"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gae7e59f9c3cc0ec5916c06977ff7d8565">DBSETLPACKET</a>(x, y)   <a class="el" href="a00524.html#gabdcccf4e0d093ff48c0e7048a4bfaf84">dbsetllong</a>((x), (y), DBSETPACKET)</td></tr>
<tr class="memdesc:gae7e59f9c3cc0ec5916c06977ff7d8565"><td class="mdescLeft"> </td><td class="mdescRight">Set the packet size in the login packet for new connections. <a href="#gae7e59f9c3cc0ec5916c06977ff7d8565">More...</a><br /></td></tr>
<tr class="separator:gae7e59f9c3cc0ec5916c06977ff7d8565"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0d0acc4ce2243e48023e022b50e2ac45"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga0d0acc4ce2243e48023e022b50e2ac45">dbsetlpacket</a>(x, y)   <a class="el" href="a00524.html#gabdcccf4e0d093ff48c0e7048a4bfaf84">dbsetllong</a>((x), (y), DBSETPACKET)</td></tr>
<tr class="memdesc:ga0d0acc4ce2243e48023e022b50e2ac45"><td class="mdescLeft"> </td><td class="mdescRight">Set the packet size in the login packet for new connections. <a href="#ga0d0acc4ce2243e48023e022b50e2ac45">More...</a><br /></td></tr>
<tr class="separator:ga0d0acc4ce2243e48023e022b50e2ac45"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1644cf55d37435711df65c12a3f7b785"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga1644cf55d37435711df65c12a3f7b785">DBTDS</a>(a)   <a class="el" href="a00524.html#ga8d765d810a40dfa01b39995a8e7406f0">dbtds</a>(a)</td></tr>
<tr class="memdesc:ga1644cf55d37435711df65c12a3f7b785"><td class="mdescLeft"> </td><td class="mdescRight">Sybase macro, maps to the internal (lower-case) function. <a href="#ga1644cf55d37435711df65c12a3f7b785">More...</a><br /></td></tr>
<tr class="separator:ga1644cf55d37435711df65c12a3f7b785"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gaf1879b85e8238c015b9648d077665285"><td class="memItemLeft" align="right" valign="top">static RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaf1879b85e8238c015b9648d077665285">_dbresults</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="separator:gaf1879b85e8238c015b9648d077665285"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gabcc14a1ca58b65bc46cce6c81c45218c"><td class="memItemLeft" align="right" valign="top">BYTE * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gabcc14a1ca58b65bc46cce6c81c45218c">dbadata</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid, int column)</td></tr>
<tr class="memdesc:gabcc14a1ca58b65bc46cce6c81c45218c"><td class="mdescLeft"> </td><td class="mdescRight">Get address of compute column data. <a href="#gabcc14a1ca58b65bc46cce6c81c45218c">More...</a><br /></td></tr>
<tr class="separator:gabcc14a1ca58b65bc46cce6c81c45218c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga3340e21db274b272ec11c037cb147222"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga3340e21db274b272ec11c037cb147222">dbadlen</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid, int column)</td></tr>
<tr class="memdesc:ga3340e21db274b272ec11c037cb147222"><td class="mdescLeft"> </td><td class="mdescRight">Get size of data in a compute column. <a href="#ga3340e21db274b272ec11c037cb147222">More...</a><br /></td></tr>
<tr class="separator:ga3340e21db274b272ec11c037cb147222"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gafefd17e15b22adda84366c817178dd7d"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gafefd17e15b22adda84366c817178dd7d">dbaltbind</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid, int column, int vartype, DBINT varlen, BYTE *varaddr)</td></tr>
<tr class="memdesc:gafefd17e15b22adda84366c817178dd7d"><td class="mdescLeft"> </td><td class="mdescRight">Bind a compute column to a program variable. <a href="#gafefd17e15b22adda84366c817178dd7d">More...</a><br /></td></tr>
<tr class="separator:gafefd17e15b22adda84366c817178dd7d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad10c9fd75a86c7a0ac375937df0e90a6"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gad10c9fd75a86c7a0ac375937df0e90a6">dbaltcolid</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid, int column)</td></tr>
<tr class="memdesc:gad10c9fd75a86c7a0ac375937df0e90a6"><td class="mdescLeft"> </td><td class="mdescRight">Get column ID of a compute column. <a href="#gad10c9fd75a86c7a0ac375937df0e90a6">More...</a><br /></td></tr>
<tr class="separator:gad10c9fd75a86c7a0ac375937df0e90a6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9a35c8d3cd0e35c10555baf8f6a01e93"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga9a35c8d3cd0e35c10555baf8f6a01e93">dbaltlen</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid, int column)</td></tr>
<tr class="memdesc:ga9a35c8d3cd0e35c10555baf8f6a01e93"><td class="mdescLeft"> </td><td class="mdescRight">Get size of data in compute column. <a href="#ga9a35c8d3cd0e35c10555baf8f6a01e93">More...</a><br /></td></tr>
<tr class="separator:ga9a35c8d3cd0e35c10555baf8f6a01e93"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga947837a5c8fd99898c043435945b668c"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga947837a5c8fd99898c043435945b668c">dbaltop</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid, int column)</td></tr>
<tr class="memdesc:ga947837a5c8fd99898c043435945b668c"><td class="mdescLeft"> </td><td class="mdescRight">Get aggregation operator for a compute column. <a href="#ga947837a5c8fd99898c043435945b668c">More...</a><br /></td></tr>
<tr class="separator:ga947837a5c8fd99898c043435945b668c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa85171e020dc606f2bd3395ad1d3ab4f"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaa85171e020dc606f2bd3395ad1d3ab4f">dbalttype</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid, int column)</td></tr>
<tr class="memdesc:gaa85171e020dc606f2bd3395ad1d3ab4f"><td class="mdescLeft"> </td><td class="mdescRight">Get datatype for a compute column. <a href="#gaa85171e020dc606f2bd3395ad1d3ab4f">More...</a><br /></td></tr>
<tr class="separator:gaa85171e020dc606f2bd3395ad1d3ab4f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf1c00d83dfa88dc99a3fb449c49660ea"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaf1c00d83dfa88dc99a3fb449c49660ea">dbaltutype</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid, int column)</td></tr>
<tr class="memdesc:gaf1c00d83dfa88dc99a3fb449c49660ea"><td class="mdescLeft"> </td><td class="mdescRight">Get user-defined datatype of a compute column. <a href="#gaf1c00d83dfa88dc99a3fb449c49660ea">More...</a><br /></td></tr>
<tr class="separator:gaf1c00d83dfa88dc99a3fb449c49660ea"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga939c2a2e67b9992c787e2cec5b6cc1a7"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga939c2a2e67b9992c787e2cec5b6cc1a7">dbanullbind</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid, int column, DBINT *indicator)</td></tr>
<tr class="memdesc:ga939c2a2e67b9992c787e2cec5b6cc1a7"><td class="mdescLeft"> </td><td class="mdescRight">Tie a null-indicator to a compute result column. <a href="#ga939c2a2e67b9992c787e2cec5b6cc1a7">More...</a><br /></td></tr>
<tr class="separator:ga939c2a2e67b9992c787e2cec5b6cc1a7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad57aa777300cf7f62077478ec6000d00"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gad57aa777300cf7f62077478ec6000d00">dbanydatecrack</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, <a class="el" href="a01297.html">DBDATEREC2</a> *di, int type, const void *data)</td></tr>
<tr class="memdesc:gad57aa777300cf7f62077478ec6000d00"><td class="mdescLeft"> </td><td class="mdescRight">Break any kind of date or time value into useful pieces. <a href="#gad57aa777300cf7f62077478ec6000d00">More...</a><br /></td></tr>
<tr class="separator:gad57aa777300cf7f62077478ec6000d00"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga873bc0f4663165e711655ade1dfae795"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795">dbbind</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column, int vartype, DBINT varlen, BYTE *varaddr)</td></tr>
<tr class="memdesc:ga873bc0f4663165e711655ade1dfae795"><td class="mdescLeft"> </td><td class="mdescRight">Tie a host variable to a resultset column. <a href="#ga873bc0f4663165e711655ade1dfae795">More...</a><br /></td></tr>
<tr class="separator:ga873bc0f4663165e711655ade1dfae795"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae658a0cd5270f3bd6f22de17b2cb2e64"><td class="memItemLeft" align="right" valign="top">BYTE * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gae658a0cd5270f3bd6f22de17b2cb2e64">dbbylist</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid, int *size)</td></tr>
<tr class="memdesc:gae658a0cd5270f3bd6f22de17b2cb2e64"><td class="mdescLeft"> </td><td class="mdescRight">Get <code>bylist</code> for a compute row. <a href="#gae658a0cd5270f3bd6f22de17b2cb2e64">More...</a><br /></td></tr>
<tr class="separator:gae658a0cd5270f3bd6f22de17b2cb2e64"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5ea23272124fff03b8d87538c1ec3ee5"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga5ea23272124fff03b8d87538c1ec3ee5">dbcancel</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga5ea23272124fff03b8d87538c1ec3ee5"><td class="mdescLeft"> </td><td class="mdescRight">Cancel the current command batch. <a href="#ga5ea23272124fff03b8d87538c1ec3ee5">More...</a><br /></td></tr>
<tr class="separator:ga5ea23272124fff03b8d87538c1ec3ee5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga559e24ba70d0d96c3469eb6ab8f74e05"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga559e24ba70d0d96c3469eb6ab8f74e05">dbcanquery</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga559e24ba70d0d96c3469eb6ab8f74e05"><td class="mdescLeft"> </td><td class="mdescRight">Cancel the query currently being retrieved, discarding all pending rows. <a href="#ga559e24ba70d0d96c3469eb6ab8f74e05">More...</a><br /></td></tr>
<tr class="separator:ga559e24ba70d0d96c3469eb6ab8f74e05"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8cbc761b1266bd947783d843aeeec264"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga8cbc761b1266bd947783d843aeeec264">dbchange</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga8cbc761b1266bd947783d843aeeec264"><td class="mdescLeft"> </td><td class="mdescRight">See if a command caused the current database to change. <a href="#ga8cbc761b1266bd947783d843aeeec264">More...</a><br /></td></tr>
<tr class="separator:ga8cbc761b1266bd947783d843aeeec264"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaef740b394b44eb33925c2718f7b30d69"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaef740b394b44eb33925c2718f7b30d69">dbclose</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gaef740b394b44eb33925c2718f7b30d69"><td class="mdescLeft"> </td><td class="mdescRight">Close a connection to the server and free associated resources. <a href="#gaef740b394b44eb33925c2718f7b30d69">More...</a><br /></td></tr>
<tr class="separator:gaef740b394b44eb33925c2718f7b30d69"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga01404b179a251c249aecfdae72ec6ca4"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga01404b179a251c249aecfdae72ec6ca4">dbclrbuf</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, DBINT n)</td></tr>
<tr class="memdesc:ga01404b179a251c249aecfdae72ec6ca4"><td class="mdescLeft"> </td><td class="mdescRight">Clear <em>n</em> rows from the row buffer. <a href="#ga01404b179a251c249aecfdae72ec6ca4">More...</a><br /></td></tr>
<tr class="separator:ga01404b179a251c249aecfdae72ec6ca4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga93ee3c8ca34a08588f88784898fd69e0"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga93ee3c8ca34a08588f88784898fd69e0">dbclropt</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int option, const char param[])</td></tr>
<tr class="memdesc:ga93ee3c8ca34a08588f88784898fd69e0"><td class="mdescLeft"> </td><td class="mdescRight">Reset an option. <a href="#ga93ee3c8ca34a08588f88784898fd69e0">More...</a><br /></td></tr>
<tr class="separator:ga93ee3c8ca34a08588f88784898fd69e0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga87b39d9863316b4ba85654b0885d53a0"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0">dbcmd</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, const char cmdstring[])</td></tr>
<tr class="memdesc:ga87b39d9863316b4ba85654b0885d53a0"><td class="mdescLeft"> </td><td class="mdescRight"><code>Append</code> SQL to the command buffer. <a href="#ga87b39d9863316b4ba85654b0885d53a0">More...</a><br /></td></tr>
<tr class="separator:ga87b39d9863316b4ba85654b0885d53a0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga89fc5589b4bf41932324d2cfc6ad6433"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga89fc5589b4bf41932324d2cfc6ad6433">dbcollen</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:ga89fc5589b4bf41932324d2cfc6ad6433"><td class="mdescLeft"> </td><td class="mdescRight">Get size of a regular result column. <a href="#ga89fc5589b4bf41932324d2cfc6ad6433">More...</a><br /></td></tr>
<tr class="separator:ga89fc5589b4bf41932324d2cfc6ad6433"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad06f5deddac18604dfa858b2580e232f"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gad06f5deddac18604dfa858b2580e232f">dbcolname</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:gad06f5deddac18604dfa858b2580e232f"><td class="mdescLeft"> </td><td class="mdescRight">Return name of a regular result column. <a href="#gad06f5deddac18604dfa858b2580e232f">More...</a><br /></td></tr>
<tr class="separator:gad06f5deddac18604dfa858b2580e232f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga3a96d0188e5e0eb9eea661b3685fdcc3"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga3a96d0188e5e0eb9eea661b3685fdcc3">dbcolsource</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:ga3a96d0188e5e0eb9eea661b3685fdcc3"><td class="mdescLeft"> </td><td class="mdescRight">Get base database column name for a result set column. <a href="#ga3a96d0188e5e0eb9eea661b3685fdcc3">More...</a><br /></td></tr>
<tr class="separator:ga3a96d0188e5e0eb9eea661b3685fdcc3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga636e6f1b64743f3cf22158a56eef371f"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f">dbcoltype</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:ga636e6f1b64743f3cf22158a56eef371f"><td class="mdescLeft"> </td><td class="mdescRight">Get the datatype of a regular result set column. <a href="#ga636e6f1b64743f3cf22158a56eef371f">More...</a><br /></td></tr>
<tr class="separator:ga636e6f1b64743f3cf22158a56eef371f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga3c33e72c41b40e08dbcfdfa0d16bc399"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a01269.html">DBTYPEINFO</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga3c33e72c41b40e08dbcfdfa0d16bc399">dbcoltypeinfo</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:ga3c33e72c41b40e08dbcfdfa0d16bc399"><td class="mdescLeft"> </td><td class="mdescRight">Get precision and scale information for a regular result column. <a href="#ga3c33e72c41b40e08dbcfdfa0d16bc399">More...</a><br /></td></tr>
<tr class="separator:ga3c33e72c41b40e08dbcfdfa0d16bc399"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab33d2f4fd44f50e55b6c71902db4fdae"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gab33d2f4fd44f50e55b6c71902db4fdae">dbcolutype</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:gab33d2f4fd44f50e55b6c71902db4fdae"><td class="mdescLeft"> </td><td class="mdescRight">Get user-defined datatype of a regular result column. <a href="#gab33d2f4fd44f50e55b6c71902db4fdae">More...</a><br /></td></tr>
<tr class="separator:gab33d2f4fd44f50e55b6c71902db4fdae"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga32eb72f6fb3edb130e59fb3dd0766e7e"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga32eb72f6fb3edb130e59fb3dd0766e7e">dbconvert</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int srctype, const BYTE *src, DBINT srclen, int desttype, BYTE *dest, DBINT destlen)</td></tr>
<tr class="memdesc:ga32eb72f6fb3edb130e59fb3dd0766e7e"><td class="mdescLeft"> </td><td class="mdescRight">cf. <a href="#ga32eb72f6fb3edb130e59fb3dd0766e7e">More...</a><br /></td></tr>
<tr class="separator:ga32eb72f6fb3edb130e59fb3dd0766e7e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8b00d5cdcaa20cba13fa2e03d52a443e"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga8b00d5cdcaa20cba13fa2e03d52a443e">dbconvert_ps</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int db_srctype, const BYTE *src, DBINT srclen, int db_desttype, BYTE *dest, DBINT destlen, <a class="el" href="a01269.html">DBTYPEINFO</a> *typeinfo)</td></tr>
<tr class="memdesc:ga8b00d5cdcaa20cba13fa2e03d52a443e"><td class="mdescLeft"> </td><td class="mdescRight">Convert one datatype to another. <a href="#ga8b00d5cdcaa20cba13fa2e03d52a443e">More...</a><br /></td></tr>
<tr class="separator:ga8b00d5cdcaa20cba13fa2e03d52a443e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9433bc200c0978569964354451d9b64e"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga9433bc200c0978569964354451d9b64e">dbcount</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga9433bc200c0978569964354451d9b64e"><td class="mdescLeft"> </td><td class="mdescRight">Get count of rows processed. <a href="#ga9433bc200c0978569964354451d9b64e">More...</a><br /></td></tr>
<tr class="separator:ga9433bc200c0978569964354451d9b64e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaee60c306a22383805a4b9caa647a1e16"><td class="memItemLeft" align="right" valign="top">BYTE * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16">dbdata</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:gaee60c306a22383805a4b9caa647a1e16"><td class="mdescLeft"> </td><td class="mdescRight">Get address of data in a regular result column. <a href="#gaee60c306a22383805a4b9caa647a1e16">More...</a><br /></td></tr>
<tr class="separator:gaee60c306a22383805a4b9caa647a1e16"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga46f3641b79a2e90371a66950b6db2c4d"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga46f3641b79a2e90371a66950b6db2c4d">dbdatecrack</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, <a class="el" href="a01289.html">DBDATEREC</a> *di, <a class="el" href="a01257.html">DBDATETIME</a> *datetime)</td></tr>
<tr class="memdesc:ga46f3641b79a2e90371a66950b6db2c4d"><td class="mdescLeft"> </td><td class="mdescRight">Break a <a class="el" href="a01257.html">DBDATETIME</a> value into useful pieces. <a href="#ga46f3641b79a2e90371a66950b6db2c4d">More...</a><br /></td></tr>
<tr class="separator:ga46f3641b79a2e90371a66950b6db2c4d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae666d141533126babb0235af21bdca0f"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gae666d141533126babb0235af21bdca0f">dbdatlen</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:gae666d141533126babb0235af21bdca0f"><td class="mdescLeft"> </td><td class="mdescRight">Get size of current row's data in a regular result column. <a href="#gae666d141533126babb0235af21bdca0f">More...</a><br /></td></tr>
<tr class="separator:gae666d141533126babb0235af21bdca0f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab8209543de865f359bdb32829fa8b757"><td class="memItemLeft" align="right" valign="top">EHANDLEFUNC </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gab8209543de865f359bdb32829fa8b757">dberrhandle</a> (EHANDLEFUNC handler)</td></tr>
<tr class="memdesc:gab8209543de865f359bdb32829fa8b757"><td class="mdescLeft"> </td><td class="mdescRight">Set an error handler, for messages from db-lib. <a href="#gab8209543de865f359bdb32829fa8b757">More...</a><br /></td></tr>
<tr class="separator:gab8209543de865f359bdb32829fa8b757"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad0044401c8c83205583f93a4764f2d8b"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gad0044401c8c83205583f93a4764f2d8b">dbexit</a> ()</td></tr>
<tr class="memdesc:gad0044401c8c83205583f93a4764f2d8b"><td class="mdescLeft"> </td><td class="mdescRight">Close server connections and free all related structures. <a href="#gad0044401c8c83205583f93a4764f2d8b">More...</a><br /></td></tr>
<tr class="separator:gad0044401c8c83205583f93a4764f2d8b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga43727b10d4cbb7708b374811abe6eadb"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga43727b10d4cbb7708b374811abe6eadb">dbfcmd</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, const char *fmt,...)</td></tr>
<tr class="memdesc:ga43727b10d4cbb7708b374811abe6eadb"><td class="mdescLeft"> </td><td class="mdescRight"><code>printf-like</code> way to form SQL to send to the server. <a href="#ga43727b10d4cbb7708b374811abe6eadb">More...</a><br /></td></tr>
<tr class="separator:ga43727b10d4cbb7708b374811abe6eadb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0fcfcf6846442dac9dd5584d270ec72a"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga0fcfcf6846442dac9dd5584d270ec72a">dbfreebuf</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga0fcfcf6846442dac9dd5584d270ec72a"><td class="mdescLeft"> </td><td class="mdescRight">Erase the command buffer, in case <code>DBNOAUTOFREE</code> was set with <a class="el" href="a00518.html#ga9d660d278f3f58871b4086c0e175f4c6" title="Set db-lib or server option. ">dbsetopt()</a>. <a href="#ga0fcfcf6846442dac9dd5584d270ec72a">More...</a><br /></td></tr>
<tr class="separator:ga0fcfcf6846442dac9dd5584d270ec72a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf917cf746c954a5d1b718afe3c4d1940"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaf917cf746c954a5d1b718afe3c4d1940">dbgetchar</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int pos)</td></tr>
<tr class="memdesc:gaf917cf746c954a5d1b718afe3c4d1940"><td class="mdescLeft"> </td><td class="mdescRight">Get address of a position in the command buffer. <a href="#gaf917cf746c954a5d1b718afe3c4d1940">More...</a><br /></td></tr>
<tr class="separator:gaf917cf746c954a5d1b718afe3c4d1940"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gadb34c5c2aae50ac9f2a26d8984136997"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gadb34c5c2aae50ac9f2a26d8984136997">dbgetmaxprocs</a> (void)</td></tr>
<tr class="memdesc:gadb34c5c2aae50ac9f2a26d8984136997"><td class="mdescLeft"> </td><td class="mdescRight">get maximum simultaneous connections db-lib will open to the server. <a href="#gadb34c5c2aae50ac9f2a26d8984136997">More...</a><br /></td></tr>
<tr class="separator:gadb34c5c2aae50ac9f2a26d8984136997"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gabaf9aa756f7cb8bbec80d1c7201c6238"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gabaf9aa756f7cb8bbec80d1c7201c6238">dbgetpacket</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gabaf9aa756f7cb8bbec80d1c7201c6238"><td class="mdescLeft"> </td><td class="mdescRight">Get TDS packet size for the connection. <a href="#gabaf9aa756f7cb8bbec80d1c7201c6238">More...</a><br /></td></tr>
<tr class="separator:gabaf9aa756f7cb8bbec80d1c7201c6238"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga60fe544491c760f8bc6c37bc7f777d70"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga60fe544491c760f8bc6c37bc7f777d70">dbgetrow</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, DBINT row)</td></tr>
<tr class="memdesc:ga60fe544491c760f8bc6c37bc7f777d70"><td class="mdescLeft"> </td><td class="mdescRight">Read a row from the row buffer. <a href="#ga60fe544491c760f8bc6c37bc7f777d70">More...</a><br /></td></tr>
<tr class="separator:ga60fe544491c760f8bc6c37bc7f777d70"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6ccffbb3f0cfb10883ad349f1e47c50e"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga6ccffbb3f0cfb10883ad349f1e47c50e">dbgettime</a> (void)</td></tr>
<tr class="memdesc:ga6ccffbb3f0cfb10883ad349f1e47c50e"><td class="mdescLeft"> </td><td class="mdescRight">Get maximum seconds db-lib waits for a server response to query. <a href="#ga6ccffbb3f0cfb10883ad349f1e47c50e">More...</a><br /></td></tr>
<tr class="separator:ga6ccffbb3f0cfb10883ad349f1e47c50e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa5714a91d7c14365fa1e5b164bb2b0b6"><td class="memItemLeft" align="right" valign="top">BYTE * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaa5714a91d7c14365fa1e5b164bb2b0b6">dbgetuserdata</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gaa5714a91d7c14365fa1e5b164bb2b0b6"><td class="mdescLeft"> </td><td class="mdescRight">Get address of user-allocated data from a <code>DBPROCESS</code>. <a href="#gaa5714a91d7c14365fa1e5b164bb2b0b6">More...</a><br /></td></tr>
<tr class="separator:gaa5714a91d7c14365fa1e5b164bb2b0b6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga564dd3a1bb0425a8957f1714d8b2a7c0"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga564dd3a1bb0425a8957f1714d8b2a7c0">dbinit</a> (void)</td></tr>
<tr class="memdesc:ga564dd3a1bb0425a8957f1714d8b2a7c0"><td class="mdescLeft"> </td><td class="mdescRight">Initialize db-lib. <a href="#ga564dd3a1bb0425a8957f1714d8b2a7c0">More...</a><br /></td></tr>
<tr class="separator:ga564dd3a1bb0425a8957f1714d8b2a7c0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6ba2a7f18cb76d24776e45fd71141494"><td class="memItemLeft" align="right" valign="top">BOOL </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga6ba2a7f18cb76d24776e45fd71141494">dbiscount</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga6ba2a7f18cb76d24776e45fd71141494"><td class="mdescLeft"> </td><td class="mdescRight">Indicates whether or not the count returned by dbcount is real (Microsoft-compatibility feature). <a href="#ga6ba2a7f18cb76d24776e45fd71141494">More...</a><br /></td></tr>
<tr class="separator:ga6ba2a7f18cb76d24776e45fd71141494"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac3eb8cb53f50998403ea9aebc6263df9"><td class="memItemLeft" align="right" valign="top">DBBOOL </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gac3eb8cb53f50998403ea9aebc6263df9">dbisopt</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int option, const char param[])</td></tr>
<tr class="memdesc:gac3eb8cb53f50998403ea9aebc6263df9"><td class="mdescLeft"> </td><td class="mdescRight">Get value of an option. <a href="#gac3eb8cb53f50998403ea9aebc6263df9">More...</a><br /></td></tr>
<tr class="separator:gac3eb8cb53f50998403ea9aebc6263df9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0984798bb806f7451a53bffa7e2c430f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a00565.html">LOGINREC</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga0984798bb806f7451a53bffa7e2c430f">dblogin</a> (void)</td></tr>
<tr class="memdesc:ga0984798bb806f7451a53bffa7e2c430f"><td class="mdescLeft"> </td><td class="mdescRight">Allocate a <code><a class="el" href="a00565.html">LOGINREC</a></code> structure. <a href="#ga0984798bb806f7451a53bffa7e2c430f">More...</a><br /></td></tr>
<tr class="separator:ga0984798bb806f7451a53bffa7e2c430f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac1bdb1766b791153f37dceae8ff64ad6"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gac1bdb1766b791153f37dceae8ff64ad6">dbloginfree</a> (<a class="el" href="a00565.html">LOGINREC</a> *login)</td></tr>
<tr class="memdesc:gac1bdb1766b791153f37dceae8ff64ad6"><td class="mdescLeft"> </td><td class="mdescRight">free the <code><a class="el" href="a00565.html">LOGINREC</a></code> <a href="#gac1bdb1766b791153f37dceae8ff64ad6">More...</a><br /></td></tr>
<tr class="separator:gac1bdb1766b791153f37dceae8ff64ad6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac3ba9f53cc77e4dde8f48335ed94ac19"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gac3ba9f53cc77e4dde8f48335ed94ac19">dbmorecmds</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gac3ba9f53cc77e4dde8f48335ed94ac19"><td class="mdescLeft"> </td><td class="mdescRight">See if more commands are to be processed. <a href="#gac3ba9f53cc77e4dde8f48335ed94ac19">More...</a><br /></td></tr>
<tr class="separator:gac3ba9f53cc77e4dde8f48335ed94ac19"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6f13381522a1fa0b6ce2c15378088cdd"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga6f13381522a1fa0b6ce2c15378088cdd">dbmoretext</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, DBINT size, const BYTE text[])</td></tr>
<tr class="memdesc:ga6f13381522a1fa0b6ce2c15378088cdd"><td class="mdescLeft"> </td><td class="mdescRight">Send chunk of a text/image value to the server. <a href="#ga6f13381522a1fa0b6ce2c15378088cdd">More...</a><br /></td></tr>
<tr class="separator:ga6f13381522a1fa0b6ce2c15378088cdd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gadc8af9a65f3719804c2537fd737298ca"><td class="memItemLeft" align="right" valign="top">MHANDLEFUNC </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gadc8af9a65f3719804c2537fd737298ca">dbmsghandle</a> (MHANDLEFUNC handler)</td></tr>
<tr class="memdesc:gadc8af9a65f3719804c2537fd737298ca"><td class="mdescLeft"> </td><td class="mdescRight">Set a message handler, for messages from the server. <a href="#gadc8af9a65f3719804c2537fd737298ca">More...</a><br /></td></tr>
<tr class="separator:gadc8af9a65f3719804c2537fd737298ca"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab185982ffe0b85b8fd19747bd1f433fe"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gab185982ffe0b85b8fd19747bd1f433fe">dbname</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gab185982ffe0b85b8fd19747bd1f433fe"><td class="mdescLeft"> </td><td class="mdescRight">Get name of current database. <a href="#gab185982ffe0b85b8fd19747bd1f433fe">More...</a><br /></td></tr>
<tr class="separator:gab185982ffe0b85b8fd19747bd1f433fe"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga85dcc40c3615f94be96b09b2ec043533"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga85dcc40c3615f94be96b09b2ec043533">dbnullbind</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column, DBINT *indicator)</td></tr>
<tr class="memdesc:ga85dcc40c3615f94be96b09b2ec043533"><td class="mdescLeft"> </td><td class="mdescRight">Tie a null-indicator to a regular result column. <a href="#ga85dcc40c3615f94be96b09b2ec043533">More...</a><br /></td></tr>
<tr class="separator:ga85dcc40c3615f94be96b09b2ec043533"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga67934deac3bebbf8238eff8c0559389a"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga67934deac3bebbf8238eff8c0559389a">dbnumalts</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int computeid)</td></tr>
<tr class="memdesc:ga67934deac3bebbf8238eff8c0559389a"><td class="mdescLeft"> </td><td class="mdescRight">Get count of columns in a compute row. <a href="#ga67934deac3bebbf8238eff8c0559389a">More...</a><br /></td></tr>
<tr class="separator:ga67934deac3bebbf8238eff8c0559389a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gadaa9482a082aa3fe52231e17749c2993"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993">dbnumcols</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gadaa9482a082aa3fe52231e17749c2993"><td class="mdescLeft"> </td><td class="mdescRight">Return number of regular columns in a result set. <a href="#gadaa9482a082aa3fe52231e17749c2993">More...</a><br /></td></tr>
<tr class="separator:gadaa9482a082aa3fe52231e17749c2993"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac554d2cb2da0c9f9fd3d4867998edcc4"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gac554d2cb2da0c9f9fd3d4867998edcc4">dbnumcompute</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gac554d2cb2da0c9f9fd3d4867998edcc4"><td class="mdescLeft"> </td><td class="mdescRight">Get count of <code>COMPUTE</code> clauses for a result set. <a href="#gac554d2cb2da0c9f9fd3d4867998edcc4">More...</a><br /></td></tr>
<tr class="separator:gac554d2cb2da0c9f9fd3d4867998edcc4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac0cb0584f6500d61a2ac95a891da73eb"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gac0cb0584f6500d61a2ac95a891da73eb">dbprcollen</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:gac0cb0584f6500d61a2ac95a891da73eb"><td class="mdescLeft"> </td><td class="mdescRight">Get size of a result column needed to print column. <a href="#gac0cb0584f6500d61a2ac95a891da73eb">More...</a><br /></td></tr>
<tr class="separator:gac0cb0584f6500d61a2ac95a891da73eb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9dfc2ee533e5e48a7aa8ca22f8d9ed79"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga9dfc2ee533e5e48a7aa8ca22f8d9ed79">dbprhead</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga9dfc2ee533e5e48a7aa8ca22f8d9ed79"><td class="mdescLeft"> </td><td class="mdescRight">Print result set headings to stdout. <a href="#ga9dfc2ee533e5e48a7aa8ca22f8d9ed79">More...</a><br /></td></tr>
<tr class="separator:ga9dfc2ee533e5e48a7aa8ca22f8d9ed79"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa30be3414a97aac6139af2e928db91ca"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaa30be3414a97aac6139af2e928db91ca">dbprrow</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gaa30be3414a97aac6139af2e928db91ca"><td class="mdescLeft"> </td><td class="mdescRight">Print a result set to stdout. <a href="#gaa30be3414a97aac6139af2e928db91ca">More...</a><br /></td></tr>
<tr class="separator:gaa30be3414a97aac6139af2e928db91ca"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac25ae21ca19777ffab1c013bd6049ebf"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gac25ae21ca19777ffab1c013bd6049ebf">dbprtype</a> (int token)</td></tr>
<tr class="memdesc:gac25ae21ca19777ffab1c013bd6049ebf"><td class="mdescLeft"> </td><td class="mdescRight">Print a token value's name to a buffer. <a href="#gac25ae21ca19777ffab1c013bd6049ebf">More...</a><br /></td></tr>
<tr class="separator:gac25ae21ca19777ffab1c013bd6049ebf"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gadd5685565c8c6c86079e17b8a73b324c"><td class="memItemLeft" align="right" valign="top">STATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gadd5685565c8c6c86079e17b8a73b324c">dbreadtext</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, void *buf, DBINT bufsize)</td></tr>
<tr class="memdesc:gadd5685565c8c6c86079e17b8a73b324c"><td class="mdescLeft"> </td><td class="mdescRight">Fetch part of a text or image value from the server. <a href="#gadd5685565c8c6c86079e17b8a73b324c">More...</a><br /></td></tr>
<tr class="separator:gadd5685565c8c6c86079e17b8a73b324c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gabb14ad9f268b92a8d63fa506098b24dd"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gabb14ad9f268b92a8d63fa506098b24dd">dbrecftos</a> (const char filename[])</td></tr>
<tr class="memdesc:gabb14ad9f268b92a8d63fa506098b24dd"><td class="mdescLeft"> </td><td class="mdescRight">Record to a file all SQL commands sent to the server. <a href="#gabb14ad9f268b92a8d63fa506098b24dd">More...</a><br /></td></tr>
<tr class="separator:gabb14ad9f268b92a8d63fa506098b24dd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga4e26d949be2c3bf71b1a33c75b11d931"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931">dbresults</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga4e26d949be2c3bf71b1a33c75b11d931"><td class="mdescLeft"> </td><td class="mdescRight">Set up query results. <a href="#ga4e26d949be2c3bf71b1a33c75b11d931">More...</a><br /></td></tr>
<tr class="separator:ga4e26d949be2c3bf71b1a33c75b11d931"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad0ccc03b94ba2515fd1f5d35559fcb41"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gad0ccc03b94ba2515fd1f5d35559fcb41">dbsafestr</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, const char *src, DBINT srclen, char *dest, DBINT destlen, int quotetype)</td></tr>
<tr class="memdesc:gad0ccc03b94ba2515fd1f5d35559fcb41"><td class="mdescLeft"> </td><td class="mdescRight">safely quotes character values in SQL text. <a href="#gad0ccc03b94ba2515fd1f5d35559fcb41">More...</a><br /></td></tr>
<tr class="separator:gad0ccc03b94ba2515fd1f5d35559fcb41"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga39302e8efbb476ba01cff109ffb3661e"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga39302e8efbb476ba01cff109ffb3661e">dbservcharset</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga39302e8efbb476ba01cff109ffb3661e"><td class="mdescLeft"> </td><td class="mdescRight">Get <code>syscharset</code> name of the server character set. <a href="#ga39302e8efbb476ba01cff109ffb3661e">More...</a><br /></td></tr>
<tr class="separator:ga39302e8efbb476ba01cff109ffb3661e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga663350909fec3a1d152316c45a65e708"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga663350909fec3a1d152316c45a65e708">dbsetifile</a> (char *filename)</td></tr>
<tr class="memdesc:ga663350909fec3a1d152316c45a65e708"><td class="mdescLeft"> </td><td class="mdescRight">set name and location of the <code>interfaces</code> file FreeTDS should use to look up a servername. <a href="#ga663350909fec3a1d152316c45a65e708">More...</a><br /></td></tr>
<tr class="separator:ga663350909fec3a1d152316c45a65e708"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga335fcbe476ad0f897e4e2ce377f0a8cc"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga335fcbe476ad0f897e4e2ce377f0a8cc">dbsetinterrupt</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, DB_DBCHKINTR_FUNC chkintr, DB_DBHNDLINTR_FUNC hndlintr)</td></tr>
<tr class="memdesc:ga335fcbe476ad0f897e4e2ce377f0a8cc"><td class="mdescLeft"> </td><td class="mdescRight">Set interrupt handler for db-lib to use while blocked against a read from the server. <a href="#ga335fcbe476ad0f897e4e2ce377f0a8cc">More...</a><br /></td></tr>
<tr class="separator:ga335fcbe476ad0f897e4e2ce377f0a8cc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5f1281c07dde5a6d28e60ef62c501d1d"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga5f1281c07dde5a6d28e60ef62c501d1d">dbsetlogintime</a> (int seconds)</td></tr>
<tr class="memdesc:ga5f1281c07dde5a6d28e60ef62c501d1d"><td class="mdescLeft"> </td><td class="mdescRight">Set maximum seconds db-lib waits for a server response to a login attempt. <a href="#ga5f1281c07dde5a6d28e60ef62c501d1d">More...</a><br /></td></tr>
<tr class="separator:ga5f1281c07dde5a6d28e60ef62c501d1d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa22dce1ee0eb83059699c34c47d07c14"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaa22dce1ee0eb83059699c34c47d07c14">dbsetlversion</a> (<a class="el" href="a00565.html">LOGINREC</a> *login, BYTE version)</td></tr>
<tr class="memdesc:gaa22dce1ee0eb83059699c34c47d07c14"><td class="mdescLeft"> </td><td class="mdescRight">Set TDS version for future connections. <a href="#gaa22dce1ee0eb83059699c34c47d07c14">More...</a><br /></td></tr>
<tr class="separator:gaa22dce1ee0eb83059699c34c47d07c14"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf2ca0e63f800b3839684c894ff651dd4"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaf2ca0e63f800b3839684c894ff651dd4">dbsetmaxprocs</a> (int maxprocs)</td></tr>
<tr class="memdesc:gaf2ca0e63f800b3839684c894ff651dd4"><td class="mdescLeft"> </td><td class="mdescRight">Set maximum simultaneous connections db-lib will open to the server. <a href="#gaf2ca0e63f800b3839684c894ff651dd4">More...</a><br /></td></tr>
<tr class="separator:gaf2ca0e63f800b3839684c894ff651dd4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga399512ec78c15ce3db79ea88ef3b1293"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga399512ec78c15ce3db79ea88ef3b1293">dbsetnull</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int bindtype, int bindlen, BYTE *bindval)</td></tr>
<tr class="memdesc:ga399512ec78c15ce3db79ea88ef3b1293"><td class="mdescLeft"> </td><td class="mdescRight">Define substitution values to be used when binding null values. <a href="#ga399512ec78c15ce3db79ea88ef3b1293">More...</a><br /></td></tr>
<tr class="separator:ga399512ec78c15ce3db79ea88ef3b1293"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9d660d278f3f58871b4086c0e175f4c6"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga9d660d278f3f58871b4086c0e175f4c6">dbsetopt</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int option, const char *char_param, int int_param)</td></tr>
<tr class="memdesc:ga9d660d278f3f58871b4086c0e175f4c6"><td class="mdescLeft"> </td><td class="mdescRight">Set db-lib or server option. <a href="#ga9d660d278f3f58871b4086c0e175f4c6">More...</a><br /></td></tr>
<tr class="separator:ga9d660d278f3f58871b4086c0e175f4c6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaeb3d621e4f6846bb228b0a596d8758c0"><td class="memItemLeft" align="right" valign="top">STATUS </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaeb3d621e4f6846bb228b0a596d8758c0">dbsetrow</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, DBINT row)</td></tr>
<tr class="memdesc:gaeb3d621e4f6846bb228b0a596d8758c0"><td class="mdescLeft"> </td><td class="mdescRight">Make a buffered row "current" without fetching it into bound variables. <a href="#gaeb3d621e4f6846bb228b0a596d8758c0">More...</a><br /></td></tr>
<tr class="separator:gaeb3d621e4f6846bb228b0a596d8758c0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gada4b41f34542a87f0cd87e78e56d18bb"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gada4b41f34542a87f0cd87e78e56d18bb">dbsettime</a> (int seconds)</td></tr>
<tr class="memdesc:gada4b41f34542a87f0cd87e78e56d18bb"><td class="mdescLeft"> </td><td class="mdescRight">Set maximum seconds db-lib waits for a server response to query. <a href="#gada4b41f34542a87f0cd87e78e56d18bb">More...</a><br /></td></tr>
<tr class="separator:gada4b41f34542a87f0cd87e78e56d18bb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gabea9c70d02bf3e46bbb1d759915cb91e"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gabea9c70d02bf3e46bbb1d759915cb91e">dbsetuserdata</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, BYTE *ptr)</td></tr>
<tr class="memdesc:gabea9c70d02bf3e46bbb1d759915cb91e"><td class="mdescLeft"> </td><td class="mdescRight">Associate client-allocated (and defined) data with a <code>DBPROCESS</code>. <a href="#gabea9c70d02bf3e46bbb1d759915cb91e">More...</a><br /></td></tr>
<tr class="separator:gabea9c70d02bf3e46bbb1d759915cb91e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab9aa181fb3081ffb314340cbd71e434d"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gab9aa181fb3081ffb314340cbd71e434d">dbsetversion</a> (DBINT version)</td></tr>
<tr class="memdesc:gab9aa181fb3081ffb314340cbd71e434d"><td class="mdescLeft"> </td><td class="mdescRight">Specify a db-lib version level. <a href="#gab9aa181fb3081ffb314340cbd71e434d">More...</a><br /></td></tr>
<tr class="separator:gab9aa181fb3081ffb314340cbd71e434d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga223a6d333f95e726b0b42ec19a076731"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga223a6d333f95e726b0b42ec19a076731">dbspid</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga223a6d333f95e726b0b42ec19a076731"><td class="mdescLeft"> </td><td class="mdescRight">Get server process ID for a <code>DBPROCESS</code>. <a href="#ga223a6d333f95e726b0b42ec19a076731">More...</a><br /></td></tr>
<tr class="separator:ga223a6d333f95e726b0b42ec19a076731"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf641c8e3d34607ca8b7ac2afed3e6d67"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaf641c8e3d34607ca8b7ac2afed3e6d67">dbspr1row</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, char *buffer, DBINT buf_len)</td></tr>
<tr class="memdesc:gaf641c8e3d34607ca8b7ac2afed3e6d67"><td class="mdescLeft"> </td><td class="mdescRight">Print a regular result row to a buffer. <a href="#gaf641c8e3d34607ca8b7ac2afed3e6d67">More...</a><br /></td></tr>
<tr class="separator:gaf641c8e3d34607ca8b7ac2afed3e6d67"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga308918c13a5b1644269c1654fbea96ac"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga308918c13a5b1644269c1654fbea96ac">dbspr1rowlen</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga308918c13a5b1644269c1654fbea96ac"><td class="mdescLeft"> </td><td class="mdescRight">Determine size buffer required to hold the results returned by <a class="el" href="a00518.html#gaaa4839a9c88e5b90f33bd2407fcbc43e" title="Print result set headings to a buffer. ">dbsprhead()</a>, <a class="el" href="a00518.html#gacfaf9feb29c87cfb660886162f643152" title="Get formatted string for underlining dbsprhead() column names. ">dbsprline()</a>, and <a class="el" href="a00518.html#gaf641c8e3d34607ca8b7ac2afed3e6d67" title="Print a regular result row to a buffer. ">dbspr1row()</a>. <a href="#ga308918c13a5b1644269c1654fbea96ac">More...</a><br /></td></tr>
<tr class="separator:ga308918c13a5b1644269c1654fbea96ac"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaaa4839a9c88e5b90f33bd2407fcbc43e"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaaa4839a9c88e5b90f33bd2407fcbc43e">dbsprhead</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, char *buffer, DBINT buf_len)</td></tr>
<tr class="memdesc:gaaa4839a9c88e5b90f33bd2407fcbc43e"><td class="mdescLeft"> </td><td class="mdescRight">Print result set headings to a buffer. <a href="#gaaa4839a9c88e5b90f33bd2407fcbc43e">More...</a><br /></td></tr>
<tr class="separator:gaaa4839a9c88e5b90f33bd2407fcbc43e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gacfaf9feb29c87cfb660886162f643152"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gacfaf9feb29c87cfb660886162f643152">dbsprline</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, char *buffer, DBINT buf_len, DBCHAR line_char)</td></tr>
<tr class="memdesc:gacfaf9feb29c87cfb660886162f643152"><td class="mdescLeft"> </td><td class="mdescRight">Get formatted string for underlining <a class="el" href="a00518.html#gaaa4839a9c88e5b90f33bd2407fcbc43e" title="Print result set headings to a buffer. ">dbsprhead()</a> column names. <a href="#gacfaf9feb29c87cfb660886162f643152">More...</a><br /></td></tr>
<tr class="separator:gacfaf9feb29c87cfb660886162f643152"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaae889abeb145ec41f7361aa8f597fe46"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaae889abeb145ec41f7361aa8f597fe46">dbsqlexec</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gaae889abeb145ec41f7361aa8f597fe46"><td class="mdescLeft"> </td><td class="mdescRight">send the SQL command to the server and wait for an answer. <a href="#gaae889abeb145ec41f7361aa8f597fe46">More...</a><br /></td></tr>
<tr class="separator:gaae889abeb145ec41f7361aa8f597fe46"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae1f50a6a2c31fda57cb481922b06841e"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gae1f50a6a2c31fda57cb481922b06841e">dbsqlok</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gae1f50a6a2c31fda57cb481922b06841e"><td class="mdescLeft"> </td><td class="mdescRight">Wait for results of a query from the server. <a href="#gae1f50a6a2c31fda57cb481922b06841e">More...</a><br /></td></tr>
<tr class="separator:gae1f50a6a2c31fda57cb481922b06841e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac980139b9cea03cf93e373d425991481"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481">dbsqlsend</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:gac980139b9cea03cf93e373d425991481"><td class="mdescLeft"> </td><td class="mdescRight">Transmit the command buffer to the server. <a href="#gac980139b9cea03cf93e373d425991481">More...</a><br /></td></tr>
<tr class="separator:gac980139b9cea03cf93e373d425991481"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab5fe0cd5f24d4fd33670111035a4fbed"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gab5fe0cd5f24d4fd33670111035a4fbed">dbstrbuild</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, char *charbuf, int bufsize, char *text, char *formats,...)</td></tr>
<tr class="memdesc:gab5fe0cd5f24d4fd33670111035a4fbed"><td class="mdescLeft"> </td><td class="mdescRight">Build a printable string from text containing placeholders for variables. <a href="#gab5fe0cd5f24d4fd33670111035a4fbed">More...</a><br /></td></tr>
<tr class="separator:gab5fe0cd5f24d4fd33670111035a4fbed"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf130b12e9e58b1bfd4a6685e33f5b3cd"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaf130b12e9e58b1bfd4a6685e33f5b3cd">dbstrcpy</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int start, int numbytes, char *dest)</td></tr>
<tr class="memdesc:gaf130b12e9e58b1bfd4a6685e33f5b3cd"><td class="mdescLeft"> </td><td class="mdescRight">Get a copy of a chunk of the command buffer. <a href="#gaf130b12e9e58b1bfd4a6685e33f5b3cd">More...</a><br /></td></tr>
<tr class="separator:gaf130b12e9e58b1bfd4a6685e33f5b3cd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga13caa07ec45cd6f64e9197d29e3cfe5e"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga13caa07ec45cd6f64e9197d29e3cfe5e">dbstrlen</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc)</td></tr>
<tr class="memdesc:ga13caa07ec45cd6f64e9197d29e3cfe5e"><td class="mdescLeft"> </td><td class="mdescRight">Get size of the command buffer, in bytes. <a href="#ga13caa07ec45cd6f64e9197d29e3cfe5e">More...</a><br /></td></tr>
<tr class="separator:ga13caa07ec45cd6f64e9197d29e3cfe5e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9804fc70ae6ed35c92cd75d410dad570"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga9804fc70ae6ed35c92cd75d410dad570">dbtablecolinfo</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, DBINT column, <a class="el" href="a01277.html">DBCOL</a> *pdbcol)</td></tr>
<tr class="memdesc:ga9804fc70ae6ed35c92cd75d410dad570"><td class="mdescLeft"> </td><td class="mdescRight">describe table column attributes with a single call (Freetds-only API function modelled on dbcolinfo) <a href="#ga9804fc70ae6ed35c92cd75d410dad570">More...</a><br /></td></tr>
<tr class="separator:ga9804fc70ae6ed35c92cd75d410dad570"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga57e4098b153a030f0be02bcd98e08ba2"><td class="memItemLeft" align="right" valign="top">DBBINARY * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga57e4098b153a030f0be02bcd98e08ba2">dbtxptr</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:ga57e4098b153a030f0be02bcd98e08ba2"><td class="mdescLeft"> </td><td class="mdescRight">Get text pointer for a column in the current row. <a href="#ga57e4098b153a030f0be02bcd98e08ba2">More...</a><br /></td></tr>
<tr class="separator:ga57e4098b153a030f0be02bcd98e08ba2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac3f11142ec7ff25b1f8972af10fe9454"><td class="memItemLeft" align="right" valign="top">DBBINARY * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gac3f11142ec7ff25b1f8972af10fe9454">dbtxtimestamp</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:gac3f11142ec7ff25b1f8972af10fe9454"><td class="mdescLeft"> </td><td class="mdescRight">Get text timestamp for a column in the current row. <a href="#gac3f11142ec7ff25b1f8972af10fe9454">More...</a><br /></td></tr>
<tr class="separator:gac3f11142ec7ff25b1f8972af10fe9454"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga66ea891910f0a357cc78107d6ab7d962"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga66ea891910f0a357cc78107d6ab7d962">dbuse</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, const char *name)</td></tr>
<tr class="memdesc:ga66ea891910f0a357cc78107d6ab7d962"><td class="mdescLeft"> </td><td class="mdescRight">Change current database. <a href="#ga66ea891910f0a357cc78107d6ab7d962">More...</a><br /></td></tr>
<tr class="separator:ga66ea891910f0a357cc78107d6ab7d962"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga57c856964a9a0b4cc43f5192647c51e7"><td class="memItemLeft" align="right" valign="top">DBINT </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga57c856964a9a0b4cc43f5192647c51e7">dbvarylen</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, int column)</td></tr>
<tr class="memdesc:ga57c856964a9a0b4cc43f5192647c51e7"><td class="mdescLeft"> </td><td class="mdescRight">Determine whether a column can vary in size. <a href="#ga57c856964a9a0b4cc43f5192647c51e7">More...</a><br /></td></tr>
<tr class="separator:ga57c856964a9a0b4cc43f5192647c51e7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga666726c86108342b1c1f27eecf68e13c"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga666726c86108342b1c1f27eecf68e13c">dbversion</a> ()</td></tr>
<tr class="memdesc:ga666726c86108342b1c1f27eecf68e13c"><td class="mdescLeft"> </td><td class="mdescRight">See which version of db-lib is in use. <a href="#ga666726c86108342b1c1f27eecf68e13c">More...</a><br /></td></tr>
<tr class="separator:ga666726c86108342b1c1f27eecf68e13c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaaf8349999c16b3c36caf5947747a2915"><td class="memItemLeft" align="right" valign="top">DBBOOL </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#gaaf8349999c16b3c36caf5947747a2915">dbwillconvert</a> (int srctype, int desttype)</td></tr>
<tr class="memdesc:gaaf8349999c16b3c36caf5947747a2915"><td class="mdescLeft"> </td><td class="mdescRight">Test whether or not a datatype can be converted to another datatype. <a href="#gaaf8349999c16b3c36caf5947747a2915">More...</a><br /></td></tr>
<tr class="separator:gaaf8349999c16b3c36caf5947747a2915"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga548153eb2eae76c48aa9d4b72258dc1c"><td class="memItemLeft" align="right" valign="top">RETCODE </td><td class="memItemRight" valign="bottom"><a class="el" href="a00518.html#ga548153eb2eae76c48aa9d4b72258dc1c">dbwritetext</a> (<a class="el" href="a00901.html">DBPROCESS</a> *dbproc, char *objname, DBBINARY *textptr, DBTINYINT textptrlen, DBBINARY *timestamp, DBBOOL log, DBINT size, BYTE *text)</td></tr>
<tr class="memdesc:ga548153eb2eae76c48aa9d4b72258dc1c"><td class="mdescLeft"> </td><td class="mdescRight">Send text or image data to the server. <a href="#ga548153eb2eae76c48aa9d4b72258dc1c">More...</a><br /></td></tr>
<tr class="separator:ga548153eb2eae76c48aa9d4b72258dc1c"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>Core functions needed by most db-lib programs. </p>
<h2 class="groupheader">Macro Definition Documentation</h2>
<a id="ga8b263669ce0312e52b5ea42a57a56838"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8b263669ce0312e52b5ea42a57a56838">§ </a></span>DBCMDROW</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBCMDROW</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00524.html#ga196f6d67de47f34a32fcc2103ab0f416">dbcmdrow</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#ga196f6d67de47f34a32fcc2103ab0f416" title="See if the current command can return rows. ">dbcmdrow()</a> </dd></dl>
</div>
</div>
<a id="ga0ac1828f731a21c591c8d6330cbba3a9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga0ac1828f731a21c591c8d6330cbba3a9">§ </a></span>DBCOUNT</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBCOUNT</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00518.html#ga9433bc200c0978569964354451d9b64e">dbcount</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga9433bc200c0978569964354451d9b64e" title="Get count of rows processed. ">dbcount()</a> </dd></dl>
</div>
</div>
<a id="gae375344b1ec50c1f756e3b69f3cef715"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae375344b1ec50c1f756e3b69f3cef715">§ </a></span>DBCURCMD</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBCURCMD</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00524.html#ga01e7fb38bece3bb07526532fa6be50e5">dbcurcmd</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#ga01e7fb38bece3bb07526532fa6be50e5" title="Get number of the row just returned. ">dbcurcmd()</a> </dd></dl>
</div>
</div>
<a id="gaf49e4b58918bfa4d4adaa14ee5bb375c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf49e4b58918bfa4d4adaa14ee5bb375c">§ </a></span>DBCURROW</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBCURROW</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00524.html#ga9e23a95d84192b4fc83db7544d772d16">dbcurrow</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#ga9e23a95d84192b4fc83db7544d772d16" title="Get number of the row currently being read. ">dbcurrow()</a> </dd></dl>
</div>
</div>
<a id="ga2c7b5eec4843ea326b21f2db2ded2754"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2c7b5eec4843ea326b21f2db2ded2754">§ </a></span>DBDEAD</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBDEAD</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00524.html#gaed43cb21ed54dc1a6340075d6290e4b0">dbdead</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#gaed43cb21ed54dc1a6340075d6290e4b0" title="Check if dbproc is an ex-parrot. ">dbdead()</a> </dd></dl>
</div>
</div>
<a id="ga97a6493786124215ec9fe4b4bd2d7cbb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga97a6493786124215ec9fe4b4bd2d7cbb">§ </a></span>DBFIRSTROW</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBFIRSTROW</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00524.html#gaf40b925f3b3ba43804720dd4ae584935">dbfirstrow</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#gaf40b925f3b3ba43804720dd4ae584935" title="See if a server response has arrived. ">dbfirstrow()</a> </dd></dl>
</div>
</div>
<a id="ga74ac942f9b7baa49e1d7d18628321297"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga74ac942f9b7baa49e1d7d18628321297">§ </a></span>DBIORDESC</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBIORDESC</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00524.html#gab842baac0ec420b265d8c199cc45059d">dbiordesc</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro, maps to the internal (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#gab842baac0ec420b265d8c199cc45059d" title="Get file descriptor of the socket used by a DBPROCESS to read data coming from the server...">dbiordesc()</a> </dd></dl>
</div>
</div>
<a id="ga5afb13924cda059d30be36a70dcf2cd9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga5afb13924cda059d30be36a70dcf2cd9">§ </a></span>DBIOWDESC</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBIOWDESC</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00524.html#ga666a4d0609ee7f241deb0a62893d2cfa">dbiowdesc</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro, maps to the internal (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#ga666a4d0609ee7f241deb0a62893d2cfa" title="Get file descriptor of the socket used by a DBPROCESS to write data coming to the server...">dbiowdesc()</a> </dd></dl>
</div>
</div>
<a id="ga40f6c951a851744e58ee715c652a8ac8"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga40f6c951a851744e58ee715c652a8ac8">§ </a></span>DBISAVAIL</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBISAVAIL</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   dbisavail((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd>dbisavail() </dd></dl>
</div>
</div>
<a id="ga10b9b26cf9a901146e9675a9e678632b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga10b9b26cf9a901146e9675a9e678632b">§ </a></span>DBLASTROW</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBLASTROW</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00524.html#ga13ead146339b43b3a4d9049eb124ef4b">dblastrow</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#ga13ead146339b43b3a4d9049eb124ef4b" title="Get number of the last row in the row buffer. ">dblastrow()</a>, <a class="el" href="a00518.html#ga97a6493786124215ec9fe4b4bd2d7cbb" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBFIRSTROW()</a> </dd></dl>
</div>
</div>
<a id="gad887bdce8cb0d3b8c6aaf659eb477b48"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad887bdce8cb0d3b8c6aaf659eb477b48">§ </a></span>DBMORECMDS</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBMORECMDS</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00518.html#gac3ba9f53cc77e4dde8f48335ed94ac19">dbmorecmds</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gac3ba9f53cc77e4dde8f48335ed94ac19" title="See if more commands are to be processed. ">dbmorecmds()</a> </dd></dl>
</div>
</div>
<a id="ga48d71b32c26703c810191ef916c5448c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga48d71b32c26703c810191ef916c5448c">§ </a></span>DBROWS</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBROWS</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00524.html#ga4be2ab59dc7161d6b93c17202e7ae9b1">dbrows</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#ga4be2ab59dc7161d6b93c17202e7ae9b1" title="Indicate whether a query returned rows. ">dbrows()</a> </dd></dl>
</div>
</div>
<a id="ga6fda3f4982dda5825d13fee392e89fd9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6fda3f4982dda5825d13fee392e89fd9">§ </a></span>DBROWTYPE</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBROWTYPE</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x</td><td>)</td>
<td>   <a class="el" href="a00524.html#gaa2dc8c062342f76adffe53ee280b7fb4">dbrowtype</a>((x))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro mapping to the Microsoft (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#gaa2dc8c062342f76adffe53ee280b7fb4" title="Get returned row's type. ">dbrowtype()</a> </dd></dl>
</div>
</div>
<a id="ga316c0fd24b8dc1259ce9eb4d25016400"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga316c0fd24b8dc1259ce9eb4d25016400">§ </a></span>DBSETLCHARSET</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBSETLCHARSET</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">y </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td>   <a class="el" href="a00524.html#gae1fc46447c4f8a9ff7f66607b8cd23b6">dbsetlname</a>((x), (y), DBSETCHARSET)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the client character set in the login packet. </p>
<dl class="section remark"><dt>Remarks</dt><dd>Has no effect on TDS 7.0+ connections. </dd></dl>
</div>
</div>
<a id="gac51e3075197963557a8d2a37d82df921"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac51e3075197963557a8d2a37d82df921">§ </a></span>DBSETLENCRYPT</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBSETLENCRYPT</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">y </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td>   <a class="el" href="a00524.html#ga03e850369aca6fba074da5e9da4effd7">dbsetlbool</a>((x), (y), DBSETENCRYPT)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Enable (or not) network password encryption for Sybase servers version 10.0 or above. </p>
<dl class="todo"><dt><b><a class="el" href="a00515.html#_todo000020">Todo:</a></b></dt><dd>Unimplemented. </dd></dl>
<dl class="section see"><dt>See also</dt><dd>dbsetlencrypt() </dd></dl>
</div>
</div>
<a id="gadada0e76c811a6fb84ce6759bcf116b5"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gadada0e76c811a6fb84ce6759bcf116b5">§ </a></span>DBSETLNATLANG</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBSETLNATLANG</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">y </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td>   <a class="el" href="a00524.html#gae1fc46447c4f8a9ff7f66607b8cd23b6">dbsetlname</a>((x), (y), DBSETNATLANG)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the language the server should use for messages. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga30e0028e6208414c2245e5fcd6740d9d" title="Set the language the server should use for messages. ">dbsetlnatlang()</a>, <a class="el" href="a00524.html#gae1fc46447c4f8a9ff7f66607b8cd23b6" title="Set the value of a string in a LOGINREC structure. ">dbsetlname()</a> </dd></dl>
</div>
</div>
<a id="ga30e0028e6208414c2245e5fcd6740d9d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga30e0028e6208414c2245e5fcd6740d9d">§ </a></span>dbsetlnatlang</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">dbsetlnatlang</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">y </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td>   <a class="el" href="a00524.html#gae1fc46447c4f8a9ff7f66607b8cd23b6">dbsetlname</a>((x), (y), DBSETNATLANG)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the language the server should use for messages. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gadada0e76c811a6fb84ce6759bcf116b5" title="Set the language the server should use for messages. ">DBSETLNATLANG()</a>, <a class="el" href="a00524.html#gae1fc46447c4f8a9ff7f66607b8cd23b6" title="Set the value of a string in a LOGINREC structure. ">dbsetlname()</a> </dd></dl>
</div>
</div>
<a id="gae7e59f9c3cc0ec5916c06977ff7d8565"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae7e59f9c3cc0ec5916c06977ff7d8565">§ </a></span>DBSETLPACKET</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBSETLPACKET</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">y </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td>   <a class="el" href="a00524.html#gabdcccf4e0d093ff48c0e7048a4bfaf84">dbsetllong</a>((x), (y), DBSETPACKET)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the packet size in the login packet for new connections. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga0d0acc4ce2243e48023e022b50e2ac45" title="Set the packet size in the login packet for new connections. ">dbsetlpacket()</a>, <a class="el" href="a00524.html#gabdcccf4e0d093ff48c0e7048a4bfaf84" title="Set an integer value in a LOGINREC structure. ">dbsetllong()</a> </dd></dl>
</div>
</div>
<a id="ga0d0acc4ce2243e48023e022b50e2ac45"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga0d0acc4ce2243e48023e022b50e2ac45">§ </a></span>dbsetlpacket</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">dbsetlpacket</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">x, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">y </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td>   <a class="el" href="a00524.html#gabdcccf4e0d093ff48c0e7048a4bfaf84">dbsetllong</a>((x), (y), DBSETPACKET)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the packet size in the login packet for new connections. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gae7e59f9c3cc0ec5916c06977ff7d8565" title="Set the packet size in the login packet for new connections. ">DBSETLPACKET()</a>, <a class="el" href="a00524.html#gabdcccf4e0d093ff48c0e7048a4bfaf84" title="Set an integer value in a LOGINREC structure. ">dbsetllong()</a> </dd></dl>
</div>
</div>
<a id="ga1644cf55d37435711df65c12a3f7b785"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga1644cf55d37435711df65c12a3f7b785">§ </a></span>DBTDS</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBTDS</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">a</td><td>)</td>
<td>   <a class="el" href="a00524.html#ga8d765d810a40dfa01b39995a8e7406f0">dbtds</a>(a)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sybase macro, maps to the internal (lower-case) function. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00524.html#ga8d765d810a40dfa01b39995a8e7406f0" title="Get the TDS version in use for dbproc. ">dbtds()</a> </dd></dl>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a id="gaf1879b85e8238c015b9648d077665285"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf1879b85e8238c015b9648d077665285">§ </a></span>_dbresults()</h2>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static RETCODE _dbresults </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">static</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section remark"><dt>Remarks</dt><dd>Either SYBDBLIB or MSDBLIB (not both) must be defined. This affects how certain application-addressable strucures are defined. </dd></dl>
<div class="dynheader">
Here is the caller graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaf1879b85e8238c015b9648d077665285_icgraph.svg" width="224" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gabcc14a1ca58b65bc46cce6c81c45218c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gabcc14a1ca58b65bc46cce6c81c45218c">§ </a></span>dbadata()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">BYTE* dbadata </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get address of compute column data. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>of <code>COMPUTE</code> clause to which we're referring. </td></tr>
<tr><td class="paramname">column</td><td>Nth column in <em>computeid</em>, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>pointer to columns's data buffer. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">NULL</td><td>no such <em>computeid</em> or <em>column</em>. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga3340e21db274b272ec11c037cb147222" title="Get size of data in a compute column. ">dbadlen()</a>, <a class="el" href="a00518.html#gafefd17e15b22adda84366c817178dd7d" title="Bind a compute column to a program variable. ">dbaltbind()</a>, <a class="el" href="a00518.html#ga9a35c8d3cd0e35c10555baf8f6a01e93" title="Get size of data in compute column. ">dbaltlen()</a>, <a class="el" href="a00518.html#gaa85171e020dc606f2bd3395ad1d3ab4f" title="Get datatype for a compute column. ">dbalttype()</a>, <a class="el" href="a00518.html#ga60fe544491c760f8bc6c37bc7f777d70" title="Read a row from the row buffer. ">dbgetrow()</a>, dbnextrow(), <a class="el" href="a00518.html#ga67934deac3bebbf8238eff8c0559389a" title="Get count of columns in a compute row. ">dbnumalts()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gabcc14a1ca58b65bc46cce6c81c45218c_cgraph.svg" width="235" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga3340e21db274b272ec11c037cb147222"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga3340e21db274b272ec11c037cb147222">§ </a></span>dbadlen()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbadlen </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get size of data in a compute column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>of <code>COMPUTE</code> clause to which we're referring. </td></tr>
<tr><td class="paramname">column</td><td>Nth column in <em>computeid</em>, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>size of the data, in bytes. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">-1</td><td>no such <em>column</em> or <em>computeid</em>. </td></tr>
<tr><td class="paramname">0</td><td>data are NULL. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gabcc14a1ca58b65bc46cce6c81c45218c" title="Get address of compute column data. ">dbadata()</a>, <a class="el" href="a00518.html#ga9a35c8d3cd0e35c10555baf8f6a01e93" title="Get size of data in compute column. ">dbaltlen()</a>, <a class="el" href="a00518.html#gaa85171e020dc606f2bd3395ad1d3ab4f" title="Get datatype for a compute column. ">dbalttype()</a>, <a class="el" href="a00518.html#ga60fe544491c760f8bc6c37bc7f777d70" title="Read a row from the row buffer. ">dbgetrow()</a>, dbnextrow(), <a class="el" href="a00518.html#ga67934deac3bebbf8238eff8c0559389a" title="Get count of columns in a compute row. ">dbnumalts()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga3340e21db274b272ec11c037cb147222_cgraph.svg" width="234" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gafefd17e15b22adda84366c817178dd7d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gafefd17e15b22adda84366c817178dd7d">§ </a></span>dbaltbind()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbaltbind </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>vartype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>varlen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BYTE * </td>
<td class="paramname"><em>varaddr</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a compute column to a program variable. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>of <code>COMPUTE</code> clause to which we're referring. </td></tr>
<tr><td class="paramname">column</td><td>Nth column in <em>computeid</em>, starting from 1. </td></tr>
<tr><td class="paramname">vartype</td><td>datatype of the host variable that will receive the data </td></tr>
<tr><td class="paramname">varlen</td><td>size of host variable pointed to <em>varaddr</em> </td></tr>
<tr><td class="paramname">varaddr</td><td>address of host variable </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>everything worked. </td></tr>
<tr><td class="paramname">FAIL</td><td>no such <em>computeid</em> or <em>column</em>, or no such conversion possible, or target buffer too small. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gabcc14a1ca58b65bc46cce6c81c45218c" title="Get address of compute column data. ">dbadata()</a>, dbaltbind_ps(), <a class="el" href="a00518.html#ga939c2a2e67b9992c787e2cec5b6cc1a7" title="Tie a null-indicator to a compute result column. ">dbanullbind()</a>, <a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795" title="Tie a host variable to a resultset column. ">dbbind()</a>, dbbind_ps(), <a class="el" href="a00518.html#ga32eb72f6fb3edb130e59fb3dd0766e7e" title="cf. ">dbconvert()</a>, <a class="el" href="a00518.html#ga8b00d5cdcaa20cba13fa2e03d52a443e" title="Convert one datatype to another. ">dbconvert_ps()</a>, <a class="el" href="a00518.html#ga85dcc40c3615f94be96b09b2ec043533" title="Tie a null-indicator to a regular result column. ">dbnullbind()</a>, <a class="el" href="a00518.html#ga399512ec78c15ce3db79ea88ef3b1293" title="Define substitution values to be used when binding null values. ">dbsetnull()</a>, <a class="el" href="a00518.html#gab9aa181fb3081ffb314340cbd71e434d" title="Specify a db-lib version level. ">dbsetversion()</a>, <a class="el" href="a00518.html#gaaf8349999c16b3c36caf5947747a2915" title="Test whether or not a datatype can be converted to another datatype. ">dbwillconvert()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gafefd17e15b22adda84366c817178dd7d_cgraph.svg" width="240" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gad10c9fd75a86c7a0ac375937df0e90a6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad10c9fd75a86c7a0ac375937df0e90a6">§ </a></span>dbaltcolid()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbaltcolid </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get column ID of a compute column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>of <code>COMPUTE</code> clause to which we're referring. </td></tr>
<tr><td class="paramname">column</td><td>Nth column in <em>computeid</em>, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Nth column in the base result set, on which <em>column</em> was computed. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gabcc14a1ca58b65bc46cce6c81c45218c" title="Get address of compute column data. ">dbadata()</a>, <a class="el" href="a00518.html#ga3340e21db274b272ec11c037cb147222" title="Get size of data in a compute column. ">dbadlen()</a>, <a class="el" href="a00518.html#ga9a35c8d3cd0e35c10555baf8f6a01e93" title="Get size of data in compute column. ">dbaltlen()</a>, <a class="el" href="a00518.html#ga60fe544491c760f8bc6c37bc7f777d70" title="Read a row from the row buffer. ">dbgetrow()</a>, dbnextrow(), <a class="el" href="a00518.html#ga67934deac3bebbf8238eff8c0559389a" title="Get count of columns in a compute row. ">dbnumalts()</a>, <a class="el" href="a00518.html#gac25ae21ca19777ffab1c013bd6049ebf" title="Print a token value's name to a buffer. ">dbprtype()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gad10c9fd75a86c7a0ac375937df0e90a6_cgraph.svg" width="243" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga9a35c8d3cd0e35c10555baf8f6a01e93"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9a35c8d3cd0e35c10555baf8f6a01e93">§ </a></span>dbaltlen()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbaltlen </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get size of data in compute column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>of <code>COMPUTE</code> clause to which we're referring. </td></tr>
<tr><td class="paramname">column</td><td>Nth column in <em>computeid</em>, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gabcc14a1ca58b65bc46cce6c81c45218c" title="Get address of compute column data. ">dbadata()</a>, <a class="el" href="a00518.html#ga3340e21db274b272ec11c037cb147222" title="Get size of data in a compute column. ">dbadlen()</a>, <a class="el" href="a00518.html#gaa85171e020dc606f2bd3395ad1d3ab4f" title="Get datatype for a compute column. ">dbalttype()</a>, <a class="el" href="a00518.html#ga60fe544491c760f8bc6c37bc7f777d70" title="Read a row from the row buffer. ">dbgetrow()</a>, dbnextrow(), <a class="el" href="a00518.html#ga67934deac3bebbf8238eff8c0559389a" title="Get count of columns in a compute row. ">dbnumalts()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga9a35c8d3cd0e35c10555baf8f6a01e93_cgraph.svg" width="232" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga947837a5c8fd99898c043435945b668c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga947837a5c8fd99898c043435945b668c">§ </a></span>dbaltop()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbaltop </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get aggregation operator for a compute column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>of <code>COMPUTE</code> clause to which we're referring. </td></tr>
<tr><td class="paramname">column</td><td>Nth column in <em>computeid</em>, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>token value for the type of the compute column's aggregation operator. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">-1</td><td>no such <em>computeid</em> or <em>column</em>. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gabcc14a1ca58b65bc46cce6c81c45218c" title="Get address of compute column data. ">dbadata()</a>, <a class="el" href="a00518.html#ga3340e21db274b272ec11c037cb147222" title="Get size of data in a compute column. ">dbadlen()</a>, <a class="el" href="a00518.html#ga9a35c8d3cd0e35c10555baf8f6a01e93" title="Get size of data in compute column. ">dbaltlen()</a>, dbnextrow(), <a class="el" href="a00518.html#ga67934deac3bebbf8238eff8c0559389a" title="Get count of columns in a compute row. ">dbnumalts()</a>, <a class="el" href="a00518.html#gac25ae21ca19777ffab1c013bd6049ebf" title="Print a token value's name to a buffer. ">dbprtype()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga947837a5c8fd99898c043435945b668c_cgraph.svg" width="230" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaa85171e020dc606f2bd3395ad1d3ab4f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa85171e020dc606f2bd3395ad1d3ab4f">§ </a></span>dbalttype()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbalttype </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get datatype for a compute column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>of <code>COMPUTE</code> clause to which we're referring. </td></tr>
<tr><td class="paramname">column</td><td>Nth column in <em>computeid</em>, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>SYB*</code> dataype token. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">-1</td><td>no such <em>column</em> or <em>computeid</em>. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gabcc14a1ca58b65bc46cce6c81c45218c" title="Get address of compute column data. ">dbadata()</a>, <a class="el" href="a00518.html#ga3340e21db274b272ec11c037cb147222" title="Get size of data in a compute column. ">dbadlen()</a>, <a class="el" href="a00518.html#ga9a35c8d3cd0e35c10555baf8f6a01e93" title="Get size of data in compute column. ">dbaltlen()</a>, dbnextrow(), <a class="el" href="a00518.html#ga67934deac3bebbf8238eff8c0559389a" title="Get count of columns in a compute row. ">dbnumalts()</a>, <a class="el" href="a00518.html#gac25ae21ca19777ffab1c013bd6049ebf" title="Print a token value's name to a buffer. ">dbprtype()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaa85171e020dc606f2bd3395ad1d3ab4f_cgraph.svg" width="240" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaf1c00d83dfa88dc99a3fb449c49660ea"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf1c00d83dfa88dc99a3fb449c49660ea">§ </a></span>dbaltutype()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbaltutype </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get user-defined datatype of a compute column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>of <code>COMPUTE</code> clause to which we're referring. </td></tr>
<tr><td class="paramname">column</td><td>Nth column in <em>computeid</em>, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>user-defined datatype of compute column, else -1. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gaa85171e020dc606f2bd3395ad1d3ab4f" title="Get datatype for a compute column. ">dbalttype()</a>, <a class="el" href="a00518.html#gab33d2f4fd44f50e55b6c71902db4fdae" title="Get user-defined datatype of a regular result column. ">dbcolutype()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaf1c00d83dfa88dc99a3fb449c49660ea_cgraph.svg" width="248" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga939c2a2e67b9992c787e2cec5b6cc1a7"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga939c2a2e67b9992c787e2cec5b6cc1a7">§ </a></span>dbanullbind()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbanullbind </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT * </td>
<td class="paramname"><em>indicator</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Tie a null-indicator to a compute result column. </p>
<p>When a row is fetched, the indicator variable tells the state of the column's data.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>identifies which one of potientially many compute rows is meant. The first compute clause has <em>computeid</em> == 1. </td></tr>
<tr><td class="paramname">column</td><td>Nth column in the result set, starting with 1. </td></tr>
<tr><td class="paramname">indicator</td><td>address of host variable. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>variable accepted. </td></tr>
<tr><td class="paramname">FAIL</td><td><em>indicator</em> is NULL or <em>column</em> is out of range. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>Contents of <em>indicator</em> are set with <code>dbnextrow()</code>. Possible values are:<ul>
<li>0 <em>column</em> bound successfully</li>
<li>-1 <em>column</em> is NULL.</li>
<li>>0 true length of data, had <em>column</em> not been truncated due to insufficient space in the columns bound host variable . </li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gabcc14a1ca58b65bc46cce6c81c45218c" title="Get address of compute column data. ">dbadata()</a>, <a class="el" href="a00518.html#ga3340e21db274b272ec11c037cb147222" title="Get size of data in a compute column. ">dbadlen()</a>, <a class="el" href="a00518.html#gafefd17e15b22adda84366c817178dd7d" title="Bind a compute column to a program variable. ">dbaltbind()</a>, dbnextrow(), <a class="el" href="a00518.html#ga85dcc40c3615f94be96b09b2ec043533" title="Tie a null-indicator to a regular result column. ">dbnullbind()</a>. </dd></dl>
<dl class="todo"><dt><b><a class="el" href="a00515.html#_todo000008">Todo:</a></b></dt><dd>Never fails, but only because failure conditions aren't checked. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga939c2a2e67b9992c787e2cec5b6cc1a7_cgraph.svg" width="254" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gad57aa777300cf7f62077478ec6000d00"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad57aa777300cf7f62077478ec6000d00">§ </a></span>dbanydatecrack()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbanydatecrack </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="a01297.html">DBDATEREC2</a> * </td>
<td class="paramname"><em>di</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void * </td>
<td class="paramname"><em>data</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Break any kind of date or time value into useful pieces. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">di</td><td><em>output:</em> structure to contain the exploded parts of <em>datetime</em>. </td></tr>
<tr><td class="paramname">type</td><td><em>input:</em> <code>type</code> of date/time value returned by <a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f" title="Get the datatype of a regular result set column. ">dbcoltype()</a>. </td></tr>
<tr><td class="paramname">data</td><td><em>input:</em> <code>date/time</code> value to be converted. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>always. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>The members of <em>di</em> have different names, depending on whether <code>–with-msdblib</code> was configured.</dd></dl>
<p>This is an extension to <a class="el" href="a00518.html#ga46f3641b79a2e90371a66950b6db2c4d" title="Break a DBDATETIME value into useful pieces. ">dbdatecrack()</a>, see it for more information.</p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga46f3641b79a2e90371a66950b6db2c4d" title="Break a DBDATETIME value into useful pieces. ">dbdatecrack()</a>, <a class="el" href="a00518.html#ga32eb72f6fb3edb130e59fb3dd0766e7e" title="cf. ">dbconvert()</a>, <a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16" title="Get address of data in a regular result column. ">dbdata()</a>, dbdatechar(), dbdatename(), dbdatepart(), <a class="el" href="a00524.html#ga2c99ec565452279e9a382451d89642eb" title="Form a connection with the server. ">tdsdbopen()</a>. </dd></dl>
</div>
</div>
<a id="ga873bc0f4663165e711655ade1dfae795"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga873bc0f4663165e711655ade1dfae795">§ </a></span>dbbind()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbbind </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>vartype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>varlen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BYTE * </td>
<td class="paramname"><em>varaddr</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Tie a host variable to a resultset column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth column, starting at 1. </td></tr>
<tr><td class="paramname">vartype</td><td>datatype of the host variable that will receive the data </td></tr>
<tr><td class="paramname">varlen</td><td>size of host variable pointed to <em>varaddr</em> </td></tr>
<tr><td class="paramname">varaddr</td><td>address of host variable </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>everything worked. </td></tr>
<tr><td class="paramname">FAIL</td><td>no such <em>column</em> or no such conversion possible, or target buffer too small. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd></dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga873bc0f4663165e711655ade1dfae795_cgraph.svg" width="224" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gae658a0cd5270f3bd6f22de17b2cb2e64"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae658a0cd5270f3bd6f22de17b2cb2e64">§ </a></span>dbbylist()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">BYTE* dbbylist </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>size</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get <code>bylist</code> for a compute row. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>of <code>COMPUTE</code> clause to which we're referring. </td></tr>
<tr><td class="paramname">size</td><td><em>output:</em> size of <code>bylist</code> buffer whose address is returned, possibly zero. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>address of <code>bylist</code> for <em>computeid</em>. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">NULL</td><td>no such <em>computeid</em>. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>Do not free returned pointer. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gabcc14a1ca58b65bc46cce6c81c45218c" title="Get address of compute column data. ">dbadata()</a>, <a class="el" href="a00518.html#ga3340e21db274b272ec11c037cb147222" title="Get size of data in a compute column. ">dbadlen()</a>, <a class="el" href="a00518.html#ga9a35c8d3cd0e35c10555baf8f6a01e93" title="Get size of data in compute column. ">dbaltlen()</a>, <a class="el" href="a00518.html#gaa85171e020dc606f2bd3395ad1d3ab4f" title="Get datatype for a compute column. ">dbalttype()</a>, <a class="el" href="a00518.html#gad06f5deddac18604dfa858b2580e232f" title="Return name of a regular result column. ">dbcolname()</a>, <a class="el" href="a00518.html#ga60fe544491c760f8bc6c37bc7f777d70" title="Read a row from the row buffer. ">dbgetrow()</a>, dbnextrow(). </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gae658a0cd5270f3bd6f22de17b2cb2e64_cgraph.svg" width="230" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga5ea23272124fff03b8d87538c1ec3ee5"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga5ea23272124fff03b8d87538c1ec3ee5">§ </a></span>dbcancel()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbcancel </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Cancel the current command batch. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>always. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga559e24ba70d0d96c3469eb6ab8f74e05" title="Cancel the query currently being retrieved, discarding all pending rows. ">dbcanquery()</a>, dbnextrow(), <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a>, <a class="el" href="a00518.html#ga335fcbe476ad0f897e4e2ce377f0a8cc" title="Set interrupt handler for db-lib to use while blocked against a read from the server. ">dbsetinterrupt()</a>, <a class="el" href="a00518.html#gaae889abeb145ec41f7361aa8f597fe46" title="send the SQL command to the server and wait for an answer. ">dbsqlexec()</a>, <a class="el" href="a00518.html#gae1f50a6a2c31fda57cb481922b06841e" title="Wait for results of a query from the server. ">dbsqlok()</a>, <a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481" title="Transmit the command buffer to the server. ">dbsqlsend()</a>. </dd></dl>
<dl class="todo"><dt><b><a class="el" href="a00515.html#_todo000010">Todo:</a></b></dt><dd>Check for failure and return accordingly. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga5ea23272124fff03b8d87538c1ec3ee5_cgraph.svg" width="240" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga559e24ba70d0d96c3469eb6ab8f74e05"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga559e24ba70d0d96c3469eb6ab8f74e05">§ </a></span>dbcanquery()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbcanquery </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Cancel the query currently being retrieved, discarding all pending rows. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd></dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga559e24ba70d0d96c3469eb6ab8f74e05_cgraph.svg" width="256" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga8cbc761b1266bd947783d843aeeec264"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8cbc761b1266bd947783d843aeeec264">§ </a></span>dbchange()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* dbchange </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>See if a command caused the current database to change. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>name of new database, if changed, as a null-terminated ASCII string, else <code>NULL</code>.</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gab185982ffe0b85b8fd19747bd1f433fe" title="Get name of current database. ">dbname()</a>, <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a>, <a class="el" href="a00518.html#gaae889abeb145ec41f7361aa8f597fe46" title="send the SQL command to the server and wait for an answer. ">dbsqlexec()</a>, <a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481" title="Transmit the command buffer to the server. ">dbsqlsend()</a>, <a class="el" href="a00518.html#ga66ea891910f0a357cc78107d6ab7d962" title="Change current database. ">dbuse()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga8cbc761b1266bd947783d843aeeec264_cgraph.svg" width="246" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaef740b394b44eb33925c2718f7b30d69"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaef740b394b44eb33925c2718f7b30d69">§ </a></span>dbclose()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void dbclose </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Close a connection to the server and free associated resources. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gad0044401c8c83205583f93a4764f2d8b" title="Close server connections and free all related structures. ">dbexit()</a>, <a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaef740b394b44eb33925c2718f7b30d69_cgraph.svg" width="232" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga01404b179a251c249aecfdae72ec6ca4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga01404b179a251c249aecfdae72ec6ca4">§ </a></span>dbclrbuf()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void dbclrbuf </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>n</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Clear <em>n</em> rows from the row buffer. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">n</td><td>number of rows to remove, >= 0. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga60fe544491c760f8bc6c37bc7f777d70" title="Read a row from the row buffer. ">dbgetrow()</a>, dbnextrow(), <a class="el" href="a00518.html#ga9d660d278f3f58871b4086c0e175f4c6" title="Set db-lib or server option. ">dbsetopt()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga01404b179a251c249aecfdae72ec6ca4_cgraph.svg" width="232" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga93ee3c8ca34a08588f88784898fd69e0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga93ee3c8ca34a08588f88784898fd69e0">§ </a></span>dbclropt()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbclropt </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>option</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char </td>
<td class="paramname"><em>param</em>[] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Reset an option. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">option</td><td>to be turned off. </td></tr>
<tr><td class="paramname">param</td><td>clearing some options requires a parameter, believe it or not. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td><em>option</em> and <em>parameter</em> seem sane. </td></tr>
<tr><td class="paramname">FAIL</td><td>no such <em>option</em>. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>Only the following options are recognized:<ul>
<li>DBARITHABORT</li>
<li>DBARITHIGNORE</li>
<li>DBCHAINXACTS</li>
<li>DBFIPSFLAG</li>
<li>DBISOLATION</li>
<li>DBNOCOUNT</li>
<li>DBNOEXEC</li>
<li>DBPARSEONLY</li>
<li>DBSHOWPLAN</li>
<li>DBSTORPROCID</li>
<li>DBQUOTEDIDENT</li>
<li>DBSETTIME </li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gac3eb8cb53f50998403ea9aebc6263df9" title="Get value of an option. ">dbisopt()</a>, <a class="el" href="a00518.html#ga9d660d278f3f58871b4086c0e175f4c6" title="Set db-lib or server option. ">dbsetopt()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga93ee3c8ca34a08588f88784898fd69e0_cgraph.svg" width="234" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga87b39d9863316b4ba85654b0885d53a0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga87b39d9863316b4ba85654b0885d53a0">§ </a></span>dbcmd()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbcmd </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char </td>
<td class="paramname"><em>cmdstring</em>[] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p><code>Append</code> SQL to the command buffer. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">cmdstring</td><td>SQL to append to the command buffer. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>success. </td></tr>
<tr><td class="paramname">FAIL</td><td>insufficient memory. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>set command state to <code>DBCMDPEND</code> unless the command state is DBCMDSENT, in which case it frees the command buffer. This latter may or may not be the Right Thing to do. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga43727b10d4cbb7708b374811abe6eadb" title="printf-like way to form SQL to send to the server. ">dbfcmd()</a>, <a class="el" href="a00518.html#ga0fcfcf6846442dac9dd5584d270ec72a" title="Erase the command buffer, in case DBNOAUTOFREE was set with dbsetopt(). ">dbfreebuf()</a>, <a class="el" href="a00518.html#gaf917cf746c954a5d1b718afe3c4d1940" title="Get address of a position in the command buffer. ">dbgetchar()</a>, <a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a>, <a class="el" href="a00518.html#gaf130b12e9e58b1bfd4a6685e33f5b3cd" title="Get a copy of a chunk of the command buffer. ">dbstrcpy()</a>, <a class="el" href="a00518.html#ga13caa07ec45cd6f64e9197d29e3cfe5e" title="Get size of the command buffer, in bytes. ">dbstrlen()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga87b39d9863316b4ba85654b0885d53a0_cgraph.svg" width="224" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga89fc5589b4bf41932324d2cfc6ad6433"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga89fc5589b4bf41932324d2cfc6ad6433">§ </a></span>dbcollen()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbcollen </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get size of a regular result column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>size of the column (not of data in any particular row). On error, -1. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gad06f5deddac18604dfa858b2580e232f" title="Return name of a regular result column. ">dbcolname()</a>, <a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f" title="Get the datatype of a regular result set column. ">dbcoltype()</a>, <a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16" title="Get address of data in a regular result column. ">dbdata()</a>, <a class="el" href="a00518.html#gae666d141533126babb0235af21bdca0f" title="Get size of current row's data in a regular result column. ">dbdatlen()</a>, <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga89fc5589b4bf41932324d2cfc6ad6433_cgraph.svg" width="236" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gad06f5deddac18604dfa858b2580e232f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad06f5deddac18604dfa858b2580e232f">§ </a></span>dbcolname()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* dbcolname </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Return name of a regular result column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting with 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>pointer to ASCII null-terminated string, the name of the column. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">NULL</td><td><em>column</em> is not in range. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga89fc5589b4bf41932324d2cfc6ad6433" title="Get size of a regular result column. ">dbcollen()</a>, <a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f" title="Get the datatype of a regular result set column. ">dbcoltype()</a>, <a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16" title="Get address of data in a regular result column. ">dbdata()</a>, <a class="el" href="a00518.html#gae666d141533126babb0235af21bdca0f" title="Get size of current row's data in a regular result column. ">dbdatlen()</a>, <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a>. </dd></dl>
<dl class="bug"><dt><b><a class="el" href="a00516.html#_bug000001">Bug:</a></b></dt><dd>Relies on ASCII column names, post iconv conversion. Will not work as described for UTF-8 or UCS-2 clients. But maybe it shouldn't. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gad06f5deddac18604dfa858b2580e232f_cgraph.svg" width="252" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga3a96d0188e5e0eb9eea661b3685fdcc3"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga3a96d0188e5e0eb9eea661b3685fdcc3">§ </a></span>dbcolsource()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* dbcolsource </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get base database column name for a result set column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>pointer to ASCII null-terminated string, the name of the column. On error, NULL. </dd></dl>
<dl class="section see"><dt>See also</dt><dd>dbcolbrowse(), dbqual(), dbtabbrowse(), dbtabcount(), dbtabname(), dbtabsource(), dbtsnewlen(), dbtsnewval(), dbtsput(). </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga3a96d0188e5e0eb9eea661b3685fdcc3_cgraph.svg" width="259" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga636e6f1b64743f3cf22158a56eef371f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga636e6f1b64743f3cf22158a56eef371f">§ </a></span>dbcoltype()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbcoltype </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the datatype of a regular result set column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>SYB*</code> datetype token value, or zero if <em>column</em> out of range </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga89fc5589b4bf41932324d2cfc6ad6433" title="Get size of a regular result column. ">dbcollen()</a>, <a class="el" href="a00518.html#gad06f5deddac18604dfa858b2580e232f" title="Return name of a regular result column. ">dbcolname()</a>, <a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16" title="Get address of data in a regular result column. ">dbdata()</a>, <a class="el" href="a00518.html#gae666d141533126babb0235af21bdca0f" title="Get size of current row's data in a regular result column. ">dbdatlen()</a>, <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a>, <a class="el" href="a00518.html#gac25ae21ca19777ffab1c013bd6049ebf" title="Print a token value's name to a buffer. ">dbprtype()</a>, <a class="el" href="a00518.html#ga57c856964a9a0b4cc43f5192647c51e7" title="Determine whether a column can vary in size. ">dbvarylen()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga636e6f1b64743f3cf22158a56eef371f_cgraph.svg" width="244" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga3c33e72c41b40e08dbcfdfa0d16bc399"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga3c33e72c41b40e08dbcfdfa0d16bc399">§ </a></span>dbcoltypeinfo()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a01269.html">DBTYPEINFO</a>* dbcoltypeinfo </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get precision and scale information for a regular result column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Pointer to a DBTYPEINFO structure . NULL <em>column</em> is out of range. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga89fc5589b4bf41932324d2cfc6ad6433" title="Get size of a regular result column. ">dbcollen()</a>, <a class="el" href="a00518.html#gad06f5deddac18604dfa858b2580e232f" title="Return name of a regular result column. ">dbcolname()</a>, <a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f" title="Get the datatype of a regular result set column. ">dbcoltype()</a>, <a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16" title="Get address of data in a regular result column. ">dbdata()</a>, <a class="el" href="a00518.html#gae666d141533126babb0235af21bdca0f" title="Get size of current row's data in a regular result column. ">dbdatlen()</a>, <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a>, <a class="el" href="a00518.html#gac25ae21ca19777ffab1c013bd6049ebf" title="Print a token value's name to a buffer. ">dbprtype()</a>, <a class="el" href="a00518.html#ga57c856964a9a0b4cc43f5192647c51e7" title="Determine whether a column can vary in size. ">dbvarylen()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga3c33e72c41b40e08dbcfdfa0d16bc399_cgraph.svg" width="267" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gab33d2f4fd44f50e55b6c71902db4fdae"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab33d2f4fd44f50e55b6c71902db4fdae">§ </a></span>dbcolutype()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbcolutype </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get user-defined datatype of a regular result column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>SYB*</code> datetype token value, or -1 if <em>column</em> out of range </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gaf1c00d83dfa88dc99a3fb449c49660ea" title="Get user-defined datatype of a compute column. ">dbaltutype()</a>, <a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f" title="Get the datatype of a regular result set column. ">dbcoltype()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gab33d2f4fd44f50e55b6c71902db4fdae_cgraph.svg" width="251" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga32eb72f6fb3edb130e59fb3dd0766e7e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga32eb72f6fb3edb130e59fb3dd0766e7e">§ </a></span>dbconvert()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbconvert </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>srctype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const BYTE * </td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>srclen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>desttype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BYTE * </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>destlen</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>cf. </p>
<p><a class="el" href="a00518.html#ga8b00d5cdcaa20cba13fa2e03d52a443e" title="Convert one datatype to another. ">dbconvert_ps()</a>, above</p>
<p><em>Sybase:</em> Convert numeric types. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">srctype</td><td>datatype of the data to convert. </td></tr>
<tr><td class="paramname">src</td><td>buffer to convert </td></tr>
<tr><td class="paramname">srclen</td><td>length of <em>src</em> </td></tr>
<tr><td class="paramname">desttype</td><td>target datatype </td></tr>
<tr><td class="paramname">dest</td><td>output buffer </td></tr>
<tr><td class="paramname">destlen</td><td>size of <em>dest</em> </td></tr>
<tr><td class="paramname">typeinfo</td><td>address of a <code>DBTYPEINFO</code> structure that governs the precision & scale of the output, may be <code>NULL</code>. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gafefd17e15b22adda84366c817178dd7d" title="Bind a compute column to a program variable. ">dbaltbind()</a>, dbaltbind_ps(), <a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795" title="Tie a host variable to a resultset column. ">dbbind()</a>, dbbind_ps(), <a class="el" href="a00518.html#ga8b00d5cdcaa20cba13fa2e03d52a443e" title="Convert one datatype to another. ">dbconvert_ps()</a>, <a class="el" href="a00518.html#gab8209543de865f359bdb32829fa8b757" title="Set an error handler, for messages from db-lib. ">dberrhandle()</a>, <a class="el" href="a00518.html#ga399512ec78c15ce3db79ea88ef3b1293" title="Define substitution values to be used when binding null values. ">dbsetnull()</a>, <a class="el" href="a00518.html#gab9aa181fb3081ffb314340cbd71e434d" title="Specify a db-lib version level. ">dbsetversion()</a>, <a class="el" href="a00518.html#gaaf8349999c16b3c36caf5947747a2915" title="Test whether or not a datatype can be converted to another datatype. ">dbwillconvert()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga32eb72f6fb3edb130e59fb3dd0766e7e_cgraph.svg" width="246" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga8b00d5cdcaa20cba13fa2e03d52a443e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga8b00d5cdcaa20cba13fa2e03d52a443e">§ </a></span>dbconvert_ps()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbconvert_ps </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>db_srctype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const BYTE * </td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>srclen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>db_desttype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BYTE * </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>destlen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="a01269.html">DBTYPEINFO</a> * </td>
<td class="paramname"><em>typeinfo</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Convert one datatype to another. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">srctype</td><td>datatype of the data to convert. </td></tr>
<tr><td class="paramname">src</td><td>buffer to convert </td></tr>
<tr><td class="paramname">srclen</td><td>length of <em>src</em> </td></tr>
<tr><td class="paramname">desttype</td><td>target datatype </td></tr>
<tr><td class="paramname">dest</td><td>output buffer </td></tr>
<tr><td class="paramname">destlen</td><td>size of <em>dest</em> </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>On success, the count of output bytes in <em>dest</em>, else -1. On failure, it will call any user-supplied error handler. </dd></dl>
<dl class="section remark"><dt>Remarks</dt><dd>Causes of failure:<ul>
<li>No such conversion unavailable.</li>
<li>Character data output was truncated, or numerical data overflowed or lost precision.</li>
<li>In converting character data to one of the numeric types, the string could not be interpreted as a number.</li>
</ul>
</dd></dl>
<p>Conversion functions are handled in the TDS layer.</p>
<p>The main reason for this is that <code>ct-lib</code> and <code>ODBC</code> (and presumably <code>DBI</code>) need to be able to do conversions between datatypes. This is possible because the format of complex data (dates, money, numeric, decimal) is defined by its representation on the wire; thus what we call <code><a class="el" href="a01249.html">DBMONEY</a></code> is exactly its format on the wire. CLIs that need a different representation (ODBC?) need to convert from this format anyway, so the code would already be in place.</p>
<p>Each datatype is also defined by its Server-type so all CLIs should be able to map native types to server types as well.</p>
<p><a class="el" href="a00530.html#gaa865e08f7ad70ef92b111c2ea3657457" title="tds_convert convert a type to another. ">tds_convert()</a> copies from src to dest and returns the output data length, period. All padding and termination is the responsibility of the API library and is done post-conversion. The peculiar rule in <a class="el" href="a00518.html#ga32eb72f6fb3edb130e59fb3dd0766e7e" title="cf. ">dbconvert()</a> is that a <em>destlen</em> of -1 and a <em>desttype</em> of <code>SYBCHAR</code> means the output buffer should be null-terminated.</p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gafefd17e15b22adda84366c817178dd7d" title="Bind a compute column to a program variable. ">dbaltbind()</a>, dbaltbind_ps(), <a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795" title="Tie a host variable to a resultset column. ">dbbind()</a>, dbbind_ps(), <a class="el" href="a00518.html#ga8b00d5cdcaa20cba13fa2e03d52a443e" title="Convert one datatype to another. ">dbconvert_ps()</a>, <a class="el" href="a00518.html#gab8209543de865f359bdb32829fa8b757" title="Set an error handler, for messages from db-lib. ">dberrhandle()</a>, <a class="el" href="a00518.html#ga399512ec78c15ce3db79ea88ef3b1293" title="Define substitution values to be used when binding null values. ">dbsetnull()</a>, <a class="el" href="a00518.html#gab9aa181fb3081ffb314340cbd71e434d" title="Specify a db-lib version level. ">dbsetversion()</a>, <a class="el" href="a00518.html#gaaf8349999c16b3c36caf5947747a2915" title="Test whether or not a datatype can be converted to another datatype. ">dbwillconvert()</a>. </dd></dl>
<dl class="todo"><dt><b><a class="el" href="a00515.html#_todo000007">Todo:</a></b></dt><dd><p class="startdd">What happens if client does not reset values? </p>
<p class="enddd">Microsoft and Sybase define this function differently. </p>
</dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga8b00d5cdcaa20cba13fa2e03d52a443e_cgraph.svg" width="268" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga9433bc200c0978569964354451d9b64e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9433bc200c0978569964354451d9b64e">§ </a></span>dbcount()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbcount </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get count of rows processed. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><ul>
<li>for insert/update/delete, count of rows affected.</li>
<li>for select, count of rows returned, after all rows have been fetched. </li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga0ac1828f731a21c591c8d6330cbba3a9" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBCOUNT()</a>, dbnextrow(), <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga9433bc200c0978569964354451d9b64e_cgraph.svg" width="232" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaee60c306a22383805a4b9caa647a1e16"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaee60c306a22383805a4b9caa647a1e16">§ </a></span>dbdata()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">BYTE* dbdata </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get address of data in a regular result column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>pointer the data, or NULL if data are NULL, or if <em>column</em> is out of range. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795" title="Tie a host variable to a resultset column. ">dbbind()</a>, <a class="el" href="a00518.html#ga89fc5589b4bf41932324d2cfc6ad6433" title="Get size of a regular result column. ">dbcollen()</a>, <a class="el" href="a00518.html#gad06f5deddac18604dfa858b2580e232f" title="Return name of a regular result column. ">dbcolname()</a>, <a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f" title="Get the datatype of a regular result set column. ">dbcoltype()</a>, <a class="el" href="a00518.html#gae666d141533126babb0235af21bdca0f" title="Get size of current row's data in a regular result column. ">dbdatlen()</a>, <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaee60c306a22383805a4b9caa647a1e16_cgraph.svg" width="227" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga46f3641b79a2e90371a66950b6db2c4d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga46f3641b79a2e90371a66950b6db2c4d">§ </a></span>dbdatecrack()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbdatecrack </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="a01289.html">DBDATEREC</a> * </td>
<td class="paramname"><em>di</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="a01257.html">DBDATETIME</a> * </td>
<td class="paramname"><em>datetime</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Break a <a class="el" href="a01257.html">DBDATETIME</a> value into useful pieces. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">di</td><td><em>output:</em> structure to contain the exploded parts of <em>datetime</em>. </td></tr>
<tr><td class="paramname">datetime</td><td><em>input:</em> <code><a class="el" href="a01257.html">DBDATETIME</a></code> to be converted. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>always. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>The members of <em>di</em> have different names, depending on whether <code>–with-msdblib</code> was configured.</dd></dl>
<p>If DBPROCESS is NULL, <a class="el" href="a00518.html#ga46f3641b79a2e90371a66950b6db2c4d" title="Break a DBDATETIME value into useful pieces. ">dbdatecrack()</a> uses the compiled in default value of MSDBLIB as of when libsybdb was compiled, irrespective of its value when the application is compiled. This can lead to incorrect results because Sybase and Microsoft use different ranges – [0,11] vs. [1,12] – for the month.</p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga32eb72f6fb3edb130e59fb3dd0766e7e" title="cf. ">dbconvert()</a>, <a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16" title="Get address of data in a regular result column. ">dbdata()</a>, dbdatechar(), dbdatename(), dbdatepart(), <a class="el" href="a00524.html#ga2c99ec565452279e9a382451d89642eb" title="Form a connection with the server. ">tdsdbopen()</a>. </dd></dl>
</div>
</div>
<a id="gae666d141533126babb0235af21bdca0f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae666d141533126babb0235af21bdca0f">§ </a></span>dbdatlen()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbdatlen </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get size of current row's data in a regular result column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>size of the data, in bytes. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga89fc5589b4bf41932324d2cfc6ad6433" title="Get size of a regular result column. ">dbcollen()</a>, <a class="el" href="a00518.html#gad06f5deddac18604dfa858b2580e232f" title="Return name of a regular result column. ">dbcolname()</a>, <a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f" title="Get the datatype of a regular result set column. ">dbcoltype()</a>, <a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16" title="Get address of data in a regular result column. ">dbdata()</a>, <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gae666d141533126babb0235af21bdca0f_cgraph.svg" width="238" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gab8209543de865f359bdb32829fa8b757"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab8209543de865f359bdb32829fa8b757">§ </a></span>dberrhandle()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EHANDLEFUNC dberrhandle </td>
<td>(</td>
<td class="paramtype">EHANDLEFUNC </td>
<td class="paramname"><em>handler</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set an error handler, for messages from db-lib. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">handler</td><td>pointer to callback function that will handle errors. Pass NULL to restore the default handler. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>address of prior handler, or NULL if none was previously installed. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga2c7b5eec4843ea326b21f2db2ded2754" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBDEAD()</a>, <a class="el" href="a00518.html#gadc8af9a65f3719804c2537fd737298ca" title="Set a message handler, for messages from the server. ">dbmsghandle()</a>. </dd></dl>
</div>
</div>
<a id="gad0044401c8c83205583f93a4764f2d8b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad0044401c8c83205583f93a4764f2d8b">§ </a></span>dbexit()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void dbexit </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Close server connections and free all related structures. </p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gaef740b394b44eb33925c2718f7b30d69" title="Close a connection to the server and free associated resources. ">dbclose()</a>, <a class="el" href="a00518.html#ga564dd3a1bb0425a8957f1714d8b2a7c0" title="Initialize db-lib. ">dbinit()</a>, <a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a>. </dd></dl>
<dl class="todo"><dt><b><a class="el" href="a00515.html#_todo000006">Todo:</a></b></dt><dd>breaks if ctlib/dblib used in same process. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gad0044401c8c83205583f93a4764f2d8b_cgraph.svg" width="220" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga43727b10d4cbb7708b374811abe6eadb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga43727b10d4cbb7708b374811abe6eadb">§ </a></span>dbfcmd()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbfcmd </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>fmt</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"><em>...</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p><code>printf-like</code> way to form SQL to send to the server. </p>
<p>Forms a command string and writes to the command buffer with <a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a>. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">fmt</td><td><code> man vasprintf</code> for details. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>success. </td></tr>
<tr><td class="paramname">FAIL</td><td>insufficient memory, or <a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a> failed. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a>, <a class="el" href="a00518.html#ga0fcfcf6846442dac9dd5584d270ec72a" title="Erase the command buffer, in case DBNOAUTOFREE was set with dbsetopt(). ">dbfreebuf()</a>, <a class="el" href="a00518.html#gaf917cf746c954a5d1b718afe3c4d1940" title="Get address of a position in the command buffer. ">dbgetchar()</a>, <a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a>, <a class="el" href="a00518.html#gaf130b12e9e58b1bfd4a6685e33f5b3cd" title="Get a copy of a chunk of the command buffer. ">dbstrcpy()</a>, <a class="el" href="a00518.html#ga13caa07ec45cd6f64e9197d29e3cfe5e" title="Get size of the command buffer, in bytes. ">dbstrlen()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga43727b10d4cbb7708b374811abe6eadb_cgraph.svg" width="228" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga0fcfcf6846442dac9dd5584d270ec72a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga0fcfcf6846442dac9dd5584d270ec72a">§ </a></span>dbfreebuf()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void dbfreebuf </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Erase the command buffer, in case <code>DBNOAUTOFREE</code> was set with <a class="el" href="a00518.html#ga9d660d278f3f58871b4086c0e175f4c6" title="Set db-lib or server option. ">dbsetopt()</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a>, <a class="el" href="a00518.html#ga43727b10d4cbb7708b374811abe6eadb" title="printf-like way to form SQL to send to the server. ">dbfcmd()</a>, <a class="el" href="a00518.html#gaf917cf746c954a5d1b718afe3c4d1940" title="Get address of a position in the command buffer. ">dbgetchar()</a>, <a class="el" href="a00518.html#gaae889abeb145ec41f7361aa8f597fe46" title="send the SQL command to the server and wait for an answer. ">dbsqlexec()</a>, <a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481" title="Transmit the command buffer to the server. ">dbsqlsend()</a>, <a class="el" href="a00518.html#ga9d660d278f3f58871b4086c0e175f4c6" title="Set db-lib or server option. ">dbsetopt()</a>, <a class="el" href="a00518.html#gaf130b12e9e58b1bfd4a6685e33f5b3cd" title="Get a copy of a chunk of the command buffer. ">dbstrcpy()</a>, <a class="el" href="a00518.html#ga13caa07ec45cd6f64e9197d29e3cfe5e" title="Get size of the command buffer, in bytes. ">dbstrlen()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga0fcfcf6846442dac9dd5584d270ec72a_cgraph.svg" width="242" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaf917cf746c954a5d1b718afe3c4d1940"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf917cf746c954a5d1b718afe3c4d1940">§ </a></span>dbgetchar()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* dbgetchar </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>pos</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get address of a position in the command buffer. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">pos</td><td>offset within the command buffer, starting at <em>0</em>. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>A bit overspecialized, this one. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a>, <a class="el" href="a00518.html#ga43727b10d4cbb7708b374811abe6eadb" title="printf-like way to form SQL to send to the server. ">dbfcmd()</a>, <a class="el" href="a00518.html#ga0fcfcf6846442dac9dd5584d270ec72a" title="Erase the command buffer, in case DBNOAUTOFREE was set with dbsetopt(). ">dbfreebuf()</a>, <a class="el" href="a00518.html#gaf130b12e9e58b1bfd4a6685e33f5b3cd" title="Get a copy of a chunk of the command buffer. ">dbstrcpy()</a>, <a class="el" href="a00518.html#ga13caa07ec45cd6f64e9197d29e3cfe5e" title="Get size of the command buffer, in bytes. ">dbstrlen()</a>, </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaf917cf746c954a5d1b718afe3c4d1940_cgraph.svg" width="247" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gadb34c5c2aae50ac9f2a26d8984136997"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gadb34c5c2aae50ac9f2a26d8984136997">§ </a></span>dbgetmaxprocs()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbgetmaxprocs </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>get maximum simultaneous connections db-lib will open to the server. </p>
<dl class="section return"><dt>Returns</dt><dd>Current maximum. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gaf2ca0e63f800b3839684c894ff651dd4" title="Set maximum simultaneous connections db-lib will open to the server. ">dbsetmaxprocs()</a>, <a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a> </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gadb34c5c2aae50ac9f2a26d8984136997_cgraph.svg" width="280" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gabaf9aa756f7cb8bbec80d1c7201c6238"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gabaf9aa756f7cb8bbec80d1c7201c6238">§ </a></span>dbgetpacket()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbgetpacket </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get TDS packet size for the connection. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>TDS packet size, in bytes. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gae7e59f9c3cc0ec5916c06977ff7d8565" title="Set the packet size in the login packet for new connections. ">DBSETLPACKET()</a> </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gabaf9aa756f7cb8bbec80d1c7201c6238_cgraph.svg" width="260" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga60fe544491c760f8bc6c37bc7f777d70"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga60fe544491c760f8bc6c37bc7f777d70">§ </a></span>dbgetrow()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbgetrow </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>row</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Read a row from the row buffer. </p>
<p>When row buffering is enabled (DBBUFFER option is on), the client can use <a class="el" href="a00518.html#ga60fe544491c760f8bc6c37bc7f777d70" title="Read a row from the row buffer. ">dbgetrow()</a> to re-read a row previously fetched with dbnextrow(). The effect is to move the row pointer – analogous to fseek() – back to <em>row</em>. Calls to dbnextrow() read from <em>row</em> + 1 until the buffer is exhausted, at which point it resumes its normal behavior, except that as each row is fetched from the server, it is added to the row buffer (in addition to being returned to the client). When the buffer is filled, dbnextrow() returns <code>FAIL</code> until the buffer is at least partially emptied with <a class="el" href="a00518.html#ga01404b179a251c249aecfdae72ec6ca4" title="Clear n rows from the row buffer. ">dbclrbuf()</a>. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">row</td><td>Nth row to read, starting with 1. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">REG_ROW</td><td>returned row is a regular row. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>computeid when returned row is a compute row. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">NO_MORE_ROWS</td><td>no such row in the row buffer. Current row is unchanged. </td></tr>
<tr><td class="paramname">FAIL</td><td>unsuccessful; row buffer may be full. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gafefd17e15b22adda84366c817178dd7d" title="Bind a compute column to a program variable. ">dbaltbind()</a>, <a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795" title="Tie a host variable to a resultset column. ">dbbind()</a>, <a class="el" href="a00518.html#ga01404b179a251c249aecfdae72ec6ca4" title="Clear n rows from the row buffer. ">dbclrbuf()</a>, <a class="el" href="a00518.html#gaf49e4b58918bfa4d4adaa14ee5bb375c" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBCURROW()</a>, <a class="el" href="a00518.html#ga97a6493786124215ec9fe4b4bd2d7cbb" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBFIRSTROW()</a>, <a class="el" href="a00518.html#ga10b9b26cf9a901146e9675a9e678632b" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBLASTROW()</a>, dbnextrow(), <a class="el" href="a00518.html#gaeb3d621e4f6846bb228b0a596d8758c0" title="Make a buffered row "current" without fetching it into bound variables. ">dbsetrow()</a>. </dd></dl>
</div>
</div>
<a id="ga6ccffbb3f0cfb10883ad349f1e47c50e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6ccffbb3f0cfb10883ad349f1e47c50e">§ </a></span>dbgettime()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbgettime </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get maximum seconds db-lib waits for a server response to query. </p>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">query</td><td>timeout limit, in seconds </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gab8209543de865f359bdb32829fa8b757" title="Set an error handler, for messages from db-lib. ">dberrhandle()</a>, DBSETTIME(), <a class="el" href="a00518.html#ga5f1281c07dde5a6d28e60ef62c501d1d" title="Set maximum seconds db-lib waits for a server response to a login attempt. ">dbsetlogintime()</a>, <a class="el" href="a00518.html#gaae889abeb145ec41f7361aa8f597fe46" title="send the SQL command to the server and wait for an answer. ">dbsqlexec()</a>, <a class="el" href="a00518.html#gae1f50a6a2c31fda57cb481922b06841e" title="Wait for results of a query from the server. ">dbsqlok()</a>, <a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481" title="Transmit the command buffer to the server. ">dbsqlsend()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga6ccffbb3f0cfb10883ad349f1e47c50e_cgraph.svg" width="244" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaa5714a91d7c14365fa1e5b164bb2b0b6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa5714a91d7c14365fa1e5b164bb2b0b6">§ </a></span>dbgetuserdata()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">BYTE* dbgetuserdata </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get address of user-allocated data from a <code>DBPROCESS</code>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>address of user-defined data that <code>db-lib</code> associated with <em>dbproc</em> when the client called <a class="el" href="a00518.html#gabea9c70d02bf3e46bbb1d759915cb91e" title="Associate client-allocated (and defined) data with a DBPROCESS. ">dbsetuserdata()</a>. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">undefined</td><td>(probably <code>NULL</code>) <a class="el" href="a00518.html#gabea9c70d02bf3e46bbb1d759915cb91e" title="Associate client-allocated (and defined) data with a DBPROCESS. ">dbsetuserdata()</a> was not previously called. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gabea9c70d02bf3e46bbb1d759915cb91e" title="Associate client-allocated (and defined) data with a DBPROCESS. ">dbsetuserdata()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaa5714a91d7c14365fa1e5b164bb2b0b6_cgraph.svg" width="274" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga564dd3a1bb0425a8957f1714d8b2a7c0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga564dd3a1bb0425a8957f1714d8b2a7c0">§ </a></span>dbinit()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbinit </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Initialize db-lib. </p>
<dl class="section remark"><dt>Remarks</dt><dd>Call this function before trying to use db-lib in any way. Allocates various internal structures and reads <code>locales.conf</code> (if any) to determine the default date format. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>normal. </td></tr>
<tr><td class="paramname">FAIL</td><td>cannot allocate an array of <code>TDS_MAX_CONN</code> <code>TDSSOCKET</code> pointers. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga6ba2a7f18cb76d24776e45fd71141494"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6ba2a7f18cb76d24776e45fd71141494">§ </a></span>dbiscount()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">BOOL dbiscount </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Indicates whether or not the count returned by dbcount is real (Microsoft-compatibility feature). </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>TRUE if the count returned by dbcount is real or FALSE if the count returned by dbcount is not real. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga0ac1828f731a21c591c8d6330cbba3a9" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBCOUNT()</a>, <a class="el" href="a00518.html#ga9433bc200c0978569964354451d9b64e" title="Get count of rows processed. ">dbcount()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga6ba2a7f18cb76d24776e45fd71141494_cgraph.svg" width="243" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gac3eb8cb53f50998403ea9aebc6263df9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac3eb8cb53f50998403ea9aebc6263df9">§ </a></span>dbisopt()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBBOOL dbisopt </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>option</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char </td>
<td class="paramname"><em>param</em>[] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get value of an option. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">option</td><td>the option </td></tr>
<tr><td class="paramname">param</td><td>a parameter to <em>option</em>. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga93ee3c8ca34a08588f88784898fd69e0" title="Reset an option. ">dbclropt()</a>, <a class="el" href="a00518.html#ga9d660d278f3f58871b4086c0e175f4c6" title="Set db-lib or server option. ">dbsetopt()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gac3eb8cb53f50998403ea9aebc6263df9_cgraph.svg" width="228" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga0984798bb806f7451a53bffa7e2c430f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga0984798bb806f7451a53bffa7e2c430f">§ </a></span>dblogin()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a00565.html">LOGINREC</a>* dblogin </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Allocate a <code><a class="el" href="a00565.html">LOGINREC</a></code> structure. </p>
<dl class="section remark"><dt>Remarks</dt><dd>A <code><a class="el" href="a00565.html">LOGINREC</a></code> structure is passed to <code><a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a></code> to create a connection to the database. Does not communicate to the server; interacts strictly with library. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">NULL</td><td>the <code><a class="el" href="a00565.html">LOGINREC</a></code> cannot be allocated. </td></tr>
<tr><td class="paramname">LOGINREC*</td><td>to valid memory, otherwise. </td></tr>
</table>
</dd>
</dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga0984798bb806f7451a53bffa7e2c430f_cgraph.svg" width="228" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gac1bdb1766b791153f37dceae8ff64ad6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac1bdb1766b791153f37dceae8ff64ad6">§ </a></span>dbloginfree()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void dbloginfree </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00565.html">LOGINREC</a> * </td>
<td class="paramname"><em>login</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>free the <code><a class="el" href="a00565.html">LOGINREC</a></code> </p>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gac1bdb1766b791153f37dceae8ff64ad6_cgraph.svg" width="254" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gac3ba9f53cc77e4dde8f48335ed94ac19"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac3ba9f53cc77e4dde8f48335ed94ac19">§ </a></span>dbmorecmds()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbmorecmds </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>See if more commands are to be processed. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gad887bdce8cb0d3b8c6aaf659eb477b48" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBMORECMDS()</a>. <a class="el" href="a00518.html#ga8b263669ce0312e52b5ea42a57a56838" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBCMDROW()</a>, <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a>, <a class="el" href="a00518.html#ga48d71b32c26703c810191ef916c5448c" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBROWS()</a>, <a class="el" href="a00518.html#ga6fda3f4982dda5825d13fee392e89fd9" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBROWTYPE()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gac3ba9f53cc77e4dde8f48335ed94ac19_cgraph.svg" width="264" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga6f13381522a1fa0b6ce2c15378088cdd"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6f13381522a1fa0b6ce2c15378088cdd">§ </a></span>dbmoretext()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbmoretext </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>size</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const BYTE </td>
<td class="paramname"><em>text</em>[] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Send chunk of a text/image value to the server. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">size</td><td>count of bytes to send. </td></tr>
<tr><td class="paramname">text</td><td>textpointer, obtained from dbtxptr. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>always. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga57e4098b153a030f0be02bcd98e08ba2" title="Get text pointer for a column in the current row. ">dbtxptr()</a>, <a class="el" href="a00518.html#gac3f11142ec7ff25b1f8972af10fe9454" title="Get text timestamp for a column in the current row. ">dbtxtimestamp()</a>, <a class="el" href="a00518.html#ga548153eb2eae76c48aa9d4b72258dc1c" title="Send text or image data to the server. ">dbwritetext()</a>. </dd></dl>
<dl class="todo"><dt><b><a class="el" href="a00515.html#_todo000015">Todo:</a></b></dt><dd>Check return value of called functions and return <code>FAIL</code> if appropriate. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga6f13381522a1fa0b6ce2c15378088cdd_cgraph.svg" width="254" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gadc8af9a65f3719804c2537fd737298ca"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gadc8af9a65f3719804c2537fd737298ca">§ </a></span>dbmsghandle()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">MHANDLEFUNC dbmsghandle </td>
<td>(</td>
<td class="paramtype">MHANDLEFUNC </td>
<td class="paramname"><em>handler</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set a message handler, for messages from the server. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">handler</td><td>address of the function that will process the messages. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga2c7b5eec4843ea326b21f2db2ded2754" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBDEAD()</a>, <a class="el" href="a00518.html#gab8209543de865f359bdb32829fa8b757" title="Set an error handler, for messages from db-lib. ">dberrhandle()</a>. </dd></dl>
</div>
</div>
<a id="gab185982ffe0b85b8fd19747bd1f433fe"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab185982ffe0b85b8fd19747bd1f433fe">§ </a></span>dbname()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* dbname </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get name of current database. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>current database name, as null-terminated ASCII string. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga8cbc761b1266bd947783d843aeeec264" title="See if a command caused the current database to change. ">dbchange()</a>, <a class="el" href="a00518.html#ga66ea891910f0a357cc78107d6ab7d962" title="Change current database. ">dbuse()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gab185982ffe0b85b8fd19747bd1f433fe_cgraph.svg" width="234" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga85dcc40c3615f94be96b09b2ec043533"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga85dcc40c3615f94be96b09b2ec043533">§ </a></span>dbnullbind()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbnullbind </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT * </td>
<td class="paramname"><em>indicator</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Tie a null-indicator to a regular result column. </p>
<p>When a row is fetched, the indicator variable tells the state of the column's data.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth column in the result set, starting with 1. </td></tr>
<tr><td class="paramname">indicator</td><td>address of host variable. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>variable accepted. </td></tr>
<tr><td class="paramname">FAIL</td><td><em>indicator</em> is NULL or <em>column</em> is out of range. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>Contents of <em>indicator</em> are set with <code>dbnextrow()</code>. Possible values are:<ul>
<li>0 <em>column</em> bound successfully</li>
<li>-1 <em>column</em> is NULL.</li>
<li>>0 true length of data, had <em>column</em> not been truncated due to insufficient space in the columns bound host variable . </li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga939c2a2e67b9992c787e2cec5b6cc1a7" title="Tie a null-indicator to a compute result column. ">dbanullbind()</a>, <a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795" title="Tie a host variable to a resultset column. ">dbbind()</a>, <a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16" title="Get address of data in a regular result column. ">dbdata()</a>, <a class="el" href="a00518.html#gae666d141533126babb0235af21bdca0f" title="Get size of current row's data in a regular result column. ">dbdatlen()</a>, dbnextrow(). </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga85dcc40c3615f94be96b09b2ec043533_cgraph.svg" width="246" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga67934deac3bebbf8238eff8c0559389a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga67934deac3bebbf8238eff8c0559389a">§ </a></span>dbnumalts()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbnumalts </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>computeid</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get count of columns in a compute row. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">computeid</td><td>of <code>COMPUTE</code> clause to which we're referring. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>number of columns, else -1 if no such <em>computeid</em>. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gabcc14a1ca58b65bc46cce6c81c45218c" title="Get address of compute column data. ">dbadata()</a>, <a class="el" href="a00518.html#ga3340e21db274b272ec11c037cb147222" title="Get size of data in a compute column. ">dbadlen()</a>, <a class="el" href="a00518.html#ga9a35c8d3cd0e35c10555baf8f6a01e93" title="Get size of data in compute column. ">dbaltlen()</a>, <a class="el" href="a00518.html#gaa85171e020dc606f2bd3395ad1d3ab4f" title="Get datatype for a compute column. ">dbalttype()</a>, <a class="el" href="a00518.html#ga60fe544491c760f8bc6c37bc7f777d70" title="Read a row from the row buffer. ">dbgetrow()</a>, dbnextrow(), <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga67934deac3bebbf8238eff8c0559389a_cgraph.svg" width="247" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gadaa9482a082aa3fe52231e17749c2993"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gadaa9482a082aa3fe52231e17749c2993">§ </a></span>dbnumcols()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbnumcols </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Return number of regular columns in a result set. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga89fc5589b4bf41932324d2cfc6ad6433" title="Get size of a regular result column. ">dbcollen()</a>, <a class="el" href="a00518.html#gad06f5deddac18604dfa858b2580e232f" title="Return name of a regular result column. ">dbcolname()</a>, <a class="el" href="a00518.html#ga67934deac3bebbf8238eff8c0559389a" title="Get count of columns in a compute row. ">dbnumalts()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gadaa9482a082aa3fe52231e17749c2993_cgraph.svg" width="250" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gac554d2cb2da0c9f9fd3d4867998edcc4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac554d2cb2da0c9f9fd3d4867998edcc4">§ </a></span>dbnumcompute()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbnumcompute </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get count of <code>COMPUTE</code> clauses for a result set. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>number of compute clauses for the current query, possibly zero. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga67934deac3bebbf8238eff8c0559389a" title="Get count of columns in a compute row. ">dbnumalts()</a>, <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gac554d2cb2da0c9f9fd3d4867998edcc4_cgraph.svg" width="278" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gac0cb0584f6500d61a2ac95a891da73eb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac0cb0584f6500d61a2ac95a891da73eb">§ </a></span>dbprcollen()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbprcollen </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get size of a result column needed to print column. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>size of the column in characters (not of data in any particular row). On error, -1. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gad06f5deddac18604dfa858b2580e232f" title="Return name of a regular result column. ">dbcolname()</a>, <a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f" title="Get the datatype of a regular result set column. ">dbcoltype()</a>, <a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16" title="Get address of data in a regular result column. ">dbdata()</a>, <a class="el" href="a00518.html#gae666d141533126babb0235af21bdca0f" title="Get size of current row's data in a regular result column. ">dbdatlen()</a>, <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gac0cb0584f6500d61a2ac95a891da73eb_cgraph.svg" width="248" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga9dfc2ee533e5e48a7aa8ca22f8d9ed79"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9dfc2ee533e5e48a7aa8ca22f8d9ed79">§ </a></span>dbprhead()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void dbprhead </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Print result set headings to stdout. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd></dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga9dfc2ee533e5e48a7aa8ca22f8d9ed79_cgraph.svg" width="244" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaa30be3414a97aac6139af2e928db91ca"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa30be3414a97aac6139af2e928db91ca">§ </a></span>dbprrow()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbprrow </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Print a result set to stdout. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795" title="Tie a host variable to a resultset column. ">dbbind()</a>, dbnextrow(), <a class="el" href="a00518.html#ga9dfc2ee533e5e48a7aa8ca22f8d9ed79" title="Print result set headings to stdout. ">dbprhead()</a>, <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a>, <a class="el" href="a00518.html#gaf641c8e3d34607ca8b7ac2afed3e6d67" title="Print a regular result row to a buffer. ">dbspr1row()</a>, <a class="el" href="a00518.html#gaaa4839a9c88e5b90f33bd2407fcbc43e" title="Print result set headings to a buffer. ">dbsprhead()</a>, <a class="el" href="a00518.html#gacfaf9feb29c87cfb660886162f643152" title="Get formatted string for underlining dbsprhead() column names. ">dbsprline()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaa30be3414a97aac6139af2e928db91ca_cgraph.svg" width="235" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gac25ae21ca19777ffab1c013bd6049ebf"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac25ae21ca19777ffab1c013bd6049ebf">§ </a></span>dbprtype()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* dbprtype </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>token</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Print a token value's name to a buffer. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">token</td><td>server SYB* value, e.g. SYBINT.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>ASCII null-terminated string. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga947837a5c8fd99898c043435945b668c" title="Get aggregation operator for a compute column. ">dbaltop()</a>, <a class="el" href="a00518.html#gaa85171e020dc606f2bd3395ad1d3ab4f" title="Get datatype for a compute column. ">dbalttype()</a>, <a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f" title="Get the datatype of a regular result set column. ">dbcoltype()</a>, <a class="el" href="a00519.html#gaa478c8b96923bca02d158d966172ec1b" title="Get datatype of a stored procedure's return parameter. ">dbrettype()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gac25ae21ca19777ffab1c013bd6049ebf_cgraph.svg" width="239" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gadd5685565c8c6c86079e17b8a73b324c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gadd5685565c8c6c86079e17b8a73b324c">§ </a></span>dbreadtext()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">STATUS dbreadtext </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>buf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>bufsize</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Fetch part of a text or image value from the server. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">buf</td><td><em>output:</em> buffer into which text will be placed. </td></tr>
<tr><td class="paramname">bufsize</td><td>size of <em>buf</em>, in bytes. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><ul>
<li><code>>0</code> count of bytes placed in <em>buf</em>.</li>
<li><code>0</code> end of row.</li>
<li><code>-1</code> <em>error</em>, no result set ready for <em>dbproc</em>.</li>
<li><code>NO_MORE_ROWS</code> all rows read, no further data. </li>
</ul>
</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga6f13381522a1fa0b6ce2c15378088cdd" title="Send chunk of a text/image value to the server. ">dbmoretext()</a>, dbnextrow(), <a class="el" href="a00518.html#ga548153eb2eae76c48aa9d4b72258dc1c" title="Send text or image data to the server. ">dbwritetext()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gadd5685565c8c6c86079e17b8a73b324c_cgraph.svg" width="251" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gabb14ad9f268b92a8d63fa506098b24dd"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gabb14ad9f268b92a8d63fa506098b24dd">§ </a></span>dbrecftos()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void dbrecftos </td>
<td>(</td>
<td class="paramtype">const char </td>
<td class="paramname"><em>filename</em>[]</td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Record to a file all SQL commands sent to the server. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>name of file to write to. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>Files are named <em>filename.n</em>, where n is an integer, starting with 0, and incremented with each callto <a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a>. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a>, TDSDUMP environment variable(). </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gabb14ad9f268b92a8d63fa506098b24dd_cgraph.svg" width="242" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga4e26d949be2c3bf71b1a33c75b11d931"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4e26d949be2c3bf71b1a33c75b11d931">§ </a></span>dbresults()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbresults </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set up query results. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>Some results are available. </td></tr>
<tr><td class="paramname">FAIL</td><td>query was not processed successfully by the server </td></tr>
<tr><td class="paramname">NO_MORE_RESULTS</td><td>query produced no results.</td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>Call <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a> after calling <a class="el" href="a00518.html#gaae889abeb145ec41f7361aa8f597fe46" title="send the SQL command to the server and wait for an answer. ">dbsqlexec()</a> or <a class="el" href="a00518.html#gae1f50a6a2c31fda57cb481922b06841e" title="Wait for results of a query from the server. ">dbsqlok()</a>, or <a class="el" href="a00519.html#gafa4dfd181be21e49c397f7daaa9cf96c" title="Execute the procedure and free associated memory. ">dbrpcsend()</a> returns SUCCEED. Unless one of them fails, dbresults will return either SUCCEED or NO_MORE_RESULTS.</dd></dl>
<p>The meaning of <em>results</em> is very specific and not very intuitive. Results are created by either</p><ul>
<li><p class="startli">a SELECT statement</p><ul>
<li>a stored procedure</li>
</ul>
<p class="startli">When dbresults returns SUCCEED, therefore, it indicates the server processed the query successfully and that one or more of these is present:</p>
</li>
<li>metadata – <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a> returns 1 or more</li>
<li>data – dbnextrow() returns SUCCEED</li>
<li>return status – <a class="el" href="a00519.html#ga7a5062dac92ccedc8459f6d4a530ffb7" title="Determine if query generated a return status number. ">dbhasretstat()</a> returns TRUE</li>
<li>output parameters – <a class="el" href="a00519.html#gaff09873008411a0573f6d1a9e6c7cf4b" title="Get count of output parameters filled by a stored procedure. ">dbnumrets()</a> returns 1 or more</li>
</ul>
<p>If none of the above are present, <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a> returns NO_MORE_RESULTS.</p>
<p>SUCCEED does not imply that <a class="el" href="a00518.html#ga48d71b32c26703c810191ef916c5448c" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBROWS()</a> will return TRUE or even that <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a> will return nonzero. A general algorithm for reading results will call <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a> until it return NO_MORE_RESULTS (or FAIL). An application should check for all the above kinds of results within the <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a> loop.</p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gaae889abeb145ec41f7361aa8f597fe46" title="send the SQL command to the server and wait for an answer. ">dbsqlexec()</a>, <a class="el" href="a00518.html#gae1f50a6a2c31fda57cb481922b06841e" title="Wait for results of a query from the server. ">dbsqlok()</a>, <a class="el" href="a00519.html#gafa4dfd181be21e49c397f7daaa9cf96c" title="Execute the procedure and free associated memory. ">dbrpcsend()</a>, <a class="el" href="a00518.html#ga5ea23272124fff03b8d87538c1ec3ee5" title="Cancel the current command batch. ">dbcancel()</a>, <a class="el" href="a00518.html#ga48d71b32c26703c810191ef916c5448c" title="Sybase macro mapping to the Microsoft (lower-case) function. ">DBROWS()</a>, dbnextrow(), <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a>, <a class="el" href="a00519.html#ga7a5062dac92ccedc8459f6d4a530ffb7" title="Determine if query generated a return status number. ">dbhasretstat()</a>, <a class="el" href="a00519.html#ga2306039d73fbc7045f257b0e750c37b4" title="Fetch status value returned by query or remote procedure call. ">dbretstatus()</a>, <a class="el" href="a00519.html#gaff09873008411a0573f6d1a9e6c7cf4b" title="Get count of output parameters filled by a stored procedure. ">dbnumrets()</a> </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga4e26d949be2c3bf71b1a33c75b11d931_cgraph.svg" width="224" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gad0ccc03b94ba2515fd1f5d35559fcb41"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad0ccc03b94ba2515fd1f5d35559fcb41">§ </a></span>dbsafestr()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsafestr </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>srclen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>destlen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>quotetype</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>safely quotes character values in SQL text. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">src</td><td>input string. </td></tr>
<tr><td class="paramname">srclen</td><td>length of <em>src</em> in bytes, or -1 to indicate it's null-terminated. </td></tr>
<tr><td class="paramname">dest</td><td><em>output:</em> client-provided output buffer. </td></tr>
<tr><td class="paramname">destlen</td><td>size of <em>dest</em> in bytes, or -1 to indicate it's "big enough" and the data should be null-terminated. </td></tr>
<tr><td class="paramname">quotetype</td><td><ul>
<li><code>DBSINGLE</code> Doubles all single quotes (').</li>
<li><code>DBDOUBLE</code> Doubles all double quotes (").</li>
<li><code>DBBOTH</code> Doubles all single and double quotes. </li>
</ul>
</td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>everything worked. </td></tr>
<tr><td class="paramname">FAIL</td><td>no such <em>quotetype</em>, or insufficient room in <em>dest</em>. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a>, <a class="el" href="a00518.html#ga43727b10d4cbb7708b374811abe6eadb" title="printf-like way to form SQL to send to the server. ">dbfcmd()</a>. </dd></dl>
</div>
</div>
<a id="ga39302e8efbb476ba01cff109ffb3661e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga39302e8efbb476ba01cff109ffb3661e">§ </a></span>dbservcharset()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* dbservcharset </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get <code>syscharset</code> name of the server character set. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>name of server's charset, as null-terminated ASCII string. </dd></dl>
<dl class="section see"><dt>See also</dt><dd>dbcharsetconv(), dbgetcharset(), <a class="el" href="a00518.html#ga316c0fd24b8dc1259ce9eb4d25016400" title="Set the client character set in the login packet. ">DBSETLCHARSET()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga39302e8efbb476ba01cff109ffb3661e_cgraph.svg" width="272" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga663350909fec3a1d152316c45a65e708"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga663350909fec3a1d152316c45a65e708">§ </a></span>dbsetifile()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void dbsetifile </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"><em>filename</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>set name and location of the <code>interfaces</code> file FreeTDS should use to look up a servername. </p>
<p>Does not affect lookups or location of <code>freetds.conf</code>. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">filename</td><td>name of <code>interfaces</code> </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a> </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga663350909fec3a1d152316c45a65e708_cgraph.svg" width="239" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga335fcbe476ad0f897e4e2ce377f0a8cc"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga335fcbe476ad0f897e4e2ce377f0a8cc">§ </a></span>dbsetinterrupt()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void dbsetinterrupt </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DB_DBCHKINTR_FUNC </td>
<td class="paramname"><em>chkintr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DB_DBHNDLINTR_FUNC </td>
<td class="paramname"><em>hndlintr</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set interrupt handler for db-lib to use while blocked against a read from the server. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">chkintr</td><td></td></tr>
<tr><td class="paramname">hndlintr</td><td></td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga5ea23272124fff03b8d87538c1ec3ee5" title="Cancel the current command batch. ">dbcancel()</a>, <a class="el" href="a00518.html#gaa5714a91d7c14365fa1e5b164bb2b0b6" title="Get address of user-allocated data from a DBPROCESS. ">dbgetuserdata()</a>, <a class="el" href="a00518.html#gabea9c70d02bf3e46bbb1d759915cb91e" title="Associate client-allocated (and defined) data with a DBPROCESS. ">dbsetuserdata()</a>, dbsetbusy(), dbsetidle(). </dd></dl>
</div>
</div>
<a id="ga5f1281c07dde5a6d28e60ef62c501d1d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga5f1281c07dde5a6d28e60ef62c501d1d">§ </a></span>dbsetlogintime()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsetlogintime </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>seconds</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set maximum seconds db-lib waits for a server response to a login attempt. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">seconds</td><td>New limit for application. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>Always. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gab8209543de865f359bdb32829fa8b757" title="Set an error handler, for messages from db-lib. ">dberrhandle()</a>, <a class="el" href="a00518.html#gada4b41f34542a87f0cd87e78e56d18bb" title="Set maximum seconds db-lib waits for a server response to query. ">dbsettime()</a> </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga5f1281c07dde5a6d28e60ef62c501d1d_cgraph.svg" width="274" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaa22dce1ee0eb83059699c34c47d07c14"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaa22dce1ee0eb83059699c34c47d07c14">§ </a></span>dbsetlversion()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsetlversion </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00565.html">LOGINREC</a> * </td>
<td class="paramname"><em>login</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BYTE </td>
<td class="paramname"><em>version</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set TDS version for future connections. </p>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaa22dce1ee0eb83059699c34c47d07c14_cgraph.svg" width="267" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaf2ca0e63f800b3839684c894ff651dd4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf2ca0e63f800b3839684c894ff651dd4">§ </a></span>dbsetmaxprocs()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsetmaxprocs </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>maxprocs</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set maximum simultaneous connections db-lib will open to the server. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">maxprocs</td><td>Limit for process. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>Always. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gadb34c5c2aae50ac9f2a26d8984136997" title="get maximum simultaneous connections db-lib will open to the server. ">dbgetmaxprocs()</a>, <a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a> </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaf2ca0e63f800b3839684c894ff651dd4_cgraph.svg" width="279" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga399512ec78c15ce3db79ea88ef3b1293"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga399512ec78c15ce3db79ea88ef3b1293">§ </a></span>dbsetnull()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsetnull </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>bindtype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>bindlen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BYTE * </td>
<td class="paramname"><em>bindval</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Define substitution values to be used when binding null values. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">bindtype</td><td>type of binding to which the substitute value will apply. </td></tr>
<tr><td class="paramname">bindlen</td><td>size of the substitute value you are supplying, in bytes. Ignored except for CHARBIND and BINARYBIND. </td></tr>
<tr><td class="paramname">bindval</td><td>pointer to a buffer containing the substitute value. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>query was processed without errors. </td></tr>
<tr><td class="paramname">FAIL</td><td>query was not processed </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gafefd17e15b22adda84366c817178dd7d" title="Bind a compute column to a program variable. ">dbaltbind()</a>, <a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795" title="Tie a host variable to a resultset column. ">dbbind()</a>, <a class="el" href="a00518.html#ga32eb72f6fb3edb130e59fb3dd0766e7e" title="cf. ">dbconvert()</a>, <a class="el" href="a00518.html#ga85dcc40c3615f94be96b09b2ec043533" title="Tie a null-indicator to a regular result column. ">dbnullbind()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga399512ec78c15ce3db79ea88ef3b1293_cgraph.svg" width="239" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga9d660d278f3f58871b4086c0e175f4c6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9d660d278f3f58871b4086c0e175f4c6">§ </a></span>dbsetopt()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsetopt </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>option</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>char_param</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>int_param</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set db-lib or server option. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">option</td><td>option to set. </td></tr>
<tr><td class="paramname">char_param</td><td>value to set <em>option</em> to, if it wants a null-teminated ASCII string. </td></tr>
<tr><td class="paramname">int_param</td><td>value to set <em>option</em> to, if it wants an integer value. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>everything worked. </td></tr>
<tr><td class="paramname">FAIL</td><td>no such <em>option</em>, or insufficient memory, or unimplemented. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>Many are unimplemented. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga93ee3c8ca34a08588f88784898fd69e0" title="Reset an option. ">dbclropt()</a>, <a class="el" href="a00518.html#gac3eb8cb53f50998403ea9aebc6263df9" title="Get value of an option. ">dbisopt()</a>. </dd></dl>
<dl class="todo"><dt><b><a class="el" href="a00515.html#_todo000011">Todo:</a></b></dt><dd>Implement more options. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga9d660d278f3f58871b4086c0e175f4c6_cgraph.svg" width="238" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaeb3d621e4f6846bb228b0a596d8758c0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaeb3d621e4f6846bb228b0a596d8758c0">§ </a></span>dbsetrow()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">STATUS dbsetrow </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>row</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Make a buffered row "current" without fetching it into bound variables. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">MORE_ROWS</td><td>row found </td></tr>
<tr><td class="paramname">NO_MORE_ROWS</td><td>row not found </td></tr>
<tr><td class="paramname">FAIL</td><td><em>dbproc</em> is dead or not enabled </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gafefd17e15b22adda84366c817178dd7d" title="Bind a compute column to a program variable. ">dbaltbind()</a>, <a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795" title="Tie a host variable to a resultset column. ">dbbind()</a>, <a class="el" href="a00518.html#ga559e24ba70d0d96c3469eb6ab8f74e05" title="Cancel the query currently being retrieved, discarding all pending rows. ">dbcanquery()</a>, <a class="el" href="a00518.html#ga01404b179a251c249aecfdae72ec6ca4" title="Clear n rows from the row buffer. ">dbclrbuf()</a>, <a class="el" href="a00518.html#ga60fe544491c760f8bc6c37bc7f777d70" title="Read a row from the row buffer. ">dbgetrow()</a>, dbnextrow(), <a class="el" href="a00518.html#gaa30be3414a97aac6139af2e928db91ca" title="Print a result set to stdout. ">dbprrow()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaeb3d621e4f6846bb228b0a596d8758c0_cgraph.svg" width="240" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gada4b41f34542a87f0cd87e78e56d18bb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gada4b41f34542a87f0cd87e78e56d18bb">§ </a></span>dbsettime()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsettime </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>seconds</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set maximum seconds db-lib waits for a server response to query. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">seconds</td><td>New limit for application. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>Always. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gab8209543de865f359bdb32829fa8b757" title="Set an error handler, for messages from db-lib. ">dberrhandle()</a>, DBGETTIME(), <a class="el" href="a00518.html#ga5f1281c07dde5a6d28e60ef62c501d1d" title="Set maximum seconds db-lib waits for a server response to a login attempt. ">dbsetlogintime()</a>, <a class="el" href="a00518.html#gaae889abeb145ec41f7361aa8f597fe46" title="send the SQL command to the server and wait for an answer. ">dbsqlexec()</a>, <a class="el" href="a00518.html#gae1f50a6a2c31fda57cb481922b06841e" title="Wait for results of a query from the server. ">dbsqlok()</a>, <a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481" title="Transmit the command buffer to the server. ">dbsqlsend()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gada4b41f34542a87f0cd87e78e56d18bb_cgraph.svg" width="244" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gabea9c70d02bf3e46bbb1d759915cb91e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gabea9c70d02bf3e46bbb1d759915cb91e">§ </a></span>dbsetuserdata()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void dbsetuserdata </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BYTE * </td>
<td class="paramname"><em>ptr</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Associate client-allocated (and defined) data with a <code>DBPROCESS</code>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">ptr</td><td>address of client-defined data. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd><em>ptr</em> is the location of user data that <code>db-lib</code> will associate with <em>dbproc</em>. The client allocates the buffer addressed by <em>ptr</em>. <code>db-lib</code> never examines or uses the information; it just stashes the pointer for later retrieval by the application with <code><a class="el" href="a00518.html#gaa5714a91d7c14365fa1e5b164bb2b0b6" title="Get address of user-allocated data from a DBPROCESS. ">dbgetuserdata()</a></code>. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gaa5714a91d7c14365fa1e5b164bb2b0b6" title="Get address of user-allocated data from a DBPROCESS. ">dbgetuserdata()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gabea9c70d02bf3e46bbb1d759915cb91e_cgraph.svg" width="272" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gab9aa181fb3081ffb314340cbd71e434d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab9aa181fb3081ffb314340cbd71e434d">§ </a></span>dbsetversion()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsetversion </td>
<td>(</td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>version</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Specify a db-lib version level. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">version</td><td>anything, really. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>Always. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>No effect on behavior of <code>db-lib</code> in <code>FreeTDS</code>. </dd></dl>
<dl class="section see"><dt>See also</dt><dd></dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gab9aa181fb3081ffb314340cbd71e434d_cgraph.svg" width="264" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga223a6d333f95e726b0b42ec19a076731"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga223a6d333f95e726b0b42ec19a076731">§ </a></span>dbspid()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbspid </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get server process ID for a <code>DBPROCESS</code>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><em>"spid"</em>, the server's process ID. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00479.html#ae408d8e1c2ab0767d8bfd26d00d1ff6a" title="Normally not used. ">dbopen()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga223a6d333f95e726b0b42ec19a076731_cgraph.svg" width="224" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaf641c8e3d34607ca8b7ac2afed3e6d67"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf641c8e3d34607ca8b7ac2afed3e6d67">§ </a></span>dbspr1row()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbspr1row </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>buf_len</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Print a regular result row to a buffer. </p>
<p>Fills a buffer with one data row, represented as a null-terminated ASCII string. Helpful for debugging. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">buffer</td><td><em>output:</em> Address of a buffer to hold ASCII null-terminated string. </td></tr>
<tr><td class="paramname">buf_len</td><td>size of <em>buffer</em>, in bytes. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>on success. </td></tr>
<tr><td class="paramname">FAIL</td><td>trouble encountered. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga93ee3c8ca34a08588f88784898fd69e0" title="Reset an option. ">dbclropt()</a>, <a class="el" href="a00518.html#gac3eb8cb53f50998403ea9aebc6263df9" title="Get value of an option. ">dbisopt()</a>, <a class="el" href="a00518.html#ga9dfc2ee533e5e48a7aa8ca22f8d9ed79" title="Print result set headings to stdout. ">dbprhead()</a>, <a class="el" href="a00518.html#gaa30be3414a97aac6139af2e928db91ca" title="Print a result set to stdout. ">dbprrow()</a>, <a class="el" href="a00518.html#ga308918c13a5b1644269c1654fbea96ac" title="Determine size buffer required to hold the results returned by dbsprhead(), dbsprline(), and dbspr1row(). ">dbspr1rowlen()</a>, <a class="el" href="a00518.html#gaaa4839a9c88e5b90f33bd2407fcbc43e" title="Print result set headings to a buffer. ">dbsprhead()</a>, <a class="el" href="a00518.html#gacfaf9feb29c87cfb660886162f643152" title="Get formatted string for underlining dbsprhead() column names. ">dbsprline()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaf641c8e3d34607ca8b7ac2afed3e6d67_cgraph.svg" width="250" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga308918c13a5b1644269c1654fbea96ac"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga308918c13a5b1644269c1654fbea96ac">§ </a></span>dbspr1rowlen()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbspr1rowlen </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Determine size buffer required to hold the results returned by <a class="el" href="a00518.html#gaaa4839a9c88e5b90f33bd2407fcbc43e" title="Print result set headings to a buffer. ">dbsprhead()</a>, <a class="el" href="a00518.html#gacfaf9feb29c87cfb660886162f643152" title="Get formatted string for underlining dbsprhead() column names. ">dbsprline()</a>, and <a class="el" href="a00518.html#gaf641c8e3d34607ca8b7ac2afed3e6d67" title="Print a regular result row to a buffer. ">dbspr1row()</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>size of buffer requirement, in bytes. </dd></dl>
<dl class="section remark"><dt>Remarks</dt><dd>An esoteric function. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga9dfc2ee533e5e48a7aa8ca22f8d9ed79" title="Print result set headings to stdout. ">dbprhead()</a>, <a class="el" href="a00518.html#gaa30be3414a97aac6139af2e928db91ca" title="Print a result set to stdout. ">dbprrow()</a>, <a class="el" href="a00518.html#gaf641c8e3d34607ca8b7ac2afed3e6d67" title="Print a regular result row to a buffer. ">dbspr1row()</a>, <a class="el" href="a00518.html#gaaa4839a9c88e5b90f33bd2407fcbc43e" title="Print result set headings to a buffer. ">dbsprhead()</a>, <a class="el" href="a00518.html#gacfaf9feb29c87cfb660886162f643152" title="Get formatted string for underlining dbsprhead() column names. ">dbsprline()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga308918c13a5b1644269c1654fbea96ac_cgraph.svg" width="268" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaaa4839a9c88e5b90f33bd2407fcbc43e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaaa4839a9c88e5b90f33bd2407fcbc43e">§ </a></span>dbsprhead()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsprhead </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>buf_len</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Print result set headings to a buffer. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">buffer</td><td>output buffer </td></tr>
<tr><td class="paramname">buf_len</td><td>size of <em>buffer</em> </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td><em>buffer</em> filled. </td></tr>
<tr><td class="paramname">FAIL</td><td>insufficient spaace in <em>buffer</em>, usually. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga9dfc2ee533e5e48a7aa8ca22f8d9ed79" title="Print result set headings to stdout. ">dbprhead()</a>, <a class="el" href="a00518.html#gaa30be3414a97aac6139af2e928db91ca" title="Print a result set to stdout. ">dbprrow()</a>, <a class="el" href="a00518.html#ga9d660d278f3f58871b4086c0e175f4c6" title="Set db-lib or server option. ">dbsetopt()</a>, <a class="el" href="a00518.html#gaf641c8e3d34607ca8b7ac2afed3e6d67" title="Print a regular result row to a buffer. ">dbspr1row()</a>, <a class="el" href="a00518.html#ga308918c13a5b1644269c1654fbea96ac" title="Determine size buffer required to hold the results returned by dbsprhead(), dbsprline(), and dbspr1row(). ">dbspr1rowlen()</a>, <a class="el" href="a00518.html#gacfaf9feb29c87cfb660886162f643152" title="Get formatted string for underlining dbsprhead() column names. ">dbsprline()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaaa4839a9c88e5b90f33bd2407fcbc43e_cgraph.svg" width="251" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gacfaf9feb29c87cfb660886162f643152"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gacfaf9feb29c87cfb660886162f643152">§ </a></span>dbsprline()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsprline </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>buf_len</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBCHAR </td>
<td class="paramname"><em>line_char</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get formatted string for underlining <a class="el" href="a00518.html#gaaa4839a9c88e5b90f33bd2407fcbc43e" title="Print result set headings to a buffer. ">dbsprhead()</a> column names. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">buffer</td><td>output buffer </td></tr>
<tr><td class="paramname">buf_len</td><td>size of <em>buffer</em> </td></tr>
<tr><td class="paramname">line_char</td><td>character to use to represent underlining. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td><em>buffer</em> filled. </td></tr>
<tr><td class="paramname">FAIL</td><td>insufficient space in <em>buffer</em>, usually. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga9dfc2ee533e5e48a7aa8ca22f8d9ed79" title="Print result set headings to stdout. ">dbprhead()</a>, <a class="el" href="a00518.html#gaa30be3414a97aac6139af2e928db91ca" title="Print a result set to stdout. ">dbprrow()</a>, <a class="el" href="a00518.html#gaf641c8e3d34607ca8b7ac2afed3e6d67" title="Print a regular result row to a buffer. ">dbspr1row()</a>, <a class="el" href="a00518.html#ga308918c13a5b1644269c1654fbea96ac" title="Determine size buffer required to hold the results returned by dbsprhead(), dbsprline(), and dbspr1row(). ">dbspr1rowlen()</a>, <a class="el" href="a00518.html#gaaa4839a9c88e5b90f33bd2407fcbc43e" title="Print result set headings to a buffer. ">dbsprhead()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gacfaf9feb29c87cfb660886162f643152_cgraph.svg" width="240" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaae889abeb145ec41f7361aa8f597fe46"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaae889abeb145ec41f7361aa8f597fe46">§ </a></span>dbsqlexec()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsqlexec </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>send the SQL command to the server and wait for an answer. </p>
<p>Please be patient. This function waits for the server to respond. <code>dbsqlexec</code> is equivalent to <a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481" title="Transmit the command buffer to the server. ">dbsqlsend()</a> followed by <a class="el" href="a00518.html#gae1f50a6a2c31fda57cb481922b06841e" title="Wait for results of a query from the server. ">dbsqlok()</a>. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>query was processed without errors. </td></tr>
<tr><td class="paramname">FAIL</td><td>was returned by <a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481" title="Transmit the command buffer to the server. ">dbsqlsend()</a> or <a class="el" href="a00518.html#gae1f50a6a2c31fda57cb481922b06841e" title="Wait for results of a query from the server. ">dbsqlok()</a>. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a>, <a class="el" href="a00518.html#ga43727b10d4cbb7708b374811abe6eadb" title="printf-like way to form SQL to send to the server. ">dbfcmd()</a>, dbnextrow(), <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a>, <a class="el" href="a00519.html#ga2306039d73fbc7045f257b0e750c37b4" title="Fetch status value returned by query or remote procedure call. ">dbretstatus()</a>, <a class="el" href="a00518.html#gada4b41f34542a87f0cd87e78e56d18bb" title="Set maximum seconds db-lib waits for a server response to query. ">dbsettime()</a>, <a class="el" href="a00518.html#gae1f50a6a2c31fda57cb481922b06841e" title="Wait for results of a query from the server. ">dbsqlok()</a>, <a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481" title="Transmit the command buffer to the server. ">dbsqlsend()</a> </dd></dl>
</div>
</div>
<a id="gae1f50a6a2c31fda57cb481922b06841e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae1f50a6a2c31fda57cb481922b06841e">§ </a></span>dbsqlok()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsqlok </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Wait for results of a query from the server. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>everything worked, fetch results with <code>dbnextresults()</code>. </td></tr>
<tr><td class="paramname">FAIL</td><td>SQL syntax error, typically. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a>, <a class="el" href="a00518.html#ga43727b10d4cbb7708b374811abe6eadb" title="printf-like way to form SQL to send to the server. ">dbfcmd()</a>, <a class="el" href="a00518.html#ga74ac942f9b7baa49e1d7d18628321297" title="Sybase macro, maps to the internal (lower-case) function. ">DBIORDESC()</a>, <a class="el" href="a00518.html#ga5afb13924cda059d30be36a70dcf2cd9" title="Sybase macro, maps to the internal (lower-case) function. ">DBIOWDESC()</a>, <a class="el" href="a00518.html#ga6f13381522a1fa0b6ce2c15378088cdd" title="Send chunk of a text/image value to the server. ">dbmoretext()</a>, dbnextrow(), dbpoll(), DBRBUF(), <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a>, <a class="el" href="a00519.html#ga2306039d73fbc7045f257b0e750c37b4" title="Fetch status value returned by query or remote procedure call. ">dbretstatus()</a>, <a class="el" href="a00519.html#gafa4dfd181be21e49c397f7daaa9cf96c" title="Execute the procedure and free associated memory. ">dbrpcsend()</a>, <a class="el" href="a00518.html#gada4b41f34542a87f0cd87e78e56d18bb" title="Set maximum seconds db-lib waits for a server response to query. ">dbsettime()</a>, <a class="el" href="a00518.html#gaae889abeb145ec41f7361aa8f597fe46" title="send the SQL command to the server and wait for an answer. ">dbsqlexec()</a>, <a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481" title="Transmit the command buffer to the server. ">dbsqlsend()</a>, <a class="el" href="a00518.html#ga548153eb2eae76c48aa9d4b72258dc1c" title="Send text or image data to the server. ">dbwritetext()</a>. </dd></dl>
</div>
</div>
<a id="gac980139b9cea03cf93e373d425991481"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac980139b9cea03cf93e373d425991481">§ </a></span>dbsqlsend()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbsqlsend </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Transmit the command buffer to the server. </p>
<p><em>Non-blocking</em>, does not wait for a response.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>SQL sent. </td></tr>
<tr><td class="paramname">FAIL</td><td>protocol problem, unless <a class="el" href="a00518.html#gac980139b9cea03cf93e373d425991481" title="Transmit the command buffer to the server. ">dbsqlsend()</a> when it's not supposed to be (in which case a db-lib error message will be emitted). </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a>, <a class="el" href="a00518.html#ga43727b10d4cbb7708b374811abe6eadb" title="printf-like way to form SQL to send to the server. ">dbfcmd()</a>, <a class="el" href="a00518.html#ga74ac942f9b7baa49e1d7d18628321297" title="Sybase macro, maps to the internal (lower-case) function. ">DBIORDESC()</a>, <a class="el" href="a00518.html#ga5afb13924cda059d30be36a70dcf2cd9" title="Sybase macro, maps to the internal (lower-case) function. ">DBIOWDESC()</a>, dbnextrow(), dbpoll(), <a class="el" href="a00518.html#ga4e26d949be2c3bf71b1a33c75b11d931" title="Set up query results. ">dbresults()</a>, <a class="el" href="a00518.html#gada4b41f34542a87f0cd87e78e56d18bb" title="Set maximum seconds db-lib waits for a server response to query. ">dbsettime()</a>, <a class="el" href="a00518.html#gaae889abeb145ec41f7361aa8f597fe46" title="send the SQL command to the server and wait for an answer. ">dbsqlexec()</a>, <a class="el" href="a00518.html#gae1f50a6a2c31fda57cb481922b06841e" title="Wait for results of a query from the server. ">dbsqlok()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gac980139b9cea03cf93e373d425991481_cgraph.svg" width="248" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gab5fe0cd5f24d4fd33670111035a4fbed"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab5fe0cd5f24d4fd33670111035a4fbed">§ </a></span>dbstrbuild()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbstrbuild </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>charbuf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>bufsize</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>formats</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"><em>...</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Build a printable string from text containing placeholders for variables. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">charbuf</td><td><em>output:</em> buffer that will contain the ASCII null-terminated string built by <code><a class="el" href="a00518.html#gab5fe0cd5f24d4fd33670111035a4fbed" title="Build a printable string from text containing placeholders for variables. ">dbstrbuild()</a></code>. </td></tr>
<tr><td class="paramname">bufsize</td><td>size of <em>charbuf</em>, in bytes. </td></tr>
<tr><td class="paramname">text</td><td>null-terminated ASCII string, with <em>placeholders</em> for variables. <em>A</em> Placeholder is a three-byte string, made up of:<ul>
<li>'' a percent sign</li>
<li>0-9 an integer (designates the argument number to use, starting with 1.)</li>
<li>'!' an exclamation point </li>
</ul>
</td></tr>
<tr><td class="paramname">formats</td><td>null-terminated ASCII sprintf-style string. Has one format specifier for each placeholder in <em>text</em>. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>Following <em>formats</em> are the arguments, the values to substitute for the placeholders. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga32eb72f6fb3edb130e59fb3dd0766e7e" title="cf. ">dbconvert()</a>, dbdatename(), dbdatepart(). </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gab5fe0cd5f24d4fd33670111035a4fbed_cgraph.svg" width="243" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaf130b12e9e58b1bfd4a6685e33f5b3cd"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf130b12e9e58b1bfd4a6685e33f5b3cd">§ </a></span>dbstrcpy()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbstrcpy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>start</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>numbytes</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>dest</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a copy of a chunk of the command buffer. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">start</td><td>position in the command buffer to start copying from, starting from <em>0</em>. If start is past the end of the command buffer, <a class="el" href="a00518.html#gaf130b12e9e58b1bfd4a6685e33f5b3cd" title="Get a copy of a chunk of the command buffer. ">dbstrcpy()</a> inserts a null terminator at dest[0]. </td></tr>
<tr><td class="paramname">numbytes</td><td>number of bytes to copy.<ul>
<li>If -1, <a class="el" href="a00518.html#gaf130b12e9e58b1bfd4a6685e33f5b3cd" title="Get a copy of a chunk of the command buffer. ">dbstrcpy()</a> copies the whole command buffer.</li>
<li>If 0 <a class="el" href="a00518.html#gaf130b12e9e58b1bfd4a6685e33f5b3cd" title="Get a copy of a chunk of the command buffer. ">dbstrcpy()</a> writes a <code>NULL</code> to dest[0].</li>
<li>If the command buffer contains fewer than <em>numbytes</em> (taking <em>start</em> into account) <a class="el" href="a00518.html#gaf130b12e9e58b1bfd4a6685e33f5b3cd" title="Get a copy of a chunk of the command buffer. ">dbstrcpy()</a> copies the rest of it. </li>
</ul>
</td></tr>
<tr><td class="paramname">dest</td><td><em>output:</em> the buffer to write to. Make sure it's big enough. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>the inputs were valid and <em>dest</em> was affected. </td></tr>
<tr><td class="paramname">FAIL</td><td><em>start</em> < 0 or <em>numbytes</em> < -1. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a>, <a class="el" href="a00518.html#ga43727b10d4cbb7708b374811abe6eadb" title="printf-like way to form SQL to send to the server. ">dbfcmd()</a>, <a class="el" href="a00518.html#ga0fcfcf6846442dac9dd5584d270ec72a" title="Erase the command buffer, in case DBNOAUTOFREE was set with dbsetopt(). ">dbfreebuf()</a>, <a class="el" href="a00518.html#gaf917cf746c954a5d1b718afe3c4d1940" title="Get address of a position in the command buffer. ">dbgetchar()</a>, <a class="el" href="a00518.html#ga13caa07ec45cd6f64e9197d29e3cfe5e" title="Get size of the command buffer, in bytes. ">dbstrlen()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaf130b12e9e58b1bfd4a6685e33f5b3cd_cgraph.svg" width="236" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga13caa07ec45cd6f64e9197d29e3cfe5e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga13caa07ec45cd6f64e9197d29e3cfe5e">§ </a></span>dbstrlen()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int dbstrlen </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get size of the command buffer, in bytes. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga87b39d9863316b4ba85654b0885d53a0" title="Append SQL to the command buffer. ">dbcmd()</a>, <a class="el" href="a00518.html#ga43727b10d4cbb7708b374811abe6eadb" title="printf-like way to form SQL to send to the server. ">dbfcmd()</a>, <a class="el" href="a00518.html#ga0fcfcf6846442dac9dd5584d270ec72a" title="Erase the command buffer, in case DBNOAUTOFREE was set with dbsetopt(). ">dbfreebuf()</a>, <a class="el" href="a00518.html#gaf917cf746c954a5d1b718afe3c4d1940" title="Get address of a position in the command buffer. ">dbgetchar()</a>, <a class="el" href="a00518.html#gaf130b12e9e58b1bfd4a6685e33f5b3cd" title="Get a copy of a chunk of the command buffer. ">dbstrcpy()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga13caa07ec45cd6f64e9197d29e3cfe5e_cgraph.svg" width="234" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga9804fc70ae6ed35c92cd75d410dad570"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga9804fc70ae6ed35c92cd75d410dad570">§ </a></span>dbtablecolinfo()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbtablecolinfo </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>column</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="a01277.html">DBCOL</a> * </td>
<td class="paramname"><em>pdbcol</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>describe table column attributes with a single call (Freetds-only API function modelled on dbcolinfo) </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting from 1. </td></tr>
<tr><td class="paramname">pdbcol</td><td>address of structure to be populated by this function. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>SUCCEED or FAIL. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00077.html#a9b73fd1afa2c3ccfca481635212d2e43" title="Get a bunch of column attributes with a single call (Microsoft-compatibility feature). ">dbcolinfo()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga9804fc70ae6ed35c92cd75d410dad570_cgraph.svg" width="270" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga57e4098b153a030f0be02bcd98e08ba2"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga57e4098b153a030f0be02bcd98e08ba2">§ </a></span>dbtxptr()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBBINARY* dbtxptr </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get text pointer for a column in the current row. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>number of the column in the <code>SELECT</code> statement, starting at 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>text pointer for <em>column</em>, may be NULL. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gac3f11142ec7ff25b1f8972af10fe9454" title="Get text timestamp for a column in the current row. ">dbtxtimestamp()</a>, <a class="el" href="a00518.html#ga548153eb2eae76c48aa9d4b72258dc1c" title="Send text or image data to the server. ">dbwritetext()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga57e4098b153a030f0be02bcd98e08ba2_cgraph.svg" width="227" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gac3f11142ec7ff25b1f8972af10fe9454"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac3f11142ec7ff25b1f8972af10fe9454">§ </a></span>dbtxtimestamp()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBBINARY* dbtxtimestamp </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get text timestamp for a column in the current row. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>number of the column in the <code>SELECT</code> statement, starting at 1. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>timestamp for <em>column</em>, may be NULL. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga57e4098b153a030f0be02bcd98e08ba2" title="Get text pointer for a column in the current row. ">dbtxptr()</a>, <a class="el" href="a00518.html#ga548153eb2eae76c48aa9d4b72258dc1c" title="Send text or image data to the server. ">dbwritetext()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gac3f11142ec7ff25b1f8972af10fe9454_cgraph.svg" width="274" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga66ea891910f0a357cc78107d6ab7d962"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga66ea891910f0a357cc78107d6ab7d962">§ </a></span>dbuse()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbuse </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Change current database. </p>
<p>Analagous to the unix command <code>cd</code>, <a class="el" href="a00518.html#ga66ea891910f0a357cc78107d6ab7d962" title="Change current database. ">dbuse()</a> makes <em>name</em> the default database. Waits for an answer from the server. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">name</td><td>database to use. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>query was processed without errors. </td></tr>
<tr><td class="paramname">FAIL</td><td>query was not processed </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga8cbc761b1266bd947783d843aeeec264" title="See if a command caused the current database to change. ">dbchange()</a>, <a class="el" href="a00518.html#gab185982ffe0b85b8fd19747bd1f433fe" title="Get name of current database. ">dbname()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga66ea891910f0a357cc78107d6ab7d962_cgraph.svg" width="220" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga57c856964a9a0b4cc43f5192647c51e7"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga57c856964a9a0b4cc43f5192647c51e7">§ </a></span>dbvarylen()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBINT dbvarylen </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>column</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Determine whether a column can vary in size. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">column</td><td>Nth in the result set, starting from 1. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">TRUE</td><td>datatype of column can vary in size, or is nullable. </td></tr>
<tr><td class="paramname">FALSE</td><td>datatype of column is fixed and is not nullable. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga89fc5589b4bf41932324d2cfc6ad6433" title="Get size of a regular result column. ">dbcollen()</a>, <a class="el" href="a00518.html#gad06f5deddac18604dfa858b2580e232f" title="Return name of a regular result column. ">dbcolname()</a>, <a class="el" href="a00518.html#ga636e6f1b64743f3cf22158a56eef371f" title="Get the datatype of a regular result set column. ">dbcoltype()</a>, <a class="el" href="a00518.html#gaee60c306a22383805a4b9caa647a1e16" title="Get address of data in a regular result column. ">dbdata()</a>, <a class="el" href="a00518.html#gae666d141533126babb0235af21bdca0f" title="Get size of current row's data in a regular result column. ">dbdatlen()</a>, <a class="el" href="a00518.html#gadaa9482a082aa3fe52231e17749c2993" title="Return number of regular columns in a result set. ">dbnumcols()</a>, <a class="el" href="a00518.html#gac25ae21ca19777ffab1c013bd6049ebf" title="Print a token value's name to a buffer. ">dbprtype()</a>. </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga57c856964a9a0b4cc43f5192647c51e7_cgraph.svg" width="244" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga666726c86108342b1c1f27eecf68e13c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga666726c86108342b1c1f27eecf68e13c">§ </a></span>dbversion()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* dbversion </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>See which version of db-lib is in use. </p>
<dl class="section return"><dt>Returns</dt><dd>null-terminated ASCII string representing the version of db-lib. </dd></dl>
<dl class="section remark"><dt>Remarks</dt><dd>FreeTDS returns the CVS version string of <a class="el" href="a00077.html" title="Main implementation file for db-lib. ">dblib.c</a>. </dd></dl>
<dl class="section see"><dt>See also</dt><dd></dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga666726c86108342b1c1f27eecf68e13c_cgraph.svg" width="244" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="gaaf8349999c16b3c36caf5947747a2915"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaaf8349999c16b3c36caf5947747a2915">§ </a></span>dbwillconvert()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">DBBOOL dbwillconvert </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>srctype</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>desttype</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Test whether or not a datatype can be converted to another datatype. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">srctype</td><td>type converting from </td></tr>
<tr><td class="paramname">desttype</td><td>type converting to </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd><a class="el" href="a00518.html#gaaf8349999c16b3c36caf5947747a2915" title="Test whether or not a datatype can be converted to another datatype. ">dbwillconvert()</a> lies sometimes. Some datatypes <em>should</em> be convertible but aren't yet in our implementation. Legal unimplemented conversions return <em>TRUE</em>. </dd></dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">TRUE</td><td>convertible, or should be. </td></tr>
<tr><td class="paramname">FAIL</td><td>not convertible. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#gafefd17e15b22adda84366c817178dd7d" title="Bind a compute column to a program variable. ">dbaltbind()</a>, <a class="el" href="a00518.html#ga873bc0f4663165e711655ade1dfae795" title="Tie a host variable to a resultset column. ">dbbind()</a>, <a class="el" href="a00518.html#ga32eb72f6fb3edb130e59fb3dd0766e7e" title="cf. ">dbconvert()</a>, <a class="el" href="a00518.html#ga8b00d5cdcaa20cba13fa2e03d52a443e" title="Convert one datatype to another. ">dbconvert_ps()</a>, <code>src/dblib/unittests/convert</code>().c(). </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_gaaf8349999c16b3c36caf5947747a2915_cgraph.svg" width="264" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
<a id="ga548153eb2eae76c48aa9d4b72258dc1c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga548153eb2eae76c48aa9d4b72258dc1c">§ </a></span>dbwritetext()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">RETCODE dbwritetext </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a00901.html">DBPROCESS</a> * </td>
<td class="paramname"><em>dbproc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>objname</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBBINARY * </td>
<td class="paramname"><em>textptr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBTINYINT </td>
<td class="paramname"><em>textptrlen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBBINARY * </td>
<td class="paramname"><em>timestamp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBBOOL </td>
<td class="paramname"><em>log</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">DBINT </td>
<td class="paramname"><em>size</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">BYTE * </td>
<td class="paramname"><em>text</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Send text or image data to the server. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dbproc</td><td>contains all information needed by db-lib to manage communications with the server. </td></tr>
<tr><td class="paramname">objname</td><td>table name </td></tr>
<tr><td class="paramname">textptr</td><td>text pointer to be modified, obtained from <a class="el" href="a00518.html#ga57e4098b153a030f0be02bcd98e08ba2" title="Get text pointer for a column in the current row. ">dbtxptr()</a>. </td></tr>
<tr><td class="paramname">textptrlen</td><td><em>Ignored</em>. Supposed to be <code>DBTXPLEN</code>. </td></tr>
<tr><td class="paramname">timestamp</td><td>text timestamp to be modified, obtained from <a class="el" href="a00518.html#gac3f11142ec7ff25b1f8972af10fe9454" title="Get text timestamp for a column in the current row. ">dbtxtimestamp()</a> or dbtxtsnewval(), may be <code>NULL</code>. </td></tr>
<tr><td class="paramname">log</td><td><code>TRUE</code> if the operation is to be recorded in the transaction log. </td></tr>
<tr><td class="paramname">size</td><td>overall size of the data (in total, not just for this call), in bytes. A guideline, must not overstate the case. </td></tr>
<tr><td class="paramname">text</td><td>the chunk of data to write. </td></tr>
</table>
</dd>
</dl>
<dl class="retval"><dt>Return values</dt><dd>
<table class="retval">
<tr><td class="paramname">SUCCEED</td><td>everything worked. </td></tr>
<tr><td class="paramname">FAIL</td><td>not sent, possibly because <em>timestamp</em> is invalid or was changed in the database since it was fetched. </td></tr>
</table>
</dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="a00518.html#ga6f13381522a1fa0b6ce2c15378088cdd" title="Send chunk of a text/image value to the server. ">dbmoretext()</a>, <a class="el" href="a00518.html#ga57e4098b153a030f0be02bcd98e08ba2" title="Get text pointer for a column in the current row. ">dbtxptr()</a>, <a class="el" href="a00518.html#gac3f11142ec7ff25b1f8972af10fe9454" title="Get text timestamp for a column in the current row. ">dbtxtimestamp()</a>, <a class="el" href="a00518.html#ga548153eb2eae76c48aa9d4b72258dc1c" title="Send text or image data to the server. ">dbwritetext()</a>, dbtxtsput(). </dd></dl>
<div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a00518_ga548153eb2eae76c48aa9d4b72258dc1c_cgraph.svg" width="252" height="38"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</body>
</html>
