--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/epoc32/include/mw/coeutils.h	Wed Mar 31 12:27:01 2010 +0100
@@ -0,0 +1,102 @@
+// COEUTILS.H
+
+/*
+* Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+* which accompanies this distribution, and is available
+* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+
+
+#ifndef __COEUTILS_H__
+#define __COEUTILS_H__
+
+#include <e32std.h>
+class CCoeEnv;
+
+/** Provides file and path utility functions.
+
+@publishedAll
+@released */
+class ConeUtils
+	{
+public:
+	IMPORT_C static TBool FileExists(const TDesC& aFileName);
+	IMPORT_C static void EnsurePathExistsL(const TPtrC& aFileName);
+	};
+
+
+/** 
+Class encapsulates methods for opening and closing localised resource files
+in the CONE environment. The actual reading of resources from an opened 
+resource file is done using various CCoeEnv provided resource-reading 
+methods. The Cone Resource Loader API consists of the RCoeResourceLoader class.
+
+Only one resource at a time may be opened by one RCoeResourceLoader instance. 
+You can use several RCoeResourceLoader instances for accessing several 
+resources simultaneously or use one instance and close the previous resource
+before opening a new one.
+
+The implementation uses BaflUtils::NearestLanguageFile to search for
+a localised resource in proper search order.
+ 
+Usage example:  
+
+@code
+#include <coeutils.h>  
+
+// Get CCoeEnv instance
+CEikonEnv* eikEnv = CEikonEnv::Static();
+// Initialize loader
+RCoeResourceLoader rLoader(eikEnv);
+
+// Push resource loader to cleanup stack, so that it will always be properly 
+// closed when popped.
+CleanupClosePushL(rLoader);
+
+// Open resource file
+_LIT( KSampleResourceFileName, "Z:\\System\\Apps\\sample\\sample.rsc" );
+TFileName fileName(KSampleResourceFileName);
+rLoader.OpenL(fileName);
+
+// Read a resource   
+iSomeArray = eikEnv->ReadDesC16ArrayResourceL(R_SOME_RESOURCE);
+
+// Pop and destroy rLoader from stack. 
+// This also calls the rLoader close function after CleanupClosePushL is used.
+CleanupStack::PopAndDestroy(); // rLoader
+@endcode
+
+@publishedAll
+@released */
+NONSHARABLE_CLASS(RCoeResourceLoader)
+    {
+public:
+    IMPORT_C RCoeResourceLoader(CCoeEnv& aEnv);
+    IMPORT_C TInt Open(TFileName& aFileName);
+    IMPORT_C void OpenL(TFileName& aFileName);
+    IMPORT_C void Close();
+private:
+    // Prohibit copy constructor and assigment operator because not deriving from CBase.
+    RCoeResourceLoader();
+    RCoeResourceLoader(const RCoeResourceLoader&);
+    RCoeResourceLoader& operator= (const RCoeResourceLoader&);
+private:
+    // Needed for closing
+    CCoeEnv& iEnv; 
+    TInt iResourceFileOffset;
+    };
+
+
+#endif	// __COEUTILS_H__