:orphan:
# VecCUDAPlaceArray
Allows one to replace the GPU array in a vector with a GPU array provided by the user. 
## Synopsis
```
#include <petscvec.h> 
PetscErrorCode VecCUDAPlaceArray(Vec vin, const PetscScalar a[])
```
Not Collective; Asynchronous; No Fortran Support


## Input Parameters

- ***vec -*** the vector
- ***array -*** the GPU array





## Notes
This routine is useful to avoid copying an array into a vector, though you can return to the
original GPU array with a call to `VecCUDAResetArray()`.

It is not possible to use `VecCUDAPlaceArray()` and `VecPlaceArray()` at the same time on the
same vector.

`vec` does not take ownership of `array` in any way. The user must free `array` themselves
but be careful not to do so before the vector has either been destroyed, had its original
array restored with `VecCUDAResetArray()` or permanently replaced with
`VecCUDAReplaceArray()`.


## See Also
 [](ch_vectors), `VecPlaceArray()`, `VecGetArray()`, `VecRestoreArray()`, `VecReplaceArray()`,
`VecResetArray()`, `VecCUDAResetArray()`, `VecCUDAReplaceArray()`

## Level
advanced

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/vec/vec/impls/seq/cupm/cuda/vecseqcupm.cu.html#VecCUDAPlaceArray">src/vec/vec/impls/seq/cupm/cuda/vecseqcupm.cu</A>


---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/vec/vec/impls/seq/cupm/cuda/vecseqcupm.cu)


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