set_source_tag


Description:

[ Version ( since = "2.36" ) ]
public void set_source_tag (void* source_tag)

Sets this's source tag.

You can use this to tag a task return value with a particular pointer (usually a pointer to the function doing the tagging) and then later check it using get_source_tag (or is_tagged) in the task's "finish" function, to figure out if the response came from a particular place.

A macro wrapper around this function will automatically set the task’s name to the string form of source_tag if it’s not already set, for convenience.

Parameters:

this

the Task

source_tag

an opaque pointer indicating the source of this task