/**
 * vim: set ts=4 :
 * ================================================================
 * SourcePawn
 * Copyright (C) 2004-2007 AlliedModders LLC.  All rights reserved.
 * ================================================================
 *
 * This program is free software; you can redistribute it and/or 
 * modify it under the terms of the GNU General Public License, 
 * version 3.0, as published by the Free Software Foundation.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 * As a special exception, AlliedModders LLC gives you permission to 
 * link the code of this program (as well as its derivative works) to 
 * "Half-Life 2," the "Source Engine," the "SourcePawn JIT," and any 
 * Game MODs that run on software by the Valve Corporation.  You must 
 * obey the GNU General Public License in all respects for all other 
 * code used. Additionally, AlliedModders LLC grants this exception 
 * to all derivative works. AlliedModders LLC defines further 
 * exceptions, found in LICENSE.txt (as of this writing, version 
 * JULY-31-2007), or <http://www.sourcemod.net/license.php>.
 *
 * Version: $Id$
 */

#ifndef _INCLUDE_SOURCEPAWN_BASECONTEXT_H_
#define _INCLUDE_SOURCEPAWN_BASECONTEXT_H_

#include "sp_vm_api.h"
#include "sp_vm_function.h"

/**
 * :TODO: Make functions allocate as a lump instead of individual allocations!
 */

namespace SourcePawn
{
	class BaseContext : 
		public IPluginContext,
		public IPluginDebugInfo
	{
	public:
		BaseContext(sp_context_t *ctx);
		~BaseContext();
	public: //IPluginContext
		IVirtualMachine *GetVirtualMachine();
		sp_context_t *GetContext();
		bool IsDebugging();
		int SetDebugBreak(SPVM_DEBUGBREAK newpfn, SPVM_DEBUGBREAK *oldpfn);
		IPluginDebugInfo *GetDebugInfo();
		int HeapAlloc(unsigned int cells, cell_t *local_addr, cell_t **phys_addr);
		int HeapPop(cell_t local_addr);
		int HeapRelease(cell_t local_addr);
		int FindNativeByName(const char *name, uint32_t *index);
		int GetNativeByIndex(uint32_t index, sp_native_t **native);
		uint32_t GetNativesNum();
		int FindPublicByName(const char *name, uint32_t *index);
		int GetPublicByIndex(uint32_t index, sp_public_t **publicptr);
		uint32_t GetPublicsNum();
		int GetPubvarByIndex(uint32_t index, sp_pubvar_t **pubvar);
		int FindPubvarByName(const char *name, uint32_t *index);
		int GetPubvarAddrs(uint32_t index, cell_t *local_addr, cell_t **phys_addr);
		uint32_t GetPubVarsNum();
		int LocalToPhysAddr(cell_t local_addr, cell_t **phys_addr);
		int LocalToString(cell_t local_addr, char **addr);
		int StringToLocal(cell_t local_addr, size_t chars, const char *source);
		int StringToLocalUTF8(cell_t local_addr, size_t maxbytes, const char *source, size_t *wrtnbytes);
		int PushCell(cell_t value);
		int PushCellArray(cell_t *local_addr, cell_t **phys_addr, cell_t array[], unsigned int numcells);
		int PushString(cell_t *local_addr, char **phys_addr, const char *string);
		int PushCellsFromArray(cell_t array[], unsigned int numcells);
		int BindNatives(const sp_nativeinfo_t *natives, unsigned int num, int overwrite);
		int BindNative(const sp_nativeinfo_t *native);
		int BindNativeToAny(SPVM_NATIVE_FUNC native);
		int Execute(uint32_t code_addr, cell_t *result);
		cell_t ThrowNativeErrorEx(int error, const char *msg, ...);
		cell_t ThrowNativeError(const char *msg, ...);
		IPluginFunction *GetFunctionByName(const char *public_name);
		IPluginFunction *GetFunctionById(funcid_t func_id);
#if defined SOURCEMOD_BUILD
		SourceMod::IdentityToken_t *GetIdentity();
		void SetIdentity(SourceMod::IdentityToken_t *token);
		cell_t *GetNullRef(SP_NULL_TYPE type);
		int LocalToStringNULL(cell_t local_addr, char **addr);
#endif
	public: //IPluginDebugInfo
		int LookupFile(ucell_t addr, const char **filename);
		int LookupFunction(ucell_t addr, const char **name);
		int LookupLine(ucell_t addr, uint32_t *line);
	public:
		void SetContext(sp_context_t *_ctx);
	private:
		void SetErrorMessage(const char *msg, va_list ap);
		void FlushFunctionCache();
		void RefreshFunctionCache();
	private:
		sp_context_t *ctx;
#if defined SOURCEMOD_BUILD
		SourceMod::IdentityToken_t *m_pToken;
		cell_t *m_pNullVec;
		cell_t *m_pNullString;
#endif
		char m_MsgCache[1024];
		bool m_CustomMsg;
		bool m_InExec;
		unsigned int m_funcsnum;
#if 0
		CFunction **m_priv_funcs;
#endif
		CFunction **m_pub_funcs;
	};
};

#endif //_INCLUDE_SOURCEPAWN_BASECONTEXT_H_