.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "al_set_sample_instance_length" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_set_sample_instance_length - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro_audio.h>

bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl,
   unsigned int val)
\f[R]
.fi
.SH DESCRIPTION
.PP
Set the length of the sample instance in sample values.
This can be used to play only parts of the underlying sample.
Be careful not to exceed the actual length of the sample data, though.
.PP
Return true on success, false on failure.
Will fail if the sample instance is currently playing.
.SH SEE ALSO
.PP
al_get_sample_instance_length(3alleg5)