GRASS GIS 8 Programmer's Manual
8.2.2dev(2023)-3d2c704037
|
Vector library - Open existing or create new vector map (native or OGR/PostGIS format) More...
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <grass/vector.h>
#include <grass/glocale.h>
#include "local_proto.h"
#include "pg_local_proto.h"
Go to the source code of this file.
Macros | |
#define | MAX_OPEN_LEVEL 2 |
Functions | |
int | Vect_set_open_level (int level) |
Predetermine level at which a vector map will be opened for reading. More... | |
int | Vect__open_old (struct Map_info *Map, const char *name, const char *mapset, const char *layer, int update, int head_only, int is_tmp) |
Open existing vector map for reading (internal use only) More... | |
int | Vect_open_old (struct Map_info *Map, const char *name, const char *mapset) |
Open existing vector map for reading. More... | |
int | Vect_open_tmp_old (struct Map_info *Map, const char *name, const char *mapset) |
Open existing temporary vector map for reading. More... | |
int | Vect_open_old2 (struct Map_info *Map, const char *name, const char *mapset, const char *layer) |
Open existing vector map for reading. More... | |
int | Vect_open_update (struct Map_info *Map, const char *name, const char *mapset) |
Open existing vector map for reading/writing. More... | |
int | Vect_open_tmp_update (struct Map_info *Map, const char *name, const char *mapset) |
Open existing temporary vector map for reading/writing. More... | |
int | Vect_open_update2 (struct Map_info *Map, const char *name, const char *mapset, const char *layer) |
Open existing vector map for reading/writing. More... | |
int | Vect_open_old_head (struct Map_info *Map, const char *name, const char *mapset) |
Reads only info about vector map (headers) More... | |
int | Vect_open_old_head2 (struct Map_info *Map, const char *name, const char *mapset, const char *layer) |
Reads only info about vector map (headers) More... | |
int | Vect_open_update_head (struct Map_info *Map, const char *name, const char *mapset) |
Open header file of existing vector map for updating (mostly for database link updates) More... | |
int | Vect_open_new (struct Map_info *Map, const char *name, int with_z) |
Create new vector map for reading/writing. More... | |
int | Vect_open_tmp_new (struct Map_info *Map, const char *name, int with_z) |
Create new temporary vector map. More... | |
int | Vect_coor_info (const struct Map_info *Map, struct Coor_info *Info) |
Update Coor_info structure. More... | |
const char * | Vect_maptype_info (const struct Map_info *Map) |
Gets vector map format (as string) More... | |
int | Vect_maptype (const struct Map_info *Map) |
Gets vector map format. More... | |
int | Vect_open_topo (struct Map_info *Map, int head_only) |
Open topology file ('topo') More... | |
int | Vect_open_sidx (struct Map_info *Map, int mode) |
Open spatial index file ('sidx') More... | |
char * | Vect__get_path (char *path, const struct Map_info *Map) |
Get map directory name (internal use only) More... | |
char * | Vect__get_element_path (char *file_path, const struct Map_info *Map, const char *element) |
Get map element full path (internal use only) More... | |
Vector library - Open existing or create new vector map (native or OGR/PostGIS format)
Higher level functions for reading/writing/manipulating vectors.
(C) 2001-2015 by the GRASS Development Team
This program is free software under the GNU General Public License (>=v2). Read the file COPYING that comes with GRASS for details.
Definition in file vector/Vlib/open.c.
#define MAX_OPEN_LEVEL 2 |
Definition at line 44 of file vector/Vlib/open.c.
char* Vect__get_element_path | ( | char * | file_path, |
const struct Map_info * | Map, | ||
const char * | element | ||
) |
Get map element full path (internal use only)
Allocate string should be freed by G_free().
Map | pointer to Map_info struct |
element | element name, eg. GV_TOPO_ELEMENT |
Definition at line 1479 of file vector/Vlib/open.c.
References G_file_name(), G_file_name_tmp(), GPATH_MAX, Map_info::mapset, Map_info::temporary, and Vect__get_path().
Referenced by V1_close_nat(), V1_open_new_nat(), V2_close_pg(), Vect_cidx_open(), Vect_coor_info(), Vect_open_topo(), Vect_save_fidx(), and Vect_save_sidx().
char* Vect__get_path | ( | char * | path, |
const struct Map_info * | Map | ||
) |
Get map directory name (internal use only)
file_path | path string buffer |
Map | pointer to Map_info struct |
Definition at line 1455 of file vector/Vlib/open.c.
References G__temp_element(), GPATH_MAX, GV_DIRECTORY, Map_info::name, Map_info::temporary, and TRUE.
Referenced by V1_open_new_nat(), V1_open_old_nat(), Vect__get_element_path(), Vect__read_head(), Vect__write_head(), Vect_cidx_open(), Vect_open_topo(), Vect_save_topo(), and Vect_write_dblinks().
int Vect__open_old | ( | struct Map_info * | Map, |
const char * | name, | ||
const char * | mapset, | ||
const char * | layer, | ||
int | update, | ||
int | head_only, | ||
int | is_tmp | ||
) |
Open existing vector map for reading (internal use only)
[out] | Map | pointer to Map_info structure |
name | name of vector map to open | |
mapset | mapset name ("" for search path) | |
layer | layer name (OGR format only) | |
update | non-zero to open for update otherwise read-only mode | |
head_only | read only header info from 'head', 'dbln', 'topo', 'cidx' is not opened. The header may be opened on level 2 only. | |
is_tmp | non-zero code for temporary maps |
Definition at line 162 of file vector/Vlib/open.c.
References GMAPSET_MAX, GNAME_MAX, and GPATH_MAX.
Referenced by Vect_open_old(), Vect_open_old2(), Vect_open_old_head(), Vect_open_old_head2(), Vect_open_tmp_old(), Vect_open_tmp_update(), Vect_open_update(), Vect_open_update2(), and Vect_open_update_head().
Update Coor_info structure.
Definition at line 975 of file vector/Vlib/open.c.
References _, Map_info::dig_fp, dig_fseek(), dig_ftell(), Map_info::format, G_debug(), G_warning(), GPATH_MAX, GV_COOR_ELEMENT, GV_FORMAT_NATIVE, GV_FORMAT_OGR, GV_FORMAT_OGR_DIRECT, GV_FORMAT_POSTGIS, Coor_info::mtime, Map_info::open, Coor_info::size, Vect__get_element_path(), and VECT_OPEN_CODE.
Referenced by V1_close_nat(), V1_open_old_nat(), and Vect_open_topo().
int Vect_maptype | ( | const struct Map_info * | Map | ) |
Gets vector map format.
Currently are implemented:
Map | pointer to Map_info structure |
Definition at line 1069 of file vector/Vlib/open.c.
References Format_info_pg::conninfo, Format_info_ogr::driver_name, Map_info::fInfo, Map_info::format, GV_FORMAT_OGR, GV_FORMAT_POSTGIS, Format_info::ogr, Format_info::pg, and Map_info::temporary.
Referenced by Vect_fidx_dump().
const char* Vect_maptype_info | ( | const struct Map_info * | Map | ) |
Gets vector map format (as string)
Note: string is allocated by G_store(). Free allocated memory with G_free().
Currently are implemented:
Map | pointer to Map_info structure |
Definition at line 1033 of file vector/Vlib/open.c.
References _, Map_info::format, G_store(), GV_FORMAT_NATIVE, GV_FORMAT_OGR, GV_FORMAT_OGR_DIRECT, and GV_FORMAT_POSTGIS.
Referenced by Vect_fidx_dump().
int Vect_open_new | ( | struct Map_info * | Map, |
const char * | name, | ||
int | with_z | ||
) |
Create new vector map for reading/writing.
By default list of updated features is not maintained, see Vect_set_updated() for details.
By default map format is native (GV_FORMAT_NATIVE). If OGR file is found in the current mapset then the map (ie. OGR layer) is created in given OGR datasource (GV_FORMAT_OGR). Similarly if PG file exists then the map (ie. PostGIS table) is created using PostGIS interface (GV_FORMAT_POSTGIS). The format of map is stored in Map->format.
[out] | Map | pointer to Map_info structure |
name | name of vector map to be created | |
with_z | WITH_Z for 3D vector data otherwise WITHOUT_Z |
Definition at line 921 of file vector/Vlib/open.c.
References G_debug(), and getenv().
Referenced by Vect_close().
int Vect_open_old | ( | struct Map_info * | Map, |
const char * | name, | ||
const char * | mapset | ||
) |
Open existing vector map for reading.
This function is replaced by Vect_open_old2() to handle also direct OGR support.
Calls G_fatal_error() on failure.
[out] | Map | pointer to Map_info structure |
name | name of vector map to open | |
mapset | mapset name ("" for search path) |
Definition at line 573 of file vector/Vlib/open.c.
References FALSE, NULL, and Vect__open_old().
int Vect_open_old2 | ( | struct Map_info * | Map, |
const char * | name, | ||
const char * | mapset, | ||
const char * | layer | ||
) |
Open existing vector map for reading.
Calls G_fatal_error() on failure.
[out] | Map | pointer to Map_info structure |
name | name of vector map to open (datasource for direct OGR access) | |
mapset | mapset name ("" for search path, "OGR" for direct OGR access) | |
layer | layer name (OGR layer for direct OGR access) |
Definition at line 615 of file vector/Vlib/open.c.
References FALSE, and Vect__open_old().
int Vect_open_old_head | ( | struct Map_info * | Map, |
const char * | name, | ||
const char * | mapset | ||
) |
Reads only info about vector map (headers)
Reads from headers of 'head', 'dbln', 'topo' and 'cidx' file.
This function is replaced by Vect_open_old_head2() to handle also direct OGR support.
Calls G_fatal_error() on failure.
[out] | Map | pointer to Map_info structure |
name | name of vector map to read | |
mapset | mapset name ("" for search path) |
Definition at line 711 of file vector/Vlib/open.c.
References FALSE, NULL, TRUE, and Vect__open_old().
int Vect_open_old_head2 | ( | struct Map_info * | Map, |
const char * | name, | ||
const char * | mapset, | ||
const char * | layer | ||
) |
Reads only info about vector map (headers)
Reads from headers of 'head', 'dbln', 'topo' and 'cidx' file.
Calls G_fatal_error() on failure.
[out] | Map | pointer to Map_info structure |
name | name of vector map to read (dsn for OGR) | |
mapset | mapset name ("" for search path) | |
layer | layer name (OGR format) | |
[out] | Map | pointer to Map_info structure |
name | name of vector map to open (datasource for direct OGR access) | |
mapset | mapset name ("" for search path, "OGR" for direct OGR access) | |
layer | layer name (OGR layer for direct OGR access) |
Definition at line 737 of file vector/Vlib/open.c.
References FALSE, TRUE, and Vect__open_old().
int Vect_open_sidx | ( | struct Map_info * | Map, |
int | mode | ||
) |
Open spatial index file ('sidx')
[in,out] | Map | pointer to Map_info |
mode | 0 old, 1 update, 2 new |
Definition at line 1176 of file vector/Vlib/open.c.
Referenced by Vect_build_partial().
int Vect_open_tmp_new | ( | struct Map_info * | Map, |
const char * | name, | ||
int | with_z | ||
) |
Create new temporary vector map.
Temporary vector maps are stored in the current mapset (directory .tmp/<hostname>/vector
). If the map already exists, it is overwritten.
Temporary vector maps are automatically deleted when closing the map (see Vect_close() for details).
If name is not given (is NULL), then the name is determined by process id (tmp_<pid>
).
[out] | Map | pointer to output Map_info struct |
name | name for new vector map (or NULL) | |
with_z | WITH_Z for 3D vector data otherwise WITHOUT_Z |
Definition at line 951 of file vector/Vlib/open.c.
int Vect_open_tmp_old | ( | struct Map_info * | Map, |
const char * | name, | ||
const char * | mapset | ||
) |
Open existing temporary vector map for reading.
Temporary vector maps are stored in the current mapset (directory .tmp/<hostname>/vector
).
Calls G_fatal_error() on failure.
[out] | Map | pointer to Map_info structure |
name | name of vector map to open | |
mapset | mapset name ("" for search path) |
Definition at line 596 of file vector/Vlib/open.c.
References FALSE, NULL, TRUE, and Vect__open_old().
int Vect_open_tmp_update | ( | struct Map_info * | Map, |
const char * | name, | ||
const char * | mapset | ||
) |
Open existing temporary vector map for reading/writing.
Temporary vector maps are stored in the current mapset (directory .tmp/<hostname>/vector
).
By default list of updated features is not maintained, see Vect_set_updated() for details.
Calls G_fatal_error() on failure.
[out] | Map | pointer to Map_info structure |
name | name of vector map to update | |
mapset | mapset name |
Definition at line 666 of file vector/Vlib/open.c.
References FALSE, NULL, TRUE, and Vect__open_old().
int Vect_open_topo | ( | struct Map_info * | Map, |
int | head_only | ||
) |
Open topology file ('topo')
[in,out] | Map | pointer to Map_info structure |
head_only | TRUE to read only header |
Definition at line 1096 of file vector/Vlib/open.c.
References _, Plus_head::coor_mtime, Plus_head::coor_size, dig_file_init(), dig_load_plus(), dig_Rd_Plus_head(), err(), gvfile::file, G_debug(), G_fopen_old(), G_warning(), GPATH_MAX, GV_TOPO_ELEMENT, Map_info::mapset, Map_info::name, NULL, Map_info::plus, Coor_info::size, Vect__get_element_path(), Vect__get_path(), and Vect_coor_info().
int Vect_open_update | ( | struct Map_info * | Map, |
const char * | name, | ||
const char * | mapset | ||
) |
Open existing vector map for reading/writing.
This function is replaced by Vect_open_update2() to handle also direct OGR support.
By default list of updated features is not maintained, see Vect_set_updated() for details.
Calls G_fatal_error() on failure.
[out] | Map | pointer to Map_info structure |
name | name of vector map to update | |
mapset | mapset name |
Definition at line 640 of file vector/Vlib/open.c.
References FALSE, NULL, TRUE, and Vect__open_old().
int Vect_open_update2 | ( | struct Map_info * | Map, |
const char * | name, | ||
const char * | mapset, | ||
const char * | layer | ||
) |
Open existing vector map for reading/writing.
By default list of updated features is not maintained, see Vect_set_updated() for details.
Calls G_fatal_error() on failure.
[out] | Map | pointer to Map_info structure |
name | name of vector map to open (datasource for direct OGR access) | |
mapset | mapset name ("" for search path, "OGR" for direct OGR access) | |
layer | layer name (OGR layer for direct OGR access) |
Definition at line 688 of file vector/Vlib/open.c.
References FALSE, TRUE, and Vect__open_old().
int Vect_open_update_head | ( | struct Map_info * | Map, |
const char * | name, | ||
const char * | mapset | ||
) |
Open header file of existing vector map for updating (mostly for database link updates)
[out] | Map | pointer to Map_info structure |
name | name of vector map to update | |
mapset | mapset name |
Definition at line 754 of file vector/Vlib/open.c.
References FALSE, NULL, TRUE, and Vect__open_old().
int Vect_set_open_level | ( | int | level | ) |
Predetermine level at which a vector map will be opened for reading.
If it can't open that level, the open will fail. The specified level must be set before any call to open. The default is to try to open the highest level possible, and keep stepping down until success.
NOTE: This should only be used to set when you wish to force a lower level open. If you require a higher level, then just check the return to verify the level instead of forcing it. This is because future releases will have higher levels which will be downward compatible and which your programs should support by default.
level | vector access level |
Definition at line 134 of file vector/Vlib/open.c.