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

src/vec/vec/interface/rvector.c

Examples

src/ts/tutorials/ex24.c
src/ts/tutorials/extchemfield.c
src/dm/tutorials/ex6.c
src/ts/tutorials/ex20fwd.c
src/ts/tutorials/ex77.c
src/dm/field/tutorials/ex1.c
src/dm/tutorials/ex5.c
src/ts/tutorials/ex51.c
src/ts/utils/dmplexlandau/tutorials/ex1.c
src/ts/tutorials/ex52.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