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

# allocrdsrecwin(3)

allocates a structure used to know windows which contains a rectangle.

## NAME

allocrdsrecwin - allocates a structure used to know windows which contains a rectangle.

## SYNOPSYS

```
#include "rwinnn.h"
 rdsrecwin_list ∗allocrdsrecwin()
```

## PARAMETER

none

## DESCRIPTION

The *allocrdsrecwin* function allocates a rdsrecwin\_list structure item. This structure contains a pointer to a window structure so it permits to chain all windows which contains a same rectangle (see librwi).

## 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"
        # define POINTER_WINDOW(R)                                \
                                                                  \
          (((UserStruct ∗)((char ∗)(R)+sizeof(rdsrec_list)))->WINDOW )
        typedef struct UserStruct
         {
           rdsrecwin_list ∗WINDOW;
         } UserStruct;
        main()
          {
             rdsfig_list ∗Figure;
             rdsrec_list ∗Rectangle;
             rdswin_list ∗Window;
             mbkenv();
             rdsenv();
             loadrdsparam();
             Figure = addrdsfig( "core",sizeof ( UserStruct ) );
             Rectangle =
               addrdsfigrec(Figure,"Alu1",RDS_ALU1,2,4,5,1);
             POINTER_WINDOW (Rectangle) = allocrdsrecwin();
             . . . .
             Window = ...
             (POINTER_WINDOW (Rectangle))->WINDOW = Window;
             . . . .
          }
```

## SEE ALSO

**librwi**