Blame src/libnm-systemd-shared/src/basic/strv.c

Packit Service dff8e4
/* SPDX-License-Identifier: LGPL-2.1-or-later */
Packit Service dff8e4
Packit Service dff8e4
#include "nm-sd-adapt-shared.h"
Packit Service dff8e4
Packit Service dff8e4
#include <errno.h>
Packit Service dff8e4
#include <fnmatch.h>
Packit Service dff8e4
#include <stdarg.h>
Packit Service dff8e4
#include <stdio.h>
Packit Service dff8e4
#include <stdlib.h>
Packit Service dff8e4
Packit Service dff8e4
#include "alloc-util.h"
Packit Service dff8e4
#include "escape.h"
Packit Service dff8e4
#include "extract-word.h"
Packit Service dff8e4
#include "fileio.h"
Packit Service dff8e4
#include "memory-util.h"
Packit Service dff8e4
#include "nulstr-util.h"
Packit Service dff8e4
#include "sort-util.h"
Packit Service dff8e4
#include "string-util.h"
Packit Service dff8e4
#include "strv.h"
Packit Service dff8e4
Packit Service dff8e4
char *strv_find(char * const *l, const char *name) {
Packit Service dff8e4
        char * const *i;
Packit Service dff8e4
Packit Service dff8e4
        assert(name);
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(i, l)
Packit Service dff8e4
                if (streq(*i, name))
Packit Service dff8e4
                        return *i;
Packit Service dff8e4
Packit Service dff8e4
        return NULL;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char *strv_find_case(char * const *l, const char *name) {
Packit Service dff8e4
        char * const *i;
Packit Service dff8e4
Packit Service dff8e4
        assert(name);
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(i, l)
Packit Service dff8e4
                if (strcaseeq(*i, name))
Packit Service dff8e4
                        return *i;
Packit Service dff8e4
Packit Service dff8e4
        return NULL;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char *strv_find_prefix(char * const *l, const char *name) {
Packit Service dff8e4
        char * const *i;
Packit Service dff8e4
Packit Service dff8e4
        assert(name);
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(i, l)
Packit Service dff8e4
                if (startswith(*i, name))
Packit Service dff8e4
                        return *i;
Packit Service dff8e4
Packit Service dff8e4
        return NULL;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char *strv_find_startswith(char * const *l, const char *name) {
Packit Service dff8e4
        char * const *i, *e;
Packit Service dff8e4
Packit Service dff8e4
        assert(name);
Packit Service dff8e4
Packit Service dff8e4
        /* Like strv_find_prefix, but actually returns only the
Packit Service dff8e4
         * suffix, not the whole item */
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(i, l) {
Packit Service dff8e4
                e = startswith(*i, name);
Packit Service dff8e4
                if (e)
Packit Service dff8e4
                        return e;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        return NULL;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_free(char **l) {
Packit Service dff8e4
        char **k;
Packit Service dff8e4
Packit Service dff8e4
        if (!l)
Packit Service dff8e4
                return NULL;
Packit Service dff8e4
Packit Service dff8e4
        for (k = l; *k; k++)
Packit Service dff8e4
                free(*k);
Packit Service dff8e4
Packit Service dff8e4
        return mfree(l);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_free_erase(char **l) {
Packit Service dff8e4
        char **i;
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(i, l)
Packit Service dff8e4
                erase_and_freep(i);
Packit Service dff8e4
Packit Service dff8e4
        return mfree(l);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_copy(char * const *l) {
Packit Service dff8e4
        char **r, **k;
Packit Service dff8e4
Packit Service dff8e4
        k = r = new(char*, strv_length(l) + 1);
Packit Service dff8e4
        if (!r)
Packit Service dff8e4
                return NULL;
Packit Service dff8e4
Packit Service dff8e4
        if (l)
Packit Service dff8e4
                for (; *l; k++, l++) {
Packit Service dff8e4
                        *k = strdup(*l);
Packit Service dff8e4
                        if (!*k) {
Packit Service dff8e4
                                strv_free(r);
Packit Service dff8e4
                                return NULL;
Packit Service dff8e4
                        }
Packit Service dff8e4
                }
Packit Service dff8e4
Packit Service dff8e4
        *k = NULL;
Packit Service dff8e4
        return r;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
size_t strv_length(char * const *l) {
Packit Service dff8e4
        size_t n = 0;
Packit Service dff8e4
Packit Service dff8e4
        if (!l)
Packit Service dff8e4
                return 0;
Packit Service dff8e4
Packit Service dff8e4
        for (; *l; l++)
Packit Service dff8e4
                n++;
Packit Service dff8e4
Packit Service dff8e4
        return n;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_new_ap(const char *x, va_list ap) {
Packit Service dff8e4
        _cleanup_strv_free_ char **a = NULL;
Packit Service dff8e4
        size_t n = 0, i = 0;
Packit Service dff8e4
        va_list aq;
Packit Service dff8e4
Packit Service dff8e4
        /* As a special trick we ignore all listed strings that equal
Packit Service dff8e4
         * STRV_IGNORE. This is supposed to be used with the
Packit Service dff8e4
         * STRV_IFNOTNULL() macro to include possibly NULL strings in
Packit Service dff8e4
         * the string list. */
Packit Service dff8e4
Packit Service dff8e4
        va_copy(aq, ap);
Packit Service dff8e4
        for (const char *s = x; s; s = va_arg(aq, const char*)) {
Packit Service dff8e4
                if (s == STRV_IGNORE)
Packit Service dff8e4
                        continue;
Packit Service dff8e4
Packit Service dff8e4
                n++;
Packit Service dff8e4
        }
Packit Service dff8e4
        va_end(aq);
Packit Service dff8e4
Packit Service dff8e4
        a = new(char*, n+1);
Packit Service dff8e4
        if (!a)
Packit Service dff8e4
                return NULL;
Packit Service dff8e4
Packit Service dff8e4
        for (const char *s = x; s; s = va_arg(ap, const char*)) {
Packit Service dff8e4
                if (s == STRV_IGNORE)
Packit Service dff8e4
                        continue;
Packit Service dff8e4
Packit Service dff8e4
                a[i] = strdup(s);
Packit Service dff8e4
                if (!a[i])
Packit Service dff8e4
                        return NULL;
Packit Service dff8e4
Packit Service dff8e4
                i++;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        a[i] = NULL;
Packit Service dff8e4
Packit Service dff8e4
        return TAKE_PTR(a);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_new_internal(const char *x, ...) {
Packit Service dff8e4
        char **r;
Packit Service dff8e4
        va_list ap;
Packit Service dff8e4
Packit Service dff8e4
        va_start(ap, x);
Packit Service dff8e4
        r = strv_new_ap(x, ap);
Packit Service dff8e4
        va_end(ap);
Packit Service dff8e4
Packit Service dff8e4
        return r;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_extend_strv(char ***a, char * const *b, bool filter_duplicates) {
Packit Service dff8e4
        char * const *s, **t;
Packit Service dff8e4
        size_t p, q, i = 0, j;
Packit Service dff8e4
Packit Service dff8e4
        assert(a);
Packit Service dff8e4
Packit Service dff8e4
        if (strv_isempty(b))
Packit Service dff8e4
                return 0;
Packit Service dff8e4
Packit Service dff8e4
        p = strv_length(*a);
Packit Service dff8e4
        q = strv_length(b);
Packit Service dff8e4
Packit Service dff8e4
        if (p >= SIZE_MAX - q)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        t = reallocarray(*a, GREEDY_ALLOC_ROUND_UP(p + q + 1), sizeof(char *));
Packit Service dff8e4
        if (!t)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        t[p] = NULL;
Packit Service dff8e4
        *a = t;
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(s, b) {
Packit Service dff8e4
Packit Service dff8e4
                if (filter_duplicates && strv_contains(t, *s))
Packit Service dff8e4
                        continue;
Packit Service dff8e4
Packit Service dff8e4
                t[p+i] = strdup(*s);
Packit Service dff8e4
                if (!t[p+i])
Packit Service dff8e4
                        goto rollback;
Packit Service dff8e4
Packit Service dff8e4
                i++;
Packit Service dff8e4
                t[p+i] = NULL;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        assert(i <= q);
Packit Service dff8e4
Packit Service dff8e4
        return (int) i;
Packit Service dff8e4
Packit Service dff8e4
rollback:
Packit Service dff8e4
        for (j = 0; j < i; j++)
Packit Service dff8e4
                free(t[p + j]);
Packit Service dff8e4
Packit Service dff8e4
        t[p] = NULL;
Packit Service dff8e4
        return -ENOMEM;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
#if 0 /* NM_IGNORED */
Packit Service dff8e4
int strv_extend_strv_concat(char ***a, char * const *b, const char *suffix) {
Packit Service dff8e4
        char * const *s;
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(s, b) {
Packit Service dff8e4
                char *v;
Packit Service dff8e4
Packit Service dff8e4
                v = strjoin(*s, suffix);
Packit Service dff8e4
                if (!v)
Packit Service dff8e4
                        return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
                r = strv_push(a, v);
Packit Service dff8e4
                if (r < 0) {
Packit Service dff8e4
                        free(v);
Packit Service dff8e4
                        return r;
Packit Service dff8e4
                }
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        return 0;
Packit Service dff8e4
}
Packit Service dff8e4
#endif /* NM_IGNORED */
Packit Service dff8e4
Packit Bot c44df3
int strv_split_newlines_full(char ***ret, const char *s, ExtractFlags flags) {
Packit Bot c44df3
        _cleanup_strv_free_ char **l = NULL;
Packit Service dff8e4
        size_t n;
Packit Bot c44df3
        int r;
Packit Service dff8e4
Packit Service dff8e4
        assert(s);
Packit Service dff8e4
Packit Bot c44df3
        /* Special version of strv_split_full() that splits on newlines and
Packit Bot c44df3
         * suppresses an empty string at the end. */
Packit Service dff8e4
Packit Bot c44df3
        r = strv_split_full(&l, s, NEWLINE, flags);
Packit Bot c44df3
        if (r < 0)
Packit Bot c44df3
                return r;
Packit Service dff8e4
Packit Service dff8e4
        n = strv_length(l);
Packit Bot c44df3
        if (n > 0 && isempty(l[n - 1])) {
Packit Service dff8e4
                l[n - 1] = mfree(l[n - 1]);
Packit Bot c44df3
                n--;
Packit Bot c44df3
        }
Packit Service dff8e4
Packit Bot c44df3
        *ret = TAKE_PTR(l);
Packit Bot c44df3
        return n;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_split_full(char ***t, const char *s, const char *separators, ExtractFlags flags) {
Packit Service dff8e4
        _cleanup_strv_free_ char **l = NULL;
Packit Service dff8e4
        size_t n = 0, allocated = 0;
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        assert(t);
Packit Service dff8e4
        assert(s);
Packit Service dff8e4
Packit Service dff8e4
        for (;;) {
Packit Service dff8e4
                _cleanup_free_ char *word = NULL;
Packit Service dff8e4
Packit Service dff8e4
                r = extract_first_word(&s, &word, separators, flags);
Packit Service dff8e4
                if (r < 0)
Packit Service dff8e4
                        return r;
Packit Service dff8e4
                if (r == 0)
Packit Service dff8e4
                        break;
Packit Service dff8e4
Packit Service dff8e4
                if (!GREEDY_REALLOC(l, allocated, n + 2))
Packit Service dff8e4
                        return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
                l[n++] = TAKE_PTR(word);
Packit Service dff8e4
Packit Service dff8e4
                l[n] = NULL;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        if (!l) {
Packit Service dff8e4
                l = new0(char*, 1);
Packit Service dff8e4
                if (!l)
Packit Service dff8e4
                        return -ENOMEM;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        *t = TAKE_PTR(l);
Packit Service dff8e4
Packit Service dff8e4
        return (int) n;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
#if 0 /* NM_IGNORED */
Packit Service dff8e4
int strv_split_colon_pairs(char ***t, const char *s) {
Packit Service dff8e4
        _cleanup_strv_free_ char **l = NULL;
Packit Service dff8e4
        size_t n = 0, allocated = 0;
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        assert(t);
Packit Service dff8e4
        assert(s);
Packit Service dff8e4
Packit Service dff8e4
        for (;;) {
Packit Service dff8e4
                _cleanup_free_ char *first = NULL, *second = NULL, *tuple = NULL, *second_or_empty = NULL;
Packit Service dff8e4
Packit Service dff8e4
                r = extract_first_word(&s, &tuple, NULL, EXTRACT_UNQUOTE|EXTRACT_RETAIN_ESCAPE);
Packit Service dff8e4
                if (r < 0)
Packit Service dff8e4
                        return r;
Packit Service dff8e4
                if (r == 0)
Packit Service dff8e4
                        break;
Packit Service dff8e4
Packit Service dff8e4
                const char *p = tuple;
Packit Service dff8e4
                r = extract_many_words(&p, ":", EXTRACT_CUNESCAPE|EXTRACT_UNESCAPE_SEPARATORS,
Packit Service dff8e4
                                       &first, &second, NULL);
Packit Service dff8e4
                if (r < 0)
Packit Service dff8e4
                        return r;
Packit Service dff8e4
                if (r == 0)
Packit Service dff8e4
                        continue;
Packit Service dff8e4
                /* Enforce that at most 2 colon-separated words are contained in each group */
Packit Service dff8e4
                if (!isempty(p))
Packit Service dff8e4
                        return -EINVAL;
Packit Service dff8e4
Packit Service dff8e4
                second_or_empty = strdup(strempty(second));
Packit Service dff8e4
                if (!second_or_empty)
Packit Service dff8e4
                        return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
                if (!GREEDY_REALLOC(l, allocated, n + 3))
Packit Service dff8e4
                        return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
                l[n++] = TAKE_PTR(first);
Packit Service dff8e4
                l[n++] = TAKE_PTR(second_or_empty);
Packit Service dff8e4
Packit Service dff8e4
                l[n] = NULL;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        if (!l) {
Packit Service dff8e4
                l = new0(char*, 1);
Packit Service dff8e4
                if (!l)
Packit Service dff8e4
                        return -ENOMEM;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        *t = TAKE_PTR(l);
Packit Service dff8e4
Packit Service dff8e4
        return (int) n;
Packit Service dff8e4
}
Packit Service dff8e4
#endif /* NM_IGNORED */
Packit Service dff8e4
Packit Service dff8e4
char *strv_join_full(char * const *l, const char *separator, const char *prefix, bool unescape_separators) {
Packit Service dff8e4
        char * const *s;
Packit Service dff8e4
        char *r, *e;
Packit Service dff8e4
        size_t n, k, m;
Packit Service dff8e4
Packit Service dff8e4
        if (!separator)
Packit Service dff8e4
                separator = " ";
Packit Service dff8e4
Packit Service dff8e4
        k = strlen(separator);
Packit Service dff8e4
        m = strlen_ptr(prefix);
Packit Service dff8e4
Packit Service dff8e4
        if (unescape_separators) /* If there separator is multi-char, we won't know how to escape it. */
Packit Service dff8e4
                assert(k == 1);
Packit Service dff8e4
Packit Service dff8e4
        n = 0;
Packit Service dff8e4
        STRV_FOREACH(s, l) {
Packit Service dff8e4
                if (s != l)
Packit Service dff8e4
                        n += k;
Packit Service dff8e4
Packit Service dff8e4
                bool needs_escaping = unescape_separators && strchr(*s, separator[0]);
Packit Service dff8e4
Packit Service dff8e4
                n += m + strlen(*s) * (1 + needs_escaping);
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        r = new(char, n+1);
Packit Service dff8e4
        if (!r)
Packit Service dff8e4
                return NULL;
Packit Service dff8e4
Packit Service dff8e4
        e = r;
Packit Service dff8e4
        STRV_FOREACH(s, l) {
Packit Service dff8e4
                if (s != l)
Packit Service dff8e4
                        e = stpcpy(e, separator);
Packit Service dff8e4
Packit Service dff8e4
                if (prefix)
Packit Service dff8e4
                        e = stpcpy(e, prefix);
Packit Service dff8e4
Packit Service dff8e4
                bool needs_escaping = unescape_separators && strchr(*s, separator[0]);
Packit Service dff8e4
Packit Service dff8e4
                if (needs_escaping)
Packit Service dff8e4
                        for (size_t i = 0; (*s)[i]; i++) {
Packit Service dff8e4
                                if ((*s)[i] == separator[0])
Packit Service dff8e4
                                        *(e++) = '\\';
Packit Service dff8e4
                                *(e++) = (*s)[i];
Packit Service dff8e4
                        }
Packit Service dff8e4
                else
Packit Service dff8e4
                        e = stpcpy(e, *s);
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        *e = 0;
Packit Service dff8e4
Packit Service dff8e4
        return r;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_push(char ***l, char *value) {
Packit Service dff8e4
        char **c;
Packit Service dff8e4
        size_t n;
Packit Service dff8e4
Packit Service dff8e4
        if (!value)
Packit Service dff8e4
                return 0;
Packit Service dff8e4
Packit Service dff8e4
        n = strv_length(*l);
Packit Service dff8e4
Packit Service dff8e4
        /* Check for overflow */
Packit Service dff8e4
        if (n > SIZE_MAX-2)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        c = reallocarray(*l, GREEDY_ALLOC_ROUND_UP(n + 2), sizeof(char*));
Packit Service dff8e4
        if (!c)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        c[n] = value;
Packit Service dff8e4
        c[n+1] = NULL;
Packit Service dff8e4
Packit Service dff8e4
        *l = c;
Packit Service dff8e4
        return 0;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_push_pair(char ***l, char *a, char *b) {
Packit Service dff8e4
        char **c;
Packit Service dff8e4
        size_t n;
Packit Service dff8e4
Packit Service dff8e4
        if (!a && !b)
Packit Service dff8e4
                return 0;
Packit Service dff8e4
Packit Service dff8e4
        n = strv_length(*l);
Packit Service dff8e4
Packit Service dff8e4
        /* Check for overflow */
Packit Service dff8e4
        if (n > SIZE_MAX-3)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        /* increase and check for overflow */
Packit Service dff8e4
        c = reallocarray(*l, GREEDY_ALLOC_ROUND_UP(n + !!a + !!b + 1), sizeof(char*));
Packit Service dff8e4
        if (!c)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        if (a)
Packit Service dff8e4
                c[n++] = a;
Packit Service dff8e4
        if (b)
Packit Service dff8e4
                c[n++] = b;
Packit Service dff8e4
        c[n] = NULL;
Packit Service dff8e4
Packit Service dff8e4
        *l = c;
Packit Service dff8e4
        return 0;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_insert(char ***l, size_t position, char *value) {
Packit Service dff8e4
        char **c;
Packit Service dff8e4
        size_t n, m, i;
Packit Service dff8e4
Packit Service dff8e4
        if (!value)
Packit Service dff8e4
                return 0;
Packit Service dff8e4
Packit Service dff8e4
        n = strv_length(*l);
Packit Service dff8e4
        position = MIN(position, n);
Packit Service dff8e4
Packit Service dff8e4
        /* increase and check for overflow */
Packit Service dff8e4
        m = n + 2;
Packit Service dff8e4
        if (m < n)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        c = new(char*, m);
Packit Service dff8e4
        if (!c)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        for (i = 0; i < position; i++)
Packit Service dff8e4
                c[i] = (*l)[i];
Packit Service dff8e4
        c[position] = value;
Packit Service dff8e4
        for (i = position; i < n; i++)
Packit Service dff8e4
                c[i+1] = (*l)[i];
Packit Service dff8e4
Packit Service dff8e4
        c[n+1] = NULL;
Packit Service dff8e4
Packit Service dff8e4
        free(*l);
Packit Service dff8e4
        *l = c;
Packit Service dff8e4
Packit Service dff8e4
        return 0;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_consume(char ***l, char *value) {
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        r = strv_push(l, value);
Packit Service dff8e4
        if (r < 0)
Packit Service dff8e4
                free(value);
Packit Service dff8e4
Packit Service dff8e4
        return r;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_consume_pair(char ***l, char *a, char *b) {
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        r = strv_push_pair(l, a, b);
Packit Service dff8e4
        if (r < 0) {
Packit Service dff8e4
                free(a);
Packit Service dff8e4
                free(b);
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        return r;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_consume_prepend(char ***l, char *value) {
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        r = strv_push_prepend(l, value);
Packit Service dff8e4
        if (r < 0)
Packit Service dff8e4
                free(value);
Packit Service dff8e4
Packit Service dff8e4
        return r;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_prepend(char ***l, const char *value) {
Packit Service dff8e4
        char *v;
Packit Service dff8e4
Packit Service dff8e4
        if (!value)
Packit Service dff8e4
                return 0;
Packit Service dff8e4
Packit Service dff8e4
        v = strdup(value);
Packit Service dff8e4
        if (!v)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        return strv_consume_prepend(l, v);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_extend(char ***l, const char *value) {
Packit Service dff8e4
        char *v;
Packit Service dff8e4
Packit Service dff8e4
        if (!value)
Packit Service dff8e4
                return 0;
Packit Service dff8e4
Packit Service dff8e4
        v = strdup(value);
Packit Service dff8e4
        if (!v)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        return strv_consume(l, v);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_extend_front(char ***l, const char *value) {
Packit Service dff8e4
        size_t n, m;
Packit Service dff8e4
        char *v, **c;
Packit Service dff8e4
Packit Service dff8e4
        assert(l);
Packit Service dff8e4
Packit Service dff8e4
        /* Like strv_extend(), but prepends rather than appends the new entry */
Packit Service dff8e4
Packit Service dff8e4
        if (!value)
Packit Service dff8e4
                return 0;
Packit Service dff8e4
Packit Service dff8e4
        n = strv_length(*l);
Packit Service dff8e4
Packit Service dff8e4
        /* Increase and overflow check. */
Packit Service dff8e4
        m = n + 2;
Packit Service dff8e4
        if (m < n)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        v = strdup(value);
Packit Service dff8e4
        if (!v)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        c = reallocarray(*l, m, sizeof(char*));
Packit Service dff8e4
        if (!c) {
Packit Service dff8e4
                free(v);
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        memmove(c+1, c, n * sizeof(char*));
Packit Service dff8e4
        c[0] = v;
Packit Service dff8e4
        c[n+1] = NULL;
Packit Service dff8e4
Packit Service dff8e4
        *l = c;
Packit Service dff8e4
        return 0;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_uniq(char **l) {
Packit Service dff8e4
        char **i;
Packit Service dff8e4
Packit Service dff8e4
        /* Drops duplicate entries. The first identical string will be
Packit Service dff8e4
         * kept, the others dropped */
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(i, l)
Packit Service dff8e4
                strv_remove(i+1, *i);
Packit Service dff8e4
Packit Service dff8e4
        return l;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
bool strv_is_uniq(char * const *l) {
Packit Service dff8e4
        char * const *i;
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(i, l)
Packit Service dff8e4
                if (strv_find(i+1, *i))
Packit Service dff8e4
                        return false;
Packit Service dff8e4
Packit Service dff8e4
        return true;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_remove(char **l, const char *s) {
Packit Service dff8e4
        char **f, **t;
Packit Service dff8e4
Packit Service dff8e4
        if (!l)
Packit Service dff8e4
                return NULL;
Packit Service dff8e4
Packit Service dff8e4
        assert(s);
Packit Service dff8e4
Packit Service dff8e4
        /* Drops every occurrence of s in the string list, edits
Packit Service dff8e4
         * in-place. */
Packit Service dff8e4
Packit Service dff8e4
        for (f = t = l; *f; f++)
Packit Service dff8e4
                if (streq(*f, s))
Packit Service dff8e4
                        free(*f);
Packit Service dff8e4
                else
Packit Service dff8e4
                        *(t++) = *f;
Packit Service dff8e4
Packit Service dff8e4
        *t = NULL;
Packit Service dff8e4
        return l;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_parse_nulstr(const char *s, size_t l) {
Packit Service dff8e4
        /* l is the length of the input data, which will be split at NULs into
Packit Service dff8e4
         * elements of the resulting strv. Hence, the number of items in the resulting strv
Packit Service dff8e4
         * will be equal to one plus the number of NUL bytes in the l bytes starting at s,
Packit Service dff8e4
         * unless s[l-1] is NUL, in which case the final empty string is not stored in
Packit Service dff8e4
         * the resulting strv, and length is equal to the number of NUL bytes.
Packit Service dff8e4
         *
Packit Service dff8e4
         * Note that contrary to a normal nulstr which cannot contain empty strings, because
Packit Service dff8e4
         * the input data is terminated by any two consequent NUL bytes, this parser accepts
Packit Service dff8e4
         * empty strings in s.
Packit Service dff8e4
         */
Packit Service dff8e4
Packit Service dff8e4
        const char *p;
Packit Service dff8e4
        size_t c = 0, i = 0;
Packit Service dff8e4
        char **v;
Packit Service dff8e4
Packit Service dff8e4
        assert(s || l <= 0);
Packit Service dff8e4
Packit Service dff8e4
        if (l <= 0)
Packit Service dff8e4
                return new0(char*, 1);
Packit Service dff8e4
Packit Service dff8e4
        for (p = s; p < s + l; p++)
Packit Service dff8e4
                if (*p == 0)
Packit Service dff8e4
                        c++;
Packit Service dff8e4
Packit Service dff8e4
        if (s[l-1] != 0)
Packit Service dff8e4
                c++;
Packit Service dff8e4
Packit Service dff8e4
        v = new0(char*, c+1);
Packit Service dff8e4
        if (!v)
Packit Service dff8e4
                return NULL;
Packit Service dff8e4
Packit Service dff8e4
        p = s;
Packit Service dff8e4
        while (p < s + l) {
Packit Service dff8e4
                const char *e;
Packit Service dff8e4
Packit Service dff8e4
                e = memchr(p, 0, s + l - p);
Packit Service dff8e4
Packit Service dff8e4
                v[i] = strndup(p, e ? e - p : s + l - p);
Packit Service dff8e4
                if (!v[i]) {
Packit Service dff8e4
                        strv_free(v);
Packit Service dff8e4
                        return NULL;
Packit Service dff8e4
                }
Packit Service dff8e4
Packit Service dff8e4
                i++;
Packit Service dff8e4
Packit Service dff8e4
                if (!e)
Packit Service dff8e4
                        break;
Packit Service dff8e4
Packit Service dff8e4
                p = e + 1;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        assert(i == c);
Packit Service dff8e4
Packit Service dff8e4
        return v;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
#if 0 /* NM_IGNORED */
Packit Service dff8e4
char **strv_split_nulstr(const char *s) {
Packit Service dff8e4
        const char *i;
Packit Service dff8e4
        char **r = NULL;
Packit Service dff8e4
Packit Service dff8e4
        NULSTR_FOREACH(i, s)
Packit Service dff8e4
                if (strv_extend(&r, i) < 0) {
Packit Service dff8e4
                        strv_free(r);
Packit Service dff8e4
                        return NULL;
Packit Service dff8e4
                }
Packit Service dff8e4
Packit Service dff8e4
        if (!r)
Packit Service dff8e4
                return strv_new(NULL);
Packit Service dff8e4
Packit Service dff8e4
        return r;
Packit Service dff8e4
}
Packit Service dff8e4
#endif /* NM_IGNORED */
Packit Service dff8e4
Packit Service dff8e4
int strv_make_nulstr(char * const *l, char **ret, size_t *ret_size) {
Packit Service dff8e4
        /* A valid nulstr with two NULs at the end will be created, but
Packit Service dff8e4
         * q will be the length without the two trailing NULs. Thus the output
Packit Service dff8e4
         * string is a valid nulstr and can be iterated over using NULSTR_FOREACH,
Packit Service dff8e4
         * and can also be parsed by strv_parse_nulstr as long as the length
Packit Service dff8e4
         * is provided separately.
Packit Service dff8e4
         */
Packit Service dff8e4
Packit Service dff8e4
        size_t n_allocated = 0, n = 0;
Packit Service dff8e4
        _cleanup_free_ char *m = NULL;
Packit Service dff8e4
        char * const *i;
Packit Service dff8e4
Packit Service dff8e4
        assert(ret);
Packit Service dff8e4
        assert(ret_size);
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(i, l) {
Packit Service dff8e4
                size_t z;
Packit Service dff8e4
Packit Service dff8e4
                z = strlen(*i);
Packit Service dff8e4
Packit Service dff8e4
                if (!GREEDY_REALLOC(m, n_allocated, n + z + 2))
Packit Service dff8e4
                        return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
                memcpy(m + n, *i, z + 1);
Packit Service dff8e4
                n += z + 1;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        if (!m) {
Packit Service dff8e4
                m = new0(char, 1);
Packit Service dff8e4
                if (!m)
Packit Service dff8e4
                        return -ENOMEM;
Packit Service dff8e4
                n = 1;
Packit Service dff8e4
        } else
Packit Service dff8e4
                /* make sure there is a second extra NUL at the end of resulting nulstr */
Packit Service dff8e4
                m[n] = '\0';
Packit Service dff8e4
Packit Service dff8e4
        assert(n > 0);
Packit Service dff8e4
        *ret = m;
Packit Service dff8e4
        *ret_size = n - 1;
Packit Service dff8e4
Packit Service dff8e4
        m = NULL;
Packit Service dff8e4
Packit Service dff8e4
        return 0;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
bool strv_overlap(char * const *a, char * const *b) {
Packit Service dff8e4
        char * const *i;
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(i, a)
Packit Service dff8e4
                if (strv_contains(b, *i))
Packit Service dff8e4
                        return true;
Packit Service dff8e4
Packit Service dff8e4
        return false;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
#if 0 /* NM_IGNORED */
Packit Service dff8e4
static int str_compare(char * const *a, char * const *b) {
Packit Service dff8e4
        return strcmp(*a, *b);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_sort(char **l) {
Packit Service dff8e4
        typesafe_qsort(l, strv_length(l), str_compare);
Packit Service dff8e4
        return l;
Packit Service dff8e4
}
Packit Service dff8e4
#endif /* NM_IGNORED */
Packit Service dff8e4
Packit Service dff8e4
int strv_compare(char * const *a, char * const *b) {
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        if (strv_isempty(a)) {
Packit Service dff8e4
                if (strv_isempty(b))
Packit Service dff8e4
                        return 0;
Packit Service dff8e4
                else
Packit Service dff8e4
                        return -1;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        if (strv_isempty(b))
Packit Service dff8e4
                return 1;
Packit Service dff8e4
Packit Service dff8e4
        for ( ; *a || *b; ++a, ++b) {
Packit Service dff8e4
                r = strcmp_ptr(*a, *b);
Packit Service dff8e4
                if (r != 0)
Packit Service dff8e4
                        return r;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        return 0;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
void strv_print(char * const *l) {
Packit Service dff8e4
        char * const *s;
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(s, l)
Packit Service dff8e4
                puts(*s);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_extendf(char ***l, const char *format, ...) {
Packit Service dff8e4
        va_list ap;
Packit Service dff8e4
        char *x;
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        va_start(ap, format);
Packit Service dff8e4
        r = vasprintf(&x, format, ap);
Packit Service dff8e4
        va_end(ap);
Packit Service dff8e4
Packit Service dff8e4
        if (r < 0)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        return strv_consume(l, x);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_reverse(char **l) {
Packit Service dff8e4
        size_t n, i;
Packit Service dff8e4
Packit Service dff8e4
        n = strv_length(l);
Packit Service dff8e4
        if (n <= 1)
Packit Service dff8e4
                return l;
Packit Service dff8e4
Packit Service dff8e4
        for (i = 0; i < n / 2; i++)
Packit Service dff8e4
                SWAP_TWO(l[i], l[n-1-i]);
Packit Service dff8e4
Packit Service dff8e4
        return l;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_shell_escape(char **l, const char *bad) {
Packit Service dff8e4
        char **s;
Packit Service dff8e4
Packit Service dff8e4
        /* Escapes every character in every string in l that is in bad,
Packit Service dff8e4
         * edits in-place, does not roll-back on error. */
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(s, l) {
Packit Service dff8e4
                char *v;
Packit Service dff8e4
Packit Service dff8e4
                v = shell_escape(*s, bad);
Packit Service dff8e4
                if (!v)
Packit Service dff8e4
                        return NULL;
Packit Service dff8e4
Packit Service dff8e4
                free(*s);
Packit Service dff8e4
                *s = v;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        return l;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
bool strv_fnmatch_full(char* const* patterns, const char *s, int flags, size_t *matched_pos) {
Packit Service dff8e4
        for (size_t i = 0; patterns && patterns[i]; i++)
Packit Service dff8e4
                if (fnmatch(patterns[i], s, flags) == 0) {
Packit Service dff8e4
                        if (matched_pos)
Packit Service dff8e4
                                *matched_pos = i;
Packit Service dff8e4
                        return true;
Packit Service dff8e4
                }
Packit Service dff8e4
Packit Service dff8e4
        return false;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char ***strv_free_free(char ***l) {
Packit Service dff8e4
        char ***i;
Packit Service dff8e4
Packit Service dff8e4
        if (!l)
Packit Service dff8e4
                return NULL;
Packit Service dff8e4
Packit Service dff8e4
        for (i = l; *i; i++)
Packit Service dff8e4
                strv_free(*i);
Packit Service dff8e4
Packit Service dff8e4
        return mfree(l);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
char **strv_skip(char **l, size_t n) {
Packit Service dff8e4
Packit Service dff8e4
        while (n > 0) {
Packit Service dff8e4
                if (strv_isempty(l))
Packit Service dff8e4
                        return l;
Packit Service dff8e4
Packit Service dff8e4
                l++, n--;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        return l;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int strv_extend_n(char ***l, const char *value, size_t n) {
Packit Service dff8e4
        size_t i, j, k;
Packit Service dff8e4
        char **nl;
Packit Service dff8e4
Packit Service dff8e4
        assert(l);
Packit Service dff8e4
Packit Service dff8e4
        if (!value)
Packit Service dff8e4
                return 0;
Packit Service dff8e4
        if (n == 0)
Packit Service dff8e4
                return 0;
Packit Service dff8e4
Packit Service dff8e4
        /* Adds the value n times to l */
Packit Service dff8e4
Packit Service dff8e4
        k = strv_length(*l);
Packit Service dff8e4
        if (n >= SIZE_MAX - k)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        nl = reallocarray(*l, GREEDY_ALLOC_ROUND_UP(k + n + 1), sizeof(char *));
Packit Service dff8e4
        if (!nl)
Packit Service dff8e4
                return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
        *l = nl;
Packit Service dff8e4
Packit Service dff8e4
        for (i = k; i < k + n; i++) {
Packit Service dff8e4
                nl[i] = strdup(value);
Packit Service dff8e4
                if (!nl[i])
Packit Service dff8e4
                        goto rollback;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        nl[i] = NULL;
Packit Service dff8e4
        return 0;
Packit Service dff8e4
Packit Service dff8e4
rollback:
Packit Service dff8e4
        for (j = k; j < i; j++)
Packit Service dff8e4
                free(nl[j]);
Packit Service dff8e4
Packit Service dff8e4
        nl[k] = NULL;
Packit Service dff8e4
        return -ENOMEM;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int fputstrv(FILE *f, char * const *l, const char *separator, bool *space) {
Packit Service dff8e4
        bool b = false;
Packit Service dff8e4
        char * const *s;
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        /* Like fputs(), but for strv, and with a less stupid argument order */
Packit Service dff8e4
Packit Service dff8e4
        if (!space)
Packit Service dff8e4
                space = &b;
Packit Service dff8e4
Packit Service dff8e4
        STRV_FOREACH(s, l) {
Packit Service dff8e4
                r = fputs_with_space(f, *s, separator, space);
Packit Service dff8e4
                if (r < 0)
Packit Service dff8e4
                        return r;
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        return 0;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
static int string_strv_hashmap_put_internal(Hashmap *h, const char *key, const char *value) {
Packit Service dff8e4
        char **l;
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        l = hashmap_get(h, key);
Packit Service dff8e4
        if (l) {
Packit Service dff8e4
                /* A list for this key already exists, let's append to it if it is not listed yet */
Packit Service dff8e4
                if (strv_contains(l, value))
Packit Service dff8e4
                        return 0;
Packit Service dff8e4
Packit Service dff8e4
                r = strv_extend(&l, value);
Packit Service dff8e4
                if (r < 0)
Packit Service dff8e4
                        return r;
Packit Service dff8e4
Packit Service dff8e4
                assert_se(hashmap_update(h, key, l) >= 0);
Packit Service dff8e4
        } else {
Packit Service dff8e4
                /* No list for this key exists yet, create one */
Packit Service dff8e4
                _cleanup_strv_free_ char **l2 = NULL;
Packit Service dff8e4
                _cleanup_free_ char *t = NULL;
Packit Service dff8e4
Packit Service dff8e4
                t = strdup(key);
Packit Service dff8e4
                if (!t)
Packit Service dff8e4
                        return -ENOMEM;
Packit Service dff8e4
Packit Service dff8e4
                r = strv_extend(&l2, value);
Packit Service dff8e4
                if (r < 0)
Packit Service dff8e4
                        return r;
Packit Service dff8e4
Packit Service dff8e4
                r = hashmap_put(h, t, l2);
Packit Service dff8e4
                if (r < 0)
Packit Service dff8e4
                        return r;
Packit Service dff8e4
                TAKE_PTR(t);
Packit Service dff8e4
                TAKE_PTR(l2);
Packit Service dff8e4
        }
Packit Service dff8e4
Packit Service dff8e4
        return 1;
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int _string_strv_hashmap_put(Hashmap **h, const char *key, const char *value  HASHMAP_DEBUG_PARAMS) {
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        r = _hashmap_ensure_allocated(h, &string_strv_hash_ops  HASHMAP_DEBUG_PASS_ARGS);
Packit Service dff8e4
        if (r < 0)
Packit Service dff8e4
                return r;
Packit Service dff8e4
Packit Service dff8e4
        return string_strv_hashmap_put_internal(*h, key, value);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
int _string_strv_ordered_hashmap_put(OrderedHashmap **h, const char *key, const char *value  HASHMAP_DEBUG_PARAMS) {
Packit Service dff8e4
        int r;
Packit Service dff8e4
Packit Service dff8e4
        r = _ordered_hashmap_ensure_allocated(h, &string_strv_hash_ops  HASHMAP_DEBUG_PASS_ARGS);
Packit Service dff8e4
        if (r < 0)
Packit Service dff8e4
                return r;
Packit Service dff8e4
Packit Service dff8e4
        return string_strv_hashmap_put_internal(PLAIN_HASHMAP(*h), key, value);
Packit Service dff8e4
}
Packit Service dff8e4
Packit Service dff8e4
DEFINE_HASH_OPS_FULL(string_strv_hash_ops, char, string_hash_func, string_compare_func, free, char*, strv_free);