:orphan:
# MatDenseHIPReplaceArray
Allows one to replace the GPU array in a `MATDENSEHIP` matrix with an array provided by the user. This is useful to avoid copying an array into a matrix. 
## Synopsis
```
PetscErrorCode MatDenseHIPReplaceArray(Mat mat, const PetscScalar *array)
```
Not Collective


## Input Parameters

- ***mat   -*** the matrix
- ***array -*** the array in column major order





## Note
This permanently replaces the GPU array and frees the memory associated with the old GPU
array. The memory passed in CANNOT be freed by the user. It will be freed when the matrix is
destroyed. The array should respect the matrix leading dimension.


## See Also
 `MatDenseHIPGetArray()`, `MatDenseHIPPlaceArray()`, `MatDenseHIPResetArray()`

## Level
developer

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/dense/mpi/cupm/hip/matmpidensehip.hip.cpp#MatDenseHIPReplaceArray">src/mat/impls/dense/mpi/cupm/hip/matmpidensehip.hip.cpp</A>


---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/mat/impls/dense/mpi/cupm/hip/matmpidensehip.hip.cpp)


[Index of all Mat routines](index.md)  
[Table of Contents for all manual pages](/manualpages/index.md)  
[Index of all manual pages](/manualpages/singleindex.md)