1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130
|
/* strarray.h -- an expanding array of strings
*
* Copyright (c) 1994-2011 Carnegie Mellon University. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The name "Carnegie Mellon University" must not be used to
* endorse or promote products derived from this software without
* prior written permission. For permission or any legal
* details, please contact
* Carnegie Mellon University
* Center for Technology Transfer and Enterprise Creation
* 4615 Forbes Avenue
* Suite 302
* Pittsburgh, PA 15213
* (412) 268-7393, fax: (412) 268-7395
* innovation@andrew.cmu.edu
*
* 4. Redistributions of any form whatsoever must retain the following
* acknowledgment:
* "This product includes software developed by Computing Services
* at Carnegie Mellon University (http://www.cmu.edu/computing/)."
*
* CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO
* THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
* AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE
* FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
* AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
* OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*
* Author: Greg Banks
* Start Date: 2011/01/11
*/
#ifndef __CYRUS_STRARRAY_H__
#define __CYRUS_STRARRAY_H__
#include <string.h>
#include <sys/types.h>
typedef struct
{
int count;
int alloc;
char **data;
} strarray_t;
#define STRARRAY_INITIALIZER { 0, 0, NULL }
#define strarray_init(sa) (memset((sa), 0, sizeof(strarray_t)))
void strarray_fini(strarray_t *);
strarray_t *strarray_new(void);
void strarray_free(strarray_t *);
#define strarray_appendv(sa, s) strarray_nth((sa), strarray_append((sa), (s)))
#define strarray_addv(sa, s) strarray_nth((sa), strarray_add((sa), (s)))
#define strarray_add_casev(sa, s) strarray_nth((sa), strarray_add_case((sa), (s)))
int strarray_append(strarray_t *, const char *);
int strarray_add(strarray_t *, const char *);
int strarray_addm(strarray_t *sa, char *s);
int strarray_add_case(strarray_t *, const char *);
int strarray_appendm(strarray_t *, char *);
void strarray_set(strarray_t *, int idx, const char *);
void strarray_setm(strarray_t *, int idx, char *);
void strarray_insert(strarray_t *, int idx, const char *);
void strarray_insertm(strarray_t *, int idx, char *);
char *strarray_remove(strarray_t *, int idx);
void strarray_remove_all(strarray_t *sa, const char *s);
void strarray_remove_all_case(strarray_t *sa, const char *s);
const char *strarray_nth(const strarray_t *sa, int idx);
const char *strarray_safenth(const strarray_t *sa, int idx);
void strarray_truncate(strarray_t *sa, int newlen);
strarray_t *strarray_dup(const strarray_t *);
void strarray_cat(strarray_t *dest, const strarray_t *src);
void strarray_swap(strarray_t *, int, int);
void strarray_addfirst(strarray_t *, const char *);
void strarray_addfirst_case(strarray_t *, const char *);
void strarray_subtract_complement(strarray_t *sa, const strarray_t *sb);
#define strarray_shift(sa) strarray_remove((sa), 0)
#define strarray_unshift(sa, s) strarray_insert((sa), 0, (s))
#define strarray_unshiftm(sa, s) strarray_insertm((sa), 0, (s))
#define strarray_pop(sa) strarray_remove((sa), -1)
#define strarray_push(sa, s) strarray_append((sa), (s))
#define strarray_pushm(sa, s) strarray_appendm((sa), (s))
char *strarray_join(const strarray_t *, const char *sep);
#define STRARRAY_TRIM (1<<0)
#define STRARRAY_LCASE (1<<1)
strarray_t *strarray_splitm(strarray_t *sa, char *buf, const char *sep, int flags);
strarray_t *strarray_split(const char *buf, const char *sep, int flags);
strarray_t *strarray_nsplit(const char *buf, size_t len, const char *sep, int flags);
/* strarray_cmp_fn_t is same sig as qsort's compar argument */
typedef int strarray_cmp_fn_t(const void *, const void *);
void strarray_sort(strarray_t *, strarray_cmp_fn_t *);
void strarray_uniq(strarray_t *);
char **strarray_safetakevf(strarray_t *sa);
char **strarray_takevf(strarray_t *sa);
int strarray_find(const strarray_t *sa, const char *match,
int starting);
int strarray_find_case(const strarray_t *sa, const char *match,
int starting);
#define strarray_contains(sa, match) (strarray_find(sa, match, 0) >= 0)
#define strarray_contains_case(sa, match) (strarray_find_case(sa, match, 0) >= 0)
int strarray_intersect(const strarray_t *sa, const strarray_t *b);
int strarray_intersect_case(const strarray_t *sa, const strarray_t *b);
int strarray_size(const strarray_t *sa);
int strarray_cmp(const strarray_t *a, const strarray_t *b);
#endif /* __CYRUS_STRARRAY_H__ */
|