VecGetArrayRead#
Get read-only pointer to contiguous array containing this processor’s portion of the vector data.
Synopsis#
#include "petscvec.h"
PetscErrorCode VecGetArrayRead(Vec x, const PetscScalar **a)
Not Collective
Input Parameter#
x - the vector
Output Parameter#
a - the array
Notes#
The array must be returned using a matching call to VecRestoreArrayRead().
Unlike VecGetArray(), preserves cached information like vector norms.
Standard PETSc vectors use contiguous storage so that this routine does not perform a copy. Other vector implementations may require a copy, but such implementations should cache the contiguous representation so that only one copy is performed when this routine is called multiple times in sequence.
Fortran Notes#
VecGetArrayRead() Fortran binding is deprecated (since PETSc 3.19), use VecGetArrayReadF90()
See Also#
Vectors and Parallel Data, Vec, VecGetArrayReadF90(), VecGetArray(), VecRestoreArray(), VecGetArrayPair(), VecRestoreArrayPair()
Level#
beginner
Location#
Examples#
src/dm/tutorials/ex22.c
src/dm/impls/plex/tutorials/ex6.c
src/dm/impls/plex/tutorials/ex8.c
src/ts/tutorials/ex32.c
src/dm/impls/plex/tutorials/ex15.c
src/ts/tutorials/ex77.c
src/dm/tutorials/swarm_ex3.c
src/dm/field/tutorials/ex1.c
src/ts/tutorials/ex51.c
src/ts/utils/dmplexlandau/tutorials/ex1.c
Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages