|
|
IVR Software Library
ivr_get_digits
Database Systems Corp. (DSC) provides an API subroutine library of IVR Software routines that perform phone functions The following is a description of one of the functions within this library that controls the IVR operation - ivr_get_digits.
The routine is from our C programming library, although this same routine has an equivalent for Visual Basic, .NET, C++ and Active-X. DSC provides a separate user guide for each of these languages.
Contact DSC to obtain the most current IVR manuals in your required programming language.
ivr_get_digits()
int
ivr_get_digits(int call, int max_digits, int timeout, char termchar, int clear,
IVRDIGITS *ivrd)
The
ivr_get_digits function waits for digits to be entered from the
specified call.
Parameters
|
int
|
call
|
Specifies
which call to retrieve digits from. It can be one of the following values.
CALL_PRIMARY: Collect Digits from the Primary Call
CALL_SECONDARY: Collect Digits from the Secondary Call
|
|
int
|
max_digits
|
The maximum number of digits to return. This must be less
than 32.
|
|
int
|
timeout
|
The maximum amount of time in seconds to wait for the
digits to be entered.
|
|
char
|
termchar
|
A specific character to terminate digit collection.
|
|
int
|
clear
|
Clear the buffer before digit collection. It can be one of
the following values.
NO_CLEAR: Do NOT clear the buffer before digit collection
CLEAR: Clear the buffer before digit collection
|
|
IVRDIGITS *
|
ivrd
|
Structure of type IVRDIGITS
in which the digits will be returned.
|
Return Value
Return
IVR_SUCCESS on a successful function call. On error the function returns one
of the IVR Error Codes.
Example
IVRDIGITS ivrd; if(ivr_get_digits(CALL_PRIMARY,3,10,'*',CLEAR,&ivrd) != IVR_SUCCESS){ ...handle error; }
|
|
