_get_gropts.hlp

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

{smcl}
{* 10mar2005}{...}
{cmd:help _get_gropts}{right:also see:  {help undocumented}}
{hline}

{title:Title}

{p 4 21 2}
{cmd:_get_gropts} {hline 2} Parsing tool for graph commands


{title:Syntax}

{p 8 22 2}
{cmd:_get_gropts}
	{cmd:,}
	{cmd:graphopts(}{it:options}{cmd:)}
	[
	{cmd:grbyable}
	{cmd:nobycheck}
	{cmdab:total:allowed}
	{cmdab:missing:allowed}
	{cmd:getbyallowed(}{it:namelist}{cmd:)}
	{cmd:getcombine}
	{cmd:gettwoway}
	{cmd:getallowed(}{it:namelist}{cmd:)}
	]


{title:Description}

{pstd}
{cmd:_get_gropts} is a parsing tool that was written to assist in syntax
checking and parsing of commands that generate graphs.


{title:Options}

{phang}
{cmd:graphopts(}{it:options}{cmd:)} contains the options to be parsed.

{phang}
{cmd:grbyable} indicates that the {cmd:by()} option is allowed, see
{help by_option}.  By default, {cmd:by()} is not allowed.

{phang2}
{cmd:totalallowed} indicates that the {cmd:total} option is allowed as an option
within the {cmd:by()} option.  By default, {cmd:by(,total)} is not allowed.

{phang2}
{cmd:missingallowed} indicates that the {cmd:missing} option is allowed as an option
within the {cmd:by()} option.  By default, {cmd:by(,missing)} is not allowed.

{phang}
{cmd:getbyallowed(}{it:namelist}{cmd:)} allows for the extraction of specific
options that take arguments from the {cmd:by()} option.  For each {it:name} in
{it:namelist}, the option {it:name}{cmd:()} is placed in
{cmd:s(by_}{it:name}{cmd:)} like a {cmd:passthru}.  By default, all
unrecognized options are returned in {cmd:s(byopts)}.
Option abbreviations are  allowed in {it:namelist}, all letters in
{it:name} are converted to lowercase for {cmd:s(by_}{it:name}{cmd:)}.

{pmore}
This option requires the {cmd:grbyable} option.
{* this restriction allows for easy grepping of graph producing commands}

{phang}
{cmd:nobycheck} prevents {cmd:_get_gropts} from checking if options are
provided to the {cmd:by()} option, but not a {it:varlist}.  By default, the
{cmd:by()} option requires a {it:varlist}.

{phang}
{cmd:getcombine} checks for the unique options allowed by {cmd:graph combine}.
For a complete list of these options see {helpb graph combine}, also see
{help repeated_options}.  All options that take arguments are returned as
{cmd:passthru}'s according to the {cmd:syntax} documentation.  This option may
not be combined with {cmd:gettwoway}.

{phang}
{cmd:gettwoway} checks for the unique options allowed by {cmd:graph twoway}.
For a complete list of these options see {help twoway_options}, also see
{help repeated_options}.  All options that take arguments are returned as
{cmd:passthru}'s according to the {cmd:syntax} documentation.  This option may
not be combined with {cmd:getcombine}.

{phang}
{cmd:getallowed(}{it:namelist}{cmd:)} allows for the extraction of specific
options that take arguments.  For each {it:name} in {it:namelist}, the
arguments in {it:name}{cmd:()} are placed in {cmd:s(}{it:name}{cmd:)}.  By
default, all unrecognized options are returned in {cmd:s(graphopts)}.
Option abbreviations are  allowed in {it:namelist}, all letters in
{it:name} are converted to lowercase for {cmd:s(}{it:name}{cmd:)}.


{title:Some official Stata commands that use {cmd:_get_gropts}}

{pstd}
The following commands use {cmd:_get_gropts}.  See help for

{pin}
	{helpb ac},
	{helpb avplot},
	{helpb fracplot},
	{helpb greigen},
	{helpb grmeanby},
	{helpb kdensity},
	{helpb lowess},
	{helpb lroc},
	{helpb lsens},
	{helpb pac},
	{helpb pnorm},
	{helpb qnorm},
	{helpb qqplot},
	{helpb quantile},
	{helpb xchart},
	{helpb xcorr}


{title:Saved results}

{pstd}
{cmd:_get_gropts} saves in {cmd:s()}:

{pstd}
Macros:

	{cmd:s(varlist)}     varlist from {cmd:by()}
	{cmd:s(total)}       {cmd:total} option from {cmd:by()}
	{cmd:s(missing)}     {cmd:missing} option from {cmd:by()}
	{cmd:s(by_}{it:name}{cmd:)}     the {it:name}{cmd:()} option from {cmd:by()}
	{cmd:s(byopts)}      rest of the options from {cmd:by()}
	{cmd:s(combineopts)} the {cmd:getcombine} options
	{cmd:s(twowayopts)}  the {cmd:gettwoway} options
	{cmd:s(}{it:name}{cmd:)}        arguments in {it:name}{cmd:()} from {cmd:graphopts()}
	{cmd:s(graphopts)}   rest of the options from {cmd:graphopts()}


{title:Examples}

{phang}
{cmd}. _get_gropts , graphopts(by(for, total) name(gr1) saving(gr1, replace)
replace ciopts(m(o)) plot(function y = sin(3*c(pi)*x))) grbyable total
getallowed(ciopts plot){text}

{phang}
{cmd}. sreturn list{text}

    macros:
	 s(graphopts) : "{res}name(gr1) saving(gr1, replace) replace{txt}"
	   s(varlist) : "{res}foreign{txt}"
	     s(total) : "{res}total{txt}"
	      s(plot) : "{res}function y = sin(3*c(pi)*x){txt}"
	    s(ciopts) : "{res}m(o){txt}"

{phang}
{cmd}. _get_gropts , graphopts(by(for, total ti("Title") legend(draw)) name(gr1) saving(gr1, replace) ciopts(m(o)) plot(function y = sin(3*c(pi)*X))) grbyable total getbyallowed(TItle) getcombine getallowed(ciopts plot)

{phang}
{cmd}. sreturn list{text}

    {txt}macros:
	   s(varlist) : "{res}foreign{txt}"
	     s(total) : "{res}total{txt}"
	  s(by_title) : "{res}title("Title"){txt}"
	    s(byopts) : "{res}legend(draw){txt}"
       s(combineopts) : "{res}name(gr1) saving(gr1, replace){txt}"
	      s(plot) : "{res}function y = sin(3*c(pi)*x){txt}"
	    s(ciopts) : "{res}m(o){txt}"


{title:Also see}

{psee}
Online:  {helpb graph},
{helpb macro},
{helpb syntax},
{helpb _check4gropts}
{p_end}