1/*
2 * Copyright (c) 2015, Intel Corporation
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without modification,
6 * are permitted provided that the following conditions are met:
7 *
8 * 1. Redistributions of source code must retain the above copyright notice, this
9 * list of conditions and the following disclaimer.
10 *
11 * 2. Redistributions in binary form must reproduce the above copyright notice,
12 * this list of conditions and the following disclaimer in the documentation and/or
13 * other materials provided with the distribution.
14 *
15 * 3. Neither the name of the copyright holder nor the names of its contributors
16 * may be used to endorse or promote products derived from this software without
17 * specific prior written permission.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
21 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
23 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
24 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
26 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
28 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 */
30
31#include <algorithm>
32#include <type_traits>
33#include "Iterator.hpp"
34#include <cassert>
35
36namespace utility
37{
38
39/**
40 * Raw copy of one variable to another of the same size
41 *
42 * This can be regarder as a reinterpret_cast but does a copy and does not
43 * break strict-aliasing rules.
44 *
45 * The source and the destination must have the same storage size (e.g. copying
46 * a uint8_t into a uint32_t won't compile)
47 *
48 * @tparam Source The source type
49 * @tparam Destination the destination type (even if it is a reference, this
50 *         function returns by copy)
51 * @param source Source variable
52 * @returns the source, reinterpreted as the destination type
53 */
54template <class Destination, class Source>
55typename std::remove_reference<Destination>::type binaryCopy(const Source source)
56{
57    static_assert(sizeof(Source) == sizeof(Destination),
58                  "Source and Destination must have the same size");
59
60    using Destination_ = decltype(binaryCopy<Destination>(source));
61
62    union
63    {
64        Source source;
65        Destination_ destination;
66    } hack;
67
68    hack.source = source;
69    return hack.destination;
70}
71
72} // namespace utility
73