NAME

remove_call_out() - remove a pending call_out

SYNOPSIS

int remove_call_out( string fun );
int remove_call_out( int handle );
int remove_call_out();

DESCRIPTION

In  the  first form this function removes the next pending call out for
function <fun> in the current object.  The return  value  is the number
of  seconds  remaining  before  the callback was to be called, or -1 if
there was no call out pending to this function.

In the second form, this function removes a pending call out identified
by  the  <handle>  returned  from the  call_out()  function. The return
value is the number of remaining seconds before the call_out was to  be
called,  or -1  if  there  was  no  valid  call_out  identified  by the
specified <handle>.

In the third form all pending call outs for the current object will be
removed. In this case the return value is always 0.

SEE ALSO

call_out, call_out_info, call_out_walltime