libstdc++
Classes | Typedefs | Enumerations | Functions
__gnu_debug Namespace Reference

Classes

class  _After_nth_from
struct  _BeforeBeginHelper
class  _Equal_to
class  _Not_equal_to
class  _Safe_iterator
 Safe iterator wrapper. More...
class  _Safe_iterator_base
 Basic functionality for a safe iterator. More...
class  _Safe_local_iterator
 Safe iterator wrapper. More...
class  _Safe_local_iterator_base
 Basic functionality for a safe iterator. More...
class  _Safe_sequence
 Base class for constructing a safe sequence type that tracks iterators that reference it. More...
class  _Safe_sequence_base
 Base class that supports tracking of iterators that reference a sequence. More...
class  _Safe_unordered_container
 Base class for constructing a safe unordered container type that tracks iterators that reference it. More...
class  _Safe_unordered_container_base
 Base class that supports tracking of local iterators that reference an unordered container. More...
class  basic_string
 Class std::basic_string with safety/checking/debug instrumentation. More...

Typedefs

typedef basic_string< char > string
typedef basic_string< wchar_t > wstring

Enumerations

enum  _Debug_msg_id {
  __msg_valid_range, __msg_insert_singular, __msg_insert_different, __msg_erase_bad,
  __msg_erase_different, __msg_subscript_oob, __msg_empty, __msg_unpartitioned,
  __msg_unpartitioned_pred, __msg_unsorted, __msg_unsorted_pred, __msg_not_heap,
  __msg_not_heap_pred, __msg_bad_bitset_write, __msg_bad_bitset_read, __msg_bad_bitset_flip,
  __msg_self_splice, __msg_splice_alloc, __msg_splice_bad, __msg_splice_other,
  __msg_splice_overlap, __msg_init_singular, __msg_init_copy_singular, __msg_init_const_singular,
  __msg_copy_singular, __msg_bad_deref, __msg_bad_inc, __msg_bad_dec,
  __msg_iter_subscript_oob, __msg_advance_oob, __msg_retreat_oob, __msg_iter_compare_bad,
  __msg_compare_different, __msg_iter_order_bad, __msg_order_different, __msg_distance_bad,
  __msg_distance_different, __msg_deref_istream, __msg_inc_istream, __msg_output_ostream,
  __msg_deref_istreambuf, __msg_inc_istreambuf, __msg_insert_after_end, __msg_erase_after_bad,
  __msg_valid_range2, __msg_local_iter_compare_bad, __msg_non_empty_range
}
enum  _Distance_precision { __dp_equality, __dp_sign, __dp_exact }

Functions

template<typename _Iterator >
_Siter_base< _Iterator >
::iterator_type 		__base (_Iterator __it)
template<typename _Iterator >
bool __check_dereferenceable (_Iterator &)
template<typename _Tp >
bool __check_dereferenceable (const _Tp *__ptr)
template<typename _Iterator , typename _Sequence >
bool __check_dereferenceable (const _Safe_iterator< _Iterator, _Sequence > &__x)
template<typename _ForwardIterator , typename _Tp >
bool __check_partitioned_lower (_ForwardIterator __first, _ForwardIterator __last, const _Tp &__value)
template<typename _ForwardIterator , typename _Tp , typename _Pred >
bool __check_partitioned_lower (_ForwardIterator __first, _ForwardIterator __last, const _Tp &__value, _Pred __pred)
template<typename _ForwardIterator , typename _Tp >
bool __check_partitioned_upper (_ForwardIterator __first, _ForwardIterator __last, const _Tp &__value)
template<typename _ForwardIterator , typename _Tp , typename _Pred >
bool __check_partitioned_upper (_ForwardIterator __first, _ForwardIterator __last, const _Tp &__value, _Pred __pred)
template<typename _Iterator >
bool __check_singular (_Iterator &)
template<typename _Tp >
bool __check_singular (const _Tp *__ptr)
template<typename _Iterator , typename _Sequence >
bool __check_singular (const _Safe_iterator< _Iterator, _Sequence > &__x)
bool __check_singular_aux (const void *)
bool __check_singular_aux (const _Safe_iterator_base *__x)
template<typename _InputIterator >
bool __check_sorted (const _InputIterator &__first, const _InputIterator &__last)
template<typename _InputIterator , typename _Predicate >
bool __check_sorted (const _InputIterator &__first, const _InputIterator &__last, _Predicate __pred)
template<typename _InputIterator >
bool __check_sorted_aux (const _InputIterator &, const _InputIterator &, std::input_iterator_tag)
template<typename _ForwardIterator >
bool __check_sorted_aux (_ForwardIterator __first, _ForwardIterator __last, std::forward_iterator_tag)
template<typename _InputIterator , typename _Predicate >
bool __check_sorted_aux (const _InputIterator &, const _InputIterator &, _Predicate, std::input_iterator_tag)
template<typename _ForwardIterator , typename _Predicate >
bool __check_sorted_aux (_ForwardIterator __first, _ForwardIterator __last, _Predicate __pred, std::forward_iterator_tag)
template<typename _InputIterator1 , typename _InputIterator2 >
bool __check_sorted_set (const _InputIterator1 &__first, const _InputIterator1 &__last, const _InputIterator2 &)
template<typename _InputIterator1 , typename _InputIterator2 , typename _Predicate >
bool __check_sorted_set (const _InputIterator1 &__first, const _InputIterator1 &__last, const _InputIterator2 &, _Predicate __pred)
template<typename _InputIterator >
bool __check_sorted_set_aux (const _InputIterator &__first, const _InputIterator &__last, std::__true_type)
template<typename _InputIterator >
bool __check_sorted_set_aux (const _InputIterator &, const _InputIterator &, std::__false_type)
template<typename _InputIterator , typename _Predicate >
bool __check_sorted_set_aux (const _InputIterator &__first, const _InputIterator &__last, _Predicate __pred, std::__true_type)
template<typename _InputIterator , typename _Predicate >
bool __check_sorted_set_aux (const _InputIterator &, const _InputIterator &, _Predicate, std::__false_type)
template<typename _CharT , typename _Integer >
const _CharT * __check_string (const _CharT *__s, const _Integer &__n __attribute__((__unused__)))
template<typename _CharT >
const _CharT * __check_string (const _CharT *__s)
template<typename _InputIterator >
_InputIterator __check_valid_range (const _InputIterator &__first, const _InputIterator &__last __attribute__((__unused__)))
template<typename _Iterator1 , typename _Iterator2 >
std::pair< typename
std::iterator_traits
< _Iterator1 >
::difference_type,
_Distance_precision > 		__get_distance (const _Iterator1 &__lhs, const _Iterator2 &__rhs, std::random_access_iterator_tag)
template<typename _Iterator1 , typename _Iterator2 >
std::pair< typename
std::iterator_traits
< _Iterator1 >
::difference_type,
_Distance_precision > 		__get_distance (const _Iterator1 &__lhs, const _Iterator2 &__rhs, std::forward_iterator_tag)
template<typename _Iterator1 , typename _Iterator2 >
std::pair< typename
std::iterator_traits
< _Iterator1 >
::difference_type,
_Distance_precision > 		__get_distance (const _Iterator1 &__lhs, const _Iterator2 &__rhs)
template<typename _InputIterator >
bool __valid_range (const _InputIterator &__first, const _InputIterator &__last)
template<typename _Iterator , typename _Sequence >
bool __valid_range (const _Safe_iterator< _Iterator, _Sequence > &__first, const _Safe_iterator< _Iterator, _Sequence > &__last)
template<typename _Iterator , typename _Sequence >
bool __valid_range (const _Safe_local_iterator< _Iterator, _Sequence > &__first, const _Safe_local_iterator< _Iterator, _Sequence > &__last)
template<typename _Integral >
bool __valid_range_aux (const _Integral &, const _Integral &, std::__true_type)
template<typename _InputIterator >
bool __valid_range_aux (const _InputIterator &__first, const _InputIterator &__last, std::__false_type)
template<typename _RandomAccessIterator >
bool __valid_range_aux2 (const _RandomAccessIterator &__first, const _RandomAccessIterator &__last, std::random_access_iterator_tag)
template<typename _InputIterator >
bool __valid_range_aux2 (const _InputIterator &, const _InputIterator &, std::input_iterator_tag)
template<typename _CharT , typename _Traits , typename _Allocator >
std::basic_istream< _CharT,
_Traits > & 		getline (std::basic_istream< _CharT, _Traits > &__is, basic_string< _CharT, _Traits, _Allocator > &__str, _CharT __delim)
template<typename _CharT , typename _Traits , typename _Allocator >
std::basic_istream< _CharT,
_Traits > & 		getline (std::basic_istream< _CharT, _Traits > &__is, basic_string< _CharT, _Traits, _Allocator > &__str)
template<typename _IteratorL , typename _IteratorR , typename _Sequence >
bool operator!= (const _Safe_local_iterator< _IteratorL, _Sequence > &__lhs, const _Safe_local_iterator< _IteratorR, _Sequence > &__rhs)
template<typename _Iterator , typename _Sequence >
bool operator!= (const _Safe_local_iterator< _Iterator, _Sequence > &__lhs, const _Safe_local_iterator< _Iterator, _Sequence > &__rhs)
template<typename _IteratorL , typename _IteratorR , typename _Sequence >
bool operator!= (const _Safe_iterator< _IteratorL, _Sequence > &__lhs, const _Safe_iterator< _IteratorR, _Sequence > &__rhs)
template<typename _Iterator , typename _Sequence >
bool operator!= (const _Safe_iterator< _Iterator, _Sequence > &__lhs, const _Safe_iterator< _Iterator, _Sequence > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator!= (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator!= (const _CharT *__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator!= (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const _CharT *__rhs)
template<typename _Iterator , typename _Sequence >
_Safe_iterator< _Iterator,
_Sequence > 		operator+ (typename _Safe_iterator< _Iterator, _Sequence >::difference_type __n, const _Safe_iterator< _Iterator, _Sequence > &__i)
template<typename _CharT , typename _Traits , typename _Allocator >
basic_string< _CharT, _Traits,
_Allocator > 		operator+ (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
basic_string< _CharT, _Traits,
_Allocator > 		operator+ (const _CharT *__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
basic_string< _CharT, _Traits,
_Allocator > 		operator+ (_CharT __lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
basic_string< _CharT, _Traits,
_Allocator > 		operator+ (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const _CharT *__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
basic_string< _CharT, _Traits,
_Allocator > 		operator+ (const basic_string< _CharT, _Traits, _Allocator > &__lhs, _CharT __rhs)
template<typename _IteratorL , typename _IteratorR , typename _Sequence >
_Safe_iterator< _IteratorL,
_Sequence >::difference_type 		operator- (const _Safe_iterator< _IteratorL, _Sequence > &__lhs, const _Safe_iterator< _IteratorR, _Sequence > &__rhs)
template<typename _Iterator , typename _Sequence >
_Safe_iterator< _Iterator,
_Sequence >::difference_type 		operator- (const _Safe_iterator< _Iterator, _Sequence > &__lhs, const _Safe_iterator< _Iterator, _Sequence > &__rhs)
template<typename _IteratorL , typename _IteratorR , typename _Sequence >
bool operator< (const _Safe_iterator< _IteratorL, _Sequence > &__lhs, const _Safe_iterator< _IteratorR, _Sequence > &__rhs)
template<typename _Iterator , typename _Sequence >
bool operator< (const _Safe_iterator< _Iterator, _Sequence > &__lhs, const _Safe_iterator< _Iterator, _Sequence > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator< (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator< (const _CharT *__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator< (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const _CharT *__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
std::basic_ostream< _CharT,
_Traits > & 		operator<< (std::basic_ostream< _CharT, _Traits > &__os, const basic_string< _CharT, _Traits, _Allocator > &__str)
template<typename _IteratorL , typename _IteratorR , typename _Sequence >
bool operator<= (const _Safe_iterator< _IteratorL, _Sequence > &__lhs, const _Safe_iterator< _IteratorR, _Sequence > &__rhs)
template<typename _Iterator , typename _Sequence >
bool operator<= (const _Safe_iterator< _Iterator, _Sequence > &__lhs, const _Safe_iterator< _Iterator, _Sequence > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator<= (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator<= (const _CharT *__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator<= (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const _CharT *__rhs)
template<typename _IteratorL , typename _IteratorR , typename _Sequence >
bool operator== (const _Safe_local_iterator< _IteratorL, _Sequence > &__lhs, const _Safe_local_iterator< _IteratorR, _Sequence > &__rhs)
template<typename _Iterator , typename _Sequence >
bool operator== (const _Safe_local_iterator< _Iterator, _Sequence > &__lhs, const _Safe_local_iterator< _Iterator, _Sequence > &__rhs)
template<typename _IteratorL , typename _IteratorR , typename _Sequence >
bool operator== (const _Safe_iterator< _IteratorL, _Sequence > &__lhs, const _Safe_iterator< _IteratorR, _Sequence > &__rhs)
template<typename _Iterator , typename _Sequence >
bool operator== (const _Safe_iterator< _Iterator, _Sequence > &__lhs, const _Safe_iterator< _Iterator, _Sequence > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator== (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator== (const _CharT *__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator== (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const _CharT *__rhs)
template<typename _IteratorL , typename _IteratorR , typename _Sequence >
bool operator> (const _Safe_iterator< _IteratorL, _Sequence > &__lhs, const _Safe_iterator< _IteratorR, _Sequence > &__rhs)
template<typename _Iterator , typename _Sequence >
bool operator> (const _Safe_iterator< _Iterator, _Sequence > &__lhs, const _Safe_iterator< _Iterator, _Sequence > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator> (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator> (const _CharT *__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator> (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const _CharT *__rhs)
template<typename _IteratorL , typename _IteratorR , typename _Sequence >
bool operator>= (const _Safe_iterator< _IteratorL, _Sequence > &__lhs, const _Safe_iterator< _IteratorR, _Sequence > &__rhs)
template<typename _Iterator , typename _Sequence >
bool operator>= (const _Safe_iterator< _Iterator, _Sequence > &__lhs, const _Safe_iterator< _Iterator, _Sequence > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator>= (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator>= (const _CharT *__lhs, const basic_string< _CharT, _Traits, _Allocator > &__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
bool operator>= (const basic_string< _CharT, _Traits, _Allocator > &__lhs, const _CharT *__rhs)
template<typename _CharT , typename _Traits , typename _Allocator >
std::basic_istream< _CharT,
_Traits > & 		operator>> (std::basic_istream< _CharT, _Traits > &__is, basic_string< _CharT, _Traits, _Allocator > &__str)
template<typename _CharT , typename _Traits , typename _Allocator >
void swap (basic_string< _CharT, _Traits, _Allocator > &__lhs, basic_string< _CharT, _Traits, _Allocator > &__rhs)

Detailed Description

GNU debug classes for public use.

Enumeration Type Documentation

enum __gnu_debug::_Distance_precision

The precision to which we can calculate the distance between two iterators.

Definition at line 72 of file safe_iterator.h.

Function Documentation

template<typename _Iterator >
_Siter_base<_Iterator>::iterator_type __gnu_debug::__base ( _Iterator  __it)
inline

Helper function to extract base iterator of random access safe iterator in order to reduce performance impact of debug mode. Limited to random access iterator because it is the only category for which it is possible to check for correct iterators order in the __valid_range function thanks to the < operator.

Definition at line 743 of file safe_iterator.h.

Referenced by __gnu_parallel::__for_each_template_random_access_workstealing(), __gnu_debug::_Safe_iterator< _Iterator, _Sequence >::_M_before_dereferenceable(), __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::append(), __gnu_debug::basic_string< _CharT, _Traits, _Allocator >::assign(), std::boolalpha(), std::dec(), std::fixed(), std::hex(), std::internal(), std::left(), std::noboolalpha(), std::noshowbase(), std::noshowpoint(), std::noshowpos(), std::noskipws(), std::nounitbuf(), std::nouppercase(), std::oct(), std::right(), std::scientific(), std::showbase(), std::showpoint(), std::showpos(), std::skipws(), std::unitbuf(), and std::uppercase().

template<typename _Iterator >
bool __gnu_debug::__check_dereferenceable ( _Iterator &  )
inline

Assume that some arbitrary iterator is dereferenceable, because we can't prove that it isn't.

Definition at line 70 of file functions.h.

template<typename _Tp >
bool __gnu_debug::__check_dereferenceable ( const _Tp *  __ptr)
inline

Non-NULL pointers are dereferenceable.

Definition at line 76 of file functions.h.

template<typename _Iterator , typename _Sequence >
bool __gnu_debug::__check_dereferenceable ( const _Safe_iterator< _Iterator, _Sequence > &  __x)
inline

Safe iterators know if they are singular.

Definition at line 82 of file functions.h.

References __gnu_debug::_Safe_iterator< _Iterator, _Sequence >::_M_dereferenceable().

template<typename _Tp >
bool __gnu_debug::__check_singular ( const _Tp *  __ptr)
inline

Non-NULL pointers are nonsingular.

Definition at line 57 of file functions.h.

template<typename _Iterator , typename _Sequence >
bool __gnu_debug::__check_singular ( const _Safe_iterator< _Iterator, _Sequence > &  __x)
inline

Safe iterators know if they are singular.

Definition at line 63 of file functions.h.

References __gnu_debug::_Safe_iterator_base::_M_singular().

bool __gnu_debug::__check_singular_aux ( const _Safe_iterator_base *  __x)
inline

Iterators that derive from _Safe_iterator_base but that aren't _Safe_iterators can be determined singular or non-singular via _Safe_iterator_base.

Definition at line 66 of file safe_iterator.h.

References __gnu_debug::_Safe_iterator_base::_M_singular().

template<typename _CharT , typename _Integer >
const _CharT* __gnu_debug::__check_string ( const _CharT *  __s,
const _Integer &__n   __attribute__(__unused__) 
)
inline

Checks that __s is non-NULL or __n == 0, and then returns __s.

Definition at line 171 of file functions.h.

template<typename _CharT >
const _CharT* __gnu_debug::__check_string ( const _CharT *  __s)
inline

Checks that __s is non-NULL and then returns __s.

Definition at line 183 of file functions.h.

template<typename _Iterator1 , typename _Iterator2 >
std::pair<typename std::iterator_traits<_Iterator1>::difference_type, _Distance_precision> __gnu_debug::__get_distance ( const _Iterator1 &  __lhs,
const _Iterator2 &  __rhs,
std::random_access_iterator_tag   
)
inline

Determine the distance between two iterators with some known precision.

Definition at line 85 of file safe_iterator.h.

References std::make_pair().

template<typename _InputIterator >
bool __gnu_debug::__valid_range ( const _InputIterator &  __first,
const _InputIterator &  __last 
)
inline

Don't know what these iterators are, or if they are even iterators (we may get an integral type for InputIterator), so see if they are integral and pass them on to the next phase otherwise.

Definition at line 134 of file functions.h.

References __valid_range_aux().

template<typename _Iterator , typename _Sequence >
bool __gnu_debug::__valid_range ( const _Safe_iterator< _Iterator, _Sequence > &  __first,
const _Safe_iterator< _Iterator, _Sequence > &  __last 
)
inline

Safe iterators know how to check if they form a valid range.

Definition at line 143 of file functions.h.

template<typename _Iterator , typename _Sequence >
bool __gnu_debug::__valid_range ( const _Safe_local_iterator< _Iterator, _Sequence > &  __first,
const _Safe_local_iterator< _Iterator, _Sequence > &  __last 
)
inline

Safe local iterators know how to check if they form a valid range.

Definition at line 150 of file functions.h.

template<typename _Integral >
bool __gnu_debug::__valid_range_aux ( const _Integral &  ,
const _Integral &  ,
std::__true_type   
)
inline

We say that integral types for a valid range, and defer to other routines to realize what to do with integral types instead of iterators.

Definition at line 111 of file functions.h.

Referenced by __valid_range().

template<typename _InputIterator >
bool __gnu_debug::__valid_range_aux ( const _InputIterator &  __first,
const _InputIterator &  __last,
std::__false_type   
)
inline

We have iterators, so figure out what kind of iterators that are to see if we can check the range ahead of time.

Definition at line 119 of file functions.h.

References __valid_range_aux2().

template<typename _RandomAccessIterator >
bool __gnu_debug::__valid_range_aux2 ( const _RandomAccessIterator &  __first,
const _RandomAccessIterator &  __last,
std::random_access_iterator_tag   
)
inline

If the distance between two random access iterators is nonnegative, assume the range is valid.

Definition at line 90 of file functions.h.

Referenced by __valid_range_aux().

template<typename _InputIterator >
bool __gnu_debug::__valid_range_aux2 ( const _InputIterator &  ,
const _InputIterator &  ,
std::input_iterator_tag   
)
inline

Can't test for a valid range with input iterators, because iteration may be destructive. So we just assume that the range is valid.

Definition at line 101 of file functions.h.