SeqAn3 3.2.0
The Modern C++ library for sequence analysis.
traits.hpp
Go to the documentation of this file.
1// -----------------------------------------------------------------------------------------------------
2// Copyright (c) 2006-2022, Knut Reinert & Freie Universität Berlin
3// Copyright (c) 2016-2022, Knut Reinert & MPI für molekulare Genetik
4// This file may be used, modified and/or redistributed under the terms of the 3-clause BSD-License
5// shipped with this file and also available at: https://github.com/seqan/seqan3/blob/master/LICENSE.md
6// -----------------------------------------------------------------------------------------------------
7
13#pragma once
14
15#include <type_traits>
16
19
20// ----------------------------------------------------------------------------
21// seqan3::list_traits::detail
22// ----------------------------------------------------------------------------
23
24namespace seqan3::list_traits::detail
25{
26
32template <ptrdiff_t idx, typename... pack_t>
33std::type_identity<seqan3::pack_traits::at<idx, pack_t...>> at(type_list<pack_t...>);
34
39template <typename... pack_t>
40std::type_identity<seqan3::pack_traits::front<pack_t...>> front(type_list<pack_t...>);
41
46template <typename... pack_t>
47std::type_identity<seqan3::pack_traits::back<pack_t...>> back(type_list<pack_t...>);
48
54template <typename... pack1_t, typename... pack2_t>
55type_list<pack1_t..., pack2_t...> concat(type_list<pack1_t...>, type_list<pack2_t...>);
56
63template <typename... pack1_t, typename... pack2_t, typename... more_lists_t>
64auto concat(type_list<pack1_t...>, type_list<pack2_t...>, more_lists_t...)
65{
66 return concat(type_list<pack1_t..., pack2_t...>{}, more_lists_t{}...);
67}
68
73template <typename... pack_t>
74pack_traits::drop_front<pack_t...> drop_front(type_list<pack_t...>);
75
81template <template <typename> typename trait_t, typename... pack_t>
82pack_traits::transform<trait_t, pack_t...> transform(type_list<pack_t...>);
83
89template <ptrdiff_t idx, typename... pack1_t>
90pack_traits::split_after<idx, pack1_t...> split_after(type_list<pack1_t...>);
91
97template <size_t count, typename t>
98auto repeat()
99{
100 if constexpr (count == 0)
101 return type_list<>{};
102 else if constexpr (count == 1)
103 return type_list<t>{};
104 else if constexpr (count == 2)
105 return type_list<t, t>{};
106 else if constexpr (count == 3)
107 return type_list<t, t, t>{};
108 else if constexpr (count == 4)
109 return type_list<t, t, t, t>{};
110 else if constexpr (count == 5)
111 return type_list<t, t, t, t, t>{};
112 else
113 return concat(repeat<5, t>(), repeat<count - 5, t>());
114}
115
122template <typename replace_t, ptrdiff_t idx, typename... pack_t>
123pack_traits::replace_at<replace_t, idx, pack_t...> replace_at(type_list<pack_t...>);
124
126inline constexpr type_list<> reverse(type_list<>)
127{
128 return {};
129}
130
132template <typename head_t, typename... pack_t>
133auto reverse(type_list<head_t, pack_t...>)
134{
135 return concat(reverse(type_list<pack_t...>{}), type_list<head_t>{});
136}
137
139template <typename... current_list_t>
140constexpr seqan3::type_list<current_list_t...> type_list_difference(seqan3::type_list<current_list_t...>,
142{
143 return {};
144}
145
147template <typename... current_list_t, typename remove_t, typename... remove_list_t>
149{
150 constexpr auto pos = seqan3::pack_traits::find<remove_t, current_list_t...>;
151 if constexpr (pos >= 0)
152 {
153 using split_list_t = seqan3::pack_traits::split_after<pos, current_list_t...>;
154
155 using split_list1_t = typename split_list_t::first_type;
156 using split_list2_t = decltype(drop_front(typename split_list_t::second_type{}));
157 using filtered_list_t = decltype(concat(split_list1_t{}, split_list2_t{}));
158 return type_list_difference(filtered_list_t{}, seqan3::type_list<remove_t, remove_list_t...>{});
159 }
160 else
161 {
162 // remove_t not contained in current_list_t
163 using filtered_list_t = seqan3::type_list<current_list_t...>;
164 return type_list_difference(filtered_list_t{}, seqan3::type_list<remove_list_t...>{});
165 }
166}
167
168} // namespace seqan3::list_traits::detail
169
170// ----------------------------------------------------------------------------
171// seqan3::list_traits
172// ----------------------------------------------------------------------------
173
175namespace seqan3::list_traits
176{
177
183template <typename list_t>
184 requires seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>
185inline constexpr size_t size = 0;
187
194template <typename... pack_t>
195inline constexpr size_t size<type_list<pack_t...>> = sizeof...(pack_t);
196
198template <typename query_t, typename list_t>
199 requires seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>
200inline constexpr ptrdiff_t count = -1;
202
209template <typename query_t, typename... pack_t>
210inline constexpr ptrdiff_t count<query_t, type_list<pack_t...>> = seqan3::pack_traits::count<query_t, pack_t...>;
211
213template <typename query_t, typename list_t>
214 requires seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>
215inline constexpr ptrdiff_t find = -1;
217
224template <typename query_t, typename... pack_t>
225inline constexpr ptrdiff_t find<query_t, type_list<pack_t...>> =
226 seqan3::pack_traits::detail::find<query_t, pack_t...>();
227
229template <template <typename> typename pred_t, typename list_t>
230 requires seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>
231inline constexpr ptrdiff_t find_if = -1;
233
240template <template <typename> typename pred_t, typename... pack_t>
241inline constexpr ptrdiff_t find_if<pred_t, type_list<pack_t...>> =
242 seqan3::pack_traits::detail::find_if<pred_t, pack_t...>();
243
250template <typename query_t, typename list_t>
251 requires seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>
252inline constexpr bool contains = (find<query_t, list_t> != -1);
253
255
276template <ptrdiff_t idx, typename list_t>
277 requires (seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>)
278 && ((idx >= 0 && idx < size<list_t>) || (-idx <= size<list_t>))
279using at = typename decltype(detail::at<idx>(list_t{}))::type;
280
294template <typename list_t>
295 requires (seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>) && (size<list_t> > 0)
296using front = typename decltype(detail::front(list_t{}))::type;
297
314template <typename list_t>
315 requires (seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>) && (size<list_t> > 0)
316using back = typename decltype(detail::back(list_t{}))::type;
317
319
340template <typename... lists_t>
341 requires (seqan3::detail::template_specialisation_of<lists_t, seqan3::type_list> && ...)
342using concat = decltype(detail::concat(lists_t{}...));
343
357template <typename list_t>
358 requires (seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>) && (size<list_t> > 0)
359using drop_front = decltype(detail::drop_front(list_t{}));
360
375template <ptrdiff_t i, typename list_t>
376 requires (seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>) && (i >= 0 && i <= size<list_t>)
377using take = typename decltype(detail::split_after<i>(list_t{}))::first_type;
378
393template <ptrdiff_t i, typename list_t>
394 requires (seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>) && (i >= 0 && i <= size<list_t>)
395using drop = typename decltype(detail::split_after<i>(list_t{}))::second_type;
396
411template <ptrdiff_t i, typename list_t>
412 requires (seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>) && (i >= 0 && i <= size<list_t>)
413using take_last = drop<size<list_t> - i, list_t>;
414
429template <ptrdiff_t i, typename list_t>
430 requires (seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>) && (i >= 0 && i <= size<list_t>)
431using drop_last = take<size<list_t> - i, list_t>;
432
447template <ptrdiff_t i, typename list_t>
448 requires (seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>) && (i >= 0 && i <= size<list_t>)
449using split_after = decltype(detail::split_after<i>(list_t{}));
450
468template <template <typename> typename trait_t, typename list_t>
469 requires seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>
470using transform = decltype(detail::transform<trait_t>(list_t{}));
471
487template <typename replace_t, std::ptrdiff_t i, typename list_t>
488 requires (seqan3::detail::template_specialisation_of<list_t, seqan3::type_list>) && (i >= 0 && i < size<list_t>)
489using replace_at = decltype(detail::replace_at<replace_t, i>(list_t{}));
490
503template <size_t count, typename t>
504using repeat = decltype(detail::repeat<count, t>());
506
507} // namespace seqan3::list_traits
decltype(detail::split_after< i >(list_t{})) split_after
Split a seqan3::type_list into two parts returned as a pair of seqan3::type_list.
Definition: traits.hpp:449
typename decltype(detail::split_after< i >(list_t{}))::first_type take
Return a seqan3::type_list of the first n types in the input type list.
Definition: traits.hpp:377
decltype(detail::concat(lists_t{}...)) concat
Join two seqan3::type_list s into one.
Definition: traits.hpp:342
constexpr bool contains
Whether a type occurs in a type list or not.
Definition: traits.hpp:252
drop< size< list_t > - i, list_t > take_last
Return a seqan3::type_list of the last n types in the input type list.
Definition: traits.hpp:413
typename decltype(detail::front(list_t{}))::type front
Return the first type from the type list.
Definition: traits.hpp:296
take< size< list_t > - i, list_t > drop_last
Return a seqan3::type_list of the types the input type list, except the last n.
Definition: traits.hpp:431
decltype(detail::replace_at< replace_t, i >(list_t{})) replace_at
Replace the type at the given index with the given type.
Definition: traits.hpp:489
decltype(detail::repeat< count, t >()) repeat
Create a type list with the given type repeated count times..
Definition: traits.hpp:504
typename decltype(detail::split_after< i >(list_t{}))::second_type drop
Return a seqan3::type_list of the types in the input type list, except the first n.
Definition: traits.hpp:395
typename decltype(detail::at< idx >(list_t{}))::type at
Return the type at given index from the type list.
Definition: traits.hpp:279
decltype(detail::transform< trait_t >(list_t{})) transform
Apply a transformation trait to every type in the list and return a seqan3::type_list of the results.
Definition: traits.hpp:470
typename decltype(detail::back(list_t{}))::type back
Return the last type from the type list.
Definition: traits.hpp:316
decltype(detail::drop_front(list_t{})) drop_front
Return a seqan3::type_list of all the types in the type list, except the first.
Definition: traits.hpp:359
decltype(detail::replace_at< replace_t, i, pack_t... >(std::make_index_sequence< size< pack_t... > >{})) replace_at
Replace the type at the given index with the given type.
Definition: traits.hpp:443
typename decltype(detail::drop_front< pack_t... >())::type drop_front
Return a seqan3::type_list of all the types in the type pack, except the first.
Definition: traits.hpp:308
typename decltype((std::type_identity< pack_t >{},...))::type back
Return the last type from the type pack.
Definition: traits.hpp:285
constexpr ptrdiff_t find
Get the index of the first occurrence of a type in a pack.
Definition: traits.hpp:182
constexpr ptrdiff_t count
Count the occurrences of a type in a pack.
Definition: traits.hpp:164
typename decltype(detail::at< idx, pack_t... >())::type at
Return the type at given index from the type pack.
Definition: traits.hpp:248
decltype(detail::split_after< i, pack_t... >(type_list<>{})) split_after
Split a type pack into two parts returned as a pair of seqan3::type_list.
Definition: traits.hpp:424
typename decltype(detail::front< pack_t... >())::type front
Return the first type from the type pack.
Definition: traits.hpp:265
constexpr size_t size
The size of a type pack.
Definition: traits.hpp:146
seqan3::type_list< trait_t< pack_t >... > transform
Apply a transformation trait to every type in the pack and return a seqan3::type_list of the results.
Definition: traits.hpp:328
Namespace containing traits for working on seqan3::type_list.
T reverse(T... args)
Type that contains multiple types.
Definition: type_list.hpp:29
Provides seqan3::type_list.
Provides various traits for template packs.