freerdsrec(3alc)

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

NAME

6        freerdsrec - free memory associated to a rectangle
7

SYNOPSIS

9        #include "rdsnnn.h"
10         void freerdsrec( Rectangle, Size )
11           rdsrec_list  ∗Rectangle;
12           unsigned int  Size;
13

PARAMETER

15       Rectangle           Pointer of the rectangle structure to free.
16
17       Size                Size  of  the  structure  added  (if  it exists) to
18                           rdsrec_list structure.
19

DESCRIPTION

21       This function deletes the memory associated to  the  rectangle.  Memory
22       used  is  both memory of rdsrec_list structure and memory of the struc‐
23       ture added by the user. If the user structure doesn't exist, the param‐
24       eter  ´Size´  must  be  to 0L. Memory place used by the Pointers of the
25       rdsrec_list structure (and the added structure) is not deleted  so  the
26       user  has  to free these pointers before calling the freerdsrec() func‐
27       tion.
28

RETURN VALUE

30       nothing
31

ERRORS

33       none
34

EXAMPLE

36                  #include "mutnnn.h"
37                  #include "rdsnnn.h"
38                  #include "rtlnnn.h"
39              typedef struct UserStruct
40               {
41                 char ∗STRING;
42                 void ∗USER1;
43               } UserStruct;
44              main()
45               {
46                 rdsrec_list ∗Rectangle;
47                      mbkenv();
48                      rdsenv();
49                      loadrdsparam();
50                 Rectangle = allocrdsrec ( sizeof ( UserStruct ) );
51                 ...
52                 /∗ ∗/ freerdsrec ( Rectangle, sizeof ( UserStruct ) );
53               }
54