SHAPELIB(1)							   User Commands						       SHAPELIB(1)

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 "Inte-
	      ger", "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)