= Stata List =

the '''`list`''' command lists data.

<<TableOfContents>>

----



== Usage ==

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

----



== Data Formats ==



=== String Length and Truncation ===

The `list` command examines data to (re-)allocate text width. 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 ===

The `list` command shifts between two output modes based on the width of the output, and on the width of the screen.

In '''table format''', the `list` command right-justifies all string values.

In '''display format''', 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 ===

The `list` command abbreviates variable names; by default to 8 characters. To increase that limit, try:

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



=== Value Labels ===

The `list` command displays labels (as opposed to values) when available. 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