wearable/docs/gst/html/gstreamer-GstStructure.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>GstStructure</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GStreamer 0.10 Core Reference Manual">
   8 <link rel="up" href="libgstreamer.html" title="GStreamer Core Library">
   9 <link rel="prev" href="gstreamer-GstSegment.html" title="GstSegment">
  10 <link rel="next" href="GstSystemClock.html" title="GstSystemClock">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="gstreamer-GstSegment.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="libgstreamer.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GStreamer 0.10 Core Reference Manual</th>
  21 <td><a accesskey="n" href="GstSystemClock.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#gstreamer-GstStructure.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gstreamer-GstStructure.description" class="shortcut">Description</a>
  27 </td></tr>
  28 </table>
  29 <div class="refentry">
  30 <a name="gstreamer-GstStructure"></a><div class="titlepage"></div>
  31 <div class="refnamediv"><table width="100%"><tr>
  32 <td valign="top">
  33 <h2><span class="refentrytitle"><a name="gstreamer-GstStructure.top_of_page"></a>GstStructure</span></h2>
  34 <p>GstStructure — Generic structure containing fields of names and values</p>
  35 </td>
  36 <td valign="top" align="right"></td>
  37 </tr></table></div>
  38 <div class="refsynopsisdiv">
  39 <a name="gstreamer-GstStructure.synopsis"></a><h2>Synopsis</h2>
  40 <pre class="synopsis">
  41 #include &lt;gst/gst.h&gt;
  42
  43 struct              <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure">GstStructure</a>;
  44 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="gstreamer-GstStructure.html#GstStructureForeachFunc" title="GstStructureForeachFunc ()">*GstStructureForeachFunc</a>)          (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field_id</code></em>,
  45                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
  46                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
  47 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (<a class="link" href="gstreamer-GstStructure.html#GstStructureMapFunc" title="GstStructureMapFunc ()">*GstStructureMapFunc</a>)              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field_id</code></em>,
  48                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
  49                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
  50 <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      <a class="link" href="gstreamer-GstStructure.html#gst-structure-empty-new" title="gst_structure_empty_new ()">gst_structure_empty_new</a>             (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  51 <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-empty-new" title="gst_structure_id_empty_new ()">gst_structure_id_empty_new</a>          (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> quark</code></em>);
  52 <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      <a class="link" href="gstreamer-GstStructure.html#gst-structure-new" title="gst_structure_new ()">gst_structure_new</a>                   (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
  53                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *firstfield</code></em>,
  54                                                          <em class="parameter"><code>...</code></em>);
  55 <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      <a class="link" href="gstreamer-GstStructure.html#gst-structure-new-valist" title="gst_structure_new_valist ()">gst_structure_new_valist</a>            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
  56                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *firstfield</code></em>,
  57                                                          <em class="parameter"><code><span class="type">va_list</span> varargs</code></em>);
  58 <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-new" title="gst_structure_id_new ()">gst_structure_id_new</a>                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> name_quark</code></em>,
  59                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field_quark</code></em>,
  60                                                          <em class="parameter"><code>...</code></em>);
  61 <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      <a class="link" href="gstreamer-GstStructure.html#gst-structure-copy" title="gst_structure_copy ()">gst_structure_copy</a>                  (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);
  62 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-free" title="gst_structure_free ()">gst_structure_free</a>                  (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);
  63 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-name" title="gst_structure_get_name ()">gst_structure_get_name</a>              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);
  64 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-has-name" title="gst_structure_has_name ()">gst_structure_has_name</a>              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  65                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  66 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-set-name" title="gst_structure_set_name ()">gst_structure_set_name</a>              (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  67                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  68 <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a>              <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-name-id" title="gst_structure_get_name_id ()">gst_structure_get_name_id</a>           (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);
  69 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-get" title="gst_structure_id_get ()">gst_structure_id_get</a>                (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  70                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> first_field_id</code></em>,
  71                                                          <em class="parameter"><code>...</code></em>);
  72 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-get-valist" title="gst_structure_id_get_valist ()">gst_structure_id_get_valist</a>         (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  73                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> first_field_id</code></em>,
  74                                                          <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
  75 const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-get-value" title="gst_structure_id_get_value ()">gst_structure_id_get_value</a>          (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  76                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field</code></em>);
  77 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-set-value" title="gst_structure_id_set_value ()">gst_structure_id_set_value</a>          (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  78                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field</code></em>,
  79                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
  80 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-take-value" title="gst_structure_id_take_value ()">gst_structure_id_take_value</a>         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  81                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field</code></em>,
  82                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
  83 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get" title="gst_structure_get ()">gst_structure_get</a>                   (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  84                                                          <em class="parameter"><code>const <span class="type">char</span> *first_fieldname</code></em>,
  85                                                          <em class="parameter"><code>...</code></em>);
  86 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-valist" title="gst_structure_get_valist ()">gst_structure_get_valist</a>            (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  87                                                          <em class="parameter"><code>const <span class="type">char</span> *first_fieldname</code></em>,
  88                                                          <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
  89 const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-value" title="gst_structure_get_value ()">gst_structure_get_value</a>             (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  90                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>);
  91 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-set-value" title="gst_structure_set_value ()">gst_structure_set_value</a>             (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  92                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
  93                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
  94 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-take-value" title="gst_structure_take_value ()">gst_structure_take_value</a>            (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  95                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
  96                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
  97 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-set" title="gst_structure_set ()">gst_structure_set</a>                   (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
  98                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
  99                                                          <em class="parameter"><code>...</code></em>);
 100 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-set-valist" title="gst_structure_set_valist ()">gst_structure_set_valist</a>            (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 101                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 102                                                          <em class="parameter"><code><span class="type">va_list</span> varargs</code></em>);
 103 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-set" title="gst_structure_id_set ()">gst_structure_id_set</a>                (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 104                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> fieldname</code></em>,
 105                                                          <em class="parameter"><code>...</code></em>);
 106 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-set-valist" title="gst_structure_id_set_valist ()">gst_structure_id_set_valist</a>         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 107                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> fieldname</code></em>,
 108                                                          <em class="parameter"><code><span class="type">va_list</span> varargs</code></em>);
 109 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-remove-field" title="gst_structure_remove_field ()">gst_structure_remove_field</a>          (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 110                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>);
 111 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-remove-fields" title="gst_structure_remove_fields ()">gst_structure_remove_fields</a>         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 112                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 113                                                          <em class="parameter"><code>...</code></em>);
 114 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-remove-fields-valist" title="gst_structure_remove_fields_valist ()">gst_structure_remove_fields_valist</a>  (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 115                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 116                                                          <em class="parameter"><code><span class="type">va_list</span> varargs</code></em>);
 117 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-remove-all-fields" title="gst_structure_remove_all_fields ()">gst_structure_remove_all_fields</a>     (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);
 118 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>               <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-field-type" title="gst_structure_get_field_type ()">gst_structure_get_field_type</a>        (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 119                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>);
 120 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-foreach" title="gst_structure_foreach ()">gst_structure_foreach</a>               (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 121                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructureForeachFunc" title="GstStructureForeachFunc ()"><span class="type">GstStructureForeachFunc</span></a> func</code></em>,
 122                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 123 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-n-fields" title="gst_structure_n_fields ()">gst_structure_n_fields</a>              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);
 124 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-has-field" title="gst_structure_has_field ()">gst_structure_has_field</a>             (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 125                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>);
 126 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-has-field-typed" title="gst_structure_has_field_typed ()">gst_structure_has_field_typed</a>       (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 127                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 128                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>);
 129 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-is-equal" title="gst_structure_is_equal ()">gst_structure_is_equal</a>              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure1</code></em>,
 130                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure2</code></em>);
 131 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-is-subset" title="gst_structure_is_subset ()">gst_structure_is_subset</a>             (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *subset</code></em>,
 132                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *superset</code></em>);
 133 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-can-intersect" title="gst_structure_can_intersect ()">gst_structure_can_intersect</a>         (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *struct1</code></em>,
 134                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *struct2</code></em>);
 135 <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      <a class="link" href="gstreamer-GstStructure.html#gst-structure-intersect" title="gst_structure_intersect ()">gst_structure_intersect</a>             (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *struct1</code></em>,
 136                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *struct2</code></em>);
 137 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-has-field" title="gst_structure_id_has_field ()">gst_structure_id_has_field</a>          (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 138                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field</code></em>);
 139 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-has-field-typed" title="gst_structure_id_has_field_typed ()">gst_structure_id_has_field_typed</a>    (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 140                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field</code></em>,
 141                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>);
 142 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-boolean" title="gst_structure_get_boolean ()">gst_structure_get_boolean</a>           (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 143                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 144                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);
 145 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-int" title="gst_structure_get_int ()">gst_structure_get_int</a>               (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 146                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 147                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value</code></em>);
 148 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-uint" title="gst_structure_get_uint ()">gst_structure_get_uint</a>              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 149                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 150                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *value</code></em>);
 151 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-fourcc" title="gst_structure_get_fourcc ()">gst_structure_get_fourcc</a>            (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 152                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 153                                                          <em class="parameter"><code><span class="type">guint32</span> *value</code></em>);
 154 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-double" title="gst_structure_get_double ()">gst_structure_get_double</a>            (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 155                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 156                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *value</code></em>);
 157 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-string" title="gst_structure_get_string ()">gst_structure_get_string</a>            (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 158                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>);
 159 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-date" title="gst_structure_get_date ()">gst_structure_get_date</a>              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 160                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 161                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> **value</code></em>);
 162 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-date-time" title="gst_structure_get_date_time ()">gst_structure_get_date_time</a>         (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 163                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 164                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstDateTime.html#GstDateTime" title="GstDateTime"><span class="type">GstDateTime</span></a> **value</code></em>);
 165 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-clock-time" title="gst_structure_get_clock_time ()">gst_structure_get_clock_time</a>        (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 166                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 167                                                          <em class="parameter"><code><a class="link" href="GstClock.html#GstClockTime" title="GstClockTime"><span class="type">GstClockTime</span></a> *value</code></em>);
 168 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-enum" title="gst_structure_get_enum ()">gst_structure_get_enum</a>              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 169                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 170                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> enumtype</code></em>,
 171                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value</code></em>);
 172 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-fraction" title="gst_structure_get_fraction ()">gst_structure_get_fraction</a>          (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 173                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 174                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value_numerator</code></em>,
 175                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value_denominator</code></em>);
 176 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-map-in-place" title="gst_structure_map_in_place ()">gst_structure_map_in_place</a>          (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 177                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructureMapFunc" title="GstStructureMapFunc ()"><span class="type">GstStructureMapFunc</span></a> func</code></em>,
 178                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 179 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gstreamer-GstStructure.html#gst-structure-nth-field-name" title="gst_structure_nth_field_name ()">gst_structure_nth_field_name</a>        (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 180                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);
 181 <span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstStructure.html#gst-structure-set-parent-refcount" title="gst_structure_set_parent_refcount ()">gst_structure_set_parent_refcount</a>   (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 182                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *refcount</code></em>);
 183 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="gstreamer-GstStructure.html#gst-structure-to-string" title="gst_structure_to_string ()">gst_structure_to_string</a>             (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);
 184 <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      <a class="link" href="gstreamer-GstStructure.html#gst-structure-from-string" title="gst_structure_from_string ()">gst_structure_from_string</a>           (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>,
 185                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **end</code></em>);
 186 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-fixate-field-nearest-int" title="gst_structure_fixate_field_nearest_int ()">gst_structure_fixate_field_nearest_int</a>
 187                                                         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 188                                                          <em class="parameter"><code>const <span class="type">char</span> *field_name</code></em>,
 189                                                          <em class="parameter"><code><span class="type">int</span> target</code></em>);
 190 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-fixate-field-nearest-double" title="gst_structure_fixate_field_nearest_double ()">gst_structure_fixate_field_nearest_double</a>
 191                                                         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 192                                                          <em class="parameter"><code>const <span class="type">char</span> *field_name</code></em>,
 193                                                          <em class="parameter"><code><span class="type">double</span> target</code></em>);
 194 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-fixate-field-nearest-fraction" title="gst_structure_fixate_field_nearest_fraction ()">gst_structure_fixate_field_nearest_fraction</a>
 195                                                         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 196                                                          <em class="parameter"><code>const <span class="type">char</span> *field_name</code></em>,
 197                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> target_numerator</code></em>,
 198                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> target_denominator</code></em>);
 199 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-fixate-field-boolean" title="gst_structure_fixate_field_boolean ()">gst_structure_fixate_field_boolean</a>  (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 200                                                          <em class="parameter"><code>const <span class="type">char</span> *field_name</code></em>,
 201                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> target</code></em>);
 202 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstStructure.html#gst-structure-fixate-field-string" title="gst_structure_fixate_field_string ()">gst_structure_fixate_field_string</a>   (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 203                                                          <em class="parameter"><code>const <span class="type">char</span> *field_name</code></em>,
 204                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *target</code></em>);
 205 </pre>
 206 </div>
 207 <div class="refsect1">
 208 <a name="gstreamer-GstStructure.description"></a><h2>Description</h2>
 209 <p>
 210 A <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> is a collection of key/value pairs. The keys are expressed
 211 as GQuarks and the values can be of any GType.
 212 </p>
 213 <p>
 214 In addition to the key/value pairs, a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> also has a name. The name
 215 starts with a letter and can be folled by letters, numbers and any of "/-_.:".
 216 </p>
 217 <p>
 218 <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> is used by various GStreamer subsystems to store information
 219 in a flexible and extensible way. A <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> does not have a refcount
 220 because it usually is part of a higher level object such as <a class="link" href="gstreamer-GstCaps.html#GstCaps" title="struct GstCaps"><span class="type">GstCaps</span></a>. It
 221 provides a means to enforce mutability using the refcount of the parent
 222 with the <a class="link" href="gstreamer-GstStructure.html#gst-structure-set-parent-refcount" title="gst_structure_set_parent_refcount ()"><code class="function">gst_structure_set_parent_refcount()</code></a> method.
 223 </p>
 224 <p>
 225 A <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> can be created with <a class="link" href="gstreamer-GstStructure.html#gst-structure-empty-new" title="gst_structure_empty_new ()"><code class="function">gst_structure_empty_new()</code></a> or
 226 <a class="link" href="gstreamer-GstStructure.html#gst-structure-new" title="gst_structure_new ()"><code class="function">gst_structure_new()</code></a>, which both take a name and an optional set of
 227 key/value pairs along with the types of the values.
 228 </p>
 229 <p>
 230 Field values can be changed with <a class="link" href="gstreamer-GstStructure.html#gst-structure-set-value" title="gst_structure_set_value ()"><code class="function">gst_structure_set_value()</code></a> or
 231 <a class="link" href="gstreamer-GstStructure.html#gst-structure-set" title="gst_structure_set ()"><code class="function">gst_structure_set()</code></a>.
 232 </p>
 233 <p>
 234 Field values can be retrieved with <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-value" title="gst_structure_get_value ()"><code class="function">gst_structure_get_value()</code></a> or the more
 235 convenient gst_structure_get_*() functions.
 236 </p>
 237 <p>
 238 Fields can be removed with <a class="link" href="gstreamer-GstStructure.html#gst-structure-remove-field" title="gst_structure_remove_field ()"><code class="function">gst_structure_remove_field()</code></a> or
 239 <a class="link" href="gstreamer-GstStructure.html#gst-structure-remove-fields" title="gst_structure_remove_fields ()"><code class="function">gst_structure_remove_fields()</code></a>.
 240 </p>
 241 <p>
 242 Strings in structures must be ASCII or UTF-8 encoded. Other encodings are
 243 not allowed. Strings must not be empty either, but may be NULL.
 244 </p>
 245 <p>
 246 Last reviewed on 2009-06-08 (0.10.23)
 247 </p>
 248 </div>
 249 <div class="refsect1">
 250 <a name="gstreamer-GstStructure.details"></a><h2>Details</h2>
 251 <div class="refsect2">
 252 <a name="GstStructure"></a><h3>struct GstStructure</h3>
 253 <pre class="programlisting">struct GstStructure {
 254   GType type;
 255 };
 256 </pre>
 257 <p>
 258 The GstStructure object. Most fields are private.
 259 </p>
 260 <div class="variablelist"><table border="0">
 261 <col align="left" valign="top">
 262 <tbody><tr>
 263 <td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="GstStructure.type"></a>type</code></em>;</span></p></td>
 264 <td>the GType of a structure</td>
 265 </tr></tbody>
 266 </table></div>
 267 </div>
 268 <hr>
 269 <div class="refsect2">
 270 <a name="GstStructureForeachFunc"></a><h3>GstStructureForeachFunc ()</h3>
 271 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*GstStructureForeachFunc)          (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field_id</code></em>,
 272                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
 273                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 274 <p>
 275 A function that will be called in <a class="link" href="gstreamer-GstStructure.html#gst-structure-foreach" title="gst_structure_foreach ()"><code class="function">gst_structure_foreach()</code></a>. The function may
 276 not modify <em class="parameter"><code>value</code></em>.
 277 </p>
 278 <div class="variablelist"><table border="0">
 279 <col align="left" valign="top">
 280 <tbody>
 281 <tr>
 282 <td><p><span class="term"><em class="parameter"><code>field_id</code></em> :</span></p></td>
 283 <td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> of the field name</td>
 284 </tr>
 285 <tr>
 286 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 287 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of the field</td>
 288 </tr>
 289 <tr>
 290 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 291 <td>user data</td>
 292 </tr>
 293 <tr>
 294 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 295 <td>TRUE if the foreach operation should continue, FALSE if
 296 the foreach operation should stop with FALSE.</td>
 297 </tr>
 298 </tbody>
 299 </table></div>
 300 </div>
 301 <hr>
 302 <div class="refsect2">
 303 <a name="GstStructureMapFunc"></a><h3>GstStructureMapFunc ()</h3>
 304 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            (*GstStructureMapFunc)              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field_id</code></em>,
 305                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>,
 306                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 307 <p>
 308 A function that will be called in <a class="link" href="gstreamer-GstStructure.html#gst-structure-map-in-place" title="gst_structure_map_in_place ()"><code class="function">gst_structure_map_in_place()</code></a>. The function
 309 may modify <em class="parameter"><code>value</code></em>.
 310 </p>
 311 <div class="variablelist"><table border="0">
 312 <col align="left" valign="top">
 313 <tbody>
 314 <tr>
 315 <td><p><span class="term"><em class="parameter"><code>field_id</code></em> :</span></p></td>
 316 <td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> of the field name</td>
 317 </tr>
 318 <tr>
 319 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 320 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of the field</td>
 321 </tr>
 322 <tr>
 323 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 324 <td>user data</td>
 325 </tr>
 326 <tr>
 327 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 328 <td>TRUE if the map operation should continue, FALSE if
 329 the map operation should stop with FALSE.</td>
 330 </tr>
 331 </tbody>
 332 </table></div>
 333 </div>
 334 <hr>
 335 <div class="refsect2">
 336 <a name="gst-structure-empty-new"></a><h3>gst_structure_empty_new ()</h3>
 337 <pre class="programlisting"><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      gst_structure_empty_new             (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 338 <p>
 339 Creates a new, empty <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> with the given <em class="parameter"><code>name</code></em>.
 340 </p>
 341 <p>
 342 See <a class="link" href="gstreamer-GstStructure.html#gst-structure-set-name" title="gst_structure_set_name ()"><code class="function">gst_structure_set_name()</code></a> for constraints on the <em class="parameter"><code>name</code></em> parameter.
 343 </p>
 344 <p>
 345 Free-function: gst_structure_free
 346 </p>
 347 <div class="variablelist"><table border="0">
 348 <col align="left" valign="top">
 349 <tbody>
 350 <tr>
 351 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 352 <td>name of new structure</td>
 353 </tr>
 354 <tr>
 355 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 356 <td>a new, empty <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 357 </td>
 358 </tr>
 359 </tbody>
 360 </table></div>
 361 </div>
 362 <hr>
 363 <div class="refsect2">
 364 <a name="gst-structure-id-empty-new"></a><h3>gst_structure_id_empty_new ()</h3>
 365 <pre class="programlisting"><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      gst_structure_id_empty_new          (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> quark</code></em>);</pre>
 366 <p>
 367 Creates a new, empty <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> with the given name as a GQuark.
 368 </p>
 369 <p>
 370 Free-function: gst_structure_free
 371 </p>
 372 <div class="variablelist"><table border="0">
 373 <col align="left" valign="top">
 374 <tbody>
 375 <tr>
 376 <td><p><span class="term"><em class="parameter"><code>quark</code></em> :</span></p></td>
 377 <td>name of new structure</td>
 378 </tr>
 379 <tr>
 380 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 381 <td>a new, empty <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 382 </td>
 383 </tr>
 384 </tbody>
 385 </table></div>
 386 </div>
 387 <hr>
 388 <div class="refsect2">
 389 <a name="gst-structure-new"></a><h3>gst_structure_new ()</h3>
 390 <pre class="programlisting"><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      gst_structure_new                   (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 391                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *firstfield</code></em>,
 392                                                          <em class="parameter"><code>...</code></em>);</pre>
 393 <p>
 394 Creates a new <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> with the given name.  Parses the
 395 list of variable arguments and sets fields to the values listed.
 396 Variable arguments should be passed as field name, field type,
 397 and value.  Last variable argument should be NULL.
 398 </p>
 399 <p>
 400 Free-function: gst_structure_free
 401 </p>
 402 <div class="variablelist"><table border="0">
 403 <col align="left" valign="top">
 404 <tbody>
 405 <tr>
 406 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 407 <td>name of new structure</td>
 408 </tr>
 409 <tr>
 410 <td><p><span class="term"><em class="parameter"><code>firstfield</code></em> :</span></p></td>
 411 <td>name of first field to set</td>
 412 </tr>
 413 <tr>
 414 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
 415 <td>additional arguments</td>
 416 </tr>
 417 <tr>
 418 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 419 <td>a new <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 420 </td>
 421 </tr>
 422 </tbody>
 423 </table></div>
 424 </div>
 425 <hr>
 426 <div class="refsect2">
 427 <a name="gst-structure-new-valist"></a><h3>gst_structure_new_valist ()</h3>
 428 <pre class="programlisting"><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      gst_structure_new_valist            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
 429                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *firstfield</code></em>,
 430                                                          <em class="parameter"><code><span class="type">va_list</span> varargs</code></em>);</pre>
 431 <p>
 432 Creates a new <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> with the given <em class="parameter"><code>name</code></em>.  Structure fields
 433 are set according to the varargs in a manner similar to
 434 <a class="link" href="gstreamer-GstStructure.html#gst-structure-new" title="gst_structure_new ()"><code class="function">gst_structure_new()</code></a>.
 435 </p>
 436 <p>
 437 See <a class="link" href="gstreamer-GstStructure.html#gst-structure-set-name" title="gst_structure_set_name ()"><code class="function">gst_structure_set_name()</code></a> for constraints on the <em class="parameter"><code>name</code></em> parameter.
 438 </p>
 439 <p>
 440 Free-function: gst_structure_free
 441 </p>
 442 <div class="variablelist"><table border="0">
 443 <col align="left" valign="top">
 444 <tbody>
 445 <tr>
 446 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 447 <td>name of new structure</td>
 448 </tr>
 449 <tr>
 450 <td><p><span class="term"><em class="parameter"><code>firstfield</code></em> :</span></p></td>
 451 <td>name of first field to set</td>
 452 </tr>
 453 <tr>
 454 <td><p><span class="term"><em class="parameter"><code>varargs</code></em> :</span></p></td>
 455 <td>variable argument list</td>
 456 </tr>
 457 <tr>
 458 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 459 <td>a new <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 460 </td>
 461 </tr>
 462 </tbody>
 463 </table></div>
 464 </div>
 465 <hr>
 466 <div class="refsect2">
 467 <a name="gst-structure-id-new"></a><h3>gst_structure_id_new ()</h3>
 468 <pre class="programlisting"><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      gst_structure_id_new                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> name_quark</code></em>,
 469                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field_quark</code></em>,
 470                                                          <em class="parameter"><code>...</code></em>);</pre>
 471 <p>
 472 Creates a new <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> with the given name as a GQuark, followed by
 473 fieldname quark, GType, argument(s) "triplets" in the same format as
 474 <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-set" title="gst_structure_id_set ()"><code class="function">gst_structure_id_set()</code></a>. Basically a convenience wrapper around
 475 <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-empty-new" title="gst_structure_id_empty_new ()"><code class="function">gst_structure_id_empty_new()</code></a> and <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-set" title="gst_structure_id_set ()"><code class="function">gst_structure_id_set()</code></a>.
 476 </p>
 477 <p>
 478 The last variable argument must be NULL (or 0).
 479 </p>
 480 <p>
 481 Free-function: gst_structure_free
 482 </p>
 483 <div class="variablelist"><table border="0">
 484 <col align="left" valign="top">
 485 <tbody>
 486 <tr>
 487 <td><p><span class="term"><em class="parameter"><code>name_quark</code></em> :</span></p></td>
 488 <td>name of new structure</td>
 489 </tr>
 490 <tr>
 491 <td><p><span class="term"><em class="parameter"><code>field_quark</code></em> :</span></p></td>
 492 <td>the GQuark for the name of the field to set</td>
 493 </tr>
 494 <tr>
 495 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
 496 <td>variable arguments</td>
 497 </tr>
 498 <tr>
 499 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 500 <td>a new <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 501 </td>
 502 </tr>
 503 </tbody>
 504 </table></div>
 505 <p class="since">Since 0.10.24</p>
 506 </div>
 507 <hr>
 508 <div class="refsect2">
 509 <a name="gst-structure-copy"></a><h3>gst_structure_copy ()</h3>
 510 <pre class="programlisting"><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      gst_structure_copy                  (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);</pre>
 511 <p>
 512 Duplicates a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> and all its fields and values.
 513 </p>
 514 <p>
 515 Free-function: gst_structure_free
 516 </p>
 517 <div class="variablelist"><table border="0">
 518 <col align="left" valign="top">
 519 <tbody>
 520 <tr>
 521 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 522 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> to duplicate</td>
 523 </tr>
 524 <tr>
 525 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 526 <td>a new <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 527 </td>
 528 </tr>
 529 </tbody>
 530 </table></div>
 531 </div>
 532 <hr>
 533 <div class="refsect2">
 534 <a name="gst-structure-free"></a><h3>gst_structure_free ()</h3>
 535 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_free                  (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);</pre>
 536 <p>
 537 Frees a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> and all its fields and values. The structure must not
 538 have a parent when this function is called.
 539 </p>
 540 <div class="variablelist"><table border="0">
 541 <col align="left" valign="top">
 542 <tbody><tr>
 543 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 544 <td>the <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> to free. <span class="annotation">[<acronym title="Parameter for input. Default is transfer none."><span class="acronym">in</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 545 </td>
 546 </tr></tbody>
 547 </table></div>
 548 </div>
 549 <hr>
 550 <div class="refsect2">
 551 <a name="gst-structure-get-name"></a><h3>gst_structure_get_name ()</h3>
 552 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_structure_get_name              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);</pre>
 553 <p>
 554 Get the name of <em class="parameter"><code>structure</code></em> as a string.
 555 </p>
 556 <div class="variablelist"><table border="0">
 557 <col align="left" valign="top">
 558 <tbody>
 559 <tr>
 560 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 561 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 562 </td>
 563 </tr>
 564 <tr>
 565 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 566 <td>the name of the structure.</td>
 567 </tr>
 568 </tbody>
 569 </table></div>
 570 </div>
 571 <hr>
 572 <div class="refsect2">
 573 <a name="gst-structure-has-name"></a><h3>gst_structure_has_name ()</h3>
 574 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_has_name              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 575                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 576 <p>
 577 Checks if the structure has the given name
 578 </p>
 579 <div class="variablelist"><table border="0">
 580 <col align="left" valign="top">
 581 <tbody>
 582 <tr>
 583 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 584 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 585 </td>
 586 </tr>
 587 <tr>
 588 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 589 <td>structure name to check for</td>
 590 </tr>
 591 <tr>
 592 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 593 <td>TRUE if <em class="parameter"><code>name</code></em> matches the name of the structure.</td>
 594 </tr>
 595 </tbody>
 596 </table></div>
 597 </div>
 598 <hr>
 599 <div class="refsect2">
 600 <a name="gst-structure-set-name"></a><h3>gst_structure_set_name ()</h3>
 601 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_set_name              (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 602                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 603 <p>
 604 Sets the name of the structure to the given <em class="parameter"><code>name</code></em>.  The string
 605 provided is copied before being used. It must not be empty, start with a
 606 letter and can be followed by letters, numbers and any of "/-_.:".
 607 </p>
 608 <div class="variablelist"><table border="0">
 609 <col align="left" valign="top">
 610 <tbody>
 611 <tr>
 612 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 613 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 614 </td>
 615 </tr>
 616 <tr>
 617 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 618 <td>the new name of the structure</td>
 619 </tr>
 620 </tbody>
 621 </table></div>
 622 </div>
 623 <hr>
 624 <div class="refsect2">
 625 <a name="gst-structure-get-name-id"></a><h3>gst_structure_get_name_id ()</h3>
 626 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="returnvalue">GQuark</span></a>              gst_structure_get_name_id           (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);</pre>
 627 <p>
 628 Get the name of <em class="parameter"><code>structure</code></em> as a GQuark.
 629 </p>
 630 <div class="variablelist"><table border="0">
 631 <col align="left" valign="top">
 632 <tbody>
 633 <tr>
 634 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 635 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 636 </td>
 637 </tr>
 638 <tr>
 639 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 640 <td>the quark representing the name of the structure.</td>
 641 </tr>
 642 </tbody>
 643 </table></div>
 644 </div>
 645 <hr>
 646 <div class="refsect2">
 647 <a name="gst-structure-id-get"></a><h3>gst_structure_id_get ()</h3>
 648 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_id_get                (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 649                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> first_field_id</code></em>,
 650                                                          <em class="parameter"><code>...</code></em>);</pre>
 651 <p>
 652 Parses the variable arguments and reads fields from <em class="parameter"><code>structure</code></em> accordingly.
 653 Variable arguments should be in the form field id quark, field type
 654 (as a GType), pointer(s) to a variable(s) to hold the return value(s).
 655 The last variable argument should be NULL (technically it should be a
 656 0 quark, but we require NULL so compilers that support it can check for
 657 the NULL terminator and warn if it's not there).
 658 </p>
 659 <p>
 660 This function is just like <a class="link" href="gstreamer-GstStructure.html#gst-structure-get" title="gst_structure_get ()"><code class="function">gst_structure_get()</code></a> only that it is slightly
 661 more efficient since it saves the string-to-quark lookup in the global
 662 quark hashtable.
 663 </p>
 664 <p>
 665 For refcounted (mini)objects you will receive a new reference which
 666 you must release with a suitable <code class="function">_unref()</code> when no longer needed. For
 667 strings and boxed types you will receive a copy which you will need to
 668 release with either <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> or the suitable function for the boxed type.
 669 </p>
 670 <div class="variablelist"><table border="0">
 671 <col align="left" valign="top">
 672 <tbody>
 673 <tr>
 674 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 675 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 676 </td>
 677 </tr>
 678 <tr>
 679 <td><p><span class="term"><em class="parameter"><code>first_field_id</code></em> :</span></p></td>
 680 <td>the quark of the first field to read</td>
 681 </tr>
 682 <tr>
 683 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
 684 <td>variable arguments</td>
 685 </tr>
 686 <tr>
 687 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 688 <td>FALSE if there was a problem reading any of the fields (e.g.
 689 because the field requested did not exist, or was of a type other
 690 than the type specified), otherwise TRUE.</td>
 691 </tr>
 692 </tbody>
 693 </table></div>
 694 <p class="since">Since 0.10.24</p>
 695 </div>
 696 <hr>
 697 <div class="refsect2">
 698 <a name="gst-structure-id-get-valist"></a><h3>gst_structure_id_get_valist ()</h3>
 699 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_id_get_valist         (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 700                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> first_field_id</code></em>,
 701                                                          <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
 702 <p>
 703 Parses the variable arguments and reads fields from <em class="parameter"><code>structure</code></em> accordingly.
 704 valist-variant of <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-get" title="gst_structure_id_get ()"><code class="function">gst_structure_id_get()</code></a>. Look at the documentation of
 705 <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-get" title="gst_structure_id_get ()"><code class="function">gst_structure_id_get()</code></a> for more details.
 706 </p>
 707 <div class="variablelist"><table border="0">
 708 <col align="left" valign="top">
 709 <tbody>
 710 <tr>
 711 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 712 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 713 </td>
 714 </tr>
 715 <tr>
 716 <td><p><span class="term"><em class="parameter"><code>first_field_id</code></em> :</span></p></td>
 717 <td>the quark of the first field to read</td>
 718 </tr>
 719 <tr>
 720 <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
 721 <td>variable arguments</td>
 722 </tr>
 723 <tr>
 724 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 725 <td>TRUE, or FALSE if there was a problem reading any of the fields</td>
 726 </tr>
 727 </tbody>
 728 </table></div>
 729 <p class="since">Since 0.10.24</p>
 730 </div>
 731 <hr>
 732 <div class="refsect2">
 733 <a name="gst-structure-id-get-value"></a><h3>gst_structure_id_get_value ()</h3>
 734 <pre class="programlisting">const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      gst_structure_id_get_value          (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 735                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field</code></em>);</pre>
 736 <p>
 737 Get the value of the field with GQuark <em class="parameter"><code>field</code></em>.
 738 </p>
 739 <div class="variablelist"><table border="0">
 740 <col align="left" valign="top">
 741 <tbody>
 742 <tr>
 743 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 744 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 745 </td>
 746 </tr>
 747 <tr>
 748 <td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
 749 <td>the <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> of the field to get</td>
 750 </tr>
 751 <tr>
 752 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 753 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> corresponding to the field with the given name
 754 identifier.</td>
 755 </tr>
 756 </tbody>
 757 </table></div>
 758 </div>
 759 <hr>
 760 <div class="refsect2">
 761 <a name="gst-structure-id-set-value"></a><h3>gst_structure_id_set_value ()</h3>
 762 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_id_set_value          (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 763                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field</code></em>,
 764                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
 765 <p>
 766 Sets the field with the given GQuark <em class="parameter"><code>field</code></em> to <em class="parameter"><code>value</code></em>.  If the field
 767 does not exist, it is created.  If the field exists, the previous
 768 value is replaced and freed.
 769 </p>
 770 <div class="variablelist"><table border="0">
 771 <col align="left" valign="top">
 772 <tbody>
 773 <tr>
 774 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 775 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 776 </td>
 777 </tr>
 778 <tr>
 779 <td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
 780 <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> representing a field</td>
 781 </tr>
 782 <tr>
 783 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 784 <td>the new value of the field</td>
 785 </tr>
 786 </tbody>
 787 </table></div>
 788 </div>
 789 <hr>
 790 <div class="refsect2">
 791 <a name="gst-structure-id-take-value"></a><h3>gst_structure_id_take_value ()</h3>
 792 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_id_take_value         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 793                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field</code></em>,
 794                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
 795 <p>
 796 Sets the field with the given GQuark <em class="parameter"><code>field</code></em> to <em class="parameter"><code>value</code></em>.  If the field
 797 does not exist, it is created.  If the field exists, the previous
 798 value is replaced and freed.
 799 </p>
 800 <div class="variablelist"><table border="0">
 801 <col align="left" valign="top">
 802 <tbody>
 803 <tr>
 804 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 805 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 806 </td>
 807 </tr>
 808 <tr>
 809 <td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
 810 <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> representing a field</td>
 811 </tr>
 812 <tr>
 813 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 814 <td>the new value of the field. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 815 </td>
 816 </tr>
 817 </tbody>
 818 </table></div>
 819 <p class="since">Since 0.10.31</p>
 820 </div>
 821 <hr>
 822 <div class="refsect2">
 823 <a name="gst-structure-get"></a><h3>gst_structure_get ()</h3>
 824 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get                   (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 825                                                          <em class="parameter"><code>const <span class="type">char</span> *first_fieldname</code></em>,
 826                                                          <em class="parameter"><code>...</code></em>);</pre>
 827 <p>
 828 Parses the variable arguments and reads fields from <em class="parameter"><code>structure</code></em> accordingly.
 829 Variable arguments should be in the form field name, field type
 830 (as a GType), pointer(s) to a variable(s) to hold the return value(s).
 831 The last variable argument should be NULL.
 832 </p>
 833 <p>
 834 For refcounted (mini)objects you will receive a new reference which
 835 you must release with a suitable <code class="function">_unref()</code> when no longer needed. For
 836 strings and boxed types you will receive a copy which you will need to
 837 release with either <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> or the suitable function for the boxed type.
 838 </p>
 839 <div class="variablelist"><table border="0">
 840 <col align="left" valign="top">
 841 <tbody>
 842 <tr>
 843 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 844 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 845 </td>
 846 </tr>
 847 <tr>
 848 <td><p><span class="term"><em class="parameter"><code>first_fieldname</code></em> :</span></p></td>
 849 <td>the name of the first field to read</td>
 850 </tr>
 851 <tr>
 852 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
 853 <td>variable arguments</td>
 854 </tr>
 855 <tr>
 856 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 857 <td>FALSE if there was a problem reading any of the fields (e.g.
 858 because the field requested did not exist, or was of a type other
 859 than the type specified), otherwise TRUE.</td>
 860 </tr>
 861 </tbody>
 862 </table></div>
 863 <p class="since">Since 0.10.24</p>
 864 </div>
 865 <hr>
 866 <div class="refsect2">
 867 <a name="gst-structure-get-valist"></a><h3>gst_structure_get_valist ()</h3>
 868 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_valist            (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 869                                                          <em class="parameter"><code>const <span class="type">char</span> *first_fieldname</code></em>,
 870                                                          <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
 871 <p>
 872 Parses the variable arguments and reads fields from <em class="parameter"><code>structure</code></em> accordingly.
 873 valist-variant of <a class="link" href="gstreamer-GstStructure.html#gst-structure-get" title="gst_structure_get ()"><code class="function">gst_structure_get()</code></a>. Look at the documentation of
 874 <a class="link" href="gstreamer-GstStructure.html#gst-structure-get" title="gst_structure_get ()"><code class="function">gst_structure_get()</code></a> for more details.
 875 </p>
 876 <div class="variablelist"><table border="0">
 877 <col align="left" valign="top">
 878 <tbody>
 879 <tr>
 880 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 881 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 882 </td>
 883 </tr>
 884 <tr>
 885 <td><p><span class="term"><em class="parameter"><code>first_fieldname</code></em> :</span></p></td>
 886 <td>the name of the first field to read</td>
 887 </tr>
 888 <tr>
 889 <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
 890 <td>variable arguments</td>
 891 </tr>
 892 <tr>
 893 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 894 <td>TRUE, or FALSE if there was a problem reading any of the fields</td>
 895 </tr>
 896 </tbody>
 897 </table></div>
 898 <p class="since">Since 0.10.24</p>
 899 </div>
 900 <hr>
 901 <div class="refsect2">
 902 <a name="gst-structure-get-value"></a><h3>gst_structure_get_value ()</h3>
 903 <pre class="programlisting">const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *      gst_structure_get_value             (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 904                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>);</pre>
 905 <p>
 906 Get the value of the field with name <em class="parameter"><code>fieldname</code></em>.
 907 </p>
 908 <div class="variablelist"><table border="0">
 909 <col align="left" valign="top">
 910 <tbody>
 911 <tr>
 912 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 913 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 914 </td>
 915 </tr>
 916 <tr>
 917 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
 918 <td>the name of the field to get</td>
 919 </tr>
 920 <tr>
 921 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 922 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> corresponding to the field with the given name.</td>
 923 </tr>
 924 </tbody>
 925 </table></div>
 926 </div>
 927 <hr>
 928 <div class="refsect2">
 929 <a name="gst-structure-set-value"></a><h3>gst_structure_set_value ()</h3>
 930 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_set_value             (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 931                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 932                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
 933 <p>
 934 Sets the field with the given name <em class="parameter"><code>field</code></em> to <em class="parameter"><code>value</code></em>.  If the field
 935 does not exist, it is created.  If the field exists, the previous
 936 value is replaced and freed.
 937 </p>
 938 <div class="variablelist"><table border="0">
 939 <col align="left" valign="top">
 940 <tbody>
 941 <tr>
 942 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 943 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 944 </td>
 945 </tr>
 946 <tr>
 947 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
 948 <td>the name of the field to set</td>
 949 </tr>
 950 <tr>
 951 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 952 <td>the new value of the field</td>
 953 </tr>
 954 </tbody>
 955 </table></div>
 956 </div>
 957 <hr>
 958 <div class="refsect2">
 959 <a name="gst-structure-take-value"></a><h3>gst_structure_take_value ()</h3>
 960 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_take_value            (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 961                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 962                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
 963 <p>
 964 Sets the field with the given name <em class="parameter"><code>field</code></em> to <em class="parameter"><code>value</code></em>.  If the field
 965 does not exist, it is created.  If the field exists, the previous
 966 value is replaced and freed. The function will take ownership of <em class="parameter"><code>value</code></em>.
 967 </p>
 968 <div class="variablelist"><table border="0">
 969 <col align="left" valign="top">
 970 <tbody>
 971 <tr>
 972 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
 973 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
 974 </td>
 975 </tr>
 976 <tr>
 977 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
 978 <td>the name of the field to set</td>
 979 </tr>
 980 <tr>
 981 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 982 <td>the new value of the field. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 983 </td>
 984 </tr>
 985 </tbody>
 986 </table></div>
 987 <p class="since">Since 0.10.31</p>
 988 </div>
 989 <hr>
 990 <div class="refsect2">
 991 <a name="gst-structure-set"></a><h3>gst_structure_set ()</h3>
 992 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_set                   (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
 993                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
 994                                                          <em class="parameter"><code>...</code></em>);</pre>
 995 <p>
 996 Parses the variable arguments and sets fields accordingly.
 997 Variable arguments should be in the form field name, field type
 998 (as a GType), value(s).  The last variable argument should be NULL.
 999 </p>
1000 <div class="variablelist"><table border="0">
1001 <col align="left" valign="top">
1002 <tbody>
1003 <tr>
1004 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1005 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1006 </td>
1007 </tr>
1008 <tr>
1009 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1010 <td>the name of the field to set</td>
1011 </tr>
1012 <tr>
1013 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1014 <td>variable arguments</td>
1015 </tr>
1016 </tbody>
1017 </table></div>
1018 </div>
1019 <hr>
1020 <div class="refsect2">
1021 <a name="gst-structure-set-valist"></a><h3>gst_structure_set_valist ()</h3>
1022 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_set_valist            (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1023                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1024                                                          <em class="parameter"><code><span class="type">va_list</span> varargs</code></em>);</pre>
1025 <p>
1026 va_list form of <a class="link" href="gstreamer-GstStructure.html#gst-structure-set" title="gst_structure_set ()"><code class="function">gst_structure_set()</code></a>.
1027 </p>
1028 <div class="variablelist"><table border="0">
1029 <col align="left" valign="top">
1030 <tbody>
1031 <tr>
1032 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1033 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1034 </td>
1035 </tr>
1036 <tr>
1037 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1038 <td>the name of the field to set</td>
1039 </tr>
1040 <tr>
1041 <td><p><span class="term"><em class="parameter"><code>varargs</code></em> :</span></p></td>
1042 <td>variable arguments</td>
1043 </tr>
1044 </tbody>
1045 </table></div>
1046 </div>
1047 <hr>
1048 <div class="refsect2">
1049 <a name="gst-structure-id-set"></a><h3>gst_structure_id_set ()</h3>
1050 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_id_set                (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1051                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> fieldname</code></em>,
1052                                                          <em class="parameter"><code>...</code></em>);</pre>
1053 <p>
1054 Identical to gst_structure_set, except that field names are
1055 passed using the GQuark for the field name. This allows more efficient
1056 setting of the structure if the caller already knows the associated
1057 quark values.
1058 The last variable argument must be NULL.
1059 </p>
1060 <div class="variablelist"><table border="0">
1061 <col align="left" valign="top">
1062 <tbody>
1063 <tr>
1064 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1065 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1066 </td>
1067 </tr>
1068 <tr>
1069 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1070 <td>the GQuark for the name of the field to set</td>
1071 </tr>
1072 <tr>
1073 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1074 <td>variable arguments</td>
1075 </tr>
1076 </tbody>
1077 </table></div>
1078 <p class="since">Since 0.10.10</p>
1079 </div>
1080 <hr>
1081 <div class="refsect2">
1082 <a name="gst-structure-id-set-valist"></a><h3>gst_structure_id_set_valist ()</h3>
1083 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_id_set_valist         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1084                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> fieldname</code></em>,
1085                                                          <em class="parameter"><code><span class="type">va_list</span> varargs</code></em>);</pre>
1086 <p>
1087 va_list form of <a class="link" href="gstreamer-GstStructure.html#gst-structure-id-set" title="gst_structure_id_set ()"><code class="function">gst_structure_id_set()</code></a>.
1088 </p>
1089 <div class="variablelist"><table border="0">
1090 <col align="left" valign="top">
1091 <tbody>
1092 <tr>
1093 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1094 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1095 </td>
1096 </tr>
1097 <tr>
1098 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1099 <td>the name of the field to set</td>
1100 </tr>
1101 <tr>
1102 <td><p><span class="term"><em class="parameter"><code>varargs</code></em> :</span></p></td>
1103 <td>variable arguments</td>
1104 </tr>
1105 </tbody>
1106 </table></div>
1107 <p class="since">Since 0.10.10</p>
1108 </div>
1109 <hr>
1110 <div class="refsect2">
1111 <a name="gst-structure-remove-field"></a><h3>gst_structure_remove_field ()</h3>
1112 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_remove_field          (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1113                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>);</pre>
1114 <p>
1115 Removes the field with the given name.  If the field with the given
1116 name does not exist, the structure is unchanged.
1117 </p>
1118 <div class="variablelist"><table border="0">
1119 <col align="left" valign="top">
1120 <tbody>
1121 <tr>
1122 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1123 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1124 </td>
1125 </tr>
1126 <tr>
1127 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1128 <td>the name of the field to remove</td>
1129 </tr>
1130 </tbody>
1131 </table></div>
1132 </div>
1133 <hr>
1134 <div class="refsect2">
1135 <a name="gst-structure-remove-fields"></a><h3>gst_structure_remove_fields ()</h3>
1136 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_remove_fields         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1137                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1138                                                          <em class="parameter"><code>...</code></em>);</pre>
1139 <p>
1140 Removes the fields with the given names. If a field does not exist, the
1141 argument is ignored.
1142 </p>
1143 <div class="variablelist"><table border="0">
1144 <col align="left" valign="top">
1145 <tbody>
1146 <tr>
1147 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1148 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1149 </td>
1150 </tr>
1151 <tr>
1152 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1153 <td>the name of the field to remove</td>
1154 </tr>
1155 <tr>
1156 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1157 <td>NULL-terminated list of more fieldnames to remove</td>
1158 </tr>
1159 </tbody>
1160 </table></div>
1161 </div>
1162 <hr>
1163 <div class="refsect2">
1164 <a name="gst-structure-remove-fields-valist"></a><h3>gst_structure_remove_fields_valist ()</h3>
1165 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_remove_fields_valist  (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1166                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1167                                                          <em class="parameter"><code><span class="type">va_list</span> varargs</code></em>);</pre>
1168 <p>
1169 va_list form of <a class="link" href="gstreamer-GstStructure.html#gst-structure-remove-fields" title="gst_structure_remove_fields ()"><code class="function">gst_structure_remove_fields()</code></a>.
1170 </p>
1171 <div class="variablelist"><table border="0">
1172 <col align="left" valign="top">
1173 <tbody>
1174 <tr>
1175 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1176 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1177 </td>
1178 </tr>
1179 <tr>
1180 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1181 <td>the name of the field to remove</td>
1182 </tr>
1183 <tr>
1184 <td><p><span class="term"><em class="parameter"><code>varargs</code></em> :</span></p></td>
1185 <td>NULL-terminated list of more fieldnames to remove</td>
1186 </tr>
1187 </tbody>
1188 </table></div>
1189 </div>
1190 <hr>
1191 <div class="refsect2">
1192 <a name="gst-structure-remove-all-fields"></a><h3>gst_structure_remove_all_fields ()</h3>
1193 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_remove_all_fields     (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);</pre>
1194 <p>
1195 Removes all fields in a GstStructure.
1196 </p>
1197 <div class="variablelist"><table border="0">
1198 <col align="left" valign="top">
1199 <tbody><tr>
1200 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1201 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1202 </td>
1203 </tr></tbody>
1204 </table></div>
1205 </div>
1206 <hr>
1207 <div class="refsect2">
1208 <a name="gst-structure-get-field-type"></a><h3>gst_structure_get_field_type ()</h3>
1209 <pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>               gst_structure_get_field_type        (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1210                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>);</pre>
1211 <p>
1212 Finds the field with the given name, and returns the type of the
1213 value it contains.  If the field is not found, G_TYPE_INVALID is
1214 returned.
1215 </p>
1216 <div class="variablelist"><table border="0">
1217 <col align="left" valign="top">
1218 <tbody>
1219 <tr>
1220 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1221 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1222 </td>
1223 </tr>
1224 <tr>
1225 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1226 <td>the name of the field</td>
1227 </tr>
1228 <tr>
1229 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1230 <td>the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> of the field</td>
1231 </tr>
1232 </tbody>
1233 </table></div>
1234 </div>
1235 <hr>
1236 <div class="refsect2">
1237 <a name="gst-structure-foreach"></a><h3>gst_structure_foreach ()</h3>
1238 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_foreach               (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1239                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructureForeachFunc" title="GstStructureForeachFunc ()"><span class="type">GstStructureForeachFunc</span></a> func</code></em>,
1240                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1241 <p>
1242 Calls the provided function once for each field in the <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>. The
1243 function must not modify the fields. Also see <a class="link" href="gstreamer-GstStructure.html#gst-structure-map-in-place" title="gst_structure_map_in_place ()"><code class="function">gst_structure_map_in_place()</code></a>.
1244 </p>
1245 <div class="variablelist"><table border="0">
1246 <col align="left" valign="top">
1247 <tbody>
1248 <tr>
1249 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1250 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1251 </td>
1252 </tr>
1253 <tr>
1254 <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1255 <td>a function to call for each field. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
1256 </td>
1257 </tr>
1258 <tr>
1259 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1260 <td>private data. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
1261 </td>
1262 </tr>
1263 <tr>
1264 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1265 <td>TRUE if the supplied function returns TRUE For each of the fields,
1266 FALSE otherwise.</td>
1267 </tr>
1268 </tbody>
1269 </table></div>
1270 </div>
1271 <hr>
1272 <div class="refsect2">
1273 <a name="gst-structure-n-fields"></a><h3>gst_structure_n_fields ()</h3>
1274 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gst_structure_n_fields              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);</pre>
1275 <p>
1276 Get the number of fields in the structure.
1277 </p>
1278 <div class="variablelist"><table border="0">
1279 <col align="left" valign="top">
1280 <tbody>
1281 <tr>
1282 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1283 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1284 </td>
1285 </tr>
1286 <tr>
1287 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1288 <td>the number of fields in the structure</td>
1289 </tr>
1290 </tbody>
1291 </table></div>
1292 </div>
1293 <hr>
1294 <div class="refsect2">
1295 <a name="gst-structure-has-field"></a><h3>gst_structure_has_field ()</h3>
1296 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_has_field             (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1297                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>);</pre>
1298 <p>
1299 Check if <em class="parameter"><code>structure</code></em> contains a field named <em class="parameter"><code>fieldname</code></em>.
1300 </p>
1301 <div class="variablelist"><table border="0">
1302 <col align="left" valign="top">
1303 <tbody>
1304 <tr>
1305 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1306 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1307 </td>
1308 </tr>
1309 <tr>
1310 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1311 <td>the name of a field</td>
1312 </tr>
1313 <tr>
1314 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1315 <td>TRUE if the structure contains a field with the given name</td>
1316 </tr>
1317 </tbody>
1318 </table></div>
1319 </div>
1320 <hr>
1321 <div class="refsect2">
1322 <a name="gst-structure-has-field-typed"></a><h3>gst_structure_has_field_typed ()</h3>
1323 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_has_field_typed       (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1324                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1325                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>);</pre>
1326 <p>
1327 Check if <em class="parameter"><code>structure</code></em> contains a field named <em class="parameter"><code>fieldname</code></em> and with GType <em class="parameter"><code>type</code></em>.
1328 </p>
1329 <div class="variablelist"><table border="0">
1330 <col align="left" valign="top">
1331 <tbody>
1332 <tr>
1333 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1334 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1335 </td>
1336 </tr>
1337 <tr>
1338 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1339 <td>the name of a field</td>
1340 </tr>
1341 <tr>
1342 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
1343 <td>the type of a value</td>
1344 </tr>
1345 <tr>
1346 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1347 <td>TRUE if the structure contains a field with the given name and type</td>
1348 </tr>
1349 </tbody>
1350 </table></div>
1351 </div>
1352 <hr>
1353 <div class="refsect2">
1354 <a name="gst-structure-is-equal"></a><h3>gst_structure_is_equal ()</h3>
1355 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_is_equal              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure1</code></em>,
1356                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure2</code></em>);</pre>
1357 <p>
1358 Tests if the two <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> are equal.
1359 </p>
1360 <div class="variablelist"><table border="0">
1361 <col align="left" valign="top">
1362 <tbody>
1363 <tr>
1364 <td><p><span class="term"><em class="parameter"><code>structure1</code></em> :</span></p></td>
1365 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>.</td>
1366 </tr>
1367 <tr>
1368 <td><p><span class="term"><em class="parameter"><code>structure2</code></em> :</span></p></td>
1369 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>.</td>
1370 </tr>
1371 <tr>
1372 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1373 <td>TRUE if the two structures have the same name and field.</td>
1374 </tr>
1375 </tbody>
1376 </table></div>
1377 <p class="since">Since 0.10.36</p>
1378 </div>
1379 <hr>
1380 <div class="refsect2">
1381 <a name="gst-structure-is-subset"></a><h3>gst_structure_is_subset ()</h3>
1382 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_is_subset             (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *subset</code></em>,
1383                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *superset</code></em>);</pre>
1384 <p>
1385 Checks if <em class="parameter"><code>subset</code></em> is a subset of <em class="parameter"><code>superset</code></em>, i.e. has the same
1386 structure name and for all fields that are existing in <em class="parameter"><code>superset</code></em>,
1387 <em class="parameter"><code>subset</code></em> has a value that is a subset of the value in <em class="parameter"><code>superset</code></em>.
1388 </p>
1389 <div class="variablelist"><table border="0">
1390 <col align="left" valign="top">
1391 <tbody>
1392 <tr>
1393 <td><p><span class="term"><em class="parameter"><code>subset</code></em> :</span></p></td>
1394 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1395 </td>
1396 </tr>
1397 <tr>
1398 <td><p><span class="term"><em class="parameter"><code>superset</code></em> :</span></p></td>
1399 <td>a potentially greater <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1400 </td>
1401 </tr>
1402 <tr>
1403 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1404 <td>
1405 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>subset</code></em> is a subset of <em class="parameter"><code>superset</code></em>
1406 </td>
1407 </tr>
1408 </tbody>
1409 </table></div>
1410 <p class="since">Since 0.10.36</p>
1411 </div>
1412 <hr>
1413 <div class="refsect2">
1414 <a name="gst-structure-can-intersect"></a><h3>gst_structure_can_intersect ()</h3>
1415 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_can_intersect         (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *struct1</code></em>,
1416                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *struct2</code></em>);</pre>
1417 <p>
1418 Tries intersecting <em class="parameter"><code>struct1</code></em> and <em class="parameter"><code>struct2</code></em> and reports whether the result
1419 would not be empty.
1420 </p>
1421 <div class="variablelist"><table border="0">
1422 <col align="left" valign="top">
1423 <tbody>
1424 <tr>
1425 <td><p><span class="term"><em class="parameter"><code>struct1</code></em> :</span></p></td>
1426 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1427 </td>
1428 </tr>
1429 <tr>
1430 <td><p><span class="term"><em class="parameter"><code>struct2</code></em> :</span></p></td>
1431 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1432 </td>
1433 </tr>
1434 <tr>
1435 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1436 <td>
1437 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if intersection would not be empty</td>
1438 </tr>
1439 </tbody>
1440 </table></div>
1441 <p class="since">Since 0.10.36</p>
1442 </div>
1443 <hr>
1444 <div class="refsect2">
1445 <a name="gst-structure-intersect"></a><h3>gst_structure_intersect ()</h3>
1446 <pre class="programlisting"><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      gst_structure_intersect             (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *struct1</code></em>,
1447                                                          <em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *struct2</code></em>);</pre>
1448 <p>
1449 Interesects <em class="parameter"><code>struct1</code></em> and <em class="parameter"><code>struct2</code></em> and returns the intersection.
1450 </p>
1451 <div class="variablelist"><table border="0">
1452 <col align="left" valign="top">
1453 <tbody>
1454 <tr>
1455 <td><p><span class="term"><em class="parameter"><code>struct1</code></em> :</span></p></td>
1456 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1457 </td>
1458 </tr>
1459 <tr>
1460 <td><p><span class="term"><em class="parameter"><code>struct2</code></em> :</span></p></td>
1461 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1462 </td>
1463 </tr>
1464 <tr>
1465 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1466 <td>Intersection of <em class="parameter"><code>struct1</code></em> and <em class="parameter"><code>struct2</code></em>
1467 </td>
1468 </tr>
1469 </tbody>
1470 </table></div>
1471 <p class="since">Since 0.10.36</p>
1472 </div>
1473 <hr>
1474 <div class="refsect2">
1475 <a name="gst-structure-id-has-field"></a><h3>gst_structure_id_has_field ()</h3>
1476 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_id_has_field          (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1477                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field</code></em>);</pre>
1478 <p>
1479 Check if <em class="parameter"><code>structure</code></em> contains a field named <em class="parameter"><code>field</code></em>.
1480 </p>
1481 <div class="variablelist"><table border="0">
1482 <col align="left" valign="top">
1483 <tbody>
1484 <tr>
1485 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1486 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1487 </td>
1488 </tr>
1489 <tr>
1490 <td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
1491 <td>
1492 <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> of the field name</td>
1493 </tr>
1494 <tr>
1495 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1496 <td>TRUE if the structure contains a field with the given name</td>
1497 </tr>
1498 </tbody>
1499 </table></div>
1500 <p class="since">Since 0.10.26</p>
1501 </div>
1502 <hr>
1503 <div class="refsect2">
1504 <a name="gst-structure-id-has-field-typed"></a><h3>gst_structure_id_has_field_typed ()</h3>
1505 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_id_has_field_typed    (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1506                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> field</code></em>,
1507                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>);</pre>
1508 <p>
1509 Check if <em class="parameter"><code>structure</code></em> contains a field named <em class="parameter"><code>field</code></em> and with GType <em class="parameter"><code>type</code></em>.
1510 </p>
1511 <div class="variablelist"><table border="0">
1512 <col align="left" valign="top">
1513 <tbody>
1514 <tr>
1515 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1516 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1517 </td>
1518 </tr>
1519 <tr>
1520 <td><p><span class="term"><em class="parameter"><code>field</code></em> :</span></p></td>
1521 <td>
1522 <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> of the field name</td>
1523 </tr>
1524 <tr>
1525 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
1526 <td>the type of a value</td>
1527 </tr>
1528 <tr>
1529 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1530 <td>TRUE if the structure contains a field with the given name and type</td>
1531 </tr>
1532 </tbody>
1533 </table></div>
1534 <p class="since">Since 0.10.26</p>
1535 </div>
1536 <hr>
1537 <div class="refsect2">
1538 <a name="gst-structure-get-boolean"></a><h3>gst_structure_get_boolean ()</h3>
1539 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_boolean           (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1540                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1541                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);</pre>
1542 <p>
1543 Sets the boolean pointed to by <em class="parameter"><code>value</code></em> corresponding to the value of the
1544 given field.  Caller is responsible for making sure the field exists
1545 and has the correct type.
1546 </p>
1547 <div class="variablelist"><table border="0">
1548 <col align="left" valign="top">
1549 <tbody>
1550 <tr>
1551 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1552 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1553 </td>
1554 </tr>
1555 <tr>
1556 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1557 <td>the name of a field</td>
1558 </tr>
1559 <tr>
1560 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1561 <td>a pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1562 </td>
1563 </tr>
1564 <tr>
1565 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1566 <td>TRUE if the value could be set correctly. If there was no field
1567 with <em class="parameter"><code>fieldname</code></em> or the existing field did not contain a boolean, this
1568 function returns FALSE.</td>
1569 </tr>
1570 </tbody>
1571 </table></div>
1572 </div>
1573 <hr>
1574 <div class="refsect2">
1575 <a name="gst-structure-get-int"></a><h3>gst_structure_get_int ()</h3>
1576 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_int               (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1577                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1578                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value</code></em>);</pre>
1579 <p>
1580 Sets the int pointed to by <em class="parameter"><code>value</code></em> corresponding to the value of the
1581 given field.  Caller is responsible for making sure the field exists
1582 and has the correct type.
1583 </p>
1584 <div class="variablelist"><table border="0">
1585 <col align="left" valign="top">
1586 <tbody>
1587 <tr>
1588 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1589 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1590 </td>
1591 </tr>
1592 <tr>
1593 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1594 <td>the name of a field</td>
1595 </tr>
1596 <tr>
1597 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1598 <td>a pointer to an int to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1599 </td>
1600 </tr>
1601 <tr>
1602 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1603 <td>
1604 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the value could be set correctly. If there was no field
1605 with <em class="parameter"><code>fieldname</code></em> or the existing field did not contain an int, this function
1606 returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
1607 </tr>
1608 </tbody>
1609 </table></div>
1610 </div>
1611 <hr>
1612 <div class="refsect2">
1613 <a name="gst-structure-get-uint"></a><h3>gst_structure_get_uint ()</h3>
1614 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_uint              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1615                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1616                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *value</code></em>);</pre>
1617 <p>
1618 Sets the uint pointed to by <em class="parameter"><code>value</code></em> corresponding to the value of the
1619 given field.  Caller is responsible for making sure the field exists
1620 and has the correct type.
1621 </p>
1622 <div class="variablelist"><table border="0">
1623 <col align="left" valign="top">
1624 <tbody>
1625 <tr>
1626 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1627 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1628 </td>
1629 </tr>
1630 <tr>
1631 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1632 <td>the name of a field</td>
1633 </tr>
1634 <tr>
1635 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1636 <td>a pointer to a uint to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1637 </td>
1638 </tr>
1639 <tr>
1640 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1641 <td>
1642 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the value could be set correctly. If there was no field
1643 with <em class="parameter"><code>fieldname</code></em> or the existing field did not contain a uint, this function
1644 returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
1645 </tr>
1646 </tbody>
1647 </table></div>
1648 <p class="since">Since 0.10.15</p>
1649 </div>
1650 <hr>
1651 <div class="refsect2">
1652 <a name="gst-structure-get-fourcc"></a><h3>gst_structure_get_fourcc ()</h3>
1653 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_fourcc            (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1654                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1655                                                          <em class="parameter"><code><span class="type">guint32</span> *value</code></em>);</pre>
1656 <p>
1657 Sets the Fourcc pointed to by <em class="parameter"><code>value</code></em> corresponding to the value of the
1658 given field.  Caller is responsible for making sure the field exists
1659 and has the correct type.
1660 </p>
1661 <div class="variablelist"><table border="0">
1662 <col align="left" valign="top">
1663 <tbody>
1664 <tr>
1665 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1666 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1667 </td>
1668 </tr>
1669 <tr>
1670 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1671 <td>the name of a field</td>
1672 </tr>
1673 <tr>
1674 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1675 <td>a pointer to a 32bit unsigned int to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1676 </td>
1677 </tr>
1678 <tr>
1679 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1680 <td>TRUE if the value could be set correctly. If there was no field
1681 with <em class="parameter"><code>fieldname</code></em> or the existing field did not contain a fourcc, this function
1682 returns FALSE.</td>
1683 </tr>
1684 </tbody>
1685 </table></div>
1686 </div>
1687 <hr>
1688 <div class="refsect2">
1689 <a name="gst-structure-get-double"></a><h3>gst_structure_get_double ()</h3>
1690 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_double            (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1691                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1692                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *value</code></em>);</pre>
1693 <p>
1694 Sets the double pointed to by <em class="parameter"><code>value</code></em> corresponding to the value of the
1695 given field.  Caller is responsible for making sure the field exists
1696 and has the correct type.
1697 </p>
1698 <div class="variablelist"><table border="0">
1699 <col align="left" valign="top">
1700 <tbody>
1701 <tr>
1702 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1703 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1704 </td>
1705 </tr>
1706 <tr>
1707 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1708 <td>the name of a field</td>
1709 </tr>
1710 <tr>
1711 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1712 <td>a pointer to a gdouble to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1713 </td>
1714 </tr>
1715 <tr>
1716 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1717 <td>TRUE if the value could be set correctly. If there was no field
1718 with <em class="parameter"><code>fieldname</code></em> or the existing field did not contain a double, this
1719 function returns FALSE.</td>
1720 </tr>
1721 </tbody>
1722 </table></div>
1723 </div>
1724 <hr>
1725 <div class="refsect2">
1726 <a name="gst-structure-get-string"></a><h3>gst_structure_get_string ()</h3>
1727 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_structure_get_string            (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1728                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>);</pre>
1729 <p>
1730 Finds the field corresponding to <em class="parameter"><code>fieldname</code></em>, and returns the string
1731 contained in the field's value.  Caller is responsible for making
1732 sure the field exists and has the correct type.
1733 </p>
1734 <p>
1735 The string should not be modified, and remains valid until the next
1736 call to a gst_structure_*() function with the given structure.
1737 </p>
1738 <div class="variablelist"><table border="0">
1739 <col align="left" valign="top">
1740 <tbody>
1741 <tr>
1742 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1743 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1744 </td>
1745 </tr>
1746 <tr>
1747 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1748 <td>the name of a field</td>
1749 </tr>
1750 <tr>
1751 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1752 <td>a pointer to the string or NULL when the field did not exist
1753 or did not contain a string.</td>
1754 </tr>
1755 </tbody>
1756 </table></div>
1757 </div>
1758 <hr>
1759 <div class="refsect2">
1760 <a name="gst-structure-get-date"></a><h3>gst_structure_get_date ()</h3>
1761 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_date              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1762                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1763                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> **value</code></em>);</pre>
1764 <p>
1765 Sets the date pointed to by <em class="parameter"><code>value</code></em> corresponding to the date of the
1766 given field.  Caller is responsible for making sure the field exists
1767 and has the correct type.
1768 </p>
1769 <p>
1770 On success <em class="parameter"><code>value</code></em> will point to a newly-allocated copy of the date which
1771 should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#g-date-free"><code class="function">g_date_free()</code></a> when no longer needed (note: this is
1772 inconsistent with e.g. <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-string" title="gst_structure_get_string ()"><code class="function">gst_structure_get_string()</code></a> which doesn't return a
1773 copy of the string).
1774 </p>
1775 <div class="variablelist"><table border="0">
1776 <col align="left" valign="top">
1777 <tbody>
1778 <tr>
1779 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1780 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1781 </td>
1782 </tr>
1783 <tr>
1784 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1785 <td>the name of a field</td>
1786 </tr>
1787 <tr>
1788 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1789 <td>a pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> callee-allocates]</span>
1790 </td>
1791 </tr>
1792 <tr>
1793 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1794 <td>TRUE if the value could be set correctly. If there was no field
1795 with <em class="parameter"><code>fieldname</code></em> or the existing field did not contain a data, this function
1796 returns FALSE.</td>
1797 </tr>
1798 </tbody>
1799 </table></div>
1800 </div>
1801 <hr>
1802 <div class="refsect2">
1803 <a name="gst-structure-get-date-time"></a><h3>gst_structure_get_date_time ()</h3>
1804 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_date_time         (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1805                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1806                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstDateTime.html#GstDateTime" title="GstDateTime"><span class="type">GstDateTime</span></a> **value</code></em>);</pre>
1807 <p>
1808 Sets the datetime pointed to by <em class="parameter"><code>value</code></em> corresponding to the datetime of the
1809 given field. Caller is responsible for making sure the field exists
1810 and has the correct type.
1811 </p>
1812 <p>
1813 On success <em class="parameter"><code>value</code></em> will point to a reference of the datetime which
1814 should be unreffed with <a class="link" href="gstreamer-GstDateTime.html#gst-date-time-unref" title="gst_date_time_unref ()"><code class="function">gst_date_time_unref()</code></a> when no longer needed
1815 (note: this is inconsistent with e.g. <a class="link" href="gstreamer-GstStructure.html#gst-structure-get-string" title="gst_structure_get_string ()"><code class="function">gst_structure_get_string()</code></a>
1816 which doesn't return a copy of the string).
1817 </p>
1818 <div class="variablelist"><table border="0">
1819 <col align="left" valign="top">
1820 <tbody>
1821 <tr>
1822 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1823 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1824 </td>
1825 </tr>
1826 <tr>
1827 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1828 <td>the name of a field</td>
1829 </tr>
1830 <tr>
1831 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1832 <td>a pointer to a <a class="link" href="gstreamer-GstDateTime.html#GstDateTime" title="GstDateTime"><span class="type">GstDateTime</span></a> to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym> callee-allocates]</span>
1833 </td>
1834 </tr>
1835 <tr>
1836 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1837 <td>TRUE if the value could be set correctly. If there was no field
1838 with <em class="parameter"><code>fieldname</code></em> or the existing field did not contain a data, this function
1839 returns FALSE.</td>
1840 </tr>
1841 </tbody>
1842 </table></div>
1843 <p class="since">Since 0.10.31</p>
1844 </div>
1845 <hr>
1846 <div class="refsect2">
1847 <a name="gst-structure-get-clock-time"></a><h3>gst_structure_get_clock_time ()</h3>
1848 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_clock_time        (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1849                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1850                                                          <em class="parameter"><code><a class="link" href="GstClock.html#GstClockTime" title="GstClockTime"><span class="type">GstClockTime</span></a> *value</code></em>);</pre>
1851 <p>
1852 Sets the clock time pointed to by <em class="parameter"><code>value</code></em> corresponding to the clock time
1853 of the given field.  Caller is responsible for making sure the field exists
1854 and has the correct type.
1855 </p>
1856 <div class="variablelist"><table border="0">
1857 <col align="left" valign="top">
1858 <tbody>
1859 <tr>
1860 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1861 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1862 </td>
1863 </tr>
1864 <tr>
1865 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1866 <td>the name of a field</td>
1867 </tr>
1868 <tr>
1869 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1870 <td>a pointer to a <a class="link" href="GstClock.html#GstClockTime" title="GstClockTime"><span class="type">GstClockTime</span></a> to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1871 </td>
1872 </tr>
1873 <tr>
1874 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1875 <td>TRUE if the value could be set correctly. If there was no field
1876 with <em class="parameter"><code>fieldname</code></em> or the existing field did not contain a <a class="link" href="GstClock.html#GstClockTime" title="GstClockTime"><span class="type">GstClockTime</span></a>, this
1877 function returns FALSE.</td>
1878 </tr>
1879 </tbody>
1880 </table></div>
1881 </div>
1882 <hr>
1883 <div class="refsect2">
1884 <a name="gst-structure-get-enum"></a><h3>gst_structure_get_enum ()</h3>
1885 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_enum              (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1886                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1887                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> enumtype</code></em>,
1888                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value</code></em>);</pre>
1889 <p>
1890 Sets the int pointed to by <em class="parameter"><code>value</code></em> corresponding to the value of the
1891 given field.  Caller is responsible for making sure the field exists,
1892 has the correct type and that the enumtype is correct.
1893 </p>
1894 <div class="variablelist"><table border="0">
1895 <col align="left" valign="top">
1896 <tbody>
1897 <tr>
1898 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1899 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1900 </td>
1901 </tr>
1902 <tr>
1903 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1904 <td>the name of a field</td>
1905 </tr>
1906 <tr>
1907 <td><p><span class="term"><em class="parameter"><code>enumtype</code></em> :</span></p></td>
1908 <td>the enum type of a field</td>
1909 </tr>
1910 <tr>
1911 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1912 <td>a pointer to an int to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1913 </td>
1914 </tr>
1915 <tr>
1916 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1917 <td>TRUE if the value could be set correctly. If there was no field
1918 with <em class="parameter"><code>fieldname</code></em> or the existing field did not contain an enum of the given
1919 type, this function returns FALSE.</td>
1920 </tr>
1921 </tbody>
1922 </table></div>
1923 </div>
1924 <hr>
1925 <div class="refsect2">
1926 <a name="gst-structure-get-fraction"></a><h3>gst_structure_get_fraction ()</h3>
1927 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_get_fraction          (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1928                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *fieldname</code></em>,
1929                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value_numerator</code></em>,
1930                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value_denominator</code></em>);</pre>
1931 <p>
1932 Sets the integers pointed to by <em class="parameter"><code>value_numerator</code></em> and <em class="parameter"><code>value_denominator</code></em>
1933 corresponding to the value of the given field.  Caller is responsible
1934 for making sure the field exists and has the correct type.
1935 </p>
1936 <div class="variablelist"><table border="0">
1937 <col align="left" valign="top">
1938 <tbody>
1939 <tr>
1940 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1941 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1942 </td>
1943 </tr>
1944 <tr>
1945 <td><p><span class="term"><em class="parameter"><code>fieldname</code></em> :</span></p></td>
1946 <td>the name of a field</td>
1947 </tr>
1948 <tr>
1949 <td><p><span class="term"><em class="parameter"><code>value_numerator</code></em> :</span></p></td>
1950 <td>a pointer to an int to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1951 </td>
1952 </tr>
1953 <tr>
1954 <td><p><span class="term"><em class="parameter"><code>value_denominator</code></em> :</span></p></td>
1955 <td>a pointer to an int to set. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
1956 </td>
1957 </tr>
1958 <tr>
1959 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1960 <td>TRUE if the values could be set correctly. If there was no field
1961 with <em class="parameter"><code>fieldname</code></em> or the existing field did not contain a GstFraction, this
1962 function returns FALSE.</td>
1963 </tr>
1964 </tbody>
1965 </table></div>
1966 </div>
1967 <hr>
1968 <div class="refsect2">
1969 <a name="gst-structure-map-in-place"></a><h3>gst_structure_map_in_place ()</h3>
1970 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_map_in_place          (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
1971                                                          <em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructureMapFunc" title="GstStructureMapFunc ()"><span class="type">GstStructureMapFunc</span></a> func</code></em>,
1972                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1973 <p>
1974 Calls the provided function once for each field in the <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>. In
1975 contrast to <a class="link" href="gstreamer-GstStructure.html#gst-structure-foreach" title="gst_structure_foreach ()"><code class="function">gst_structure_foreach()</code></a>, the function may modify but not delete the
1976 fields. The structure must be mutable.
1977 </p>
1978 <div class="variablelist"><table border="0">
1979 <col align="left" valign="top">
1980 <tbody>
1981 <tr>
1982 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
1983 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
1984 </td>
1985 </tr>
1986 <tr>
1987 <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1988 <td>a function to call for each field. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
1989 </td>
1990 </tr>
1991 <tr>
1992 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1993 <td>private data. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
1994 </td>
1995 </tr>
1996 <tr>
1997 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1998 <td>TRUE if the supplied function returns TRUE For each of the fields,
1999 FALSE otherwise.</td>
2000 </tr>
2001 </tbody>
2002 </table></div>
2003 </div>
2004 <hr>
2005 <div class="refsect2">
2006 <a name="gst-structure-nth-field-name"></a><h3>gst_structure_nth_field_name ()</h3>
2007 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_structure_nth_field_name        (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
2008                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
2009 <p>
2010 Get the name of the given field number, counting from 0 onwards.
2011 </p>
2012 <div class="variablelist"><table border="0">
2013 <col align="left" valign="top">
2014 <tbody>
2015 <tr>
2016 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
2017 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
2018 </td>
2019 </tr>
2020 <tr>
2021 <td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
2022 <td>the index to get the name of</td>
2023 </tr>
2024 <tr>
2025 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2026 <td>the name of the given field number</td>
2027 </tr>
2028 </tbody>
2029 </table></div>
2030 </div>
2031 <hr>
2032 <div class="refsect2">
2033 <a name="gst-structure-set-parent-refcount"></a><h3>gst_structure_set_parent_refcount ()</h3>
2034 <pre class="programlisting"><span class="returnvalue">void</span>                gst_structure_set_parent_refcount   (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
2035                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *refcount</code></em>);</pre>
2036 <p>
2037 Sets the parent_refcount field of <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>. This field is used to
2038 determine whether a structure is mutable or not. This function should only be
2039 called by code implementing parent objects of <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>, as described in
2040 the MT Refcounting section of the design documents.
2041 </p>
2042 <div class="variablelist"><table border="0">
2043 <col align="left" valign="top">
2044 <tbody>
2045 <tr>
2046 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
2047 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
2048 </td>
2049 </tr>
2050 <tr>
2051 <td><p><span class="term"><em class="parameter"><code>refcount</code></em> :</span></p></td>
2052 <td>a pointer to the parent's refcount. <span class="annotation">[<acronym title="Parameter for input. Default is transfer none."><span class="acronym">in</span></acronym>]</span>
2053 </td>
2054 </tr>
2055 </tbody>
2056 </table></div>
2057 </div>
2058 <hr>
2059 <div class="refsect2">
2060 <a name="gst-structure-to-string"></a><h3>gst_structure_to_string ()</h3>
2061 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             gst_structure_to_string             (<em class="parameter"><code>const <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>);</pre>
2062 <p>
2063 Converts <em class="parameter"><code>structure</code></em> to a human-readable string representation.
2064 </p>
2065 <p>
2066 For debugging purposes its easier to do something like this:
2067 </p>
2068 <div class="informalexample">
2069   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2070     <tbody>
2071       <tr>
2072         <td class="listing_lines" align="right"><pre>1</pre></td>
2073         <td class="listing_code"><pre class="programlisting"><span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstInfo.html#GST-LOG:CAPS">GST_LOG</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;structure is %&quot;</span> GST_PTR_FORMAT<span class="gtkdoc opt">,</span> structure<span class="gtkdoc opt">);</span></pre></td>
2074       </tr>
2075     </tbody>
2076   </table>
2077 </div>
2078
2079 <p>
2080 This prints the structure in human readble form.
2081 </p>
2082 <p>
2083 Free-function: g_free
2084 </p>
2085 <div class="variablelist"><table border="0">
2086 <col align="left" valign="top">
2087 <tbody>
2088 <tr>
2089 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
2090 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
2091 </td>
2092 </tr>
2093 <tr>
2094 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2095 <td>(transfer full)L a pointer to string allocated by <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-malloc"><code class="function">g_malloc()</code></a>.
2096 <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after usage.</td>
2097 </tr>
2098 </tbody>
2099 </table></div>
2100 </div>
2101 <hr>
2102 <div class="refsect2">
2103 <a name="gst-structure-from-string"></a><h3>gst_structure_from_string ()</h3>
2104 <pre class="programlisting"><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="returnvalue">GstStructure</span></a> *      gst_structure_from_string           (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>,
2105                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **end</code></em>);</pre>
2106 <p>
2107 Creates a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> from a string representation.
2108 If end is not NULL, a pointer to the place inside the given string
2109 where parsing ended will be returned.
2110 </p>
2111 <p>
2112 Free-function: gst_structure_free
2113 </p>
2114 <div class="variablelist"><table border="0">
2115 <col align="left" valign="top">
2116 <tbody>
2117 <tr>
2118 <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
2119 <td>a string representation of a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>.</td>
2120 </tr>
2121 <tr>
2122 <td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
2123 <td>pointer to store the end of the string in. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2124 </td>
2125 </tr>
2126 <tr>
2127 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2128 <td>a new <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> or NULL when the string could
2129 not be parsed. Free with <a class="link" href="gstreamer-GstStructure.html#gst-structure-free" title="gst_structure_free ()"><code class="function">gst_structure_free()</code></a> after use. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2130 </td>
2131 </tr>
2132 </tbody>
2133 </table></div>
2134 </div>
2135 <hr>
2136 <div class="refsect2">
2137 <a name="gst-structure-fixate-field-nearest-int"></a><h3>gst_structure_fixate_field_nearest_int ()</h3>
2138 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_fixate_field_nearest_int
2139                                                         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
2140                                                          <em class="parameter"><code>const <span class="type">char</span> *field_name</code></em>,
2141                                                          <em class="parameter"><code><span class="type">int</span> target</code></em>);</pre>
2142 <p>
2143 Fixates a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> by changing the given field to the nearest
2144 integer to <em class="parameter"><code>target</code></em> that is a subset of the existing field.
2145 </p>
2146 <div class="variablelist"><table border="0">
2147 <col align="left" valign="top">
2148 <tbody>
2149 <tr>
2150 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
2151 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
2152 </td>
2153 </tr>
2154 <tr>
2155 <td><p><span class="term"><em class="parameter"><code>field_name</code></em> :</span></p></td>
2156 <td>a field in <em class="parameter"><code>structure</code></em>
2157 </td>
2158 </tr>
2159 <tr>
2160 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
2161 <td>the target value of the fixation</td>
2162 </tr>
2163 <tr>
2164 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2165 <td>TRUE if the structure could be fixated</td>
2166 </tr>
2167 </tbody>
2168 </table></div>
2169 </div>
2170 <hr>
2171 <div class="refsect2">
2172 <a name="gst-structure-fixate-field-nearest-double"></a><h3>gst_structure_fixate_field_nearest_double ()</h3>
2173 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_fixate_field_nearest_double
2174                                                         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
2175                                                          <em class="parameter"><code>const <span class="type">char</span> *field_name</code></em>,
2176                                                          <em class="parameter"><code><span class="type">double</span> target</code></em>);</pre>
2177 <p>
2178 Fixates a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> by changing the given field to the nearest
2179 double to <em class="parameter"><code>target</code></em> that is a subset of the existing field.
2180 </p>
2181 <div class="variablelist"><table border="0">
2182 <col align="left" valign="top">
2183 <tbody>
2184 <tr>
2185 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
2186 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
2187 </td>
2188 </tr>
2189 <tr>
2190 <td><p><span class="term"><em class="parameter"><code>field_name</code></em> :</span></p></td>
2191 <td>a field in <em class="parameter"><code>structure</code></em>
2192 </td>
2193 </tr>
2194 <tr>
2195 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
2196 <td>the target value of the fixation</td>
2197 </tr>
2198 <tr>
2199 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2200 <td>TRUE if the structure could be fixated</td>
2201 </tr>
2202 </tbody>
2203 </table></div>
2204 </div>
2205 <hr>
2206 <div class="refsect2">
2207 <a name="gst-structure-fixate-field-nearest-fraction"></a><h3>gst_structure_fixate_field_nearest_fraction ()</h3>
2208 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_fixate_field_nearest_fraction
2209                                                         (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
2210                                                          <em class="parameter"><code>const <span class="type">char</span> *field_name</code></em>,
2211                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> target_numerator</code></em>,
2212                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> target_denominator</code></em>);</pre>
2213 <p>
2214 Fixates a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> by changing the given field to the nearest
2215 fraction to <em class="parameter"><code>target_numerator</code></em>/<em class="parameter"><code>target_denominator</code></em> that is a subset
2216 of the existing field.
2217 </p>
2218 <div class="variablelist"><table border="0">
2219 <col align="left" valign="top">
2220 <tbody>
2221 <tr>
2222 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
2223 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
2224 </td>
2225 </tr>
2226 <tr>
2227 <td><p><span class="term"><em class="parameter"><code>field_name</code></em> :</span></p></td>
2228 <td>a field in <em class="parameter"><code>structure</code></em>
2229 </td>
2230 </tr>
2231 <tr>
2232 <td><p><span class="term"><em class="parameter"><code>target_numerator</code></em> :</span></p></td>
2233 <td>The numerator of the target value of the fixation</td>
2234 </tr>
2235 <tr>
2236 <td><p><span class="term"><em class="parameter"><code>target_denominator</code></em> :</span></p></td>
2237 <td>The denominator of the target value of the fixation</td>
2238 </tr>
2239 <tr>
2240 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2241 <td>TRUE if the structure could be fixated</td>
2242 </tr>
2243 </tbody>
2244 </table></div>
2245 </div>
2246 <hr>
2247 <div class="refsect2">
2248 <a name="gst-structure-fixate-field-boolean"></a><h3>gst_structure_fixate_field_boolean ()</h3>
2249 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_fixate_field_boolean  (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
2250                                                          <em class="parameter"><code>const <span class="type">char</span> *field_name</code></em>,
2251                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> target</code></em>);</pre>
2252 <p>
2253 Fixates a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> by changing the given <em class="parameter"><code>field_name</code></em> field to the given
2254 <em class="parameter"><code>target</code></em> boolean if that field is not fixed yet.
2255 </p>
2256 <div class="variablelist"><table border="0">
2257 <col align="left" valign="top">
2258 <tbody>
2259 <tr>
2260 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
2261 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
2262 </td>
2263 </tr>
2264 <tr>
2265 <td><p><span class="term"><em class="parameter"><code>field_name</code></em> :</span></p></td>
2266 <td>a field in <em class="parameter"><code>structure</code></em>
2267 </td>
2268 </tr>
2269 <tr>
2270 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
2271 <td>the target value of the fixation</td>
2272 </tr>
2273 <tr>
2274 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2275 <td>TRUE if the structure could be fixated</td>
2276 </tr>
2277 </tbody>
2278 </table></div>
2279 </div>
2280 <hr>
2281 <div class="refsect2">
2282 <a name="gst-structure-fixate-field-string"></a><h3>gst_structure_fixate_field_string ()</h3>
2283 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_structure_fixate_field_string   (<em class="parameter"><code><a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> *structure</code></em>,
2284                                                          <em class="parameter"><code>const <span class="type">char</span> *field_name</code></em>,
2285                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *target</code></em>);</pre>
2286 <p>
2287 Fixates a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a> by changing the given <em class="parameter"><code>field_name</code></em> field to the given
2288 <em class="parameter"><code>target</code></em> string if that field is not fixed yet.
2289 </p>
2290 <div class="variablelist"><table border="0">
2291 <col align="left" valign="top">
2292 <tbody>
2293 <tr>
2294 <td><p><span class="term"><em class="parameter"><code>structure</code></em> :</span></p></td>
2295 <td>a <a class="link" href="gstreamer-GstStructure.html#GstStructure" title="struct GstStructure"><span class="type">GstStructure</span></a>
2296 </td>
2297 </tr>
2298 <tr>
2299 <td><p><span class="term"><em class="parameter"><code>field_name</code></em> :</span></p></td>
2300 <td>a field in <em class="parameter"><code>structure</code></em>
2301 </td>
2302 </tr>
2303 <tr>
2304 <td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
2305 <td>the target value of the fixation</td>
2306 </tr>
2307 <tr>
2308 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2309 <td>TRUE if the structure could be fixated</td>
2310 </tr>
2311 </tbody>
2312 </table></div>
2313 <p class="since">Since 0.10.30</p>
2314 </div>
2315 </div>
2316 <div class="refsect1">
2317 <a name="gstreamer-GstStructure.see-also"></a><h2>See Also</h2>
2318 <a class="link" href="gstreamer-GstCaps.html#GstCaps" title="struct GstCaps"><span class="type">GstCaps</span></a>, <a class="link" href="gstreamer-GstMessage.html#GstMessage" title="struct GstMessage"><span class="type">GstMessage</span></a>, <a class="link" href="gstreamer-GstEvent.html#GstEvent" title="struct GstEvent"><span class="type">GstEvent</span></a>, <a class="link" href="gstreamer-GstQuery.html#GstQuery" title="struct GstQuery"><span class="type">GstQuery</span></a>
2319 </div>
2320 </div>
2321 <div class="footer">
2322 <hr>
2323           Generated by GTK-Doc V1.18</div>
2324 </body>
2325 </html>