get_region_data_nth
Description:
public unowned string get_region_data_nth (uint index, out unowned DateTime publication_date, out unowned string certificate)
Returns the media's age certificate and publication date for one region.
Use length with GRL_METADATA_KEY_REGION to discover how many regions are available. For instance: <informalexample> <programlisting role="C"><![CDATA[ guint count = grl_data_length (GRL_DATA (media), GRL_METADATA_KEY_REGION); guint i; for (i = 0; i < count; ++i) { const GDateTime* publication_date = NULL; const gchar* certificate = NULL; const gchar* region = grl_media_get_region_data_nth (media, i, &publication_date, &certificate); ... } ]]></programlisting > </informalexample>
Parameters:
| this |
the media object |
| index |
element to retrieve |
| publication_date |
the publication date, or null to ignore. |
| certificate |
the age certification, or null to ignore. |
Returns:
|
the ISO-3166-1 of the region where the media was published (owned by this). |