Page 452 - Asterisk™: The Future of Telephony
P. 452

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
                   Zero or more of the following options:
                   s
                       Return immediately if the line is not answered.
                   i
                       Interpret the filename as an indication tone setting from indications.conf.
                   n
                       Read digits even if the line has not been 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.

                   ; 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()


               ReadFile()                                     Reads the contents of a file in to a variable
               ReadFile(variable=filename,length)

               ReadFile captures the contents of filename, with a maximum size of length.
                   ; read the first 80 characters of a file in to a variable
                   exten => 123,1,Answer()
                   exten => 123,n,ReadFile(TEST=/tmp/test.txt,80)
                   exten => 123,n,SayAlpha(${TEST})
               See Also
               System(), Read()


               RealTime                           Looks up information from the RealTime configuration handler

               RealTime(family,colmatch,value[,prefix])

               Uses the RealTime configuration handler system to read data in to channel variables.
               All unique column names (from the specified family) will be set as channel variables,



               424 | Appendix B: Application Reference
   447   448   449   450   451   452   453   454   455   456   457