PUBLIC

USIntrDLIterC::USIntrDLIterC(void) USIntrDLIterC::USIntrDLIterC(IntrDListC &) USIntrDLIterC::USIntrDLIterC(const USIntrDLIterC &) USIntrDLIterC::USIntrDLIterC(IntrDListC &,DataC &) USIntrDLIterC::operator=(const USIntrDLIterC &) IntrDLIterC::Copy(void) const IntrDLIterC::operator=(const IntrDLIterC &) IntrDLIterC::DLIter(void) const IntrDLIterC::LateItemSet(IntrDListC &) IntrDLIterC::LateItemSet(const IntrDLIterC &) BaseIntrDLIterC::Data(void) const BaseIntrDLIterC::Data(void) BaseIntrDLIterC::First(void) BaseIntrDLIterC::Last(void) BaseIntrDLIterC::Next(void) BaseIntrDLIterC::Prev(void) BaseIntrDLIterC::NextCrc(void) BaseIntrDLIterC::PrevCrc(void) BaseIntrDLIterC::Nth(LongIntT) BaseIntrDLIterC::RelNth(LongIntT) BaseIntrDLIterC::LinkBef(DataC *) BaseIntrDLIterC::LinkAft(DataC *) BaseIntrDLIterC::MoveBef(BaseIntrDLIterC &) BaseIntrDLIterC::MoveAft(BaseIntrDLIterC &) BaseIntrDLIterC::MoveBef(IntrDListC &) BaseIntrDLIterC::MoveAft(IntrDListC &) BaseIntrDLIterC::UnlinkMoveNext(void) BaseIntrDLIterC::Unlink(void) BaseIntrDLIterC::LateItemSet(IntrDListC &) BaseIntrDLIterC::LateItemSet(const BaseIntrDLIterC &) BaseIntrConstDLIterC::Data(void) const BaseIntrConstDLIterC::List(void) const BaseIntrConstDLIterC::operator==(const BaseIntrConstDLIterC &) const BaseIntrConstDLIterC::operator!=(const BaseIntrConstDLIterC &) const BaseIntrConstDLIterC::IsFirst(void) const BaseIntrConstDLIterC::IsLast(void) const BaseIntrConstDLIterC::IsElm(void) const BaseIntrConstDLIterC::First(void) BaseIntrConstDLIterC::Last(void) BaseIntrConstDLIterC::Next(void) BaseIntrConstDLIterC::Prev(void) BaseIntrConstDLIterC::NextCrc(void) BaseIntrConstDLIterC::PrevCrc(void) BaseIntrConstDLIterC::Nth(LongIntT) BaseIntrConstDLIterC::RelNth(LongIntT) BaseIntrConstDLIterC::Index(void) const BaseIntrConstDLIterC::LateItemSet(IntrDListC &) BaseIntrConstDLIterC::LateItemSet(const BaseIntrConstDLIterC &) BaseIntrConstDLIterC::IsValid(void) const

USIntrDLIterC<class DataC>
include	"amma/USInDLIt.hh"
User Level:	Default
Library:	Mlist
Example:	exDList.cc
Section:	Containers.Lists
In Scope:	std

Comments:
///////////////////////////////////////////////////// DList/USInDLIt.hh 26/3/97 By Charles Galambos UnSafe IntrDLIter, this is here to make the constructor from a list and a data item public. It's unsafe because it allow's public constructon from a data element and a list.

public IntrDLIterC<class DataC>

USIntrDLIterC()

Default constructor.

USIntrDLIterC(IntrDListC<DataC> & list)

Construct from a normal iterator.

USIntrDLIterC(const USIntrDLIterC<DataC> & iter)

Copy constructor.

USIntrDLIterC(IntrDListC<DataC> & list,DataC & data)

Construct from a list and a data item. This constructor is must be use with caution. It does NOT check if the data elemnt actual belongs to the list given. If the data does not belong to this list the behavour of this class is undefined !

const USIntrDLIterC<DataC> & operator=(const USIntrDLIterC<DataC> & it)

Assignment operator.

IntrDLIterC<DataC> Copy() const

Copy constructor.

const IntrDLIterC<DataC> & operator=(const IntrDLIterC<DataC> & it)

Assingment. This iterator will point to the same list element as the iterator 'it'. Access to the object items. ---------------------------

const IntrDLIterC<DataC> & DLIter() const

Self-identification. The function returns this object. Array item constructors. ------------------------ ATTENTION! The following member functions can be used only for initialization of arrays. This constructor is provided because of trouble with an array of objects. The present ANSI C++ does not enable to pass any constructor of array elements different from a defaut constructor. The extension of GNU g++ compiler is not supported by other compiler. The constructor should be used only for such purposes. If this limitation of C++ is removed, the constructor will be obsolete.

void LateItemSet(IntrDListC<DataC> & list)

Sets the unvalid list iterator. The iterator will point to the first item of the 'list', if there is any, otherwise to the head of the list.

void LateItemSet(const IntrDLIterC<DataC> & iter)

Sets the unvalid list iterator to be the copy of the iterator 'iter'.

const DataC & Data() const

Access to the constant object contained in the list element.

DataC & Data()

Access to the object contained in the list element. BE CAREFUL. You must not change the links of created chains. Positioning the iterator. -------------------------

BaseIntrDLIterC<DataC> & First()

Sets the iterator to point to the first element of the list.

BaseIntrDLIterC<DataC> & Last()

Sets the iterator to point to the last element of the list.

BaseIntrDLIterC<DataC> & Next()

Moves the iterator to the successor of the element.

BaseIntrDLIterC<DataC> & Prev()

Moves the iterator to the predecessor of the element.

BaseIntrDLIterC<DataC> & NextCrc()

Moves the iterator to the successor of the element. If the result element is not a proper element of the list the iterator is moved to the first element.

BaseIntrDLIterC<DataC> & PrevCrc()

Moves the iterator to the predecessor of the element. If the result element is not a proper element of the list the iterator is moved to the last element.

BaseIntrDLIterC<DataC> & Nth(LongIntT n)

Sets to the n-th element of the list. The index 'n' can be negative. The first element of the list has the index 0, the last element has the index -1. It does not skip the head of the list.

BaseIntrDLIterC<DataC> & RelNth(LongIntT n)

Moves to the n-th element from the current element. The index 'n' can be positive, zero, or negative. Particularly, the n = 0 means no move, n = 1 means the move to the next element, and n = -1 means the move to the previous element. Link / Unlink / Delete. -----------------------

const BaseIntrDLIterC<DataC> & LinkBef(DataC * data)

Inserts the new element containing 'data' before the element pointed to by this iterator. This iterator is returned.

const BaseIntrDLIterC<DataC> & LinkAft(DataC * data)

Inserts the new element containing 'data' after the element pointed to by this iterator. This iterator is returned.

const BaseIntrDLIterC<DataC> & MoveBef(BaseIntrDLIterC<DataC> & iter)

The element pointed to by 'iter' is moved before the element pointed to by this iterator. This iterator will point to the same element as before. The iterator 'iter' will point to the previous element in the original list.

const BaseIntrDLIterC<DataC> & MoveAft(BaseIntrDLIterC<DataC> & iter)

The element pointed to by 'iter' is moved after the element pointed to by this iterator. This iterator will point to the same element as before. The iterator 'iter' will point to the previous element in the original list.

const BaseIntrDLIterC<DataC> & MoveBef(IntrDListC<DataC> & list)

All elements of the 'list' are moved before the element pointed to by this iterator. The 'list' will be empty after this operation.

const BaseIntrDLIterC<DataC> & MoveAft(IntrDListC<DataC> & list)

All elements of the 'list' are moved before the element pointed to by this iterator. The 'list' will be empty after this operation.

DataC * UnlinkMoveNext()

Unlinks the element pointed to by this iterator and moves iterator to the next element.

DataC * Unlink()

Unlinks the element pointed to by this iterator and moves iterator to the previous element. Array item constructors. ------------------------ ATTENTION! The following member functions can be used only for initialization of arrays. This constructor is provided because of trouble with an array of objects. The present ANSI C++ does not enable to pass any constructor of array elements different from a defaut constructor. The extension of GNU g++ compiler is not supported by other compiler. The constructor should be used only for such purposes. If this limitation of C++ is removed, the constructor will be obsolete.

void LateItemSet(IntrDListC<DataC> & list)

Sets the unvalid list iterator. The iterator will point to the first item of the 'list', if there is any, otherwise to the head of the list.

void LateItemSet(const BaseIntrDLIterC<DataC> & iter)

Sets the unvalid list iterator to be the copy of the iterator 'iter'.

const DataC & Data() const

Access to the constant object contained in the list element.

const IntrDListC<DataC> & List() const

Returns the list whose element is pointed to by this iterator. ------------ Predicates -------------------------------------

BooleanT operator==(const BaseIntrConstDLIterC<DataC> & it) const

Returns TRUE if both iterators point to the same list element.

BooleanT operator!=(const BaseIntrConstDLIterC<DataC> & it) const

Returns TRUE if this iterators points to a different list element than the iterator 'it'.

BooleanT IsFirst() const

Returns TRUE if the pointed element is the first in a list.

BooleanT IsLast() const

Returns TRUE if the pointed element is the last one in a list.

BooleanT IsElm() const

Returns TRUE if the pointed an proper element (not a head) of a list. ----------- Positioning the iterator -----------------------------

BaseIntrConstDLIterC<DataC> & First()

Sets the iterator to point to the first element of the list.

BaseIntrConstDLIterC<DataC> & Last()

Sets the iterator to point to the last element of the list.

BaseIntrConstDLIterC<DataC> & Next()

Moves the iterator to the successor of the element.

BaseIntrConstDLIterC<DataC> & Prev()

Moves the iterator to the predecessor of the element.

BaseIntrConstDLIterC<DataC> & NextCrc()

Moves the iterator to the successor of the element. If the result element is not a proper element of the list the iterator is moved to the first element.

BaseIntrConstDLIterC<DataC> & PrevCrc()

Moves the iterator to the predecessor of the element. If the result element is not a proper element of the list the iterator is moved to the last element.

BaseIntrConstDLIterC<DataC> & Nth(LongIntT n)

Sets to the n-th element of the list. The index 'n' can be negative. The first element of the list has the index 0, the last element has the index -1. It does not skip the head of the list.

BaseIntrConstDLIterC<DataC> & RelNth(LongIntT n)

Moves to the n-th element from the current element. The index 'n' can be positive, zero, or negative. Particularly, the n = 0 means no move, n = 1 means the move to the next element, and n = -1 means the move to the previous element.

LongIntT Index() const

Returns the offset of an element from the first element. Particularly, it returns 0 if the iterator points to the first element, it returns -1 if element is the head of the list, and it returns -2 if the element is not contained in the list. The function does not check counter overflow. Array item constructors. ------------------------ ATTENTION! The following member functions can be used only for initialization of arrays. This constructor is provided because of trouble with an array of objects. The present ANSI C++ does not enable to pass any constructor of array elements different from a defaut constructor. The extension of GNU g++ compiler is not supported by other compiler. The constructor should be used only for such purposes. If this limitation of C++ is removed, the constructor will be obsolete.

void LateItemSet(IntrDListC<DataC> & list)

Sets the unvalid list iterator. The iterator will point to the first item of the 'list', if there is any, otherwise to the head of the list.

void LateItemSet(const BaseIntrConstDLIterC<DataC> & iter)

Sets the unvalid list iterator to be the copy of the iterator 'iter'.

BooleanT IsValid() const

Returns TRUE if the iterator was not constructed by the default constructor.