PLAY (function)

The PLAY function returns the number of remaining notes in the background music queue.

Syntax

notesLeft& = PLAY (ignored%)

Parameters

• notesLeft& is the number of notes left to play in the background music queue.
  • In QB64-PE this is the number of audio samples left to play in the background music queue.

• ignored% can be any numeric expression. This is ignored.

Description

• Use this to detect if the background music queue is still playing.
• Unlike QuickBASIC, this does not return the number of notes left but the number of audio samples.
• When there is nothing left to play, this returns zero.

Availability

• QB64-PE v3.1 and up (QB64 Phoenix Edition)

Examples

PLAY "mb l4cf.l8el4fag.l8fl4gl8agl4f.l8fl4a>cl2dl4dl4c.<l8al4afg.l8fl4gl8agl4f.l8dl4dcl2f>l4dc.<l8al4afg.l8fl4g>dc.<l8al4a>cl2dl4dc.<l8al4afg.l8fl4gl8agl4f.l8dl4dcl1f" PRINT "Playing tune..." DO playLeft& = PLAY(0) LOCATE , 1: PRINT "Left to play ="; playLeft&; " "; LOOP WHILE playLeft& PRINT: PRINT "And we are done!" END

See also

• PLAY (statement)
• SOUND
• BEEP
• _SNDOPEN (play sound files)
• _SNDRAW (play frequency waves)

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage Report a broken link