Skip to content

[docs] Document limitation on std::set_terminate and __cxa_begin_catch #23728

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Mar 6, 2025
Merged

[docs] Document limitation on std::set_terminate and __cxa_begin_catch #23728

Changes from 1 commit
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
3526475
[docs] Document limitation on std::set_terminate
aheejin Feb 22, 2025
b6f7831
Update site/source/docs/porting/exceptions.rst
aheejin Feb 27, 2025
c6940b2
Document about __cxa_begin_catch too
aheejin Feb 27, 2025
591b4ad
Merge branch 'main' into doc_set_terminate
aheejin Feb 28, 2025
d3b43e4
Reword
aheejin Mar 5, 2025
99bad19
Merge branch 'main' into doc_set_terminate
aheejin Mar 5, 2025
b747cd2
Add example to the first point
aheejin Mar 5, 2025
e13ded9
Limitations regarding std::terminate()
aheejin Mar 6, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions site/source/docs/porting/exceptions.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -171,3 +171,14 @@ Using Exceptions and setjmp-longjmp Together
============================================

See :ref:`using-exceptions-and-setjmp-longjmp-together`.


Limitations
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since both of these limitation are regarding std::set_terminate should we call this section Limitations regarding std::terminate?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

===========

Currently `std::set_terminate
<https://en.cppreference.com/w/cpp/error/set_terminate>`_ is NOT supported, both
in Emscripten-style and WebAssembly exceptions. The functionality requires the
`two-phase exception handling
<https://itanium-cxx-abi.github.io/cxx-abi/abi-eh.html>`_, which neither
supports.