Man Page get_temporary_buffer.3

                       Standard C++ Library
             Copyright 1998, Rogue Wave Software, Inc.

NAME

     get_temporary_buffer

      - Pointer based primitive for handling memory

SYNOPSIS

     #include <memory>
     template <class T>
     pair<T*, ptrdiff_t> get_temporary_buffer (ptrdiff_t);
     template <class T>
     pair<T*, ptrdiff_t> get_temporary_buffer (ptrdiff_t, T*);

DESCRIPTION

     The get_temporary_buffer templatized function reserves  from
     system  memory the largest possible buffer that is less than
     or equal to the size requested (n*sizeof(T)), and returns  a
     pair<T*,  ptrdiff_t> containing the address and size of that
     buffer. The units used  to  describe  the  capacity  are  in
     sizeof(T).

     The first version of this function is not available if  your
     compiler  does  not  support functions templatized on return
     type only.

SEE ALSO

     allocator, pair, return_temporary_buffer.