mf_findfile.hlp

是一个经济学管理应用软件 很难找的 但是经济学学生又必须用到

{smcl}
{* 21mar2005}{...}
{cmd:help mata findfile()}
{hline}
{* index findfile()}{...}
{* index file processing}{...}

{title:Title}

{p 4 4 2}
{bf:[M-5] findfile() -- Find file}


{title:Syntax}

{p 8 12 2}
{it:string scalar}
{cmd:findfile(}{it:string scalar fn}{cmd:,}
{it:string scalar} {it:dirlist}{cmd:)}

{p 8 12 2}
{it:string scalar}
{cmd:findfile(}{it:string scalar fn}{cmd:)}


{title:Description}

{p 4 4 2}
{cmd:findfile(}{it:fn}{cmd:,} {it:dirlist}{cmd:)}
looks for file {it:fn} along the semicolon-separated list of directories 
{it:dirlist} and returns the fully qualified path-and-filename if 
{it:fn} is found}.  {cmd:findfile()} returns "" if the file is not found.

{p 4 4 2}
{cmd:findfile(}{it:fn}{cmd:)} 
is equivalent to {cmd:findfile(}{it:fn}{cmd:, c("adopath"))}.
{cmd:findfile()} with one argument looks along the official Stata 
ado-path for file {it:fn}.


{title:Remarks}

{p 4 4 2}
For instance, 

	{cmd:findfile("kappa.ado")}

{p 4 4 2}
might return "{cmd:C:\Program Files\Stata9\ado\updates\k\kappa.ado}".


{title:Conformability}

    {cmd:findfile(}{it:fn}{cmd:,} {it:dirlist}{cmd:)}:
	      {it:fn}:  1 {it:x} 1
	 {it:dirlist}:  1 {it:x} 1  (optional)
	   {it:result}: 1 {it:x} 1


{title:Diagnostics}

{p 4 4 2}
{cmd:findfile(}{it:fn}{cmd:,} {it:dirlist}{cmd:)}
and 
{cmd:findfile(}{it:fn}{cmd:)} 
return "" if the file is not found.
If the file is found, the returned fully qualified path-and-filename is 
guaranteed to exist and be readable at the instant {cmd:findfile()} 
concluded.


{title:Source code}

{p 4 4 2}
{view findfile.mata, adopath asis:findfile.mata}


{title:Also see}

{p 4 13 2}
Manual:  {hi:[M-5] findfile()}

{p 4 13 2}
Online:  help for 
{bf:{help m4_io:[M-4] io}}
{p_end}