Method

GrlMediaget_region_data_nth

since: 0.2.3

Declaration [src]

const gchar*
grl_media_get_region_data_nth (
  GrlMedia* media,
  guint index,
  const GDateTime** publication_date,
  const gchar** certificate
)

Description [src]

Returns the media’s age certificate and publication date for one region. Use grl_data_length() with GRL_METADATA_KEY_REGION to discover how many regions are available. For instance: <![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); … } ]]>

Available since: 0.2.3

Parameters

index

Type: guint

Element to retrieve.

publication_date

Type: GDateTime

The publication date, or NULL to ignore.

The argument will be set by the function.

The data is owned by the instance.

certificate

Type: const gchar**

The age certification, or NULL to ignore.

The argument will be set by the function.

The data is owned by the instance.

The value is a NUL terminated UTF-8 string.

Return value

Type: const gchar*

The ISO-3166-1 of the region where the media was published (owned by media).

The data is owned by the instance.

The value is a NUL terminated UTF-8 string.