source: trunk/src/xmlpatterns/expr/qqnameconstructor_p.h@ 243

Last change on this file since 243 was 2, checked in by Dmitry A. Kuminov, 16 years ago

Initially imported qt-all-opensource-src-4.5.1 from Trolltech.

File size: 7.3 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4** Contact: Qt Software Information ([email protected])
5**
6** This file is part of the QtXmlPatterns module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial Usage
10** Licensees holding valid Qt Commercial licenses may use this file in
11** accordance with the Qt Commercial License Agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and Nokia.
14**
15** GNU Lesser General Public License Usage
16** Alternatively, this file may be used under the terms of the GNU Lesser
17** General Public License version 2.1 as published by the Free Software
18** Foundation and appearing in the file LICENSE.LGPL included in the
19** packaging of this file. Please review the following information to
20** ensure the GNU Lesser General Public License version 2.1 requirements
21** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
22**
23** In addition, as a special exception, Nokia gives you certain
24** additional rights. These rights are described in the Nokia Qt LGPL
25** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
26** package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you are unsure which license is appropriate for your use, please
37** contact the sales department at [email protected].
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42//
43// W A R N I N G
44// -------------
45//
46// This file is not part of the Qt API. It exists purely as an
47// implementation detail. This header file may change from version to
48// version without notice, or even be removed.
49//
50// We mean it.
51
52#ifndef Patternist_QNameConstructor_H
53#define Patternist_QNameConstructor_H
54
55#include "qsinglecontainer_p.h"
56#include "qbuiltintypes_p.h"
57#include "qpatternistlocale_p.h"
58#include "qxpathhelper_p.h"
59
60QT_BEGIN_HEADER
61
62QT_BEGIN_NAMESPACE
63
64namespace QPatternist
65{
66 /**
67 * @short Creates an @c xs:QName value from a lexical QName using
68 * statically known namespace bindings.
69 *
70 * @see QQNameValue
71 * @see QXmlUtils
72 * @author Frans Englich <[email protected]>
73 * @ingroup Patternist_expressions
74 */
75 class QNameConstructor : public SingleContainer
76 {
77 public:
78
79 QNameConstructor(const Expression::Ptr &source,
80 const NamespaceResolver::Ptr &nsResolver);
81
82 virtual Item evaluateSingleton(const DynamicContext::Ptr &) const;
83
84 virtual SequenceType::List expectedOperandTypes() const;
85
86 virtual SequenceType::Ptr staticType() const;
87
88 virtual ExpressionVisitorResult::Ptr accept(const ExpressionVisitor::Ptr &visitor) const;
89
90 /**
91 * Expands @p lexicalQName, which is a lexical representation of a QName such as "x:body", into
92 * a QName using @p nsResolver to supply the namespace bindings.
93 *
94 * If @p lexicalQName is lexically invalid @p InvalidQName is raised via @p context, or if
95 * no namespace binding does not exists for a prefix(if any) in @p lexicalQName, @p NoBinding
96 * is raised via @p context.
97 *
98 * If @p asForAttribute is @c true, the name is considered to be for an
99 * attribute in some way, and @p lexicalQName will not pick up the
100 * default namespace if it doesn't have a prefix.
101 *
102 * @p nsResolver is parameterized meaning the function can be instantiated with either
103 * DynamicContext or StaticContext.
104 *
105 * @see QQNameValue
106 * @see QXmlUtils
107 */
108 template<typename TReportContext,
109 const ReportContext::ErrorCode InvalidQName,
110 const ReportContext::ErrorCode NoBinding>
111 static
112 QXmlName expandQName(const QString &lexicalQName,
113 const TReportContext &context,
114 const NamespaceResolver::Ptr &nsResolver,
115 const SourceLocationReflection *const r,
116 const bool asForAttribute = false);
117
118 /**
119 * Resolves the namespace prefix @p prefix to its namespace if it exists, or
120 * raised ReportContext::XPST0081 otherwise.
121 *
122 * @returns the namespace URI corresponding to @p prefix
123 */
124 static QXmlName::NamespaceCode namespaceForPrefix(const QXmlName::PrefixCode prefix,
125 const StaticContext::Ptr &context,
126 const SourceLocationReflection *const r);
127
128 virtual const SourceLocationReflection *actualReflection() const;
129
130 private: