/** @page parse_media Parsing media properties

libquvi uses a @ref m_script to parse the media properties for a
@ref m_url. You should make a note of the difference of @ref m_prop
and @ref ms_prop. There may be >1 of the latter. See the next section
(@ref qms_properties below) for an example of handling those.

@note The available @ref m_script collection determines which
websites are supported by the library.

These examples use an abort_if_error function which could do nothing
more than check @ref quvi_ok return value and exit if the function
returned QUVI_FALSE. We do not define this function in these examples.

@code
quvi_media_t qm = quvi_media_new(q, URL);
abort_if_error();
{
  char *m_title, *m_url;
  quvi_media_get(qm, QUVI_MEDIA_PROPERTY_TITLE, &m_title);
  quvi_media_get(qm, QUVI_MEDIA_STREAM_PROPERTY_URL, &m_url);
}
quvi_media_free(qm); /* Release when done using it. */
qm = NULL;
@endcode

@sa QuviMediaProperty

@section qms_properties Media stream properties

There may be >1 @ref m_stream available. These may be accessed using the
quvi_media_stream_* function set. The one exception to this is the
@ref quvi_media_get function which is used to query the values from the
library.

@note  Using any of the QUVI_MEDIA_STREAM_PROPERTY_* values
with @ref quvi_media_get will cause the library to advance to the first
media stream in the list. This will make @ref quvi_media_stream_next
function to continue from the second media stream, not the first one
as one might expect.

For example:

@code
quvi_media_t qm = quvi_media_new(q, URL);
abort_if_error();
{
  char *m_title, *m_url;
  quvi_media_get(qm, QUVI_MEDIA_PROPERTY_TITLE, &m_title);

  /* Advances the media stream list, starting from the first. */
  quvi_media_get(qm, QUVI_MEDIA_STREAM_PROPERTY_URL, &m_url);

  /* Would now continue from second stream in the list. */
  while (quvi_media_stream_next(qm) == QUVI_TRUE)
    quvi_media_get(qm, QUVI_MEDIA_STREAM_PROPERTY_URL, &m_url);
}
@endcode

Where as:

@code
quvi_media_t qm = quvi_media_new(q, URL);
abort_if_error();
{
  char *m_title, *m_url;
  quvi_media_get(qm, QUVI_MEDIA_PROPERTY_TITLE, &m_title);

  /* Would start from the first stream in the list. */
  while (quvi_media_stream_next(qm) == QUVI_TRUE)
    quvi_media_get(qm, QUVI_MEDIA_STREAM_PROPERTY_URL, &m_url);
}
@endcode

Alternatively, call @ref quvi_media_stream_reset after the @ref
quvi_media_get call.

@sa @ref select_stream
*/