Add us_asprintf function
[vlc.git] / include / vlc_charset.h
1 /*****************************************************************************
2  * charset.h: Unicode UTF-8 wrappers function
3  *****************************************************************************
4  * Copyright (C) 2003-2005 the VideoLAN team
5  * Copyright © 2005-2006 Rémi Denis-Courmont
6  * $Id$
7  *
8  * Author: Rémi Denis-Courmont <rem # videolan,org>
9  *
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.
14  *
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.
19  *
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  *****************************************************************************/
24
25 #ifndef VLC_CHARSET_H
26 #define VLC_CHARSET_H 1
27
28 /**
29  * \file
30  * This files handles locale conversions in vlc
31  */
32
33 #include <stdarg.h>
34 #include <sys/types.h>
35 #include <dirent.h>
36
37 VLC_EXPORT( void, LocaleFree, ( const char * ) );
38 VLC_EXPORT( char *, FromLocale, ( const char * ) LIBVLC_USED );
39 VLC_EXPORT( char *, FromLocaleDup, ( const char * ) LIBVLC_USED );
40 VLC_EXPORT( char *, ToLocale, ( const char * ) LIBVLC_USED );
41 VLC_EXPORT( char *, ToLocaleDup, ( const char * ) LIBVLC_USED );
42
43 /* TODO: move all of this to "vlc_fs.h" or something like that */
44 VLC_EXPORT( int, utf8_open, ( const char *filename, int flags, mode_t mode ) LIBVLC_USED );
45 VLC_EXPORT( FILE *, utf8_fopen, ( const char *filename, const char *mode ) LIBVLC_USED );
46 VLC_EXPORT( DIR *, utf8_opendir, ( const char *dirname ) LIBVLC_USED );
47 VLC_EXPORT( char *, utf8_readdir, ( DIR *dir ) LIBVLC_USED );
48 VLC_EXPORT( int, utf8_loaddir, ( DIR *dir, char ***namelist, int (*select)( const char * ), int (*compar)( const char **, const char ** ) ) );
49 VLC_EXPORT( int, utf8_scandir, ( const char *dirname, char ***namelist, int (*select)( const char * ), int (*compar)( const char **, const char ** ) ) );
50 VLC_EXPORT( int, utf8_mkdir, ( const char *filename, mode_t mode ) );
51 VLC_EXPORT( int, utf8_unlink, ( const char *filename ) );
52
53 #if defined( WIN32 ) && !defined( UNDER_CE )
54 # define stat _stati64
55 #endif
56
57 VLC_EXPORT( int, utf8_stat, ( const char *filename, struct stat *buf ) );
58 VLC_EXPORT( int, utf8_lstat, ( const char *filename, struct stat *buf ) );
59
60 VLC_EXPORT( int, utf8_vfprintf, ( FILE *stream, const char *fmt, va_list ap ) );
61 VLC_EXPORT( int, utf8_fprintf, ( FILE *, const char *, ... ) LIBVLC_FORMAT( 2, 3 ) );
62
63 VLC_EXPORT( int, utf8_mkstemp, ( char * ) );
64
65 VLC_EXPORT( char *, EnsureUTF8, ( char * ) );
66 VLC_EXPORT( const char *, IsUTF8, ( const char * ) LIBVLC_USED );
67
68 #ifdef WIN32
69 LIBVLC_USED
70 static inline char *FromWide (const wchar_t *wide)
71 {
72     size_t len = WideCharToMultiByte (CP_UTF8, 0, wide, -1, NULL, 0, NULL, NULL);
73     if (len == 0)
74         return NULL;
75
76     char *out = (char *)malloc (len);
77
78     if (out)
79         WideCharToMultiByte (CP_UTF8, 0, wide, -1, out, len, NULL, NULL);
80     return out;
81 }
82 #endif
83
84 VLC_EXPORT( const char *, GetFallbackEncoding, ( void ) LIBVLC_USED );
85
86 VLC_EXPORT( double, us_strtod, ( const char *, char ** ) LIBVLC_USED );
87 VLC_EXPORT( double, us_atof, ( const char * ) LIBVLC_USED );
88 VLC_EXPORT( int, us_asprintf, ( char **, const char *, ... ) LIBVLC_USED );
89
90 #endif