Name
Read() — Reads DTMF digits from the caller and assign the result to a variable
Synopsis
Read(variable
[,filename
][,maxdigits
][,option
][,attempts
][,timeout
])
Reads a #
-terminated string
of digits a certain number of times from the user into the given
variable
.
Other arguments include:
filename
Specifies the file to play before reading digits.
maxdigits
Sets the maximum acceptable number of digits. If this argument is specified, the application stops reading after
maxdigits
have been entered (without requiring the user to press the#
key). Defaults to0-
(no limit, wait for the user to press the#
key). Any value below0
means the same. The maximum accepted value is255
.option
Specify
skip
to return immediately if the line is not answered, ornoanswer
to read digits even if the line is not answered.attempts
If greater than
1
, that many attempts will be made in the event that no data is entered.timeout
If greater than
0
, that value will override the default timeout.
Returns -1
on hangup or error
and 0
otherwise.
; read a two-digit number and repeat it back to the caller
exten => 123,1,Read(NUMBER,,2)
exten => 123,2,SayNumber(${NUMBER})
exten => 123,3,Goto(1)
See Also
Get Asterisk: The Future of Telephony now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.