2: #include <petsc/private/petscimpl.h>
4: /*@C
5: PetscObjectGetName - Gets a string name associated with a PETSc object.
7: Not Collective unless object has not been named yet
9: Input Parameters:
10: + obj - the Petsc variable
11: Thus must be cast with a (`PetscObject`), for example,
12: `PetscObjectGetName`((`PetscObject`)mat,&name);
13: - name - the name associated with obj
15: Note:
16: Calls `PetscObjectName()` if a name has not yet been provided to the object.
18: Level: intermediate
20: .seealso: `PetscObjectSetName()`, `PetscObjectName()`
21: @*/
22: PetscErrorCode PetscObjectGetName(PetscObject obj, const char *name[])
23: {
26: PetscObjectName(obj);
27: *name = obj->name;
28: return 0;
29: }