.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.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)