---
title: "sorted(on:_:by:)"
framework: tabulardata
role: symbol
role_heading: Instance Method
path: "tabulardata/dataframeprotocol/sorted(on:_:by:)"
---

# sorted(on:_:by:)

Generates a data frame by copying the data frame’s rows and then sorting the rows according to a column that you select by its name and type, with a predicate.

## Declaration

```swift
func sorted<T>(on columnName: String, _ type: T.Type, by areInIncreasingOrder: (T, T) throws -> Bool) rethrows -> DataFrame
```

## Parameters

- `columnName`: The name of a column.
- `type`: The column’s type.
- `areInIncreasingOrder`: A closure that returns a Boolean that indicates whether the two elements are in increasing order.

## Discussion

Discussion note: Elements with a value of nil are less than all non-nil values.

## See Also

### Creating a Data Frame by Sorting a Column

- [sorted(on:order:)](tabulardata/dataframeprotocol/sorted(on:order:)-818u5.md)
- [sorted(on:_:order:)](tabulardata/dataframeprotocol/sorted(on:_:order:)-8d7rr.md)
- [sorted(on:order:)](tabulardata/dataframeprotocol/sorted(on:order:)-5nl5c.md)
- [sorted(on:by:)](tabulardata/dataframeprotocol/sorted(on:by:).md)