Skip to content

Commit

Permalink
Added struct de-structure-ing example in tips & tricks
Browse files Browse the repository at this point in the history
  • Loading branch information
korken89 committed Nov 7, 2019
1 parent 72e84cb commit 76e2345
Show file tree
Hide file tree
Showing 2 changed files with 56 additions and 0 deletions.
9 changes: 9 additions & 0 deletions book/en/src/by-example/tips.md
Original file line number Diff line number Diff line change
Expand Up @@ -165,3 +165,12 @@ crate and print the output to the console.
$ # produces the same output as before
$ cargo expand --example smallest | tail
```

## Resource de-structure-ing

When having a task taking multiple resources it can help in readability to split
up the resource struct. Here're two examples on how this can be done:

``` rust
{{#include ../../../../examples/destructure.rs}}
```
47 changes: 47 additions & 0 deletions examples/destructure.rs
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
//! examples/destructure.rs

#![deny(unsafe_code)]
#![deny(warnings)]
#![no_main]
#![no_std]

use cortex_m_semihosting::hprintln;
use lm3s6965::Interrupt;
use panic_semihosting as _;

#[rtfm::app(device = lm3s6965)]
const APP: () = {
struct Resources {
// Some resources to work with
#[init(0)]
a: u32,
#[init(0)]
b: u32,
#[init(0)]
c: u32,
}

#[init]
fn init(_: init::Context) {
rtfm::pend(Interrupt::UART0);
rtfm::pend(Interrupt::UART1);
}

// Direct destructure
#[task(binds = UART0, resources = [a, b, c])]
fn uart0(cx: uart0::Context) {
let a = cx.resources.a;
let b = cx.resources.b;
let c = cx.resources.c;

hprintln!("UART0: a = {}, b = {}, c = {}", a, b, c).unwrap();
}

// De-structure-ing syntax
#[task(binds = UART1, resources = [a, b, c])]
fn uart1(cx: uart1::Context) {
let uart1::Resources { a, b, c } = cx.resources;

hprintln!("UART0: a = {}, b = {}, c = {}", a, b, c).unwrap();
}
};

0 comments on commit 76e2345

Please sign in to comment.