struct Measure::Length

• Measure::Length
• Struct
• Value
• Object

Included Modules

• Comparable(Measure::Length)
• JSON::Serializable

Defined in:

Constructors

• .new(magnitude : Float64, unit : Measure::Length::Unit)

  Instantiate a Length instance with the given #magnitude and Unit.

• .new(pull : JSON::PullParser)

Instance Method Summary

• #*(scalar : Number) : self

  Multiply by a scalar value

• #+(other : self) : self

  Add two Lengths of any units together, returning an instance using self's Unit.

• #-(other : self) : self

  Subtract a Length from self, returning an instance using self's Unit.

• #/(scalar : Number) : self

  Multiply by a scalar value

• #<=>(other : self)

  Returns -1 if self is less than other, 0 if they're equal, or -1 otherwise.

• #==(other : self)

  Returns true if self and other are close enough to each other to be considered equivalent — within a femtometer (1/1_000_000_000_000_000th of a meter).

• #magnitude : Float64

  The numeric part of the measurement — the 1 in 1.meter.

• #to(unit : Unit) : self

  Convert this instance to the given Unit.

• #to_s(io : IO) : Nil

  Output a human-readable representation of this Length to the given IO.

• #total_meters : Float64

  Returns the number of meters represented by this Length instance

• #unit : Unit

  The unit used in measuring the length.

Constructor Detail

Instance Method Detail

2.miles * 5
# => Measure::Length(@magnitude=10.0, @unit=Measure::Length::Unit::Mile)

1.kilometer + 1.mile
# => Measure::Length(@magnitude=2.6093439485009937, @unit=Measure::Length::Unit::Kilometer)

1.mile - 1.kilometer
# => Measure::Length(@magnitude=0.37862878787878795, @unit=Measure::Length::Unit::Mile)

10.miles / 2
# => Measure::Length(@magnitude=5.0, @unit=Measure::Length::Unit::Mile)

1.mile <=> 1.kilometer # => 1
1.mile <=> 1.mile      # => 0
1.kilometer <=> 1.mile # => -1
1.kilometer < 1.mile   # => true
1.kilometer > 1.mile   # => false

1.mile.to(:feet)
# => Measure::Length(@magnitude=5280.0, @unit=Measure::Length::Unit::Foot)