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

# allocrdswindow(3)

allocates a window structure

## NAME

allocrdswindow - allocates a window structure

## SYNOPSYS

```
#include "rwinnn.h"
 rdswindow ∗allocrdswindow()
```

## PARAMETER

none

## DESCRIPTION

The *allocrdswindow* allocates a window structure (rdswindow) which is used to create an ´object´ window (see librwi). It contains fields information about the window's table and the pointer to the window's table. It's the head of windowing.

## RETURN VALUE

The pointer to the rdswindow structure allocated 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()
          {
            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,** **buildrdswindow,** **destroyrdswindow,** **viewrdswindow**