source: trunk/third/glib2/glib/gconvert.h @ 20721

Revision 20721, 3.8 KB checked in by ghudson, 20 years ago (diff)
This commit was generated by cvs2svn to compensate for changes in r20720, which included commits to RCS files with non-trunk default branches.
Line 
1/* GLIB - Library of useful routines for C programming
2 * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
18 */
19
20/*
21 * Modified by the GLib Team and others 1997-2000.  See the AUTHORS
22 * file for a list of people on the GLib Team.  See the ChangeLog
23 * files for a list of changes.  These files are distributed with
24 * GLib at ftp://ftp.gtk.org/pub/gtk/.
25 */
26
27#ifndef __G_CONVERT_H__
28#define __G_CONVERT_H__
29
30#include <stddef.h>      /* For size_t */
31#include <glib/gerror.h>
32
33G_BEGIN_DECLS
34
35typedef enum
36{
37  G_CONVERT_ERROR_NO_CONVERSION,
38  G_CONVERT_ERROR_ILLEGAL_SEQUENCE,
39  G_CONVERT_ERROR_FAILED,
40  G_CONVERT_ERROR_PARTIAL_INPUT,
41  G_CONVERT_ERROR_BAD_URI,
42  G_CONVERT_ERROR_NOT_ABSOLUTE_PATH
43} GConvertError;
44
45#define G_CONVERT_ERROR g_convert_error_quark()
46GQuark g_convert_error_quark (void);
47
48/* Thin wrappers around iconv
49 */
50typedef struct _GIConv *GIConv;
51
52GIConv g_iconv_open   (const gchar  *to_codeset,
53                       const gchar  *from_codeset);
54size_t g_iconv        (GIConv        converter,
55                       gchar       **inbuf,
56                       gsize        *inbytes_left,
57                       gchar       **outbuf,
58                       gsize        *outbytes_left);
59gint   g_iconv_close  (GIConv        converter);
60
61
62gchar* g_convert               (const gchar  *str,
63                                gssize        len,           
64                                const gchar  *to_codeset,
65                                const gchar  *from_codeset,
66                                gsize        *bytes_read,     
67                                gsize        *bytes_written, 
68                                GError      **error);
69gchar* g_convert_with_iconv    (const gchar  *str,
70                                gssize        len,
71                                GIConv        converter,
72                                gsize        *bytes_read,     
73                                gsize        *bytes_written, 
74                                GError      **error);
75gchar* g_convert_with_fallback (const gchar  *str,
76                                gssize        len,           
77                                const gchar  *to_codeset,
78                                const gchar  *from_codeset,
79                                gchar        *fallback,
80                                gsize        *bytes_read,     
81                                gsize        *bytes_written, 
82                                GError      **error);
83
84
85/* Convert between libc's idea of strings and UTF-8.
86 */
87gchar* g_locale_to_utf8   (const gchar  *opsysstring,
88                           gssize        len,           
89                           gsize        *bytes_read,     
90                           gsize        *bytes_written, 
91                           GError      **error);
92gchar* g_locale_from_utf8 (const gchar  *utf8string,
93                           gssize        len,           
94                           gsize        *bytes_read,     
95                           gsize        *bytes_written, 
96                           GError      **error);
97
98/* Convert between the operating system (or C runtime)
99 * representation of file names and UTF-8.
100 */
101gchar* g_filename_to_utf8   (const gchar  *opsysstring,
102                             gssize        len,           
103                             gsize        *bytes_read,     
104                             gsize        *bytes_written, 
105                             GError      **error);
106gchar* g_filename_from_utf8 (const gchar  *utf8string,
107                             gssize        len,           
108                             gsize        *bytes_read,     
109                             gsize        *bytes_written, 
110                             GError      **error);
111
112gchar *g_filename_from_uri (const gchar *uri,
113                            gchar      **hostname,
114                            GError     **error);
115 
116gchar *g_filename_to_uri   (const gchar *filename,
117                            const gchar *hostname,
118                            GError     **error);
119
120
121G_END_DECLS
122
123#endif /* __G_CONVERT_H__ */
Note: See TracBrowser for help on using the repository browser.