#include "types.h"

Functions
bool	girara_setting_add (girara_session_t session, const char name, void value, girara_setting_type_t type, bool init_only, const char description, girara_setting_callback_t callback, void *data)

bool	girara_setting_set (girara_session_t session, const char name, void *value)

bool	girara_setting_get (girara_session_t session, const char name, void *dest)

girara_setting_t *	girara_setting_find (girara_session_t session, const char name)

const char *	girara_setting_get_name (girara_setting_t *setting)

bool	girara_setting_get_value (girara_setting_t setting, void dest)

girara_setting_type_t	girara_setting_get_type (girara_setting_t *setting)

void	girara_setting_set_value (girara_session_t session, girara_setting_t setting, void *value)

Function Documentation

bool girara_setting_add	(	girara_session_t *	session,
		const char *	name,
		void *	value,
		girara_setting_type_t	type,
		bool	init_only,
		const char *	description,
		girara_setting_callback_t	callback,
		void *	data
	)

Adds an additional entry in the settings list

Parameters

session	The used girara session
name	The name of the setting
value	The value of the setting
type	The type of the setting
init_only	Will only available on initialization
description	Description of the setting
callback	Function that is called when the setting changes
data	Arbitary data that can be used by callbacks

Returns: TRUE No error occured; FALSE An error occured

Definition at line 64 of file settings.c.

girara_setting_t* girara_setting_find	(	girara_session_t *	session,
		const char *	name
	)

Find a setting.

Parameters

session	The girara session
name	name of the setting

Returns: the setting or NULL if it doesn't exist

Definition at line 168 of file settings.c.

bool girara_setting_get	(	girara_session_t *	session,
		const char *	name,
		void *	dest
	)

Retreive the value of a setting. If the setting is a string, the value stored in dest has to be deallocated with g_free.

Parameters

session	The used girara session
name	The name of the setting
dest	A pointer to the destination of the result.

Returns: true if the setting exists, false otherwise.

Definition at line 140 of file settings.c.

const char* girara_setting_get_name ( girara_setting_t * setting )

Get the setting's name.

Parameters

setting The setting

Returns: the setting's name

Definition at line 185 of file settings.c.

girara_setting_type_t girara_setting_get_type ( girara_setting_t * setting )

Get the setting's value.

Parameters

setting The setting

Returns: the value

Definition at line 191 of file settings.c.

bool girara_setting_get_value	(	girara_setting_t *	setting,
		void *	dest
	)

Get the setting's value. If the setting is a string, the value stored in dest has to be deallocated with g_free.

Parameters

setting	The setting
dest	A pointer to the destination of the result.

Returns: true if the setting exists, false otherwise.

Definition at line 110 of file settings.c.

bool girara_setting_set	(	girara_session_t *	session,
		const char *	name,
		void *	value
	)

Sets the value of a setting

Parameters

session	The used girara session
name	The name of the setting
value	The new value of the setting

Returns: TRUE No error occured; FALSE An error occured

Definition at line 95 of file settings.c.

void girara_setting_set_value	(	girara_session_t *	session,
		girara_setting_t *	setting,
		void *	value
	)

Set the setting's value. If session is NULL, the setting's callback won't be called.

Parameters

session	The girara session
setting	The setting
value	The new value

Definition at line 34 of file settings.c.

Functions

Function Documentation