strv.h

   1 /*-*- Mode: C; c-basic-offset: 8 -*-*/
   2
   3 #ifndef foostrvhfoo
   4 #define foostrvhfoo
   5
   6 /***
   7   This file is part of systemd.
   8
   9   Copyright 2010 Lennart Poettering
  10
  11   systemd is free software; you can redistribute it and/or modify it
  12   under the terms of the GNU General Public License as published by
  13   the Free Software Foundation; either version 2 of the License, or
  14   (at your option) any later version.
  15
  16   systemd is distributed in the hope that it will be useful, but
  17   WITHOUT ANY WARRANTY; without even the implied warranty of
  18   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  19   General Public License for more details.
  20
  21   You should have received a copy of the GNU General Public License
  22   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  23 ***/
  24
  25 #include <stdarg.h>
  26 #include <stdbool.h>
  27
  28 #include "macro.h"
  29
  30 char *strv_find(char **l, const char *name);
  31 void strv_free(char **l);
  32 char **strv_copy(char **l) _malloc;
  33 unsigned strv_length(char **l);
  34
  35 char **strv_merge(char **a, char **b);
  36 char **strv_merge_concat(char **a, char **b, const char *suffix);
  37 char **strv_append(char **l, const char *s);
  38
  39 char **strv_remove(char **l, const char *s);
  40 char **strv_uniq(char **l);
  41
  42 #define strv_contains(l, s) (!!strv_find((l), (s)))
  43
  44 char **strv_new(const char *x, ...) _sentinel _malloc;
  45 char **strv_new_ap(const char *x, va_list ap) _malloc;
  46
  47 static inline bool strv_isempty(char **l) {
  48         return !l || !*l;
  49 }
  50
  51 char **strv_split(const char *s, const char *separator) _malloc;
  52 char **strv_split_quoted(const char *s) _malloc;
  53
  54 char *strv_join(char **l, const char *separator) _malloc;
  55
  56 char **strv_env_merge(char **x, ...) _sentinel;
  57 char **strv_env_delete(char **x, ...) _sentinel;
  58
  59 #define STRV_FOREACH(s, l)                      \
  60         for ((s) = (l); (s) && *(s); (s)++)
  61
  62 #define STRV_FOREACH_BACKWARDS(s, l)            \
  63         for (; (l) && ((s) >= (l)); (s)--)
  64
  65 #endif