diff options
Diffstat (limited to 'libgo/go/sync/once.go')
-rw-r--r-- | libgo/go/sync/once.go | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/libgo/go/sync/once.go b/libgo/go/sync/once.go new file mode 100644 index 000000000..8c877cdec --- /dev/null +++ b/libgo/go/sync/once.go @@ -0,0 +1,35 @@ +// Copyright 2009 The Go Authors. All rights reserved. +// Use of this source code is governed by a BSD-style +// license that can be found in the LICENSE file. + +package sync + +// Once is an object that will perform exactly one action. +type Once struct { + m Mutex + done bool +} + +// Do calls the function f if and only if the method is being called for the +// first time with this receiver. In other words, given +// var once Once +// if Do(f) is called multiple times, only the first call will invoke f, +// even if f has a different value in each invocation. A new instance of +// Once is required for each function to execute. +// +// Do is intended for initialization that must be run exactly once. Since f +// is niladic, it may be necessary to use a function literal to capture the +// arguments to a function to be invoked by Do: +// config.once.Do(func() { config.init(filename) }) +// +// Because no call to Do returns until the one call to f returns, if f causes +// Do to be called, it will deadlock. +// +func (o *Once) Do(f func()) { + o.m.Lock() + defer o.m.Unlock() + if !o.done { + o.done = true + f() + } +} |