////////////////////////////////////////////////////////////////////////////////
// This source file is part of the ZipArchive library source distribution and
// is Copyrighted 2000 - 2009 by Artpol Software - Tadeusz Dracz
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License
// as published by the Free Software Foundation; either version 2
// of the License, or (at your option) any later version.
// 
// For the licensing details refer to the License.txt file.
//
// Web Site: http://www.artpol-software.com
////////////////////////////////////////////////////////////////////////////////

/**
* \file ZipSplitNamesHandler.h
*	Includes the CZipSplitNamesHandler, CZipRegularSplitNamesHandler and CZipBinSplitNamesHandler class.
*
*/

#if !defined(ZIPARCHIVE_ZIPSPLITNAMESHANDLER_DOT_H)
#define ZIPARCHIVE_ZIPSPLITNAMESHANDLER_DOT_H

#if _MSC_VER > 1000
	#pragma once
	#pragma warning( push )
	#pragma warning (disable : 4100) // unreferenced formal parameter
#endif

#include "_features.h"
#include "ZipString.h"
#include "ZipPathComponent.h"
#include "BitFlag.h"


/**
	Generates and parses names for split archive volumes.
	Base class for split names handlers.
	\see
		<a href="kb">0610051553|splitNames</a>
*/
class ZIP_API CZipSplitNamesHandler
{
	
public:
	/**
		Flags for the #GetVolumeName method.
	*/
	enum Flags
	{
		flNone		= 0x00,	///< No special flags.
		flLast		= 0x01, ///< The volume is the last volume in the archive.
		flExisting	= 0x02	///< The archive is an existing archive.
	};

	/**
		Initializes a new instance of the CZipSplitNamesHandler class.
	*/
	CZipSplitNamesHandler()
	{		

	}

	/**
		Called when opening an archive. 

		\param szArchiveName
			The archive path provided when opening an archive.
	*/
	virtual void Initialize(const CZipString& szArchiveName)
	{

	}

	/**
		Returns the path for the given volume number.

		\param szArchiveName
			The archive path provided when opening an archive.

		\param uCurrentVolume
			The current volume number. The first volume number is \c 1.

		\param flags
			Additional flags. It can be one or more of the #Flags values.
	*/
	virtual CZipString GetVolumeName(const CZipString& szArchiveName, ZIP_VOLUME_TYPE uCurrentVolume, ZipArchiveLib::CBitFlag flags) const = 0;

	/**
		Returns the volume number for the given volume path.

		\param szVolumePath
			The volume path.

		\return
			The volume number parsed from the \a szVolumePath. The first volume number is \c 1. 
			Return \c 0 to indicate an error during parsing.

		\note
			Implementing of this method is only required for a handler for binary split archives.
	*/
	virtual ZIP_VOLUME_TYPE GetVolumeNumber(const CZipString& szVolumePath) const
	{
		// unspecified
		return 0;
	}

	virtual ~CZipSplitNamesHandler()
	{
	}
};


/**
	Generates names for regular split archives.

	\see
		<a href="kb">0610051553|splitNames</a>
*/
class ZIP_API CZipRegularSplitNamesHandler : public CZipSplitNamesHandler
{
protected:
	CZipString m_szExt;
public:
	CZipRegularSplitNamesHandler()
		:m_szExt(_T("zip"))
	{
	}

	void Initialize(const CZipString& szArchiveName)
	{
		CZipPathComponent zpc(szArchiveName);
		m_szExt = zpc.GetFileExt();
	}

	CZipString GetVolumeName(const CZipString& szArchiveName, ZIP_VOLUME_TYPE uCurrentVolume, ZipArchiveLib::CBitFlag flags) const
	{		 
		CZipString szExt;
		if (flags.IsSetAny(CZipSplitNamesHandler::flLast))
			szExt = m_szExt;
		else
		{
			if (uCurrentVolume < 100)
				szExt.Format(_T("z%.2u"), uCurrentVolume);
			else
				szExt.Format(_T("z%u"), uCurrentVolume);
		}
		CZipPathComponent zpc(szArchiveName);
		zpc.SetExtension(szExt);
		return zpc.GetFullPath();
	}	
};

/**
	Generates names for binary split archives.

	\see
		<a href="kb">0610051553|splitNames</a>
*/
class ZIP_API CZipBinSplitNamesHandler : public CZipSplitNamesHandler
{
public:
	CZipString GetVolumeName(const CZipString& szArchiveName, ZIP_VOLUME_TYPE uCurrentVolume, ZipArchiveLib::CBitFlag flags) const
	{
		CZipString szExt;
		if (uCurrentVolume < 1000)
			szExt.Format(_T("%.3u"), uCurrentVolume);
		else
			szExt.Format(_T("%u"), uCurrentVolume);
		if (flags.IsSetAny(CZipSplitNamesHandler::flExisting))
		{
			CZipPathComponent zpc(szArchiveName);
			zpc.SetExtension(szExt);
			return zpc.GetFullPath();
		}
		else
		{
			return szArchiveName + _T(".") + szExt;
		}
	}

	ZIP_VOLUME_TYPE GetVolumeNumber(const CZipString& szArchiveName) const
	{
		CZipPathComponent zpc(szArchiveName);
		CZipString szExt = zpc.GetFileExt();
		szExt.MakeLower();
		if (szExt.GetLength() < 3)
			return 0;
		__int64 ret;
#if !defined __GNUC__ || defined __MINGW32__
		ret = _ttoi64((LPCTSTR)szExt);		
#else
		errno = 0;
		ret = (__int64)strtoll((LPCTSTR)szExt, NULL, 10);
		if (errno != 0)
			return 0;		
#endif
		return (ZIP_VOLUME_TYPE)((ret <= 0 || ret > UINT_MAX) ? 0 : ret);
	}
};

#if _MSC_VER > 1000
	#pragma warning( pop )
#endif

#endif
