summaryrefslogtreecommitdiffstats
blob: 8d29fca4664bf2a544b0ccebba83b3e7b403f270 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
/*
 Copyright (c) 2014 Glen Joseph Fernandes
 glenfe at live dot com

 Distributed under the Boost Software License,
 Version 1.0. (See accompanying file LICENSE_1_0.txt
 or copy at http://boost.org/LICENSE_1_0.txt)
*/
#ifndef BOOST_ALIGN_ALIGN_HPP
#define BOOST_ALIGN_ALIGN_HPP

/**
 Function align.

 @file
 @author Glen Fernandes
*/

#include <boost/config.hpp>

/**
 @cond
*/
#if !defined(BOOST_NO_CXX11_STD_ALIGN)
#include <boost/align/detail/align_cxx11.hpp>
#else
#include <boost/align/detail/align.hpp>
#endif

#if defined(BOOST_NO_CXX11_STD_ALIGN)
/**
 @endcond
*/

/**
 Boost namespace.
*/
namespace boost {
    /**
     Alignment namespace.
    */
    namespace alignment {
        /**
         If it is possible to fit `size` bytes of storage
         aligned by `alignment` into the buffer pointed to by
         `ptr` with length `space`, the function updates `ptr`
         to point to the first possible address of such
         storage and decreases `space` by the number of bytes
         used for alignment. Otherwise, the function does
         nothing.

         @param alignment Shall be a fundamental alignment
           value or an extended alignment value, and shall be
           a power of two.

         @param size The size in bytes of storage to fit into
           the buffer.

         @param ptr Shall point to contiguous storage of at
           least `space` bytes.

         @param space The length of the buffer.

         @return A null pointer if the requested aligned
           buffer would not fit into the available space,
           otherwise the adjusted value of `ptr`.

         @remark **Note:** The function updates its `ptr` and
           space arguments so that it can be called repeatedly
           with possibly different `alignment` and `size`
           arguments for the same buffer.
        */
        inline void* align(std::size_t alignment, std::size_t size,
            void*& ptr, std::size_t& space);
    }
}

/**
 @cond
*/
#endif
/**
 @endcond
*/

#endif