Raw Engine
Engine::new
creates a scripting Engine
with common functionalities (e.g. printing to stdout
via print
or debug
).
In many controlled embedded environments, however, these may not be needed and unnecessarily occupy application code storage space.
Even with a raw [`Engine`], some operators are built-in and always available.
See [_Built-in Operators_][built-in operators] for a full list.
Use Engine::new_raw
to create a raw Engine
, in which only a minimal set of
built-in basic arithmetic and logical operators are supported.
To add more functionalities to a raw Engine
, load packages into it.
Since packages can be shared, this is an extremely efficient way to create multiple instances of
the same Engine
with the same set of functions.
Engine::new | Engine::new_raw | |
---|---|---|
Built-in operators | yes | yes |
Package loaded | StandardPackage | none |
Module resolver | FileModuleResolver | none |
on_print | yes | none |
on_debug | yes | none |
```rust
use rhai::module_resolvers::FileModuleResolver;
use rhai::packages::StandardPackage;
// Create a raw scripting Engine
let mut engine = Engine::new_raw();
// Use the file-based module resolver
engine.set_module_resolver(FileModuleResolver::new());
// Default print/debug implementations
engine.on_print(|text| println!("{}", text));
engine.on_debug(|text, source, pos| {
if let Some(source) = source {
println!("{} @ {:?} | {}", source, pos, text);
} else if pos.is_none() {
println!("{}", text);
} else {
println!("{:?} | {}", pos, text);
}
});
// Register the Standard Package
let package = StandardPackage::new().as_shared_module();
engine.register_global_module(package);
```