Enum rsass::ScopeRef

pub enum ScopeRef {
    Builtin(&'static Scope),
    Dynamic(Arc<Scope>),
}

A static or dynamic scope referece.

This dereferences to a Scope.

Variants

Builtin(&'static Scope)

The builtin scopes in rsass is static.

Dynamic(Arc<Scope>)

All other scopes are dynamic. This uses Arc reference counting.

Implementations

impl ScopeRef

pub fn new_global(format: Format) -> Self

Create a new global scope.

A “global” scope is just a scope that have no parent. There will be multiple global scopes existing during the evaluation of a single sass file.

pub fn sub(parent: ScopeRef) -> Self

Create a new subscope of a given parent.

pub fn sub_selectors(parent: ScopeRef, selectors: Selectors) -> Self

Create a new subscope of a given parent with selectors.

pub fn is_same(a: &Self, b: &Self) -> bool

Check if a and b references the same scope.

pub fn eval_body(self, body: &[Item]) -> Result<Option<Value>, Error> where
    Self: Sized, 

Evaluate a body of items in this scope.

Methods from Deref<Target = Scope>

pub fn define_module(&self, name: String, module: ScopeRef)

Define a module in the scope.

This is used by the @use statement.

pub fn get_module(&self, name: &str) -> Option<ScopeRef>

Get a module.

This is used when refering to a function or variable with namespace.name notation.

pub fn get_format(&self) -> Format

Get the format used in this scope.

pub fn define(&self, name: Name, val: &Value)

Define a none-default, non-global variable.

pub fn set_variable(&self, name: Name, val: Value, default: bool, global: bool)

Define a variable with a value.

The $ sign is not included in name.

pub fn define_global(&self, name: Name, val: Value)

Define a variable in the global scope that is an ultimate parent of this scope.

pub fn define_multi(&self, names: &[Name], value: &Value)

Define multiple names from a value that is a list. Special case: in names is a single name, value is used directly.

pub fn get_or_none(&self, name: &Name) -> Option<Value>

Get the Value for a variable.

pub fn get(&self, name: &str) -> Result<Value, Error>

Get the value for a variable (or an error).

pub fn store_local_values(&self, names: &[Name]) -> Vec<(Name, Option<Value>)>

Copy a set of local variables to a temporary holder

pub fn restore_local_values(&self, data: Vec<(Name, Option<Value>)>)

Restore a set of local variables from a temporary holder

pub fn get_global_or_none(&self, name: &Name) -> Option<Value>

Get the global Value for a variable.

pub fn get_mixin(&self, name: &Name) -> Option<Mixin>

Get a mixin by name.

Returns the formal args and the body of the mixin.

pub fn define_mixin(&self, name: Name, mixin: Mixin)

Define a mixin.

pub fn define_function(&self, name: Name, func: Function)

Define a function.

pub fn get_function(&self, name: &Name) -> Result<Option<Function>, Error>

Get a function by name.

pub fn get_selectors(&self) -> &Selectors

Get the selectors active for this scope.

pub fn functions_map(&self) -> Value

Get the functions of this scope as a Value::Map.

pub fn variables_map(&self) -> Value

Get the variables of this scope as a Value::Map.

pub fn forward(&self) -> ScopeRef

Get the forward scope for this scope.

Create a new one if necessary.

pub fn opt_forward(&self) -> Option<ScopeRef>

Get the forward scope for this scope.

Create a new one if necessary.

Trait Implementations

impl Clone for ScopeRef

fn clone(&self) -> ScopeRef

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Deref for ScopeRef

type Target = Scope

The resulting type after dereferencing.

fn deref(&self) -> &Scope

Dereferences the value.