Debian Codegraph @

doc/programmers-guide/reference-field.html

raw
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Retrieving Field Data by Name</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="Database Independent Abstraction Layer for C"
11 HREF="index.html"><LINK
12 REL="UP"
13 TITLE="libdbi API Reference"
14 HREF="reference.html"><LINK
15 REL="PREVIOUS"
16 TITLE="Retrieving Field Meta-data"
17 HREF="reference-field-meta.html"><LINK
18 REL="NEXT"
19 TITLE="Retrieving Field Data by Index"
20 HREF="reference-field-idx.html"></HEAD
21 ><BODY
22 CLASS="SECTION"
23 BGCOLOR="#FFFFFF"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 SUMMARY="Header navigation table"
32 WIDTH="100%"
33 BORDER="0"
34 CELLPADDING="0"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="3"
39 ALIGN="center"
40 >Database Independent Abstraction Layer for C: libdbi Programmer's Guide</TH
41 ></TR
42 ><TR
43 ><TD
44 WIDTH="10%"
45 ALIGN="left"
46 VALIGN="bottom"
47 ><A
48 HREF="reference-field-meta.html"
49 ACCESSKEY="P"
50 >Prev</A
51 ></TD
52 ><TD
53 WIDTH="80%"
54 ALIGN="center"
55 VALIGN="bottom"
56 >Chapter 7. libdbi API Reference</TD
57 ><TD
58 WIDTH="10%"
59 ALIGN="right"
60 VALIGN="bottom"
61 ><A
62 HREF="reference-field-idx.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><DIV
72 CLASS="SECTION"
73 ><H1
74 CLASS="SECTION"
75 ><A
76 NAME="REFERENCE-FIELD"
77 >7.8. Retrieving Field Data by Name</A
78 ></H1
79 ><DIV
80 CLASS="SECTION"
81 ><H2
82 CLASS="SECTION"
83 ><A
84 NAME="DBI-RESULT-GET-FIELDS"
85 >7.8.1. dbi_result_get_fields</A
86 ></H2
87 ><DIV
88 CLASS="FUNCSYNOPSIS"
89 ><P
90 ></P
91 ><A
92 NAME="AEN2821"
93 ></A
94 ><P
95 ><CODE
96 ><CODE
97 CLASS="FUNCDEF"
98 >unsigned int <B
99 CLASS="FSFUNC"
100 >dbi_result_get_fields</B
101 ></CODE
102 >(dbi_result <VAR
103 CLASS="PDPARAM"
104 >Result</VAR
105 >, const char *<VAR
106 CLASS="PDPARAM"
107 >format</VAR
108 >, <VAR
109 CLASS="PDPARAM"
110 >...</VAR
111 >);</CODE
112 ></P
113 ><P
114 ></P
115 ></DIV
116 ><P
117 >Fetch multiple fields from the current result set, using a printf-like syntax. The formatter string specified field names and types, and each field's associated destination variable is passed as an argument following the format string. Fields in the formatter string are separated by spaces, and follow the format <TT
118 CLASS="LITERAL"
119 >"a.%b"</TT
120 >, where "a" is the name of the field, and "b" is the field type specifier. Make sure you pass the destination variables' memory addresses by prepending the &amp; operator to each variable's name.</P
121 ><P
122 ><EM
123 >Field type specifiers:</EM
124 ></P
125 ><P
126 ></P
127 ><UL
128 ><LI
129 ><P
130 ><TT
131 CLASS="LITERAL"
132 >%c / %uc</TT
133 >: A signed/unsigned character (1-byte)</P
134 ></LI
135 ><LI
136 ><P
137 ><TT
138 CLASS="LITERAL"
139 >%h / %uh</TT
140 >: A signed/unsigned short integer (2-byte)</P
141 ></LI
142 ><LI
143 ><P
144 ><TT
145 CLASS="LITERAL"
146 >%l / %ul</TT
147 >: A signed/unsigned integer (4-byte)</P
148 ></LI
149 ><LI
150 ><P
151 ><TT
152 CLASS="LITERAL"
153 >%i / %ui</TT
154 >: A signed/unsigned integer (4-byte)</P
155 ></LI
156 ><LI
157 ><P
158 ><TT
159 CLASS="LITERAL"
160 >%L / %uL</TT
161 >: A signed/unsigned long long integer (8-byte)</P
162 ></LI
163 ><LI
164 ><P
165 ><TT
166 CLASS="LITERAL"
167 >%f</TT
168 >: A floating point number</P
169 ></LI
170 ><LI
171 ><P
172 ><TT
173 CLASS="LITERAL"
174 >%d</TT
175 >: A double-precision number</P
176 ></LI
177 ><LI
178 ><P
179 ><TT
180 CLASS="LITERAL"
181 >%s</TT
182 >: A read-only string</P
183 ></LI
184 ><LI
185 ><P
186 ><TT
187 CLASS="LITERAL"
188 >%S</TT
189 >: A local copy of a string (must be freed by program)</P
190 ></LI
191 ><LI
192 ><P
193 ><TT
194 CLASS="LITERAL"
195 >%b</TT
196 >: A read-only pointer to binary data</P
197 ></LI
198 ><LI
199 ><P
200 ><TT
201 CLASS="LITERAL"
202 >%B</TT
203 >: A local copy of binary data (must be freed by program)</P
204 ></LI
205 ><LI
206 ><P
207 ><TT
208 CLASS="LITERAL"
209 >%m</TT
210 >: A time_t value representing a DATE and/or TIME</P
211 ></LI
212 ></UL
213 ><P
214 ><EM
215 >Example usage</EM
216 >: <TT
217 CLASS="LITERAL"
218 >dbi_result_get_fields(result, "idnum.%ul lastname.%s", &amp;id_number, &amp;name)</TT
219 ></P
220 ><P
221 ></P
222 ><DIV
223 CLASS="VARIABLELIST"
224 ><DL
225 ><DT
226 >Arguments</DT
227 ><DD
228 ><P
229 ><TT
230 CLASS="LITERAL"
231 >Result</TT
232 >: The target query result.</P
233 ><P
234 ><TT
235 CLASS="LITERAL"
236 >format</TT
237 >: The field format string as described above.</P
238 ><P
239 ><TT
240 CLASS="LITERAL"
241 >ARG</TT
242 >: (...) Pointers to the destination variables corresponding with each field in the format string.</P
243 ></DD
244 ><DT
245 >Returns</DT
246 ><DD
247 ><P
248 >The number of fields fetched, or DBI_FIELD_ERROR if there was an error. If an invalid field name was specified it will not raise an error, and the other fetched fields will work as usual.</P
249 ></DD
250 ></DL
251 ></DIV
252 ></DIV
253 ><DIV
254 CLASS="SECTION"
255 ><H2
256 CLASS="SECTION"
257 ><A
258 NAME="DBI-RESULT-BIND-FIELDS"
259 >7.8.2. dbi_result_bind_fields</A
260 ></H2
261 ><DIV
262 CLASS="FUNCSYNOPSIS"
263 ><P
264 ></P
265 ><A
266 NAME="AEN2891"
267 ></A
268 ><P
269 ><CODE
270 ><CODE
271 CLASS="FUNCDEF"
272 >unsigned int <B
273 CLASS="FSFUNC"
274 >dbi_result_bind_fields</B
275 ></CODE
276 >(dbi_result <VAR
277 CLASS="PDPARAM"
278 >Result</VAR
279 >, const char *<VAR
280 CLASS="PDPARAM"
281 >format</VAR
282 >, <VAR
283 CLASS="PDPARAM"
284 >...</VAR
285 >);</CODE
286 ></P
287 ><P
288 ></P
289 ></DIV
290 ><P
291 >Bind multiple fields in the current result set, using a printf-like syntax. See <A
292 HREF="reference-field.html#DBI-RESULT-GET-FIELDS"
293 >dbi_result_get_fields</A
294 > for a detailed explanation of the syntax.</P
295 ><P
296 ></P
297 ><DIV
298 CLASS="VARIABLELIST"
299 ><DL
300 ><DT
301 >Arguments</DT
302 ><DD
303 ><P
304 ><TT
305 CLASS="LITERAL"
306 >Result</TT
307 >: The target query result.</P
308 ><P
309 ><TT
310 CLASS="LITERAL"
311 >format</TT
312 >: The field format string as described above.</P
313 ><P
314 ><TT
315 CLASS="LITERAL"
316 >ARG</TT
317 >: (...) Pointers to the destination variables corresponding with each field in the format string.</P
318 ></DD
319 ><DT
320 >Returns</DT
321 ><DD
322 ><P
323 >The number of field binding set up, or DBI_FIELD_ERROR if there was an error.</P
324 ></DD
325 ></DL
326 ></DIV
327 ></DIV
328 ><DIV
329 CLASS="SECTION"
330 ><H2
331 CLASS="SECTION"
332 ><A
333 NAME="DBI-RESULT-GET-CHAR"
334 >7.8.3. dbi_result_get_char</A
335 ></H2
336 ><DIV
337 CLASS="FUNCSYNOPSIS"
338 ><P
339 ></P
340 ><A
341 NAME="AEN2919"
342 ></A
343 ><P
344 ><CODE
345 ><CODE
346 CLASS="FUNCDEF"
347 >signed char <B
348 CLASS="FSFUNC"
349 >dbi_result_get_char</B
350 ></CODE
351 >(dbi_result <VAR
352 CLASS="PDPARAM"
353 >Result</VAR
354 >, const char *<VAR
355 CLASS="PDPARAM"
356 >fieldname</VAR
357 >);</CODE
358 ></P
359 ><P
360 ></P
361 ></DIV
362 ><P
363 >Fetch the data stored in the speficied field, which contains a character (a 1-byte signed integer). This is the default for the "char" type on the x86 platform, as well as on Mac OS X.</P
364 ><P
365 ></P
366 ><DIV
367 CLASS="VARIABLELIST"
368 ><DL
369 ><DT
370 >Arguments</DT
371 ><DD
372 ><P
373 ><TT
374 CLASS="LITERAL"
375 >Result</TT
376 >: The target query result.</P
377 ><P
378 ><TT
379 CLASS="LITERAL"
380 >fieldname</TT
381 >: The name of the field to fetch.</P
382 ></DD
383 ><DT
384 >Returns</DT
385 ><DD
386 ><P
387 >The data stored in the specified field, or 0 (zero) if an error occurs. In the latter case the <A
388 HREF="errornumbers.html"
389 >error number</A
390 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME.</P
391 ></DD
392 ></DL
393 ></DIV
394 ></DIV
395 ><DIV
396 CLASS="SECTION"
397 ><H2
398 CLASS="SECTION"
399 ><A
400 NAME="DBI-RESULT-GET-UCHAR"
401 >7.8.4. dbi_result_get_uchar</A
402 ></H2
403 ><DIV
404 CLASS="FUNCSYNOPSIS"
405 ><P
406 ></P
407 ><A
408 NAME="AEN2943"
409 ></A
410 ><P
411 ><CODE
412 ><CODE
413 CLASS="FUNCDEF"
414 >unsigned <B
415 CLASS="FSFUNC"
416 >char dbi_result_get_uchar</B
417 ></CODE
418 >(dbi_result <VAR
419 CLASS="PDPARAM"
420 >Result</VAR
421 >, const char *<VAR
422 CLASS="PDPARAM"
423 >fieldname</VAR
424 >);</CODE
425 ></P
426 ><P
427 ></P
428 ></DIV
429 ><P
430 >Fetch the data stored in the speficied field, which contains an unsigned character (1-byte unsigned integer). This is the default for the "char" type on Linux for PowerPC.</P
431 ><P
432 ></P
433 ><DIV
434 CLASS="VARIABLELIST"
435 ><DL
436 ><DT
437 >Arguments</DT
438 ><DD
439 ><P
440 ><TT
441 CLASS="LITERAL"
442 >Result</TT
443 >: The target query result.</P
444 ><P
445 ><TT
446 CLASS="LITERAL"
447 >fieldname</TT
448 >: The name of the field to fetch.</P
449 ></DD
450 ><DT
451 >Returns</DT
452 ><DD
453 ><P
454 >The data stored in the specified field, or 0 (zero) if an error occurs. In the latter case the <A
455 HREF="errornumbers.html"
456 >error number</A
457 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME.</P
458 ></DD
459 ></DL
460 ></DIV
461 ></DIV
462 ><DIV
463 CLASS="SECTION"
464 ><H2
465 CLASS="SECTION"
466 ><A
467 NAME="DBI-RESULT-GET-SHORT"
468 >7.8.5. dbi_result_get_short</A
469 ></H2
470 ><DIV
471 CLASS="FUNCSYNOPSIS"
472 ><P
473 ></P
474 ><A
475 NAME="AEN2967"
476 ></A
477 ><P
478 ><CODE
479 ><CODE
480 CLASS="FUNCDEF"
481 >short <B
482 CLASS="FSFUNC"
483 >dbi_result_get_short</B
484 ></CODE
485 >(dbi_result <VAR
486 CLASS="PDPARAM"
487 >Result</VAR
488 >, const char *<VAR
489 CLASS="PDPARAM"
490 >const char *fieldname</VAR
491 >);</CODE
492 ></P
493 ><P
494 ></P
495 ></DIV
496 ><P
497 >Fetch the data stored in the speficied field, which contains a short integer (2-byte signed integer).</P
498 ><P
499 ></P
500 ><DIV
501 CLASS="VARIABLELIST"
502 ><DL
503 ><DT
504 >Arguments</DT
505 ><DD
506 ><P
507 ><TT
508 CLASS="LITERAL"
509 >Result</TT
510 >: The target query result.</P
511 ><P
512 ><TT
513 CLASS="LITERAL"
514 >fieldname</TT
515 >: The name of the field to fetch.</P
516 ></DD
517 ><DT
518 >Returns</DT
519 ><DD
520 ><P
521 >The data stored in the specified field, or 0 (zero) if an error occurs. In the latter case the <A
522 HREF="errornumbers.html"
523 >error number</A
524 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME..</P
525 ></DD
526 ></DL
527 ></DIV
528 ></DIV
529 ><DIV
530 CLASS="SECTION"
531 ><H2
532 CLASS="SECTION"
533 ><A
534 NAME="DBI-RESULT-GET-USHORT"
535 >7.8.6. dbi_result_get_ushort</A
536 ></H2
537 ><DIV
538 CLASS="FUNCSYNOPSIS"
539 ><P
540 ></P
541 ><A
542 NAME="AEN2991"
543 ></A
544 ><P
545 ><CODE
546 ><CODE
547 CLASS="FUNCDEF"
548 >unsigned short <B
549 CLASS="FSFUNC"
550 >dbi_result_get_ushort</B
551 ></CODE
552 >(dbi_result <VAR
553 CLASS="PDPARAM"
554 >Result</VAR
555 >, const char *<VAR
556 CLASS="PDPARAM"
557 >fieldname</VAR
558 >);</CODE
559 ></P
560 ><P
561 ></P
562 ></DIV
563 ><P
564 >Fetch the data stored in the speficied field, which contains an unsigned short integer (2-byte unsigned integer).</P
565 ><P
566 ></P
567 ><DIV
568 CLASS="VARIABLELIST"
569 ><DL
570 ><DT
571 >Arguments</DT
572 ><DD
573 ><P
574 ><TT
575 CLASS="LITERAL"
576 >Result</TT
577 >: The target query result.</P
578 ><P
579 ><TT
580 CLASS="LITERAL"
581 >fieldname</TT
582 >: The name of the field to fetch.</P
583 ></DD
584 ><DT
585 >Returns</DT
586 ><DD
587 ><P
588 >The data stored in the specified field, or 0 (zero) if an error occurs. In the latter case the <A
589 HREF="errornumbers.html"
590 >error number</A
591 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME..</P
592 ></DD
593 ></DL
594 ></DIV
595 ></DIV
596 ><DIV
597 CLASS="SECTION"
598 ><H2
599 CLASS="SECTION"
600 ><A
601 NAME="DBI-RESULT-GET-INT"
602 >7.8.7. dbi_result_get_int</A
603 ></H2
604 ><DIV
605 CLASS="FUNCSYNOPSIS"
606 ><P
607 ></P
608 ><A
609 NAME="AEN3015"
610 ></A
611 ><P
612 ><CODE
613 ><CODE
614 CLASS="FUNCDEF"
615 >int <B
616 CLASS="FSFUNC"
617 >dbi_result_get_int</B
618 ></CODE
619 >(dbi_result <VAR
620 CLASS="PDPARAM"
621 >Result</VAR
622 >, const char *<VAR
623 CLASS="PDPARAM"
624 >fieldname</VAR
625 >);</CODE
626 ></P
627 ><P
628 ></P
629 ></DIV
630 ><P
631 >Fetch the data stored in the speficied field, which contains an integer (4-byte signed integer).</P
632 ><P
633 ></P
634 ><DIV
635 CLASS="VARIABLELIST"
636 ><DL
637 ><DT
638 >Arguments</DT
639 ><DD
640 ><P
641 ><TT
642 CLASS="LITERAL"
643 >Result</TT
644 >: The target query result.</P
645 ><P
646 ><TT
647 CLASS="LITERAL"
648 >fieldname</TT
649 >: The name of the field to fetch.</P
650 ></DD
651 ><DT
652 >Returns</DT
653 ><DD
654 ><P
655 >The data stored in the specified field, or 0 (zero) if an error occurs. In the latter case the <A
656 HREF="errornumbers.html"
657 >error number</A
658 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME..</P
659 ></DD
660 ><DT
661 >Availability</DT
662 ><DD
663 ><P
664 >0.8.0</P
665 ></DD
666 ></DL
667 ></DIV
668 ></DIV
669 ><DIV
670 CLASS="SECTION"
671 ><H2
672 CLASS="SECTION"
673 ><A
674 NAME="DBI-RESULT-GET-UINT"
675 >7.8.8. dbi_result_get_uint</A
676 ></H2
677 ><DIV
678 CLASS="FUNCSYNOPSIS"
679 ><P
680 ></P
681 ><A
682 NAME="AEN3043"
683 ></A
684 ><P
685 ><CODE
686 ><CODE
687 CLASS="FUNCDEF"
688 >unsigned int <B
689 CLASS="FSFUNC"
690 >dbi_result_get_uint</B
691 ></CODE
692 >(dbi_result <VAR
693 CLASS="PDPARAM"
694 >Result</VAR
695 >, const char *<VAR
696 CLASS="PDPARAM"
697 >fieldname</VAR
698 >);</CODE
699 ></P
700 ><P
701 ></P
702 ></DIV
703 ><P
704 >Fetch the data stored in the speficied field, which contains an unsigned integer (4-byte unsigned integer).</P
705 ><P
706 ></P
707 ><DIV
708 CLASS="VARIABLELIST"
709 ><DL
710 ><DT
711 >Arguments</DT
712 ><DD
713 ><P
714 ><TT
715 CLASS="LITERAL"
716 >Result</TT
717 >: The target query result.</P
718 ><P
719 ><TT
720 CLASS="LITERAL"
721 >fieldname</TT
722 >: The name of the field to fetch.</P
723 ></DD
724 ><DT
725 >Returns</DT
726 ><DD
727 ><P
728 >The data stored in the specified field, or 0 (zero) if an error occurs. In the latter case the <A
729 HREF="errornumbers.html"
730 >error number</A
731 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME..</P
732 ></DD
733 ><DT
734 >Availability</DT
735 ><DD
736 ><P
737 >0.8.0</P
738 ></DD
739 ></DL
740 ></DIV
741 ></DIV
742 ><DIV
743 CLASS="SECTION"
744 ><H2
745 CLASS="SECTION"
746 ><A
747 NAME="DBI-RESULT-GET-LONG"
748 >7.8.9. dbi_result_get_long</A
749 ></H2
750 ><DIV
751 CLASS="FUNCSYNOPSIS"
752 ><P
753 ></P
754 ><A
755 NAME="AEN3071"
756 ></A
757 ><P
758 ><CODE
759 ><CODE
760 CLASS="FUNCDEF"
761 >int <B
762 CLASS="FSFUNC"
763 >dbi_result_get_long</B
764 ></CODE
765 >(dbi_result <VAR
766 CLASS="PDPARAM"
767 >Result</VAR
768 >, const char *<VAR
769 CLASS="PDPARAM"
770 >fieldname</VAR
771 >);</CODE
772 ></P
773 ><P
774 ></P
775 ></DIV
776 ><P
777 >This is the same as <A
778 HREF="reference-field.html#DBI-RESULT-GET-INT"
779 >dbi_result_get_int</A
780 >. The use of this function is deprecated as the name implies the wrong return type on 64-bit platforms.</P
781 ></DIV
782 ><DIV
783 CLASS="SECTION"
784 ><H2
785 CLASS="SECTION"
786 ><A
787 NAME="DBI-RESULT-GET-ULONG"
788 >7.8.10. dbi_result_get_ulong</A
789 ></H2
790 ><DIV
791 CLASS="FUNCSYNOPSIS"
792 ><P
793 ></P
794 ><A
795 NAME="AEN3083"
796 ></A
797 ><P
798 ><CODE
799 ><CODE
800 CLASS="FUNCDEF"
801 >unsigned int <B
802 CLASS="FSFUNC"
803 >dbi_result_get_ulong</B
804 ></CODE
805 >(dbi_result <VAR
806 CLASS="PDPARAM"
807 >Result</VAR
808 >, const char *<VAR
809 CLASS="PDPARAM"
810 >fieldname</VAR
811 >);</CODE
812 ></P
813 ><P
814 ></P
815 ></DIV
816 ><P
817 >This is the same as <A
818 HREF="reference-field.html#DBI-RESULT-GET-UINT"
819 >dbi_result_get_uint</A
820 >. The use of this function is deprecated as the name implies the wrong return type on 64-bit platforms.</P
821 ></DIV
822 ><DIV
823 CLASS="SECTION"
824 ><H2
825 CLASS="SECTION"
826 ><A
827 NAME="DBI-RESULT-GET-LONGLONG"
828 >7.8.11. dbi_result_get_longlong</A
829 ></H2
830 ><DIV
831 CLASS="FUNCSYNOPSIS"
832 ><P
833 ></P
834 ><A
835 NAME="AEN3095"
836 ></A
837 ><P
838 ><CODE
839 ><CODE
840 CLASS="FUNCDEF"
841 >long long <B
842 CLASS="FSFUNC"
843 >dbi_result_get_longlong</B
844 ></CODE
845 >(dbi_result <VAR
846 CLASS="PDPARAM"
847 >Result</VAR
848 >, const char *<VAR
849 CLASS="PDPARAM"
850 >fieldname</VAR
851 >);</CODE
852 ></P
853 ><P
854 ></P
855 ></DIV
856 ><P
857 >Fetch the data stored in the speficied field, which contains a long long integer (8-byte signed integer).</P
858 ><P
859 ></P
860 ><DIV
861 CLASS="VARIABLELIST"
862 ><DL
863 ><DT
864 >Arguments</DT
865 ><DD
866 ><P
867 ><TT
868 CLASS="LITERAL"
869 >Result</TT
870 >: The target query result.</P
871 ><P
872 ><TT
873 CLASS="LITERAL"
874 >fieldname</TT
875 >: The name of the field to fetch.</P
876 ></DD
877 ><DT
878 >Returns</DT
879 ><DD
880 ><P
881 >The data stored in the specified field, or 0 (zero) if an error occurs. In the latter case the <A
882 HREF="errornumbers.html"
883 >error number</A
884 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME..</P
885 ></DD
886 ></DL
887 ></DIV
888 ></DIV
889 ><DIV
890 CLASS="SECTION"
891 ><H2
892 CLASS="SECTION"
893 ><A
894 NAME="DBI-RESULT-GET-ULONGLONG"
895 >7.8.12. dbi_result_get_ulonglong</A
896 ></H2
897 ><DIV
898 CLASS="FUNCSYNOPSIS"
899 ><P
900 ></P
901 ><A
902 NAME="AEN3119"
903 ></A
904 ><P
905 ><CODE
906 ><CODE
907 CLASS="FUNCDEF"
908 >unsigned long long <B
909 CLASS="FSFUNC"
910 >dbi_result_get_ulonglong</B
911 ></CODE
912 >(dbi_result <VAR
913 CLASS="PDPARAM"
914 >Result</VAR
915 >, const char *<VAR
916 CLASS="PDPARAM"
917 >fieldname</VAR
918 >);</CODE
919 ></P
920 ><P
921 ></P
922 ></DIV
923 ><P
924 >Fetch the data stored in the speficied field, which contains an unsigned long long integer (8-byte unsigned integer).</P
925 ><P
926 ></P
927 ><DIV
928 CLASS="VARIABLELIST"
929 ><DL
930 ><DT
931 >Arguments</DT
932 ><DD
933 ><P
934 ><TT
935 CLASS="LITERAL"
936 >Result</TT
937 >: The target query result.</P
938 ><P
939 ><TT
940 CLASS="LITERAL"
941 >fieldname</TT
942 >: The name of the field to fetch.</P
943 ></DD
944 ><DT
945 >Returns</DT
946 ><DD
947 ><P
948 >The data stored in the specified field, or 0 (zero) if an error occurs. In the latter case the <A
949 HREF="errornumbers.html"
950 >error number</A
951 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME..</P
952 ></DD
953 ></DL
954 ></DIV
955 ></DIV
956 ><DIV
957 CLASS="SECTION"
958 ><H2
959 CLASS="SECTION"
960 ><A
961 NAME="DBI-RESULT-GET-FLOAT"
962 >7.8.13. dbi_result_get_float</A
963 ></H2
964 ><DIV
965 CLASS="FUNCSYNOPSIS"
966 ><P
967 ></P
968 ><A
969 NAME="AEN3143"
970 ></A
971 ><P
972 ><CODE
973 ><CODE
974 CLASS="FUNCDEF"
975 >float <B
976 CLASS="FSFUNC"
977 >dbi_result_get_float</B
978 ></CODE
979 >(dbi_result <VAR
980 CLASS="PDPARAM"
981 >Result</VAR
982 >, const char *<VAR
983 CLASS="PDPARAM"
984 >fieldname</VAR
985 >);</CODE
986 ></P
987 ><P
988 ></P
989 ></DIV
990 ><P
991 >Fetch the data stored in the speficied field, which contains a floating-point number.</P
992 ><P
993 ></P
994 ><DIV
995 CLASS="VARIABLELIST"
996 ><DL
997 ><DT
998 >Arguments</DT
999 ><DD
1000 ><P
1001 ><TT
1002 CLASS="LITERAL"
1003 >Result</TT
1004 >: The target query result.</P
1005 ><P
1006 ><TT
1007 CLASS="LITERAL"
1008 >fieldname</TT
1009 >: The name of the field to fetch.</P
1010 ></DD
1011 ><DT
1012 >Returns</DT
1013 ><DD
1014 ><P
1015 >The data stored in the specified field, which contains a fractional number, or 0 (zero) if an error occurs. In the latter case the <A
1016 HREF="errornumbers.html"
1017 >error number</A
1018 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME..</P
1019 ></DD
1020 ></DL
1021 ></DIV
1022 ></DIV
1023 ><DIV
1024 CLASS="SECTION"
1025 ><H2
1026 CLASS="SECTION"
1027 ><A
1028 NAME="DBI-RESULT-GET-DOUBLE"
1029 >7.8.14. dbi_result_get_double</A
1030 ></H2
1031 ><DIV
1032 CLASS="FUNCSYNOPSIS"
1033 ><P
1034 ></P
1035 ><A
1036 NAME="AEN3167"
1037 ></A
1038 ><P
1039 ><CODE
1040 ><CODE
1041 CLASS="FUNCDEF"
1042 >double <B
1043 CLASS="FSFUNC"
1044 >dbi_result_get_double</B
1045 ></CODE
1046 >(dbi_result <VAR
1047 CLASS="PDPARAM"
1048 >Result</VAR
1049 >, const char *<VAR
1050 CLASS="PDPARAM"
1051 >fieldname</VAR
1052 >);</CODE
1053 ></P
1054 ><P
1055 ></P
1056 ></DIV
1057 ><P
1058 >Fetch the data stored in the speficied field, which contains a double-precision fractional number.</P
1059 ><P
1060 ></P
1061 ><DIV
1062 CLASS="VARIABLELIST"
1063 ><DL
1064 ><DT
1065 >Arguments</DT
1066 ><DD
1067 ><P
1068 ><TT
1069 CLASS="LITERAL"
1070 >Result</TT
1071 >: The target query result.</P
1072 ><P
1073 ><TT
1074 CLASS="LITERAL"
1075 >fieldname</TT
1076 >: The name of the field to fetch.</P
1077 ></DD
1078 ><DT
1079 >Returns</DT
1080 ><DD
1081 ><P
1082 >The data stored in the specified field, or 0 (zero) if an error occurs. In the latter case the <A
1083 HREF="errornumbers.html"
1084 >error number</A
1085 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME..</P
1086 ></DD
1087 ></DL
1088 ></DIV
1089 ></DIV
1090 ><DIV
1091 CLASS="SECTION"
1092 ><H2
1093 CLASS="SECTION"
1094 ><A
1095 NAME="DBI-RESULT-GET-STRING"
1096 >7.8.15. dbi_result_get_string</A
1097 ></H2
1098 ><DIV
1099 CLASS="FUNCSYNOPSIS"
1100 ><P
1101 ></P
1102 ><A
1103 NAME="AEN3191"
1104 ></A
1105 ><P
1106 ><CODE
1107 ><CODE
1108 CLASS="FUNCDEF"
1109 >const char *<B
1110 CLASS="FSFUNC"
1111 >dbi_result_get_string</B
1112 ></CODE
1113 >(dbi_result <VAR
1114 CLASS="PDPARAM"
1115 >Result</VAR
1116 >, const char *<VAR
1117 CLASS="PDPARAM"
1118 >fieldname</VAR
1119 >);</CODE
1120 ></P
1121 ><P
1122 ></P
1123 ></DIV
1124 ><P
1125 >Fetch the data stored in the speficied field, which contains a zero-terminated string.</P
1126 ><P
1127 ></P
1128 ><DIV
1129 CLASS="VARIABLELIST"
1130 ><DL
1131 ><DT
1132 >Arguments</DT
1133 ><DD
1134 ><P
1135 ><TT
1136 CLASS="LITERAL"
1137 >Result</TT
1138 >: The target query result.</P
1139 ><P
1140 ><TT
1141 CLASS="LITERAL"
1142 >fieldname</TT
1143 >: The name of the field to fetch.</P
1144 ></DD
1145 ><DT
1146 >Returns</DT
1147 ><DD
1148 ><P
1149 >The data stored in the specified field, which is a zero-terminated string. If the field contains a NULL value, the function returns a NULL pointer. The string may not be modified, and may not necessarily persist between row fetches. In case of an error, this function returns the string "ERROR". In the latter case the <A
1150 HREF="errornumbers.html"
1151 >error number</A
1152 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME.</P
1153 ></DD
1154 ></DL
1155 ></DIV
1156 ></DIV
1157 ><DIV
1158 CLASS="SECTION"
1159 ><H2
1160 CLASS="SECTION"
1161 ><A
1162 NAME="DBI-RESULT-GET-STRING-COPY"
1163 >7.8.16. dbi_result_get_string_copy</A
1164 ></H2
1165 ><DIV
1166 CLASS="FUNCSYNOPSIS"
1167 ><P
1168 ></P
1169 ><A
1170 NAME="AEN3215"
1171 ></A
1172 ><P
1173 ><CODE
1174 ><CODE
1175 CLASS="FUNCDEF"
1176 >char *<B
1177 CLASS="FSFUNC"
1178 >dbi_result_get_string_copy</B
1179 ></CODE
1180 >(dbi_result <VAR
1181 CLASS="PDPARAM"
1182 >Result</VAR
1183 >, const char *<VAR
1184 CLASS="PDPARAM"
1185 >fieldname</VAR
1186 >);</CODE
1187 ></P
1188 ><P
1189 ></P
1190 ></DIV
1191 ><P
1192 >Fetch the data stored in the speficied field, which contains a zero-terminated string, and return it in an allocated buffer.</P
1193 ><P
1194 ></P
1195 ><DIV
1196 CLASS="VARIABLELIST"
1197 ><DL
1198 ><DT
1199 >Arguments</DT
1200 ><DD
1201 ><P
1202 ><TT
1203 CLASS="LITERAL"
1204 >Result</TT
1205 >: The target query result.</P
1206 ><P
1207 ><TT
1208 CLASS="LITERAL"
1209 >fieldname</TT
1210 >: The name of the field to fetch.</P
1211 ></DD
1212 ><DT
1213 >Returns</DT
1214 ><DD
1215 ><P
1216 >The data stored in the specified field as a zero-terminated allocated string. If the field contains a NULL value, the function returns a NULL pointer, and no memory is allocated. The newly allocated string may be modified by the host program, but the program is responsible for freeing the string. In case of an error, this function returns an allocated string reading "ERROR". In that case the <A
1217 HREF="errornumbers.html"
1218 >error number</A
1219 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME.</P
1220 ></DD
1221 ></DL
1222 ></DIV
1223 ></DIV
1224 ><DIV
1225 CLASS="SECTION"
1226 ><H2
1227 CLASS="SECTION"
1228 ><A
1229 NAME="DBI-RESULT-GET-BINARY"
1230 >7.8.17. dbi_result_get_binary</A
1231 ></H2
1232 ><DIV
1233 CLASS="FUNCSYNOPSIS"
1234 ><P
1235 ></P
1236 ><A
1237 NAME="AEN3239"
1238 ></A
1239 ><P
1240 ><CODE
1241 ><CODE
1242 CLASS="FUNCDEF"
1243 >const unsigned char *<B
1244 CLASS="FSFUNC"
1245 >dbi_result_get_binary</B
1246 ></CODE
1247 >(dbi_result <VAR
1248 CLASS="PDPARAM"
1249 >Result</VAR
1250 >, const char *<VAR
1251 CLASS="PDPARAM"
1252 >fieldname</VAR
1253 >);</CODE
1254 ></P
1255 ><P
1256 ></P
1257 ></DIV
1258 ><P
1259 >Fetch the data stored in the speficied field, which contains binary data.</P
1260 ><P
1261 ></P
1262 ><DIV
1263 CLASS="VARIABLELIST"
1264 ><DL
1265 ><DT
1266 >Arguments</DT
1267 ><DD
1268 ><P
1269 ><TT
1270 CLASS="LITERAL"
1271 >Result</TT
1272 >: The target query result.</P
1273 ><P
1274 ><TT
1275 CLASS="LITERAL"
1276 >fieldname</TT
1277 >: The name of the field to fetch.</P
1278 ></DD
1279 ><DT
1280 >Returns</DT
1281 ><DD
1282 ><P
1283 >The data stored in the specified field. The binary data may contain zero bytes and non-printable characters. Use <A
1284 HREF="reference-field-meta.html#DBI-RESULT-GET-FIELD-LENGTH"
1285 >dbi_result_get_field_length</A
1286 > or <A
1287 HREF="reference-field-meta.html#DBI-RESULT-GET-FIELD-LENGTH-IDX"
1288 >dbi_result_get_field_length_idx</A
1289 > to determine the number of bytes contained in the resulting binary string. The data may not be modified, and may not necessarily persist between row fetches. If the field contains a NULL value, the function returns a NULL pointer. In case of an error, this function returns the string "ERROR". In that case the <A
1290 HREF="errornumbers.html"
1291 >error number</A
1292 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME.</P
1293 ></DD
1294 ></DL
1295 ></DIV
1296 ></DIV
1297 ><DIV
1298 CLASS="SECTION"
1299 ><H2
1300 CLASS="SECTION"
1301 ><A
1302 NAME="DBI-RESULT-GET-BINARY-COPY"
1303 >7.8.18. dbi_result_get_binary_copy</A
1304 ></H2
1305 ><DIV
1306 CLASS="FUNCSYNOPSIS"
1307 ><P
1308 ></P
1309 ><A
1310 NAME="AEN3265"
1311 ></A
1312 ><P
1313 ><CODE
1314 ><CODE
1315 CLASS="FUNCDEF"
1316 >unsigned char *<B
1317 CLASS="FSFUNC"
1318 >dbi_result_get_binary_copy</B
1319 ></CODE
1320 >(dbi_result <VAR
1321 CLASS="PDPARAM"
1322 >Result</VAR
1323 >, const char *<VAR
1324 CLASS="PDPARAM"
1325 >fieldname</VAR
1326 >);</CODE
1327 ></P
1328 ><P
1329 ></P
1330 ></DIV
1331 ><P
1332 >Fetch the data stored in the speficied field, which contains binary data, and return it in an allocated buffer.</P
1333 ><P
1334 ></P
1335 ><DIV
1336 CLASS="VARIABLELIST"
1337 ><DL
1338 ><DT
1339 >Arguments</DT
1340 ><DD
1341 ><P
1342 ><TT
1343 CLASS="LITERAL"
1344 >Result</TT
1345 >: The target query result.</P
1346 ><P
1347 ><TT
1348 CLASS="LITERAL"
1349 >fieldname</TT
1350 >: The name of the field to fetch.</P
1351 ></DD
1352 ><DT
1353 >Returns</DT
1354 ><DD
1355 ><P
1356 >The data stored in the specified field. The binary data may contain zero bytes and non-printable characters. Use <A
1357 HREF="reference-field-meta.html#DBI-RESULT-GET-FIELD-LENGTH"
1358 >dbi_result_get_field_length</A
1359 > or <A
1360 HREF="reference-field-meta.html#DBI-RESULT-GET-FIELD-LENGTH-IDX"
1361 >dbi_result_get_field_length_idx</A
1362 > to determine the number of bytes contained in the resulting binary string. The newly allocated memory may be modified by the host program, but the program is responsible for freeing the data. If the field contains a NULL value, the function returns a NULL pointer. In case of an error, this function returns the string "ERROR". In that case the <A
1363 HREF="errornumbers.html"
1364 >error number</A
1365 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME.</P
1366 ></DD
1367 ></DL
1368 ></DIV
1369 ></DIV
1370 ><DIV
1371 CLASS="SECTION"
1372 ><H2
1373 CLASS="SECTION"
1374 ><A
1375 NAME="DBI-RESULT-GET-DATETIME"
1376 >7.8.19. dbi_result_get_datetime</A
1377 ></H2
1378 ><DIV
1379 CLASS="FUNCSYNOPSIS"
1380 ><P
1381 ></P
1382 ><A
1383 NAME="AEN3291"
1384 ></A
1385 ><P
1386 ><CODE
1387 ><CODE
1388 CLASS="FUNCDEF"
1389 >time_t <B
1390 CLASS="FSFUNC"
1391 >dbi_result_get_datetime</B
1392 ></CODE
1393 >(dbi_result <VAR
1394 CLASS="PDPARAM"
1395 >Result</VAR
1396 >, const char *<VAR
1397 CLASS="PDPARAM"
1398 >fieldname</VAR
1399 >);</CODE
1400 ></P
1401 ><P
1402 ></P
1403 ></DIV
1404 ><P
1405 >Fetch the data stored in the specified field, which contains a DATE and/or TIME value.</P
1406 ><P
1407 ></P
1408 ><DIV
1409 CLASS="VARIABLELIST"
1410 ><DL
1411 ><DT
1412 >Arguments</DT
1413 ><DD
1414 ><P
1415 ><TT
1416 CLASS="LITERAL"
1417 >Result</TT
1418 >: The target query result.</P
1419 ><P
1420 ><TT
1421 CLASS="LITERAL"
1422 >fieldname</TT
1423 >: The name of the field to fetch.</P
1424 ></DD
1425 ><DT
1426 >Returns</DT
1427 ><DD
1428 ><P
1429 >The data stored in the specified field as a time_t value. To convert this into human-readable dates or times, use the C library functions gmtime (3) and localtime (3). In case of an error this function returns 0 (zero) which resolves to the Unix epoch when converted. In case of an error the <A
1430 HREF="errornumbers.html"
1431 >error number</A
1432 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME.</P
1433 ></DD
1434 ></DL
1435 ></DIV
1436 ></DIV
1437 ><DIV
1438 CLASS="SECTION"
1439 ><H2
1440 CLASS="SECTION"
1441 ><A
1442 NAME="DBI-RESULT-GET-AS-LONGLONG"
1443 >7.8.20. dbi_result_get_as_longlong</A
1444 ></H2
1445 ><DIV
1446 CLASS="FUNCSYNOPSIS"
1447 ><P
1448 ></P
1449 ><A
1450 NAME="AEN3315"
1451 ></A
1452 ><P
1453 ><CODE
1454 ><CODE
1455 CLASS="FUNCDEF"
1456 >long long <B
1457 CLASS="FSFUNC"
1458 >dbi_result_get_as_longlong</B
1459 ></CODE
1460 >(dbi_result <VAR
1461 CLASS="PDPARAM"
1462 >Result</VAR
1463 >, const char *<VAR
1464 CLASS="PDPARAM"
1465 >fieldname</VAR
1466 >);</CODE
1467 ></P
1468 ><P
1469 ></P
1470 ></DIV
1471 ><P
1472 >Fetch the data stored in the specified field. Return the contents as a long long integer value, using appropriate casts or conversions if applicable.</P
1473 ><P
1474 ></P
1475 ><DIV
1476 CLASS="VARIABLELIST"
1477 ><DL
1478 ><DT
1479 >Arguments</DT
1480 ><DD
1481 ><P
1482 ><TT
1483 CLASS="LITERAL"
1484 >Result</TT
1485 >: The target query result.</P
1486 ><P
1487 ><TT
1488 CLASS="LITERAL"
1489 >fieldname</TT
1490 >: The name of the field to fetch.</P
1491 ></DD
1492 ><DT
1493 >Returns</DT
1494 ><DD
1495 ><P
1496 >The data stored in the specified field as a long long integer. Integer and floating point data as well as datetime data are cast to long long. Strings are converted using strtoll(). Empty strings, strings that do not translate into an integer, and binary strings are returned as 0 (zero) without raising an error. In case of an error this function returns 0 (zero) and the <A
1497 HREF="errornumbers.html"
1498 >error number</A
1499 > is DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME.</P
1500 ></DD
1501 ><DT
1502 >Availability</DT
1503 ><DD
1504 ><P
1505 >0.9.0</P
1506 ></DD
1507 ></DL
1508 ></DIV
1509 ></DIV
1510 ><DIV
1511 CLASS="SECTION"
1512 ><H2
1513 CLASS="SECTION"
1514 ><A
1515 NAME="DBI-RESULT-GET-AS-STRING-COPY"
1516 >7.8.21. dbi_result_get_as_string_copy</A
1517 ></H2
1518 ><DIV
1519 CLASS="FUNCSYNOPSIS"
1520 ><P
1521 ></P
1522 ><A
1523 NAME="AEN3343"
1524 ></A
1525 ><P
1526 ><CODE
1527 ><CODE
1528 CLASS="FUNCDEF"
1529 >char *<B
1530 CLASS="FSFUNC"
1531 >dbi_result_get_as_string_copy</B
1532 ></CODE
1533 >(dbi_result <VAR
1534 CLASS="PDPARAM"
1535 >Result</VAR
1536 >, const char *<VAR
1537 CLASS="PDPARAM"
1538 >fieldname</VAR
1539 >);</CODE
1540 ></P
1541 ><P
1542 ></P
1543 ></DIV
1544 ><P
1545 >Fetch the data stored in the specified field. Return the contents as an allocated string, using appropriate conversions if applicable. The caller is responsible for freeing the returned buffer when done.</P
1546 ><P
1547 ></P
1548 ><DIV
1549 CLASS="VARIABLELIST"
1550 ><DL
1551 ><DT
1552 >Arguments</DT
1553 ><DD
1554 ><P
1555 ><TT
1556 CLASS="LITERAL"
1557 >Result</TT
1558 >: The target query result.</P
1559 ><P
1560 ><TT
1561 CLASS="LITERAL"
1562 >fieldname</TT
1563 >: The name of the field to fetch.</P
1564 ></DD
1565 ><DT
1566 >Returns</DT
1567 ><DD
1568 ><P
1569 >A string representation of the data stored in the specified field. Integer, floating point and datetime data are pretty-printed using snprintf(). Strings are returned as such. Empty strings and binary strings are returned as empty strings without raising an error. In case of an error this function returns the string "ERROR" and the <A
1570 HREF="errornumbers.html"
1571 >error number</A
1572 > is DBI_ERROR_NOMEM, DBI_ERROR_BADTYPE, DBI_ERROR_BADIDX, or DBI_ERROR_BADNAME.</P
1573 ></DD
1574 ><DT
1575 >Availability</DT
1576 ><DD
1577 ><P
1578 >0.9.0</P
1579 ></DD
1580 ></DL
1581 ></DIV
1582 ></DIV
1583 ><DIV
1584 CLASS="SECTION"
1585 ><H2
1586 CLASS="SECTION"
1587 ><A
1588 NAME="DBI-RESULT-BIND-CHAR"
1589 >7.8.22. dbi_result_bind_char</A
1590 ></H2
1591 ><DIV
1592 CLASS="FUNCSYNOPSIS"
1593 ><P
1594 ></P
1595 ><A
1596 NAME="AEN3371"
1597 ></A
1598 ><P
1599 ><CODE
1600 ><CODE
1601 CLASS="FUNCDEF"
1602 >int <B
1603 CLASS="FSFUNC"
1604 >dbi_result_bind_char</B
1605 ></CODE
1606 >(dbi_result <VAR
1607 CLASS="PDPARAM"
1608 >Result</VAR
1609 >, const char *<VAR
1610 CLASS="PDPARAM"
1611 >fieldname</VAR
1612 >, char *<VAR
1613 CLASS="PDPARAM"
1614 >bindto</VAR
1615 >);</CODE
1616 ></P
1617 ><P
1618 ></P
1619 ></DIV
1620 ><P
1621 >Bind the specified variable to the specified field, which holds a character (a 1-byte signed integer). This is the default for the "char" type on the x86 platform, as well as on Mac OS X.</P
1622 ><P
1623 ></P
1624 ><DIV
1625 CLASS="VARIABLELIST"
1626 ><DL
1627 ><DT
1628 >Arguments</DT
1629 ><DD
1630 ><P
1631 ><TT
1632 CLASS="LITERAL"
1633 >Result</TT
1634 >: The target query result.</P
1635 ><P
1636 ><TT
1637 CLASS="LITERAL"
1638 >fieldname</TT
1639 >: The name of the field to bind to.</P
1640 ><P
1641 ><TT
1642 CLASS="LITERAL"
1643 >bindto</TT
1644 >: A pointer to the variable that will be updated with the specified field's value.</P
1645 ></DD
1646 ><DT
1647 >Returns</DT
1648 ><DD
1649 ><P
1650 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
1651 HREF="errornumbers.html"
1652 >error numbers</A
1653 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
1654 ></DD
1655 ></DL
1656 ></DIV
1657 ></DIV
1658 ><DIV
1659 CLASS="SECTION"
1660 ><H2
1661 CLASS="SECTION"
1662 ><A
1663 NAME="DBI-RESULT-BIND-UCHAR"
1664 >7.8.23. dbi_result_bind_uchar</A
1665 ></H2
1666 ><DIV
1667 CLASS="FUNCSYNOPSIS"
1668 ><P
1669 ></P
1670 ><A
1671 NAME="AEN3399"
1672 ></A
1673 ><P
1674 ><CODE
1675 ><CODE
1676 CLASS="FUNCDEF"
1677 >int <B
1678 CLASS="FSFUNC"
1679 >dbi_result_bind_uchar</B
1680 ></CODE
1681 >(dbi_result <VAR
1682 CLASS="PDPARAM"
1683 >Result</VAR
1684 >, const char *<VAR
1685 CLASS="PDPARAM"
1686 >fieldname</VAR
1687 >, unsigned char *<VAR
1688 CLASS="PDPARAM"
1689 >bindto</VAR
1690 >);</CODE
1691 ></P
1692 ><P
1693 ></P
1694 ></DIV
1695 ><P
1696 >Bind the specified variable to the specified field, which holds an unsigned character (1-byte unsigned integer). This is the default for the "char" type on Linux for PowerPC.</P
1697 ><P
1698 ></P
1699 ><DIV
1700 CLASS="VARIABLELIST"
1701 ><DL
1702 ><DT
1703 >Arguments</DT
1704 ><DD
1705 ><P
1706 ><TT
1707 CLASS="LITERAL"
1708 >Result</TT
1709 >: The target query result.</P
1710 ><P
1711 ><TT
1712 CLASS="LITERAL"
1713 >fieldname</TT
1714 >: The name of the field to bind to.</P
1715 ><P
1716 ><TT
1717 CLASS="LITERAL"
1718 >bindto</TT
1719 >: A pointer to the variable that will be updated with the specified field's value.</P
1720 ></DD
1721 ><DT
1722 >Returns</DT
1723 ><DD
1724 ><P
1725 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
1726 HREF="errornumbers.html"
1727 >error numbers</A
1728 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
1729 ></DD
1730 ></DL
1731 ></DIV
1732 ></DIV
1733 ><DIV
1734 CLASS="SECTION"
1735 ><H2
1736 CLASS="SECTION"
1737 ><A
1738 NAME="DBI-RESULT-BIND-SHORT"
1739 >7.8.24. dbi_result_bind_short</A
1740 ></H2
1741 ><DIV
1742 CLASS="FUNCSYNOPSIS"
1743 ><P
1744 ></P
1745 ><A
1746 NAME="AEN3427"
1747 ></A
1748 ><P
1749 ><CODE
1750 ><CODE
1751 CLASS="FUNCDEF"
1752 >int <B
1753 CLASS="FSFUNC"
1754 >dbi_result_bind_short</B
1755 ></CODE
1756 >(dbi_result <VAR
1757 CLASS="PDPARAM"
1758 >Result</VAR
1759 >, const char *<VAR
1760 CLASS="PDPARAM"
1761 >fieldname</VAR
1762 >, short *<VAR
1763 CLASS="PDPARAM"
1764 >bindto</VAR
1765 >);</CODE
1766 ></P
1767 ><P
1768 ></P
1769 ></DIV
1770 ><P
1771 >Bind the specified variable to the specified field, which holds a short integer (2-byte signed integer).</P
1772 ><P
1773 ></P
1774 ><DIV
1775 CLASS="VARIABLELIST"
1776 ><DL
1777 ><DT
1778 >Arguments</DT
1779 ><DD
1780 ><P
1781 ><TT
1782 CLASS="LITERAL"
1783 >Result</TT
1784 >: The target query result.</P
1785 ><P
1786 ><TT
1787 CLASS="LITERAL"
1788 >fieldname</TT
1789 >: The name of the field to bind to.</P
1790 ><P
1791 ><TT
1792 CLASS="LITERAL"
1793 >bindto</TT
1794 >: A pointer to the variable that will be updated with the specified field's value.</P
1795 ></DD
1796 ><DT
1797 >Returns</DT
1798 ><DD
1799 ><P
1800 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
1801 HREF="errornumbers.html"
1802 >error numbers</A
1803 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
1804 ></DD
1805 ></DL
1806 ></DIV
1807 ></DIV
1808 ><DIV
1809 CLASS="SECTION"
1810 ><H2
1811 CLASS="SECTION"
1812 ><A
1813 NAME="DBI-RESULT-BIND-USHORT"
1814 >7.8.25. dbi_result_bind_ushort</A
1815 ></H2
1816 ><DIV
1817 CLASS="FUNCSYNOPSIS"
1818 ><P
1819 ></P
1820 ><A
1821 NAME="AEN3455"
1822 ></A
1823 ><P
1824 ><CODE
1825 ><CODE
1826 CLASS="FUNCDEF"
1827 >int <B
1828 CLASS="FSFUNC"
1829 >dbi_result_bind_ushort</B
1830 ></CODE
1831 >(dbi_result <VAR
1832 CLASS="PDPARAM"
1833 >Result</VAR
1834 >, const char *<VAR
1835 CLASS="PDPARAM"
1836 >fieldname</VAR
1837 >, unsigned short *<VAR
1838 CLASS="PDPARAM"
1839 >bindto</VAR
1840 >);</CODE
1841 ></P
1842 ><P
1843 ></P
1844 ></DIV
1845 ><P
1846 >Bind the specified variable to the specified field, which holds an unsigned short integer (2-byte unsigned integer).</P
1847 ><P
1848 ></P
1849 ><DIV
1850 CLASS="VARIABLELIST"
1851 ><DL
1852 ><DT
1853 >Arguments</DT
1854 ><DD
1855 ><P
1856 ><TT
1857 CLASS="LITERAL"
1858 >Result</TT
1859 >: The target query result.</P
1860 ><P
1861 ><TT
1862 CLASS="LITERAL"
1863 >fieldname</TT
1864 >: The name of the field to bind to.</P
1865 ><P
1866 ><TT
1867 CLASS="LITERAL"
1868 >bindto</TT
1869 >: A pointer to the variable that will be updated with the specified field's value.</P
1870 ></DD
1871 ><DT
1872 >Returns</DT
1873 ><DD
1874 ><P
1875 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
1876 HREF="errornumbers.html"
1877 >error numbers</A
1878 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
1879 ></DD
1880 ></DL
1881 ></DIV
1882 ></DIV
1883 ><DIV
1884 CLASS="SECTION"
1885 ><H2
1886 CLASS="SECTION"
1887 ><A
1888 NAME="DBI-RESULT-BIND-INT"
1889 >7.8.26. dbi_result_bind_int</A
1890 ></H2
1891 ><DIV
1892 CLASS="FUNCSYNOPSIS"
1893 ><P
1894 ></P
1895 ><A
1896 NAME="AEN3483"
1897 ></A
1898 ><P
1899 ><CODE
1900 ><CODE
1901 CLASS="FUNCDEF"
1902 >int <B
1903 CLASS="FSFUNC"
1904 >dbi_result_bind_int</B
1905 ></CODE
1906 >(dbi_result <VAR
1907 CLASS="PDPARAM"
1908 >Result</VAR
1909 >, const char *<VAR
1910 CLASS="PDPARAM"
1911 >fieldname</VAR
1912 >, long *<VAR
1913 CLASS="PDPARAM"
1914 >bindto</VAR
1915 >);</CODE
1916 ></P
1917 ><P
1918 ></P
1919 ></DIV
1920 ><P
1921 >Bind the specified variable to the specified field, which holds an integer (4-byte signed integer).</P
1922 ><P
1923 ></P
1924 ><DIV
1925 CLASS="VARIABLELIST"
1926 ><DL
1927 ><DT
1928 >Arguments</DT
1929 ><DD
1930 ><P
1931 ><TT
1932 CLASS="LITERAL"
1933 >Result</TT
1934 >: The target query result.</P
1935 ><P
1936 ><TT
1937 CLASS="LITERAL"
1938 >fieldname</TT
1939 >: The name of the field to bind to.</P
1940 ><P
1941 ><TT
1942 CLASS="LITERAL"
1943 >bindto</TT
1944 >: A pointer to the variable that will be updated with the specified field's value.</P
1945 ></DD
1946 ><DT
1947 >Returns</DT
1948 ><DD
1949 ><P
1950 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
1951 HREF="errornumbers.html"
1952 >error numbers</A
1953 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
1954 ></DD
1955 ><DT
1956 >Availability</DT
1957 ><DD
1958 ><P
1959 >0.8.0</P
1960 ></DD
1961 ></DL
1962 ></DIV
1963 ></DIV
1964 ><DIV
1965 CLASS="SECTION"
1966 ><H2
1967 CLASS="SECTION"
1968 ><A
1969 NAME="DBI-RESULT-BIND-UINT"
1970 >7.8.27. dbi_result_bind_uint</A
1971 ></H2
1972 ><DIV
1973 CLASS="FUNCSYNOPSIS"
1974 ><P
1975 ></P
1976 ><A
1977 NAME="AEN3515"
1978 ></A
1979 ><P
1980 ><CODE
1981 ><CODE
1982 CLASS="FUNCDEF"
1983 >int <B
1984 CLASS="FSFUNC"
1985 >dbi_result_bind_uint</B
1986 ></CODE
1987 >(dbi_result <VAR
1988 CLASS="PDPARAM"
1989 >Result</VAR
1990 >, const char *<VAR
1991 CLASS="PDPARAM"
1992 >fieldname</VAR
1993 >, unsigned long *<VAR
1994 CLASS="PDPARAM"
1995 >bindto</VAR
1996 >);</CODE
1997 ></P
1998 ><P
1999 ></P
2000 ></DIV
2001 ><P
2002 >Bind the specified variable to the specified field, which holds an unsigned long integer (4-byte unsigned integer).</P
2003 ><P
2004 ></P
2005 ><DIV
2006 CLASS="VARIABLELIST"
2007 ><DL
2008 ><DT
2009 >Arguments</DT
2010 ><DD
2011 ><P
2012 ><TT
2013 CLASS="LITERAL"
2014 >Result</TT
2015 >: The target query result.</P
2016 ><P
2017 ><TT
2018 CLASS="LITERAL"
2019 >fieldname</TT
2020 >: The name of the field to bind to.</P
2021 ><P
2022 ><TT
2023 CLASS="LITERAL"
2024 >bindto</TT
2025 >: A pointer to the variable that will be updated with the specified field's value.</P
2026 ></DD
2027 ><DT
2028 >Returns</DT
2029 ><DD
2030 ><P
2031 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
2032 HREF="errornumbers.html"
2033 >error numbers</A
2034 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
2035 ></DD
2036 ><DT
2037 >Availability</DT
2038 ><DD
2039 ><P
2040 >0.8.0</P
2041 ></DD
2042 ></DL
2043 ></DIV
2044 ></DIV
2045 ><DIV
2046 CLASS="SECTION"
2047 ><H2
2048 CLASS="SECTION"
2049 ><A
2050 NAME="DBI-RESULT-BIND-LONG"
2051 >7.8.28. dbi_result_bind_long</A
2052 ></H2
2053 ><DIV
2054 CLASS="FUNCSYNOPSIS"
2055 ><P
2056 ></P
2057 ><A
2058 NAME="AEN3547"
2059 ></A
2060 ><P
2061 ><CODE
2062 ><CODE
2063 CLASS="FUNCDEF"
2064 >int <B
2065 CLASS="FSFUNC"
2066 >dbi_result_bind_long</B
2067 ></CODE
2068 >(dbi_result <VAR
2069 CLASS="PDPARAM"
2070 >Result</VAR
2071 >, const char *<VAR
2072 CLASS="PDPARAM"
2073 >fieldname</VAR
2074 >, long *<VAR
2075 CLASS="PDPARAM"
2076 >bindto</VAR
2077 >);</CODE
2078 ></P
2079 ><P
2080 ></P
2081 ></DIV
2082 ><P
2083 >The same as <A
2084 HREF="reference-field.html#DBI-RESULT-BIND-INT"
2085 >dbi_result_bind_int</A
2086 >. The use of this function is deprecated as the name implies the wrong return type on 64-bit platforms.</P
2087 ></DIV
2088 ><DIV
2089 CLASS="SECTION"
2090 ><H2
2091 CLASS="SECTION"
2092 ><A
2093 NAME="DBI-RESULT-BIND-ULONG"
2094 >7.8.29. dbi_result_bind_ulong</A
2095 ></H2
2096 ><DIV
2097 CLASS="FUNCSYNOPSIS"
2098 ><P
2099 ></P
2100 ><A
2101 NAME="AEN3561"
2102 ></A
2103 ><P
2104 ><CODE
2105 ><CODE
2106 CLASS="FUNCDEF"
2107 >int <B
2108 CLASS="FSFUNC"
2109 >dbi_result_bind_ulong</B
2110 ></CODE
2111 >(dbi_result <VAR
2112 CLASS="PDPARAM"
2113 >Result</VAR
2114 >, const char *<VAR
2115 CLASS="PDPARAM"
2116 >fieldname</VAR
2117 >, unsigned long *<VAR
2118 CLASS="PDPARAM"
2119 >bindto</VAR
2120 >);</CODE
2121 ></P
2122 ><P
2123 ></P
2124 ></DIV
2125 ><P
2126 >The same as <A
2127 HREF="reference-field.html#DBI-RESULT-BIND-UINT"
2128 >dbi_result_bind_uint</A
2129 >. The use of this function is deprecated as the name implies the wrong return type on 64-bit platforms.</P
2130 ></DIV
2131 ><DIV
2132 CLASS="SECTION"
2133 ><H2
2134 CLASS="SECTION"
2135 ><A
2136 NAME="DBI-RESULT-BIND-LONGLONG"
2137 >7.8.30. dbi_result_bind_longlong</A
2138 ></H2
2139 ><DIV
2140 CLASS="FUNCSYNOPSIS"
2141 ><P
2142 ></P
2143 ><A
2144 NAME="AEN3575"
2145 ></A
2146 ><P
2147 ><CODE
2148 ><CODE
2149 CLASS="FUNCDEF"
2150 >int <B
2151 CLASS="FSFUNC"
2152 >dbi_result_bind_longlong</B
2153 ></CODE
2154 >(dbi_result <VAR
2155 CLASS="PDPARAM"
2156 >Result</VAR
2157 >, const char *<VAR
2158 CLASS="PDPARAM"
2159 >fieldname</VAR
2160 >, long long *<VAR
2161 CLASS="PDPARAM"
2162 >bindto</VAR
2163 >);</CODE
2164 ></P
2165 ><P
2166 ></P
2167 ></DIV
2168 ><P
2169 >Bind the specified variable to the specified field, which holds a long long integer (8-byte signed integer).</P
2170 ><P
2171 ></P
2172 ><DIV
2173 CLASS="VARIABLELIST"
2174 ><DL
2175 ><DT
2176 >Arguments</DT
2177 ><DD
2178 ><P
2179 ><TT
2180 CLASS="LITERAL"
2181 >Result</TT
2182 >: The target query result.</P
2183 ><P
2184 ><TT
2185 CLASS="LITERAL"
2186 >fieldname</TT
2187 >: The name of the field to bind to.</P
2188 ><P
2189 ><TT
2190 CLASS="LITERAL"
2191 >bindto</TT
2192 >: A pointer to the variable that will be updated with the specified field's value.</P
2193 ></DD
2194 ><DT
2195 >Returns</DT
2196 ><DD
2197 ><P
2198 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
2199 HREF="errornumbers.html"
2200 >error numbers</A
2201 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
2202 ></DD
2203 ></DL
2204 ></DIV
2205 ></DIV
2206 ><DIV
2207 CLASS="SECTION"
2208 ><H2
2209 CLASS="SECTION"
2210 ><A
2211 NAME="DBI-RESULT-BIND-ULONGLONG"
2212 >7.8.31. dbi_result_bind_ulonglong</A
2213 ></H2
2214 ><DIV
2215 CLASS="FUNCSYNOPSIS"
2216 ><P
2217 ></P
2218 ><A
2219 NAME="AEN3603"
2220 ></A
2221 ><P
2222 ><CODE
2223 ><CODE
2224 CLASS="FUNCDEF"
2225 >int <B
2226 CLASS="FSFUNC"
2227 >dbi_result_bind_ulonglong</B
2228 ></CODE
2229 >(dbi_result <VAR
2230 CLASS="PDPARAM"
2231 >Result</VAR
2232 >, const char *<VAR
2233 CLASS="PDPARAM"
2234 >fieldname</VAR
2235 >, unsigned long long *<VAR
2236 CLASS="PDPARAM"
2237 >bindto</VAR
2238 >);</CODE
2239 ></P
2240 ><P
2241 ></P
2242 ></DIV
2243 ><P
2244 >Bind the specified variable to the specified field, which holds an unsigned long long integer (8-byte unsigned integer).</P
2245 ><P
2246 ></P
2247 ><DIV
2248 CLASS="VARIABLELIST"
2249 ><DL
2250 ><DT
2251 >Arguments</DT
2252 ><DD
2253 ><P
2254 ><TT
2255 CLASS="LITERAL"
2256 >Result</TT
2257 >: The target query result.</P
2258 ><P
2259 ><TT
2260 CLASS="LITERAL"
2261 >fieldname</TT
2262 >: The name of the field to bind to.</P
2263 ><P
2264 ><TT
2265 CLASS="LITERAL"
2266 >bindto</TT
2267 >: A pointer to the variable that will be updated with the specified field's value.</P
2268 ></DD
2269 ><DT
2270 >Returns</DT
2271 ><DD
2272 ><P
2273 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
2274 HREF="errornumbers.html"
2275 >error numbers</A
2276 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
2277 ></DD
2278 ></DL
2279 ></DIV
2280 ></DIV
2281 ><DIV
2282 CLASS="SECTION"
2283 ><H2
2284 CLASS="SECTION"
2285 ><A
2286 NAME="DBI-RESULT-BIND-FLOAT"
2287 >7.8.32. dbi_result_bind_float</A
2288 ></H2
2289 ><DIV
2290 CLASS="FUNCSYNOPSIS"
2291 ><P
2292 ></P
2293 ><A
2294 NAME="AEN3631"
2295 ></A
2296 ><P
2297 ><CODE
2298 ><CODE
2299 CLASS="FUNCDEF"
2300 >int <B
2301 CLASS="FSFUNC"
2302 >dbi_result_bind_float</B
2303 ></CODE
2304 >(dbi_result <VAR
2305 CLASS="PDPARAM"
2306 >Result</VAR
2307 >, const char *<VAR
2308 CLASS="PDPARAM"
2309 >fieldname</VAR
2310 >, float *<VAR
2311 CLASS="PDPARAM"
2312 >bindto</VAR
2313 >);</CODE
2314 ></P
2315 ><P
2316 ></P
2317 ></DIV
2318 ><P
2319 >Bind the specified variable to the specified field, which holds a floating-point number.</P
2320 ><P
2321 ></P
2322 ><DIV
2323 CLASS="VARIABLELIST"
2324 ><DL
2325 ><DT
2326 >Arguments</DT
2327 ><DD
2328 ><P
2329 ><TT
2330 CLASS="LITERAL"
2331 >Result</TT
2332 >: The target query result.</P
2333 ><P
2334 ><TT
2335 CLASS="LITERAL"
2336 >fieldname</TT
2337 >: The name of the field to bind to.</P
2338 ><P
2339 ><TT
2340 CLASS="LITERAL"
2341 >bindto</TT
2342 >: A pointer to the variable that will be updated with the specified field's value.</P
2343 ></DD
2344 ><DT
2345 >Returns</DT
2346 ><DD
2347 ><P
2348 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
2349 HREF="errornumbers.html"
2350 >error numbers</A
2351 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
2352 ></DD
2353 ></DL
2354 ></DIV
2355 ></DIV
2356 ><DIV
2357 CLASS="SECTION"
2358 ><H2
2359 CLASS="SECTION"
2360 ><A
2361 NAME="DBI-RESULT-BIND-DOUBLE"
2362 >7.8.33. dbi_result_bind_double</A
2363 ></H2
2364 ><DIV
2365 CLASS="FUNCSYNOPSIS"
2366 ><P
2367 ></P
2368 ><A
2369 NAME="AEN3659"
2370 ></A
2371 ><P
2372 ><CODE
2373 ><CODE
2374 CLASS="FUNCDEF"
2375 >int <B
2376 CLASS="FSFUNC"
2377 >dbi_result_bind_double</B
2378 ></CODE
2379 >(dbi_result <VAR
2380 CLASS="PDPARAM"
2381 >Result</VAR
2382 >, const char *<VAR
2383 CLASS="PDPARAM"
2384 >fieldname</VAR
2385 >, double *<VAR
2386 CLASS="PDPARAM"
2387 >bindto</VAR
2388 >);</CODE
2389 ></P
2390 ><P
2391 ></P
2392 ></DIV
2393 ><P
2394 >Bind the specified variable to the specified field, which holds a double-precision fractional number.</P
2395 ><P
2396 ></P
2397 ><DIV
2398 CLASS="VARIABLELIST"
2399 ><DL
2400 ><DT
2401 >Arguments</DT
2402 ><DD
2403 ><P
2404 ><TT
2405 CLASS="LITERAL"
2406 >Result</TT
2407 >: The target query result.</P
2408 ><P
2409 ><TT
2410 CLASS="LITERAL"
2411 >fieldname</TT
2412 >: The name of the field to bind to.</P
2413 ><P
2414 ><TT
2415 CLASS="LITERAL"
2416 >bindto</TT
2417 >: A pointer to the variable that will be updated with the specified field's value.</P
2418 ></DD
2419 ><DT
2420 >Returns</DT
2421 ><DD
2422 ><P
2423 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
2424 HREF="errornumbers.html"
2425 >error numbers</A
2426 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
2427 ></DD
2428 ></DL
2429 ></DIV
2430 ></DIV
2431 ><DIV
2432 CLASS="SECTION"
2433 ><H2
2434 CLASS="SECTION"
2435 ><A
2436 NAME="DBI-RESULT-BIND-STRING"
2437 >7.8.34. dbi_result_bind_string</A
2438 ></H2
2439 ><DIV
2440 CLASS="FUNCSYNOPSIS"
2441 ><P
2442 ></P
2443 ><A
2444 NAME="AEN3687"
2445 ></A
2446 ><P
2447 ><CODE
2448 ><CODE
2449 CLASS="FUNCDEF"
2450 >int <B
2451 CLASS="FSFUNC"
2452 >dbi_result_bind_string</B
2453 ></CODE
2454 >(dbi_result <VAR
2455 CLASS="PDPARAM"
2456 >Result</VAR
2457 >, const char *<VAR
2458 CLASS="PDPARAM"
2459 >fieldname</VAR
2460 >, const char **<VAR
2461 CLASS="PDPARAM"
2462 >bindto</VAR
2463 >);</CODE
2464 ></P
2465 ><P
2466 ></P
2467 ></DIV
2468 ><P
2469 >Bind the specified variable to the specified field, which holds a string. The string must not be modified.</P
2470 ><P
2471 ></P
2472 ><DIV
2473 CLASS="VARIABLELIST"
2474 ><DL
2475 ><DT
2476 >Arguments</DT
2477 ><DD
2478 ><P
2479 ><TT
2480 CLASS="LITERAL"
2481 >Result</TT
2482 >: The target query result.</P
2483 ><P
2484 ><TT
2485 CLASS="LITERAL"
2486 >fieldname</TT
2487 >: The name of the field to bind to.</P
2488 ><P
2489 ><TT
2490 CLASS="LITERAL"
2491 >bindto</TT
2492 >: A pointer to the variable that will be updated with the specified field's value.</P
2493 ></DD
2494 ><DT
2495 >Returns</DT
2496 ><DD
2497 ><P
2498 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
2499 HREF="errornumbers.html"
2500 >error numbers</A
2501 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
2502 ></DD
2503 ></DL
2504 ></DIV
2505 ></DIV
2506 ><DIV
2507 CLASS="SECTION"
2508 ><H2
2509 CLASS="SECTION"
2510 ><A
2511 NAME="DBI-RESULT-BIND-BINARY"
2512 >7.8.35. dbi_result_bind_binary</A
2513 ></H2
2514 ><DIV
2515 CLASS="FUNCSYNOPSIS"
2516 ><P
2517 ></P
2518 ><A
2519 NAME="AEN3715"
2520 ></A
2521 ><P
2522 ><CODE
2523 ><CODE
2524 CLASS="FUNCDEF"
2525 >int <B
2526 CLASS="FSFUNC"
2527 >dbi_result_bind_binary</B
2528 ></CODE
2529 >(dbi_result <VAR
2530 CLASS="PDPARAM"
2531 >Result</VAR
2532 >, const char *<VAR
2533 CLASS="PDPARAM"
2534 >fieldname</VAR
2535 >, const unsigned char **<VAR
2536 CLASS="PDPARAM"
2537 >bindto</VAR
2538 >);</CODE
2539 ></P
2540 ><P
2541 ></P
2542 ></DIV
2543 ><P
2544 >Bind the specified variable to the specified field, which holds binary BLOB data. The data must not be modified.</P
2545 ><P
2546 ></P
2547 ><DIV
2548 CLASS="VARIABLELIST"
2549 ><DL
2550 ><DT
2551 >Arguments</DT
2552 ><DD
2553 ><P
2554 ><TT
2555 CLASS="LITERAL"
2556 >Result</TT
2557 >: The target query result.</P
2558 ><P
2559 ><TT
2560 CLASS="LITERAL"
2561 >fieldname</TT
2562 >: The name of the field to bind to.</P
2563 ><P
2564 ><TT
2565 CLASS="LITERAL"
2566 >bindto</TT
2567 >: A pointer to the variable that will be updated with the specified field's value.</P
2568 ></DD
2569 ><DT
2570 >Returns</DT
2571 ><DD
2572 ><P
2573 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
2574 HREF="errornumbers.html"
2575 >error numbers</A
2576 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
2577 ></DD
2578 ></DL
2579 ></DIV
2580 ></DIV
2581 ><DIV
2582 CLASS="SECTION"
2583 ><H2
2584 CLASS="SECTION"
2585 ><A
2586 NAME="DBI-RESULT-BIND-STRING-COPY"
2587 >7.8.36. dbi_result_bind_string_copy</A
2588 ></H2
2589 ><DIV
2590 CLASS="FUNCSYNOPSIS"
2591 ><P
2592 ></P
2593 ><A
2594 NAME="AEN3743"
2595 ></A
2596 ><P
2597 ><CODE
2598 ><CODE
2599 CLASS="FUNCDEF"
2600 >int <B
2601 CLASS="FSFUNC"
2602 >dbi_result_bind_string_copy</B
2603 ></CODE
2604 >(dbi_result <VAR
2605 CLASS="PDPARAM"
2606 >Result</VAR
2607 >, const char *<VAR
2608 CLASS="PDPARAM"
2609 >fieldname</VAR
2610 >, char **<VAR
2611 CLASS="PDPARAM"
2612 >bindto</VAR
2613 >);</CODE
2614 ></P
2615 ><P
2616 ></P
2617 ></DIV
2618 ><P
2619 >Bind the specified variable to the specified field, which holds a string. The newly allocated string may be modified by the host program, but the program is responsible for freeing the string.</P
2620 ><P
2621 ></P
2622 ><DIV
2623 CLASS="VARIABLELIST"
2624 ><DL
2625 ><DT
2626 >Arguments</DT
2627 ><DD
2628 ><P
2629 ><TT
2630 CLASS="LITERAL"
2631 >Result</TT
2632 >: The target query result.</P
2633 ><P
2634 ><TT
2635 CLASS="LITERAL"
2636 >fieldname</TT
2637 >: The name of the field to bind to.</P
2638 ><P
2639 ><TT
2640 CLASS="LITERAL"
2641 >bindto</TT
2642 >: A pointer to the variable that will be updated with the specified field's value.</P
2643 ></DD
2644 ><DT
2645 >Returns</DT
2646 ><DD
2647 ><P
2648 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
2649 HREF="errornumbers.html"
2650 >error numbers</A
2651 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
2652 ></DD
2653 ></DL
2654 ></DIV
2655 ></DIV
2656 ><DIV
2657 CLASS="SECTION"
2658 ><H2
2659 CLASS="SECTION"
2660 ><A
2661 NAME="DBI-RESULT-BIND-BINARY-COPY"
2662 >7.8.37. dbi_result_bind_binary_copy</A
2663 ></H2
2664 ><DIV
2665 CLASS="FUNCSYNOPSIS"
2666 ><P
2667 ></P
2668 ><A
2669 NAME="AEN3771"
2670 ></A
2671 ><P
2672 ><CODE
2673 ><CODE
2674 CLASS="FUNCDEF"
2675 >int <B
2676 CLASS="FSFUNC"
2677 >dbi_result_bind_binary_copy</B
2678 ></CODE
2679 >(dbi_result <VAR
2680 CLASS="PDPARAM"
2681 >Result</VAR
2682 >, const char *<VAR
2683 CLASS="PDPARAM"
2684 >fieldname</VAR
2685 >, unsigned char **<VAR
2686 CLASS="PDPARAM"
2687 >bindto</VAR
2688 >);</CODE
2689 ></P
2690 ><P
2691 ></P
2692 ></DIV
2693 ><P
2694 >Bind the specified variable to the specified field, which holds binary BLOB data. The newly allocated data may be modified by the host program, but the program is responsible for freeing the data.</P
2695 ><P
2696 ></P
2697 ><DIV
2698 CLASS="VARIABLELIST"
2699 ><DL
2700 ><DT
2701 >Arguments</DT
2702 ><DD
2703 ><P
2704 ><TT
2705 CLASS="LITERAL"
2706 >Result</TT
2707 >: The target query result.</P
2708 ><P
2709 ><TT
2710 CLASS="LITERAL"
2711 >fieldname</TT
2712 >: The name of the field to bind to.</P
2713 ><P
2714 ><TT
2715 CLASS="LITERAL"
2716 >bindto</TT
2717 >: A pointer to the variable that will be updated with the specified field's value.</P
2718 ></DD
2719 ><DT
2720 >Returns</DT
2721 ><DD
2722 ><P
2723 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
2724 HREF="errornumbers.html"
2725 >error numbers</A
2726 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
2727 ></DD
2728 ></DL
2729 ></DIV
2730 ></DIV
2731 ><DIV
2732 CLASS="SECTION"
2733 ><H2
2734 CLASS="SECTION"
2735 ><A
2736 NAME="DBI-RESULT-BIND-DATETIME"
2737 >7.8.38. dbi_result_bind_datetime</A
2738 ></H2
2739 ><DIV
2740 CLASS="FUNCSYNOPSIS"
2741 ><P
2742 ></P
2743 ><A
2744 NAME="AEN3799"
2745 ></A
2746 ><P
2747 ><CODE
2748 ><CODE
2749 CLASS="FUNCDEF"
2750 >int <B
2751 CLASS="FSFUNC"
2752 >dbi_result_bind_datetime</B
2753 ></CODE
2754 >(dbi_result <VAR
2755 CLASS="PDPARAM"
2756 >Result</VAR
2757 >, const char *<VAR
2758 CLASS="PDPARAM"
2759 >fieldname</VAR
2760 >, time_t *<VAR
2761 CLASS="PDPARAM"
2762 >bindto</VAR
2763 >);</CODE
2764 ></P
2765 ><P
2766 ></P
2767 ></DIV
2768 ><P
2769 >Bind the specified variable to the specified field, which holds a DATE and/or TIME value.</P
2770 ><P
2771 ></P
2772 ><DIV
2773 CLASS="VARIABLELIST"
2774 ><DL
2775 ><DT
2776 >Arguments</DT
2777 ><DD
2778 ><P
2779 ><TT
2780 CLASS="LITERAL"
2781 >Result</TT
2782 >: The target query result.</P
2783 ><P
2784 ><TT
2785 CLASS="LITERAL"
2786 >fieldname</TT
2787 >: The name of the field to bind to.</P
2788 ><P
2789 ><TT
2790 CLASS="LITERAL"
2791 >bindto</TT
2792 >: A pointer to the variable that will be updated with the specified field's value.</P
2793 ></DD
2794 ><DT
2795 >Returns</DT
2796 ><DD
2797 ><P
2798 >0 upon success, DBI_BIND_ERROR if there was an error. Possible <A
2799 HREF="errornumbers.html"
2800 >error numbers</A
2801 > are DBI_ERROR_BADPTR, DBI_ERROR_NOMEM, and DBI_ERROR_BADNAME.</P
2802 ></DD
2803 ></DL
2804 ></DIV
2805 ></DIV
2806 ></DIV
2807 ><DIV
2808 CLASS="NAVFOOTER"
2809 ><HR
2810 ALIGN="LEFT"
2811 WIDTH="100%"><TABLE
2812 SUMMARY="Footer navigation table"
2813 WIDTH="100%"
2814 BORDER="0"
2815 CELLPADDING="0"
2816 CELLSPACING="0"
2817 ><TR
2818 ><TD
2819 WIDTH="33%"
2820 ALIGN="left"
2821 VALIGN="top"
2822 ><A
2823 HREF="reference-field-meta.html"
2824 ACCESSKEY="P"
2825 >Prev</A
2826 ></TD
2827 ><TD
2828 WIDTH="34%"
2829 ALIGN="center"
2830 VALIGN="top"
2831 ><A
2832 HREF="index.html"
2833 ACCESSKEY="H"
2834 >Home</A
2835 ></TD
2836 ><TD
2837 WIDTH="33%"
2838 ALIGN="right"
2839 VALIGN="top"
2840 ><A
2841 HREF="reference-field-idx.html"
2842 ACCESSKEY="N"
2843 >Next</A
2844 ></TD
2845 ></TR
2846 ><TR
2847 ><TD
2848 WIDTH="33%"
2849 ALIGN="left"
2850 VALIGN="top"
2851 >Retrieving Field Meta-data</TD
2852 ><TD
2853 WIDTH="34%"
2854 ALIGN="center"
2855 VALIGN="top"
2856 ><A
2857 HREF="reference.html"
2858 ACCESSKEY="U"
2859 >Up</A
2860 ></TD
2861 ><TD
2862 WIDTH="33%"
2863 ALIGN="right"
2864 VALIGN="top"
2865 >Retrieving Field Data by Index</TD
2866 ></TR
2867 ></TABLE
2868 ></DIV
2869 ></BODY
2870 ></HTML
2871 >