str_list.h 2.76 KB
Newer Older
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
/* str_list.h */

/* Functions to deal with NULL-terminated string lists */

/* $Id$ */

/****************************************************************************
 * @format.tab-size 4		(Plain Text/Source Code File Header)			*
 * @format.use-tabs true	(see http://www.synchro.net/ptsc_hdr.html)		*
 *																			*
 * Copyright 2004 Rob Swindell - http://www.synchro.net/copyright.html		*
 *																			*
 * This library is free software; you can redistribute it and/or			*
 * modify it under the terms of the GNU Lesser General Public License		*
 * as published by the Free Software Foundation; either version 2			*
 * of the License, or (at your option) any later version.					*
 * See the GNU Lesser General Public License for more details: lgpl.txt or	*
 * http://www.fsf.org/copyleft/lesser.html									*
 *																			*
 * Anonymous FTP access to the most recent released source is available at	*
 * ftp://vert.synchro.net, ftp://cvs.synchro.net and ftp://ftp.synchro.net	*
 *																			*
 * Anonymous CVS access to the development source and modification history	*
 * is available at cvs.synchro.net:/cvsroot/sbbs, example:					*
 * cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs login			*
 *     (just hit return, no password is necessary)							*
 * cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs checkout src		*
 *																			*
 * For Synchronet coding style and modification guidelines, see				*
 * http://www.synchro.net/source.html										*
 *																			*
 * You are encouraged to submit any modifications (preferably in Unix diff	*
 * format) via e-mail to mods@synchro.net									*
 *																			*
 * Note: If this box doesn't appear square, then you need to fix your tabs.	*
 ****************************************************************************/

#ifndef _STR_LIST_H
#define _STR_LIST_H

#include "gen_defs.h"

#if defined(__cplusplus)
extern "C" {
#endif

47
48
typedef char** str_list_t;

49
/* Returns an allocated and terminated string list */
50
str_list_t	strListAlloc(void);
51
52

/* Frees the strings in the list (and the list itself) */
53
void		strListFree(str_list_t* list);
54
55

/* Pass a pointer to a string list, the string to add */
56
/* Returns the updated list or NULL on error */
57
str_list_t	strListAdd(str_list_t* list, char* str);
58
59

/* Adds a string into the list at a specific index */
60
str_list_t	strListAddAt(str_list_t* list, char* str, size_t index);
61
62

/* Count the number of strings in the list and returns the count */
63
size_t		strListCount(str_list_t list);
64

rswindell's avatar
rswindell committed
65
66
67
68
69
void		strListSortAlpha(str_list_t list);
void		strListSortAlphaReverse(str_list_t list);
void		strListSortAlphaCase(str_list_t list);
void		strListSortAlphaCaseReverse(str_list_t list);

70
71
72
73
74
#if defined(__cplusplus)
}
#endif

#endif	/* Don't add anything after this line */