Struct Feature

pub struct Feature { /* private fields */ }

A set of runtime feature flags which can be enabled individually or in combination, which will change the way Parser works.

To build multiple features, use the bitwise OR operator.

Example

use css_lexer::*;
let features = Feature::SingleLineComments | Feature::SeparateWhitespace;
let mut lexer = Lexer::new_with_features("// foo", features);

Implementations

impl Feature

pub const SingleLineComments: Feature

This flag is forwarded to the Lexer which, when enabled, will treat single line comments as valid Comment tokens. If it encounters two consecutative SOLIDUS characters (//), it will return a Token with Kind::Comment. For more information about exactly what happens here at the lexer level, consult the css_lexer::Feature::SingleLineComments feature.

This flag doesn’t cause any changes in logic on the Parser; comments will be collected in the trivia tokens Vec as normal.

pub const SeparateWhitespace: Feature

This flag is forwarded to the Lexer which, when enabled, will treat diffetent whitespace kinds as descrete. For more information about exactly what happens here at the lexer level, consult the css_lexer::Feature::SeparateWhitespace feature.

This flag doesn’t cause any changes in logic on the Parser; whitespace is typically collected in the trivia Vec. AST nodes which call Parser::set_skip() to parse whitespace sensitive nodes should be cognizant that this feature could be enabled, meaning that adjacent whitespace tokens are possible. To counter adjacent tokens, simply parse any whitespace in a loop.

pub const fn bits(&self) -> u8

Returns the underlying bits of the bitmask.

pub const fn all_bits() -> Self

Returns a bitmask that contains all values.

This will include bits that do not have any flags. Use ::all_flags() if you only want to use flags.

pub const fn all_flags() -> Self

Returns a bitmask that contains all flags.

pub const fn is_all_bits(&self) -> bool

Returns true if the bitmask contains all values.

This will check for bits == !0, use .is_all_flags() if you only want to check for all flags

pub const fn is_all_flags(&self) -> bool

Returns true if the bitmask contains all flags.

This will fail if any unused bit is set, consider using .truncate() first.

pub const fn all() -> Self

👎Deprecated: Please use the ::all_bits() constructor

Returns a bitmask that contains all values.

This will include bits that do not have any flags. Use ::all_flags() if you only want to use flags.

pub const fn is_all(&self) -> bool

👎Deprecated: Please use the .is_all_bits() method

Returns true if the bitmask contains all values.

This will check for bits == !0, use .is_all_flags() if you only want to check for all flags

pub const fn full() -> Self

👎Deprecated: Please use the ::all_flags() constructor

Returns a bitmask that contains all flags.

pub const fn is_full(&self) -> bool

👎Deprecated: Please use the .is_all_flags() method

Returns true if the bitmask contains all flags.

This will fail if any unused bit is set, consider using .truncate() first.

pub const fn none() -> Self

Returns a bitmask that does not contain any values.

pub const fn is_none(&self) -> bool

Returns true if the bitmask does not contain any values.

pub const fn truncate(&self) -> Self

Returns a bitmask that only has bits corresponding to flags

pub const fn intersects(&self, other: Self) -> bool

Returns true if self intersects with any value in other, or if other does not contain any values.

This is equivalent to (self & other) != 0 || other == 0.

pub const fn contains(&self, other: Self) -> bool

Returns true if self contains all values of other.

This is equivalent to (self & other) == other.

pub const fn not(self) -> Self

Returns the bitwise NOT of the bitmask.

pub const fn and(self, other: Self) -> Self

Returns the bitwise AND of the bitmask.

pub const fn or(self, other: Self) -> Self

Returns the bitwise OR of the bitmask.

pub const fn xor(self, other: Self) -> Self

Returns the bitwise XOR of the bitmask.

Trait Implementations

impl Binary for Feature

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

Formats the value using the given formatter.

impl BitAnd for Feature

type Output = Feature

The resulting type after applying the & operator.

fn bitand(self, rhs: Self) -> Self::Output

Performs the & operation.

impl BitAndAssign for Feature

fn bitand_assign(&mut self, rhs: Self)

Performs the &= operation.

impl BitOr for Feature

type Output = Feature

The resulting type after applying the | operator.

fn bitor(self, rhs: Self) -> Self::Output

Performs the | operation.

impl BitOrAssign for Feature

fn bitor_assign(&mut self, rhs: Self)

Performs the |= operation.

impl BitXor for Feature

type Output = Feature

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: Self) -> Self::Output

Performs the ^ operation.

impl BitXorAssign for Feature

fn bitxor_assign(&mut self, rhs: Self)

Performs the ^= operation.

impl Clone for Feature

fn clone(&self) -> Feature

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Feature

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

Formats the value using the given formatter.

impl Default for Feature

fn default() -> Self

Returns the “default value” for a type.

impl From<Feature> for Feature

fn from(value: Feature) -> Self

Converts to this type from the input type.

impl From<Feature> for u8

fn from(val: Feature) -> u8

Converts to this type from the input type.

impl From<u8> for Feature

fn from(val: u8) -> Self

Converts to this type from the input type.

impl Hash for Feature

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl LowerHex for Feature

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

Formats the value using the given formatter.

impl Not for Feature

type Output = Feature

The resulting type after applying the ! operator.

fn not(self) -> Self::Output

Performs the unary ! operation.

impl Octal for Feature

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

Formats the value using the given formatter.

impl Ord for Feature

fn cmp(&self, other: &Feature) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq<u8> for Feature

fn eq(&self, other: &u8) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for Feature

fn eq(&self, other: &Feature) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Feature

fn partial_cmp(&self, other: &Feature) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl UpperHex for Feature

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

Formats the value using the given formatter.

impl Copy for Feature

impl Eq for Feature

impl StructuralPartialEq for Feature