v?cosd

Compute the cosine of an input vector of angles.

Interface Definition

C interface:

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

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

Parameters

Parameter	Type	Description	Input/Output
len	Integer	Number of elements in the input vector. If len ≤ 0, an invalid parameter error is reported and the function returns.	Input
src	Single-precision floating-point type for vscosd Double-precision floating-point type for vdcosd	Input vector src with length len. If the pointer is null, a null pointer error is reported and the function returns.	Input
dst	Single-precision floating-point type for vscosd Double-precision floating-point type for vdcosd	Output vector dst with length len. If the pointer is null, a null pointer error is reported and the function returns.	Output

Parameter

Type

Description

Input/Output

len

Integer

Number of elements in the input vector.

If len ≤ 0, an invalid parameter error is reported and the function returns.

Input

src

Single-precision floating-point type for vscosd
Double-precision floating-point type for vdcosd

Input vector src with length len.

If the pointer is null, a null pointer error is reported and the function returns.

Input

dst

Single-precision floating-point type for vscosd
Double-precision floating-point type for vdcosd

Output vector dst with length len.

If the pointer is null, a null pointer error is reported and the function returns.

Output

Return Value

The cosine y of angle x is returned for each operation value, that is, y = cosd(x) = cos(x * π/180). y ∈ [-1, +1]
For special values, see the following table.
Input Angle (src)

Output Cosine (dst)

+0

+1

-0

+1

+inf

nan

-inf

nan

nan

nan

Input Angle (src)	Output Cosine (dst)
+0	+1
-0	+1
+inf	nan
-inf	nan
nan	nan

Dependencies

C: "kvml.h"

Examples

C interface:

float src[LEN] = {0.0f, 2.0f, INFINITY, NAN};
float* dst = (float*)malloc(sizeof(float) * LEN);
if (dst == NULL) {
    printf("Malloc Failed!\n");
    return;
}
vscosd(LEN, src, dst);
/**
 *  Output dst:
 *     1.0  0x1.ffb026p-1  nan  nan
 *
 */

Parent topic: Function Syntax