[Docs] Improve function pointer docs#26667
Open
kripken wants to merge 1 commit intoemscripten-core:mainfrom
Open
[Docs] Improve function pointer docs#26667kripken wants to merge 1 commit intoemscripten-core:mainfrom
kripken wants to merge 1 commit intoemscripten-core:mainfrom
Conversation
sbc100
approved these changes
Apr 10, 2026
| Function pointer casts can cause function pointer calls to fail. | ||
|
|
||
| Function pointers must be called with the correct type: it is undefined behavior in C and C++ to cast a function pointer to another type and call it that way. This does work in most native platforms, however, despite it being UB, but in Wasm it can fail. In that case, you may see an ``abort(10)`` or some other number, and if assertions are on you may see a message with details that start with | ||
| Function pointers must be called with the correct type: it is undefined behavior in C and C++ to cast a function pointer to another type and call it that way. This does work in most native platforms, however, despite it being UB, but in Wasm it can fail. In that case, you may see an error like this: |
| index will call this function, which simply calls ``abort()``. | ||
| If you get | ||
|
|
||
| :: |
Collaborator
There was a problem hiding this comment.
Can you combine there lines. e.g. If you get ::`?
| RuntimeError: null function or function signature mismatch | ||
|
|
||
| (or, in certain build types, an ``abort()`` or an error of "incorrect function | ||
| pointer"), the problem is that a proper function pointer was not found in the |
Collaborator
There was a problem hiding this comment.
.. the problem is that a function of the correct type was not found in the ..
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The message mentioned was for asm.js, not wasm.
Also mention the clang flag for warnings on casts in another place.