sl@0: // Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: //
sl@0: 
sl@0: 
sl@0: 
sl@0: #include <barsread.h>    // TResourceReader
sl@0: #include <bautils.h>     // BaflUtils
sl@0: #include "textresolver.h"
sl@0: #include <errorres.rsg>
sl@0: #include <uikon/eikdefconst.h>
sl@0: 
sl@0: 
sl@0: const TInt KUnknownError( 0 );
sl@0: const TInt KBlankError( -2 );
sl@0: 
sl@0: const TInt KRIMask(0x00000fff);
sl@0: _LIT(KErrorResResourceFileName, "z:\\resource\\errors\\ERRORRES.RSC"); 
sl@0: _LIT(KRDSupport, "c:\\resource\\ErrRD");
sl@0: _LIT(KTextResolverPanic,   "TextResolver");
sl@0: 
sl@0: 
sl@0: GLDEF_C void Panic(TInt aPanic)
sl@0: 	{
sl@0:     User::Panic(KTextResolverPanic, aPanic);
sl@0: 	}
sl@0: 
sl@0: 
sl@0: CTextResolver::CTextResolver()
sl@0:     {
sl@0:     }
sl@0: 
sl@0: CTextResolver::CTextResolver(CCoeEnv& aEnv)
sl@0:     :iCoe(&aEnv)
sl@0:     {
sl@0:     }
sl@0: /**
sl@0:  * Two-phase constructor method that is used to create a new instance
sl@0:  * of the CTextResolver class. The implementation uses the passed 
sl@0:  * CCoeEnv instance to access the resource files.
sl@0:  *
sl@0:  * @param aEnv the CCoeEnv instance to be used to access the resource
sl@0:  * files.
sl@0:  * @return a pointer to a new instance of the CTextResolver class.
sl@0:  */
sl@0: EXPORT_C CTextResolver* CTextResolver::NewL(CCoeEnv& aEnv)
sl@0:     {
sl@0:     CTextResolver* self = CTextResolver::NewLC(aEnv);
sl@0:     CleanupStack::Pop(self);
sl@0:     return self;
sl@0:     }
sl@0: 
sl@0:  /**
sl@0:  * Constructor creates a new instance of CTextResolver. The 
sl@0:  * implementation uses the passed CCoeEnv instance to access the 
sl@0:  * resource files. Leaves the object on the cleanup stack.
sl@0:  *
sl@0:  * @param aEnv the CCoeEnv instance to be used to access the resource
sl@0:  * files.
sl@0:  * @return a pointer to a new instance of the CTextResolver class.
sl@0:  */
sl@0: EXPORT_C CTextResolver* CTextResolver::NewLC(CCoeEnv& aEnv)
sl@0:     {
sl@0:     CTextResolver* self = new (ELeave) CTextResolver(aEnv);
sl@0:     CleanupStack::PushL(self);
sl@0:     self->ConstructL();
sl@0:     return self;
sl@0:     }
sl@0: 
sl@0:  /**
sl@0:  * Constructor creates a new instance of CTextResolver. Resource files 
sl@0:  * are accessed through the RResourceFile API.
sl@0:  *
sl@0:  * @return a pointer to a new instance of the CTextResolver class.
sl@0:  */
sl@0: EXPORT_C CTextResolver* CTextResolver::NewL()
sl@0:     {
sl@0:     CTextResolver* self = CTextResolver::NewLC();
sl@0:     CleanupStack::Pop(self);
sl@0:     return self;
sl@0:     }
sl@0: 
sl@0:  /**
sl@0:  * Constructor creates a new instance of CTextResolver.Resource files 
sl@0:  * are accessed through the RResourceFile API. Leaves the object on 
sl@0:  * the cleanup stack.
sl@0:  *
sl@0:  * @return a pointer to a new instance of the CTextResolver class.
sl@0:  */
sl@0: EXPORT_C CTextResolver* CTextResolver::NewLC()
sl@0:     {
sl@0:     CTextResolver* self = new (ELeave) CTextResolver();
sl@0:     CleanupStack::PushL(self);
sl@0:     self->ConstructL();
sl@0:     return self;
sl@0:     }
sl@0: 
sl@0: //
sl@0: // ---------------------------------------------------------
sl@0: // CTextResolver::ConstructL
sl@0: //
sl@0: // Symbian OS default constructor, initializes variables and cache 
sl@0: // ---------------------------------------------------------
sl@0: //
sl@0: void CTextResolver::ConstructL()
sl@0:     {
sl@0:     // if no coe is present, connect new filesession.
sl@0:     if (!iCoe)
sl@0:     	{
sl@0:         User::LeaveIfError(iFs.Connect());    
sl@0: 
sl@0: 		TFileName resFile(KErrorResResourceFileName);
sl@0: 		BaflUtils::NearestLanguageFile(iFs, resFile);
sl@0: 		iResFile.OpenL(iFs, resFile);
sl@0:     	}
sl@0: 
sl@0:     iRDSupport = BaflUtils::FileExists(iCoe ? iCoe->FsSession() : iFs, KRDSupport);     
sl@0:     }
sl@0: 
sl@0: /** 
sl@0: * Destructor 
sl@0: */
sl@0: EXPORT_C CTextResolver::~CTextResolver()
sl@0:     {
sl@0:     Reset();
sl@0:     iResFile.Close();
sl@0: 
sl@0:     // if no coe is present, close filesession.
sl@0:     if (!iCoe)
sl@0:         iFs.Close();   
sl@0:     
sl@0:     delete iTitleText;
sl@0:     delete iTextBuffer;
sl@0:     delete iContextSeparator;
sl@0:     }
sl@0: 
sl@0: /**
sl@0: * Resolves the given error code and returns the error text for the
sl@0: * resolved error. Resolved text can be of any length. This version 
sl@0: * is for "normal" use.
sl@0: *
sl@0: * @param aError The error code to be resolved.
sl@0: * @param aContext Optional context for error numbers. If the aContext 
sl@0: * parameter is not passed to the function, it uses the default value
sl@0: * ECtxAutomatic. 
sl@0: * @return the error text for the resolved error. "System error" (in 
sl@0: * English localisation) is returned when error code is not known. For 
sl@0: * unknown errors blank error flag (flags are defined in 
sl@0: * textresolver.hrh) is also set to hide errors without proper 
sl@0: * explanation. There is no limit on how long the resolved string
sl@0: * can be.
sl@0: */
sl@0: EXPORT_C const TDesC& CTextResolver::ResolveErrorString(TInt aError, TErrorContext aContext)
sl@0:     {
sl@0:     TUint flags(0);
sl@0:     TInt id(0);
sl@0: 	return ResolveErrorString(aError,id,flags,aContext);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: * Resolves the given error code and returns the error text for the
sl@0: * resolved error. Resolved text can be of any length. This version
sl@0: * is for advanced use
sl@0: *
sl@0: * @param aError The error code to be resolved.
sl@0: * @param aTextId ID of the returned text.
sl@0: * @param aFlags The priority of the returned error. The priority is 
sl@0: * defined by the this module! Flags are defined in textresolver.hrh.
sl@0: * @param aContext Optional context for error numbers. If the aContext 
sl@0: * parameter is not passed to the function, it uses the default value
sl@0: * ECtxAutomatic. 
sl@0: * @return the error text for the resolved error. "System error" (in 
sl@0: * English localisation) is returned when error code is not known. For 
sl@0: * unknown errors blank error flag (flags are defined in 
sl@0: * textresolver.hrh) is also set to hide errors without proper 
sl@0: * explanation. There is no limit on how long the resolved string 
sl@0: * can be.
sl@0: */
sl@0: EXPORT_C const TDesC& CTextResolver::ResolveErrorString(TInt aError, TInt& aTextId, TUint& aFlags, TErrorContext aContext)
sl@0:     {
sl@0:     aFlags = 0;
sl@0:     if (iCoe)	// Use the resource loaded using the CCoeEnv to read the resource file
sl@0:     	{
sl@0: 	    TRAPD(err, DoResolveErrorStringL(aError, aTextId, aFlags));
sl@0: 		if (err)
sl@0: 			{
sl@0: 			if ((!AddContextAndSeparator(aContext)))
sl@0: 				{
sl@0: 				// Even the resource file opening failed, return OOM flag
sl@0: 				aFlags |= EErrorResOOMFlag;
sl@0: 				return KNullDesC;
sl@0: 				}
sl@0: 			return *iTextBuffer;
sl@0: 			}            
sl@0: 
sl@0: 		if(aFlags&ETextResolverUnknownErrorFlag)	// Error code not supported. No error text found.
sl@0: 	        {
sl@0: 	        // Error is not recognised 
sl@0: 	        aTextId = R_ERROR_RES_GENERAL;	// Read and return an "unknown error" text from the
sl@0: 	        								// Nokia-specific version of the errorres.rss file
sl@0: 	      	TPtr appTextPtr = iTitleText->Des();
sl@0: 	      	TPtr textPtr = iTextBuffer->Des();
sl@0: 	      	iCoe->ReadResourceL(appTextPtr, R_BASE);
sl@0: 	      	iCoe->ReadResourceL(textPtr, R_ERROR_RES_GENERAL);
sl@0: 	        }
sl@0: 		}
sl@0: 	else	// No CCoeEnv available
sl@0: 		{
sl@0: 		aTextId = 0;
sl@0:         TRAPD(err, DoRawReadOfSystemErrorResourcesToArraysL(aError, aTextId));
sl@0:         if(err)
sl@0:             {
sl@0:             // Cleaning needed since object not destroyed
sl@0:             Reset();
sl@0:             
sl@0:             if (aTextId != R_ERROR_RES_NO_MEMORY || !AddContextAndSeparator(aContext))
sl@0:                 {
sl@0:                 // Even the resource file opening failed, return OOM flag
sl@0:                 aFlags |= EErrorResOOMFlag;
sl@0:                 return KNullDesC;
sl@0:                 }
sl@0: 
sl@0:             return *iTextBuffer;
sl@0:             }            
sl@0:         
sl@0:         aTextId = ResourceForError(aError);
sl@0:         switch (aTextId)
sl@0:             {
sl@0:             case KBlankError:
sl@0:                 {
sl@0:                 aFlags |= ETextResolverBlankErrorFlag;
sl@0:                 break;
sl@0:                 }
sl@0:             case KUnknownError:
sl@0:                 {
sl@0:                 // Error is not recognised 
sl@0:                 aTextId = R_ERROR_RES_GENERAL;
sl@0: 
sl@0: 				delete iTitleText;
sl@0:                 iTitleText = AllocReadUnicodeString(iResFile, R_BASE);
sl@0:                 aFlags |= ETextResolverUnknownErrorFlag;
sl@0:                 // No break here; Fall through to default case to resolve text for the general error
sl@0:                 }
sl@0:             default:    
sl@0:                 {
sl@0:                 // --- Error recognised by the resolver, so get the text ---
sl@0: 				delete iTextBuffer;
sl@0:                 iTextBuffer = AllocReadUnicodeString(iResFile, aTextId);
sl@0:                 break;
sl@0:                 }
sl@0:             };       
sl@0:         }       
sl@0: 
sl@0: 	if(aFlags&ETextResolverBlankErrorFlag)	// Error code supported, but no error text found.
sl@0: 		{
sl@0: 		delete iTextBuffer;
sl@0: 		iTextBuffer = NULL;				// Return no error text at all	
sl@0: 		}
sl@0: 
sl@0:     if (!AddContextAndSeparator(aContext))
sl@0: 		{
sl@0: 		aFlags |= EErrorResOOMFlag;
sl@0: 		return KNullDesC;
sl@0: 		}
sl@0: 
sl@0:     if (iRDSupport && iTextBuffer) 
sl@0:         {
sl@0:         HBufC* tempBuffer = iTextBuffer->ReAlloc(iTextBuffer->Length()+14);
sl@0: 
sl@0:         // if allocation succeeds, append error id. Otherwise iTextBuffer stays as it is
sl@0:         if (tempBuffer)
sl@0:             {
sl@0:             iTextBuffer = tempBuffer;
sl@0:             iTextBuffer->Des().Append(' ');
sl@0:             iTextBuffer->Des().Append('(');
sl@0:             iTextBuffer->Des().AppendNum(aError);
sl@0:             iTextBuffer->Des().Append(')');
sl@0:             }
sl@0:         }
sl@0: 	else if (aFlags & ETextResolverUnknownErrorFlag)
sl@0: 		{ // We hide the errors we cannot give proper explanation, 
sl@0: 		  //i.e. "System Error" will not be shown.
sl@0: 		aFlags |= ETextResolverBlankErrorFlag;	
sl@0:         }
sl@0: 
sl@0:     if (iTextBuffer)
sl@0:         return *iTextBuffer;
sl@0:     else
sl@0:         return KNullDesC;
sl@0:     }
sl@0: 
sl@0: TInt CTextResolver::ResourceForError(TInt aError)
sl@0:     {
sl@0:     ASSERT(!iCoe);
sl@0:     const TInt errorCount = iStartError->Count();
sl@0:             
sl@0:     delete iTitleText;
sl@0:     iTitleText = NULL;
sl@0:     
sl@0:     for (TInt cc = 0; cc < errorCount; ++cc)
sl@0:         {
sl@0:         const TInt starterror = (*iStartError)[cc];
sl@0:         const TInt endError = starterror-(*iErrorTexts)[cc]->Count()+1;
sl@0:         
sl@0:         if (aError >= endError && aError <= starterror)
sl@0:         	{
sl@0: 	        ASSERT(!iTitleText);
sl@0: 	        iTitleText = AllocReadUnicodeString(iResFile, (*iAppTexts)[cc]);
sl@0: 
sl@0: 	        const TInt errorIndex = -(aError-starterror);
sl@0: 	        const TInt flags = (*iFlags)[cc]->At(errorIndex);
sl@0: 	        
sl@0: 	        if (flags & ETextResolverPanicErrorFlag)
sl@0: 	            {
sl@0: 	            // --- Some errors are never meant to get to the UI level ---
sl@0: 	            // --- Those of them that do, result in a panic ---
sl@0: 	            Panic(aError);
sl@0: 	            }
sl@0: 	        
sl@0: 	        else if (flags & ETextResolverBlankErrorFlag)
sl@0: 	            {
sl@0: 	            // --- Error code can be ignored from the users' perspective ---
sl@0: 	            // --- Return blank error text ---
sl@0: 	            return KBlankError;
sl@0: 	            }
sl@0: 
sl@0: 	        else if (flags & ETextResolverUnknownErrorFlag)
sl@0: 	            {
sl@0: 	            // --- Error not recognised by TextResolver ---
sl@0: 	            // --- Will be passed on to UIKON for interpretation ---
sl@0: 	            return KUnknownError;
sl@0: 	            }
sl@0: 	            
sl@0: 	        return (*iErrorTexts)[cc]->At(errorIndex); 
sl@0:         	}
sl@0:         }
sl@0:         
sl@0:    return KUnknownError;     
sl@0:    }
sl@0:     
sl@0: 
sl@0: /**
sl@0: Read the system error texts from errorres.rss only, without using the Uikon CEikErrorResolver.
sl@0: This will not pick up any appliation specific errors.
sl@0: */
sl@0: void CTextResolver::DoRawReadOfSystemErrorResourcesToArraysL(TInt& aError, TInt& aTextId)
sl@0:     {
sl@0:     ASSERT(!iCoe);
sl@0:     TResourceReader reader;
sl@0:     ReadLocalizedSeparatorCharacterFromResourceAndPrepareResourceReaderLC(reader);
sl@0: 
sl@0:     // Lets handle KErrNoMemory as a special case, this this way we can maybe avoid extra "Resolving Errors"
sl@0:     if (aError == KErrNoMemory) 
sl@0:         {
sl@0:         ASSERT(!iTextBuffer && !iTitleText);
sl@0: 		aTextId = R_ERROR_RES_NO_MEMORY;
sl@0: 		iTextBuffer = AllocReadUnicodeString(iResFile, aTextId);
sl@0: 		iTitleText = AllocReadUnicodeString(iResFile, R_BASE);
sl@0:         User::Leave(KErrNoMemory);
sl@0:         }
sl@0:    
sl@0: 	if(iStartError && iErrorTexts && iFlags && iAppTexts)
sl@0: 		{
sl@0: 		CleanupStack::PopAndDestroy(); // rBuffer
sl@0: 		return;	// Already all done
sl@0: 		}
sl@0:         
sl@0: 	// The resource data is used differenciate between the old and new resource formats 
sl@0: 	// (i.e, resources using title text and one's without using title text)
sl@0: 	// This API only support the new format, so just check that it is on the new format
sl@0:     const TInt dummy = reader.ReadInt16();
sl@0:     const TInt version = reader.ReadInt16();
sl@0:     __ASSERT_ALWAYS(dummy == 0 && version == 2, User::Leave(KErrNotSupported));
sl@0: 
sl@0:     // Read into the error arrays
sl@0:     const TInt arrayCount = reader.ReadInt16();
sl@0:     
sl@0:     ASSERT(!iStartError && !iErrorTexts && !iFlags && !iAppTexts);
sl@0:     iStartError = new(ELeave) CArrayFixFlat<TInt>(arrayCount);
sl@0:     iErrorTexts = new(ELeave) CArrayPtrSeg<CErrorResourceIdArray>(arrayCount);
sl@0:     iFlags = new(ELeave) CArrayPtrSeg<CErrorResourceFlagArray>(arrayCount);
sl@0:     iAppTexts = new(ELeave) CArrayFixFlat<TInt>(arrayCount);
sl@0:     
sl@0:     for (TInt cc = 0; cc < arrayCount; ++cc)
sl@0:         {
sl@0:         // Read in error array
sl@0:         iAppTexts->AppendL(reader.ReadInt32()); // Application indicators  
sl@0:         iStartError->AppendL(reader.ReadInt32());
sl@0: 
sl@0:         const TInt listId = reader.ReadInt32();
sl@0:         
sl@0:         TResourceReader reader2;
sl@0:         HBufC8* rBuffer = iResFile.AllocReadL(listId & KRIMask); // Remove offset from id
sl@0:         reader2.SetBuffer(rBuffer);
sl@0:         CleanupStack::PushL(rBuffer);
sl@0: 
sl@0:         const TInt count = reader2.ReadInt16();
sl@0:         CArrayFixFlat<TInt>* array = new(ELeave) CErrorResourceIdArray(count);
sl@0:         CleanupStack::PushL(array);
sl@0:         
sl@0:         CArrayFixFlat<TInt>* flagarray = new(ELeave) CErrorResourceFlagArray(count);
sl@0:         CleanupStack::PushL(flagarray);
sl@0:     
sl@0:         for (TInt dd = 0; dd < count; ++dd)
sl@0:             {                   
sl@0:             const TInt flags = reader2.ReadInt8();
sl@0:             flagarray->AppendL(flags);
sl@0:             // Append resource id for this error text
sl@0:             array->AppendL(reader2.ReadInt32());
sl@0:             }
sl@0:     
sl@0:         iFlags->AppendL(flagarray);
sl@0:         CleanupStack::Pop(flagarray); 
sl@0: 
sl@0:         iErrorTexts->AppendL(array);
sl@0:         CleanupStack::Pop(array);
sl@0: 
sl@0:         CleanupStack::PopAndDestroy(rBuffer);
sl@0:         }
sl@0:     
sl@0:     CleanupStack::PopAndDestroy(); // reader's rBuffer
sl@0:     }
sl@0: 
sl@0: // ---------------------------------------------------------
sl@0: // CTextResolver::Reset()
sl@0: //
sl@0: // Reset the member variables
sl@0: // ---------------------------------------------------------
sl@0: //
sl@0: void CTextResolver::Reset()
sl@0:     {
sl@0:     if (iBaseResourceFileOffset)
sl@0:         {
sl@0:         iCoe->DeleteResourceFile(iBaseResourceFileOffset);
sl@0:         iBaseResourceFileOffset = 0;
sl@0:         }
sl@0:         
sl@0:     if (iErrorTexts)
sl@0:         {
sl@0:         iErrorTexts->ResetAndDestroy();
sl@0:         delete iErrorTexts;
sl@0:         iErrorTexts = NULL;
sl@0:         }
sl@0:     
sl@0:     if (iFlags)
sl@0:         {
sl@0:         iFlags->ResetAndDestroy();
sl@0:         delete iFlags;
sl@0:         iFlags = NULL;
sl@0:         }
sl@0:                 
sl@0:     delete iStartError;
sl@0:     iStartError = NULL;
sl@0:     
sl@0:     delete iAppTexts;   
sl@0:     iAppTexts = NULL;
sl@0:     }
sl@0: 
sl@0: /**
sl@0: ErrorResolver resource files in the ?:/resource/errors/ folder must always begin with
sl@0: an array of error texts. The Nokia-specific version of the errorres.rss file also 
sl@0: contains the localized titel/text separator character at the end of the file.
sl@0: This method reads the separator character from file using the CCoeEnv provided.
sl@0: */
sl@0: void CTextResolver::ReadLocalizedSeparatorCharacterFromResourceL(CCoeEnv& aCoeEnv)
sl@0: 	{
sl@0: 	ASSERT(&aCoeEnv);
sl@0: 	
sl@0: 	if (!iBaseResourceFileOffset)
sl@0:     	{
sl@0:     	TFileName filename(KErrorResResourceFileName);
sl@0:     	BaflUtils::NearestLanguageFile(aCoeEnv.FsSession(), filename);
sl@0:     
sl@0:     	iBaseResourceFileOffset = aCoeEnv.AddResourceFileL(filename);
sl@0: 		
sl@0: 		ASSERT(!iContextSeparator);
sl@0: 		iContextSeparator = aCoeEnv.AllocReadResourceL(R_LOCALIZED_CONTEXT_SEPARATOR);
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: ErrorResolver resource files in the ?:/resource/errors/ folder must always begin with
sl@0: an array of error texts. The Nokia-specific version of the errorres.rss file also 
sl@0: contains the localized titel/text separator character at the end of the file.
sl@0: This method reads the separator character from file WITHOUT using a CCoeEnv.
sl@0: */
sl@0: void CTextResolver::ReadLocalizedSeparatorCharacterFromResourceAndPrepareResourceReaderLC(TResourceReader& aResReader)
sl@0:     {
sl@0:     ASSERT(!iCoe);
sl@0:     ASSERT(!iBaseResourceFileOffset);
sl@0: 
sl@0:     HBufC8* rBuffer = iResFile.AllocReadL(R_ERROR_RES_BASE_LIST & KRIMask); // Remove offset from id
sl@0:     aResReader.SetBuffer(rBuffer);        
sl@0:     CleanupStack::PushL(rBuffer);
sl@0:     
sl@0:     if(!iContextSeparator)
sl@0:     	iContextSeparator = AllocReadUnicodeString(iResFile, R_LOCALIZED_CONTEXT_SEPARATOR);
sl@0:     
sl@0:     // Leave rBuffer on CleanupStack
sl@0:     }
sl@0: 
sl@0: // returns NULL if out of memory
sl@0: HBufC* CTextResolver::AllocReadUnicodeString(RResourceFile& aResFile, TInt aTextId)
sl@0:     { 
sl@0:     // Reading Unicode string w/o CCoe
sl@0:     HBufC8* tempBuffer = NULL;
sl@0:     HBufC* retBuffer = NULL;
sl@0: 
sl@0:     TRAPD(err, tempBuffer = aResFile.AllocReadL((KRIMask & aTextId))); // Remove offset from id
sl@0:     if (!err)
sl@0:         {
sl@0:         __ASSERT_DEBUG((tempBuffer->Length()%2)==0,Panic(aTextId));
sl@0: 
sl@0:         // do bitwise shift to halve the length for mapping the tempBuffer to unicode.
sl@0:         TInt newLen = tempBuffer->Length()>>1;
sl@0:         TPtrC tempPointer((TText*)tempBuffer->Ptr(), newLen);
sl@0: 
sl@0:         retBuffer = tempPointer.Alloc();
sl@0:         delete tempBuffer;
sl@0:         }
sl@0: 
sl@0:     return retBuffer;
sl@0:     }
sl@0: 
sl@0: TBool CTextResolver::AddContextAndSeparator(TErrorContext aContext)
sl@0:     {
sl@0:     TBool retval(EFalse); 
sl@0:     
sl@0:     if (iTextBuffer && iTitleText && iContextSeparator) // If we got all the parts we need...
sl@0:         {
sl@0:         //... then put them together according to the aContext argument
sl@0:         
sl@0:         // Context checked after validity of string buffers is checked, 
sl@0:         // because EFalse return value is required if any of those is NULL.
sl@0:         if (aContext == ECtxNoCtxNoSeparator)
sl@0:             retval = ETrue;
sl@0:         else
sl@0:             {
sl@0:             HBufC* tempBuffer = iTextBuffer->ReAlloc(iTextBuffer->Length()+iContextSeparator->Length()+iTitleText->Length()+1);
sl@0: 
sl@0:             // If allocation succeeds, insert context. Otherwise iTextBuffer stays as it is.
sl@0:             if (tempBuffer)
sl@0:                 {
sl@0:                 iTextBuffer = tempBuffer;
sl@0: 				
sl@0: 				// Add the title ("context") text and separator before the error text
sl@0: 
sl@0:                	_LIT(KNewLineChar, "\n");
sl@0:                 iTextBuffer->Des().Insert(0, KNewLineChar);            
sl@0:                 iTextBuffer->Des().Insert(0, *iContextSeparator);
sl@0: 
sl@0:                 if (aContext != ECtxNoCtx)
sl@0:                     iTextBuffer->Des().Insert(0,*iTitleText);
sl@0: 
sl@0:                 retval = ETrue;
sl@0:                 }
sl@0:             }
sl@0:         }
sl@0:     return retval;
sl@0:     }
sl@0: 
sl@0: void CTextResolver::AllocBuffersL()
sl@0: 	{
sl@0: 	delete iTitleText;
sl@0: 	iTitleText = NULL;
sl@0: 	delete iTextBuffer;
sl@0: 	iTextBuffer = NULL;
sl@0: 
sl@0: 	iTitleText = HBufC::NewL(KEikErrorResolverMaxTextLength);
sl@0:     iTextBuffer = HBufC::NewL(KEikErrorResolverMaxTextLength);
sl@0: 	}
sl@0: 	
sl@0: void CTextResolver::DoResolveErrorStringL(TInt aError, TInt& aTextId, TUint& aFlags)
sl@0: 	{
sl@0: 	ASSERT(iCoe);
sl@0: 	AllocBuffersL();
sl@0:     
sl@0:    	TPtr errTextPtr = iTextBuffer->Des();
sl@0: 	TPtr errTitlePtr = iTitleText->Des();
sl@0:     
sl@0:     CEikonEnv::TErrorValidity errValidity = static_cast<CEikonEnv*>(iCoe)->DoGetErrorTextAndTitle(errTextPtr, aError, aTextId, aFlags, errTitlePtr, ETrue);
sl@0: 
sl@0:     if (errValidity == CEikonEnv::EErrorNumInvalid)
sl@0:     	Panic(aError);
sl@0: 
sl@0: 	// If either the iTextBuffer or iTitleText buffers were too small, 
sl@0: 	// they will contain the required length coded as digits into the buffer
sl@0: 	TLex sizeRealloc(*iTextBuffer);
sl@0:     TInt sizeRequiredForTextBuffer = 0;
sl@0:     TInt sizeRequiredForTitleBuffer = 0;
sl@0:     
sl@0:     // Try reading the size required, if any
sl@0:     sizeRealloc.Val(sizeRequiredForTextBuffer);
sl@0:     sizeRealloc = *iTitleText;
sl@0:     sizeRealloc.Val(sizeRequiredForTitleBuffer);
sl@0:     
sl@0:     // If sizes were found, realloc and get the error text again
sl@0:     if (sizeRequiredForTextBuffer || sizeRequiredForTitleBuffer)	
sl@0:     	{	
sl@0: 		if (sizeRequiredForTextBuffer)
sl@0: 			{
sl@0: 			delete iTextBuffer;
sl@0: 			iTextBuffer = NULL;
sl@0: 			iTextBuffer = HBufC::NewL(sizeRequiredForTextBuffer);
sl@0: 			}
sl@0: 			
sl@0: 		if (sizeRequiredForTitleBuffer)
sl@0: 			{
sl@0: 			delete iTitleText;
sl@0: 			iTitleText = NULL;
sl@0: 			iTitleText = HBufC::NewL(sizeRequiredForTitleBuffer);
sl@0: 			}
sl@0: 
sl@0: 	   	TPtr errTextPtr(iTextBuffer->Des());
sl@0: 		TPtr errTitlePtr(iTitleText->Des());
sl@0: 		errValidity = static_cast<CEikonEnv*>(iCoe)->DoGetErrorTextAndTitle(errTextPtr, aError, aTextId, aFlags, errTitlePtr, ETrue);
sl@0: 		if (!iTextBuffer->Length())
sl@0: 			{
sl@0: 			delete iTextBuffer;
sl@0: 			iTextBuffer = NULL;
sl@0: 			}
sl@0:     	}
sl@0:     	
sl@0:     ReadLocalizedSeparatorCharacterFromResourceL(*iCoe);
sl@0: 	}
sl@0: 
sl@0: //  End of File
sl@0: 
sl@0: