1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
|
/*************************************************************************
*
* $RCSfile: configpathes.hxx,v $
*
* $Revision: 1.1 $
*
* last change: $Author: jb $ $Date: 2001-07-10 11:12:16 $
*
* The Contents of this file are made available subject to the terms of
* either of the following licenses
*
* - GNU Lesser General Public License Version 2.1
* - Sun Industry Standards Source License Version 1.1
*
* Sun Microsystems Inc., October, 2000
*
* GNU Lesser General Public License Version 2.1
* =============================================
* Copyright 2000 by Sun Microsystems, Inc.
* 901 San Antonio Road, Palo Alto, CA 94303, USA
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License version 2.1, as published by the Free Software Foundation.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
* MA 02111-1307 USA
*
*
* Sun Industry Standards Source License Version 1.1
* =================================================
* The contents of this file are subject to the Sun Industry Standards
* Source License Version 1.1 (the "License"); You may not use this file
* except in compliance with the License. You may obtain a copy of the
* License at http://www.openoffice.org/license.html.
*
* Software provided under this License is provided on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING,
* WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
* MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
* See the License for the specific provisions governing your rights and
* obligations concerning the Software.
*
* The Initial Developer of the Original Code is: Sun Microsystems, Inc..
*
* Copyright: 2000 by Sun Microsystems, Inc.
*
* All Rights Reserved.
*
* Contributor(s): _______________________________________
*
*
************************************************************************/
#ifndef UNOTOOLS_CONFIGPATHES_HXX_INCLUDED
#define UNOTOOLS_CONFIGPATHES_HXX_INCLUDED
#ifndef _SAL_TYPES_H_
#include <sal/types.h>
#endif
namespace rtl
{
class OUString;
}
//----------------------------------------------------------------------------
namespace utl
{
//----------------------------------------------------------------------------
/** extract the local nodename and the parent nodepath
from a configuration path.
@param _sInPath
A configuration path that is not an empty or root path.<BR/>
If this is not a valid configuration path, it is interpreted as
local name of a node.
@param _rsOutPath
On exit: The configuration path obtained by dropping
the last level off <var>_sInPath</var>.<BR/>
If <var>_sInPath</var> could not be parsed as a valid
configuration path, this is set to an empty string.
@param _rsLocalName
On exit: The plain (non-escaped) name of the node identified by
<var>_sInPath</var>. <BR/>
If <var>_sInPath</var> could not be parsed as a valid
configuration path, this is set to <var>_sInPath</var>.
@returns
<TRUE/>, if a parent path could be set
<FALSE/>, if the path was a one-level path or an invalid path
*/
sal_Bool splitLastFromConfigurationPath(::rtl::OUString const& _sInPath,
::rtl::OUString& _rsOutPath,
::rtl::OUString& _rsLocalName);
//----------------------------------------------------------------------------
/** extract the first nodename from a configuration path.
@param _sInPath
A relative configuration path that is not empty.<BR/>
If this is not a valid configuration path, it is interpreted as
a single name of a node.
@returns
The plain (non-escaped) name of the node that is the first step
when traversing <var>_sInPath</var>.<BR/>
If <var>_sInPath</var> could not be parsed as a valid
configuration path, it is returned unaltered.
*/
::rtl::OUString extractFirstFromConfigurationPath(::rtl::OUString const& _sInPath);
//----------------------------------------------------------------------------
/** check whether a path is to a nested node with respect to a parent path.
@param _sNestedPath
A configuration path that maybe points to a descendant of the node
identified by <var>_sPrefixPath</var>, with both pathes starting
from the same node (or both being absolute).
@param _sPrefixPath
A configuration path.<BR/>
If this path is absolute, <var>_sNestedPath</var> should be absolute;
If this path is relative, <var>_sNestedPath</var> should be relative;
If this path is empty, <var>_sNestedPath</var> may start with a '/',
which is disregarded.
@returns
<TRUE/>, if <var>_sPrefixPath</var> is a prefix of <var>_sNestedPath</var>;
<FALSE/> otherwise.<BR/>
If both pathes are equal <TRUE/> is returned.
*/
sal_Bool isPrefixOfConfigurationPath(::rtl::OUString const& _sNestedPath,
::rtl::OUString const& _sPrefixPath);
//----------------------------------------------------------------------------
/** get the relative path to a nested node with respect to a parent path.
@param _sNestedPath
A configuration path that points to a descendant of the node
identified by <var>_sPrefixPath</var>, with both pathes starting
from the same node (or both being absolute).
@param _sPrefixPath
A configuration path.<BR/>
If this path is absolute, <var>_sNestedPath</var> must be absolute;
If this path is relative, <var>_sNestedPath</var> must be relative;
If this path is empty, <var>_sNestedPath</var> may start with a '/',
which is stripped.
@returns
The remaining relative path from the target of <var>_sPrefixPath</var>
to the target of <var>_sNestedPath</var>.<BR/>
If <var>_sPrefixPath</var> is not a prefix of <var>_sNestedPath</var>,
<var>_sNestedPath</var> is returned unaltered.
*/
::rtl::OUString dropPrefixFromConfigurationPath(::rtl::OUString const& _sNestedPath,
::rtl::OUString const& _sPrefixPath);
//----------------------------------------------------------------------------
/** Create a one-level relative configuration path from a set element name
without a known set element type.
@param _sElementName
An arbitrary string that is to be interpreted as
name of a configuration set element.
@returns
A one-level relative path to the element, of the form
"*['<Name>']", where <Name> is properly escaped.
*/
::rtl::OUString wrapConfigurationElementName(::rtl::OUString const& _sElementName);
//----------------------------------------------------------------------------
/** Create a one-level relative configuration path from a set element name
and a known set element type.
@param _sElementName
An arbitrary string that is to be interpreted as
name of a configuration set element.
@param _sTypeName
An string identifying the type of the element. Usually this is be
the name of the element-template of the set.<BR/>
@returns
A one-level relative path to the element, of the form
"<Type>['<Name>']", where <Name> is properly escaped.
*/
::rtl::OUString wrapConfigurationElementName(::rtl::OUString const& _sElementName,
::rtl::OUString const& _sTypeName);
//----------------------------------------------------------------------------
} // namespace utl
//----------------------------------------------------------------------------
#endif // UNOTOOLS_CONFIGPATHES_HXX_INCLUDED
/*************************************************************************
* history:
* $Log: not supported by cvs2svn $
*
************************************************************************/
|
