///\file /****************************************************************************** The MIT License(MIT) Embedded Template Library. https://github.com/ETLCPP/etl https://www.etlcpp.com Copyright(c) 2014 John Wellbelove Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files(the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and / or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions : The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ******************************************************************************/ #ifndef ETL_ALIGNMENT_INCLUDED #define ETL_ALIGNMENT_INCLUDED #include "platform.h" #include "type_traits.h" #include "static_assert.h" #include "error_handler.h" #include "exception.h" #include ///\defgroup alignment alignment /// Creates a variable of the specified type at the specified alignment. /// \ingroup utilities namespace etl { //*************************************************************************** /// Exception base for alignment //*************************************************************************** class alignment_exception : public etl::exception { public: alignment_exception(string_type reason_, string_type file_name_, numeric_type line_number_) : exception(reason_, file_name_, line_number_) { } }; //*************************************************************************** /// Memory misalignment exception. //*************************************************************************** class alignment_error : public alignment_exception { public: alignment_error(string_type file_name_, numeric_type line_number_) : alignment_exception(ETL_ERROR_TEXT("alignment:error", ETL_ALIGNMENT_FILE_ID"A"), file_name_, line_number_) { } }; //***************************************************************************** /// Check that 'p' has 'required_alignment'. //***************************************************************************** inline bool is_aligned(void* p, size_t required_alignment) { uintptr_t address = reinterpret_cast(p); return (address % required_alignment) == 0U; } //***************************************************************************** /// Check that 'p' has 'Alignment'. //***************************************************************************** template bool is_aligned(void* p) { uintptr_t address = reinterpret_cast(p); return (address % Alignment) == 0U; } //***************************************************************************** /// Check that 'p' has the alignment of 'T'. //***************************************************************************** template bool is_aligned(void* p) { return is_aligned::value>(p); } namespace private_alignment { #if ETL_USING_CPP11 //*************************************************************************** // Matcher. //*************************************************************************** template class type_with_alignment_matcher; // Matching alignment. template class type_with_alignment_matcher { public: typedef T1 type; }; // Non-matching alignment template class type_with_alignment_matcher { public: typedef typename type_with_alignment_matcher < Alignment <= etl::alignment_of::value , Alignment, T2, TRest... > ::type type; }; // Non-matching alignment, none left. template class type_with_alignment_matcher { public: typedef char type; }; //*************************************************************************** // Helper. //*************************************************************************** template class type_with_alignment_helper { public: typedef typename type_with_alignment_matcher::value, Alignment, T1, T...>::type type; }; #else //*************************************************************************** // Matcher. //*************************************************************************** template class type_with_alignment_matcher; // Matching alignment. template class type_with_alignment_matcher { public: typedef T1 type; }; // Non-matching alignment. template class type_with_alignment_matcher { public: typedef typename type_with_alignment_matcher::value, Alignment, T2, T3, T4, T5, T6, T7, T8, void>::type type; }; // Non-matching alignment, none left. template class type_with_alignment_matcher { public: typedef char type; }; //*************************************************************************** // Helper. //*************************************************************************** template class type_with_alignment_helper { public: typedef typename type_with_alignment_matcher::value, Alignment, T1, T2, T3, T4, T5, T6, T7, T8>::type type; }; #endif } //*************************************************************************** /// Gets a type that has the same as the specified alignment. ///\ingroup alignment //*************************************************************************** template class type_with_alignment { public: #if ETL_USING_CPP11 typedef struct { alignas(Alignment) char dummy; } type; #else #if ETL_NOT_USING_64BIT_TYPES typedef typename private_alignment::type_with_alignment_helper::type type; #else typedef typename private_alignment::type_with_alignment_helper::type type; #endif #endif ETL_STATIC_ASSERT(etl::alignment_of::value == Alignment, "Unable to create the type with the specified alignment"); }; #if ETL_USING_CPP11 template using type_with_alignment_t = typename type_with_alignment::type; #endif //*************************************************************************** /// Aligned storage /// Length should be determined in terms of sizeof() ///\ingroup alignment //*************************************************************************** template struct aligned_storage { struct type { //type() // : data() //{ //} /// Convert to T reference. template operator T& () { ETL_STATIC_ASSERT((etl::is_same:: value || ((Alignment % etl::alignment_of::value) == 0)), "Incompatible alignment"); T* t = *this; return *t; } /// Convert to const T reference. template operator const T& () const { ETL_STATIC_ASSERT((etl::is_same:: value || ((Alignment % etl::alignment_of::value) == 0)), "Incompatible alignment"); const T* t = *this; return *t; } /// Convert to T pointer. template operator T* () { ETL_STATIC_ASSERT((etl::is_same:: value || ((Alignment % etl::alignment_of::value) == 0)), "Incompatible alignment"); return reinterpret_cast(data); } /// Convert to const T pointer. template operator const T* () const { ETL_STATIC_ASSERT((etl::is_same:: value || ((Alignment % etl::alignment_of::value) == 0)), "Incompatible alignment"); return reinterpret_cast(data); } /// Get address as T reference. template T& get_reference() { ETL_STATIC_ASSERT((etl::is_same:: value || ((Alignment % etl::alignment_of::value) == 0)), "Incompatible alignment"); T* t = *this; return *t; } /// Get address as const T reference. template const T& get_reference() const { ETL_STATIC_ASSERT((etl::is_same:: value || ((Alignment % etl::alignment_of::value) == 0)), "Incompatible alignment"); const T* t = *this; return *t; } /// Get address as T pointer. template T* get_address() { ETL_STATIC_ASSERT((etl::is_same:: value || ((Alignment % etl::alignment_of::value) == 0)), "Incompatible alignment"); return reinterpret_cast(data); } /// Get address as const T pointer. template const T* get_address() const { ETL_STATIC_ASSERT((etl::is_same:: value || ((Alignment % etl::alignment_of::value) == 0)), "Incompatible alignment"); return reinterpret_cast(data); } #if ETL_USING_CPP11 && !defined(ETL_COMPILER_ARM5) alignas(Alignment) char data[Length]; #else union { char data[Length]; typename etl::type_with_alignment::type etl_alignment_type; // A POD type that has the same alignment as Alignment. }; #endif }; }; #if ETL_USING_CPP11 template using aligned_storage_t = typename aligned_storage::type; #endif //*************************************************************************** /// Aligned storage as ///\ingroup alignment //*************************************************************************** template struct aligned_storage_as : public etl::aligned_storage::value> { }; #if ETL_USING_CPP11 template using aligned_storage_as_t = typename aligned_storage_as::type; #endif } #endif