projects
/
wxWidgets.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Provide a wxDirSelectorPromptStr
[wxWidgets.git]
/
docs
/
latex
/
wx
/
hashmap.tex
diff --git
a/docs/latex/wx/hashmap.tex
b/docs/latex/wx/hashmap.tex
index 2faf063e6319e21dd01013b93ea02b7b15bbdfa9..ebb9c60e6a3c55b0593afdb78f946271ecab99a5 100644
(file)
--- a/
docs/latex/wx/hashmap.tex
+++ b/
docs/latex/wx/hashmap.tex
@@
-2,8
+2,8
@@
This is a simple, type-safe, and reasonably efficient hash map class,
whose interface is a subset of the interface of STL containers. In
This is a simple, type-safe, and reasonably efficient hash map class,
whose interface is a subset of the interface of STL containers. In
-particular, the interface is model
l
ed after std::map, and the various,
-non
standard, std::hash\_map.
+particular, the interface is modeled after std::map, and the various,
+non
-
standard, std::hash\_map.
\wxheading{Example}
\wxheading{Example}
@@
-48,7
+48,7
@@
non standard, std::hash\_map.
CLASSNAME ); // name of the class
\end{verbatim}
CLASSNAME ); // name of the class
\end{verbatim}
-Declares a
n
hash map class named CLASSNAME, with {\tt wxString} keys
+Declares a hash map class named CLASSNAME, with {\tt wxString} keys
and VALUE\_T values.
\begin{verbatim}
and VALUE\_T values.
\begin{verbatim}
@@
-56,7
+56,7
@@
and VALUE\_T values.
CLASSNAME ); // name of the class
\end{verbatim}
CLASSNAME ); // name of the class
\end{verbatim}
-Declares a
n
hash map class named CLASSNAME, with {\tt void*} keys
+Declares a hash map class named CLASSNAME, with {\tt void*} keys
and VALUE\_T values.
\begin{verbatim}
and VALUE\_T values.
\begin{verbatim}
@@
-77,7
+77,7
@@
and their unsigned counterparts ), {\tt wxStringHash} for strings
Similarly three equality predicates:
{\tt wxIntegerEqual}, {\tt wxStringEqual}, {\tt wxPointerEqual} are provided.
Similarly three equality predicates:
{\tt wxIntegerEqual}, {\tt wxStringEqual}, {\tt wxPointerEqual} are provided.
-Using this you could declare a
n
hash map mapping {\tt int} values
+Using this you could declare a hash map mapping {\tt int} values
to {\tt wxString} like this:
\begin{verbatim}
to {\tt wxString} like this:
\begin{verbatim}
@@
-130,11
+130,13
@@
you used in the class declaration.
\twocolitem{wxHashMap::mapped\_type}{Type of the values stored in the hash map}
\twocolitem{wxHashMap::value\_type}{Equivalent to
{\tt struct \{ key\_type first; mapped\_type second \};} }
\twocolitem{wxHashMap::mapped\_type}{Type of the values stored in the hash map}
\twocolitem{wxHashMap::value\_type}{Equivalent to
{\tt struct \{ key\_type first; mapped\_type second \};} }
-\twocolitem{wxHashMap::iterator}{Used to enumerate all the elements in a
n
hash
+\twocolitem{wxHashMap::iterator}{Used to enumerate all the elements in a hash
map; it is similar to a {\tt value\_type*}}
\twocolitem{wxHashMap::const\_iterator}{Used to enumerate all the elements
in a constant hash map; it is similar to a {\tt const value\_type*}}
\twocolitem{wxHashMap::size\_type}{Used for sizes}
map; it is similar to a {\tt value\_type*}}
\twocolitem{wxHashMap::const\_iterator}{Used to enumerate all the elements
in a constant hash map; it is similar to a {\tt const value\_type*}}
\twocolitem{wxHashMap::size\_type}{Used for sizes}
+\twocolitem{wxHashMap::Insert\_Result}{The return value for
+\helpref{insert()}{wxhashmapinsert}}
\end{twocollist}
\wxheading{Iterators}
\end{twocollist}
\wxheading{Iterators}
@@
-152,7
+154,7
@@
means that you can't use {\tt --it}, {\tt it + 3}, {\tt it1 - it2}.
\latexignore{\rtfignore{\wxheading{Members}}}
\latexignore{\rtfignore{\wxheading{Members}}}
-\membersection{wxHashMap::wxHashMap}
+\membersection{wxHashMap::wxHashMap}
\label{wxhashmapctor}
\func{}{wxHashMap}{\param{size\_type}{ size = 10}}
\func{}{wxHashMap}{\param{size\_type}{ size = 10}}
@@
-163,7
+165,7
@@
to preserve performance.
Copy constructor.
Copy constructor.
-\membersection{wxHashMap::begin}
+\membersection{wxHashMap::begin}
\label{wxhashmapbegin}
\constfunc{const\_iterator}{begin}{}
\constfunc{const\_iterator}{begin}{}
@@
-172,26
+174,26
@@
Copy constructor.
Returns an iterator pointing at the first element of the hash map.
Please remember that hash maps do not guarantee ordering.
Returns an iterator pointing at the first element of the hash map.
Please remember that hash maps do not guarantee ordering.
-\membersection{wxHashMap::clear}
+\membersection{wxHashMap::clear}
\label{wxhashmapclear}
\func{void}{clear}{}
Removes all elements from the hash map.
\func{void}{clear}{}
Removes all elements from the hash map.
-\membersection{wxHashMap::count}
+\membersection{wxHashMap::count}
\label{wxhashmapcount}
\constfunc{size\_type}{count}{\param{const key\_type\&}{ key}}
Counts the number of elements with the given key present in the map.
\constfunc{size\_type}{count}{\param{const key\_type\&}{ key}}
Counts the number of elements with the given key present in the map.
-This function
can actually return
0 or 1.
+This function
returns only
0 or 1.
-\membersection{wxHashMap::empty}
+\membersection{wxHashMap::empty}
\label{wxhashmapempty}
\constfunc{bool}{empty}{}
\constfunc{bool}{empty}{}
-Returns true if the hash map does not contain any element, false otherwise.
+Returns true if the hash map does not contain any element
s
, false otherwise.
-\membersection{wxHashMap::end}
+\membersection{wxHashMap::end}
\label{wxhashmapend}
\constfunc{const\_iterator}{end}{}
\constfunc{const\_iterator}{end}{}
@@
-200,7
+202,7
@@
Returns true if the hash map does not contain any element, false otherwise.
Returns an iterator pointing at the one-after-the-last element of the hash map.
Please remember that hash maps do not guarantee ordering.
Returns an iterator pointing at the one-after-the-last element of the hash map.
Please remember that hash maps do not guarantee ordering.
-\membersection{wxHashMap::erase}
+\membersection{wxHashMap::erase}
\label{wxhashmaperase}
\func{size\_type}{erase}{\param{const key\_type\&}{ key}}
\func{size\_type}{erase}{\param{const key\_type\&}{ key}}
@@
-214,7
+216,7
@@
erased (either 0 or 1).
Erases the element pointed to by the iterator. After the deletion
the iterator is no longer valid and must not be used.
Erases the element pointed to by the iterator. After the deletion
the iterator is no longer valid and must not be used.
-\membersection{wxHashMap::find}
+\membersection{wxHashMap::find}
\label{wxhashmapfind}
\func{iterator}{find}{\param{const key\_type\&}{ key}}
\func{iterator}{find}{\param{const key\_type\&}{ key}}
@@
-224,21
+226,24
@@
If an element with the given key is present, the functions returns
an iterator pointing at that element, otherwise an invalid iterator
is returned (i.e. hashmap.find( non\_existent\_key ) == hashmap.end()).
an iterator pointing at that element, otherwise an invalid iterator
is returned (i.e. hashmap.find( non\_existent\_key ) == hashmap.end()).
-\membersection{wxHashMap::insert}
+\membersection{wxHashMap::insert}
\label{wxhashmapinsert}
-\func{
void
}{insert}{\param{const value\_type\&}{ v}}
+\func{
Insert\_Result
}{insert}{\param{const value\_type\&}{ v}}
-Inserts the given value in the hash map.
+Inserts the given value in the hash map. The return value is
+equivalent to a \texttt{std::pair<wxHashMap::iterator, bool>};
+the iterator points to the inserted element, the boolean value
+is \texttt{true} if \texttt{v} was actually inserted.
-\membersection{wxHashMap::operator[]}
+\membersection{wxHashMap::operator[]}
\label{wxhashmapbracket}
\func{mapped\_type\&}{operator[]}{\param{const key\_type\&}{ key}}
\func{mapped\_type\&}{operator[]}{\param{const key\_type\&}{ key}}
-Use
it
as an array subscript. The only difference is that if the
+Use
the key
as an array subscript. The only difference is that if the
given key is not present in the hash map, an element with the
default {\tt value\_type()} is inserted in the table.
given key is not present in the hash map, an element with the
default {\tt value\_type()} is inserted in the table.
-\membersection{wxHashMap::size}
+\membersection{wxHashMap::size}
\label{wxhashmapsize}
\constfunc{size\_type}{size}{}
\constfunc{size\_type}{size}{}