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 / which < prev    next >
Encoding:
Text File  |  2002-10-28  |  917 b   |  26 lines
  1. Synopsis:
  2.    $which(<file> [<dir>[:<dir> ...]])
  3.  
  4. Technical:
  5.    This function returns the full pathname of the specified filename.  The
  6.    function will search the client's current LOAD_PATH for the file.  In
  7.    addition, a list of colon-delimited directories may be specified, which
  8.    will be searched if the file is not found in the LOAD_PATH.
  9.  
  10. Practical:
  11.    This function tries to find the location of a particular file.  This
  12.    makes it suitable for LOAD and STUB commands, allowing a file to be
  13.    loaded, even if its exact location is not known.
  14.  
  15. Returns:
  16.    the canonical path of the file, or nothing if it isn't found
  17.  
  18. Examples:
  19.    $which(some_file)           shows full path of file
  20.    $which(does_not_exist)      returns nothing, file dies not exist
  21.    $which(some_file /bin)      search in /bin for some_file too
  22.  
  23. See Also:
  24.    load(5); set(4) load_path; stub(5); which(4)
  25.  
  26.