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
|
#ifndef __IPathSegment_I_h__
#define __IPathSegment_I_h__ 1
// =================================================================================================
// Copyright 2014 Adobe
// All Rights Reserved.
//
// NOTICE: Adobe permits you to use, modify, and distribute this file in accordance with the terms
// of the Adobe license agreement accompanying it.
// =================================================================================================
#include "XMPCore/XMPCoreFwdDeclarations_I.h"
#include "XMPCore/Interfaces/IPathSegment.h"
#include "XMPCommon/Interfaces/BaseInterfaces/ISharedObject_I.h"
namespace AdobeXMPCore_Int {
#if XMP_WinBuild
#pragma warning( push )
#pragma warning( disable : 4250 )
#endif
//!
//! \brief Internal interface that represents an PathSegment.
//! \details Provides all the functions to access
//!
class IPathSegment_I
: public virtual IPathSegment
, public virtual ISharedObject_I
{
public:
//!
//! return the version of the interface.
//! \return 32 bit unsigned integer representing the version of the interface.
//!
static uint32 GetInterfaceVersion() { return kInternalInterfaceVersionNumber; }
using IPathSegment_v1::GetNameSpace;
using IPathSegment_v1::GetName;
using IPathSegment_v1::GetType;
using IPathSegment_v1::GetValue;
virtual spcIPathSegment APICALL Clone() const = 0;
virtual pIPathSegment APICALL GetActualIPathSegment() __NOTHROW__ { return this; }
virtual pIPathSegment_I APICALL GetIPathSegment_I() __NOTHROW__ { return this; }
virtual pvoid APICALL GetInterfacePointer( uint64 interfaceID, uint32 interfaceVersion );
// static factory functions
// Factories to create the specific segments
//!
//! Creates a normal property path segment.These are essentially all properties (simple, struct and arrays).
//! \param[in] nameSpace shared pointer to a const IUTF8String object containing name space URI of the property.
//! \param[in] name shared pointer to a const IUTF8String object containing local name of the property.
//! \return a shared pointer to const #IPathSegment.
//! \attention throws #AdobeXMPCommon::pcIError in case
//! - shared pointers are invalid,
//! - their content is empty.
//!
XMP_PRIVATE static spcIPathSegment CreatePropertyPathSegment( const spcIUTF8String & nameSpace, const spcIUTF8String & name );
//!
//! Creates an array index path segment that denotes a specific element of an array.
//! Such segments do not have an own name and inherits the namespace from the Array property itself.
//! \param[in] nameSpace shared pointer to a const IUTF8String object containing name space URI of the property.
//! \param[in] index an object of type #AdobeXMP::sizet containting the index of the array element.
//! \return a shared pointer to const #IPathSegment.
//! \attention throws #AdobeXMP::pcIError in case
//! - pointers to const char buffers are NULL,
//! - their content is empty.
//!
//!
XMP_PRIVATE static spcIPathSegment CreateArrayIndexPathSegment( const spcIUTF8String & nameSpace, sizet index );
//!
//! Creates a Qualifier path segment, which behaves like a normal property
//! \param[in] nameSpace shared pointer to a const IUTF8String object containing name space URI of the property.
//! \param[in] name shared pointer to a const IUTF8String object containing local name of the property.
//! \return a shared pointer to const #IPathSegment.
//! \attention throws #AdobeXMPCommon::pcIError in case
//! - shared pointers are invalid,
//! - their content is empty.
//!
XMP_PRIVATE static spcIPathSegment CreateQualifierPathSegment( const spcIUTF8String & nameSpace, const spcIUTF8String & name );
//!
//! Creates a path segment that selects a specific qualifier by its value.
//! For example a specific language in a alternative array of languages.
//! \param[in] nameSpace shared pointer to a const IUTF8String object containing name space URI of the property.
//! \param[in] name shared pointer to a const IUTF8String object containing local name of the property.
//! \param[in] value shared pointer to a const IUTF8String object containing value of the language (xml:lang)
//! \return a shared pointer to const #IPathSegment.
//! \attention throws #AdobeXMPCommon::pcIError in case
//! - shared pointers are invalid,
//! - their content is empty.
//!
XMP_PRIVATE static spcIPathSegment CreateQualifierSelectorPathSegment( const spcIUTF8String & nameSpace, const spcIUTF8String & name, const spcIUTF8String & value );
protected:
virtual ~IPathSegment_I() __NOTHROW__ {}
pvoid APICALL GetInterfacePointerInternal( uint64 interfaceID, uint32 interfaceVersion, bool isTopLevel );
virtual pcIUTF8String_base APICALL getNameSpace( pcIError_base & error ) const __NOTHROW__;
virtual pcIUTF8String_base APICALL getName( pcIError_base & error ) const __NOTHROW__;
virtual uint32 APICALL getType( pcIError_base & error ) const __NOTHROW__;
virtual pcIUTF8String_base APICALL getValue( pcIError_base & error ) const __NOTHROW__;
virtual pvoid APICALL getInterfacePointer( uint64 interfaceID, uint32 interfaceVersion, pcIError_base & error ) __NOTHROW__;
#ifdef FRIEND_CLASS_DECLARATION
FRIEND_CLASS_DECLARATION();
#endif
REQ_FRIEND_CLASS_DECLARATION();
};
#if XMP_WinBuild
#pragma warning( pop )
#endif
}
#endif // __IPathSegment_I_h__
|
