C++ Client API Reference for Oracle Coherence: coherence/lang/SubscriptHolder.hpp Source File

00001 /*
00002  * Copyright (c) 2000, 2020, Oracle and/or its affiliates.
00003  *
00004  * Licensed under the Universal Permissive License v 1.0 as shown at
00005  * http://oss.oracle.com/licenses/upl.
00006  */
00007 #ifndef COH_SUBSCRIPT_HOLDER_HPP
00008 #define COH_SUBSCRIPT_HOLDER_HPP
00009 
00010 #include "coherence/lang/compatibility.hpp"
00011 
00012 #include "coherence/lang/TypedHandle.hpp"
00013 #include "coherence/lang/TypedHolder.hpp"
00014 
00015 COH_OPEN_NAMESPACE2(coherence,lang)
00016 
00017 
00018 /**
00019 * A TypedHolder implementation which supports automatic delegation of the
00020 * subscript operator.
00021 *
00022 * @author mf  2009.03.10
00023 */
00024 template<class T, class ET, class IT = size32_t>
00025 class SubscriptHolder
00026     : public TypedHolder<T>
00027     {
00028     // ----- typedefs -------------------------------------------------------
00029 
00030     typedef ET ElementType;
00031 
00032 
00033     // ----- constructors ---------------------------------------------------
00034 
00035     public:
00036         /**
00037         * Create an empty SubscriptHolder.
00038         */
00039         SubscriptHolder()
00040             : TypedHolder<T>()
00041             {
00042             }
00043 
00044         /**
00045         * Create a new SubscriptHolder from the TypedHandle with a type
00046         * conversion.
00047         */
00048         template<class DT> SubscriptHolder<T, ET, IT>(const TypedHandle<DT>& that)
00049             : TypedHolder<T>(that)
00050             {
00051             }
00052 
00053         /**
00054         * Create a new SubscriptHolder from the TypedHolder with a type
00055         * conversion.
00056         */
00057         template<class DT> SubscriptHolder<T, ET, IT>(const TypedHolder<DT>& that)
00058             : TypedHolder<T>(that)
00059             {
00060             }
00061 
00062         /**
00063         * Create a new SubscriptHolder from the raw pointer.
00064         */
00065         SubscriptHolder(T* o)
00066             : TypedHolder<T>(o)
00067             {
00068             }
00069 
00070         /**
00071         * The copy constructor.
00072         */
00073         SubscriptHolder<T, ET, IT>(const SubscriptHolder<T, ET, IT>& that)
00074             : TypedHolder<T>(that)
00075             {
00076             }
00077 
00078         /**
00079         * The subscript operator.
00080         */
00081         ElementType& operator[](IT i) const
00082             {
00083             const T* cpo = TypedHolder<T>::m_cpo;
00084             if (NULL == cpo)
00085                 {
00086                 coh_throw_npe(typeid(T));
00087                 }
00088             return (*cpo)[i];
00089             }
00090     };
00091 
00092 COH_CLOSE_NAMESPACE2
00093 
00094 #endif // COH_SUBSCRIPT_HOLDER_HPP