mf_st_varformat.hlp

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

{smcl}
{* 17mar2005}{...}
{cmd:help mata st_varformat()}
{hline}
{* index st_varformat()}{...}
{* index st_varlabel()}{...}
{* index st_varvaluelabel()}{...}
{* index stata variable labels}{...}
{* index stata value labels}{...}
{* index stata variable formats}{...}

{title:Title}

{p 4 4 2}
{bf:[M-5] st_varformat() -- Obtain/set format, etc., of Stata variable}


{title:Syntax}

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

{p 8 12 2}
{it:void}{bind:         }
{cmd:st_varformat(}{it:scalar var}{cmd:,}
{it:string scalar fmt}{cmd:)}


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

{p 8 12 2}
{it:void}{bind:         }
{cmd:st_varlabel(}{it:scalar var}{cmd:,}
{it:string scalar label}{cmd:)}


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

{p 8 12 2}
{it:void}{bind:         }
{cmd:st_varvaluelabel(}{it:scalar var}{cmd:,}
{it:string scalar labelname}{cmd:)}


{p 4 4 2}
where {it:var} contains a Stata variable name or a Stata variable index.


{title:Description}

{p 4 4 2}
{cmd:st_varformat(}{it:var}{cmd:)}
returns the display format associated with {it:var}, such as 
{cmd:"%9.0gc"}.
{cmd:st_varformat(}{it:var}{cmd:,} {it:fmt}{cmd:)}
changes {it:var}'s display format.

{p 4 4 2}
{cmd:st_varlabel(}{it:var}{cmd:)}
returns the variable label associated with {it:var}, such as 
{cmd:"Sex of Patient"}, or it returns {cmd:""} if {it:var} has no 
variable label.
{cmd:st_varformat(}{it:var}{cmd:,} {it:label}{cmd:)}
changes {it:var}'s variable label.

{p 4 4 2}
{cmd:st_varvaluelabel(}{it:var}{cmd:)}
returns the value-label name associated with {it:var}, such as 
{cmd:"origin"}, or it returns {cmd:""} if {it:var} has no 
value label.
{cmd:st_varvaluelabel(}{it:var}{cmd:,} {it:labelname}{cmd:)}
changes the value-label name associated with {it:var}.



{title:Conformability}

{p 4 4 2}
{cmd:st_varformat(}{it:var}{cmd:)},
{cmd:st_varlabel(}{it:var}{cmd:)},
{cmd:st_varvaluelabel(}{it:var}{cmd:)}:
{p_end}
	      {it:var}:  1 {it:x} 1
	   {it:result}:  1 {it:x} 1


{p 4 4 2}
{cmd:st_varformat(}{it:var}{cmd:,} {it:value}{cmd:)},
{cmd:st_varlabel(}{it:var}{cmd:,} {it:value}{cmd:)},
{cmd:st_varvaluelabel(}{it:var}{cmd:,} {it:value}{cmd:)}:
{p_end}
	      {it:var}:  1 {it:x} 1
	    {it:value}:  1 {it:x} 1
	   {it:result}:  {it:void}


{title:Diagnostics}

{p 4 4 2}
In all functions, if {it:var} is specified as a name, abbreviations are 
not allowed.

{p 4 4 2}
All functions abort with error if {it:var} is not a valid Stata variable.

{p 4 4 2}
{cmd:st_varformat(}{it:var}{cmd:,} {it:fmt}{cmd:)}
aborts with error if {it:fmt} does not contain a valid display format 
for {it:var}.

{p 4 4 2}
{cmd:st_varlabel(}{it:var}{cmd:,} {it:label}{cmd:)}
will truncate {it:label} if it is too long.

{p 4 4 2}
{cmd:st_varvaluelabel(}{it:var}{cmd:,} {it:labelname}{cmd:)}
aborts with error 
if {it:var} is a Stata string variable or if 
{it:labelname} does not contain a valid name (assuming {it:labelname} is 
not "").
It is not required, however, that the label name exist.


{title:Source code}

{p 4 4 2}
Functions are built-in.


{title:Also see}

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

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