wxWidgets/docs/latex/wx/strlist.tex

83 lines
2.2 KiB
TeX
Raw Normal View History

\section{\class{wxStringList}}\label{wxstringlist}
{\bf NB:} This class is obsolete, please don't use it any longer. You can use
either \helpref{wxArrayString}{wxarraystring} or a \helpref{type safe}{wxlist}
list class instead.
A string list is a list which is assumed to contain strings.
Memory is allocated when strings are added to
the list, and deallocated by the destructor or by the {\bf Delete}\rtfsp
member.
\wxheading{Derived from}
\helpref{wxList}{wxlist}\\
\helpref{wxObject}{wxobject}
\wxheading{Include files}
<wx/list.h>
\wxheading{See also}
\helpref{wxString}{wxstring}, \helpref{wxList}{wxlist}
\latexignore{\rtfignore{\wxheading{Members}}}
\membersection{wxStringList::wxStringList}\label{wxstringlistctor}
\func{}{wxStringList}{\void}
Constructor.
\func{void}{wxStringList}{\param{char* }{first}, ...}
Constructor, taking NULL-terminated string argument list. wxStringList
allocates memory for the strings.
\membersection{wxStringList::\destruct{wxStringList}}\label{wxstringlistdtor}
\func{}{\destruct{wxStringList}}{\void}
Deletes string list, deallocating strings.
\membersection{wxStringList::Add}\label{wxstringlistadd}
\func{wxNode *}{Add}{\param{const wxString\& }{s}}
Adds string to list, allocating memory.
\membersection{wxStringList::Clear}\label{wxstringlistclear}
\func{void}{Clear}{\void}
Clears all strings from the list.
\membersection{wxStringList::Delete}\label{wxstringlistdelete}
\func{void}{Delete}{\param{const wxString\& }{s}}
Searches for string and deletes from list, deallocating memory.
\membersection{wxStringList::ListToArray}\label{wxstringlistlisttoarray}
\func{char*}{ListToArray}{\param{bool}{ new\_copies = false}}
Converts the list to an array of strings, only allocating new memory if
\rtfsp{\bf new\_copies} is true.
\membersection{wxStringList::Member}\label{wxstringlistmember}
\func{bool}{Member}{\param{const wxString\& }{s}}
Returns true if {\bf s} is a member of the list (tested using {\bf strcmp}).
\membersection{wxStringList::Sort}\label{wxstringlistsort}
\func{void}{Sort}{\void}
Sorts the strings in ascending alphabetical order. Note that all nodes
(but not strings) get deallocated and new ones allocated.