---
title: cmfill
description: "复数矩阵的填充运算。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengaccel/system-lib/ug-kvsip/kunpengaccel_kvsip_06_0082.html
sourcePath: /source/zh/kunpengaccel/system-lib/ug-kvsip/kunpengaccel_kvsip_06_0082.html
indexId: 305f4b596cd8ac06d510b679a9a3134b06d33635175887f828f88e4cea03052f75
---
# cmfill

复数矩阵的填充运算。

函数接口声明如下：

float型函数操作：

void (vsip_cmfill_f)(vsip_cscalar_f alpha, const vsip_cmview_f *r);

#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| alpha | 标量复数。 | 不限 | 输入 |
| r | 指向目标复数矩阵的指针。 | 非空 | 输出 |


#### 异常输入

空指针输入时，函数直接返回。


#### 示例

```
#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include "kvsip.h"
#include "vsip.h"
#include "vsip_type.h"

void CmfillExample()
{
    vsip_cscalar_f alpha = {1.1f, -1.2f};
    int32_t row = 4;
    int32_t col = 3;
    int64_t rowStride = 1;
    int64_t colStride = row * rowStride;
    uint64_t offset = 0;
    int32_t len = 2 * (col * colStride + offset);
    float *dst = (float *)malloc(len * sizeof(float));

    vsip_cblock_f *block_r = vsip_cblockbind_f(dst, NULL, len, VSIP_MEM_NONE);
    vsip_cmview_f *r = vsip_cmbind_f(block_r, offset, colStride, col, rowStride, row);
    vsip_cblockadmit_f(block_r, VSIP_TRUE);

    vsip_cmfill_f(alpha, r);

    vsip_cmalldestroy_f(r);

    printf("alpha: %.2f %.2f\n", alpha.r, alpha.i);
    printf("dst:\n");
    for (int32_t i = 0; i < col; ++i) {
        for (int32_t j = 0; j < row; ++j) {
            printf("%.2f ", dst[i * row * 2 + j * 2]);
            printf("%.2f    ", dst[i * row * 2 + j * 2 + 1]);
        }
        printf("\n");
    }
    free(dst);
}

int main(void) {
    CmfillExample();
    return 0;
}
```

运行结果：

```
alpha: 1.10 -1.20
dst:
1.10 -1.20    1.10 -1.20    1.10 -1.20    1.10 -1.20
1.10 -1.20    1.10 -1.20    1.10 -1.20    1.10 -1.20
1.10 -1.20    1.10 -1.20    1.10 -1.20    1.10 -1.20
```