addrdsfig(3alc)

1ADDRDSFIG(3)                RDS PHYSICAL FUNCTIONS                ADDRDSFIG(3)
2
3
4

NAME

6       addrdsfig - adds a figure
7

SYNOPSIS

9       #include"rdsnnn.h"
10       rdsfig_list ∗addrdsfig( Name, Size )
11         char        ∗Name;
12         unsigned int Size;
13

PARAMETER

15       Name                Name of the figure to add to the figures's list.
16
17       Size                Size  of  the  user structure (if defined) added to
18                           the rdsrec_list structure.
19

DESCRIPTION

21       The addrdsfig function adds a new figure called 'Name' to the  head  of
22       figures's list and becomes itself the list head (HEAD_RDSFIG pointer).
23       The field NAME of the figure is set to ´Name´.
24       The field SIZE of the figure is set to ´Size´.
25       The field MODE of the figure is set to ´A´.
26
27       Note :
28
29       Name allocation is done with the namealloc() MBK function.
30
31       If  user  structure isn't defined, the user has to set parameter 'Size'
32       to 0L.
33

RETURN VALUE

35       Pointer to the newly created figure.It's also the HEAD_RDSFIG pointer.
36

ERRORS

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

EXAMPLE

42               #include "mutnnn.h"
43          #include "rdsnnn.h"
44               #include "rtlnnn.h"
45           typedef struct UserStruct
46            {
47              char ∗STRING;
48              void ∗USER1;
49            } UserStruct;
50           main()
51            {
52              rdsfig_list ∗RdsFigure;
53                   mbkenv();
54                   rdsenv();
55                   loadrdsparam();
56              RdsFigure = addrdsfig ("core",sizeof ( UserStruct ) );
57              printf("FIGURE NAME = %s\n",RdsFigure->NAME);
58              /∗ The new figure is head of figure list ∗/
59              printf("HEAD_RDSFIG : FIGURE NAME = %s\n",HEAD_RDSFIG->NAME);
60            }
61