Common Lisp содержит несколько функций для работы с полями смежных битов произвольной длины, находящимися где-нибудь в целом числе. Такое множество смежных битов называется байт. В Common Lisp’е термин байт не означает некоторое определённое количество бит (как например восемь), а обозначает поле произвольной, определяемой пользователем длины.
Функции обработки байтом используют объекты, называющиеся спецификаторы байта для определения заданной позиции байта в целом числе. Представление спецификатора байта зависит от реализации. В частности оно может быть или не быть числом. Достаточно знать, что функция byte будет создавать такой спецификатор, и что функция для обработки байта будет принимать его. Функция byte принимает два целых числа указывающих на позицию и размер байта и возвращает его спецификатор. Такой спецификатор определяет байт, у которого ширина равна размеру, и биты которого имеют веса с 2position+size−1 по 2position.
byte принимает два целых числа, указывающих на размер и позицию байта и возвращает спецификатор, который может использоваться в функциях работы с байтами.
Принимая спецификатор байта, byte-size возвращает размер указанного байта, а byte-position — позицию этого байта. Например:
Спецификатор байта bytespec указывает на байт, который будет извлечён из целого числа integer. Результат возвращается в качестве неотрицательного целого числа. Например:
Имя функции ldb означает «load byte (загрузить байт)».
Если аргумент integer задан формой, которая может использоваться в setf, тогда setf может использоваться вместе с ldb для изменения байта в целом числе указанном в форме integer. Это действие выполняется с помощью операции dpb.
ldb-test является предикатом, который истинен, если любой из битов, указанных в спецификаторе байта bytespec, в целом числе integer имеет значение 1. Другими словами, предикат истинен, если указанное поле не равно нулю.
Функция похожа а ldb. Однако результат содержит указанный байт целого числа integer в той же позиции, что указана в спецификаторе bytespec, а не в нулевой позиции, как делает ldb. Таким образом результат в указанном байте совпадает с целым числом integer , но в остальных местах имеет нулевые биты. Например:
Если аргумент integer задан формой, которая может использоваться в setf, тогда setf может использоваться вместе с mask-field для изменения байта в целом числе указанном в форме integer. Это действие выполняется с помощью операции deposit-field.
Данная функция возвращает число, которое похоже на integer за исключением битов, указанных спецификатором bytespec.. Пусть s будет размером, указанным в спецификаторе bytespec. Тогда целое число newbyte будет интерпретировано, будучи выровненным вправо, как если бы было результатом ldb. Например:
Имя функции dpb означает «deposit byte (сохранить байт)».
Данная функция относится к mask-field так же, как dpb относится к ldb. Результатом является целое число, которое содержит биты newbyte в том месте, куда указывает спецификатор bytespec, и биты числа integer во всех остальных местах.
Заметка для реализации: If the bytespec is a constant, one may of course construct, at compile time, an equivalent mask m, for example by computing (deposit-field -1 bytespec 0). Given this mask m, one may then compute
by computing
where the result of (lognot m) can of course also be computed at compile time. However, the following expression may also be used and may require fewer temporary registers in some situations:
A related, though possibly less useful, trick is that
interchanges those bits of x and y for which the mask m is 1, and leaves alone those bits of x and y for which m is 0.