TaskLocal

Implements a task local storage variable.

Task local variables, similar to thread local variables, exist separately in each task. Consequently, they do not need any form of synchronization when accessing them.

Note, however, that each TaskLocal variable will increase the memory footprint of any task that uses task local storage. There is also an overhead to access TaskLocal variables, higher than for thread local variables, but generelly still O(1) (since actual storage acquisition is done lazily the first access can require a memory allocation with unknown computational costs).

Notice: FiberLocal instances MUST be declared as static/global thread-local variables. Defining them as a temporary/stack variable will cause crashes or data corruption!

struct TaskLocal (

) {

this(T init_val);

this(this);

void opAssign(T value);

T storage [@property getter];

}

Constructors

this this(T init_val): Undocumented in source.

Postblit

this(this) this(this): Undocumented in source.

opAssign void opAssign(T value): Undocumented in source. Be warned that the author may not have intended to support it.

Properties

storage T storage [@property getter]: Undocumented in source. Be warned that the author may not have intended to support it.

Examples

TaskLocal!string s_myString = "world";

void taskFunc()
{
	assert(s_myString == "world");
	s_myString = "hello";
	assert(s_myString == "hello");
}

shared static this()
{
	// both tasks will get independent storage for s_myString
	runTask(&taskFunc);
	runTask(&taskFunc);
}

TaskLocal

Constructors

Postblit

Alias This

Members

Functions

Properties

Examples

Meta

Source