Le module Comparable

Fait partie de la section Programmation orientée objet du Journey Ruby de Coddy. Leçon 29 sur 57.

Le module intégré de Ruby Comparable fournit à une classe les opérateurs <, <=, ==, >, >= ainsi que les méthodes between? et clamp. Il nécessite une méthode de la classe : <=>, qui renvoie un nombre négatif, 0 ou un nombre positif lorsque l’objet est plus petit, égal ou plus grand :

class Weight
  include Comparable
  attr_reader :grams

  def initialize(grams)
    @grams = grams
  end

  def <=>(other)
    grams <=> other.grams
  end
end

a = Weight.new(500)
b = Weight.new(1200)
puts a < b
puts a == Weight.new(500)
puts b.between?(a, Weight.new(2000))

Sortie :

true
true
true

Les nombres et les chaînes possèdent déjà <=>, une classe délègue donc généralement la comparaison à l’une de ses valeurs. La comparaison des tableaux s’effectue élément par élément, ce qui permet de trier selon plusieurs champs à la fois :

class Person
  include Comparable
  attr_reader :last, :first

  def initialize(first, last)
    @first = first
    @last = last
  end

  def <=>(other)
    [last, first] <=> [other.last, other.first]
  end
end

a = Person.new("Ada", "Lovelace")
b = Person.new("Alan", "Turing")
c = Person.new("Byron", "Lovelace")
puts a < c
puts b > c

Sortie :

true
true

sort, min et max utilisent également <=>, de sorte que les objets de la classe peuvent être triés sans bloc. clamp maintient une valeur entre deux autres :

class Weight
  include Comparable
  attr_reader :grams

  def initialize(grams)
    @grams = grams
  end

  def <=>(other)
    grams <=> other.grams
  end

  def to_s
    "#{grams}g"
  end
end

list = [Weight.new(900), Weight.new(150), Weight.new(400)]
puts list.sort.join(", ")
puts list.max
puts Weight.new(5000).clamp(Weight.new(0), Weight.new(1000))

Sortie :

150g, 400g, 900g
900g
1000g

<=> doit renvoyer nil lorsque l’autre objet ne peut pas être comparé. Comparable lève alors ArgumentError pour < et renvoie false pour ==, au lieu d’échouer avec un déroutant NoMethodError :

def <=>(other)
  return nil unless other.is_a?(Weight)

  grams <=> other.grams
end

Weight.new(1) == 5     # false
Weight.new(1) < 5      # ArgumentError: comparison of Weight with 5 failed

Défi

Facile

Complète la classe Weight. Weight.parse(text) lit 500g, 1.2kg ou 2lb (1 lb correspond à 453.6 g) et stocke les grammes. Inclus Comparable et définis <=> sur les grammes. to_s renvoie les grammes arrondis à l’entier le plus proche, comme 1200g.

Le code fourni analyse chaque ligne d’entrée, puis affiche les poids triés, le plus lourd, le plus léger, indique si le premier poids est compris entre 1 kg et 2 kg, et affiche le premier poids limité à 1 kg au maximum.

Ton code doit se trouver dans weight.rb. main.rb contient le code d’entrée/sortie fourni et ne peut pas être modifié.

Essayez vous-même

require_relative 'weight'

# Code d'entrée/sortie fourni : le laisser tel quel
input = []
while (line = gets)
  input << line.chomp
end
weights = input.map { |line| Weight.parse(line) }
puts "sorted: #{weights.sort.join(", ")}"
puts "heaviest: #{weights.max}"
puts "lightest: #{weights.min}"
puts "first between 1kg and 2kg: #{weights[0].between?(Weight.parse("1kg"), Weight.parse("2kg"))}"
puts "first clamped: #{weights[0].clamp(Weight.parse("0g"), Weight.parse("1kg"))}"