1 .\" $NetBSD: stringlist.3,v 1.5 1999/03/22 19:44:46 garbled Exp $
3 .\" Copyright (c) 1997, 1999 The NetBSD Foundation, Inc.
4 .\" All rights reserved.
6 .\" This file was contributed to The NetBSD Foundation by Luke Mewburn.
8 .\" Redistribution and use in source and binary forms, with or without
9 .\" modification, are permitted provided that the following conditions
11 .\" 1. Redistributions of source code must retain the above copyright
12 .\" notice, this list of conditions and the following disclaimer.
13 .\" 2. Redistributions in binary form must reproduce the above copyright
14 .\" notice, this list of conditions and the following disclaimer in the
15 .\" documentation and/or other materials provided with the distribution.
17 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
18 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
19 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
20 .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
21 .\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
25 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27 .\" POSSIBILITY OF SUCH DAMAGE.
40 .Nd stringlist manipulation functions
48 .Fn sl_add "StringList *sl" "char *item"
50 .Fn sl_free "StringList *sl" "int freeall"
52 .Fn sl_find "StringList *sl" "const char *item"
56 functions manipulate stringlists, which are lists of
57 strings that extend automatically if necessary.
61 structure has the following definition:
62 .Bd -literal -offset indent
63 typedef struct _stringlist {
69 .Bl -tag -width "sl_str" -offset indent
71 a pointer to the base of the array containing the list.
78 of the current element.
81 The following stringlist manipulation functions are available:
82 .Bl -tag -width "sl_init()"
85 Returns a pointer to a
91 Releases memory occupied by
98 is non-zero, then each of the items within
108 extending the size of
110 Returns zero upon success, \-1 upon failure.
116 returning NULL if it is not found.
124 functions appeared in