Skip to end of metadata
Go to start of metadata

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[,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.
    • t - Terminator digit(s) to use for ending input. Default is #. If you need to read the digit # literally, you should remove or change the terminator character. Multiple terminator characters may be specified. If no terminator digit is present, input cannot be ended using digits and you will need to rely on duration and max digits for ending input.
  • 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

Import Version

This documentation was imported from Asterisk Version GIT-16-c5c5171

  • No labels

1 Comment

  1. 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.

    The default timeout in this case seems to be the value of TIMEOUT(response), not TIMEOUT(digit).