strvec.h

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright 2016, Olivier MATZ <zer0@droids-corp.org>
 */
 
#pragma once
#include <stdio.h>
 
struct ec_strvec;
 
struct ec_strvec *ec_strvec(void);
 
#define EC_STRVEC(args...)                                                                         \
    ({                                                                                         \
        const char *_arr[] = {args};                                                       \
        ec_strvec_from_array(_arr, EC_COUNT_OF(_arr));                                     \
    })
struct ec_strvec *ec_strvec_from_array(const char *const *strarr, size_t n);
 
typedef enum {
    EC_STRVEC_STRICT = 0x1,
    EC_STRVEC_TRAILSP = 0x2,
} ec_strvec_flag_t;
 
#define EC_STRVEC_ATTR_START "start"
#define EC_STRVEC_ATTR_END "end"
 
struct ec_strvec *
ec_strvec_sh_lex_str(const char *str, ec_strvec_flag_t flags, char *unclosed_quote);
 
int ec_strvec_set(struct ec_strvec *strvec, size_t idx, const char *s);
 
int ec_strvec_add(struct ec_strvec *strvec, const char *s);
 
int ec_strvec_del_last(struct ec_strvec *strvec);
 
struct ec_strvec *ec_strvec_dup(const struct ec_strvec *strvec);
 
struct ec_strvec *ec_strvec_ndup(const struct ec_strvec *strvec, size_t off, size_t len);
 
void ec_strvec_free(struct ec_strvec *strvec);
 
size_t ec_strvec_len(const struct ec_strvec *strvec);
 
const char *ec_strvec_val(const struct ec_strvec *strvec, size_t idx);
 
const struct ec_dict *ec_strvec_get_attrs(const struct ec_strvec *strvec, size_t idx);
 
int ec_strvec_set_attrs(struct ec_strvec *strvec, size_t idx, struct ec_dict *attrs);
 
int ec_strvec_cmp(const struct ec_strvec *strvec1, const struct ec_strvec *strvec2);
 
void ec_strvec_sort(struct ec_strvec *strvec, int (*str_cmp)(const char *s1, const char *s2));
 
void ec_strvec_dump(FILE *out, const struct ec_strvec *strvec);