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()`, `PetscObject`, `PetscObjectGetId()`
21: @*/
22: PetscErrorCode PetscObjectGetName(PetscObject obj, const char *name[])
23: {
24: PetscFunctionBegin;
27: PetscCall(PetscObjectName(obj));
28: *name = obj->name;
29: PetscFunctionReturn(PETSC_SUCCESS);
30: }