xref: /petsc/src/sys/objects/pgname.c (revision e6e75211d226c622f451867f53ce5d558649ff4f)
1 
2 #include <petsc/private/petscimpl.h>        /*I    "petscsys.h"   I*/
3 
4 #undef __FUNCT__
5 #define __FUNCT__ "PetscObjectGetName"
6 /*@C
7    PetscObjectGetName - Gets a string name associated with a PETSc object.
8 
9    Not Collective unless object has not been named yet
10 
11    Input Parameters:
12 +  obj - the Petsc variable
13          Thus must be cast with a (PetscObject), for example,
14          PetscObjectGetName((PetscObject)mat,&name);
15 -  name - the name associated with obj
16 
17    Level: intermediate
18 
19    Concepts: object name
20 
21 .seealso: PetscObjectSetName()
22 @*/
23 PetscErrorCode  PetscObjectGetName(PetscObject obj,const char *name[])
24 {
25   PetscErrorCode ierr;
26 
27   PetscFunctionBegin;
28   PetscValidHeader(obj,1);
29   PetscValidPointer(name,2);
30   ierr  = PetscObjectName(obj);CHKERRQ(ierr);
31   *name = obj->name;
32   PetscFunctionReturn(0);
33 }
34 
35