bitClear()

Описание

bitClear() сбрасывает конкретный бит числовой переменной, записывая в него 0. Функция особенно полезна при низкоуровневой работе: управлении аппаратными регистрами, сбросе флагов состояния или прямом управлении вводом-выводом через регистры микроконтроллера.

Важно понимать, что bitClear() изменяет только один указанный бит — все остальные биты переменной остаются нетронутыми.

Синтаксис

Чтобы сбросить бит с номером n в переменной x, используйте:

bitClear(x, n)

Параметры

Функция допускает следующие параметры:

• x: числовая переменная, бит которой необходимо очистить.
• n: номер бита, который нужно сбросить. Нумерация начинается с 0 — это младший (самый правый) бит. Например, значение 3 означает четвёртый бит справа.

Возвращает

Функция возвращает значение числовой переменной после того, как бит в позиции n сброшен в 0.

Пример кода

Изменить данный байт x превратив его 6-й бит в 0:

uint8_t x = 0b11111111; // исходный байт 

void setup() {
  Serial.begin(9600);
  
  int index = 6; // индекс изменяемого бита
  
  x = bitClear(x, index-1);

  Serial.print("The resulting byte is: ");
  Serial.println(x, BIN);
 
}

void loop() {
}

Примечание

Упрощённо bitClear() можно представить так:

#define bitClear(value, bit) ((value) &= ~(1UL << (bit)))

Где применяется

• Управление аппаратными регистрами — сброс отдельных битов в регистрах периферии (таймеры, UART, SPI) без изменения остальных настроек.
• Работа с битовыми флагами — сброс флага после обработки события, например флага готовности данных.
• Прямое управление портами — очистка отдельного пина через регистры PORTx/DDRx быстрее, чем через digitalWrite().
• Хранение набора булевых состояний в одной переменной типа byte или int для экономии памяти.

Практические замечания

• Параметр n должен быть в допустимом диапазоне для типа переменной x: для byte — от 0 до 7, для int — от 0 до 15, для long — от 0 до 31. Выход за пределы приводит к непредсказуемому поведению.
• bitClear() изменяет переменную x напрямую — это не просто вычисление нового значения, а модификация оригинала.
• Если нужно установить бит в 1, используйте bitSet(). Для чтения значения бита — bitRead(), для записи произвольного значения — bitWrite().
• При работе с регистрами микроконтроллера операция чтение-изменение-запись не является атомарной. Если прерывания могут изменить тот же регистр между чтением и записью, на время операции стоит отключить прерывания.
• Для отладки удобно выводить значение переменной до и после вызова через Serial.println(x, BIN), чтобы видеть изменение в двоичном представлении.