Skip to content

zonyitoo/context-rs

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

Architecture Linux (UNIX) Windows MacOS X iOS
i386 SYSV (ELF) MS (PE) SYSV (MACH-O) -
x86_64 SYSV, 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)
mips1 O32 (ELF) - - -
mips64 N64 (ELF) - - -
ppc32 SYSV (ELF), XCOFF - SYSV (MACH-O) -
ppc64 SYSV (ELF), XCOFF - SYSV (MACH-O) -
loongarch64 SYSV (ELF) - - -
riscv64 SYSV (ELF) - - -
s390x SYSV (ELF) - - -

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