Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
Miscellaneous
Miscellaneous
complex
exception
functional
iterator
limits
locale
memory
new
numeric
stdexcept
typeinfo
utility
valarray
memory
classes:
allocator
auto_ptr
auto_ptr_ref
raw_storage_iterator
functions:
get_temporary_buffer
return_temporary_buffer
uninitialized_copy
uninitialized_fill
uninitialized_fill_n


get_temporary_buffer

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

Get block of temporary memory

Requests a memory block to contain up to n elements of type T temporarily.

The memory block is aligned apropriately to contain elements of type T, although it is left uninitialized (no object is constructed).

This function is specifically designed to obtain memory of temporary nature (such as for the operations of an algorithm). Once the memory block is not needed anymore, it shall be released by calling return_temporary_buffer.

Parameters

n
Quantity of elements of type T for which temporary memory is requested.
ptrdiff_t is an integral type.

Return value

On success to obtain the storage space, the function returns a pair object with its first element containing a pointer to the first element in the block, and the second element with its size, in terms of quantity of elements of type T that it can hold.

If the block cannot be obtained, the pair contains a null pointer as first and a value of zero as second.

Example

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
 
// get/return_temporary_buffer example
#include <iostream>
#include <memory>
#include <algorithm>
using namespace std;
int main () {
  int numbers[]= {30,50,10,20,60,40};
  // use temporary buffer to sort and show the numbers:
  pair <int*,ptrdiff_t> result = get_temporary_buffer<int>(6);
  if (result.second>0)
  {
    uninitialized_copy (numbers,numbers+result.second,result.first);
    sort (result.first,result.first+result.second);
    cout << "sorted numbers  : ";
    for (int i=0;i<result.second;i++)
      cout << result.first[i] << " ";
    cout << endl;
    return_temporary_buffer (result.first);
  }
  // show original numbers:
  cout << "unsorted numbers: ";
  for (int i=0;i<6;i++)
    cout << numbers[i] << " ";
  cout << endl;
  return 0;
}


Possible output:

sorted numbers  : 10 20 30 40 50 60
unsorted numbers: 30 50 10 20 60 40

See also

return_temporary_buffer Return block of temporary memory (function template)