1
0
mirror of https://github.com/KarolS/millfork.git synced 2024-07-18 02:28:57 +00:00
millfork/docs/abi/undefined-behaviour.md

32 lines
1.4 KiB
Markdown
Raw Normal View History

2018-01-04 00:15:04 +00:00
# Undefined behaviour
Since Millfork is only a middle-level programming language and attempts to eschew runtime checks in favour of performance,
there are many situation when the program may not behave as expected.
In the following list, "undefined value" means an arbitrary value that cannot be relied upon,
and "undefined behaviour" means arbitrary and unpredictable behaviour that may lead to anything,
even up to hardware damage.
* array overruns: indexing past the end of an array leads to undefined behaviour
* stray pointers: indexing a pointer that doesn't point to a valid object or indexing it past the end of the pointed object leads to undefined behaviour
* reading uninitialized variables: will return undefined values
2018-01-30 16:38:32 +00:00
* reading variables used by return dispatch statements but not assigned a value: will return undefined values
* returning a value from a function by return dispatch to a function of different return type: will return undefined values
* passing an index out of range for a return dispatch statement
2018-01-04 00:15:04 +00:00
* stack overflow: exhausting the hardware stack due to excess recursion, excess function calls or excess stack-allocated variables
2018-01-18 21:35:25 +00:00
* on ROM-based platforms: writing to arrays
* on ROM-based platforms: using global variables with an initial value
2018-01-04 00:15:04 +00:00
* violating the [safe assembly rules](../lang/assembly.md)
* violating the [safe reentrancy rules](../lang/reentrancy.md)
The above list is not exhaustive.