O'Reilly logo

Asterisk: The Future of Telephony by Leif Madsen, Jared Smith, Jim Van Meggelen

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

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 to 0- (no limit, wait for the user to press the # key). Any value below 0 means the same. The maximum accepted value is 255.

option

Specify skip to return immediately if the line is not answered, or noanswer 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

SendDTMF()

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required