list.hlp

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

{smcl}
{* 24feb2005}{...}
{cmd:help list}, {cmd:help flist} {right:dialog:  {bf:{dialog list}}}
{hline}

{title:Title}

{p2colset 5 17 19 2}{...}
{p2col :{hi:[D] list} {hline 2}}List values of variables{p_end}
{p2colreset}{...}


{title:Syntax}

{p 8 14 2}
{opt l:ist} [{it:{help varlist}}] {ifin} [{cmd:,} {it:options}]

{p 8 14 2}
{opt fl:ist} is equivalent to {cmd:list} with the {opt fast} option.

{synoptset 21 tabbed}{...}
{synopthdr}
{synoptline}
{syntab :Main}
{synopt :{opt c:ompress}}compress width of columns in both table and display
formats{p_end}
{synopt :{opt noc:ompress}}use display format of each variable{p_end}
{synopt :{opt fast}}synonym for {opt noncompress}; no delay in output of large
datasets{p_end}
{synopt :{opt ab:breviate(#)}}abbreviate variable names to {it:#} characters;
default is {cmd:ab(8)}{p_end}
{synopt :{opt str:ing(#)}}truncate string variables to {it:#} characters;
default is {cmd:string(10)}{p_end}
{synopt :{opt noo:bs}}do not list observation numbers{p_end}

{syntab :Options}
{synopt :{opt t:able}}force table format{p_end}
{synopt :{opt d:isplay}}force display format{p_end}
{synopt :{opt h:eader}}display variable header once; default is table
mode{p_end}
{synopt :{opt noh:eader}}suppress variable header{p_end}
{synopt :{opt h:eader(#)}}display variable header every {it:#} lines{p_end}
{synopt :{opt clean}}force table format with no divider or separator
lines{p_end}
{synopt :{opt div:ider}}draw divider lines between columns{p_end}
{synopt :{opt sep:arator(#)}}draw a separator line every {it:#} lines; default is 
{cmd:separator(5)}{p_end}
{synopt :{opth sepby(varlist)}}draw a separator line whenever {it:varlist} values 
change{p_end}
{synopt :{opt nol:abel}}display numeric codes rather than label values{p_end}

{syntab :Summary}
{synopt :{opt mean}[{cmd:(}{it:{help varlist}}{cmd:)}]}add line reporting the 
mean for the (specified) variables{p_end}
{synopt :{opt sum}[{cmd:(}{it:{help varlist}}{cmd:)}]}add line reporting the sum 
for the (specified) variables{p_end}
{synopt :{opt N}[{cmd:(}{it:{help varlist}}{cmd:)}]}add line reporting the 
number of nonmissing values for the (specified) variables{p_end}
{synopt :{opth labv:ar(varname)}}substitute {opt Mean}, {opt Sum}, or 
{opt N} for value of {it:varname} in last row of table{p_end}

{syntab :Advanced}
{synopt :{opt con:stant}[{cmd:(}{it:{help varlist}}{cmd:)}]}separate and list
variables that are only once{p_end}
{synopt :{opt notr:im}}suppress string trimming{p_end}
{synopt :{opt abs:olute}}display overall observation numbers when using by
{it:varlist}:{p_end}
{synopt :{opt nodotz}}display numerical values equal to {cmd:.z} as field of
blanks{p_end}
{synopt :{opt subvar:name}}substitute characteristic for variable name in
header{p_end}
{synopt :{opt line:size(#)}}columns per line; default is
{cmd:linesize(79)}{p_end}
{synoptline}
{p2colreset}{...}
{p 4 6 2}{varlist} may contain time-series operators; see {help tsvarlist}.{p_end}
{p 4 6 2}{opt by} may be used with {cmd:list}; see {help by}.


{title:Description}

{pstd}
{cmd:list} displays the values of variables.  If no {varlist} is specified,
the values of all the variables are displayed.  Also see {helpb browse}.


{title:Options}

{dlgtab:Main}

{phang}
{opt compress} and {opt nocompress} change the width of the columns in both
table and display formats.  By default, {cmd:list} examines the data and
allocates the needed width to each variable.  For instance, a variable might
be a string with a %18s format, and yet the longest string will be only 12
characters long.  Or, a numeric variable might have a %9.0g format, and yet,
given the values actually present, the widest number needs only four columns.

{pmore}
{opt nocompress} prevents {cmd:list} from examining the data.  Widths will be
set according to the {help format:display format} of each variable.  Output
generally looks better when {opt nocompress} is not specified, but for very
large datasets (say 1,000,000 observations or more), {opt nocompress} can
speed up the execution of {cmd:list}.

{pmore}
{opt compress} allows {cmd:list} to engage in a little more compression than
it otherwise would by telling {cmd:list} to abbreviate variable names to fewer
than 8 characters.

{phang}
{opt fast} is a synonym for {opt nocompress}.  {opt fast} may be of interest
to those with very large datasets who wish to see output appear without delay.

{phang}
{opt abbreviate(#)} is an alternative to {opt compress} that allows you to
specify the minimum abbreviation of variable names to be considered.
For example, you could specify {cmd:abbreviate(16)}  if you never wanted
variables abbreviated to less than 16 characters.

{phang}
{opt string(#)} specifies that when string variables are listed, they be
truncated to {it:#} characters in the output.  Any value that is truncated
will be appended with "{cmd:..}" to indicate the truncation.  {opt string()}
is useful for displaying just a part of long strings. 

{phang}
{opt noobs} suppresses the listing of the observation numbers.

{dlgtab:Options}

{phang}
{opt table} and {opt display} determines the style of output.  By default,
{cmd:list} determines whether to use {opt table} or {opt display} based on
the width of your screen and the {opt linesize()} option, if you specify it.

{pmore}
{opt table} forces table format.  Forcing table format when {cmd:list} would
have chosen otherwise generally produces impossible-to-read output because of
the linewraps.  However, if you are {help log:logging output} in SMCL format
and plan to print the output on wide paper later, specifying {opt table} can
be a reasonable thing to do.

{pmore}
{opt display} forces display format.

{phang}
{opt header}, {opt noheader}, and {opt header(#)} specify how the variable
header is to be displayed.

{pmore}
{opt header} is the default in table mode and displays the variable header
once, at the top of the table.  

{pmore}
{opt noheader} suppresses the header altogether.

{pmore}
{opt header(#)} redisplays the variable header every {it:#} observations.  For
example, {cmd:header(10)} would display a new header every 10 observations.

{pmore}
The default in display mode is to display the variable names interweaved with
the data:

	     {txt}{c TLC}{hline 13}{c TT}{hline 7}{c TT}{hline 5}{c TT}{hline 8}{c TT}{hline 11}{c TT}{hline 8}{c TRC}
	  1. {c |} make        {c |} price {c |} mpg {c |} rep78  {c |} headroom  {c |} trunk  {c |}
	     {c |} {res}AMC Concord {txt}{c |} {res}4,099 {txt}{c |} {res} 22 {txt}{c |} {res}    3  {txt}{c |} {res}     2.5  {txt}{c |} {res}   11  {txt}{c |}
	     {c LT}{hline 8}{c TT}{hline 4}{c BT}{hline 3}{c TT}{hline 3}{c BT}{hline 2}{c TT}{hline 2}{c BT}{hline 7}{c TT}{c BT}{hline 9}{c TT}{hline 1}{c BT}{hline 8}{c RT}
	     {c |} weight {c |} length {c |} turn {c |} displa~t {c |} gear_r~o {c |}  foreign {c |}
	     {c |} {res} 2,930 {txt}{c |} {res}   186 {txt}{c |} {res}  40 {txt}{c |} {res}     121 {txt}{c |} {res}    3.58 {txt}{c |} {res}Domestic {txt}{c |}
	     {c BLC}{hline 8}{c BT}{hline 8}{c BT}{hline 6}{c BT}{hline 10}{c BT}{hline 10}{c BT}{hline 10}{c BRC}

{pmore}
However, if you specify {opt header}, the header is display once, at the top
of the table:

	     {txt}{c TLC}{hline 13}{c TT}{hline 7}{c TT}{hline 5}{c TT}{hline 8}{c TT}{hline 11}{c TT}{hline 8}{c TRC}
	     {c |} make        {c |} price {c |} mpg {c |} rep78  {c |} headroom  {c |} trunk  {c |}
	     {c LT}{hline 8}{c TT}{hline 4}{c BT}{hline 3}{c TT}{hline 3}{c BT}{hline 2}{c TT}{hline 2}{c BT}{hline 7}{c TT}{c BT}{hline 9}{c TT}{hline 1}{c BT}{hline 8}{c RT}
	     {c |} weight {c |} length {c |} turn {c |} displa~t {c |} gear_r~o {c |}  foreign {c |}
	     {c BLC}{hline 8}{c BT}{hline 8}{c BT}{hline 6}{c BT}{hline 10}{c BT}{hline 10}{c BT}{hline 10}{c BRC}

	     {c TLC}{hline 13}{c TT}{hline 7}{c TT}{hline 5}{c TT}{hline 8}{c TT}{hline 11}{c TT}{hline 8}{c TRC}
	  1. {c |} {res}AMC Concord {txt}{c |} {res}4,099 {txt}{c |} {res} 22 {txt}{c |} {res}    3  {txt}{c |} {res}     2.5  {txt}{c |} {res}   11  {txt}{c |}
	     {c LT}{hline 8}{c TT}{hline 4}{c BT}{hline 3}{c TT}{hline 3}{c BT}{hline 2}{c TT}{hline 2}{c BT}{hline 7}{c TT}{c BT}{hline 9}{c TT}{hline 1}{c BT}{hline 8}{c RT}
	     {c |} {res} 2,930 {txt}{c |} {res}   186 {txt}{c |} {res}  40 {txt}{c |} {res}     121 {txt}{c |} {res}    3.58 {txt}{c |} {res}Domestic {txt}{c |}
	     {c BLC}{hline 8}{c BT}{hline 8}{c BT}{hline 6}{c BT}{hline 10}{c BT}{hline 10}{c BT}{hline 10}{c BRC}

{phang}
{opt clean} is a better alternative to {opt table} when you want to force
table format and your goal is to produce more readable output on the screen.
{opt clean} implies {opt table}, and it removes all dividing and separating
lines, which is what makes wrapped table output nearly impossible to read.

{phang}
{opt divider}, {opt separator(#)}, and {opth sepby(varlist)} specify
how dividers and separator lines should be displayed.  These three options
affect only table format.

{pmore}
{opt divider} specifies that divider lines be drawn between columns.  The
default is {opt nodivider}.

{pmore}
{opt separator(#)} and {opth sepby(varlist)} indicate when separator lines
should be drawn between rows.

{pmore}
{opt separator(#)} specifies how often separator lines should be drawn between
rows.  The default is {cmd:separator(5)}, meaning every 5 observations.  You
may specify {cmd:separator(0)} to suppress separators altogether.

{pmore}
{opth sepby(varlist)} specifies that a separator line be drawn whenever any of
the variables in {opt sepby(varlist)} change their values; up to ten variables
may be specified.  You need not make sure the data were sorted on 
{opt sepby(varlist)} before issuing the {cmd:list} command.  The variables in 
{opt sepby(varlist)} also need not be among the variables being listed.

{phang}
{opt nolabel} specifies that the numeric codes be displayed rather than label
values.

{dlgtab:Summary}

{phang}
{opt mean}, {opt sum}, {opt N}, {opth mean(varlist)}, {opth sum(varlist)}, and
{opth N(varlist)} all specify that lines be added to the output reporting the
mean, sum, or number of nonmissing values for the (specified) variables.  If