declares the symbols si as shared variables whose values are synchronized among all parallel kernels.


  • The unique value of a shared variable is maintained by the master kernel and every access on a parallel subkernel is synchronized through the master kernel.
  • Shared variables without a value evaluate to Null.


open allclose all

Basic Examples  (1)

Make xs be a (global) shared variable:

Each subkernel increments the (global) shared variable value:

Without sharing, each subkernel has its own (local) copy of the variable:

Scope  (4)

Share a single value:

Access a single element of a shared list efficiently:

Assign a new value to a shared variable:

Only the last assignment performed remains:

Change a single element of a shared list:

Update the value of a shared variable:

Append to a shared list:

Append to an element of a shared list:

Generalizations & Extensions  (1)

Delayed values defined on the master kernel are evaluated on the master kernel:

Delayed values defined on a subkernel are evaluated on the kernel asking for the value:

Applications  (5)

Use shared variables to synchronize input and output in an infinite search:

Find such that is prime, until the computation is manually aborted:

Use a shared variable to signal all evaluations to stop as soon as a prime has been found:

Use a shared variable to hand out tasks to do:

Monitor the progress of a calculation, counting major calculation steps:

Return results as they are found:

Watch the results appear in real time:

Properties & Relations  (1)

$KernelCount is effectively a shared variable:

Possible Issues  (2)

Separate read and write operations are not thread-safe:

Use atomic updates for synchronization:

Alternatively, use CriticalSection to make a whole code section atomic:

Create a shared variable whose value is a large matrix:

Accessing its elements causes the whole matrix to be transferred to the subkernels repeatedly:

Use Unevaluated to allow the special code for parts of shared variables to see the variable:

Wolfram Research (2008), SetSharedVariable, Wolfram Language function,


Wolfram Research (2008), SetSharedVariable, Wolfram Language function,


@misc{reference.wolfram_2020_setsharedvariable, author="Wolfram Research", title="{SetSharedVariable}", year="2008", howpublished="\url{}", note=[Accessed: 03-December-2020 ]}


@online{reference.wolfram_2020_setsharedvariable, organization={Wolfram Research}, title={SetSharedVariable}, year={2008}, url={}, note=[Accessed: 03-December-2020 ]}


Wolfram Language. 2008. "SetSharedVariable." Wolfram Language & System Documentation Center. Wolfram Research.


Wolfram Language. (2008). SetSharedVariable. Wolfram Language & System Documentation Center. Retrieved from