src/charset.h

   1 /* ncmpc (Ncurses MPD Client)
   2  * (c) 2004-2017 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 #include "Compiler.h"
  25
  26 #include <stdbool.h>
  27
  28 #ifdef ENABLE_LOCALE
  29 const char *
  30 charset_init(void);
  31 #endif
  32
  33 /**
  34  * Returns the number of terminal cells occupied by this string.
  35  */
  36 gcc_pure
  37 unsigned
  38 utf8_width(const char *str);
  39
  40 /**
  41  * Returns the number of terminal cells occupied by this string.
  42  */
  43 gcc_pure
  44 unsigned
  45 locale_width(const char *p);
  46
  47 /**
  48  * Limits the width of the specified string.  Cuts it off before the
  49  * specified width is exceeded.
  50  *
  51  * @return the resulting width of the string
  52  */
  53 unsigned
  54 utf8_cut_width(char *p, unsigned max_width);
  55
  56 char *utf8_to_locale(const char *str);
  57 char *locale_to_utf8(const char *str);
  58
  59 /**
  60  * Converts the UTF-8 string to the locale, and frees the source
  61  * pointer.  Returns the source pointer as-is if no conversion is
  62  * required.
  63  */
  64 char *
  65 replace_utf8_to_locale(char *src);
  66
  67 /**
  68  * Converts the locale string to UTF-8, and frees the source pointer.
  69  * Returns the source pointer as-is if no conversion is required.
  70  */
  71 char *
  72 replace_locale_to_utf8(char *src);
  73
  74 #endif