28.2.117 __builtin_sacr

Architecture

dsPIC33C/E/F, dsPIC30

Description

Shifts value by shift and returns the value which is rounded using the rounding mode determined by the CORCONbits.RND control bit.

For example:

 volatile register int16_t value asm("A");
 int16_t result;

 result = __builtin_sacr(value,3);

Might generate:

 sac.r A, #3, w0

Prototype

int16_t __builtin_sacr(int16_t value, int16_t shift);

Arguments

value – Integer number to be shifted.

shift – Literal amount to shift between -8 and 7

Return Value

Returns the shifted result to CORCON register.

Machine Instruction

sacr

Error Messages

An error message will be displayed if:
  • the result is not an accumulator register
  • the shift value is not a literal within range