stl_construct.h

Introduction

This is an internal header file, included by other library headers. You should not attempt to use it directly.

Classes

allocator

Functions

__destroy_aux( _ForwardIterator, _ForwardIterator, __true_type)

__destroy_aux(_ForwardIterator, _ForwardIterator, __false_type)

_Construct(_T1 *)

_Construct(_T1 *, const _T2 &)

_Destroy

template<typename _ForwardIterator> inline void __destroy_aux(
    _ForwardIterator,
    _ForwardIterator,
    __true_type) 

Discussion

@if maint Destroy a range of objects with trivial destructors. Since the destructors are trivial, there's nothing to do and hopefully this function will be entirely optimized away.

This is a helper function used only by _Destroy(). @endif

template<typename _ForwardIterator> inline void __destroy_aux(
    _ForwardIterator __first,
    _ForwardIterator __last, 
    __false_type) 

Discussion

@if maint Destroy a range of objects with nontrivial destructors.

This is a helper function used only by _Destroy(). @endif

template<typename _T1> inline void _Construct(
    _T1*__p) 

Discussion

@if maint Constructs an object in existing memory by invoking an allocated object's default constructor (no initializers). @endif

template<typename _T1, typename _T2> inline void _Construct(
    _T1*__p,
    const _T2& __value) 

Discussion

@if maint Constructs an object in existing memory by invoking an allocated object's constructor with an initializer. @endif

template<typename _Tp> inline void _Destroy(
    _Tp*__pointer) 

Discussion

@if maint Destroy the object pointed to by a pointer type. @endif

Typedefs

template<typename _ForwardIterator> inline void _Destroy(
    _ForwardIterator __first,
    _ForwardIterator __last) 

Discussion

@if maint Destroy a range of objects. If the value_type of the object has a trivial destructor, the compiler should optimize all of this away, otherwise the objects' destructors must be invoked. @endif

Did this document help you? Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.

Last Updated: 2006-06-20