RealView Compilation Tools Compiler Reference Guide: 4.7.40. __usat

RealView Compilation Tools Compiler Reference Guide

Version 4.0

Home > Compiler-specific Features > Instruction intrinsics > __usat

4.7.40. `__usat`

This intrinsic inserts a USAT instruction into the instruction stream generated by the compiler. It enables you to saturate an unsigned value from within your C or C++ code.

Syntax

int __usat(unsigned int val, unsigned int sat)

Where:

val: Is the value to be saturated.
sat: Is the bit position to saturate to.
usat must be in the range 0 to 31.

Return value

The __usat intrinsic returns val saturated to the unsigned range 0 ≤ x ≤ 2^sat-1 -1.

Errors

The compiler does not recognize the __usat intrinsic when compiling for a target that does not support the USAT instruction. The compiler generates either a warning or an error in this case.

See also

__ssat
SSAT and USAT in the Assembler Guide.

Copyright © 2007-2010 ARM. All rights reserved.	ARM DUI 0348C
Non-Confidential	ID101213
PDF version

Home > Compiler-specific Features > Instruction intrinsics > __usat