ispc_rt 2.0.4

A runtime dependency for linking Rust code with pre-built ISPC binaries and Rust bindings. These modules and bindings should be built with ispc_compile.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

//! Defines the trait that must be implemented by ISPC instrumentation callbacks structs
//! and provides a default one.

use std::ffi::CStr;

/// Trait to be implemented to provide ISPC instrumentation functionality.
///
/// The [runtime required function](http://ispc.github.io/perfguide.html#instrumenting-ispc-programs-to-understand-runtime-behavior)
/// is wrapped and forwarded to your struct.
pub trait Instrument {
    /// instrument is called when ISPC calls the `ISPCInstrument` callback. The file
    /// and note strings are converted `CStr` and the number of active programs is
    /// computed from the mask.
    fn instrument(&self, file: &CStr, note: &CStr, line: i32, mask: u64, active_count: u32);
    /// Called through `ispc::print_instrumenting_summary`, optionally log out a summary
    /// of performance information gathered through the `instrument` callback.
    fn print_summary(&self) {}
}

/// A simple ISPC instrumenter which will print the information passed to it out.
pub struct SimpleInstrument;

impl Instrument for SimpleInstrument {
    fn instrument(&self, file: &CStr, note: &CStr, line: i32, mask: u64, active_count: u32) {
        println!(
            "SimpleInstrument:\n\tFile: {}\n\tNote: {}\
                 \n\tLine: {}\n\tActive: {}\nt\tMask: 0x{:x}",
            file.to_str().unwrap(),
            note.to_str().unwrap(),
            line,
            active_count,
            mask
        );
    }
}