home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / MorphOS / Epic4_mos / share / epic / help / 6_functions / glob < prev    next >
Encoding:
Text File  |  2002-10-28  |  1.3 KB  |  34 lines
  1. Synopsis:
  2.    $glob(<file glob pattern>)
  3.  
  4. Technical:
  5.    This function is used to find filenames that are matched by specified
  6.    patterns.  This function is controlled by a compile time option, so it
  7.    may not be available on every installation.  Multiple patterns may be
  8.    specified.  Hidden files (dot-files) are not displayed unless a glob
  9.     pattern beginning with a dot is given.
  10.  
  11. Practical:
  12.    This function gives the client the file globbing abilities of modern
  13.    Unix command shells.  It will attempt to find any file or directory
  14.    names matching the given glob pattern.  This is highly useful for
  15.    listing files, or finding files with similar names.
  16.  
  17. Returns:
  18.    list of files matching input glob pattern, nothing if none match
  19.  
  20. Examples:
  21.    $glob(~/*)    returns all non-hidden files in your home directory
  22.    $glob(*)      returns all non-hidden files in your current directory
  23.    $glob(.*)     returns all hidden files in your current directory
  24.    $glob(f*)     returns all non-hidden files that start with "f" in cwd
  25.  
  26. See Also:
  27.    fexist(6); fsize(6)
  28.  
  29. Restrictions:
  30.    This function may not be present in all clients.  A compile-time option
  31.    is available to disable it.  The function is present if the string
  32.    returned by $info(o) has a "g" in it.
  33.  
  34.