GetPVarString

From SA-MP Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 07:59, 30 November 2014
Threshold (Talk | contribs)

← Previous diff
Revision as of 06:54, 12 October 2016
JernejL (Talk | contribs)

Next diff →
Line 10: Line 10:
{{Returns|The length of the string.}} {{Returns|The length of the string.}}
 +
 +{{Notes|
 +* If length of string is zero (value not set), string_return text will not be updated or set to anything and will remain with old data, neccesying that you clear the variable to blank value if GetPVarString returns 0 if that behavior is undesired
 +}}
'''Example: Save the player's name in a pVar''' '''Example: Save the player's name in a pVar'''

Revision as of 06:54, 12 October 2016



Description:

Gets a player variable as a string.


Parameters:
(playerid, varname[], string_return[], len)
playeridThe ID of the player whose player variable to get.
varnameThe name of the player variable, set by SetPVarString.
&string_returnThe array in which to store the string value in, passed by reference.
lenThe maximum length of the returned string.


Return Values:

The length of the string.


Image:32px-Ambox_warning_orange.png

Notes

  • If length of string is zero (value not set), string_return text will not be updated or set to anything and will remain with old data, neccesying that you clear the variable to blank value if GetPVarString returns 0 if that behavior is undesired


Example: Save the player's name in a pVar

public OnPlayerConnect(playerid,reason)
{
    new playerName[MAX_PLAYER_NAME+1];
    GetPlayerName(playerid, playerName, MAX_PLAYER_NAME);
    SetPVarString(playerid, "PlayerName", playerName);
    return 1;
}
 
public OnPlayerDeath(playerid, killerid, reason)
{
    new playerName[MAX_PLAYER_NAME+1];
    GetPVarString(playerid, "PlayerName", playerName, sizeof(playerName));
 
    printf("%s died.", playerName);
}

Related Functions

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

  • SetPVarInt: Set an integer for a player variable.
  • GetPVarInt: Get the previously set integer from a player variable.
  • GetPVarFloat: Get the previously set float from a player variable.
Personal tools