xmp_toolkit_ruby 0.0.2

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMPCommon/source/IUTF8String.cpp

@@ -0,0 +1,299 @@
+// =================================================================================================
+// Copyright Adobe
+// Copyright 2015 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. 
+// =================================================================================================
+
+#define FRIEND_CLASS_DECLARATION() friend class IUTF8StringProxy;
+
+#include "XMPCommon/Interfaces/IUTF8String.h"
+
+#if !BUILDING_XMPCOMMON_LIB && !SOURCE_COMPILING_XMP_ALL
+
+#include "XMPCommon/Utilities/TWrapperFunctions.h"
+#include "XMPCommon/Interfaces/IObjectFactory.h"
+
+#include <assert.h>
+
+namespace AdobeXMPCommon {
+
+	class IUTF8StringProxy
+		: public virtual IUTF8String
+		, public enable_shared_from_this< IUTF8StringProxy >
+	{
+	private:
+		pIUTF8String mRawPtr;
+
+	public:
+		IUTF8StringProxy( pIUTF8String ptr )
+			: mRawPtr( ptr )
+		{
+			mRawPtr->Acquire();
+		}
+
+		~IUTF8StringProxy() __NOTHROW__ { mRawPtr->Release(); }
+
+		pIUTF8String APICALL GetActualIUTF8String() __NOTHROW__ { return mRawPtr; }
+
+		void APICALL Acquire() const __NOTHROW__ { assert( false ); }
+
+		void APICALL Release() const __NOTHROW__ { assert( false ); }
+
+		spIUTF8String APICALL append( const char * buf, sizet count ) {
+			CallSafeFunction< IUTF8String, pIUTF8String_base, pIUTF8String_base, const char *, sizet >(
+				mRawPtr, &IUTF8String::append, buf, count )->Release();
+			return shared_from_this();
+		}
+
+		spIUTF8String APICALL append( const spcIUTF8String & src, sizet srcPos, sizet count ) {
+			CallSafeFunction< IUTF8String, pIUTF8String_base, pIUTF8String_base, pcIUTF8String_base, sizet, sizet >(
+				mRawPtr, &IUTF8String::append, src ? src->GetActualIUTF8String() : NULL, srcPos, count )->Release();
+			return shared_from_this();
+		}
+
+		pIUTF8String_base APICALL append( const char * buffer, sizet count, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			mRawPtr->append( buffer, count, error );
+			return this;
+		}
+
+		pIUTF8String_base APICALL append( pcIUTF8String_base str, sizet srcPos, sizet count, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			mRawPtr->append( str, srcPos, count, error );
+			return this;
+		}
+
+		spIUTF8String APICALL assign( const char * buf, sizet count ) {
+			CallSafeFunction< IUTF8String, pIUTF8String_base, pIUTF8String_base, const char *, sizet >(
+				mRawPtr, &IUTF8String::assign, buf, count )->Release();
+			return shared_from_this();
+		}
+
+		spIUTF8String APICALL assign( const spcIUTF8String & src, sizet srcPos, sizet count ) {
+			CallSafeFunction< IUTF8String, pIUTF8String_base, pIUTF8String_base, pcIUTF8String_base, sizet, sizet >(
+				mRawPtr, &IUTF8String::assign, src ? src->GetActualIUTF8String() : NULL, srcPos, count )->Release();
+			return shared_from_this();
+		}
+
+		pIUTF8String_base APICALL assign( const char * buffer, sizet count, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			mRawPtr->assign( buffer, count, error );
+			return this;
+		}
+
+		pIUTF8String_base APICALL assign( pcIUTF8String_base str, sizet srcPos, sizet count, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			mRawPtr->assign( str, srcPos, count, error );
+			return this;
+		}
+
+		spIUTF8String APICALL insert( sizet pos, const char * buf, sizet count ) {
+			CallSafeFunction< IUTF8String, pIUTF8String_base, pIUTF8String_base, sizet, const char *, sizet >(
+				mRawPtr, &IUTF8String::insert, pos, buf, count )->Release();
+			return shared_from_this();
+		}
+
+		spIUTF8String APICALL insert( sizet pos, const spcIUTF8String & src, sizet srcPos, sizet count ) {
+			CallSafeFunction< IUTF8String, pIUTF8String_base, pIUTF8String_base, sizet, pcIUTF8String_base, sizet, sizet >(
+				mRawPtr, &IUTF8String::insert, pos, src ? src->GetActualIUTF8String() : NULL, srcPos, count )->Release();
+			return shared_from_this();
+		}
+
+		pIUTF8String_base APICALL insert( sizet pos, const char * buf, sizet count, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			mRawPtr->insert( pos, buf, count, error );
+			return this;
+		}
+
+		pIUTF8String_base APICALL insert( sizet pos, pcIUTF8String_base src, sizet srcPos, sizet count, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			mRawPtr->insert( pos, src, srcPos, count, error );
+			return this;
+		}
+
+		spIUTF8String APICALL erase( sizet pos, sizet count ) {
+			CallSafeFunction< IUTF8String, pIUTF8String_base, pIUTF8String_base, sizet, sizet >(
+				mRawPtr, &IUTF8String::erase, pos, count )->Release();
+			return shared_from_this();
+		}
+
+		pIUTF8String_base APICALL erase( sizet pos, sizet count, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			mRawPtr->erase( pos, count, error );
+			return this;
+		}
+
+		void APICALL resize( sizet n ) {
+			CallSafeFunctionReturningVoid< IUTF8String, sizet >(
+				mRawPtr, &IUTF8String::resize, n );
+		}
+
+		virtual void APICALL resize( sizet n, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			mRawPtr->resize( n, error );
+		}
+
+		spIUTF8String APICALL replace( sizet pos, sizet count, const char * buf, sizet srcCount ) {
+			CallSafeFunction< IUTF8String, pIUTF8String_base, pIUTF8String_base, sizet, sizet, const char *, sizet >(
+				mRawPtr, &IUTF8String::replace, pos, count, buf, srcCount )->Release();
+			return shared_from_this();
+		}
+
+		spIUTF8String APICALL replace( sizet pos, sizet count, const spcIUTF8String & src, sizet srcPos, sizet srcCount ) {
+			CallSafeFunction< IUTF8String, pIUTF8String_base, pIUTF8String_base, sizet, sizet, pcIUTF8String_base, sizet, sizet >(
+				mRawPtr, &IUTF8String::replace, pos, count, src ? src->GetActualIUTF8String() : NULL, srcPos, srcCount )->Release();
+			return shared_from_this();
+		}
+
+		pIUTF8String_base APICALL replace( sizet pos, sizet count, const char * buf, sizet srcCount, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			mRawPtr->replace( pos, count, buf, srcCount, error );
+			return this;
+		}
+
+		pIUTF8String_base APICALL replace( sizet pos, sizet count, pcIUTF8String_base src, sizet srcPos, sizet srcCount, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			mRawPtr->replace( pos, count, src, srcPos, srcCount, error );
+			return this;
+		}
+
+		sizet APICALL copy( char * buf, sizet len, sizet pos ) const {
+			return CallConstSafeFunction< IUTF8String, sizet, sizet, char *, sizet, sizet >(
+				mRawPtr, &IUTF8String::copy, buf, len, pos );
+		}
+
+		sizet APICALL copy( char * buf, sizet len, sizet pos, pcIError_base & error ) const __NOTHROW__ {
+			assert( false );
+			return mRawPtr->copy( buf, len, pos, error );
+		}
+
+		sizet APICALL find( const char * buf, sizet pos, sizet count ) const {
+			return CallConstSafeFunction< IUTF8String, sizet, sizet, const char *, sizet, sizet >(
+				mRawPtr, &IUTF8String::find, buf, pos, count );
+		}
+
+		sizet APICALL find( const spcIUTF8String & src, sizet pos, sizet count ) const {
+			return CallConstSafeFunction< IUTF8String, sizet, sizet, pcIUTF8String_base, sizet, sizet >(
+				mRawPtr, &IUTF8String::find, src ? src->GetActualIUTF8String() : NULL, pos, count );
+		}
+
+		sizet APICALL find( const char * buf, sizet pos, sizet count, pcIError_base & error ) const __NOTHROW__ {
+			assert( false );
+			return mRawPtr->find( buf, pos, count, error );
+		}
+
+		sizet APICALL find( pcIUTF8String_base src, sizet pos, sizet count, pcIError_base & error ) const __NOTHROW__ {
+			assert( false );
+			return mRawPtr->find( src, pos, count, error );
+		}
+
+		sizet APICALL rfind( const char * buf, sizet pos, sizet count ) const {
+			return CallConstSafeFunction< IUTF8String, sizet, sizet, const char *, sizet, sizet >(
+				mRawPtr, &IUTF8String::rfind, buf, pos, count );
+		}
+
+		sizet APICALL rfind( const spcIUTF8String & src, sizet pos, sizet count ) const {
+			return CallConstSafeFunction< IUTF8String, sizet, sizet, pcIUTF8String_base, sizet, sizet >(
+				mRawPtr, &IUTF8String::rfind, src ? src->GetActualIUTF8String() : NULL, pos, count );
+		}
+
+		sizet APICALL rfind( const char * buf, sizet pos, sizet count, pcIError_base & error ) const __NOTHROW__ {
+			assert( false );
+			return mRawPtr->rfind( buf, pos, count, error );
+		}
+
+		sizet APICALL rfind( pcIUTF8String_base src, sizet pos, sizet count, pcIError_base & error ) const __NOTHROW__ {
+			assert( false );
+			return mRawPtr->rfind( src, pos, count, error );
+		}
+
+		int32 APICALL compare( sizet pos, sizet len, const char * buf, sizet count ) const {
+			return CallConstSafeFunction< IUTF8String, int32, int32, sizet, sizet, const char *, sizet >(
+				mRawPtr, &IUTF8String::compare, pos, len, buf, count );
+		}
+
+		int32 APICALL compare( sizet pos, sizet len, const spcIUTF8String & str, sizet strPos, sizet strLen ) const {
+			return CallConstSafeFunction< IUTF8String, int32, int32, sizet, sizet, pcIUTF8String_base, sizet, sizet >(
+				mRawPtr, &IUTF8String::compare, pos, len, str ? str->GetActualIUTF8String() : NULL, strPos, strLen );
+		}
+
+		int32 APICALL compare( sizet pos, sizet len, const char * buf, sizet count, pcIError_base & error ) const __NOTHROW__ {
+			assert( false );
+			return mRawPtr->compare( pos, len, buf, count, error );
+		}
+
+		int32 APICALL compare( sizet pos, sizet len, pcIUTF8String_base str, sizet strPos, sizet strLen, pcIError_base & error ) const __NOTHROW__ {
+			assert( false );
+			return mRawPtr->compare( pos, len, str, strPos, strLen, error );
+		}
+
+		spIUTF8String APICALL substr( sizet pos, sizet count ) const {
+			return CallConstSafeFunctionReturningPointer< IUTF8String, pIUTF8String_base, IUTF8String, sizet, sizet >(
+				mRawPtr, &IUTF8String::substr, pos, count );
+		}
+
+		pIUTF8String_base APICALL substr( sizet pos, sizet count, pcIError_base & error ) const __NOTHROW__ {
+			assert( false );
+			return mRawPtr->substr( pos, count, error );
+		}
+
+		bool APICALL empty() const {
+			return CallConstSafeFunction< IUTF8String, bool, uint32 >(
+				mRawPtr, &IUTF8String::empty );
+		}
+
+		uint32 APICALL empty( pcIError_base & error ) const __NOTHROW__ {
+			assert( false );
+			return mRawPtr->empty();
+		}
+
+		const char * APICALL c_str() const __NOTHROW__ {
+			return mRawPtr->c_str();
+		}
+
+		void APICALL clear() __NOTHROW__ {
+			mRawPtr->clear();
+		}
+
+		sizet APICALL size() const __NOTHROW__ {
+			return mRawPtr->size();
+		}
+
+		AdobeXMPCommon_Int::pISharedObject_I APICALL GetISharedObject_I() __NOTHROW__ {
+			return mRawPtr->GetISharedObject_I();
+		}
+
+		pvoid APICALL GetInterfacePointer( uint64 interfaceID, uint32 interfaceVersion ) {
+			return CallSafeFunction< IVersionable, pvoid, pvoid, uint64, uint32 >(
+				mRawPtr, &IVersionable::getInterfacePointer, interfaceID, interfaceVersion );
+		}
+
+		pvoid APICALL getInterfacePointer( uint64 interfaceID, uint32 interfaceVersion, pcIError_base & error ) __NOTHROW__ {
+			assert( false );
+			return mRawPtr->getInterfacePointer( interfaceID, interfaceVersion, error );
+		}
+
+	};
+
+	spIUTF8String IUTF8String_v1::MakeShared( pIUTF8String_base ptr ) {
+		if ( !ptr ) return spIUTF8String();
+		pIUTF8String p = IUTF8String::GetInterfaceVersion() > 1 ? ptr->GetInterfacePointer< IUTF8String >() : ptr;
+		return shared_ptr< IUTF8StringProxy >( new IUTF8StringProxy( p ) );
+	}
+
+	spIUTF8String IUTF8String_v1::CreateUTF8String( pIObjectFactory objFactory ) {
+		return CallSafeFunctionReturningPointer< IObjectFactory, pIUTF8String_base, IUTF8String, const char *, sizet >(
+			objFactory, &IObjectFactory::CreateUTF8String, NULL, ( sizet ) 0 );
+	}
+
+	spIUTF8String IUTF8String_v1::CreateUTF8String( pIObjectFactory objFactory, const char * buf, sizet count ) {
+		return CallSafeFunctionReturningPointer< IObjectFactory, pIUTF8String_base, IUTF8String, const char *, sizet >(
+			objFactory, &IObjectFactory::CreateUTF8String, buf, count );
+	}
+
+}
+
+#endif  // BUILDING_XMPCOMMON_LIB  && !SOURCE_COMPILING_XMP_ALL

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMPCore/Interfaces/IArrayNode.h

@@ -0,0 +1,303 @@
+#ifndef __IArrayNode_h__
+#define __IArrayNode_h__ 1
+
+// =================================================================================================
+// Copyright Adobe
+// 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/Interfaces/ICompositeNode.h"
+
+namespace AdobeXMPCore {
+
+	//!
+	//! \brief Version1 of the interface that represents an Array Node of XMP DOM.
+	//! \details Provides all the functions to get and set various properties of the array node.
+	//! \attention Support multi threading through locks but can be enabled/disabled by the client. By default
+	//!  every object created does not support multi-threading.
+	//! \note The index of the array is 1-based.
+	//!
+	class XMP_PUBLIC IArrayNode_v1
+		: public virtual ICompositeNode_v1
+	{
+	public:
+
+		//!
+		//! @brief Indicates different kinds of array forms possible in XMP i.e, unordered, ordered and alternative.
+		//!
+		typedef enum {
+			//! unknown array form, should be used as invalid value.
+			kAFNone									= 0,
+
+			//! Array contains entries which are unordered.
+			kAFUnordered							= 1 << 0,
+
+			//! Array contains entries which are ordered.
+			kAFOrdered								= 1 << 1,
+
+			//! Array contains entries which are ordered plus default value should be the top one.
+			kAFAlternative							= 1 << 2,
+
+			//! Maximum value this enum can hold, should be treated as invalid value
+			kAFAll									= kAllBits
+		} eArrayForm;
+
+		//!
+		//! @brief Get the type of array.
+		//! \return a value of type #eArrayForm indicating the type of array.
+		//!
+		virtual eArrayForm APICALL GetArrayForm() const  = 0;
+
+		//!
+		//! @brief Get the type of child nodes.
+		//! \return a value of type #eNodeType indicating the type of child nodes array can hold.
+		//! \note An empty array will return \#INode_v1::kNTAll indicating that right now it can hold any type of node.
+		//!
+		virtual eNodeType APICALL GetChildNodeType() const = 0;
+
+		//!
+		//! @{
+		//! @brief Get the node at the specified index.
+		//! \param[in] index an object of type \#sizet indicating the index of the node client who is interested in.
+		//! \return A shared pointer to const or non const \#INode object containing node.
+		//! \note In case no node exists at the given index an invalid shared pointer is returned.
+		//! \note The index of an array is 1-based.
+		//!
+		virtual spINode APICALL GetNodeAtIndex( sizet index ) = 0;
+		XMP_PRIVATE spcINode GetNodeAtIndex( sizet index ) const {
+			return const_cast< IArrayNode_v1 * >( this )->GetNodeAtIndex( index );
+		}
+		//! @}
+
+		//!
+		//! @{
+		//! @brief Get the node at the specified index as simple node, if possible.
+		//! \param[in] index An object of type \#sizet indicating the index of the node client is interested in.
+		//! \return A shared pointer to const or non const \#ISimpleNode object containing node.
+		//! \note In case no node exists at the given index an invalid shared pointer is returned.
+		//! \note The index of an array is 1-based.
+		//! \attention Error is thrown in case 
+		//!		- a child exists at the given index but is not a simple node.
+		//!
+		XMP_PRIVATE spcISimpleNode GetSimpleNodeAtIndex( sizet index ) const {
+			auto node = GetNodeAtIndex( index );
+			if ( node ) return node->ConvertToSimpleNode();
+			return spcISimpleNode();
+		}
+
+		XMP_PRIVATE spISimpleNode GetSimpleNodeAtIndex( sizet index ) {
+			auto node = GetNodeAtIndex( index );
+			if ( node ) return node->ConvertToSimpleNode();
+			return spISimpleNode();
+		}
+		//! @}
+
+		//!
+		//! @{
+		//! @brief Get the node at the specified index as structure node, if possible.
+		//! \param[in] index An object of type \#sizet indicating the index of the node client is interested in.
+		//! \return A shared pointer to const or non const \#IStructureNode object containing node.
+		//! \note In case no node exists at the given index an invalid shared pointer is returned.
+		//! \note The index of an array is 1-based.
+		//! \attention Error is thrown in case 
+		//!		- a child exists at the given index but is not a structure node.
+		//!
+		XMP_PRIVATE spcIStructureNode GetStructureNodeAtIndex( sizet index ) const {
+			auto node = GetNodeAtIndex( index );
+			if ( node ) return node->ConvertToStructureNode();
+			return spcIStructureNode();
+		}
+
+		XMP_PRIVATE spIStructureNode GetStructureNodeAtIndex( sizet index ) {
+			auto node = GetNodeAtIndex( index );
+			if ( node ) return node->ConvertToStructureNode();
+			return spIStructureNode();
+		}
+		//! @}
+
+		//!
+		//! @{
+		//! @brief Get the node at the specified index as an array node, if possible.
+		//! \param[in] index an object of type \#sizet indicating the index of the node client is interested in.
+		//! \return a shared pointer to const or non const \#IArrayNode object containing node.
+		//! \note In case no node exists at the given index an invalid shared pointer is returned.
+		//! \note The index of an array is 1-based.
+		//! \attention Error is thrown in case 
+		//!		- a child exists at the given index but is not an array node.
+		//!
+		XMP_PRIVATE spcIArrayNode GetArrayNodeAtIndex( sizet index ) const {
+			auto node = GetNodeAtIndex( index );
+			if ( node ) return node->ConvertToArrayNode();
+			return spcIArrayNode();
+		}
+
+		XMP_PRIVATE spIArrayNode GetArrayNodeAtIndex( sizet index ) {
+			auto node = GetNodeAtIndex( index );
+			if ( node ) return node->ConvertToArrayNode();
+			return spIArrayNode();
+		}
+		//! @}
+
+		//!
+		//! @brief Inserts a given node at the specified index.
+		//! \param[in] node Shared pointer to an object of \#INode containing the node to be inserted at the specified index.
+		//! \param[in] index An object of type sizet indicating the index where the node should
+		//!            be inserted.
+		//! \note The index of an array is 1-based.
+		//! \attention Error is thrown in following cases:
+		//!		-# given node is invalid.
+		//!		-# type of given node is not same as other child items of the array node.
+		//!		-# given node is already a child of some other node.
+		//!		-# given index is less than 1 or greater than current child count + 1.
+		//!
+		virtual void APICALL InsertNodeAtIndex( const spINode & node, sizet index ) = 0;
+
+		//!
+		//! @brief Replaces an existing node with the given node at the specified index.
+		//! \param[in] node Shared pointer to an object of \#INode containing the node to be inserted at the specified index.
+		//! \param[in] index An object of type \#sizet indicating the index from where the node should be replaced.
+		//! \return A shared pointer to the node replaced with the new node.
+		//! \note The index of an array is 1-based.
+		//! \attention Error is thrown in following cases:
+		//!		-# Given node is invalid.
+		//!		-# Type of given node is not same as other child items of the array node.
+		//!		-# Given node is already a child of some other node.
+		//!		-# Given index is less than 1 or greater than current child count.
+		//!		-# No node exists at the requested index.
+		//!
+		virtual spINode APICALL ReplaceNodeAtIndex( const spINode & node, sizet index ) = 0;
+
+		//!
+		//! @brief Remove the node at the specified index.
+		//! \param[in] index An object of type \#sizet indicating the index from where the node should be removed.
+		//! \note The index of an array is 1-based.
+		//! \return A shared pointer to \#INode object containing node which is removed from the tree.
+		//! \note In case no node exists at the given index an invalid shared pointer is returned.
+		//!
+		virtual spINode APICALL RemoveNodeAtIndex( sizet index ) = 0;
+		
+		//!
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		
+		//!
+		//! @{
+		//! @brief Returns the actual raw pointer from the shared pointer, which can be a shared pointer of a proxy class.
+		//! \return Either a const or non const pointer to IArrayNode interface.
+		//!
+		virtual pIArrayNode APICALL GetActualIArrayNode() __NOTHROW__ = 0;
+		XMP_PRIVATE pcIArrayNode GetActualIArrayNode() const __NOTHROW__ {
+			return const_cast< IArrayNode_v1 * >( this )->GetActualIArrayNode();
+		}
+		//!
+		//! @}
+
+		//!
+		//! @{
+		//! @brief Return the pointer to internal interfaces.
+		//! \return either a const or non const pointer to IArrayNode_I interface.
+		//!
+		virtual AdobeXMPCore_Int::pIArrayNode_I APICALL GetIArrayNode_I() __NOTHROW__ = 0;
+
+		XMP_PRIVATE AdobeXMPCore_Int::pcIArrayNode_I GetIArrayNode_I() const __NOTHROW__ {
+			return const_cast< IArrayNode_v1 * >( this )->GetIArrayNode_I();
+		}
+		//!
+		//! @}
+		
+		//!
+		//! @{
+		//! @brief Converts raw pointer to shared pointer. 
+		//! @details The raw pointer is of version 1 interface
+		//! where as the returned shared pointer depends on the version client is interested in.
+		//! \return  Shared pointer to const or non constant interface.
+		//!
+		XMP_PRIVATE static spIArrayNode MakeShared( pIArrayNode_base ptr );
+		XMP_PRIVATE static spcIArrayNode MakeShared( pcIArrayNode_base ptr ) {
+			return MakeShared( const_cast< pIArrayNode_base >( ptr ) );
+		}
+		//!
+		//! @}
+
+		//!
+		//! return The unique ID assigned to the interface.
+		//! \return 64 bit unsigned integer representing the unique ID assigned to the interface.
+		//!
+		XMP_PRIVATE static uint64 GetInterfaceID() { return kIArrayNodeID; }
+
+		//!
+		//! @brief Returns the version of the interface.
+		//! \return 32 bit unsigned integer representing the version of the interface.
+		//!
+		XMP_PRIVATE static uint32 GetInterfaceVersion() { return 1; }
+		//! \endcond
+
+		// Factories to create the array node
+
+		//!
+		//! @brief Creates an unordered array node which is not part of any metadata document.
+		//! \param[in] nameSpace Pointer to a constant char buffer containing name space URI of the array node.
+		//! \param[in] nameSpaceLength Number of characters in nameSpace. In case nameSpace is null terminated, set it to \#AdobeXMPCommon::npos.
+		//! \param[in] name Pointer to a constant char buffer containing local name of the array node.
+		//! \param[in] nameLength Number of characters in name. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \return A shared pointer to a \#IArrayNode object.
+		//! \attention Error is thrown in the following cases:
+		//!		-# nameSpace is NULL or its contents are empty.
+		//!		-# name is NULL or its contents are empty.
+		//!
+		XMP_PRIVATE static spIArrayNode CreateUnorderedArrayNode( const char * nameSpace, sizet nameSpaceLength, const char * name, sizet nameLength );
+
+		//!
+		//! @brief Creates an ordered array node which is not part of any metadata document.
+		//! \param[in] nameSpace Pointer to a constant char buffer containing name space URI of the array node.
+		//! \param[in] nameSpaceLength Number of characters in nameSpace. In case nameSpace is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] name Pointer to a constant char buffer containing local name of the array node.
+		//! \param[in] nameLength Number of characters in name. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \return A shared pointer to a \#IArrayNode object.
+		//! \attention Error is thrown in the following cases:
+		//!		-# nameSpace is NULL or its contents are empty.
+		//!		-# name is NULL or its contents are empty.
+		//!
+		XMP_PRIVATE static spIArrayNode CreateOrderedArrayNode( const char * nameSpace, sizet nameSpaceLength, const char * name, sizet nameLength );
+
+		//!
+		//! @brief Creates an alternative array node which is not part of any metadata document.
+		//! \param[in] nameSpace Pointer to a constant char buffer containing name space URI of the array node.
+		//! \param[in] nameSpaceLength Number of characters in nameSpace. In case nameSpace is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \param[in] name Pointer to a constant char buffer containing local name of the array node.
+		//! \param[in] nameLength Number of characters in name. In case name is null terminated set it to \#AdobeXMPCommon::npos.
+		//! \return A shared pointer to a \#IArrayNode object.
+		//! \attention Error is thrown in the following cases:
+		//!		-# nameSpace is NULL or its contents are empty.
+		//!		-# name is NULL or its contents are empty.
+		//!
+		XMP_PRIVATE static spIArrayNode CreateAlternativeArrayNode( const char * nameSpace, sizet nameSpaceLength, const char * name, sizet nameLength );
+
+	protected:
+		//!
+		//! Destructor
+		//! 
+		virtual ~IArrayNode_v1() __NOTHROW__ {}
+
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		virtual uint32 APICALL getArrayForm( pcIError_base & error ) const __NOTHROW__ = 0;
+		virtual uint32 APICALL getChildNodeType( pcIError_base & error ) const __NOTHROW__ = 0;
+		virtual pINode_base APICALL getNodeAtIndex( sizet index, pcIError_base & error ) __NOTHROW__ = 0;
+		virtual void APICALL insertNodeAtIndex( pINode_base node, sizet index, pcIError_base & error ) __NOTHROW__ = 0;
+		virtual pINode_base APICALL replaceNodeAtIndex( pINode_base node, sizet index, pcIError_base & error ) __NOTHROW__ = 0;
+		virtual pINode_base APICALL removeNodeAtIndex( sizet index, pcIError_base & error ) __NOTHROW__ = 0;
+
+		#ifdef FRIEND_CLASS_DECLARATION
+			FRIEND_CLASS_DECLARATION();
+		#endif
+		REQ_FRIEND_CLASS_DECLARATION();
+		//! \endcond
+
+	};
+}
+
+#endif  // __IArrayNode_h__