Класс HexFormat

public static HexFormat of()

Возвращает:

форматировщик шестнадцатеричных значений без разделителя и со строчными символами

public static HexFormat ofDelimiter(String delimiter)

Параметры:

delimiter — разделитель, не null, может быть пустым

Возвращает:

HexFormat с разделителем и строчными символами

public HexFormat withDelimiter(String delimiter)

Параметры:

delimiter — разделитель, не null, может быть пустым

Возвращает:

копию этого HexFormat с разделителем

public HexFormat withPrefix(String prefix)

Параметры:

prefix — префикс, не null, может быть пустым

Возвращает:

копию этого HexFormat с префиксом

public HexFormat withSuffix(String suffix)

Параметры:

suffix — суффикс, не null, может быть пустым

Возвращает:

копию этого HexFormat с суффиксом

public HexFormat withUpperCase()

Возвращает:

копию этого HexFormat с прописными шестнадцатеричными символами

public HexFormat withLowerCase()

Возвращает:

копию этого HexFormat со строчными шестнадцатеричными символами

public String delimiter()

Возвращает:

разделитель, не null, может быть пустым ""

public String prefix()

Возвращает:

префикс, не null, может быть пустым ""

public String suffix()

Возвращает:

суффикс, не null, может быть пустым ""

public boolean isUpperCase()

Возвращает:

true, если шестнадцатеричные цифры записаны прописными буквами, иначе — false

public String formatHex(byte[] bytes)

Параметры:

bytes — массив байтов, не null

Возвращает:

строку с шестнадцатеричным представлением массива байтов

public String formatHex(byte[] bytes, int fromIndex, int toIndex)

Параметры:

bytes — массив байтов, не null

fromIndex — начальный индекс диапазона включительно

toIndex — конечный индекс диапазона исключительно

Возвращает:

строку с шестнадцатеричным представлением каждого байта диапазона массива

Выбрасывает:

IndexOutOfBoundsException — если диапазон массива выходит за допустимые границы

public <A extends Appendable> A formatHex(A out, byte[] bytes)

Параметры типа:

A — тип Appendable

Параметры:

out — Appendable, не null

bytes — массив байтов

Возвращает:

Appendable

Выбрасывает:

UncheckedIOException — если при добавлении в выходной поток возникает исключение ввода-вывода

public <A extends Appendable> A formatHex(A out, byte[] bytes, int fromIndex, int toIndex)

Параметры типа:

A — тип Appendable

Параметры:

out — Appendable, не null

bytes — массив байтов, не null

fromIndex — начальный индекс диапазона включительно

toIndex — конечный индекс диапазона исключительно.

Возвращает:

Appendable

Выбрасывает:

IndexOutOfBoundsException — если диапазон массива выходит за допустимые границы

UncheckedIOException — если при добавлении в выходной поток возникает исключение ввода-вывода

public byte[] parseHex(CharSequence string)

Параметры:

string — строка, содержащая значения байтов с префиксом, шестнадцатеричными цифрами, суффиксом и разделителями

Возвращает:

массив байтов со значениями, разобранными из строки

Выбрасывает:

IllegalArgumentException — если для какого-либо значения байта отсутствует префикс или суффикс, значения байтов не являются шестнадцатеричными символами или после всех значений байтов, кроме последнего, отсутствует разделитель

public byte[] parseHex(CharSequence string, int fromIndex, int toIndex)

Параметры:

string — диапазон строки, содержащий шестнадцатеричные цифры, разделители, префикс и суффикс.

fromIndex — начальный индекс диапазона включительно

toIndex — конечный индекс диапазона исключительно.

Возвращает:

массив байтов со значениями, разобранными из диапазона строки

Выбрасывает:

IllegalArgumentException — если для какого-либо значения байта отсутствует префикс или суффикс, значения байтов не являются шестнадцатеричными символами или после всех значений байтов, кроме последнего, отсутствует разделитель

IndexOutOfBoundsException — если диапазон строки выходит за допустимые границы

public byte[] parseHex(char[] chars, int fromIndex, int toIndex)

Параметры:

chars — диапазон массива символов, содержащий чётное число шестнадцатеричных цифр, разделители, префикс и суффикс.

fromIndex — начальный индекс диапазона включительно

toIndex — конечный индекс диапазона исключительно.

Возвращает:

массив байтов со значениями, разобранными из диапазона массива символов

Выбрасывает:

IllegalArgumentException — если для какого-либо значения байта отсутствует префикс или суффикс, значения байтов не являются шестнадцатеричными символами или после всех значений байтов, кроме последнего, отсутствует разделитель

IndexOutOfBoundsException — если диапазон массива символов выходит за допустимые границы

public char toLowHexDigit(int value)

Параметры:

value — значение; используются только младшие 4 бита 0-3 значения

Возвращает:

шестнадцатеричный символ для младших 4 битов 0-3 значения

public char toHighHexDigit(int value)

Параметры:

value — значение; используются только биты 4-7 значения

Возвращает:

шестнадцатеричный символ для битов 4-7 значения

public <A extends Appendable> A toHexDigits(A out, byte value)

Параметры типа:

A — тип Appendable

Параметры:

out — Appendable, не null

value — значение байта

Возвращает:

Appendable

Выбрасывает:

UncheckedIOException — если при добавлении в выходной поток возникает исключение ввода-вывода

public String toHexDigits(byte value)

Параметры:

value — значение байта

Возвращает:

два шестнадцатеричных символа для значения байта

public String toHexDigits(char value)

Параметры:

value — значение char

Возвращает:

четыре шестнадцатеричных символа для значения char

public String toHexDigits(short value)

Параметры:

value — значение short

Возвращает:

четыре шестнадцатеричных символа для значения short

public String toHexDigits(int value)

Параметры:

value — значение int

Возвращает:

восемь шестнадцатеричных символов для значения int

См. также:

• Integer.toHexString(int)

public String toHexDigits(long value)

Параметры:

value — значение long

Возвращает:

шестнадцать шестнадцатеричных символов для значения long

См. также:

• Long.toHexString(long)

public String toHexDigits(long value, int digits)

Параметры:

value — значение long

digits — количество возвращаемых шестнадцатеричных цифр, от 0 до 16

Возвращает:

шестнадцатеричные символы для значения long

Выбрасывает:

IllegalArgumentException — если digits меньше нуля или больше 16

public static boolean isHexDigit(int ch)

Параметры:

ch — кодовая точка

Возвращает:

true, если символ является допустимым шестнадцатеричным символом, иначе — false

public static int fromHexDigit(int ch)

Параметры:

ch — символ или кодовая точка

Возвращает:

значение 0-15

Выбрасывает:

NumberFormatException — если кодовая точка не является шестнадцатеричным символом

public static int fromHexDigits(CharSequence string)

Примечание к API:

Integer.parseInt(s, 16) и Integer.parseUnsignedInt(s, 16) похожи, но допускают все шестнадцатеричные цифры Unicode, определённые методом Character.digit(ch, 16). HexFormat использует только шестнадцатеричные символы "0-9", "A-F" и "a-f". Знаковые шестнадцатеричные строки можно разобрать с помощью Integer.parseInt(String, int).

Параметры:

string — CharSequence, содержащая не более восьми шестнадцатеричных символов

Возвращает:

значение, разобранное из строки

Выбрасывает:

IllegalArgumentException — если длина строки больше восьми (8) или любой из символов не является шестнадцатеричным

public static int fromHexDigits(CharSequence string, int fromIndex, int toIndex)

Примечание к API:

Integer.parseInt(s, 16) и Integer.parseUnsignedInt(s, 16) похожи, но допускают все шестнадцатеричные цифры Unicode, определённые методом Character.digit(ch, 16). HexFormat использует только шестнадцатеричные символы "0-9", "A-F" и "a-f". Знаковые шестнадцатеричные строки можно разобрать с помощью Integer.parseInt(String, int).

Параметры:

string — CharSequence, содержащая символы

fromIndex — начальный индекс диапазона включительно

toIndex — конечный индекс диапазона исключительно.

Возвращает:

значение, разобранное из диапазона строки

Выбрасывает:

IndexOutOfBoundsException — если диапазон выходит за допустимые границы CharSequence

IllegalArgumentException — если длина диапазона больше восьми (8) или любой из символов не является шестнадцатеричным

public static long fromHexDigitsToLong(CharSequence string)

Примечание к API:

Long.parseLong(s, 16) и Long.parseUnsignedLong(s, 16) похожи, но допускают все шестнадцатеричные цифры Unicode, определённые методом Character.digit(ch, 16). HexFormat использует только шестнадцатеричные символы "0-9", "A-F" и "a-f". Знаковые шестнадцатеричные строки можно разобрать с помощью Long.parseLong(String, int).

Параметры:

string — CharSequence, содержащая не более шестнадцати шестнадцатеричных символов

Возвращает:

значение, разобранное из строки

Выбрасывает:

IllegalArgumentException — если длина строки больше шестнадцати (16) или любой из символов не является шестнадцатеричным

public static long fromHexDigitsToLong(CharSequence string, int fromIndex, int toIndex)

Примечание к API:

Long.parseLong(s, 16) и Long.parseUnsignedLong(s, 16) похожи, но допускают все шестнадцатеричные цифры Unicode, определённые методом Character.digit(ch, 16). HexFormat использует только шестнадцатеричные символы "0-9", "A-F" и "a-f". Знаковые шестнадцатеричные строки можно разобрать с помощью Long.parseLong(String, int).

Параметры:

string — CharSequence, содержащая символы

fromIndex — начальный индекс диапазона включительно

toIndex — конечный индекс диапазона исключительно.

Возвращает:

значение, разобранное из диапазона строки

Выбрасывает:

IndexOutOfBoundsException — если диапазон выходит за допустимые границы CharSequence

IllegalArgumentException — если длина диапазона больше шестнадцати (16) или любой из символов не является шестнадцатеричным

public boolean equals(Object o)

Переопределяет:

equals в классе Object

Параметры:

o — объект, может быть null

Возвращает:

true, если другой объект является HexFormat и параметры uppercase, delimiter, prefix и suffix равны; иначе — false

См. также:

• Object.hashCode()
• HashMap

public int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код этого HexFormat

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(Object)

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

описание этого HexFormat