src/strv.h

   1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
   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 char *strv_find_prefix(char **l, const char *name);
  32
  33 void strv_free(char **l);
  34 char **strv_copy(char **l) _malloc_;
  35 unsigned strv_length(char **l);
  36
  37 char **strv_merge(char **a, char **b);
  38 char **strv_merge_concat(char **a, char **b, const char *suffix);
  39 char **strv_append(char **l, const char *s);
  40
  41 char **strv_remove(char **l, const char *s);
  42 char **strv_uniq(char **l);
  43
  44 #define strv_contains(l, s) (!!strv_find((l), (s)))
  45
  46 char **strv_new(const char *x, ...) _sentinel_ _malloc_;
  47 char **strv_new_ap(const char *x, va_list ap) _malloc_;
  48
  49 static inline bool strv_isempty(char **l) {
  50         return !l || !*l;
  51 }
  52
  53 char **strv_split(const char *s, const char *separator) _malloc_;
  54 char **strv_split_quoted(const char *s) _malloc_;
  55
  56 char *strv_join(char **l, const char *separator) _malloc_;
  57
  58 char **strv_env_merge(unsigned n_lists, ...);
  59 char **strv_env_delete(char **x, unsigned n_lists, ...);
  60
  61 char **strv_env_set(char **x, const char *p);
  62 char **strv_env_unset(char **l, const char *p);
  63
  64 char *strv_env_get_with_length(char **l, const char *name, size_t k);
  65 char *strv_env_get(char **x, const char *n);
  66
  67 char **strv_env_clean(char **l);
  68
  69 char **strv_parse_nulstr(const char *s, size_t l);
  70
  71 bool strv_overlap(char **a, char **b);
  72
  73 #define STRV_FOREACH(s, l)                      \
  74         for ((s) = (l); (s) && *(s); (s)++)
  75
  76 #define STRV_FOREACH_BACKWARDS(s, l)            \
  77         for (; (l) && ((s) >= (l)); (s)--)
  78
  79 #endif