v?erfcinv

Compute the inverse complementary error function value of the input vector.

Interface Definition

C interface:

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

void vderfcinv(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 vserfcinv Double-precision floating-point type for vderfcinv	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 vserfcinv Double-precision floating-point type for vderfcinv	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 vserfcinv
Double-precision floating-point type for vderfcinv

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 vserfcinv
Double-precision floating-point type for vderfcinv

Output vector dst with length len.

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

Output

Return Value

Each operation value returns the inverse complementary error function value of x.
For special values, see the following table.
Input Value (src)

Output Value (dst)

2

-inf

>2

nan

-0

+inf

0 <= x < 0x1p-52

+inf

< 0

nan

±inf

nan

nan

nan

Input Value (src)	Output Value (dst)
2	-inf
>2	nan
-0	+inf
0 <= x < 0x1p-52	+inf
< 0	nan
±inf	nan
nan	nan

Dependencies

C: "kvml.h"

Examples

C interface:

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

    /** 
     *  Output dst: 
     *     nan nan inf inf 0.000000 nan nan nan nan
     */

Parent topic: Function Syntax