.\" Process this file with
.\" groff -man -Tascii dbfadd.1
.\"
.TH SHAPELIB 1 "OCTOBER 2004" "shapelib" "User Commands"
.SH NAME
dbfadd \- add a row to an xBase DBF file
.SH SYNOPSIS
.B dbfadd
.I filename fieldvalues...
.SH DESCRIPTION
Adds a row to the DBF file named by
.I filename
with column values given by the
.I fieldvalues
options that follow.  A
.B NULL
value is denoted by an empty argument.
.SH EXIT STATUS
.TP
.B 0
Successful program execution.
.TP
.B 1
Missing
.I filename
or 
.I fieldvalues
arguments.
.TP
.B 2
Failed to open
.I filename
for reading and appending.
.TP
.B 3
Too few values in
.I fieldvalues...
.SH DIAGNOSTICS
The following diagnostics may be issued on stdout:
.TP
.RI DBFOpen( filename ",""rb+"") failed."
.TP
.RI Got\  count1 " fields, but require " count2 
.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
Field values that are too large to fit in a field are silently
truncated from the right. Numeric field values that can't be parsed by
.BR atof (3)
get undefined values.
.SH "SEE ALSO"
.BR dbfcreate (1),
.BR dbfdump (1),
.BR dbf_dump (1),
.BR shpadd (1),
.BR shpcreate (1),
.BR shpdump (1),
.BR shprewind (1)