Vector library - Copy vector features and attribute tables linked to the map. More...

#include <grass/vector.h>
#include <grass/glocale.h>
#include "local_proto.h"
#include "pg_local_proto.h"

Include dependency graph for vector/Vlib/copy.c:

Macros
#define	TOPO_NONE -1
	Copy topological elements. More...

#define	TOPO_NATIVE 1

#define	TOPO_POSTGIS 2

Functions
int	Vect_copy_map_lines (struct Map_info In, struct Map_info Out)
	Copy all alive vector features from input vector map to output vector map. More...

int	Vect_copy_map_lines_field (struct Map_info In, int field, struct Map_info Out)
	Copy all alive vector features from given layer from input vector map to output vector map. More...

int	Vect__copy_areas (const struct Map_info In, int field, struct Map_info Out)
	Copy areas as polygons (OGR/PostGIS simple features access only) More...

int	Vect_copy_tables (const struct Map_info In, struct Map_info Out, int field)
	Copy attribute tables linked to vector map. More...

int	Vect_copy_table (const struct Map_info In, struct Map_info Out, int field_in, int field_out, const char *field_name, int type)
	Copy attribute table linked to vector map based on type. More...

int	Vect_copy_table_by_cat_list (const struct Map_info In, struct Map_info Out, int field_in, int field_out, const char field_name, int type, const struct cat_list cat_list)
	Copy attribute table linked to vector map based on category list. More...

int	Vect_copy_table_by_cats (const struct Map_info In, struct Map_info Out, int field_in, int field_out, const char field_name, int type, int cats, int ncats)
	Copy attribute table linked to vector map based on category numbers. More...

Detailed Description

Vector library - Copy vector features and attribute tables linked to the map.

Higher level functions for reading/writing/manipulating vectors.

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 by Martin Landa <landa.martin gmail.com> (OGR/PostGIS topology support)

Definition in file vector/Vlib/copy.c.

Macro Definition Documentation

◆ TOPO_NATIVE

#define TOPO_NATIVE 1

Definition at line 31 of file vector/Vlib/copy.c.

◆ TOPO_NONE

#define TOPO_NONE -1

Copy topological elements.

simple features (None)
native topo (GRASS)
PostGIS Topo

Definition at line 30 of file vector/Vlib/copy.c.

◆ TOPO_POSTGIS

#define TOPO_POSTGIS 2

Definition at line 32 of file vector/Vlib/copy.c.

Function Documentation

◆ Vect__copy_areas()

int Vect__copy_areas	(	const struct Map_info *	In,
		int	field,
		struct Map_info *	Out
	)

Copy areas as polygons (OGR/PostGIS simple features access only)

Parameters

In	input vector map
field	layer number (-1 for all layers)
Out	output vector map

Returns: 0 on success; 1 on error

Definition at line 486 of file vector/Vlib/copy.c.

◆ Vect_copy_map_lines()

int Vect_copy_map_lines	(	struct Map_info *	In,
		struct Map_info *	Out
	)

Copy all alive vector features from input vector map to output vector map.

Parameters

	In	input vector map
[out]	Out	output vector map

Returns: 0 on success; 1 on error

Definition at line 57 of file vector/Vlib/copy.c.

References Vect_copy_map_lines_field().

◆ Vect_copy_map_lines_field()

int Vect_copy_map_lines_field	(	struct Map_info *	In,
		int	field,
		struct Map_info *	Out
	)

Copy all alive vector features from given layer from input vector map to output vector map.

Note: Try to copy on level 2 otherwise level 1 is used.

Parameters

	In	input vector map
	field	layer number (-1 for all layers)
[out]	Out	output vector map

Returns: 0 on success; 1 on error

Definition at line 75 of file vector/Vlib/copy.c.

Referenced by Vect_close(), and Vect_copy_map_lines().

◆ Vect_copy_table()

int Vect_copy_table	(	const struct Map_info *	In,
		struct Map_info *	Out,
		int	field_in,
		int	field_out,
		const char *	field_name,
		int	type
	)

Copy attribute table linked to vector map based on type.

Parameters

	In	input vector map
[out]	Out	output vector map
	field_in	input layer number
	field_out	output layer number
	field_name	layer name (can be NULL)
	type	how many tables are linked to map: GV_1TABLE / GV_MTABLE

Returns: 0 on success; -1 on error

Definition at line 652 of file vector/Vlib/copy.c.

◆ Vect_copy_table_by_cat_list()

int Vect_copy_table_by_cat_list	(	const struct Map_info *	In,
		struct Map_info *	Out,
		int	field_in,
		int	field_out,
		const char *	field_name,
		int	type,
		const struct cat_list *	cat_list
	)

Copy attribute table linked to vector map based on category list.

If cat_list is NULL, then Vect_copy_table() is called.

Parameters

	In	input vector map
[out]	Out	output vector map
	field_in	input layer number
	field_out	output layer number
	field_name	layer name (can be NULL)
	type	how many tables are linked to map: GV_1TABLE / GV_MTABLE
	cat_list	pointer to cat_list struct (can be NULL)

Returns: 0 on success; -1 on error

Definition at line 676 of file vector/Vlib/copy.c.

◆ Vect_copy_table_by_cats()

int Vect_copy_table_by_cats	(	const struct Map_info *	In,
		struct Map_info *	Out,
		int	field_in,
		int	field_out,
		const char *	field_name,
		int	type,
		int *	cats,
		int	ncats
	)

Copy attribute table linked to vector map based on category numbers.

Parameters

	In	input vector map
[out]	Out	output vector map
	field_in	input layer number
	field_out	output layer number
	field_name	layer name (can be NULL)
	type	how many tables are linked to map: GV_1TABLE / GV_MTABLE
	cats	pointer to array of cats or NULL
	ncats	number of cats in 'cats'

Returns: 0 on success; -1 on error

Definition at line 716 of file vector/Vlib/copy.c.

◆ Vect_copy_tables()

int Vect_copy_tables	(	const struct Map_info *	In,
		struct Map_info *	Out,
		int	field
	)

Copy attribute tables linked to vector map.

Copy all attribute tables linked to the vector map if field is 0, or selected attribute table defined by given field if field > 0.

Notice, that if input vector map has no tables defined, it will copy nothing and return 0 (success).

Parameters

	In	input vector map
[out]	Out	output vector map
	field	layer number (0 for all tables linked to the vector map)

Returns: 0 on success; -1 on error

Definition at line 603 of file vector/Vlib/copy.c.

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ TOPO_NATIVE

◆ TOPO_NONE

◆ TOPO_POSTGIS

Function Documentation

◆ Vect__copy_areas()

◆ Vect_copy_map_lines()

◆ Vect_copy_map_lines_field()

◆ Vect_copy_table()

◆ Vect_copy_table_by_cat_list()

◆ Vect_copy_table_by_cats()

◆ Vect_copy_tables()