blob: 637a4849e471fbd6e498450602d900d20cc7cc77 [file] [log] [blame]
Eric Fiselier4e860492019-01-16 01:37:43 +00001.. _FeatureTestMacroTable:
2
3==========================
4Feature Test Macro Support
5==========================
6
7.. contents::
8 :local:
9
10Overview
11========
12
13This file documents the feature test macros currently supported by libc++.
14
15.. _feature-status:
16
17Status
18======
19
20.. table:: Current Status
21 :name: feature-status-table
22 :widths: auto
Louis Dionne1b335f72019-11-14 08:54:23 -050023
Eric Fiselier4e860492019-01-16 01:37:43 +000024 ================================================= =================
Louis Dionne13dd7b82020-09-22 08:38:57 -040025 Macro Name Value
Eric Fiselier4e860492019-01-16 01:37:43 +000026 ================================================= =================
Louis Dionne13dd7b82020-09-22 08:38:57 -040027 **C++ 14**
Eric Fiselier4e860492019-01-16 01:37:43 +000028 -------------------------------------------------------------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040029 ``__cpp_lib_chrono_udls`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000030 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040031 ``__cpp_lib_complex_udls`` ``201309L``
Eric Fiselier4e860492019-01-16 01:37:43 +000032 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040033 ``__cpp_lib_exchange_function`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000034 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040035 ``__cpp_lib_generic_associative_lookup`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000036 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040037 ``__cpp_lib_integer_sequence`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000038 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040039 ``__cpp_lib_integral_constant_callable`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000040 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040041 ``__cpp_lib_is_final`` ``201402L``
Eric Fiselier4e860492019-01-16 01:37:43 +000042 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040043 ``__cpp_lib_is_null_pointer`` ``201309L``
Eric Fiselier4e860492019-01-16 01:37:43 +000044 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040045 ``__cpp_lib_make_reverse_iterator`` ``201402L``
Eric Fiselier4e860492019-01-16 01:37:43 +000046 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040047 ``__cpp_lib_make_unique`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000048 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040049 ``__cpp_lib_null_iterators`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000050 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040051 ``__cpp_lib_quoted_string_io`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000052 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040053 ``__cpp_lib_result_of_sfinae`` ``201210L``
Eric Fiselier4e860492019-01-16 01:37:43 +000054 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040055 ``__cpp_lib_robust_nonmodifying_seq_ops`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000056 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040057 ``__cpp_lib_shared_timed_mutex`` ``201402L``
Eric Fiselier4e860492019-01-16 01:37:43 +000058 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040059 ``__cpp_lib_string_udls`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000060 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040061 ``__cpp_lib_transformation_trait_aliases`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000062 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040063 ``__cpp_lib_transparent_operators`` ``201210L``
Eric Fiselier4e860492019-01-16 01:37:43 +000064 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040065 ``__cpp_lib_tuple_element_t`` ``201402L``
Eric Fiselier4e860492019-01-16 01:37:43 +000066 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040067 ``__cpp_lib_tuples_by_type`` ``201304L``
Eric Fiselier4e860492019-01-16 01:37:43 +000068 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040069 **C++ 17**
Eric Fiselier4e860492019-01-16 01:37:43 +000070 -------------------------------------------------------------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040071 ``__cpp_lib_addressof_constexpr`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +000072 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040073 ``__cpp_lib_allocator_traits_is_always_equal`` ``201411L``
Eric Fiselier4e860492019-01-16 01:37:43 +000074 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040075 ``__cpp_lib_any`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +000076 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040077 ``__cpp_lib_apply`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +000078 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040079 ``__cpp_lib_array_constexpr`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +000080 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040081 ``__cpp_lib_as_const`` ``201510L``
Eric Fiselier4e860492019-01-16 01:37:43 +000082 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040083 ``__cpp_lib_atomic_is_always_lock_free`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +000084 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040085 ``__cpp_lib_bool_constant`` ``201505L``
Eric Fiselier4e860492019-01-16 01:37:43 +000086 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040087 ``__cpp_lib_boyer_moore_searcher`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +000088 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040089 ``__cpp_lib_byte`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +000090 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040091 ``__cpp_lib_chrono`` ``201611L``
Eric Fiselier4e860492019-01-16 01:37:43 +000092 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040093 ``__cpp_lib_clamp`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +000094 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040095 ``__cpp_lib_enable_shared_from_this`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +000096 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040097 ``__cpp_lib_execution`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +000098 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -040099 ``__cpp_lib_filesystem`` ``201703L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000100 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400101 ``__cpp_lib_gcd_lcm`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000102 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400103 ``__cpp_lib_hardware_interference_size`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000104 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400105 ``__cpp_lib_has_unique_object_representations`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000106 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400107 ``__cpp_lib_hypot`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000108 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400109 ``__cpp_lib_incomplete_container_elements`` ``201505L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000110 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400111 ``__cpp_lib_invoke`` ``201411L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000112 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400113 ``__cpp_lib_is_aggregate`` ``201703L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000114 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400115 ``__cpp_lib_is_invocable`` ``201703L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000116 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400117 ``__cpp_lib_is_swappable`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000118 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400119 ``__cpp_lib_launder`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000120 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400121 ``__cpp_lib_logical_traits`` ``201510L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000122 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400123 ``__cpp_lib_make_from_tuple`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000124 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400125 ``__cpp_lib_map_try_emplace`` ``201411L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000126 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400127 ``__cpp_lib_math_special_functions`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000128 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400129 ``__cpp_lib_memory_resource`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000130 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400131 ``__cpp_lib_node_extract`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000132 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400133 ``__cpp_lib_nonmember_container_access`` ``201411L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000134 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400135 ``__cpp_lib_not_fn`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000136 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400137 ``__cpp_lib_optional`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000138 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400139 ``__cpp_lib_parallel_algorithm`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000140 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400141 ``__cpp_lib_raw_memory_algorithms`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000142 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400143 ``__cpp_lib_sample`` ``201603L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000144 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400145 ``__cpp_lib_scoped_lock`` ``201703L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000146 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400147 ``__cpp_lib_shared_mutex`` ``201505L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000148 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400149 ``__cpp_lib_shared_ptr_arrays`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000150 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400151 ``__cpp_lib_shared_ptr_weak_type`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000152 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400153 ``__cpp_lib_string_view`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000154 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400155 ``__cpp_lib_to_chars`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000156 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400157 ``__cpp_lib_transparent_operators`` ``201510L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000158 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400159 ``__cpp_lib_type_trait_variable_templates`` ``201510L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000160 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400161 ``__cpp_lib_uncaught_exceptions`` ``201411L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000162 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400163 ``__cpp_lib_unordered_map_try_emplace`` ``201411L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000164 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400165 ``__cpp_lib_variant`` ``201606L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000166 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400167 ``__cpp_lib_void_t`` ``201411L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000168 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400169 **C++ 2a**
Eric Fiselier4e860492019-01-16 01:37:43 +0000170 -------------------------------------------------------------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400171 ``__cpp_lib_array_constexpr`` ``201811L``
Louis Dionne44704ce2020-05-22 09:59:48 -0400172 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400173 ``__cpp_lib_atomic_flag_test`` ``201907L``
Olivier Girouxdf5bfa32020-09-09 10:00:09 -0700174 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400175 ``__cpp_lib_atomic_float`` *unimplemented*
Olivier Girouxdf5bfa32020-09-09 10:00:09 -0700176 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400177 ``__cpp_lib_atomic_lock_free_type_aliases`` ``201907L``
Olivier Girouxdf5bfa32020-09-09 10:00:09 -0700178 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400179 ``__cpp_lib_atomic_ref`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000180 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400181 ``__cpp_lib_atomic_shared_ptr`` *unimplemented*
Olivier Girouxdf5bfa32020-09-09 10:00:09 -0700182 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400183 ``__cpp_lib_atomic_value_initialization`` *unimplemented*
Olivier Girouxdf5bfa32020-09-09 10:00:09 -0700184 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400185 ``__cpp_lib_atomic_wait`` ``201907L``
Olivier Girouxdf5bfa32020-09-09 10:00:09 -0700186 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400187 ``__cpp_lib_bind_front`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000188 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400189 ``__cpp_lib_bit_cast`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000190 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400191 ``__cpp_lib_char8_t`` ``201811L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000192 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400193 ``__cpp_lib_concepts`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000194 ------------------------------------------------- -----------------
Louis Dionne99f59432020-09-17 12:06:13 -0400195 ``__cpp_lib_constexpr_dynamic_alloc`` ``201907L``
196 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400197 ``__cpp_lib_constexpr_misc`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000198 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400199 ``__cpp_lib_constexpr_swap_algorithms`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000200 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400201 ``__cpp_lib_constexpr_utility`` ``201811L``
Michael Schellenberger Costad41ace62020-09-02 21:20:33 +0200202 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400203 ``__cpp_lib_destroying_delete`` ``201806L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000204 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400205 ``__cpp_lib_endian`` ``201907L``
Louis Dionne1b335f72019-11-14 08:54:23 -0500206 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400207 ``__cpp_lib_erase_if`` ``202002L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000208 ------------------------------------------------- -----------------
Ruslan Arutyunyan44234392020-11-10 07:49:55 -0500209 ``__cpp_lib_generic_unordered_lookup`` ``201811L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000210 ------------------------------------------------- -----------------
Mark de Wever896e0742020-11-24 14:50:49 +0100211 ``__cpp_lib_int_pow2`` ``202002L``
212 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400213 ``__cpp_lib_interpolate`` ``201902L``
Marshall Clow174901e2019-04-25 12:11:43 +0000214 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400215 ``__cpp_lib_is_constant_evaluated`` ``201811L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000216 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400217 ``__cpp_lib_list_remove_return_type`` ``201806L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000218 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400219 ``__cpp_lib_math_constants`` ``201907L``
Raul Tambreafcedea2020-06-19 12:43:33 +0530220 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400221 ``__cpp_lib_ranges`` *unimplemented*
Eric Fiselier4e860492019-01-16 01:37:43 +0000222 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400223 ``__cpp_lib_span`` ``202002L``
Michael Schellenberger Costaea234282020-05-13 09:50:06 -0400224 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400225 ``__cpp_lib_three_way_comparison`` *unimplemented*
Marek Kurdej0d715672020-01-30 13:27:35 +0100226 ------------------------------------------------- -----------------
Louis Dionne13dd7b82020-09-22 08:38:57 -0400227 ``__cpp_lib_to_array`` ``201907L``
Eric Fiselier4e860492019-01-16 01:37:43 +0000228 ================================================= =================
229