.\" generated with Ronn-NG/v0.9.1
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
.TH "DBFCREATE" "1" "December 2023" "" "shplib"
.SH "NAME"
\fBdbfcreate\fR \- Create an empty xBase DBF file
.SH "SYNOPSIS"
\fBdbfcreate\fR \fIxbase_file\fR [[\fB\-s\fR \fIfield_name\fR \fIwidth\fR] | [\fB\-n\fR \fIfield_name\fR \fIwidth\fR \fIdecimals\fR],\|\.\|\.\|\.]
.SH "DESCRIPTION"
Creates an empty DBF file called \fIxbase_file\fR with columns described by all the \fB\-s\fR and \fB\-n\fR options that follow\.
.SH "OPTIONS"
.TP
\fIxbase_file\fR
the name of xBase file to be created\. Doesn't need the extension\.
.TP
\fB\-s\fR \fIfield_name\fR \fIwidth\fR
creates a string field with name \fIfield_name\fR and size \fIwidth\fR\.
.TP
\fB\-n\fR \fIfield_name\fR \fIwidth\fR \fIdecimals\fR
creates a numeric field with name \fIfield_name\fR, width of \fIwidth\fR and with \fIdecimals\fR places sized by decimals\.
.SH "EXAMPLE"
\fBdbfcreate\fR \fItestbase\fR \fB\-s\fR \fBNAME\fR \fI20\fR, \fB\-n\fR \fBAREA\fR \fI9\fR \fI3\fR, \fB\-n\fR \fBVALUE\fR \fI9\fR \fI2\fR
.P
this will create a file named \fItestbase\fR\fB\.dbf\fR with 3 fields: \fBNAME\fR (string (\fI20\fR)), \fBAREA\fR (float (\fI9\fR,\fI3\fR)) and \fBVALUE\fR (float (\fI9\fR,\fI2\fR))
.SH "EXIT STATUS"
.TP
\fB0\fR
Successful program execution\.
.TP
\fB1\fR
Missing \fIxbase_file\fR argument\.
.TP
\fB2\fR
Failed to create the file \fIxbase_file\fR for writing\.
.TP
\fB3\fR
Missing \fIfield_name\fR, \fIwidth\fR, or \fIdecimals\fR argument for a \fB\-s\fR or \fB\-n\fR option\.
.TP
\fB4\fR
Failed to add a column given by a \fB\-s\fR or \fB\-n\fR option\.
.SH "DIAGNOSTICS"
The following diagnostics may be issued on stdout:
.P
DBFCreate(\fIxbase_file\fR) failed\.
.P
DBFAddField(\fIfield_name\fR,FTString,\fIwidth\fR,0) failed\.
.P
DBFAddField(\fIfield_name\fR,FTDouble,\fIwidth\fR,\fIdecimals\fR) failed\.
.P
Argument incomplete, or unrecognised: \fIarg\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 "SEE ALSO"
\fBdbfadd\fR(1), \fBdbfcat\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)