{{DISPLAYTITLE:_SNDGETPOS}}
The [[_SNDGETPOS]] function returns the current playing position in seconds using a handle from [[_SNDOPEN]].


{{PageSyntax}}
:{{Parameter|position}} = [[_SNDGETPOS]]({{Parameter|handle&amp;}})


{{PageDescription}}
*Returns the current playing position in seconds from an open sound file.
*If a sound isn't playing, it returns 0.
*If a sound is paused, it returns the paused position.
*For a looping sound, the value returned continues to increment and does not reset to 0 when the sound loops.
* In versions '''prior to build 20170811/60''', the sound identified by {{Parameter|handle&amp;}} must have been opened using the [[_SNDOPEN|"SETPOS" capability]] to use this function.


{{PageExamples}}
''Example:'' To check the current playing position in an MP3 file, use [[_SNDPLAY]] with [[_SNDGETPOS]] printed in a loop:
{{CodeStart}} '' ''
SoundFile&amp; = {{Cl|_SNDOPEN}}("YourSoundFile.mp3") '&lt;&lt;&lt; your MP3 sound file here!
{{Cl|_SNDSETPOS}} SoundFile&amp;, 5.5   'set to play sound 5 1/2 seconds into music 
{{Cl|_SNDPLAY}} SoundFile&amp;  'play sound 
Do: {{Cl|_LIMIT}} 60     
   LOCATE 5, 2: PRINT "Current play position> "; {{Cl|_SNDGETPOS}}(SoundFile&amp;)
LOOP UNTIL {{Cl|_KEYDOWN}}(27) OR {{Cl|NOT}} {{Cl|_SNDPLAYING}}(SoundFile&amp;) 'ESC or end of sound exit
{{CodeEnd}}


{{PageSeeAlso}}
* [[_SNDSETPOS]]
* [[_SNDOPEN]]


{{PageNavigation}}
<
