Pular para o conteúdo principal

GetPVarString

Descrição​

Obtém uma variável de jogador como uma string.

NomeDescrição
playeridO ID do jogador cuja variável de jogador será obtida.
const pvar[]O nome da variável do jogador, definido por SetPVarString.
output[]A matriz na qual armazenar o valor da string, passada por referência.
len = sizeof (output)O comprimento máximo da string retornada.

Retornos​

O comprimento da string.

Exemplos​

public OnPlayerConnect(playerid,reason)
{
    new playerName[MAX_PLAYER_NAME];
    GetPlayerName(playerid, playerName, MAX_PLAYER_NAME);
    SetPVarString(playerid, "PlayerName", playerName);
    return 1;
}

public OnPlayerDeath(playerid, killerid, WEAPON:reason)
{
    new playerName[MAX_PLAYER_NAME];
    GetPVarString(playerid, "PlayerName", playerName, sizeof(playerName));

    printf("%s died.", playerName);
}

Notas​

dica

Se o comprimento da string for zero (valor não definido), o texto output não será atualizado ou definido como nada e permanecerá com os dados antigos, sendo necessário limpar a variável para o valor em branco se GetPVarString retornar 0 se esse comportamento for indesejado.

Funções Relacionadas​

  • SetPVarString: Defina uma string para uma variável do jogador.
  • SetPVarInt: Defina um número inteiro para uma variável do jogador.
  • GetPVarInt: Obtenha o número inteiro definido anteriormente de uma variável do jogador.
  • SetPVarFloat: Defina um float para uma variável do jogador.
  • GetPVarFloat: Obtenha o float definido anteriormente de uma variável do jogador.
  • DeletePVar: Exclua uma variável do jogador.