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, 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)

Definition at line 101 of file nme_in_mps.c.

References G_store(), GMAPSET_MAX, and GNAME_MAX.

Referenced by M_do_copy(), Rast__check_fp_type(), Rast__open_old(), Rast__quant_import(), Rast_map_is_fp(), 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, 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(), I_fopen_signature_file_new(), I_fopen_sigset_file_new(), 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().

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().