Struct Block 

pub struct Block { /* private fields */ }

Represents a block, a collection of Statements that can end with a LastStatement.

Implementations

impl Block

pub fn new( statements: Vec<Statement>, last_statement: Option<LastStatement>, ) -> Self

Creates a new Block with the given statements and optional last statement.

pub fn with_tokens(self, tokens: BlockTokens) -> Self

Attaches token information to this block and returns the updated block.

pub fn set_tokens(&mut self, tokens: BlockTokens)

Attaches token information to this block.

pub fn get_tokens(&self) -> Option<&BlockTokens>

Returns a reference to the token information attached to this block, if any.

pub fn mutate_tokens(&mut self) -> Option<&mut BlockTokens>

Returns a mutable reference to the token information attached to this block, if any.

pub fn push_statement<T: Into<Statement>>(&mut self, statement: T)

Adds a statement to the end of the block. Updates token information if present.

This method maintains consistency between the statements and their token information.

pub fn remove_statement(&mut self, index: usize)

Removes a statement at the specified index. Updates token information if present.

Does nothing if the index is out of bounds.

pub fn with_statement<T: Into<Statement>>(self, statement: T) -> Self

Adds a statement to the end of the block and returns the updated block.

pub fn insert_statement( &mut self, index: usize, statement: impl Into<Statement>, )

Inserts a statement at the specified index, appending if the index is beyond the end. Updates token information if present.

This method maintains consistency between the statements and their token information.

pub fn set_last_statement(&mut self, last_statement: impl Into<LastStatement>)

Sets the last statement of the block.

pub fn with_last_statement( self, last_statement: impl Into<LastStatement>, ) -> Self

Sets the last statement of the block and returns the updated block.

pub fn is_empty(&self) -> bool

Checks if the block is empty (contains no statements or last statement).

pub fn statements_len(&self) -> usize

Returns the number of statements in the block.

pub fn iter_statements(&self) -> impl Iterator<Item = &Statement>

Returns an iterator over references to the statements in the block.

pub fn reverse_iter_statements(&self) -> impl Iterator<Item = &Statement>

Returns an iterator over references to the statements in the block in reverse order.

pub fn get_last_statement(&self) -> Option<&LastStatement>

Returns a reference to the last statement of the block, if any.

pub fn filter_statements<F>(&mut self, f: F)

where F: FnMut(&Statement) -> bool,

Filters statements in the block, removing those for which the predicate returns false. Updates token information if present.

This method ensures token information stays consistent with the statements collection.

pub fn filter_mut_statements<F>(&mut self, f: F)

where F: FnMut(&mut Statement) -> bool,

Filters statements with mutable access, removing those for which the predicate returns false. Updates token information if present.

This method gives mutable access to statements during filtering.

pub fn truncate(&mut self, length: usize)

Truncates the statements to the specified length.

Updates token information if present.

pub fn iter_mut_statements(&mut self) -> impl Iterator<Item = &mut Statement>

Returns a mutable iterator over the statements in the block.

pub fn first_statement(&self) -> Option<&Statement>

Returns a reference to the first statement in the block, if any.

pub fn first_mut_statement(&mut self) -> Option<&mut Statement>

Returns a mutable reference to the first statement in the block, if any.

pub fn take_statements(&mut self) -> Vec<Statement>

Removes all statements from the block and returns them.

Clears token information if present.

pub fn take_last_statement(&mut self) -> Option<LastStatement>

Removes and returns the last statement of the block, if any.

Clears the last semicolon token if present.

pub fn set_statements(&mut self, statements: Vec<Statement>)

Sets the statements of the block.

Clears any existing semicolon tokens.

pub fn mutate_last_statement(&mut self) -> Option<&mut LastStatement>

Returns a mutable reference to the last statement of the block, if any.

pub fn replace_last_statement<S: Into<LastStatement>>( &mut self, statement: S, ) -> Option<LastStatement>

Replaces the last statement with the given statement and returns the old one, if any.

pub fn clear(&mut self)

Clears all statements and the last statement from the block.

Also clears all token information if present.

pub fn mutate_first_token(&mut self) -> &mut Token

Returns a mutable reference to the first token in this block, creating it if it doesn’t exist.

pub fn mutate_last_token(&mut self) -> &mut Token

Returns a mutable reference to the last token for this block, creating it if missing.

pub fn clear_comments(&mut self)

Clears all comments from the tokens in this node.

pub fn clear_whitespaces(&mut self)

Clears all whitespaces information from the tokens in this node.

Trait Implementations

impl Clone for Block

fn clone(&self) -> Block

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Block

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

Formats the value using the given formatter.

impl Default for Block

fn default() -> Self

Returns the “default value” for a type.

impl<IntoStatement: Into<Statement>> From<IntoStatement> for Block

fn from(statement: IntoStatement) -> Block

Converts to this type from the input type.

impl From<LastStatement> for Block

fn from(statement: LastStatement) -> Block

Converts to this type from the input type.

impl From<ReturnStatement> for Block

fn from(statement: ReturnStatement) -> Block

Converts to this type from the input type.

impl PartialEq for Block

fn eq(&self, other: &Block) -> 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 Eq for Block

impl StructuralPartialEq for Block