Add Y_NONNULL attribute macro

commit_hash:140767fba3ddf262d702b06bc0bade2616e5a317

1 files changed, 19 insertions, 0 deletions

diff --git a/util/system/compiler.h b/util/system/compiler.h
index 499e432eee4..6a8239d1575 100644
--- a/util/system/compiler.h
+++ b/util/system/compiler.h
@@ -716,3 +716,22 @@ Y_FORCE_INLINE void DoNotOptimizeAway(const T&) = delete;
 #else
     #define Y_RETURNS_NONNULL
 #endif
+
+/**
+ * @def Y_NONNULL
+ *
+ * The nonnull attribute indicates that some function parameters must not be null.
+ *
+ * @see
+ *    GCC: https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-nonnull-function-attribute
+ *    Clang: https://clang.llvm.org/docs/AttributeReference.html#id15
+ *
+ * @code
+ * void func(char* Y_NONNULL arr, size_t len);
+ * @endcode
+ */
+#if Y_HAVE_ATTRIBUTE(nonnull)
+    #define Y_NONNULL __attribute__((nonnull))
+#else
+    #define Y_NONNULL
+#endif