Struct SubListChangeMove 

pub struct SubListChangeMove<S, V> { /* private fields */ }

A move that relocates a contiguous sublist from one position to another.

Supports both intra-list moves (within same entity) and inter-list moves (between different entities). Uses typed function pointers for zero-erasure.

Type Parameters

• S - The planning solution type
• V - The list element value type

Example

use solverforge_solver::heuristic::r#move::SubListChangeMove;
use solverforge_core::domain::PlanningSolution;
use solverforge_core::score::SimpleScore;

#[derive(Clone, Debug)]
struct Vehicle { id: usize, visits: Vec<i32> }

#[derive(Clone, Debug)]
struct Solution { vehicles: Vec<Vehicle>, score: Option<SimpleScore> }

impl PlanningSolution for Solution {
    type Score = SimpleScore;
    fn score(&self) -> Option<Self::Score> { self.score }
    fn set_score(&mut self, score: Option<Self::Score>) { self.score = score; }
}

fn list_len(s: &Solution, entity_idx: usize) -> usize {
    s.vehicles.get(entity_idx).map_or(0, |v| v.visits.len())
}
fn sublist_remove(s: &mut Solution, entity_idx: usize, start: usize, end: usize) -> Vec<i32> {
    s.vehicles.get_mut(entity_idx)
        .map(|v| v.visits.drain(start..end).collect())
        .unwrap_or_default()
}
fn sublist_insert(s: &mut Solution, entity_idx: usize, pos: usize, items: Vec<i32>) {
    if let Some(v) = s.vehicles.get_mut(entity_idx) {
        for (i, item) in items.into_iter().enumerate() {
            v.visits.insert(pos + i, item);
        }
    }
}

// Move elements [1..3) from vehicle 0 to vehicle 1 at position 0
let m = SubListChangeMove::<Solution, i32>::new(
    0, 1, 3,  // source: entity 0, range [1, 3)
    1, 0,     // dest: entity 1, position 0
    list_len, sublist_remove, sublist_insert,
    "visits", 0,
);

Implementations

impl<S, V> SubListChangeMove<S, V>

pub fn new( source_entity_index: usize, source_start: usize, source_end: usize, dest_entity_index: usize, dest_position: usize, list_len: fn(&S, usize) -> usize, sublist_remove: fn(&mut S, usize, usize, usize) -> Vec<V>, sublist_insert: fn(&mut S, usize, usize, Vec<V>), variable_name: &'static str, descriptor_index: usize, ) -> Self

Creates a new sublist change move with typed function pointers.

Arguments

• source_entity_index - Entity index to remove from
• source_start - Start of range (inclusive)
• source_end - End of range (exclusive)
• dest_entity_index - Entity index to insert into
• dest_position - Position in destination list
• list_len - Function to get list length
• sublist_remove - Function to remove range [start, end)
• sublist_insert - Function to insert elements at position
• variable_name - Name of the list variable
• descriptor_index - Entity descriptor index

pub fn source_entity_index(&self) -> usize

Returns the source entity index.

pub fn source_start(&self) -> usize

Returns the source range start (inclusive).

pub fn source_end(&self) -> usize

Returns the source range end (exclusive).

pub fn sublist_len(&self) -> usize

Returns the sublist length.

pub fn dest_entity_index(&self) -> usize

Returns the destination entity index.

pub fn dest_position(&self) -> usize

Returns the destination position.

pub fn is_intra_list(&self) -> bool

Returns true if this is an intra-list move (same entity).

Trait Implementations

impl<S: Clone, V: Clone> Clone for SubListChangeMove<S, V>

fn clone(&self) -> SubListChangeMove<S, V>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S, V: Debug> Debug for SubListChangeMove<S, V>

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

Formats the value using the given formatter.

impl<S, V> Move<S> for SubListChangeMove<S, V>

where S: PlanningSolution, V: Clone + Send + Sync + Debug + 'static,

fn is_doable(&self, score_director: &dyn ScoreDirector<S>) -> bool

Returns true if this move can be executed in the current state.

fn do_move(&self, score_director: &mut dyn ScoreDirector<S>)

Executes this move, modifying the working solution.

fn descriptor_index(&self) -> usize

Returns the descriptor index of the entity type this move affects.

fn entity_indices(&self) -> &[usize]

Returns the entity indices involved in this move.

fn variable_name(&self) -> &str

Returns the variable name this move affects.