debian man page for load_sample

load_sample(3alleg4)						  Allegro manual					      load_sample(3alleg4)

NAME
       load_sample - Loads a sample from a file. Allegro game programming library.

SYNOPSIS
       #include <allegro.h>

       SAMPLE *load_sample(const char *filename);

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:

	  SAMPLE *sample = load_sample(user_input);
	  if (!sample)
	     abort_on_error("Couldn't load sample!");

RETURN VALUE
       Returns a pointer to the SAMPLE or NULL on error. Remember to free this sample later to avoid memory leaks.

SEE ALSO
       destroy_sample(3alleg4),    load_voc(3alleg4),	  load_wav(3alleg4),	 play_sample(3alleg4),	   save_sample(3alleg4),     register_sam-
       ple_file_type(3alleg4), exsample(3alleg4)

Allegro 							   version 4.4.2					      load_sample(3alleg4)