VecGetArray#
Returns a pointer to a contiguous array that contains this MPI processes’s portion of the vector data
Synopsis#
#include "petscvec.h"
PetscErrorCode VecGetArray(Vec x, PetscScalar **a)
Logically Collective
Input Parameter#
x - the vector
Output Parameter#
a - location to put pointer to the array
Notes#
For the standard PETSc vectors, VecGetArray() returns a pointer to the local data array and
does not use any copies. If the underlying vector data is not stored in a contiguous array
this routine will copy the data to a contiguous array and return a pointer to that. You MUST
call VecRestoreArray() when you no longer need access to the array.
Fortran Notes#
VecGetArray() Fortran binding is deprecated (since PETSc 3.19), use VecGetArrayF90()
See Also#
Vectors and Parallel Data, Vec, VecRestoreArray(), VecGetArrayRead(), VecGetArrays(), VecGetArrayF90(), VecGetArrayReadF90(), VecPlaceArray(), VecGetArray2d(),
VecGetArrayPair(), VecRestoreArrayPair(), VecGetArrayWrite(), VecRestoreArrayWrite()
Level#
beginner
Location#
Examples#
src/dm/tutorials/ex5.c
src/ksp/ksp/tutorials/ex36.cxx
src/ksp/ksp/tutorials/ex69.c
src/ksp/ksp/tutorials/ex42.c
src/ksp/ksp/tutorials/ex43.c
src/dm/field/tutorials/ex1.c
src/dm/tutorials/ex6.c
src/ksp/ksp/tutorials/ex35.cxx
src/ksp/ksp/tutorials/ex11.c
src/ksp/ksp/tutorials/ex68.c
Implementations#
VecGetArray_Nest() in src/vec/vec/impls/nest/vecnest.c
VecGetArray_SeqKokkos() in src/vec/vec/impls/seq/kokkos/veckok.kokkos.cxx
VecGetArray_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