User Tools

Site Tools


glob

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

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.
 +
  
glob.txt ยท Last modified: 2007/03/02 02:32 (external edit)