v?MinMag

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 4/28/2026

Version

Public

v?MinMag

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

Syntax

vhMinMag ( n , a , b , y );

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

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

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

vsMinMag ( n , a , b , y );

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

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

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

vdMinMag ( n , a , b , y );

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

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

vmdMinMagI(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 `vhMinMag` const float* for `vsMinMag` const _Float16* for `vmhMinMag` const float* for `vmsMinMag` const double* for `vdMinMag` const double* for `vmdMinMag`	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 `vhMinMag` float* for `vsMinMag` _Float16* for `vmhMinMag` float* for `vmsMinMag` double* for `vdMinMag` double* for `vmdMinMag`	Pointer to an array containing the output vector `y` .

Description

The v?MinMag function returns a vector with element values equal to the element with the smaller 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?Fmin .

Special values for Real Function v?MinMag(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:

MaxMag
Fmin

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?MinMag

Syntax

Include Files

Input Parameters

Output Parameters

Description