getrdsmodellist(3) - Linux man page

Name

getrdsmodellist - gets model list of the instances of a figure

Synopsys

#include "rutnnn.h"
 ptype_list ∗getrdsmodellist( Figure )
   rdsfig_list ∗Figure;

Parameter

Figure The figure which contains the models to extract.

Description

The getrdsmodellist function gets list of instance's models of the figure 'Figure'. The data structure returned "ptype_list" is defined ( in MBK library mutnnn.h ) as follows :

typedef struct ptype
  {
     struct ptype ∗NEXT;  /∗ next pointer                ∗/
     void         ∗DATA;  /∗ generic pointer             ∗/
     long         TYPE;   /∗ type                        ∗/
  } ptype_list;

The field 'DATA' of ptype_list structure contains the pointer to the rdsfig_list structure.

Return Value

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

Errors

none

EXAMPLE :

    #include "mphnnn.h"
    #include "mutnnn.h"
    #include "rdsnnn.h"
    #include "rutnnn.h"
    #include "rtlnnn.h"
    main()
     {
      phfig_list  ∗MbkFigure;
      rdsfig_list ∗RdsFigure;
      ptype_list  ∗FigureList;
      ptype_list  ∗ScanFigureList;
      mbkenv();
      rdsenv();
      loadrdsparam();
      MbkFigure        = getphfig("core",'A');
      RdsFigure = figmbkrds(MbkFigure,0,0);
      FigureList = getrdsmodellist( RdsFigure );
      for (
            ScanFigureList  = FigureList ;
            ScanFigureList != (ptype_list ∗) NULL ;
            ScanFigureList  = ScanFigureList->NEXT
          )
        viewrdsfig ( (rdsfig_list ∗) ScanFigureList->DATA );
      . . .
    }