1 //=================================================================================================
2 /*!
3 // \file blaze/math/shims/Pow3.h
4 // \brief Header file for the pow3 shim
5 //
6 // Copyright (C) 2012-2020 Klaus Iglberger - All Rights Reserved
7 //
8 // This file is part of the Blaze library. You can redistribute it and/or modify it under
9 // the terms of the New (Revised) BSD License. Redistribution and use in source and binary
10 // forms, with or without modification, are permitted provided that the following conditions
11 // are met:
12 //
13 // 1. Redistributions of source code must retain the above copyright notice, this list of
14 // conditions and the following disclaimer.
15 // 2. Redistributions in binary form must reproduce the above copyright notice, this list
16 // of conditions and the following disclaimer in the documentation and/or other materials
17 // provided with the distribution.
18 // 3. Neither the names of the Blaze development group nor the names of its contributors
19 // may be used to endorse or promote products derived from this software without specific
20 // prior written permission.
21 //
22 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
23 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24 // OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
25 // SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26 // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
27 // TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
28 // BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
30 // ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
31 // DAMAGE.
32 */
33 //=================================================================================================
34
35 #ifndef _BLAZE_MATH_SHIMS_POW3_H_
36 #define _BLAZE_MATH_SHIMS_POW3_H_
37
38
39 //*************************************************************************************************
40 // Includes
41 //*************************************************************************************************
42
43 #include <blaze/system/Inline.h>
44
45
46 namespace blaze {
47
48 //=================================================================================================
49 //
50 // POW3 SHIM
51 //
52 //=================================================================================================
53
54 //*************************************************************************************************
55 /*!\brief Cubing the given value/object.
56 // \ingroup math_shims
57 //
58 // \param a The value/object to be cubed.
59 // \return The result of the cube operation.
60 //
61 // The \a pow3 shim represents an abstract interface for cubing a value/object of any given
62 // data type. For values of built-in data type this results in a plain multiplication.
63 */
64 template< typename T >
decltype(auto)65 BLAZE_ALWAYS_INLINE constexpr decltype(auto) pow3( const T& a ) noexcept( noexcept( a * a * a ) )
66 {
67 return ( a * a * a );
68 }
69 //*************************************************************************************************
70
71 } // namespace blaze
72
73 #endif
74