petsc-3.5.4 2015-05-23

MatRestoreRow

Frees any temporary space allocated by MatGetRow().

Synopsis

#include "petscmat.h" 
PetscErrorCode  MatRestoreRow(Mat mat,PetscInt row,PetscInt *ncols,const PetscInt *cols[],const PetscScalar *vals[])

Not Collective

Input Parameters

	mat	- the matrix
	row	- the row to get
	ncols, cols	- the number of nonzeros and their columns
	vals	- if nonzero the column values

Notes

This routine should be called after you have finished examining the entries.

This routine zeros out ncols, cols, and vals. This is to prevent accidental us of the array after it has been restored. If you pass NULL, it will not zero the pointers. Use of cols or vals after MatRestoreRow is invalid.

Fortran Notes

The calling sequence from Fortran is

   MatRestoreRow(matrix,row,ncols,cols,values,ierr)
      Mat     matrix (input)
      integer row    (input)
      integer ncols  (output)
      integer cols(maxcols) (output)
      double precision (or double complex) values(maxcols) output

Where maxcols >= maximum nonzeros in any row of the matrix.

In Fortran MatRestoreRow() MUST be called after MatGetRow() before another call to MatGetRow() can be made.

Examples