NumberHexFormat

class NumberHexFormat

Представляет опции формата в шестнадцатеричном формате для форматирования и парсинга числового значения.

Результат форматирования состоит из строки prefix, шестнадцатеричного представления форматируемого значения и строки suffix. Шестнадцатеричное представление значения вычисляется путем сопоставления каждого четырехбитного блока его двоичного представления соответствующей шестнадцатеричной цифре, начиная с наиболее значимых битов. upperCase определяет, используются ли заглавные 0-9, A-F или строчные 0-9, a-f шестнадцатеричные цифры. Если removeLeadingZeros имеет значение true, ведущие нули в шестнадцатеричном представлении удаляются.

Например, двоичное представление значения Byte 58 — это 8-битное 00111010, которое преобразуется в шестнадцатеричное представление 3a или 3A в зависимости от upperCase. В то время как двоичное представление значения Int 58 — это 32-битное 00000000000000000000000000111010, которое преобразуется в шестнадцатеричное представление 0000003a или 0000003A в зависимости от upperCase. Если removeLeadingZeros имеет значение true, ведущие нули в 0000003a удаляются, в результате чего получается 3a.

Чтобы преобразовать значение в шестнадцатеричную строку определенной длины, сначала преобразуйте значение в тип с соответствующим размером в битах. Например, чтобы преобразовать значение Int в шестнадцатеричную строку длиной 4 символа, преобразуйте значение toShort() перед шестнадцатеричным форматированием. Чтобы преобразовать его в шестнадцатеричную строку длиной не более 4 символов без ведущих нулей, установите removeLeadingZeros в true дополнительно.

Для парсинга необходимо, чтобы prefix и suffix были присутствовать в строке-входе, а количество шестнадцатеричных цифр должно быть не менее одной и не более значения, деленного на четыре. Парсинг выполняется без учета регистра, и removeLeadingZeros также игнорируется.

См. NumberHexFormat.Builder, чтобы узнать, как настраиваются опции и какое значение по умолчанию для каждой опции.