summaryrefslogtreecommitdiffstats
path: root/src/corelib/tools/qvector.cpp
diff options
context:
space:
mode:
authorCasper van Donderen <casper.vandonderen@nokia.com>2012-03-20 19:37:07 +0100
committerQt by Nokia <qt-info@nokia.com>2012-04-19 07:34:53 +0200
commit0bc02fd0d61d1e4aed9b39890d28975dff30e822 (patch)
treee967ab719c7f8df24c35b088bd48e0f5b0942148 /src/corelib/tools/qvector.cpp
parent7f0c130be963de90d1baeb037820b17a4f298700 (diff)
Doc: Prepare for building modular QtCore docs.
This change fixes most qdoc errors in QtCore. There are about 900 left. The main thing this change does is moving documentation from qtcore from /doc/src to /src/corelib/doc. Other issues resolved are mis-use of qdoc commands. Change-Id: I002d01edfb13575e8bf27ce91596a577a92562d1 Reviewed-by: Lars Knoll <lars.knoll@nokia.com> Reviewed-by: Jason McDonald <jason.mcdonald@nokia.com> Reviewed-by: Jerome Pasion <jerome.pasion@nokia.com>
Diffstat (limited to 'src/corelib/tools/qvector.cpp')
-rw-r--r--src/corelib/tools/qvector.cpp36
1 files changed, 18 insertions, 18 deletions
diff --git a/src/corelib/tools/qvector.cpp b/src/corelib/tools/qvector.cpp
index 0026338047..20501f98ff 100644
--- a/src/corelib/tools/qvector.cpp
+++ b/src/corelib/tools/qvector.cpp
@@ -119,20 +119,20 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
Here's an example of a QVector that stores integers and a QVector
that stores QString values:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 0
+ \snippet code/src_corelib_tools_qvector.cpp 0
QVector stores a vector (or array) of items. Typically, vectors
are created with an initial size. For example, the following code
constructs a QVector with 200 elements:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 1
+ \snippet code/src_corelib_tools_qvector.cpp 1
The elements are automatically initialized with a
\l{default-constructed value}. If you want to initialize the
vector with a different value, pass that value as the second
argument to the constructor:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 2
+ \snippet code/src_corelib_tools_qvector.cpp 2
You can also call fill() at any time to fill the vector with a
value.
@@ -142,11 +142,11 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
non-const vectors, operator[]() returns a reference to the item
that can be used on the left side of an assignment:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 3
+ \snippet code/src_corelib_tools_qvector.cpp 3
For read-only access, an alternative syntax is to use at():
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 4
+ \snippet code/src_corelib_tools_qvector.cpp 4
at() can be faster than operator[](), because it never causes a
\l{deep copy} to occur.
@@ -164,7 +164,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
backward. Both return the index of the matching item if they found
one; otherwise, they return -1. For example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 5
+ \snippet code/src_corelib_tools_qvector.cpp 5
If you simply want to check whether a vector contains a
particular value, use contains(). If you want to find out how
@@ -411,7 +411,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
can be used to access and modify the items in the vector.
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 6
+ \snippet code/src_corelib_tools_qvector.cpp 6
The pointer remains valid as long as the vector isn't
reallocated.
@@ -482,7 +482,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
Inserts \a value at the end of the vector.
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 7
+ \snippet code/src_corelib_tools_qvector.cpp 7
This is the same as calling resize(size() + 1) and assigning \a
value to the new last element in the vector.
@@ -499,7 +499,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
Inserts \a value at the beginning of the vector.
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 8
+ \snippet code/src_corelib_tools_qvector.cpp 8
This is the same as vector.insert(0, \a value).
@@ -519,7 +519,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
value is appended to the vector.
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 9
+ \snippet code/src_corelib_tools_qvector.cpp 9
For large vectors, this operation can be slow (\l{linear time}),
because it requires moving all the items at indexes \a i and
@@ -538,7 +538,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
vector.
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 10
+ \snippet code/src_corelib_tools_qvector.cpp 10
*/
/*! \fn QVector::iterator QVector::insert(iterator before, const T &value)
@@ -592,7 +592,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
size beforehand.
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 11
+ \snippet code/src_corelib_tools_qvector.cpp 11
\sa resize()
*/
@@ -604,7 +604,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
Returns -1 if no item matched.
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 12
+ \snippet code/src_corelib_tools_qvector.cpp 12
This function requires the value type to have an implementation of
\c operator==().
@@ -620,7 +620,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
last item. Returns -1 if no item matched.
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 13
+ \snippet code/src_corelib_tools_qvector.cpp 13
This function requires the value type to have an implementation of
\c operator==().
@@ -966,7 +966,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 14
+ \snippet code/src_corelib_tools_qvector.cpp 14
\sa fromList(), QList::fromVector()
*/
@@ -977,7 +977,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 15
+ \snippet code/src_corelib_tools_qvector.cpp 15
\sa toList(), QList::toVector()
*/
@@ -989,7 +989,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 16
+ \snippet code/src_corelib_tools_qvector.cpp 16
\sa toStdVector(), QList::fromStdList()
*/
@@ -999,7 +999,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
Returns a std::vector object with the data contained in this QVector.
Example:
- \snippet doc/src/snippets/code/src_corelib_tools_qvector.cpp 17
+ \snippet code/src_corelib_tools_qvector.cpp 17
\sa fromStdVector(), QList::toStdList()
*/