/////////////////////////////////////////////////////////////////////////////
// Name: list.h
-// Purpose: documentation for wxList<T> class
+// Purpose: interface of wxList<T>
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
@library{wxbase}
@category{FIXME}
- @seealso
- wxArrayT, wxVectorT
+ @see wxArrayT(), wxVectorT()
*/
class wxList<T>
{
Constructors.
*/
wxListT();
- wxListT(size_t count, T * elements[]);
+ wxListT(size_t count, T* elements[]);
//@}
/**
~wxListT();
/**
- Appends the pointer to @e object to the list.
+ Appends the pointer to @a object to the list.
*/
- wxListT::compatibility_iterator Append(T * object);
+ wxListT::compatibility_iterator Append(T* object);
/**
Clears the list, but does not delete the objects stored in the list
void Clear();
/**
- If @e destroy is @true, instructs the list to call @e delete
+ If @a destroy is @true, instructs the list to call @e delete
on objects stored in the list whenever they are removed.
The default is @false.
*/
bool DeleteNode(const compatibility_iterator& iter);
/**
- Finds the given @e object and removes it from the list, returning
+ Finds the given @a object and removes it from the list, returning
@true if successful. The application must delete the actual object
separately.
*/
- bool DeleteObject(T * object);
+ bool DeleteObject(T* object);
/**
Removes element refered to be @c iter.
void Erase(const compatibility_iterator& iter);
/**
- Returns the iterator refering to @e object or @NULL if none found.
+ Returns the iterator refering to @a object or @NULL if none found.
*/
- wxListT::compatibility_iterator Find(T * object);
+ wxListT::compatibility_iterator Find(T* object) const;
/**
Returns the number of elements in the list.
*/
- size_t GetCount();
+ size_t GetCount() const;
/**
Returns the first iterator in the list (@NULL if the list is empty).
*/
- wxListT::compatibility_iterator GetFirst();
+ wxListT::compatibility_iterator GetFirst() const;
/**
Returns the last iterator in the list (@NULL if the list is empty).
*/
- wxListT::compatibility_iterator GetLast();
+ wxListT::compatibility_iterator GetLast() const;
/**
- Returns the index of @e obj within the list or @c wxNOT_FOUND if
- @e obj is not found in the list.
+ Returns the index of @a obj within the list or @c wxNOT_FOUND if
+ @a obj is not found in the list.
*/
- int IndexOf(T* obj);
+ int IndexOf(T* obj) const;
//@{
/**
Inserts the object before the object refered to be @e iter.
*/
- wxListT::compatibility_iterator Insert(T * object);
+ wxListT::compatibility_iterator Insert(T* object);
wxListT::compatibility_iterator Insert(size_t position,
- T * object);
+ T* object);
wxListT::compatibility_iterator Insert(compatibility_iterator iter,
- T * object);
+ T* object);
//@}
/**
Returns @true if the list is empty, @false otherwise.
*/
- bool IsEmpty();
+ bool IsEmpty() const;
/**
Returns the iterator refering to the object at the given
@c index in the list.
*/
- wxListT::compatibility_iterator Item(size_t index);
+ wxListT::compatibility_iterator Item(size_t index) const;
/**
@b NB: This function is deprecated, use wxList::Find instead.
*/
- wxListT::compatibility_iterator Member(T * object);
+ wxListT::compatibility_iterator Member(T* object) const;
/**
@b NB: This function is deprecated, use @ref wxList::itemfunc Item instead.
-
Returns the @e nth node in the list, indexing from zero (@NULL if the list is
empty
or the nth node could not be found).
*/
-#define wxListT::compatibility_iterator Nth(int n) /* implementation is private */
+ wxListT::compatibility_iterator Nth(int n) const;
/**
@b NB: This function is deprecated, use wxList::GetCount instead.
-
Returns the number of elements in the list.
*/
- int Number();
+ int Number() const;
/**
Allows the sorting of arbitrary lists by giving a function to compare
/**
Returns the last item of the list.
*/
- reference back();
- const_reference back();
+ reference back() const;
+ const_reference back() const;
//@}
//@{
/**
Returns a (const) iterator pointing to the beginning of the list.
*/
- iterator begin();
- const_iterator begin();
+ iterator begin() const;
+ const_iterator begin() const;
//@}
/**
/**
Returns @e @true if the list is empty.
*/
- bool empty();
+ bool empty() const;
//@{
/**
Returns a (const) iterator pointing at the end of the list.
*/
- iterator end();
- const_iterator end();
+ iterator end() const;
+ const_iterator end() const;
//@}
//@{
/**
- Erases the items from @e first to @e last.
+ Erases the items from @a first to @e last.
*/
iterator erase(const iterator& it);
iterator erase(const iterator& first,
/**
Returns the first item in the list.
*/
- reference front();
- const_reference front();
+ reference front() const;
+ const_reference front() const;
//@}
//@{
/**
Returns the largest possible size of the list.
*/
- size_type max_size();
+ size_type max_size() const;
/**
Removes the last item from the list.
/**
)
-
Adds an item to end of the list.
*/
void push_back();
/**
)
-
Adds an item to the front of the list.
*/
void push_front();
Returns a (const) reverse iterator pointing to the beginning of the
reversed list.
*/
- reverse_iterator rbegin();
- const_reverse_iterator rbegin();
+ reverse_iterator rbegin() const;
+ const_reverse_iterator rbegin() const;
//@}
/**
Returns a (const) reverse iterator pointing to the end of the
reversed list.
*/
- reverse_iterator rend();
- const_reverse_iterator rend();
+ reverse_iterator rend() const;
+ const_reverse_iterator rend() const;
//@}
/**
)
-
Resizes the list. If the the list is enlarges items with
the value @e v are appended to the list.
*/
/**
Returns the size of the list.
*/
- size_type size();
+ size_type size() const;
};
+
/**
@class wxNode
@wxheader{list.h}
@library{wxbase}
@category{FIXME}
- @seealso
- wxList, wxHashTable
+ @see wxList, wxHashTable
*/
class wxNode
{
/**
Retrieves the client data pointer associated with the node.
*/
- T * GetData();
+ T* GetData() const;
/**
Retrieves the next node or @NULL if this node is the last one.
*/
- wxNodeT * GetNext();
+ wxNodeT* GetNext() const;
/**
Retrieves the previous node or @NULL if this node is the first one in the list.
*/
- wxNodeT * GetPrevious();
+ wxNodeT* GetPrevious();
/**
Returns the zero-based index of this node within the list. The return value
Sets the data associated with the node (usually the pointer will have been
set when the node was created).
*/
- void SetData(T * data);
+ void SetData(T* data);
};
+
projects / wxWidgets.git / blobdiff