skins2: fix typo in documentation
[vlc/asuraparaju-public.git] / include / vlc_charset.h
blobaaa9d58a6526d891d5a8cd10524a7debd10b24dd
1 /*****************************************************************************
2 * charset.h: Unicode UTF-8 wrappers function
3 *****************************************************************************
4 * Copyright (C) 2003-2005 the VideoLAN team
5 * Copyright © 2005-2010 Rémi Denis-Courmont
6 * $Id$
8 * Author: Rémi Denis-Courmont <rem # videolan,org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
25 #ifndef VLC_CHARSET_H
26 #define VLC_CHARSET_H 1
28 /**
29 * \file
30 * This files handles locale conversions in vlc
33 #include <stdarg.h>
35 VLC_EXPORT( void, LocaleFree, ( const char * ) );
36 VLC_EXPORT( char *, FromLocale, ( const char * ) LIBVLC_USED );
37 VLC_EXPORT( char *, FromLocaleDup, ( const char * ) LIBVLC_USED );
38 VLC_EXPORT( char *, ToLocale, ( const char * ) LIBVLC_USED );
39 VLC_EXPORT( char *, ToLocaleDup, ( const char * ) LIBVLC_USED );
41 VLC_EXPORT( int, utf8_vfprintf, ( FILE *stream, const char *fmt, va_list ap ) );
42 VLC_EXPORT( int, utf8_fprintf, ( FILE *, const char *, ... ) LIBVLC_FORMAT( 2, 3 ) );
44 VLC_EXPORT( char *, EnsureUTF8, ( char * ) );
45 VLC_EXPORT( const char *, IsUTF8, ( const char * ) LIBVLC_USED );
47 #ifdef WIN32
48 LIBVLC_USED
49 static inline char *FromWide (const wchar_t *wide)
51 size_t len = WideCharToMultiByte (CP_UTF8, 0, wide, -1, NULL, 0, NULL, NULL);
52 if (len == 0)
53 return NULL;
55 char *out = (char *)malloc (len);
57 if (out)
58 WideCharToMultiByte (CP_UTF8, 0, wide, -1, out, len, NULL, NULL);
59 return out;
61 #endif
63 /**
64 * Converts a nul-terminated string from ISO-8859-1 to UTF-8.
66 static inline char *FromLatin1 (const char *latin)
68 char *str = (char *)malloc (2 * strlen (latin) + 1), *utf8 = str;
69 unsigned char c;
71 if (str == NULL)
72 return NULL;
74 while ((c = *(latin++)) != '\0')
76 if (c >= 0x80)
78 *(utf8++) = 0xC0 | (c >> 6);
79 *(utf8++) = 0x80 | (c & 0x3F);
81 else
82 *(utf8++) = c;
84 *(utf8++) = '\0';
86 utf8 = (char *)realloc (str, utf8 - str);
87 return utf8 ? utf8 : str;
90 VLC_EXPORT( char *, FromCharset, ( const char *charset, const void *data, size_t data_size ) LIBVLC_USED );
92 VLC_EXPORT( double, us_strtod, ( const char *, char ** ) LIBVLC_USED );
93 VLC_EXPORT( float, us_strtof, ( const char *, char ** ) LIBVLC_USED );
94 VLC_EXPORT( double, us_atof, ( const char * ) LIBVLC_USED );
95 VLC_EXPORT( int, us_asprintf, ( char **, const char *, ... ) LIBVLC_USED );
97 #endif