TQT_DBusObjectPath Class Reference

#include <tqdbusobjectpath.h>

List of all members.

Public Member Functions
	TQT_DBusObjectPath ()
	TQT_DBusObjectPath (const TQT_DBusObjectPath &other)
	TQT_DBusObjectPath (const TQString &other)
	TQT_DBusObjectPath (const TQT_DBusObjectPath &parentNode, const TQString &nodeName)
bool	isValid () const
TQT_DBusObjectPath	parentNode () const
Static Public Member Functions
static int	validate (const TQString &path)

---

Detailed Description

Class for representing D-Bus object paths.

This data type is necessary to correctly represent object paths in the context of D-Bus messages, since normal strings have a different D-Bus signature than object paths.

See also:

Object paths

Definition at line 38 of file tqdbusobjectpath.h.

---

Constructor & Destructor Documentation

TQT_DBusObjectPath::TQT_DBusObjectPath

(

)

Creates an empty and invalid object path.

Definition at line 26 of file tqdbusobjectpath.cpp.

                                       : TQString()
{
}

Here is the caller graph for this function:

TQT_DBusObjectPath::TQT_DBusObjectPath

(

const TQT_DBusObjectPath &

other

)

Creates copy of the given other object path.

Parameters:

other

the object path to copy

Definition at line 30 of file tqdbusobjectpath.cpp.

                                                                      : TQString(static_cast<const TQString&>(other))
{
}

TQT_DBusObjectPath::TQT_DBusObjectPath

(

const TQString &

other

)

Creates copy of the given other object path.

Parameters:

other

the object path to copy

Definition at line 34 of file tqdbusobjectpath.cpp.

                                                            : TQString(static_cast<const TQString&>(other))
{
}

TQT_DBusObjectPath::TQT_DBusObjectPath	(	const TQT_DBusObjectPath &	parentNode,
		const TQString &	nodeName
	)

Creates an object path for an object as a child of the parent node.

This is basically like specifying a directory and a file name to create the file's full path.

Example:

 TQT_DBusObjectPath rootNode("/"); // => "/"

 TQT_DBusObjectPath childNod(rootNode, "child"); // => "/child"

 TQT_DBusObjectPath grandChildNode(childNode, "grandchild"); // => "/child/grandchild"

Parameters:

parentNode	the object path to create the child on
nodeName	the name of the child node

Definition at line 38 of file tqdbusobjectpath.cpp.

    : TQString(static_cast<const TQString&>(parentNode))
{
    if (parentNode.length() != 1)
    {
      append("/");
    }
    append(nodeName);
}

---

Member Function Documentation

bool TQT_DBusObjectPath::isValid

(

)

const

Returns whether the current content is considered a valid object path.

Note:

Calls validate() to perform a check on the current content

Returns:

true if the object's content describe a valid object path, otherwise false

See also:

Object paths

Definition at line 48 of file tqdbusobjectpath.cpp.

References validate().

{
    return (validate(*this) == -1);
}

Here is the call graph for this function:

Here is the caller graph for this function:

TQT_DBusObjectPath TQT_DBusObjectPath::parentNode

(

)

const

Returns the object path of this path's parent node.

This is basically like getting the directory of an file path

Returns:

the parent node's object path or an empty and invalid object if this is already the root node

Definition at line 53 of file tqdbusobjectpath.cpp.

References TQT_DBusObjectPath().

{
    if (length() == 1)
    {
      return TQT_DBusObjectPath();
    }

    int index = findRev('/');
    if (index == -1)
    {
      return TQT_DBusObjectPath();
    }
    else if (index == 0)
    {
      return left(1);
    }

    return left(index);
}

Here is the call graph for this function:

int TQT_DBusObjectPath::validate

(

const TQString &

path

)

[static]

Checks the given string for validity as a D-Bus object path.

See section Object paths for information on object path formatting.

Parameters:

path	the string to check

Returns:

-1 if the object path is valid, otherwise the index of the first violating character

See also:

isValid()

Definition at line 73 of file tqdbusobjectpath.cpp.

{
    if (path.isEmpty() || path[0] != '/')
    {
      return 0;
    }

    // only root node allowed to end in slash
    uint len = path.length();
    if (path[len - 1] == '/' && len > 1)
    {
      return (len - 1);
    }

    return -1;
}

Here is the caller graph for this function:

---

The documentation for this class was generated from the following files:

• tqdbusobjectpath.h
• tqdbusobjectpath.cpp