QDBusUtil Namespace Reference

---

Detailed Description

QtDBus

Functions
bool	isValidPartOfObjectPath (const QString &part)
bool	isValidInterfaceName (const QString &ifaceName)
bool	isValidUniqueConnectionName (const QString &connName)
bool	isValidBusName (const QString &busName)
bool	isValidMemberName (const QString &memberName)
bool	isValidErrorName (const QString &errorName)
bool	isValidObjectPath (const QString &path)
bool	isValidSignature (const QString &signature)
bool	isValidSingleSignature (const QString &signature)

---

Function Documentation

QDBUS_EXPORT bool QDBusUtil::isValidBusName

(

const QString &

busName

)

Returns true if busName is a valid bus name.

A valid bus name is either a valid unique connection name or follows the rules: is not empty does not exceed 255 characters in length be composed of dot-separated string components that contain only ASCII letters, digits, hyphens or underscores ("_"), but don't start with a digit contains at least two such elements

See also:

isValidUniqueConnectionName()

Definition at line 134 of file qdbusutil.cpp.

References QList< T >::at(), QList< T >::count(), QRegExp::exactMatch(), i, QString::isEmpty(), isValidUniqueConnectionName(), QString::length(), and QString::startsWith().

Referenced by QDBusConnectionPrivate::getNameOwner(), main(), and QDBusAbstractInterfacePrivate::QDBusAbstractInterfacePrivate().

    {
        if (busName.isEmpty() || busName.length() > DBUS_MAXIMUM_NAME_LENGTH)
            return false;

        if (busName.startsWith(QLatin1Char(':')))
            return isValidUniqueConnectionName(busName);

        QStringList parts = busName.split(QLatin1Char('.'));
        if (parts.count() < 1)
            return false;

        QRegExp regex(QLatin1String("[a-zA-Z_-][a-zA-Z0-9_-]*"));
        for (int i = 0; i < parts.count(); ++i)
            if (!regex.exactMatch(parts.at(i)))
                return false;

        return true;
    }

Here is the call graph for this function:

QDBUS_EXPORT bool QDBusUtil::isValidErrorName

(

const QString &

errorName

)

Returns true if errorName is a valid error name. Valid error names are valid interface names and vice-versa, so this function is actually an alias for isValidInterfaceName.

Definition at line 174 of file qdbusutil.cpp.

References isValidInterfaceName().

    {
        return isValidInterfaceName(errorName);
    }

Here is the call graph for this function:

QDBUS_EXPORT bool QDBusUtil::isValidInterfaceName

(

const QString &

ifaceName

)

Returns true if this is ifaceName is a valid interface name.

Valid interface names must: not be empty not exceed 255 characters in length be composed of dot-separated string components that contain only ASCII letters, digits and the underscore ("_") character contain at least two such components

Definition at line 78 of file qdbusutil.cpp.

References QList< T >::at(), QList< T >::count(), i, QString::isEmpty(), isValidMemberName(), QString::length(), and QString::split().

Referenced by QDBusConnection::connect(), QDBusConnection::disconnect(), QDBusXmlParser::interfaces(), isValidErrorName(), listAllInterfaces(), main(), QDBusXmlParser::object(), parseAnnotations(), QDBusAbstractInterfacePrivate::QDBusAbstractInterfacePrivate(), and splitInterfaceAndName().

    {
        if (ifaceName.isEmpty() || ifaceName.length() > DBUS_MAXIMUM_NAME_LENGTH)
            return false;

        QStringList parts = ifaceName.split(QLatin1Char('.'));
        if (parts.count() < 2)
            return false;           // at least two parts

        for (int i = 0; i < parts.count(); ++i)
            if (!isValidMemberName(parts.at(i)))
                return false;

        return true;
    }

Here is the call graph for this function:

QDBUS_EXPORT bool QDBusUtil::isValidMemberName

(

const QString &

memberName

)

Returns true if memberName is a valid member name. A valid member name does not exceed 255 characters in length, is not empty, is composed only of ASCII letters, digits and underscores, but does not start with a digit.

Definition at line 160 of file qdbusutil.cpp.

References QRegExp::exactMatch(), QByteArray::isEmpty(), QByteArray::length(), and QTest::memberName().

Referenced by QDBusXmlParser::interfaces(), isValidInterfaceName(), main(), and splitInterfaceAndName().

    {
        if (memberName.isEmpty() || memberName.length() > DBUS_MAXIMUM_NAME_LENGTH)
            return false;

        QRegExp regex(QLatin1String("[a-zA-Z_][a-zA-Z0-9_]*"));
        return regex.exactMatch(memberName);
    }

Here is the call graph for this function:

QDBUS_EXPORT bool QDBusUtil::isValidObjectPath

(

const QString &

path

)

Returns true if path is valid object path.

Valid object paths follow the rules: start with the slash character ("/") do not end in a slash, unless the path is just the initial slash do not contain any two slashes in sequence contain slash-separated parts, each of which is composed of ASCII letters, digits and underscores ("_")

Definition at line 192 of file qdbusutil.cpp.

References QList< T >::at(), QList< T >::count(), i, isValidPartOfObjectPath(), path, and QList< T >::removeFirst().

Referenced by QDBusObjectPath::check(), main(), QDBusXmlParser::object(), QDBusConnection::objectRegisteredAt(), QDBusAbstractInterfacePrivate::QDBusAbstractInterfacePrivate(), QDBusConnection::registerObject(), and QDBusConnection::unregisterObject().

    {
        if (path == QLatin1String("/"))
            return true;

        if (!path.startsWith(QLatin1Char('/')) || path.indexOf(QLatin1String("//")) != -1 ||
            path.endsWith(QLatin1Char('/')))
            return false;

        QStringList parts = path.split(QLatin1Char('/'));
        Q_ASSERT(parts.count() >= 1);
        parts.removeFirst();    // it starts with /, so we get an empty first part

        for (int i = 0; i < parts.count(); ++i)
            if (!isValidPartOfObjectPath(parts.at(i)))
                return false;

        return true;
    }

Here is the call graph for this function:

bool QDBusUtil::isValidPartOfObjectPath

(

const QString &

part

)

Definition at line 48 of file qdbusutil.cpp.

References c, i, QString::isEmpty(), QString::length(), u, and QString::unicode().

Referenced by isValidObjectPath().

    {
        if (part.isEmpty())
            return false;       // can't be valid if it's empty

        const QChar *c = part.unicode();
        for (int i = 0; i < part.length(); ++i) {
            register ushort u = c[i].unicode();
            if (!((u >= 'a' && u <= 'z') ||
                  (u >= 'A' && u <= 'Z') ||
                  (u >= '0' && u <= '9') ||
                  u == '_'))
                return false;
        }
        return true;
    }

Here is the call graph for this function:

QDBUS_EXPORT bool QDBusUtil::isValidSignature

(

const QString &

signature

)

Returns true if signature is a valid D-Bus type signature for one or more types. This function returns true if it can all of signature into valid, individual types and no characters remain in signature.

See also:

isValidSingleSignature()

Definition at line 220 of file qdbusutil.cpp.

References QString::toUtf8().

Referenced by QDBusSignature::check().

    {
        return dbus_signature_validate(signature.toUtf8(), 0);
    }

Here is the call graph for this function:

QDBUS_EXPORT bool QDBusUtil::isValidSingleSignature

(

const QString &

signature

)

Returns true if signature is a valid D-Bus type signature for exactly one full type. This function tries to convert the type signature into a D-Bus type and, if it succeeds and no characters remain in the signature, it returns true.

Definition at line 231 of file qdbusutil.cpp.

References QString::toUtf8().

Referenced by QDBusXmlParser::interfaces(), and parseArgs().

    {
        return dbus_signature_validate_single(signature.toUtf8(), 0);
    }

Here is the call graph for this function:

QDBUS_EXPORT bool QDBusUtil::isValidUniqueConnectionName

(

const QString &

connName

)

Returns true if connName is a valid unique connection name.

Unique connection names start with a colon (":") and are followed by a list of dot-separated components composed of ASCII letters, digits, the hypen or the underscore ("_") character.

Definition at line 101 of file qdbusutil.cpp.

References QList< T >::at(), QList< T >::count(), QRegExp::exactMatch(), i, QString::isEmpty(), QString::length(), QString::mid(), QString::split(), and QString::startsWith().

Referenced by QDBusConnectionPrivate::getNameOwner(), and isValidBusName().

    {
        if (connName.isEmpty() || connName.length() > DBUS_MAXIMUM_NAME_LENGTH ||
            !connName.startsWith(QLatin1Char(':')))
            return false;

        QStringList parts = connName.mid(1).split(QLatin1Char('.'));
        if (parts.count() < 1)
            return false;

        QRegExp regex(QLatin1String("[a-zA-Z0-9_-]+"));
        for (int i = 0; i < parts.count(); ++i)
            if (!regex.exactMatch(parts.at(i)))
                return false;

        return true;
    }

Here is the call graph for this function:

---