| stringlist.3 (108040) | stringlist.3 (109508) |
|---|---|
| 1.\" $NetBSD: stringlist.3,v 1.2 1997/04/09 08:59:25 kleink Exp $ | 1.\" $NetBSD: stringlist.3,v 1.5 1999/03/22 19:44:46 garbled Exp $ |
| 2.\" | 2.\" |
| 3.\" Copyright (c) 1997 The NetBSD Foundation, Inc. | 3.\" Copyright (c) 1997, 1999 The NetBSD Foundation, Inc. |
| 4.\" All rights reserved. 5.\" 6.\" This file was contributed to The NetBSD Foundation by Luke Mewburn. 7.\" 8.\" Redistribution and use in source and binary forms, with or without 9.\" modification, are permitted provided that the following conditions 10.\" are met: 11.\" 1. Redistributions of source code must retain the above copyright --- 16 unchanged lines hidden (view full) --- 28.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 29.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 30.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 31.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 32.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 33.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 34.\" POSSIBILITY OF SUCH DAMAGE. 35.\" | 4.\" All rights reserved. 5.\" 6.\" This file was contributed to The NetBSD Foundation by Luke Mewburn. 7.\" 8.\" Redistribution and use in source and binary forms, with or without 9.\" modification, are permitted provided that the following conditions 10.\" are met: 11.\" 1. Redistributions of source code must retain the above copyright --- 16 unchanged lines hidden (view full) --- 28.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 29.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 30.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 31.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 32.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 33.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 34.\" POSSIBILITY OF SUCH DAMAGE. 35.\" |
| 36.\" $FreeBSD: head/lib/libc/gen/stringlist.3 108040 2002-12-18 13:33:04Z ru $ | 36.\" $FreeBSD: head/lib/libc/gen/stringlist.3 109508 2003-01-19 01:16:01Z obrien $ |
| 37.\" | 37.\" |
| 38.Dd February 24, 1997 | 38.Dd November 28, 1999 |
| 39.Os 40.Dt STRINGLIST 3 41.Sh NAME 42.Nm stringlist , 43.Nm sl_init , 44.Nm sl_add , 45.Nm sl_free , 46.Nm sl_find 47.Nd stringlist manipulation functions 48.Sh LIBRARY 49.Lb libc 50.Sh SYNOPSIS 51.In stringlist.h 52.Ft StringList * 53.Fn sl_init | 39.Os 40.Dt STRINGLIST 3 41.Sh NAME 42.Nm stringlist , 43.Nm sl_init , 44.Nm sl_add , 45.Nm sl_free , 46.Nm sl_find 47.Nd stringlist manipulation functions 48.Sh LIBRARY 49.Lb libc 50.Sh SYNOPSIS 51.In stringlist.h 52.Ft StringList * 53.Fn sl_init |
| 54.Ft void | 54.Ft int |
| 55.Fn sl_add "StringList *sl" "char *item" 56.Ft void 57.Fn sl_free "StringList *sl" "int freeall" 58.Ft char * 59.Fn sl_find "StringList *sl" "char *item" 60.Sh DESCRIPTION 61The 62.Nm --- 23 unchanged lines hidden (view full) --- 86of the current element. 87.El 88.Pp 89The following stringlist manipulation functions are available: 90.Bl -tag -width "sl_init()" 91.It Fn sl_init 92Create a stringlist. 93Returns a pointer to a | 55.Fn sl_add "StringList *sl" "char *item" 56.Ft void 57.Fn sl_free "StringList *sl" "int freeall" 58.Ft char * 59.Fn sl_find "StringList *sl" "char *item" 60.Sh DESCRIPTION 61The 62.Nm --- 23 unchanged lines hidden (view full) --- 86of the current element. 87.El 88.Pp 89The following stringlist manipulation functions are available: 90.Bl -tag -width "sl_init()" 91.It Fn sl_init 92Create a stringlist. 93Returns a pointer to a |
| 94.Vt StringList . | 94.Vt StringList , 95or 96.Dv NULL 97in case of failure. |
| 95.It Fn sl_free 96Releases memory occupied by 97.Fa sl 98and the 99.Fa sl->sl_str 100array. 101If 102.Fa freeall 103is non-zero, then each of the items within 104.Fa sl->sl_str 105is released as well. 106.It Fn sl_add 107Add 108.Fa item 109to 110.Fa sl->sl_str 111at 112.Fa sl->sl_cur , 113extending the size of | 98.It Fn sl_free 99Releases memory occupied by 100.Fa sl 101and the 102.Fa sl->sl_str 103array. 104If 105.Fa freeall 106is non-zero, then each of the items within 107.Fa sl->sl_str 108is released as well. 109.It Fn sl_add 110Add 111.Fa item 112to 113.Fa sl->sl_str 114at 115.Fa sl->sl_cur , 116extending the size of |
| 114.Fa sl->sl_str | 117.Fa sl->sl_str . 118Returns zero upon success, -1 upon failure. |
| 115.It Fn sl_find 116Find 117.Fa item 118in 119.Fa sl , 120returning NULL if it's not found. 121.El 122.Sh SEE ALSO 123.Xr free 3 , 124.Xr malloc 3 | 119.It Fn sl_find 120Find 121.Fa item 122in 123.Fa sl , 124returning NULL if it's not found. 125.El 126.Sh SEE ALSO 127.Xr free 3 , 128.Xr malloc 3 |
| 129.Sh HISTORY 130The 131.Nm 132functions appeared in 133.Fx 2.2.6 134and 135.Nx 1.3 . |
|