GRASS GIS 7 Programmer's Manual  7.9.dev(2021)-e5379bbd7
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
nameelement name
mapsetmapset 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
fullnamefull map name
[out]namemap name
[out]mapsetmapset 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
namemap name
mapsetmapset to check or NULL
[out]xnamemap name
[out]xmapsetmapset 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().