GetPlayerVersion

From SA-MP Wiki

Jump to: navigation, search

GetPlayerVersion was added in SA-MP 0.3e This function was added in SA-MP 0.3e and will not work in earlier versions!


Description:

Returns the SA-MP client version, as reported by the player.


Parameters:
(playerid, version[], len)
playeridThe ID of the player to get the client version of.
version[]The string to store the player's version in, passed by reference.
lenThe maximum length of the version.


Return Values:

The length of the player's client version. 0 if player specified doesn't exist.
  • The client version is stored in the specified array.


Image:32px-Ambox_warning_orange.png

Note

A client's version can be up to 24 characters long, otherwise the connection will be rejected due to "Invalid client connection". However, normal players can only join with a version length between 5 (0.3.7) and 9 (0.3.DL-R1) characters.


Image:32px-Circle-style-warning.png

Important
Note

The string the version gets stored in will be empty if playerid is an NPC.


Example Usage:

public OnPlayerConnect(playerid)
{
    new string[24];
    GetPlayerVersion(playerid, string, sizeof(string));
    format(string, sizeof(string), "Your version of SA-MP: %s", string);
    SendClientMessage(playerid, 0xFFFFFFFF, string);
    // possible text: "Your version of SA-MP: 0.3.7"
    return 1;
}

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

Personal tools
In other languages