header_finfo.c File Reference

Vector library - header manipulation (relevant for external formats) More...

#include <string.h>
#include <grass/vector.h>
#include <grass/glocale.h>

Include dependency graph for header_finfo.c:

Go to the source code of this file.

Functions
const char *	Vect_get_finfo_dsn_name (struct Map_info *Map)
	Get datasource name (relevant only for non-native formats)
char *	Vect_get_finfo_layer_name (struct Map_info *Map)
	Get layer name (relevant only for non-native formats)
const char *	Vect_get_finfo_format_info (struct Map_info *Map)
	Get format info as string (relevant only for non-native formats)
const char *	Vect_get_finfo_geometry_type (struct Map_info *Map)
	Get geometry type as string (relevant only for non-native formats)
const struct Format_info *	Vect_get_finfo (struct Map_info *Map)
	Get header info for non-native formats.
int	Vect_get_finfo_topology_info (struct Map_info *Map, char **toposchema, char **topogeom, int *topo_geo_only)
	Get topology type (relevant only for non-native formats)

Detailed Description

Vector library - header manipulation (relevant for external formats)

Higher level functions for reading/writing/manipulating vectors.

(C) 2001-2013 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.

Author

Original author CERL, probably Dave Gerdes or Mike Higgins.

Update to GRASS 5.7 Radim Blazek and David D. Gray.

Update to GRASS 7 (OGR/PostGIS support) by Martin Landa <landa.martin gmail.com>

Definition in file header_finfo.c.

Function Documentation

Vect_get_finfo()

const struct Format_info * Vect_get_finfo

(

struct Map_info *

Map

)

Get header info for non-native formats.

Parameters

Map	pointer to Map_info structure

Returns

pointer to Format_info structure

NULL for native format

Definition at line 209 of file header_finfo.c.

References NULL.

Vect_get_finfo_dsn_name()

const char * Vect_get_finfo_dsn_name

(

struct Map_info *

Map

)

Get datasource name (relevant only for non-native formats)

Returns:

• datasource name for OGR format (GV_FORMAT_OGR and GV_FORMAT_OGR_DIRECT)
• database name for PostGIS format (GV_FORMAT_POSTGIS)

Parameters

Map	pointer to Map_info structure

Returns

string containing OGR/PostGIS datasource name

NULL on error (map format is native)

Definition at line 37 of file header_finfo.c.

References _, G_debug(), G_free(), G_warning(), GV_FORMAT_OGR, GV_FORMAT_OGR_DIRECT, GV_FORMAT_POSTGIS, NULL, and Vect_get_full_name().

Vect_get_finfo_format_info()

const char * Vect_get_finfo_format_info

(

struct Map_info *

Map

)

Get format info as string (relevant only for non-native formats)

Parameters

Map	pointer to Map_info structure

Returns

string containing name of OGR format

"PostgreSQL" for PostGIS format (GV_FORMAT_POSTGIS)

NULL on error (or on missing OGR/PostgreSQL support)

Definition at line 104 of file header_finfo.c.

References GV_FORMAT_OGR, GV_FORMAT_OGR_DIRECT, GV_FORMAT_POSTGIS, and NULL.

Referenced by Vect_build_ogr(), and Vect_build_pg().

Vect_get_finfo_geometry_type()

const char * Vect_get_finfo_geometry_type

(

struct Map_info *

Map

)

Get geometry type as string (relevant only for non-native formats)

Note: All inner spaces are removed, function returns feature type in lowercase.

Parameters

Map	pointer to Map_info structure

Returns

allocated string containing geometry type info (point, linestring, polygon, ...)

NULL on error (map format is native)

Definition at line 131 of file header_finfo.c.

References _, DB_SQL_MAX, G_debug(), G_free(), G_malloc, G_store(), G_str_replace(), G_str_to_lower(), G_warning(), GV_FORMAT_OGR, GV_FORMAT_OGR_DIRECT, GV_FORMAT_POSTGIS, NULL, and Format_info_pg::res.

Referenced by Vect_build_ogr(), Vect_build_pg(), Vect_copy_map_lines_field(), and Vect_fidx_dump().

Vect_get_finfo_layer_name()

char * Vect_get_finfo_layer_name

(

struct Map_info *

Map

)

Get layer name (relevant only for non-native formats)

Returns:

• layer name for OGR format (GV_FORMAT_OGR and GV_FORMAT_OGR_DIRECT)
• table name for PostGIS format (GV_FORMAT_POSTGIS) including schema (<schema>.<table>)

Note: allocated string should be freed by G_free()

Parameters

Map	pointer to Map_info structure

Returns

string containing layer name

NULL on error (map format is native)

Definition at line 71 of file header_finfo.c.

References _, G_asprintf(), G_debug(), G_free(), G_store(), G_warning(), GV_FORMAT_OGR, GV_FORMAT_OGR_DIRECT, GV_FORMAT_POSTGIS, name, NULL, and Vect_get_full_name().

Referenced by Vect_copy_map_lines_field().

Vect_get_finfo_topology_info()

int Vect_get_finfo_topology_info	(	struct Map_info *	Map,
		char **	toposchema,
		char **	topogeom,
		int *	topo_geo_only
	)

Get topology type (relevant only for non-native formats)

Parameters

	Map	pointer to Map_info structure
[out]	toposchema	Topology schema name or NULL
[out]	topogeom	TopoGeometry column name or NULL
[out]	topo_geo_only	TRUE for Topo-Geo data model or NULL

Returns

GV_TOPO_NATIVE for native format

GV_TOPO_PSEUDO for pseudo-topology

GV_TOPO_POSTGIS for PostGIS Topology

Definition at line 232 of file header_finfo.c.

References G_store(), GV_FORMAT_OGR, GV_FORMAT_OGR_DIRECT, GV_FORMAT_POSTGIS, GV_TOPO_NATIVE, GV_TOPO_POSTGIS, GV_TOPO_PSEUDO, and Format_info_pg::topo_geo_only.