GimpConfig-path

## GimpConfig-path GimpConfig-path — File path utilities for libgimpconfig. |

## Synopsis

    typedef             GimpConfigPath;
    enum                GimpConfigPathType;
    GParamSpec *        gimp_param_spec_config_path         (const gchar *name,
                                                             const gchar *nick,
                                                             const gchar *blurb,
                                                             GimpConfigPathType type,
                                                             const gchar *default_value,
                                                             GParamFlags flags);
    GimpConfigPathType  gimp_param_spec_config_path_type    (GParamSpec *pspec);
    gchar *             gimp_config_path_expand             (const gchar *path,
                                                             gboolean recode,
                                                             GError **error);
    gchar *             gimp_config_build_data_path         (const gchar *name);
    gchar *             gimp_config_build_writable_path     (const gchar *name);
    gchar *             gimp_config_build_plug_in_path      (const gchar *name);
    #define             GIMP_VALUE_HOLDS_CONFIG_PATH        (value)

## Description

File path utilities for libgimpconfig.

## Details

### GimpConfigPath

    typedef gchar *                   GimpConfigPath; /* to satisfy docs */

### enum GimpConfigPathType

    typedef enum {
      GIMP_CONFIG_PATH_FILE,
      GIMP_CONFIG_PATH_FILE_LIST,
      GIMP_CONFIG_PATH_DIR,
      GIMP_CONFIG_PATH_DIR_LIST
    } GimpConfigPathType;

### gimp_param_spec_config_path ()

    GParamSpec *        gimp_param_spec_config_path         (const gchar *name,
                                                             const gchar *nick,
                                                             const gchar *blurb,
                                                             GimpConfigPathType type,
                                                             const gchar *default_value,
                                                             GParamFlags flags);

Creates a param spec to hold a filename, dir name, or list of file or dir names. See `g_param_spec_internal()` for more information.

`name` : | Canonical name of the param
`nick` : | Nickname of the param
`blurb` : | Brief desciption of param.
`type` : | a GimpConfigPathType value.
`default_value` : | Value to use if none is assigned.
`flags` : | a combination of GParamFlags
Returns : | a newly allocated GParamSpec instance

Since GIMP 2.4

### gimp_param_spec_config_path_type ()

    GimpConfigPathType  gimp_param_spec_config_path_type    (GParamSpec *pspec);

Tells whether the path param encodes a filename, dir name, or list of file or dir names.

`pspec` : | A GParamSpec for a path param
Returns : | a GimpConfigPathType value

Since GIMP 2.4

### gimp_config_path_expand ()

    gchar *             gimp_config_path_expand             (const gchar *path,
                                                             gboolean recode,
                                                             GError **error);

Paths as stored in the gimprc have to be treated special. The string may contain special identifiers such as for example ${gimp_dir} that have to be substituted before use. Also the user's filesystem may be in a different encoding than UTF-8 (which is what is used for the gimprc). This function does the variable substitution for you and can also attempt to convert to the filesystem encoding.

`path` : | a NUL-terminated string in UTF-8 encoding
`recode` : | whether to convert to the filesystem's encoding
`error` : | return location for errors
Returns : | a newly allocated NUL-terminated string

Since GIMP 2.4

### gimp_config_build_data_path ()

    gchar *             gimp_config_build_data_path         (const gchar *name);

Creates a search path as it is used in the gimprc file. The path returned by `gimp_config_build_data_path()` includes a directory below the user's gimp directory and one in the system-wide data directory.

Note that you cannot use this path directly with `gimp_path_parse()`. As it is in the gimprc notation, you first need to expand and recode it using `gimp_config_path_expand()`.

`name` : | directory name (in UTF-8 encoding)
Returns : | a newly allocated string

Since GIMP 2.4

### gimp_config_build_writable_path ()

    gchar *             gimp_config_build_writable_path     (const gchar *name);

Creates a search path as it is used in the gimprc file. The path returned by `gimp_config_build_writable_path()` is just the writable parts of the search path constructed by `gimp_config_build_data_path()`.

Note that you cannot use this path directly with `gimp_path_parse()`. As it is in the gimprc notation, you first need to expand and recode it using `gimp_config_path_expand()`.

`name` : | directory name (in UTF-8 encoding)
Returns : | a newly allocated string

Since GIMP 2.4

### gimp_config_build_plug_in_path ()

    gchar *             gimp_config_build_plug_in_path      (const gchar *name);

Creates a search path as it is used in the gimprc file. The path returned by `gimp_config_build_plug_in_path()` includes a directory below the user's gimp directory and one in the system-wide plug-in directory.

Note that you cannot use this path directly with `gimp_path_parse()`. As it is in the gimprc notation, you first need to expand and recode it using `gimp_config_path_expand()`.

`name` : | directory name (in UTF-8 encoding)
Returns : | a newly allocated string

Since GIMP 2.4

### GIMP_VALUE_HOLDS_CONFIG_PATH()

    #define GIMP_VALUE_HOLDS_CONFIG_PATH(value) (G_TYPE_CHECK_VALUE_TYPE ((value), GIMP_TYPE_CONFIG_PATH))