$FUNCNAME$
  FILE()
$CATEGORY$
  FILE/IO,DATABASE
$SUMMARY$
   Determine if files exist in the xClipper default directory or path
$LANG_RU$
   ,      xClipper   
$SYNTAX$
     FILE(<cFilespec>) --> lExists
$LANG_RU$
     FILE(< >) -->  
$ARGUMENTS$
     <cFilespec> is in the current xClipper default directory and path.
     It is a standard file specification that can include the wildcard
     characters * and ? as well as a drive and path reference.  Explicit
     references to a file must also include an extension.
$LANG_RU$
     < >    , 
              .
            *  ?, 
         .       
       .
$RETURNS$
     FILE() returns true (.T.) if there is a match for any file matching the
     <cFilespec> pattern; otherwise, it returns false (.F.).
$LANG_RU$
     FILE()   ""(..),     
     ,     ;   
       ""(.F.).
$DESCRIPTION$
     FILE() is an environment function that determines whether any file
     matching a file specification pattern is found.  FILE() searches the
     specified directory if a path is explicitly specified.

     If a path is not specified,  FILE() searches the current xClipper
     default directory and then the xClipper path.  In no case is the DOS
     path searched.  Note also that FILE() does not recognize hidden or
     system files in its search.
$LANG_RU$
     FILE()       ,
       - ,    
     .         
            .  
      ,  FILE()   ,  
     xClipper  ,     xClipper . 
     ,   DOS,       .
       ,  FILE()     
        .
$EXAMPLES$
       In this example FILE() attempts to find Sales.dbf in other
	than the current xClipper default:

	? FILE("Sales.dbf")               // Result: .F.
	? FILE("\APPS\DBF\Sales.dbf")     // Result: .T.
	//
	SET PATH TO \APPS\DBF
	? FILE("Sales.dbf")               // Result: .T.
	//
	SET PATH TO
	SET DEFAULT TO \APPS\DBF\
	? FILE("Sales.dbf")               // Result: .T.
	? FILE("*.dbf")                   // Result: .T.
$LANG_RU$
         ,  FILE()   Sales.dbf 
       ,      :

       ? FILE("Sales.dbf")                   // : .F.
       ? FILE("\APPS\DBF\Sales.dbf")         // : .T.
       //
       SET PATH TO \APPS\DBF
       ? FILE("Sales.dbf")                   // : .T.
       //
       SET PATH TO
       SET DEFAULT TO \APPS\DBF\
       ? FILE("Sales.dbf")                   // : .T.
       ? FILE("*.dbf")                       // : .T.
$SEEALSO$

$END$
