petsc-3.11.4 2019-09-28
ISRestoreIndices
Restores an index set to a usable state after a call to ISGetIndices().
Synopsis
#include "petscis.h"
PetscErrorCode ISRestoreIndices(IS is,const PetscInt *ptr[])
Not Collective
Input Parameters
| is | - the index set
|
| ptr | - the pointer obtained by ISGetIndices()
|
Fortran Note
This routine is used differently from Fortran
IS is
integer is_array(1)
PetscOffset i_is
int ierr
call ISGetIndices(is,is_array,i_is,ierr)
Access first local entry in list
value = is_array(i_is + 1)
...... other code
call ISRestoreIndices(is,is_array,i_is,ierr)
See the Fortran chapter of the users manual and
petsc/src/is/examples/[tutorials,tests] for details.
Note
This routine zeros out ptr. This is to prevent accidental us of the array after it has been restored.
See Also
ISGetIndices(), ISRestoreIndicesF90()
Level
intermediate
Location
src/vec/is/is/interface/index.c
Examples
src/vec/vec/utils/tagger/examples/tutorials/ex1.c.html
src/vec/is/is/examples/tutorials/ex1.c.html
src/vec/is/is/examples/tutorials/ex2.c.html
src/vec/is/is/examples/tutorials/ex3.c.html
src/vec/is/is/examples/tutorials/ex1f.F.html
src/vec/is/is/examples/tutorials/ex2f.F.html
src/dm/examples/tutorials/swarm_ex3.c.html
src/snes/examples/tutorials/ex56.c.html
src/snes/examples/tutorials/ex77.c.html
src/ts/examples/tutorials/ex11.c.html
Implementations
ISRestoreIndices_Block in src/vec/is/is/impls/block/block.c
ISRestoreIndices_General in src/vec/is/is/impls/general/general.c
ISRestoreIndices_Stride in src/vec/is/is/impls/stride/stride.c
Index of all IS routines
Table of Contents for all manual pages
Index of all manual pages