| CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Thu, 31 Jul 2025 09:20:11 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/future/promise/~promise/
HTTP/1.1 200 OK
Server: nginx
Date: Thu, 31 Jul 2025 09:20:11 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"6c27-8x7T0CM7rEgUUxK+JRPGma5c26w"
Content-Encoding: gzip
Abandons the shared state (if any) and destroys the promise object.
Note that if other (future) objects are associated to the same shared state, the shared state is itself not destroyed (until all those objects also release it).
If the object is destroyed before its shared state has been made ready (by explicitly setting a value or reference to it), the shared state is automatically made ready containing an exception of type future_error (with a broken_promise error condition).
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
<future>
classes
-
futureC++11
-
future_errorC++11
-
packaged_taskC++11
-
promiseC++11
-
shared_futureC++11
-
enum classes
-
future_errcC++11
-
future_statusC++11
-
launchC++11
-
functions
-
asyncC++11
-
future_categoryC++11
-
promise
-
promise::~promiseC++11
-
promise::promiseC++11
member functions
-
promise::get_futureC++11
-
promise::operator=C++11
-
promise::set_exceptionC++11
-
promise::set_exception_at_thread_exitC++11
-
promise::set_valueC++11
-
promise::set_value_at_thread_exitC++11
-
promise::swapC++11
-
non-member overloads
-
swap (promise)C++11
-
non-member specializations
-
uses_allocator<promise>C++11
-
public member function
<future>
std::promise::~promise
~promise();
Destroy promise
Note that if other (future) objects are associated to the same shared state, the shared state is itself not destroyed (until all those objects also release it).
If the object is destroyed before its shared state has been made ready (by explicitly setting a value or reference to it), the shared state is automatically made ready containing an exception of type future_error (with a broken_promise error condition).
Exception safety
No-throw guarantee: never throws exceptions.
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us