allocrdsrec.3alc - Man Page
allocates memory for a rectangle
Synopsis
#include"rdsnnn.h" rdsrec_list ∗allocrdsrec( Size ) unsigned int Size;
Parameter
- Size
Size of the added structure to the rdsrec_list structure.
Description
Allocates a memory block for rdsrec_list structure and an added structure defined by the user. Fields contained in the two structures are set to NULL for pointers and 0L for numbers.
NOTE: Allocation by heap ( see rdsalloc function ).
Return Value
The pointer to the rectangle structure allocated.
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"
/∗ Name and fields of UserStruct are defined by the user ∗/
typedef struct UserStruct
{
char ∗STRING;
void ∗USER1;
} UserStruct;
# define POINTER_STRING(R) \
\
(((UserStruct ∗)((char ∗)(R)+sizeof(rdsrec_list)))->STRING )
# define POINTER_USER1(R) \
\
(((UserStruct ∗)((char ∗)(R)+sizeof(rdsrec_list)))->USER1 )
main()
{
rdsfig_list ∗Figure;
rdsrec_list ∗Rectangle;
mbkenv();
rdsenv();
loadrdsparam();
Rectangle = allocrdsrec ( sizeof ( UserStruct ) );
Rectangle->X = 20;
Rectangle->Y = 20;
Rectangle->DX = 48;
Rectangle->DY = 8;
POINTER_STRING (Rectangle) = (char ∗) malloc (strlen ("Alu1")+1);
strcpy(POINTER_STRING(Rectangle),"Alu1");
POINTER_USER1 (Rectangle) = (void ∗) Figure;
...
}See Also
librds, freerdsrec, rdsalloc, rdsfree
Info
October 1, 1997 ASIM/LIP6 RDS PHYSICAL FUNCTIONS