src/util-string.h

   1 /*
   2     Copyright (C) 2012, 2013, 2014, 2015, 2016, 2017
   3     Ben Kibbey <bjk@luxsci.net>
   4
   5     This file is part of pwmd.
   6
   7     Pwmd is free software: you can redistribute it and/or modify
   8     it under the terms of the GNU General Public License as published by
   9     the Free Software Foundation, either version 2 of the License, or
  10     (at your option) any later version.
  11
  12     Pwmd is distributed in the hope that it will be useful,
  13     but WITHOUT ANY WARRANTY; without even the implied warranty of
  14     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15     GNU General Public License for more details.
  16
  17     You should have received a copy of the GNU General Public License
  18     along with Pwmd.  If not, see <http://www.gnu.org/licenses/>.
  19 */
  20 #ifndef UTIL_STRING_H
  21 #define UTIL_STRING_H
  22
  23 #include <stdarg.h>
  24
  25 #ifdef HAVE_SYS_TYPES_H
  26 #include <sys/types.h>
  27 #endif
  28
  29 struct string_s
  30 {
  31   size_t allocated;
  32   size_t len;
  33   char *str;
  34 };
  35
  36 // These mimic GLib's string utility functions.
  37 void string_free (struct string_s *s, int with_data);
  38 struct string_s *string_erase (struct string_s *s, ssize_t pos, ssize_t len);
  39 struct string_s *string_new (const char *str);
  40 struct string_s *string_new_content (char *str);
  41 struct string_s *string_append (struct string_s *s, const char *str);
  42 struct string_s *string_truncate (struct string_s *s, size_t n);
  43 struct string_s *string_prepend (struct string_s *s, const char *str);
  44 struct string_s *string_append_printf (struct string_s *s, const char *fmt,
  45                                        ...);
  46 struct string_s *string_insert_c (struct string_s *s, ssize_t pos, char c);
  47
  48 int strv_printf (char ***array, const char *fmt, ...);
  49 void strv_free (char **str);
  50 char **strv_cat (char **a, char *str);
  51 char **strv_catv (char **dst, char **src);
  52 int strv_length (char **a);
  53 char **strv_dup (char **src);
  54 char *strv_join (const char *delim, char **a);
  55
  56 char **str_split (const char *str, const char *delim, int count);
  57 char **str_split_ws (const char *str, const char *delim, int count);
  58 char *str_down (char *str);
  59 char *str_chomp (char *str);
  60 char *str_dup (const char *);
  61 char *str_asprintf (const char *fmt, ...);
  62 int str_vasprintf (char **result, const char *fmt, va_list ap);
  63
  64 #endif