find_vect.c

Go to the documentation of this file.

/*!
   \file lib/gis/find_vect.c
 
   \brief GIS library - Find a vector map
 
   (C) 2001-2009 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
 */
 
#include <string.h>
 
#include <grass/config.h>
#include <grass/gis.h>
#include <grass/vect/dig_defines.h>
#include <grass/glocale.h>
 
/*!
   \brief Finds a vector map
 
   Searches for a vector map from the mapset search list or in a
   specified mapset. Returns the mapset name where the vector map was
   found.
 
   NOTES:
   If the user specifies a fully qualified vector map which exists,
   then G_find_vector() modifies <i>name</i> by removing the
   "@<i>mapset</i>" part.
 
   Rejects all names that begin with "."
 
   \param name vector map name
   \param mapset mapset name or "" for search path
 
   \return pointer to a string with name of mapset where vector map was found
   \return NULL if not found
 */
const char *G_find_vector(char *name, const char *mapset)
{
    G_debug(1, "G_find_vector(): name=%s mapset=%s", name, mapset);
    return G_find_file(GV_DIRECTORY, name, mapset);
}
 
/*!
 * \brief Find a vector map (look but don't touch)
 *
 * The same as G_find_vector() but doesn't remove the "@<i>mapset</i>"
 * qualification from <i>name</i>, if present.
 *
 * Returns NULL if the map wasn't found, or the mapset the vector was
 * found in if it was.
 *
 * \param name vector map name
 * \param mapset mapset name where to search
 *
 * \return pointer to buffer containing mapset name
 * \return NULL when vector map not found
 */
const char *G_find_vector2(const char *name, const char *mapset)
{
    G_debug(1, "G_find_vector2(): name=%s mapset=%s", name, mapset);
    return G_find_file2(GV_DIRECTORY, name, mapset);
}