valuesInto

fun <T, C, K, R> Gather<T, C, K, R>.valuesInto(valueColumn: String): DataFrame<T>

Reshapes the columns previously selected by gather into a new valueColumn, containing the original column values. The key column is omitted.

Returns a new DataFrame with the reshaped structure. The original gathered columns are removed from the result, while all other columns remain unchanged — except that their values are duplicated for each generated value.

Resulting values can be adjusted using mapValues.

For more information, see: See gather on the documentation website.

See also: Grammar.

Example

// Gather values of all `String` columns
// into a single "tag" column, omitting the key column.
df.gather { colsOf<String>() }
.valuesInto("tag")

Return

A new DataFrame with reshaped columns.

Parameters

valueColumn

The name of the column to store gathered values.

See also


fun <T, C, K, R> Gather<T, C, K, R>.valuesInto(valueColumn: ColumnAccessor<K>): DataFrame<T>
fun <T, C, K, R> Gather<T, C, K, R>.valuesInto(valueColumn: KProperty<K>): DataFrame<T>

Deprecated

It's recommended to migrate to the String or Extension Properties Access API https://kotlin.github.io/dataframe/apilevels.html