1 /****************************************************************************
3 ** Copyright (C) Qxt Foundation. Some rights reserved.
5 ** This file is part of the QxtCore module of the Qt eXTension library
7 ** This library is free software; you can redistribute it and/or modify it
8 ** under the terms of th Common Public License, version 1.0, as published by
11 ** This file is provided "AS IS", without WARRANTIES OR CONDITIONS OF ANY
12 ** KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY
13 ** WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR
14 ** FITNESS FOR A PARTICULAR PURPOSE.
16 ** You should have received a copy of the CPL along with this file.
17 ** See the LICENSE file and the cpl1.0.txt file included with the source
18 ** distribution for more information. If you did not receive a copy of the
19 ** license, contact the Qxt Foundation.
21 ** <http://libqxt.sourceforge.net> <foundation@libqxt.org>
23 ****************************************************************************/
25 \class QxtMetaObject QxtMetaObject
29 \brief provides extensions to QMetaObject
31 including QxtMetaObject::bind \n
34 #include "qxtmetaobject.h"
35 #include "qxtboundfunction.h"
36 #include "qxtboundcfunction.h"
39 #include <QMetaObject>
40 #include <QMetaMethod>
43 class QxtBoundArgument
45 // This class intentionally left blank
47 Q_DECLARE_METATYPE(QxtBoundArgument)
49 class QxtBoundFunctionBase;
51 QxtBoundFunction::QxtBoundFunction(QObject* parent) : QObject(parent)
56 #define QXT_ARG(i) ((argCount>i)?QGenericArgument(p ## i .typeName(), p ## i .constData()):QGenericArgument())
57 #define QXT_VAR_ARG(i) (p ## i .isValid())?QGenericArgument(p ## i .typeName(), p ## i .constData()):QGenericArgument()
58 bool QxtBoundFunction::invoke(Qt::ConnectionType type, QXT_IMPL_10ARGS(QVariant))
60 return invoke(type, QXT_VAR_ARG(1), QXT_VAR_ARG(2), QXT_VAR_ARG(3), QXT_VAR_ARG(4), QXT_VAR_ARG(5), QXT_VAR_ARG(6), QXT_VAR_ARG(7), QXT_VAR_ARG(8), QXT_VAR_ARG(9), QXT_VAR_ARG(10));
63 bool QxtBoundFunction::invoke(Qt::ConnectionType type, QGenericReturnArgument returnValue, QXT_IMPL_10ARGS(QVariant))
65 return invoke(type, returnValue, QXT_VAR_ARG(1), QXT_VAR_ARG(2), QXT_VAR_ARG(3), QXT_VAR_ARG(4), QXT_VAR_ARG(5), QXT_VAR_ARG(6), QXT_VAR_ARG(7), QXT_VAR_ARG(8), QXT_VAR_ARG(9), QXT_VAR_ARG(10));
68 QxtBoundFunctionBase::QxtBoundFunctionBase(QObject* parent, QGenericArgument* params[10], QByteArray types[10]) : QxtBoundFunction(parent)
70 for (int i=0; i<10; i++)
72 if (!params[i]) break;
73 if (QByteArray(params[i]->name()) == "QxtBoundArgument")
75 arg[i] = QGenericArgument("QxtBoundArgument", params[i]->data());
79 data[i] = QMetaType::construct(QMetaType::type(params[i]->name()), params[i]->data());
80 arg[i] = p[i] = QGenericArgument(params[i]->name(), data[i]);
82 bindTypes[i] = types[i];
86 QxtBoundFunctionBase::~QxtBoundFunctionBase()
88 for (int i=0; i<10; i++)
90 if (arg[i].name() == 0) return;
91 if (QByteArray(arg[i].name()) != "QxtBoundArgument") QMetaType::destroy(QMetaType::type(arg[i].name()), arg[i].data());
95 int QxtBoundFunctionBase::qt_metacall(QMetaObject::Call _c, int _id, void **_a)
97 _id = QObject::qt_metacall(_c, _id, _a);
100 if (_c == QMetaObject::InvokeMetaMethod)
104 for (int i = 0; i < 10; i++)
106 if (QByteArray(arg[i].name()) == "QxtBoundArgument")
108 p[i] = QGenericArgument(bindTypes[i].constData(), _a[(quintptr)(arg[i].data())]);
111 invokeImpl(Qt::DirectConnection, QGenericReturnArgument(), p[0], p[1], p[2], p[3], p[4], p[5], p[6], p[7], p[8], p[9]);
118 bool QxtBoundFunctionBase::invokeBase(Qt::ConnectionType type, QGenericReturnArgument returnValue, QXT_IMPL_10ARGS(QGenericArgument))
120 QGenericArgument* args[10] = { &p1, &p2, &p3, &p4, &p5, &p6, &p7, &p8, &p9, &p10 };
121 for (int i = 0; i < 10; i++)
123 if (QByteArray(arg[i].name()) == "QxtBoundArgument")
125 p[i] = *args[(quintptr)(arg[i].data())-1];
128 return invokeImpl(type, returnValue, p[0], p[1], p[2], p[3], p[4], p[5], p[6], p[7], p[8], p[9]);
131 bool QxtBoundFunction::invoke(Qt::ConnectionType type, QGenericReturnArgument returnValue, QXT_IMPL_10ARGS(QGenericArgument))
133 return reinterpret_cast<QxtBoundFunctionBase*>(this)->invokeBase(type, returnValue, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10);
136 class QxtBoundSlot : public QxtBoundFunctionBase
141 QxtBoundSlot(QObject* receiver, const char* invokable, QGenericArgument* params[10], QByteArray types[10]) : QxtBoundFunctionBase(receiver, params, types), sig(invokable)
146 virtual bool invokeImpl(Qt::ConnectionType type, QGenericReturnArgument returnValue, QXT_IMPL_10ARGS(QGenericArgument))
148 if (!QMetaObject::invokeMethod(parent(), QxtMetaObject::methodName(sig.constData()), type, returnValue, p1, p2, p3, p4, p5, p6, p7, p8, p9, p10))
150 qWarning() << "QxtBoundFunction: call to" << sig << "failed";
157 namespace QxtMetaObject
161 \relates QxtMetaObject
163 \fn methodName(const char* method)
165 Returns the name of the given method.
169 QByteArray method = QxtMetaObject::methodName(" int foo ( int bar, double baz )");
170 // method is now "foo"
173 QByteArray methodName(const char* method)
175 QByteArray name = methodSignature(method);
176 const int idx = name.indexOf("(");
183 \relates QxtMetaObject
185 \fn methodSignature(const char* method)
187 Returns the signature of the given method.
189 QByteArray methodSignature(const char* method)
191 QByteArray name = QMetaObject::normalizedSignature(method);
192 if (name.startsWith("1") || name.startsWith("2"))
198 \relates QxtMetaObject
200 \fn bool isSignalOrSlot(const char* method)
202 checks if \p method contains parantesis and begins with 1 or 2 */
203 bool isSignalOrSlot (const char* method)
205 QByteArray m(method);
206 return (m.count() && (m[0] == '1'||m[0] == '2') && m.contains('(') && m.contains(')'));
210 \relates QxtMetaObject
211 \fn bind(QObject* recv, const char* invokable, QXT_IMPL_10ARGS(QVariant))
213 creates a QxtBoundFunction from a slot + arguments \n
214 can be used for QxtMetaObject::connect \
217 QxtMetaObject::connect(\n
218 this, SIGNAL(init()), \\n
219 QxtMetaObject::bind(this, SLOT(say(QString)), Q_ARG(QString,"hello")));
223 QxtMetaObject::connect( \n
224 this, SIGNAL(init(int i)), \n
225 QxtMetaObject::bind(this, SLOT(say(QString),int), Q_ARG(QString,"hello"),Q_BIND(1)));
229 QxtBoundFunction* bind(QObject* recv, const char* invokable, QXT_IMPL_10ARGS(QVariant))
233 qWarning() << "QxtMetaObject::bind: cannot connect to null QObject";
237 QVariant* args[10] = { &p1, &p2, &p3, &p4, &p5, &p6, &p7, &p8, &p9, &p10 };
238 QByteArray connSlot("2"), recvSlot(QMetaObject::normalizedSignature(invokable));
239 const QMetaObject* meta = recv->metaObject();
240 int methodID = meta->indexOfMethod(QxtMetaObject::methodSignature(recvSlot.constData()));
243 qWarning() << "QxtMetaObject::bind: no such method " << recvSlot;
246 QMetaMethod method = meta->method(methodID);
247 int argCount = method.parameterTypes().count();
248 const QList<QByteArray> paramTypes = method.parameterTypes();
250 for (int i=0; i<argCount; i++)
252 if (paramTypes[i] == "QxtBoundArgument") continue;
253 int type = QMetaType::type(paramTypes[i].constData());
254 if (!args[i]->canConvert((QVariant::Type)type))
256 qWarning() << "QxtMetaObject::bind: incompatible parameter list for " << recvSlot;
261 return QxtMetaObject::bind(recv, invokable, QXT_ARG(1), QXT_ARG(2), QXT_ARG(3), QXT_ARG(4), QXT_ARG(5), QXT_ARG(6), QXT_ARG(7), QXT_ARG(8), QXT_ARG(9), QXT_ARG(10));
264 QxtBoundFunction* bind(QObject* recv, const char* invokable, QXT_IMPL_10ARGS(QGenericArgument))
268 qWarning() << "QxtMetaObject::bind: cannot connect to null QObject";
272 QGenericArgument* args[10] = { &p1, &p2, &p3, &p4, &p5, &p6, &p7, &p8, &p9, &p10 };
273 QByteArray connSlot("2"), recvSlot(QMetaObject::normalizedSignature(invokable)), bindTypes[10];
274 const QMetaObject* meta = recv->metaObject();
275 int methodID = meta->indexOfMethod(QxtMetaObject::methodSignature(recvSlot.constData()).constData());
278 qWarning() << "QxtMetaObject::bind: no such method " << recvSlot;
281 QMetaMethod method = meta->method(methodID);
282 int argCount = method.parameterTypes().count();
284 connSlot += QxtMetaObject::methodName(invokable) + "(";
285 for (int i=0; i<10; i++)
287 if (args[i]->name() == 0) break; // done
290 qWarning() << "QxtMetaObject::bind: too many arguments passed to " << invokable;
293 if (i > 0) connSlot += ","; // argument separator
294 if (QByteArray(args[i]->name()) == "QxtBoundArgument")
296 Q_ASSERT_X((quintptr)(args[i]->data()) > 0 && (quintptr)(args[i]->data()) <= 10, "QXT_BIND", "invalid argument number");
297 connSlot += method.parameterTypes()[i];
298 bindTypes[i] = method.parameterTypes()[i];
302 connSlot += args[i]->name(); // type name
305 connSlot = QMetaObject::normalizedSignature(connSlot += ")");
307 if (!QMetaObject::checkConnectArgs(recvSlot.constData(), connSlot.constData()))
309 qWarning() << "QxtMetaObject::bind: provided parameters " << connSlot.mid(connSlot.indexOf('(')) << " is incompatible with " << invokable;
313 return new QxtBoundSlot(recv, invokable, args, bindTypes);
317 \relates QxtMetaObject
318 \fn connect(QObject* sender, const char* signal, QxtBoundFunction* slot, Qt::ConnectionType type) {
320 connects a signal to a QxtBoundFunction \n
322 bool connect(QObject* sender, const char* signal, QxtBoundFunction* slot, Qt::ConnectionType type)
324 const QMetaObject* meta = sender->metaObject();
325 int methodID = meta->indexOfMethod(meta->normalizedSignature(signal).mid(1).constData());
328 qWarning() << "QxtMetaObject::connect: no such signal: " << QByteArray(signal).mid(1);
332 return QMetaObject::connect(sender, methodID, slot, QObject::staticMetaObject.methodCount(), (int)(type));