Sha256: bd1d977c8ad20d9d25689555d3f67f17d14f8ea10feede3fc5c8dd732a34e223
Contents?: true
Size: 1.76 KB
Versions: 11
Compression:
Stored size: 1.76 KB
Contents
# encoding: binary
# frozen_string_literal: true
module RbNaCl
# Implements comparisons of keys
#
# This permits both timing invariant equality tests, as well as
# lexicographical sorting.
module KeyComparator
include Comparable
# spaceship operator
#
# @param other [KeyComparator,#to_str] The thing to compare
#
# @return [0] if the keys are equal
# @return [1] if the key is larger than the other key
# @return [-1] if the key is smaller than the other key
# @return [nil] if comparison doesn't make sense
def <=>(other)
if KeyComparator > other.class
other = other.to_bytes
elsif other.respond_to?(:to_str)
other = other.to_str
else
return nil
end
compare32(other)
end
# equality operator
#
# The equality operator is explicity defined, despite including Comparable
# and having a spaceship operator, so that if equality tests are desired,
# they can be timing invariant, without any chance that the further
# comparisons for greater than and less than can leak information. Maybe
# this is too paranoid, but I don't know how ruby works under the hood with
# comparable.
#
# @param other [KeyComparator,#to_str] The thing to compare
#
# @return [true] if the keys are equal
# @return [false] if they keys are not equal
def ==(other)
if KeyComparator > other.class
other = other.to_bytes
elsif other.respond_to?(:to_str)
other = other.to_str
else
return false
end
Util.verify32(to_bytes, other)
end
private
def compare32(other)
if Util.verify32(to_bytes, other)
0
elsif to_bytes > other
1
else
-1
end
end
end
end
Version data entries
11 entries across 11 versions & 1 rubygems