.\" generated with Ronn-NG/v0.9.1
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
.TH "DBFADD" "1" "December 2023" "" "shplib"
.SH "NAME"
\fBdbfadd\fR \- add a row to an xBase DBF file
.SH "SYNOPSIS"
\fBdbfadd\fR \fIxbase_file\fR \fIfield_values\|\.\|\.\|\.\fR
.SH "DESCRIPTION"
Adds a row to the DBF file named by \fIxbase_file\fR with column values given by the \fIfield_values\fR options that follow\. A NULL value is denoted by an empty argument\.
.SH "OPTIONS"
.TP
\fIxbase_file\fR
the name of an existing xBase file
.TP
\fIfield_values\fR
list of values to be inserted into the xBase file\. You must specify a number of values equal to the number of fields the xBase file has\. The order of values must also reflect the order of fields inside xBase file\.
.SH "EXAMPLE"
\fBdbfadd\fR \fItestbase\.dbf\fR \fIREGION1\fR \fI25\.656\fR \fI150\.22\fR
.P
Assuming that \fItestbase\.dbf\fR has 3 fields (\fBNAME\fR, \fBAREA\fR and \fBVALUE\fR), this command line will insert a new record into \fItestbase\.dbf\fR with the value "\fIREGION1\fR" for \fBNAME\fR, '\fI25\.656\fR' for \fBAREA\fR and '\fI150\.22\fR' for \fBVALUE\fR field\.
.SH "EXIT STATUS"
.TP
\fB0\fR
Successful program execution\.
.TP
\fB1\fR
Missing \fIxbase_file\fR or \fIfield_values\fR arguments\.
.TP
\fB2\fR
Failed to open \fIxbase_file\fR for reading and appending\.
.TP
\fB3\fR
Too few values in \fIfield_values\|\.\|\.\|\.\fR
.SH "DIAGNOSTICS"
The following diagnostics may be issued on stdout:
.P
DBFOpen(\fIxbase_file\fR,"rb+") failed\.
.P
Got \fIcount1\fR fields, but require \fIcount2\fR
.SH "AUTHOR"
\fBdbfcreate\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"
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 \fBatof\fR(3) get undefined values\.
.SH "SEE ALSO"
\fBdbfcat\fR(1), \fBdbfcreate\fR(1), \fBdbfdump\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)