src/common/string-utils/string-utils.h

   1 /*
   2  * Copyright (C) 2017 Philippe Proulx <pproulx@efficios.com>
   3  *
   4  * SPDX-License-Identifier: LGPL-2.1-only
   5  *
   6  */
   7
   8 #ifndef _STRING_UTILS_H
   9 #define _STRING_UTILS_H
  10
  11 #include <stdbool.h>
  12 #include <common/macros.h>
  13 #include <common/dynamic-array.h>
  14
  15 void strutils_normalize_star_glob_pattern(char *pattern);
  16
  17 bool strutils_is_star_glob_pattern(const char *pattern);
  18
  19 bool strutils_is_star_at_the_end_only_glob_pattern(const char *pattern);
  20
  21 char *strutils_unescape_string(const char *input, char only_char);
  22
  23 int strutils_split(const char *input, char delim, bool escape_delim,
  24                 struct lttng_dynamic_pointer_array *out_strings);
  25
  26 void strutils_free_null_terminated_array_of_strings(char **array);
  27
  28 size_t strutils_array_of_strings_len(char * const *array);
  29
  30 /*
  31  * Append `append` to the malloc-end string `str`.
  32  *
  33  * On success, `str` is free'd (if not NULL) and assigned a new malloc-ed
  34  * string.  On failure, `str` is not modified.
  35  *
  36  * Return 0 on success, -ENOMEM on failure.
  37  */
  38 C_LINKAGE int strutils_append_str(char **str, const char *append);
  39
  40 /*
  41  * Like `strutils_append_str`, but the appended string is formatted using
  42  * `fmt` and the following arguments.
  43  */
  44 C_LINKAGE ATTR_FORMAT_PRINTF(2, 3)
  45 int strutils_appendf(char **s, const char *fmt, ...);
  46
  47 #endif /* _STRING_UTILS_H */