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

  input | input map name
  output | output map name
  error | error 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

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