28.2.52 __builtin_flim_excess

Architecture

dsPIC33C/E/F, dsPIC30

Description

Force (Signed) Data Range Limit with Limit Excess Result. Simultaneously compares a 16-bit signed data value to a maximum signed limit value and a minimum signed limit value.

Return the sign of the excess value.

Prototype

int16_t __builtin_flim(int16_t value, int16_t high, int16_t low, int16_t *excess);

Arguments

value – Data value

high – Maximum limit value

low – Minimum limit value

excess – Storage for excess over limit

Return Value

Returns the value clamped between high and low; stores the sign of the excess in the storage pointed to by excess.

Machine Instruction

flim.v

(when used with __builtin_flimv_excess)

Error Messages

None