GDBusInterfaceVTable: clarify memory handling for the method() virtual function
[platform/upstream/glib.git] / gio / xdgmime / xdgmimecache.h
1 /* -*- mode: C; c-file-style: "gnu" -*- */
2 /* xdgmimecache.h: Private file.  Datastructure for mmapped caches.
3  *
4  * More info can be found at http://www.freedesktop.org/standards/
5  *
6  * Copyright (C) 2005  Matthias Clasen <mclasen@redhat.com>
7  *
8  * Licensed under the Academic Free License version 2.0
9  * Or under the following terms:
10  *
11  * This library is free software; you can redistribute it and/or
12  * modify it under the terms of the GNU Lesser General Public
13  * License as published by the Free Software Foundation; either
14  * version 2 of the License, or (at your option) any later version.
15  *
16  * This library is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
19  * Lesser General Public License for more details.
20  *
21  * You should have received a copy of the GNU Lesser General Public
22  * License along with this library; if not, see <http://www.gnu.org/licenses/>.
23  */
24
25 #ifndef __XDG_MIME_CACHE_H__
26 #define __XDG_MIME_CACHE_H__
27
28 #include "xdgmime.h"
29
30 typedef struct _XdgMimeCache XdgMimeCache;
31
32 #ifdef XDG_PREFIX
33 #define _xdg_mime_cache_new_from_file                 XDG_RESERVED_ENTRY(cache_new_from_file)
34 #define _xdg_mime_cache_ref                           XDG_RESERVED_ENTRY(cache_ref)
35 #define _xdg_mime_cache_unref                         XDG_RESERVED_ENTRY(cache_unref)
36 #define _xdg_mime_cache_get_max_buffer_extents        XDG_RESERVED_ENTRY(cache_get_max_buffer_extents)
37 #define _xdg_mime_cache_get_mime_type_for_data        XDG_RESERVED_ENTRY(cache_get_mime_type_for_data)
38 #define _xdg_mime_cache_get_mime_type_for_file        XDG_RESERVED_ENTRY(cache_get_mime_type_for_file)
39 #define _xdg_mime_cache_get_mime_type_from_file_name  XDG_RESERVED_ENTRY(cache_get_mime_type_from_file_name)
40 #define _xdg_mime_cache_get_mime_types_from_file_name XDG_RESERVED_ENTRY(cache_get_mime_types_from_file_name)
41 #define _xdg_mime_cache_list_mime_parents             XDG_RESERVED_ENTRY(cache_list_mime_parents)
42 #define _xdg_mime_cache_mime_type_subclass            XDG_RESERVED_ENTRY(cache_mime_type_subclass)
43 #define _xdg_mime_cache_unalias_mime_type             XDG_RESERVED_ENTRY(cache_unalias_mime_type)
44 #define _xdg_mime_cache_get_icon                      XDG_RESERVED_ENTRY(cache_get_icon)
45 #define _xdg_mime_cache_get_generic_icon              XDG_RESERVED_ENTRY(cache_get_generic_icon)
46 #define _xdg_mime_cache_glob_dump                     XDG_RESERVED_ENTRY(cache_glob_dump)
47 #endif
48
49 extern XdgMimeCache **_caches;
50
51 XdgMimeCache *_xdg_mime_cache_new_from_file (const char   *file_name);
52 XdgMimeCache *_xdg_mime_cache_ref           (XdgMimeCache *cache);
53 void          _xdg_mime_cache_unref         (XdgMimeCache *cache);
54
55
56 const char  *_xdg_mime_cache_get_mime_type_for_data       (const void *data,
57                                                            size_t      len,
58                                                            int        *result_prio);
59 #ifdef NOT_USED_IN_GIO
60 const char  *_xdg_mime_cache_get_mime_type_for_file       (const char  *file_name,
61                                                            struct stat *statbuf);
62 #endif
63 int          _xdg_mime_cache_get_mime_types_from_file_name (const char *file_name,
64                                                             const char  *mime_types[],
65                                                             int          n_mime_types);
66 #ifdef NOT_USED_IN_GIO
67 const char  *_xdg_mime_cache_get_mime_type_from_file_name (const char *file_name);
68 #endif
69 int          _xdg_mime_cache_is_valid_mime_type           (const char *mime_type);
70 int          _xdg_mime_cache_mime_type_equal              (const char *mime_a,
71                                                            const char *mime_b);
72 int          _xdg_mime_cache_media_type_equal             (const char *mime_a,
73                                                            const char *mime_b);
74 int          _xdg_mime_cache_mime_type_subclass           (const char *mime_a,
75                                                            const char *mime_b);
76 char       **_xdg_mime_cache_list_mime_parents            (const char *mime);
77 const char  *_xdg_mime_cache_unalias_mime_type            (const char *mime);
78 int          _xdg_mime_cache_get_max_buffer_extents       (void);
79 const char  *_xdg_mime_cache_get_icon                     (const char *mime);
80 const char  *_xdg_mime_cache_get_generic_icon             (const char *mime);
81 #ifdef NOT_USED_IN_GIO
82 void         _xdg_mime_cache_glob_dump                    (void);
83 #endif
84
85 #endif /* __XDG_MIME_CACHE_H__ */