/*
* Copyright (c) 2008 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 TSTSCHARACTERSETCONVERTER_H
#define TSTSCHARACTERSETCONVERTER_H
// INCLUDES
#include <e32base.h>
// CLASS DECLARATION
/**
* Provides character set conversion and escape character parsing.
* Converts unicode strings which may contain escaped characters to printable
* strings.
*
* @since 3.2
*/
NONSHARABLE_CLASS(TSTSCharacterSetConverter)
{
public: // Constructors and destructor
/**
* C++ default constructor.
*/
TSTSCharacterSetConverter();
public: // New functions
/**
* Converts string from unicode to printable string. String may
* contain escaped sequences as defined in RFC2253. Those
* sequences are parsed.
* If aValue contains characters which are not part of
* PrintableString character set, the method leaves with
* KSTSErrInvalidCharactersInCAName.
* @since 3.2
* @param aValue String to be converted
* @return string containing only PrintableString characters.
* Caller takes ownership.
*
*/
HBufC8* EscapedUnicodeToPrintableLC(const TDesC& aValue) const;
private:
// checks if the given character is "special", i.e. one of:
// ",", "+", """, "\", "<", ">" or ";"
TBool IsSpecial(const TChar& aChar) const;
// checks if the given character is printable, i.e. one of:
// A-Z, a-z, 0-9, space, "'", "(", ")", "+", ",", "-",".","/",":","=","?"
TBool IsPrintable(const TChar& aChar) const;
// Prohibit copy constructor if not deriving from CBase.
TSTSCharacterSetConverter(const TSTSCharacterSetConverter&);
// Prohibit assigment operator if not deriving from CBase.
TSTSCharacterSetConverter& operator=(const TSTSCharacterSetConverter&);
};
#endif // TSTSCHARACTERSETCONVERTER_H
// End of File