src/charset.h

   1 /* ncmpc (Ncurses MPD Client)
   2  * (c) 2004-2009 The Music Player Daemon Project
   3  * Project homepage: http://musicpd.org
   4
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; if not, write to the Free Software Foundation, Inc.,
  17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 */
  19
  20 #ifndef CHARSET_H
  21 #define CHARSET_H
  22
  23 #include "config.h"
  24
  25 #include <glib.h>
  26
  27 #include <stdbool.h>
  28
  29 #ifdef ENABLE_LOCALE
  30 const char *
  31 charset_init(void);
  32 #endif
  33
  34 /**
  35  * Returns the number of terminal cells occupied by this string.
  36  */
  37 G_GNUC_PURE
  38 unsigned
  39 utf8_width(const char *str);
  40
  41 /**
  42  * Returns the number of terminal cells occupied by this string.
  43  */
  44 G_GNUC_PURE
  45 unsigned
  46 locale_width(const char *p);
  47
  48 /**
  49  * Limits the width of the specified string.  Cuts it off before the
  50  * specified width is exceeded.
  51  *
  52  * @return the resulting width of the string
  53  */
  54 unsigned
  55 utf8_cut_width(char *p, unsigned max_width);
  56
  57 char *utf8_to_locale(const char *str);
  58 char *locale_to_utf8(const char *str);
  59
  60 /**
  61  * Converts the UTF-8 string to the locale, and frees the source
  62  * pointer.  Returns the source pointer as-is if no conversion is
  63  * required.
  64  */
  65 char *
  66 replace_utf8_to_locale(char *src);
  67
  68 /**
  69  * Converts the locale string to UTF-8, and frees the source pointer.
  70  * Returns the source pointer as-is if no conversion is required.
  71  */
  72 char *
  73 replace_locale_to_utf8(char *src);
  74
  75 #endif