#include <stdio.h>
#include "types.h"
#include "macros.h"
Go to the source code of this file.
Defines |
#define | girara_debug(...) _girara_debug(__FUNCTION__, __LINE__, GIRARA_DEBUG, __VA_ARGS__) |
#define | girara_info(...) _girara_debug(__FUNCTION__, __LINE__, GIRARA_INFO, __VA_ARGS__) |
#define | girara_warning(...) _girara_debug(__FUNCTION__, __LINE__, GIRARA_WARNING, __VA_ARGS__) |
#define | girara_error(...) _girara_debug(__FUNCTION__, __LINE__, GIRARA_ERROR, __VA_ARGS__) |
Enumerations |
enum | girara_xdg_path_t { XDG_CONFIG,
XDG_DATA,
XDG_CONFIG_DIRS,
XDG_DATA_DIRS
} |
Functions |
char * | girara_get_home_directory (const char *user) |
char * | girara_get_xdg_path (girara_xdg_path_t path) |
bool | girara_xdg_open (const char *uri) |
girara_list_t * | girara_split_path_array (const char *patharray) |
char * | girara_fix_path (const char *path) |
FILE * | girara_file_open (const char *path, const char *mode) |
char * | girara_file_read_line (FILE *file) |
char * | girara_file_read (const char *path) |
char * | girara_file_read2 (FILE *file) |
void | girara_clean_line (char *line) |
void * | girara_safe_realloc (void **ptr, size_t size) |
void | _girara_debug (const char *function, int line, girara_debug_level_t level, const char *format,...) GIRARA_PRINTF(4 |
void girara_debug_level_t | girara_get_debug_level () |
void | girara_set_debug_level (girara_debug_level_t level) |
Define Documentation
Prints a debug message
Definition at line 117 of file utils.h.
Enumeration Type Documentation
Enum for directories specified in the XDG specification.
- Enumerator:
XDG_CONFIG |
XDG_CONFIG_HOME
|
XDG_DATA |
XDG_DATA_HOME
|
XDG_CONFIG_DIRS |
XDG_CONFIG_DIRS
|
XDG_DATA_DIRS |
|
Definition at line 13 of file utils.h.
Function Documentation
Trims and cleans a line from multiple whitespaces
- Parameters:
-
Definition at line 340 of file utils.c.
Open a file in a safe way
- Parameters:
-
path | Path of the file |
mode | Mode that the file should be opened |
- Returns:
- NULL if an error occured
Definition at line 174 of file utils.c.
Reads the whole content from a file. Returned string has to be freed.
- Parameters:
-
- Returns:
- Read file or NULL if an error occured
Definition at line 281 of file utils.c.
Reads the whole content from a file. Returned string has to be freed.
- Parameters:
-
- Returns:
- Read file or NULL if an error occured
Definition at line 298 of file utils.c.
Reads a line from the file. Returned string has to be freed.
- Parameters:
-
- Returns:
- Read line or NULL if an error occured
Definition at line 259 of file utils.c.
Returns a "fixed" version of path. Which means, it will be an absolute path and fully expanded. ~ and ~user will be replaced by the current user's home directory (user's home directory respectively).
- Parameters:
-
- Returns:
- the "fixed" path (needs to be freed with g_free).
Definition at line 27 of file utils.c.
Get the debug level.
- Returns:
- The debug level.
Definition at line 433 of file utils.c.
Returns the home directory for the given user. $HOME is prefered over the value from g_get_home_dir.
- Parameters:
-
user | a username or NULL to get home directory of the current user. |
- Returns:
- a string containing the path to the user's home directory (needs to be freed with g_free) or NULL if the user doesn't exist.
Definition at line 88 of file utils.c.
Returns a specific path specified in the XDG specification. ~ in paths will not be expanded.
- Parameters:
-
- Returns:
- a string containing the requested patch (needs to be freed with g_free) or NULL for invalid values.
Definition at line 121 of file utils.c.
Changes the size of the memory block by wrapping a realloc function call In addition it frees the old memory block if realloc fails.
- Parameters:
-
ptr | Memory space |
size | Number of bytes |
- Returns:
- Pointer to the allocated memory block or NULL
Definition at line 368 of file utils.c.
Set the debug level. Any message with a level lower than the debug level will be discarded.
- Parameters:
-
level | The new debug level. |
Definition at line 439 of file utils.c.
Splits paths seperated by : (as in $PATH) into a list.
- Parameters:
-
patharray | String like $PATH to split |
- Returns:
- a list of paths and NULL on failure.
Definition at line 157 of file utils.c.
Opens a URI with xdg-open.
- Parameters:
-
- Returns:
- true on success, false otherwise
Definition at line 64 of file utils.c.