---
title: "GetPVarString | open.mp"
description: "Gets a player variable as a string."
canonical: https://omp.itsneufox.com/docs/scripting/functions/GetPVarString
language: en
---

# GetPVarString

## Description

Gets a player variable as a string.

| Name | Description |
| --- | --- |
| playerid | The ID of the player whose player variable to get. |
| const pvar\[\] | The name of the player variable, set by [SetPVarString](https://omp.itsneufox.com/docs/scripting/functions/SetPVarString). |
| output\[\] | The array in which to store the string value in, passed by reference. |
| len = sizeof (output) | The maximum length of the returned string. |

## Returns

The length of the string.

## Examples

```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);
}
```

## Notes

note

-   Variables aren't reset until after [OnPlayerDisconnect](https://omp.itsneufox.com/docs/scripting/callbacks/OnPlayerDisconnect) is called, so the values are still accessible in OnPlayerDisconnect.
-   If length of string is zero (value not set), `output` 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](https://omp.itsneufox.com/docs/scripting/functions/GetPVarString) returns 0 if that behavior is undesired.

## Related Functions

-   [SetPVarString](https://omp.itsneufox.com/docs/scripting/functions/SetPVarString): Set a string for a player variable.
-   [SetPVarInt](https://omp.itsneufox.com/docs/scripting/functions/SetPVarInt): Set an integer for a player variable.
-   [GetPVarInt](https://omp.itsneufox.com/docs/scripting/functions/GetPVarInt): Get the previously set integer from a player variable.
-   [SetPVarFloat](https://omp.itsneufox.com/docs/scripting/functions/SetPVarFloat): Set a float for a player variable.
-   [GetPVarFloat](https://omp.itsneufox.com/docs/scripting/functions/GetPVarFloat): Get the previously set float from a player variable.
-   [DeletePVar](https://omp.itsneufox.com/docs/scripting/functions/DeletePVar): Delete a player variable.