1DBFDUMP(1)                         shapelib                         DBFDUMP(1)
2
3
4

NAME

6       dbfdump - dumps the content of a xBase file to the terminal
7

SYNOPSIS

9       dbfdump [-h] [-r] [-m] xbase_file
10

DESCRIPTION

12       Dumps  the  contents  of  xbase_file to standard output. The first line
13       contains the field names appearing in xbase_file, and each of the  fol‐
14       lowing  lines  contains  the  field values of a record. Field names and
15       values are padded by spaces to their field  widths.  Empty  fields  are
16       printed as the string "(NULL)".
17

OPTIONS

19       -h     output header info (field descriptions).
20
21              Prints  the  column  field definitions before other output. Each
22              field definition consists of a line of the form
23
24              Field:  index,  Type=type,  Title=`name´,   Width=width,   Deci‐
25              mals=precision
26
27              where  index  is the zero offset column number of the field; the
28              type indicates the datatype of the field  value  and  is  either
29              "Integer",  "Real"  or "String"; name is the field´s name; width
30              is the number of bytes reserved for the field´s value; and  pre‐
31              cision  is  the number of decimal places of precision for "Real"
32              type fields, and is zero for "Integer" and "String" type fields.
33
34       -r     output raw field info, numeric values not reformatted.
35
36              Prints the exact bytes occurring in xbase_file for field  values
37              and suppresses printing "(NULL)" for empty values.
38
39       -m     output one line per field.
40
41              Prints each record in multiline format separated by empty lines.
42              The first line of a record gives the number of the record in the
43              form
44
45              Records: record_index
46
47              where  record_index  is  the zero offset number of the record in
48              the file, and then each field of the record appears on  its  own
49              line in the format
50
51              name: value
52
53       xbase_file
54              the name of an existing xBase file.
55

EXAMPLE

57       dbfdump -h testbase.dbf
58
59       assuming  that testbase.dbf has 1 record (inserted by other example us‐
60       ing dbfadd), this command line will produce the following output:
61
62
63           Field 0: Type=String, Title=´NAME´, Width=20, Decimals=0
64           Field 1: Type=Double, Title=´AREA´, Width=9, Decimals=3
65           Field 2: Type=Double, Title=´VALUE´, Width=9, Decimals=2
66           NAME AREA VALUE REGION1 25.656 150.22
67
68
69

EXIT STATUS

71       0      Successful program execution.
72
73       1      Missing xbase_file argument.
74
75       2      Failed to open xbase_file.
76
77       3      There are no fields in xbase_file.
78

DIAGNOSTICS

80       The following diagnostics may be issued on stdout:
81
82       DBFOpen(xbase_file,"r") failed.
83
84       There are no fields in this table!
85

AUTHOR

87       dbfdump is part of shapelib, maintained by Frank Warmerdam. This  guide
88       was  created by Eduardo Patoo Kanegae and converted to manpage by Johan
89       Van de Wauw. It was further enhanced  with  the  man  page  written  by
90       Joonas Pihlaja (jpihlaja@cc.helsinki.fi).
91

BUGS

93       Unless  the  -r option is given, values in numeric fields that overflow
94       the int or double types of the C language are printed as plus or  minus
95       a huge number. For integer fields the huge value is HUGE_VALL from
96

SEE ALSO

98       dbfadd(1),  dbfcat(1),  dbfcreate(1), dbfinfo(1), shpadd(1), shpcat(1),
99       shpcentrd(1),  shpcreate(1),  shpdump(1),  shpdxf(1),  shpfix(1),   sh‐
100       pinfo(1), shpproj(1), shprewind(1), shptest(1)
101
102
103
104                                   July 2023                        DBFDUMP(1)