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

Read(variable[,filename[&filename2[&...]][,maxdigits[,options[,attempts[,timeout]]]]])
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.

Document generated by Confluence on Oct 04, 2011 12:42