petsc-3.4.5 2014-06-29

PetscObjectComposeFunction

Associates a function with a given PETSc object.

#include "petscsys.h"
PetscErrorCode PetscObjectComposeFunction(PetscObject obj,const char name[],void (*fptr)(void))

Logically Collective on PetscObject

	obj	- the PETSc object; this must be cast with a (PetscObject), for example, PetscObjectCompose((PetscObject)mat,...);
	name	- name associated with the child function
	fname	- name of the function
	fptr	- function pointer

To remove a registered routine, pass in NULL for fptr().

PetscObjectComposeFunction() can be used with any PETSc object (such as Mat, Vec, KSP, SNES, etc.) or any user-provided object.