Subversion Repositories tendra.SVN

Rev

Rev 5 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 5 Rev 6
Line -... Line 1...
-
 
1
/*
-
 
2
 * Copyright (c) 2002-2006 The TenDRA Project <http://www.tendra.org/>.
-
 
3
 * All rights reserved.
-
 
4
 *
-
 
5
 * Redistribution and use in source and binary forms, with or without
-
 
6
 * modification, are permitted provided that the following conditions are met:
-
 
7
 *
-
 
8
 * 1. Redistributions of source code must retain the above copyright notice,
-
 
9
 *    this list of conditions and the following disclaimer.
-
 
10
 * 2. Redistributions in binary form must reproduce the above copyright notice,
-
 
11
 *    this list of conditions and the following disclaimer in the documentation
-
 
12
 *    and/or other materials provided with the distribution.
-
 
13
 * 3. Neither the name of The TenDRA Project nor the names of its contributors
-
 
14
 *    may be used to endorse or promote products derived from this software
-
 
15
 *    without specific, prior written permission.
-
 
16
 *
-
 
17
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
-
 
18
 * IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
-
 
19
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-
 
20
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
-
 
21
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
-
 
22
 * EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
-
 
23
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
-
 
24
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
-
 
25
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
-
 
26
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
-
 
27
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
 
28
 *
-
 
29
 * $Id$
-
 
30
 */
1
/*
31
/*
2
    		 Crown Copyright (c) 1997
32
    		 Crown Copyright (c) 1997
3
    
33
 
4
    This TenDRA(r) Computer Program is subject to Copyright
34
    This TenDRA(r) Computer Program is subject to Copyright
5
    owned by the United Kingdom Secretary of State for Defence
35
    owned by the United Kingdom Secretary of State for Defence
6
    acting through the Defence Evaluation and Research Agency
36
    acting through the Defence Evaluation and Research Agency
7
    (DERA).  It is made available to Recipients with a
37
    (DERA).  It is made available to Recipients with a
8
    royalty-free licence for its use, reproduction, transfer
38
    royalty-free licence for its use, reproduction, transfer
9
    to other parties and amendment for any purpose not excluding
39
    to other parties and amendment for any purpose not excluding
10
    product development provided that any such use et cetera
40
    product development provided that any such use et cetera
11
    shall be deemed to be acceptance of the following conditions:-
41
    shall be deemed to be acceptance of the following conditions:-
12
    
42
 
13
        (1) Its Recipients shall ensure that this Notice is
43
        (1) Its Recipients shall ensure that this Notice is
14
        reproduced upon any copies or amended versions of it;
44
        reproduced upon any copies or amended versions of it;
15
    
45
 
16
        (2) Any amended version of it shall be clearly marked to
46
        (2) Any amended version of it shall be clearly marked to
17
        show both the nature of and the organisation responsible
47
        show both the nature of and the organisation responsible
18
        for the relevant amendment or amendments;
48
        for the relevant amendment or amendments;
19
    
49
 
20
        (3) Its onward transfer from a recipient to another
50
        (3) Its onward transfer from a recipient to another
21
        party shall be deemed to be that party's acceptance of
51
        party shall be deemed to be that party's acceptance of
22
        these conditions;
52
        these conditions;
23
    
53
 
24
        (4) DERA gives no warranty or assurance as to its
54
        (4) DERA gives no warranty or assurance as to its
25
        quality or suitability for any purpose and DERA accepts
55
        quality or suitability for any purpose and DERA accepts
26
        no liability whatsoever in relation to any use to which
56
        no liability whatsoever in relation to any use to which
27
        it may be put.
57
        it may be put.
28
*/
58
*/
Line 54... Line 84...
54
 *
84
 *
55
 * This is the nstring list type.
85
 * This is the nstring list type.
56
 *
86
 *
57
 ***=== FUNCTIONS ============================================================
87
 ***=== FUNCTIONS ============================================================
58
 *
88
 *
59
 ** Function:	void			nstring_list_init
89
 ** Function:	void nstring_list_init(NStringListP list)
60
 *			PROTO_S ((NStringListP list))
-
 
61
 ** Exceptions:
90
 ** Exceptions:
62
 *
91
 *
63
 * This function initialises the specified nstring list to be an empty list.
92
 * This function initialises the specified nstring list to be an empty list.
64
 *
93
 *
65
 ** Function:	void			nstring_list_append
-
 
66
 *			PROTO_S ((NStringListP list, NStringP nstring))
94
 ** Function:	void nstring_list_append(NStringListP list, NStringP nstring)
67
 ** Exceptions:	XX_dalloc_no_memory
95
 ** Exceptions:	XX_dalloc_no_memory
68
 *
96
 *
69
 * This function appends the specified nstring onto the specified list.
97
 * This function appends the specified nstring onto the specified list.
70
 *
98
 *
71
 ** Function:	NStringListEntryP	nstring_list_head
99
 ** Function:	NStringListEntryP nstring_list_head(NStringListP list)
72
 *			PROTO_S ((NStringListP list))
-
 
73
 ** Exceptions:
100
 ** Exceptions:
74
 *
101
 *
75
 * This function returns a pointer to the first entry in the specified list.
102
 * This function returns a pointer to the first entry in the specified list.
76
 *
103
 *
77
 ** Function:	NStringP		nstring_list_entry_string
104
 ** Function:	NStringP nstring_list_entry_string(NStringListEntryP entry)
78
 *			PROTO_S ((NStringListEntryP entry))
-
 
79
 ** Exceptions:
105
 ** Exceptions:
80
 *
106
 *
81
 * This function returns a pointer to the nstring stored in the specified
107
 * This function returns a pointer to the nstring stored in the specified
82
 * list entry.
108
 * list entry.
83
 *
109
 *
84
 ** Function:	NStringListEntryP	nstring_list_entry_deallocate
110
 ** Function:	NStringListEntryP
85
 *			PROTO_S ((NStringListEntryP entry))
111
 *		    nstring_list_entry_deallocate(NStringListEntryP entry)
86
 ** Exceptions:
112
 ** Exceptions:
87
 *
113
 *
88
 * This function deallocates the specified list entry (without deallocating
114
 * This function deallocates the specified list entry (without deallocating
89
 * the string - this must be done by the calling function) and returns a
115
 * the string - this must be done by the calling function) and returns a
90
 * pointer to the next entry in the list.  Once this function has been called,
116
 * pointer to the next entry in the list.  Once this function has been called,
Line 127... Line 153...
127
} NStringListT, *NStringListP;
153
} NStringListT, *NStringListP;
128
 
154
 
129
/*--------------------------------------------------------------------------*/
155
/*--------------------------------------------------------------------------*/
130
 
156
 
131
extern void			nstring_list_init
157
extern void			nstring_list_init
132
	PROTO_S ((NStringListP));
158
(NStringListP);
133
extern void			nstring_list_append
159
extern void			nstring_list_append
134
	PROTO_S ((NStringListP, NStringP));
160
(NStringListP, NStringP);
135
extern NStringListEntryP	nstring_list_head
161
extern NStringListEntryP	nstring_list_head
136
	PROTO_S ((NStringListP));
162
(NStringListP);
137
extern NStringP			nstring_list_entry_string
163
extern NStringP			nstring_list_entry_string
138
	PROTO_S ((NStringListEntryP));
164
(NStringListEntryP);
139
extern NStringListEntryP	nstring_list_entry_deallocate
165
extern NStringListEntryP	nstring_list_entry_deallocate
140
	PROTO_S ((NStringListEntryP));
166
(NStringListEntryP);
141
 
167
 
142
#endif /* !defined (H_NSTRING_LIST) */
168
#endif /* !defined (H_NSTRING_LIST) */
143

169

144
/*
170
/*
145
 * Local variables(smf):
171
 * Local variables(smf):