---
title: "SetPVarString | open.mp"
description: "将字符串保存到玩家变量中。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPVarString
language: zh-CN
---

# SetPVarString

## 描述

将字符串保存到玩家变量中。

| 参数 | 说明 |
| --- | --- |
| playerid | 要设置变量的玩家 ID |
| const pvar\[\] | 玩家变量名称 |
| const value\[\] | 要保存的字符串值 |
| OPEN\_MP\_TAGS:... | 不定数量的任意标签参数 |

## 返回值

此函数不返回特定值。

## 示例

```c
public OnPlayerConnect(playerid)
{
    new
        hours,
        minutes,
        seconds,
        string[46];

    gettime(hours, minutes, seconds); // 获取当前时间
    format(string, sizeof(string), "连接时间 %02d:%02d:%02d", hours, minutes, seconds); // 创建包含连接时间的字符串
    SetPVarString(playerid, "timeconnected", string); // 将字符串存入玩家变量

    // 专业建议：open.mp中无需使用format
    SetPVarString(playerid, "timeconnected", "连接时间 %02d:%02d:%02d", hours, minutes, seconds);
    return 1;
}
```

## 重要说明

备注

玩家变量在[OnPlayerDisconnect](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnPlayerDisconnect)回调完成后才会重置，因此断开连接时仍可访问变量值。

## 相关函数

-   [SetPVarInt](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPVarInt): 设置整型玩家变量
-   [GetPVarInt](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPVarInt): 获取整型玩家变量值
-   [GetPVarString](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPVarString): 获取字符串玩家变量值
-   [SetPVarFloat](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/SetPVarFloat): 设置浮点型玩家变量
-   [GetPVarFloat](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetPVarFloat): 获取浮点型玩家变量值
-   [DeletePVar](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/DeletePVar): 删除玩家变量