getrdsmodellist(3alc)

1GETRDSMODELLIST(3)          RDS PHYSICAL FUNCTIONS          GETRDSMODELLIST(3)
2
3
4

NAME

6       getrdsmodellist - gets model list of the instances of a figure
7

SYNOPSIS

9       #include "rutnnn.h"
10        ptype_list ∗getrdsmodellist( Figure )
11          rdsfig_list ∗Figure;
12

PARAMETER

14       Figure              The figure which contains the models to extract.
15

DESCRIPTION

17       The getrdsmodellist function gets list of instance's models of the fig‐
18       ure ´Figure´. The data structure returned "ptype_list" is defined (  in
19       MBK library mutnnn.h ) as follows :
20              typedef struct ptype
21                {
22                   struct ptype ∗NEXT;  /∗ next pointer                ∗/
23                   void         ∗DATA;  /∗ generic pointer             ∗/
24                   long         TYPE;   /∗ type                        ∗/
25                } ptype_list;
26
27       The  field  ´DATA´  of ptype_list structure contains the pointer to the
28       rdsfig_list structure.
29

RETURN VALUE

31       The getrdsmodellist  function  returns  a  pointer  which  is  head  of
32       pointer's  list of the instances's models of the figure. If the list is
33       empty, NULL pointer is returned.
34

ERRORS

36       none
37

EXAMPLE :

39           #include "mphnnn.h"
40           #include "mutnnn.h"
41           #include "rdsnnn.h"
42           #include "rutnnn.h"
43           #include "rtlnnn.h"
44           main()
45            {
46             phfig_list  ∗MbkFigure;
47             rdsfig_list ∗RdsFigure;
48             ptype_list  ∗FigureList;
49             ptype_list  ∗ScanFigureList;
50             mbkenv();
51             rdsenv();
52             loadrdsparam();
53             MbkFigure        = getphfig("core",'A');
54             RdsFigure = figmbkrds(MbkFigure,0,0);
55             FigureList = getrdsmodellist( RdsFigure );
56             for (
57                   ScanFigureList  = FigureList ;
58                   ScanFigureList != (ptype_list ∗) NULL ;
59                   ScanFigureList  = ScanFigureList->NEXT
60                 )
61               viewrdsfig ( (rdsfig_list ∗) ScanFigureList->DATA );
62             . . .
63           }
64