/*
* Copyright (c) 2006-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:  MnrpUtils class definition
*
*/


#ifndef MNRP_UTILS_H
#define MNRP_UTILS_H

const TInt KMaxCoordStrSize = 15;

class MnrpUtils
    {
    public:
    
        /** Converts given coordinate into a string 
         *  \param aCoord coordinate
         *  \param aStr target string of KMaxCoordStrSize length (at least)
         *  \param aFull if EFalse, will omit higher parts if they are 0,
         *               if ETrue, outputs degrees, minutes, seconds and milliseconds
         *  \param aMillis whether milliseconds should be included or not
         */
        IMPORT_C static void CoordinateToString( 
            TReal aCoord, 
            TDes& aStr, 
            TBool aFull = EFalse,
            TBool aMillis = EFalse );
            
        /** Converts given distance value to a string with units
         *  \param aDistance distance in meters 
         *  \param aStr target string
         */
        IMPORT_C static void DistanceToString( TReal aDistance, TDes& aStr );

        /** Converts given angle value to a string
         *  \param aAngle angle in degrees (angle form North Pole) 
         *  \param aStr target string
         */
        IMPORT_C static void AngleToString( TReal aAngle, TDes& aStr );

        /** Converts given speed value to a string with units
         *  \param aSpeed speed in meters per second
         *  \param aStr target string
         */
        IMPORT_C static void SpeedToString( TReal aSpeed, TDes& aStr );

        /** Replaces unprintable characters in a string with spaces
         *  \param aStr string to work with
         *  \return pointer to new string buffer with ownership
         */
        IMPORT_C static HBufC* PrintableStringLC( const TDesC& aStr );
    };

#endif // MNRP_UTILS_H