//===- Endian.h - Utilities for IO with endian specific data ----*- C++ -*-===// // // The LLVM Compiler Infrastructure // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// // // This file declares generic functions to read and write endian specific data. // //===----------------------------------------------------------------------===// #ifndef LLVM_SUPPORT_ENDIAN_H #define LLVM_SUPPORT_ENDIAN_H #include "llvm/Support/AlignOf.h" #include "llvm/Support/Host.h" #include "llvm/Support/SwapByteOrder.h" namespace llvm { namespace support { enum endianness {big, little, native}; // These are named values for common alignments. enum {aligned = 0, unaligned = 1}; namespace detail { /// \brief ::value is either alignment, or alignof(T) if alignment is 0. template struct PickAlignment { enum {value = alignment == 0 ? AlignOf::Alignment : alignment}; }; } // end namespace detail namespace endian { /// Swap the bytes of value to match the given endianness. template inline value_type byte_swap(value_type value) { if (endian != native && sys::IsBigEndianHost != (endian == big)) sys::swapByteOrder(value); return value; } /// Read a value of a particular endianness from memory. template inline value_type read(const void *memory) { value_type ret; memcpy(&ret, LLVM_ASSUME_ALIGNED(memory, (detail::PickAlignment::value)), sizeof(value_type)); return byte_swap(ret); } /// Read a value of a particular endianness from a buffer, and increment the /// buffer past that value. template inline value_type readNext(const CharT *&memory) { value_type ret = read(memory); memory += sizeof(value_type); return ret; } /// Write a value to memory with a particular endianness. template inline void write(void *memory, value_type value) { value = byte_swap(value); memcpy(LLVM_ASSUME_ALIGNED(memory, (detail::PickAlignment::value)), &value, sizeof(value_type)); } } // end namespace endian namespace detail { template struct packed_endian_specific_integral { operator value_type() const { return endian::read( (const void*)Value.buffer); } void operator=(value_type newValue) { endian::write( (void*)Value.buffer, newValue); } packed_endian_specific_integral &operator+=(value_type newValue) { *this = *this + newValue; return *this; } packed_endian_specific_integral &operator-=(value_type newValue) { *this = *this - newValue; return *this; } packed_endian_specific_integral &operator|=(value_type newValue) { *this = *this | newValue; return *this; } packed_endian_specific_integral &operator&=(value_type newValue) { *this = *this & newValue; return *this; } private: AlignedCharArray::value, sizeof(value_type)> Value; public: struct ref { explicit ref(void *Ptr) : Ptr(Ptr) {} operator value_type() const { return endian::read(Ptr); } void operator=(value_type NewValue) { endian::write(Ptr, NewValue); } private: void *Ptr; }; }; } // end namespace detail typedef detail::packed_endian_specific_integral ulittle16_t; typedef detail::packed_endian_specific_integral ulittle32_t; typedef detail::packed_endian_specific_integral ulittle64_t; typedef detail::packed_endian_specific_integral little16_t; typedef detail::packed_endian_specific_integral little32_t; typedef detail::packed_endian_specific_integral little64_t; typedef detail::packed_endian_specific_integral aligned_ulittle16_t; typedef detail::packed_endian_specific_integral aligned_ulittle32_t; typedef detail::packed_endian_specific_integral aligned_ulittle64_t; typedef detail::packed_endian_specific_integral aligned_little16_t; typedef detail::packed_endian_specific_integral aligned_little32_t; typedef detail::packed_endian_specific_integral aligned_little64_t; typedef detail::packed_endian_specific_integral ubig16_t; typedef detail::packed_endian_specific_integral ubig32_t; typedef detail::packed_endian_specific_integral ubig64_t; typedef detail::packed_endian_specific_integral big16_t; typedef detail::packed_endian_specific_integral big32_t; typedef detail::packed_endian_specific_integral big64_t; typedef detail::packed_endian_specific_integral aligned_ubig16_t; typedef detail::packed_endian_specific_integral aligned_ubig32_t; typedef detail::packed_endian_specific_integral aligned_ubig64_t; typedef detail::packed_endian_specific_integral aligned_big16_t; typedef detail::packed_endian_specific_integral aligned_big32_t; typedef detail::packed_endian_specific_integral aligned_big64_t; typedef detail::packed_endian_specific_integral unaligned_uint16_t; typedef detail::packed_endian_specific_integral unaligned_uint32_t; typedef detail::packed_endian_specific_integral unaligned_uint64_t; typedef detail::packed_endian_specific_integral unaligned_int16_t; typedef detail::packed_endian_specific_integral unaligned_int32_t; typedef detail::packed_endian_specific_integral unaligned_int64_t; namespace endian { inline uint16_t read16le(const void *p) { return *(const ulittle16_t *)p; } inline uint32_t read32le(const void *p) { return *(const ulittle32_t *)p; } inline uint64_t read64le(const void *p) { return *(const ulittle64_t *)p; } inline uint16_t read16be(const void *p) { return *(const ubig16_t *)p; } inline uint32_t read32be(const void *p) { return *(const ubig32_t *)p; } inline uint64_t read64be(const void *p) { return *(const ubig64_t *)p; } inline void write16le(void *p, uint16_t v) { *(ulittle16_t *)p = v; } inline void write32le(void *p, uint32_t v) { *(ulittle32_t *)p = v; } inline void write64le(void *p, uint64_t v) { *(ulittle64_t *)p = v; } inline void write16be(void *p, uint16_t v) { *(ubig16_t *)p = v; } inline void write32be(void *p, uint32_t v) { *(ubig32_t *)p = v; } inline void write64be(void *p, uint64_t v) { *(ubig64_t *)p = v; } } // end namespace endian } // end namespace support } // end namespace llvm #endif