xref: /petsc/src/sys/objects/gcookie.c (revision 811af0c4b09a35de4306c442f88bd09fdc09897d)
17d0a6c19SBarry Smith 
2e5c89e4eSSatish Balay /*
3e5c89e4eSSatish Balay      Provides utility routines for manulating any type of PETSc object.
4e5c89e4eSSatish Balay */
5af0996ceSBarry Smith #include <petsc/private/petscimpl.h> /*I   "petscsys.h"    I*/
6e5c89e4eSSatish Balay 
72ec85ea4SAlex Fikl /*@
8*811af0c4SBarry Smith    PetscObjectGetClassId - Gets the classid for any `PetscObject`
9e5c89e4eSSatish Balay 
10e5c89e4eSSatish Balay    Not Collective
11e5c89e4eSSatish Balay 
12e5c89e4eSSatish Balay    Input Parameter:
13*811af0c4SBarry Smith .  obj - any PETSc object, for example a `Vec`, `Mat` or `KSP`.
14*811af0c4SBarry Smith          Thus must be cast with a (`PetscObject`), for example,
15*811af0c4SBarry Smith          `PetscObjectGetClassId`((`PetscObject`)mat,&classid);
16e5c89e4eSSatish Balay 
17e5c89e4eSSatish Balay    Output Parameter:
180700a824SBarry Smith .  classid - the classid
19e5c89e4eSSatish Balay 
20e5c89e4eSSatish Balay    Level: developer
21e5c89e4eSSatish Balay 
22*811af0c4SBarry Smith .seealso: `PetscObject`, `PetscClassId`, `PetscObjectGetClassName()`, `PetscObjectGetType()`
23e5c89e4eSSatish Balay @*/
249371c9d4SSatish Balay PetscErrorCode PetscObjectGetClassId(PetscObject obj, PetscClassId *classid) {
25e5c89e4eSSatish Balay   PetscFunctionBegin;
263cfa8680SLisandro Dalcin   PetscValidHeader(obj, 1);
275f80ce2aSJacob Faibussowitsch   PetscValidIntPointer(classid, 2);
280700a824SBarry Smith   *classid = obj->classid;
29e5c89e4eSSatish Balay   PetscFunctionReturn(0);
30e5c89e4eSSatish Balay }
31e5c89e4eSSatish Balay 
32609db0e0SLisandro Dalcin /*@C
33*811af0c4SBarry Smith    PetscObjectGetClassName - Gets the class name for any `PetscObject`
34609db0e0SLisandro Dalcin 
35609db0e0SLisandro Dalcin    Not Collective
36609db0e0SLisandro Dalcin 
37609db0e0SLisandro Dalcin    Input Parameter:
38*811af0c4SBarry Smith .  obj - any PETSc object, for example a `Vec`, `Mat` or `KSP`.
39*811af0c4SBarry Smith          Thus must be cast with a (`PetscObject`), for example,
40*811af0c4SBarry Smith          `PetscObjectGetClassName`((`PetscObject`)mat,&classname);
41609db0e0SLisandro Dalcin 
42609db0e0SLisandro Dalcin    Output Parameter:
43*811af0c4SBarry Smith .  classname - the class name, for example "Vec"
44609db0e0SLisandro Dalcin 
45609db0e0SLisandro Dalcin    Level: developer
46609db0e0SLisandro Dalcin 
47*811af0c4SBarry Smith .seealso: `PetscObject`, `PetscClassId`, `PetscObjectGetType()`
48609db0e0SLisandro Dalcin @*/
499371c9d4SSatish Balay PetscErrorCode PetscObjectGetClassName(PetscObject obj, const char *classname[]) {
50609db0e0SLisandro Dalcin   PetscFunctionBegin;
51609db0e0SLisandro Dalcin   PetscValidHeader(obj, 1);
52609db0e0SLisandro Dalcin   PetscValidPointer(classname, 2);
53609db0e0SLisandro Dalcin   *classname = obj->class_name;
54609db0e0SLisandro Dalcin   PetscFunctionReturn(0);
55609db0e0SLisandro Dalcin }
56