---
name: "al_load_sample"
section: "3alleg5"
platform: "linux"
package: "allegro5-doc"
version: "2:5.2.10.1+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/al_load_sample/3alleg5"
---

# al\_load\_sample(3alleg5)

Allegro 5 API

## NAME

al\_load\_sample - Allegro 5 API

## SYNOPSIS

-

  ```
  #include <allegro5/allegro_audio.h>
  ALLEGRO_SAMPLE *al_load_sample(const char *filename)
  ```

## DESCRIPTION

Loads a few different audio file formats based on their extension.

Note that this stores the entire file in memory at once, which may be time consuming. To read the file as it is needed, use al\_load\_audio\_stream(3alleg5) or al\_play\_audio\_stream(3alleg5).

Returns the sample on success, NULL on failure.

*Note:* the allegro\_audio library does not support any audio file formats by default. You must use the allegro\_acodec addon, or register your own format handler.

## SEE ALSO

al\_register\_sample\_loader(3alleg5), al\_init\_acodec\_addon(3alleg5)