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

# allocrdswin(3)

allocates window's table

## NAME

allocrdswin - allocates window's table

## SYNOPSYS

```
#include "rwinnn.h"
 rdswin_list ∗allocrdswin( Number )
    unsigned int Number;
```

## PARAMETER

- *Number*

  Number of windows contained in the window's table.

## DESCRIPTION

The *allocrdswin* allocates a window's table. The number of windows is specified by the parameter ´Number´ of the function. To determine the size of the parameter ´Number´, the user has to multiplicate width by height of his table in number of windows. Each item of the table is a pointer to a rdswin\_list structure which contains rectangles sorted by layer (see librwi).

## RETURN VALUE

The pointer to the table is returned.

## ERRORS

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

it's impossible to allocate the memory size for the table

## EXAMPLE

```
        #include "mutnnn.h"
        #include "rdsnnn.h"
        #include "rwinnn.h"
        #include "rtlnnn.h"
        main()
          {
            rdswindow ∗RdsWindow;
            RdsWindow = allocrdswindow();
            RdsWindow->XMIN = -200;
            RdsWindow->YMIN = -200;
            RdsWindow->XMAX =  200;
            RdsWindow->YMAX =  200;
            RdsWindow->DX   =  4;
            RdsWindow->DY   =  4;
            RdsWindow->SIDE =  100;
            RdsWindow->SIZE =  RdsWindow->DX ∗ RdsWindow->DY ;
            RdsWindow->WINTAB = allocrdswin( RdsWindow->SIZE );
            . . .
          }
```

## SEE ALSO

**librwi**