/* libquvi

 * Copyright (C) 2013  Toni Gundogdu <legatvs@gmail.com>

 *

 * This file is part of libquvi <http://quvi.sourceforge.net/>.

 *

 * This library is free software: you can redistribute it and/or

 * modify it under the terms of the GNU Affero General Public

 * License as published by the Free Software Foundation, either

 * version 3 of the License, or (at your option) any later version.

 *

 * This library is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU Affero General Public License for more details.

 *

 * You should have received a copy of the GNU Affero General

 * Public License along with this library.  If not, see

 * <http://www.gnu.org/licenses/>.

 */

/** @file subtitle_select.c */

#include "config.h"

#include <glib/gi18n-lib.h>

#include <glib.h>

#include "quvi.h"

/* -- */

#include "_quvi_s.h"

#include "_quvi_subtitle_s.h"

/* -- */

#include "misc/re.h"

static _quvi_subtitle_lang_t _match(_quvi_subtitle_t qsub, const gchar *id)

{

  _quvi_subtitle_type_t qst;

  _quvi_subtitle_lang_t qsl;

  quvi_subtitle_type_reset(qsub);

  while ( (qst = quvi_subtitle_type_next(qsub)) != NULL)

    {

      quvi_subtitle_lang_reset(qst);

      while ( (qsl = quvi_subtitle_lang_next(qst)) != NULL)

        {

          if (m_match(qsl->id->str, id) == TRUE)

            return (qsl);

        }

    }

  return (NULL);

}

/* Return the first available language of the first available type. */

static _quvi_subtitle_lang_t _default(_quvi_subtitle_t qsub)

{

  _quvi_subtitle_type_t qst;

  quvi_subtitle_type_reset(qsub);

  qst = quvi_subtitle_type_next(qsub);

  if (qst == NULL)

    return (NULL);

  quvi_subtitle_lang_reset(qst);

  return (quvi_subtitle_lang_next(qst));

}

static _quvi_subtitle_lang_t _select(_quvi_subtitle_t qsub, const gchar *id)

{

  _quvi_subtitle_lang_t qsl;

  gchar **r;

  _quvi_t q;

  gint i;

  r = g_strsplit(id, ",", 0);

  q = qsub->handle.quvi;

  q->status.rc = QUVI_OK;

  qsl = NULL;

  for (i=0; (r[i] != NULL && qsl == NULL); ++i)

    {

      if (g_strcmp0(r[i], "croak") ==0)

        {

          q->status.rc = QUVI_ERROR_KEYWORD_CROAK;

          break;

        }

      else

        qsl = _match(qsub, r[i]);

    }

  g_strfreev(r);

  return ((qsl == NULL && q->status.rc == QUVI_OK)

          ? _default(qsub)

          : qsl);

}

/** @brief Select a @ref sub_lang matching a @ref sub_lang_id

Matches the @ref sub_lang_id (pattern) to the available subtitle

language IDs and selects the language. This function returns immediately

if a matching ID was found.  The ID value may be a comma-separated value

(e.g. "foo,bar,baz"). The ID may also contain the keyword 'croak' (see

the notes below).

@note

  - ID value is used as regular expression pattern

  - ID may contain the keyword 'croak'

    - This will cause the function to exit immediately when it is reached

    - The result may be checked with @ref quvi_ok

      - The code may be retrieved using @ref quvi_get

      - The error message may be retrieved using @ref quvi_errmsg

  - If nothing matched (and the 'croak' keyword was not specified) the

    function will either:

      - return the first (default) available language, or

      - NULL if the library failed to find any subtitle languages for

        the media

  - Always confirm the result with @ref quvi_ok

  - Calling this function will reset the list pointers for both

    @ref sub_type and @ref sub_lang

@sa @ref parse_subtitle

@sa quvi_subtitle_type_reset

@sa quvi_subtitle_lang_reset

@sa quvi_subtitle_type_next

@sa quvi_subtitle_lang_next

@sa quvi_subtitle_new

@ingroup subprop

*/

const quvi_subtitle_lang_t

quvi_subtitle_select(quvi_subtitle_t handle, const char *id)

{

  /* If G_DISABLE_CHECKS is defined then the check is not performed. */

  g_return_val_if_fail(handle != NULL, NULL);

  g_return_val_if_fail(id != NULL, NULL);

  return (_select(handle, id));

}

/* vim: set ts=2 sw=2 tw=72 expandtab: */