<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 15.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 8.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "TabularData",
  "identifier" : "/documentation/TabularData/DataFrameProtocol/sorted(on:by:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "TabularData"
    ],
    "preciseIdentifier" : "s:11TabularData0B13FrameProtocolPAAE6sorted2on2byAA0bC0VAA8ColumnIDVyqd__G_Sbqd___qd__tKXEtKlF"
  },
  "title" : "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 column identifier, with a predicate.

```
func sorted<T>(on columnID: ColumnID<T>, by areInIncreasingOrder: (T, T) throws -> Bool) rethrows -> DataFrame
```

## Parameters

`columnID`

The identifier of a column.

`areInIncreasingOrder`

A closure that returns a Boolean that indicates
whether the two elements are in increasing order.

## Discussion> Note: Elements with a value of `nil` are less than all non-`nil` values.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)