[libc-commits] [PATCH] D145466: [libc] Add a note about using assertions in the libc runtime code.

Siva Chandra via Phabricator via libc-commits libc-commits at lists.llvm.org
Tue Mar 7 10:18:34 PST 2023


This revision was automatically updated to reflect the committed changes.
Closed by commit rG4155503b714b: [libc] Add a note about using assertions in the libc runtime code. (authored by sivachandra).

Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D145466/new/

https://reviews.llvm.org/D145466

Files:
  libc/docs/dev/code_style.rst


Index: libc/docs/dev/code_style.rst
===================================================================
--- libc/docs/dev/code_style.rst
+++ libc/docs/dev/code_style.rst
@@ -102,3 +102,15 @@
    entrypoint is the only exceptional entrypoint on which other entrypoints
    should explicitly depend on if they set ``errno`` to indicate error
    conditions.
+
+Assertions in libc runtime code
+===============================
+
+The libc developers should, and are encouraged to, use assertions freely in
+the libc runtime code. However, the assertion should be listed via the macro
+``LIBC_ASSERT`` defined in ``src/__support/libc_assert.h``. This macro can be
+used from anywhere in the libc runtime code. Internally, all it does is to
+print the assertion expression and exit. It does not implement the semantics
+of the standard ``assert`` macro. Hence, it can be used from any where in the
+libc runtime code without causing any recursive calls or chicken-and-egg
+situations.


-------------- next part --------------
A non-text attachment was scrubbed...
Name: D145466.503088.patch
Type: text/x-patch
Size: 980 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/libc-commits/attachments/20230307/172ee147/attachment-0001.bin>


More information about the libc-commits mailing list