Skip to main content
Version: v4 (Stable)

GETDTMFSTRING

GETDTMFSTRING(nLength AS INTEGER, nTimeout AS INTEGER, sDTMFString AS STRING [, sEscape AS STRING]) AS INTEGER

Returns a DTMF string <sDTMFString> of length <nLength>.

The function waits until the requested number of characters has been reached or at the end of the <nTimeout> in seconds or until an escape char has been typed in. The escape chars are given by the <sEscape> parameter.

If the <sDTMFString> contains the requested number of DTMF, the function returns 1; if an escape char is detected, it returns 2. The function returns 0 on the timeout, -1 when line is hung-up, -3 if the second call of a telephony transfer is hung-up.