.\" Generated by the Allegro makedoc utility
.TH midi_seek 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
midi_seek \- Seeks to the given midi_pos in the current MIDI file. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B int midi_seek(int target);
.SH DESCRIPTION
Seeks to the given midi_pos in the current MIDI file. If the target is 
earlier in the file than the current midi_pos it seeks from the 
beginning; otherwise it seeks from the current position.
.SH "RETURN VALUE"
Returns zero if it could successfully seek to the requested position.
Otherwise, a return value of 1 means it stopped playing, and midi_pos is
set to the negative length of the MIDI file (so you can use this function
to determine the length of a MIDI file). A return value of 2 means the
MIDI file looped back to the start.

.SH SEE ALSO
.BR play_midi (3alleg4),
.BR midi_pos (3alleg4)