__builtin_bcdsetsign (Clang-based front end)

Edit online

Purpose

Set the sign code of the input parameter in packed decimal format.

Note: This built-in function is valid only when all following conditions are met:
  • -qarch is set to utilize POWER9 technology.
  • The bcd.h file is included.

Prototype

vector unsigned char __builtin_bcdsetsign(vector unsigned char, unsigned char);

Usage

Returns the packed decimal value of the first parameter combined with the sign code.

The sign code is set according to the following rules:
  • If the packed decimal value of the first parameter is positive, the following rules apply:
    • If the second parameter is 0, the sign code is set to 0xC.
    • If the second parameter is 1, the sign code is set to 0xF.
  • If the packed decimal value of the first parameter is negative, the sign code is set to 0xD.
Notes:
  • The second parameter can only be 0 or 1.
  • You can determine whether a packed decimal value is positive or negative according to the following rules:
    • Packed decimal values with sign code of 0xA, 0xC, 0xE, or 0xF are interpreted as positive values.
    • Packed decimal values with sign code of 0xB or 0xD are interpreted as negative values.