/*

* Copyright (c) 2000-2007 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:  Declaration of SysLangUtil class.

*

*/

#ifndef SYSLANGUTIL_H

#define SYSLANGUTIL_H

#include <e32base.h>

class RFs;

/**

*  Language selection -related utility methods.

*

*  ?more_complete_description

*

*  @lib SysLangUtil.lib

*  @since S60 3.0

*/

class SysLangUtil

    {

public:

    /**

    * Checks if language given as an argument is valid i.e. installed

    * language.

    * @param aLanguage returned Symbian language code matching SIM one.

    * @param aFileServerSession Optional file server session handle. If

    *           omitted, new one will be created.

    * @return ETrue if language is installed, otherwise returns EFalse.

    */

    IMPORT_C static TBool IsValidLanguage(

        const TInt& aLanguage,

        RFs* aFileServerSession = NULL );

    /**

    * Checks and returns the default language in a param given.

    * @param aLanguage  Symbian language as a number

    * @param aFileServerSession Optional file server session handle. If

    *           omitted, new one will be created.

    * @return returns KErrNone if everything went OK, otherwise returns

    *           the errorcode.

    */

    IMPORT_C static TInt GetDefaultLanguage(

        TInt& aLanguage,

        RFs* aFileServerSession = NULL );

    /**

    * Checks and returns installed languages in a param given.

    * @param aLanguages  Symbian languages as a arrayfixflat<int>, ownership

    *           given to user, so user must take care of proper cleanup!

    * @param aFileServerSession Optional file server session handle. If

    *           omitted, new one will be created.

    * @return returns KErrNone if everything went OK, otherwise returns

    *           the errorcode.

    */

    IMPORT_C static TInt GetInstalledLanguages(

        CArrayFixFlat<TInt>*& aLanguages,

        RFs* aFileServerSession = NULL );

    /**

    * Returns SIM preferred languages in a param given.

    * @param aLanguage Language that was stored in flash file system

    * @param aFileServerSession Optional file server session handle. If

    *           omitted, new one will be created.

    * @return returns KErrNone if everything went OK, otherwise returns

    *           the errorcode.

    */

    IMPORT_C static TInt RestoreSIMLanguage(

        TInt &aLanguage,

        RFs* aFileServerSession = NULL );

private:

    // Utility:

    static RFs* CheckFS( RFs* aRFs, TBool &aExist, TInt &aErr );

    };

#endif // SYSLANGUTIL_H