TpHandle

TpHandle — type representing handles

Synopsis

#include <telepathy-glib/handle.h>

typedef             TpHandle;
#define             TP_TYPE_HANDLE
#define             TP_UNKNOWN_HANDLE_TYPE
gboolean            tp_handle_type_is_valid             (TpHandleType type,
                                                         GError **error);
const gchar *       tp_handle_type_to_string            (TpHandleType type);

Description

The TpHandle type represents a Telepathy handle.

Details

TpHandle

typedef guint TpHandle;

Type representing Telepathy handles within telepathy-glib.

This is guint despite the wire protocol having 32-bit integers, because dbus-glib expects GArrays of guint and so on. If the dbus-glib ABI changes in future, telepathy-glib is likely to have a matching ABI change.


TP_TYPE_HANDLE

#define TP_TYPE_HANDLE G_TYPE_UINT

The GType of a TpHandle, currently G_TYPE_UINT.

This won't change unless in an ABI-incompatible version of telepathy-glib.


TP_UNKNOWN_HANDLE_TYPE

#define TP_UNKNOWN_HANDLE_TYPE ((TpHandleType) -1)

An invalid handle type (-1 cast to TpHandleType) used to represent an unknown handle type.

Since 0.7.0


tp_handle_type_is_valid ()

gboolean            tp_handle_type_is_valid             (TpHandleType type,
                                                         GError **error);

If the given handle type is valid, return TRUE. If not, set error and return FALSE.

type :

A handle type, valid or not, to be checked

error :

Set if the handle type is invalid

Returns :

TRUE if the handle type is valid.

tp_handle_type_to_string ()

const gchar *       tp_handle_type_to_string            (TpHandleType type);

type :

A handle type, which need not be valid

Returns :

a human-readable string describing the handle type, e.g. "contact". For invalid handle types, returns "(no handle)" for 0 or "(invalid handle type)" for others.

See Also

TpHandleRepoIface