v?MaxMag

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 4/28/2026

Version

Public

v?MaxMag

Returns the element with the larger magnitude between each pair of elements of the two vector arguments.

Syntax

vhMaxMag ( n , a , b , y );

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

vmhMaxMag ( n , a , b , y , mode );

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

vsMaxMag ( n , a , b , y );

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

vmsMaxMag ( n , a , b , y , mode );

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

vdMaxMag ( n , a , b , y );

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

vmdMaxMag ( n , a , b , y , mode );

vmdMaxMagI(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` , `b`	const _Float16* for `vhMaxMag` const float* for `vsMaxMag` const _Float16* for `vmhMaxMag` const float* for `vmsMaxMag` const double* for `vdMaxMag` const double* for `vmdMaxMag`	Pointers to the arrays containing the input vectors `a` and `b` .
`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 (Sets a new mode for VM functions according to the mode parameter and stores the previous VM mode to oldmode.) for possible values and their description.

Output Parameters

Name	Type	Description
`y`	_Float16* for `vhMaxMag` float* for `vsMaxMag` _Float16* for `vmhMaxMag` float* for `vmsMaxMag` double* for `vdMaxMag` double* for `vmdMaxMag`	Pointer to an array containing the output vector `y` .

Description

The v?MaxMag function returns a vector with element values equal to the element with the larger magnitude from each pair of corresponding elements of the two vectors a and b :

If | a_i | > | b_i | v?MaxMag returns a_i , otherwise v?MaxMag returns a_i .
If | b_i | > | a_i | v?MaxMag returns b_i , otherwise v?MaxMag returns a_i .
Otherwise v?MaxMag behaves like v?Fmax .

Special values for Real Function v?MaxMag(x, y)

Argument 1	Argument 2	Result
`a`_i not NAN	NAN	`a`_i
NAN	`b`_i not NAN	`b`_i
NAN	NAN	NAN

NOTE:

MinMag
Fmax

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for C

v?MaxMag

Syntax

Include Files

Input Parameters

Output Parameters

Description