# DataColumn

> For the complete documentation index, see [llms.txt](https://kotlin.github.io/dataframe/llms.txt).

[DataColumn]() represents a column of values. It can store objects of primitive or reference types, or other [DataFrame](dataframe.html) objects.

See [how to create columns](createcolumn.html) or explore the [DataColumn Dokka API](https://kotlin.github.io/dataframe/api-docs/core/org.jetbrains.kotlinx.dataframe/-data-column/index.html).

## Properties

* `name: String` — name of the column; should be unique within the containing dataframe

* `path: ColumnPath` — path to the column; depends on the way the column was retrieved from the dataframe

* `type: KType` — type of elements in the column

* `hasNulls: Boolean` — flag indicating whether the column contains `null` values

* `values: Iterable<T>` — column data

* `size: Int` — number of elements in the column

## Column kinds

[DataColumn]() instances can be one of three subtypes: `ValueColumn`, [ColumnGroup](#columngroup) or [FrameColumn](#framecolumn)

### ValueColumn

Represents a sequence of values.

It can store values of primitive (integers, strings, decimals, etc.) or reference types. Currently, it uses [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-list/) as underlying data storage.

### ColumnGroup

Container for nested columns. Used to create column hierarchy.

You can create column groups using the group operation or by splitting inward — see [group](group.html) and [split](split.html) for details.

### FrameColumn

Special case of [ValueColumn](#valuecolumn) that stores other [DataFrame](dataframe.html) objects as elements.

[DataFrame](dataframe.html) stored in [FrameColumn](#framecolumn) may have different schemas.

[FrameColumn](#framecolumn) may appear after [reading](read.html) from JSON or other hierarchical data structures, or after grouping operations such as [groupBy](groupby.html) or [pivot](pivot.html).

