2001-06-27 19:09:53 +02:00
|
|
|
// Temporary buffer implementation -*- C++ -*-
|
|
|
|
|
2010-02-04 19:20:34 +01:00
|
|
|
// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
|
2006-07-30 15:02:58 +02:00
|
|
|
// Free Software Foundation, Inc.
|
2001-06-27 19:09:53 +02:00
|
|
|
//
|
|
|
|
// This file is part of the GNU ISO C++ Library. This library is free
|
|
|
|
// software; you can redistribute it and/or modify it under the
|
|
|
|
// terms of the GNU General Public License as published by the
|
2009-04-09 17:00:19 +02:00
|
|
|
// Free Software Foundation; either version 3, or (at your option)
|
2001-06-27 19:09:53 +02:00
|
|
|
// any later version.
|
|
|
|
|
|
|
|
// This library is distributed in the hope that it will be useful,
|
|
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
// GNU General Public License for more details.
|
|
|
|
|
2009-04-09 17:00:19 +02:00
|
|
|
// Under Section 7 of GPL version 3, you are granted additional
|
|
|
|
// permissions described in the GCC Runtime Library Exception, version
|
|
|
|
// 3.1, as published by the Free Software Foundation.
|
2001-06-27 19:09:53 +02:00
|
|
|
|
2009-04-09 17:00:19 +02:00
|
|
|
// You should have received a copy of the GNU General Public License and
|
|
|
|
// a copy of the GCC Runtime Library Exception along with this program;
|
|
|
|
// see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
|
|
|
|
// <http://www.gnu.org/licenses/>.
|
2001-06-27 19:09:53 +02:00
|
|
|
|
2000-10-05 13:27:02 +02:00
|
|
|
/*
|
|
|
|
*
|
|
|
|
* Copyright (c) 1994
|
|
|
|
* Hewlett-Packard Company
|
|
|
|
*
|
|
|
|
* Permission to use, copy, modify, distribute and sell this software
|
|
|
|
* and its documentation for any purpose is hereby granted without fee,
|
|
|
|
* provided that the above copyright notice appear in all copies and
|
|
|
|
* that both that copyright notice and this permission notice appear
|
|
|
|
* in supporting documentation. Hewlett-Packard Company makes no
|
|
|
|
* representations about the suitability of this software for any
|
|
|
|
* purpose. It is provided "as is" without express or implied warranty.
|
|
|
|
*
|
|
|
|
*
|
|
|
|
* Copyright (c) 1996,1997
|
|
|
|
* Silicon Graphics Computer Systems, Inc.
|
|
|
|
*
|
|
|
|
* Permission to use, copy, modify, distribute and sell this software
|
|
|
|
* and its documentation for any purpose is hereby granted without fee,
|
|
|
|
* provided that the above copyright notice appear in all copies and
|
|
|
|
* that both that copyright notice and this permission notice appear
|
|
|
|
* in supporting documentation. Silicon Graphics makes no
|
|
|
|
* representations about the suitability of this software for any
|
|
|
|
* purpose. It is provided "as is" without express or implied warranty.
|
|
|
|
*/
|
|
|
|
|
c_io_stdio.h: Correct grammar in comments.
2001-11-02 Phil Edwards <pme@gcc.gnu.org>
* config/io/c_io_stdio.h: Correct grammar in comments.
* docs/doxygen/Intro.3: Expand "top-level" man page.
* docs/doxygen/doxygroups.cc: New module definitions (comments).
* docs/doxygen/mainpage.doxy: Tweaks.
* docs/doxygen/run_doxygen: Update Doxygen version, massage man pages.
Add @file hooks so that headers are considered to be documented.
* include/bits/basic_ios.h, include/bits/basic_file.h,
include/bits/basic_string.h, include/bits/boost_concept_check.h,
include/bits/char_traits.h, include/bits/codecvt.h,
include/bits/concept_check.h, include/bits/cpp_type_traits.h,
include/bits/fpos.h, include/bits/gslice.h, include/bits/gslice_array.h,
include/bits/indirect_array.h, include/bits/ios_base.h,
include/bits/locale_facets.h, include/bits/localefwd.h,
include/bits/mask_array.h, include/bits/pthread_allocimpl.h,
include/bits/slice.h, include/bits/slice_array.h,
include/bits/std_algorithm.h, include/bits/std_bitset.h,
include/bits/std_complex.h, include/bits/std_deque.h,
include/bits/std_fstream.h, include/bits/std_functional.h,
include/bits/std_iomanip.h, include/bits/std_ios.h,
include/bits/std_iosfwd.h, include/bits/std_iostream.h,
include/bits/std_istream.h, include/bits/std_iterator.h,
include/bits/std_limits.h, include/bits/std_list.h,
include/bits/std_locale.h, include/bits/std_map.h,
include/bits/std_memory.h, include/bits/std_numeric.h,
include/bits/std_ostream.h, include/bits/std_queue.h,
include/bits/std_set.h, include/bits/std_sstream.h,
include/bits/std_stack.h, include/bits/std_streambuf.h,
include/bits/std_string.h, include/bits/std_utility.h,
include/bits/std_valarray.h, include/bits/std_vector.h,
include/bits/stl_algo.h, include/bits/stl_alloc.h,
include/bits/stl_bvector.h, include/bits/stl_construct.h,
include/bits/stl_deque.h, include/bits/stl_heap.h,
include/bits/stl_iterator.h, include/bits/stl_iterator_base_funcs.h,
include/bits/stl_iterator_base_types.h, include/bits/stl_list.h,
include/bits/stl_map.h, include/bits/stl_multimap.h,
include/bits/stl_multiset.h, include/bits/stl_numeric.h,
include/bits/stl_pair.h, include/bits/stl_pthread_alloc.h,
include/bits/stl_queue.h, include/bits/stl_raw_storage_iter.h,
include/bits/stl_relops.h, include/bits/stl_set.h,
include/bits/stl_stack.h, include/bits/stl_tempbuf.h,
include/bits/stl_threads.h, include/bits/stl_tree.h,
include/bits/stl_uninitialized.h, include/bits/stl_vector.h,
include/bits/stream_iterator.h, include/bits/streambuf_iterator.h,
include/bits/stringfwd.h, include/bits/type_traits.h,
include/bits/valarray_array.h, include/bits/valarray_meta.h:
Add hooks, tweak comments only.
* include/bits/stl_algobase.h (swap, min, iter_swap): Also
document these functions.
* include/bits/stl_function.h: Tweak link comments.
From-SVN: r46717
2001-11-02 18:38:11 +01:00
|
|
|
/** @file stl_tempbuf.h
|
|
|
|
* This is an internal header file, included by other library headers.
|
|
|
|
* You should not attempt to use it directly.
|
2000-10-05 13:27:02 +02:00
|
|
|
*/
|
|
|
|
|
2007-06-18 19:22:53 +02:00
|
|
|
#ifndef _STL_TEMPBUF_H
|
|
|
|
#define _STL_TEMPBUF_H 1
|
2000-10-05 13:27:02 +02:00
|
|
|
|
2007-05-04 20:07:10 +02:00
|
|
|
#include <bits/stl_algobase.h>
|
|
|
|
#include <bits/stl_construct.h>
|
2000-10-05 13:27:02 +02:00
|
|
|
|
2005-12-19 01:56:05 +01:00
|
|
|
_GLIBCXX_BEGIN_NAMESPACE(std)
|
|
|
|
|
2007-05-04 20:07:10 +02:00
|
|
|
/**
|
2007-12-01 17:29:22 +01:00
|
|
|
* @brief Allocates a temporary buffer.
|
|
|
|
* @param len The number of objects of type Tp.
|
|
|
|
* @return See full description.
|
|
|
|
*
|
|
|
|
* Reinventing the wheel, but this time with prettier spokes!
|
|
|
|
*
|
|
|
|
* This function tries to obtain storage for @c len adjacent Tp
|
|
|
|
* objects. The objects themselves are not constructed, of course.
|
2010-02-04 19:20:34 +01:00
|
|
|
* A pair<> is returned containing <em>the buffer s address and
|
2007-12-01 17:29:22 +01:00
|
|
|
* capacity (in the units of sizeof(Tp)), or a pair of 0 values if
|
2010-02-04 19:20:34 +01:00
|
|
|
* no storage can be obtained.</em> Note that the capacity obtained
|
2007-12-01 17:29:22 +01:00
|
|
|
* may be less than that requested if the memory is unavailable;
|
|
|
|
* you should compare len with the .second return value.
|
|
|
|
*
|
|
|
|
* Provides the nothrow exception guarantee.
|
2007-05-04 20:07:10 +02:00
|
|
|
*/
|
|
|
|
template<typename _Tp>
|
|
|
|
pair<_Tp*, ptrdiff_t>
|
2007-12-01 17:29:22 +01:00
|
|
|
get_temporary_buffer(ptrdiff_t __len)
|
2007-05-04 20:07:10 +02:00
|
|
|
{
|
|
|
|
const ptrdiff_t __max =
|
|
|
|
__gnu_cxx::__numeric_traits<ptrdiff_t>::__max / sizeof(_Tp);
|
|
|
|
if (__len > __max)
|
|
|
|
__len = __max;
|
|
|
|
|
|
|
|
while (__len > 0)
|
|
|
|
{
|
|
|
|
_Tp* __tmp = static_cast<_Tp*>(::operator new(__len * sizeof(_Tp),
|
|
|
|
std::nothrow));
|
|
|
|
if (__tmp != 0)
|
|
|
|
return std::pair<_Tp*, ptrdiff_t>(__tmp, __len);
|
|
|
|
__len /= 2;
|
|
|
|
}
|
|
|
|
return std::pair<_Tp*, ptrdiff_t>(static_cast<_Tp*>(0), 0);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief The companion to get_temporary_buffer().
|
|
|
|
* @param p A buffer previously allocated by get_temporary_buffer.
|
|
|
|
* @return None.
|
|
|
|
*
|
|
|
|
* Frees the memory pointed to by p.
|
|
|
|
*/
|
|
|
|
template<typename _Tp>
|
2007-05-13 18:23:20 +02:00
|
|
|
inline void
|
2007-05-04 20:07:10 +02:00
|
|
|
return_temporary_buffer(_Tp* __p)
|
2007-05-13 18:23:20 +02:00
|
|
|
{ ::operator delete(__p, std::nothrow); }
|
2007-05-04 20:07:10 +02:00
|
|
|
|
|
|
|
|
2004-01-30 04:43:00 +01:00
|
|
|
/**
|
|
|
|
* This class is used in two places: stl_algo.h and ext/memory,
|
|
|
|
* where it is wrapped as the temporary_buffer class. See
|
|
|
|
* temporary_buffer docs for more notes.
|
|
|
|
*/
|
|
|
|
template<typename _ForwardIterator, typename _Tp>
|
|
|
|
class _Temporary_buffer
|
|
|
|
{
|
|
|
|
// concept requirements
|
|
|
|
__glibcxx_class_requires(_ForwardIterator, _ForwardIteratorConcept)
|
|
|
|
|
2006-07-30 15:02:58 +02:00
|
|
|
public:
|
2004-01-30 04:43:00 +01:00
|
|
|
typedef _Tp value_type;
|
|
|
|
typedef value_type* pointer;
|
|
|
|
typedef pointer iterator;
|
|
|
|
typedef ptrdiff_t size_type;
|
2004-02-08 05:46:42 +01:00
|
|
|
|
2004-01-30 04:43:00 +01:00
|
|
|
protected:
|
|
|
|
size_type _M_original_len;
|
|
|
|
size_type _M_len;
|
|
|
|
pointer _M_buffer;
|
2004-02-08 05:46:42 +01:00
|
|
|
|
2004-01-30 04:43:00 +01:00
|
|
|
public:
|
|
|
|
/// As per Table mumble.
|
|
|
|
size_type
|
|
|
|
size() const
|
|
|
|
{ return _M_len; }
|
2004-02-08 05:46:42 +01:00
|
|
|
|
2004-01-30 04:43:00 +01:00
|
|
|
/// Returns the size requested by the constructor; may be >size().
|
|
|
|
size_type
|
|
|
|
requested_size() const
|
|
|
|
{ return _M_original_len; }
|
2004-02-08 05:46:42 +01:00
|
|
|
|
2004-01-30 04:43:00 +01:00
|
|
|
/// As per Table mumble.
|
|
|
|
iterator
|
|
|
|
begin()
|
|
|
|
{ return _M_buffer; }
|
2004-02-08 05:46:42 +01:00
|
|
|
|
2004-01-30 04:43:00 +01:00
|
|
|
/// As per Table mumble.
|
|
|
|
iterator
|
|
|
|
end()
|
|
|
|
{ return _M_buffer + _M_len; }
|
2004-02-08 05:46:42 +01:00
|
|
|
|
2004-01-30 04:43:00 +01:00
|
|
|
/**
|
|
|
|
* Constructs a temporary buffer of a size somewhere between
|
|
|
|
* zero and the size of the given range.
|
|
|
|
*/
|
|
|
|
_Temporary_buffer(_ForwardIterator __first, _ForwardIterator __last);
|
2004-02-08 05:46:42 +01:00
|
|
|
|
2004-01-30 04:43:00 +01:00
|
|
|
~_Temporary_buffer()
|
2004-02-08 05:46:42 +01:00
|
|
|
{
|
2004-01-30 04:43:00 +01:00
|
|
|
std::_Destroy(_M_buffer, _M_buffer + _M_len);
|
|
|
|
std::return_temporary_buffer(_M_buffer);
|
|
|
|
}
|
2004-02-08 05:46:42 +01:00
|
|
|
|
2004-01-30 04:43:00 +01:00
|
|
|
private:
|
|
|
|
// Disable copy constructor and assignment operator.
|
|
|
|
_Temporary_buffer(const _Temporary_buffer&);
|
2004-02-03 18:59:05 +01:00
|
|
|
|
|
|
|
void
|
|
|
|
operator=(const _Temporary_buffer&);
|
2004-01-30 04:43:00 +01:00
|
|
|
};
|
2004-02-08 05:46:42 +01:00
|
|
|
|
2010-06-16 14:26:24 +02:00
|
|
|
|
|
|
|
template<bool>
|
|
|
|
struct __uninitialized_construct_buf_dispatch
|
|
|
|
{
|
|
|
|
template<typename _ForwardIterator, typename _Tp>
|
|
|
|
static void
|
|
|
|
__ucr(_ForwardIterator __first, _ForwardIterator __last,
|
|
|
|
_Tp& __value)
|
|
|
|
{
|
|
|
|
if(__first == __last)
|
|
|
|
return;
|
|
|
|
|
|
|
|
_ForwardIterator __cur = __first;
|
|
|
|
__try
|
|
|
|
{
|
|
|
|
std::_Construct(std::__addressof(*__first),
|
|
|
|
_GLIBCXX_MOVE(__value));
|
|
|
|
_ForwardIterator __prev = __cur;
|
|
|
|
++__cur;
|
|
|
|
for(; __cur != __last; ++__cur, ++__prev)
|
|
|
|
std::_Construct(std::__addressof(*__cur),
|
|
|
|
_GLIBCXX_MOVE(*__prev));
|
|
|
|
__value = _GLIBCXX_MOVE(*__prev);
|
|
|
|
}
|
|
|
|
__catch(...)
|
|
|
|
{
|
|
|
|
std::_Destroy(__first, __cur);
|
|
|
|
__throw_exception_again;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
template<>
|
|
|
|
struct __uninitialized_construct_buf_dispatch<true>
|
|
|
|
{
|
|
|
|
template<typename _ForwardIterator, typename _Tp>
|
|
|
|
static void
|
|
|
|
__ucr(_ForwardIterator, _ForwardIterator, _Tp&) { }
|
|
|
|
};
|
|
|
|
|
|
|
|
// Constructs objects in the range [first, last).
|
|
|
|
// Note that while these new objects will take valid values,
|
|
|
|
// their exact value is not defined. In particular they may
|
|
|
|
// be 'moved from'.
|
|
|
|
//
|
|
|
|
// While __value may altered during this algorithm, it will have
|
|
|
|
// the same value when the algorithm finishes, unless one of the
|
|
|
|
// constructions throws.
|
|
|
|
//
|
|
|
|
// Requirements: _ForwardIterator::value_type(_Tp&&) is valid.
|
|
|
|
template<typename _ForwardIterator, typename _Tp>
|
|
|
|
inline void
|
|
|
|
__uninitialized_construct_buf(_ForwardIterator __first,
|
|
|
|
_ForwardIterator __last,
|
|
|
|
_Tp& __value)
|
|
|
|
{
|
|
|
|
typedef typename std::iterator_traits<_ForwardIterator>::value_type
|
|
|
|
_ValueType;
|
|
|
|
|
|
|
|
std::__uninitialized_construct_buf_dispatch<
|
|
|
|
__has_trivial_constructor(_ValueType)>::
|
|
|
|
__ucr(__first, __last, __value);
|
|
|
|
}
|
|
|
|
|
2004-01-30 04:43:00 +01:00
|
|
|
template<typename _ForwardIterator, typename _Tp>
|
|
|
|
_Temporary_buffer<_ForwardIterator, _Tp>::
|
|
|
|
_Temporary_buffer(_ForwardIterator __first, _ForwardIterator __last)
|
2004-02-08 05:46:42 +01:00
|
|
|
: _M_original_len(std::distance(__first, __last)),
|
2004-02-03 18:59:05 +01:00
|
|
|
_M_len(0), _M_buffer(0)
|
2004-01-30 04:43:00 +01:00
|
|
|
{
|
2009-02-04 00:44:53 +01:00
|
|
|
__try
|
2004-02-03 18:59:05 +01:00
|
|
|
{
|
2007-05-04 20:07:10 +02:00
|
|
|
std::pair<pointer, size_type> __p(std::get_temporary_buffer<
|
|
|
|
value_type>(_M_original_len));
|
2004-02-03 18:59:05 +01:00
|
|
|
_M_buffer = __p.first;
|
|
|
|
_M_len = __p.second;
|
2009-08-29 21:27:05 +02:00
|
|
|
if(_M_buffer)
|
2010-06-16 14:26:24 +02:00
|
|
|
std::__uninitialized_construct_buf(_M_buffer, _M_buffer + _M_len,
|
|
|
|
*__first);
|
2004-02-03 18:59:05 +01:00
|
|
|
}
|
2009-02-04 00:44:53 +01:00
|
|
|
__catch(...)
|
2004-02-08 05:46:42 +01:00
|
|
|
{
|
2004-02-03 18:59:05 +01:00
|
|
|
std::return_temporary_buffer(_M_buffer);
|
2004-02-08 05:46:42 +01:00
|
|
|
_M_buffer = 0;
|
2004-02-03 18:59:05 +01:00
|
|
|
_M_len = 0;
|
2004-02-08 05:46:42 +01:00
|
|
|
__throw_exception_again;
|
2004-02-03 18:59:05 +01:00
|
|
|
}
|
2004-01-30 04:43:00 +01:00
|
|
|
}
|
2005-12-19 01:56:05 +01:00
|
|
|
|
|
|
|
_GLIBCXX_END_NAMESPACE
|
2000-10-05 13:27:02 +02:00
|
|
|
|
2007-06-18 19:22:53 +02:00
|
|
|
#endif /* _STL_TEMPBUF_H */
|
2000-10-05 13:27:02 +02:00
|
|
|
|