![]() |
![]() |
![]() |
AppStream-glib Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <appstream-glib.h> #define AS_TYPE_REQUIRE struct AsRequireClass; enum AsRequireKind; enum AsRequireCompare; AsRequire * as_require_new (void
); AsRequireKind as_require_kind_from_string (const gchar *kind
); const gchar * as_require_kind_to_string (AsRequireKind kind
); AsRequireCompare as_require_compare_from_string (const gchar *compare
); const gchar * as_require_compare_to_string (AsRequireCompare compare
); AsRequireKind as_require_get_kind (AsRequire *require
); AsRequireCompare as_require_get_compare (AsRequire *require
); const gchar * as_require_get_version (AsRequire *require
); const gchar * as_require_get_value (AsRequire *require
); void as_require_set_kind (AsRequire *require
,AsRequireKind kind
); void as_require_set_compare (AsRequire *require
,AsRequireCompare compare
); void as_require_set_version (AsRequire *require
,const gchar *version
); void as_require_set_value (AsRequire *require
,const gchar *value
); gboolean as_require_version_compare (AsRequire *require
,const gchar *version
,GError **error
); gboolean as_require_equal (AsRequire *require1
,AsRequire *require2
);
typedef enum { AS_REQUIRE_KIND_UNKNOWN, AS_REQUIRE_KIND_ID, AS_REQUIRE_KIND_FIRMWARE, AS_REQUIRE_KIND_HARDWARE, /* Since: 0.7.4 */ AS_REQUIRE_KIND_MODALIAS, /* Since: 0.7.8 */ AS_REQUIRE_KIND_KERNEL, /* Since: 0.7.8 */ AS_REQUIRE_KIND_MEMORY, /* Since: 0.7.8 */ } AsRequireKind;
The require type.
Type invalid or not known | |
Component ID | |
Device firmware version | |
Hardware device, typically a GUID | |
Modalias string | |
Kernel version | |
Amount of installed memory in MiB |
typedef enum { AS_REQUIRE_COMPARE_UNKNOWN, AS_REQUIRE_COMPARE_EQ, AS_REQUIRE_COMPARE_NE, AS_REQUIRE_COMPARE_LT, AS_REQUIRE_COMPARE_GT, AS_REQUIRE_COMPARE_LE, AS_REQUIRE_COMPARE_GE, AS_REQUIRE_COMPARE_GLOB, AS_REQUIRE_COMPARE_REGEX, } AsRequireCompare;
The relational comparison type.
Comparison predicate invalid or not known | |
Equal to | |
Not equal to | |
Less than | |
Greater than | |
Less than or equal to | |
Greater than or equal to | |
Filename glob, e.g. `test*` | |
A regular expression, e.g. `fw[0-255]` |
AsRequire * as_require_new (void
);
Creates a new AsRequire.
Returns : |
a AsRequire. [transfer full] |
Since 0.6.7
AsRequireKind as_require_kind_from_string (const gchar *kind
);
Converts the text representation to an enumerated value.
|
the string. |
Returns : |
a AsRequireKind, or AS_REQUIRE_KIND_UNKNOWN for unknown. [transfer full]
|
Since 0.6.7
const gchar * as_require_kind_to_string (AsRequireKind kind
);
Converts the enumerated value to an text representation.
|
the AsRequireKind. |
Returns : |
string version of kind
|
Since 0.6.7
AsRequireCompare as_require_compare_from_string (const gchar *compare
);
Converts the text representation to an enumerated value.
|
the string. |
Returns : |
a AsRequireCompare, or
AS_REQUIRE_COMPARE_UNKNOWN for unknown. [transfer full]
|
Since 0.6.7
const gchar * as_require_compare_to_string (AsRequireCompare compare
);
Converts the enumerated value to an text representation.
|
the AsRequireCompare. |
Returns : |
string version of compare
|
Since 0.6.7
AsRequireKind as_require_get_kind (AsRequire *require
);
Gets the require kind.
|
a AsRequire instance. |
Returns : |
the AsRequireKind |
Since 0.6.7
AsRequireCompare as_require_get_compare (AsRequire *require
);
Gets the require version comparison type.
|
a AsRequire instance. |
Returns : |
the AsRequireKind |
Since 0.6.7
const gchar * as_require_get_version (AsRequire *require
);
Gets the require version if set.
|
a AsRequire instance. |
Returns : |
the version, e.g. "0.1.2" |
Since 0.6.7
const gchar * as_require_get_value (AsRequire *require
);
Gets the require value if set.
|
a AsRequire instance. |
Returns : |
the value, e.g. "bootloader" |
Since 0.6.7
void as_require_set_kind (AsRequire *require
,AsRequireKind kind
);
Sets the require kind.
|
a AsRequire instance. |
|
the AsRequireKind, e.g. AS_REQUIRE_KIND_ID . |
Since 0.6.7
void as_require_set_compare (AsRequire *require
,AsRequireCompare compare
);
Sets the require version comparison type.
|
a AsRequire instance. |
|
the AsRequireKind, e.g. AS_REQUIRE_KIND_ID . |
Since 0.6.7
void as_require_set_version (AsRequire *require
,const gchar *version
);
Sets the require version.
|
a AsRequire instance. |
|
an version number, e.g. `0.1.2` |
Since 0.6.7
void as_require_set_value (AsRequire *require
,const gchar *value
);
Sets the require value.
|
a AsRequire instance. |
|
an require version, e.g. `firmware` |
Since 0.6.7
gboolean as_require_version_compare (AsRequire *require
,const gchar *version
,GError **error
);
Compares the version number of the requirement with a predicate.
|
a AsRequire instance. |
|
a version number, e.g. `0.1.3` |
|
A GError or NULL
|
Returns : |
TRUE if the predicate was true |
Since 0.6.7