X hits on this document





225 / 396


10.4.3 Volatile fields

When a field-declaration includes a volatile modifier, the fields introduced by that declaration are volatile fields.

For non-volatile fields, optimization techniques that reorder instructions can lead to unexpected and unpredictable results in multi-threaded programs that access fields without synchronization such as that provided by the lock-statement (§‎8.12). These optimizations can be performed by the compiler, by the runtime system, or by hardware. For volatile fields, such reordering optimizations are restricted:

A read of a volatile field is called a volatile read. A volatile read has “acquire semantics”; that is, it is guaranteed to occur prior to any references to memory that occur after it in the instruction sequence.

A write of a volatile field is called a volatile write. A volatile write has “release semantics”; that is, it is guaranteed to happen after any memory references prior to the write instruction in the instruction sequence.

These restrictions ensure that all threads will observe volatile writes performed by any other thread in the order in which they were performed. A conforming implementation is not required to provide a single total ordering of volatile writes as seen from all threads of execution. The type of a volatile field must be one of the following:

A reference-type.

The type byte, sbyte, short, ushort, int, uint, char, float, or bool.

An enum-type having an enum base type of byte, sbyte, short, ushort, int, or uint.

The example

using System; using System.Threading;

class Test { public static int result;    public static volatile bool finished;

static void Thread2() { result = 143;     finished = true; }

static void Main() { finished = false;

// Run Thread2() in a new thread new Thread(new ThreadStart(Thread2)).Start();

// Wait for Thread2 to signal that it has a result by setting // finished to true. for (;;) { if (finished) { Console.WriteLine("result = {0}", result); return; } } } }

produces the output:

result = 143

In this example, the method Main starts a new thread that runs the method Thread2. This method stores a value into a non-volatile field called result, then stores true in the volatile field finished. The main thread waits for

212Copyright Microsoft Corporation 1999-2003. All Rights Reserved.

Document info
Document views599
Page views599
Page last viewedWed Oct 26 02:17:22 UTC 2016