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

.sp
.B int save_sample(const char *filename, SAMPLE *spl);
.SH DESCRIPTION
Writes a sample into a file. The output format is determined from the
filename extension. At present Allegro does not natively support the
writing of any sample formats, so you must register a custom saver routine
with register_sample_file_type(). Example:

.nf
   if (save_sample("sound.wav", sample) != 0)
      abort_on_error("Couldn't save sample!");
.fi
.SH "RETURN VALUE"
Returns zero on success, non-zero otherwise.

.SH SEE ALSO
.BR load_sample (3alleg4),
.BR register_sample_file_type (3alleg4)