.\" Generated by the Allegro makedoc utility
.TH load_sample 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
load_sample \- Loads a sample from a file. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B SAMPLE *load_sample(const char *filename);
.SH DESCRIPTION
Loads a sample from a file, supporting both mono and stereo WAV and mono
VOC files, in 8 or 16-bit formats, as well as formats handled by functions
registered using register_sample_file_type(). Example:

.nf
   SAMPLE *sample = load_sample(user_input);
   if (!sample)
      abort_on_error("Couldn't load sample!");
.fi
.SH "RETURN VALUE"
Returns a pointer to the SAMPLE or NULL on error. Remember to free this
sample later to avoid memory leaks.

.SH SEE ALSO
.BR destroy_sample (3alleg4),
.BR load_voc (3alleg4),
.BR load_wav (3alleg4),
.BR play_sample (3alleg4),
.BR save_sample (3alleg4),
.BR register_sample_file_type (3alleg4),
.BR exsample (3alleg4)