mf_pathjoin.hlp

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

{smcl}
{* *! version 1.0.0  15jun2005}{...}
{cmd:help mata pathjoin()}
{hline}
{* index filename manipulation}{...}
{* index pathjoin()}{...}
{* index pathsplit()}{...}
{* index pathbasename()}{...}
{* index pathsuffix()}{...}
{* index pathrmsuffix()}{...}
{* index pathisurl()}{...}
{* index pathisabs()}{...}
{* index pathasciisuffix()}{...}
{* index pathstatasuffix()}{...}
{* index pathlist()}{...}
{* index pathsubsysdir()}{...}

{title:Title}

{p 4 4 2}
{bf:[M-5] pathjoin() -- File path manipulation}


{title:Syntax}

{p 8 12 2}
{it:string scalar}{bind:   }
{cmd:pathjoin(}{it:string scalar path1}{cmd:,}
{it:string scalar path2}{cmd:)}

{p 8 12 2}
{it:string scalar}{bind:   }
{cmd:pathsplit(}{it:string scalar path}{cmd:,}
{it:path1}{cmd:,}
{it:path2}{cmd:)}


{p 8 12 2}
{it:string scalar}{bind:   }
{cmd:pathbasename(}{it:string scalar path}{cmd:)}


{p 8 12 2}
{it:string scalar}{bind:   }
{cmd:pathsuffix(}{it:string scalar path}{cmd:)}

{p 8 12 2}
{it:string scalar}{bind:   }
{cmd:pathrmsuffix(}{it:string scalar path}{cmd:)}


{p 8 12 2}
{it:real scalar}{bind:     }
{cmd:pathisurl(}{it:string scalar path}{cmd:)}

{p 8 12 2}
{it:real scalar}{bind:     }
{cmd:pathisabs(}{it:string scalar path}{cmd:)}

{p 8 12 2}
{it:real scalar}{bind:     }
{cmd:pathasciisuffix(}{it:string scalar path}{cmd:)}

{p 8 12 2}
{it:real scalar}{bind:     }
{cmd:pathstatasuffix(}{it:string scalar path}{cmd:)}


{p 8 12 2}
{it:string rowvector}
{cmd:pathlist(}{it:string scalar dirlist}{cmd:)}

{p 8 12 2}
{it:string rowvector}
{cmd:pathlist()}

{p 8 12 2}
{it:string rowvector}
{cmd:pathsubsysdir(}{it:string rowvector pathlist}{cmd:)}


{title:Description}

{p 4 4 2}
{cmd:pathjoin(}{it:path1}{cmd:,} {it:path2}{cmd:)}
forms, logically speaking, {it:path1}{cmd:/}{it:path2}, but does so in the
appropriate style.  For instance, {it:path1} might be a URL and 
{it:path2} a Windows {it:dirname}{cmd:\}{it:filename}, and the two paths 
will, even so, be joined correctly.  All issues of whether {it:path1} 
ends with a directory separator, {it:path2} begins with one, etc., 
are handled automatically.

{p 4 4 2}
{cmd:pathsplit(}{it:path}{cmd:,} {it:path1}{cmd:,} {it:path2}{cmd:)}
performs the inverse operation, removing the last element of the path 
(which is typically a filename) and storing it in {it:path2} and storing the 
rest in {it:path1}.

{p 4 4 2}
{cmd:pathbasename(}{it:path}{cmd:)}
returns the last element of {it:path}.

{p 4 4 2}
{cmd:pathsuffix(}{it:path}{cmd:)}
returns the file suffix, with leading dot, if there is one, and returns ""
otherwise.  For instance, {cmd:pathsuffix("this\that.ado")} returns
"{cmd:.ado}".

{p 4 4 2}
{cmd:pathrmsuffix(}{it:path}{cmd:)}
returns {it:path} with the suffix removed, if there was one.
For instance, 
{cmd:pathrmsuffix("this\that.ado")} returns "{cmd:this\that}".

{p 4 4 2}
{cmd:pathisurl(}{it:path}{cmd:)}
returns 1 if {it:path} is a URL and 0 otherwise.

{p 4 4 2}
{cmd:pathisabs(}{it:path}{cmd:)}
returns 1 if {it:path} is absolute and 0 if relative.  
{cmd:c:\this} is an absolute path.  {cmd:this\that} is a relative path.
URLs are considered to be absolute.

{p 4 4 2}
{cmd:pathasciisuffix(}{it:path}{cmd:)}
and 
{cmd:pathstatasuffix(}{it:path}{cmd:)}
are more for StataCorp use than anything else.
{cmd:pathasciisuffix()} returns 1 if the file is known to be ASCII, 
based on its file suffix.  StataCorp uses this function in Stata's
{cmd:net} command to decide whether end-of-line characters, which 
differ across operating systems, should be modified during downloads.
{cmd:pathstatasuffix()} is the function used by Stata's {cmd:net} and
{cmd:update} commands to decide whether a file belongs in the official 
directories.  {cmd:pathstatasuffix("example.ado")} is true, but 
{cmd:pathstatasuffix("example.do")} is false because 
do-files do not go in system directories.

{p 4 4 2}
{cmd:pathlist(}{it:dirlist}{cmd:)} returns a row vector, 
each element of which contains an element of a semicolon-separated
path list {it:dirlist}.  
For instance, 
{cmd:pathlist("}{it:a}{cmd:;}{it:b}{cmd:;}{it:c}{cmd:")} returns
{cmd:("}{it:a}{cmd:", "}{it:b}{cmd:", "}{it:c}{cmd:")}.

{p 4 4 2}
{cmd:pathlist()} without arguments returns {cmd:pathlist(c("adopath"))},
the broken-out elements of the official Stata ado-path.

{p 4 4 2}
{cmd:pathsubsysdir(}{it:pathlist}{cmd:)} returns {it:pathlist} 
with any elements which are Stata system directories shorthands, such as 
"{cmd:UPDATES}", "{cmd:PLUS}", "{cmd:PERSONAL}", etc., substituted 
with the actual directory names.  For instance, the right way to 
obtain the official directories over which Stata searches for files 
is {cmd:pathsubsysdir(pathlist())}.


{title:Remarks}

{p 4 4 2}
Use these functions and you are more likely to produce code that works 
correctly regardless of operating system.


{title:Conformability}

    {cmd:pathjoin(}{it:path1}{cmd:,} {it:path2}{cmd:)}
	    {it:path1}:  1 {it:x} 1
	    {it:path2}:  1 {it:x} 1
	   {it:result}:  1 {it:x} 1

    {cmd:pathsplit(}{it:path}{cmd:,} {it:path1}{cmd:,} {it:path2}{cmd:)}:
	{it:input:}
	     {it:path}:  1 {it:x} 1
	{it:output:}
	    {it:path1}:  1 {it:x} 1
	    {it:path2}:  1 {it:x} 1

{p 4 4 2}
    {cmd:pathbasename(}{it:path}{cmd:)},
    {cmd:pathsuffix(}{it:path}{cmd:)},
    {cmd:pathrmsuffix(}{it:path}{cmd:)}:
{p_end}
	     {it:path}:  1 {it:x} 1
	   {it:result}:  1 {it:x} 1

{p 4 4 2}
{cmd:pathisurl(}{it:path}{cmd:)},
{cmd:pathisabs(}{it:path}{cmd:)},
{cmd:pathasciisuffix(}{it:path}{cmd:)},
{cmd:pathstatasuffix(}{it:path}{cmd:)}:
{p_end}
	     {it:path}:  1 {it:x} 1
	   {it:result}:  1 {it:x} 1

    {cmd:pathlist(}{it:string scalar dirlist}{cmd:)}:
	  {it:dirlist}:  1 {it:x 1}
	   {it:result}:  1 {it:x k}

    {cmd:pathsubsysdir(}{it:string scalar pathlist}{cmd:)}:
	 {it:pathlist}:  1 {it:x k}
	   {it:result}:  1 {it:x k}


{title:Diagnostics}

{p 4 4 2}
All routines abort with error if the path is too long for the operating 
system; nothing else causes abort with error.


{title:Source code}

{p 4 4 2}
{view pathsplit.mata, adopath asis:pathsplit.mata},
{view pathlist.mata, adopath asis:pathlist.mata},
{view pathsubsysdir.mata, adopath asis:pathsubsysdir.mata};
other functions are built-in.


{title:Also see}

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

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