.\"find first call_out due to be executed for a given function
.DT
find_call_out
$MUDNAME$ driver help
find_call_out

.SH Name
.SI 5
find_call_out() - find a call out scheduled to be called next
.EI

.SH Synopsis
.SI 5
int find_call_out( string func ):
.EI

.SH Description
.SP 5 5
Find the first call out due to be executed for function `func', and
return the time left.  If it is not found, then return -1.

WARNING!  The returned value is wrong in some situations!
.EP

.SH See also
.SI 5
call_out(), remove_call_out(), set_heart_beat()
.EI
