|
|
IVR Software Library
ivr_speak_time
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_speak_time.
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_speak_time()
int
ivr_speak_time(int call, char* text_time, int allow_interrupt);
The
ivr_speak_time function speaks a time given to the specified call.
Parameters
|
int
|
call
|
Specifies which call to speak to.
It can be one of the following values.
CALL_PRIMARY: Speak to Primary Call
CALL_SECONDARY: Speak to Secondary Call
|
|
char*
|
text_time
|
time to speak
|
|
int
|
allow_interrupt
|
Specifies if a digit can interrupt the
time.
It can be one of the following values.
NO_INTERRUPT: Do not allow reading to be interrupted by a digit
INTERRUPT: Allow reading to be interrupted by a digit
|
Return Value
Returns
IVR_SUCCESS on a successful function call. On error the function returns one
of the IVR
Error Codes.
Examples
ivr_speak_time(CALL_PRIMARY, "11:57 PM",
NO_INTERRUPT);
ivr_speak_time(CALL_PRIMARY, "15:35", NO_INTERRUPT);
ivr_speak_time(CALL_PRIMARY, "1:23", NO_INTERRUPT);
ivr_speak_time(CALL_PRIMARY, "5 a.m.", NO_INTERRUPT);
ivr_speak_time(CALL_PRIMARY, "4 Pm", NO_INTERRUPT);
*** Hours and Minutes must be delineated ... not like: "357" ***
*** Hours 1 to 12 are assumed am unless otherwise specified with "PM"
***
*** If times are illogical (15:32 AM) the hours will override the
"AM" ***
|
|
