---
title: "NPC_GetAll | open.mp"
description: "获取所有 NPC ID 并存储在数组中。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_GetAll
language: zh-CN
---

# NPC\_GetAll

注意

这个函数是在omp v1.5.8.3079中添加的，在以前的版本中不起作用！

## 描述

获取所有 NPC ID 并存储到数组中。

| 参数 | 说明 |
| --- | --- |
| npcs\[\] | 存储 NPC ID 的数组，通过引用传递 |
| size | 数组大小 |

## 返回值

返回找到的 NPC 数量。

## 示例

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/countnpcs", true))
    {
        new npcs[MAX_NPCS];
        new count = NPC_GetAll(npcs);

        SendClientMessage(playerid, 0x00FF00FF, "服务器上有 %d 个NPC。", count);

        return 1;
    }
   return 0;
}
```

## 注意事项

备注

-   数组必须足够大以容纳所有 NPC ID。
-   只有有效的 NPC 才会包含在数组中。
-   函数返回实际找到的 NPC 数量。

技巧

使用此函数遍历服务器上的所有 NPC。

## 相关函数

-   [NPC\_Create](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_Create): 创建新 NPC
-   [NPC\_IsValid](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_IsValid): 检查 NPC ID 是否有效
-   [NPC\_Destroy](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_Destroy): 销毁 NPC

## 相关回调

-   [OnNPCCreate](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnNPCCreate): NPC 创建时调用