source: trunk/src/testlib/qtestcase.h@ 1023

Last change on this file since 1023 was 846, checked in by Dmitry A. Kuminov, 14 years ago

trunk: Merged in qt 4.7.2 sources from branches/vendor/nokia/qt.
File size: 13.7 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4** All rights reserved.
5** Contact: Nokia Corporation ([email protected])
6**
7** This file is part of the QtTest module of the Qt Toolkit.
8**
9** $QT_BEGIN_LICENSE:LGPL$
10** Commercial Usage
11** Licensees holding valid Qt Commercial licenses may use this file in
12** accordance with the Qt Commercial License Agreement provided with the
13** Software or, alternatively, in accordance with the terms contained in
14** a written agreement between you and Nokia.
15**
16** GNU Lesser General Public License Usage
17** Alternatively, this file may be used under the terms of the GNU Lesser
18** General Public License version 2.1 as published by the Free Software
19** Foundation and appearing in the file LICENSE.LGPL included in the
20** packaging of this file. Please review the following information to
21** ensure the GNU Lesser General Public License version 2.1 requirements
22** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
23**
24** In addition, as a special exception, Nokia gives you certain additional
25** rights. These rights are described in the Nokia Qt LGPL Exception
26** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you have questions regarding the use of this file, please contact
37** Nokia at [email protected].
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42#ifndef QTESTCASE_H
43#define QTESTCASE_H
44
45#include <QtTest/qtest_global.h>
46
47#include <QtCore/qnamespace.h>
48#include <QtCore/qmetatype.h>
49
50QT_BEGIN_HEADER
51
52QT_BEGIN_NAMESPACE
53
54QT_MODULE(Test)
55
56#define QVERIFY(statement) \
57do {\
58 if (!QTest::qVerify((statement), #statement, "", __FILE__, __LINE__))\
59 return;\
60} while (0)
61
62#define QFAIL(message) \
63do {\
64 QTest::qFail(message, __FILE__, __LINE__);\
65 return;\
66} while (0)
67
68#define QVERIFY2(statement, description) \
69do {\
70 if (statement) {\
71 if (!QTest::qVerify(true, #statement, (description), __FILE__, __LINE__))\
72 return;\
73 } else {\
74 if (!QTest::qVerify(false, #statement, (description), __FILE__, __LINE__))\
75 return;\
76 }\
77} while (0)
78
79#define QCOMPARE(actual, expected) \
80do {\
81 if (!QTest::qCompare(actual, expected, #actual, #expected, __FILE__, __LINE__))\
82 return;\
83} while (0)
84
85#define QSKIP(statement, mode) \
86do {\
87 QTest::qSkip(statement, QTest::mode, __FILE__, __LINE__);\
88 return;\
89} while (0)
90
91#define QEXPECT_FAIL(dataIndex, comment, mode)\
92do {\
93 if (!QTest::qExpectFail(dataIndex, comment, QTest::mode, __FILE__, __LINE__))\
94 return;\
95} while (0)
96
97#define QFETCH(type, name)\
98 type name = *static_cast<type *>(QTest::qData(#name, ::qMetaTypeId<type >()))
99
100#define QFETCH_GLOBAL(type, name)\
101 type name = *static_cast<type *>(QTest::qGlobalData(#name, ::qMetaTypeId<type >()))
102
103#define DEPENDS_ON(funcName)
104
105#define QTEST(actual, testElement)\
106do {\
107 if (!QTest::qTest(actual, testElement, #actual, #testElement, __FILE__, __LINE__))\
108 return;\
109} while (0)
110
111#define QWARN(msg)\
112 QTest::qWarn(msg)
113
114class QObject;
115class QTestData;
116
117#define QTEST_COMPARE_DECL(KLASS)\
118 template<> Q_TESTLIB_EXPORT char *toString<KLASS >(const KLASS &);
119
120namespace QTest
121{
122 template <typename T>
123 inline char *toString(const T &)
124 {
125 return 0;
126 }
127
128
129 Q_TESTLIB_EXPORT char *toHexRepresentation(const char *ba, int length);
130 Q_TESTLIB_EXPORT char *toString(const char *);
131 Q_TESTLIB_EXPORT char *toString(const void *);
132
133 Q_TESTLIB_EXPORT int qExec(QObject *testObject, int argc = 0, char **argv = 0);
134 Q_TESTLIB_EXPORT int qExec(QObject *testObject, const QStringList &arguments);
135
136 Q_TESTLIB_EXPORT bool qVerify(bool statement, const char *statementStr, const char *description,
137 const char *file, int line);
138 Q_TESTLIB_EXPORT void qFail(const char *statementStr, const char *file, int line);
139 Q_TESTLIB_EXPORT void qSkip(const char *message, SkipMode mode, const char *file, int line);
140 Q_TESTLIB_EXPORT bool qExpectFail(const char *dataIndex, const char *comment, TestFailMode mode,
141 const char *file, int line);
142 Q_TESTLIB_EXPORT void qWarn(const char *message);
143 Q_TESTLIB_EXPORT void ignoreMessage(QtMsgType type, const char *message);
144
145 Q_TESTLIB_EXPORT void *qData(const char *tagName, int typeId);
146 Q_TESTLIB_EXPORT void *qGlobalData(const char *tagName, int typeId);
147 Q_TESTLIB_EXPORT void *qElementData(const char *elementName, int metaTypeId);
148 Q_TESTLIB_EXPORT QObject *testObject();
149
150 Q_TESTLIB_EXPORT const char *currentTestFunction();
151 Q_TESTLIB_EXPORT const char *currentDataTag();
152 Q_TESTLIB_EXPORT bool currentTestFailed();
153
154 Q_TESTLIB_EXPORT Qt::Key asciiToKey(char ascii);
155 Q_TESTLIB_EXPORT char keyToAscii(Qt::Key key);
156
157 Q_TESTLIB_EXPORT bool compare_helper(bool success, const char *msg, const char *file,
158 int line);
159 Q_TESTLIB_EXPORT bool compare_helper(bool success, const char *msg, char *val1, char *val2,
160 const char *expected, const char *actual,
161 const char *file, int line);
162 Q_TESTLIB_EXPORT void qSleep(int ms);
163 Q_TESTLIB_EXPORT void addColumnInternal(int id, const char *name);
164
165 template <typename T>
166 inline void addColumn(const char *name, T * = 0)
167 {
168 addColumnInternal(qMetaTypeId<T>(), name);
169 }
170 Q_TESTLIB_EXPORT QTestData &newRow(const char *dataTag);
171
172 template <typename T>
173 inline bool qCompare(T const &t1, T const &t2, const char *actual, const char *expected,
174 const char *file, int line)
175 {
176 return (t1 == t2)
177 ? compare_helper(true, "COMPARE()", file, line)
178 : compare_helper(false, "Compared values are not the same",
179 toString<T>(t1), toString<T>(t2), actual, expected, file, line);
180 }
181
182
183 template <>
184 Q_TESTLIB_EXPORT bool qCompare<float>(float const &t1, float const &t2,
185 const char *actual, const char *expected, const char *file, int line);
186
187 template <>
188 Q_TESTLIB_EXPORT bool qCompare<double>(double const &t1, double const &t2,
189 const char *actual, const char *expected, const char *file, int line);
190
191 inline bool compare_ptr_helper(const void *t1, const void *t2, const char *actual,
192 const char *expected, const char *file, int line)
193 {
194 return (t1 == t2)
195 ? compare_helper(true, "COMPARE()", file, line)
196 : compare_helper(false, "Compared pointers are not the same",
197 toString(t1), toString(t2), actual, expected, file, line);
198 }
199
200 Q_TESTLIB_EXPORT bool compare_string_helper(const char *t1, const char *t2, const char *actual,
201 const char *expected, const char *file, int line);
202
203#ifndef qdoc
204 QTEST_COMPARE_DECL(short)
205 QTEST_COMPARE_DECL(ushort)
206 QTEST_COMPARE_DECL(int)
207 QTEST_COMPARE_DECL(uint)
208 QTEST_COMPARE_DECL(long)
209 QTEST_COMPARE_DECL(ulong)
210 QTEST_COMPARE_DECL(qint64)
211 QTEST_COMPARE_DECL(quint64)
212
213 QTEST_COMPARE_DECL(float)
214 QTEST_COMPARE_DECL(double)
215 QTEST_COMPARE_DECL(char)
216 QTEST_COMPARE_DECL(bool)
217#endif
218
219#ifndef QTEST_NO_SPECIALIZATIONS
220 template <typename T1, typename T2>
221 bool qCompare(T1 const &, T2 const &, const char *, const char *, const char *, int);
222
223#if defined(QT_COORD_TYPE) && (defined(QT_ARCH_ARM) || defined(QT_NO_FPU) || defined(QT_ARCH_WINDOWSCE))
224 template <>
225 inline bool qCompare<qreal, float>(qreal const &t1, float const &t2, const char *actual,
226 const char *expected, const char *file, int line)
227 {
228 return qCompare<qreal>(t1, qreal(t2), actual, expected, file, line);
229 }
230
231 template <>
232 inline bool qCompare<float, qreal>(float const &t1, qreal const &t2, const char *actual,
233 const char *expected, const char *file, int line)
234 {
235 return qCompare<qreal>(qreal(t1), t2, actual, expected, file, line);
236 }
237
238#elif defined(QT_COORD_TYPE) || defined(QT_ARCH_ARM) || defined(QT_NO_FPU) || defined(QT_ARCH_WINDOWSCE) || defined(QT_ARCH_SYMBIAN)
239 template <>
240 inline bool qCompare<qreal, double>(qreal const &t1, double const &t2, const char *actual,
241 const char *expected, const char *file, int line)
242 {
243 return qCompare<float>(float(t1), float(t2), actual, expected, file, line);
244 }
245
246 template <>
247 inline bool qCompare<double, qreal>(double const &t1, qreal const &t2, const char *actual,
248 const char *expected, const char *file, int line)
249 {
250 return qCompare<float>(float(t1), float(t2), actual, expected, file, line);
251 }
252
253#endif
254
255 template <typename T>
256 inline bool qCompare(const T *t1, const T *t2, const char *actual, const char *expected,
257 const char *file, int line)
258 {
259 return compare_ptr_helper(t1, t2, actual, expected, file, line);
260 }
261 template <typename T>
262 inline bool qCompare(T *t1, T *t2, const char *actual, const char *expected,
263 const char *file, int line)
264 {
265 return compare_ptr_helper(t1, t2, actual, expected, file, line);