v?fdim

Return the difference of x – y if x > y or 0 otherwise. The inputs are vectors.

Interface Definition

C interface:

void vsfdim(const int len, const float* src1, const float* src2, float* dst);

void vdfdim(const int len, const double* src1, const double* src2, 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
src1	Single-precision floating-point type for vsfdim Double-precision floating-point type for vdfdim	Input vector src1 with length len. If the pointer is null, a null pointer error is reported and the function returns.	Input
src2	Single-precision floating-point type for vsfdim Double-precision floating-point type for vdfdim	Input vector src2 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 vsfdim Double-precision floating-point type for vdfdim	Output vector dst with length len. If the pointer is null, a null pointer error is reported and the function returns.	Output

Return Value

If x > y, the result of x – y is returned. Otherwise, 0 is returned.
For special values, see the following table.
Input Value 1 (src1)

Input Value 2 (src2)

Output Value (dst)

any

nan

nan

nan

any

nan

Input Value 1 (src1)	Input Value 2 (src2)	Output Value (dst)
any	nan	nan
nan	any	nan

Dependencies

C: "kvml.h"

Examples

C interface:

    int i, len = 8; 
    float src1[8] = {-1.5f, -0.0f, 0.0f, 1.0f, 1.5f, -INFINITY, INFINITY, NAN};
    float src2[8] = {-1.1f, 0.0f, +0.0f, -1.0f, -1.5f, +INFINITY, -INFINITY, -NAN}; 
    float* dst = (float*)malloc(sizeof(float) * len); 
    if (dst == NULL) { 
        printf("Malloc Failed!\n"); 
        return 0;
    }
    vsfdim(len, src1, src2, dst);

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

Parent topic: Function Syntax