<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>AsComponent: AppStream Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="AppStream Library Reference Manual">
<link rel="up" href="ch01.html" title="AppStream API Reference">
<link rel="prev" href="ch01.html" title="AppStream API Reference">
<link rel="next" href="appstream-as-enums.html" title="as-enums">
<meta name="generator" content="GTK-Doc V1.29 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
<a href="#appstream-AsComponent.description" class="shortcut">Description</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="ch01.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="appstream-as-enums.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="appstream-AsComponent"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="appstream-AsComponent.top_of_page"></a>AsComponent</span></h2>
<p>AsComponent — Object representing a software component</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="appstream-AsComponent.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-kind-to-string" title="as_component_kind_to_string ()">as_component_kind_to_string</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="returnvalue">AsComponentKind</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-kind-from-string" title="as_component_kind_from_string ()">as_component_kind_from_string</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-merge-kind-to-string" title="as_merge_kind_to_string ()">as_merge_kind_to_string</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="returnvalue">AsMergeKind</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-merge-kind-from-string" title="as_merge_kind_from_string ()">as_merge_kind_from_string</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="returnvalue">AsComponent</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-new" title="as_component_new ()">as_component_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsComponent.html#AsValueFlags" title="enum AsValueFlags"><span class="returnvalue">AsValueFlags</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-value-flags" title="as_component_get_value_flags ()">as_component_get_value_flags</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-value-flags" title="as_component_set_value_flags ()">as_component_set_value_flags</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-active-locale" title="as_component_get_active_locale ()">as_component_get_active_locale</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-active-locale" title="as_component_set_active_locale ()">as_component_set_active_locale</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-id" title="as_component_get_id ()">as_component_get_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-id" title="as_component_set_id ()">as_component_set_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-data-id" title="as_component_get_data_id ()">as_component_get_data_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-data-id" title="as_component_set_data_id ()">as_component_set_data_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="returnvalue">AsComponentKind</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-kind" title="as_component_get_kind ()">as_component_get_kind</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-kind" title="as_component_set_kind ()">as_component_set_kind</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-origin" title="as_component_get_origin ()">as_component_get_origin</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-origin" title="as_component_set_origin ()">as_component_set_origin</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-pkgname" title="as_component_get_pkgname ()">as_component_get_pkgname</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-pkgnames" title="as_component_get_pkgnames ()">as_component_get_pkgnames</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-pkgnames" title="as_component_set_pkgnames ()">as_component_set_pkgnames</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-source-pkgname" title="as_component_get_source_pkgname ()">as_component_get_source_pkgname</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-source-pkgname" title="as_component_set_source_pkgname ()">as_component_set_source_pkgname</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-name" title="as_component_get_name ()">as_component_get_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-name" title="as_component_set_name ()">as_component_set_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-summary" title="as_component_get_summary ()">as_component_get_summary</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-summary" title="as_component_set_summary ()">as_component_set_summary</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-description" title="as_component_get_description ()">as_component_get_description</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-description" title="as_component_set_description ()">as_component_set_description</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-launchables" title="as_component_get_launchables ()">as_component_get_launchables</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsLaunchable.html#AsLaunchable" title="AsLaunchable"><span class="returnvalue">AsLaunchable</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-launchable" title="as_component_get_launchable ()">as_component_get_launchable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-launchable" title="as_component_add_launchable ()">as_component_add_launchable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-metadata-license" title="as_component_get_metadata_license ()">as_component_get_metadata_license</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-metadata-license" title="as_component_set_metadata_license ()">as_component_set_metadata_license</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-project-license" title="as_component_get_project_license ()">as_component_get_project_license</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-project-license" title="as_component_set_project_license ()">as_component_set_project_license</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-project-group" title="as_component_get_project_group ()">as_component_get_project_group</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-project-group" title="as_component_set_project_group ()">as_component_set_project_group</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-developer-name" title="as_component_get_developer_name ()">as_component_get_developer_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-developer-name" title="as_component_set_developer_name ()">as_component_set_developer_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-compulsory-for-desktops" title="as_component_get_compulsory_for_desktops ()">as_component_get_compulsory_for_desktops</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-compulsory-for-desktop" title="as_component_set_compulsory_for_desktop ()">as_component_set_compulsory_for_desktop</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-is-compulsory-for-desktop" title="as_component_is_compulsory_for_desktop ()">as_component_is_compulsory_for_desktop</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-categories" title="as_component_get_categories ()">as_component_get_categories</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-category" title="as_component_add_category ()">as_component_add_category</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-has-category" title="as_component_has_category ()">as_component_has_category</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-screenshots" title="as_component_get_screenshots ()">as_component_get_screenshots</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-screenshot" title="as_component_add_screenshot ()">as_component_add_screenshot</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-keywords" title="as_component_get_keywords ()">as_component_get_keywords</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-keywords" title="as_component_set_keywords ()">as_component_set_keywords</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-icons" title="as_component_get_icons ()">as_component_get_icons</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsIcon.html#AsIcon" title="AsIcon"><span class="returnvalue">AsIcon</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-icon-by-size" title="as_component_get_icon_by_size ()">as_component_get_icon_by_size</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-icon" title="as_component_add_icon ()">as_component_add_icon</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-provided" title="as_component_get_provided ()">as_component_get_provided</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-provided" title="as_component_add_provided ()">as_component_add_provided</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsProvided.html#AsProvided" title="AsProvided"><span class="returnvalue">AsProvided</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-provided-for-kind" title="as_component_get_provided_for_kind ()">as_component_get_provided_for_kind</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-url" title="as_component_get_url ()">as_component_get_url</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-url" title="as_component_add_url ()">as_component_add_url</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-releases" title="as_component_get_releases ()">as_component_get_releases</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-release" title="as_component_add_release ()">as_component_add_release</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-extends" title="as_component_get_extends ()">as_component_get_extends</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-extends" title="as_component_add_extends ()">as_component_add_extends</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-addons" title="as_component_get_addons ()">as_component_get_addons</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-addon" title="as_component_add_addon ()">as_component_add_addon</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-languages" title="as_component_get_languages ()">as_component_get_languages</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-language" title="as_component_get_language ()">as_component_get_language</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-language" title="as_component_add_language ()">as_component_add_language</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-translations" title="as_component_get_translations ()">as_component_get_translations</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-translation" title="as_component_add_translation ()">as_component_add_translation</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-has-bundle" title="as_component_has_bundle ()">as_component_has_bundle</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-bundles" title="as_component_get_bundles ()">as_component_get_bundles</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsBundle.html#AsBundle" title="AsBundle"><span class="returnvalue">AsBundle</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-bundle" title="as_component_get_bundle ()">as_component_get_bundle</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-bundle" title="as_component_add_bundle ()">as_component_add_bundle</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-suggested" title="as_component_get_suggested ()">as_component_get_suggested</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-suggested" title="as_component_add_suggested ()">as_component_add_suggested</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-search-tokens" title="as_component_get_search_tokens ()">as_component_get_search_tokens</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-search-matches" title="as_component_search_matches ()">as_component_search_matches</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-search-matches-all" title="as_component_search_matches_all ()">as_component_search_matches_all</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="returnvalue">AsMergeKind</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-merge-kind" title="as_component_get_merge_kind ()">as_component_get_merge_kind</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-set-merge-kind" title="as_component_set_merge_kind ()">as_component_set_merge_kind</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-is-member-of-category" title="as_component_is_member_of_category ()">as_component_is_member_of_category</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-is-ignored" title="as_component_is_ignored ()">as_component_is_ignored</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-is-valid" title="as_component_is_valid ()">as_component_is_valid</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-to-string" title="as_component_to_string ()">as_component_to_string</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-custom" title="as_component_get_custom ()">as_component_get_custom</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-custom-value" title="as_component_get_custom_value ()">as_component_get_custom_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-insert-custom-value" title="as_component_insert_custom_value ()">as_component_insert_custom_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-content-ratings" title="as_component_get_content_ratings ()">as_component_get_content_ratings</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="appstream-AsContentRating.html#AsContentRating" title="AsContentRating"><span class="returnvalue">AsContentRating</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-content-rating" title="as_component_get_content_rating ()">as_component_get_content_rating</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-content-rating" title="as_component_add_content_rating ()">as_component_add_content_rating</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-recommends" title="as_component_get_recommends ()">as_component_get_recommends</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-requires" title="as_component_get_requires ()">as_component_get_requires</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-relation" title="as_component_add_relation ()">as_component_add_relation</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-add-agreement" title="as_component_add_agreement ()">as_component_add_agreement</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">AsAgreement</span> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-agreement-by-kind" title="as_component_get_agreement_by_kind ()">as_component_get_agreement_by_kind</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="appstream-AsComponent.html#as-component-get-desktop-id" title="as_component_get_desktop_id ()">as_component_get_desktop_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="appstream-AsComponent.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="appstream-AsComponent.html#AS-TYPE-COMPONENT:CAPS" title="AS_TYPE_COMPONENT">AS_TYPE_COMPONENT</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="appstream-AsComponent.html#AsComponentClass" title="struct AsComponentClass">AsComponentClass</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind">AsComponentKind</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind">AsMergeKind</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="appstream-AsComponent.html#AsComponentScope" title="enum AsComponentScope">AsComponentScope</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="appstream-AsComponent.html#AsValueFlags" title="enum AsValueFlags">AsValueFlags</a></td>
</tr>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent">AsComponent</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="appstream-AsComponent.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include <appstream.h>
</pre>
</div>
<div class="refsect1">
<a name="appstream-AsComponent.description"></a><h2>Description</h2>
<p>This object represents an Appstream software component which is associated
to a package in the distribution's repositories.
A component can be anything, ranging from an application to a font, a codec or
even a non-visual software project providing libraries and python-modules for
other applications to use.</p>
<p>The type of the component is stored as <a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="type">AsComponentKind</span></a> and can be queried to
find out which kind of component we're dealing with.</p>
<p>See also: <span class="type">AsProvidesKind</span>, <span class="type">AsDatabase</span></p>
</div>
<div class="refsect1">
<a name="appstream-AsComponent.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="as-component-kind-to-string"></a><h3>as_component_kind_to_string ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_kind_to_string (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="type">AsComponentKind</span></a> kind</code></em>);</pre>
<p>Converts the enumerated value to an text representation.</p>
<div class="refsect3">
<a name="as-component-kind-to-string.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>kind</p></td>
<td class="parameter_description"><p>the <a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="type">AsComponentKind</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-kind-to-string.returns"></a><h4>Returns</h4>
<p> string version of <em class="parameter"><code>kind</code></em>
</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-kind-from-string"></a><h3>as_component_kind_from_string ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="returnvalue">AsComponentKind</span></a>
as_component_kind_from_string (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *kind_str</code></em>);</pre>
<p>Converts the text representation to an enumerated value.</p>
<div class="refsect3">
<a name="as-component-kind-from-string.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>kind_str</p></td>
<td class="parameter_description"><p>the string.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-kind-from-string.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="type">AsComponentKind</span></a> or <a class="link" href="appstream-AsComponent.html#AS-COMPONENT-KIND-UNKNOWN:CAPS"><code class="literal">AS_COMPONENT_KIND_UNKNOWN</code></a> for unknown</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-merge-kind-to-string"></a><h3>as_merge_kind_to_string ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_merge_kind_to_string (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="type">AsMergeKind</span></a> kind</code></em>);</pre>
<p>Converts the enumerated value to an text representation.</p>
<div class="refsect3">
<a name="as-merge-kind-to-string.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>kind</p></td>
<td class="parameter_description"><p>the <a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="type">AsMergeKind</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-merge-kind-to-string.returns"></a><h4>Returns</h4>
<p> string version of <em class="parameter"><code>kind</code></em>
</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-merge-kind-from-string"></a><h3>as_merge_kind_from_string ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="returnvalue">AsMergeKind</span></a>
as_merge_kind_from_string (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *kind_str</code></em>);</pre>
<p>Converts the text representation to an enumerated value.</p>
<div class="refsect3">
<a name="as-merge-kind-from-string.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>kind_str</p></td>
<td class="parameter_description"><p>the string.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-merge-kind-from-string.returns"></a><h4>Returns</h4>
<p> a <a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="type">AsMergeKind</span></a> or <a class="link" href="appstream-AsComponent.html#AS-MERGE-KIND-NONE:CAPS"><code class="literal">AS_MERGE_KIND_NONE</code></a> for unknown</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-new"></a><h3>as_component_new ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="returnvalue">AsComponent</span></a> *
as_component_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Creates a new <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a>.</p>
<div class="refsect3">
<a name="as-component-new.returns"></a><h4>Returns</h4>
<p>a new <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-value-flags"></a><h3>as_component_get_value_flags ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsComponent.html#AsValueFlags" title="enum AsValueFlags"><span class="returnvalue">AsValueFlags</span></a>
as_component_get_value_flags (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-get-value-flags.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-value-flags.returns"></a><h4>Returns</h4>
<p> The <a class="link" href="appstream-AsComponent.html#AsValueFlags" title="enum AsValueFlags"><span class="type">AsValueFlags</span></a> that are set on <em class="parameter"><code>cpt</code></em>
.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-value-flags"></a><h3>as_component_set_value_flags ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_value_flags (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsValueFlags" title="enum AsValueFlags"><span class="type">AsValueFlags</span></a> flags</code></em>);</pre>
<div class="refsect3">
<a name="as-component-set-value-flags.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>flags</p></td>
<td class="parameter_description"><p><a class="link" href="appstream-AsComponent.html#AsValueFlags" title="enum AsValueFlags"><span class="type">AsValueFlags</span></a> to set on <em class="parameter"><code>cpt</code></em>
.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-active-locale"></a><h3>as_component_get_active_locale ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_active_locale (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get the current active locale for this component, which
is used to get localized messages.</p>
<div class="refsect3">
<a name="as-component-get-active-locale.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-active-locale.returns"></a><h4>Returns</h4>
<p> the current active locale.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-active-locale"></a><h3>as_component_set_active_locale ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_active_locale (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *locale</code></em>);</pre>
<p>Set the current active locale for this component, which
is used to get localized messages.
If the <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> was fetched from a localized database, usually only
one locale is available.</p>
<div class="refsect3">
<a name="as-component-set-active-locale.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>the locale, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. e.g. "en_GB". </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-id"></a><h3>as_component_get_id ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_id (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get the unique AppStream identifier for this component.
This ID is unique for the described component, but does
not uniquely identify the metadata set.</p>
<p>For a unique ID for this metadata set in the current
session, use <a class="link" href="appstream-AsComponent.html#as-component-get-data-id" title="as_component_get_data_id ()"><code class="literal">as_component_get_data_id</code></a>()</p>
<div class="refsect3">
<a name="as-component-get-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-id.returns"></a><h4>Returns</h4>
<p> the unique AppStream identifier.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-id"></a><h3>as_component_set_id ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_id (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
<p>Set the AppStream identifier for this component.</p>
<div class="refsect3">
<a name="as-component-set-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the unique identifier.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-data-id"></a><h3>as_component_get_data_id ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_data_id (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get a unique identifier for this metadata set.
This unique ID is only valid for the current session,
as opposed to the AppStream ID which uniquely identifies
a software component.</p>
<p>The format of the unique id usually is:
%{scope}/%{origin}/%{distribution_system}/%{appstream_id}</p>
<p>For example:
system/os/package/org.example.FooBar</p>
<div class="refsect3">
<a name="as-component-get-data-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-data-id.returns"></a><h4>Returns</h4>
<p> the unique session-specific identifier.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-data-id"></a><h3>as_component_set_data_id ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_data_id (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
<p>Set the session-specific unique metadata identifier for this
component.
If two components have a different data_id but the same ID,
they will be treated as independent sets of metadata describing
the same component type.</p>
<div class="refsect3">
<a name="as-component-set-data-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the unique session-specific identifier.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-kind"></a><h3>as_component_get_kind ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="returnvalue">AsComponentKind</span></a>
as_component_get_kind (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Returns the <a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="type">AsComponentKind</span></a> of this component.</p>
<div class="refsect3">
<a name="as-component-get-kind.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-kind.returns"></a><h4>Returns</h4>
<p> the kind of <span class="type">this</span>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-kind"></a><h3>as_component_set_kind ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_kind (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="type">AsComponentKind</span></a> value</code></em>);</pre>
<p>Sets the <a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="type">AsComponentKind</span></a> of this component.</p>
<div class="refsect3">
<a name="as-component-set-kind.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the <a class="link" href="appstream-AsComponent.html#AsComponentKind" title="enum AsComponentKind"><span class="type">AsComponentKind</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-origin"></a><h3>as_component_get_origin ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_origin (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-get-origin.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-origin"></a><h3>as_component_set_origin ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_origin (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *origin</code></em>);</pre>
<div class="refsect3">
<a name="as-component-set-origin.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>origin</p></td>
<td class="parameter_description"><p>the origin.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-pkgname"></a><h3>as_component_get_pkgname ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_pkgname (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get the first package name of the list of packages that need to be installed
for this component to be present on the system.
Since most components consist of only one package, this is safe to use for
about 90% of all cases.</p>
<p>However, to support a component fully, please use <a class="link" href="appstream-AsComponent.html#as-component-get-pkgnames" title="as_component_get_pkgnames ()"><code class="literal">as_component_get_pkgnames</code></a>() for
getting all packages that need to be installed, and use this method only to
e.g. get the main package to perform a quick "is it installed?" check.</p>
<div class="refsect3">
<a name="as-component-get-pkgname.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-pkgname.returns"></a><h4>Returns</h4>
<p>String array of package names. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-pkgnames"></a><h3>as_component_get_pkgnames ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
as_component_get_pkgnames (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get a list of package names which this component consists of.
This usually is just one package name.</p>
<div class="refsect3">
<a name="as-component-get-pkgnames.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-pkgnames.returns"></a><h4>Returns</h4>
<p>String array of package names. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-pkgnames"></a><h3>as_component_set_pkgnames ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_pkgnames (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **packages</code></em>);</pre>
<p>Set a list of package names this component consists of.
(This should usually be just one package name)</p>
<div class="refsect3">
<a name="as-component-set-pkgnames.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>packages</p></td>
<td class="parameter_description"><p>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-source-pkgname"></a><h3>as_component_get_source_pkgname ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_source_pkgname (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-get-source-pkgname.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-source-pkgname.returns"></a><h4>Returns</h4>
<p> the source package name.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-source-pkgname"></a><h3>as_component_set_source_pkgname ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_source_pkgname (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *spkgname</code></em>);</pre>
<div class="refsect3">
<a name="as-component-set-source-pkgname.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>spkgname</p></td>
<td class="parameter_description"><p>the source package name.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-name"></a><h3>as_component_get_name ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_name (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>A human-readable name for this component.</p>
<div class="refsect3">
<a name="as-component-get-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-name.returns"></a><h4>Returns</h4>
<p> the name.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-name"></a><h3>as_component_set_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_name (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *locale</code></em>);</pre>
<p>Set a human-readable name for this component.</p>
<div class="refsect3">
<a name="as-component-set-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>The name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>The locale the used for this value, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the current active one. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-summary"></a><h3>as_component_get_summary ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_summary (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get a short description of this component.</p>
<div class="refsect3">
<a name="as-component-get-summary.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-summary.returns"></a><h4>Returns</h4>
<p> the summary.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-summary"></a><h3>as_component_set_summary ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_summary (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *locale</code></em>);</pre>
<p>Set a short description for this component.</p>
<div class="refsect3">
<a name="as-component-set-summary.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>The summary</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>The locale the used for this value, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the current active one. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-description"></a><h3>as_component_get_description ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_description (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get the localized long description of this component.</p>
<div class="refsect3">
<a name="as-component-get-description.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-description.returns"></a><h4>Returns</h4>
<p> the description.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-description"></a><h3>as_component_set_description ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_description (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *locale</code></em>);</pre>
<p>Set long description for this component.</p>
<div class="refsect3">
<a name="as-component-set-description.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>A valid <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>The long description</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>The locale the used for this value, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the current active one. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-launchables"></a><h3>as_component_get_launchables ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_launchables (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-get-launchables.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-launchables.returns"></a><h4>Returns</h4>
<p>an array. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsLaunchable]</span></p>
</div>
<p class="since">Since: 0.11.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-launchable"></a><h3>as_component_get_launchable ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsLaunchable.html#AsLaunchable" title="AsLaunchable"><span class="returnvalue">AsLaunchable</span></a> *
as_component_get_launchable (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsLaunchable.html#AsLaunchableKind" title="enum AsLaunchableKind"><span class="type">AsLaunchableKind</span></a> kind</code></em>);</pre>
<p>Gets a <a class="link" href="appstream-AsLaunchable.html#AsLaunchable" title="AsLaunchable"><span class="type">AsLaunchable</span></a> of a specific type that contains launchable entries for
this component.</p>
<div class="refsect3">
<a name="as-component-get-launchable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>kind</p></td>
<td class="parameter_description"><p>a launch kind, e.g. <a class="link" href="appstream-AsLaunchable.html#AS-LAUNCHABLE-KIND-DESKTOP-ID:CAPS"><code class="literal">AS_LAUNCHABLE_KIND_DESKTOP_ID</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-launchable.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="appstream-AsLaunchable.html#AsLaunchable" title="AsLaunchable"><span class="type">AsLaunchable</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not found. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 0.11.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-launchable"></a><h3>as_component_add_launchable ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_launchable (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsLaunchable.html#AsLaunchable" title="AsLaunchable"><span class="type">AsLaunchable</span></a> *launchable</code></em>);</pre>
<p>Adds a <a class="link" href="appstream-AsLaunchable.html#AsLaunchable" title="AsLaunchable"><span class="type">AsLaunchable</span></a> containing launchables entries for this component.</p>
<div class="refsect3">
<a name="as-component-add-launchable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>launchable</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsLaunchable.html#AsLaunchable" title="AsLaunchable"><span class="type">AsLaunchable</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.11.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-metadata-license"></a><h3>as_component_get_metadata_license ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_metadata_license (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>The license the metadata iself is subjected to.</p>
<div class="refsect3">
<a name="as-component-get-metadata-license.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-metadata-license.returns"></a><h4>Returns</h4>
<p> the license.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-metadata-license"></a><h3>as_component_set_metadata_license ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_metadata_license (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
<p>Set the license this metadata is licensed under.</p>
<div class="refsect3">
<a name="as-component-set-metadata-license.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the metadata license.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-project-license"></a><h3>as_component_get_project_license ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_project_license (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get the license of the project this component belongs to.</p>
<div class="refsect3">
<a name="as-component-get-project-license.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-project-license.returns"></a><h4>Returns</h4>
<p> the license.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-project-license"></a><h3>as_component_set_project_license ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_project_license (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
<p>Set the project license.</p>
<div class="refsect3">
<a name="as-component-set-project-license.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the project license.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-project-group"></a><h3>as_component_get_project_group ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_project_group (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get the component's project group.</p>
<div class="refsect3">
<a name="as-component-get-project-group.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-project-group.returns"></a><h4>Returns</h4>
<p> the project group.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-project-group"></a><h3>as_component_set_project_group ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_project_group (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
<p>Set the component's project group.</p>
<div class="refsect3">
<a name="as-component-set-project-group.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the project group.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-developer-name"></a><h3>as_component_get_developer_name ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_developer_name (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get the component's developer or development team name.</p>
<div class="refsect3">
<a name="as-component-get-developer-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-developer-name.returns"></a><h4>Returns</h4>
<p> the developer name.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-developer-name"></a><h3>as_component_set_developer_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_developer_name (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *locale</code></em>);</pre>
<p>Set the the component's developer or development team name.</p>
<div class="refsect3">
<a name="as-component-set-developer-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the developer or developer team name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>the locale, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. e.g. "en_GB". </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-compulsory-for-desktops"></a><h3>as_component_get_compulsory_for_desktops ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_compulsory_for_desktops
(<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-get-compulsory-for-desktops.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-compulsory-for-desktops.returns"></a><h4>Returns</h4>
<p>A list of desktops where this component is compulsory. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-compulsory-for-desktop"></a><h3>as_component_set_compulsory_for_desktop ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_compulsory_for_desktop
(<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *desktop</code></em>);</pre>
<p>Mark this component to be compulsory for the specified desktop environment.</p>
<div class="refsect3">
<a name="as-component-set-compulsory-for-desktop.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>desktop</p></td>
<td class="parameter_description"><p>The name of the desktop.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-is-compulsory-for-desktop"></a><h3>as_component_is_compulsory_for_desktop ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
as_component_is_compulsory_for_desktop
(<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *desktop</code></em>);</pre>
<p>Check if this component is compulsory for the given desktop.</p>
<div class="refsect3">
<a name="as-component-is-compulsory-for-desktop.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>desktop</p></td>
<td class="parameter_description"><p>the desktop-id to test for</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-is-compulsory-for-desktop.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if compulsory, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-categories"></a><h3>as_component_get_categories ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_categories (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-get-categories.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-categories.returns"></a><h4>Returns</h4>
<p>String array of categories. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-category"></a><h3>as_component_add_category ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_category (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category</code></em>);</pre>
<p>Add a category.</p>
<div class="refsect3">
<a name="as-component-add-category.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>category</p></td>
<td class="parameter_description"><p>the categories name to add.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-has-category"></a><h3>as_component_has_category ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
as_component_has_category (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category</code></em>);</pre>
<p>Check if component is in the specified category.</p>
<div class="refsect3">
<a name="as-component-has-category.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>category</p></td>
<td class="parameter_description"><p>the specified category to check</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-has-category.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the component is in the specified category.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-screenshots"></a><h3>as_component_get_screenshots ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_screenshots (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get a list of associated screenshots.</p>
<div class="refsect3">
<a name="as-component-get-screenshots.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-screenshots.returns"></a><h4>Returns</h4>
<p>an array of <a class="link" href="appstream-AsScreenshot.html#AsScreenshot" title="AsScreenshot"><span class="type">AsScreenshot</span></a> instances. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsScreenshot][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-screenshot"></a><h3>as_component_add_screenshot ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_screenshot (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsScreenshot.html#AsScreenshot" title="AsScreenshot"><span class="type">AsScreenshot</span></a> *sshot</code></em>);</pre>
<p>Add an <a class="link" href="appstream-AsScreenshot.html#AsScreenshot" title="AsScreenshot"><span class="type">AsScreenshot</span></a> to this component.</p>
<div class="refsect3">
<a name="as-component-add-screenshot.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>sshot</p></td>
<td class="parameter_description"><p>The <a class="link" href="appstream-AsScreenshot.html#AsScreenshot" title="AsScreenshot"><span class="type">AsScreenshot</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-keywords"></a><h3>as_component_get_keywords ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
as_component_get_keywords (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-get-keywords.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-keywords.returns"></a><h4>Returns</h4>
<p>String array of keywords. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-keywords"></a><h3>as_component_set_keywords ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_keywords (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *locale</code></em>);</pre>
<p>Set keywords for this component.</p>
<div class="refsect3">
<a name="as-component-set-keywords.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>String-array of keywords. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>Locale of the values, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use current locale. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-icons"></a><h3>as_component_get_icons ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_icons (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-get-icons.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-icons.returns"></a><h4>Returns</h4>
<p>A <a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> of all icons for this component. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsIcon][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-icon-by-size"></a><h3>as_component_get_icon_by_size ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsIcon.html#AsIcon" title="AsIcon"><span class="returnvalue">AsIcon</span></a> *
as_component_get_icon_by_size (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> width</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> height</code></em>);</pre>
<p>Gets an icon matching the size constraints.
The icons are not filtered by type, and the first icon
which matches the size is returned.
If you want more control over which icons you use for displaying,
use the <a class="link" href="appstream-AsComponent.html#as-component-get-icons" title="as_component_get_icons ()"><code class="literal">as_component_get_icons</code></a>() function to get a list of all icons.</p>
<p>Note that this function is not HiDPI aware! It will never return an icon with
a scaling factor > 1.</p>
<div class="refsect3">
<a name="as-component-get-icon-by-size.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>The icon width in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>the icon height in pixels.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-icon-by-size.returns"></a><h4>Returns</h4>
<p>An icon matching the given width/height, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not found. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-icon"></a><h3>as_component_add_icon ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_icon (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsIcon.html#AsIcon" title="AsIcon"><span class="type">AsIcon</span></a> *icon</code></em>);</pre>
<p>Add an icon to this component.</p>
<div class="refsect3">
<a name="as-component-add-icon.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon</p></td>
<td class="parameter_description"><p>the valid <a class="link" href="appstream-AsIcon.html#AsIcon" title="AsIcon"><span class="type">AsIcon</span></a> instance to add.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-provided"></a><h3>as_component_get_provided ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_provided (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get a list of <a class="link" href="appstream-AsProvided.html#AsProvided" title="AsProvided"><span class="type">AsProvided</span></a> objects associated with this component.</p>
<div class="refsect3">
<a name="as-component-get-provided.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-provided.returns"></a><h4>Returns</h4>
<p>A list of <a class="link" href="appstream-AsProvided.html#AsProvided" title="AsProvided"><span class="type">AsProvided</span></a> objects. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsProvided]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-provided"></a><h3>as_component_add_provided ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_provided (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsProvided.html#AsProvided" title="AsProvided"><span class="type">AsProvided</span></a> *prov</code></em>);</pre>
<p>Add a set of provided items to this component.</p>
<div class="refsect3">
<a name="as-component-add-provided.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>prov</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsProvided.html#AsProvided" title="AsProvided"><span class="type">AsProvided</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.6.2</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-provided-for-kind"></a><h3>as_component_get_provided_for_kind ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsProvided.html#AsProvided" title="AsProvided"><span class="returnvalue">AsProvided</span></a> *
as_component_get_provided_for_kind (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsProvided.html#AsProvidedKind" title="enum AsProvidedKind"><span class="type">AsProvidedKind</span></a> kind</code></em>);</pre>
<p>Get an <a class="link" href="appstream-AsProvided.html#AsProvided" title="AsProvided"><span class="type">AsProvided</span></a> object for the given interface type,
containing information about the public interfaces (mimetypes, firmware, DBus services, ...)
this component provides.</p>
<div class="refsect3">
<a name="as-component-get-provided-for-kind.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>kind</p></td>
<td class="parameter_description"><p>kind of the provided item, e.g. <a class="link" href="appstream-AsProvided.html#AS-PROVIDED-KIND-MIMETYPE:CAPS"><code class="literal">AS_PROVIDED_KIND_MIMETYPE</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-provided-for-kind.returns"></a><h4>Returns</h4>
<p><a class="link" href="appstream-AsProvided.html#AsProvided" title="AsProvided"><span class="type">AsProvided</span></a> containing the items this component provides, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-url"></a><h3>as_component_get_url ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_url (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-as-enums.html#AsUrlKind" title="enum AsUrlKind"><span class="type">AsUrlKind</span></a> url_kind</code></em>);</pre>
<p>Gets a URL.</p>
<div class="refsect3">
<a name="as-component-get-url.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>url_kind</p></td>
<td class="parameter_description"><p>the URL kind, e.g. <a class="link" href="appstream-as-enums.html#AS-URL-KIND-HOMEPAGE:CAPS"><code class="literal">AS_URL_KIND_HOMEPAGE</code></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-url.returns"></a><h4>Returns</h4>
<p>string, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if unset. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 0.6.2</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-url"></a><h3>as_component_add_url ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_url (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-as-enums.html#AsUrlKind" title="enum AsUrlKind"><span class="type">AsUrlKind</span></a> url_kind</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *url</code></em>);</pre>
<p>Adds some URL data to the component.</p>
<div class="refsect3">
<a name="as-component-add-url.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>url_kind</p></td>
<td class="parameter_description"><p>the URL kind, e.g. <a class="link" href="appstream-as-enums.html#AS-URL-KIND-HOMEPAGE:CAPS"><code class="literal">AS_URL_KIND_HOMEPAGE</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>url</p></td>
<td class="parameter_description"><p>the full URL.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.6.2</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-releases"></a><h3>as_component_get_releases ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_releases (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get an array of the <a class="link" href="appstream-AsRelease.html#AsRelease" title="AsRelease"><span class="type">AsRelease</span></a> items this component
provides.</p>
<div class="refsect3">
<a name="as-component-get-releases.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-releases.returns"></a><h4>Returns</h4>
<p>A list of releases. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsRelease][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-release"></a><h3>as_component_add_release ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_release (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsRelease.html#AsRelease" title="AsRelease"><span class="type">AsRelease</span></a> *release</code></em>);</pre>
<p>Add an <a class="link" href="appstream-AsRelease.html#AsRelease" title="AsRelease"><span class="type">AsRelease</span></a> to this component.</p>
<div class="refsect3">
<a name="as-component-add-release.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>release</p></td>
<td class="parameter_description"><p>The <a class="link" href="appstream-AsRelease.html#AsRelease" title="AsRelease"><span class="type">AsRelease</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-extends"></a><h3>as_component_get_extends ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_extends (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Returns a string list of IDs of components which
are extended by this addon.</p>
<p>See <a class="link" href="appstream-AsComponent.html#as-component-get-extends" title="as_component_get_extends ()"><code class="literal">as_component_get_extends</code></a>() for the reverse.</p>
<div class="refsect3">
<a name="as-component-get-extends.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-extends.returns"></a><h4>Returns</h4>
<p>A <a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not set. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 0.7.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-extends"></a><h3>as_component_add_extends ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_extends (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *cpt_id</code></em>);</pre>
<p>Add a reference to the extended component</p>
<div class="refsect3">
<a name="as-component-add-extends.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cpt_id</p></td>
<td class="parameter_description"><p>The id of a component which is extended by this component</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.7.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-addons"></a><h3>as_component_get_addons ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_addons (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Returns a list of <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> objects which
are addons extending this component in functionality.</p>
<p>This is the reverse of <a class="link" href="appstream-AsComponent.html#as-component-get-extends" title="as_component_get_extends ()"><code class="literal">as_component_get_extends</code></a>()</p>
<div class="refsect3">
<a name="as-component-get-addons.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-addons.returns"></a><h4>Returns</h4>
<p>An array of <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsComponent]</span></p>
</div>
<p class="since">Since: 0.9.2</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-addon"></a><h3>as_component_add_addon ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_addon (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *addon</code></em>);</pre>
<p>Add a reference to the addon that is enhancing this component.</p>
<div class="refsect3">
<a name="as-component-add-addon.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>addon</p></td>
<td class="parameter_description"><p>The <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> that extends <em class="parameter"><code>cpt</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.9.2</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-languages"></a><h3>as_component_get_languages ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
as_component_get_languages (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get a list of all languages.</p>
<div class="refsect3">
<a name="as-component-get-languages.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-languages.returns"></a><h4>Returns</h4>
<p>list of locales. </p>
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span></p>
</div>
<p class="since">Since: 0.7.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-language"></a><h3>as_component_get_language ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
as_component_get_language (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *locale</code></em>);</pre>
<p>Gets the translation coverage in percent for a specific locale</p>
<div class="refsect3">
<a name="as-component-get-language.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>the locale, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. e.g. "en_GB". </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-language.returns"></a><h4>Returns</h4>
<p> a percentage value, -1 if locale was not found</p>
</div>
<p class="since">Since: 0.7.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-language"></a><h3>as_component_add_language ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_language (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *locale</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> percentage</code></em>);</pre>
<p>Adds a language to the component.</p>
<div class="refsect3">
<a name="as-component-add-language.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>locale</p></td>
<td class="parameter_description"><p>the locale, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. e.g. "en_GB". </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>percentage</p></td>
<td class="parameter_description"><p>the percentage completion of the translation, 0 for locales with unknown amount of translation</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.7.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-translations"></a><h3>as_component_get_translations ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_translations (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get a <a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> of <a class="link" href="appstream-AsTranslation.html#AsTranslation" title="AsTranslation"><span class="type">AsTranslation</span></a> objects describing the
translation systems and translation-ids (e.g. Gettext domains) used
by this software component.</p>
<p>Only set for metainfo files.</p>
<div class="refsect3">
<a name="as-component-get-translations.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-translations.returns"></a><h4>Returns</h4>
<p>An array of <a class="link" href="appstream-AsTranslation.html#AsTranslation" title="AsTranslation"><span class="type">AsTranslation</span></a> objects. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsTranslation]</span></p>
</div>
<p class="since">Since: 0.9.2</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-translation"></a><h3>as_component_add_translation ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_translation (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsTranslation.html#AsTranslation" title="AsTranslation"><span class="type">AsTranslation</span></a> *tr</code></em>);</pre>
<p>Assign an <a class="link" href="appstream-AsTranslation.html#AsTranslation" title="AsTranslation"><span class="type">AsTranslation</span></a> object describing the translation system used
by this component.</p>
<div class="refsect3">
<a name="as-component-add-translation.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tr</p></td>
<td class="parameter_description"><p>an <a class="link" href="appstream-AsTranslation.html#AsTranslation" title="AsTranslation"><span class="type">AsTranslation</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.9.2</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-has-bundle"></a><h3>as_component_has_bundle ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
as_component_has_bundle (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-has-bundle.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-has-bundle.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if this component has a bundle associated.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-bundles"></a><h3>as_component_get_bundles ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_bundles (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get a list of all software bundles associated with this component.</p>
<div class="refsect3">
<a name="as-component-get-bundles.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-bundles.returns"></a><h4>Returns</h4>
<p>A list of <a class="link" href="appstream-AsBundle.html#AsBundle" title="AsBundle"><span class="type">AsBundle</span></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsBundle]</span></p>
</div>
<p class="since">Since: 0.10</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-bundle"></a><h3>as_component_get_bundle ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsBundle.html#AsBundle" title="AsBundle"><span class="returnvalue">AsBundle</span></a> *
as_component_get_bundle (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsBundle.html#AsBundleKind" title="enum AsBundleKind"><span class="type">AsBundleKind</span></a> bundle_kind</code></em>);</pre>
<p>Gets a bundle identifier string.</p>
<div class="refsect3">
<a name="as-component-get-bundle.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>bundle_kind</p></td>
<td class="parameter_description"><p>the bundle kind, e.g. <a class="link" href="appstream-AsBundle.html#AS-BUNDLE-KIND-LIMBA:CAPS"><code class="literal">AS_BUNDLE_KIND_LIMBA</code></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-bundle.returns"></a><h4>Returns</h4>
<p>An <a class="link" href="appstream-AsBundle.html#AsBundle" title="AsBundle"><span class="type">AsBundle</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not set. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 0.8.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-bundle"></a><h3>as_component_add_bundle ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_bundle (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsBundle.html#AsBundle" title="AsBundle"><span class="type">AsBundle</span></a> *bundle</code></em>);</pre>
<p>Adds a bundle to the component.</p>
<div class="refsect3">
<a name="as-component-add-bundle.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>bundle</p></td>
<td class="parameter_description"><p>The <a class="link" href="appstream-AsBundle.html#AsBundle" title="AsBundle"><span class="type">AsBundle</span></a> to add.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.8.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-suggested"></a><h3>as_component_get_suggested ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_suggested (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get a list of associated suggestions.</p>
<div class="refsect3">
<a name="as-component-get-suggested.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-suggested.returns"></a><h4>Returns</h4>
<p>an array of <a class="link" href="appstream-AsSuggested.html#AsSuggested" title="AsSuggested"><span class="type">AsSuggested</span></a> instances. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsSuggested]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-suggested"></a><h3>as_component_add_suggested ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_suggested (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsSuggested.html#AsSuggested" title="AsSuggested"><span class="type">AsSuggested</span></a> *suggested</code></em>);</pre>
<p>Add an <a class="link" href="appstream-AsSuggested.html#AsSuggested" title="AsSuggested"><span class="type">AsSuggested</span></a> to this component.</p>
<div class="refsect3">
<a name="as-component-add-suggested.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>suggested</p></td>
<td class="parameter_description"><p>The <a class="link" href="appstream-AsSuggested.html#AsSuggested" title="AsSuggested"><span class="type">AsSuggested</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-search-tokens"></a><h3>as_component_get_search_tokens ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_search_tokens (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Returns all search tokens for this component.</p>
<div class="refsect3">
<a name="as-component-get-search-tokens.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-search-tokens.returns"></a><h4>Returns</h4>
<p>The string search tokens. </p>
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8]</span></p>
</div>
<p class="since">Since: 0.9.7</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-search-matches"></a><h3>as_component_search_matches ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
as_component_search_matches (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *term</code></em>);</pre>
<p>Searches component data for a specific keyword.</p>
<div class="refsect3">
<a name="as-component-search-matches.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>term</p></td>
<td class="parameter_description"><p>the search term.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-search-matches.returns"></a><h4>Returns</h4>
<p> a match scrore, where 0 is no match and 100 is the best match.</p>
</div>
<p class="since">Since: 0.9.7</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-search-matches-all"></a><h3>as_component_search_matches_all ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
as_component_search_matches_all (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **terms</code></em>);</pre>
<p>Searches component data for all the specific keywords.</p>
<div class="refsect3">
<a name="as-component-search-matches-all.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>terms</p></td>
<td class="parameter_description"><p>the search terms.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-search-matches-all.returns"></a><h4>Returns</h4>
<p> a match score, where 0 is no match and larger numbers are better
matches.</p>
</div>
<p class="since">Since: 0.9.8</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-merge-kind"></a><h3>as_component_get_merge_kind ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="returnvalue">AsMergeKind</span></a>
as_component_get_merge_kind (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get the merge method which should apply to duplicate components
with this ID.</p>
<div class="refsect3">
<a name="as-component-get-merge-kind.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-merge-kind.returns"></a><h4>Returns</h4>
<p> the <a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="type">AsMergeKind</span></a> of this component.</p>
</div>
<p class="since">Since: 0.9.8</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-set-merge-kind"></a><h3>as_component_set_merge_kind ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_set_merge_kind (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="type">AsMergeKind</span></a> kind</code></em>);</pre>
<p>Sets the <a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="type">AsMergeKind</span></a> for this component.</p>
<div class="refsect3">
<a name="as-component-set-merge-kind.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>kind</p></td>
<td class="parameter_description"><p>the <a class="link" href="appstream-AsComponent.html#AsMergeKind" title="enum AsMergeKind"><span class="type">AsMergeKind</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.9.8</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-is-member-of-category"></a><h3>as_component_is_member_of_category ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
as_component_is_member_of_category (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsCategory.html#AsCategory" title="AsCategory"><span class="type">AsCategory</span></a> *category</code></em>);</pre>
<p>Test if the component <em class="parameter"><code>cpt</code></em>
is a member of category <em class="parameter"><code>category</code></em>
.</p>
<div class="refsect3">
<a name="as-component-is-member-of-category.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>category</p></td>
<td class="parameter_description"><p>The category to test.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-is-ignored"></a><h3>as_component_is_ignored ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
as_component_is_ignored (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-is-ignored.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-is-ignored.returns"></a><h4>Returns</h4>
<p> Whether this component's metadata should be ignored.</p>
</div>
<p class="since">Since: 0.10.2</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-is-valid"></a><h3>as_component_is_valid ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
as_component_is_valid (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Check if the essential properties of this Component are
populated with useful data.</p>
<div class="refsect3">
<a name="as-component-is-valid.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-is-valid.returns"></a><h4>Returns</h4>
<p> TRUE if the component data was validated successfully.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-to-string"></a><h3>as_component_to_string ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_to_string (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Returns a string identifying this component.
(useful for debugging)</p>
<div class="refsect3">
<a name="as-component-to-string.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-to-string.returns"></a><h4>Returns</h4>
<p>A descriptive string. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-custom"></a><h3>as_component_get_custom ()</h3>
<pre class="programlisting"><a href="../glib/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
as_component_get_custom (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="refsect3">
<a name="as-component-get-custom.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>An <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-custom.returns"></a><h4>Returns</h4>
<p>Hash table of custom user defined data fields. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 0.10.5</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-custom-value"></a><h3>as_component_get_custom_value ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_custom_value (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);</pre>
<p>Retrieve value for a custom data entry with the given key.</p>
<div class="refsect3">
<a name="as-component-get-custom-value.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>An <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>key</p></td>
<td class="parameter_description"><p>Field name.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.10.5</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-insert-custom-value"></a><h3>as_component_insert_custom_value ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
as_component_insert_custom_value (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
<p>Add a key and value pair to the custom data table.</p>
<div class="refsect3">
<a name="as-component-insert-custom-value.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>An <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>key</p></td>
<td class="parameter_description"><p>Key name.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>A string value.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-insert-custom-value.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the key did not exist yet.</p>
</div>
<p class="since">Since: 0.10.5</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-content-ratings"></a><h3>as_component_get_content_ratings ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_content_ratings (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Gets all content ratings defined for this software.</p>
<div class="refsect3">
<a name="as-component-get-content-ratings.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-content-ratings.returns"></a><h4>Returns</h4>
<p>an array. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsContentRating][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 0.11.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-content-rating"></a><h3>as_component_get_content_rating ()</h3>
<pre class="programlisting"><a class="link" href="appstream-AsContentRating.html#AsContentRating" title="AsContentRating"><span class="returnvalue">AsContentRating</span></a> *
as_component_get_content_rating (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *kind</code></em>);</pre>
<p>Gets a content ratings of a specific type that are defined for this component.</p>
<div class="refsect3">
<a name="as-component-get-content-rating.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>kind</p></td>
<td class="parameter_description"><p>a ratings kind, e.g. "oars-1.0"</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-content-rating.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="appstream-AsContentRating.html#AsContentRating" title="AsContentRating"><span class="type">AsContentRating</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not found. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 0.11.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-content-rating"></a><h3>as_component_add_content_rating ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_content_rating (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsContentRating.html#AsContentRating" title="AsContentRating"><span class="type">AsContentRating</span></a> *content_rating</code></em>);</pre>
<p>Adds a content rating to this component.</p>
<div class="refsect3">
<a name="as-component-add-content-rating.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>content_rating</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsContentRating.html#AsContentRating" title="AsContentRating"><span class="type">AsContentRating</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.11.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-recommends"></a><h3>as_component_get_recommends ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_recommends (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get an array of items that are recommended by this component.</p>
<div class="refsect3">
<a name="as-component-get-recommends.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-recommends.returns"></a><h4>Returns</h4>
<p>an array. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsRelation]</span></p>
</div>
<p class="since">Since: 0.12.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-requires"></a><h3>as_component_get_requires ()</h3>
<pre class="programlisting"><a href="../glib/glib-Pointer-Arrays.html#GPtrArray"><span class="returnvalue">GPtrArray</span></a> *
as_component_get_requires (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<p>Get an array of items that are required by this component.</p>
<div class="refsect3">
<a name="as-component-get-requires.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-requires.returns"></a><h4>Returns</h4>
<p>an array. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> AsRelation]</span></p>
</div>
<p class="since">Since: 0.12.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-relation"></a><h3>as_component_add_relation ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_relation (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><a class="link" href="appstream-AsRelation.html#AsRelation" title="AsRelation"><span class="type">AsRelation</span></a> *relation</code></em>);</pre>
<p>Adds a <a class="link" href="appstream-AsRelation.html#AsRelation" title="AsRelation"><span class="type">AsRelation</span></a> to set a recommends or requires relation of
component <em class="parameter"><code>cpt</code></em>
on the item mentioned in the <a class="link" href="appstream-AsRelation.html#AsRelation" title="AsRelation"><span class="type">AsRelation</span></a>.</p>
<div class="refsect3">
<a name="as-component-add-relation.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>relation</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsRelation.html#AsRelation" title="AsRelation"><span class="type">AsRelation</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.12.0</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-add-agreement"></a><h3>as_component_add_agreement ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
as_component_add_agreement (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><span class="type">AsAgreement</span> *agreement</code></em>);</pre>
<p>Adds an agreement to the software component.</p>
<div class="refsect3">
<a name="as-component-add-agreement.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>agreement</p></td>
<td class="parameter_description"><p>an <span class="type">AsAgreement</span> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 0.12.1</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-agreement-by-kind"></a><h3>as_component_get_agreement_by_kind ()</h3>
<pre class="programlisting"><span class="returnvalue">AsAgreement</span> *
as_component_get_agreement_by_kind (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>,
<em class="parameter"><code><span class="type">AsAgreementKind</span> kind</code></em>);</pre>
<p>Gets an agreement the component has specified for the particular kind.</p>
<div class="refsect3">
<a name="as-component-get-agreement-by-kind.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>kind</p></td>
<td class="parameter_description"><p>an agreement kind, e.g. <code class="literal">AS_AGREEMENT_KIND_EULA</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-agreement-by-kind.returns"></a><h4>Returns</h4>
<p>a <span class="type">AsAgreement</span> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for not found. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 0.12.1</p>
</div>
<hr>
<div class="refsect2">
<a name="as-component-get-desktop-id"></a><h3>as_component_get_desktop_id ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
as_component_get_desktop_id (<em class="parameter"><code><a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> *cpt</code></em>);</pre>
<div class="warning">
<p><code class="literal">as_component_get_desktop_id</code> has been deprecated since version 0.11.0 and should not be used in newly-written code.</p>
<p>Replaced by <a class="link" href="appstream-AsLaunchable.html#AsLaunchable" title="AsLaunchable"><span class="type">AsLaunchable</span></a> and <a class="link" href="appstream-AsComponent.html#as-component-get-launchable" title="as_component_get_launchable ()"><code class="literal">as_component_get_launchable</code></a></p>
</div>
<p>Get the Desktop Entry ID for this component, if it is
of type "desktop-application".
For most desktop-application components, this is the name
of the .desktop file.</p>
<p>Refer to https://specifications.freedesktop.org/desktop-entry-spec/latest/ape.html for more
information.</p>
<div class="refsect3">
<a name="as-component-get-desktop-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>cpt</p></td>
<td class="parameter_description"><p>a <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> instance.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="as-component-get-desktop-id.returns"></a><h4>Returns</h4>
<p> The desktop file id.</p>
</div>
<p class="since">Since: 0.9.8</p>
</div>
</div>
<div class="refsect1">
<a name="appstream-AsComponent.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="AS-TYPE-COMPONENT:CAPS"></a><h3>AS_TYPE_COMPONENT</h3>
<pre class="programlisting">#define AS_TYPE_COMPONENT (as_component_get_type ())
</pre>
</div>
<hr>
<div class="refsect2">
<a name="AsComponentClass"></a><h3>struct AsComponentClass</h3>
<pre class="programlisting">struct AsComponentClass {
GObjectClass parent_class;
};
</pre>
</div>
<hr>
<div class="refsect2">
<a name="AsComponentKind"></a><h3>enum AsComponentKind</h3>
<p>The type of an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a>.</p>
<div class="refsect3">
<a name="AsComponentKind.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-UNKNOWN:CAPS"></a>AS_COMPONENT_KIND_UNKNOWN</p></td>
<td class="enum_member_description">
<p>Type invalid or not known</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-GENERIC:CAPS"></a>AS_COMPONENT_KIND_GENERIC</p></td>
<td class="enum_member_description">
<p>A generic (= without specialized type) component</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-DESKTOP-APP:CAPS"></a>AS_COMPONENT_KIND_DESKTOP_APP</p></td>
<td class="enum_member_description">
<p>An application with a .desktop-file</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-CONSOLE-APP:CAPS"></a>AS_COMPONENT_KIND_CONSOLE_APP</p></td>
<td class="enum_member_description">
<p>A console application</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-WEB-APP:CAPS"></a>AS_COMPONENT_KIND_WEB_APP</p></td>
<td class="enum_member_description">
<p>A web application</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-ADDON:CAPS"></a>AS_COMPONENT_KIND_ADDON</p></td>
<td class="enum_member_description">
<p>An extension of existing software, which does not run standalone</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-FONT:CAPS"></a>AS_COMPONENT_KIND_FONT</p></td>
<td class="enum_member_description">
<p>A font</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-CODEC:CAPS"></a>AS_COMPONENT_KIND_CODEC</p></td>
<td class="enum_member_description">
<p>A multimedia codec</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-INPUTMETHOD:CAPS"></a>AS_COMPONENT_KIND_INPUTMETHOD</p></td>
<td class="enum_member_description">
<p>An input-method provider</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-FIRMWARE:CAPS"></a>AS_COMPONENT_KIND_FIRMWARE</p></td>
<td class="enum_member_description">
<p>Firmware</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-DRIVER:CAPS"></a>AS_COMPONENT_KIND_DRIVER</p></td>
<td class="enum_member_description">
<p>A driver</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-LOCALIZATION:CAPS"></a>AS_COMPONENT_KIND_LOCALIZATION</p></td>
<td class="enum_member_description">
<p>Software localization (usually l10n resources)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-SERVICE:CAPS"></a>AS_COMPONENT_KIND_SERVICE</p></td>
<td> </td>
<td> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-REPOSITORY:CAPS"></a>AS_COMPONENT_KIND_REPOSITORY</p></td>
<td class="enum_member_description">
<p>A remote software or data source</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-KIND-OPERATING-SYSTEM:CAPS"></a>AS_COMPONENT_KIND_OPERATING_SYSTEM</p></td>
<td class="enum_member_description">
<p>A computer operating system</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="AsMergeKind"></a><h3>enum AsMergeKind</h3>
<p>Defines how <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> data should be merged if the component is
set for merge.</p>
<div class="refsect3">
<a name="AsMergeKind.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="AS-MERGE-KIND-NONE:CAPS"></a>AS_MERGE_KIND_NONE</p></td>
<td class="enum_member_description">
<p>No merge is happening.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-MERGE-KIND-REPLACE:CAPS"></a>AS_MERGE_KIND_REPLACE</p></td>
<td class="enum_member_description">
<p>Merge replacing data of target.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-MERGE-KIND-APPEND:CAPS"></a>AS_MERGE_KIND_APPEND</p></td>
<td class="enum_member_description">
<p>Merge appending data to target.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-MERGE-KIND-REMOVE-COMPONENT:CAPS"></a>AS_MERGE_KIND_REMOVE_COMPONENT</p></td>
<td class="enum_member_description">
<p>Remove the entire component if it matches.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="AsComponentScope"></a><h3>enum AsComponentScope</h3>
<p>Scope of the <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> (system-wide or user-scope)</p>
<div class="refsect3">
<a name="AsComponentScope.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-SCOPE-UNKNOWN:CAPS"></a>AS_COMPONENT_SCOPE_UNKNOWN</p></td>
<td class="enum_member_description">
<p>Unknown scope</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-SCOPE-SYSTEM:CAPS"></a>AS_COMPONENT_SCOPE_SYSTEM</p></td>
<td class="enum_member_description">
<p>System scope</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-COMPONENT-SCOPE-USER:CAPS"></a>AS_COMPONENT_SCOPE_USER</p></td>
<td class="enum_member_description">
<p>User scope</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="AsValueFlags"></a><h3>enum AsValueFlags</h3>
<p>Set how values assigned to an <a class="link" href="appstream-AsComponent.html#AsComponent" title="AsComponent"><span class="type">AsComponent</span></a> should be treated when
they are set or retrieved.</p>
<div class="refsect3">
<a name="AsValueFlags.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="AS-VALUE-FLAG-NONE:CAPS"></a>AS_VALUE_FLAG_NONE</p></td>
<td class="enum_member_description">
<p>No flags.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-VALUE-FLAG-DUPLICATE-CHECK:CAPS"></a>AS_VALUE_FLAG_DUPLICATE_CHECK</p></td>
<td class="enum_member_description">
<p>Check for duplicates when adding items to list values.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="AS-VALUE-FLAG-NO-TRANSLATION-FALLBACK:CAPS"></a>AS_VALUE_FLAG_NO_TRANSLATION_FALLBACK</p></td>
<td class="enum_member_description">
<p>Don't fall back to C when retrieving translated values.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="AsComponent"></a><h3>AsComponent</h3>
<pre class="programlisting">typedef struct _AsComponent AsComponent;</pre>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.29</div>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-release
>
by-pkgid
>
b2f9b918f77869ef06d628d228e08893
>
files
>
146
