string.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: © 2018-2023 Alexandros Theodotou <alex@zrythm.org>
// SPDX-License-Identifier: LicenseRef-ZrythmLicense
/*
 * This file incorporates work covered by the following copyright and
 * permission notice:
 *
 * ---
 *
 * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
 * Copyright (C) 2012 Intel Corporation
 *
 * This library is free software: you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation.
 *
 * This library is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
 * License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this library. If not, see <http://www.gnu.org/licenses/>.
 *
 * Authors: Rodrigo Moya <rodrigo@ximian.com>
 *          Tristan Van Berkom <tristanvb@openismus.com>
 *
 * ---
 */
 
#ifndef __UTILS_STRING_H__
#define __UTILS_STRING_H__
 
#include <stdbool.h>
 
int
string_is_ascii (const char * string);
 
char *
string_array_contains_substr (char ** str_array, int num_str, const char * substr);
 
bool
string_contains_substr (const char * str, const char * substr);
 
bool
string_contains_substr_case_insensitive (const char * str, const char * substr);
 
void
string_to_upper (const char * in, char * out);
 
void
string_to_lower (const char * in, char * out);
 
#define string_is_equal(str1, str2) (!g_strcmp0 (str1, str2))
 
bool
string_is_equal_ignore_case (const char * str1, const char * str2);
 
NONNULL char *
string_convert_to_filename (const char * str);
 
MALLOC
NONNULL char *
string_get_substr_before_suffix (const char * str, const char * suffix);
 
char *
string_remove_until_after_first_match (const char * str, const char * match);
 
void
string_replace_regex (char ** str, const char * regex, const char * replace_str);
 
char *
string_replace (const char * str, const char * from, const char * to);
 
char *
string_get_regex_group (const char * str, const char * regex, int group);
 
int
string_get_regex_group_as_int (
  const char * str,
  const char * regex,
  int          group,
  int          def);
 
int
string_get_int_after_last_space (const char * str, char * str_without_num);
 
char **
string_array_sort_and_remove_duplicates (char ** str_arr);
 
void
string_copy_w_realloc (char ** dest, const char * src);
 
char *
string_symbolify (const char * in);
 
PURE bool
string_is_empty (const char * str);
 
int
string_utf8_strcasecmp (const char * s1, const char * s2);
 
char *
string_expand_env_vars (const char * src);
 
void
string_print_strv (const char * prefix, char ** strv);
 
char **
string_array_clone (const char ** src);
 
#endif