Struct boa_engine::Source

pub struct Source<'path, R> { /* private fields */ }

A source of ECMAScript code.

Sources can be created from plain strs, file Paths or more generally, any Read instance.

Implementations

impl<'bytes> Source<'static, UTF8Input<&'bytes [u8]>>

pub fn from_bytes<T>( source: &'bytes T ) -> Source<'static, UTF8Input<&'bytes [u8]>>

where T: AsRef<[u8]> + ?Sized,

Creates a new Source from any type equivalent to a slice of bytes e.g. &str, Vec<u8>, Box<[u8]> or a plain slice &[u8].

Examples

let code = r#"var array = [5, 4, 3, 2, 1];"#;
let source = Source::from_bytes(code);

impl<'input> Source<'static, UTF16Input<'input>>

pub fn from_utf16(input: &'input [u16]) -> Source<'static, UTF16Input<'input>>

Creates a new Source from a UTF-16 encoded slice e.g. &[u16].

Examples

let utf16: Vec<u16> = "var array = [5, 4, 3, 2, 1];".encode_utf16().collect();
let source = Source::from_utf16(&utf16);

impl<'path> Source<'path, UTF8Input<BufReader<File>>>

pub fn from_filepath( source: &'path Path ) -> Result<Source<'path, UTF8Input<BufReader<File>>>, Error>

Creates a new Source from a Path to a file.

Errors

See File::open.

Examples

let path = Path::new("script.js");
let source = Source::from_filepath(path)?;

impl<'path, R> Source<'path, UTF8Input<R>>

where R: Read,

pub fn from_reader( reader: R, path: Option<&'path Path> ) -> Source<'path, UTF8Input<R>>

Creates a new Source from a Read instance and an optional Path.

Examples

let strictler = r#""use strict""#;

let path = Path::new("no_strict.js");
let file = File::open(path)?;
let strict = strictler.as_bytes().chain(file);

let source = Source::from_reader(strict, Some(path));

Trait Implementations

impl<'path, R> Debug for Source<'path, R>

where R: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.