/*

* ==============================================================================

* Copyright (c) 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:

*

* ==============================================================================

*/

#ifndef UTILS_H_

#define UTILS_H_

// ------------------------------------------------------------------------------------------------

// Includes

// ------------------------------------------------------------------------------------------------

#include "ConnMoAdapter.h"

class TLuid;

/**

 * Utilities class for ConnMo adapter needs

 * 

 * Class contains useful helper functions etc. for parsing URI and TLuid

 */

class CUtils : public CBase

    {

public:

    virtual ~CUtils();

    /**

     * Returns first segment of URI.

     * 

     * @param aUri URI to be searched.

     * @return First segment of URI.

     */

    static TPtrC8 GetFirstURISeg( const TDesC8& aURI );

    /**

     * Returns second segment of URI.

     * 

     * @param aUri URI to be searched.

     * @return Second segment of URI.

     */

    static TPtrC8 GetSecondURISeg( const TDesC8& aURI );

    /**

     * Returns last segment of URI.

     * 

     * @param aUri URI to be searched.

     * @return Last segment of URI.

     */

    static TPtrC8 GetLastURISeg( const TDesC8& aURI );

    /**

     * Returns the end of URI starting from passed segment.

     * 

     * @param aUri URI to be parsed.

     * @param aName Segment to start.

     * @return End of URI starting from aName.

     */

    static TPtrC8 GetEndOfURIFromSeg( const TDesC8& aURI, const TDesC8& aName );

    /**

     * This function converts string value to 8-bit value.

     * 

     * @param aSource String to convert.

     * @return Pointer to 8-bit value.

     */

    static TDesC8& ConvertTo8LC( const TDesC& aSource );

    /**

     * This function converts string value to 16-bit value.

     * 

     * @param aSource String to convert.

     * @return Pointer to 16-bit value.

     */

    static TDesC16& ConvertTo16LC( const TDesC8& aSource );

    /**

     * This function sets given information to given node.

     * 

     * @param aNode Target node.

     * @param aAccTypes Node's access types.

     * @param aOccurrence Amount of possible nodes of same type.

     * @param aScope Describes if node is static or dynamic.

     * @param aFormat Node's format.

     * @param aDescription String containing description of the node.

     * @return Pointer integer value.

     */

    static void FillNodeInfoL( MSmlDmDDFObject& aNode,

                               TSmlDmAccessTypes aAccTypes,

                               MSmlDmDDFObject::TOccurence aOccurrence, 

                               MSmlDmDDFObject::TScope aScope, 

                               MSmlDmDDFObject::TDFFormat aFormat,

                               const TDesC8& aDescription);

    /**

     * This function removes characters that are not allowed in URI from given descriptor.

     * 

     * @param aString String to be modified.

     */

    static void RemoveIllegalCharsFromURI( TDes8& aString );

    /**

     * This function returns string as bool value.

     * 

     * @param aSource String to convert.

     * @param aBool conversion result.

     * @return TInt32 KErrNone if succesful conversion.

     */

    static TInt32 DesToBool( const TDesC8& aString, TBool& aBool );

    /**

     * This function convert integer value to string presentation.

     * 

     * @param aObject Int value to convert.

     * @return TDesC8& Int as string.

     */

    static TDesC8& IntToCharL( const TInt& aObject );

    /**

     * This function takes first segment from uri and adds it to target

     * 

     * @param aURI Contains source uri.

     * @param aTarget Target string.

     * @return TInt Index of first uri delimiter.

     */

    static TInt AppendFirstURISeg( TDes8& aURI, TDes8& aTarget );

    static TInt IntLUID(const TDesC8& aLUID);

private:

    //-----------------------------------------------------------------------------

    // Private functions

    //-----------------------------------------------------------------------------

    CUtils();

    //-----------------------------------------------------------------------------

    // Private member variables

    //-----------------------------------------------------------------------------

    };

#endif /* UTILS_H_ */