.\" Process this file with
.\" groff -man -Tascii dbfdump.1
.\"
.TH SHAPELIB 1 "OCTOBER 2004" "shapelib" "User Commands"
.SH NAME
dbfdump \- dump xBase DBF files as text
.SH SYNOPSIS
.B dbfdump [\-h] [\-m] [\-r]
.I file
.SH DESCRIPTION
Dumps the contents of
.I file
to standard output.  The first line contains the field names appearing
in
.I file,
and each of the following lines contains the field values of a
record.  Field names and values are padded by spaces to their field
widths.  Empty fields are printed as the string "(NULL)".
.SH OPTIONS
.TP
.B \-h
Prints the column field definitions before other output.  Each field
definition consists of a line of the form

.RI "Field: " index ", Type=" type ", Title=`" "name" "', Width=" "width" ", Decimals=" precision

where
.I index
is the zero offset column number of the field; the
.I type
indicates the datatype of the field value and is either "Integer",
"Real" or "String"; 
.I name
is the field's name;
.I width
is the number of bytes reserved for the field's value; and
.I precision
is the number of decimal places of precision for "Real" type
fields, and is zero for "Integer" and "String" type fields.
.TP
.B \-m
Prints each record in multiline format separated by empty lines.
The first line of a record gives the number of the record in the form

Records:
.I record_index

where
.I record_index
is the zero offset number of the record in the file, and
then each field of the record appears on its own line in the format

.IR name :
.I value

.TP
.B \-r
Prints the exact bytes occurring in
.I file
for field values and suppresses printing "(NULL)" for
empty values.
.SH EXIT STATUS
.TP
.B 0
Successful program execution.
.TP
.B 1
Missing
.I file
argument.
.TP
.B 2
Failed to open
.I file.
.TP
.B 3
There are no fields in
.I file.
.SH DIAGNOSTICS
The following diagnostics may be issued on stdout:
.TP
.RI DBFOpen( file ",""r"") failed."
.TP
There are no fields in this table!
.SH AUTHORS
Frank Warmerdam (warmerdam@pobox.com) is the maintainer of the
.B shapelib
shapefile library.  Joonas Pihlaja (jpihlaja@cc.helsinki.fi) wrote
this man page.
.SH BUGS
Unless the
.B \-r
option is given, values in numeric fields that overflow the
.B int
or 
.B double
types of the 
.B C
language are printed as plus or minus a huge number.  For integer
fields the huge value is
.B HUGE_VALL
from <stdlib.h> and for real fields it is
.BR HUGE_VALF .
.SH "SEE ALSO"
.BR dbf_dump (1),
.BR dbfcreate (1),
.BR dbfadd (1),
.BR shpadd (1),
.BR shpcreate (1),
.BR shpdump (1),
.BR shprewind (1)