sl@0: // Copyright (c) 1997-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: #if !defined(__BAUTILS_H__) sl@0: #define __BAUTILS_H__ sl@0: sl@0: #include sl@0: #include sl@0: #include sl@0: #include sl@0: sl@0: /** sl@0: @publishedAll sl@0: @released sl@0: */ sl@0: const TUint KBaflCharTruncation=0x2026; // Unicode's "horizontal ellipsis" sl@0: sl@0: /** sl@0: There are at most 16 languages in the language downgrade path. sl@0: The end of the language path is marked by an ELangNone. sl@0: @publishedAll sl@0: @released sl@0: */ sl@0: const TInt KMaxDowngradeLanguages = 16; sl@0: sl@0: /** sl@0: @publishedAll sl@0: @released sl@0: */ sl@0: typedef TLanguage TLanguagePath[KMaxDowngradeLanguages + 1]; sl@0: sl@0: class RFs; sl@0: class CBaflFileSortTable; sl@0: class TDigitizerCalibration; sl@0: sl@0: sl@0: class BaflUtils sl@0: /** sl@0: Provides simple-to-use file system utilities. sl@0: sl@0: The functions listed in "Copying, renaming, and deleting files" create and sl@0: use a CFileMan object. They are useful for one-off calls, but for repeated sl@0: use it is more efficient to use CFileMan directly. sl@0: sl@0: Note that there is a very similiar group of functions available in EikFileUtils, sl@0: which may be easier to use in GUI applications, as they do not require a file sl@0: server session to be passed. sl@0: sl@0: @see CFileMan sl@0: @see EikFileUtils sl@0: @publishedAll sl@0: @released sl@0: */ sl@0: { sl@0: public: sl@0: IMPORT_C static void CopyWithTruncation(TDes& aDest,const TDesC& aSrc,TChar aTruncationSymbol=KBaflCharTruncation); sl@0: IMPORT_C static TBool FileExists(const RFs& aFs,const TDesC& aFileName); sl@0: IMPORT_C static void EnsurePathExistsL(RFs& aFs,const TDesC& aFileName); sl@0: IMPORT_C static TPtrC ExtractAppNameFromFullName(const TFullName &aName); sl@0: IMPORT_C static void NearestLanguageFile(const RFs& aFs,TFileName& aName); sl@0: IMPORT_C static void NearestLanguageFile(const RFs& aFs,TFileName& aName, TLanguage& aLanguage); sl@0: IMPORT_C static TInt SetIdealLanguage(TLanguage aLanguage); sl@0: IMPORT_C static TLanguage IdealLanguage(); sl@0: IMPORT_C static void ReleaseIdealLanguage(); sl@0: IMPORT_C static TInt GetSystemDrive(TDriveNumber& aDriveNumber); sl@0: IMPORT_C static TBool PathExists(RFs& aFs,const TDesC& aFileName); sl@0: IMPORT_C static TInt IsFolder(const RFs& aFs, const TDesC& aFullName, TBool& aIsFolder); sl@0: IMPORT_C static TBool FolderExists(RFs& aFs, const TDesC& aFolderName); sl@0: IMPORT_C static TFileName FolderNameFromFullName(const TDesC& aFullName); sl@0: IMPORT_C static TFileName DriveAndPathFromFullName(const TDesC& aFullName); sl@0: IMPORT_C static TFileName RootFolderPath(const TBuf<1> aDriveLetter); sl@0: IMPORT_C static void AbbreviateFileName(const TFileName& aOriginalFileName, TDes& aAbbreviatedFileName); sl@0: IMPORT_C static TBool UidTypeMatches(const TUidType& aFileUid, const TUidType& aMatchUid); sl@0: IMPORT_C static TInt Parse(const TDesC& aName); sl@0: IMPORT_C static TInt ValidateFolderNameTypedByUserL(const RFs& aFs, const TDesC& aFolderNameTypedByUser, const TDesC& aCurrentPath, TFileName& aNewFolderFullName); sl@0: IMPORT_C static TInt CopyFile(RFs& aFs, const TDesC& aSourceFullName, const TDesC& aTargetFullName, TUint aSwitch = CFileMan::EOverWrite); sl@0: IMPORT_C static TInt RenameFile(RFs& aFs, const TDesC& aOldFullName, const TDesC& aNewFullName, TUint aSwitch = CFileMan::EOverWrite); sl@0: IMPORT_C static TInt DeleteFile(RFs& aFs, const TDesC& aSourceFullName, TUint aSwitch = 0); sl@0: IMPORT_C static TInt CheckWhetherFullNameRefersToFolder(const TDesC& aFullName, TBool& aIsFolder); sl@0: IMPORT_C static TInt MostSignificantPartOfFullName(const TDesC& aFullName, TFileName& aMostSignificantPart); sl@0: IMPORT_C static TInt CheckFolder(RFs& aFs, const TDesC& aFolderName); sl@0: IMPORT_C static TInt DiskIsReadOnly(RFs& aFs, const TDesC& aFullName, TBool& aIsReadOnly); sl@0: IMPORT_C static TInt DriveIsReadOnlyInternal(RFs& aFs, const TDesC& aFullName, TBool& aIsReadOnlyInternal); sl@0: IMPORT_C static void GetDiskListL(const RFs& aFs,CDesCArray& aArray); sl@0: IMPORT_C static void UpdateDiskListL(const RFs& aFs,CDesCArray& aArray,TBool aIncludeRom,TDriveNumber aDriveNumber); sl@0: IMPORT_C static void RemoveSystemDirectory(CDir& aDir); sl@0: IMPORT_C static TBool IsFirstDriveForSocket(TDriveUnit aDriveUnit); sl@0: IMPORT_C static TInt SortByTable(CDir& aDir,CBaflFileSortTable* aTable); sl@0: IMPORT_C static void GetDowngradePathL(const RFs& aFs, const TLanguage aCurrentLanguage, RArray& aLanguageArray); sl@0: IMPORT_C static void PersistLocale(); sl@0: IMPORT_C static TInt PersistHAL(); sl@0: IMPORT_C static void PersistScreenCalibration(const TDigitizerCalibration& aScreenCalibration); sl@0: IMPORT_C static void InitialiseScreenCalibration(RFs& aFs); sl@0: IMPORT_C static void InitialiseHAL(RFs& aFs); sl@0: IMPORT_C static void InitialiseLocale(RFs& aFs); sl@0: IMPORT_C static void GetEquivalentLanguageList(TLanguage aLang, TLanguagePath& aEquivalents); sl@0: IMPORT_C static void NearestLanguageFileV2(const RFs& aFs,TFileName& aName, TLanguage& aLanguage); sl@0: sl@0: private: sl@0: static void DoCopyFileL(RFs& aFs, const TDesC& aSourceFullName, const TDesC& aTargetFullName, TUint aSwitch); sl@0: static void DoRenameFileL(RFs& aFs, const TDesC& aOldFullName, const TDesC& aNewFullName, TUint aSwitch); sl@0: static void DoDeleteFileL(RFs& aFs, const TDesC& aSourceFullName, TUint aSwitch); sl@0: }; sl@0: sl@0: sl@0: /** sl@0: * Bafl File Sort Table containing an array of UIDs. sl@0: * @publishedAll sl@0: * @released sl@0: */ sl@0: class CBaflFileSortTable : public CArrayFixFlat sl@0: { sl@0: public: sl@0: IMPORT_C CBaflFileSortTable(); sl@0: IMPORT_C void ConstructFromResourceL(TResourceReader& aReader); sl@0: private: sl@0: enum {EArrayGranularity=4}; sl@0: }; sl@0: sl@0: #endif