Struct SourceLocation

#[repr(C)]
pub struct SourceLocation {
    pub line: u32,
    pub column: u32,
}

Source code location information

Stores the line and column number where a directive or clause appears in the original source file. This is useful for:

• Error reporting: “Error at line 42, column 5”
• IDE integration: Jump to source location
• Debugging: Know where IR came from

Learning: The Copy Trait

This struct implements Copy, meaning it can be duplicated by simple bitwise copy (like memcpy in C). This is efficient for small types.

Types that implement Copy must also implement Clone. The difference:

• Copy: Implicit duplication (assignment creates a copy)
• Clone: Explicit duplication (call .clone() method)

Learning: repr(C)

The #[repr(C)] attribute tells Rust to lay out this struct in memory exactly like C would. This is critical for FFI (Foreign Function Interface).

Without repr(C), Rust might reorder fields for optimization. With repr(C), fields appear in declaration order.

Example

use roup::ir::SourceLocation;

let loc = SourceLocation { line: 42, column: 5 };
let copy = loc; // Implicitly copied due to Copy trait
assert_eq!(loc.line, 42);
assert_eq!(copy.line, 42); // Original still valid

Fields

line: u32

Line number (1-indexed, as in editors)

column: u32

Column number (1-indexed, as in editors)

Implementations

impl SourceLocation

pub const fn new(line: u32, column: u32) -> Self

Create a new source location

Example

use roup::ir::SourceLocation;

let loc = SourceLocation::new(10, 5);
assert_eq!(loc.line, 10);
assert_eq!(loc.column, 5);

pub const fn start() -> Self

Create a location at the start of a file

Example

use roup::ir::SourceLocation;

let start = SourceLocation::start();
assert_eq!(start.line, 1);
assert_eq!(start.column, 1);

Trait Implementations

impl Clone for SourceLocation

fn clone(&self) -> SourceLocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceLocation

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

Formats the value using the given formatter.

impl Default for SourceLocation

fn default() -> Self

Default location is at the start of a file (1, 1)

impl Display for SourceLocation

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

Format as “line:column” for error messages

Example

use roup::ir::SourceLocation;

let loc = SourceLocation::new(42, 5);
assert_eq!(format!("{}", loc), "42:5");

impl Hash for SourceLocation

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 PartialEq for SourceLocation

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

impl Eq for SourceLocation

impl StructuralPartialEq for SourceLocation