NAME

       addrdsfig - adds a figure

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