:orphan:
# MatDenseHIPGetArray
Provides access to the HIP buffer inside a `MATDENSEHIP` matrix. The array must be restored with `MatDenseHIPRestoreArray()` when no longer needed. 
## Synopsis
```
PetscErrorCode MatDenseHIPGetArray(Mat A, PetscScalar **a)
```
Not Collective


## Input Parameter

- ***A -*** the matrix



## Output Parameter

- ***a -*** the GPU array in column major order





## Note
Data can be copied to the GPU due to operations done on the CPU. If you need write only
access, use `MatDenseHIPGetArrayWrite()`. For read-only access, use
`MatDenseHIPGetArrayRead()`.


## See Also
 `MATDENSEHIP`, `MatDenseHIPGetArrayRead()`, `MatDenseHIPRestoreArray()`,
`MatDenseHIPRestoreArrayWrite()`, `MatDenseHIPGetArrayWrite()`,
`MatDenseHIPRestoreArrayRead()`

## Level
developer

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/dense/mpi/cupm/hip/matmpidensehip.hip.cpp#MatDenseHIPGetArray">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)  
