// Copyright (c) 1997-2009 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:

 //

 #if !defined(__BAUTILS_H__)

 #define __BAUTILS_H__

 #include <e32std.h>

 #include <f32file.h>

 #include <barsread.h>

 #include <badesca.h>

 /**

 @publishedAll

 @released

 */

 const TUint KBaflCharTruncation=0x2026; // Unicode's "horizontal ellipsis"

 /**

 There are at most 16 languages in the language downgrade path.

 The end of the language path is marked by an ELangNone.

 @publishedAll

 @released

 */

 const TInt KMaxDowngradeLanguages = 16;

 /**

 @publishedAll

 @released

 */

 typedef TLanguage TLanguagePath[KMaxDowngradeLanguages + 1];

 class RFs;

 class CBaflFileSortTable;

 class TDigitizerCalibration;

 class BaflUtils

 /** 

 Provides simple-to-use file system utilities.

 The functions listed in "Copying, renaming, and deleting files" create and 

 use a CFileMan object. They are useful for one-off calls, but for repeated 

 use it is more efficient to use CFileMan directly.

 Note that there is a very similiar group of functions available in EikFileUtils, 

 which may be easier to use in GUI applications, as they do not require a file 

 server session to be passed.

 @see CFileMan

 @see EikFileUtils 

 @publishedAll

 @released

 */

 	{

 public:

 	IMPORT_C static void CopyWithTruncation(TDes& aDest,const TDesC& aSrc,TChar aTruncationSymbol=KBaflCharTruncation);

 	IMPORT_C static TBool FileExists(const RFs& aFs,const TDesC& aFileName);

 	IMPORT_C static void EnsurePathExistsL(RFs& aFs,const TDesC& aFileName);

 	IMPORT_C static TPtrC ExtractAppNameFromFullName(const TFullName &aName);

 	IMPORT_C static void NearestLanguageFile(const RFs& aFs,TFileName& aName);

 	IMPORT_C static void NearestLanguageFile(const RFs& aFs,TFileName& aName, TLanguage& aLanguage);

 	IMPORT_C static TInt SetIdealLanguage(TLanguage aLanguage);

 	IMPORT_C static TLanguage IdealLanguage();

 	IMPORT_C static void ReleaseIdealLanguage();

 	IMPORT_C static TInt GetSystemDrive(TDriveNumber& aDriveNumber);

 	IMPORT_C static TBool PathExists(RFs& aFs,const TDesC& aFileName);

 	IMPORT_C static TInt IsFolder(const RFs& aFs, const TDesC& aFullName, TBool& aIsFolder);

 	IMPORT_C static TBool FolderExists(RFs& aFs, const TDesC& aFolderName);

 	IMPORT_C static TFileName FolderNameFromFullName(const TDesC& aFullName);

 	IMPORT_C static TFileName DriveAndPathFromFullName(const TDesC& aFullName);

 	IMPORT_C static TFileName RootFolderPath(const TBuf<1> aDriveLetter);

 	IMPORT_C static void AbbreviateFileName(const TFileName& aOriginalFileName, TDes& aAbbreviatedFileName);

 	IMPORT_C static TBool UidTypeMatches(const TUidType& aFileUid, const TUidType& aMatchUid);

 	IMPORT_C static TInt Parse(const TDesC& aName);

 	IMPORT_C static TInt ValidateFolderNameTypedByUserL(const RFs& aFs, const TDesC& aFolderNameTypedByUser, const TDesC& aCurrentPath, TFileName& aNewFolderFullName);

 	IMPORT_C static TInt CopyFile(RFs& aFs, const TDesC& aSourceFullName, const TDesC& aTargetFullName, TUint aSwitch = CFileMan::EOverWrite);

 	IMPORT_C static TInt RenameFile(RFs& aFs, const TDesC& aOldFullName, const TDesC& aNewFullName, TUint aSwitch = CFileMan::EOverWrite);

 	IMPORT_C static TInt DeleteFile(RFs& aFs, const TDesC& aSourceFullName, TUint aSwitch = 0);

 	IMPORT_C static TInt CheckWhetherFullNameRefersToFolder(const TDesC& aFullName, TBool& aIsFolder);

 	IMPORT_C static TInt MostSignificantPartOfFullName(const TDesC& aFullName, TFileName& aMostSignificantPart);

 	IMPORT_C static TInt CheckFolder(RFs& aFs, const TDesC& aFolderName);

 	IMPORT_C static TInt DiskIsReadOnly(RFs& aFs, const TDesC& aFullName, TBool& aIsReadOnly);

 	IMPORT_C static TInt DriveIsReadOnlyInternal(RFs& aFs, const TDesC& aFullName, TBool& aIsReadOnlyInternal);

 	IMPORT_C static void GetDiskListL(const RFs& aFs,CDesCArray& aArray);

 	IMPORT_C static void UpdateDiskListL(const RFs& aFs,CDesCArray& aArray,TBool aIncludeRom,TDriveNumber aDriveNumber);

 	IMPORT_C static void RemoveSystemDirectory(CDir& aDir);

 	IMPORT_C static TBool IsFirstDriveForSocket(TDriveUnit aDriveUnit);

 	IMPORT_C static TInt SortByTable(CDir& aDir,CBaflFileSortTable* aTable);

 	IMPORT_C static void GetDowngradePathL(const RFs& aFs, const TLanguage aCurrentLanguage, RArray<TLanguage>& aLanguageArray);

 	IMPORT_C static void PersistLocale();

 	IMPORT_C static TInt PersistHAL();

 	IMPORT_C static void PersistScreenCalibration(const TDigitizerCalibration& aScreenCalibration);

 	IMPORT_C static void InitialiseScreenCalibration(RFs& aFs);

 	IMPORT_C static void InitialiseHAL(RFs& aFs);

 	IMPORT_C static void InitialiseLocale(RFs& aFs);

 	IMPORT_C static void GetEquivalentLanguageList(TLanguage aLang, TLanguagePath& aEquivalents);

 	IMPORT_C static void NearestLanguageFileV2(const RFs& aFs,TFileName& aName, TLanguage& aLanguage);

 private:

 	static void DoCopyFileL(RFs& aFs, const TDesC& aSourceFullName, const TDesC& aTargetFullName, TUint aSwitch);

 	static void DoRenameFileL(RFs& aFs, const TDesC& aOldFullName, const TDesC& aNewFullName, TUint aSwitch);

 	static void DoDeleteFileL(RFs& aFs, const TDesC& aSourceFullName, TUint aSwitch);

 	};

 /**

  * Bafl File Sort Table containing an array of UIDs.

  * @publishedAll

  * @released

  */	

 class CBaflFileSortTable : public CArrayFixFlat<TUid>

  	{

 public:

 	IMPORT_C CBaflFileSortTable();

 	IMPORT_C void ConstructFromResourceL(TResourceReader& aReader);

 private:

 	enum {EArrayGranularity=4};

 	};

 #endif