Annex D (normative) Compatibility features [depr]

D.11 Temporary buffers [depr.temporary.buffer]

1
#

The header <memory> has the following additions:

namespace std {
  template <class T>
    pair<T*, ptrdiff_t> get_temporary_buffer(ptrdiff_t n) noexcept;
  template <class T>
    void return_temporary_buffer(T* p);
}

template <class T> pair<T*, ptrdiff_t> get_temporary_buffer(ptrdiff_t n) noexcept;

2
#

Effects: Obtains a pointer to uninitialized, contiguous storage for N adjacent objects of type T, for some non-negative number N. It is implementation-defined whether over-aligned types are supported ([basic.align]).

3
#

Remarks: Calling get_­temporary_­buffer with a positive number n is a non-binding request to return storage for n objects of type T. In this case, an implementation is permitted to return instead storage for a non-negative number N of such objects, where N != n (including N == 0). [ Note: The request is non-binding to allow latitude for implementation-specific optimizations of its memory management.  — end note ]

4
#

Returns: If n <= 0 or if no storage could be obtained, returns a pair P such that P.first is a null pointer value and P.second == 0; otherwise returns a pair P such that P.first refers to the address of the uninitialized storage and P.second refers to its capacity N (in the units of sizeof(T)).

template <class T> void return_temporary_buffer(T* p);

5
#

Effects: Deallocates the storage referenced by p.

6
#

Requires: p shall be a pointer value returned by an earlier call to get_­temporary_­buffer that has not been invalidated by an intervening call to return_­temporary_­buffer(T*).

7
#

Throws: Nothing.