]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/list.tex
Correct wxObjectDataPtr<> assignment from *T to not increase the ref count
[wxWidgets.git] / docs / latex / wx / list.tex
index cb54ec86cfdb1bbb50abd50586d677769243e0b7..b5064e807216f11667aebf3f31e4f53922b60823 100644 (file)
 
 \section{\class{wxList<T>}}\label{wxlist}
 
-The wxList<T> class provides linked list functionality. It has been written
+The wxList<T> class provides linked list functionality. It has been rewritten
 to be type safe and to provide the full API of the STL std::list container and
 should be used like it. The exception is that wxList<T> actually stores
 pointers and therefore its iterators return pointers and not references
 to the actual objets in the list (see example below) and {\it value\_type} 
-is defined as {\it T*}.
+is defined as {\it T*}. wxList<T> destroys an object after removing it only
+if \helpref{DeleteContents}{wxlistdeletecontents} has been called.
 
-
-Unfortunately, the
-new wxList<T> class requires that you declare and define each wxList<T>
-class in your program. This is done with {\it WX\_DECLARE\_LIST} and 
-{\it WX\_DEFINE\_LIST} macros (see example). We hope that we'll be able
+wxList<T> is not a real template and it requires that you declare and define 
+each wxList<T> class in your program. This is done with {\it WX\_DECLARE\_LIST}
+and {\it WX\_DEFINE\_LIST} macros (see example). We hope that we'll be able
 to provide a proper template class providing both the STL std::list
 and the old wxList API in the future.
 
@@ -127,7 +126,7 @@ unless you called DeleteContents({\tt true} ).
 
 Appends the pointer to \rtfsp{\it object} to the list.
 
-\membersection{wxList<T>::Clear}\label{wxlistclear}
+\membersection{wxList<T>::Clear}\label{wxlistclear1}
 
 \func{void}{Clear}{\void}
 
@@ -194,7 +193,7 @@ Returns the last iterator in the list (NULL if the list is empty).
 Returns the index of {\it obj} within the list or {\tt wxNOT\_FOUND} if
 {\it obj} is not found in the list.
 
-\membersection{wxList<T>::Insert}\label{wxlistinsert}
+\membersection{wxList<T>::Insert}\label{wxlistinsert1}
 
 \func{wxList<T>::compatibility\_iterator}{Insert}{\param{T *}{object}}