reorganize sources
[protos/libecoli.git] / lib / ecoli_strvec.h
diff --git a/lib/ecoli_strvec.h b/lib/ecoli_strvec.h
deleted file mode 100644 (file)
index 8e14973..0000000
+++ /dev/null
@@ -1,174 +0,0 @@
-/* SPDX-License-Identifier: BSD-3-Clause
- * Copyright 2016, Olivier MATZ <zer0@droids-corp.org>
- */
-
-/**
- * Vectors of strings.
- *
- * The ec_strvec API provide helpers to manipulate string vectors.
- * When duplicating vectors, the strings are not duplicated in memory,
- * a reference counter is used.
- */
-
-#ifndef ECOLI_STRVEC_
-#define ECOLI_STRVEC_
-
-#include <stdio.h>
-
-/**
- * Allocate a new empty string vector.
- *
- * @return
- *   The new strvec object, or NULL on error (errno is set).
- */
-struct ec_strvec *ec_strvec(void);
-
-#ifndef EC_COUNT_OF
-#define EC_COUNT_OF(x) ((sizeof(x)/sizeof(0[x])) / \
-               ((size_t)(!(sizeof(x) % sizeof(0[x])))))
-#endif
-
-/**
- * Allocate a new string vector
- *
- * The string vector is initialized with the list of const strings
- * passed as arguments.
- *
- * @return
- *   The new strvec object, or NULL on error (errno is set).
- */
-#define EC_STRVEC(args...) ({                                          \
-                       const char *_arr[] = {args};                    \
-                       ec_strvec_from_array(_arr, EC_COUNT_OF(_arr));  \
-               })
-/**
- * Allocate a new string vector
- *
- * The string vector is initialized with the array of const strings
- * passed as arguments.
- *
- * @param strarr
- *   The array of const strings.
- * @param n
- *   The number of strings in the array.
- * @return
- *   The new strvec object, or NULL on error (errno is set).
- */
-struct ec_strvec *ec_strvec_from_array(const char * const *strarr,
-       size_t n);
-
-/**
- * Add a string in a vector.
- *
- * @param strvec
- *   The pointer to the string vector.
- * @param s
- *   The string to be added at the end of the vector.
- * @return
- *   0 on success or -1 on error (errno is set).
- */
-int ec_strvec_add(struct ec_strvec *strvec, const char *s);
-
-/**
- * Delete the last entry in the string vector.
- *
- * @param strvec
- *   The pointer to the string vector.
- * @param s
- *   The string to be added at the end of the vector.
- * @return
- *   0 on success or -1 on error (errno is set).
- */
-int ec_strvec_del_last(struct ec_strvec *strvec);
-
-/**
- * Duplicate a string vector.
- *
- * @param strvec
- *   The pointer to the string vector.
- * @return
- *   The duplicated strvec object, or NULL on error (errno is set).
- */
-struct ec_strvec *ec_strvec_dup(const struct ec_strvec *strvec);
-
-/**
- * Duplicate a part of a string vector.
- *
- * @param strvec
- *   The pointer to the string vector.
- * @param off
- *   The index of the first string to duplicate.
- * @param
- *   The number of strings to duplicate.
- * @return
- *   The duplicated strvec object, or NULL on error (errno is set).
- */
-struct ec_strvec *ec_strvec_ndup(const struct ec_strvec *strvec,
-       size_t off, size_t len);
-
-/**
- * Free a string vector.
- *
- * @param strvec
- *   The pointer to the string vector.
- */
-void ec_strvec_free(struct ec_strvec *strvec);
-
-/**
- * Get the length of a string vector.
- *
- * @param strvec
- *   The pointer to the string vector.
- * @return
- *   The length of the vector.
- */
-size_t ec_strvec_len(const struct ec_strvec *strvec);
-
-/**
- * Get a string element from a vector.
- *
- * @param strvec
- *   The pointer to the string vector.
- * @param idx
- *   The index of the string to get.
- * @return
- *   The string stored at given index, or NULL on error (strvec is NULL
- *   or invalid index).
- */
-const char *ec_strvec_val(const struct ec_strvec *strvec, size_t idx);
-
-/**
- * Compare two string vectors
- *
- * @param strvec
- *   The pointer to the first string vector.
- * @param strvec
- *   The pointer to the second string vector.
- * @return
- *   0 if the string vectors are equal.
- */
-int ec_strvec_cmp(const struct ec_strvec *strvec1,
-               const struct ec_strvec *strvec2);
-
-/**
- * Sort the string vector.
- *
- * @param strvec
- *   The pointer to the first string vector.
- * @param str_cmp
- *   The sort function to use. If NULL, use strcmp.
- */
-void ec_strvec_sort(struct ec_strvec *strvec,
-               int (*str_cmp)(const char *s1, const char *s2));
-
-/**
- * Dump a string vector.
- *
- * @param out
- *   The stream where the dump is sent.
- * @param strvec
- *   The pointer to the string vector.
- */
-void ec_strvec_dump(FILE *out, const struct ec_strvec *strvec);
-
-#endif