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 40... Line 70...
40 
 * replaced on operating systems with a different file name syntax to that
 70 
 * replaced on operating systems with a different file name syntax to that
41 
 * used here ('/' seperated path names).
 71 
 * used here ('/' seperated path names).
42 
 *
 72 
 *
43 
 ***=== FUNCTIONS ============================================================
 73 
 ***=== FUNCTIONS ============================================================
44 
 *
 74 
 *
45 
 ** Function:	CStringP		file_name_basename
 75 
 ** Function:	CStringP file_name_basename(CStringP path)
46 
 *			PROTO_S ((CStringP path))
 - 
 
47 
 ** Exceptions:	XX_dalloc_no_memory
 76 
 ** Exceptions:	XX_dalloc_no_memory
48 
 *
 77 
 *
49 
 * This function returns a dynamically allocated copy of the file name
 78 
 * This function returns a dynamically allocated copy of the file name
50 
 * component of the specifed path.
 79 
 * component of the specifed path.
51 
 *
 80 
 *
52 
 ** Function:	CStringP		file_name_dirname
 81 
 ** Function:	CStringP file_name_dirname(CStringP path)
53 
 *			PROTO_S ((CStringP path))
 - 
 
54 
 ** Exceptions:	XX_dalloc_no_memory
 82 
 ** Exceptions:	XX_dalloc_no_memory
55 
 *
 83 
 *
56 
 * This function returns a dynamically allocated copy of the directory name
 84 
 * This function returns a dynamically allocated copy of the directory name
57 
 * component of the specifed path.
 85 
 * component of the specifed path.
58 
 *
 86 
 *
59 
 ** Function:	CStringP		file_name_expand
 87 
 ** Function:	CStringP file_name_expand(CStringP dir, CStringP name,
60 
 *			PROTO_S ((CStringP dir, CStringP name,
 - 
 
61 
 *				  CStringP suffix))
 88 
 *					  CStringP suffix)
62 
 ** Exceptions:	XX_dalloc_no_memory
 89 
 ** Exceptions:	XX_dalloc_no_memory
63 
 *
 90 
 *
64 
 * This function returns a dynamically allocated copy of the path name
 91 
 * This function returns a dynamically allocated copy of the path name
65 
 * obtained by expanding the specified name in the specified dir.  If the
 92 
 * obtained by expanding the specified name in the specified dir.  If the
66 
 * suffix is non nil, it is also appended to the path name, following the
 93 
 * suffix is non nil, it is also appended to the path name, following the
67 
 * suffix seperator character.
 94 
 * suffix seperator character.
68 
 *
 95 
 *
69 
 ** Function:	CStringP		file_name_is_basename
 96 
 ** Function:	CStringP file_name_is_basename(CStringP path)
70 
 *			PROTO_S ((CStringP path))
 - 
 
71 
 ** Exceptions:
 97 
 ** Exceptions:
72 
 *
 98 
 *
73 
 * This function returns true if the specified path has no directory
 99 
 * This function returns true if the specified path has no directory
74 
 * component.
 100 
 * component.
75 
 *
 101 
 *
76 
 ** Function:	CStringP		file_name_is_absolute
 102 
 ** Function:	CStringP file_name_is_absolute(CStringP path)
77 
 *			PROTO_S ((CStringP path))
 - 
 
78 
 ** Exceptions:
 103 
 ** Exceptions:
79 
 *
 104 
 *
80 
 * This function returns true if the specified path is an absolute path name.
 105 
 * This function returns true if the specified path is an absolute path name.
81 
 *
 106 
 *
82 
 ** Function:	void			file_name_populate
 107 
 ** Function:	void file_name_populate(CStringP path)
83 
 *			PROTO_S ((CStringP path))
 - 
 
84 
 ** Exceptions:
 108 
 ** Exceptions:
85 
 *
 109 
 *
86 
 * This function tries to create all of the directories on the specified path.
 110 
 * This function tries to create all of the directories on the specified path.
87 
 * The final component of the path is considered to be a file, and is not
 111 
 * The final component of the path is considered to be a file, and is not
88 
 * created as a directory.  There is no confirmation of whether the function
 112 
 * created as a directory.  There is no confirmation of whether the function
Line 111... Line 135...
111 
#include "dalloc.h"
 135 
#include "dalloc.h"
112 
 
 136 
 
113 
/*--------------------------------------------------------------------------*/
 137 
/*--------------------------------------------------------------------------*/
114 
 
 138 
 
115 
extern CStringP			file_name_basename
 139 
extern CStringP			file_name_basename
116 
	PROTO_S ((CStringP));
 140 
(CStringP);
117 
extern CStringP			file_name_dirname
 141 
extern CStringP			file_name_dirname
118 
	PROTO_S ((CStringP));
 142 
(CStringP);
119 
extern CStringP			file_name_expand
 143 
extern CStringP			file_name_expand
120 
	PROTO_S ((CStringP, CStringP, CStringP));
 144 
(CStringP, CStringP, CStringP);
121 
extern BoolT			file_name_is_basename
 145 
extern BoolT			file_name_is_basename
122 
	PROTO_S ((CStringP));
 146 
(CStringP);
123 
extern BoolT			file_name_is_absolute
 147 
extern BoolT			file_name_is_absolute
124 
	PROTO_S ((CStringP));
 148 
(CStringP);
125 
extern void			file_name_populate
 149 
extern void			file_name_populate
126 
	PROTO_S ((CStringP));
 150 
(CStringP);
127 
 
 151 
 
128 
#endif /* !defined (H_FILE_NAME) */
 152 
#endif /* !defined (H_FILE_NAME) */