{smcl}
{hline}
help for {cmd:lablist}{right:(Roger Newson)}
{hline}

{title:List value labels (if present) for one or more variables}

{p 8 21 2}
{cmd:lablist} [ {varlist} ] [ , {cmdab:var:label} ]


{title:Description}

{pstd}
{cmd:lablist} produces a list of the values and value labels
used by the {help label:value label sets} belonging to each of a list of variables,
if such {help label:value label sets} are defined.
If no {varlist} is specified,
then {cmd:lablist} uses the full list of variables in the dataset currently in the memory.
{cmd:lablist} is therefore similar to {helpb label:label list},
but it requires the user to specify only the variable name(s) in the {varlist},
instead of specifying the {help label:value label set(s)}
belonging to the variable(s).
It is often used with {helpb tabulate}, or with the {help ssc:SSC} package {helpb xcontract}.


{title:Options}

{p 4 8 2}
{cmd:varlabel} specifies that {help label:variable labels} will be printed (if present),
in addition to any value labels.


{title:Examples}

{p 8 12 2}{cmd:. lablist}{p_end}

{p 8 12 2}{cmd:. lablist mpg}{p_end}

{p 8 12 2}{cmd:. tab foreign}{p_end}
{p 8 12 2}{cmd:. lablist foreign}{p_end}

{p 8 12 2}{cmd:. lablist, varlabel}{p_end}

{p 8 12 2}{cmd:. lablist foreign, var}{p_end}


{title:Author}

{pstd}
Roger Newson, National Heart and Lung Institute, Imperial College London, UK.{break}
Email: {browse "mailto:r.newson@imperial.ac.uk":r.newson@imperial.ac.uk}


{title:Also see}

{p 4 13 2}
{bind: }Manual: {hi:[D] label}, {hi:[D] tabulate oneway}, {hi:[D] tabulate twoway}
{p_end}
{p 4 13 2}
On-line: help for {helpb label}, {helpb tabulate}, {helpb tabulate oneway}, {helpb tabulate twoway},{break}
         help for {helpb xcontract} if installed
{p_end}