getrdsmodellist.3alc man page

getrdsmodellist
getrdsmodellist

getrdsmodellist — gets model list of the instances of a figure

Synopsis

#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 );
      . . .
    }

See Also

librut, Mutlibrary

Info

October 1, 1997 ASIM/LIP6 RDS PHYSICAL FUNCTIONS