single

Returns the single value in this DataColumn.

For more information: See single on the documentation website.

None of the neighbouring operations require the DataColumn to contain exactly one value: first and last return the first or the last value, firstOrNull returns the first value, or null if the DataColumn is empty, and take and takeLast return several values as a new DataColumn. There is no singleOrNull for a DataColumn.

Throws

Returns the single row in this DataFrame.

For more information: See single on the documentation website.

See also singleOrNull, that returns null instead of throwing, and first, last, that return the first or the last row and do not require the DataFrame to contain exactly one row.

Throws

Returns the single row in this DataFrame that satisfies the given predicate.

The predicate is a RowFilter — a lambda that receives each DataRow as both this and it and is expected to return a Boolean value.

It allows you to define conditions using the row's values directly, including through extension properties for convenient and type-safe access.

For more information, See RowFilter on the documentation website.

This can include column groups and nested columns.

Example

// In a DataFrame of financial transactions,
// find the only transaction made with the given id
df.single { id == 137 }

For more information: See single on the documentation website.

See also singleOrNull, that returns null instead of throwing, and first, last, that return the first or the last matching row and do not require the DataFrame to contain exactly one matching row.

Parameters

Throws