---
title: cvmmul
description: "复数向量与复数矩阵的行或列乘法运算。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengaccel/system-lib/ug-kvsip/kunpengaccel_kvsip_06_0083.html
sourcePath: /source/zh/kunpengaccel/system-lib/ug-kvsip/kunpengaccel_kvsip_06_0083.html
indexId: 9f44f78b62fb9d4a0abd86ae5e6be789d0f2d844e356d4166c0b54e8266b284575
---
# cvmmul

复数向量与复数矩阵的行或列乘法运算。

函数接口声明如下：

float型函数操作：

void (vsip_cvmmul_f)(const vsip_cvview_f *a, const vsip_cmview_f *B, vsip_major major, const vsip_cmview_f *R);

#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| a | 指向源复数向量的指针。 | 非空 | 输入 |
| B | 指向源复数矩阵的指针。 | 非空 | 输入 |
| major | 按行或列向量运算。 | 枚举vsip\_major，选项： VSIP\_ROW：行运算 VSIP\_COL：列运算 | 输入 |
| R | 指向目标复数矩阵的指针。 | 非空 | 输出 |


#### 异常输入

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


#### 示例

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

void CvmmulExample()
{
    int32_t row = 4;
    int32_t col = 3;
    int64_t rowStride = 1;
    int64_t colStride = row * rowStride;
    uint64_t offset = 0;
    vsip_major major = VSIP_ROW;
    int32_t cvLen = 2 * (row * rowStride + offset);
    int32_t cmLen = 2 * (col * colStride + offset);
    float *src1 = (float *)malloc(cvLen * sizeof(float));
    float *src2 = (float *)malloc(cmLen * sizeof(float));
    float *dst = (float *)malloc(cmLen * sizeof(float));
    for (int32_t i = 0; i < cvLen; ++i) {
        src1[i] = 1 + i / 100.0f;
    }
    for (int32_t i = 0; i < cmLen; ++i) {
        src2[i] = 2 + i / 100.0f;
    }

    vsip_cblock_f *block_a = vsip_cblockbind_f(src1, NULL, cvLen, VSIP_MEM_NONE);
    vsip_cblock_f *block_b = vsip_cblockbind_f(src2, NULL, cmLen, VSIP_MEM_NONE);
    vsip_cblock_f *block_r = vsip_cblockbind_f(dst, NULL, cmLen, VSIP_MEM_NONE);

    vsip_cvview_f *a = vsip_cvbind_f(block_a, offset, rowStride, cvLen);
    vsip_cblockadmit_f(block_a, VSIP_TRUE);
    vsip_cmview_f *B = vsip_cmbind_f(block_b, offset, colStride, col, rowStride, row);
    vsip_cblockadmit_f(block_b, VSIP_TRUE);
    vsip_cmview_f *R = vsip_cmbind_f(block_r, offset, colStride, col, rowStride, row);
    vsip_cblockadmit_f(block_r, VSIP_TRUE);

    vsip_cvmmul_f(a, B, major, R);

    vsip_cvalldestroy_f(a);
    vsip_cmalldestroy_f(B);
    vsip_cmalldestroy_f(R);

    printf("src1:\n");
    for (int32_t i = 0; i < row; ++i) {
        printf("%.5f ", src1[i * 2]);
        printf("%.5f    ", src1[i * 2 + 1]);
    }

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

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

运行结果：

```
src1:
1.00000 1.01000    1.02000 1.03000    1.04000 1.05000    1.06000 1.07000

src2:
2.00000 2.01000    2.02000 2.03000    2.04000 2.05000    2.06000 2.07000
2.08000 2.09000    2.10000 2.11000    2.12000 2.13000    2.14000 2.15000
2.16000 2.17000    2.18000 2.19000    2.20000 2.21000    2.22000 2.23000

dst:
-0.03010 4.03000    -0.03050 4.15120    -0.03090 4.27400    -0.03130 4.39840
-0.03090 4.19080    -0.03130 4.31520    -0.03170 4.44120    -0.03210 4.56880
-0.03170 4.35160    -0.03210 4.47920    -0.03250 4.60840    -0.03290 4.73920
```
