PetscObjectListRemoveReference#
Calls PetscObjectDereference()
on an object in the list immediately but keeps a pointer to the object in the list.
Synopsis#
PetscErrorCode PetscObjectListRemoveReference(PetscObjectList *fl, const char name[])
No Fortran Support
Input Parameters#
fl - the object list
name - the name to use for the object
Notes#
Use PetscObjectListAdd
(PetscObjectList
,const char name[],NULL) to truly remove the object from the list
Use this routine ONLY if you know that the object referenced will remain in existence until the pointing object is destroyed
Developer Notes#
This is to handle some cases that otherwise would result in having circular references so reference counts never got to zero
See Also#
PetscObjectListDestroy()
,PetscObjectListFind()
,PetscObjectListDuplicate()
,PetscObjectListReverseFind()
,
PetscObject
, PetscObjectListAdd()
Level#
developer
Location#
Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages