Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

v?CopySign

Returns vector of elements of one argument with signs changed to match other argument elements.

Syntax

vsCopySign (n, a, y);

vsCopySignI(n, a, inca, b, incb, y, incy);

vmsCopySign (n, a, y, mode);

vmsCopySignI(n, a, inca, b, incb, y, incy, mode);

vdCopySign (n, a, y);

vdCopySignI(n, a, inca, b, incb, y, incy);

vmdCopySign (n, a, y, mode);

vmdCopySignI(n, a, inca, b, incb, y, incy, mode);

Include Files

  • mkl.h

Input Parameters

Name

Type

Description

n

const MKL_INT

Specifies the number of elements to be calculated.

a

const float* for vsCopySign

const float* for vmsCopySign

const double* for vdCopySign

const double* for vmdCopySign

Pointer to the array containing the input vector a.

inca, incb, incy

const MKL_INT

Specifies increments for the elements of a, b, and y.

mode

const MKL_INT64

Overrides the global VM mode setting for this function call. See vmlSetMode for possible values and their description.

Output Parameters

Name

Type

Description

y

float* for vsCopySign

float* for vmsCopySign

double* for vdCopySign

double* for vmdCopySign

Pointer to an array containing the output vector y.

Description

The v?CopySign function returns the first vector argument elements with the sign changed to match the sign of the second vector argument's corresponding elements.