This shows you the differences between two versions of the page.
— |
glob [2007/03/02 02:32] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | # $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. | ||
+ | |||