/*
    Copyright (C) 2018 Thomas Schmitt
    Copyright (C) 2005, 2008, 2012 Rocky Bernstein <rocky@gnu.org>

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program 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 General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

/** \file cdtext.hpp
 *  \brief methods relating to CD-Text information. This file
 *  should not be #included directly.
 */

/*! Return string representation of the enum values above */
const char *field2str (cdtext_field_t i)
{
  return cdtext_field2str (i);
}

const char *genre2str (cdtext_genre_t i)
{
  return cdtext_genre2str (i);
}

const char *lang2str (cdtext_lang_t i)
{
  return cdtext_lang2str (i);
}

/*! returns an allocated string associated with the given field.  NULL is
  returned if key is CDTEXT_INVALID or the field is not set.

  The user needs to free the string using cdio_free() when done with it.

  @see getConst to retrieve a constant string that doesn't
  have to be freed.

*/
char *get (cdtext_field_t key, track_t i_track)
{
  return cdtext_get (p_cdtext, key, i_track);
}

/*! returns a const string associated with the given field.  NULL is
  returned if key is CDTEXT_INVALID or the field is not set.

  Don't use the string when the cdtext object (i.e. the CdIo_t object
  you got it from) is no longer valid.

  @see cdio_get to retrieve an allocated string that persists past the
  cdtext object.

*/
const char *getConst (cdtext_field_t key, track_t i_track)
{
  return cdtext_get_const (p_cdtext, key, i_track);
}

/*!
  sets cdtext's keyword entry to field
*/
void set (cdtext_field_t key, track_t i_track, const uint8_t *value, const char *charset)
{
  cdtext_set (p_cdtext, key, value, i_track, charset);
}

/*!
  returns the selected language
*/
cdtext_lang_t getLanguage()
{
  return cdtext_get_language(p_cdtext);
}

/*!
  selects a language
*/
bool selectLanguage(cdtext_lang_t lang)
{
  return cdtext_select_language(p_cdtext, lang);
}

/*!
  selects a language by index rather than language code
*/
bool setLanguageIndex(int idx)
{
  return cdtext_set_language_index(p_cdtext, idx);
}

/*!

  @deprecated. Use listLanguagesV2(), see cdio/cdtext.h

  returns a list of available languages (which has various problems)
*/
cdtext_lang_t *listLanguages()
{
  return cdtext_list_languages(p_cdtext);
}

/*!
  returns a pointer to an array with 8 elements which indicate available
  languages
*/
cdtext_lang_t *listLanguagesV2()
{
  return cdtext_list_languages_v2(p_cdtext);
}


/*
 * Local variables:
 *  c-file-style: "gnu"
 *  tab-width: 8
 *  indent-tabs-mode: nil
 * End:
 */
