Struct Path 

pub struct Path { /* private fields */ }

Non-empty sequence of grid cells with an associated traversal cost.

Cost is hop-count (from_steps) or algorithm-supplied weighted cost (from_steps_with_cost). Paths do not validate adjacency on construction; callers use crate::Grid::path_is_walkable when geometry must be checked.

Implementations

impl Path

pub fn from_steps(steps: Vec<Point>) -> Result<Self, PathBuildError>

Builds a path with cost equal to steps.len() - 1 (unit hop model).

Errors

Returns PathBuildError::Empty when steps is empty.

pub fn from_steps_with_cost( steps: Vec<Point>, cost: usize, ) -> Result<Self, PathBuildError>

Builds a path with an explicit traversal cost (weighted solvers).

Errors

Returns PathBuildError::Empty when steps is empty.

pub fn steps(&self) -> &[Point]

Ordered cell sequence from start through goal (inclusive).

pub fn len(&self) -> usize

Number of cell steps (always ≥ 1 for constructed paths).

pub const fn is_empty(&self) -> bool

Always false for successfully constructed paths.

pub fn cost(&self) -> usize

Hop count (from_steps) or algorithm-supplied traversal cost (from_steps_with_cost).

pub fn start(&self) -> Point

First step; always defined because paths are non-empty by construction.

pub fn goal(&self) -> Point

Last step; always defined because paths are non-empty by construction.

Trait Implementations

impl Clone for Path

fn clone(&self) -> Path

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Path

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

Formats the value using the given formatter.

impl Eq for Path

impl PartialEq for Path

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

Equality operator ==.

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

Inequality operator !=.

impl SearchPathCost for Path

type Cost = usize

Cost type used by this path family (for example f64 Euclidean length).

fn path_cost(&self) -> Self::Cost

Returns the path’s domain-specific traversal cost.

impl StructuralPartialEq for Path