1e5c89e4eSSatish Balay 2af0996ceSBarry Smith #include <petsc/private/petscimpl.h> /*I "petscsys.h" I*/ 3e5c89e4eSSatish Balay 4e5c89e4eSSatish Balay /*@C 5e5c89e4eSSatish Balay PetscObjectGetName - Gets a string name associated with a PETSc object. 6e5c89e4eSSatish Balay 7199a6bf1SJed Brown Not Collective unless object has not been named yet 8e5c89e4eSSatish Balay 9e5c89e4eSSatish Balay Input Parameters: 10e5c89e4eSSatish Balay + obj - the Petsc variable 11e5c89e4eSSatish Balay Thus must be cast with a (PetscObject), for example, 12e5c89e4eSSatish Balay PetscObjectGetName((PetscObject)mat,&name); 13e5c89e4eSSatish Balay - name - the name associated with obj 14e5c89e4eSSatish Balay 15*95452b02SPatrick Sanan Notes: 16*95452b02SPatrick Sanan Calls PetscObjectName() if a name has not yet been provided to the object. 17343722f2SBarry Smith 18e5c89e4eSSatish Balay Level: intermediate 19e5c89e4eSSatish Balay 20e5c89e4eSSatish Balay Concepts: object name 21e5c89e4eSSatish Balay 22343722f2SBarry Smith .seealso: PetscObjectSetName(), PetscObjectName() 23e5c89e4eSSatish Balay @*/ 247087cfbeSBarry Smith PetscErrorCode PetscObjectGetName(PetscObject obj,const char *name[]) 25e5c89e4eSSatish Balay { 26e5c89e4eSSatish Balay PetscErrorCode ierr; 27e5c89e4eSSatish Balay 28e5c89e4eSSatish Balay PetscFunctionBegin; 293cfa8680SLisandro Dalcin PetscValidHeader(obj,1); 303cfa8680SLisandro Dalcin PetscValidPointer(name,2); 317709abecSJed Brown ierr = PetscObjectName(obj);CHKERRQ(ierr); 32e5c89e4eSSatish Balay *name = obj->name; 33e5c89e4eSSatish Balay PetscFunctionReturn(0); 34e5c89e4eSSatish Balay } 35e5c89e4eSSatish Balay 36