findfile.hlp

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

{smcl}
{* 08feb2005}{...}
{cmd:help findfile}
{hline}

{title:Title}

{p2colset 5 21 23 2}{...}
{p2col :{hi:[P] findfile} {hline 2}}Find file in path{p_end}
{p2colreset}{...}


{title:Title}

{p 8 14 2}
{cmd:findfile}
{it:filename}
[{cmd:,}
{cmd:path(}{it:path}{cmd:)}
{cmdab:nodes:cend}
{cmd:all}]

{pstd}
where {it:filename} and {it:path} may optionally be enclosed in quotes, and
the default is to look over the {helpb adopath} if option {cmd:path()} is not
specified.


{title:Description}

{pstd}
{cmd:findfile} looks for a file along a specified path and, if found, displays
the fully qualified name and returns the name in {cmd:r(fn)}.  If the file is
not found, the file-not-found error, r(601), is issued.

{pstd}
Unless told otherwise, {cmd:findfile} looks along the {helpb adopath}, the same
path Stata uses for searching for ado-files, help files, etc.

{pstd}
In programming contexts, {cmd:findfile} is usually used preceded
by {helpb quietly}.

{pstd}
{cmd:findfile} is not a utility to search everywhere for a file you have lost.
{cmd:findfile} is for use in those rare ado-files that use prerecorded
datasets and for which you wish to place the datasets along the adopath,
along with the ado-file itself.


{title:Options}

{phang}
{cmd:path(}{it:path}{cmd:)} specifies the path over which {cmd:findfile} is to
    search.  Not specifying this option is equivalent to specifying
    {cmd:path(`"`c(adopath)'"')}.

{pmore}
    If specified, {it:path} should be a list of directory (folder) names
    separated by semicolons; for example,

	    {cmd:path(`".;~/bin;"~/data/my data";~"')}
	    {cmd:path(`".;\bin;"\data\my data";~"')}

{pmore}
    The individual directory names may be enclosed in quotes, but, if any are,
    remember to enclose the entire path argument in compound quotes.

{pmore}
    In addition, any of the directory names may be specified as {cmd:STATA},
    {cmd:UPDATES}, {cmd:BASE}, {cmd:SITE}, {cmd:PLUS}, {cmd:PERSONAL}, or
    {cmd:OLDPLACE}, which are indirect references to directories recorded by
    {helpb sysdir}:

	    {cmd:path(UPDATES;BASE;SITE;.;PERSONAL;PLUS)}
	    {cmd:path(\bin:SITE;.;PERSONAL;PLUS)}
	    {cmd:path(`"\bin;.;"\data\my data";PERSONAL;PLUS"')}
	    {cmd:path(`".;`c(adopath)'"')}

{phang}
{cmd:nodescend} specifies that {cmd:findfile} not follow Stata's
    normal practice of searching in letter subdirectories of directories in
    the path, as well as the directories themselves.  {cmd:nodescend} is rarely
    specified, and, if it is specified, {cmd:path()} would usually be
    specified, too.

{phang}
{cmd:all} specifies that all files along the path with the specified name are
    to be found and then listed and saved in {cmd:r(fn)}.  When {cmd:all} is not
    specified, the default is to stop the search when the first instance of
    the specified name is found.

{pmore}
    When {cmd:all} is specified, the fully qualified names of the files
    found are returned in {cmd:r(fn)}, listed one after the other, and
    each enclosed in quotes.  Thus when {cmd:all} is specified, if you
    subsequently need to quote the returned list, you must use compound double
    quotes.  In addition, remember that {cmd:findfile} issues a file-not-found
    error if no files are found.  If you wish to suppress that and want
    {cmd:r(fn)} returned containing nothing, precede {cmd:findfile} with
    {helpb capture}.  Thus typical usage of {cmd:findfile, all} is

	    {cmd:capture findfile} {it:filename}{cmd:, all}
	    {cmd:local filelist `"`r(fn)'"'}


{title:Also see}

{psee}
Manual:  {bf:[P] findfile}

{psee}
Online:  {helpb adopath}, {helpb sysuse}; {helpb _getfilename}
{p_end}