VecGetArray#
Returns a pointer to a contiguous array that contains this processor’s portion of the vector data. 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.
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
Fortran Note#
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/field/tutorials/ex1.c
src/dm/tutorials/ex5.c
src/dm/tutorials/ex6.c
src/ksp/ksp/tutorials/ex11.c
src/ksp/ksp/tutorials/ex14f.F90
src/ksp/ksp/tutorials/ex2f.F90
src/ksp/ksp/tutorials/ex35.cxx
src/ksp/ksp/tutorials/ex36.cxx
src/ksp/ksp/tutorials/ex42.c
src/ksp/ksp/tutorials/ex43.c
src/ksp/ksp/tutorials/ex49.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