Support: Document Endian.h functions
authorJustin Bogner <mail@justinbogner.com>
Mon, 24 Mar 2014 21:30:55 +0000 (21:30 +0000)
committerJustin Bogner <mail@justinbogner.com>
Mon, 24 Mar 2014 21:30:55 +0000 (21:30 +0000)
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@204671 91177308-0d34-0410-b5e6-96231b3b80d8

include/llvm/Support/Endian.h

index 5256ef9fce59fb3314b763991ac1c5c0dbe6ab8c..81690605e87d391143d8d0f658065e77b5b74f91 100644 (file)
@@ -34,6 +34,7 @@ namespace detail {
 } // end namespace detail
 
 namespace endian {
+/// Swap the bytes of value to match the given endianness.
 template<typename value_type, endianness endian>
 inline value_type byte_swap(value_type value) {
   if (endian != native && sys::IsBigEndianHost != (endian == big))
@@ -41,6 +42,7 @@ inline value_type byte_swap(value_type value) {
   return value;
 }
 
+/// Read a value of a particular endianness from memory.
 template<typename value_type,
          endianness endian,
          std::size_t alignment>
@@ -54,6 +56,7 @@ inline value_type read(const void *memory) {
   return byte_swap<value_type, endian>(ret);
 }
 
+/// Write a value to memory with a particular endianness.
 template<typename value_type,
          endianness endian,
          std::size_t alignment>