.TH GDI_PRINT_TUPLES 3 "8/19/93 (v16.3)"
.ig
% ptroff -man gdi_print_tuples.3
SccsID=@(#)gdi_print_tuples.3	16.3 8/19/93
..
.SH NAME
.PP
gdi_print_tuples \- print tuple data to stdout
.SH SYNOPSIS
.PP
.nf
.ta 8 16
.B #include "libgdi.h"
.sp
.B int
.B gdi_print_tuples (dbobj, format, header)
\fBdbObj	*dbobj;\fP	/* (i) database object */
\fBint	format;\fP	/* (i) GDI_FIXED_SPACE or GDI_DELIMITED */
\fBint	header;\fP	/* (i) TRUE for column name headings, FALSE for data only */
.fi
.SH DESCRIPTION
.PP
gdi_print_tuples() prints the tuple data in the database object,
\fIdbObj\fP, to \fIstdout\fP.  To print the \fIdbObj\fP use gdi_print_dbobj().
To print the column definitions use gdi_print_coldefs().
.PP
Specifying GDI_FIXED_SPACE causes the tuples to be printed in tabular
form.  Numbers are right justified.  Strings are left justified.
GDI_DELIMITED, prints a comma without white space between fields.  Strings
and chars are enclosed in double quotes.  This output was intended to be a
flat file format compatible with a number of database vendors.  The column
name headings can be enabled or disabled.
.SH ARGUMENTS
.PP
.TP 12
.B obj
The database data object.
.TP 12
.B format
GDI_FIXED_SPACE or GDI_DELIMITED.
.TP 12
.B header
TRUE to enable the output of column name headings, FALSE for data only.
.SH DIAGNOSTICS
.PP
gdi_print_tuples() returns one of the following status values.
.TP 12
.B GDI_SUCCESS
No problem outputting tuples.
.TP 12
.B GDI_FAILURE
NULL \fIdbObj\fP passed in.
.SH FILE
.PP
gdi_print.c
.SH SEE ALSO
.PP
.BR gdi_print_coldefs (3),
.BR gdi_print_dbobj (3)
.SH AUTHOR
.PP
Mari Mortell SAIC Geophysical Systems Operation