/*

* Copyright (c) 2002 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:  Profiles Engine utils.

*

*/

#ifndef __PROFILEENGUTILS_H

#define __PROFILEENGUTILS_H

//  INCLUDES

#include <e32std.h>

// FORWARD DECLARATIONS

class RFs;

class RWriteStream;

class CRepository;

// CLASS DECLARATION

/**

*  Profiles Engine utils.

*

*  @lib ?library

*  @since 2.0

*/

class ProfileEngUtils

    {

    public: // New functions

        /**

         * Reads alternate service setting value from RSSSettings.

         * @param aValue on return contains the value of the alternate line

         * service setting.

         */

        static void GetAlternateLineService( TInt& aValue );

        /**

         * Checks if the alternate line has been selected.

         * @return ETrue if als is supported and the alternate line has been

         * selected, EFalse otherwise.

         */

        static TBool IsAlternateLineSelected();

        /**

        * Resolves the Central Repository key for the given setting of the

        * given profile.

        * @since 2.8

        * @param aPartialKey is the part of the key which identifies the

        * setting in Central Repository (these keys are defined in Profiles-

        * PrivateCRKeys.h)

        * @param aProfileId is the id of the profile the setting of which

        * the caller is interested in

        * @return the real key to be used with Central Repository

        */

        static TUint32 ResolveKey( TUint aPartialKey, TInt aProfileId );

        /**

        * Gets the binary setting with the given id from Central Repository.

        * This can be used to only read settings that contain strings of

        * elements which length must be != 2 bytes.

        * @since 2.8

        * @param aCenRep reference to a repository containing the needed key

        * @param aId the key of the value to be fetched

        * @param aDes 8-bit buffer which contains the value read from Central

        * Repository on return. If the read value is 2 zero bytes, the

        * buffer will be empty on return.

        */

        static void GetBinarySettingL( CRepository& aCenRep, TUint32 aId,

                                       TDes8& aDes );

        /**

        * Converts 4 bytes from a binary buffer to TUint32.

        * @since 2.8

        * @param aResult is a reference to the integer which will contain the

        * value on return

        * @param aBuf is the buffer from which the 32 bits are read

        * @param aOffset is the offset from which the reading from aBuf should

        * start

        */

        static void GetUint32Presentation( TUint32& aResult,

                                           const TDesC8& aBuf,

                                           TInt aOffset );

        /**

         * Searches for given 8-bit value from a binary value stored in

         * Central Repository.

         * @since 3.0

         * @param aCenRep Central Repository containing the key

         * @param aCenRepKey the key from which the value should be searched

         * @param aValue the 8-bit value to be searched

         * @return the index of the 8-bit value if found, otherwise

         * KErrNotFound.

         */

        static TInt FindValueFromBinaryKeyL( CRepository& aCenRep,

                                             TUint32 aCenRepKey,

                                             TUint8 aValue );

        /**

         * Returns power save mode.

         * @return Power save mode.

         */

        static TBool PowerSaveModeL();

        /**

         * Returns power save mode.

         * @return Power save mode.

         */

        static TBool PowerSaveMode();

    };

#endif      // __PROFILEENGUTILS_H

// End of File