/*

* Copyright (c) 2002-2005 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 TURI_H

#define TURI_H

#include <e32std.h>

/**

 * A generic class for parsing the parts of URI's.

 *

 * NOTE: This uses the folding version of some descriptor methods, which has the

 * undesired affect of removing the distinctions between characters with and without

 * accents, etc. This is not good, but we do not want to implement our own

 * comparison ignoring case.

 */

class TUri : public TPtrC16

{

public:

    static TBool IsUri(const TDesC16& aName);

public:

    TInt Parse(const TDesC16& aDes, TBool aCheckForSlashes = EFalse);

    inline const TDesC16& Scheme() const;

    inline const TDesC16& Host() const;

    inline const TDesC16& Port() const;

    inline const TDesC16& Path() const;

    inline const TDesC16& Query() const;

    inline const TDesC16& Parameters() const;

    TInt PortAsUint(TUint& aPortNum) const;

    TInt GetParameterValue(const TDesC16& aParamName, TBool& aValue) const;

    TInt GetParameterValueInt(const TDesC16& aParamName, TInt& aValue) const;

    TInt GetParameterValue(const TDesC16& aParamName, TPtrC16& aValue) const;

    TInt CheckParameterValidity(const RPointerArray<TDesC16>& aParamNames) const;

    TInt CheckNoDuplicateParameters() const;

private:

    TInt FindParamNameIndex(const TDesC16& aParamName,

                            const TDesC16& aParametersSegment) const;

    TInt CheckParameter(const RPointerArray<TDesC>& aParamNames,

                        const TDesC16& aRemainder) const;

    static TBool MatchParamName(const TDesC16& aName1, const TDesC16& aName2);

    static TBool MatchParamNamePtr(const TPtrC16& aName1, const TPtrC16& aName2);

private:

    TPtrC16 iScheme;

    TPtrC16 iSchemeData;

    TPtrC16 iHost;

    TPtrC16 iPort;

    TPtrC16 iPath;

    TPtrC16 iParameters;

    TPtrC16 iQuery;

};

inline const TDesC16& TUri::Scheme() const

{

    return iScheme;

}

inline const TDesC16& TUri::Host() const

{

    return iHost;

}

inline const TDesC16& TUri::Port() const

{

    return iPort;

}

inline const TDesC16& TUri::Path() const

{

    return iPath;

}

inline const TDesC16& TUri::Query() const

{

    return iQuery;

}

inline const TDesC16& TUri::Parameters() const

{

    return iParameters;

}

#endif // TURI_H