---
title: "GetPVarString | open.mp"
description: "Obtém uma variável de jogador como uma string."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPVarString
language: pt-BR
---

# GetPVarString

## Descrição

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

| Nome | Descrição |
| --- | --- |
| playerid | O ID do jogador cuja variável de jogador será obtida. |
| const pvar\[\] | O nome da variável do jogador, definido por [SetPVarString](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/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

```c
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

nota

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](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPVarString) retornar 0 se esse comportamento for indesejado.

## Funções Relacionadas

-   [SetPVarString](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetPVarString): Defina uma string para uma variável do jogador.
-   [SetPVarInt](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetPVarInt): Defina um número inteiro para uma variável do jogador.
-   [GetPVarInt](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPVarInt): Obtenha o número inteiro definido anteriormente de uma variável do jogador.
-   [SetPVarFloat](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetPVarFloat): Defina um float para uma variável do jogador.
-   [GetPVarFloat](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPVarFloat): Obtenha o float definido anteriormente de uma variável do jogador.
-   [DeletePVar](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/DeletePVar): Exclua uma variável do jogador.