added wxList::IsEmpty()

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@16521 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

diff --git a/docs/latex/wx/list.tex b/docs/latex/wx/list.tex
index f7a6cd830a27d9cf145c59babf1bfa3ee4686a6d..b87233dda410c9777b8291c836c5cfb16509f0fb 100644 (file)
--- a/docs/latex/wx/list.tex
+++ b/docs/latex/wx/list.tex
@@ -176,27 +176,27 @@ The key string is copied and stored by the list implementation.
 \func{void}{Clear}{\void}
 
 Clears the list (but does not delete the client data stored with each node
 \func{void}{Clear}{\void}
 
 Clears the list (but does not delete the client data stored with each node

-unless you called DeleteContents(TRUE), in which case it deletes data).
+unless you called DeleteContents({\tt TRUE}), in which case it deletes data).

 
 \membersection{wxList::DeleteContents}\label{wxlistdeletecontents}
 
 \func{void}{DeleteContents}{\param{bool}{ destroy}}
 
 
 \membersection{wxList::DeleteContents}\label{wxlistdeletecontents}
 
 \func{void}{DeleteContents}{\param{bool}{ destroy}}
 

-If {\it destroy} is TRUE, instructs the list to call {\it delete} on the client contents of
-a node whenever the node is destroyed. The default is FALSE.
+If {\it destroy} is {\tt TRUE}, instructs the list to call {\it delete} on the client contents of
+a node whenever the node is destroyed. The default is {\tt FALSE}.

 
 \membersection{wxList::DeleteNode}\label{wxlistdeletenode}
 
 \func{bool}{DeleteNode}{\param{wxNode *}{node}}
 
 
 \membersection{wxList::DeleteNode}\label{wxlistdeletenode}
 
 \func{bool}{DeleteNode}{\param{wxNode *}{node}}
 

-Deletes the given node from the list, returning TRUE if successful.
+Deletes the given node from the list, returning {\tt TRUE} if successful.

 
 \membersection{wxList::DeleteObject}\label{wxlistdeleteobject}
 
 \func{bool}{DeleteObject}{\param{wxObject *}{object}}
 
 Finds the given client {\it object} and deletes the appropriate node from the list, returning
 
 \membersection{wxList::DeleteObject}\label{wxlistdeleteobject}
 
 \func{bool}{DeleteObject}{\param{wxObject *}{object}}
 
 Finds the given client {\it object} and deletes the appropriate node from the list, returning

-TRUE if successful. The application must delete the actual object separately.
+{\tt TRUE} if successful. The application must delete the actual object separately.

 
 \membersection{wxList::Find}\label{wxlistfind}
 
 
 \membersection{wxList::Find}\label{wxlistfind}
 


@@ -248,6 +248,12 @@ same as calling \helpref{Append}{wxlistappend}.
 
 Inserts the object before the given {\it node}.
 
 
 Inserts the object before the given {\it node}.
 

+\membersection{wxList::IsEmpty}\label{wxlistisempty}
+
+\constfunc{bool}{IsEmpty}{\void}
+
+Returns {\tt TRUE} if the list is empty, {\tt FALSE} otherwise.
+

 \membersection{wxList::Item}\label{wxlistitem}
 
 \constfunc{wxNode *}{Item}{\param{size\_t }{index}}
 \membersection{wxList::Item}\label{wxlistitem}
 
 \constfunc{wxNode *}{Item}{\param{size\_t }{index}}

diff --git a/include/wx/list.h b/include/wx/list.h
index 79a809ed59f31a7a79d32ca048e90a08c29327dd..1fd7c4808ef71c75dac0823eccb565b9b4eed2ef 100644 (file)
--- a/include/wx/list.h
+++ b/include/wx/list.h
@@ -208,6 +208,9 @@ public:
         // count of items in the list
     size_t GetCount() const { return m_count; }
 
         // count of items in the list
     size_t GetCount() const { return m_count; }
 

+        // return TRUE if this list is empty
+    bool IsEmpty() const { return m_count == 0; }
+

     // operations
 
         // delete all nodes
     // operations
 
         // delete all nodes