Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dispatch_after(3)	    Library Functions Manual	     dispatch_after(3)

NAME
       dispatch_after -- schedule blocks for deferred execution

SYNOPSIS
       #include	<dispatch/dispatch.h>

       void
       dispatch_after(dispatch_time_t when,	       dispatch_queue_t	queue,
	   void	(^block)(void));

       void
       dispatch_after_f(dispatch_time_t	when,	       dispatch_queue_t	queue,
	   void	*context, void (*function)(void	*));

DESCRIPTION
       The  dispatch_after()  function submits the block to the	given queue at
       the time	specified by the when parameter.   The	when  parameter	 is  a
       value created by	dispatch_time()	or dispatch_walltime().	 Submission of
       the  block  may be delayed by the system	in order to improve power con-
       sumption	and system performance.	 The  system  applies  a  leeway  (see
       dispatch_source_set_timer(3))  that is equal to one tenth of the	inter-
       val between when	and the	time at	which the function is called, with the
       leeway capped to	at least one millisecond and at	most one minute.

       For a more detailed description about submitting	blocks to queues,  see
       dispatch_async(3).

CAVEATS
       dispatch_after()	retains	the passed queue.

       Specifying DISPATCH_TIME_NOW as the when	parameter is supported,	but is
       not as efficient	as calling dispatch_async().

       The  result  of	passing	DISPATCH_TIME_FOREVER as the when parameter is
       undefined.

FUNDAMENTALS
       The dispatch_after() function is	a wrapper around dispatch_after_f().

SEE ALSO
       dispatch(3), dispatch_async(3), dispatch_time(3)

Darwin				  May 1, 2009		     dispatch_after(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dispatch_after&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help