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 "ext/juce/juce.h"
 
class StringArray : public juce::StringArray
{
public:
  StringArray () : juce::StringArray (){};
  StringArray (const char * const * strs);
 
  char ** getNullTerminated () const;
 
  void insert (int index, const char * s)
  {
    juce::StringArray::insert (index, juce::CharPointer_UTF8 (s));
  };
  void add (const char * s)
  {
    juce::StringArray::add (juce::CharPointer_UTF8 (s));
  };
  void set (int index, const char * s)
  {
    juce::StringArray::set (index, juce::CharPointer_UTF8 (s));
  };
  char *       getCStr (int index);
  const char * operator[] (size_t i)
  {
    return juce::StringArray::getReference (i).toRawUTF8 ();
  };
  void removeString (const char * s)
  {
    juce::StringArray::removeString (juce::CharPointer_UTF8 (s));
  };
};
 
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);
 
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