allocrdswinrec(3)

allocrdswinrec3

Allocates a structure used to create a list of tables of rectangles.

Synopsys

#include "rwinnn.h"
 rdswinrec_list ∗allocrdswinrec()

Parameter

none

Overview

The allocrdswinrec function allocates a data structure named "rdswinrec_list" used to contain rectangles. This structure contains a list of tables of rdsrec_list structures (see librwi and librds).

Return value

The pointer to the newly allocated structure is returned.

Errors

"Rds202: rdsalloc error, can't continue !"

it's impossible to allocate the memory size desired

Examples

        #include "mutnnn.h"
        #include "rdsnnn.h"
        #include "rwinnn.h"
        #include "rtlnnn.h"
        main()
          {
            rdsrec_list    ∗Rectangle;
            rdswinrec_list ∗WinRec, ∗HeadWinRec;
            mbkenv();
            rdsenv();
            loadrdsparam();
            WinRec = HeadWinRec = allocrdswinrec();
            /∗ Fill the table with rectangles ∗/
            for ( Counter = 0 ; Counter < RWI_MAX_REC ; Counter ++ )
             {
               if ( Rectangle == (rdsrec_list ∗) NULL ) break;
               WinRec->RECTAB[Counter] = Rectangle;
               Rectangle = Rectangle->NEXT;
             }
            if ( Counter == RWI_MAX_REC ) 
             {
               /∗ the table is full : allocation of a new table ∗/
               WinRec->NEXT = allocrdswinrec();
               WinRec = WinRec->NEXT;
             }
            . . . . 
          }

Releases

4 releases since Debian 7 (Wheezy); the text changed 1 time.

  1. 7–8
  2. 9–10

From alliance 5.1.1-3 in Debian 10 (Buster). Parsed by carta from the page's man source.