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

# autallocheap(3)

heap memory allocator

## NAME

autallocheap - heap memory allocator

## SYNOPSYS

```
#include "aut101.h"
char *autallocheap( Size )
   unsigned int Size;
```

## PARAMETERS

- *Size*

  Number of memory bytes to be contiguously allocated

## DESCRIPTION

**autallocheap** returns a block of *Size* bytes length, allocated on the heap. The memory block is set to zero. Its use is strongly encouraged when the *Size* is very small.\

## RETURN VALUE

**autallocheap** returns a pointer to a *Size* bytes long block.

## ERRORS

**"autalloc: alloc error, can't continue !"**

System break can't be moved anymore, no more memory can be retrieved from the system.

## EXAMPLE

```
#include "aut101.h"
typedef struct bipointer
{
  struct bipointer ∗NEXT;
  void             ∗DATA;
} bipointer;
bipointer ∗addbipointer( Data );
  void ∗Data;
{
  bipointer ∗Bp = (bipointer ∗)autallocheap( sizeof( bipointer ) );
  Bp->DATA = Data; return Bp;
}
```

## SEE ALSO

**[aut(1)](/aut/1.md),** **[autresizeblock(3)](/autresizeblock/3.md),** **[autallocblock(3)](/autallocblock/3.md),** **[autfreeblock(3)](/autfreeblock/3.md),** **[autfreeheap(3)](/autfreeheap/3.md).**