Program Safety

Memory and threads guarantees of the api.

Memory

Memory ownership is never transferred across the api boundary. Usually, any pointers returned from any of the c functions are valid until next call to the same function. Therefore, most c functions are not reentrant.

The Python and C# wrappers functions always copy all necessary memory from the provided pointers into the managed memory of the language. Be careful if you use a c function directly.

Threads

Important

Entire uwapi is strictly single-threaded!

Hardened Library

We provide a separate library that contains additional validation of correct use of the api. The library will provide you an opportunity to stop the program in debugger when a problem is detected. It will terminate the program afterwards. This library is the default.

It is recommended to use the optimized (non-hardened) library when not actively developing your bots, or when in a tournament game.

Python

Use -O, eg. python -O your_bot.py, to use the optimized (non-hard) library.

C#

Define UW_USE_OPTIMIZED_LIBRARY macro to use the optimized (non-hard) library.