From 457ed73778ef729d254fcfe5f4c2b5bc996248bd Mon Sep 17 00:00:00 2001
From: Beman <bdawes@acm.org>
Date: Wed, 29 May 2013 09:04:31 -0400
Subject: [PATCH] Add more UDT use examples. Link to UDT example in conversion
 function docs.

---
 doc/conversion.html                |  7 ++++++-
 example/udt_conversion_example.cpp | 11 +++++++++++
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/doc/conversion.html b/doc/conversion.html
index 339cc33..3ee5cb0 100644
--- a/doc/conversion.html
+++ b/doc/conversion.html
@@ -197,6 +197,11 @@ modifiable lvalue of type <code>Reversible</code>.</p>
     reversed.</td>
   </tr>
 </table>
+<p dir="ltr">See <a href="../example/udt_conversion_example.cpp">
+udt_conversion_example.cpp</a> for an example of a UDT that can used in the
+<code><a href="#big_endian">big_endian</a></code>, <code>
+<a href="#little_endian">little_endian</a></code>, and <code>
+<a href="#convert_generic">convert</a></code> function templates.</p>
 <h3><a name="Functions">Functions</a></h3>
 <pre><a name="reverse_value"></a>int16_t  reverse_value(int16_t x) noexcept;
 int32_t  reverse_value(int32_t x) noexcept;
@@ -331,7 +336,7 @@ provided.</p>
 support endian conversion as separate from endian integer types. Phil Endecott suggested the form of the value returning signatures. Vicente Botet and other reviewers suggested supporting floating point types and user defined types. General reverse template implementation approach using std::reverse suggested by Mathias Gaunard. Portable implementation approach for 16, 32, and 64-bit integers suggested by tymofey, with avoidance of undefined behavior as suggested by Giovanni Piero Deretta, and a further refinement suggested by Pyry Jahkola. Intrinsic builtins implementation approach for 16, 32, and 64-bit integers suggested by several reviewers, and by David Stone, who provided his Boost licensed macro implementation that became the starting point for <a href="../include/boost/endian/detail/intrinsic.hpp">boost/endian/detail/intrinsic.hpp</a>.</p>
 <hr>
 <p>Last revised: 
-<!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->28 May, 2013<!--webbot bot="Timestamp" endspan i-checksum="13992" --></p>
+<!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->29 May, 2013<!--webbot bot="Timestamp" endspan i-checksum="13994" --></p>
 <p>© Copyright Beman Dawes, 2011, 2013</p>
 <p>Distributed under the Boost Software License, Version 1.0. See <a href="http://www.boost.org/LICENSE_1_0.txt">www.boost.org/ LICENSE_1_0.txt</a></p>
 
diff --git a/example/udt_conversion_example.cpp b/example/udt_conversion_example.cpp
index 34bf056..07186a5 100644
--- a/example/udt_conversion_example.cpp
+++ b/example/udt_conversion_example.cpp
@@ -59,13 +59,24 @@ int main(int, char* [])
   UDT x(1, 1.2345f, "Bingo!");
   cout << std::hex;
   cout << x.id() << ' ' << x.value() << ' ' << x.desc() << endl;
+
   reverse(x);
   cout << x.id() << ' ' << x.value() << ' ' << x.desc() << endl;
+
   reverse(x);
   cout << x.id() << ' ' << x.value() << ' ' << x.desc() << endl;
+
   big_endian(x);
   cout << x.id() << ' ' << x.value() << ' ' << x.desc() << endl;
 
+  little_endian(x);
+  cout << x.id() << ' ' << x.value() << ' ' << x.desc() << endl;
+
+  convert<order::little, order::big>(x);
+  cout << x.id() << ' ' << x.value() << ' ' << x.desc() << endl;
+
+  convert(x, order::big, order::little);
+  cout << x.id() << ' ' << x.value() << ' ' << x.desc() << endl;
 }
 
 #include <boost/endian/detail/disable_warnings_pop.hpp>