---
name: "tickit_rectset_new"
section: "3"
platform: "linux"
package: "libtickit-dev"
version: "0.4.3-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tickit_rectset_new"
---

# tickit\_rectset\_new(3)

create or destroy a rectangle set

## NAME

tickit\_rectset\_new, tickit\_rectset\_destroy - create or destroy a rectangle set

## SYNOPSIS

```
#include <tickit.h>

TickitRectSet *tickit_rectset_new(void);
void tickit_rectset_destroy(TickitRectSet *trs);
```

Link with *-ltickit*.

## DESCRIPTION

**tickit\_rectset\_new**() creates a new **TickitRectSet** instance. It will be initially empty, containing no regions.

**tickit\_rectset\_destroy**() destroys the given instances and releases any resources controlled by it.

## RETURN VALUE

If successful, **tickit\_rectset\_new**() returns a pointer to the new instance. On failure, **NULL** is returned with *errno* set to indicate the failure. **tickit\_rectset\_destroy**() returns no value.

## SEE ALSO

[**tickit\_rectset\_add**(3)](/tickit_rectset_add/3.md), [**tickit\_rectset\_subtract**(3)](/tickit_rectset_subtract/3.md), [**tickit\_rectset\_rects**(3)](/tickit_rectset_rects/3.md), [**tickit\_rectset\_get\_rects**(3)](/tickit_rectset_get_rects/3.md), [**tickit\_rectset**(7)](/tickit_rectset/7.md), [**tickit**(7)](/tickit/7.md)