---
name: "create_sample"
section: "3alleg"
platform: "linux"
package: "liballegro-doc"
version: "2:4.2.2-2.2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/create_sample"
---

# create\_sample(3alleg)

Constructs a new sample structure of the specified type. Allegro game programming library.

## NAME

create\_sample - Constructs a new sample structure of the specified type. Allegro game programming library.

## SYNOPSIS

**#include \<allegro.h\>**

**SAMPLE \*create\_sample(int bits, int stereo, int freq, int len);**

## DESCRIPTION

Constructs a new sample structure of the specified type. Read chapter "Structures and types defined by Allegro" for an internal description of the SAMPLE structure. The \`bits' parameter can be 8 or 16, \`stereo' can be zero for mono samples and non-zero for stereo samples, \`freq' is the frequency in hertz, and \`len' is the number of samples you want to allocate for the full sound buffer.

## RETURN VALUE

Returns a pointer to the created sample, or NULL if the sample could not be created. Remember to free this sample later to avoid memory leaks.

## SEE ALSO

[**load\_sample**(3alleg)](/load_sample/3alleg.md), [**destroy\_sample**(3alleg)](/destroy_sample/3alleg.md)