DataPacks

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.

Example of using a DataPack

Syntax:

//writing
DataPack pack = CreateDataPack();
pack.WriteCell(23);
pack.WriteString("I'm a little teapot.");
 
//reading
pack.Reset(); //resets the index to the beginning, necessary for read.
int cellValue = pack.ReadCell();
char buffer[1024];
pack.ReadString(buffer, 1024);

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);