v?acos

计算输入弧度的反余弦值，输入为向量。

接口定义

C interface：

void vsacos(const int len, const float* src, float* dst);

void vdacos(const int len, const double* src, double* dst);

void vcacos(const int len, const float complex *src, float complex *dst);

void vzacos(const int len, const double complex *src, double complex *dst);

参数

参数名	类型	描述	输入/输出
len	整型数	表示输入向量的元素个数。 len≤0时会提示len无效并返回。	输入
src	在vsacos中是单精度浮点类型。在vdacos中是双精度浮点类型。在vcacos中是复数单精度浮点类型。在vzacos中是复数双精度浮点类型。	输入向量src，向量长度为len。若为空指针，会提示空指针错误并返回。	输入
dst	在vsacos中是单精度浮点类型。在vdacos中是双精度浮点类型。在vcacos中是复数单精度浮点类型。在vzacos中是复数双精度浮点类型。	输出dst，向量长度为len。若为空指针，会提示空指针错误并返回。	输出

参数名

类型

描述

输入/输出

len

整型数

表示输入向量的元素个数。

len≤0时会提示len无效并返回。

输入

src

在vsacos中是单精度浮点类型。
在vdacos中是双精度浮点类型。
在vcacos中是复数单精度浮点类型。
在vzacos中是复数双精度浮点类型。

输入向量src，向量长度为len。

若为空指针，会提示空指针错误并返回。

输入

dst

在vsacos中是单精度浮点类型。
在vdacos中是双精度浮点类型。
在vcacos中是复数单精度浮点类型。
在vzacos中是复数双精度浮点类型。

输出dst，向量长度为len。

若为空指针，会提示空指针错误并返回。

输出

输出结果

返回余弦值x的反余弦函数值y，x ∈ [-1, +1]。

vsacos和vdacos其他特殊值参考如下说明。

输入值（src）	输出值（dst）
±inf	nan
nan	nan
+1	+0
-1	+pi
\|x\|>1	nan

vcacos和vzacos其他特殊值参考如下说明。

输入值实部（src.real）	输入值虚部（src.imag）	输出值实部（dst.real）	输出值虚部（dst.imag）
0	0	pi/2	0
0	0	pi/2	0
0	inf	pi/2	-inf
0	-inf	pi/2	inf
0	snan	pi/2	nan
0	-snan	pi/2	nan
0	qnan	pi/2	nan
0	-qnan	pi/2	nan
0	0	pi/2	0
0	0	pi/2	0
0	inf	pi/2	-inf
0	-inf	pi/2	inf
0	snan	pi/2	nan
0	-snan	pi/2	nan
0	qnan	pi/2	nan
0	-qnan	pi/2	nan
inf	0	0	-inf
inf	0	0	inf
inf	inf	pi/4	-inf
inf	-inf	pi/4	inf
inf	snan	nan	-inf
inf	-snan	nan	-inf
inf	qnan	nan	-inf
inf	-qnan	nan	-inf
-inf	0	pi	-inf
-inf	0	pi	inf
-inf	inf	3*pi/4	-inf
-inf	-inf	3*pi/4	inf
-inf	snan	nan	-inf
-inf	-snan	nan	-inf
-inf	qnan	nan	-inf
-inf	-qnan	nan	-inf
snan	0	nan	nan
snan	0	nan	nan
snan	inf	nan	-inf
snan	-inf	nan	inf
snan	snan	nan	nan
snan	-snan	nan	nan
snan	qnan	nan	nan
snan	-qnan	nan	nan
-snan	0	nan	nan
-snan	0	nan	nan
-snan	inf	nan	-inf
-snan	-inf	nan	inf
-snan	snan	nan	nan
-snan	-snan	nan	nan
-snan	qnan	nan	nan
-snan	-qnan	nan	nan
qnan	0	nan	nan
qnan	0	nan	nan
qnan	inf	nan	-inf
qnan	-inf	nan	inf
qnan	snan	nan	nan
qnan	-snan	nan	nan
qnan	qnan	nan	nan
qnan	-qnan	nan	nan
-qnan	0	nan	nan
-qnan	0	nan	nan
-qnan	inf	nan	-inf
-qnan	-inf	nan	inf
-qnan	snan	nan	nan
-qnan	-snan	nan	nan
-qnan	qnan	nan	nan
-qnan	-qnan	nan	nan

依赖

C: "kvml.h"

示例

C interface：

    int i, len = 4; 
    float src[4] = {0.0f, 2.0f, INFINITY, NAN}; 
    float* dst = (float*)malloc(sizeof(float) * len); 
    if (dst == NULL) { 
        printf("Malloc Failed!\n"); 
        return 0; 
    } 
    vsacos(len, src, dst);

    /** 
     *  Output dst: 
     *     1.570796 nan nan nan
     */

父主题： 函数定义