mf_chdir.hlp

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

{smcl}
{* 15mar2005}{...}
{cmd:help mata chdir()}
{hline}
{* index chdir()}{...}
{* index _chdir()}{...}
{* index pwd()}{...}
{* index mkdir()}{...}
{* index _mkdir()}{...}
{* index rmdir()}{...}
{* index _rmdir()}{...}
{* index directories}{...}

{title:Title}

{p 4 4 2}
{bf:[M-5] chdir() -- Manipulate directories}


{title:Syntax}

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


{p 8 12 2}
{it:void}{bind:         }
{cmd:chdir(}{it:string scalar dirpath}{cmd:)}

{p 8 12 2}
{it:real scalar}{bind: }
{cmd:_chdir(}{it:string scalar dirpath}{cmd:)}


{p 8 12 2}
{it:void}{bind:         }
{cmd:mkdir(}{it:string scalar dirpath}{cmd:)}

{p 8 12 2}
{it:void}{bind:         }
{cmd:mkdir(}{it:string scalar dirpath}{cmd:,}
{it:real scalar public}{cmd:)}

{p 8 12 2}
{it:real scalar}{bind: }
{cmd:_mkdir(}{it:string scalar dirpath}{cmd:)}

{p 8 12 2}
{it:real scalar}{bind: }
{cmd:_mkdir(}{it:string scalar dirpath}{cmd:,}
{it:real scalar public}{cmd:)}


{p 8 12 2}
{it:void}{bind:         }
{cmd:rmdir(}{it:string scalar dirpath}{cmd:)}

{p 8 12 2}
{it:real scalar}{bind: }
{cmd:_rmdir(}{it:string scalar dirpath}{cmd:)}


{title:Description}

{p 4 4 2}
{cmd:pwd()} returns the full name (path) of the current working directory.


{p 4 4 2}
{cmd:chdir(}{it:dirpath}{cmd:)}
changes the current working directory to {it:dirpath}.  {cmd:chdir()} aborts
with error if the directory does not exist or the operating system cannot
change to it.

{p 4 4 2}
{cmd:_chdir(}{it:dirpath}{cmd:)}
does the same thing, but returns 170 (a return code) when {cmd:chdir()} would
abort.  {cmd:_chdir()} returns 0 if it is successful.


{p 4 4 2}
{cmd:mkdir(}{it:dirpath}{cmd:)} 
and
{cmd:mkdir(}{it:dirpath}{cmd:,} {it:public}{cmd:)}
create directory {it:dirpath}.  {cmd:mkdir()} aborts with error if 
the directory already exists or cannot be created.
If {it:public}!=0 is specified, the directory is given permissions so 
that everyone can read it; otherwise, it is given the usual permissions.

{p 4 4 2}
{cmd:_mkdir(}{it:dirpath}{cmd:)} 
and 
{cmd:_mkdir(}{it:dirpath}{cmd:,} {it:public}{cmd:)}
do the same thing, but return 693 (a return code) when {cmd:mkdir()} would
abort.  {cmd:_mkdir()} returns 0 if it is successful.

{p 4 4 2}
{cmd:rmdir(}{it:dirpath}{cmd:)} 
removes directory {it:dirpath}.  {cmd:rmdir()} aborts with error 
if the directory does not exist, is not empty, or the operating system 
refuses to remove it.

{p 4 4 2}
{cmd:_rmdir(}{it:dirpath}{cmd:)} 
does the same thing, but returns 693 (a return code) when {cmd:rmdir()} would
abort.  {cmd:_rmdir()} returns 0 if it is successful.


{title:Conformability}

    {cmd:pwd()}:
	   {it:result}:  1 {it:x} 1

    {cmd:chdir(}{it:dirpath}{cmd:)}:
	  {it:dirpath}:  1 {it:x} 1
	   {it:result}:  {it:void}

    {cmd:_chdir(}{it:dirpath}{cmd:)}:
	  {it:dirpath}:  1 {it:x} 1
	   {it:result}:  1 {it:x} 1

    {cmd:mkdir(}{it:dirpath}{cmd:,} {it:public}{cmd:)}:
	  {it:dirpath}:  1 {it:x} 1
	   {it:public}:  1 {it:x} 1
	   {it:result}:  {it:void}

    {cmd:_mkdir(}{it:dirpath}{cmd:,} {it:public}{cmd:)}:
	  {it:dirpath}:  1 {it:x} 1
	   {it:public}:  1 {it:x} 1
	   {it:result}:  1 {it:x} 1

    {cmd:rmdir(}{it:dirpath}{cmd:)}:
	  {it:dirpath}:  1 {it:x} 1
	   {it:result}:  {it:void}

    {cmd:_rmdir(}{it:dirpath}{cmd:)}:
	  {it:dirpath}:  1 {it:x} 1
	   {it:result}:  1 {it:x} 1


{title:Diagnostics}

{p 4 4 2}
{cmd:pwd()}
never aborts with error, but it can return {cmd:""} if the operating system
does not know or does not have a name for the current directory (which happens
when another process removes the directory in which you are working).

{p 4 4 2}
{cmd:chdir(}{it:dirpath}{cmd:)} 
aborts with error if the directory does not exist or the operating system
cannot change to it.

{p 4 4 2}
{cmd:_chdir(}{it:dirpath}{cmd:)} never aborts with error; it returns 0 
on success and 170 on failure.

{p 4 4 2}
{cmd:mkdir(}{it:dirpath}{cmd:)} 
and
{cmd:mkdir(}{it:dirpath}{cmd:,} {it:public}{cmd:)}
abort with error if the directory already exists or the operating system
cannot change to it.

{p 4 4 2}
{cmd:_mkdir(}{it:dirpath}{cmd:)} 
and
{cmd:_mkdir(}{it:dirpath}{cmd:,} {it:public}{cmd:)}
never abort with error; they return 0 
on success and 693 on failure.

{p 4 4 2}
{cmd:rmdir(}{it:dirpath}{cmd:)} 
aborts with error if the directory does not exist, is not empty, or the
operating system cannot remove it.

{p 4 4 2}
{cmd:_rmdir(}{it:dirpath}{cmd:)} 
never aborts with error; it returns 0 on success and 639 on failure.


{title:Source code}

{p 4 4 2}
{view chdir.mata, adopath asis:chdir.mata},
{view mkdir.mata, adopath asis:mkdir.mata},
{view rmdir.mata, adopath asis:rmdir.mata};
other functions are built-in.


{title:Also see}

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

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