utils.h

Go to the documentation of this file.

/* SPDX-License-Identifier: BSD-3-Clause */
 
#ifndef DUNST_UTILS_H
#define DUNST_UTILS_H
 
#include <glib.h>
#include <stdbool.h>
#include <stdio.h>
#include <string.h>

#define STR_EMPTY(s) (!s || (*s == '\0'))

#define STR_FULL(s) !(STR_EMPTY(s))

#define STR_EQ(a, b) (g_strcmp0(a, b) == 0)

#define STRN_EQ(a, b, n) (strncmp(a, b, n) == 0)

#define STR_CASEQ(a, b) (strcasecmp(a, b) == 0)

#define STR_NN(s) (s == NULL ? "(null)" : s)

#define STR_TO(...) _STR_TO(__VA_ARGS__)
#define _STR_TO(...) "" # __VA_ARGS__

#define ASSERT_OR_RET(expr, val) \
        do { if (!(expr)) return val; } while(0)

#define S2US(s) (((gint64)(s)) * G_USEC_PER_SEC)

#define US2S(s) (((gint64)(s)) / G_USEC_PER_SEC)

#define BOOL2G(x) ((x) ? TRUE : FALSE)
 

char *string_replace_char(char needle, char replacement, char *haystack);

char *string_replace_at(char *buf, int pos, int len, const char *repl);

char *string_replace_all(const char *needle, const char *replacement, char *haystack);

char *string_append(char *a, const char *b, const char *sep);

char *string_strip_quotes(const char *value);

void string_strip_delimited(char *str, char a, char b);

char **string_to_array(const char *string, const char *delimiter);

char *string_to_path(char *string);

bool safe_string_to_int(int *in, const char *str);

bool safe_string_to_long_long(long long *in, const char *str);

bool safe_string_to_double(double *in, const char *str);

gint64 string_to_time(const char *string);

gint64 time_monotonic_now(void);

gint64 time_now(void);

gint64 modification_time(const char *path);

const char *user_get_home(void);

bool safe_setenv(const char* key, const char* value);

bool is_special_section(const char* s);

bool is_deprecated_section(const char* s);
 
const char *get_section_deprecation_message(const char *s);
 

char *string_strip_brackets(const char* s);
 

int string_array_length(char **s);

bool is_readable_file(const char * const path);

FILE *fopen_verbose(const char * const path);

void add_paths_from_env(GPtrArray *arr, char *env_name, char *subdir, char *alternative);

bool string_is_int(const char *str);

bool is_like_path(const char *string);
 
#endif