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 Universite 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
",RdsFigure->NAME);
	      /* The new figure is head of figure list */
	      printf("HEAD_RDSFIG : FIGURE NAME = %s
",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)