AuROXTL/Include/auROXTL/auCopyMoveUtils.hpp

/***
    Copyright (C) 2022 J Reece Wilson (a/k/a "Reece"). All rights reserved.

    File: auCopyMoveUtils.hpp
    Date: 2022-2-1
    Author: Reece
***/
#pragma once

/**
 * @brief Upcasts R-Value upcastable @param arg.
 *        For an L-Value equivalent hint, use AuReference
 * @tparam T 
 * @param arg 
 * @return 
*/
template <class T>
auline constexpr AuRemoveReference_t<T> &&AuMove(T &&arg) noexcept
{
    return static_cast<AuRemoveReference_t<T> &&>(arg);
}

/**
 * @brief Upcasts L-Value upcastable @param arg.
 *        For an R-Value equivalent hint, use AuMove
 * @tparam T An expression to implicitly upcast to an L-value
 * @param arg
 * @return
*/
template <class T, AU_TEMPLATE_ENABLE_WHEN(!AuIsRValueReference_v<T> && !AuIsLValueReference_v<T>)>
auline constexpr AuRemoveReference_t<T> &AuReference(T &arg) noexcept
{
    return static_cast<T &>(arg);
}

/**
 * @brief Upcasts L-Value upcastable @param arg.
 *        For an R-Value equivalent hint, use AuMove
 *        Recommended use case: specifying constant ref method overload over move counterpart
 * @tparam T An expression to implicitly upcast to a constant L-value
 * @param arg
 * @return
*/
template <class T, AU_TEMPLATE_ENABLE_WHEN(!AuIsRValueReference_v<T> && !AuIsLValueReference_v<T>)>
auline constexpr const AuRemoveReference_t<T> &AuConstReference(T &arg) noexcept
{
    return static_cast<const T &>(arg);
}

/**
 * @brief Preserves R or L value without reducing; implicit AuMove or AuReference
 * @tparam T An expression to implicitly upcast to an R-value
 * @param arg 
 * @return 
*/
template <class T>
auline constexpr T &&AuForward(AuRemoveReference_t<T> &arg) noexcept
{
    return static_cast<T &&>(arg);
}

/**
 * @brief Preserves R or L value without reducing; implicit AuMove or AuReference
 * @tparam T
 * @param arg
 * @return
*/
template <class T>
auline constexpr T &&AuForward(AuRemoveReference_t<T> &&arg) noexcept
{
    return static_cast<T &&>(arg);
}