mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-27 07:56:14 +01:00
b6f7f37427
In order to make xdgmime properly relocatable so that unit tests can use it without it reading and modifying the user’s actual xdgmime files, and without the need to call setenv() (and get tied up with thread safety problems), add a xdg_mime_set_dirs() method to allow the dirs to be overridden. They will still default to the values of $XDG_DATA_HOME and $XDG_DATA_DIRS. Signed-off-by: Philip Withnall <withnall@endlessm.com>
144 lines
6.2 KiB
C
144 lines
6.2 KiB
C
/* -*- mode: C; c-file-style: "gnu" -*- */
|
|
/* xdgmime.h: XDG Mime Spec mime resolver. Based on version 0.11 of the spec.
|
|
*
|
|
* More info can be found at http://www.freedesktop.org/standards/
|
|
*
|
|
* Copyright (C) 2003 Red Hat, Inc.
|
|
* Copyright (C) 2003 Jonathan Blandford <jrb@alum.mit.edu>
|
|
*
|
|
* Licensed under the Academic Free License version 2.0
|
|
* Or under the following terms:
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
|
|
#ifndef __XDG_MIME_H__
|
|
#define __XDG_MIME_H__
|
|
|
|
#include <stdlib.h>
|
|
#include <sys/stat.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
#ifdef XDG_PREFIX
|
|
#define XDG_ENTRY(func) _XDG_ENTRY2(XDG_PREFIX,func)
|
|
#define _XDG_ENTRY2(prefix,func) _XDG_ENTRY3(prefix,func)
|
|
#define _XDG_ENTRY3(prefix,func) prefix##_##func
|
|
|
|
#define XDG_RESERVED_ENTRY(func) _XDG_RESERVED_ENTRY2(XDG_PREFIX,func)
|
|
#define _XDG_RESERVED_ENTRY2(prefix,func) _XDG_RESERVED_ENTRY3(prefix,func)
|
|
#define _XDG_RESERVED_ENTRY3(prefix,func) _##prefix##_##func
|
|
#endif
|
|
|
|
typedef void (*XdgMimeCallback) (void *user_data);
|
|
typedef void (*XdgMimeDestroy) (void *user_data);
|
|
|
|
|
|
#ifdef XDG_PREFIX
|
|
#define xdg_mime_get_mime_type_for_data XDG_ENTRY(get_mime_type_for_data)
|
|
#define xdg_mime_get_mime_type_for_file XDG_ENTRY(get_mime_type_for_file)
|
|
#define xdg_mime_get_mime_type_from_file_name XDG_ENTRY(get_mime_type_from_file_name)
|
|
#define xdg_mime_get_mime_types_from_file_name XDG_ENTRY(get_mime_types_from_file_name)
|
|
#define xdg_mime_is_valid_mime_type XDG_ENTRY(is_valid_mime_type)
|
|
#define xdg_mime_mime_type_equal XDG_ENTRY(mime_type_equal)
|
|
#define xdg_mime_media_type_equal XDG_ENTRY(media_type_equal)
|
|
#define xdg_mime_mime_type_subclass XDG_ENTRY(mime_type_subclass)
|
|
#define xdg_mime_get_mime_parents XDG_ENTRY(get_mime_parents)
|
|
#define xdg_mime_list_mime_parents XDG_ENTRY(list_mime_parents)
|
|
#define xdg_mime_unalias_mime_type XDG_ENTRY(unalias_mime_type)
|
|
#define xdg_mime_get_max_buffer_extents XDG_ENTRY(get_max_buffer_extents)
|
|
#define xdg_mime_shutdown XDG_ENTRY(shutdown)
|
|
#define xdg_mime_dump XDG_ENTRY(dump)
|
|
#define xdg_mime_register_reload_callback XDG_ENTRY(register_reload_callback)
|
|
#define xdg_mime_remove_callback XDG_ENTRY(remove_callback)
|
|
#define xdg_mime_type_unknown XDG_ENTRY(type_unknown)
|
|
#define xdg_mime_type_empty XDG_ENTRY(type_empty)
|
|
#define xdg_mime_type_textplain XDG_ENTRY(type_textplain)
|
|
#define xdg_mime_get_icon XDG_ENTRY(get_icon)
|
|
#define xdg_mime_get_generic_icon XDG_ENTRY(get_generic_icon)
|
|
|
|
#define _xdg_mime_mime_type_subclass XDG_RESERVED_ENTRY(mime_type_subclass)
|
|
#define _xdg_mime_mime_type_equal XDG_RESERVED_ENTRY(mime_type_equal)
|
|
#define _xdg_mime_unalias_mime_type XDG_RESERVED_ENTRY(unalias_mime_type)
|
|
#endif
|
|
|
|
extern const char xdg_mime_type_unknown[];
|
|
extern const char xdg_mime_type_empty[];
|
|
extern const char xdg_mime_type_textplain[];
|
|
#define XDG_MIME_TYPE_UNKNOWN xdg_mime_type_unknown
|
|
#define XDG_MIME_TYPE_EMPTY xdg_mime_type_empty
|
|
#define XDG_MIME_TYPE_TEXTPLAIN xdg_mime_type_textplain
|
|
|
|
const char *xdg_mime_get_mime_type_for_data (const void *data,
|
|
size_t len,
|
|
int *result_prio);
|
|
#ifdef NOT_USED_IN_GIO
|
|
const char *xdg_mime_get_mime_type_for_file (const char *file_name,
|
|
struct stat *statbuf);
|
|
const char *xdg_mime_get_mime_type_from_file_name (const char *file_name);
|
|
#endif
|
|
int xdg_mime_get_mime_types_from_file_name(const char *file_name,
|
|
const char *mime_types[],
|
|
int n_mime_types);
|
|
#ifdef NOT_USED_IN_GIO
|
|
int xdg_mime_is_valid_mime_type (const char *mime_type);
|
|
#endif
|
|
int xdg_mime_mime_type_equal (const char *mime_a,
|
|
const char *mime_b);
|
|
int xdg_mime_media_type_equal (const char *mime_a,
|
|
const char *mime_b);
|
|
int xdg_mime_mime_type_subclass (const char *mime_a,
|
|
const char *mime_b);
|
|
/* xdg_mime_get_mime_parents() is deprecated since it does
|
|
* not work correctly with caches. Use xdg_mime_list_parents()
|
|
* instead, but notice that that function expects you to free
|
|
* the array it returns.
|
|
*/
|
|
#ifdef NOT_USED_IN_GIO
|
|
const char **xdg_mime_get_mime_parents (const char *mime);
|
|
#endif
|
|
char ** xdg_mime_list_mime_parents (const char *mime);
|
|
const char *xdg_mime_unalias_mime_type (const char *mime);
|
|
const char *xdg_mime_get_icon (const char *mime);
|
|
const char *xdg_mime_get_generic_icon (const char *mime);
|
|
int xdg_mime_get_max_buffer_extents (void);
|
|
void xdg_mime_shutdown (void);
|
|
#ifdef NOT_USED_IN_GIO
|
|
void xdg_mime_dump (void);
|
|
#endif
|
|
int xdg_mime_register_reload_callback (XdgMimeCallback callback,
|
|
void *data,
|
|
XdgMimeDestroy destroy);
|
|
#ifdef NOT_USED_IN_GIO
|
|
void xdg_mime_remove_callback (int callback_id);
|
|
#endif
|
|
|
|
void xdg_mime_set_dirs (const char * const *dirs);
|
|
|
|
/* Private versions of functions that don't call xdg_mime_init () */
|
|
int _xdg_mime_mime_type_equal (const char *mime_a,
|
|
const char *mime_b);
|
|
int _xdg_mime_mime_type_subclass (const char *mime,
|
|
const char *base);
|
|
const char *_xdg_mime_unalias_mime_type (const char *mime);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
#endif /* __XDG_MIME_H__ */
|