---
name: "allocrdswinrec"
section: "3"
platform: "linux"
package: "alliance"
version: "5.1.1-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/allocrdswinrec"
---

# allocrdswinrec(3)

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

## NAME

allocrdswinrec - allocates a structure used to create a list of tables of rectangles.

## SYNOPSYS

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

## PARAMETER

none

## DESCRIPTION

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

## EXAMPLE

```
        #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;
             }
            . . . .
          }
```

## SEE ALSO

**librwi**