---
title: "GetConsoleVarAsString | open.mp"
description: "获取控制台变量的字符串类型值。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetConsoleVarAsString
language: zh-CN
---

# GetConsoleVarAsString

## 描述

获取控制台变量的字符串类型值。

| 参数 | 说明 |
| --- | --- |
| const cvar\[\] | 要获取的字符串类型控制台变量名称 |
| buffer\[\] | 存储值的数组变量（引用传递） |
| len（数组长度） | 存储字符串的缓冲区长度 |

## 返回值

返回字符串的实际长度。若变量不存在或类型不符返回 0。

## 示例代码

```c
public OnGameModeInit()
{
    new hostname[64];
    GetConsoleVarAsString("hostname", hostname, sizeof(hostname));  // 获取服务器名称
    printf("服务器名称: %s", hostname);  // 输出字符串值
}
```

## 注意事项

备注

当变量名为"filterscripts"或"plugins"时，此函数仅返回第一个滤镜脚本/插件的名称。

技巧

在服务器控制台输入 `varlist` 可查看所有可用控制台变量及其类型。

注意

-   在旧版本中，对非字符串类型变量（整型/布尔型/浮点型）使用此函数会导致服务器崩溃（open.mp 已修复）
-   在旧版本中，对不存在的变量使用此函数会导致服务器崩溃（open.mp 已修复）

## 相关函数

-   [GetConsoleVarAsInt](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetConsoleVarAsInt): 以整型形式获取控制台变量
-   [GetConsoleVarAsBool](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetConsoleVarAsBool): 以布尔值形式获取控制台变量