NAME

getrdsmodellist - gets model list of the instances of a figure

See the file buster/alliance/alc_origin.1.en.gz.

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 );


      . . .


    }