---
title: kupl_egroup_create
description: "创建kupl egroup，即kupl executor的集合。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/KunpengHPCKit_developer_024.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/KunpengHPCKit_developer_024.html
indexId: d2a9925c7c3ca5547aef31a580b7d02ab44a4d975999f8bf9efd614d8558dc8a67
---
# kupl_egroup_create

创建kupl egroup，即kupl executor的集合。

#### 接口定义

kupl_egroup_h kupl_egroup_create(int *executors, int executors_num);


#### 参数


**表1 参数定义**

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| executors | int \* | 组成egroup的executor，具体参数传入方式为将需要构成集合的执行器的编号赋值给该数组 约束：0≤executors[i]≤kupl\_get\_num\_executors() | 输入 |
| executors\_num | int | egroup中executor数量 约束：0≤executors\_num≤kupl\_get\_num\_executors() | 输入 |


#### 返回值

- 成功：返回创建的egroup
- 失败：返回nullptr


#### 示例

```
#include <stdio.h> 
#include "kupl.h" 

int main() 
{ 
    int executor_num = kupl_get_num_executors(); 
    int executors[executor_num]; 
    for (int i =0; i < executor_num; i++) {
        executors[i] = i;
    } 
    kupl_egroup_h egroup = kupl_egroup_create(executors, executor_num);
    kupl_egroup_destroy(egroup); 
    return 0; 
}
```

上述示例演示了创建、销毁一个egroup的流程。kupl_egroup_create函数创建了一个包含所有executor执行器的egroup。