Subversion Repositories tendra.SVN

Rev

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

Rev 2 Rev 7
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 cstring list type.
 85 
 * This is the cstring list type.
56 
 *
 86 
 *
57 
 ***=== FUNCTIONS ============================================================
 87 
 ***=== FUNCTIONS ============================================================
58 
 *
 88 
 *
59 
 ** Function:	void			cstring_list_init
 89 
 ** Function:	void cstring_list_init(CStringListP list)
60 
 *			PROTO_S ((CStringListP list))
 - 
 
61 
 ** Exceptions:
 90 
 ** Exceptions:
62 
 *
 91 
 *
63 
 * This function initialises the specified cstring list to be an empty list.
 92 
 * This function initialises the specified cstring list to be an empty list.
64 
 *
 93 
 *
65 
 ** Function:	void			cstring_list_append
 - 
 
66 
 *			PROTO_S ((CStringListP list, CStringP cstring))
 94 
 ** Function:	void cstring_list_append(CStringListP list, CStringP cstring)
67 
 ** Exceptions:	XX_dalloc_no_memory
 95 
 ** Exceptions:	XX_dalloc_no_memory
68 
 *
 96 
 *
69 
 * This function appends the specified cstring onto the specified list.
 97 
 * This function appends the specified cstring onto the specified list.
70 
 *
 98 
 *
71 
 ** Function:	CStringListEntryP	cstring_list_head
 99 
 ** Function:	CStringListEntryP cstring_list_head(CStringListP list)
72 
 *			PROTO_S ((CStringListP 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:	CStringP		cstring_list_entry_string
 104 
 ** Function:	CStringP cstring_list_entry_string(CStringListEntryP entry)
78 
 *			PROTO_S ((CStringListEntryP entry))
 - 
 
79 
 ** Exceptions:
 105 
 ** Exceptions:
80 
 *
 106 
 *
81 
 * This function returns a pointer to the cstring stored in the specified
 107 
 * This function returns a pointer to the cstring stored in the specified
82 
 * list entry.
 108 
 * list entry.
83 
 *
 109 
 *
84 
 ** Function:	CStringListEntryP	cstring_list_entry_deallocate
 110 
 ** Function:	CStringListEntryP
85 
 *			PROTO_S ((CStringListEntryP entry))
 111 
 * 		    cstring_list_entry_deallocate(CStringListEntryP 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 
} CStringListT, *CStringListP;
 153 
} CStringListT, *CStringListP;
128 
 
 154 
 
129 
/*--------------------------------------------------------------------------*/
 155 
/*--------------------------------------------------------------------------*/
130 
 
 156 
 
131 
extern void			cstring_list_init
 157 
extern void			cstring_list_init
132 
	PROTO_S ((CStringListP));
 158 
(CStringListP);
133 
extern void			cstring_list_append
 159 
extern void			cstring_list_append
134 
	PROTO_S ((CStringListP, CStringP));
 160 
(CStringListP, CStringP);
135 
extern BoolT			cstring_list_contains
 161 
extern BoolT			cstring_list_contains
136 
	PROTO_S ((CStringListP, CStringP));
 162 
(CStringListP, CStringP);
137 
extern CStringListEntryP	cstring_list_head
 163 
extern CStringListEntryP	cstring_list_head
138 
	PROTO_S ((CStringListP));
 164 
(CStringListP);
139 
extern CStringP			cstring_list_entry_string
 165 
extern CStringP			cstring_list_entry_string
140 
	PROTO_S ((CStringListEntryP));
 166 
(CStringListEntryP);
141 
extern CStringListEntryP	cstring_list_entry_deallocate
 167 
extern CStringListEntryP	cstring_list_entry_deallocate
142 
	PROTO_S ((CStringListEntryP));
 168 
(CStringListEntryP);
143 
 
 169 
 
144 
#endif /* !defined (H_CSTRING_LIST) */
 170 
#endif /* !defined (H_CSTRING_LIST) */
145
171
146 
/*
 172 
/*
147 
 * Local variables(smf):
 173 
 * Local variables(smf):