GRASS GIS 8 Programmer's Manual 8.4.1(2025)-45ca3179ab
Loading...
Searching...
No Matches
legal_name.c File Reference

GIS Library - Functions to handle file name legality. More...

#include <stdio.h>
#include <string.h>
#include <grass/gis.h>
#include <grass/glocale.h>
Include dependency graph for legal_name.c:

Go to the source code of this file.

Functions

int G_legal_filename (const char *s)
 Check for legal database file name.
 
int G_check_input_output_name (const char *input, const char *output, int error)
 Check input and output file names.
 

Detailed Description

GIS Library - Functions to handle file name legality.

(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 legal_name.c.

Function Documentation

◆ G_check_input_output_name()

int G_check_input_output_name ( const char * input,
const char * output,
int error )

Check input and output file names.

Check: 1) output is legal map name, 2) if can find input map, and 3) if input was found in current mapset, check if input != output.

Parameters
inputinput map name
outputoutput map name
errorerror type: G_FATAL_EXIT, G_FATAL_PRINT, G_FATAL_RETURN
Returns
0 OK
1 error

Definition at line 71 of file legal_name.c.

References G_fatal_error(), G_find_raster2(), G_legal_filename(), G_mapset(), G_name_is_fully_qualified(), G_warning(), NULL, and output().

◆ G_legal_filename()

int G_legal_filename ( const char * s)

Check for legal database file name.

Legal file names will not begin with '.' or NULL and must not contain the characters, ' ' (space), '/', '"'. '\'' (single quote), '@', ',', '=', '*', and all other non-alphanumeric characters within.

The function prints a warning on error.

Parameters
sfile name to check
Returns
1 success
-1 failure

Definition at line 34 of file legal_name.c.

References G_warning(), and name.

Referenced by G_check_input_output_name(), G_make_location(), and G_make_mapset().