added helpful bit macros

Author: gigapod

src/sfTk/sfToolkit.h

@@ -47,4 +47,26 @@ int32_t sftk_byte_swap(int32_t i);
 void sftk_delay_ms(uint32_t ms);
 
 // ticks in milliseconds
-uint32_t sftk_ticks_ms(void);
+uint32_t sftk_ticks_ms(void);
+
+/**
+ * @brief Check if specific bits are set in a value.
+ *
+ * This macro checks if the bits specified by the bitmask are set in the given value.
+ *
+ * @param __value__ The value to check.
+ * @param __bitmask__ The bitmask specifying which bits to check.
+ * @return True if all bits specified by the bitmask are set, false otherwise.
+ */.
+#define SFTK_CHECK_BITS_SET(__value__, __bitmask__) (((__value__) & (__bitmask__)) == __bitmask__)
+
+/**
+ * @brief Check if specific bits are cleared in a value.
+ *
+ * This macro checks if the bits specified by the bitmask are cleared in the given value.
+ *
+ * @param __value__ The value to check.
+ * @param __bitmask__ The bitmask specifying which bits to check.
+ * @return True if all bits specified by the bitmask are cleared, false otherwise.
+ */
+#define SFTK_CHECK_BITS_CLEARED(__value__, __bitmask__) (((__value__) & (__bitmask__)) == 0)