xref: /petsc/src/sys/objects/pgname.c (revision fbfcfee5110779e3d6a9465ca0a2e0f9a1a6e5e3)
1 
2 #include <petsc/private/petscimpl.h>        /*I    "petscsys.h"   I*/
3 
4 /*@C
5    PetscObjectGetName - Gets a string name associated with a PETSc object.
6 
7    Not Collective unless object has not been named yet
8 
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
14 
15    Level: intermediate
16 
17    Concepts: object name
18 
19 .seealso: PetscObjectSetName()
20 @*/
21 PetscErrorCode  PetscObjectGetName(PetscObject obj,const char *name[])
22 {
23   PetscErrorCode ierr;
24 
25   PetscFunctionBegin;
26   PetscValidHeader(obj,1);
27   PetscValidPointer(name,2);
28   ierr  = PetscObjectName(obj);CHKERRQ(ierr);
29   *name = obj->name;
30   PetscFunctionReturn(0);
31 }
32 
33