[boost-doc-zh commit] r243 - 修复升级至1.38.0版本时对 thread 译文的错误覆

From: codesite-noreply@xxxxxxxxxx
To: boost-doc-zh-notify@xxxxxxxxxxxxx
Date: Mon, 20 Apr 2009 03:35:33 +0000

Author: alai04
Date: Sun Apr 19 20:16:56 2009
New Revision: 243

Modified:
   trunk/doc/html/thread.html
   trunk/doc/html/thread/changes.html
   trunk/doc/html/thread/synchronization.html
   trunk/doc/html/thread/thread_local_storage.html
   trunk/doc/html/thread/thread_management.html
   trunk/doc/html/thread/time.html
   trunk/libs/libraries.htm

Log:
修复升级至1.38.0版本时对 thread 译文的错误覆

Modified: trunk/doc/html/thread.html
==============================================================================
--- trunk/doc/html/thread.html  (original)
+++ trunk/doc/html/thread.html  Sun Apr 19 20:16:56 2009
@@ -1,114 +1,100 @@
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Chapter 19. Thread</title>
-<link rel="stylesheet" href="boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">

-<link rel="start" href="index.html" title="The Boost C++ LibrariesBoostBook Documentation Subset">-<link rel="up" href="libraries.html" title="Part I. The Boost C++Libraries (BoostBook Subset)">

-<link rel="prev" href="string_algo/credits.html" title="Credits">

-<link rel="next" href="thread/changes.html" title="Changes since boost1.35">

-</head>

-<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

-<table cellpadding="2" width="100%"><tr>

-<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../boost.png"></td>

-<td align="center"><a href="../../index.html">Home</a></td>
-<td align="center"><a href="../../libs/libraries.htm">Libraries</a></td>

-<td align="center"><ahref="http://www.boost.org/users/people.html";>People</a></td>-<td align="center"><ahref="http://www.boost.org/users/faq.html";>FAQ</a></td>

-<td align="center"><a href="../../more/index.htm">More</a></td>
-</tr></table>
-<hr>
-<div class="spirit-nav">

-<a accesskey="p" href="string_algo/credits.html"><imgsrc="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u"href="libraries.html"><img src="../../doc/html/images/up.png"alt="Up"></a><a accesskey="h" href="index.html"><imgsrc="../../doc/html/images/home.png" alt="Home"></a><a accesskey="n"href="thread/changes.html"><img src="../../doc/html/images/next.png"alt="Next"></a>

-</div>
-<div class="chapter" lang="en">
-<div class="titlepage"><div>
-<div><h2 class="title">
-<a name="thread"></a>Chapter 19. Thread</h2></div>
-<div><div class="authorgroup"><div class="author"><h3 class="author">

-Anthony <spanclass="surname">Williams

-</h3></div></div></div>
-<div><p class="copyright">Copyright   2007 -8 Anthony Williams</p></div>
-<div><div class="legalnotice">
-<a name="id4040732"></a><p>

- Distributed under the Boost Software License, Version 1.0. (Seeaccompanying- file LICENSE_1_0.txt or copy at <ahref="http://www.boost.org/LICENSE_1_0.txt";target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)

-      </p>
-</div></div>
-</div></div>
-<div class="toc">
-<p><b>Table of Contents</b></p>
-<dl>

-<dt><a href="thread.html#thread.overview">Overview</a></dt>-<dt><a href="thread/changes.html"> Changes sinceboost 1.35</a></dt>-<dt><a href="thread/thread_management.html"> ThreadManagement</a></dt>

-<dd><dl>

-<dt><ahref="thread/thread_management.html#thread.thread_management.thread"> Class<code class="computeroutput"><spanclass="identifier">thread</code></a></dt>-<dt><ahref="thread/thread_management.html#thread.thread_management.this_thread">Namespace <code class="computeroutput"><spanclass="identifier">this_thread</code></a></dt>-<dt><ahref="thread/thread_management.html#thread.thread_management.threadgroup">Class <code class="computeroutput"><spanclass="identifier">thread_group</code></a></dt>

-</dl></dd>

-<dt><a href="thread/synchronization.html">Synchronization</a></dt>

-<dd><dl>

-<dt><ahref="thread/synchronization.html#thread.synchronization.mutex_concepts">Mutex Concepts</a></dt>-<dt><ahref="thread/synchronization.html#thread.synchronization.locks"> LockTypes</a></dt>-<dt><ahref="thread/synchronization.html#thread.synchronization.lock_functions">Lock functions</a></dt>-<dt><ahref="thread/synchronization.html#thread.synchronization.mutex_types">Mutex Types</a></dt>-<dt><ahref="thread/synchronization.html#thread.synchronization.condvar_ref">Condition Variables</a></dt>-<dt><ahref="thread/synchronization.html#thread.synchronization.once"> One-timeInitialization</a></dt>-<dt><ahref="thread/synchronization.html#thread.synchronization.barriers">Barriers</a></dt>

-</dl></dd>

-<dt><ahref="thread/thread_local_storage.html">Thread Local Storage</a></dt>-<dd><dl><dt><ahref="thread/thread_local_storage.html#thread.thread_local_storage.thread_specific_ptr">Class- <code class="computeroutput"><spanclass="identifier">thread_specific_ptr</code></a></dt></dl></dd>-<dt><a href="thread/time.html"> Date and TimeRequirements</a></dt>

-<dd><dl>

-<dt><ahref="thread/time.html#thread.time.system_time"> Typedef <codeclass="computeroutput"><spanclass="identifier">system_time</code></a></dt>-<dt><ahref="thread/time.html#thread.time.get_system_time"> Non-member function<code class="computeroutput"><spanclass="identifier">get_system_time<spanclass="special">()</code></a></dt>

-</dl></dd>

-<dt><a href="thread/acknowledgements.html">Acknowledgments</a></dt>

-</dl>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">

-<a name="thread.overview"></a><a class="link"href="thread.html#thread.overview" title="Overview"> Overview</a>

-</h2></div></div></div>
-<p>

- Boost.Thread enables theuse of multiple threads- of execution with shared data in portable C++ code. It providesclasses and- functions for managing the threads themselves, along with others forsynchronizing- data between the threads or providing separate copies of dataspecific to individual

-      threads.
-    </p>
-<p>

- The Boost.Thread librarywas originally written- and designed by William E. Kempf. This version is a major rewritedesigned- to closely follow the proposals presented to the C++ StandardsCommittee, in- particular <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2497.html";target="_top">N2497</a>,- <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2320.html";target="_top">N2320</a>,- <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2184.html";target="_top">N2184</a>,- <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2006/n2139.html";target="_top">N2139</a>,- and <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2006/n2094.html";target="_top">N2094</a>

-    </p>
-<p>

- In order to use the classes and functions described here, you caneither include- the specific headers specified by the descriptions of each class orfunction,

-      or include the master thread library header:
-    </p>

-<pre class="programlisting">#include<boost<spanclass="special">/thread<spanclass="special">.hpp<spanclass="special">>

-</pre>
-<p>
-      which includes all the other headers in turn.
-    </p>
-</div>
-</div>

-<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

-<td align="left"></td>
-<td align="right"><div class="copyright-footer"></div></td>
-</tr></table>
-<hr>
-<div class="spirit-nav">

-</div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+

+<title>Chapter 19. Thread</title><link rel="stylesheet"href="boostbook.css" type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">

+<link rel="start" href="index.html" title="The Boost C++ LibrariesBoostBook Documentation Subset">+<link rel="up" href="libraries.html" title="Part I. The BoostC++ Libraries (BoostBook Subset)">

+<link rel="prev" href="string_algo/credits.html" title="Credits">

+<link rel="next" href="thread/changes.html" title="Changes since boost1.35"></head>+<body alink="#0000ff" bgcolor="white" link="#0000ff" text="black"vlink="#840084">

+<table cellpadding="2" width="100%"><tbody><tr>

+<td valign="top"><img alt="Boost C++ Libraries" src="../../boost.png"height="86" width="277"></td>

+<td align="center"><a href="../../index.html">Home</a></td>
+<td align="center"><a href="../../libs/libraries.htm">Libraries</a></td>

+<td align="center"><ahref="http://www.boost.org/users/people.html";>People</a></td>+<td align="center"><ahref="http://www.boost.org/users/faq.html";>FAQ</a></td>

+<td align="center"><a href="../../more/index.htm">More</a></td>
+</tr></tbody></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="string_algo/credits.html"><imgsrc="../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u"href="libraries.html"><img src="../../doc/html/images/up.png"alt="Up"></a><a accesskey="h" href="index.html"><imgsrc="../../doc/html/images/home.png" alt="Home"></a><a accesskey="n"href="thread/changes.html"><img src="../../doc/html/images/next.png"alt="Next"></a>

+</div>
+<div class="chapter" lang="en">
+<div class="titlepage"><div>
+<div><h2 class="title">
+<a name="thread"></a>Chapter&nbsp;19.&nbsp;Thread</h2></div>
+<div><div class="authorgroup"><div class="author"><h3 class="author">

+Anthony <spanclass="surname">Williams

+</h3></div></div></div>
+<div><p class="copyright">Copyright (c) 2007 -8 Anthony Williams</p></div>
+<div><div class="legalnotice">
+<a name="id3714602"></a><p>

+ Distributed under the Boost Software License, Version 1.0. (Seeaccompanying+ file LICENSE_1_0.txt or copy at <ahref="http://www.boost.org/LICENSE_1_0.txt";target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)

+      </p>
+</div></div>
+</div></div>
+<div class="toc">
+<p><b>Table of Contents 目录</b></p>
+<dl>

+<dt><a href="thread.html#thread.overview"> Overview简介</a></dt>+<dt><a href="thread/changes.html"> Changes sinceboost 1.35  boost 1.35后的变化</a></dt>+<dt><a href="thread/thread_management.html"> ThreadManagement 线程管理</a></dt>

+<dd><dl>

+<dt><ahref="thread/thread_management.html#thread.thread_management.thread"> Class<code class="computeroutput"><spanclass="identifier">thread</code></a></dt>+<dt><ahref="thread/thread_management.html#thread.thread_management.this_thread">Namespace <code class="computeroutput"><spanclass="identifier">this_thread</code></a></dt>+<dt><ahref="thread/thread_management.html#thread.thread_management.threadgroup">Class <code class="computeroutput"><spanclass="identifier">thread_group</code></a></dt>

+</dl></dd>

+<dt><a href="thread/synchronization.html">Synchronization 同步处理</a></dt>

+<dd><dl>

+<dt><ahref="thread/synchronization.html#thread.synchronization.mutex_concepts">Mutex Concepts 互斥量概念</a></dt>+<dt><ahref="thread/synchronization.html#thread.synchronization.locks"> Lock Types锁定类型</a></dt>+<dt><ahref="thread/synchronization.html#thread.synchronization.lock_functions">Lock functions 锁定函数</a></dt>+<dt><ahref="thread/synchronization.html#thread.synchronization.mutex_types">Mutex Types 互斥量类型</a></dt>+<dt><ahref="thread/synchronization.html#thread.synchronization.condvar_ref">Condition Variables 条件变量</a></dt>+<dt><ahref="thread/synchronization.html#thread.synchronization.once"> One-timeInitialization 一次性初始化</a></dt>+<dt><ahref="thread/synchronization.html#thread.synchronization.barriers">Barriers 栏栅</a></dt>

+</dl></dd>

+<dt><ahref="thread/thread_local_storage.html">Thread Local Storage 线程局部存储</a></dt>+<dd><dl><dt><ahref="thread/thread_local_storage.html#thread.thread_local_storage.thread_specific_ptr">Class+ <code class="computeroutput"><spanclass="identifier">thread_specific_ptr</code></a></dt></dl></dd>+<dt><a href="thread/time.html"> Date and TimeRequirements 日期和时间相关</a></dt>

+<dd><dl>

+<dt><ahref="thread/time.html#thread.time.system_time"> Typedef <codeclass="computeroutput"><spanclass="identifier">system_time</code></a></dt>+<dt><ahref="thread/time.html#thread.time.get_system_time"> Non-member function<code class="computeroutput"><spanclass="identifier">get_system_time<spanclass="special">()</code></a></dt>

+</dl></dd>

+<dt><a href="thread/acknowledgements.html">Acknowledgments 鸣谢</a></dt>

+</dl>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both;">

+<a name="thread.overview"></a><a class="link"href="thread.html#thread.overview" title="Overview"> Overview 简介</a>

+</h2></div></div></div>
+<p>

+ Boost.Thread 使我们能够在可移植的C++代码中使用带有共享数据的多线程执行。它提供了一些类和函数来管理线程，以及在线程间同步数据或者为每个线程提供独立的数据拷贝。

+    </p>
+<p>

+ Boost.Thread 库起初是由William E. Kempf 设计和实现的。这个版本进行了大量重写以紧随C++标准委员会所发布的建议，尤其是 <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2497.html";target="_top">N2497</a>,+ <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2320.html";target="_top">N2320</a>,+ <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2184.html";target="_top">N2184</a>,+ <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2006/n2139.html";target="_top">N2139</a>, 和 <ahref="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2006/n2094.html";target="_top">N2094</a>

+    </p>

+为了使用在此文档中所介绍的类和函数，你要么包含在每个类或函数的说明中所指定的特定头文件，要么包含这个线程库的主头文件：

+    </p>

+<pre class="programlisting">#include<boost<spanclass="special">/thread<spanclass="special">.hpp<spanclass="special">>

+</pre>
+<p>该头文件将转而包含所有其它头文件。
+    </p>
+</div>
+</div>

+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tbody><tr>

+<td align="left"></td>
+<td align="right"><div class="copyright-footer"></div></td>
+</tr></tbody></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body></html>
\ No newline at end of file

Modified: trunk/doc/html/thread/changes.html
==============================================================================
--- trunk/doc/html/thread/changes.html  (original)
+++ trunk/doc/html/thread/changes.html  Sun Apr 19 20:16:56 2009
@@ -1,194 +1,103 @@
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Changes since boost 1.35</title>
-<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">

-<link rel="start" href="../index.html" title="The Boost C++ LibrariesBoostBook Documentation Subset">

-<link rel="up" href="../thread.html" title="Chapter 19. Thread">
-<link rel="prev" href="../thread.html" title="Chapter 19. Thread">
-<link rel="next" href="thread_management.html" title="Thread Management">
-</head>

-<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

-<table cellpadding="2" width="100%"><tr>

-<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../boost.png"></td>

-<td align="center"><a href="../../../index.html">Home</a></td>
-<td align="center"><a href="../../../libs/libraries.htm">Libraries</a></td>

-<td align="center"><ahref="http://www.boost.org/users/people.html";>People</a></td>-<td align="center"><ahref="http://www.boost.org/users/faq.html";>FAQ</a></td>

-<td align="center"><a href="../../../more/index.htm">More</a></td>
-</tr></table>
-<hr>
-<div class="spirit-nav">

-<a accesskey="p" href="../thread.html"><imgsrc="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u"href="../thread.html"><img src="../../../doc/html/images/up.png"alt="Up"></a><a accesskey="h" href="../index.html"><imgsrc="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n"href="thread_management.html"><img src="../../../doc/html/images/next.png"alt="Next"></a>

-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">

-<a name="thread.changes"></a><a class="link" href="changes.html"title="Changes since boost 1.35"> Changes since boost 1.35</a>

-</h2></div></div></div>
-<p>

- The 1.36.0 release of Boost includes a few new features in thethread library:

-    </p>
-<div class="itemizedlist"><ul type="disc">
-<li>

- New generic <a class="link"href="synchronization.html#thread.synchronization.lock_functions.lock_multiple"title="Non-member function lock(Lockable1,Lockable2,...)"><codeclass="computeroutput">lock<spanclass="special">()</code></a>- and <a class="link"href="synchronization.html#thread.synchronization.lock_functions.try_lock_multiple"title="Non-member function try_lock(Lockable1,Lockable2,...)"><codeclass="computeroutput">try_lock<spanclass="special">()</code></a>

-        functions for locking multiple mutexes at once.
-      </li>
-<li>

- Rvalue reference support for move semantics where the compilerssupports

-        it.
-      </li>
-<li>

- A few bugs fixed and missing functions added (including theserious win32

-        condition variable bug).
-      </li>
-<li>

-<code class="computeroutput"><spanclass="identifier">scoped_try_lock</code> types are

-        now backwards-compatible with Boost 1.34.0 and previous releases.
-      </li>
-<li>

- Support for passing function arguments to the thread function bysupplying- additional arguments to the <a class="link"href="thread_management.html#thread.thread_management.thread" title="Classthread"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread</code></a> constructor.

-      </li>
-<li>

- Backwards-compatibility overloads added for <codeclass="computeroutput">timed_lock</code>- and <code class="computeroutput"><spanclass="identifier">timed_wait</code> functions- to allow use of <code class="computeroutput"><spanclass="identifier">xtime</code> for

-        timeouts.
-      </li>
-</ul></div>
-<a name="thread.changes.changes_since_boost_1_34"></a><h4>
-<a name="id4041059"></a>

- <a class="link"href="changes.html#thread.changes.changes_since_boost_1_34">Changes sinceboost

-      1.34</a>
-    </h4>
-<p>

- Almost every line of code in <spanclass="bold">Boost.Thread- has been changed since the 1.34 release of boost. However, most ofthe interface- changes have been extensions, so the new code is largelybackwards-compatible- with the old code. The new features and breaking changes aredescribed below.

-    </p>
-<a name="thread.changes.new_features"></a><h4>
-<a name="id4041094"></a>

- <a class="link" href="changes.html#thread.changes.new_features">NewFeatures</a>

-    </h4>
-<div class="itemizedlist"><ul type="disc">
-<li>

- Instances of <a class="link"href="thread_management.html#thread.thread_management.thread" title="Classthread"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread</code></a> and of the various lock types

-        are now movable.
-      </li>
-<li>

- Threads can be interrupted at <a class="link"href="thread_management.html#interruption_points"><spanclass="emphasis">interruption

-        points</em></span></a>.
-      </li>
-<li>

- Condition variables can now be used with any type that implementsthe <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code>- concept</a>, through the use of <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">condition_variable_any</code>- (<code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">condition</code> is a <codeclass="computeroutput">typedef</code>- to <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">condition_variable_any</code>, provided forbackwards- compatibility). <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">condition_variable</code> is provided as anoptimization,- and will only work with <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock<<spanclass="identifier">boost::<spanclass="identifier">mutex></code>(<code class="computeroutput">boost<spanclass="special">::mutex<spanclass="special">::<spanclass="identifier">scoped_lock</code>).

-      </li>
-<li>

- Thread IDs are separated from <a class="link"href="thread_management.html#thread.thread_management.thread" title="Classthread"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread</code></a>, so a thread can obtain it's- own ID (using <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">this_thread::<spanclass="identifier">get_id()</code>),- and IDs can be used as keys in associative containers, as theyhave the full

-        set of comparison operators.
-      </li>
-<li>

- Timeouts are now implemented using the Boost DateTime library,through a- typedef <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">system_time</code> for absolute timeouts, and- with support for relative timeouts in many cases. <codeclass="computeroutput">boost<spanclass="special">::xtime</code>

-        is supported for backwards compatibility only.
-      </li>
-<li>

- Locks are implemented as publicly accessible templates <codeclass="computeroutput">boost<spanclass="special">::lock_guard</code>,- <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock</code>, <codeclass="computeroutput">boost<spanclass="special">::shared_lock</code>,- and <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">upgrade_lock</code>, which are templated on the- type of the mutex. The <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code> concept</a> has been extended- to include publicly available <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">lock()</code></a>- and <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">unlock()</code></a>

-        member functions, which are used by the lock types.
-      </li>
-</ul></div>
-<a name="thread.changes.breaking_changes"></a><h4>
-<a name="id4041580"></a>

- <a class="link"href="changes.html#thread.changes.breaking_changes">Breaking Changes</a>

-    </h4>
-<p>

- The list below should cover all changes to the public interfacewhich break

-      backwards compatibility.
-    </p>
-<div class="itemizedlist"><ul type="disc">
-<li>

-<a class="link"href="synchronization.html#thread.synchronization.mutex_types.try_mutex"title="Typedef try_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">try_mutex</code></a> has been removed, and- the functionality subsumed into <a class="link"href="synchronization.html#thread.synchronization.mutex_types.mutex"title="Class mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">mutex</code></a>. <a class="link"href="synchronization.html#thread.synchronization.mutex_types.try_mutex"title="Typedef try_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">try_mutex</code></a> is left as a <codeclass="computeroutput">typedef</code>, but isno longer a separate class.

-      </li>
-<li>

-<a class="link"href="synchronization.html#thread.synchronization.mutex_types.recursive_try_mutex"title="Typedef recursive_try_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">recursive_try_mutex</code></a> has been removed,- and the functionality subsumed into <a class="link"href="synchronization.html#thread.synchronization.mutex_types.recursive_mutex"title="Class recursive_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">recursive_mutex</code></a>. <a class="link"href="synchronization.html#thread.synchronization.mutex_types.recursive_try_mutex"title="Typedef recursive_try_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">recursive_try_mutex</code></a> is left as a- <code class="computeroutput"><spanclass="keyword">typedef</code>, but is no longer a

-        separate class.
-      </li>
-<li>

-<code class="computeroutput">boost<spanclass="special">::detail<spanclass="special">::thread<spanclass="special">::lock_ops</code>has been removed. Code that relies- on the <code class="computeroutput"><spanclass="identifier">lock_ops</code> implementation- detail will no longer work, as this has been removed, as it is nolonger- necessary now that mutex types now have public <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">lock()</code></a>- and <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">unlock()</code></a>

-        member functions.
-      </li>
-<li>

-<code class="computeroutput"><spanclass="identifier">scoped_lock</code> constructors- with a second parameter of type <code class="computeroutput"><spanclass="keyword">bool</code>

-        are no longer provided. With previous boost releases,

-<pre class="programlisting">boost<spanclass="special">::mutex<spanclass="special">::scoped_lock <spanclass="identifier">some_lock(<spanclass="identifier">some_mutex,<spanclass="keyword">false);</pre>- could be used to create a lock object that was associated with amutex, but- did not lock it on construction. This facility has now beenreplaced with- the constructor that takes a <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">defer_lock_type</code>

-        as the second parameter:

-</li>
-<li>

- The <code class="computeroutput"><spanclass="identifier">locked()</code>- member function of the <code class="computeroutput"><spanclass="identifier">scoped_lock</code>- types has been renamed to <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>.

-      </li>
-<li>

- You can no longer obtain a <a class="link"href="thread_management.html#thread.thread_management.thread" title="Classthread"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread</code></a> instance representing the- current thread: a default-constructed <a class="link"href="thread_management.html#thread.thread_management.thread" title="Classthread"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread</code></a> object is not associated- with any thread. The only use for such a thread object was tosupport the- comparison operators: this functionality has been moved to <aclass="link"href="thread_management.html#thread.thread_management.thread.id"title="Class boost::thread::id"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread::<spanclass="identifier">id</code></a>.

-      </li>
-<li>

- The broken <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">read_write_mutex</code> has been replaced with- <a class="link"href="synchronization.html#thread.synchronization.mutex_types.shared_mutex"title="Class shared_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">shared_mutex</code></a>.

-      </li>
-<li>

-<a class="link"href="synchronization.html#thread.synchronization.mutex_types.mutex"title="Class mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">mutex</code></a>- is now never recursive. For Boost releases prior to 1.35 <aclass="link"href="synchronization.html#thread.synchronization.mutex_types.mutex"title="Class mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">mutex</code></a> was recursive on Windows and

-        not on POSIX platforms.
-      </li>
-<li>

- When using a <a class="link"href="synchronization.html#thread.synchronization.mutex_types.recursive_mutex"title="Class recursive_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">recursive_mutex</code></a> with a call to- <a class="link"href="synchronization.html#thread.synchronization.condvar_ref.condition_variable_any.wait"title="template<typename lock_type> void wait(lock_type&lock)"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">condition_variable_any<spanclass="special">::wait<spanclass="special">()</code></a>,- the mutex is only unlocked one level, and not completely. Thisprior behaviour

-        was not guaranteed and did not feature in the tests.
-      </li>
-</ul></div>
-</div>

-<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tr>

-<td align="left"></td>

-<td align="right"><div class="copyright-footer">Copyright 2007 -8Anthony Williams- Distributed under the Boost Software License, Version 1.0. (Seeaccompanying- file LICENSE_1_0.txt or copy at <ahref="http://www.boost.org/LICENSE_1_0.txt";target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)

-      </p>
-</div></td>
-</tr></table>
-<hr>
-<div class="spirit-nav">

-</div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+

+<title>Changes since boost 1.35</title><link rel="stylesheet"href="../boostbook.css" type="text/css">

+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">

+<link rel="start" href="../index.html" title="The Boost C++ LibrariesBoostBook Documentation Subset">

+<link rel="up" href="../thread.html" title="Chapter&nbsp;19.&nbsp;Thread">

+<link rel="prev" href="../thread.html"title="Chapter 19. Thread">+<link rel="next" href="thread_management.html" title="ThreadManagement"></head>+<body alink="#0000ff" bgcolor="white" link="#0000ff" text="black"vlink="#840084">

+<table cellpadding="2" width="100%"><tbody><tr>

+<td valign="top"><img alt="Boost C++ Libraries" src="../../../boost.png"height="86" width="277"></td>

+<td align="center"><a href="../../../index.html">Home</a></td>
+<td align="center"><a href="../../../libs/libraries.htm">Libraries</a></td>

+<td align="center"><ahref="http://www.boost.org/users/people.html";>People</a></td>+<td align="center"><ahref="http://www.boost.org/users/faq.html";>FAQ</a></td>

+<td align="center"><a href="../../../more/index.htm">More</a></td>
+</tr></tbody></table>
+<hr>
+<div class="spirit-nav">

+<a accesskey="p" href="../thread.html"><imgsrc="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u"href="../thread.html"><img src="../../../doc/html/images/up.png"alt="Up"></a><a accesskey="h" href="../index.html"><imgsrc="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n"href="thread_management.html"><img src="../../../doc/html/images/next.png"alt="Next"></a>+</div><h2 class="title" style="clear: both;"><a class="link"href="../thread_/changes.html" title="Changes since boost 1.35"> Changessince boost 1.35</a>

+</h2>
+<p>1.36.0 &#29256;&#26032;&#29305;&#24615;:
+    </p>
+<div class="itemizedlist"><ul type="disc"><li>

+ 新的通用锁定函数<a class="link"href="../thread_/synchronization.html#thread.synchronization.lock_functions.lock_multiple"title="Non-member function lock(Lockable1,Lockable2,...)"><codeclass="computeroutput">lock<spanclass="special">()</code></a> ， <a class="link"href="../thread_/synchronization.html#thread.synchronization.lock_functions.try_lock_multiple"title="Non-member function try_lock(Lockable1,Lockable2,...)"><codeclass="computeroutput">try_lock<spanclass="special">()</code></a>，可以一次锁定多个互斥量。+</li><li>编译器支持的条件下，支持转移语义中的右值引用。+</li><li>修复了一些问题，补上了一些缺失的函数(包括win32平台上状态变量的严重bug）。

+      </li><li>

+<code class="computeroutput"><spanclass="identifier">scoped_try_lock</code>类型兼容于 Boost 1.34.0和更早的版本。

+      </li><li>

+ 支持通过<a class="link"href="../thread_/thread_management.html#thread.thread_management.thread"title="Class thread"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread</code></a>构造函数的额外参数传递函数参数给线程函数。

+      </li><li>

+ 重载<code class="computeroutput"><spanclass="identifier">timed_lock</code> 和 <codeclass="computeroutput">timed_wait</code>functions函数支持使用 <codeclass="computeroutput">xtime</code>做超时类型。

+      </li></ul></div>
+<a name="thread.changes.changes_since_boost_1_34"></a><h4>
+<a name="id3714929"></a>

+ <a class="link"href="../thread_/changes.html#thread.changes.changes_since_boost_1_34">Changessince boost

+      1.34</a>
+    </h4>
+<p>

+        <spanclass="bold">Boost.Thread库差不多<spanclass="bold">的所有代码和1.34相比都被改写了。然而，大多数接口变化被扩展，使这些新的代码也能兼容就的代码。新特性和明显的变化列举如下：

+    </p>
+<a name="thread.changes.new_features"></a><h4>
+<a name="id3714965"></a>

+ <a class="link"href="../thread_/changes.html#thread.changes.new_features">New Features</a>

+    </h4>

+<div class="itemizedlist"><ul type="disc"><li><a class="link"href="../thread_/thread_management.html#thread.thread_management.thread"title="Class thread"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread</code></a>和锁类型支持转移语义。+</li><li>线程可在中断点被中断。</li><li>+ 条件变量（<codeclass="computeroutput">boost<spanclass="special">::<spanclass="identifier">condition_variable_any</code>）现在可以和任意实现了可锁定概念的类型一起工作。<code class="computeroutput">boost<spanclass="special">::<spanclass="identifier">condition是一个优化的，提供兼容的类型定义，并且他只能和</code><code class="computeroutput">boost<spanclass="special">::unique_lock<spanclass="special"><boost<spanclass="special">::mutex<spanclass="special">></code> (<code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">mutex::<spanclass="identifier">scoped_lock</code>)一起工作。

+      </li><li>

+ 线程标识从 <a class="link"href="../thread_/thread_management.html#thread.thread_management.thread"title="Class thread"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread类中分离出来</code></a>,这样一个线程可以获得自己的对应的标识，并且线程标识可以被用作关联容器的键，因为它们有完全的比较操作符。

+      </li><li>

+ 通过 Boost DateTimelibrary实现了超时，采用<codeclass="computeroutput">boost<spanclass="special">::system_time</code>作为绝对时间，在很多场合支持相对的时间段超时，<code class="computeroutput">boost<spanclass="special">::xtime</code>+只是为了兼容性和被支持。

+      </li><li>

+锁定通过一些公开的模板实现，如<codeclass="computeroutput">boost<spanclass="special">::lock_guard</code>,+ <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock</code>， <codeclass="computeroutput">boost<spanclass="special">::<spanclass="identifier">shared_lock</code>， 和<codeclass="computeroutput">boost<spanclass="special">::<spanclass="identifier">upgrade_lock</code>，具体实现取决于作为模板参数的互斥量。可锁定概念被扩展，增加<aclass="link"href="../thread_/synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">供锁定操作需要使用的lock<spanclass="special">()</code></a> 和 <a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">unlock()</code></a>函数。

+      </li></ul></div>
+<a name="thread.changes.breaking_changes"></a><h4>
+<a name="id3715450"></a>

+ <a class="link"href="../thread_/changes.html#thread.changes.breaking_changes">BreakingChanges</a>

+    </h4>
+<p>

+       下面列出没有保持兼容的接口改变：

+    </p>
+<div class="itemizedlist"><ul type="disc"><li>

+<a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_types.try_mutex"title="Typedef try_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">try_mutex</code></a> 被移除了,它的功能被包含在<aclass="link"href="../thread_/synchronization.html#thread.synchronization.mutex_types.mutex"title="Class mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">mutex</code></a>。 <a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_types.try_mutex"title="Typedef try_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">try_mutex</code></a>只是作为一个类型定义存在，而不是单独的类。

+      </li><li>

+<a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_types.recursive_try_mutex"title="Typedef recursive_try_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">recursive_try_mutex</code></a>被移除了，其功能被包含在 <a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_types.recursive_mutex"title="Class recursive_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">recursive_mutex</code></a>. <a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_types.recursive_try_mutex"title="Typedef recursive_try_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">recursive_try_mutex</code></a> 只是作为一个类型定义存在，而不是单独的类。

+      </li><li>

+<code class="computeroutput">boost<spanclass="special">::detail<spanclass="special">::thread<spanclass="special">::lock_ops</code>被移除了，依赖于<codeclass="computeroutput">lock_ops</code>实现的代码将不能工作。<codeclass="computeroutput"><spanclass="identifier">lock_ops已经不再需要，因为互斥量现在已经有空开的</code><a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">lock()</code></a>和 <a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">unlock()<spanstyle="font-family: sans;">函数。</code></a>

+      </li><li>

+<code class="computeroutput"><spanclass="identifier">scoped_lock</code>中支持第二个<codeclass="computeroutput">bool</code>+参数的构造函数被移除了。在以前的boost版本，如下的定义+<pre class="programlisting">boost<spanclass="special">::mutex<spanclass="special">::scoped_lock <spanclass="identifier">some_lock(<spanclass="identifier">some_mutex,<spanclass="keyword">false);</pre>+could可以用来创建一个和互斥量关联的锁对象，但是并不马上在构造是锁定它。这个功能现在被携带<codeclass="computeroutput">boost<spanclass="special">::<spanclass="identifier">defer_lock_type</code>

+&#21442;&#25968;&#30340;&#26500;&#36896;&#20989;&#25968;&#20195;&#26367;&#20102;&#65306;

+<pre class="programlisting">boost<spanclass="special">::mutex<spanclass="special">::scoped_lock <spanclass="identifier">some_lock(<spanclass="identifier">some_mutex,<spanclass="identifier">boost::<spanclass="identifier">defer_lock);</pre>

+</li><li>

+ <code class="computeroutput"><spanclass="identifier">scoped_lock</code>类型的成员函数<codeclass="computeroutput">locked<spanclass="special">()</code> 改名为<a class="link"href="../thread_/synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>。+</li><li>不能在当前线程内获得代表自己的<aclass="link"href="../thread_/thread_management.html#thread.thread_management.thread"title="Class thread"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread</code></a>对象，现在一个默认构造出来的<a class="link"href="../thread_/thread_management.html#thread.thread_management.thread"title="Class thread"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread</code></a>实例不会关联到任何线程，这样的实例唯一的用处是在线程做比较时。现在这些功能（标识线程）都被移到<a class="link"href="../thread_/thread_management.html#thread.thread_management.thread.id"title="Class boost::thread::id"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread::<spanclass="identifier">id</code></a>类型里了。

+      </li><li>

+ <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">read_write_mutex</code> 被+ <a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_types.shared_mutex"title="Class shared_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">shared_mutex取代了</code></a>。

+      </li><li>

+<a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_types.mutex"title="Class mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">mutex</code></a>+现在不是支持递归的，在1.35版以前，<a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_types.mutex"title="Class mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">mutex</code></a> 在Windows平台上是支持递归的，而在POSIX平台上却不是。

+      </li><li>

+ 当a <a class="link"href="../thread_/synchronization.html#thread.synchronization.mutex_types.recursive_mutex"title="Class recursive_mutex"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">recursive_mutex</code></a> 配合<aclass="link"href="../thread_/synchronization.html#thread.synchronization.condvar_ref.condition_variable_any.wait"title="template<typename lock_type> void wait(lock_type&lock)"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">condition_variable_any<spanclass="special">::wait<spanclass="special">()</code></a>使用时，该函数只是释放一次锁定，而不是所有的锁定。这个在以前是不被保证的，也没有体现在测试代码中。+ </li></ul></div><tablexmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision";width="100%"><tbody><tr><td align="left"></td><td align="right"><divclass="copyright-footer">Copyright 2007 -8 Anthony Williams+ Distributed under the Boost Software License, Version 1.0. (Seeaccompanying+ file LICENSE_1_0.txt or copy at <ahref="http://www.boost.org/LICENSE_1_0.txt";target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)

+      </p>
+</div></td>
+</tr></tbody></table>
+<hr>
+<div class="spirit-nav">

+</div>
+</body></html>
\ No newline at end of file

Modified: trunk/doc/html/thread/synchronization.html
==============================================================================
--- trunk/doc/html/thread/synchronization.html  (original)
+++ trunk/doc/html/thread/synchronization.html  Sun Apr 19 20:16:56 2009
@@ -1,3417 +1,1773 @@
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Synchronization</title>
-<link rel="stylesheet" href="../boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">

-<link rel="start" href="../index.html" title="The Boost C++ LibrariesBoostBook Documentation Subset">

-<link rel="up" href="../thread.html" title="Chapter 19. Thread">
-<link rel="prev" href="thread_management.html" title="Thread Management">

-<link rel="next" href="thread_local_storage.html" title="Thread LocalStorage">

-</head>

-<body bgcolor="white" text="black" link="#0000FF" vlink="#840084"alink="#0000FF">

-<table cellpadding="2" width="100%"><tr>

-<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86"src="../../../boost.png"></td>

-<td align="center"><a href="../../../index.html">Home</a></td>
-<td align="center"><a href="../../../libs/libraries.htm">Libraries</a></td>

-<td align="center"><ahref="http://www.boost.org/users/people.html";>People</a></td>-<td align="center"><ahref="http://www.boost.org/users/faq.html";>FAQ</a></td>

-<td align="center"><a href="../../../more/index.htm">More</a></td>
-</tr></table>
-<hr>
-<div class="spirit-nav">

-<a accesskey="p" href="thread_management.html"><imgsrc="../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u"href="../thread.html"><img src="../../../doc/html/images/up.png"alt="Up"></a><a accesskey="h" href="../index.html"><imgsrc="../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n"href="thread_local_storage.html"><imgsrc="../../../doc/html/images/next.png" alt="Next"></a>

-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">

-<a name="thread.synchronization"></a><a class="link"href="synchronization.html" title="Synchronization"> Synchronization</a>

-</h2></div></div></div>
-<div class="toc"><dl>

-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts"> MutexConcepts</a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks"> LockTypes</a></dt>-<dt><ahref="synchronization.html#thread.synchronization.lock_functions"> Lockfunctions</a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_types"> MutexTypes</a></dt>-<dt><ahref="synchronization.html#thread.synchronization.condvar_ref"> ConditionVariables</a></dt>-<dt><ahref="synchronization.html#thread.synchronization.once"> One-timeInitialization</a></dt>-<dt><ahref="synchronization.html#thread.synchronization.barriers">Barriers</a></dt>

-</dl></div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h3 class="title">

-<a name="thread.synchronization.mutex_concepts"></a><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts"title="Mutex Concepts"> Mutex Concepts</a>

-</h3></div></div></div>
-<div class="toc"><dl>

-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.lockable"><code class="computeroutput"><spanclass="identifier">Lockable</code> Concept</a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable">- <code class="computeroutput"><spanclass="identifier">TimedLockable</code> Concept</a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable">- <code class="computeroutput"><spanclass="identifier">SharedLockable</code> Concept</a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable">- <code class="computeroutput"><spanclass="identifier">UpgradeLockable</code> Concept</a></dt>

-</dl></div>
-<p>

- A mutex object facilitates protection against data races andallows thread-safe- synchronization of data between threads. A thread obtainsownership of a- mutex object by calling one of the lock functions and relinquishesownership- by calling the corresponding unlock function. Mutexes may beeither recursive- or non-recursive, and may grant simultaneous ownership to one ormany threads.- Boost.Thread suppliesrecursive and non-recursive- mutexes with exclusive ownership semantics, along with a sharedownership

-        (multiple-reader / single-writer) mutex.
-      </p>
-<p>

- Boost.Thread supportsfour basic concepts- for lockable objects: <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a>, <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable"title="TimedLockable Concept"><code class="computeroutput"><spanclass="identifier">TimedLockable</code></a>, <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable"title="SharedLockable Concept"><code class="computeroutput"><spanclass="identifier">SharedLockable</code></a> and <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable"title="UpgradeLockable Concept"><code class="computeroutput"><spanclass="identifier">UpgradeLockable</code></a>. Each mutex type- implements one or more of these concepts, as do the various locktypes.

-      </p>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">

-<a name="thread.synchronization.mutex_concepts.lockable"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"> <code class="computeroutput"><spanclass="identifier">Lockable</code> Concept</a>

-</h4></div></div></div>
-<div class="toc"><dl>

-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock">- <code class="computeroutput">voidlock<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.lockable.try_lock">- <code class="computeroutput">booltry_lock<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock">- <code class="computeroutput">voidunlock<spanclass="special">()</code></a></dt>

-</dl></div>
-<p>

- The <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code> concept</a> models exclusive- ownership. A type that implements the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code> concept</a> shall provide

-          the following member functions:
-        </p>
-<div class="itemizedlist"><ul type="disc">

-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="keyword">void lock<spanclass="special">();</code></a></li>-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.try_lock"title="bool try_lock()"><code class="computeroutput"><spanclass="keyword">bool try_lock<spanclass="special">();</code></a></li>-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="keyword">void unlock<spanclass="special">();</code></a></li>

-</ul></div>
-<p>

- Lock ownership acquired through a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">lock()</code></a>- or <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.try_lock"title="bool try_lock()"><code class="computeroutput"><spanclass="identifier">try_lock()</code></a>- must be released through a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">unlock()</code></a>.

-        </p>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.mutex_concepts.lockable.lock"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()">- <code class="computeroutput">voidlock<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- The current thread blocks until ownership can be obtainedfor the

-                current thread.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- The current thread owns <code class="computeroutput"><spanclass="special">*this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread_resource_error</code> if an error

-                occurs.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.mutex_concepts.lockable.try_lock"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.try_lock"title="bool try_lock()">- <code class="computeroutput">booltry_lock<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Attempt to obtain ownership for the current thread withoutblocking.

-              </p></dd>
-<dt><span class="term">Returns:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="keyword">true</code> if ownership was- obtained for the current thread, <codeclass="computeroutput">false</code>

-                otherwise.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- If the call returns <code class="computeroutput"><spanclass="keyword">true</code>,- the current thread owns the <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread_resource_error</code> if an error

-                occurs.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.mutex_concepts.lockable.unlock"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()">- <code class="computeroutput">voidunlock<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Precondition:</span></dt>
-<dd><p>

- The current thread owns <code class="computeroutput"><spanclass="special">*this</code>.

-              </p></dd>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>
-                Releases ownership by the current thread.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- The current thread no longer owns <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing
-              </p></dd>
-</dl>
-</div>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">

-<a name="thread.synchronization.mutex_concepts.timed_lockable"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable"title="TimedLockable Concept">- <code class="computeroutput"><spanclass="identifier">TimedLockable</code> Concept</a>

-</h4></div></div></div>
-<div class="toc"><dl>

-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock">- <code class="computeroutput">booltimed_lock<spanclass="special">(boost<spanclass="special">::system_time- const<spanclass="special">&- abs_time<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock_duration">- <code class="computeroutput"><spanclass="keyword">template<<spanclass="keyword">typename <spanclass="identifier">DurationType>bool <spanclass="identifier">timed_lock(<spanclass="identifier">DurationType <spanclass="keyword">const& <spanclass="identifier">rel_time<spanclass="special">)</code></a></dt>

-</dl></div>
-<p>

- The <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable"title="TimedLockable Concept"><code class="computeroutput"><spanclass="identifier">TimedLockable</code> concept</a> refines- the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code> concept</a> to add support

-          for timeouts when trying to acquire the lock.
-        </p>
-<p>

- A type that implements the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable"title="TimedLockable Concept"><code class="computeroutput"><spanclass="identifier">TimedLockable</code> concept</a> shall meet- the requirements of the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code> concept</a>. In addition,

-          the following member functions must be provided:
-        </p>
-<div class="itemizedlist"><ul type="disc">

-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock"title="bool timed_lock(boost::system_time const& abs_time)"><codeclass="computeroutput">bool <spanclass="identifier">timed_lock(<spanclass="identifier">boost::<spanclass="identifier">system_time- const<spanclass="special">&- abs_time<spanclass="special">);</code></a></li>-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock_duration"title="template<typename DurationType> bool timed_lock(DurationTypeconst& rel_time)"><code class="computeroutput"><spanclass="keyword">template<<spanclass="keyword">typename <spanclass="identifier">DurationType>bool <spanclass="identifier">timed_lock(<spanclass="identifier">DurationType <spanclass="keyword">const& <spanclass="identifier">rel_time<spanclass="special">);</code></a></li>

-</ul></div>
-<p>

- Lock ownership acquired through a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock"title="bool timed_lock(boost::system_time const& abs_time)"><codeclass="computeroutput">timed_lock<spanclass="special">()</code></a>- must be released through a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">unlock()</code></a>.

-        </p>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.timed_lockable.timed_lock"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock"title="bool timed_lock(boost::system_time const& abs_time)">- <code class="computeroutput">booltimed_lock<spanclass="special">(boost<spanclass="special">::system_time- const<spanclass="special">&- abs_time<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Attempt to obtain ownership for the current thread. Blocksuntil- ownership can be obtained, or the specified time isreached. If the- specified time has already passed, behaves as <aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.try_lock"title="bool try_lock()"><code class="computeroutput"><spanclass="identifier">try_lock<spanclass="special">()</code></a>.

-              </p></dd>
-<dt><span class="term">Returns:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="keyword">true</code> if ownership was- obtained for the current thread, <codeclass="computeroutput">false</code>

-                otherwise.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- If the call returns <code class="computeroutput"><spanclass="keyword">true</code>,- the current thread owns <code class="computeroutput"><spanclass="special">*this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread_resource_error</code> if an error

-                occurs.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.timed_lockable.timed_lock_duration"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock_duration"title="template<typename DurationType> bool timed_lock(DurationTypeconst& rel_time)">- <code class="computeroutput"><spanclass="keyword">template<<spanclass="keyword">typename <spanclass="identifier">DurationType>bool <spanclass="identifier">timed_lock(<spanclass="identifier">DurationType <spanclass="keyword">const& <spanclass="identifier">rel_time)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- As-if <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock"title="bool timed_lock(boost::system_time const& abs_time)"><codeclass="computeroutput">timed_lock<spanclass="special">(boost<spanclass="special">::<spanclass="identifier">get_system_time<spanclass="special">()+rel_time<spanclass="special">)</code></a>.

-              </p></dd>
-</dl>
-</div>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">

-<a name="thread.synchronization.mutex_concepts.shared_lockable"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable"title="SharedLockable Concept">- <code class="computeroutput"><spanclass="identifier">SharedLockable</code> Concept</a>

-</h4></div></div></div>
-<div class="toc"><dl>

-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.lock_shared">- <code class="computeroutput">voidlock_shared<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.try_lock_shared">- <code class="computeroutput">booltry_lock_shared<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.timed_lock_shared">- <code class="computeroutput">booltimed_lock_shared<spanclass="special">(boost<spanclass="special">::system_time- const<spanclass="special">&- abs_time<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.unlock_shared">- <code class="computeroutput">voidunlock_shared<spanclass="special">()</code></a></dt>

-</dl></div>
-<p>

- The <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable"title="SharedLockable Concept"><code class="computeroutput"><spanclass="identifier">SharedLockable</code> concept</a> is a refinement- of the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable"title="TimedLockable Concept"><code class="computeroutput"><spanclass="identifier">TimedLockable</code> concept</a> that allows- for shared ownership aswell as exclusive- ownership. This is the standard multiple-reader /single-write- model: at most one thread can have exclusive ownership, and ifany thread- does have exclusive ownership, no other threads can have sharedor exclusive

-          ownership. Alternatively, many threads may have shared ownership.
-        </p>
-<p>

- For a type to implement the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable"title="SharedLockable Concept"><code class="computeroutput"><spanclass="identifier">SharedLockable</code> concept</a>, as well- as meeting the requirements of the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable"title="TimedLockable Concept"><code class="computeroutput"><spanclass="identifier">TimedLockable</code> concept</a>, it must

-          also provide the following member functions:
-        </p>
-<div class="itemizedlist"><ul type="disc">

-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.lock_shared"title="void lock_shared()"><code class="computeroutput"><spanclass="keyword">void <spanclass="identifier">lock_shared<spanclass="special">();</code></a></li>-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.try_lock_shared"title="bool try_lock_shared()"><code class="computeroutput"><spanclass="keyword">bool <spanclass="identifier">try_lock_shared<spanclass="special">();</code></a></li>-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.unlock_shared"title="void unlock_shared()"><code class="computeroutput"><spanclass="keyword">bool <spanclass="identifier">unlock_shared<spanclass="special">();</code></a></li>-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.timed_lock_shared"title="bool timed_lock_shared(boost::system_time const&abs_time)"><code class="computeroutput">booltimed_lock_shared<spanclass="special">(boost<spanclass="special">::system_time- const<spanclass="special">&- abs_time<spanclass="special">);</code></a></li>

-</ul></div>
-<p>

- Lock ownership acquired through a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.lock_shared"title="void lock_shared()"><code class="computeroutput"><spanclass="identifier">lock_shared<spanclass="special">()</code></a>,- <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.try_lock_shared"title="bool try_lock_shared()"><code class="computeroutput"><spanclass="identifier">try_lock_shared<spanclass="special">()</code></a>- or <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.timed_lock_shared"title="bool timed_lock_shared(boost::system_time const&abs_time)"><code class="computeroutput"><spanclass="identifier">timed_lock_shared<spanclass="special">()</code></a>- must be released through a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.unlock_shared"title="void unlock_shared()"><code class="computeroutput"><spanclass="identifier">unlock_shared<spanclass="special">()</code></a>.

-        </p>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.shared_lockable.lock_shared"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.lock_shared"title="void lock_shared()">- <code class="computeroutput">voidlock_shared<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- The current thread blocks until shared ownership can beobtained

-                for the current thread.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- The current thread has shared ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread_resource_error</code> if an error

-                occurs.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.shared_lockable.try_lock_shared"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.try_lock_shared"title="bool try_lock_shared()">- <code class="computeroutput">booltry_lock_shared<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Attempt to obtain shared ownership for the current threadwithout

-                blocking.
-              </p></dd>
-<dt><span class="term">Returns:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="keyword">true</code> if shared ownership- was obtained for the current thread, <codeclass="computeroutput">false</code>

-                otherwise.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- If the call returns <code class="computeroutput"><spanclass="keyword">true</code>,- the current thread has shared ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread_resource_error</code> if an error

-                occurs.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.shared_lockable.timed_lock_shared"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.timed_lock_shared"title="bool timed_lock_shared(boost::system_time const& abs_time)">- <code class="computeroutput">booltimed_lock_shared<spanclass="special">(boost<spanclass="special">::system_time- const<spanclass="special">&- abs_time<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Attempt to obtain shared ownership for the current thread.Blocks- until shared ownership can be obtained, or the specifiedtime is- reached. If the specified time has already passed, behavesas <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.try_lock_shared"title="bool try_lock_shared()"><code class="computeroutput"><spanclass="identifier">try_lock_shared<spanclass="special">()</code></a>.

-              </p></dd>
-<dt><span class="term">Returns:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="keyword">true</code> if shared ownership- was acquired for the current thread, <codeclass="computeroutput">false</code>

-                otherwise.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread_resource_error</code> if an error

-                occurs.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.shared_lockable.unlock_shared"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.unlock_shared"title="void unlock_shared()">- <code class="computeroutput">voidunlock_shared<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Precondition:</span></dt>
-<dd><p>

- The current thread has shared ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Releases shared ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code> by the current thread.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- The current thread no longer has shared ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing
-              </p></dd>
-</dl>
-</div>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">

-<a name="thread.synchronization.mutex_concepts.upgrade_lockable"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable"title="UpgradeLockable Concept">- <code class="computeroutput"><spanclass="identifier">UpgradeLockable</code> Concept</a>

-</h4></div></div></div>
-<div class="toc"><dl>

-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.lock_upgrade">- <code class="computeroutput">voidlock_upgrade<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade">- <code class="computeroutput">voidunlock_upgrade<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade_and_lock">- <code class="computeroutput">voidunlock_upgrade_and_lock<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade_and_lock_shared">- <code class="computeroutput">voidunlock_upgrade_and_lock_shared<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_and_lock_upgrade">- <code class="computeroutput">voidunlock_and_lock_upgrade<spanclass="special">()</code></a></dt>

-</dl></div>
-<p>

- The <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable"title="UpgradeLockable Concept"><code class="computeroutput"><spanclass="identifier">UpgradeLockable</code> concept</a> is a refinement- of the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable"title="SharedLockable Concept"><code class="computeroutput"><spanclass="identifier">SharedLockable</code> concept</a> that allows- for upgradable ownershipas well as shared- ownership and exclusiveownership. This- is an extension to the multiple-reader / single-write modelprovided by- the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable"title="SharedLockable Concept"><code class="computeroutput"><spanclass="identifier">SharedLockable</code> concept</a>: a single- thread may have upgradableownership at the same time- as others have sharedownership. The thread with- upgradable ownership mayat any time attempt to upgrade- that ownership to exclusiveownership. If no other- threads have shared ownership, the upgrade is completedimmediately, and- the thread now has exclusiveownership, which must- be relinquished by a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">unlock()</code></a>,- just as if it had been acquired by a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">lock()</code></a>.

-        </p>
-<p>

- If a thread with upgradableownership tries to upgrade- whilst other threads have sharedownership, the attempt- will fail and the thread will block until <spanclass="emphasis">exclusive ownership

-          can be acquired.
-        </p>
-<p>

- Ownership can also be <spanclass="emphasis">downgraded as well as <spanclass="emphasis">upgraded:- exclusive ownership of an implementation of the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable"title="UpgradeLockable Concept"><code class="computeroutput"><spanclass="identifier">UpgradeLockable</code> concept</a> can be- downgraded to upgradable ownership or shared ownership, andupgradable

-          ownership can be downgraded to plain shared ownership.
-        </p>
-<p>

- For a type to implement the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable"title="UpgradeLockable Concept"><code class="computeroutput"><spanclass="identifier">UpgradeLockable</code> concept</a>, as well- as meeting the requirements of the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable"title="SharedLockable Concept"><code class="computeroutput"><spanclass="identifier">SharedLockable</code> concept</a>, it must

-          also provide the following member functions:
-        </p>
-<div class="itemizedlist"><ul type="disc">

-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.lock_upgrade"title="void lock_upgrade()"><code class="computeroutput"><spanclass="keyword">void <spanclass="identifier">lock_upgrade<spanclass="special">();</code></a></li>-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade"title="void unlock_upgrade()"><code class="computeroutput"><spanclass="keyword">bool <spanclass="identifier">unlock_upgrade<spanclass="special">();</code></a></li>-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade_and_lock"title="void unlock_upgrade_and_lock()"><code class="computeroutput"><spanclass="keyword">void <spanclass="identifier">unlock_upgrade_and_lock<spanclass="special">();</code></a></li>-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_and_lock_upgrade"title="void unlock_and_lock_upgrade()"><code class="computeroutput"><spanclass="keyword">void <spanclass="identifier">unlock_and_lock_upgrade<spanclass="special">();</code></a></li>-<li><a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade_and_lock_shared"title="void unlock_upgrade_and_lock_shared()"><codeclass="computeroutput">void <spanclass="identifier">unlock_upgrade_and_lock_shared<spanclass="special">();</code></a></li>

-</ul></div>
-<p>

- Lock ownership acquired through a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.lock_upgrade"title="void lock_upgrade()"><code class="computeroutput"><spanclass="identifier">lock_upgrade<spanclass="special">()</code></a>- must be released through a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade"title="void unlock_upgrade()"><code class="computeroutput"><spanclass="identifier">unlock_upgrade<spanclass="special">()</code></a>.- If the ownership type is changed through a call to one of the<code class="computeroutput"><spanclass="identifier">unlock_xxx_and_lock_yyy<spanclass="special">()</code>- functions, ownership must be released through a call to theunlock function

-          corresponding to the new level of ownership.
-        </p>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.upgrade_lockable.lock_upgrade"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.lock_upgrade"title="void lock_upgrade()">- <code class="computeroutput">voidlock_upgrade<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- The current thread blocks until upgrade ownership can beobtained

-                for the current thread.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- The current thread has upgrade ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">thread_resource_error</code> if an error

-                occurs.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade"title="void unlock_upgrade()">- <code class="computeroutput">voidunlock_upgrade<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Precondition:</span></dt>
-<dd><p>

- The current thread has upgrade ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Releases upgrade ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code> by the current thread.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- The current thread no longer has upgrade ownership of<code class="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade_and_lock"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade_and_lock"title="void unlock_upgrade_and_lock()">- <code class="computeroutput">voidunlock_upgrade_and_lock<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Precondition:</span></dt>
-<dd><p>

- The current thread has upgrade ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Atomically releases upgrade ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code> by the current thread and acquires- exclusive ownership of <code class="computeroutput"><spanclass="special">*this</code>. If anyother threads have shared- ownership, blocks until exclusive ownership can beacquired.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- The current thread has exclusive ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade_and_lock_shared"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_upgrade_and_lock_shared"title="void unlock_upgrade_and_lock_shared()">- <code class="computeroutput">voidunlock_upgrade_and_lock_shared<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Precondition:</span></dt>
-<dd><p>

- The current thread has upgrade ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Atomically releases upgrade ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code> by the current thread and acquires- shared ownership of <code class="computeroutput"><spanclass="special">*this</code> withoutblocking.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- The current thread has shared ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.mutex_concepts.upgrade_lockable.unlock_and_lock_upgrade"></a><aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.upgrade_lockable.unlock_and_lock_upgrade"title="void unlock_and_lock_upgrade()">- <code class="computeroutput">voidunlock_and_lock_upgrade<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Precondition:</span></dt>
-<dd><p>

- The current thread has exclusive ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Atomically releases exclusive ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code> by the current thread and acquires- upgrade ownership of <code class="computeroutput"><spanclass="special">*this</code> withoutblocking.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- The current thread has upgrade ownership of <codeclass="computeroutput">*<spanclass="keyword">this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing
-              </p></dd>
-</dl>
-</div>
-</div>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h3 class="title">

-<a name="thread.synchronization.locks"></a><a class="link"href="synchronization.html#thread.synchronization.locks" title="LockTypes"> Lock Types</a>

-</h3></div></div></div>
-<div class="toc"><dl>

-<dt><ahref="synchronization.html#thread.synchronization.locks.lock_guard"> Classtemplate- <code class="computeroutput"><spanclass="identifier">lock_guard</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock"> Classtemplate- <code class="computeroutput"><spanclass="identifier">unique_lock</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock"> Classtemplate- <code class="computeroutput"><spanclass="identifier">shared_lock</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.upgrade_lock">Class template- <code class="computeroutput"><spanclass="identifier">upgrade_lock</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.upgrade_to_unique_lock">- Class template <code class="computeroutput"><spanclass="identifier">upgrade_to_unique_lock</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.scoped_try_lock">Mutex-specific- class <code class="computeroutput"><spanclass="identifier">scoped_try_lock</code></a></dt>

-</dl></div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">

-<a name="thread.synchronization.locks.lock_guard"></a><a class="link"href="synchronization.html#thread.synchronization.locks.lock_guard"title="Class template lock_guard"> Class template- <code class="computeroutput"><spanclass="identifier">lock_guard</code></a>

-</h4></div></div></div>
-<div class="toc"><dl>

-<dt><ahref="synchronization.html#thread.synchronization.locks.lock_guard.constructor">- <code class="computeroutput"><spanclass="identifier">lock_guard(<spanclass="identifier">Lockable &- m<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.lock_guard.constructor_adopt">- <code class="computeroutput"><spanclass="identifier">lock_guard(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::adopt_lock_t<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.lock_guard.destructor">- <code class="computeroutput">~<spanclass="identifier">lock_guard<spanclass="special">()</code></a></dt>

-</dl></div>

-<pre class="programlisting">#include<boost<spanclass="special">/thread<spanclass="special">/locks<spanclass="special">.hpp<spanclass="special">>

-template<spanclass="special"><typename <spanclass="identifier">Lockable>-class <spanclass="identifier">lock_guard

-<span class="special">{</span>
-<span class="keyword">public</span><span class="special">:</span>

- explicit <spanclass="identifier">lock_guard(<spanclass="identifier">Lockable& <spanclass="identifier">m_);- lock_guard<spanclass="special">(Lockable<spanclass="special">& m_<spanclass="special">,boost<spanclass="special">::adopt_lock_t<spanclass="special">);

- ~<spanclass="identifier">lock_guard();

-<span class="special">};</span>
-</pre>
-<p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.lock_guard"title="Class template lock_guard"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">lock_guard</code></a>- is very simple: on construction it acquires ownership of theimplementation- of the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code> concept</a> supplied as the- constructor parameter. On destruction, the ownership isreleased. This- provides simple RAII-style locking of a <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object, to facilitate- exception-safe locking and unlocking. In addition, the <aclass="link"href="synchronization.html#thread.synchronization.locks.lock_guard.constructor_adopt"title="lock_guard(Lockable & m,boost::adopt_lock_t)"><codeclass="computeroutput">lock_guard<spanclass="special">(Lockable <spanclass="special">&- m<spanclass="special">,boost<spanclass="special">::adopt_lock_t<spanclass="special">)</code>- constructor</a> allows the <a class="link"href="synchronization.html#thread.synchronization.locks.lock_guard"title="Class template lock_guard"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">lock_guard</code></a> object to take ownership

-          of a lock already held by the current thread.
-        </p>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.lock_guard.constructor"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.lock_guard.constructor"title="lock_guard(Lockable & m)">- <code class="computeroutput"><spanclass="identifier">lock_guard(<spanclass="identifier">Lockable &- m<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Stores a reference to <code class="computeroutput"><spanclass="identifier">m</code>.- Invokes <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">m.<spanclass="identifier">lock()</code></a>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- Any exception thrown by the call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">m.<spanclass="identifier">lock()</code></a>.

-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.lock_guard.constructor_adopt"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.lock_guard.constructor_adopt"title="lock_guard(Lockable & m,boost::adopt_lock_t)">- <code class="computeroutput"><spanclass="identifier">lock_guard(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::adopt_lock_t<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Precondition:</span></dt>
-<dd><p>

- The current thread owns a lock on <codeclass="computeroutput">m</code>- equivalent to one obtained by a call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">m.<spanclass="identifier">lock()</code></a>.

-              </p></dd>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Stores a reference to <code class="computeroutput"><spanclass="identifier">m</code>.- Takes ownership of the lock state of <codeclass="computeroutput">m</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.lock_guard.destructor"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.lock_guard.destructor"title="~lock_guard()">- <code class="computeroutput">~<spanclass="identifier">lock_guard<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Invokes <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">m.<spanclass="identifier">unlock()</code></a>- on the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object passed to

-                the constructor.
-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">

-<a name="thread.synchronization.locks.unique_lock"></a><a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock"title="Class template unique_lock"> Class template- <code class="computeroutput"><spanclass="identifier">unique_lock</code></a>

-</h4></div></div></div>
-<div class="toc"><dl>

-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.defaultconstructor">- <code class="computeroutput"><spanclass="identifier">unique_lock<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.constructor">- <code class="computeroutput"><spanclass="identifier">unique_lock(<spanclass="identifier">Lockable &- m<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.constructor_adopt">- <code class="computeroutput"><spanclass="identifier">unique_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::adopt_lock_t<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.constructor_defer">- <code class="computeroutput"><spanclass="identifier">unique_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::defer_lock_t<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.constructor_try">- <code class="computeroutput"><spanclass="identifier">unique_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::try_to_lock_t<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.constructor_abs_time">- <code class="computeroutput"><spanclass="identifier">unique_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::system_time <spanclass="keyword">const& <spanclass="identifier">abs_time<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.destructor">- <code class="computeroutput">~<spanclass="identifier">unique_lock<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock">- <code class="computeroutput">boolowns_lock()const</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.mutex">- <code class="computeroutput"><spanclass="identifier">Lockable*- mutex<spanclass="special">()

-          <span class="keyword">const</span></code></a></span></dt>

-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.bool_conversion">- <code class="computeroutput"><spanclass="keyword">operator <spanclass="identifier">unspecified-<spanclass="keyword">bool-<spanclass="identifier">type() <spanclass="keyword">const</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.operator_not">- <code class="computeroutput">booloperator!() <spanclass="keyword">const</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.unique_lock.release">- <code class="computeroutput"><spanclass="identifier">Lockable*- release<spanclass="special">()</code></a></dt>

-</dl></div>

-<pre class="programlisting">#include<boost<spanclass="special">/thread<spanclass="special">/locks<spanclass="special">.hpp<spanclass="special">>

-<span class="special">{</span>
-<span class="keyword">public</span><span class="special">:</span>

- unique_lock<spanclass="special">();- explicit <spanclass="identifier">unique_lock(<spanclass="identifier">Lockable& <spanclass="identifier">m_);- unique_lock<spanclass="special">(Lockable<spanclass="special">& m_<spanclass="special">,adopt_lock_t<spanclass="special">);- unique_lock<spanclass="special">(Lockable<spanclass="special">& m_<spanclass="special">,defer_lock_t<spanclass="special">);- unique_lock<spanclass="special">(Lockable<spanclass="special">& m_<spanclass="special">,try_to_lock_t<spanclass="special">);- unique_lock<spanclass="special">(Lockable<spanclass="special">& m_<spanclass="special">,system_time <spanclass="keyword">const& <spanclass="identifier">target_time);

- ~<spanclass="identifier">unique_lock();

- unique_lock<spanclass="special">(detail<spanclass="special">::thread_move_t<spanclass="special"><unique_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);- unique_lock<spanclass="special">(detail<spanclass="special">::thread_move_t<spanclass="special"><<spanclass="identifier">upgrade_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);

- operator <spanclass="identifier">detail::<spanclass="identifier">thread_move_t<spanclass="special"><unique_lock<spanclass="special"><Lockable<spanclass="special">> >();- detail<spanclass="special">::thread_move_t<spanclass="special"><unique_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">move();- unique_lock<spanclass="special">& operator<spanclass="special">=(detail<spanclass="special">::thread_move_t<spanclass="special"><unique_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);- unique_lock<spanclass="special">& operator<spanclass="special">=(detail<spanclass="special">::thread_move_t<spanclass="special"><<spanclass="identifier">upgrade_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);

- void <spanclass="identifier">swap(<spanclass="identifier">unique_lock&other);- void <spanclass="identifier">swap(<spanclass="identifier">detail::<spanclass="identifier">thread_move_t<spanclass="special"><unique_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);

- template<spanclass="special"><typename <spanclass="identifier">TimeDuration>- bool <spanclass="identifier">timed_lock(<spanclass="identifier">TimeDuration <spanclass="keyword">const& <spanclass="identifier">relative_time);- bool <spanclass="identifier">timed_lock(::<spanclass="identifier">boost::<spanclass="identifier">system_time <spanclass="keyword">const& <spanclass="identifier">absolute_time);

- void <spanclass="identifier">unlock();

- bool <spanclass="identifier">owns_lock() <spanclass="keyword">const;- operator <spanclass="emphasis">unspecified-bool-type<spanclass="special">() const<spanclass="special">;- bool <spanclass="keyword">operator!() <spanclass="keyword">const;

- Lockable*mutex() <spanclass="keyword">const;- Lockable*release();

-<span class="special">};</span>
-</pre>
-<p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock"title="Class template unique_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock</code></a> is more complex than- <a class="link"href="synchronization.html#thread.synchronization.locks.lock_guard"title="Class template lock_guard"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">lock_guard</code></a>:- not only does it provide for RAII-style locking, it also allowsfor deferring- acquiring the lock until the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">lock()</code></a>- member function is called explicitly, or trying to acquire thelock in- a non-blocking fashion, or with a timeout. Consequently, <aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">unlock()</code></a>- is only called in the destructor if the lock object has lockedthe <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object, or otherwise- adopted a lock on the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object.

-        </p>
-<p>

- Specializations of <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock"title="Class template unique_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock</code></a> model the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable"title="TimedLockable Concept"><code class="computeroutput"><spanclass="identifier">TimedLockable</code> concept</a> if the supplied- <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> type itself models <aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable"title="TimedLockable Concept"><code class="computeroutput"><spanclass="identifier">TimedLockable</code> concept</a> (e.g. <codeclass="computeroutput">boost<spanclass="special">::unique_lock<spanclass="special"><boost<spanclass="special">::timed_mutex<spanclass="special">></code>),- or the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code> concept</a> otherwise (e.g.- <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock<<spanclass="identifier">boost::<spanclass="identifier">mutex></code>).

-        </p>
-<p>

- An instance of <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock"title="Class template unique_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock</code></a> is said to <spanclass="emphasis">own- the lock state of a <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> <codeclass="computeroutput">m</code>- if <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns a pointer to <code class="computeroutput"><spanclass="identifier">m</code>- and <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">true</code>. If an object- that owns the lock stateof a <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object is destroyed,- then the destructor will invoke <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">mutex()-><spanclass="identifier">unlock()</code></a>.

-        </p>
-<p>

- The member functions of <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock"title="Class template unique_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock</code></a> are not thread-safe.- In particular, <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock"title="Class template unique_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock</code></a> is intended to model- the ownership of a <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object by a particular- thread, and the member functions that release ownership of thelock state- (including the destructor) must be called by the same threadthat acquired

-          ownership of the lock state.
-        </p>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.locks.unique_lock.defaultconstructor"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.defaultconstructor"title="unique_lock()">- <code class="computeroutput"><spanclass="identifier">unique_lock<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>
-                Creates a lock object with no associated mutex.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">false</code>. <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns <code class="computeroutput"><spanclass="identifier">NULL</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.unique_lock.constructor"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.constructor"title="unique_lock(Lockable & m)">- <code class="computeroutput"><spanclass="identifier">unique_lock(<spanclass="identifier">Lockable &- m<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Stores a reference to <code class="computeroutput"><spanclass="identifier">m</code>.- Invokes <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">m.<spanclass="identifier">lock()</code></a>.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">true</code>. <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns <code class="computeroutput"><spanclass="special">&m</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.locks.unique_lock.constructor_adopt"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.constructor_adopt"title="unique_lock(Lockable & m,boost::adopt_lock_t)">- <code class="computeroutput"><spanclass="identifier">unique_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::adopt_lock_t<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Precondition:</span></dt>
-<dd><p>

- The current thread owns an exclusive lock on <codeclass="computeroutput">m</code>.

-              </p></dd>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">true</code>. <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns <code class="computeroutput"><spanclass="special">&m</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.locks.unique_lock.constructor_defer"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.constructor_defer"title="unique_lock(Lockable & m,boost::defer_lock_t)">- <code class="computeroutput"><spanclass="identifier">unique_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::defer_lock_t<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Stores a reference to <code class="computeroutput"><spanclass="identifier">m</code>.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.unique_lock.constructor_try"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.constructor_try"title="unique_lock(Lockable & m,boost::try_to_lock_t)">- <code class="computeroutput"><spanclass="identifier">unique_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::try_to_lock_t<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Stores a reference to <code class="computeroutput"><spanclass="identifier">m</code>.- Invokes <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.try_lock"title="bool try_lock()"><code class="computeroutput"><spanclass="identifier">m.<spanclass="identifier">try_lock<spanclass="special">()</code></a>,- and takes ownership of the lock state if the call returns<code class="computeroutput">true</code>.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns <code class="computeroutput"><spanclass="special">&m</code>.- If the call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.try_lock"title="bool try_lock()"><code class="computeroutput"><spanclass="identifier">try_lock()</code></a>- returned <code class="computeroutput"><spanclass="keyword">true</code>, then- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">true</code>, otherwise- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">false</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.locks.unique_lock.constructor_abs_time"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.constructor_abs_time"title="unique_lock(Lockable & m,boost::system_time const&abs_time)">- <code class="computeroutput"><spanclass="identifier">unique_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::system_time <spanclass="keyword">const& <spanclass="identifier">abs_time)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Stores a reference to <code class="computeroutput"><spanclass="identifier">m</code>.- Invokes <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock"title="bool timed_lock(boost::system_time const& abs_time)"><codeclass="computeroutput">m<spanclass="special">.timed_lock<spanclass="special">(abs_time<spanclass="special">)</code></a>,- and takes ownership of the lock state if the call returns<code class="computeroutput">true</code>.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns <code class="computeroutput"><spanclass="special">&m</code>.- If the call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock"title="bool timed_lock(boost::system_time const& abs_time)"><codeclass="computeroutput">timed_lock<spanclass="special">()</code></a>- returned <code class="computeroutput"><spanclass="keyword">true</code>, then- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">true</code>, otherwise- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">false</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- Any exceptions thrown by the call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.timed_lockable.timed_lock"title="bool timed_lock(boost::system_time const& abs_time)"><codeclass="computeroutput">m<spanclass="special">.timed_lock<spanclass="special">(abs_time<spanclass="special">)</code></a>.

-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.unique_lock.destructor"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.destructor"title="~unique_lock()">- <code class="computeroutput">~<spanclass="identifier">unique_lock<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Invokes <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex<spanclass="special">()</code></a><code class="computeroutput"><spanclass="special">-></code> <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">unlock()</code></a>- if <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">true</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.unique_lock.owns_lock"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const">- <code class="computeroutput">boolowns_lock()const</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Returns:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="keyword">true</code> if the <codeclass="computeroutput">*<spanclass="keyword">this</code>- owns the lock on the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object associated- with <code class="computeroutput"><spanclass="special">*this</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.unique_lock.mutex"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const">- <code class="computeroutput"><spanclass="identifier">Lockable*- mutex<spanclass="special">()

-          <span class="keyword">const</span></code></a>
-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Returns:</span></dt>
-<dd><p>

- A pointer to the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object associated- with <code class="computeroutput"><spanclass="special">*this</code>,- or <code class="computeroutput"><spanclass="identifier">NULL</code> if there

-                is no such object.
-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.unique_lock.bool_conversion"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.bool_conversion"title="operator unspecified-bool-type() const">- <code class="computeroutput"><spanclass="keyword">operator <spanclass="identifier">unspecified-<spanclass="keyword">bool-<spanclass="identifier">type() <spanclass="keyword">const</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Returns:</span></dt>
-<dd><p>

- If <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- would return <code class="computeroutput"><spanclass="keyword">true</code>, a- value that evaluates to <code class="computeroutput"><spanclass="keyword">true</code>- in boolean contexts, otherwise a value that evaluates to<code class="computeroutput">false</code> inboolean contexts.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.unique_lock.operator_not"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.operator_not"title="bool operator!() const">- <code class="computeroutput">booloperator!() <spanclass="keyword">const</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Returns:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="special">!</code> <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.unique_lock.release"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.unique_lock.release"title="Lockable* release()">- <code class="computeroutput"><spanclass="identifier">Lockable*- release<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- The association between <code class="computeroutput"><spanclass="special">*this</code> and the <aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object is removed,- without affecting the lock state of the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object. If <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- would have returned <code class="computeroutput"><spanclass="keyword">true</code>,- it is the responsibility of the calling code to ensurethat the- <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> is correctly unlocked.

-              </p></dd>
-<dt><span class="term">Returns:</span></dt>
-<dd><p>

- A pointer to the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object associated- with <code class="computeroutput"><spanclass="special">*this</code>- at the point of the call, or <codeclass="computeroutput">NULL</code>

-                if there is no such object.
-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- <code class="computeroutput"><spanclass="special">*this</code>- is no longer associated with any <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object. <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns <code class="computeroutput"><spanclass="identifier">NULL</code> and- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">false</code>.

-              </p></dd>
-</dl>
-</div>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">

-<a name="thread.synchronization.locks.shared_lock"></a><a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock"title="Class template shared_lock"> Class template- <code class="computeroutput"><spanclass="identifier">shared_lock</code></a>

-</h4></div></div></div>
-<div class="toc"><dl>

-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.defaultconstructor">- <code class="computeroutput"><spanclass="identifier">shared_lock<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.constructor">- <code class="computeroutput"><spanclass="identifier">shared_lock(<spanclass="identifier">Lockable &- m<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.constructor_adopt">- <code class="computeroutput"><spanclass="identifier">shared_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::adopt_lock_t<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.constructor_defer">- <code class="computeroutput"><spanclass="identifier">shared_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::defer_lock_t<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.constructor_try">- <code class="computeroutput"><spanclass="identifier">shared_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::try_to_lock_t<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.constructor_abs_time">- <code class="computeroutput"><spanclass="identifier">shared_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::system_time <spanclass="keyword">const& <spanclass="identifier">abs_time<spanclass="special">)</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.destructor">- <code class="computeroutput">~<spanclass="identifier">shared_lock<spanclass="special">()</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.owns_lock">- <code class="computeroutput">boolowns_lock()const</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.mutex">- <code class="computeroutput"><spanclass="identifier">Lockable*- mutex<spanclass="special">()

-          <span class="keyword">const</span></code></a></span></dt>

-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.bool_conversion">- <code class="computeroutput"><spanclass="keyword">operator <spanclass="identifier">unspecified-<spanclass="keyword">bool-<spanclass="identifier">type() <spanclass="keyword">const</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.operator_not">- <code class="computeroutput">booloperator!() <spanclass="keyword">const</code></a></dt>-<dt><ahref="synchronization.html#thread.synchronization.locks.shared_lock.release">- <code class="computeroutput"><spanclass="identifier">Lockable*- release<spanclass="special">()</code></a></dt>

-</dl></div>

-<pre class="programlisting">#include<boost<spanclass="special">/thread<spanclass="special">/locks<spanclass="special">.hpp<spanclass="special">>

-<span class="special">{</span>
-<span class="keyword">public</span><span class="special">:</span>

- shared_lock<spanclass="special">();- explicit <spanclass="identifier">shared_lock(<spanclass="identifier">Lockable& <spanclass="identifier">m_);- shared_lock<spanclass="special">(Lockable<spanclass="special">& m_<spanclass="special">,adopt_lock_t<spanclass="special">);- shared_lock<spanclass="special">(Lockable<spanclass="special">& m_<spanclass="special">,defer_lock_t<spanclass="special">);- shared_lock<spanclass="special">(Lockable<spanclass="special">& m_<spanclass="special">,try_to_lock_t<spanclass="special">);- shared_lock<spanclass="special">(Lockable<spanclass="special">& m_<spanclass="special">,system_time <spanclass="keyword">const& <spanclass="identifier">target_time);- shared_lock<spanclass="special">(detail<spanclass="special">::thread_move_t<spanclass="special"><shared_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);- shared_lock<spanclass="special">(detail<spanclass="special">::thread_move_t<spanclass="special"><unique_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);- shared_lock<spanclass="special">(detail<spanclass="special">::thread_move_t<spanclass="special"><<spanclass="identifier">upgrade_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);

- ~<spanclass="identifier">shared_lock();

- shared_lock<spanclass="special">& operator<spanclass="special">=(detail<spanclass="special">::thread_move_t<spanclass="special"><shared_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);- shared_lock<spanclass="special">& operator<spanclass="special">=(detail<spanclass="special">::thread_move_t<spanclass="special"><unique_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);- shared_lock<spanclass="special">& operator<spanclass="special">=(detail<spanclass="special">::thread_move_t<spanclass="special"><<spanclass="identifier">upgrade_lock<spanclass="special"><Lockable<spanclass="special">> > <spanclass="identifier">other);- void <spanclass="identifier">swap(<spanclass="identifier">shared_lock&other);

- void <spanclass="identifier">lock();- bool <spanclass="identifier">try_lock();- bool <spanclass="identifier">timed_lock(<spanclass="identifier">boost::<spanclass="identifier">system_time <spanclass="keyword">const& <spanclass="identifier">target_time);- void <spanclass="identifier">unlock();

- operator <spanclass="emphasis">unspecified-bool-type<spanclass="special">() const<spanclass="special">;- bool <spanclass="keyword">operator!() <spanclass="keyword">const;- bool <spanclass="identifier">owns_lock() <spanclass="keyword">const;

-<span class="special">};</span>
-</pre>
-<p>

- Like <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock"title="Class template unique_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock</code></a>, <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock"title="Class template shared_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">shared_lock</code></a> models the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code> concept</a>, but rather than- acquiring unique ownership of the supplied <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object, locking an instance- of <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock"title="Class template shared_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">shared_lock</code></a> acquires shared ownership.

-        </p>
-<p>

- Like <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock"title="Class template unique_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">unique_lock</code></a>, not only does it- provide for RAII-style locking, it also allows for deferringacquiring- the lock until the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock"title="void lock()"><code class="computeroutput"><spanclass="identifier">lock()</code></a>- member function is called explicitly, or trying to acquire thelock in- a non-blocking fashion, or with a timeout. Consequently, <aclass="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock"title="void unlock()"><code class="computeroutput"><spanclass="identifier">unlock()</code></a>- is only called in the destructor if the lock object has lockedthe <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object, or otherwise- adopted a lock on the <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object.

-        </p>
-<p>

- An instance of <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock"title="Class template shared_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">shared_lock</code></a> is said to <spanclass="emphasis">own- the lock state of a <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> <codeclass="computeroutput">m</code>- if <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns a pointer to <code class="computeroutput"><spanclass="identifier">m</code>- and <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">true</code>. If an object- that owns the lock stateof a <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object is destroyed,- then the destructor will invoke <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.unlock_shared"title="void unlock_shared()"><code class="computeroutput"><spanclass="identifier">mutex()-><spanclass="identifier">unlock_shared<spanclass="special">()</code></a>.

-        </p>
-<p>

- The member functions of <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock"title="Class template shared_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">shared_lock</code></a> are not thread-safe.- In particular, <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock"title="Class template shared_lock"><code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">shared_lock</code></a> is intended to model- the shared ownership of a <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.lockable"title="Lockable Concept"><code class="computeroutput"><spanclass="identifier">Lockable</code></a> object by a particular- thread, and the member functions that release ownership of thelock state- (including the destructor) must be called by the same threadthat acquired

-          ownership of the lock state.
-        </p>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.locks.shared_lock.defaultconstructor"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.shared_lock.defaultconstructor"title="shared_lock()">- <code class="computeroutput"><spanclass="identifier">shared_lock<spanclass="special">()</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>
-                Creates a lock object with no associated mutex.
-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.shared_lock.constructor"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.shared_lock.constructor"title="shared_lock(Lockable & m)">- <code class="computeroutput"><spanclass="identifier">shared_lock(<spanclass="identifier">Lockable &- m<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">true</code>. <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns <code class="computeroutput"><spanclass="special">&m</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- Any exception thrown by the call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.lock_shared"title="void lock_shared()"><code class="computeroutput"><spanclass="identifier">m.<spanclass="identifier">lock_shared<spanclass="special">()</code></a>.

-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.locks.shared_lock.constructor_adopt"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.shared_lock.constructor_adopt"title="shared_lock(Lockable & m,boost::adopt_lock_t)">- <code class="computeroutput"><spanclass="identifier">shared_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::adopt_lock_t<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Precondition:</span></dt>
-<dd><p>

- The current thread owns an exclusive lock on <codeclass="computeroutput">m</code>.

-              </p></dd>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.locks.shared_lock.constructor_defer"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.shared_lock.constructor_defer"title="shared_lock(Lockable & m,boost::defer_lock_t)">- <code class="computeroutput"><spanclass="identifier">shared_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::defer_lock_t<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Stores a reference to <code class="computeroutput"><spanclass="identifier">m</code>.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">false</code>. <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns <code class="computeroutput"><spanclass="special">&m</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<a name="thread.synchronization.locks.shared_lock.constructor_try"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.shared_lock.constructor_try"title="shared_lock(Lockable & m,boost::try_to_lock_t)">- <code class="computeroutput"><spanclass="identifier">shared_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::try_to_lock_t<spanclass="special">)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Stores a reference to <code class="computeroutput"><spanclass="identifier">m</code>.- Invokes <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.try_lock_shared"title="bool try_lock_shared()"><code class="computeroutput"><spanclass="identifier">m.<spanclass="identifier">try_lock_shared<spanclass="special">()</code></a>,- and takes ownership of the lock state if the call returns<code class="computeroutput">true</code>.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns <code class="computeroutput"><spanclass="special">&m</code>.- If the call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.try_lock_shared"title="bool try_lock_shared()"><code class="computeroutput"><spanclass="identifier">try_lock_shared<spanclass="special">()</code></a>- returned <code class="computeroutput"><spanclass="keyword">true</code>, then- <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">true</code>, otherwise- <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">false</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>
-                Nothing.
-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">

-<aname="thread.synchronization.locks.shared_lock.constructor_abs_time"></a><aclass="link"href="synchronization.html#thread.synchronization.locks.shared_lock.constructor_abs_time"title="shared_lock(Lockable & m,boost::system_time const&abs_time)">- <code class="computeroutput"><spanclass="identifier">shared_lock(<spanclass="identifier">Lockable &- m<spanclass="special">,boost<spanclass="special">::system_time <spanclass="keyword">const& <spanclass="identifier">abs_time)</code></a>

-</h5></div></div></div>
-<div class="variablelist">
-<p class="title"><b></b></p>
-<dl>
-<dt><span class="term">Effects:</span></dt>
-<dd><p>

- Stores a reference to <code class="computeroutput"><spanclass="identifier">m</code>.- Invokes <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.timed_lock_shared"title="bool timed_lock_shared(boost::system_time const&abs_time)"><code class="computeroutput"><spanclass="identifier">m.<spanclass="identifier">timed_lock(<spanclass="identifier">abs_time)</code></a>,- and takes ownership of the lock state if the call returns<code class="computeroutput">true</code>.

-              </p></dd>
-<dt><span class="term">Postcondition:</span></dt>
-<dd><p>

- <a class="link"href="synchronization.html#thread.synchronization.locks.unique_lock.mutex"title="Lockable* mutex() const"><code class="computeroutput"><spanclass="identifier">mutex()</code></a>- returns <code class="computeroutput"><spanclass="special">&m</code>.- If the call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.timed_lock_shared"title="bool timed_lock_shared(boost::system_time const&abs_time)"><code class="computeroutput"><spanclass="identifier">timed_lock_shared<spanclass="special">()</code></a>- returned <code class="computeroutput"><spanclass="keyword">true</code>, then- <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">true</code>, otherwise- <a class="link"href="synchronization.html#thread.synchronization.locks.shared_lock.owns_lock"title="bool owns_lock() const"><code class="computeroutput"><spanclass="identifier">owns_lock<spanclass="special">()</code></a>- returns <code class="computeroutput"><spanclass="keyword">false</code>.

-              </p></dd>
-<dt><span class="term">Throws:</span></dt>
-<dd><p>

- Any exceptions thrown by the call to <a class="link"href="synchronization.html#thread.synchronization.mutex_concepts.shared_lockable.timed_lock_shared"title="bool timed_lock_shared(boost::system_time const&abs_time)"><code class="computeroutput"><spanclass="identifier">m.<spanclass="identifier">timed_lock(<spanclass="identifier">abs_time)</code></a>.

-              </p></dd>
-</dl>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="thread.synchronization.locks.shared_lock.destr

==============================================================================
Diff truncated at 200k characters

[boost-doc-zh commit] r243 - 修复升级至1.38.0版本时对 thread 译文的错误覆

Other related posts: