src/util-string.h

   1 /*
   2     Copyright (C) 2012, 2013
   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_append (struct string_s *s, const char *str);
  41 struct string_s *string_truncate (struct string_s *s, size_t n);
  42 struct string_s *string_prepend (struct string_s *s, const char *str);
  43 struct string_s *string_append_printf (struct string_s *s, const char *fmt,
  44                                        ...);
  45 struct string_s *string_insert_c (struct string_s *s, ssize_t pos, char c);
  46
  47 int strv_printf (char ***array, const char *fmt, ...);
  48 void strv_free (char **str);
  49 char **strv_cat (char **a, char *str);
  50 char **strv_catv (char **dst, char **src);
  51 int strv_length (char **a);
  52 char **strv_dup (char **src);
  53 char *strv_join (char *delim, char **a);
  54
  55 char **str_split (const char *str, const char *delim, int count);
  56 char *str_down (char *str);
  57 char *str_chomp (char *str);
  58 char *str_dup (const char *);
  59 char *str_asprintf (const char *fmt, ...);
  60 int str_vasprintf (char **result, const char *fmt, va_list ap);
  61
  62 #endif