WebSVN – tendra.SVN – Diff – /branches/tendra5/src/utilities/sid/dstring.h

+/*
+ * Copyright (c) 2002-2005 The TenDRA Project <http://www.tendra.org/>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice,
+ *    this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ *    this list of conditions and the following disclaimer in the documentation
+ *    and/or other materials provided with the distribution.
+ * 3. Neither the name of The TenDRA Project nor the names of its contributors
+ *    may be used to endorse or promote products derived from this software
+ *    without specific, prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
+ * IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
+ * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+ * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+ * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+ * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * $Id$
+ */
 /*
     		 Crown Copyright (c) 1997
     This TenDRA(r) Computer Program is subject to Copyright
     owned by the United Kingdom Secretary of State for Defence
     acting through the Defence Evaluation and Research Agency
     (DERA).  It is made available to Recipients with a
     royalty-free licence for its use, reproduction, transfer
     to other parties and amendment for any purpose not excluding
     product development provided that any such use et cetera
     shall be deemed to be acceptance of the following conditions:-
         (1) Its Recipients shall ensure that this Notice is
         reproduced upon any copies or amended versions of it;
         (2) Any amended version of it shall be clearly marked to
         show both the nature of and the organisation responsible
         for the relevant amendment or amendments;
         (3) Its onward transfer from a recipient to another
         party shall be deemed to be that party's acceptance of
         these conditions;
         (4) DERA gives no warranty or assurance as to its
         quality or suitability for any purpose and DERA accepts
         no liability whatsoever in relation to any use to which
         it may be put.
 */
  * converted to one of the other string types.
+ *
  ***=== FUNCTIONS ============================================================
+ *
  ** Function:	void			nstring_init
- *			PROTO_S ((NStringP nstring))
+ *			(NStringP nstring)
  ** Exceptions:
+ *
  * This function initialises the specified nstring to be an empty nstring.
+ *
  ** Function:	void			nstring_init_length
- *			PROTO_S ((NStringP nstring, unsigned length))
+ *			(NStringP nstring, unsigned length)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function initialises the specified nstring to be an nstring of the
  * specified length.  The initial contents are unspecified.
+ *
  ** Function:	void			nstring_assign
- *			PROTO_S ((NStringP to, NStringP from))
+ *			(NStringP to, NStringP from)
  ** Exceptions:
+ *
  * This function assigns the from nstring to the to nstring.  The from nstring
  * should not be used afterwards, without reinitialising it.
+ *
  ** Function:	void			nstring_copy_cstring
- *			PROTO_S ((NStringP nstring, CStringP cstring))
+ *			(NStringP nstring, CStringP cstring)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function initialises the specified nstring from the content of the
  * specified cstring.
+ *
  ** Function:	void			nstring_insert_cstring
- *			PROTO_S ((NStringP nstring, CStringP cstring))
+ *			(NStringP nstring, CStringP cstring)
  ** Exceptions:
+ *
  * This function inserts the specified cstring into the specified nstring.
  * Sufficient characters are copied to fill up the nstring.
+ *
  ** Function:	void			nstring_copy
- *			PROTO_S ((NStringP to, NStringP from))
+ *			(NStringP to, NStringP from)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function copies the specified from nstring into the specified to
  * nstring.
+ *
  ** Function:	CStringP		nstring_to_cstring
- *			PROTO_S ((NStringP nstring))
+ *			(NStringP nstring)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function returns a dynamically allocated cstring copy of the specified
  * nstring.  If the nstring contains null characters, then the characters
  * after the first null will be ignored in the cstring (although they will
  * still be part of it).
+ *
  ** Function:	unsigned		nstring_hash_value
- *			PROTO_S ((NStringP nstring))
+ *			(NStringP nstring)
  ** Exceptions:
+ *
  * This function returns the hash value associated with the specified nstring.
  * This value is guaranteed to be identical for all nstrings with the same
  * content.
+ *
  ** Function:	unsigned		nstring_length
- *			PROTO_S ((NStringP nstring))
+ *			(NStringP nstring)
  ** Exceptions:
+ *
  * This function returns the length of the specified nstring.
+ *
  ** Function:	CStringP		nstring_contents
- *			PROTO_S ((NStringP nstring))
+ *			(NStringP nstring)
  ** Exceptions:
+ *
  * This function returns the contents of the specified nstring.
+ *
  ** Function:	CmpT			nstring_compare
- *			PROTO_S ((NStringP nstring1, NStringP nstring2))
+ *			(NStringP nstring1, NStringP nstring2)
  ** Exceptions:
+ *
  * This function returns ``CMP_LT'', ``CMP_EQ'', or ``CMP_GT'', depending on
  * whether the content of nstring1 is lexicographically less than, equal to,
  * or greater than the content of nstring2.
+ *
  ** Function:	BoolT			nstring_equal
- *			PROTO_S ((NStringP nstring1, NStringP nstring2))
+ *			(NStringP nstring1, NStringP nstring2)
  ** Exceptions:
+ *
  * This function returns true if the specified nstrings have the same content,
  * and false otherwise.
+ *
  ** Function:	BoolT			nstring_ci_equal
- *			PROTO_S ((NStringP nstring1, NStringP nstring2))
+ *			(NStringP nstring1, NStringP nstring2)
  ** Exceptions:
+ *
  * This function returns true if the specified nstrings have the same content
  * (ignoring differences in case), and false otherwise.
+ *
  ** Function:	BoolT			nstring_contains
- *			PROTO_S ((NStringP nstring, char c))
+ *			(NStringP nstring, char c)
  ** Exceptions:
+ *
  * This function returns true if the specified nstring contains the specified
  * character, and false otherwise.
+ *
  ** Function:	BoolT			nstring_is_prefix
- *			PROTO_S ((NStringP nstring1, NStringP nstring2))
+ *			(NStringP nstring1, NStringP nstring2)
  ** Exceptions:
+ *
  * This function returns true if the second nstring is a prefix of the first
  * nstring, and false otherwise.
+ *
  ** Function:	void			nstring_destroy
- *			PROTO_S ((NStringP nstring))
+ *			(NStringP nstring)
  ** Exceptions:
+ *
  * This function deallocates the contents of the specified nstring.
+ *
  ** Function:	void			write_nstring
- *			PROTO_S ((OStreamP stream, NStringP nstring))
+ *			(OStreamP stream, NStringP nstring)
  ** Exceptions:	XX_dalloc_no_memory, XX_ostream_write_error
+ *
  * This function writes the content of the specified nstring to the specified
  * ostream.
+ *
  ** Function:	void			dstring_init
- *			PROTO_S ((DStringP dstring))
+ *			(DStringP dstring)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function initialises the specified dstring to be an empty dstring.
+ *
  ** Function:	unsigned		dstring_length
- *			PROTO_S ((DStringP dstring))
+ *			(DStringP dstring)
  ** Exceptions:
+ *
  * This function returns the length of the specified dstring.
+ *
  ** Function:	void			dstring_append_char
- *			PROTO_S ((DStringP dstring, char c))
+ *			(DStringP dstring, char c)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function appends the specified character to the specified dstring.
+ *
  ** Function:	void			dstring_append_cstring
- *			PROTO_S ((DStringP dstring, CStringP cstring)
+ *			(DStringP dstring, CStringP cstring)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function appends the content of the specified cstring to the specified
  * dstring.
+ *
  ** Function:	void			dstring_append_nstring
- *			PROTO_S ((DStringP dstring, NStringP nstring)
+ *			(DStringP dstring, NStringP nstring)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function appends the content of the specified nstring to the specified
  * dstring.
+ *
  ** Function:	BoolT			dstring_last_char_equal
- *			PROTO_S ((DStringP dstring, char c))
+ *			(DStringP dstring, char c)
  ** Exceptions:
+ *
  * This function returns true if the last character of the specified dstring
  * is the same as the specified character, and false otherwise.  If the
  * dstring is empty, then false is always returned.
+ *
  ** Function:	void			dstring_to_nstring
- *			PROTO_S ((DStringP dstring, NStringP nstring_ref))
+ *			(DStringP dstring, NStringP nstring_ref)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function copies the content of the specified dstring into the
  * specified nstring.
+ *
  ** Functions:	CStringP		dstring_to_cstring
- *			PROTO_S ((DStringP dstring))
+ *			(DStringP dstring)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function copies the content of the specified dstring into a
  * dynamically allocated cstring, and returns it.
+ *
  ** Function:	CStringP		dstring_destroy_to_cstring
- *			PROTO_S ((DStringP dstring))
+ *			(DStringP dstring)
  ** Exceptions:	XX_dalloc_no_memory
+ *
  * This function does the equivalent of a call to ``dstring_to_cstring''
  * followed by a call to ``dstring_destroy''.  It returns a cstring that is
  * normally the internal cstring of the dstring (if there isn't enough room
  * for a null character at the end, then the cstring will need to be
  * reallocated).
+ *
  ** Function:	void			dstring_destroy
- *			PROTO_S ((DStringP dstring))
+ *			(DStringP dstring)
  ** Exceptions:
+ *
  * This function deallocates the contents of the specified dstring.
+ *
  **** Change log:
     CStringP			contents;
 } DStringT, *DStringP;
 /*--------------------------------------------------------------------------*/
-extern void			nstring_init
+extern void		nstring_init(NStringP);
-	PROTO_S ((NStringP));
-extern void			nstring_init_length
+extern void		nstring_init_length(NStringP, unsigned);
-	PROTO_S ((NStringP, unsigned));
-extern void			nstring_assign
+extern void		nstring_assign(NStringP, NStringP);
-	PROTO_S ((NStringP, NStringP));
-extern void			nstring_copy_cstring
+extern void		nstring_copy_cstring(NStringP, CStringP);
-	PROTO_S ((NStringP, CStringP));
-extern void			nstring_insert_cstring
+extern void		nstring_insert_cstring(NStringP, CStringP);
-	PROTO_S ((NStringP, CStringP));
-extern void			nstring_copy
+extern void		nstring_copy(NStringP, NStringP);
-	PROTO_S ((NStringP, NStringP));
-extern CStringP			nstring_to_cstring
+extern CStringP		nstring_to_cstring(NStringP);
-	PROTO_S ((NStringP));
-extern unsigned			nstring_hash_value
+extern unsigned		nstring_hash_value(NStringP);
-	PROTO_S ((NStringP));
-extern unsigned			nstring_length
+extern unsigned		nstring_length(NStringP);
-	PROTO_S ((NStringP));
-extern CStringP			nstring_contents
+extern CStringP		nstring_contents(NStringP);
-	PROTO_S ((NStringP));
-extern CmpT			nstring_compare
+extern CmpT		nstring_compare(NStringP, NStringP);
-	PROTO_S ((NStringP, NStringP));
-extern BoolT			nstring_equal
+extern BoolT		nstring_equal(NStringP, NStringP);
-	PROTO_S ((NStringP, NStringP));
-extern BoolT			nstring_ci_equal
+extern BoolT		nstring_ci_equal(NStringP, NStringP);
-	PROTO_S ((NStringP, NStringP));
-extern BoolT			nstring_contains
+extern BoolT		nstring_contains(NStringP, char);
-	PROTO_S ((NStringP, char));
-extern BoolT			nstring_is_prefix
+extern BoolT		nstring_is_prefix(NStringP, NStringP);
-	PROTO_S ((NStringP, NStringP));
-extern void			nstring_destroy
+extern void		nstring_destroy(NStringP);
-	PROTO_S ((NStringP));
-extern void			write_nstring
+extern void		write_nstring(OStreamP, NStringP);
-	PROTO_S ((OStreamP, NStringP));
-extern void			dstring_init
+extern void		dstring_init(DStringP);
-	PROTO_S ((DStringP));
-extern unsigned			dstring_length
+extern unsigned		dstring_length(DStringP);
-	PROTO_S ((DStringP));
-extern void			dstring_append_char
+extern void		dstring_append_char(DStringP, char);
-	PROTO_S ((DStringP, char));
-extern void			dstring_append_cstring
+extern void		dstring_append_cstring(DStringP, CStringP);
-	PROTO_S ((DStringP, CStringP));
-extern void			dstring_append_nstring
+extern void		dstring_append_nstring(DStringP, NStringP);
-	PROTO_S ((DStringP, NStringP));
-extern BoolT			dstring_last_char_equal
+extern BoolT		dstring_last_char_equal(DStringP, char);
-	PROTO_S ((DStringP, char));
-extern void			dstring_to_nstring
+extern void		dstring_to_nstring(DStringP, NStringP);
-	PROTO_S ((DStringP, NStringP));
-extern CStringP			dstring_to_cstring
+extern CStringP		dstring_to_cstring(DStringP);
-	PROTO_S ((DStringP));
-extern CStringP			dstring_destroy_to_cstring
+extern CStringP		dstring_destroy_to_cstring(DStringP);
-	PROTO_S ((DStringP));
-extern void			dstring_destroy
+extern void		dstring_destroy(DStringP);
-	PROTO_S ((DStringP));
 /*--------------------------------------------------------------------------*/
 #ifdef FS_FAST
-#define nstring_length(s) ((s)->length)
+#define nstring_length(s)	((s)->length)
-#define nstring_contents(s) ((s)->contents)
+#define nstring_contents(s)	((s)->contents)
-#define dstring_length(s) ((s)->length)
+#define dstring_length(s)	((s)->length)
 #endif /* defined (FS_FAST) */
 #endif /* !defined (H_DSTRING) */
 /*

Subversion Repositories tendra.SVN

(root)/branches/tendra5/src/utilities/sid/dstring.h – Rev 5 → 6