<!--
{
  "availability" : [
    "iOS: 9.0.0 -",
    "iPadOS: 9.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.11.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 3.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Accelerate",
  "identifier" : "/documentation/Accelerate/sparse_permute_rows_float(_:_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Accelerate"
    ],
    "preciseIdentifier" : "c:@F@sparse_permute_rows_float"
  },
  "title" : "sparse_permute_rows_float(_:_:)"
}
-->

# sparse_permute_rows_float(_:_:)

Permutes the rows of the single-precision sparse matrix *A* based on the provided permutation array.

```
func sparse_permute_rows_float(_ A: sparse_matrix_float!, _ perm: UnsafePointer<sparse_index>!) -> sparse_status
```

## Parameters

`A`

The sparse matrix, *A*.

`perm`

The permutation array.  Holds number of rows in *A* values indicating the permutation of the matrix.  The indices in `perm` are expected to be 0 based  (first element of pointer is `ptr[0]`). The indices in perm are expected to be within bounds of the matrix.  Undefined behavior if not met.

## Return Value

On successful return, *A* has been permuted and [`SPARSE_SUCCESS`](/documentation/Accelerate/SPARSE_SUCCESS) is returned.

## Discussion

Permute the rows of the sparse matrix *A* based on the provided permutation array. For each row in *A*, swap rows as:

```swift
 tmp[:] = A[i,:];
 A[i,:] = A[perm[i],:];
 A[perm[i],:] = tmp[:];
```

> Important:
> Apple provides the BLAS and LAPACK libraries under the Accelerate framework to be in line with LAPACK 3.9.1. Starting with iOS 26, iPadOS 26, macOS 26, tvOS 26, visionOS 26, and watchOS 26, the libraries are in line with LAPACK 3.12.0. These new interfaces provide additional functionality, as well as a new ILP64 interface. To use the new interfaces, define `ACCELERATE_NEW_LAPACK` before including the Accelerate or vecLib headers. For ILP64 interfaces, also define `ACCELERATE_LAPACK_ILP64`. For Swift projects, specify `ACCELERATE_NEW_LAPACK=1` and `ACCELERATE_LAPACK_ILP64=1` as preprocessor macros in Xcode build settings under Apple Clang - Preprocessing > Preprocessor Macros.

---

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)