amxmodx/plugins/include/datapack.inc

139 lines
3.4 KiB
PHP
Raw Normal View History

// vim: set ts=4 sw=4 tw=99 noet:
//
// AMX Mod X, based on AMX Mod by Aleksander Naszko ("OLO").
// Copyright (C) The AMX Mod X Development Team.
//
// This software is licensed under the GNU General Public License, version 3 or higher.
// Additional exceptions apply. For full license details, see LICENSE.txt or visit:
// https://alliedmods.net/amxmodx-license
2014-04-11 20:57:42 +00:00
#if defined _datapack_included
#endinput
#endif
#define _datapack_included
/**
* DataPacks are a way to store and move around various types of data in AMX Mod X Scripting.
* Since some things are not possible in AMX Mod X, such as a function consuming a String,
* DataPacks help us get these Strings and other items where they need to go.
*/
enum DataPack
{
Invalid_DataPack = 0
};
/**
* Creates a new data pack.
*
* @return A Handle to the data pack.
*/
native DataPack:CreateDataPack();
/**
* Packs a normal cell into a data pack.
*
* @param pack Handle to the data pack.
* @param cell Cell to add.
* @noreturn
* @error Invalid handle.
*/
native WritePackCell(DataPack:pack, any:cell);
2014-04-11 20:57:42 +00:00
/**
* Packs a float into a data pack.
*
* @param pack Handle to the data pack.
* @param val Float to add.
* @noreturn
* @error Invalid handle.
*/
native WritePackFloat(DataPack:pack, Float:val);
/**
* Packs a string into a data pack.
*
* @param pack Handle to the data pack.
* @param str String to add.
* @return Length of copied string.
* @error Invalid handle.
*/
native WritePackString(DataPack:pack, const str[]);
/**
* Reads a cell from a data pack.
*
* @param pack Handle to the data pack.
* @return Cell value.
* @error Invalid handle, or bounds error.
*/
native any:ReadPackCell(DataPack:pack);
2014-04-11 20:57:42 +00:00
/**
* Reads a float from a data pack.
*
* @param pack Handle to the data pack.
* @return Float value.
* @error Invalid handle, or bounds error.
*/
native Float:ReadPackFloat(DataPack:pack);
/**
* Reads a string from a data pack.
*
* @param pack Handle to the data pack.
* @param buffer Destination string buffer.
* @param maxlen Maximum length of output string buffer.
* @return Length of output string.
* @error Invalid handle, or bounds error.
*/
native ReadPackString(DataPack:pack, buffer[], maxlen);
/**
* Resets the position in a data pack.
*
* @param pack Handle to the data pack.
* @param clear If true, clears the contained data.
* @noreturn
* @error Invalid handle.
*/
native ResetPack(DataPack:pack, bool:clear=false);
/**
* Returns the read or write position in a data pack.
*
* @param pack Handle to the data pack.
* @return Numerical position in the data pack.
* @error Invalid handle.
*/
native GetPackPosition(DataPack:pack);
/**
* Sets the read/write position in a data pack.
*
* @param pack Handle to the data pack.
* @param position New position to set.
* @noreturn
* @error Invalid handle, or position is beyond the pack bounds.
*/
native SetPackPosition(DataPack:pack, position);
/**
* Returns whether or not a specified number of bytes from the data pack
* position to the end can be read.
*
* @param pack Handle to the data pack.
* @param bytes Number of bytes to simulate reading.
* @return True if can be read, false otherwise.
* @error Invalid handle.
*/
native bool:IsPackReadable(DataPack:pack, bytes);
/**
* Disposes of a data pack.
*
* @param pack Handle to the data pack.
* @return True if disposed, false otherwise.
*/
native DestroyDataPack(&DataPack:pack);