.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "DBFDUMP" "1" "August 2018" "" "shplib"
.
.SH "NAME"
\fBdbfdump\fR \- dumps the content of a xBase file to the terminal
.
.SH "SYNOPSIS"
\fBdbfdump\fR [\fB\-h\fR] [\fB\-r\fR] [\fB\-m\fR] \fIxbase_file\fR
.
.SH "DESCRIPTION"
Dumps the contents of \fIxbase_file\fR to standard output\. The first line contains the field names appearing in \fIxbase_file\fR, 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
\fB\-h\fR
output header info (field descriptions)\.
.
.IP
Prints the column field definitions before other output\. Each field definition consists of a line of the form
.
.IP
Field: \fIindex\fR, Type=\fItype\fR, Title=`\fIname\fR\', Width=\fIwidth\fR, Decimals=\fIprecision\fR
.
.IP
where \fIindex\fR is the zero offset column number of the field; the \fItype\fR indicates the datatype of the field value and is either "Integer", "Real" or "String"; \fIname\fR is the field\'s name; \fIwidth\fR is the number of bytes reserved for the field\'s value; and \fIprecision\fR is the number of decimal places of precision for "Real" type fields, and is zero for "Integer" and "String" type fields\.
.
.TP
\fB\-r\fR
output raw field info, numeric values not reformatted\.
.
.IP
Prints the exact bytes occurring in \fIxbase_file\fR for field values and suppresses printing "(NULL)" for empty values\.
.
.TP
\fB\-m\fR
output one line per field\.
.
.IP
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
.
.IP
Records: \fIrecord_index\fR
.
.IP
where \fIrecord_index\fR 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
.
.IP
\fIname\fR: \fIvalue\fR
.
.TP
\fIxbase_file\fR
the name of an existing xBase file\.

.
.SH "EXAMPLE"
\fBdbfdump\fR \fB\-h\fR \fItestbase\.dbf\fR
.
.P
assuming that \fItestbase\.dbf\fR has 1 record (inserted by other example using \fBdbfadd\fR), this command line will produce the following output:
.
.IP "" 4
.
.nf

Field 0: Type=String, Title=\'NAME\', Width=20, Decimals=0
Field 1: Type=Double, Title=\'AREA\', Width=9, Decimals=3
Field 2: Type=Double, Title=\'VALUE\', Width=9, Decimals=2
NAME AREA VALUE REGION1 25\.656 150\.22
.
.fi
.
.IP "" 0
.
.SH "EXIT STATUS"
.
.TP
\fB0\fR
Successful program execution\.
.
.TP
\fB1\fR
Missing \fIxbase_file\fR argument\.
.
.TP
\fB2\fR
Failed to open \fIxbase_file\fR\.
.
.TP
\fB3\fR
There are no fields in \fIxbase_file\fR\.
.
.SH "DIAGNOSTICS"
The following diagnostics may be issued on stdout:
.
.P
DBFOpen(\fIxbase_file\fR,"r") failed\.
.
.P
There are no fields in this table!
.
.SH "AUTHOR"
\fBdbfdump\fR is part of shapelib, maintained by Frank Warmerdam\. This guide was created by Eduardo Patoo Kanegae and converted to manpage by Johan Van de Wauw\. It was further enhanced with the man page written by Joonas Pihlaja (jpihlaja@cc\.helsinki\.fi)\.
.
.SH "BUGS"
Unless the \fB\-r\fR option is given, values in numeric fields that overflow the \fBint\fR or \fBdouble\fR types of the \fBC\fR language are printed as plus or minus a huge number\. For integer fields the huge value is \fBHUGE_VALL\fR from <stdlib\.h> and for real fields it is \fBHUGE_VALF\fR\.
.
.SH "SEE ALSO"
\fBdbfadd\fR(1), \fBdbfcat\fR(1), \fBdbfcreate\fR(1), \fBdbfinfo\fR(1), \fBshpadd\fR(1), \fBshpcat\fR(1), \fBshpcentrd\fR(1), \fBshpcreate\fR(1), \fBshpdump\fR(1), \fBshpdxf\fR(1), \fBshpfix\fR(1), \fBshpinfo\fR(1), \fBshpproj\fR(1), \fBshprewind\fR(1), \fBshptest\fR(1)