= Stata List =

'''`-list-`''' lists data.

<<TableOfContents>>

----



== Usage ==

{{{
list foo bar baz
list foo bar baz in 1/10
list foo if bar==baz
}}}

----



== Display Formats ==

`-list-` shifts between two output modes based on the width of the output, and on the width of the screen. '''Table format''' is as a columnar table. '''Display format''' is a list of cells that wraps indefinitely across rows.



=== String Length and Truncation ===

`-list-` examines values to allocate the screen's width across columns. If the longest value for a string variable with format `%18s` is 12 characters long, then `-list-` will only allocate 12 columns for that variable. This behavior can be disabled using the '''`nocompress`''' option.

Note that the default behavior has an impact on performance, especially for large datasets. As such, there is a '''`fast`''' option which is simply an alias for `nocompress`.

To truncate string values to an explicit length, try:

{{{
list comment, string(10)
}}}



=== String Alignment ===

In table format, string values are always right-justified.

In display format however, string values are aligned according to the display format. A string value would be left-justified if the variable had a format of `%-18s`.



=== Variable Name Length and Truncation ===

Variable names are abbreviated to 8 characters. To increase that limit, try:

{{{
list very_long_variable_name, abbreviate(50)
}}}



=== Value Labels ===

Value labels (as opposed to values themselves) are displayed. To override this behavior, use the '''`nolabel`''' option.

Value labels are aligned in the same way as string values; based on the output mode and the display format. Just as a string value would be left-justified if the variable had a format of `%-18s`, a label would be justified if the variable had a format of `%-8g`.

----



== See also ==

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



----
CategoryRicottone