1DBFADD(1)                          shapelib                          DBFADD(1)
2
3
4

NAME

6       dbfadd - add a row to an xBase DBF file
7

SYNOPSIS

9       dbfadd xbase_file field_values...
10

DESCRIPTION

12       Adds a row to the DBF file named by xbase_file with column values given
13       by the field_values options that follow. A NULL value is denoted by  an
14       empty argument.
15

OPTIONS

17       xbase_file
18              the name of an existing xBase file
19
20       field_values
21              list  of  values  to  be  inserted into the xBase file. You must
22              specify a number of values equal to the  number  of  fields  the
23              xBase  file has. The order of values must also reflect the order
24              of fields inside xBase file.
25

EXAMPLE

27       dbfadd testbase.dbf REGION1 25.656 150.22
28
29       Assuming that testbase.dbf has 3 fields (NAME, AREA  and  VALUE),  this
30       command  line will insert a new record into testbase.dbf with the value
31       "REGION1" for NAME, ´25.656´ for AREA and ´150.22´ for VALUE field.
32

EXIT STATUS

34       0      Successful program execution.
35
36       1      Missing xbase_file or field_values arguments.
37
38       2      Failed to open xbase_file for reading and appending.
39
40       3      Too few values in field_values...
41

DIAGNOSTICS

43       The following diagnostics may be issued on stdout:
44
45       DBFOpen(xbase_file,"rb+") failed.
46
47       Got count1 fields, but require count2
48

AUTHOR

50       dbfcreate is part of shapelib,  maintained  by  Frank  Warmerdam.  This
51       guide  was created by Eduardo Patoo Kanegae and converted to manpage by
52       Johan Van de Wauw. It was further enhanced with the man page written by
53       Joonas Pihlaja (jpihlaja@cc.helsinki.fi).
54

BUGS

56       Field  values  that  are too large to fit in a field are silently trun‐
57       cated from the right. Numeric field values  that  can´t  be  parsed  by
58       atof(3) get undefined values.
59

SEE ALSO

61       dbfcat(1),  dbfcreate(1), dbfdump(1), dbfinfo(1), shpadd(1), shpcat(1),
62       shpcentrd(1),  shpcreate(1),  shpdump(1),  shpdxf(1),  shpfix(1),   sh‐
63       pinfo(1), shpproj(1), shprewind(1), shptest(1)
64
65
66
67                                   July 2023                         DBFADD(1)
Impressum