This page last changed on Mar 30, 2011 by wikibot.
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
Arguments
- variable - The input digits will be stored in the given variable name.
- filenames
- filename - file(s) to play before reading digits or tone with option i
- filename2
- maxdigits - Maximum acceptable number of digits. Stops reading after maxdigits have been entered (without requiring the user to press the # key). Defaults to 0 - no limit - wait for the user press the # key. Any value below 0 means the same. Max accepted value is 255.
- options
- s - to return immediately if the line is not up.
- i - to play filename as an indication tone from your indications.conf.
- n - to read digits even if the line is not up.
- attempts - If greater than 1, 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 than 0, that value will override the default timeout. Can be floating point.
See Also
Application_SendDTMF
Import Version
This documentation was imported from Asterisk version SVN-branch-1.8-r311874.
|