__tdw, __builtin_ppc_tdw, __tw, __builtin_ppc_tw

Purpose

Trap Doubleword, Trap Word

Compares parameter a with parameter b. This comparison results in five conditions which are ANDed with a 5-bit constant TO. If the result is not 0 the system trap handler is invoked.

Prototype

void __builtin_ppc_tdw ( long long a, long long b, unsigned int TO);

void __builtin_ppc_tw (int a, int b, unsigned int TO);

void __tdw ( long long a, long long b, unsigned int TO);

void __tw (int a, int b, unsigned int TO);

Note:
  • The built-in function in the form of __name is a synonym of the built-in function in the form of __builtin_ppc_name.
  • The built-in function in the form of __name is provided for compatibility with IBM® XL C/C++ for AIX® 16.1.0 or earlier releases. This built-in function form might be deprecated in the future.

Parameters

TO
A value of 1 to 31 inclusive. Each bit position, if set, indicates one or more of the following possible conditions:
0 (high-order bit)
a is less than b, using signed comparison.
1
a is greater than b, using signed comparison.
2
a is equal to b
3
a is less than b, using unsigned comparison.
4 (low-order bit)
a is greater than b, using unsigned comparison.

Usage

__tdw is valid only in 64-bit mode.