DataPacks

From AlliedModders Wiki
Revision as of 17:49, 5 March 2008 by DaRk NiGhT (talk | contribs) (New page: DataPacks are a way to store and move around various types of data in SourceMod Scripting. Since some things are not possible in SourcePawn, such as a fun...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

DataPacks are a way to store and move around various types of data in SourceMod Scripting. Since some things are not possible in SourcePawn, such as a function consuming a String, DataPacks help us get these Strings and other items where they need to go.

Creating a DataPack

Creating a DataPack is very simple; all you need is a Handle to write to.

new Handle:dataPackHandle = CreateDataPack();

For more information on using Handles, see Handle API (SourceMod).

DataPack Functions

On you have created your DataPack, you can use a variety of functions to manage the DataPack.

WritePackCell

Syntax:

native WritePackCell(Handle:pack, cell);

WritePackFloat

This function can be used to write a Float to a DataPack.

Syntax:

native WritePackFloat(Handle:pack, Float:val);

WritePackString

This function can be used to write a String to a DataPack.

Syntax:

native WritePackString(Handle:pack, const String:str[]);

ReadPackCell

Syntax:

native ReadPackCell(Handle:pack);

ReadPackFloat

This function can be used to read a Float from a DataPack.

Syntax:

native Float:ReadPackFloat(Handle:pack);

ReadPackString

This function can be used to read a String from a DataPack.

Syntax:

native ReadPackString(Handle:pack, String:buffer[], maxlen);

ResetPack

This function resets your position in the DataPack.

Syntax:

native ResetPack(Handle:pack, bool:clear=false);

GetPackPosition

This function gets your current position in the DataPack.

Syntax:

native GetPackPosition(Handle:pack);

SetPackPosition

This function sets your current position in the DataPack.

Syntax:

native SetPackPosition(Handle:pack, position);

Disposing of a DataPack

To dispose of a DataPack, all you have to do is close its Handle.

Example:

CloseHandle(dataPackHandle);