PIKApp/libpikaconfig/pikaconfig-path.h

110 lines
4.0 KiB
C

/* LIBPIKA - The PIKA Library
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
*
* pikaconfig-path.h
* Copyright (C) 2001-2002 Sven Neumann <sven@gimp.org>
*
* 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 3 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
* Library 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
* <https://www.gnu.org/licenses/>.
*/
#if !defined (__PIKA_CONFIG_H_INSIDE__) && !defined (PIKA_CONFIG_COMPILATION)
#error "Only <libpikaconfig/pikaconfig.h> can be included directly."
#endif
#ifndef __PIKA_CONFIG_PATH_H__
#define __PIKA_CONFIG_PATH_H__
G_BEGIN_DECLS
/* For information look into the C source or the html documentation */
/*
* PIKA_TYPE_CONFIG_PATH
*/
#define PIKA_TYPE_CONFIG_PATH (pika_config_path_get_type ())
#define PIKA_VALUE_HOLDS_CONFIG_PATH(value) (G_TYPE_CHECK_VALUE_TYPE ((value), PIKA_TYPE_CONFIG_PATH))
GType pika_config_path_get_type (void) G_GNUC_CONST;
/*
* PIKA_TYPE_PARAM_CONFIG_PATH
*/
/**
* PikaConfigPathType:
* @PIKA_CONFIG_PATH_FILE: A single file
* @PIKA_CONFIG_PATH_FILE_LIST: A list of files
* @PIKA_CONFIG_PATH_DIR: A single folder
* @PIKA_CONFIG_PATH_DIR_LIST: A list of folders
*
* Types of config paths.
**/
typedef enum
{
PIKA_CONFIG_PATH_FILE,
PIKA_CONFIG_PATH_FILE_LIST,
PIKA_CONFIG_PATH_DIR,
PIKA_CONFIG_PATH_DIR_LIST
} PikaConfigPathType;
#define PIKA_TYPE_PARAM_CONFIG_PATH (pika_param_config_path_get_type ())
#define PIKA_IS_PARAM_SPEC_CONFIG_PATH(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), PIKA_TYPE_PARAM_CONFIG_PATH))
GType pika_param_config_path_get_type (void) G_GNUC_CONST;
GParamSpec * pika_param_spec_config_path (const gchar *name,
const gchar *nick,
const gchar *blurb,
PikaConfigPathType type,
const gchar *default_value,
GParamFlags flags);
PikaConfigPathType pika_param_spec_config_path_type (GParamSpec *pspec);
/*
* PikaConfigPath utilities
*/
gchar * pika_config_path_expand (const gchar *path,
gboolean recode,
GError **error) G_GNUC_MALLOC;
GList * pika_config_path_expand_to_files (const gchar *path,
GError **error) G_GNUC_MALLOC;
gchar * pika_config_path_unexpand (const gchar *path,
gboolean recode,
GError **error) G_GNUC_MALLOC;
GFile * pika_file_new_for_config_path (const gchar *path,
GError **error) G_GNUC_MALLOC;
gchar * pika_file_get_config_path (GFile *file,
GError **error) G_GNUC_MALLOC;
gchar * pika_config_build_data_path (const gchar *name) G_GNUC_MALLOC;
gchar * pika_config_build_writable_path (const gchar *name) G_GNUC_MALLOC;
gchar * pika_config_build_plug_in_path (const gchar *name) G_GNUC_MALLOC;
gchar * pika_config_build_system_path (const gchar *name) G_GNUC_MALLOC;
G_END_DECLS
#endif /* __PIKA_CONFIG_PATH_H__ */