addrdsfig

ADDRDSFIG(3)                RDS PHYSICAL FUNCTIONS                ADDRDSFIG(3)



NAME
       addrdsfig - adds a figure


ORIGIN
       This software belongs to the  ALLIANCE CAD SYSTEM developed by the ASIM
       team at LIP6 laboratory of Université Pierre et Marie CURIE, in Paris,
       France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr


SYNOPSYS
       #include"rdsnnn.h"
       rdsfig_list ∗addrdsfig( Name, Size )
         char        ∗Name;
         unsigned int Size;

PARAMETER
       Name                Name of the figure to add to the figures's list.

       Size                Size of the user structure (if defined) added to
                           the rdsrec_list structure.

DESCRIPTION
       The addrdsfig function adds a new figure called 'Name' to the head of
       figures's list and becomes itself the list head (HEAD_RDSFIG pointer).
       The field NAME of the figure is set to ´Name´.
       The field SIZE of the figure is set to ´Size´.
       The field MODE of the figure is set to ´A´.

       Note :

       Name allocation is done with the namealloc() MBK function.

       If user structure isn't defined, the user has to set parameter 'Size'
       to 0L.

RETURN VALUE
       Pointer to the newly created figure.It's also the HEAD_RDSFIG pointer.

ERRORS
       "Rds202: rdsalloc error, can't continue !"
              it's impossible to allocate the memory size desired

EXAMPLE
               #include "mutnnn.h"
          #include "rdsnnn.h"
               #include "rtlnnn.h"
           typedef struct UserStruct
            {
              char ∗STRING;
              void ∗USER1;
            } UserStruct;
           main()
            {
              rdsfig_list ∗RdsFigure;
                   mbkenv();
                   rdsenv();
                   loadrdsparam();
              RdsFigure = addrdsfig ("core",sizeof ( UserStruct ) );
              printf("FIGURE NAME = %s\n",RdsFigure->NAME);
              /∗ The new figure is head of figure list ∗/
              printf("HEAD_RDSFIG : FIGURE NAME = %s\n",HEAD_RDSFIG->NAME);
            }

SEE ALSO
       librds, delrdsfig, viewrdsfig




BUG REPORT
       This tool is under development at the ASIM department of the LIP6
       laboratory.
       We need your feedback to improve documentation and tools.






ASIM/LIP6                       October 1, 1997                   ADDRDSFIG(3)