# VecHIPGetArrayWrite
Provides write access to the HIP buffer inside a vector. 
## Synopsis
```
#include "petscvec.h"   
PETSC_EXTERN PetscErrorCode VecHIPGetArrayWrite(Vec v, PetscScalar **a)
```
The data pointed to by the device pointer is uninitialized.  The user
may not read from this data.  Furthermore, the entire array needs to
be filled by the user to obtain well-defined behaviour.  The device
memory will be allocated by this function if it hasn't been allocated
previously.  This is analogous to intent(out) in Fortran.

The device pointer needs to be released with
VecHIPRestoreArrayWrite().  When the pointer is released the
host data of the vector is marked as out of data.  Subsequent access
of the host data with e.g. VecGetArray() incurs a device to host data
transfer.


## Input Parameter

- ***v -*** the vector



## Output Parameter

- ***a -*** the HIP pointer



## Fortran note
This function is not currently available from Fortran.




## See Also
 `VecHIPRestoreArrayWrite()`, `VecHIPGetArray()`, `VecHIPGetArrayRead()`, `VecHIPGetArrayWrite()`, `VecGetArray()`, `VecGetArrayRead()`

## Level
advanced

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/vec/vec/interface/rvector.c.html#VecHIPGetArrayWrite">src/vec/vec/interface/rvector.c</A>


---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/vec/vec/interface/rvector.c)


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