= Stata Label =

'''`-label-`''' manipulates [[Stata/Metadata|metadata]].

<<TableOfContents>>

----



== Usage ==

To assign a label to a dataset, try:

{{{
label data "Raw dataset"
}}}

To assign a label to a variable, try:

{{{
label variable foo "foo: A variable"
}}}

Value labels are not stored in the dataset itself. To create a new value label and then attach it to a variable, try:

{{{
label define yesno 1 "Yes" 0 "No"
label copy yesno yesno2
label values foo yesno
}}}

To query these value labels, try:

{{{
label dir
label list yesno yesno2
}}}

By default, value labels cannot be overwritten. The '''`add`''' option allows new values to be inserted into an existing label. The '''`replace`''' option allows existing values to be overwritten in an existing label. The '''`modify`''' option combines both.

----



== Stored Results ==

`label dir` stores the names of all labels in `r(names)`.

`label list` stores the following details:

 * the number of values with labels, in `r(k)`
 * the lowest non-missing value with a label, in `r(min)`
 * the highest non-missing value with a label, in `r(max)`
 * whether or not (i.e. 1 or 0) labeled missing values (i.e. `.a`) have labels, in `r(hasemiss)`

----



== See also ==

[[https://www.stata.com/manuals/dlabel.pdf|Stata manual for -label-]] 



----
CategoryRicottone