EPIC
Enhanced
Programmable
IRC-II
Client

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
# $EPIC: glob.txt,v 1.4 2007/03/02 02:32:04 jnelson Exp $
======Synopsis:======
$__glob__(<file 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
</file>

======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 function|info]](o) has a "g" in it.