//===-- Hexadecimal Converter for printf ------------------------*- C++ -*-===// // // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. // See https://llvm.org/LICENSE.txt for license information. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception // //===----------------------------------------------------------------------===// #ifndef LLVM_LIBC_SRC_STDIO_PRINTF_CORE_FLOAT_HEX_CONVERTER_H #define LLVM_LIBC_SRC_STDIO_PRINTF_CORE_FLOAT_HEX_CONVERTER_H #include "src/__support/CPP/string_view.h" #include "src/__support/FPUtil/FPBits.h" #include "src/__support/FPUtil/rounding_mode.h" #include "src/__support/ctype_utils.h" #include "src/__support/macros/config.h" #include "src/stdio/printf_core/converter_utils.h" #include "src/stdio/printf_core/core_structs.h" #include "src/stdio/printf_core/float_inf_nan_converter.h" #include "src/stdio/printf_core/writer.h" #include #include namespace LIBC_NAMESPACE_DECL { namespace printf_core { template LIBC_INLINE int convert_float_hex_exp(Writer *writer, const FormatSection &to_conv) { using LDBits = fputil::FPBits; using StorageType = LDBits::StorageType; bool is_negative; int exponent; StorageType mantissa; bool is_inf_or_nan; uint32_t fraction_bits; if (to_conv.length_modifier == LengthModifier::L) { fraction_bits = LDBits::FRACTION_LEN; LDBits::StorageType float_raw = to_conv.conv_val_raw; LDBits float_bits(float_raw); is_negative = float_bits.is_neg(); exponent = float_bits.get_explicit_exponent(); mantissa = float_bits.get_explicit_mantissa(); is_inf_or_nan = float_bits.is_inf_or_nan(); } else { using LBits = fputil::FPBits; fraction_bits = LBits::FRACTION_LEN; LBits::StorageType float_raw = static_cast(to_conv.conv_val_raw); LBits float_bits(float_raw); is_negative = float_bits.is_neg(); exponent = float_bits.get_explicit_exponent(); mantissa = float_bits.get_explicit_mantissa(); is_inf_or_nan = float_bits.is_inf_or_nan(); } if (is_inf_or_nan) return convert_inf_nan(writer, to_conv); char sign_char = 0; if (is_negative) sign_char = '-'; else if ((to_conv.flags & FormatFlags::FORCE_SIGN) == FormatFlags::FORCE_SIGN) sign_char = '+'; // FORCE_SIGN has precedence over SPACE_PREFIX else if ((to_conv.flags & FormatFlags::SPACE_PREFIX) == FormatFlags::SPACE_PREFIX) sign_char = ' '; constexpr size_t BITS_IN_HEX_DIGIT = 4; // This is to handle situations where the mantissa isn't an even number of hex // digits. This is primarily relevant for x86 80 bit long doubles, which have // 63 bit mantissas. In the case where the mantissa is 0, however, the // exponent should stay as 0. if (fraction_bits % BITS_IN_HEX_DIGIT != 0 && mantissa > 0) { exponent -= fraction_bits % BITS_IN_HEX_DIGIT; } // This is the max number of digits it can take to represent the mantissa. // Since the number is in bits, we divide by 4, and then add one to account // for the extra implicit bit. We use the larger of the two possible values // since the size must be constant. constexpr size_t MANT_BUFF_LEN = (LDBits::FRACTION_LEN / BITS_IN_HEX_DIGIT) + 1; char mant_buffer[MANT_BUFF_LEN]; size_t mant_len = (fraction_bits / BITS_IN_HEX_DIGIT) + 1; // Precision only tracks the number of digits after the hexadecimal point, so // we have to add one to account for the digit before the hexadecimal point. if (to_conv.precision + 1 < static_cast(mant_len) && to_conv.precision + 1 > 0) { const size_t intended_digits = to_conv.precision + 1; const size_t shift_amount = (mant_len - intended_digits) * BITS_IN_HEX_DIGIT; const StorageType truncated_bits = mantissa & ((StorageType(1) << shift_amount) - 1); const StorageType halfway_const = StorageType(1) << (shift_amount - 1); mantissa >>= shift_amount; switch (fputil::quick_get_round()) { case FE_TONEAREST: // Round to nearest, if it's exactly halfway then round to even. if (truncated_bits > halfway_const) ++mantissa; else if (truncated_bits == halfway_const) mantissa = mantissa + (mantissa & 1); break; case FE_DOWNWARD: if (truncated_bits > 0 && is_negative) ++mantissa; break; case FE_UPWARD: if (truncated_bits > 0 && !is_negative) ++mantissa; break; case FE_TOWARDZERO: break; } // If the rounding caused an overflow, shift the mantissa and adjust the // exponent to match. if (mantissa >= (StorageType(1) << (intended_digits * BITS_IN_HEX_DIGIT))) { mantissa >>= BITS_IN_HEX_DIGIT; exponent += BITS_IN_HEX_DIGIT; } mant_len = intended_digits; } size_t mant_cur = mant_len; size_t first_non_zero = 1; for (; mant_cur > 0; --mant_cur, mantissa >>= 4) { char mant_mod_16 = static_cast(mantissa % 16); char new_digit = internal::int_to_b36_char(mant_mod_16); if (internal::isupper(to_conv.conv_name)) new_digit = internal::toupper(new_digit); mant_buffer[mant_cur - 1] = new_digit; if (new_digit != '0' && first_non_zero < mant_cur) first_non_zero = mant_cur; } size_t mant_digits = first_non_zero; if (to_conv.precision >= 0) mant_digits = mant_len; // This approximates the number of digits it will take to represent the // exponent. The calculation is ceil((bits * 5) / 16). Floor also works, but // only on exact multiples of 16. We add 1 for the sign. // Relevant sizes: // 15 -> 5 // 11 -> 4 // 8 -> 3 constexpr size_t EXP_LEN = (((LDBits::EXP_LEN * 5) + 15) / 16) + 1; char exp_buffer[EXP_LEN]; bool exp_is_negative = false; if (exponent < 0) { exp_is_negative = true; exponent = -exponent; } size_t exp_cur = EXP_LEN; for (; exponent > 0; --exp_cur, exponent /= 10) { exp_buffer[exp_cur - 1] = internal::int_to_b36_char(exponent % 10); } if (exp_cur == EXP_LEN) { // if nothing else was written, write a 0. exp_buffer[EXP_LEN - 1] = '0'; exp_cur = EXP_LEN - 1; } exp_buffer[exp_cur - 1] = exp_is_negative ? '-' : '+'; --exp_cur; // these are signed to prevent underflow due to negative values. The eventual // values will always be non-negative. size_t trailing_zeroes = 0; int padding; // prefix is "0x", and always appears. constexpr size_t PREFIX_LEN = 2; char prefix[PREFIX_LEN]; prefix[0] = '0'; prefix[1] = internal::islower(to_conv.conv_name) ? 'x' : 'X'; const cpp::string_view prefix_str(prefix, PREFIX_LEN); // If the precision is greater than the actual result, pad with 0s if (to_conv.precision > static_cast(mant_digits - 1)) trailing_zeroes = to_conv.precision - (mant_digits - 1); bool has_hexadecimal_point = (mant_digits > 1) || ((to_conv.flags & FormatFlags::ALTERNATE_FORM) == FormatFlags::ALTERNATE_FORM); constexpr cpp::string_view HEXADECIMAL_POINT("."); // This is for the letter 'p' before the exponent. const char exp_separator = internal::islower(to_conv.conv_name) ? 'p' : 'P'; constexpr int EXP_SEPARATOR_LEN = 1; padding = static_cast(to_conv.min_width - (sign_char > 0 ? 1 : 0) - PREFIX_LEN - mant_digits - trailing_zeroes - static_cast(has_hexadecimal_point) - EXP_SEPARATOR_LEN - (EXP_LEN - exp_cur)); if (padding < 0) padding = 0; if ((to_conv.flags & FormatFlags::LEFT_JUSTIFIED) == FormatFlags::LEFT_JUSTIFIED) { // The pattern is (sign), 0x, digit, (.), (other digits), (zeroes), p, // exponent, (spaces) if (sign_char > 0) RET_IF_RESULT_NEGATIVE(writer->write(sign_char)); RET_IF_RESULT_NEGATIVE(writer->write(prefix_str)); RET_IF_RESULT_NEGATIVE(writer->write(mant_buffer[0])); if (has_hexadecimal_point) RET_IF_RESULT_NEGATIVE(writer->write(HEXADECIMAL_POINT)); if (mant_digits > 1) RET_IF_RESULT_NEGATIVE(writer->write({mant_buffer + 1, mant_digits - 1})); if (trailing_zeroes > 0) RET_IF_RESULT_NEGATIVE(writer->write('0', trailing_zeroes)); RET_IF_RESULT_NEGATIVE(writer->write(exp_separator)); RET_IF_RESULT_NEGATIVE( writer->write({exp_buffer + exp_cur, EXP_LEN - exp_cur})); if (padding > 0) RET_IF_RESULT_NEGATIVE(writer->write(' ', padding)); } else { // The pattern is (spaces), (sign), 0x, (zeroes), digit, (.), (other // digits), (zeroes), p, exponent if ((padding > 0) && ((to_conv.flags & FormatFlags::LEADING_ZEROES) != FormatFlags::LEADING_ZEROES)) RET_IF_RESULT_NEGATIVE(writer->write(' ', padding)); if (sign_char > 0) RET_IF_RESULT_NEGATIVE(writer->write(sign_char)); RET_IF_RESULT_NEGATIVE(writer->write(prefix_str)); if ((padding > 0) && ((to_conv.flags & FormatFlags::LEADING_ZEROES) == FormatFlags::LEADING_ZEROES)) RET_IF_RESULT_NEGATIVE(writer->write('0', padding)); RET_IF_RESULT_NEGATIVE(writer->write(mant_buffer[0])); if (has_hexadecimal_point) RET_IF_RESULT_NEGATIVE(writer->write(HEXADECIMAL_POINT)); if (mant_digits > 1) RET_IF_RESULT_NEGATIVE(writer->write({mant_buffer + 1, mant_digits - 1})); if (trailing_zeroes > 0) RET_IF_RESULT_NEGATIVE(writer->write('0', trailing_zeroes)); RET_IF_RESULT_NEGATIVE(writer->write(exp_separator)); RET_IF_RESULT_NEGATIVE( writer->write({exp_buffer + exp_cur, EXP_LEN - exp_cur})); } return WRITE_OK; } } // namespace printf_core } // namespace LIBC_NAMESPACE_DECL #endif // LLVM_LIBC_SRC_STDIO_PRINTF_CORE_FLOAT_HEX_CONVERTER_H