mirror/rtic
1
0
Fork 0
mirror of https://github.com/rtic-rs/rtic.git synced 2025-12-16 21:05:35 +01:00
Code Issues Projects Releases Packages Wiki Activity

doc: add a paragraph to software_tasks.md

Browse source
This commit is contained in:
Oleksandr Babak 2025-03-23 11:42:22 +01:00 • committed by Emil Fresk
parent f6eacdc8d1
commit c43788f141
1 changed files with 4 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

4
book/en/src/by-example/software_tasks.md
View file

@ -84,6 +84,10 @@ $ cargo xtask qemu --verbose --example spawn_arguments
{{#include ../../../../ci/expected/lm3s6965/spawn_arguments.run}}
```
## Divergent tasks
A task can have one of two signatures: `async fn({name}::Context, ..)` or `async fn({name}::Context, ..) -> !`. The latter defines a *divergent* task — one that never returns. The key advantage of divergent tasks is that they receive a `'static` context, and `local` resources have `'static` lifetime. Additionally, using this signature makes the task’s intent explicit, clearly distinguishing between short-lived tasks and those that run indefinitely.
## Priority zero tasks
In RTIC tasks run preemptively to each other, with priority zero (0) the lowest priority. You can use priority zero tasks for background work, without any strict real-time requirements.