sl@0: /*
sl@0: * Copyright (c) 2006-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 <e32std.h>
sl@0: #include <e32def.h>
sl@0: #include <e32des8.h> 
sl@0: #include "unicodeconv.h"
sl@0: 
sl@0: //replacement character to be used when unicode cannot be converted
sl@0: const TUint8 KForeignReplacement = 0x5F;
sl@0: 
sl@0: //This function converts from Unicoded characters, to foreign characters and adds them into a descriptor
sl@0: EXPORT_C void UnicodeConv::ConvertFromUnicodeL(TDes8& aForeign, const TDesC16& aUnicode)
sl@0:     {
sl@0:     UnicodeConv::ConvertFromUnicodeL(aForeign, aUnicode, ETrue);
sl@0:     }
sl@0: 
sl@0: //This function converts from Unicoded characters, to foreign characters and adds them into a descriptor
sl@0: EXPORT_C TInt UnicodeConv::ConvertFromUnicodeL(TDes8& aForeign, const TDesC16& aUnicode, TBool leaveWhenOverflow)
sl@0: 	{
sl@0: 	const TInt unicodeLength = aUnicode.Length();
sl@0: 	
sl@0: 	//loop going through the character of the unicode descriptor
sl@0: 	for(TInt i=0; i<unicodeLength; i++)
sl@0: 		{
sl@0: 		const TUint16 unicodeChar = aUnicode[i];
sl@0: 		
sl@0: 		// if the output buffer is already full, leave with KErrOverflow
sl@0: 		if ( aForeign.Length() >= aForeign.MaxLength() )
sl@0: 		    {
sl@0: 		    if (leaveWhenOverflow)
sl@0: 		        User::Leave(KErrOverflow);
sl@0: 		    else
sl@0: 		        return KErrOverflow;
sl@0: 		    }			
sl@0: 
sl@0: 		//charcters from 0x0000 to 0x007F, can be mapped directly
sl@0: 		if(unicodeChar<0x0080)
sl@0: 			{
sl@0: 			aForeign.Append(static_cast<TUint8>(unicodeChar));
sl@0: 			}
sl@0: 		else
sl@0: 			{
sl@0: 			TInt trailByte = KErrNotFound;
sl@0: 			TInt returnValue = TConvDataStruct::ConvertSingleUnicode(unicodeChar,trailByte);
sl@0: 			
sl@0: 			if(returnValue!=KErrNotFound)
sl@0: 				{
sl@0: 				if(trailByte!=KErrNotFound)		
sl@0: 					{					
sl@0: 					// as two bytes are being added check enough space for second
sl@0: 					if ( aForeign.Length() + 2 <= aForeign.MaxLength() )
sl@0: 					    {
sl@0: 					    aForeign.Append(static_cast<TUint8>(returnValue));
sl@0: 					    aForeign.Append(static_cast<TUint8>(trailByte));
sl@0: 					    }
sl@0: 					else
sl@0: 					    {
sl@0: 			            if (leaveWhenOverflow)
sl@0: 			                User::Leave(KErrOverflow);
sl@0: 			            else
sl@0: 			                return KErrOverflow;
sl@0: 					    }					
sl@0: 					}
sl@0: 				else
sl@0: 					aForeign.Append(static_cast<TUint8>(returnValue));
sl@0: 				}		
sl@0: 			else
sl@0: 				aForeign.Append(KForeignReplacement);
sl@0: 			}
sl@0: 		}
sl@0: 	
sl@0: 	return KErrNone;
sl@0: 	}
sl@0: 				
sl@0: //This function converts from foreign characters into unicode and adds them into a descriptor
sl@0: EXPORT_C void UnicodeConv::ConvertToUnicodeL(TDes16& aUnicode, const TDesC8& aForeign)
sl@0:     {
sl@0:     UnicodeConv::ConvertToUnicodeL(aUnicode, aForeign, ETrue);
sl@0:     }
sl@0: 
sl@0: //This function converts from foreign characters into unicode and adds them into a descriptor
sl@0: EXPORT_C TInt UnicodeConv::ConvertToUnicodeL(TDes16& aUnicode, const TDesC8& aForeign, TBool leaveWhenOverflow)
sl@0: 	{
sl@0: 	const TInt foreignLength = aForeign.Length();
sl@0: 
sl@0: 	//loop going through the characters of the foreign descriptor
sl@0: 	for(TInt i = 0; i<foreignLength; i++)
sl@0: 		{
sl@0: 		const TUint8 leadForeign = aForeign[i];
sl@0: 		TUint8 tailForeign = 0x00;
sl@0: 
sl@0: 		// Check there is enough space in the output buffer, and leave with KErrOverflow if not
sl@0: 		if ( aUnicode.Length() == aUnicode.MaxLength() )
sl@0:             {
sl@0:             if (leaveWhenOverflow)
sl@0:                 User::Leave(KErrOverflow);
sl@0:             else
sl@0:                 return KErrOverflow;
sl@0:             }
sl@0: 
sl@0: 		//charcters from 0x00 to 0x7F, can be mapped directly
sl@0: 		if(leadForeign < 0x80)
sl@0: 			aUnicode.Append(static_cast<TUint16>(leadForeign));
sl@0: 		else
sl@0: 			{
sl@0: 			if((i+1)<foreignLength)
sl@0: 				tailForeign = aForeign[i+1];
sl@0: 
sl@0: 			const TLeadOrSingle* structPtr = TConvDataStruct::KFirstByteConversions + (leadForeign-0x80);
sl@0: 			
sl@0: 			if(structPtr->iUnicodeIfSingle)
sl@0: 				aUnicode.Append(structPtr->iUnicodeIfSingle);
sl@0: 			else
sl@0: 				{
sl@0: 				if(TConvDataStruct::KMinTrailByte<=tailForeign && tailForeign<=TConvDataStruct::KMaxTrailByte)
sl@0: 					aUnicode.Append(TConvDataStruct::KDoubleByteConversions[structPtr->iDoubleByteIndex+
sl@0: 						(tailForeign - TConvDataStruct::KMinTrailByte)]);
sl@0: 				else
sl@0: 					aUnicode.Append(0xFFFD);
sl@0: 				i++;
sl@0: 				}
sl@0: 			}
sl@0: 		}
sl@0: 
sl@0: 	return KErrNone;
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TBool UnicodeConv::IsLegalShortNameCharacter (TUint aCharacter)
sl@0: 	{
sl@0: 	//1. aCharacter >= 0x0080 
sl@0: 	if (aCharacter>=0x0080)
sl@0: 		{
sl@0: 		if (aCharacter>0xFFFF)
sl@0: 			return EFalse;
sl@0: 		
sl@0: 		TInt trailByte = KErrNotFound;
sl@0: 		TInt returnValue = TConvDataStruct::ConvertSingleUnicode(aCharacter,trailByte);
sl@0: 		
sl@0: 		if(returnValue!=KErrNotFound)
sl@0: 			return ETrue;
sl@0: 		else
sl@0: 			return EFalse;
sl@0: 		}
sl@0: 	
sl@0:     // For most common cases: 
sl@0:     // Note: lower case characters are considered legal DOS char here. 
sl@0: 	if ((aCharacter>='a' && aCharacter<='z') || 
sl@0: 	    (aCharacter>='A' && aCharacter<='Z') || 
sl@0: 	    (aCharacter>='0' && aCharacter<='9'))
sl@0: 			{
sl@0: 			return ETrue;
sl@0: 			}
sl@0:     // Checking for illegal chars: 
sl@0:     // 2. aCharacter <= 0x20 
sl@0:     // Note: leading 0x05 byte should be guarded by callers of this function 
sl@0:     //  as the information of the position of the character is required. 
sl@0: 	if (aCharacter < 0x20)
sl@0: 		return EFalse;
sl@0: 	// Space (' ') is not considered as a legal DOS char here.
sl@0: 	if (aCharacter == 0x20)
sl@0: 		return EFalse;
sl@0: 	
sl@0: 	// 3. 0x20 < aCharacter < 0x80 
sl@0:     // According to FAT Spec, "following characters are not legal in any bytes of DIR_Name": 
sl@0:     switch (aCharacter) 
sl@0:             { 
sl@0:             case 0x22:        // '"' 
sl@0:             case 0x2A:        // '*' 
sl@0:             case 0x2B:        // '+' 
sl@0:             case 0x2C:        // ',' 
sl@0:             //case 0x2E:        // '.'   // Although '.' is not allowed in any bytes of DIR_Name, it 
sl@0:                                          // is a valid character in short file names. 
sl@0:             case 0x2F:        // '/' 
sl@0:             case 0x3A:        // ':' 
sl@0:             case 0x3B:        // ';' 
sl@0:             case 0x3C:        // '<' 
sl@0:             case 0x3D:        // '=' 
sl@0:             case 0x3E:        // '>' 
sl@0:             case 0x3F:        // '?' 
sl@0:             case 0x5B:        // '[' 
sl@0:             case 0x5C:        // '\' 
sl@0:             case 0x5D:        // ']' 
sl@0:             case 0x7C:        // '|' 
sl@0:             	return EFalse; 
sl@0:             default: 
sl@0:             	return ETrue; 
sl@0:             } 
sl@0: 	}		
sl@0: