# $EPIC: glob.txt,v 1.4 2007/03/02 02:32:04 jnelson Exp $

Synopsis:

$glob(

pattern
)
 
======Technical:======
The <file glob pattern> argument is a [[what is a word|dword]] which is 
different than most functions.
 
This function is used to find filenames that are matched by specified
patterns.  This function is controlled by a compile time option, so it
may not be available on every installation.  Multiple patterns may be
specified.  Hidden files (dot-files) are not displayed unless a glob
pattern beginning with a dot is given.
 
======Practical:======
This function gives the client the file globbing abilities of modern
Unix command shells.  It will attempt to find any file or directory
names matching the given glob pattern.  This is highly useful for
listing files, or finding files with similar names.
 
======Returns:======
list of files matching input glob pattern, nothing if none match
 
======Examples:======
<file>
$glob(~/*)    returns all non-hidden files in your home directory
$glob(*)      returns all non-hidden files in your current directory
$glob(.*)     returns all hidden files in your current directory
$glob(f*)     returns all non-hidden files that start with "f" in cwd

Restrictions:

This function may not be present in all clients. A compile-time option is available to disable it. The function is present if the string returned by $info(o) has a ā€œgā€ in it.