From SA-MP Wiki

Jump to: navigation, search


Image:Farm-Fresh text lowercase.png Note: This function name starts with a lowercase letter.


Convert an integer into a string.

(dest[], value, bool:pack=false)
destThe destination of the string.
valueThe value to convert to a string.
pack (optional)Whether to pack the destination (off by default).

Return Values:

This function does not return any specific values.

Example Usage:

new string[4];
new iValue = 250;
valstr(string,iValue); // string is now "250"


Passing a high value to this function can cause the server to freeze/crash. Fixes are available. Below is a fix that can be put straight in to your script (before valstr is used anywhere). includes this fix.
// valstr fix by Slice
stock FIX_valstr(dest[], value, bool:pack = false)
    // format can't handle cellmin properly
    static const cellmin_value[] = !"-2147483648";
    if (value == cellmin)
        pack && strpack(dest, cellmin_value, 12) || strunpack(dest, cellmin_value, 12);
        format(dest, 12, "%d", value), pack && strpack(dest, dest, 12);
#define valstr FIX_valstr

Related Functions

The following functions may be helpful as they relate to this function in one way or another.

  • strval: Convert a string into an integer.
  • strcmp: Compare two strings to check if they are the same.