set_callback
Description:
public bool set_callback (MainContext? context, WorkerCallback? callback) throws Error
Declare a callback function to be called when a job has been processed.
If callback
is null, then any previously effect of this function is removed. If the same
function is called with a different callback
value, then the previous one is simply replaced.
Since this function adds a new source of events to the specified MainContext (or
the default one if context
is null),
Notes: <itemizedlist> <listitem><para>before calling this function, this internally gets
rid of the job, so the jib_id
passed to callback
does not actually designate a known job ID, and so calling
fetch_job_result for that job ID will fail</para></listitem
> <listitem><para>the job's result, if any, has to be freed by callback
(this
does not do it)</para></listitem> <listitem><para>any call to this function will only be honored for the jobs submitted
_after_ calling it, the ones submitted before are not affected</para></listitem> <listitem><para>passing
null for context
is similar to passing the result of
ref_thread_default</para></listitem> <
/itemizedlist>
Parameters:
this |
a Worker object |
context |
a MainContext, or null |
callback |
the function to call when a job submitted from within the calling thread using submit_job has finished being processed. |
user_data |
argument passed to |
Returns:
true if no error occurred. |