
Lê uma string de dígitos terminada em # um certo número de vezes do usuário e armazena na variável especificada.
Este aplicativo define a seguinte variável de canal após a conclusão:
READSTATUS - Este é o status da operação de leitura:
• OK
• ERROR
• HANGUP
• INTERRUPTED
• SKIPPED
• TIMEOUT
Sintaxe:
Read(variable,filename&[filename2[&...]],[maxdigits,[options,[attempts,[timeout]]]]])
Parâmetros:
• variable - Os dígitos digitados serão armazenados no nome de variável fornecido.
• filenames - Lista separada por e-comercial (&) de nomes de arquivos para tocar antes de ler os dígitos ou tom com a opção 'i'. Se o nome do arquivo for relativo (não começar com barra), será procurado no diretório de sons do Asterisk. Se o nome do arquivo puder ser interpretado como uma URL, o Asterisk fará o download e iniciará a reprodução. Para incluir um '&' literal na URL, você pode envolvê-la em aspas simples.
• maxdigits - Número máximo aceitável de dígitos. Interrompe a leitura após maxdigits serem inseridos (sem exigir que o usuário pressione a tecla '#'). O padrão é '0' - sem limite - aguarda o usuário pressionar '#'. Qualquer valor abaixo de '0' significa o mesmo. Valor máximo aceito é '255'.
• options - Opções disponíveis:
- s - para retornar imediatamente se a linha não estiver ativa.
- i - para tocar o nome do arquivo como um tom de indicação do seu indications.conf.
- n - para ler dígitos mesmo que a linha não esteja ativa.
- t - Dígito(s) terminador(es) a serem usados para finalizar a entrada. O padrão é '#'. Se você precisar ler o dígito '#' literalmente, deve remover ou alterar o caractere terminador. Múltiplos caracteres terminadores podem ser especificados. Se nenhum dígito terminador estiver presente, a entrada não pode ser finalizada usando dígitos e você precisará confiar na duração e no número máximo de dígitos para finalizar a entrada.
- e - para ler o terminador como a string de dígitos se o único dígito lido for o terminador. Isso é para casos onde o terminador é um dígito válido, mas apenas por si só. Ex: '1234' e '#' são válidos, mas '1234#' não é.
• attempts - Se maior que '1', essa quantidade de tentativas será feita no caso de nenhum dado ser inserido.
• timeout - O número de segundos para aguardar uma resposta de dígito. Se maior que '0', esse valor substituirá o tempo limite padrão. Pode ser um valor decimal.

