settings.c File Reference

Implementation of API to handle configuration file management. More...

#include "settings.h"
#include <stdio.h>
#include <string.h>

Include dependency graph for settings.c:

Go to the source code of this file.

Functions
int	settings_init_from_file (settings_t *settings, const gchar *filename, const gchar *group)
	Initialise a settings struct from a file. More...
void	settings_cleanup (settings_t *settings)
	Cleanup a settings structure. More...
int	init_settings_iterator_from_file (settings_iterator_t *iterator, const gchar *filename, const gchar *group)
	Initialise a settings iterator from a file. More...
void	cleanup_settings_iterator (settings_iterator_t *iterator)
	Cleanup a settings iterator. More...
gboolean	settings_iterator_next (settings_iterator_t *iterator)
	Increment an iterator. More...
const gchar *	settings_iterator_name (settings_iterator_t *iterator)
	Get the name from a settings iterator. More...
const gchar *	settings_iterator_value (settings_iterator_t *iterator)
	Get the value from a settings iterator. More...

Detailed Description

Implementation of API to handle configuration file management.

Definition in file settings.c.

Function Documentation

cleanup_settings_iterator()

void cleanup_settings_iterator

(

settings_iterator_t *

iterator

)

Cleanup a settings iterator.

Parameters

[in]

iterator

Settings iterator.

Definition at line 144 of file settings.c.

{
  g_strfreev (iterator->keys);
  settings_cleanup (&iterator->settings);
}

References settings_iterator_t::keys, settings_iterator_t::settings, and settings_cleanup().

Referenced by prefs_config().

Here is the call graph for this function:

Here is the caller graph for this function:

init_settings_iterator_from_file()

int init_settings_iterator_from_file	(	settings_iterator_t *	iterator,
		const gchar *	filename,
		const gchar *	group
	)

Initialise a settings iterator from a file.

Parameters

[in]	iterator	Settings iterator.
[in]	filename	Complete name of the configuration file.
[in]	group	Name of the group in the file.

Returns

0 success, -1 error.

Definition at line 106 of file settings.c.

{
  int ret;
  gsize keys_length;
  GError *error = NULL;

  ret = settings_init_from_file (&iterator->settings, filename, group);
  if (ret)
    return ret;

  iterator->keys = g_key_file_get_keys (iterator->settings.key_file, group,
                                        &keys_length, &error);

  if (iterator->keys == NULL)
    {
      if (error)
        {
          g_warning ("Failed to retrieve keys of group %s from %s: %s", group,
                     filename, error->message);
          g_error_free (error);
        }
      g_key_file_free (iterator->settings.key_file);
      return -1;
    }

  iterator->current_key = iterator->keys - 1;
  iterator->last_key = iterator->keys + keys_length - 1;

  return 0;
}

References settings_iterator_t::current_key, settings_t::key_file, settings_iterator_t::keys, settings_iterator_t::last_key, settings_iterator_t::settings, and settings_init_from_file().

Referenced by prefs_config().

Here is the call graph for this function:

Here is the caller graph for this function:

settings_cleanup()

void settings_cleanup

(

settings_t *

settings

)

Cleanup a settings structure.

Parameters

[in]

settings

Settings structure.

Definition at line 89 of file settings.c.

{
  g_free (settings->group_name);
  g_free (settings->file_name);
  g_key_file_free (settings->key_file);
}

References settings_t::file_name, settings_t::group_name, and settings_t::key_file.

Referenced by cleanup_settings_iterator().

Here is the caller graph for this function:

settings_init_from_file()

int settings_init_from_file	(	settings_t *	settings,
		const gchar *	filename,
		const gchar *	group
	)

Initialise a settings struct from a file.

Parameters

[in]	settings	Settings.
[in]	filename	Complete name of the configuration file.
[in]	group	Name of the group in the file.

Returns

0 success, -1 error.

Definition at line 40 of file settings.c.

{
  GError *error = NULL;

  if (filename == NULL || group == NULL)
    return -1;

  gchar *contents = NULL;

  if (!g_file_get_contents (filename, &contents, NULL, &error))
    {
      g_error_free (error);
      return -1;
    }

  if (contents != NULL)
    {
      gchar *contents_with_group = g_strjoin ("\n", "[Misc]", contents, NULL);
      settings->key_file = g_key_file_new ();

      if (!g_key_file_load_from_data (
            settings->key_file, contents_with_group,
            strlen (contents_with_group),
            G_KEY_FILE_KEEP_COMMENTS | G_KEY_FILE_KEEP_TRANSLATIONS, &error))
        {
          g_warning ("Failed to load configuration from %s: %s", filename,
                     error->message);
          g_error_free (error);
          g_free (contents_with_group);
          g_free (contents);
          return -1;
        }
      g_free (contents_with_group);
      g_free (contents);
    }

  settings->group_name = g_strdup (group);
  settings->file_name = g_strdup (filename);

  return 0;
}

References settings_t::file_name, settings_t::group_name, and settings_t::key_file.

Referenced by init_settings_iterator_from_file().

Here is the caller graph for this function:

settings_iterator_name()

const gchar* settings_iterator_name

(

settings_iterator_t *

iterator

)

Get the name from a settings iterator.

Parameters

[in]

iterator

Settings iterator.

Returns

Name of current key.

Definition at line 174 of file settings.c.

{
  return *iterator->current_key;
}

References settings_iterator_t::current_key.

Referenced by prefs_config().

Here is the caller graph for this function:

settings_iterator_next()

gboolean settings_iterator_next

(

settings_iterator_t *

iterator

)

Increment an iterator.

Parameters

[in]

iterator

Settings iterator.

Returns

TRUE if there was a next item, else FALSE.

Definition at line 158 of file settings.c.

{
  if (iterator->current_key == iterator->last_key)
    return FALSE;
  iterator->current_key++;
  return TRUE;
}

References settings_iterator_t::current_key, and settings_iterator_t::last_key.

Referenced by prefs_config().

Here is the caller graph for this function:

settings_iterator_value()

const gchar* settings_iterator_value

(

settings_iterator_t *

iterator

)

Get the value from a settings iterator.

Parameters

[in]

iterator

Settings iterator.

Returns

Value of current key.

Definition at line 187 of file settings.c.

{
  return g_key_file_get_value (iterator->settings.key_file,
                               iterator->settings.group_name,
                               *iterator->current_key, NULL);
}

References settings_iterator_t::current_key, settings_t::group_name, settings_t::key_file, and settings_iterator_t::settings.

Referenced by prefs_config().

Here is the caller graph for this function: