VecPlaceArray#

Allows one to replace the array in a vector with an array provided by the user. This is useful to avoid copying an array into a vector.

Synopsis#

#include "petscvec.h"   
PetscErrorCode VecPlaceArray(Vec vec, const PetscScalar array[])

Not Collective; No Fortran Support

Input Parameters#

  • vec - the vector

  • array - the array

Notes#

Use VecReplaceArray() instead to permanently replace the array

You can return to the original array with a call to VecResetArray(). vec does not take ownership of array in any way.

The user must free array themselves but be careful not to do so before the vector has either been destroyed, had its original array restored with VecResetArray() or permanently replaced with VecReplaceArray().

See Also#

Vectors and Parallel Data, Vec, VecGetArray(), VecRestoreArray(), VecReplaceArray(), VecResetArray()

Level#

developer

Location#

src/vec/vec/interface/rvector.c

Examples#

src/ksp/ksp/tutorials/ex13.c
src/ksp/ksp/tutorials/ex13f90.F90
src/ksp/ksp/tutorials/ex61f.F90

Implementations#

VecPlaceArray_MPI in src/vec/vec/impls/mpi/pbvec.c
VecPlaceArray_Seq in src/vec/vec/impls/seq/dvec2.c
VecPlaceArray_SeqKokkos in src/vec/vec/impls/seq/kokkos/veckok.kokkos.cxx
VecPlaceArray_SeqViennaCL in src/vec/vec/impls/seq/seqviennacl/vecviennacl.cxx


Edit on GitLab

Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages