toolConfigFile

toolConfigFile — Generic read methods of the configuration files are defined here.

Functions

Types and Values

Description

These methods give generic tools to read common data in the configuration files, such as arrays of float values or one VisuElement... It also defines a enumeration of detailed errors (see ToolConfigFileError) when reading a file. All read elements are either from tokens (given g_strsplit()) or strings.

Functions

tool_config_file_getQuark ()

GQuark
tool_config_file_getQuark ();

Internal routine for error handling.

Returns

the GQuark associated to errors related to configuration files.


tool_config_file_readFloatFromTokens ()

gboolean
tool_config_file_readFloatFromTokens (gchar **tokens,
                                      int *position,
                                      float *values,
                                      guint size,
                                      int lineId,
                                      GError **error);

Read size floating point values from tokens , store them in values and returns the new head in tokens .

Parameters

tokens

array of tokens resulting from a call to g_strsplit() with " " as separator ;

 

position

IN, the position of the beginning in tokens ; OUT, one token after the last read ;

 

values

allocated area to store read values ;

 

size

the number of floating point values to be read ;

 

lineId

the number of the line of the config file which the line argument is taken from ;

 

error

a location to store a possible reading error.

 

Returns

TRUE if no error occured.


tool_config_file_readFloat ()

gboolean
tool_config_file_readFloat (gchar *line,
                            int position,
                            float *values,
                            guint size,
                            GError **error);

Read size floating point values from line and store them in values .

Parameters

line

string where values are read from ;

 

position

the number of the line of the config file which the line argument is taken from ;

 

values

allocated area to store read values ;

 

size

the number of floating point values to be read ;

 

error

a location to store a possible reading error.

 

Returns

TRUE if no error occured.


tool_config_file_readIntegerFromTokens ()

gboolean
tool_config_file_readIntegerFromTokens
                               (gchar **tokens,
                                int *position,
                                int *values,
                                guint size,
                                int lineId,
                                GError **error);

Read size integer values from tokens , store them in values and returns the new head in tokens .

Parameters

tokens

array of tokens resulting from a call to g_strsplit() with " " as separator ;

 

position

IN, the position of the beginning in tokens ; OUT, one token after the last read ;

 

values

allocated area to store read values ;

 

size

the number of floating point values to be read ;

 

lineId

the number of the line of the config file which the line argument is taken from ;

 

error

a location to store a possible reading error.

 

Returns

TRUE if no error occured.


tool_config_file_readInteger ()

gboolean
tool_config_file_readInteger (gchar *line,
                              int position,
                              int *values,
                              guint size,
                              GError **error);

Read size integers from line and store them in values .

Parameters

line

string where values are read from ;

 

position

the number of the line of the config file which the line argument is taken from ;

 

values

allocated area to store read values ;

 

size

the number of floating point values to be read ;

 

error

a location to store a possible reading error.

 

Returns

TRUE if no error occured.


tool_config_file_readBooleanFromTokens ()

gboolean
tool_config_file_readBooleanFromTokens
                               (gchar **tokens,
                                int *position,
                                gboolean *values,
                                guint size,
                                int lineId,
                                GError **error);

Read size boolean values from tokens , store them in values and returns the new head in tokens .

Parameters

tokens

array of tokens resulting from a call to g_strsplit() with " " as separator ;

 

position

IN, the position of the beginning in tokens ; OUT, one token after the last read ;

 

values

allocated area to store read values ;

 

size

the number of floating point values to be read ;

 

lineId

the number of the line of the config file which the line argument is taken from ;

 

error

a location to store a possible reading error.

 

Returns

TRUE if no error occured.


tool_config_file_readBoolean ()

gboolean
tool_config_file_readBoolean (gchar *line,
                              int position,
                              gboolean *values,
                              guint size,
                              GError **error);

Read size boolean values from line and store them in values .

Parameters

line

string where values are read from ;

 

position

the number of the line of the config file which the line argument is taken from ;

 

values

allocated area to store read values ;

 

size

the number of boolean values to be read ;

 

error

a location to store a possible reading error.

 

Returns

TRUE if no error occured.


tool_config_file_readStringFromTokens ()

gboolean
tool_config_file_readStringFromTokens (gchar **tokens,
                                       int *position,
                                       gchar ***values,
                                       guint size,
                                       int lineId,
                                       GError **error);

Read size strings from tokens , store them in values and returns the new head in tokens .

Parameters

tokens

array of tokens resulting from a call to g_strsplit() with " " as separator ;

 

position

IN, the position of the beginning in tokens ; OUT, one token after the last read ;

 

values

a location to point on a gchar** ;

 

size

the number of floating point values to be read ;

 

lineId

the number of the line of the config file which the line argument is taken from ;

 

error

a location to store a possible reading error.

 

Returns

TRUE if no error occured.


tool_config_file_readString ()

gboolean
tool_config_file_readString (gchar *line,
                             int position,
                             gchar ***values,
                             guint size,
                             gboolean join,
                             GError **error);

Read size strings from line and values points on them. If more strings than size are available, an error is raised ; except if join is TRUE. In that case, the method return size tokens, joining all remaining ones.

Parameters

line

string where values are read from ;

 

position

the number of the line of the config file which the line argument is taken from ;

 

values

a location to point on a gchar** ;

 

size

the number of strings to be read ;

 

join

a boolean ;

 

error

a location to store a possible reading error.

 

Returns

TRUE if no error occured, then values point on an allocated memory area that is NULL terminated and that must be freed with g_strfreev().


tool_config_file_clampFloat ()

gboolean
tool_config_file_clampFloat (float *variable,
                             float value,
                             float min,
                             float max);

It puts value in a variable if value is in min and max or put min or max in if not. It return true if value is out of bounds. Min and max are inclusive values. If there is no max bounds then put max at a lower value than min and if there is no min bound, put min at a higher value than max.

Parameters

variable

a pointer to a storage for the value ;

 

value

the value to put in the storage ;

 

min

a lower bound ;

 

max

a upper bound.

 

Returns

TRUE if the value is out of bounds.


tool_config_file_clampInt ()

gboolean
tool_config_file_clampInt (int *variable,
                           int value,
                           int min,
                           int max);

Integer version o tool_config_file_clampFloat().

Parameters

variable

a pointer to a storage for the value ;

 

value

the value to put in the storage ;

 

min

a lower bound ;

 

max

a upper bound.

 

Returns

TRUE if the value is out of bounds.

Since: 3.8

Types and Values

TOOL_CONFIG_FILE_ERROR

#define TOOL_CONFIG_FILE_ERROR tool_config_file_getQuark()

Domain used to parse config files.


enum ToolConfigFileError

Possible errors when parsing a config file.

Members

TOOL_CONFIG_FILE_ERROR_EMPTY_LINE

error when reading the file, found an empty line, where something should have been.

 

TOOL_CONFIG_FILE_ERROR_VALUE

error of file format, values read are out of bounds.

 

TOOL_CONFIG_FILE_ERROR_READ

error of file format (can't read variables...).

 

TOOL_CONFIG_FILE_ERROR_MISSING

error of file format (missing variables...).

 

TOOL_CONFIG_FILE_ERROR_TAG

error dealing with a tag.

 

TOOL_CONFIG_FILE_ERROR_MARKUP

error dealing with a markup (unkown one...).

 

TOOL_CONFIG_FILE_ERROR_NO_FILE

no valid file found on disk.