IVR Software Library
IVR Utility Routine Descriptions
The following routine or parameter is maintained in the PACER and WIZARD IVR software library. These routines are developed for programmers who are creating and managing IVR application programs.
IVR programs can be written in C/C++ on Windows, Unix and Linux operating environments.
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" ***
|
