_String_const_iterator< _Mystr > Class Template Reference

Inheritance diagram for _String_const_iterator< _Mystr >:

Public Types
typedef _String_const_iterator< _Mystr >	_Myiter
typedef random_access_iterator_tag	iterator_category
typedef _Mystr::value_type	value_type
typedef _Mystr::difference_type	difference_type
typedef _Mystr::const_pointer	pointer
typedef _Mystr::const_reference	reference
typedef pointer	_Unchecked_type
Public Types inherited from _Iterator012< random_access_iterator_tag, _Mystr::value_type, _Mystr::difference_type, _Mystr::const_pointer, _Mystr::const_reference, _Iterator_base >
typedef random_access_iterator_tag	iterator_category
typedef _Mystr::value_type	value_type
typedef _Mystr::difference_type	difference_type
typedef _Mystr::difference_type	distance_type
typedef _Mystr::const_pointer	pointer
typedef _Mystr::const_reference	reference

Public Member Functions
	_String_const_iterator ()
	_String_const_iterator (pointer _Parg, const _Container_base *_Pstring)
_Myiter &	_Rechecked (_Unchecked_type _Right)
_Unchecked_type	_Unchecked () const
reference	operator* () const
pointer	operator-> () const
_Myiter &	operator++ ()
_Myiter	operator++ (int)
_Myiter &	operator-- ()
_Myiter	operator-- (int)
_Myiter &	operator+= (difference_type _Off)
_Myiter	operator+ (difference_type _Off) const
_Myiter &	operator-= (difference_type _Off)
_Myiter	operator- (difference_type _Off) const
difference_type	operator- (const _Myiter &_Right) const
reference	operator[] (difference_type _Off) const
bool	operator== (const _Myiter &_Right) const
bool	operator!= (const _Myiter &_Right) const
bool	operator< (const _Myiter &_Right) const
bool	operator> (const _Myiter &_Right) const
bool	operator<= (const _Myiter &_Right) const
bool	operator>= (const _Myiter &_Right) const
void	_Compat (const _Myiter &) const
Public Member Functions inherited from _Iterator_base0
void	_Adopt (const void *)
const _Container_base0 *	_Getcont () const

Public Attributes
pointer	_Ptr

Member Typedef Documentation

template<class _Mystr>

typedef _String_const_iterator<_Mystr> _String_const_iterator< _Mystr >::_Myiter

template<class _Mystr>

typedef pointer _String_const_iterator< _Mystr >::_Unchecked_type

template<class _Mystr>

typedef _Mystr::difference_type _String_const_iterator< _Mystr >::difference_type

template<class _Mystr>

typedef random_access_iterator_tag _String_const_iterator< _Mystr >::iterator_category

template<class _Mystr>

typedef _Mystr::const_pointer _String_const_iterator< _Mystr >::pointer

template<class _Mystr>

typedef _Mystr::const_reference _String_const_iterator< _Mystr >::reference

template<class _Mystr>

typedef _Mystr::value_type _String_const_iterator< _Mystr >::value_type

Constructor & Destructor Documentation

template<class _Mystr>

_String_const_iterator< _Mystr >::_String_const_iterator ( )

inline

        {   // construct with null pointer
        this->_Ptr = 0;
        }

template<class _Mystr>

_String_const_iterator< _Mystr >::_String_const_iterator ( pointer  _Parg, const _Container_base *  _Pstring  )

inline

        {   // construct with pointer _Parg
        this->_Adopt(_Pstring);
        this->_Ptr = _Parg;
        }

Member Function Documentation

template<class _Mystr>

void _String_const_iterator< _Mystr >::_Compat ( const _Myiter &  ) const

inline

        {   // test for compatible iterator pair
        }

template<class _Mystr>

_Myiter& _String_const_iterator< _Mystr >::_Rechecked ( _Unchecked_type  _Right )

inline

        {   // reset from unchecked iterator
        this->_Ptr = _Right;
        return (*this);
        }

template<class _Mystr>

_Unchecked_type _String_const_iterator< _Mystr >::_Unchecked ( ) const

inline

        {   // make an unchecked iterator
        return (_Unchecked_type(this->_Ptr));
        }

template<class _Mystr>

bool _String_const_iterator< _Mystr >::operator!= ( const _Myiter &  _Right ) const

inline

        {   // test for iterator inequality
        return (!(*this == _Right));
        }

template<class _Mystr>

reference _String_const_iterator< _Mystr >::operator* ( ) const

inline

        {   // return designated object
 #if _ITERATOR_DEBUG_LEVEL == 2
        if (this->_Getcont() == 0
            || this->_Ptr == 0
            || this->_Ptr < ((_Mystr *)this->_Getcont())->_Myptr()
            || ((_Mystr *)this->_Getcont())->_Myptr()
                + ((_Mystr *)this->_Getcont())->_Mysize <= this->_Ptr)
            {   // report error
            _DEBUG_ERROR("string iterator not dereferencable");
            _SCL_SECURE_OUT_OF_RANGE;
            }

 #elif _ITERATOR_DEBUG_LEVEL == 1
        _SCL_SECURE_VALIDATE(this->_Getcont() != 0 && this->_Ptr != 0);
        _SCL_SECURE_VALIDATE_RANGE(
            ((_Mystr *)this->_Getcont())->_Myptr() <= this->_Ptr
            && this->_Ptr < ((_Mystr *)this->_Getcont())->_Myptr()
                + ((_Mystr *)this->_Getcont())->_Mysize);
 #endif /* _ITERATOR_DEBUG_LEVEL */

        _Analysis_assume_(this->_Ptr != 0);

        return (*this->_Ptr);
        }

template<class _Mystr>

_Myiter _String_const_iterator< _Mystr >::operator+ ( difference_type  _Off ) const

inline

        {   // return this + integer
        _Myiter _Tmp = *this;
        return (_Tmp += _Off);
        }

template<class _Mystr>

_Myiter& _String_const_iterator< _Mystr >::operator++ ( )

inline

        {   // preincrement
 #if _ITERATOR_DEBUG_LEVEL == 2
        if (this->_Getcont() == 0
            || this->_Ptr == 0
            || ((_Mystr *)this->_Getcont())->_Myptr()
                + ((_Mystr *)this->_Getcont())->_Mysize <= this->_Ptr)
            {   // report error
            _DEBUG_ERROR("string iterator not incrementable");
            _SCL_SECURE_OUT_OF_RANGE;
            }

 #elif _ITERATOR_DEBUG_LEVEL == 1
        _SCL_SECURE_VALIDATE(this->_Getcont() != 0 && this->_Ptr != 0);
        _SCL_SECURE_VALIDATE_RANGE(
            this->_Ptr < ((_Mystr *)this->_Getcont())->_Myptr()
                + ((_Mystr *)this->_Getcont())->_Mysize);
 #endif /* _ITERATOR_DEBUG_LEVEL */

        ++this->_Ptr;
        return (*this);
        }

template<class _Mystr>

_Myiter _String_const_iterator< _Mystr >::operator++ ( int  )

inline

        {   // postincrement
        _Myiter _Tmp = *this;
        ++*this;
        return (_Tmp);
        }

template<class _Mystr>

_Myiter& _String_const_iterator< _Mystr >::operator+= ( difference_type  _Off )

inline

        {   // increment by integer
 #if _ITERATOR_DEBUG_LEVEL == 2
        if (this->_Getcont() == 0
            || this->_Ptr == 0
            || this->_Ptr + _Off < ((_Mystr *)this->_Getcont())->_Myptr()
            || ((_Mystr *)this->_Getcont())->_Myptr()
                + ((_Mystr *)this->_Getcont())->_Mysize < this->_Ptr + _Off)
            {   // report error
            _DEBUG_ERROR("string iterator + offset out of range");
            _SCL_SECURE_OUT_OF_RANGE;
            }

 #elif _ITERATOR_DEBUG_LEVEL == 1
        _SCL_SECURE_VALIDATE(this->_Getcont() != 0 && this->_Ptr != 0);
        _SCL_SECURE_VALIDATE_RANGE(
            ((_Mystr *)this->_Getcont())->_Myptr() <= this->_Ptr + _Off
                && this->_Ptr + _Off <= ((_Mystr *)this->_Getcont())->_Myptr()
                    + ((_Mystr *)this->_Getcont())->_Mysize);
 #endif /* _ITERATOR_DEBUG_LEVEL */

        _Ptr += _Off;
        return (*this);
        }

template<class _Mystr>

_Myiter _String_const_iterator< _Mystr >::operator- ( difference_type  _Off ) const

inline

        {   // return this - integer
        _Myiter _Tmp = *this;
        return (_Tmp -= _Off);
        }

template<class _Mystr>

difference_type _String_const_iterator< _Mystr >::operator- ( const _Myiter &  _Right ) const

inline

        {   // return difference of iterators
        _Compat(_Right);
        return (this->_Ptr - _Right._Ptr);
        }

template<class _Mystr>

_Myiter& _String_const_iterator< _Mystr >::operator-- ( )

inline

        {   // predecrement
 #if _ITERATOR_DEBUG_LEVEL == 2
        if (this->_Getcont() == 0
            || this->_Ptr == 0
            || this->_Ptr <= ((_Mystr *)this->_Getcont())->_Myptr())
            {   // report error
            _DEBUG_ERROR("string iterator not decrementable");
            _SCL_SECURE_OUT_OF_RANGE;
            }

 #elif _ITERATOR_DEBUG_LEVEL == 1
        _SCL_SECURE_VALIDATE(this->_Getcont() != 0 && this->_Ptr != 0);
        _SCL_SECURE_VALIDATE_RANGE(
            ((_Mystr *)this->_Getcont())->_Myptr() < this->_Ptr);
 #endif /* _ITERATOR_DEBUG_LEVEL */

        --this->_Ptr;
        return (*this);
        }

template<class _Mystr>

_Myiter _String_const_iterator< _Mystr >::operator-- ( int  )

inline

        {   // postdecrement
        _Myiter _Tmp = *this;
        --*this;
        return (_Tmp);
        }

template<class _Mystr>

_Myiter& _String_const_iterator< _Mystr >::operator-= ( difference_type  _Off )

inline

        {   // decrement by integer
        return (*this += -_Off);
        }

template<class _Mystr>

pointer _String_const_iterator< _Mystr >::operator-> ( ) const

inline

        {   // return pointer to class object
        return (_STD pointer_traits<pointer>::pointer_to(**this));
        }

template<class _Mystr>

bool _String_const_iterator< _Mystr >::operator< ( const _Myiter &  _Right ) const

inline

        {   // test if this < _Right
        _Compat(_Right);
        return (this->_Ptr < _Right._Ptr);
        }

template<class _Mystr>

bool _String_const_iterator< _Mystr >::operator<= ( const _Myiter &  _Right ) const

inline

        {   // test if this <= _Right
        return (!(_Right < *this));
        }

template<class _Mystr>

bool _String_const_iterator< _Mystr >::operator== ( const _Myiter &  _Right ) const

inline

        {   // test for iterator equality
        _Compat(_Right);
        return (this->_Ptr == _Right._Ptr);
        }

template<class _Mystr>

bool _String_const_iterator< _Mystr >::operator> ( const _Myiter &  _Right ) const

inline

        {   // test if this > _Right
        return (_Right < *this);
        }

template<class _Mystr>

bool _String_const_iterator< _Mystr >::operator>= ( const _Myiter &  _Right ) const

inline

        {   // test if this >= _Right
        return (!(*this < _Right));
        }

template<class _Mystr>

reference _String_const_iterator< _Mystr >::operator[] ( difference_type  _Off ) const

inline

        {   // subscript
        return (*(*this + _Off));
        }

Member Data Documentation

template<class _Mystr>

pointer _String_const_iterator< _Mystr >::_Ptr

---

The documentation for this class was generated from the following file:

• VS2013/inc/xstring