NAME

       g.mlist   -  Lists  available  GRASS data base files of the user-specified data type optionally using the
       search pattern.

KEYWORDS

       general, map management

SYNOPSIS

       g.mlist
       g.mlist help
       g.mlist [-retmpf] type=datatype[,datatype,...]  [pattern=string]   [exclude=string]    [separator=string]
       [mapset=string]   [--verbose]  [--quiet]

   Flags:
       -r
           Use basic regular expressions instead of wildcards

       -e
           Use extended regular expressions instead of wildcards

       -t
           Print data types

       -m
           Print fully-qualified map names (including mapsets)

       -p
           Pretty printing in human readable format

       -f
           Verbose listing (also list map titles)

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       type=datatype[,datatype,...]
           Data type
           Options: rast,rast3d,vect,oldvect,asciivect,icon,labels,sites,region,region3d,group,3dview,all
           Default: rast

       pattern=string
           Map name search pattern (default: all)

       exclude=string
           Map name exclusion pattern (default: none)

       separator=string
           One-character output separator, newline, comma, space, or tab
           Default: newline

       mapset=string
           Mapset to list (default: current search path)

DESCRIPTION

       g.mlist  searches  for  data  files  matching  a  pattern  given  by  wildcards or POSIX Extended Regular
       Expressions.

EXAMPLES

       List all available GRASS data base files:
         g.mlist type=all
        List all raster and vector maps:
         g.mlist type=rast,vect

   Wildcards:
       List all vector maps starting with letter "r":
         g.mlist type=vect pattern="r*"
        List certain raster maps with one variable character/number:
         g.mlist type=rast pattern="N45E00?.meters"
        Use of exclude parameter:
       # without exclude:
       g.mlist rast pat="r*" mapset=PERMANENT
       railroads
       roads
       rstrct.areas
       rushmore
       # exclude only complete word(s):
       g.mlist rast pat="r*" exclude=roads mapset=PERMANENT
       railroads
       rstrct.areas
       rushmore
       # exclude with wildcard:
       g.mlist rast pat="r*" exclude="*roads*" mapset=PERMANENT
       rstrct.areas
       rushmore

   Regular expressions:
       Print out all soils map with "soils" in their name:
       g.mlist -r type=rast pattern='^soils'
        Print out "tmp" if "tmp" raster map exists:
         g.mlist -r pattern='^tmp$'
        Print out "tmp0" ..."tmp9" if corresponding vector map exists (each map name linewise):
         g.mlist -r type=vect pattern='^tmp[0-9]$'
        Print out "tmp0" ..."tmp9" if corresponding vector map exists (each map name comma separated):
         g.mlist -r type=vect separator=, pattern='^tmp[0-9]$'
        This may be useful for other programs' parameter input (e.g. r.series).

SEE ALSO

       g.list

       Regular expression (from Wikipedia, the free encyclopedia)

AUTHOR

       Huidae Cho
       grass4u@gmail.com

       Last changed: $Date: 2011-06-03 09:42:11 -0700 (Fri, 03 Jun 2011) $

       Full index

       © 2003-2013 GRASS Development Team

GRASS 6.4.3                                                                                      g.mlist(1grass)