6.60.22.5 Основные встроенные функции PowerPC, доступные в ISA 3.0

Основные встроенные функции, описанные в этом разделе, доступны в процессорах семейства PowerPC, начиная с ISA 3.0 или более поздних версий. Если конкретные параметры не отключены явно в командной строке, указание параметра -mcpu=power9 приводит к включению всех тех же параметров, что и для -mcpu=power8, в дополнение к параметру -misel.

Следующие встроенные функции доступны в 64-битных системах Linux, использующих набор инструкций ISA 3.0 (-mcpu=power9):

Встроенная функция: __float128 __builtin_addf128_round_to_odd (__float128, __float128)

Выполняет сложение 128-битных чисел с плавающей точкой IEEE, используя режим округления до ближайшего нечётного числа.

Встроенная функция: __float128 __builtin_subf128_round_to_odd (__float128, __float128)

Выполняет вычитание 128-битных чисел с плавающей точкой IEEE, используя режим округления до ближайшего нечётного числа.

Встроенная функция: __float128 __builtin_mulf128_round_to_odd (__float128, __float128)

Выполняет умножение 128-битных чисел с плавающей точкой IEEE, используя режим округления до ближайшего нечётного числа.

Встроенная функция: __float128 __builtin_divf128_round_to_odd (__float128, __float128)

Выполняет деление 128-битных чисел с плавающей точкой IEEE, используя режим округления до ближайшего нечётного числа.

Встроенная функция: __float128 __builtin_sqrtf128_round_to_odd (__float128)

Выполняет вычисление квадратного корня 128-битных чисел с плавающей точкой IEEE, используя режим округления до ближайшего нечётного числа.

Встроенная функция: __float128 __builtin_fmaf128_round_to_odd (__float128, __float128, __float128)

Выполняет операцию умножения-сложения (fused multiply-add) 128-битных чисел с плавающей точкой IEEE, используя режим округления до ближайшего нечётного числа.

Встроенная функция: double __builtin_truncf128_round_to_odd (__float128)

Преобразует значение 128-битного числа с плавающей точкой IEEE в double, используя режим округления до ближайшего нечётного числа.

Следующие дополнительные встроенные функции также доступны для процессоров семейства PowerPC, начиная с ISA 3.0 или более поздних версий:

Встроенная функция: long long __builtin_darn (void)

Встроенная функция: long long __builtin_darn_raw (void)

Встроенная функция: int __builtin_darn_32 (void)

Функции __builtin_darn и __builtin_darn_raw требуют 64-битной среды, поддерживающей ISA 3.0 или более поздние версии. Функция __builtin_darn предоставляет условное случайное число в 64-битном формате. Функция __builtin_darn_raw предоставляет 64-битное случайное число в сыром формате. Функция __builtin_darn_32 предоставляет условное случайное число в 32-битном формате.

Следующие дополнительные встроенные функции также доступны для процессоров семейства PowerPC, начиная с ISA 3.0 или более поздних версий:

int __builtin_byte_in_set (unsigned char u, unsigned long long set);
int __builtin_byte_in_range (unsigned char u, unsigned int range);
int __builtin_byte_in_either_range (unsigned char u, unsigned int ranges);

int __builtin_dfp_dtstsfi_lt (unsigned int comparison, _Decimal64 value);
int __builtin_dfp_dtstsfi_lt (unsigned int comparison, _Decimal128 value);
int __builtin_dfp_dtstsfi_lt_dd (unsigned int comparison, _Decimal64 value);
int __builtin_dfp_dtstsfi_lt_td (unsigned int comparison, _Decimal128 value);

int __builtin_dfp_dtstsfi_gt (unsigned int comparison, _Decimal64 value);
int __builtin_dfp_dtstsfi_gt (unsigned int comparison, _Decimal128 value);
int __builtin_dfp_dtstsfi_gt_dd (unsigned int comparison, _Decimal64 value);
int __builtin_dfp_dtstsfi_gt_td (unsigned int comparison, _Decimal128 value);

int __builtin_dfp_dtstsfi_eq (unsigned int comparison, _Decimal64 value);
int __builtin_dfp_dtstsfi_eq (unsigned int comparison, _Decimal128 value);
int __builtin_dfp_dtstsfi_eq_dd (unsigned int comparison, _Decimal64 value);
int __builtin_dfp_dtstsfi_eq_td (unsigned int comparison, _Decimal128 value);

int __builtin_dfp_dtstsfi_ov (unsigned int comparison, _Decimal64 value);
int __builtin_dfp_dtstsfi_ov (unsigned int comparison, _Decimal128 value);
int __builtin_dfp_dtstsfi_ov_dd (unsigned int comparison, _Decimal64 value);
int __builtin_dfp_dtstsfi_ov_td (unsigned int comparison, _Decimal128 value);

double __builtin_mffsl(void);

Функция __builtin_byte_in_set требует 64-битной среды, поддерживающей ISA 3.0 или более поздние версии. Эта функция возвращает ненулевое значение тогда и только тогда, когда её аргумент u точно равен одному из восьми байтов, содержащихся в её 64-битном аргументе set.

Функции __builtin_byte_in_range и __builtin_byte_in_either_range требуют среды, поддерживающей ISA 3.0 или более поздние версии. Для этих двух функций аргумент range закодирован как 4 байта, организованные как hi_1:lo_1:hi_2:lo_2. Функция __builtin_byte_in_range возвращает ненулевое значение тогда и только тогда, когда её аргумент u находится в диапазоне от lo_2 до hi_2 включительно. Функция __builtin_byte_in_either_range возвращает ненулевое значение тогда и только тогда, когда её аргумент u находится либо в диапазоне от lo_1 до hi_1 включительно, либо в диапазоне от lo_2 до hi_2 включительно.

Функция __builtin_dfp_dtstsfi_lt возвращает ненулевое значение тогда и только тогда, когда количество значащих цифр её аргумента value меньше её аргумента comparison. Функции __builtin_dfp_dtstsfi_lt_dd и __builtin_dfp_dtstsfi_lt_td ведут себя аналогично, но требуют, чтобы тип аргумента value был __Decimal64 и __Decimal128 соответственно.

Функция __builtin_dfp_dtstsfi_gt возвращает ненулевое значение тогда и только тогда, когда количество значащих цифр её аргумента value больше её аргумента comparison. Функции __builtin_dfp_dtstsfi_gt_dd и __builtin_dfp_dtstsfi_gt_td ведут себя аналогично, но требуют, чтобы тип аргумента value был __Decimal64 и __Decimal128 соответственно.

Функция __builtin_dfp_dtstsfi_eq возвращает ненулевое значение тогда и только тогда, когда количество значащих цифр её аргумента value равно её аргументу comparison. Функции __builtin_dfp_dtstsfi_eq_dd и __builtin_dfp_dtstsfi_eq_td ведут себя аналогично, но требуют, чтобы тип аргумента value был __Decimal64 и __Decimal128 соответственно.

Функция __builtin_dfp_dtstsfi_ov возвращает ненулевое значение тогда и только тогда, когда у её аргумента value неопределённое количество значащих цифр, например, когда value является кодированием NaN. Функции __builtin_dfp_dtstsfi_ov_dd и __builtin_dfp_dtstsfi_ov_td ведут себя аналогично, но требуют, чтобы тип аргумента value был __Decimal64 и __Decimal128 соответственно.

Функция __builtin_mffsl использует инструкцию ISA 3.0 mffsl для чтения FPSCR. Инструкция является версией с меньшей задержкой инструкции mffs. Если инструкция mffsl недоступна, встроенная функция использует более старую инструкцию mffs для чтения FPSCR.