AsProvide: AppStream-glib Reference Manual

## AsProvide AsProvide — Object representing a single object the application provides. |

## Stability Level

Stable, unless otherwise indicated

## Functions

AsProvide * | as_provide_new ()
AsProvideKind | as_provide_kind_from_string ()
const gchar * | as_provide_kind_to_string ()
const gchar * | as_provide_get_value ()
AsProvideKind | as_provide_get_kind ()
void | as_provide_set_value ()
void | as_provide_set_kind ()

## Types and Values

#define | AS_TYPE_PROVIDE
struct | AsProvideClass
enum | AsProvideKind
| AsProvide

## Object Hierarchy

        GObject
        ╰── AsProvide

## Includes

    #include <appstream-glib.h>

## Description

Applications may provide different binary names, firmware files and that kind of thing. This is the place to express those extra items.

See also: AsApp

## Functions

### as_provide_new ()

    AsProvide *
    as_provide_new (void);

Creates a new AsProvide.

#### Returns

a AsProvide.

[transfer full]

Since: 0.1.6

### as_provide_kind_from_string ()

    AsProvideKind
    as_provide_kind_from_string (const gchar *kind);

Converts the text representation to an enumerated value.

#### Parameters

kind | the string. |

#### Returns

a AsProvideKind, or `AS_PROVIDE_KIND_UNKNOWN` for unknown.

[transfer full]

Since: 0.1.6

### as_provide_kind_to_string ()

    const gchar *
    as_provide_kind_to_string (AsProvideKind kind);

Converts the enumerated value to an text representation.

#### Parameters

kind | the AsProvideKind. |

#### Returns

string version of `kind`

Since: 0.1.6

### as_provide_get_value ()

    const gchar *
    as_provide_get_value (AsProvide *provide);

Gets the full qualified URL for the provide, usually pointing at some mirror.

#### Parameters

provide | a AsProvide instance. |

#### Returns

URL

Since: 0.1.6

### as_provide_get_kind ()

    AsProvideKind
    as_provide_get_kind (AsProvide *provide);

Gets the provide kind.

#### Parameters

provide | a AsProvide instance. |

#### Returns

the AsProvideKind

Since: 0.1.6

### as_provide_set_value ()

    void
    as_provide_set_value (AsProvide *provide,
                          const gchar *value);

Sets the fully-qualified mirror URL to use for the provide.

#### Parameters

provide | a AsProvide instance. |
value | the URL. |

Since: 0.1.6

### as_provide_set_kind ()

    void
    as_provide_set_kind (AsProvide *provide,
                         AsProvideKind kind);

Sets the provide kind.

#### Parameters

provide | a AsProvide instance. |
kind | the AsProvideKind, e.g. `AS_PROVIDE_KIND_LIBRARY`. |

Since: 0.1.6

## Types and Values

### AS_TYPE_PROVIDE

    #define AS_TYPE_PROVIDE (as_provide_get_type ())

### struct AsProvideClass

    struct AsProvideClass {
    	GObjectClass		parent_class;
    };

### enum AsProvideKind

The provide type.

#### Members

AS_PROVIDE_KIND_UNKNOWN | Type invalid or not known |
AS_PROVIDE_KIND_LIBRARY | A library file |
AS_PROVIDE_KIND_BINARY | A binary file |
AS_PROVIDE_KIND_FONT | A font file |
AS_PROVIDE_KIND_MODALIAS | A hardware modalias |
AS_PROVIDE_KIND_FIRMWARE_RUNTIME | A runtime-loadable firmware file |
AS_PROVIDE_KIND_PYTHON2 | A Python 2 module |
AS_PROVIDE_KIND_PYTHON3 | A Python 3 module |
AS_PROVIDE_KIND_DBUS_SESSION | A D-Bus session service |
AS_PROVIDE_KIND_DBUS_SYSTEM | A D-Bus system service |
AS_PROVIDE_KIND_FIRMWARE_FLASHED | A flashed firmware GUID |

### AsProvide

    typedef struct _AsProvide AsProvide;