Read()
Synopsis
Read a variable.
Description
Reads a #-terminated string of digits a certain number of times from the user in to the given variable.
This application sets the following channel variable upon completion:
READSTATUS- This is the status of the read operation.- OK
- ERROR
- HANGUP
- INTERRUPTED
- SKIPPED
- TIMEOUT
Syntax
Read(variable,filename&[filename2[&...]],[maxdigits,[options,[attempts,[timeout]]]]])
Arguments
variable- The input digits will be stored in the given variable name.filenamesfilename- file(s) to play before reading digits or tone with option ifilename2
maxdigits- Maximum acceptable number of digits. Stops reading after maxdigits have been entered (without requiring the user to press the#key).
Defaults to0- no limit - wait for the user press the#key. Any value below0means the same. Max accepted value is255.optionss- to return immediately if the line is not up.i- to play filename as an indication tone from yourindications.conf.n- to read digits even if the line is not up.
attempts- If greater than1, that many attempts will be made in the event no data is entered.timeout- The number of seconds to wait for a digit response. If greater than0, that value will override the default timeout. Can be floating point.
See Also
Import Version
This documentation was imported from Asterisk Version SVN-branch-13-r420538