ascii.c File Reference

Vector library - GRASS ASCII vector format. More...

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <grass/vector.h>
#include <grass/dbmi.h>
#include <grass/glocale.h>

Include dependency graph for ascii.c:

Go to the source code of this file.

Macros
#define	BUFFSIZE   128

Functions
int	Vect_read_ascii (FILE *ascii, struct Map_info *Map)
	Read data in GRASS ASCII vector format. More...
int	Vect_read_ascii_head (FILE *dascii, struct Map_info *Map)
	Read header of GRASS ASCII vector format. More...
int	Vect_write_ascii (FILE *ascii, FILE *att, struct Map_info *Map, int ver, int format, int dp, char *fs, int region_flag, int type, int field, const struct cat_list *Clist, const char *where, const char **column_names, int header)
	Write data to GRASS ASCII vector format. More...
void	Vect_write_ascii_head (FILE *dascii, struct Map_info *Map)
	Write data to GRASS ASCII vector format. More...

Detailed Description

Vector library - GRASS ASCII vector 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.

Author

Original author CERL

Updated for GRASS 7 (SF support) by Martin Landa <landa.martin gmail.com>

Definition in file ascii.c.

Macro Definition Documentation

BUFFSIZE

#define BUFFSIZE   128

Definition at line 24 of file ascii.c.

Referenced by Vect_read_ascii().

Function Documentation

Vect_read_ascii()

int Vect_read_ascii	(	FILE *	ascii,
		struct Map_info *	Map
	)

Read data in GRASS ASCII vector format.

Parameters

	ascii	pointer to the input ASCII file
[out]	Map	pointer to the output Map_info structure

Returns

number of read features

-1 on error

Definition at line 40 of file ascii.c.

References BUFFSIZE, and x.

Vect_read_ascii_head()

int Vect_read_ascii_head	(	FILE *	dascii,
		struct Map_info *	Map
	)

Read header of GRASS ASCII vector format.

Parameters

dascii	pointer to the ASCII file
Map	pointer to Map_info structure

Returns

0 on success

-1 on error

Definition at line 256 of file ascii.c.

References _, G_getl2(), G_warning(), Vect_set_comment(), Vect_set_date(), Vect_set_map_date(), Vect_set_map_name(), Vect_set_organization(), Vect_set_person(), Vect_set_scale(), Vect_set_thresh(), and Vect_set_zone().

Vect_write_ascii()

int Vect_write_ascii	(	FILE *	ascii,
		FILE *	att,
		struct Map_info *	Map,
		int	ver,
		int	format,
		int	dp,
		char *	fs,
		int	region_flag,
		int	type,
		int	field,
		const struct cat_list *	Clist,
		const char *	where,
		const char **	column_names,
		int	header
	)

Write data to GRASS ASCII vector format.

Prints message if some features without category are skipped.

Parameters

[out]	ascii	pointer to the output ASCII file
[out]	att	att file (< version 5 only)
	Map	pointer to Map_info structure
	ver	version number 4 or 5
	format	format GV_ASCII_FORMAT_POINT or GV_ASCII_FORMAT_STD
	dp	number of significant digits
	fs	field separator
	region_flag	check region
	type	feature type filter
	field	field number
	Clist	list of categories to filter features or NULL
	where	SQL select where statement to filter features or NULL
	column_names	array of columns to be included to the output or NULL "*" as the first item in the array indicates all columns
	header	TRUE to print also header

Returns

number of written features

-1 on error

Definition at line 336 of file ascii.c.

Vect_write_ascii_head()

void Vect_write_ascii_head	(	FILE *	dascii,
		struct Map_info *	Map
	)

Write data to GRASS ASCII vector format.

Parameters

[out]	dascii	pointer to the output ASCII file
	Map	pointer to Map_info structure

Definition at line 917 of file ascii.c.

References HOST_NEWLINE, Vect_get_comment(), Vect_get_date(), Vect_get_map_date(), Vect_get_map_name(), Vect_get_organization(), Vect_get_person(), Vect_get_scale(), Vect_get_thresh(), and Vect_get_zone().