VecGetArrayWrite#
Returns a pointer to a contiguous array that WILL contain this MPI processes’s portion of the vector data.
Synopsis#
#include "petscvec.h"
PetscErrorCode VecGetArrayWrite(Vec x, PetscScalar **a)
Logically Collective
Input Parameter#
x - the vector
Output Parameter#
a - location to put pointer to the array
Note#
The values in this array are NOT valid, the caller of this routine is responsible for putting values into the array; any values it does not set will be invalid.
The array must be returned using a matching call to VecRestoreArrayWrite().
For vectors associated with GPUs, the host and device vectors are not synchronized before
giving access. If you need correct values in the array use VecGetArray()
Fortran Notes#
VecGetArrayWrite() Fortran binding is deprecated (since PETSc 3.19), use VecGetArrayWriteF90()
See Also#
Vectors and Parallel Data, Vec, VecGetArrayWriteF90(), VecRestoreArray(), VecGetArrayRead(), VecGetArrays(), VecGetArrayF90(), VecGetArrayReadF90(), VecPlaceArray(), VecGetArray2d(),
VecGetArrayPair(), VecRestoreArrayPair(), VecGetArray(), VecRestoreArrayWrite()
Level#
intermediate
Location#
Examples#
src/ts/tutorials/ex43.c
src/snes/tutorials/ex17.c
src/tao/unconstrained/tutorials/rosenbrock3.c
src/dm/impls/plex/tutorials/ex11.c
src/ts/tutorials/ex77.c
src/ts/tutorials/ex36.c
src/ts/tutorials/ex23fwdadj.c
src/dm/impls/plex/tutorials/ex14.c
src/ts/tutorials/ex45.c
src/ts/tutorials/ex3.c
Implementations#
VecGetArrayWrite_SeqKokkos() in src/vec/vec/impls/seq/kokkos/veckok.kokkos.cxx
VecGetArrayWrite_SeqViennaCL() in src/vec/vec/impls/seq/seqviennacl/vecviennacl.cxx
Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages