MIP_SDK  v3.0.0-187-g93c7302
MicroStrain Communications Library for embedded systems
span.hpp
Go to the documentation of this file.
1 #pragma once
2 
3 #ifdef MICROSTRAIN_USE_STD_SPAN
4 
5 #include <span>
6 
7 namespace microstrain
8 {
9 
10  static inline constexpr size_t DYNAMIC_EXTENT = std::dynamic_extent;
11 
12  template<class T, size_t Size=DYNAMIC_EXTENT>
13  using Span = std::span<T, Size>;
14 
15 } // namespace microstrain
16 
17 #else // MICROSTRAIN_USE_STD_SPAN
18 
19 #include <type_traits>
20 #include <stdint.h>
21 #include <stddef.h>
22 
23 namespace microstrain
24 {
25 
26 
27 static constexpr size_t DYNAMIC_EXTENT = SIZE_MAX;
28 
40 template<class T, size_t Extent=DYNAMIC_EXTENT>
41 struct Span
42 {
43  static constexpr size_t extent = Extent;
44 
45  using element_type = T;
46  using value_type = typename std::remove_cv<T>::type;
47  using difference_type = ptrdiff_t;
48  using pointer = T*;
49  using reference = T&;
50  using const_pointer = const T*;
51  using const_reference = const T&;
52 
53  constexpr Span(pointer ptr) : m_ptr(ptr) {}
54 
55  constexpr pointer begin() const noexcept { return m_ptr; }
56  constexpr pointer end() const noexcept { return m_ptr+extent; }
57 
58  constexpr element_type front() const noexcept { return *m_ptr; }
59  constexpr element_type back() const noexcept { return *m_ptr[extent-1]; }
60 
61  constexpr reference operator[](size_t idx) noexcept { return m_ptr[idx]; }
62  constexpr const_reference operator[](size_t idx) const noexcept { return m_ptr[idx]; }
63 
64  constexpr pointer data() const noexcept { return m_ptr; }
65 
66  [[nodiscard]] constexpr size_t size() const noexcept { return extent; }
67  [[nodiscard]] constexpr bool empty() const noexcept { return extent == 0; }
68 
69  [[nodiscard]] constexpr Span<T, DYNAMIC_EXTENT> subspan(size_t index, size_t length) const { return {m_ptr+index, length}; }
70  [[nodiscard]] constexpr Span<T, DYNAMIC_EXTENT> subspan(size_t index) const { return {m_ptr+index, extent-index}; }
71  template<size_t Offset, size_t Count = DYNAMIC_EXTENT>
72  [[nodiscard]] constexpr Span<T, Count == DYNAMIC_EXTENT ? DYNAMIC_EXTENT : Extent-Count> subspan() const { return {m_ptr+Offset}; }
73 
74  [[nodiscard]] constexpr Span<T, DYNAMIC_EXTENT> first(size_t count) const { return {m_ptr, count};}
75  template<size_t Count>
76  [[nodiscard]] constexpr Span<T, Count> first() const { static_assert(Count<=Extent, "Count out of range"); return {m_ptr}; }
77 
78  [[nodiscard]] constexpr Span<T, DYNAMIC_EXTENT> last(size_t count) const { return {m_ptr+(size()-count), count};}
79  template<size_t Count>
80  [[nodiscard]] constexpr Span<T, Count> last() const { static_assert(Count<=Extent, "Count out of range"); return {m_ptr+(Extent-Count)}; }
81 
82 private:
83  pointer m_ptr = nullptr;
84 };
85 
86 
87 template<class T>
88 struct Span<T, DYNAMIC_EXTENT>
89 {
90  using element_type = T;
91  using value_type = typename std::remove_cv<T>::type;
92  using difference_type = ptrdiff_t;
93  using pointer = T*;
94  using reference = T&;
95  using const_pointer = const T*;
96  using const_reference = const T&;
97 
98  constexpr Span() = default;
99  constexpr Span(pointer ptr, size_t cnt) : m_ptr(ptr), m_cnt(cnt) {}
100  template<size_t N>
101  constexpr Span(const T (&arr)[N]) : m_ptr(arr), m_cnt(N) {}
102 
103  constexpr pointer begin() const noexcept { return m_ptr; }
104  constexpr pointer end() const noexcept { return m_ptr+m_cnt; }
105 
106  constexpr element_type front() const noexcept { return *m_ptr; }
107  constexpr element_type back() const noexcept { return *m_ptr[m_cnt-1]; }
108 
109  constexpr reference operator[](size_t idx) noexcept { return m_ptr[idx]; }
110  constexpr const_reference operator[](size_t idx) const noexcept { return m_ptr[idx]; }
111 
112  constexpr pointer data() const noexcept { return m_ptr; }
113 
114  [[nodiscard]] constexpr size_t size() const noexcept { return m_cnt; }
115  [[nodiscard]] constexpr bool empty() const noexcept { return m_cnt == 0; }
116 
117  [[nodiscard]] constexpr Span<T, DYNAMIC_EXTENT> subspan(size_t index, size_t length) const { return {m_ptr+index, length}; }
118  [[nodiscard]] constexpr Span<T, DYNAMIC_EXTENT> subspan(size_t index) const { return {m_ptr+index, m_cnt-index}; }
119  template<size_t Offset, size_t Count = DYNAMIC_EXTENT>
120  [[nodiscard]] constexpr Span<T, Count> subspan() const { return {m_ptr+Offset, Count}; }
121 
122  [[nodiscard]] constexpr Span<T, DYNAMIC_EXTENT> first(size_t count) const { return {m_ptr, count};}
123  template<size_t Count>
124  [[nodiscard]] constexpr Span<T, Count> first() const { return {m_ptr}; }
125 
126  [[nodiscard]] constexpr Span<T, DYNAMIC_EXTENT> last(size_t count) const { return {m_ptr+(size()-count), count};}
127  template<size_t Count>
128  [[nodiscard]] constexpr Span<T, Count> last() const { return {m_ptr+(size()-Count)}; }
129 
130 private:
131  pointer m_ptr = nullptr;
132  size_t m_cnt = 0;
133 };
134 
135 
136 } // namespace microstrain
137 
138 #endif // MICROSTRAIN_USE_STD_SPAN
microstrain::Span< T, DYNAMIC_EXTENT >
Definition: span.hpp:88
microstrain::Span::data
constexpr pointer data() const noexcept
Definition: span.hpp:64
microstrain::Span::subspan
constexpr Span< T, DYNAMIC_EXTENT > subspan(size_t index) const
Definition: span.hpp:70
microstrain::Span::Span
constexpr Span(pointer ptr)
Definition: span.hpp:53
microstrain::Span::pointer
T * pointer
Definition: span.hpp:48
microstrain::Span< T, DYNAMIC_EXTENT >::element_type
T element_type
Definition: span.hpp:90
microstrain::Span< T, DYNAMIC_EXTENT >::last
constexpr Span< T, DYNAMIC_EXTENT > last(size_t count) const
Definition: span.hpp:126
microstrain::Span::first
constexpr Span< T, DYNAMIC_EXTENT > first(size_t count) const
Definition: span.hpp:74
microstrain::Span< T, DYNAMIC_EXTENT >::subspan
constexpr Span< T, DYNAMIC_EXTENT > subspan(size_t index, size_t length) const
Definition: span.hpp:117
microstrain::Span::front
constexpr element_type front() const noexcept
Definition: span.hpp:58
microstrain::Span< T, DYNAMIC_EXTENT >::last
constexpr Span< T, Count > last() const
Definition: span.hpp:128
microstrain::Span::subspan
constexpr Span< T, DYNAMIC_EXTENT > subspan(size_t index, size_t length) const
Definition: span.hpp:69
microstrain::Span< T, DYNAMIC_EXTENT >::front
constexpr element_type front() const noexcept
Definition: span.hpp:106
microstrain::Span::size
constexpr size_t size() const noexcept
Definition: span.hpp:66
microstrain::Span< T, DYNAMIC_EXTENT >::const_pointer
const T * const_pointer
Definition: span.hpp:95
microstrain::Span::operator[]
constexpr const_reference operator[](size_t idx) const noexcept
Definition: span.hpp:62
microstrain::Span< T, DYNAMIC_EXTENT >::end
constexpr pointer end() const noexcept
Definition: span.hpp:104
microstrain::Span< T, DYNAMIC_EXTENT >::difference_type
ptrdiff_t difference_type
Definition: span.hpp:92
microstrain::Span
Implementation of std::span from C++20.
Definition: span.hpp:41
microstrain::Span< T, DYNAMIC_EXTENT >::empty
constexpr bool empty() const noexcept
Definition: span.hpp:115
microstrain::Span< T, DYNAMIC_EXTENT >::pointer
T * pointer
Definition: span.hpp:93
microstrain::Span< T, DYNAMIC_EXTENT >::value_type
typename std::remove_cv< T >::type value_type
Definition: span.hpp:91
microstrain::Span::first
constexpr Span< T, Count > first() const
Definition: span.hpp:76
mip::metadata::ParameterInfo
Definition: mip_structures.hpp:161
microstrain::Span::subspan
constexpr Span< T, Count==DYNAMIC_EXTENT ? DYNAMIC_EXTENT :Extent-Count > subspan() const
Definition: span.hpp:72
microstrain::Span< T, DYNAMIC_EXTENT >::Span
constexpr Span(const T(&arr)[N])
Definition: span.hpp:101
microstrain::Span< T, DYNAMIC_EXTENT >::const_reference
const T & const_reference
Definition: span.hpp:96
microstrain::Span< T, DYNAMIC_EXTENT >::data
constexpr pointer data() const noexcept
Definition: span.hpp:112
microstrain::Span::begin
constexpr pointer begin() const noexcept
Definition: span.hpp:55
microstrain::Span::last
constexpr Span< T, Count > last() const
Definition: span.hpp:80
microstrain::Span< T, DYNAMIC_EXTENT >::subspan
constexpr Span< T, DYNAMIC_EXTENT > subspan(size_t index) const
Definition: span.hpp:118
microstrain::Span< const mip::metadata::ParameterInfo >::const_reference
const const mip::metadata::ParameterInfo & const_reference
Definition: span.hpp:51
microstrain::Span< T, DYNAMIC_EXTENT >::begin
constexpr pointer begin() const noexcept
Definition: span.hpp:103
microstrain::Span< const mip::metadata::ParameterInfo >::const_pointer
const const mip::metadata::ParameterInfo * const_pointer
Definition: span.hpp:50
microstrain::Span< T, DYNAMIC_EXTENT >::size
constexpr size_t size() const noexcept
Definition: span.hpp:114
microstrain::Span< const mip::metadata::ParameterInfo >::difference_type
ptrdiff_t difference_type
Definition: span.hpp:47
microstrain::Span::operator[]
constexpr reference operator[](size_t idx) noexcept
Definition: span.hpp:61
microstrain::Span::empty
constexpr bool empty() const noexcept
Definition: span.hpp:67
microstrain::Span::end
constexpr pointer end() const noexcept
Definition: span.hpp:56
microstrain::Span< T, DYNAMIC_EXTENT >::first
constexpr Span< T, Count > first() const
Definition: span.hpp:124
microstrain::Span< T, DYNAMIC_EXTENT >::first
constexpr Span< T, DYNAMIC_EXTENT > first(size_t count) const
Definition: span.hpp:122
microstrain::Span< T, DYNAMIC_EXTENT >::back
constexpr element_type back() const noexcept
Definition: span.hpp:107
microstrain::Span< T, DYNAMIC_EXTENT >::reference
T & reference
Definition: span.hpp:94
microstrain::Span< T, DYNAMIC_EXTENT >::subspan
constexpr Span< T, Count > subspan() const
Definition: span.hpp:120
microstrain::Span::back
constexpr element_type back() const noexcept
Definition: span.hpp:59
microstrain::Span::last
constexpr Span< T, DYNAMIC_EXTENT > last(size_t count) const
Definition: span.hpp:78
microstrain::Span< const mip::metadata::ParameterInfo >::value_type
typename std::remove_cv< const mip::metadata::ParameterInfo >::type value_type
Definition: span.hpp:46
microstrain::Span::extent
static constexpr size_t extent
Definition: span.hpp:43
microstrain::Span< T, DYNAMIC_EXTENT >::Span
constexpr Span(pointer ptr, size_t cnt)
Definition: span.hpp:99
microstrain::Span< T, DYNAMIC_EXTENT >::operator[]
constexpr reference operator[](size_t idx) noexcept
Definition: span.hpp:109
microstrain::Span< T, DYNAMIC_EXTENT >::operator[]
constexpr const_reference operator[](size_t idx) const noexcept
Definition: span.hpp:110
microstrain
Definition: embedded_time.h:8
mip::metadata::Span
microstrain::Span< T > Span
Definition: mip_structures.hpp:13