nme_in_mps.c File Reference

GIS Library - check map name. More...

#include <string.h>
#include <grass/gis.h>

Include dependency graph for nme_in_mps.c:

Go to the source code of this file.

Functions
int	G_name_is_fully_qualified (const char *fullname, char *name, char *mapset)
	Check if map name is fully qualified (map @ mapset) More...
char *	G_fully_qualified_name (const char *name, const char *mapset)
	Get fully qualified element name. More...
int	G_unqualified_name (const char *name, const char *mapset, char *xname, char *xmapset)
	Returns unqualified map name (without @ mapset) More...

Detailed Description

GIS Library - check map name.

(C) 2001-2009, 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

Definition in file nme_in_mps.c.

Function Documentation

G_fully_qualified_name()

char* G_fully_qualified_name	(	const char *	name,
		const char *	mapset
	)

Get fully qualified element name.

Returns a fully qualified name for GIS element name in mapset. Currently this string is in the form name@mapset, but the programmer should pretend not to know this and always call this routine to get the fully qualified name.

String is allocated by G_store().

#include <grass/gis.h>
int main(char *argc, char **argv)
{
char name[GNAME_MAX], *mapset, *fqn;
char command[1024];
 
G_gisinit(argv[0]);
mapset = G_find_rast(name, "");
if (mapset == NULL)
exit(EXIT_SUCCESS);
 
fqn = G_fully_qualified_name (name, mapset);
printf (stdout, "map='%s'", fqn);
 
exit(EXIT_SUCCESS);
}

Parameters

name	element name
mapset	mapset name

Returns

pointer to full element name (map@mapset)

Definition at line 101 of file nme_in_mps.c.

References G_store(), GMAPSET_MAX, GNAME_MAX, and name.

Referenced by M_do_copy(), Rast__check_fp_type(), Rast__open_old(), Rast__quant_import(), Rast_map_is_fp(), Rast_mask_name(), Rast_quantize_fp_map(), Rast_read_fp_range(), and Rast_read_range().

G_name_is_fully_qualified()

int G_name_is_fully_qualified	(	const char *	fullname,
		char *	name,
		char *	mapset
	)

Check if map name is fully qualified (map @ mapset)

Returns a fully qualified name for the file name in mapset. Currently this string is in the form name@mapset, but the programmer should pretend not to know this and always call this routine to get the fully qualified name.

Note:

• name is char array of size GNAME_MAX
• mapset is char array of size GMAPSET_MAX

Parameters

	fullname	full map name
[out]	name	map name
[out]	mapset	mapset name

Returns

1 if input map name is fully qualified

0 if input map name is not fully qualified

Definition at line 36 of file nme_in_mps.c.

References name.

Referenced by G_rename(), G_unqualified_name(), M_do_remove(), Rast__quant_export(), Rast__quant_import(), Rast_remove_colors(), Vect_copy(), and Vect_remove_colors().

G_unqualified_name()

int G_unqualified_name	(	const char *	name,
		const char *	mapset,
		char *	xname,
		char *	xmapset
	)

Returns unqualified map name (without @ mapset)

Returns an unqualified name for the file name in mapset.

Note:

• name, xname are char array of size GNAME_MAX
• mapset, xmapset are char array of size GMAPSET_MAX

Parameters

	name	map name
	mapset	mapset to check or NULL
[out]	xname	map name
[out]	xmapset	mapset name

Returns

1 if input map name is fully qualified

0 if name is not fully qualified

-1 if input mapset invalid (mapset != xmapset)

Definition at line 134 of file nme_in_mps.c.

References G_name_is_fully_qualified(), name, and strcpy.

Referenced by I_fopen_signature_file_old(), I_fopen_sigset_file_old(), Rast3d_open_cell_old_no_header(), Rast__open_null_write(), and Rast__open_old().