Functions

list.c File Reference

List elements. More...

#include <stdlib.h>
#include <unistd.h>
#include <signal.h>
#include <string.h>
#include <sys/types.h>
#include <dirent.h>
#include <grass/gis.h>
#include <grass/glocale.h>
Include dependency graph for list.c:

Go to the source code of this file.

Functions

int G_set_list_hit_return (int flag)
int G_list_element (const char *element, const char *desc, const char *mapset, int(*lister)(const char *, const char *, const char *))
 General purpose list function.
char ** G_list (int element, const char *gisbase, const char *location, const char *mapset)
 List specified type of elements. Application must release the allocated memory.
void G_free_list (char **list)
 Free list.

Detailed Description

List elements.

Author:
Unknown (probably CERL)

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

Definition in file list.c.


Function Documentation

void G_free_list ( char **  list  ) 

Free list.

Parameters:
list char* array to be freed
Returns:

Definition at line 302 of file list.c.

References G_free().

char** G_list ( int  element,
const char *  gisbase,
const char *  location,
const char *  mapset 
)

List specified type of elements. Application must release the allocated memory.

Parameters:
element Element type (G_ELEMENT_RASTER, G_ELEMENT_VECTOR, G_ELEMENT_REGION )
gisbase Path to GISBASE
location Location name
mapset Mapset name
Returns:
Zero terminated array of element names

Definition at line 227 of file list.c.

References G_fatal_error(), G_free(), and NULL.

int G_list_element ( const char *  element,
const char *  desc,
const char *  mapset,
int(*)(const char *, const char *, const char *)  lister 
)

General purpose list function.

Will list files from all mapsets in the mapset list for a specified database element.

Note: output is to stdout piped thru the more utility

lister (char *name char *mapset, char* buf)

Given file 'name', and 'mapset', lister() should copy a string into 'buf' when called with name == "", should set buf to general title for mapset list.

Parameters:
element Database element (eg, "cell", "cellhd", etc)
desc Description for element (if NULL, element is used)
mapset Mapset to be listed "" to list all mapsets in mapset search list "." will list current mapset
lister If given will call this routine to get a list title. NULL if no titles desired.
Returns:
Number of elements

Definition at line 60 of file list.c.

References G__mapset_name(), and G_pclose().

int G_set_list_hit_return ( int  flag  ) 

Definition at line 32 of file list.c.