NAME

       dbfdump - dump xBase DBF files as text

SYNOPSIS

       dbfdump [-h] [-m] [-r] file

DESCRIPTION

       Dumps  the  contents  of  file  to standard output.  The first line contains the field names appearing in
       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)".

OPTIONS

       -h     Prints the column field definitions before other output.  Each field definition consists of a line
              of the form

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

              where  index is the zero offset column number of the field; the type indicates the datatype of the
              field value and is either "Integer", "Real" or "String"; name is the field's name;  width  is  the
              number  of  bytes reserved for the field's value; and precision is the number of decimal places of
              precision for "Real" type fields, and is zero for "Integer" and "String" type fields.

       -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: record_index

              where 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

              name: value

       -r     Prints the exact bytes occurring in file for field values and  suppresses  printing  "(NULL)"  for
              empty values.

EXIT STATUS

       0      Successful program execution.

       1      Missing file argument.

       2      Failed to open file.

       3      There are no fields in file.

DIAGNOSTICS

       The following diagnostics may be issued on stdout:

       DBFOpen(file,"r") failed.

       There are no fields in this table!

AUTHORS

       Frank  Warmerdam  (warmerdam@pobox.com)  is  the  maintainer  of  the shapelib shapefile library.  Joonas
       Pihlaja (jpihlaja@cc.helsinki.fi) wrote this man page.

BUGS

       Unless the -r option is given, values in numeric fields that overflow the int or double types  of  the  C
       language are printed as plus or minus a huge number.  For integer fields the huge value is HUGE_VALL from
       <stdlib.h> and for real fields it is HUGE_VALF.

SEE ALSO

       dbf_dump(1), dbfcreate(1), dbfadd(1), shpadd(1), shpcreate(1), shpdump(1), shprewind(1)

shapelib                                          OCTOBER 2004                                       SHAPELIB(1)