upd

Author: GyverLibs

README.md

@@ -295,57 +295,49 @@ bool tickRaw(bool s);
 // ================== ОПРОС ==================
 // кнопка нажата [событие]
 bool press();
+bool press(uint8_t clicks);
 
 // кнопка отпущена (в любом случае) [событие]
 bool release();
+bool release(uint8_t clicks);
 
 // клик по кнопке (отпущена без удержания) [событие]
 bool click();
+bool click(uint8_t clicks);
 
 // кнопка зажата (между press() и release()) [состояние]
 bool pressing();
+bool pressing(uint8_t clicks);
 
 // кнопка была удержана (больше таймаута) [событие]
 bool hold();
-
-// кнопка была удержана (больше таймаута) с предварительными кликами [событие]
-bool hold(uint8_t num);
+bool hold(uint8_t clicks);
 
 // кнопка удерживается (больше таймаута) [состояние]
 bool holding();
-
-// кнопка удерживается (больше таймаута) с предварительными кликами [состояние]
-bool holding(uint8_t num);
+bool holding(uint8_t clicks);
 
 // импульсное удержание [событие]
 bool step();
-
-// импульсное удержание с предварительными кликами [событие]
-bool step(uint8_t num);
+bool step(uint8_t clicks);
 
 // зафиксировано несколько кликов [событие]
 bool hasClicks();
-
-// зафиксировано указанное количество кликов [событие]
-bool hasClicks(uint8_t num);
-
-// получить количество кликов
-uint8_t getClicks();
-
-// получить количество степов
-uint16_t getSteps();
+bool hasClicks(uint8_t clicks);
 
 // кнопка отпущена после удержания [событие]
 bool releaseHold();
-
-// кнопка отпущена после удержания с предварительными кликами [событие]
-bool releaseHold(uint8_t num);
+bool releaseHold(uint8_t clicks);
 
 // кнопка отпущена после импульсного удержания [событие]
 bool releaseStep();
+bool releaseStep(uint8_t clicks);
+
+// получить количество кликов
+uint8_t getClicks();
 
-// кнопка отпущена после импульсного удержания с предварительными кликами [событие]
-bool releaseStep(uint8_t num);
+// получить количество степов
+uint16_t getSteps();
 
 // кнопка ожидает повторных кликов (между click() и hasClicks()) [состояние]
 bool waiting();
@@ -801,6 +793,8 @@ void loop() {
 - Если ожидается `timeout` - событие timeout с указанным периодом от текущего момента
 - Обработка кнопки в прерывании сообщает библиотеке о факте нажатия, вся остальная обработка выполняется штатно в `tick()`
 
+> Отличие `click(n)` от `hasClicks(n)`: `click(n)` вернёт `true` в любом случае при совпадении количества кликов, даже если будет сделано больше кликов. `hasClicks(n)` вернёт `true` только в том случае, если было сделано ровно указанное количество кликов и больше кликов не было!
+
 > Лучше один раз увидеть, чем сто раз прочитать. Запусти пример demo и понажимай на кнопку, или попробуй [онлайн-симуляцию в Wokwi](https://wokwi.com/projects/373591584298469377)
 
 ##### Click
@@ -1769,6 +1763,8 @@ void loop() {
   - Оптимизация
   - Упрощена замена кастомных функций
   - Исправлена ошибка компиляции при использовании библиотеки в нескольких .cpp файлах
+- v3.5.3
+  - Добавлено количество кликов в опрос press/release/click/pressing
     
 <a id="feedback"></a>
 ## Баги и обратная связь

library.properties

@@ -1,5 +1,5 @@
 name=EncButton
-version=3.5.2
+version=3.5.3
 author=AlexGyver <[email protected]>
 maintainer=AlexGyver <[email protected]>
 sentence=Light and powerful library for button and encoder operation for Arduino

src/core/VirtButton.h

@@ -139,29 +139,49 @@ class VirtButton {
         return read_bf(EB_PRS_R);
     }
 
+    // кнопка нажата с предварительными кликами [событие]
+    bool press(const uint8_t& num) {
+        return (clicks == num) && press();
+    }
+
     // кнопка отпущена (в любом случае) [событие]
     bool release() {
         return eq_bf(EB_REL_R | EB_REL, EB_REL_R | EB_REL);
     }
 
+    // кнопка отпущена (в любом случае) с предварительными кликами [событие]
+    bool release(const uint8_t& num) {
+        return (clicks == num) && release();
+    }
+
     // клик по кнопке (отпущена без удержания) [событие]
     bool click() {
         return eq_bf(EB_REL_R | EB_REL | EB_HLD, EB_REL_R);
     }
 
+    // клик по кнопке (отпущена без удержания) с предварительными кликами [событие]
+    bool click(const uint8_t& num) {
+        return (clicks == num) && click();
+    }
+
     // кнопка зажата (между press() и release()) [состояние]
     bool pressing() {
         return read_bf(EB_PRS);
     }
 
+    // кнопка зажата (между press() и release()) с предварительными кликами [состояние]
+    bool pressing(const uint8_t& num) {
+        return (clicks == num) && pressing();
+    }
+
     // кнопка была удержана (больше таймаута) [событие]
     bool hold() {
         return read_bf(EB_HLD_R);
     }
 
     // кнопка была удержана (больше таймаута) с предварительными кликами [событие]
     bool hold(const uint8_t& num) {
-        return clicks == num && hold();
+        return (clicks == num) && hold();
     }
 
     // кнопка удерживается (больше таймаута) [состояние]
@@ -171,7 +191,7 @@ class VirtButton {
 
     // кнопка удерживается (больше таймаута) с предварительными кликами [состояние]
     bool holding(const uint8_t& num) {
-        return clicks == num && holding();
+        return (clicks == num) && holding();
     }
 
     // импульсное удержание [событие]
@@ -181,7 +201,7 @@ class VirtButton {
 
     // импульсное удержание с предварительными кликами [событие]
     bool step(const uint8_t& num) {
-        return clicks == num && step();
+        return (clicks == num) && step();
     }
 
     // зафиксировано несколько кликов [событие]
@@ -191,7 +211,7 @@ class VirtButton {
 
     // зафиксировано указанное количество кликов [событие]
     bool hasClicks(const uint8_t& num) {
-        return clicks == num && hasClicks();
+        return (clicks == num) && hasClicks();
     }
 
     // получить количество кликов