1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>History</title>
<link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset">
<link rel="up" href="../thread.html" title="Chapter 28. Thread 3.0.1">
<link rel="prev" href="build.html" title="Using and building the library">
<link rel="next" href="future.html" title="Future">
</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"><a href="http://www.boost.org/users/people.html">People</a></td>
<td align="center"><a href="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="build.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../thread.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="future.html"><img src="../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="thread.changes"></a><a class="link" href="changes.html" title="History">History</a>
</h2></div></div></div>
<h4>
<a name="thread.changes.h0"></a>
<span><a name="thread.changes.version_3_0_1___boost_1_51"></a></span><a class="link" href="changes.html#thread.changes.version_3_0_1___boost_1_51">Version
3.0.1 - boost 1.51</a>
</h4>
<p>
Deprecated features since boost 1.50 available only until boost 1.55:
</p>
<p>
These deprecated features will be provided by default up to boost 1.52. If
you don't want to include the deprecated features you could define BOOST_THREAD_DONT_PROVIDE_DEPRECATED_FEATURES_SINCE_V3_0_0.
Since 1.53 these features will not be included any more by default. Since this
version, if you want to include the deprecated features yet you could define
BOOST_THREAD_PROVIDE_DEPRECATED_FEATURES_SINCE_V3_0_0. These deprecated features
will be only available until boost 1.55, that is you have 1 year and a half
to move to the new features.
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
Time related functions don't using the Boost.Chrono library, use the chrono
overloads instead.
</li></ul></div>
<p>
Breaking changes when BOOST_THREAD_VERSION==3:
</p>
<p>
There are some new features which share the same interface but with different
behavior. These breaking features are provided by default when BOOST_THREAD_VERSION
is 3, but the user can however choose the version 2 behavior by defining the
corresponding macro. As for the deprecated features, these broken features
will be only available until boost 1.55.
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6229" target="_top">#6229</a>
Rename the unique_future to future following the c++11.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6266" target="_top">#6266</a>
Breaking change: thread destructor should call terminate if joinable.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6269" target="_top">#6269</a>
Breaking change: thread move assignment should call terminate if joinable.
</li>
</ul></div>
<p>
Fixed Bugs:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4258" target="_top">#4258</a>
Linking with boost thread does not work on mingw/gcc 4.5.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4885" target="_top">#4885</a>
Access violation in set_tss_data at process exit due to invalid assumption
about TlsAlloc.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6931" target="_top">#6931</a>
mutex waits forwever with Intel Compiler and /debug:parallel
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/7044" target="_top">#7044</a>
boost 1.50.0 header missing.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/7052" target="_top">#7052</a>
Thread: BOOST_THREAD_PROVIDES_DEPRECATED_FEATURES_SINCE_V3_0_0 only masks
thread::operator==, thread::operator!= forward declarations, not definitions.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/7066" target="_top">#7066</a>
An attempt to fix current_thread_tls_key static initialization order.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/7074" target="_top">#7074</a>
Multiply defined symbol boost::allocator_arg.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/7078" target="_top">#7078</a>
Trivial 64-bit warning fix on Windows for thread attribute stack size
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/7089" target="_top">#7089</a>
BOOST_THREAD_WAIT_BUG limits functionality without solving anything
</li>
</ul></div>
<h4>
<a name="thread.changes.h1"></a>
<span><a name="thread.changes.version_3_0_0___boost_1_50"></a></span><a class="link" href="changes.html#thread.changes.version_3_0_0___boost_1_50">Version
3.0.0 - boost 1.50</a>
</h4>
<p>
Breaking changes when BOOST_THREAD_VERSION==3:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6229" target="_top">#6229</a>
Breaking change: Rename the unique_future to future following the c++11.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6266" target="_top">#6266</a>
Breaking change: thread destructor should call terminate if joinable.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6269" target="_top">#6269</a>
Breaking change: thread move assignment should call terminate if joinable.
</li>
</ul></div>
<p>
New Features:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/1850" target="_top">#1850</a>
Request for unlock_guard to compliment lock_guard.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/2637" target="_top">#2637</a>
Request for shared_mutex duration timed_lock and timed_lock_shared.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/2741" target="_top">#2741</a>
Proposal to manage portable and non portable thread attributes.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/3567" target="_top">#3567</a>
Request for shared_lock_guard.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6194" target="_top">#6194</a>
Adapt to Boost.Move.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6195" target="_top">#6195</a>
c++11 compliance: Provide the standard time related interface using Boost.Chrono.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6217" target="_top">#6217</a>
Enhance Boost.Thread shared mutex interface following Howard Hinnant proposal.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6224" target="_top">#6224</a>
c++11 compliance: Add the use of standard noexcept on compilers supporting
them.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6225" target="_top">#6225</a>
Add the use of standard =delete defaulted operations on compilers supporting
them.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6226" target="_top">#6226</a>
c++11 compliance: Add explicit bool conversion from locks.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6228" target="_top">#6228</a>
Add promise constructor with allocator following the standard c++11.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6230" target="_top">#6230</a>
c++11 compliance: Follows the exception reporting mechanism as defined
in the c++11.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6231" target="_top">#6231</a>
Add BasicLockable requirements in the documentation to follow c++11.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6272" target="_top">#6272</a>
c++11 compliance: Add thread::id hash specialization.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6273" target="_top">#6273</a>
c++11 compliance: Add cv_status enum class and use it on the conditions
wait functions.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6342" target="_top">#6342</a>
c++11 compliance: Adapt the one_flag to the c++11 interface.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6671" target="_top">#6671</a>
upgrade_lock: missing mutex and release functions.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6672" target="_top">#6672</a>
upgrade_lock:: missing constructors from time related types.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6675" target="_top">#6675</a>
upgrade_lock:: missing non-member swap.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6676" target="_top">#6676</a>
lock conversion should be explicit.
</li>
<li class="listitem">
Added missing packaged_task::result_type and packaged_task:: constructor
with allocator.
</li>
<li class="listitem">
Added packaged_task::reset()
</li>
</ul></div>
<p>
Fixed Bugs:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/2380" target="_top">#2380</a>
boost::move from lvalue does not work with gcc.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/2430" target="_top">#2430</a>
shared_mutex for win32 doesn't have timed_lock_upgrade.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/2575" target="_top">#2575</a>
Bug- Boost 1.36.0 on Itanium platform.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/3160" target="_top">#3160</a>
Duplicate tutorial code in boost::thread.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4345" target="_top">#4345</a>
thread::id and joining problem with cascade of threads.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4521" target="_top">#4521</a>
Error using boost::move on packaged_task (MSVC 10).
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4711" target="_top">#4711</a>
Must use implementation details to return move-only types.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4921" target="_top">#4921</a>
BOOST_THREAD_USE_DLL and BOOST_THREAD_USE_LIB are crucial and need to be
documented.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5013" target="_top">#5013</a>
documentation: boost::thread: pthreas_exit causes terminate().
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5173" target="_top">#5173</a>
boost::this_thread::get_id is very slow.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5351" target="_top">#5351</a>
interrupt a future get boost::unknown_exception.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5516" target="_top">#5516</a>
Upgrade lock is not acquired when previous upgrade lock releases if another
read lock is present.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5990" target="_top">#5990</a>
shared_future<T>::get() has wrong return type.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6174" target="_top">#6174</a>
packaged_task doesn't correctly handle moving results.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6222" target="_top">#6222</a>
Compile error with SunStudio: unique_future move.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6354" target="_top">#6354</a>
PGI: Compiler threading support is not turned on.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6673" target="_top">#6673</a>
shared_lock: move assign doesn't works with c++11.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6674" target="_top">#6674</a>
shared_mutex: try_lock_upgrade_until doesn't works.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6908" target="_top">#6908</a>
Compile error due to unprotected definitions of _WIN32_WINNT and WINVER.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6940" target="_top">#6940</a>
TIME_UTC is a macro in C11.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6959" target="_top">#6959</a>
call of abs is ambiguous.
</li>
<li class="listitem">
Fix issue signaled on the ML with task_object(task_object const&) in
presence of task_object(task_object &&)
</li>
</ul></div>
<h4>
<a name="thread.changes.h2"></a>
<span><a name="thread.changes.version_2_1_1___boost_1_49"></a></span><a class="link" href="changes.html#thread.changes.version_2_1_1___boost_1_49">Version
2.1.1 - boost 1.49</a>
</h4>
<p>
Fixed Bugs:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/2309" target="_top">#2309</a>
Lack of g++ symbol visibility support in Boost.Thread.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/2639" target="_top">#2639</a>
documentation should be extended(defer_lock, try_to_lock, ...).
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/3639" target="_top">#3639</a>
Boost.Thread doesn't build with Sun-5.9 on Linux.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/3762" target="_top">#3762</a>
Thread can't be compiled with winscw (Codewarrior by Nokia).
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/3885" target="_top">#3885</a>
document about mix usage of boost.thread and native thread api.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/3975" target="_top">#3975</a>
Incorrect precondition for promise::set_wait_callback().
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4048" target="_top">#4048</a>
thread::id formatting involves locale
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4315" target="_top">#4315</a>
gcc 4.4 Warning: inline ... declared as dllimport: attribute ignored.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4480" target="_top">#4480</a>
OpenVMS patches for compiler issues workarounds.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4819" target="_top">#4819</a>
boost.thread's documentation misprints.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5423" target="_top">#5423</a>
thread issues with C++0x.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5617" target="_top">#5617</a>
boost::thread::id copy ctor.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5739" target="_top">#5739</a>
set-but-not-used warnings with gcc-4.6.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5826" target="_top">#5826</a>
threads.cpp: resource leak on threads creation failure.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5839" target="_top">#5839</a>
thread.cpp: ThreadProxy leaks on exceptions.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5859" target="_top">#5859</a>
win32 shared_mutex constructor leaks on exceptions.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6100" target="_top">#6100</a>
Compute hardware_concurrency() using get_nprocs() on GLIBC systems.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6168" target="_top">#6168</a>
recursive_mutex is using wrong config symbol (possible typo).
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6175" target="_top">#6175</a>
Compile error with SunStudio.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6200" target="_top">#6200</a>
patch to have condition_variable and mutex error better handle EINTR.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6207" target="_top">#6207</a>
shared_lock swap compiler error on clang 3.0 c++11.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6208" target="_top">#6208</a>
try_lock_wrapper swap compiler error on clang 3.0 c++11.
</li>
</ul></div>
<h4>
<a name="thread.changes.h3"></a>
<span><a name="thread.changes.version_2_1_0___changes_since_boost_1_40"></a></span><a class="link" href="changes.html#thread.changes.version_2_1_0___changes_since_boost_1_40">Version 2.1.0
- Changes since boost 1.40</a>
</h4>
<p>
The 1.41.0 release of Boost adds futures to the thread library. There are also
a few minor changes.
</p>
<h4>
<a name="thread.changes.h4"></a>
<span><a name="thread.changes.changes_since_boost_1_35"></a></span><a class="link" href="changes.html#thread.changes.changes_since_boost_1_35">Changes
since boost 1.35</a>
</h4>
<p>
The 1.36.0 release of Boost includes a few new features in the thread library:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
New generic <a class="link" href="synchronization.html#thread.synchronization.lock_functions.lock_multiple" title="Non-member function lock(Lockable1,Lockable2,...)"><code class="computeroutput"><span class="identifier">lock</span><span class="special">()</span></code></a>
and <a class="link" href="synchronization.html#thread.synchronization.lock_functions.try_lock_multiple" title="Non-member function try_lock(Lockable1,Lockable2,...)"><code class="computeroutput"><span class="identifier">try_lock</span><span class="special">()</span></code></a>
functions for locking multiple mutexes at once.
</li>
<li class="listitem">
Rvalue reference support for move semantics where the compilers supports
it.
</li>
<li class="listitem">
A few bugs fixed and missing functions added (including the serious win32
condition variable bug).
</li>
<li class="listitem">
<code class="computeroutput"><span class="identifier">scoped_try_lock</span></code> types are
now backwards-compatible with Boost 1.34.0 and previous releases.
</li>
<li class="listitem">
Support for passing function arguments to the thread function by supplying
additional arguments to the <a class="link" href="thread_management.html#thread.thread_management.thread" title="Class thread"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span></code></a> constructor.
</li>
<li class="listitem">
Backwards-compatibility overloads added for <code class="computeroutput"><span class="identifier">timed_lock</span></code>
and <code class="computeroutput"><span class="identifier">timed_wait</span></code> functions
to allow use of <code class="computeroutput"><span class="identifier">xtime</span></code> for
timeouts.
</li>
</ul></div>
<h4>
<a name="thread.changes.h5"></a>
<span><a name="thread.changes.version_2_0_0___changes_since_boost_1_34"></a></span><a class="link" href="changes.html#thread.changes.version_2_0_0___changes_since_boost_1_34">Version 2.0.0
- Changes since boost 1.34</a>
</h4>
<p>
Almost every line of code in <span class="bold"><strong>Boost.Thread</strong></span>
has been changed since the 1.34 release of boost. However, most of the interface
changes have been extensions, so the new code is largely backwards-compatible
with the old code. The new features and breaking changes are described below.
</p>
<h4>
<a name="thread.changes.h6"></a>
<span><a name="thread.changes.new_features"></a></span><a class="link" href="changes.html#thread.changes.new_features">New
Features</a>
</h4>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
Instances of <a class="link" href="thread_management.html#thread.thread_management.thread" title="Class thread"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span></code></a> and of the various lock
types are now movable.
</li>
<li class="listitem">
Threads can be interrupted at <a class="link" href="thread_management.html#interruption_points"><span class="emphasis"><em>interruption
points</em></span></a>.
</li>
<li class="listitem">
Condition variables can now be used with any type that implements the
<a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.lockable" title="Lockable Concept"><code class="computeroutput"><span class="identifier">Lockable</span></code> concept</a>, through the
use of <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">condition_variable_any</span></code> (<code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">condition</span></code> is a <code class="computeroutput"><span class="keyword">typedef</span></code>
to <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">condition_variable_any</span></code>, provided for
backwards compatibility). <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">condition_variable</span></code>
is provided as an optimization, and will only work with <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">unique_lock</span><span class="special"><</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span><span class="special">></span></code> (<code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span><span class="special">::</span><span class="identifier">scoped_lock</span></code>).
</li>
<li class="listitem">
Thread IDs are separated from <a class="link" href="thread_management.html#thread.thread_management.thread" title="Class thread"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span></code></a>, so a thread can obtain
it's own ID (using <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">this_thread</span><span class="special">::</span><span class="identifier">get_id</span><span class="special">()</span></code>), and IDs can be used as keys in associative
containers, as they have the full set of comparison operators.
</li>
<li class="listitem">
Timeouts are now implemented using the Boost DateTime library, through
a typedef <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">system_time</span></code> for absolute timeouts, and
with support for relative timeouts in many cases. <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">xtime</span></code>
is supported for backwards compatibility only.
</li>
<li class="listitem">
Locks are implemented as publicly accessible templates <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">lock_guard</span></code>,
<code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">unique_lock</span></code>, <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">shared_lock</span></code>,
and <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">upgrade_lock</span></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"><span class="identifier">Lockable</span></code> concept</a> has been extended
to include publicly available <a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.basic_lockable.lock" title="m.lock();"><code class="computeroutput"><span class="identifier">lock</span><span class="special">()</span></code></a>
and <a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.basic_lockable.unlock" title="m.unlock();"><code class="computeroutput"><span class="identifier">unlock</span><span class="special">()</span></code></a>
member functions, which are used by the lock types.
</li>
</ul></div>
<h4>
<a name="thread.changes.h7"></a>
<span><a name="thread.changes.breaking_changes"></a></span><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 interface which break
backwards compatibility.
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<a class="link" href="synchronization.html#thread.synchronization.mutex_types.try_mutex" title="Typedef try_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">try_mutex</span></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"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span></code></a>. <a class="link" href="synchronization.html#thread.synchronization.mutex_types.try_mutex" title="Typedef try_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">try_mutex</span></code></a> is left as a <code class="computeroutput"><span class="keyword">typedef</span></code>, but is no longer a separate class.
</li>
<li class="listitem">
<a class="link" href="synchronization.html#thread.synchronization.mutex_types.recursive_try_mutex" title="Typedef recursive_try_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">recursive_try_mutex</span></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"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">recursive_mutex</span></code></a>. <a class="link" href="synchronization.html#thread.synchronization.mutex_types.recursive_try_mutex" title="Typedef recursive_try_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">recursive_try_mutex</span></code></a> is left as
a <code class="computeroutput"><span class="keyword">typedef</span></code>, but is no longer
a separate class.
</li>
<li class="listitem">
<code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">detail</span><span class="special">::</span><span class="identifier">thread</span><span class="special">::</span><span class="identifier">lock_ops</span></code> has been removed. Code that
relies on the <code class="computeroutput"><span class="identifier">lock_ops</span></code>
implementation detail will no longer work, as this has been removed, as
it is no longer necessary now that mutex types now have public <a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.basic_lockable.lock" title="m.lock();"><code class="computeroutput"><span class="identifier">lock</span><span class="special">()</span></code></a>
and <a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.basic_lockable.unlock" title="m.unlock();"><code class="computeroutput"><span class="identifier">unlock</span><span class="special">()</span></code></a>
member functions.
</li>
<li class="listitem">
<code class="computeroutput"><span class="identifier">scoped_lock</span></code> constructors
with a second parameter of type <code class="computeroutput"><span class="keyword">bool</span></code>
are no longer provided. With previous boost releases,
<pre class="programlisting"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span><span class="special">::</span><span class="identifier">scoped_lock</span> <span class="identifier">some_lock</span><span class="special">(</span><span class="identifier">some_mutex</span><span class="special">,</span><span class="keyword">false</span><span class="special">);</span></pre>
could be used to create a lock object that was associated with a mutex,
but did not lock it on construction. This facility has now been replaced
with the constructor that takes a <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">defer_lock_type</span></code>
as the second parameter:
<pre class="programlisting"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span><span class="special">::</span><span class="identifier">scoped_lock</span> <span class="identifier">some_lock</span><span class="special">(</span><span class="identifier">some_mutex</span><span class="special">,</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">defer_lock</span><span class="special">);</span></pre>
</li>
<li class="listitem">
The <code class="computeroutput"><span class="identifier">locked</span><span class="special">()</span></code>
member function of the <code class="computeroutput"><span class="identifier">scoped_lock</span></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"><span class="identifier">owns_lock</span><span class="special">()</span></code></a>.
</li>
<li class="listitem">
You can no longer obtain a <a class="link" href="thread_management.html#thread.thread_management.thread" title="Class thread"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span></code></a> instance representing the
current thread: a default-constructed <a class="link" href="thread_management.html#thread.thread_management.thread" title="Class thread"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span></code></a> object is not associated
with any thread. The only use for such a thread object was to support the
comparison operators: this functionality has been moved to <a class="link" href="thread_management.html#thread.thread_management.thread.id" title="Class boost::thread::id"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span><span class="special">::</span><span class="identifier">id</span></code></a>.
</li>
<li class="listitem">
The broken <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">read_write_mutex</span></code> has been replaced with
<a class="link" href="synchronization.html#thread.synchronization.mutex_types.shared_mutex" title="Class shared_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">shared_mutex</span></code></a>.
</li>
<li class="listitem">
<a class="link" href="synchronization.html#thread.synchronization.mutex_types.mutex" title="Class mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span></code></a> is now never recursive.
For Boost releases prior to 1.35 <a class="link" href="synchronization.html#thread.synchronization.mutex_types.mutex" title="Class mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span></code></a> was recursive on Windows
and not on POSIX platforms.
</li>
<li class="listitem">
When using a <a class="link" href="synchronization.html#thread.synchronization.mutex_types.recursive_mutex" title="Class recursive_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">recursive_mutex</span></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"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">condition_variable_any</span><span class="special">::</span><span class="identifier">wait</span><span class="special">()</span></code></a>,
the mutex is only unlocked one level, and not completely. This prior 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 -11 Anthony Williams<br>Copyright © 2011 -12 Vicente J. Botet Escriba<p>
Distributed under the Boost Software License, Version 1.0. (See accompanying
file LICENSE_1_0.txt or copy at <a href="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">
<a accesskey="p" href="build.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../thread.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="future.html"><img src="../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>
|
