Home

Awesome

context-rs

Build & Test License

This project offers an easy interface to the famous Boost.Context library and thus provides the building blocks for higher-level abstractions, like coroutines, cooperative threads (userland threads) or an equivalent to C# keyword yield in C++.

API documentation

Usage

To use context, first add this to your Cargo.toml:

[dependencies]
context = "3.0"

And then add this to your source files:

extern crate context;

Performance

The performance heavily depends on the architecture and even on the operating system. A context switch itself is usually as fast as a regular function call though and can thus be viewed as one.

To see this for yourself run cargo bench resume. You can then compare the results of the resume benchmarks (which uses Context::resume()) to the results of resume_reference_perf (which uses regular function calls).

Platforms

ArchitectureLinux (UNIX)WindowsMacOS XiOS
i386SYSV (ELF)MS (PE)SYSV (MACH-O)-
x86_64SYSV, X32 (ELF)MS (PE)SYSV (MACH-O)-
arm (aarch32)AAPCS (ELF)AAPCS (PE)-AAPCS (MACH-O)
arm (aarch64)AAPCS (ELF)AAPCS (PE)-AAPCS (MACH-O)
mips1O32 (ELF)---
mips64N64 (ELF)---
ppc32SYSV (ELF), XCOFF-SYSV (MACH-O)-
ppc64SYSV (ELF), XCOFF-SYSV (MACH-O)-
loongarch64SYSV (ELF)---
riscv64SYSV (ELF)---
s390xSYSV (ELF)---

Format: ABI (binary format). Source: Boost.Context