freerdsrec(3)

NAME

freerdsrec - free memory associated to a rectangle

SYNOPSYS

 #include "rdsnnn.h"
  void freerdsrec( Rectangle, Size )
    rdsrec_list  ∗Rectangle;
    unsigned int  Size;

PARAMETER

Rectangle: Pointer of the rectangle structure to free.

Size: Size of the structure added (if it exists) to rdsrec_list structure.

DESCRIPTION

This function deletes the memory associated to the rectangle. Memory used is both memory of rdsrec_list structure and memory of the structure added by the user. If the user structure doesn't exist, the parameter ´Size´ must be to 0L. Memory place used by the Pointers of the rdsrec_list structure (and the added structure) is not deleted so the user has to free these pointers before calling the freerdsrec() function.

RETURN VALUE

nothing

ERRORS

none

EXAMPLE

           #include "mutnnn.h"
           #include "rdsnnn.h"
           #include "rtlnnn.h"
	    typedef struct UserStruct
	     {
	       char ∗STRING;
	       void ∗USER1;
	     } UserStruct;
	    main()
	     {
	       rdsrec_list ∗Rectangle;
               mbkenv();
               rdsenv();
               loadrdsparam();
	       Rectangle = allocrdsrec ( sizeof ( UserStruct ) );
	       ...
	       /∗ ∗/ freerdsrec ( Rectangle, sizeof ( UserStruct ) );            
	     }