/*
* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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: 
* Note: This file may contain code to generate corrupt files for test purposes.
* Such code is excluded from production builds by use of compiler defines;
* it is recommended that such code should be removed if this code is ever published publicly.
* various utility functions
*
*/


/**
 @file 
 @internalComponent
 @released
*/

#ifndef __UTILS_H_
#define __UTILS_H_

// ===========================================================================
// INCLUDES
// ===========================================================================

#include "utility_interface.h"
#include <wchar.h>
#include "basetype.h"
#include <iostream>
 

enum TUtilsException
	{ErrNotEnoughMemory	=-1,
	ErrCannotOpenFile	=-2,
	ErrCannotReadFile	=-3,
	ErrCannotWriteFile	=-4,
	ErrCannotConvertFile=-5,
	ErrCertFileKeyFileMismatch = -6};

enum TEncodingScheme
	{
	EAscii	= 0,
	EUtf8	= 1,
	EUcs2LE	= 2,
	EUcs2BE	= 3,
	};

// ===========================================================================
// GLOBAL FUNCTIONS
// ===========================================================================

// is a file unicode
bool FileIsUnicode(LPCWSTR fileName, TEncodingScheme& encScheme);
// create a temporary file which is a UCS2 little endian UNICODE version of a
// big endian UNICODE file
LPWSTR ConvertUCS2FileToLittleEndianUnicode(LPCWSTR fileName);
// create a temporary file which is a UCS4 little endian UNICODE version of a
// big endian UNICODE file 
LPWSTR	ConvertUCS4FileToLittleEndianUnicode(LPCWSTR fileName);
// create a temporary file which is a UNICODE version of an MBCS file
LPWSTR ConvertFileToUnicode(LPCWSTR fileName, TEncodingScheme encScheme);
// get a temporary filename (in c:\temp\mks???\ with given file name)
LPWSTR TempFileName();
// Verifies if given buffer has correct UTF8 encoding
bool CorrectUTF8(LPSTR pNarrowBuf, DWORD dwNumBytes);
// Convert UCS2 file to UCS4 format
LPWSTR ConvertUCS2FileToUCS4(LPCWSTR fileName);

#endif