Make constructor-based resource registration malloc free
[platform/upstream/glib.git] / gio / gresource.h
1 /* GIO - GLib Input, Output and Streaming Library
2  *
3  * Copyright (C) 2006-2007 Red Hat, Inc.
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library 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 GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General
16  * Public License along with this library; if not, write to the
17  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18  * Boston, MA 02111-1307, USA.
19  *
20  * Author: Alexander Larsson <alexl@redhat.com>
21  */
22
23 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
24 #error "Only <gio/gio.h> can be included directly."
25 #endif
26
27 #ifndef __G_RESOURCE_H__
28 #define __G_RESOURCE_H__
29
30 #include <gio/giotypes.h>
31
32 G_BEGIN_DECLS
33
34 /**
35  * G_TYPE_RESOURCE:
36  *
37  * The #GType for #GResource.
38  */
39 #define G_TYPE_RESOURCE (g_resource_get_type ())
40
41
42 /**
43  * G_RESOURCE_ERROR:
44  *
45  * Error domain for #GResource. Errors in this domain will be from the
46  * #GResourceError enumeration. See #GError for more information on
47  * error domains.
48  */
49 #define G_RESOURCE_ERROR (g_resource_error_quark ())
50 GQuark g_resource_error_quark (void);
51
52 typedef struct _GStaticResource GStaticResource;
53
54 struct _GStaticResource {
55   const guint8 *data;
56   gsize data_len;
57   GResource *resource;
58   GStaticResource *next;
59   gpointer padding;
60 };
61
62 GType         g_resource_get_type            (void) G_GNUC_CONST;
63 GResource *   g_resource_new_from_data       (GBytes                *data,
64                                               GError               **error);
65 GResource *   g_resource_ref                 (GResource             *resource);
66 void          g_resource_unref               (GResource             *resource);
67 GResource *   g_resource_load                (const gchar           *filename,
68                                               GError               **error);
69 GInputStream *g_resource_open_stream         (GResource             *resource,
70                                               const char            *path,
71                                               GResourceLookupFlags   lookup_flags,
72                                               GError               **error);
73 GBytes *      g_resource_lookup_data         (GResource             *resource,
74                                               const char            *path,
75                                               GResourceLookupFlags   lookup_flags,
76                                               GError               **error);
77 char **       g_resource_enumerate_children  (GResource             *resource,
78                                               const char            *path,
79                                               GResourceLookupFlags   lookup_flags,
80                                               GError               **error);
81 gboolean      g_resource_get_info            (GResource             *resource,
82                                               const char            *path,
83                                               GResourceLookupFlags   lookup_flags,
84                                               gsize                 *size,
85                                               guint32               *flags,
86                                               GError               **error);
87
88 void          g_resources_register           (GResource             *resource);
89 void          g_resources_unregister         (GResource             *resource);
90 GInputStream *g_resources_open_stream        (const char            *path,
91                                               GResourceLookupFlags   lookup_flags,
92                                               GError               **error);
93 GBytes *      g_resources_lookup_data        (const char            *path,
94                                               GResourceLookupFlags   lookup_flags,
95                                               GError               **error);
96 char **       g_resources_enumerate_children (const char            *path,
97                                               GResourceLookupFlags   lookup_flags,
98                                               GError               **error);
99 gboolean      g_resources_get_info           (const char            *path,
100                                               GResourceLookupFlags   lookup_flags,
101                                               gsize                 *size,
102                                               guint32               *flags,
103                                               GError               **error);
104
105
106 void          g_static_resource_init          (GStaticResource *static_resource);
107 void          g_static_resource_fini          (GStaticResource *static_resource);
108 GResource    *g_static_resource_get_resource  (GStaticResource *static_resource);
109
110 G_END_DECLS
111
112 #endif /* __G_RESOURCE_H__ */