freerdsrec.3alc man page

freerdsrec
freerdsrec

freerdsrec — free memory associated to a rectangle

Synopsis

 #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 ) );            
	     }

See Also

librds, freerdsrec, rdsfree

Info

October 1, 1997 ASIM/LIP6 RDS PHYSICAL FUNCTIONS