---
title: "GetPVarString | open.mp"
description: "یه متغیر بازیکن رو به صورت string دریافت می‌کنه."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/GetPVarString
language: fa
---

# GetPVarString

## توضیحات

یه متغیر بازیکن رو به صورت string دریافت می‌کنه.

| نام | توضیحات |
| --- | --- |
| playerid | ID بازیکنی که می‌خوای متغیرش رو دریافت کنی. |
| const pvar\[\] | اسم متغیر بازیکن که توسط [SetPVarString](https://omp.itsneufox.com/fa/docs/scripting/functions/SetPVarString) تنظیم شده. |
| output\[\] | آرایه‌ای برای ذخیره مقدار string که به صورت reference پاس داده می‌شه. |
| len = sizeof (output) | حداکثر طول string برگردونده شده. |

## مقادیر برگشتی

طول string.

## مثال‌ها

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

## نکات

یادداشت

اگه طول string صفر باشه (مقدار تنظیم نشده)، متن `output` آپدیت یا تنظیم نمی‌شه و با داده‌های قدیمی باقی می‌مونه، که اگه این رفتار مطلوب نیست، باید متغیر رو صاف کنی اگه [GetPVarString](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPVarString) صفر برگردونه.

## توابع مرتبط

-   [SetPVarString](https://omp.itsneufox.com/fa/docs/scripting/functions/SetPVarString): تنظیم یه string برای متغیر بازیکن.
-   [SetPVarInt](https://omp.itsneufox.com/fa/docs/scripting/functions/SetPVarInt): تنظیم یه integer برای متغیر بازیکن.
-   [GetPVarInt](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPVarInt): دریافت integer قبلاً تنظیم شده از متغیر بازیکن.
-   [SetPVarFloat](https://omp.itsneufox.com/fa/docs/scripting/functions/SetPVarFloat): تنظیم یه float برای متغیر بازیکن.
-   [GetPVarFloat](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPVarFloat): دریافت float قبلاً تنظیم شده از متغیر بازیکن.
-   [DeletePVar](https://omp.itsneufox.com/fa/docs/scripting/functions/DeletePVar): حذف یه متغیر بازیکن.