.TH g.mlist 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBg.mlist\fR\fR  - Lists available GRASS data base files of the user-specified data type optionally using the search pattern.
.SH KEYWORDS
general, map management
.SH SYNOPSIS
\fBg.mlist\fR
.br
\fBg.mlist help\fR
.br
\fBg.mlist\fR [\-\fBretmpf\fR] \fBtype\fR=\fIdatatype\fR[,\fIdatatype\fR,...]  [\fBpattern\fR=\fIstring\fR]   [\fBexclude\fR=\fIstring\fR]   [\fBseparator\fR=\fIstring\fR]   [\fBmapset\fR=\fIstring\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-r\fR" 4m
.br
Use basic regular expressions instead of wildcards
.IP "\fB\-e\fR" 4m
.br
Use extended regular expressions instead of wildcards
.IP "\fB\-t\fR" 4m
.br
Print data types
.IP "\fB\-m\fR" 4m
.br
Print fully-qualified map names (including mapsets)
.IP "\fB\-p\fR" 4m
.br
Pretty printing in human readable format
.IP "\fB\-f\fR" 4m
.br
Verbose listing (also list map titles)
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBtype\fR=\fIdatatype[,\fIdatatype\fR,...]\fR" 4m
.br
Data type
.br
Options: \fIrast,rast3d,vect,oldvect,asciivect,icon,labels,sites,region,region3d,group,3dview,all\fR
.br
Default: \fIrast\fR
.IP "\fBpattern\fR=\fIstring\fR" 4m
.br
Map name search pattern (default: all)
.IP "\fBexclude\fR=\fIstring\fR" 4m
.br
Map name exclusion pattern (default: none)
.IP "\fBseparator\fR=\fIstring\fR" 4m
.br
One-character output separator, newline, comma, space, or tab
.br
Default: \fInewline\fR
.IP "\fBmapset\fR=\fIstring\fR" 4m
.br
Mapset to list (default: current search path)
.PP
.SH DESCRIPTION
\fIg.mlist\fR searches for data files matching a pattern given by wildcards or POSIX Extended Regular Expressions.
.SH EXAMPLES
List all available GRASS data base files:
\fC
.DS
.br
  g.mlist type=all
.br
.DE
\fR
List all raster and vector maps:
\fC
.DS
.br
  g.mlist type=rast,vect
.br
.DE
\fR
.SS Wildcards:
List all vector maps starting with letter "r":
\fC
.DS
.br
  g.mlist type=vect pattern="r*"
.br
.DE
\fR
List certain raster maps with one variable character/number:
\fC
.DS
.br
  g.mlist type=rast pattern="N45E00?.meters"
.br
.DE
\fR
Use of \fIexclude\fR parameter:
\fC
.DS
.br
# without exclude:
.br
g.mlist rast pat="r*" mapset=PERMANENT
.br
railroads
.br
roads
.br
rstrct.areas
.br
rushmore
.br
.br
# exclude only complete word(s):
.br
g.mlist rast pat="r*" exclude=roads mapset=PERMANENT
.br
railroads
.br
rstrct.areas
.br
rushmore
.br
.br
# exclude with wildcard:
.br
g.mlist rast pat="r*" exclude="*roads*" mapset=PERMANENT
.br
rstrct.areas
.br
rushmore
.br
.DE
\fR
.SS Regular expressions:
Print out all soils map with "soils" in their name:
\fC
.DS
.br
g.mlist \-r type=rast pattern='^soils'
.br
.DE
\fR
Print out "tmp" if "tmp" raster map exists:
\fC
.DS
.br
  g.mlist \-r pattern='^tmp$'
.br
.DE
\fR
Print out "tmp0" ..."tmp9" if corresponding vector map exists (each map name linewise):
\fC
.DS
.br
  g.mlist \-r type=vect pattern='^tmp[0-9]$'
.br
.DE
\fR
Print out "tmp0" ..."tmp9" if corresponding vector map exists (each map name comma separated):
\fC
.DS
.br
  g.mlist \-r type=vect separator=, pattern='^tmp[0-9]$'
.br
.DE
\fR
This may be useful for other programs' parameter input 
(e.g. \fIr.series\fR).
.SH SEE ALSO
\fIg.list\fR
.PP
Regular expression (from Wikipedia, the free encyclopedia)
.SH AUTHOR
Huidae Cho
.br
grass4u@gmail.com
.PP
\fILast changed: $Date: 2011-06-03 18:42:11 +0200 (Fri, 03 Jun 2011) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team