phonebookui/Phonebook/App/inc/TSingleDesCArray.h
changeset 0 e686773b3f54
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phonebookui/Phonebook/App/inc/TSingleDesCArray.h	Tue Feb 02 10:12:17 2010 +0200
@@ -0,0 +1,109 @@
+/*
+* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description: 
+*     A string array class holding only one string
+*
+*/
+
+
+#ifndef __TSingleDesCArray_H__
+#define __TSingleDesCArray_H__
+
+// INCLUDES
+#include <bamdesca.h>   // MDesCArray
+
+// CLASS DECLARATION
+
+/**
+ * A string array class holding only one string.
+ */ 
+class TSingleDesCArray : public MDesCArray
+    {
+    public:
+        /**
+         * Default constructor.
+         * @postcond MdcaCount()==0
+         */
+        inline TSingleDesCArray();
+
+        /**
+         * Constructor.
+         * @param aString reference to the one and only string this array 
+         *        contains
+         * @postcond MdcaCount()==1 && MdcaPoint(0)==aString
+         */
+        inline TSingleDesCArray(const TDesC& aString);
+
+        /**
+         * Sets the one and only string this array contains to aString.
+         * @postcond MdcaCount()==1 && MdcaPoint(0)==aString
+         */
+        inline void SetDesC(const TDesC& aString);
+
+        /**
+         * Makes this array empty.
+         * @postcond MdcaCount()==0
+         */
+        inline void Reset();
+
+    public:  // from MDesCArray
+        TInt MdcaCount() const;
+        TPtrC MdcaPoint(TInt aIndex) const;
+
+    private:  // Implementation
+        enum TPanicCode
+            {
+            EPanicPostCond_Constructor,
+            EPanicPostCond_Constructor_TDesC,
+            EPanicPostCond_SetDesC,
+            EPanicPostCond_Reset,
+            EPanicPreCond_MdcaPoint
+            };
+        static void Panic(TInt aReason);
+        
+    private:  // Data
+		/// Ref: the string which this array contains
+        const TDesC* iString;
+    };
+
+
+inline TSingleDesCArray::TSingleDesCArray()
+    : iString(NULL)
+    {
+    __ASSERT_DEBUG(MdcaCount()==0, Panic(EPanicPostCond_Constructor));
+    }
+
+inline TSingleDesCArray::TSingleDesCArray(const TDesC& aString)
+    : iString(&aString)
+    {
+    __ASSERT_DEBUG(MdcaCount()==1 && MdcaPoint(0)==aString, 
+        Panic(EPanicPostCond_Constructor_TDesC));
+    }
+
+inline void TSingleDesCArray::SetDesC(const TDesC& aString)
+    {
+    iString = &aString;
+    __ASSERT_DEBUG(MdcaCount()==1 && MdcaPoint(0)==aString, 
+        Panic(EPanicPostCond_SetDesC));
+    }
+
+inline void TSingleDesCArray::Reset()
+    {
+    iString = NULL;
+    __ASSERT_DEBUG(MdcaCount()==0, Panic(EPanicPostCond_Reset));
+    }
+
+#endif // __TSingleDesCArray_H__
+            
+// End of File