ZifDepend

ZifDepend — A package dependency

Synopsis

#define             ZIF_DEPEND_ERROR
enum                ZifDependFlag;
struct              ZifDepend;
struct              ZifDependClass;
ZifDepend *         zif_depend_new                      (void);
ZifDepend *         zif_depend_new_from_data            (const gchar **keys,
                                                         const gchar **values);
gchar *             zif_depend_to_string                (ZifDepend *depend);
const gchar *       zif_depend_flag_to_string           (ZifDependFlag flag);
gboolean            zif_depend_parse_description        (ZifDepend *depend,
                                                         const gchar *value,
                                                         GError **error);
gboolean            zif_depend_satisfies                (ZifDepend *got,
                                                         ZifDepend *need);
gint                zif_depend_compare                  (ZifDepend *a,
                                                         ZifDepend *b);
ZifDependFlag       zif_depend_get_flag                 (ZifDepend *depend);
const gchar *       zif_depend_get_name                 (ZifDepend *depend);
const gchar *       zif_depend_get_version              (ZifDepend *depend);
const gchar *       zif_depend_get_description          (ZifDepend *depend);
void                zif_depend_set_flag                 (ZifDepend *depend,
                                                         ZifDependFlag flag);
void                zif_depend_set_name                 (ZifDepend *depend,
                                                         const gchar *name);
void                zif_depend_set_name_str             (ZifDepend *depend,
                                                         ZifString *name);
void                zif_depend_set_version              (ZifDepend *depend,
                                                         const gchar *version);
void                zif_depend_set_version_str          (ZifDepend *depend,
                                                         ZifString *version);
                    ZifDependPrivate;

Description

An object to represent some information about an encoded dependency.

Details

ZIF_DEPEND_ERROR

#define ZIF_DEPEND_ERROR (zif_depend_error_quark ())


enum ZifDependFlag

typedef enum {
	ZIF_DEPEND_FLAG_ANY = 1,
	ZIF_DEPEND_FLAG_LESS = 2,
	ZIF_DEPEND_FLAG_GREATER = 4,
	ZIF_DEPEND_FLAG_EQUAL = 8,
	ZIF_DEPEND_FLAG_UNKNOWN = 0
} ZifDependFlag;


struct ZifDepend

struct ZifDepend {
	GObject			 parent;
	ZifDependPrivate *priv;
};


struct ZifDependClass

struct ZifDependClass {
	GObjectClass		 parent_class;
};


zif_depend_new ()

ZifDepend *         zif_depend_new                      (void);

Returns :

A new ZifDepend instance.

Since 0.1.3


zif_depend_new_from_data ()

ZifDepend *         zif_depend_new_from_data            (const gchar **keys,
                                                         const gchar **values);

keys :

Data keys

values :

Data values

Returns :

A new ZifDepend instance, or NULL for error

Since 0.2.1


zif_depend_to_string ()

gchar *             zif_depend_to_string                (ZifDepend *depend);

Returns a string representation of the ZifDepend object.

Note: this function is deprecated, use zif_depend_get_description() instead as it is more efficient.

depend :

A ZifDepend

Returns :

string value, free with g_free()

Since 0.1.0


zif_depend_flag_to_string ()

const gchar *       zif_depend_flag_to_string           (ZifDependFlag flag);

Returns a string representation of the ZifDependFlag.

flag :

A ZifDependFlag

Returns :

string value

Since 0.1.0


zif_depend_parse_description ()

gboolean            zif_depend_parse_description        (ZifDepend *depend,
                                                         const gchar *value,
                                                         GError **error);

Parses a depend string and sets internal state.

depend :

A ZifDepend

value :

Depend string, e.g. "obsolete-package < 1.0.0"

error :

A GError, or NULL

Returns :

TRUE for success

Since 0.1.3


zif_depend_satisfies ()

gboolean            zif_depend_satisfies                (ZifDepend *got,
                                                         ZifDepend *need);

Returns if the dependency will be satisfied with what we've got.

got :

The ZifDepend we've got

need :

The ZifDepend we need

Returns :

TRUE if okay, FALSE otherwise

Since 0.1.3


zif_depend_compare ()

gint                zif_depend_compare                  (ZifDepend *a,
                                                         ZifDepend *b);

Compares one dependancy against another. This is basically a zif_compare_evr() on the versions.

a :

A ZifDepend

b :

A ZifDepend to compare

Returns :

1 for a>b, 0 for a==b, -1 for b>a, or G_MAXINT for error

Since 0.1.3


zif_depend_get_flag ()

ZifDependFlag       zif_depend_get_flag                 (ZifDepend *depend);

Gets the depend flag.

depend :

A ZifDepend

Returns :

A flag of depend, e.g. ZIF_DEPEND_FLAG_LESS.

Since 0.1.3


zif_depend_get_name ()

const gchar *       zif_depend_get_name                 (ZifDepend *depend);

Gets the name for this depend.

depend :

A ZifDepend

Returns :

A string value, or NULL.

Since 0.1.3


zif_depend_get_version ()

const gchar *       zif_depend_get_version              (ZifDepend *depend);

Gets the version for this depend.

depend :

A ZifDepend

Returns :

A string value, or NULL.

Since 0.1.3


zif_depend_get_description ()

const gchar *       zif_depend_get_description          (ZifDepend *depend);

Returns a string representation of the ZifDepend object.

depend :

A ZifDepend

Returns :

string value

Since 0.1.3


zif_depend_set_flag ()

void                zif_depend_set_flag                 (ZifDepend *depend,
                                                         ZifDependFlag flag);

Sets the depend flag status.

depend :

A ZifDepend

flag :

If the depend is flag

Since 0.1.3


zif_depend_set_name ()

void                zif_depend_set_name                 (ZifDepend *depend,
                                                         const gchar *name);

Sets the depend name.

depend :

A ZifDepend

name :

The depend name

Since 0.1.3


zif_depend_set_name_str ()

void                zif_depend_set_name_str             (ZifDepend *depend,
                                                         ZifString *name);

Sets the depend name.

depend :

A ZifDepend

name :

The depend name

Since 0.1.3


zif_depend_set_version ()

void                zif_depend_set_version              (ZifDepend *depend,
                                                         const gchar *version);

Sets the depend version.

depend :

A ZifDepend

version :

The depend version

Since 0.1.3


zif_depend_set_version_str ()

void                zif_depend_set_version_str          (ZifDepend *depend,
                                                         ZifString *version);

Sets the depend version.

depend :

A ZifDepend

version :

The depend version

Since 0.1.3


ZifDependPrivate

typedef struct _ZifDependPrivate ZifDependPrivate;